1.1 --- a/.hgtags Tue May 12 15:21:55 2009 +0900
1.2 +++ b/.hgtags Thu May 14 00:17:25 2009 -0700
1.3 @@ -31,3 +31,5 @@
1.4 d1c43d1f5676a24ba86221ac7cad5694f3a9afda jdk7-b54
1.5 522bb5aa17e0c0cff00b1ed7d1b51bc4db2cfef9 jdk7-b55
1.6 7fd3bc37afe36f8f6165ba679db1229716db822a jdk7-b56
1.7 +d5a1223e961891564de25c39fba6f2442d0fb045 jdk7-b57
1.8 +9ba256e2e5c161b89e638390f998baa175ec9abe jdk7-b58
2.1 --- a/make/common/Release.gmk Tue May 12 15:21:55 2009 +0900
2.2 +++ b/make/common/Release.gmk Thu May 14 00:17:25 2009 -0700
2.3 @@ -52,6 +52,9 @@
2.4 com.sun.java.swing.plaf.motif \
2.5 com.sun.java.swing.plaf.gtk
2.6
2.7 +# This is a stopgap until 6839872 is fixed.
2.8 +EXCLUDE_PROPWARN_PKGS += sun.dyn
2.9 +
2.10 # 64-bit solaris has a few special cases. We define the variable
2.11 # SOLARIS64 for use in this Makefile to easily test those cases
2.12 ifeq ($(PLATFORM), solaris)
3.1 --- a/make/docs/CORE_PKGS.gmk Tue May 12 15:21:55 2009 +0900
3.2 +++ b/make/docs/CORE_PKGS.gmk Thu May 14 00:17:25 2009 -0700
3.3 @@ -1,5 +1,5 @@
3.4 #
3.5 -# Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
3.6 +# Copyright 2001-2008 Sun Microsystems, Inc. All Rights Reserved.
3.7 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3.8 #
3.9 # This code is free software; you can redistribute it and/or modify it
3.10 @@ -55,6 +55,7 @@
3.11 # This is a list of regular expressions. So foo.* matches "foo" and "foo.bar".
3.12 #
3.13 ACTIVE_JSR_PKGS= \
3.14 + java.dyn \
3.15 java.sql \
3.16 javax.activation \
3.17 javax.annotation.* \
3.18 @@ -96,6 +97,7 @@
3.19 java.awt.print \
3.20 java.beans \
3.21 java.beans.beancontext \
3.22 + java.dyn \
3.23 java.io \
3.24 java.lang \
3.25 java.lang.annotation \
4.1 --- a/make/java/Makefile Tue May 12 15:21:55 2009 +0900
4.2 +++ b/make/java/Makefile Thu May 14 00:17:25 2009 -0700
4.3 @@ -1,5 +1,5 @@
4.4 #
4.5 -# Copyright 1995-2006 Sun Microsystems, Inc. All Rights Reserved.
4.6 +# Copyright 1995-2009 Sun Microsystems, Inc. All Rights Reserved.
4.7 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4.8 #
4.9 # This code is free software; you can redistribute it and/or modify it
4.10 @@ -39,7 +39,7 @@
4.11 # Others
4.12 # Note: java_crw_demo java_hprof_demo are demos but must be delivered built in sdk
4.13 SUBDIRS += security npt java_crw_demo java_hprof_demo \
4.14 - math awt util text applet net nio \
4.15 + math awt util text applet net nio dyn \
4.16 sql rmi jar beans logging management instrument
4.17
4.18
5.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
5.2 +++ b/make/java/dyn/Makefile Thu May 14 00:17:25 2009 -0700
5.3 @@ -0,0 +1,44 @@
5.4 +#
5.5 +# Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
5.6 +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5.7 +#
5.8 +# This code is free software; you can redistribute it and/or modify it
5.9 +# under the terms of the GNU General Public License version 2 only, as
5.10 +# published by the Free Software Foundation. Sun designates this
5.11 +# particular file as subject to the "Classpath" exception as provided
5.12 +# by Sun in the LICENSE file that accompanied this code.
5.13 +#
5.14 +# This code is distributed in the hope that it will be useful, but WITHOUT
5.15 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
5.16 +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
5.17 +# version 2 for more details (a copy is included in the LICENSE file that
5.18 +# accompanied this code).
5.19 +#
5.20 +# You should have received a copy of the GNU General Public License version
5.21 +# 2 along with this work; if not, write to the Free Software Foundation,
5.22 +# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
5.23 +#
5.24 +# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
5.25 +# CA 95054 USA or visit www.sun.com if you need additional information or
5.26 +# have any questions.
5.27 +#
5.28 +
5.29 +BUILDDIR = ../..
5.30 +
5.31 +PACKAGE = java.dyn
5.32 +PRODUCT = java
5.33 +include $(BUILDDIR)/common/Defs.gmk
5.34 +
5.35 +AUTO_FILES_JAVA_DIRS = java/dyn sun/dyn
5.36 +
5.37 +# The sources built here use new language syntax to generate
5.38 +# method handle calls. Let's be sure we are using that format.
5.39 +#LANGUAGE_VERSION = -source 7
5.40 +#CLASS_VERSION = -target 7
5.41 +
5.42 +# Actually, it will be less disruptive to compile with the same
5.43 +# -target option as the rest of the system, and just turn on
5.44 +# the specific compiler option we need here:
5.45 +OTHER_JAVACFLAGS = -XDinvokedynamic
5.46 +
5.47 +include $(BUILDDIR)/common/Classes.gmk
6.1 --- a/make/sun/awt/FILES_c_unix.gmk Tue May 12 15:21:55 2009 +0900
6.2 +++ b/make/sun/awt/FILES_c_unix.gmk Thu May 14 00:17:25 2009 -0700
6.3 @@ -125,7 +125,6 @@
6.4 FourByteAbgrPre.c \
6.5 BufferedMaskBlit.c \
6.6 BufferedRenderPipe.c \
6.7 - RenderBuffer.c \
6.8 ShapeSpanIterator.c \
6.9 SpanClipRenderer.c \
6.10 awt_ImageRep.c \
7.1 --- a/make/sun/awt/FILES_c_windows.gmk Tue May 12 15:21:55 2009 +0900
7.2 +++ b/make/sun/awt/FILES_c_windows.gmk Thu May 14 00:17:25 2009 -0700
7.3 @@ -70,7 +70,6 @@
7.4 FourByteAbgrPre.c \
7.5 BufferedMaskBlit.c \
7.6 BufferedRenderPipe.c \
7.7 - RenderBuffer.c \
7.8 ShapeSpanIterator.c \
7.9 SpanClipRenderer.c \
7.10 SurfaceData.c \
8.1 --- a/make/sun/awt/mapfile-vers Tue May 12 15:21:55 2009 +0900
8.2 +++ b/make/sun/awt/mapfile-vers Thu May 14 00:17:25 2009 -0700
8.3 @@ -65,7 +65,6 @@
8.4 Java_sun_awt_image_ShortComponentRaster_initIDs;
8.5 Java_sun_java2d_pipe_BufferedMaskBlit_enqueueTile;
8.6 Java_sun_java2d_pipe_BufferedRenderPipe_fillSpans;
8.7 - Java_sun_java2d_pipe_RenderBuffer_copyFromArray;
8.8 Java_sun_java2d_pipe_SpanClipRenderer_eraseTile;
8.9 Java_sun_java2d_pipe_SpanClipRenderer_fillTile;
8.10 Java_sun_java2d_pipe_ShapeSpanIterator_addSegment;
9.1 --- a/make/sun/awt/mapfile-vers-linux Tue May 12 15:21:55 2009 +0900
9.2 +++ b/make/sun/awt/mapfile-vers-linux Thu May 14 00:17:25 2009 -0700
9.3 @@ -117,7 +117,6 @@
9.4 Java_sun_java2d_loops_MaskBlit_MaskBlit;
9.5 Java_sun_java2d_loops_MaskFill_MaskFill;
9.6 Java_sun_java2d_pipe_BufferedRenderPipe_fillSpans;
9.7 - Java_sun_java2d_pipe_RenderBuffer_copyFromArray;
9.8 Java_sun_java2d_pipe_SpanClipRenderer_initIDs;
9.9 sun_awt_image_GifImageDecoder_initIDs;
9.10
10.1 --- a/src/linux/doc/man/appletviewer.1 Tue May 12 15:21:55 2009 +0900
10.2 +++ b/src/linux/doc/man/appletviewer.1 Thu May 14 00:17:25 2009 -0700
10.3 @@ -1,6 +1,4 @@
10.4 -.'" t
10.5 -."
10.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
10.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
10.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
10.9 ."
10.10 ." This code is free software; you can redistribute it and/or modify it
10.11 @@ -20,20 +18,21 @@
10.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
10.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
10.14 ." have any questions.
10.15 -."
10.16 -." `
10.17 -.TH appletviewer 1 "05 Aug 2006"
10.18 -." Generated by html2roff
10.19 +."
10.20 +.TH appletviewer 1 "04 May 2009"
10.21 +." Generated from HTML by html2man (author: Eric Armstrong)
10.22
10.23 .LP
10.24 -.SH NAME
10.25 +.SH "Name"
10.26 appletviewer \- The Java Applet Viewer
10.27 .LP
10.28 +.RS 3
10.29
10.30 .LP
10.31 .LP
10.32 The \f3appletviewer\fP command allows you to run applets outside of a web browser.
10.33 .LP
10.34 +.RE
10.35 .SH "SYNOPSIS"
10.36 .LP
10.37
10.38 @@ -59,15 +58,18 @@
10.39 .LP
10.40
10.41 .LP
10.42 +.RS 3
10.43 .TP 3
10.44 \-debug
10.45 -Starts the applet viewer in the Java debugger, \f3jdb\fP, thus allowing you to debug the applets in the document.
10.46 +Starts the applet viewer in the Java debugger, jdb(1), thus allowing you to debug the applets in the document.
10.47 .TP 3
10.48 \-encoding \ \ encoding name
10.49 Specify the input HTML file encoding name.
10.50 .TP 3
10.51 \-Jjavaoption
10.52 Passes through the string \f2javaoption\fP as a single argument to the Java interpreter which runs the appletviewer. The argument should not contain spaces. Multiple argument words must all begin with the prefix \f3\-J\fP, which is stripped. This is useful for adjusting the compiler's execution environment or memory usage.
10.53 +.RE
10.54 +
10.55 .LP
10.56 .LP
10.57
11.1 --- a/src/linux/doc/man/apt.1 Tue May 12 15:21:55 2009 +0900
11.2 +++ b/src/linux/doc/man/apt.1 Thu May 14 00:17:25 2009 -0700
11.3 @@ -1,5 +1,3 @@
11.4 -.'" t
11.5 -."
11.6 ." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
11.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
11.8 ."
11.9 @@ -20,10 +18,9 @@
11.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
11.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
11.12 ." have any questions.
11.13 -."
11.14 -." `
11.15 -.TH apt 1 "05 Aug 2006"
11.16 -." Generated by html2roff
11.17 +."
11.18 +.TH apt 1 "04 May 2009"
11.19 +." Generated from HTML by html2man (author: Eric Armstrong)
11.20
11.21 .LP
11.22 .SH "NAME"
11.23 @@ -41,12 +38,15 @@
11.24 .LP
11.25 Options may be in any order. For a discussion of parameters which apply to a specific option, see OPTIONS below.
11.26 .LP
11.27 +.RS 3
11.28 .TP 3
11.29 sourcefiles
11.30 Zero or more source files to be processed.
11.31 .TP 3
11.32 @files
11.33 One or more files that list source files or other options
11.34 +.RE
11.35 +
11.36 .LP
11.37 .SH "DESCRIPTION"
11.38 .LP
11.39 @@ -60,19 +60,19 @@
11.40 .fi
11.41 http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
11.42 .LP
11.43 +.RS 3
11.44 .TP 3
11.45 Note:
11.46 -\f2The functionality of \fP\f2apt\fP has been subsumed by the annotation\-processing infrastructure that is now part of the \f2javac\fP tool [
11.47 -.na
11.48 -\f2Solaris and Linux\fP @
11.49 -.fi
11.50 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [Windows] and standardized for use by all Java compilers. This new infrastructure relies on the language model and annotation\-processing APIs that are now part of the Java Platform. It is recommended that new annotation processor development be based on the new APIs and the \f2javac\fP tool.
11.51 +\f2The functionality of \fP\f2apt\fP has been subsumed by the annotation\-processing infrastructure that is now part of the \f2javac(1)\fP tool and standardized for use by all Java compilers. This new infrastructure relies on the language model and annotation\-processing APIs that are now part of the Java Platform. It is recommended that new annotation processor development be based on the new APIs and the \f2javac\fP tool.
11.52 +.RE
11.53 +
11.54 .LP
11.55 .SH "OPTIONS"
11.56 .LP
11.57 .SS
11.58 apt specific options
11.59 .LP
11.60 +.RS 3
11.61 .TP 3
11.62 \-s dir
11.63 Specify the directory root under which processor\-generated source files will be placed; files are placed in subdirectories based on package namespace.
11.64 @@ -91,17 +91,21 @@
11.65 .TP 3
11.66 \-factory classname
11.67 Name of annotation processor factory to use; bypasses default discovery process
11.68 +.RE
11.69 +
11.70 .LP
11.71 .SS
11.72 Options shared with javac
11.73 .LP
11.74 +.RS 3
11.75 .TP 3
11.76 \-d dir
11.77 Specify where to place processor and javac generated class files
11.78 .TP 3
11.79 -\-cp path or \-classpath
11.80 -path
11.81 +\-cp path or \-classpath path
11.82 Specify where to find user class files and annotation processor factories. If \f2\-factorypath\fP is given, the classpath is not searched for factories.
11.83 +.RE
11.84 +
11.85 .LP
11.86 .LP
11.87 Consult the javac(1) man page for information on \f2javac\fP options.
11.88 @@ -115,24 +119,11 @@
11.89 .LP
11.90 .RS 3
11.91 .TP 2
11.92 -*
11.93 -javac: [
11.94 -.na
11.95 -\f2Solaris and Linux\fP @
11.96 -.fi
11.97 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [Windows]
11.98 -.TP 2
11.99 -*
11.100 -java: [
11.101 -.na
11.102 -\f2Solaris\fP @
11.103 -.fi
11.104 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
11.105 -.na
11.106 -\f2Linux\fP @
11.107 -.fi
11.108 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] [Windows]
11.109 +o
11.110 +javac(1), java(1)
11.111 .RE
11.112
11.113 .LP
11.114 +
11.115 +.LP
11.116
12.1 --- a/src/linux/doc/man/extcheck.1 Tue May 12 15:21:55 2009 +0900
12.2 +++ b/src/linux/doc/man/extcheck.1 Thu May 14 00:17:25 2009 -0700
12.3 @@ -1,6 +1,4 @@
12.4 -.'" t
12.5 -."
12.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
12.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
12.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
12.9 ."
12.10 ." This code is free software; you can redistribute it and/or modify it
12.11 @@ -21,19 +19,20 @@
12.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
12.13 ." have any questions.
12.14 ."
12.15 -." `
12.16 -.TH extcheck 1 "05 Aug 2006"
12.17 -." Generated by html2roff
12.18 +.TH extcheck 1 "04 May 2009"
12.19 +." Generated from HTML by html2man (author: Eric Armstrong)
12.20
12.21 .LP
12.22 -.SH NAME
12.23 +.SH "Name"
12.24 extcheck \- A utility to detect jar conflicts
12.25 .LP
12.26 +.RS 3
12.27
12.28 .LP
12.29 .LP
12.30 \f3extcheck\fP detects version conflicts between a target jar file and currently installed extension jar files.
12.31 .LP
12.32 +.RE
12.33 .SH "SYNOPSIS"
12.34 .LP
12.35
12.36 @@ -67,19 +66,22 @@
12.37 .LP
12.38
12.39 .LP
12.40 +.RS 3
12.41 .TP 3
12.42 \-verbose
12.43 Lists Jar files in the extension directory as they are checked. Additionally, manifest attributes of the target jar file and any conflicting jar files are also reported.
12.44 .TP 3
12.45 \-Joption
12.46 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
12.47 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
12.48 +.RE
12.49 +
12.50 .LP
12.51 .SH "SEE ALSO"
12.52 .LP
12.53
12.54 .LP
12.55 .LP
12.56 -jar
12.57 +jar(1)
12.58 .LP
12.59
12.60 .LP
13.1 --- a/src/linux/doc/man/idlj.1 Tue May 12 15:21:55 2009 +0900
13.2 +++ b/src/linux/doc/man/idlj.1 Thu May 14 00:17:25 2009 -0700
13.3 @@ -1,5 +1,3 @@
13.4 -.'" t
13.5 -."
13.6 ." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
13.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
13.8 ."
13.9 @@ -21,12 +19,11 @@
13.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
13.11 ." have any questions.
13.12 ."
13.13 -." `
13.14 -.TH idlj 1 "07 Aug 2006"
13.15 -." Generated by html2man
13.16 +.TH idlj 1 "04 May 2009"
13.17 +." Generated from HTML by html2man (author: Eric Armstrong)
13.18
13.19 .LP
13.20 -.SH NAME
13.21 +.SH "Name"
13.22 idlj \- The IDL\-to\-Java Compiler
13.23 .LP
13.24 .RS 3
13.25 @@ -54,7 +51,11 @@
13.26 .LP
13.27
13.28 .LP
13.29 -The IDL\-to\-Java Compiler generates the Java bindings for a given IDL file.\ For binding details, see the OMG IDL to Java Language Language Mapping Specification. Some previous releases of the IDL\-to\-Java compiler were named \f2idltojava\fP.
13.30 +The IDL\-to\-Java Compiler generates the Java bindings for a given IDL file.\ For binding details, see the
13.31 +.na
13.32 +\f2OMG IDL to Java Language Language Mapping Specification\fP @
13.33 +.fi
13.34 +http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html. Some previous releases of the IDL\-to\-Java compiler were named \f2idltojava\fP.
13.35 .SS
13.36 Emitting Client and Server Bindings
13.37 .LP
13.38 @@ -78,10 +79,18 @@
13.39 The default server\-side model is the \f2Portable Servant Inheritance Model\fP. Given an interface \f2My\fP defined in \f2My.idl\fP, the file \f2MyPOA.java\fP is generated. You must provide the implementation for \f2My\fP and it must inherit from \f2MyPOA\fP.
13.40 .LP
13.41 .LP
13.42 -\f2MyPOA.java\fP is a stream\-based skeleton that extends \f2org.omg.PortableServer.Servant\fP and implements the \f2InvokeHandler\fP interface and the operations interface associated with the IDL interface the skeleton implements.
13.43 +\f2MyPOA.java\fP is a stream\-based skeleton that extends
13.44 +.na
13.45 +\f2org.omg.PortableServer.Servant\fP @
13.46 +.fi
13.47 +http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html and implements the \f2InvokeHandler\fP interface and the operations interface associated with the IDL interface the skeleton implements.
13.48 .LP
13.49 .LP
13.50 -The \f2PortableServer\fP module for the Portable Object Adapter (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior.
13.51 +The \f2PortableServer\fP module for the
13.52 +.na
13.53 +\f2Portable Object Adapter (POA)\fP @
13.54 +.fi
13.55 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior.
13.56 .LP
13.57 .LP
13.58 Another option for the Inheritance Model is to use the \f2\-oldImplBase\fP flag in order to generate server\-side bindings that are compatible with versions of the Java programming language prior to J2SE 1.4. Note that using the \f2\-oldImplBase\fP flag is non\-standard: these APIs are being deprecated. You would use this flag ONLY for compatibility with existing servers written in J2SE 1.3. In that case, you would need to modify an existing MAKEFILE to add the \f2\-oldImplBase\fP flag to the \f2idlj\fP compiler, otherwise POA\-based server\-side mappings will be generated. To generate server\-side bindings that are backwards compatible:
13.59 @@ -203,7 +212,11 @@
13.60 .LP
13.61 Since this form of include can become irritatingly long, another means of indicating to the compiler where to search for included files is provided. This technique is similar to the idea of an environment variable. Create a file named \f2idl.config\fP in a directory that is listed in your CLASSPATH. Inside of \f2idl.config\fP, provide a line with the following form: \f2includes=/includes;/moreIncludes\fP
13.62 .LP
13.63 -The compiler will find this file and read in the includes list. Note that in this example the separator character between the two directories is a semicolon (;). This separator character is platform dependent. On the Windows platform, use a semicolon, on the Unix platform, use a colon, etc. For more information on \f2includes\fP, read the CLASSPATH\ (Solaris) or CLASSPATH\ (Windows) documentation.
13.64 +The compiler will find this file and read in the includes list. Note that in this example the separator character between the two directories is a semicolon (;). This separator character is platform dependent. On the Windows platform, use a semicolon, on the Unix platform, use a colon, etc. For more information on \f2includes\fP, see the
13.65 +.na
13.66 +\f2Setting the Classpath\fP @
13.67 +.fi
13.68 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general.
13.69 .RE
13.70 .SS
13.71 Emitting Bindings for Include Files
14.1 --- a/src/linux/doc/man/ja/appletviewer.1 Tue May 12 15:21:55 2009 +0900
14.2 +++ b/src/linux/doc/man/ja/appletviewer.1 Thu May 14 00:17:25 2009 -0700
14.3 @@ -1,6 +1,4 @@
14.4 -.'" t
14.5 -."
14.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
14.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
14.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
14.9 ."
14.10 ." This code is free software; you can redistribute it and/or modify it
14.11 @@ -20,55 +18,58 @@
14.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
14.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
14.14 ." have any questions.
14.15 -."
14.16 -." `
14.17 -.TH appletviewer 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
14.18 -." Generated by html2roff
14.19 +."
14.20 +.TH appletviewer 1 "04 May 2009"
14.21 +." Generated from HTML by html2man (author: Eric Armstrong)
14.22
14.23 .LP
14.24 -.SH 名前
14.25 -appletviewer \- Java アプレットビューア
14.26 +.SH ""
14.27 +appletviewer \- Java ≪ャ若
14.28 +.LP
14.29 +.RS 3
14.30 +
14.31 +.LP
14.32 +.LP
14.33 +\f3appletviewer\fP 潟潟 Web 吟紊с≪絎茵障
14.34 +.LP
14.35 +.RE
14.36 +.SH "綵√"
14.37 .LP
14.38
14.39 .LP
14.40 .LP
14.41 -\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
14.42 +\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
14.43 .LP
14.44 -.SH "形式"
14.45 +.SH "茯"
14.46 .LP
14.47
14.48 .LP
14.49 .LP
14.50 -\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
14.51 +\f3appletviewer\fP 潟潟 \f2urls\fP 絎ャ<潟純若鴻・膓ャ<潟с≪c潟ц;腓冴障羈: \f2urls\fP cсャ<潟\f2OBJECT\fP\f2EMBED\fP障 \f2APPLET\fP 帥違с≪с翫\f3appletviewer\fP 篏茵障\f3appletviewer\fP с泣若 HTML 帥違荅括完ゃ
14.52 +.na
14.53 +\f2≪ャ若≪帥違\fP @
14.54 +.fi
14.55 +http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlс
14.56 .LP
14.57 -.SH "機能説明"
14.58 +.LP
14.59 +\f3羈:\fP \f3appletviewer\fP RFC2396 ц鎘鴻宴若罘罕緇c膃垸 URL 綽荀障泣若膃垸 URL с<ゃゃRFC2396 絎号х垸茹iゃ鏆荀障
14.60 +.LP
14.61 +.SH "激с"
14.62 .LP
14.63
14.64 .LP
14.65 -.LP
14.66 -\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注:\f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
14.67 -.fi
14.68 -http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.html
14.69 -の
14.70 -.na
14.71 -「\f2AppletViewer Tags\fP」を参照してください。
14.72 -.LP
14.73 -.LP
14.74 -\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
14.75 -.LP
14.76 -.SH "オプション"
14.77 -.LP
14.78 -
14.79 -.LP
14.80 +.RS 3
14.81 .TP 3
14.82 \-debug
14.83 -Java デバッガ \f3jdb\fP でアプレットビューアを開始します。 これにより、ドキュメント中のアプレットをデバッグすることができます。
14.84 +Java jdb(1) с≪ャ若≪紮障 ャ<潟筝≪違с障
14.85 .TP 3
14.86 \-encoding \ \ encoding name
14.87 -入力 HTML ファイルのエンコーディング名を指定します。
14.88 +ュ HTML <ゃ潟潟若c潟医絎障
14.89 .TP 3
14.90 \-Jjavaoption
14.91 -文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数に空白文字を含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリの利用に有効です。
14.92 +絖 \f2javaoption\fP appletviewer 絎茵 Java ゃ潟帥帥 1 ゃ綣違羝<障綣違鴻若鴻障茲違綣違綣違鴻・莨 \f3\-J\fP у阪綽荀障潟潟ゃ絎茵医障<≪若鴻с
14.93 +.RE
14.94 +
14.95 .LP
14.96 .LP
14.97
15.1 --- a/src/linux/doc/man/ja/apt.1 Tue May 12 15:21:55 2009 +0900
15.2 +++ b/src/linux/doc/man/ja/apt.1 Thu May 14 00:17:25 2009 -0700
15.3 @@ -1,179 +1,126 @@
15.4 -'\" t
15.5 -.\"
15.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
15.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
15.8 -.\"
15.9 -.\" This code is free software; you can redistribute it and/or modify it
15.10 -.\" under the terms of the GNU General Public License version 2 only, as
15.11 -.\" published by the Free Software Foundation.
15.12 -.\"
15.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
15.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
15.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
15.17 -.\" accompanied this code).
15.18 -.\"
15.19 -.\" You should have received a copy of the GNU General Public License version
15.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
15.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
15.22 -.\"
15.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
15.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
15.25 -.\" have any questions.
15.26 -.\"
15.27 -.\"
15.28 -.\"
15.29 -.TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
15.30 -.SH "名前"
15.31 -apt \- 注釈処理ツール
15.32 -.\"
15.33 -.SH "形式"
15.34 -.B apt
15.35 -.BI [\-classpath " classpath"]
15.36 -.BI [\-sourcepath " sourcepath"]
15.37 -.BI [\-d " directory"]
15.38 -.BI [\-s " directory"]
15.39 -.BI [\-factorypath " path"]
15.40 -.BI [\-factory " class"]
15.41 -.B [\-print]
15.42 -.B [\-nocompile]
15.43 -.B [\-Akey[=val] ...]
15.44 -.BI [javac option]
15.45 -.BI sourcefiles
15.46 -.BI [@files]
15.47 -.SH "パラメータ"
15.48 -オプションは任意の順序で使用できます。特定のオプションに適用される
15.49 -パラメータについては、後述の「オプション」を参照してください。
15.50 -.if t .TP 20
15.51 -.if n .TP 15
15.52 -.I sourcefiles
15.53 -処理される 0 個以上のソースファイル。
15.54 -.if t .TP 20
15.55 -.if n .TP 15
15.56 -.I @files
15.57 -ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。
15.58 -.SH "機能説明"
15.59 -注釈処理ツール
15.60 -.B apt
15.61 -には、プログラム注釈を処理するための一連の
15.62 -新しいリフレクション API とインフラストラクチャサポートが含まれています。
15.63 -.B apt
15.64 -のリフレクション API では、プログラム構造のビューが、
15.65 -ビルド時のソースベースの読み取り専用として用意されています。
15.66 -これらのリフレクション API は、総称型の追加後に、
15.67 -Java(TM) プログラミング言語の型システムを
15.68 -わかりやすくモデル化できるように設計されました。
15.69 -はじめに、
15.70 -.B apt
15.71 -は注釈プロセッサを実行します。この注釈プロセッサでは、
15.72 -新規のソースコードおよびその他のファイルを生成します。
15.73 -次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、
15.74 -開発を容易にします。ツールと対話するためのリフレクション API と
15.75 -その他の API は、
15.76 -.B com.sun.mirror
15.77 -のサブパッケージです。
15.78 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
15.79 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
15.80 +."
15.81 +." This code is free software; you can redistribute it and/or modify it
15.82 +." under the terms of the GNU General Public License version 2 only, as
15.83 +." published by the Free Software Foundation.
15.84 +."
15.85 +." This code is distributed in the hope that it will be useful, but WITHOUT
15.86 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15.87 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
15.88 +." version 2 for more details (a copy is included in the LICENSE file that
15.89 +." accompanied this code).
15.90 +."
15.91 +." You should have received a copy of the GNU General Public License version
15.92 +." 2 along with this work; if not, write to the Free Software Foundation,
15.93 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
15.94 +."
15.95 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
15.96 +." CA 95054 USA or visit www.sun.com if you need additional information or
15.97 +." have any questions.
15.98 +."
15.99 +.TH apt 1 "04 May 2009"
15.100 +." Generated from HTML by html2man (author: Eric Armstrong)
15.101 +
15.102 .LP
15.103 -.B apt
15.104 -によるツールの操作方法と開発手順についての詳細は、
15.105 -http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
15.106 -の「Getting Started with apt」を参照してください。
15.107 +.SH "NAME"
15.108 .LP
15.109 +.LP
15.110 +\f2apt\fP \- 羈若
15.111 +.LP
15.112 +.SH "綵√"
15.113 +.LP
15.114 +.LP
15.115 +\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...][\f2javac option\fP] sourcefiles [@files]
15.116 +.LP
15.117 +.SH "<若"
15.118 +.LP
15.119 +.LP
15.120 +激с潟筝с劫激с潟<若帥ゃ筝荐激с潟с
15.121 +.LP
15.122 +.RS 3
15.123 .TP 3
15.124 -注:
15.125 -\f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [
15.126 +sourcefiles
15.127 +若1 ゃ障茲違絲乗院純若鴻<ゃ
15.128 +.TP 3
15.129 +@files
15.130 +純若鴻<ゃ障篁激с潟筝荀ц;腓冴 1 ゃ障茲違<ゃ
15.131 +.RE
15.132 +
15.133 +.LP
15.134 +.SH "茯"
15.135 +.LP
15.136 +.LP
15.137 +羈若 \f2apt\fP 違 API 泣若ゃ潟鴻c若罕違羈障\f2apt\fP API 罕膀純若鴻若鴻с違罕≪茯水絨ャ若箴障 API 膩霡違菴遵緇Java(TM) 違潟域茯激鴻罩c≪荐荐障\f2apt\fP 違純若鴻潟若篁<ゃ篏羈祉泣絎茵障罨<\f2apt\fP 純若鴻<ゃ純若鴻<ゃ筝≧鴻潟潟ゃ冴罐純障若ゃ潟帥с若鴻篏睡 API API \f2com.sun.mirror\fP 泣宴若吾с
15.138 +.LP
15.139 +.LP
15.140 +若罘純≪荅括完\f2apt\fP 篏睡堺号ゃ
15.141 .na
15.142 -\f2Solaris と Linux\fP の場合:
15.143 +\f4\fP\f4apt\fP\f3 ラ\fP @
15.144 .fi
15.145 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [
15.146 -.na
15.147 -\f2Windows\fP の場合:
15.148 -.fi
15.149 -http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。
15.150 +http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlс
15.151 .LP
15.152 -.SH "オプション"
15.153 -.SS apt 固有のオプション
15.154 -.if t .TP 20
15.155 -.if n .TP 15
15.156 -.BI \-s " dir"
15.157 -プロセッサが生成するソースファイルが配置されるディレクトリルートを
15.158 -指定します。ファイルはパッケージのネームスペースに従って、
15.159 -サブディレクトリに配置されます。
15.160 -.if t .TP 20
15.161 -.if n .TP 15
15.162 -.BI \-nocompile
15.163 -ソースファイルをクラスファイルにコンパイルしません。
15.164 -.if t .TP 20
15.165 -.if n .TP 15
15.166 -.BI \-print
15.167 -指定した型のテキスト表現を出力します。
15.168 -注釈処理やコンパイルは実行しません。
15.169 -.if t .TP 20
15.170 -.if n .TP 15
15.171 -.BI \-A[key[=val]]
15.172 -注釈プロセッサに渡されるオプション。
15.173 -.B apt
15.174 -は、これらのオプションを直接解釈しませんが、個別のプロセッサ
15.175 -によって使用可能になります。
15.176 -.if t .TP 20
15.177 -.if n .TP 15
15.178 -.BI \-factorypath " path"
15.179 -注釈プロセッサファクトリを検索する場所を指定します。
15.180 -このオプションを使用する場合、ファクトリの検索に
15.181 -クラスパスは使用されません。
15.182 -.if t .TP 20
15.183 -.if n .TP 15
15.184 -.BI \-factory " classname"
15.185 -使用する注釈プロセッサファクトリの名前。
15.186 -デフォルトの検出処理はバイパスされます。
15.187 -.SS javac と共有されるオプション
15.188 -.if t .TP 20
15.189 -.if n .TP 15
15.190 -.BI \-d " dir"
15.191 -プロセッサおよび
15.192 -.B javac
15.193 -が生成したクラスファイルを配置する場所を指定します。
15.194 -.if t .TP 20
15.195 -.if n .TP 15
15.196 -.BI \-cp " path " \fLまたは\fP \fL\-classpath " path"
15.197 -ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を
15.198 -指定します。
15.199 -.B \-factorypath
15.200 -を指定した場合、ファクトリの検索にクラスパスは使用されません。
15.201 +.RS 3
15.202 +.TP 3
15.203 +羈:
15.204 +\f2apt\fP 罘純\f2javac(1)\fP 若筝c羈ゃ潟鴻c若腟粋昭障鴻 Java 潟潟ゃт戎с罔羣障違ゃ潟鴻c若荐茯≪ Java 若筝c羈 API 箴絖障羈祉泣冴違 API \f2javac\fP 若冴ャ茵с障
15.205 +.RE
15.206 +
15.207 .LP
15.208 -javac のオプションについては、
15.209 -.BR javac(1)
15.210 -のマニュアルページを参照してください。
15.211 -.SH 注意事項
15.212 +.SH "激с"
15.213 .LP
15.214 -\f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。
15.215 +.SS
15.216 +apt 堺激с
15.217 .LP
15.218 -.SH "関連項目"
15.219 +.RS 3
15.220 +.TP 3
15.221 +\-s dir
15.222 +祉泣純若鴻<ゃ臀c若絎障 <ゃ宴若吾腥咲冴ャ泣c臀障
15.223 +.TP 3
15.224 +\-nocompile
15.225 +純若鴻<ゃ鴻<ゃ潟潟ゃ障
15.226 +.TP 3
15.227 +\-print
15.228 +絎帥ゃ鴻茵憗阪障 羈障潟潟ゃ茵障
15.229 +.TP 3
15.230 +\-A[key[=val]]
15.231 +羈祉泣御検激с潟с 激с潟\f2apt\fP 贋・茹iс祉泣c篏睡с紊障
15.232 +.TP 3
15.233 +\-factorypath path
15.234 +羈祉泣<罎膣≪贋絎障 激с潟篏睡翫鴻鴻<罎膣≪障
15.235 +.TP 3
15.236 +\-factory classname
15.237 +篏睡羈祉泣<с 罎冴祉鴻ャ障
15.238 +.RE
15.239 +
15.240 +.LP
15.241 +.SS
15.242 +javac 援激с
15.243 +.LP
15.244 +.RS 3
15.245 +.TP 3
15.246 +\-d dir
15.247 +祉泣 javac 鴻<ゃ臀贋絎障
15.248 +.TP 3
15.249 +\-cp path or \-classpath path
15.250 +若吟若鴻<ゃ羈祉泣<罎膣≪贋絎障\f2\-factorypath\fP 絎翫鴻鴻<罎膣≪障
15.251 +.RE
15.252 +
15.253 +.LP
15.254 +.LP
15.255 +\f2javac\fP 激с潟荅括完ゃjavac(1) ャ≪若吾с
15.256 +.LP
15.257 +.SH "羈"
15.258 +.LP
15.259 +.LP
15.260 +\f2apt\fP 罘純\f2javac\fP 箴罔羣羈ゃ潟鴻c若腟粋昭障障篁緇 JDK 若鴻с\f2apt\fP 渇∫c API 泣若筝罩≪醇с障
15.261 +.LP
15.262 +.SH "∫i"
15.263 .LP
15.264 .RS 3
15.265 .TP 2
15.266 -*
15.267 -javac: [
15.268 -.na
15.269 -\f2Solaris と Linux\fP の場合:
15.270 -.fi
15.271 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html]
15.272 -[ \f2Windows\fP の場合:
15.273 -.fi
15.274 -http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html]
15.275 -.TP 2
15.276 -*
15.277 -java: [
15.278 -.na
15.279 -\f2Solaris\fP の場合:
15.280 -.fi
15.281 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
15.282 -.na
15.283 -\f2Linux\fP の場合:
15.284 -.fi
15.285 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html]
15.286 -[ \f2Windows\fP の場合:
15.287 -.fi
15.288 -http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html]
15.289 +o
15.290 +javac(1), java(1)
15.291 .RE
15.292
15.293 .LP
16.1 --- a/src/linux/doc/man/ja/extcheck.1 Tue May 12 15:21:55 2009 +0900
16.2 +++ b/src/linux/doc/man/ja/extcheck.1 Thu May 14 00:17:25 2009 -0700
16.3 @@ -1,109 +1,88 @@
16.4 -'\" t
16.5 -.\"
16.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
16.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
16.8 -.\"
16.9 -.\" This code is free software; you can redistribute it and/or modify it
16.10 -.\" under the terms of the GNU General Public License version 2 only, as
16.11 -.\" published by the Free Software Foundation.
16.12 -.\"
16.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
16.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
16.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
16.17 -.\" accompanied this code).
16.18 -.\"
16.19 -.\" You should have received a copy of the GNU General Public License version
16.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
16.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
16.22 -.\"
16.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
16.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
16.25 -.\" have any questions.
16.26 -.\"
16.27 -.\" `
16.28 -'\"macro stdmacro
16.29 -.TH extcheck 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
16.30 -.SH "名前"
16.31 -extcheck \- jar の競合検出ユーティリティ
16.32 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
16.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
16.34 +."
16.35 +." This code is free software; you can redistribute it and/or modify it
16.36 +." under the terms of the GNU General Public License version 2 only, as
16.37 +." published by the Free Software Foundation.
16.38 +."
16.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
16.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
16.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16.42 +." version 2 for more details (a copy is included in the LICENSE file that
16.43 +." accompanied this code).
16.44 +."
16.45 +." You should have received a copy of the GNU General Public License version
16.46 +." 2 along with this work; if not, write to the Free Software Foundation,
16.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
16.48 +."
16.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
16.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
16.51 +." have any questions.
16.52 +."
16.53 +.TH extcheck 1 "04 May 2009"
16.54 +." Generated from HTML by html2man (author: Eric Armstrong)
16.55 +
16.56 +.LP
16.57 +.SH ""
16.58 +extcheck \- jar 腴九罎冴若cc
16.59 +.LP
16.60 +.RS 3
16.61 +
16.62 +.LP
16.63 +.LP
16.64 +\f3extcheck\fP 帥若蚊 jar <ゃ憜ゃ潟鴻若≦宍罘純 jar <ゃ若吾с潟腴九罎冴障
16.65 +.LP
16.66 +.RE
16.67 +.SH "綵√"
16.68 .LP
16.69
16.70 .LP
16.71 +.nf
16.72 +\f3
16.73 +.fl
16.74 +extcheck [ \-verbose ] targetfile.jar
16.75 +.fl
16.76 +\fP
16.77 +.fi
16.78 +
16.79 .LP
16.80 -\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
16.81 +.SH "茯"
16.82 .LP
16.83 -.SH "形式"
16.84 -.B extcheck
16.85 -[
16.86 -.B \-verbose
16.87 -]
16.88 -.B targetfile.jar
16.89 -.SH "機能説明"
16.90 -.IX "jar conflict detection utility" "" "jar conflict detection utility \(em \fLextcheck\fP"
16.91 -.IX "extcheck" "" "\fLextcheck\fP \(em jar conflict detection utility"
16.92 -.B extcheck
16.93 -ユーティリティは、指定された
16.94 -.B jar
16.95 -ファイルのタイトルおよびバージョンが Java(TM) SDK
16.96 -ソフトウェアにインストールされている拡張機能と競合していないかを
16.97 -検査します。
16.98 -拡張機能をインストールする前に、このユーティリティを使って、
16.99 -バージョンが同じか、
16.100 -より新しい拡張機能がすでにインストールされていないかどうかを調べる
16.101 -ことができます。
16.102 +
16.103 .LP
16.104 -.B extcheck
16.105 -ユーティリティは、
16.106 -.I targetfile.jar
16.107 -ファイルのマニフェスト内のヘッダ
16.108 -.I Specification-title
16.109 -および
16.110 -.I Specification-version
16.111 -を、拡張機能ディレクトリ内に現在インストールされているすべての jar
16.112 -ファイル内の対応するヘッダと比較します。
16.113 -デフォルトでは、拡張機能ディレクトリは、
16.114 -.I jre/lib/ext
16.115 -です。
16.116 -.B extcheck
16.117 -ユーティリティは、
16.118 -.I java.lang.Package.isCompatibleWith
16.119 -メソッドと同様の方法でバージョン番号を比較します。
16.120 .LP
16.121 -競合が検出されない場合、リターンコードは
16.122 -.I 0 です。
16.123 +\f3extcheck\fP 若cc若絎 Jar <ゃ帥ゃ潟若吾с潟 Java(TM) 2 SDK ゃ潟鴻若≦宍罘純腴九с障≦宍罘純ゃ潟鴻若若cc若篏帥c若吾с潟違≦宍罘純сゃ潟鴻若茯帥鴻с障
16.124 .LP
16.125 -拡張機能ディレクトリ内の
16.126 -.B jar
16.127 -ファイルのマニフェストに、同一の
16.128 -.I Specification-title、
16.129 -および同一またはより新しい
16.130 -.I Specification-version
16.131 -番号がある場合、ゼロでないエラー
16.132 -コードが返されます。
16.133 -.I targetfile.jar
16.134 -のマニフェストに
16.135 -.I Specification-title
16.136 -または
16.137 -.I Specification-version
16.138 -属性がない場合も、ゼロでないエラーコードが返されます。
16.139 -.SH "オプション"
16.140 -以下のオプションが指定できます。
16.141 -.TP 15
16.142 -.B -verbose
16.143 -拡張機能ディレクトリ内の
16.144 -.B jar
16.145 -ファイルを、検査時に一覧表示します。また、ターゲット
16.146 -.B jar
16.147 -ファイルのマニフェストの属性、および競合する
16.148 -.B jar
16.149 -ファイルについても報告します。
16.150 -.TP 15
16.151 -.BI \-J "option"
16.152 -.I option
16.153 -を Java 仮想マシンに渡します。ここで、
16.154 -.I option
16.155 -は、Java アプリケーション起動プログラム java(1) のマニュアルページで
16.156 -説明されているオプションの 1 つです。たとえば、-J-Xms48m
16.157 -は、起動時に使用するメモリを 48M バイトに設定します。
16.158 -.SH "関連項目"
16.159 -.BR jar (1)
16.160 +.LP
16.161 +\f3extcheck\fP 若cc若\f2targetfile.jar\fP <ゃс鴻 \f2Specification\-title\fP \f2Specification\-version\fP ≦宍罘純c憜ゃ潟鴻若鴻 Jar <ゃ絲上若罸莠障с≦宍罘純c\f2jre/lib/ext\fP с\f3extcheck\fP 若cc若\f2java.lang.Package.isCompatibleWith\fP <純罕号с若吾с括垩罸莠障
16.162 +.LP
16.163 +.LP
16.164 +腴九罎冴翫帥若潟潟若 \f20\fP с
16.165 +.LP
16.166 +.LP
16.167 +≦宍罘純c jar <ゃс鴻筝 \f2Specification\-title\fP喝筝障違 \f2Specification\-version\fP 垩翫若с若潟若菴障\f2targetfile.jar\fP с鴻 \f2Specification\-title\fP 障 \f2Specification\-version\fP 絮с翫若с若潟若菴障
16.168 +.LP
16.169 +.SH "激с"
16.170 +.LP
16.171 +
16.172 +.LP
16.173 +.RS 3
16.174 +.TP 3
16.175 +\-verbose
16.176 +≦宍罘純c Jar <ゃс筝荀ц;腓冴障障帥若蚊 jar <ゃс鴻絮с括九 jar <ゃゃ怨障
16.177 +.TP 3
16.178 +\-Joption
16.179 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
16.180 +.RE
16.181 +
16.182 +.LP
16.183 +.SH "∫i"
16.184 +.LP
16.185 +
16.186 +.LP
16.187 +.LP
16.188 +jar(1)
16.189 +.LP
16.190 +
16.191 +.LP
16.192 +
17.1 --- a/src/linux/doc/man/ja/idlj.1 Tue May 12 15:21:55 2009 +0900
17.2 +++ b/src/linux/doc/man/ja/idlj.1 Thu May 14 00:17:25 2009 -0700
17.3 @@ -1,203 +1,112 @@
17.4 -'\" t
17.5 -.\"
17.6 -.\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
17.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
17.8 -.\"
17.9 -.\" This code is free software; you can redistribute it and/or modify it
17.10 -.\" under the terms of the GNU General Public License version 2 only, as
17.11 -.\" published by the Free Software Foundation.
17.12 -.\"
17.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
17.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
17.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
17.17 -.\" accompanied this code).
17.18 -.\"
17.19 -.\" You should have received a copy of the GNU General Public License version
17.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
17.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
17.22 -.\"
17.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
17.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
17.25 -.\" have any questions.
17.26 -.\"
17.27 -.\"
17.28 -.\"
17.29 -.TH idlj 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
17.30 -.SH "名前"
17.31 -idlj - IDL-to-Java コンパイラ
17.32 -.LP
17.33 -.B idlj
17.34 -は、指定された IDL ファイルから Java バインディングを生成します。
17.35 -.SH "形式"
17.36 -.B idlj
17.37 -[
17.38 -.IB options
17.39 -]
17.40 -.B idl-file
17.41 -.LP
17.42 -.BR idl-file
17.43 -には、Interface Definition Language (IDL) 定義が格納されている
17.44 -ファイルの名前を指定します。
17.45 -.BR Options
17.46 -は任意の順序で指定できますが、
17.47 -.BR idl-file
17.48 -よりも前に指定する必要があります。
17.49 -.SH "機能説明"
17.50 -IDL-to-Java コンパイラは、指定された IDL ファイルに対して Java
17.51 -バインディングを生成します。
17.52 -バインディングの詳細は、「\f2OMG IDL to Java Language Language Mapping Specification\fP」
17.53 -.fi
17.54 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html)
17.55 -を参照してください。
17.56 -IDL-to-Java コンパイラの旧リリースのなかには、
17.57 -.BR idltojava という名前が付けられていたものがあります。
17.58 -.SH "クライアントバインディングとサーババインディングの発行"
17.59 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
17.60 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
17.61 +."
17.62 +." This code is free software; you can redistribute it and/or modify it
17.63 +." under the terms of the GNU General Public License version 2 only, as
17.64 +." published by the Free Software Foundation.
17.65 +."
17.66 +." This code is distributed in the hope that it will be useful, but WITHOUT
17.67 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
17.68 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17.69 +." version 2 for more details (a copy is included in the LICENSE file that
17.70 +." accompanied this code).
17.71 +."
17.72 +." You should have received a copy of the GNU General Public License version
17.73 +." 2 along with this work; if not, write to the Free Software Foundation,
17.74 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
17.75 +."
17.76 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
17.77 +." CA 95054 USA or visit www.sun.com if you need additional information or
17.78 +." have any questions.
17.79 +."
17.80 +.TH idlj 1 "04 May 2009"
17.81 +." Generated from HTML by html2man (author: Eric Armstrong)
17.82
17.83 .LP
17.84 -.BR My.idl
17.85 -という名前の IDL ファイルに対して Java バインディングを生成
17.86 -するには、次のように指定します。
17.87 +.SH ""
17.88 +idlj \- IDL\-to\-Java 潟潟ゃ
17.89 .LP
17.90 -.RS
17.91 -.ft 3
17.92 +.RS 3
17.93 +
17.94 +.LP
17.95 +\f3idlj\fP 絎 IDL <ゃ Java ゃ潟c潟違障
17.96 +.RE
17.97 +.SH "綵√"
17.98 +.LP
17.99 +
17.100 +.LP
17.101 .nf
17.102 -idlj My.idl
17.103 +\f3
17.104 +.fl
17.105 +idlj [ \fP\f3options\fP\f3 ] \fP\f4idl\-file\fP\f3
17.106 +.fl
17.107 +\fP
17.108 .fi
17.109 -.ft 1
17.110 -.RE
17.111 +
17.112 .LP
17.113 -クライアント側のバインディングを生成する上記のコマンドは、
17.114 -次のようにも指定できます。
17.115 .LP
17.116 -.RS
17.117 -.ft 3
17.118 -.nf
17.119 -idlj -fclient My.idl
17.120 +\f2idl\-file\fP ゃ潟帥с若劫臂荐茯 (IDL) 絎臂ャc<ゃс\f2options\fP 篁紙с\f2idl\-file\fP 絎違障
17.121 +.LP
17.122 +.SH "茯"
17.123 +.LP
17.124 +
17.125 +.LP
17.126 +IDL\-to\-Java 潟潟ゃ絎 IDL <ゃゃ Java ゃ潟c潟違障 ゃ潟c潟違荅括完
17.127 +.na
17.128 +\f2OMG IDL to Java Language Mapping Specification\fP @
17.129 .fi
17.130 -.ft 1
17.131 -.RE
17.132 +http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html сIDL\-to\-Java 潟潟ゃ篁ュ若鴻筝\f2idltojava\fP c障
17.133 +.SS
17.134 +ゃ≪潟ゃ潟c潟違潟泣若若ゃ潟c潟違肴
17.135 .LP
17.136 -クライアント側のバインディングには、サーバ側のスケルトンは
17.137 -取り込まれていません。インタフェースに対してサーバ側のバインディング
17.138 -を生成するには、次のように指定します。
17.139 +.RS 3
17.140 +
17.141 .LP
17.142 -.RS
17.143 -.ft 3
17.144 -.nf
17.145 -idlj -fserver My.idl
17.146 +My.idl IDL <ゃ絲障 Java ゃ潟c潟違罨<潟潟絎茵障 \f2idlj My.idl\fP
17.147 +.LP
17.148 +ゃ≪潟眼ゃ潟c潟違障 潟潟罨<潟潟膈箴<с \f2idlj \fP\f4\-fclient\fP\f2 My.idl\fP
17.149 +.LP
17.150 +ゃ≪潟眼ゃ潟c潟違泣若弱眼鴻宴潟腟粋昭障障ゃ潟帥с若鴻絲障泣若弱眼ゃ潟c潟違罨<潟潟絎茵障 \f2idlj \fP\f4\-fserver\fP\f2 My.idl\fP
17.151 +.LP
17.152 +泣若弱眼ゃ潟c潟違ゃ≪潟眼ゃ潟c潟違鴻宴潟腟粋昭障障 鴻 \f2POA\fP (膓帥≪) 鴻сゃ≪潟眼泣若弱眼筝≧鴻ゃ潟c潟違翫罨<潟潟 (膈箴) < 1 ゃ篏睡障 \f2idlj \fP\f4\-fclient \-fserver\fP\f2 My.idl\fP
17.153 +.br
17.154 +\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
17.155 +.LP
17.156 +.LP
17.157 +泣若弱眼≪2 ゃ≪純с膓帥≪Tie 紮茘蚊≪с
17.158 +.LP
17.159 +.LP
17.160 +泣若弱眼≪腱紙純泣若潟膓帥≪с\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2MyPOA.java\fP <ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyPOA\fP 膓帥綽荀障
17.161 +.LP
17.162 +.LP
17.163 +\f2MyPOA.java\fP
17.164 +.na
17.165 +\f2org.omg.PortableServer.Servant\fP @
17.166 .fi
17.167 -.ft 1
17.168 -.RE
17.169 +http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html ≦宍鴻若若鴻鴻宴潟с鴻宴潟絎茖 IDL ゃ潟帥с若鴻∫d \f2InvokeHandler\fP ゃ潟帥с若鴻若激с潟ゃ潟帥с若鴻絎茖障
17.170 .LP
17.171 -サーバ側のバインディングには、クライアント側のバインディングのほか
17.172 -にスケルトンが取り込まれています。これらはすべて、POA (継承モデル)
17.173 -クラスです。クライアント側とサーバ側の両方のバインディングを生成する
17.174 -には、以下の等価コマンドのどちらか一方を使用してください。
17.175 -.LP
17.176 -.RS
17.177 -.ft 3
17.178 -.nf
17.179 -idlj -fclient -fserver My.idl
17.180 -.br
17.181 -idlj -fall My.idl
17.182 -.fi
17.183 -.ft 1
17.184 -.RE
17.185 -.LP
17.186 -サーバ側モデルとしては、継承モデルと Tie 委譲モデルの 2 種類を
17.187 -利用できます。
17.188 -.LP
17.189 -デフォルトのサーバ側モデルは、ポータブルサーバント継承モデルです。
17.190 -.BR My.idl
17.191 -でインタフェース My が定義されていると、ファイル
17.192 -.BR MyPOA.java が生成されます。ユーザは、
17.193 -.BR My に対してその実装を提供する必要があります。この実装は、
17.194 -.BR MyPOA から継承しなければなりません。
17.195 -.LP
17.196 -.BR MyPOA.java は、
17.197 -.na
17.198 -\f2org.omg.PortableServer.Servant\fP
17.199 -.fi
17.200 -(http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html)
17.201 -を拡張するストリームベースのスケルトンであり、このスケルトンが実装する
17.202 -IDL インタフェースに関連した
17.203 -.BR InvokeHandler
17.204 -インタフェースとオペレーションインタフェースを実装します。
17.205 .LP
17.206 .na
17.207 -\f2Portable Object Adapter (POA)\fP
17.208 +\f2Portable Object Adapter (POA)\fP @
17.209 .fi
17.210 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html) の
17.211 -.BR PortableServer
17.212 -モジュールは、ネイティブ Servant 型を定義します。Java プログラミング言語では、
17.213 -.BR Servant
17.214 -型は、Java
17.215 -.BR org.omg.PortableServer.Servant
17.216 -クラスにマップされます。
17.217 -これはすべての
17.218 -.BR POA
17.219 -サーバント実装の基底クラスとして機能し、アプリケーション開発者が呼び出せる
17.220 -多数のメソッドを提供します。また、POA 自体が呼び出したり、サーバント動作を
17.221 -制御するためにユーザが上書きしたりできるメソッドも提供します。
17.222 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html \f2PortableServer\fP ≪吾ャ若ゃc \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違<純箴障 <純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫c泣若潟篏九勝若吟若若若ゃ障
17.223 .LP
17.224 -継承モデルには、J2SE 1.4 より前のバージョンの Java プログラミング言語
17.225 -と互換性のあるサーバ側バインディングを生成するために
17.226 -.BR -oldImplBase
17.227 -フラグを使用するというオプションもあります。
17.228 -\f2\-oldImplBase\fP フラグの使用は非標準であることに注意してください。これらの API はまもなく非推奨となります。このフラグを使用するのは、J2SE 1.3 で記述された既存のサーバとの互換性を確保する必要がある場合だけにしてください。その場合、既存の MAKEFILE を変更し、\f2\-oldImplBase\fP フラグを \f2idlj\fP コンパイラに追加する必要があります。そうしないと、POA ベースのサーバ側マッピングが生成されてしまいます。
17.229 -下位互換を維持したサーバ側
17.230 -バインディングを生成するには、次のように指定します。
17.231 .LP
17.232 -.RS
17.233 -.ft 3
17.234 -.nf
17.235 -idlj -fclient -fserver -oldImplBase My.idl
17.236 +膓帥≪ 1 ゃ激с潟\f2\-oldImplBase\fP 違篏睡J2SE 1.4 若吾с潟 Java 違潟域茯篋с泣若弱眼ゃ潟c潟違с\f2\-oldImplBase\fP 違篏睡罔羣羈с障 API ィ絅障違篏睡J2SE 1.3 ц菴違√泣若若篋с篆ゅ翫с翫√ MAKEFILE 紊眼 \f2idlj\fP 潟潟ゃ \f2\-oldImplBase\fP 違菴遵綽荀障 違菴遵翫POA 若鴻泣若弱眼潟違障筝篏篋с泣若弱眼ゃ潟c潟違罨<潟潟篏睡障
17.237 +.LP
17.238 +\f2idlj \fP\f4\-fclient \-fserver\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
17.239 .br
17.240 -idlj -fall -oldImplBase My.idl
17.241 -.fi
17.242 -.ft 1
17.243 -.RE
17.244 +\f2idlj \fP\f4\-fall\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
17.245 .LP
17.246 -.BR My.idl
17.247 -内でインタフェース My が定義されていると、ファイル
17.248 -.I _MyImpleBase.java
17.249 -が生成されます。ユーザは、
17.250 -.BR My
17.251 -に対してその実装を提供する必要があります。この実証は、
17.252 -.I _MyImplBase
17.253 - から継承しなければなりません。
17.254 +\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2_MyImplBase.java\fP <ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyImplBase\fP 膓帥違障
17.255 .LP
17.256 -もう一方のサーバ側モデルは、Tie モデルと呼ばれます。これは、
17.257 -委譲モデルです。Tie モデルは Tie とスケルトンを同時には生成
17.258 -できないため、これらは別々に生成する必要があります。次のコ
17.259 -マンドは、Tie モデルに対してバインディングを生成します。
17.260 + 1 ゃ泣若弱眼≪Tie ≪若違с泣若弱眼≪紮茘蚊≪сTie 鴻宴潟сャ違障罨<潟潟cTie ≪ゃ潟c潟違障
17.261 .LP
17.262 -.RS
17.263 -.ft 3
17.264 -.nf
17.265 -idlj -fall My.idl
17.266 +\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
17.267 .br
17.268 -idlj -fallTIE My.idl
17.269 -.fi
17.270 -.ft 1
17.271 -.RE
17.272 +\f2idlj \fP\f4\-fallTIE\fP\f2 My.idl\fP
17.273 .LP
17.274 -インタフェース
17.275 -.BR My
17.276 -の場合、2 つめのコマンドは
17.277 -.BR MyPOATie.java
17.278 - を生成します。
17.279 -.BR MyPOATie
17.280 -のコンストラクタは、delegate を受け取ります。
17.281 -この例ではデフォルトの POA モデルを使用しているので、コンストラクタは \f2poa\fP も必要とします。
17.282 -ユーザは、delegate
17.283 -に対して実装を提供する必要があります。ただし、インタフェース
17.284 -.BR MyOperations
17.285 -を継承すればよく、ほかのクラスから継承する必要はありません。
17.286 -しかし、この実装を ORB と共に使用するには、
17.287 -.BR MyPOATie
17.288 -内に実装をラップする必要があります。例を示します。
17.289 +\f2My\fP ゃ潟帥с若鴻翫筝荐 2 潟潟\f2MyPOATie.java\fP 障\f2MyPOATie\fP 潟潟鴻帥\f2delegate\fP 障箴с POA ≪篏睡潟潟鴻帥 \f2poa\fP 綽荀с\f2delegate\fP 絲障絎茖箴違障絎茖 \f2MyOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2MyPOATie\fP у茖違障違罨<障
17.290 .nf
17.291 \f3
17.292 .fl
17.293 @@ -205,7 +114,7 @@
17.294 .fl
17.295
17.296 .fl
17.297 - // rootpoa への参照を取得し、POAManager を有効にします
17.298 + // Get reference to rootpoa & activate the POAManager
17.299 .fl
17.300 POA rootpoa = (POA)orb.resolve_initial_references("RootPOA");
17.301 .fl
17.302 @@ -213,7 +122,7 @@
17.303 .fl
17.304
17.305 .fl
17.306 - // サーバントを作成し、それを ORB に登録します
17.307 + // create servant and register it with the ORB
17.308 .fl
17.309 MyServant myDelegate = new MyServant();
17.310 .fl
17.311 @@ -221,13 +130,13 @@
17.312 .fl
17.313
17.314 .fl
17.315 - // Tie を作成します。サーバントが delegate になります。
17.316 + // create a tie, with servant being the delegate.
17.317 .fl
17.318 MyPOATie tie = new MyPOATie(myDelegate, rootpoa);
17.319 .fl
17.320
17.321 .fl
17.322 - // Tie の objectRef を取得します
17.323 + // obtain the objectRef for the tie
17.324 .fl
17.325 My ref = tie._this(orb);
17.326 .fl
17.327 @@ -235,45 +144,16 @@
17.328 .fi
17.329
17.330 .LP
17.331 -実装をほかの実装から継承しなければならない場合は、標準の継承モデル
17.332 -の代わりに Tie モデルを使用することもできます。Java は任意の数の
17.333 -インタフェース継承を認めていますが、クラスの継承に使用できる
17.334 -スロットは 1 つだけです。継承モデルを使用すると、このスロットが占
17.335 -有されます。Tie モデルを使用すると、スロットをユーザ自身の使用の
17.336 -ために解放できます。ただし、一定レベルの間接参照を引き起こすと
17.337 -いう欠点があります。つまり、メソッドを呼び出すと、余分なメソッド呼
17.338 -び出しが 1 つ発生します。
17.339 +篁絎茖膓帥違翫罔羣膓帥≪с Tie ≪篏睡障Java 翫ゃ潟帥с若鴻膓帥違狗障鴻膓帥篏睡с鴻 1 ゃс膓帥≪篏睡翫鴻障Tie ≪篏睡翫鴻篏睡若吟若т戎с障・с 1 ゅャ罨鴻障ゃ障<純若喝冴篏<純若喝冴榊障
17.340 .LP
17.341 -1.4 よりも前の J2SE バージョンで IDL-to-Java 言語
17.342 -マッピングのバージョンと互換性があるサーバ側の Tie モデルバインディングを生成
17.343 -するには、次のように指定します。
17.344 +IDL 若吾с潟 J2SE 1.4 若吾с潟 Java 荐茯吾潟違篋с泣若弱眼 Tie ≪ゃ潟c潟違罨<潟潟篏睡障
17.345 .LP
17.346 -.RS
17.347 -.ft 3
17.348 -.nf
17.349 -idlj -oldImplBase -fall My.idl
17.350 +\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fall\fP\f2 My.idl\fP
17.351 .br
17.352 -idlj -oldImplBase -fallTIE My.idl
17.353 -.fi
17.354 -.ft 1
17.355 -.RE
17.356 +\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fallTIE\fP\f2 My.idl\fP
17.357 .LP
17.358 -インタフェース
17.359 -.BR My
17.360 -の場合、このコマンドは
17.361 -.I My_Tie.java
17.362 -を生成します。
17.363 -.I My_Tie
17.364 -のコンストラクタは、
17.365 -.BR impl
17.366 -を受け取ります。ユーザは、
17.367 -.BR impl
17.368 -に対して実装を提供する必要があります。ただし、インタフェース
17.369 -.BR HelloOperations
17.370 -を継承すればよく、ほかのクラスから継承する必要はありません。
17.371 -しかし、この実装を ORB と共に使用するには、
17.372 -.BR My_Tie
17.373 - 内に実装をラップする必要があります。例を示します。
17.374 +.LP
17.375 +\f2My\fP ゃ潟帥с若鴻翫 \f2My_Tie.java\fP 障\f2My_Tie\fP 潟潟鴻帥\f2impl\fP 障\f2impl\fP 絲障絎茖箴違障絎茖 \f2HelloOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2My_Tie\fP у茖違障違罨<障
17.376 .LP
17.377 .nf
17.378 \f3
17.379 @@ -282,7 +162,7 @@
17.380 .fl
17.381
17.382 .fl
17.383 - // サーバントを作成し、それを ORB に登録します
17.384 + // create servant and register it with the ORB
17.385 .fl
17.386 MyServant myDelegate = new MyServant();
17.387 .fl
17.388 @@ -290,13 +170,13 @@
17.389 .fl
17.390
17.391 .fl
17.392 - // Tie を作成します。サーバントが delegate になります。
17.393 + // create a tie, with servant being the delegate.
17.394 .fl
17.395 MyPOATie tie = new MyPOATie(myDelegate);
17.396 .fl
17.397
17.398 .fl
17.399 - // Tie の objectRef を取得します
17.400 + // obtain the objectRef for the tie
17.401 .fl
17.402 My ref = tie._this(orb);
17.403 .fl
17.404 @@ -304,451 +184,235 @@
17.405 .fi
17.406
17.407 .LP
17.408 -.SH "発行されたファイルの代替場所の指定"
17.409 -.br
17.410 -発行されたファイルを現在のディレクトリ以外のディレクトリに保存したい場合は、
17.411 -次のようにコンパイラを呼び出してください。
17.412 +.RE
17.413 +.SS
17.414 +肴<ゃ篁f推臀絎
17.415 .LP
17.416 -.RS
17.417 -.ft 3
17.418 -.nf
17.419 -idlj -td /altdir My.idl
17.420 -.fi
17.421 -.ft 1
17.422 -.RE
17.423 -.LP
17.424 -インタフェース
17.425 -.BR My
17.426 -の場合、バインディングは
17.427 -.BR ./My.java
17.428 - ではなく
17.429 -.BR /altdir/My.java
17.430 -などに対して発行されます。
17.431 -.SH "インクルードファイルの代替場所の指定"
17.432 -.BR My.idl
17.433 -にほかの idl ファイル、
17.434 -.BR MyOther.idl
17.435 -が取り込まれている場合、コンパイラは
17.436 -.BR MyOther.idl
17.437 -がローカルディレクトリに存在すると見なします。たとえば、
17.438 -.BR MyOther.idl
17.439 -が
17.440 -.BR /includes
17.441 -に存在する場合は、次のコマンドでコンパイラを呼び出します。
17.442 -.LP
17.443 -.RS
17.444 -.ft 3
17.445 -.nf
17.446 -idlj -i /includes My.idl
17.447 -.fi
17.448 -.ft 1
17.449 -.RE
17.450 -.LP
17.451 -.BR たとえば、My.idl が
17.452 -.BR /moreIncludes
17.453 -に存在する
17.454 -.BR Another.idl
17.455 -も取り込んでいる場合は、次のコマンドでコンパイラを呼び出します。
17.456 -.LP
17.457 -.RS
17.458 -.ft 3
17.459 -.nf
17.460 -idlj -i /includes -i /moreIncludes My.idl
17.461 -.fi
17.462 -.ft 1
17.463 -.RE
17.464 -.LP
17.465 -この形式でファイルを取り込むと、コマンドが非常に長くなることがあります。
17.466 -このため、インクルードファイルの検索場所をコンパイラに知らせる方法が
17.467 -別に用意されています。この方法は、環境変数の概念に似ています。まず、
17.468 -CLASSPATH にリストされているディレクトリ内に、
17.469 -.BR idl.config
17.470 -という名前のファイルを作成します。そして、
17.471 -.BR idl.config
17.472 -内に次の形式の行を 1 つ作成します。
17.473 -.LP
17.474 -.RS
17.475 -.ft 3
17.476 -.nf
17.477 -includes=/includes;/moreIncludes
17.478 -.fi
17.479 -.ft 1
17.480 -.RE
17.481 -.LP
17.482 -コンパイラはこのファイルを見つけ、インクルードリストに読み込みます。
17.483 -この例では 2 つのディレクトリ間の区切り文字はセミコロン (;) であること
17.484 -に注意してください。
17.485 -この区切り文字はプラットフォームによって異なります。Windows プラットフォームではセミコロンを使用し、UNIX プラットフォームではコロンを使用する、などのようになります。
17.486 -インクルードの詳
17.487 -細は、
17.488 -.na
17.489 -\f2CLASSPATH\ のドキュメント (Solaris:
17.490 -.fi
17.491 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/classpath.html)
17.492 -(Windows:
17.493 -.fi
17.494 -http://java.sun.com/javase/6/docs/technotes/tools/windows/classpath.html)
17.495 -を参照してください。
17.496 -.SH "インクルードファイルに対するバインディングの発行"
17.497 -デフォルトでは、コマンド行 idl ファイルに定義されているインタフェース、
17.498 -構造体などに対してのみ、Java バインディングが生成されます。インクルード
17.499 -ファイルに定義されているタイプの Java バインディングは生成されません。
17.500 -例として、次の 2 つの idl ファイルを考えてみましょう。
17.501 -.TP
17.502 -.B My.idl
17.503 -.LP
17.504 -.RS
17.505 -#include <MyOther.idl>
17.506 -.br
17.507 -interface My
17.508 -.br
17.509 -{
17.510 -.br
17.511 -};
17.512 -.RE
17.513 -.TP
17.514 -.B MyOther.idl
17.515 -.LP
17.516 -.RS
17.517 -interface MyOther
17.518 -.br
17.519 -{
17.520 -.br
17.521 -};
17.522 -.RE
17.523 -.LP
17.524 -次のコマンドは、
17.525 -.BR My
17.526 -に対する Java バインディングしか生成しません。
17.527 -.LP
17.528 -.RS
17.529 -.ft 3
17.530 -.nf
17.531 -idlj My.idl
17.532 -.fi
17.533 -.ft 1
17.534 -.RE
17.535 -.LP
17.536 -.BR My.idl
17.537 -内に定義されているすべてのタイプ、および
17.538 -.BR My.idl
17.539 -に取り込まれているファイル (この例では
17.540 -.BR MyOther.idl
17.541 -) 内に定義されているすべてのタイプを生成するには、
17.542 -次のコマンドを使用してください。
17.543 -.LP
17.544 -.RS
17.545 -.ft 3
17.546 -.nf
17.547 -idlj -emitAll My.idl
17.548 -.fi
17.549 -.ft 1
17.550 -.RE
17.551 -.LP
17.552 -このデフォルトの規則については、次の点に注意する必要があります。
17.553 -グローバルスコープに出現する
17.554 -.BR #include
17.555 -文は、記述どおりに処理されます。これらの
17.556 -.BR #include
17.557 -文は、インポート文と見なすことができます。一部の囲みスコープ内に
17.558 -出現する #include 文は、通常の
17.559 -.BR #include
17.560 -文として扱われます。つまり、インクルードファイル内のコードは
17.561 -オリジナルファイル内に出現しているかのように扱われ、これに
17.562 -対して Java バインディングが発行されます。例を示します。
17.563 -.TP
17.564 -.B My.idl
17.565 -.LP
17.566 -.RS
17.567 -#include <MyOther.idl>
17.568 -.br
17.569 -interface My
17.570 -.br
17.571 -{
17.572 -.br
17.573 - #include <Embedded.idl>
17.574 -.br
17.575 -};
17.576 -.RE
17.577 -.TP
17.578 -.B MyOther.idl
17.579 -.LP
17.580 -.RS
17.581 -interface MyOther
17.582 -.br
17.583 -{
17.584 -.br
17.585 -};
17.586 -.RE
17.587 -.TP
17.588 -.B Embedded.idl
17.589 -.LP
17.590 -.RS
17.591 -enum E {one, two, three};
17.592 -.RE
17.593 -.LP
17.594 -次のコマンドを実行すると、
17.595 -.LP
17.596 -.RS
17.597 -.ft 3
17.598 -.nf
17.599 -idlj My.idl
17.600 -.fi
17.601 -.ft 1
17.602 -.RE
17.603 -.LP
17.604 -以下の Java ファイルのリストが生成されます。
17.605 -.LP
17.606 -.B ./MyHolder.java\fP
17.607 -.br
17.608 -.B ./MyHelper.java\fP
17.609 -.br
17.610 -.B ./_MyStub.java\fP
17.611 -.br
17.612 -.B ./MyPackage\fP
17.613 -.br
17.614 -.B ./MyPackage/EHolder.java\fP
17.615 -.br
17.616 -.B ./MyPackage/EHelper.java\fP
17.617 -.br
17.618 -.B ./MyPackage/E.java\fP
17.619 -.br
17.620 -.B ./My.java\fP
17.621 -.LP
17.622 -.BR MyOther.java
17.623 -は生成されないことに注意してください。これは、インポートに類似した
17.624 -.BR #include
17.625 -で定義されているためです。しかし、通常の
17.626 -.BR #include
17.627 -に定義された
17.628 -.BR E.java
17.629 -は生成されます。
17.630 -.BR Embedded.idl
17.631 -はインタフェース My のスコープ内に取り込まれているため、
17.632 -.BR My
17.633 -のスコープ内 (つまり
17.634 -.BR MyPackage
17.635 -) に生成されます。
17.636 -.LP
17.637 -上記の例で
17.638 -.BI -emitAll
17.639 -フラグが使用されていた場合は、すべてのインクルードファイル内に
17.640 -定義されているすべてのタイプが発行されます。
17.641 -.SH "パッケージ接頭辞の挿入"
17.642 -あなたが次の IDL ファイルを作成した ABC という名の企業に勤務していると
17.643 -仮定してください。
17.644 -.TP
17.645 -.B Widgets. idl
17.646 -module Widgets
17.647 -.br
17.648 -{
17.649 -.br
17.650 - interface W1 {...};
17.651 -.br
17.652 - interface W2 {...};
17.653 -.br
17.654 -};
17.655 -.LP
17.656 -このファイルに対して IDL-to-Java コンパイラを実行すると、パッケージ
17.657 -Widgets 内の W1 と W2 に対して Java バインディングが生成されます。
17.658 -しかし、業界規約では、企業のパッケージは
17.659 -.BR com.<company name>
17.660 -という名前のパッケージ内に配置しなければならないと規定されています。
17.661 -そのため、この
17.662 -.BR Widgets
17.663 -パッケージのままでは不十分です。規定に従うには、
17.664 -.BR com.abc.Widgets
17.665 -でなければなりません。
17.666 -.BR Widgets
17.667 -モジュールにこのパッケージ接頭辞を配置するには、次のコマンドを
17.668 -実行してください。
17.669 -.LP
17.670 -.RS
17.671 -.ft 3
17.672 -.nf
17.673 -idlj -pkgPrefix Widgets com.abc Widgets.idl
17.674 -.fi
17.675 -.ft 1
17.676 -.RE
17.677 -.LP
17.678 -.BR Widgets.idl
17.679 -を取り込んでいる IDL ファイルが存在する場合は、そのコマンド内にも
17.680 -.BI \-pkgPrefix
17.681 -フラグを指定する必要があります。このフラグを指定しないと、IDL ファイルは
17.682 -.BR com.abc.Widgets
17.683 -パッケージではなく
17.684 -.BR Widgets
17.685 -パッケージを検索します。
17.686 -.LP
17.687 -接頭辞を必要とするこれらのパッケージが多数存在する場合は、前述した
17.688 -.BR idl.config
17.689 -ファイルに配置する方が簡単でしょう。各パッケージ接頭辞行は、次の書式で記述します。
17.690 -.LP
17.691 -.RS
17.692 -.ft 3
17.693 -.nf
17.694 -PkgPrefix.<type>=<prefix>
17.695 -.fi
17.696 -.ft 1
17.697 -.RE
17.698 -.LP
17.699 -この書式に従うと、上記例の行は次のようになります。
17.700 -.LP
17.701 -.RS
17.702 -.ft 3
17.703 -.nf
17.704 -PkgPrefix.Widgets=com.abc
17.705 -.fi
17.706 -.ft 1
17.707 -.RE
17.708 -.LP
17.709 -このオプションを使用しても、リポジトリ ID には影響を与えません。
17.710 -.SH "コンパイル前のシンボルの定義"
17.711 -バインディング内にデバッグコードを取り込む場合などに IDL ファイル内
17.712 -にコンパイル用のシンボルが定義されていないときは、それらのシンボル
17.713 -を定義する必要があることがあります。次のコマンド
17.714 -.LP
17.715 -.RS
17.716 -.ft 3
17.717 -.nf
17.718 -idlj -d MYDEF My.idl
17.719 -.fi
17.720 -.ft 1
17.721 -.RE
17.722 -.LP
17.723 -は、My.idl 内に
17.724 -.BR #define
17.725 -.BR MYDEF
17.726 -という行を含めるのと同じです。
17.727 -.SH "既存のバインディングの保持"
17.728 -Java バインディングファイルが既に存在する場合は、
17.729 -.BI \-keep
17.730 -フラグを使用してコンパイラによる上書きを防止できます。デフォルトでは、
17.731 -既に存在するかどうかにかかわらずすべてのファイルが生成されます。
17.732 -ファイルをカスタマイズ (カスタマイズはその内容がよほど適切でない限り推奨
17.733 -されません) してある場合は、
17.734 -.BI \-keep
17.735 -オプションが非常に役立ちます。次のコマンド
17.736 -.LP
17.737 -.RS
17.738 -.ft 3
17.739 -.nf
17.740 -idlj -keep My.idl
17.741 -.fi
17.742 -.ft 1
17.743 -.RE
17.744 -.LP
17.745 -は、まだ存在していないすべてのクライアント側バインディングを発行します。
17.746 -.SH "コンパイルの進捗の表示"
17.747 -IDL-to-Java コンパイラは、その実行段階でステータスメッセージを
17.748 -生成します。この生成を詳細 (verbose) モードにするには、
17.749 -.BR -v
17.750 -オプションを使用してください。
17.751 -.LP
17.752 -.RS
17.753 -.ft 3
17.754 -.nf
17.755 -idlj -v My.idl
17.756 -.fi
17.757 -.ft 1
17.758 -.RE
17.759 -.LP
17.760 -デフォルトでは、コンパイラは詳細モードで動作しません。
17.761 -.SH "バージョン情報の表示"
17.762 -IDL-to-Java コンパイラのビルドバージョンを表示するには、コマンド行で
17.763 -.BI \-version
17.764 -オプションを指定してください。
17.765 -.LP
17.766 -.RS
17.767 -.ft 3
17.768 -.nf
17.769 -idlj -version
17.770 -.fi
17.771 -.ft 1
17.772 -.RE
17.773 -.LP
17.774 -コンパイラが生成したバインディング内に、バージョン情報も表示されます。
17.775 -コマンド行に指定されるその他のオプションは無視されます。
17.776 -.SH "オプション"
17.777 -.TP
17.778 -.BI \-d " symbol"
17.779 -これは、IDL ファイルに次の行を指定するのと同じです。
17.780 -.LP
17.781 -.RS
17.782 -.ft 3
17.783 -.nf
17.784 -#define symbol
17.785 -.fi
17.786 -.ft 1
17.787 -.RE
17.788 -.TP
17.789 -.BI \-emitAll
17.790 -.BR #include
17.791 -ファイル内に指定されているものも含め、すべてのタイプを発行します。
17.792 -.TP
17.793 -.BI \-fside
17.794 -発行するバインディングを定義します。
17.795 -.BI side
17.796 -には、
17.797 -.BR client
17.798 -、
17.799 -.BR server
17.800 -、
17.801 -.BR serverTIE
17.802 -、
17.803 -.BR all
17.804 -、
17.805 -.BR allTIE
17.806 -のうちいずれか 1 つを指定します。
17.807 -.BR -fserverTIE
17.808 -と
17.809 -.BR -fallTIE
17.810 -オプションを指定すると、委譲モデルスケルトンが発行されます。
17.811 -フラグを指定しない場合は、
17.812 -.BR -fclient
17.813 -と見なされます。
17.814 -.TP
17.815 -.BI \-i " include-path"
17.816 -デフォルトでは、現在のディレクトリでインクルードファイルが
17.817 -検索されます。このオプションを使用すると、ほかのディレクトリを
17.818 -追加できます。
17.819 -.TP
17.820 -.BI \-keep
17.821 -生成されるファイルが既に存在する場合、既存ファイルを上書きしません。
17.822 -デフォルトでは、既存ファイルが上書きされます。
17.823 -.TP
17.824 -.BI \-noWarn
17.825 -警告メッセージを表示しないようにします。
17.826 -.TP
17.827 -.BI \-oldImplBase
17.828 -1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。
17.829 -デフォルトでは、POA 継承モデルのサーバ側バインディングが生成されます。
17.830 -このオプションは、
17.831 -.BR ImplBase
17.832 -継承モデルクラスであるサーバ側バインディングを生成することによって、
17.833 -旧バージョンの Java プログラミング言語との下位互換性を提供します。
17.834 -.TP
17.835 -.BI \-pkgPrefix " type prefix"
17.836 -ファイルスコープで
17.837 -.BI type
17.838 -が検出された場合、そのタイプに対して生成されるすべてのファイルについて、
17.839 -生成される Java パッケージ名に
17.840 -.BI prefix
17.841 -という接頭辞を付けます。
17.842 -.BI type
17.843 -は、トップレベルモジュールの単純名か、モジュールの外部で定義された
17.844 -IDL タイプの単純名です。
17.845 -.TP
17.846 -.BI \-pkgTranslate " type package"
17.847 -特定の識別子内でモジュール名 \f2type\fP が見つかった場合、生成された Java パッケージ内のすべてのファイルに対して、その識別子内のモジュール名を \f2package\fP で置き換えます。
17.848 -.BR pkgPrefix
17.849 -変更が初めに行われることに注意してください。
17.850 -.BI type
17.851 -はトップレベルモジュールの単純名か、モジュールの外部で定義された IDL タイプの
17.852 -単純名のいずれかであり、パッケージのフルネームと正確に一致する必要があります。
17.853 +.RS 3
17.854
17.855 .LP
17.856 -特定の識別子に一致する変換が 2 つ以上見つかった場合、もっとも長い一致が選択されます。たとえば、引数を次のように指定したとします。
17.857 +肴<ゃ潟c篁ュc臀罨<潟潟с潟潟ゃ若喝冴障
17.858 +.RS 3
17.859 +
17.860 +.LP
17.861 +\f2idlj \fP\f4\-td /altdir\fP\f2 My.idl\fP
17.862 +.RE
17.863 +\f2My\fP ゃ潟帥с若鴻翫ゃ潟c潟違\f2./My.java\fP с\f2/altdir/My.java\fP 肴障
17.864 +.RE
17.865 +.SS
17.866 +ゃ潟若<ゃ篁f推臀絎
17.867 +.LP
17.868 +.RS 3
17.869 +
17.870 +.LP
17.871 +\f2My.idl\fP 1 ゃ IDL <ゃ \f2MyOther.idl\fP ゃ潟若翫潟潟ゃ若c \f2MyOther.idl\fP 喝障<ゃ \f2/includes\fP 翫罨<潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes\fP\f2 My.idl\fP
17.872 +.LP
17.873 +障 \f2My.idl\fP \f2/moreIncludes\fP \f2Another.idl\fP ゃ潟若с違罨<潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes \-i /moreIncludes\fP\f2 My.idl\fP
17.874 +.LP
17.875 +綵√сゃ潟若絎潟潟激茲障 сゃ潟若<ゃ罎膣≪贋潟潟ゃ腓冴ャ号障号医紊違鴻篌若障CLASSPATH 鴻c \f2idl.config\fP <ゃ篏障 \f2idl.config\fP 筝罨<綵√茵ャ障 \f2includes=/includes;/moreIncludes\fP
17.876 +.LP
17.877 +潟潟ゃ<ゃ罎膣≪ゃ潟若鴻茯粋昭帥障箴сc阪絖祉潟 (;) c障阪絖若c違障違Windows 若с祉潟潟сUnix 若с潟潟с \f2ゃ潟若\fP荅括完ゃ
17.878 +.na
17.879 +\f2CLASSPATH 荐絎\fP @
17.880 +.fi
17.881 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general с
17.882 +.RE
17.883 +.SS
17.884 +ゃ潟若<ゃ絲障ゃ潟c潟違肴
17.885 +.LP
17.886 +.RS 3
17.887 +
17.888 +.LP
17.889 +с潟潟茵絎 IDL <ゃу臂ゃ潟帥с若鴻罕篏ゃ帥Java ゃ潟c潟違障ゃ潟若<ゃу臂ゃJava ゃ潟c潟違障違罨< 2 ゃ IDL <ゃゃ帥障 \f4My.idl\fP
17.890 +.LP
17.891 +\f2#include <MyOther.idl>\fP
17.892 +.br
17.893 +\f2interface My\fP
17.894 +.br
17.895 +\f2{\fP
17.896 +.br
17.897 +\f2};\fP
17.898 +.br
17.899 +\f4MyOther.idl\fP
17.900 +.LP
17.901 +\f2interface MyOther\fP
17.902 +.br
17.903 +\f2{\fP
17.904 +.br
17.905 +\f2};\fP\
17.906 +.LP
17.907 +罨<潟潟с\f2My\fP 絲障 Java ゃ潟c潟違障 \f2idlj My.idl\fP
17.908 +.LP
17.909 +\f2My.idl\fP у臂\f2My.idl\fP ゃ潟若<ゃ (箴с \f2MyOther.idl\fP) у臂鴻ゃ Java ゃ潟c潟違罨<潟潟篏睡障 \f2idlj \fP\f4\-emitAll\fP\f2 My.idl\fP
17.910 +.LP
17.911 +荀≪羈違障違若鴻潟若絎 \f2#include\fP 菴違障 \f2#include\fP ゃ潟若荀с障絲障篁絎臂蚊障鴻潟若絎 \f2#include\fP 綵潟с \f2#include\fP 障 ゃ障ゃ潟若<ゃ潟若<ゃ障丈絎絲障 Java ゃ潟c潟違肴障罨<箴腓冴障 \f4My.idl\fP
17.912 +.LP
17.913 +\f2#include <MyOther.idl>\fP
17.914 +.br
17.915 +\f2interface My\fP
17.916 +.br
17.917 +\f2{\fP
17.918 +.br
17.919 +\f2\ #include <Embedded.idl>\fP
17.920 +.br
17.921 +\f2};\ \fP \f4MyOther.idl\fP
17.922 +.LP
17.923 +\f2interface MyOther\fP
17.924 +.br
17.925 +\f2{\fP
17.926 +.br
17.927 +\f2};\ \fP \f4Embedded.idl\fP
17.928 +.LP
17.929 +\f2enum E {one, two, three};\fP\
17.930 +.LP
17.931 +罨<潟潟絎茵 \f2idlj My.idl\fP
17.932 +.LP
17.933 +罨<筝c Java <ゃ障 \f2./MyHolder.java\fP
17.934 +.br
17.935 +\f2./MyHelper.java\fP
17.936 +.br
17.937 +\f2./_MyStub.java\fP
17.938 +.br
17.939 +\f2./MyPackage\fP
17.940 +.br
17.941 +\f2./MyPackage/EHolder.java\fP
17.942 +.br
17.943 +\f2./MyPackage/EHelper.java\fP
17.944 +.br
17.945 +\f2./MyPackage/E.java\fP
17.946 +.br
17.947 +\f2./My.java\fP
17.948 +.LP
17.949 +ゃ潟若荀 \f2#include\fP 絎臂\f2MyOther.java\fP 障綵潟с \f2#include\fP у臂\f2E.java\fP 障\f2Embedded.idl\fP \f2My\fP ゃ潟帥с若鴻鴻潟若ゃ潟若\f2My\fP 鴻潟若 (ゃ障\f2MyPackage\fP ) 障
17.950 +.LP
17.951 +筝荐箴 \f2\-emitAll\fP 違篏睡違ゃ潟若鴻<ゃ鴻肴障
17.952 +.LP
17.953 +.RE
17.954 +.SS
17.955 +宴若吾・莨水
17.956 +.LP
17.957 +.RS 3
17.958 +
17.959 +.LP
17.960 +ABC 篌腓障篏罐罨< IDL <ゃ罕膀障
17.961 +.br
17.962 +\f4Widgets.idl\fP
17.963 +.LP
17.964 +\f2module Widgets\fP
17.965 +.br
17.966 +\f2{\fP
17.967 +.br
17.968 +\f2\ interface W1 {...};\fP
17.969 +.br
17.970 +\f2\ interface W2 {...};\fP
17.971 +.br
17.972 +\f2};\fP\
17.973 +.LP
17.974 +<ゃ絲障 IDL\-to\-Java 潟潟ゃ絎茵\f2W1\fP \f2W2\fP 絲障 Java ゃ潟c潟違 \f2Widgets\fP 宴若後障罐d篌腓障宴若吾\f2com.<篌腓上>\fP 宴若後臀c障\f2Widgets\fP 宴若吾с筝сd緇宴若吾 \f2com.abc.Widgets\fP 綽荀障宴若御・莨 \f2Widgets\fP ≪吾ャ若篁罨<潟潟絎茵障 \f2idlj \fP\f4\-pkgPrefix Widgets com.abc\fP\f2 Widgets.idl\fP
17.975 +.LP
17.976 +\f2Widgets.idl\fP ゃ潟若 IDL <ゃ翫潟潟 \f2\-pkgPrefix\fP 違綽荀с違絎 IDL <ゃ\f2com.abc.Widgets\fP 宴若吾с\f2Widgets\fP 宴若吾罎膣≪障
17.977 +.LP
17.978 +・莨綽荀宴若吾ゃ翫菴違 \f2idl.config\fP <ゃф・莨絎膂≦с宴若吾・莨絎茵罨<綵√ц菴違障
17.979 +.LP
17.980 +\f2PkgPrefix.<type>=<prefix>\fP
17.981 +.LP
17.982 +c筝荐箴翫罨<荐菴違障 \f2PkgPrefix.Widgets=com.abc\fP
17.983 +.LP
17.984 +.LP
17.985 +激с潟篏睡吾 ID 綵演帥障
17.986 +.LP
17.987 +.RE
17.988 +.SS
17.989 +潟潟ゃ激潟絎臂
17.990 +.LP
17.991 +.RS 3
17.992 +
17.993 +.LP
17.994 +潟潟ゃ激潟 IDL <ゃу臂翫激潟絎臂綽荀障 違ゃ潟c潟医違潟若腟水ャ篏睡障罨<潟潟 \f2idlj \fP\f4\-d\fP\f2 MYDEF My.idl\fP
17.995 +.LP
17.996 +\f2My.idl\fP \f2#define MYDEF\fP 茵絎翫膈箴<с
17.997 +.RE
17.998 +.SS
17.999 +√ゃ潟c潟違篆
17.1000 +.LP
17.1001 +.RS 3
17.1002 +
17.1003 +.LP
17.1004 +Java ゃ潟c潟違<ゃс絖翫\f2\-keep\fP 違絎潟潟ゃ筝吾帥с障сс絖鴻<ゃ障<ゃ鴻帥ゃ冴翫 (絎鴻罩g∈с篁ュ鴻帥ゃ冴帥)\f2\-keep\fP 激с潟с罨<潟潟 \f2idlj \fP\f4\-keep\fP\f2 My.idl\fP
17.1005 +.LP
17.1006 +ゃ≪潟眼ゃ潟c潟違с障絖鴻肴障
17.1007 +.RE
17.1008 +.SS
17.1009 +潟潟ゃ我倶茵腓
17.1010 +.LP
17.1011 +.RS 3
17.1012 +
17.1013 +.LP
17.1014 +IDL\-to\-Java 潟潟ゃ絎茵罧級х倶<祉若吾障激≪若 (<祉若吾紊≪若) \f2\-v\fP 激с潟篏睡障 \f2idlj \fP\f4\-v\fP\f2 My.idl\fP
17.1015 +.LP
17.1016 +с潟潟ゃ激≪若с絎茵障
17.1017 +.RE
17.1018 +.SS
17.1019 +若吾с恰宴茵腓
17.1020 +.LP
17.1021 +.RS 3
17.1022 +
17.1023 +.LP
17.1024 +.LP
17.1025 +IDL\-to\-Java 潟潟ゃ若吾с潟茵腓冴潟潟茵 \f2\-version\fP 激с潟絎障
17.1026 +.LP
17.1027 +.LP
17.1028 +\f2idlj \-version\fP
17.1029 +.LP
17.1030 +.LP
17.1031 +若吾с恰宴潟潟ゃcゃ潟c潟医吾莨若障障激с潟潟潟茵絎篁ュ激с潟絎鴻∴障
17.1032 +.LP
17.1033 +.RE
17.1034 +.SH "激с"
17.1035 +.LP
17.1036 +
17.1037 +.LP
17.1038 +.RS 3
17.1039 +.TP 3
17.1040 +\-d symbol
17.1041 +激с潟IDL <ゃ罨<茵菴遵翫膈箴<с
17.1042 +.RS 3
17.1043 +
17.1044 +.LP
17.1045 +.nf
17.1046 +\f3
17.1047 +.fl
17.1048 +#define \fP\f4symbol\fP\f3
17.1049 +.fl
17.1050 +\fP
17.1051 +.fi
17.1052 +.RE
17.1053 +.TP 3
17.1054 +\-emitAll
17.1055 +\f2#include\fP <ゃу臂鴻肴障
17.1056 +.TP 3
17.1057 +\-fside
17.1058 +肴ゃ潟c潟違絎臂障 \f2side\fP \f2client\fP\f2server\fP\f2serverTIE\fP\f2all\fP\f2allTIE\fP <с\f2\-fserverTIE\fP 障 \f2\-fallTIE\fP 激с潟絎紮茘蚊≪鴻宴潟肴障違絎c翫\f2\-fclient\fP 絎荀障
17.1059 +.TP 3
17.1060 +\-i include\-path
17.1061 +сゃ潟若<ゃ潟c罎膣≪障激с潟絎祉c菴遵с障
17.1062 +.TP 3
17.1063 +\-keep
17.1064 +<ゃс絖翫<ゃ筝吾障с筝吾障
17.1065 +.TP 3
17.1066 +\-noWarn
17.1067 +茘<祉若吾茵腓冴障
17.1068 +.TP 3
17.1069 +\-oldImplBase
17.1070 +v1.4 JDK ORB 篋с鴻宴潟障сPOA 膓帥≪泣若弱眼ゃ潟c潟違障激с潟絎\f2ImplBase\fP 膓帥≪鴻с泣若弱眼ゃ潟c潟違сゃ若吾с潟 Java 違潟域茯筝篏篋с緇障
17.1071 +.TP 3
17.1072 +\-pkgPrefix type prefix
17.1073 +\f2type\fP <ゃ鴻潟若ф冴翫絲障鴻<ゃゃ Java 宴若後 \f2prefix\fP ・莨篁障\f2type\fP ≪吾ャ若膣≪吾ャ若紊眼у臂 IDL 膣<с
17.1074 +.TP 3
17.1075 +\-pkgTranslate type package
17.1076 +茘ュ筝≪吾ャ若 \f2type\fP 罎冴 Java 宴若後鴻<ゃゃ茘ュ筝 \f2package\fP х舟障 \f2pkgPrefix\fP 紊眼障\f2type\fP ≪吾ャ若障鴻≪吾ャ若紊у臂 IDL 膣с 絎宴若後罩g∈筝眼違障
17.1077 +.LP
17.1078 +1 ゃ茘ュ筝ц違紊翫c激吾違障違罨<綣違絎翫
17.1079 .nf
17.1080 \f3
17.1081 .fl
17.1082 @@ -757,7 +421,7 @@
17.1083 \fP
17.1084 .fi
17.1085 .LP
17.1086 -このとき、次の変換が実行されます。
17.1087 +罨<紊絎純障
17.1088 .nf
17.1089 \f3
17.1090 .fl
17.1091 @@ -772,102 +436,74 @@
17.1092 \fP
17.1093 .fi
17.1094 .LP
17.1095 -次のパッケージ名は変換できません。
17.1096 +罨<宴若後紊с障
17.1097 .RS 3
17.1098 .TP 2
17.1099 -*
17.1100 +o
17.1101 \f2org\fP
17.1102 .TP 2
17.1103 -*
17.1104 -\f2org.omg\fP または \f2org.omg\fP のサブパッケージ
17.1105 +o
17.1106 +\f2org.omg\fP障 \f2org.omg\fP 泣宴若
17.1107 .RE
17.1108 .LP
17.1109 -これらのパッケージの変換を試みると、コンパイル不可能なコードが生成されます。
17.1110 -これらのパッケージを
17.1111 -.BR \-pkgTranslate
17.1112 -の後の最初の引数として使用すると、エラーとして扱われます。
17.1113 +宴若後紊篋с潟若障 \f2\-pkgTranslate\fP 綣違宴若吾篏睡若宴障
17.1114 +.TP 3
17.1115 +\-skeletonName xxx%yyy
17.1116 +\f2xxx%yyy\fP 鴻宴潟篁帥若潟篏睡障罨<с
17.1117 +.RS 3
17.1118 +.TP 2
17.1119 +o
17.1120 +\f2POA\fP 阪鴻翫%POA(\f2\-fserver\fP 障 \f2\-fall\fP)
17.1121 +.TP 2
17.1122 +o
17.1123 +\f2oldImplBase\fP 鴻翫_%ImplBase(\f2\-oldImplBase\fP (\f2\-fserver\fP 障 \f2\-fall\fP))
17.1124 .RE
17.1125 -.TP
17.1126 -.BI \-skeletonName " xxx%yyy"
17.1127 -.BI xxx%yyy
17.1128 -をスケルトンの名前付けのパターンとして使用します。デフォルトは次のとおりです。
17.1129 +.TP 3
17.1130 +\-td dir
17.1131 +阪c潟cс\f2dir\fP 篏睡障
17.1132 +.TP 3
17.1133 +\-tieName xxx%yyy
17.1134 +帥若潟緇c Tie 篁障罨<с
17.1135 +.RS 3
17.1136 +.TP 2
17.1137 +o
17.1138 +\f2POA\fP Tie 阪鴻翫%POATie(\f2\-fserverTie\fP 障 \f2\-fallTie\fP)
17.1139 +.TP 2
17.1140 +o
17.1141 +\f2oldImplBase\fP Tie 鴻翫%_Tie(\f2\-oldImplBase\fP (\f2\-fserverTie\fP 障 \f2\-fallTie\fP))
17.1142 +.RE
17.1143 +.TP 3
17.1144 +\-verbose
17.1145 +激≪若障
17.1146 +.TP 3
17.1147 +\-version
17.1148 +若吾с恰宴茵腓冴腟篋障
17.1149 +.RE
17.1150 +
17.1151 .LP
17.1152 -.RS
17.1153 -.TP 2
17.1154 -\(bu POA 基底クラス
17.1155 -(
17.1156 -.BR \-fserver
17.1157 -または
17.1158 -.BR \-fall
17.1159 -) の場合、%POA
17.1160 -.TP 2
17.1161 -\(bu
17.1162 -.BR \-oldImplBase
17.1163 -クラス (
17.1164 -.BR \-oldImplBase
17.1165 -および、
17.1166 -.BR \-fserver
17.1167 -または
17.1168 -.BR \-fall
17.1169 -) の場合、_%ImplBase
17.1170 -.RE
17.1171 -.TP
17.1172 -.BI \-td " dir"
17.1173 -出力ディレクトリとして、現在のディレクトリではなく
17.1174 -.BI dir
17.1175 -を使用します。
17.1176 -.TP
17.1177 -.BI \-tieName " xxx%yyy"
17.1178 -パターンに応じて Tie に名前を付けます。デフォルトは次のとおりです。
17.1179 -.LP
17.1180 -.RS
17.1181 -.TP 2
17.1182 -\(bu POA Tie 基底クラス (
17.1183 -.BR \-fserverTie
17.1184 -または
17.1185 -.BR \-fallTie
17.1186 -) の場合、%POATie
17.1187 -.TP 2
17.1188 -\(bu
17.1189 -.BR oldImplBase Tie
17.1190 -クラス (
17.1191 -.BR \-oldImplBase
17.1192 -および、
17.1193 -.BR \-fserverTie
17.1194 -または
17.1195 -.BR \-fallTie
17.1196 -のいずれか) の場合、%_Tie
17.1197 -.RE
17.1198 -.TP
17.1199 -.BI \-nowarn, \-verbose
17.1200 -詳細モードにします。
17.1201 -.TP
17.1202 -.BI \-version
17.1203 -バージョン情報を表示して終了します。
17.1204 -.LP
17.1205 -オプションの詳細は、「機能説明」の節を参照してください。
17.1206 -.SH "制限事項"
17.1207 -.LP
17.1208 -.TP 2
17.1209 -\(bu グローバルスコープ内でエスケープされた識別子は、
17.1210 -IDL プリミティブ型 (
17.1211 -.BR Object
17.1212 -または
17.1213 -.BR ValueBase
17.1214 -) と同じスペルであってはなりません。これは、シンボルテーブルがこれらの
17.1215 -識別子を使用してすでにロードされているためです。これらを定義し直すと、
17.1216 -それらの本来の定義を上書きすることになります (この制限は永続的に
17.1217 -適用される見込み)。
17.1218 -.TP 2
17.1219 -\(bu IDL の fixed 型はサポートされていません。
17.1220 -.SH "既知の問題"
17.1221 +激с潟荅括完ゃ茯祉激с潟с
17.1222 +.SH "句"
17.1223 .LP
17.1224
17.1225 .LP
17.1226 .RS 3
17.1227 .TP 2
17.1228 -*
17.1229 -グローバル識別子のインポートは生成されません。エクスポートされていないローカル実装を呼び出すと例外が発生しますが、その原因はおそらく \f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP です。
17.1230 +o
17.1231 +違若鴻潟若鴻宴若茘ュIDL c \f2Object\fP 障 \f2ValueBase\fP 膓眼сc障茘ュゃ激潟若篋若茘ュ絎臂荐怨絎臂筝吾障障箙句с
17.1232 +.TP 2
17.1233 +o
17.1234 +\f2fixed\fP IDL 泣若障
17.1235 +.RE
17.1236 +
17.1237 +.LP
17.1238 +.SH "∝ャ馹"
17.1239 +.LP
17.1240 +
17.1241 +.LP
17.1242 +.RS 3
17.1243 +.TP 2
17.1244 +o
17.1245 +違若茘ュゃゃ潟若障篋若 impl 若喝冴箴紊障 \f2ServerDelegate\fP DSI 潟若 \f2NullPointerException\fP с
17.1246 .RE
17.1247
17.1248 .LP
18.1 --- a/src/linux/doc/man/ja/jar.1 Tue May 12 15:21:55 2009 +0900
18.2 +++ b/src/linux/doc/man/ja/jar.1 Thu May 14 00:17:25 2009 -0700
18.3 @@ -1,234 +1,141 @@
18.4 -'\" t
18.5 -.\"
18.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
18.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
18.8 -.\"
18.9 -.\" This code is free software; you can redistribute it and/or modify it
18.10 -.\" under the terms of the GNU General Public License version 2 only, as
18.11 -.\" published by the Free Software Foundation.
18.12 -.\"
18.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
18.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
18.17 -.\" accompanied this code).
18.18 -.\"
18.19 -.\" You should have received a copy of the GNU General Public License version
18.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
18.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18.22 -.\"
18.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
18.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
18.25 -.\" have any questions.
18.26 -.\"
18.27 -.\" `
18.28 -.TH jar 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
18.29 -.SH "名前"
18.30 -jar \- Java アーカイブツール
18.31 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
18.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
18.33 +."
18.34 +." This code is free software; you can redistribute it and/or modify it
18.35 +." under the terms of the GNU General Public License version 2 only, as
18.36 +." published by the Free Software Foundation.
18.37 +."
18.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
18.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18.41 +." version 2 for more details (a copy is included in the LICENSE file that
18.42 +." accompanied this code).
18.43 +."
18.44 +." You should have received a copy of the GNU General Public License version
18.45 +." 2 along with this work; if not, write to the Free Software Foundation,
18.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18.47 +."
18.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
18.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
18.50 +." have any questions.
18.51 +."
18.52 +.TH jar 1 "04 May 2009"
18.53 +." Generated from HTML by html2man (author: Eric Armstrong)
18.54 +
18.55 .LP
18.56 -\f3jar\fP は複数のファイルを 1 つの Java Archive (JAR) ファイルに結合します。
18.57 -.\"
18.58 -.\" This document was created by saving an HTML file as text
18.59 -.\" from the JavaSoft web site:
18.60 -.\"
18.61 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
18.62 -.\"
18.63 -.\" and adding appropriate troff macros. Because the JavaSoft web site
18.64 -.\" man pages can change without notice, it may be helpful to diff
18.65 -.\" files to identify changes other than new functionality.
18.66 -.\"
18.67 -.SH "形式"
18.68 +.SH ""
18.69 +jar \- Java ARchive 若
18.70 +.LP
18.71 +\f3jar\fP 茲違<ゃ 1 ゃ JAR ≪若ゃ<ゃ腟障
18.72 +.RS 3
18.73 +.TP 2
18.74 +o
18.75 +綵√
18.76 +.TP 2
18.77 +o
18.78 +茯
18.79 +.TP 2
18.80 +o
18.81 +激с
18.82 +.TP 2
18.83 +o
18.84 +潟潟茵綣違<ゃ
18.85 +.TP 2
18.86 +o
18.87 +箴
18.88 +.TP 2
18.89 +o
18.90 +∫i
18.91 +.RE
18.92 +
18.93 +.LP
18.94 +.SH "綵√"
18.95 .LP
18.96
18.97 .LP
18.98 +.RS 3
18.99 .TP 3
18.100 -jar ファイルの作成
18.101 +JAR <ゃ篏
18.102 \f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
18.103 .TP 3
18.104 -jar ファイルの更新
18.105 +JAR <ゃ贋
18.106 \f4jar u\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
18.107 .TP 3
18.108 -jar ファイルの抽出
18.109 +JAR <ゃ遵
18.110 \f4jar x\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
18.111 .TP 3
18.112 -jar ファイルの内容の一覧を作成
18.113 +JAR <ゃ絎鴻茵綵√筝荀ц;腓
18.114 \f4jar t\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
18.115 .TP 3
18.116 -jar ファイルにインデックスを追加
18.117 +JAR <ゃ吾ゃ潟鴻菴遵
18.118 \f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
18.119 +.RE
18.120 +
18.121 .LP
18.122 .LP
18.123 -パラメータ
18.124 +茯
18.125 .LP
18.126 .RS 3
18.127
18.128 .LP
18.129 +.RS 3
18.130 .TP 3
18.131 cuxtiv0Mmfe
18.132 -.I jar
18.133 -コマンドを制御するオプション。
18.134 +\f2jar\fP 潟潟九勝激с
18.135 .TP 3
18.136 - jarfile
18.137 -作成 (c)、更新 (u)、抽出 (x)、または閲覧される内容の一覧を作成 (t) する
18.138 -jar ファイルです。
18.139 -.I \-f
18.140 -オプションとファイル名
18.141 -.I jarfile
18.142 -は対になっています。
18.143 -使用する場合は、両方を一緒に使用します。
18.144 -.I f
18.145 -および
18.146 -.I jarfile
18.147 -を省略すると、標準入力から「jar ファイル」が
18.148 -使用されたり (x および t の場合)、標準出力にこの「jar ファイル」が
18.149 -送信されたりします (c および u の場合)。
18.150 +jarfile
18.151 +篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)障絎鴻筝荀ц;腓 (\f2t\fP) 絲乗院 JAR <ゃ\f2f\fP 激с潟<ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュJAR <ゃ緇 (x t 翫)罔羣阪吾JAR <ゃ篆<障(c u 翫)
18.152 .TP 3
18.153 -
18.154 inputfiles
18.155 -.I jar ファイル
18.156 -に結合 (c および u の場合)、または
18.157 -.I jar ファイル
18.158 -から抽出 (x の場合) または一覧表示 (t の場合) されるファイル
18.159 -またはディレクトリ。空白文字で区切ります。
18.160 -すべてのディレクトリは再帰的に処理されます。
18.161 -オプション 0 (ゼロ) が使用されない場合は、ファイルが圧縮されます。
18.162 +\f2jarfile\fP 腟 (c u 翫)\f2jarfile\fP 遵 (x 翫) 障筝荀ц;腓 (t 翫) 腥榊純у阪<ゃ障c鴻c絽亥障<ゃ激с \f2O\fP (若) 篏睡х軒障
18.163 .TP 3
18.164 - manifest
18.165 -jar ファイルの MANIFEST.MF に含めようとする名前:値ペアが含まれている
18.166 -既存の manifest ファイルです。
18.167 -.I \-m
18.168 -オプションと
18.169 -.I manifest
18.170 -のファイル名は対になっています。
18.171 -使用する場合は、両方を一緒に使用します。
18.172 -文字
18.173 -.B m
18.174 -、
18.175 -.B f
18.176 -、および
18.177 -.B e
18.178 -の出現順序は、
18.179 -.I manifest
18.180 -、
18.181 -.I jarfile
18.182 -、および
18.183 -.I entrypoint
18.184 -の出現順序と一致する必要があります。
18.185 +manifest
18.186 +\f2name\fP\f2:\fP\f2value\fP ≪JAR <ゃ MANIFEST.MF 障√с鴻<ゃ\f2\-m\fP 激с潟<ゃ \f2manifest\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
18.187 .TP 3
18.188 -
18.189 entrypoint
18.190 -実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして設定するクラスの名前。
18.191 -.I \-e
18.192 -オプションと entrypoint は対になっています。どちらかを指定する場合は両方とも指定する必要があります。文字
18.193 -.I m
18.194 -、
18.195 -.I f
18.196 -、
18.197 -.I e
18.198 -の出現順序は
18.199 -.I manifest
18.200 -、
18.201 -.I jarfile
18.202 -、
18.203 -.I entrypoint
18.204 -の出現順序と一致する必要があります。
18.205 +絎茵 JAR <ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟荐絎鴻\f2\-e\fP 激с潟 entrypoint 絲障c障 <絎翫筝≧鴻絎綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
18.206 .TP 3
18.207 \-C\ dir
18.208 -後続の入力ファイル引数の処理中、
18.209 -ディレクトリを
18.210 -.I dir
18.211 -に一時的に変更します。
18.212 -複数の
18.213 -.I \-C " dir"
18.214 -入力ファイルのセットを使用できます。
18.215 +膓 \f2inputfiles\fP 綣違c \f2dir\fP 娯紊眼障\f2\-C\ \fP\f2dir\fP \f2inputfiles\fP 祉茲遺戎с障
18.216 .TP 3
18.217 \-Joption
18.218 -Java Runtime Environment に渡されるオプション
18.219 -(
18.220 -.I \-J
18.221 -と
18.222 -.I option
18.223 -の間には空白文字を入れないでください)。
18.224 -.SH "機能説明"
18.225 -.IX "Java archive tool" "" "Java archive tool \(em \fLjar\fP"
18.226 -.IX "jar" "" "\fLjar\fP \(em Java archive tool"
18.227 -.B jar
18.228 -ツールは
18.229 -Java
18.230 -アプリケーションの
18.231 -1
18.232 -つで、複数個のファイルを
18.233 -1
18.234 -個の
18.235 -JAR
18.236 -アーカイブファイルに統合します。また、
18.237 -jar は汎用的なアーカイブ作成用
18.238 -および圧縮用のツールでもあり、圧縮は
18.239 -.SM ZIP
18.240 -または
18.241 -.I ZLIB
18.242 +Java 絎茵医御検激с潟\f2\-J\fP \f2option\fP 腥榊純ャс
18.243 +.RE
18.244 +
18.245 +.LP
18.246 +.RE
18.247 +.SH "茯"
18.248 +.LP
18.249 +
18.250 +.LP
18.251 +\f3jar\fP 若茲違<ゃ 1 ゃ JAR ≪若ゃ<ゃ腟障 \f3jar\fP ZIP
18.252 +.na
18.253 +\f2ZLIB\fP @
18.254 .fi
18.255 - (http://www.gzip.org/zlib/)
18.256 -形式で行います。
18.257 -ただし
18.258 -.B jar
18.259 -ツールの主な目的は、いくつかの
18.260 -Java
18.261 -アプレットやアプリケーションを
18.262 -1
18.263 -個のアーカイブに統合することです。
18.264 -アプレットやアプリケーションのコンポーネント、たとえば
18.265 -クラスファイル、イメージ、サウンドなどを単一のアーカイブに
18.266 -まとめると、ブラウザのような
18.267 -Java
18.268 -エージェントにダウンロードするときに、一度の
18.269 -HTTP
18.270 -トランザクションで済みます。コンポーネントごとに
18.271 -新たに接続する必要がありません。
18.272 -これによりダウンロード時間が大幅に短縮できます。
18.273 -また
18.274 -.B jar
18.275 -はファイルの圧縮も行うので、ダウンロードがより高速になります。
18.276 -さらに、ファイル中の個々のエントリに対してアプレットの作成者が
18.277 -署名できるので、作成元を明確化できます。
18.278 -.B jar
18.279 -ツールの構文は、
18.280 -.I tar
18.281 -コマンドの構文とほぼ同一です。
18.282 -.B jar
18.283 -アーカイブは、圧縮されているかどうかにかかわらず、
18.284 -クラスパス
18.285 +http://www.gzip.org/zlib/ х軒綵√若鴻羆≪若ゃ喝х軒若с \f3jar\fP 若筝祉ゃ Java ≪≪宴若激с潟 1 ≪若ゃ腟怨с≪≪宴若激с潟潟潟若潟 (<ゃゃ<若吾潟泣潟) 1 ゃ≪若ゃ腟Java 若吾с潟 (吟) 潟潟若潟 1 HTTP 潟吟激с潟с潟若с潟潟若潟違・膓綽荀障c潟若違紊у羝障 障\f3jar\fP <ゃх軒с潟若障障<ゃ潟≪篏臀峨吾莨若с絽茯荐若純障jar 若罕\f2tar\fP 潟潟罕祉弱с\f3JAR\fP ≪若ゃх軒鴻鴻潟篏睡с障
18.286 +.LP
18.287 +茲違<ゃ JAR <ゃ悟筝篏睡羈罨<с
18.288 +.LP
18.289 +.RS 3
18.290 +
18.291 +.LP
18.292 +.nf
18.293 +\f3
18.294 +.fl
18.295 +% jar cf myFile.jar *.class
18.296 +.fl
18.297 +\fP
18.298 .fi
18.299 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/classpath.html)
18.300 -エントリとして使用できます。
18.301 +.RE
18.302 +
18.303 .LP
18.304 -複数のファイルを jar ファイルに統合する標準的な使い方は次のとおりです。
18.305 +箴с憜c (.class) <ゃ鴻\f2myFile.jar\fP <ゃ主障jar 若\f2META\-INF/MANIFEST.MF\fP с鴻<ゃ潟障絽吾JAR <ゃ潟障с鴻<ゃ≪若ゃ≪<炊宴絎h若帥 \f2name\ :\ value\fP ≪主障jar 若с鴻<ゃ<炊宴主号荅括完ゃ
18.306 +.na
18.307 +\f2JAR file specification\fP @
18.308 +.fi
18.309 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifestс
18.310 .LP
18.311 -.RS
18.312 -.ft 3
18.313 -.nf
18.314 -% jar cf myFile.jar *.class
18.315 -.fi
18.316 -.ft 1
18.317 -.RE
18.318 -.LP
18.319 -この例では、現在のディレクトリ中のすべてのクラスファイルが
18.320 -.I myFile.jar
18.321 -という名前のファイルに置かれます。
18.322 -jar ツールは自動的に、
18.323 -.I META\-INF/MANIFEST.MF
18.324 -という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを
18.325 -.I name : value
18.326 -ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、
18.327 -.fi
18.328 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest
18.329 -の
18.330 -.na
18.331 -「JAR file specification」を参照してください。
18.332 -.LP
18.333 -既存のマニフェストファイル内に格納された
18.334 -.I name : value
18.335 -ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。
18.336 +√с鴻<ゃ主 \f2name\ :\ value\fP ≪ JAR <ゃ綽荀翫<ゃ罨< \f2\-m\fP 激с潟篏帥c絎障
18.337 .LP
18.338 .RS 3
18.339
18.340 @@ -243,295 +150,206 @@
18.341 .RE
18.342
18.343 .LP
18.344 -既存のマニフェストファイルは改行文字で終わっている必要があります。\ マニフェストファイルが改行文字で終わっていない場合、\f3jar\fP はその最後の行を解析しません。
18.345 +√с鴻<ゃ壕絖хc綽荀障 с鴻<ゃ壕絖хc翫\f3jar\fP 緇茵茹f障
18.346 .br
18.347
18.348 .LP
18.349 .br
18.350
18.351 .LP
18.352 -\f3注:\ \fP コマンド行に
18.353 -.I cmf
18.354 -ではなく
18.355 -.I cfm
18.356 -が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず jar アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。次に例を示します。
18.357 +\f3羈:\ \fP潟潟茵 \f2cmf\fP с \f2cfm\fP 絎 jar 潟潟 (m \-f 激с潟) 翫\f3jar\fP 潟潟茵障 JAR ≪若ゃ絎膓с鴻<ゃ絎綽荀障 罨<箴腓冴障
18.358 +.RS 3
18.359 +
18.360 .LP
18.361 -.RS 5
18.362 -.B % jar cfm myFile.jar myManifestFile *.class
18.363 +.nf
18.364 +\f3
18.365 +.fl
18.366 +% jar cfm myFile.jar myManifestFile *.class
18.367 +.fl
18.368 +\fP
18.369 +.fi
18.370 +.RE
18.371 +
18.372 +.LP
18.373 +с鴻RFC822 ASCII 綵√ц鎘鴻綵√сс鴻<ゃ絎鴻膂≦茵腓冴括隈с障
18.374 +.LP
18.375 +JAR <ゃ<ゃ遵冴翫\f2x\fP 篏睡障
18.376 +.LP
18.377 +.RS 3
18.378 +
18.379 +.LP
18.380 +.nf
18.381 +\f3
18.382 +.fl
18.383 +% jar xf myFile.jar
18.384 +.fl
18.385 +\fP
18.386 +.fi
18.387 +.RE
18.388 +
18.389 +.LP
18.390 +.LP
18.391 +jar <ゃャ<ゃ遵冴翫<ゃ絎障
18.392 +.LP
18.393 +.RS 3
18.394 +
18.395 +.LP
18.396 +.nf
18.397 +\f3
18.398 +.fl
18.399 +% jar xf myFile.jar foo bar
18.400 +.fl
18.401 +\fP
18.402 +.fi
18.403 +.RE
18.404 +
18.405 +.LP
18.406 +.LP
18.407 +Java 2 SDK 若吾с 1.3 篁ラ\f2jar\fP 若cc若
18.408 +.na
18.409 +\f2JarIndex\fP @
18.410 +.fi
18.411 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex 泣若障 JarIndex 篏睡≪宴若激с潟鴻若若 JAR <ゃ鴻若合筝障≪宴若激с潟障≪茲違 JAR <ゃ潟翫鴻若綽荀 JAR <ゃ篁ュ潟若潟若潟茵障若潟鴻違 \f2\-i\fP 激с潟絎 \f2jar\fP 絎茵鴻障激с潟篏帥絎 JAR <ゃ潟<ゃ<ゃ潟<ゃ箴絖鴻 JAR <ゃゃ宴若娯臀宴障 <ゃ潟<ゃ箴絖 JAR <ゃJAR <ゃ潟<ゃс鴻 \f2Class\-Path\fP 絮с絎鏆荀障
18.412 +.LP
18.413 +.RS 3
18.414 +
18.415 +.LP
18.416 +.nf
18.417 +\f3
18.418 +.fl
18.419 +% jar i main.jar
18.420 +.fl
18.421 +\fP
18.422 +.fi
18.423 +.RE
18.424 +
18.425 +.LP
18.426 +.LP
18.427 +箴с\f2INDEX.LIST\fP <ゃ \f2main.jar\fP \f2META\-INF\fP c水ャ障
18.428 +.br
18.429 +.br
18.430 +<ゃ主宴篏睡≪宴若激с潟鴻若若合鴻若障 ゃ潟鴻<ゃ篏臀宴主号荅括完 \f2JarIndex\fP 篁罕с
18.431 +.br
18.432 +.br
18.433 +c潟若障 \f2dir1\fP <ゃх軒罔羣阪阪膓罔羣ュ \f2dir2\fP 遵冴障 (筝≧鴻 \f2jar\fP 潟潟 \f2\-f\fP 激с潟) 罨<箴腓冴障
18.434 +.LP
18.435 +.RS 3
18.436 +
18.437 +.LP
18.438 +.nf
18.439 +\f3
18.440 +.fl
18.441 +% (cd dir1; jar c .) | (cd dir2; jar x)
18.442 +.fl
18.443 +\fP
18.444 +.fi
18.445 +.RE
18.446 +
18.447 +.LP
18.448 +.LP
18.449 +\f2jar\fP 篏帥c JAR <ゃ JAR <ゃс鴻篏潟潟泣潟腆肴箴с障
18.450 +.na
18.451 +\f2Java Tutorial\fP @
18.452 +.fi
18.453 +http://java.sun.com/docs/books/tutorial/jar JAR 潟若鴻с
18.454 +.LP
18.455 +.SH "激с"
18.456 +.LP
18.457 +
18.458 +.LP
18.459 +.RS 3
18.460 +.TP 3
18.461 +c
18.462 +\f2jarfile\fP ф違≪若ゃ<ゃ篏 (\f2f\fP 絎翫)罔羣阪т障 (\f2f\fP \f2jarfile\fP ャ翫)\f2inputfiles\fP ф絎<ゃc≪若ゃ菴遵障
18.463 +.TP 3
18.464 +u
18.465 +\f2inputfiles\fP ф絎<ゃc菴遵√<ゃ \f2jarfile\fP 贋違障 (\f2f\fP 絎翫) 箴腓冴障
18.466 +.RS 3
18.467 +
18.468 +.LP
18.469 +.nf
18.470 +\f3
18.471 +.fl
18.472 +jar uf foo.jar foo.class
18.473 +.fl
18.474 +\fP
18.475 +.fi
18.476 +.RE
18.477 +筝潟潟<ゃ \f2foo.class\fP √ JAR <ゃ \f2foo.jar\fP 菴遵障罨<箴腓冴\f2\-u\fP 激с潟с鴻潟贋違с障
18.478 +.RS 3
18.479 +
18.480 +.LP
18.481 +.nf
18.482 +\f3
18.483 +.fl
18.484 +jar umf manifest foo.jar
18.485 +.fl
18.486 +\fP
18.487 +.fi
18.488 +.RE
18.489 +\f2foo.jar\fP с鴻с鴻 \f2name:value\fP ≪ф贋違障
18.490 +.TP 3
18.491 +x
18.492 +\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)<ゃc遵冴障\f2inputfiles\fP 絎翫絎<ゃc遵冴障絎違鴻<ゃc遵冴障遵冴<ゃユ≪若ゃц┃絎с
18.493 +.TP 3
18.494 +t
18.495 +\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)絎鴻茵綵√т荀ц;腓冴障\f2inputfiles\fP 絎翫絎<ゃc筝荀ц;腓冴障絎違鴻<ゃc筝荀ц;腓冴障
18.496 +.TP 3
18.497 +i
18.498 +絎 \f2jarfile\fP 箴絖 JAR <ゃゃゃ潟号宴障箴腓冴障
18.499 +.RS 3
18.500 +
18.501 +.LP
18.502 +.nf
18.503 +\f3
18.504 +.fl
18.505 +jar i foo.jar
18.506 +.fl
18.507 +\fP
18.508 +.fi
18.509 .RE
18.510 .LP
18.511 -manifest は RFC822
18.512 -.SM ASCII
18.513 -形式に基づいたテキスト形式を使用するため、manifest ファイルの内容は
18.514 -簡単に表示および処理できます。
18.515 +筝潟潟\f2foo.jar\fP \f2INDEX.LIST\fP <ゃ障 <ゃ\f2foo.jar\fP \f2foo.jar\fP \f2Class\-Path\fP 絮с絎鴻 JAR <ゃャc宴若吾篏臀宴吾莨若障障 ゃ潟鴻箴с
18.516 +.TP 3
18.517 +f
18.518 +篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)ゃ潟壕申 (\f2i\fP)障茵腓 (\f2t\fP) 絲乗院<ゃ \f2jarfile\fP 絎障\f2f\fP 激с潟<ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュ JAR <ゃ篏睡 (x t 翫)罔羣阪 jar <ゃ 篆<障 (c u 翫)
18.519 +.TP 3
18.520 +v
18.521 +荅括完阪罔羣阪障т腓冴障
18.522 +.TP 3
18.523 +0
18.524 +(若) ZIP х軒篏睡篆絖障
18.525 +.TP 3
18.526 +M
18.527 +с鴻<ゃ潟篏障 (c u 翫) 障с鴻<ゃ潟絖翫ゃ障 (u 翫)
18.528 +.TP 3
18.529 +m
18.530 +\f2META\-INF/MANIFEST.MF\fP <ゃф絎с鴻<ゃ \f2manifest\fP \f2name :value\fP 絮с≪腟粋昭帥障су \f2jar\fP \f2name\ :\ value\fP ≪菴遵障у翫\f2jar\fP ゃ贋違障
18.531 .LP
18.532 -jar ファイルからファイルを抽出する場合は、
18.533 -.I x
18.534 -を使用します。次に例を示します。
18.535 +潟潟茵с\f3m\fP \f3f\fP 絖\f2manifest\fP \f2jarfile\fP ュ綺綺ц菴違綽荀障違罨<篏帥障
18.536 +.RS 3
18.537 +
18.538 .LP
18.539 -.RS 5
18.540 -% jar xf myFile.jar
18.541 +.nf
18.542 +\f3
18.543 +.fl
18.544 +jar cmf myManifestFile myFile.jar *.class
18.545 +.fl
18.546 +\fP
18.547 +.fi
18.548 .RE
18.549 +с鴻障с鴻劫ャ \f2name\ :\ value\fP 絮с≪菴遵с障違潟惹宴若吾с恰宴宴若吾激若潟違障 JAR 潟≪宴若激с潟絎茵絮с菴遵с障\f4\-m\fP 激с潟篏睡箴ゃJava Tutorial
18.550 +.na
18.551 +\f2JAR Files\fP @
18.552 +.fi
18.553 +http://java.sun.com/docs/books/tutorial/jar/潟若鴻с
18.554 .LP
18.555 -jar ファイルから個別のファイルを抽出する場合は、
18.556 -そのファイル名を指定します。
18.557 -.LP
18.558 -.RS 5
18.559 -% jar xf myFile.jar foo bar
18.560 -.RE
18.561 -.LP
18.562 -JDK のバージョン 1.3 から、jar ユーティリティで
18.563 -.fi
18.564 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
18.565 -の「
18.566 -.I JarIndex
18.567 -」をサポートするようになりました。
18.568 -これにより、
18.569 -アプリケーションのクラスローダは、jar ファイルから
18.570 -クラスをより高速に読み込めるようになりました。
18.571 -アプリケーションまたはアプレットが複数の jar ファイルに
18.572 -バンドルされている場合、必要な jar ファイルだけがダウン
18.573 -ロードされて開かれ、クラスが読み込まれます。
18.574 -このパフォーマンスの最適化は、
18.575 -.I jar
18.576 -を
18.577 -.I \-i
18.578 -オプションを使用して実行すると有効になります。
18.579 -指定した
18.580 -メインの jar ファイルおよびそのファイルが依存している
18.581 -すべての jar ファイルのパッケージ位置情報が生成されます。
18.582 -これらの情報は、メイン jar ファイルの manifest の
18.583 -.I Class-Path
18.584 -属性で
18.585 -指定する必要があります。
18.586 -.LP
18.587 -.RS 5
18.588 -% jar i main.jar
18.589 -.RE
18.590 -.LP
18.591 -この例では、
18.592 -.I INDEX.LIST
18.593 -ファイルが
18.594 -.I main.jar
18.595 -の
18.596 -.I META-INF ディレクトリに追加されます。
18.597 -アプリケーションのクラスローダでは、このファイルに格納された情報を
18.598 -使用して、クラスのロードを高速化します。
18.599 -インデックスファイルに位置情報を格納する方法の詳細は、
18.600 -「JarIndex 仕様」を参照してください。
18.601 -.br
18.602 -.br
18.603 -ディレクトリをコピーするには、まず
18.604 -.I dir1
18.605 -内のファイルを圧縮して標準出力に出力し、続いて標準入力から
18.606 -.I dir2
18.607 -に抽出します (両方の
18.608 -.I jar
18.609 -コマンドから
18.610 -.I \-f
18.611 -オプションを省く)。次に例を示します。
18.612 -.LP
18.613 -.RS 5
18.614 -% (cd dir1; jar c .) | (cd dir2; jar x)
18.615 -.RE
18.616 -.LP
18.617 -.I jar
18.618 -を使って JAR ファイルや JAR ファイルマニフェストを操作するコマンドサンプルを確認するには、「例」を参照してください。また、
18.619 -.fi
18.620 -http://java.sun.com/docs/books/tutorial/jar
18.621 -の
18.622 -.na
18.623 -「Java Tutorial」の JAR コースも参照してください。
18.624 -.SH "オプション"
18.625 -.if t .TP 10
18.626 -.if n .TP 5
18.627 -.B c
18.628 -新規のアーカイブファイルを
18.629 -.I jarfile
18.630 -という名前 (
18.631 -.I f
18.632 -を指定した場合)、または標準出力上に (
18.633 -.I f
18.634 -と
18.635 -.I jarfile
18.636 -を省略した場合) 作成します。
18.637 -アーカイブには入力ファイルで指定したファイルおよびディレクトリが追加されます。
18.638 -.if t .TP 10
18.639 -.if n .TP 5
18.640 -.B u
18.641 -既存の
18.642 -.I jarfile
18.643 -(
18.644 -.I f
18.645 -を指定した場合) を更新します。
18.646 -このとき、この
18.647 -.I jarfile
18.648 -には入力ファイルで指定されたファイルおよびディレクトリが追加されます。以下に例を示します。
18.649 -.LP
18.650 -.RS 5
18.651 -% jar uf foo.jar foo.class
18.652 -.RE
18.653 -.LP
18.654 -この例では、ファイル
18.655 -.I foo.class
18.656 -が既存の jar ファイル
18.657 -.I foo.jar
18.658 -に追加されます。
18.659 -.I u
18.660 -オプションでは、マニフェストのエントリを更新することもできます。以下に例を示します。
18.661 -.LP
18.662 -.RS 5
18.663 -% jar umf manifest foo.jar
18.664 -.RE
18.665 -.LP
18.666 -.I foo.jar
18.667 -マニフェストをマニフェスト内の名前:値ペアで更新します。
18.668 -.if t .TP 10
18.669 -.if n .TP 5
18.670 -.B x
18.671 -ファイルおよびディレクトリを
18.672 -.I jarfile
18.673 -(
18.674 -.I f
18.675 -を指定した場合)、
18.676 -または標準入力 (
18.677 -.I f
18.678 -と
18.679 -.I jarfile
18.680 -を省略した場合) から抽出します。
18.681 -入力ファイルを指定した場合、その入力ファイルで指定されたファイルおよびディレクトリだけが
18.682 -抽出されます。指定しない場合は、すべてのファイルおよびディレクトリが抽出されます。
18.683 -抽出されたファイルの日時は、アーカイブ内で設定されたものです。
18.684 -.if t .TP 10
18.685 -.if n .TP 5
18.686 -.B t
18.687 -.I jarfile
18.688 -(
18.689 -.I f
18.690 -を指定した場合)、または標準入力 (
18.691 -.I f
18.692 -と
18.693 -.I jarfile
18.694 -を省略した場合) から内容をリストします。入力ファイルを指定した場合、
18.695 -その入力ファイルで指定されたファイルおよびディレクトリだけが
18.696 -リストされます。指定しない場合は、すべてのファイルおよびディレクトリがリストされます。
18.697 -.if t .TP 10
18.698 -.if n .TP 5
18.699 -.B i
18.700 -指定された
18.701 -.I jarfile
18.702 -および関連づけられている jar ファイルの
18.703 -インデックス情報を生成します。次に例を示します。
18.704 -.LP
18.705 -.RS 5
18.706 -% jar i foo.jar
18.707 -.RE
18.708 -.LP
18.709 -.I foo.jar
18.710 -に
18.711 -.I INDEX.LIST
18.712 -ファイルが生成されます。
18.713 -このファイルには、
18.714 -.I foo.jar
18.715 -の各パッケージおよび
18.716 -.I foo.jar
18.717 -の
18.718 -.I Class-Path
18.719 -属性に指定されているすべての jar ファイルの
18.720 -位置情報が書き込まれています。
18.721 -インデックスの例を参照してください。
18.722 -.if t .TP 10
18.723 -.if n .TP 5
18.724 -.B f
18.725 -作成 (c)、更新 (u)、抽出 (x)、インデックス作成(i)、
18.726 -または表示 (t) する
18.727 -.I jarfile
18.728 -を指定します。
18.729 -.I \-f
18.730 -オプションと
18.731 -.I jarfile
18.732 -のファイル名は対になっています。
18.733 -使用する場合は、両方を一緒に使用します。
18.734 -.I f
18.735 -と
18.736 -.I jarfile
18.737 -を省略すると、標準入力から jar ファイル名が
18.738 -使用されたり (x および t の場合)、標準出力に jar ファイルが
18.739 -送信されたりします (c および u の場合)。
18.740 -.if t .TP 10
18.741 -.if n .TP 5
18.742 -.B v
18.743 -標準出力に詳細な出力を生成します。次に例を示します。
18.744 -.if t .TP 10
18.745 -.if n .TP 5
18.746 -.B 0
18.747 -ゼロ。ZIP 圧縮を使用せずに格納します。
18.748 -.if t .TP 10
18.749 -.if n .TP 5
18.750 -.B M
18.751 -manifest ファイルエントリを作成しません (c および u の場合)。または
18.752 -すでに存在する manifest ファイルエントリを削除します (u の場合)。
18.753 -.if t .TP 10
18.754 -.if n .TP 5
18.755 -.B m
18.756 -指定したマニフェストファイル
18.757 -.I manifest
18.758 -から
18.759 -名前:値属性をファイル
18.760 -.I META-INF/MANIFEST.MF
18.761 -に取り込みます。
18.762 -すでに同じ名前で存在しない限り、
18.763 -.I jar
18.764 -はその名前:値ペアを追加します。同じ名前で存在する場合は、
18.765 -jar
18.766 -はその値を更新します。
18.767 -.LP
18.768 -コマンド行では、文字
18.769 -.B m
18.770 -と
18.771 -.B f
18.772 -は、
18.773 -.I manifest
18.774 -と
18.775 -.I jarfile
18.776 -が出現するのと
18.777 -同じ順序で使用します。次に例を示します。
18.778 -.LP
18.779 -.RS 5
18.780 -% jar cmf myManifestFile myFile.jar *.class
18.781 -.RE
18.782 -.LP
18.783 -manifest ファイルには、デフォルトのマニフェストに含まれていない、
18.784 -専用の名前:値属性ペアを追加できます。
18.785 -たとえば、
18.786 -ベンダー情報、バージョン情報、パッケージシーリング、
18.787 -または JAR にバンドルされたアプリケーションを実行するための属性を
18.788 -追加できます。
18.789 -.B -m
18.790 -オプションの使用例については、「Java Tutorial」
18.791 -.fi
18.792 -http://java.sun.com/docs/books/tutorial/jar/
18.793 -にある
18.794 -.na
18.795 -「
18.796 -.I JAR Files
18.797 -」コースを参照してください。
18.798 .TP 3
18.799 e
18.800 -実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして、
18.801 -.I entrypoint
18.802 -を設定します。このオプションを使用すると、マニフェストファイル内の
18.803 -.I Main\-Class
18.804 -属性値が作成または上書きされます。このオプションは、JAR ファイルの作成中または更新中に使用できます。このオプションを使えば、マニフェストファイルを編集または作成することなしに、アプリケーションのエントリポイントを指定できます。
18.805 +絎茵 JAR <ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟\f2entrypoint\fP 荐絎障激с潟篏睡с鴻<ゃ \f2Main\-Class\fP 絮уゃ篏障筝吾障 激с潟JAR <ゃ篏筝障贋遺賢篏睡с障 激с潟篏帥違с鴻<ゃ膩障篏≪宴若激с潟潟ゃ潟絎с障
18.806 .br
18.807 .br
18.808 -たとえば、次のコマンドは
18.809 -.I Main.jar
18.810 -を作成しますが、その際、マニフェストファイル内の
18.811 -.I Main\-Class
18.812 -属性値は
18.813 -.I Main
18.814 -に設定されます。
18.815 +違罨<潟潟 \f2Main.jar\fP 篏障с鴻<ゃ \f2Main\-Class\fP 絮уゃ \f2Main\fP 荐絎障
18.816 .RS 3
18.817
18.818 .LP
18.819 @@ -544,7 +362,7 @@
18.820 .fi
18.821 .RE
18.822 .LP
18.823 -次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。
18.824 +罨<潟潟絎茵 java 潟帥ゃ贋・≪宴若激с潟莎桁с障
18.825 .RS 3
18.826
18.827 .LP
18.828 @@ -556,11 +374,7 @@
18.829 \fP
18.830 .fi
18.831 .RE
18.832 -エントリポイントのクラス名が特定のパッケージ内に存在している場合、エントリポイントの区切り文字としてドット (「.」) またはスラッシュ (「/」) を使用できます。たとえば、
18.833 -.I Main.class
18.834 -が
18.835 -.I foo
18.836 -という名前のパッケージ内に存在している場合、次のようにしてエントリポイントを指定できます。
18.837 +潟ゃ潟劫劫宴若後絖翫潟ゃ潟阪絖 (.) 障鴻激 (/) 篏睡с障違\f2Main.class\fP \f2foo\fP 宴若後絖翫罨<潟ゃ潟絎с障
18.838 .RS 3
18.839
18.840 .LP
18.841 @@ -572,7 +386,7 @@
18.842 \fP
18.843 .fi
18.844 .RE
18.845 -または
18.846 +障
18.847 .RS 3
18.848
18.849 .LP
18.850 @@ -584,36 +398,14 @@
18.851 \fP
18.852 .fi
18.853 .RE
18.854 -\f3注:\ \fP
18.855 -.I \-m
18.856 -オプションと
18.857 -.I \-e
18.858 -オプションの両方を同時に指定する場合、指定されたマニフェストにも
18.859 -.I Main\-Class
18.860 -属性が含まれていると、
18.861 -.I Main.class
18.862 -の指定があいまいになってエラーが発生し、JAR の作成または更新処理が異常終了します。
18.863 -.if t .TP 10
18.864 -.if n .TP 5
18.865 -.B \-C \ dir
18.866 -.B jar
18.867 -コマンドの実行中に一時的にディレクトリを変更します (
18.868 -.I cd " dir"
18.869 -)。
18.870 -このとき、後続の入力ファイル引数が処理されます。
18.871 -この動作は、UNIX の
18.872 -.I tar
18.873 -ユーティリティの
18.874 -.I \-C
18.875 -オプションと
18.876 -同様の動作になります。
18.877 -たとえば、次のコマンドは、
18.878 -.I classes
18.879 -ディレクトリに移動し、そのディレクトリから
18.880 -.I bar.classes
18.881 -を
18.882 -.I foo.jar
18.883 -に追加します。
18.884 +\f3羈:\ \fP \f2\-m\fP 激с潟 \f2\-e\fP 激с潟筝≧鴻絎翫絎с鴻 \f2Main\-Class\fP 絮с障\f2Main.class\fP 絎障c若榊JAR 篏障贋医医幻腟篋障
18.885 +.LP
18.886 +.TP 3
18.887 +\-C \ dir
18.888 +\f2jar\fP 潟潟絎茵筝緇膓 \f2inputfiles\fP 綣違筝c紊眼障 (\f2cd\fP\ \f2dir\fP)UNIX \f2tar\fP 若cc若 \f2\-C\fP 激с潟罘純蕁篌若障
18.889 +.br
18.890 +.br
18.891 +違罨<潟潟\f2classes\fP c腱糸c \f2bar.class\fP \f2foo.jar\fP 菴遵障
18.892 .RS 3
18.893
18.894 .LP
18.895 @@ -625,20 +417,7 @@
18.896 \fP
18.897 .fi
18.898 .RE
18.899 -次のコマンドでは、
18.900 -.I classes
18.901 -ディレクトリに移動し、
18.902 -.I classes
18.903 -ディレクトリ内のすべてのファイルを
18.904 -.I foo.jar
18.905 -に追加します (jar ファイルには classes ディレクトリを作成しません)。
18.906 -次に元のディレクトリに戻ってから、
18.907 -.I bin
18.908 -ディレクトリに移動し、
18.909 -.I xyz.class
18.910 -を
18.911 -.I foo.jar
18.912 -に追加します。
18.913 +罨<潟潟с\f2classes\fP c腱糸\f2classes\fP c鴻<ゃ \f2foo.jar\fP 菴遵障 (jar <ゃ classes c篏障) 罨<c祉c\f2bin\fP c腱糸\f2xyz.class\fP \f2foo.jar\fP 菴遵障
18.914 .RS 3
18.915
18.916 .LP
18.917 @@ -650,276 +429,294 @@
18.918 \fP
18.919 .fi
18.920 .RE
18.921 -.I classes
18.922 -にファイル
18.923 -.I bar1
18.924 -および
18.925 -.I bar2
18.926 -がある場合、
18.927 -.I jar tf foo.jar
18.928 -を実行すると、jar ファイルの内容が次のように表示されます。
18.929 +\f2classes\fP \f2bar1\fP \f2bar2\fP 篆翫\f2jar tf foo.jar\fP 篏睡JAR <ゃ罨<荀膣障
18.930 +.RS 3
18.931 +
18.932 .LP
18.933 -.if t .RS 15
18.934 -.if n .RS 8
18.935 -.ft 3
18.936 .nf
18.937 -META-INF/
18.938 -META-INF/MANIFEST.MF
18.939 +\f3
18.940 +.fl
18.941 +META\-INF/
18.942 +.fl
18.943 +META\-INF/MANIFEST.MF
18.944 +.fl
18.945 bar1
18.946 +.fl
18.947 bar2
18.948 +.fl
18.949 xyz.class
18.950 +.fl
18.951 +\fP
18.952 .fi
18.953 -.ft 1
18.954 -.RE
18.955 -.if t .TP 10
18.956 -.if n .TP 5
18.957 -.B \-Joption
18.958 -.I option
18.959 -を Java Runtime Environment に渡します。
18.960 -ここで、
18.961 -.I option
18.962 -は、Java アプリケーション起動プログラムのマニュアルページ
18.963 -.fi
18.964 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html#options)
18.965 -で説明されているオプションの 1 つです。
18.966 -たとえば
18.967 -.B \-J-Xms48m
18.968 -は、最大メモリを 48M バイトに設定します。
18.969 -.I \-J
18.970 -が基本にする仮想マシンにオプションを渡すことは、共通の規約です。
18.971 -.SH "コマンド行引数ファイル"
18.972 -.B jar
18.973 -コマンド行を短くまたは簡単にするために、
18.974 -.I jar
18.975 -コマンドの引数 (
18.976 -.I \-J
18.977 -オプションを除く) を含むファイルを 1 つ以上指定できます。
18.978 -これにより、任意の長さの
18.979 -.B jar
18.980 -コマンドを作成でき、
18.981 -オペレーティングシステムによるコマンド行の制限を
18.982 -回避できます。
18.983 -.LP
18.984 -引数ファイルには、オプションとファイル名を含めることができます。
18.985 -引数ファイル内の引数は空白文字区切りまたは改行区切りにします。
18.986 -引数ファイル内のファイル名は、引数ファイルの位置に対してではなく、
18.987 -現在のディレクトリに対して相対的に指定します。
18.988 -通常はオペレーティングシステムシェルによって展開されるワイルドカード (*) は
18.989 -展開されません。ファイルを再帰的に解釈するための @ 文字は使用できません。
18.990 -.I \-J
18.991 -オプションは、起動プログラムに渡されるため、サポートされていません。
18.992 -起動プログラムでは引数ファイルを使用できないためです。
18.993 -.LP
18.994 -.I jar
18.995 -の実行時、各引数ファイルのパスおよび名前の先頭に @ 文字を付けて渡します。
18.996 -.I jar
18.997 -で先頭に文字 @ の付いた引数が出現するたびに、
18.998 -そのファイルの内容が引数リストに展開されます。
18.999 -.br
18.1000 -.br
18.1001 -次の例では、
18.1002 -.I find
18.1003 -コマンドから出力されたファイル名を
18.1004 -.I classes.list
18.1005 -内に格納しています。
18.1006 -.LP
18.1007 -.RS 5
18.1008 -% find . -name '*.class' -print > classes.list
18.1009 .RE
18.1010 .LP
18.1011 -その後、引数ファイル構文を使って
18.1012 -.I jar
18.1013 -にリストを渡すと、
18.1014 -.I Classes.list
18.1015 -で
18.1016 -.I jar
18.1017 -コマンドを実行できます。
18.1018 +.TP 3
18.1019 +\-Joption
18.1020 +Java 絎茵医 \f2option\fP 羝<障 \f2option\fP Java ≪宴若激с活儀若<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f4\-J\-Xmx48M\fP 絎紊с<≪若 48M ゃ荐絎障\f2\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
18.1021 +.RE
18.1022 +
18.1023 .LP
18.1024 -.RS 5
18.1025 -% jar cf my.jar @classes.list
18.1026 -.RE
18.1027 +.SH "潟潟茵綣違<ゃ"
18.1028 .LP
18.1029 -引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内の
18.1030 -すべてのファイル名は、渡されたパスに対して相対的ではなく、
18.1031 -現在の作業ディレクトリに相対的となります。次に例を示します。
18.1032 +
18.1033 .LP
18.1034 -.RS 5
18.1035 -% jar @path1/classes.list
18.1036 -.RE
18.1037 -.SH "使用例"
18.1038 -あるディレクトリ中のファイルをすべてアーカイブに追加する例を示します
18.1039 -(アーカイブがすでに存在する場合は、内容が上書きされます)。
18.1040 -詳細を列挙すると (
18.1041 -.I \-v
18.1042 -オプションを使用)、
18.1043 -サイズや最終更新日など、
18.1044 -アーカイブ内のファイルに関して詳しい情報が得られます。
18.1045 -.RS
18.1046 +jar 潟潟茵膂≧\f2jar\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝<ゃ絎с障篁紙激 jar 潟潟篏с若c潟違激鴻潟潟茵狗茹f障障
18.1047 +.LP
18.1048 +綣違<ゃ激с潟<ゃс障<ゃ綣違鴻若鴻障壕у阪障綣違<ゃ<ゃ憜c荀後障鴻障 綣違<ゃ篏臀荀後障鴻с障ゃ若 (*) 絽吾違若c潟違激鴻激сc絖茹i障翫茹i障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
18.1049 +.LP
18.1050 +.LP
18.1051 +\f2jar\fP 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障\f2jar\fP \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
18.1052 +.br
18.1053 +.br
18.1054 +罨<箴с\f2find\fP 潟潟阪<ゃ \f2classes.list\fP 主障
18.1055 +.LP
18.1056 +.RS 3
18.1057 +
18.1058 +.LP
18.1059 +.nf
18.1060 \f3
18.1061 -.nf
18.1062 -% ls
18.1063 -1.au Animator.class monkey.jpg
18.1064 -2.au Wave.class spacemusic.au
18.1065 -3.au at_work.gif
18.1066 -.LP
18.1067 -% jar cvf bundle.jar *
18.1068 -added manifest
18.1069 -adding: 1.au(in = 2324) (out= 67)(deflated 97%)
18.1070 -adding: 2.au(in = 6970) (out= 90)(deflated 98%)
18.1071 -adding: 3.au(in = 11616) (out= 108)(deflated 99%)
18.1072 -adding: Animator.class(in = 2266) (out= 66)(deflated 97%)
18.1073 -adding: Wave.class(in = 3778) (out= 81)(deflated 97%)
18.1074 -adding: at_work.gif(in = 6621) (out= 89)(deflated 98%)
18.1075 -adding: monkey.jpg(in = 7667) (out= 91)(deflated 98%)
18.1076 -adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)
18.1077 -\f1
18.1078 +.fl
18.1079 +% find \fP\f3.\fP \-name '*.class' \-print > classes.list
18.1080 +.fl
18.1081 .fi
18.1082 .RE
18.1083 -イメージ、オーディオファイル、およびクラス用のサブディレクトリが
18.1084 -すでに存在する場合、単一の
18.1085 -.B jar
18.1086 -ファイルに結合できます。
18.1087 -.RS
18.1088 +
18.1089 +.LP
18.1090 +.LP
18.1091 +緇綣違<ゃ罕篏帥c \f2jar\fP 鴻羝<\f2Classes.list\fP \f2jar\fP 潟潟絎茵с障
18.1092 +.LP
18.1093 +.RS 3
18.1094 +
18.1095 +.LP
18.1096 +.nf
18.1097 \f3
18.1098 +.fl
18.1099 +% jar cf my.jar @classes.list
18.1100 +.fl
18.1101 +\fP
18.1102 +.fi
18.1103 +.RE
18.1104 +
18.1105 +.LP
18.1106 +綣違<ゃ鴻絎с障後障鴻荐菴違綣違<ゃ鴻<ゃ羝<鴻絲障後丞с憜篏罐c後丞障 罨<箴腓冴障
18.1107 +.RS 3
18.1108 +
18.1109 +.LP
18.1110 .nf
18.1111 -% ls -F
18.1112 +\f3
18.1113 +.fl
18.1114 +% jar @path1/classes.list
18.1115 +.fl
18.1116 +\fP
18.1117 +.fi
18.1118 +.RE
18.1119 +
18.1120 +.LP
18.1121 +.LP
18.1122 +
18.1123 +.LP
18.1124 +.SH "箴"
18.1125 +.LP
18.1126 +
18.1127 +.LP
18.1128 +劫c鴻<ゃ≪若ゃ菴遵 (≪若ゃс絖翫絎鴻筝吾) 罨<障\f2\-v\fP 激с潟篏睡宴荅括完絎泣ゃ冴違贋井ャ≪若ゃ<ゃゃ荅括完宴茵腓冴障
18.1129 +.RS 3
18.1130 +
18.1131 +.LP
18.1132 +.nf
18.1133 +\f3
18.1134 +.fl
18.1135 +% ls
18.1136 +.fl
18.1137 +1.au Animator.class monkey.jpg
18.1138 +.fl
18.1139 +2.au Wave.class spacemusic.au
18.1140 +.fl
18.1141 +3.au at_work.gif
18.1142 +.fl
18.1143 +
18.1144 +.fl
18.1145 +% jar cvf bundle.jar *
18.1146 +.fl
18.1147 +added manifest
18.1148 +.fl
18.1149 +adding: 1.au(in = 2324) (out= 67)(deflated 97%)
18.1150 +.fl
18.1151 +adding: 2.au(in = 6970) (out= 90)(deflated 98%)
18.1152 +.fl
18.1153 +adding: 3.au(in = 11616) (out= 108)(deflated 99%)
18.1154 +.fl
18.1155 +adding: Animator.class(in = 2266) (out= 66)(deflated 97%)
18.1156 +.fl
18.1157 +adding: Wave.class(in = 3778) (out= 81)(deflated 97%)
18.1158 +.fl
18.1159 +adding: at_work.gif(in = 6621) (out= 89)(deflated 98%)
18.1160 +.fl
18.1161 +adding: monkey.jpg(in = 7667) (out= 91)(deflated 98%)
18.1162 +.fl
18.1163 +adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)
18.1164 +.fl
18.1165 +\fP
18.1166 +.fi
18.1167 +.RE
18.1168 +
18.1169 +.LP
18.1170 +с糸若c<ゃ潟合泣c翫筝 JAR <ゃ腟с障
18.1171 +.RS 3
18.1172 +
18.1173 +.LP
18.1174 +.nf
18.1175 +\f3
18.1176 +.fl
18.1177 +% ls \-F
18.1178 +.fl
18.1179 audio/ classes/ images/
18.1180 +.fl
18.1181
18.1182 +.fl
18.1183 % jar cvf bundle.jar audio classes images
18.1184 +.fl
18.1185 added manifest
18.1186 +.fl
18.1187 adding: audio/(in = 0) (out= 0)(stored 0%)
18.1188 +.fl
18.1189 adding: audio/1.au(in = 2324) (out= 67)(deflated 97%)
18.1190 +.fl
18.1191 adding: audio/2.au(in = 6970) (out= 90)(deflated 98%)
18.1192 +.fl
18.1193 adding: audio/3.au(in = 11616) (out= 108)(deflated 99%)
18.1194 +.fl
18.1195 adding: audio/spacemusic.au(in = 3079) (out= 73)(deflated 97%)
18.1196 +.fl
18.1197 adding: classes/(in = 0) (out= 0)(stored 0%)
18.1198 +.fl
18.1199 adding: classes/Animator.class(in = 2266) (out= 66)(deflated 97%)
18.1200 +.fl
18.1201 adding: classes/Wave.class(in = 3778) (out= 81)(deflated 97%)
18.1202 +.fl
18.1203 adding: images/(in = 0) (out= 0)(stored 0%)
18.1204 +.fl
18.1205 adding: images/monkey.jpg(in = 7667) (out= 91)(deflated 98%)
18.1206 +.fl
18.1207 adding: images/at_work.gif(in = 6621) (out= 89)(deflated 98%)
18.1208 +.fl
18.1209
18.1210 -% ls -F
18.1211 +.fl
18.1212 +% ls \-F
18.1213 +.fl
18.1214 audio/ bundle.jar classes/ images/
18.1215 +.fl
18.1216 +\fP
18.1217 .fi
18.1218 -\f1
18.1219 .RE
18.1220 -次の例では、
18.1221 -.I t
18.1222 -オプションを指定して、jar ファイル中のエントリ名を表示します。
18.1223 -.RS
18.1224 +
18.1225 +.LP
18.1226 +JAR <ゃ潟茵腓冴\f2t\fP激с潟篏睡障
18.1227 +.RS 3
18.1228 +
18.1229 +.LP
18.1230 +.nf
18.1231 \f3
18.1232 -.nf
18.1233 +.fl
18.1234 % jar tf bundle.jar
18.1235 -META-INF/
18.1236 -META-INF/MANIFEST.MF
18.1237 +.fl
18.1238 +META\-INF/
18.1239 +.fl
18.1240 +META\-INF/MANIFEST.MF
18.1241 +.fl
18.1242 audio/1.au
18.1243 +.fl
18.1244 audio/2.au
18.1245 +.fl
18.1246 audio/3.au
18.1247 +.fl
18.1248 audio/spacemusic.au
18.1249 +.fl
18.1250 classes/Animator.class
18.1251 +.fl
18.1252 classes/Wave.class
18.1253 +.fl
18.1254 images/monkey.jpg
18.1255 +.fl
18.1256 images/at_work.gif
18.1257 +.fl
18.1258 +\fP
18.1259 .fi
18.1260 -\f1
18.1261 .RE
18.1262 -クラスの読み込みを高速化するために jar ファイルにインデックスファイルを
18.1263 -追加する場合は、
18.1264 -.I i
18.1265 -オプションを使用してください。
18.1266 +
18.1267 +.LP
18.1268 +.LP
18.1269 +鴻若蕭ゃ潟鴻<ゃ JAR <ゃ菴遵\f2i\fP激с潟篏睡障
18.1270 .br
18.1271 .br
18.1272 -例:
18.1273 +箴:
18.1274 .br
18.1275
18.1276 .LP
18.1277 .RS 3
18.1278
18.1279 .LP
18.1280 -たとえば株取引アプリケーションの内部依存しているクラスを
18.1281 -.I main.jar
18.1282 -、
18.1283 -.I buy.jar
18.1284 -、
18.1285 -および
18.1286 -.I sell.jar
18.1287 -という 3 つの jar ファイル
18.1288 -に分割したとします。
18.1289 -.I main.jar
18.1290 -のマニフェストの
18.1291 -.I Class-Path
18.1292 -属性に次のように指定した場合、
18.1293 +違綣≪宴若激с括娯箴絖鴻\f2main.jar\fP\f2buy.jar\fP \f2sell.jar\fP 3 ゃ JAR <ゃ蚊障
18.1294 +.br
18.1295 +
18.1296 .LP
18.1297 -.RS 5
18.1298 -Class-Path: buy.jar sell.jar
18.1299 +.br
18.1300 +
18.1301 +.LP
18.1302 +\f2main.jar\fP с鴻 \f2Class\-path\fP 絮с罨<絎翫
18.1303 +.nf
18.1304 +\f3
18.1305 +.fl
18.1306 +Class\-Path: buy.jar sell.jar
18.1307 +.fl
18.1308 +\fP
18.1309 +.fi
18.1310 +
18.1311 +.LP
18.1312 +\f2\-i\fP 激с潟篏睡違≪宴若激с潟鴻 茯粋昭帥蕭с障
18.1313 +.nf
18.1314 +\f3
18.1315 +.fl
18.1316 +% jar i main.jar
18.1317 +.fl
18.1318 +\fP
18.1319 +.fi
18.1320 +
18.1321 +.LP
18.1322 +\f2INDEX.LIST\fP <ゃ \f2META\-INF\fP c水ャ障腟≪宴若激с潟鴻若若c鴻障 純若鴻罎膣≪茵 jar <ゃ潟若障
18.1323 .RE
18.1324 -.LP
18.1325 -.I -i
18.1326 -オプションを使用すれば、アプリケーションのクラスの
18.1327 -読み込みを高速化できます。
18.1328 -.LP
18.1329 -.RS 5
18.1330 -% jar i main.jar
18.1331 -.RE
18.1332 -.LP
18.1333 -.I INDEX.LIST
18.1334 -ファイルが
18.1335 -.I META-INF
18.1336 -ディレクトリに追加されます。
18.1337 -この結果、アプリケーションのクラスローダによってクラスまたは
18.1338 -リソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。
18.1339 -.SH "関連項目"
18.1340 +.SH "∫i"
18.1341 .LP
18.1342
18.1343 .LP
18.1344 +.na
18.1345 +\f2JAR <ゃ网荀\fP @
18.1346 .fi
18.1347 http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
18.1348 -の
18.1349 -.na
18.1350 -「
18.1351 -.I The Jar Overview
18.1352 -」
18.1353 .br
18.1354
18.1355 .LP
18.1356 +.na
18.1357 +\f2JAR <ゃ篁罕\fP @
18.1358 .fi
18.1359 http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
18.1360 -の
18.1361 -.na
18.1362 -「
18.1363 -.I The Jar File Specification
18.1364 -」
18.1365 .br
18.1366
18.1367 .LP
18.1368 +.na
18.1369 +\f2Jar ゃ潟鴻\fP @
18.1370 .fi
18.1371 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
18.1372 -の
18.1373 -.na
18.1374 -「
18.1375 -.I The JarIndex Spec
18.1376 -」
18.1377 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex
18.1378 .br
18.1379
18.1380 .LP
18.1381 +.na
18.1382 +\f2Jar ャ若≪\fP @
18.1383 .fi
18.1384 -http://java.sun.com/docs/books/tutorial/jar
18.1385 -の
18.1386 -.na
18.1387 -「
18.1388 -.I Jar Tutorial
18.1389 -」
18.1390 -(Java ソフトウェアの Web サイト内)
18.1391 +http://java.sun.com/docs/books/tutorial/jar (Java Software Web 泣ゃ)
18.1392 .br
18.1393
18.1394 .LP
18.1395 -.fi
18.1396 -http://java.sun.com/javase/6/docs/technotes/tools/share/pack200.html
18.1397 -の
18.1398 -.na
18.1399 -「
18.1400 -.I pack200 Reference Page
18.1401 -」
18.1402 +pack200(1)
18.1403 .LP
18.1404
19.1 --- a/src/linux/doc/man/ja/jarsigner.1 Tue May 12 15:21:55 2009 +0900
19.2 +++ b/src/linux/doc/man/ja/jarsigner.1 Thu May 14 00:17:25 2009 -0700
19.3 @@ -1,431 +1,827 @@
19.4 -'\" t
19.5 -.\"
19.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
19.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
19.8 -.\"
19.9 -.\" This code is free software; you can redistribute it and/or modify it
19.10 -.\" under the terms of the GNU General Public License version 2 only, as
19.11 -.\" published by the Free Software Foundation.
19.12 -.\"
19.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
19.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
19.17 -.\" accompanied this code).
19.18 -.\"
19.19 -.\" You should have received a copy of the GNU General Public License version
19.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
19.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19.22 -.\"
19.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
19.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
19.25 -.\" have any questions.
19.26 -.\"
19.27 -.\"
19.28 -.TH jarsigner 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
19.29 -.SH "名前"
19.30 -jarsigner \- JAR 署名および検証ツール
19.31 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
19.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
19.33 +."
19.34 +." This code is free software; you can redistribute it and/or modify it
19.35 +." under the terms of the GNU General Public License version 2 only, as
19.36 +." published by the Free Software Foundation.
19.37 +."
19.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
19.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19.41 +." version 2 for more details (a copy is included in the LICENSE file that
19.42 +." accompanied this code).
19.43 +."
19.44 +." You should have received a copy of the GNU General Public License version
19.45 +." 2 along with this work; if not, write to the Free Software Foundation,
19.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
19.47 +."
19.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
19.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
19.50 +." have any questions.
19.51 +."
19.52 +.TH jarsigner 1 "04 May 2009"
19.53 +." Generated from HTML by html2man (author: Eric Armstrong)
19.54 +
19.55 +.LP
19.56 +.SH ""
19.57 +jarsigner \- JAR 臀峨恰荐若若
19.58 .LP
19.59 .RS 3
19.60
19.61 .LP
19.62 .LP
19.63 -Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。
19.64 +Java ARchive (JAR) <ゃ臀峨臀峨篁 JAR <ゃ臀峨罎荐若障
19.65 .LP
19.66 .RE
19.67 -.SH "形式"
19.68 -.B jarsigner
19.69 -[
19.70 -.BI options
19.71 -]
19.72 -jar-file alias
19.73 -.br
19.74 -.B jarsigner
19.75 -.BI \-verify
19.76 -[
19.77 -.BI options
19.78 -]
19.79 -jar-file
19.80 -.SH "説明"
19.81 -.IX "JAR signing and verification tool " "" "JAR signing and verification tool \(em \fLjarsigner\fP"
19.82 -.IX "jarsigner" "" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.83 -.B jarsigner
19.84 -ツールは、次の 2 つの目的で使用します。
19.85 -.TP 5
19.86 -1.
19.87 -Java ARchive (JAR) ファイルに署名を付ける
19.88 -.TP 5
19.89 -2.
19.90 -署名付き JAR ファイルの署名と完全性を検証する
19.91 +.SH "綵√"
19.92 .LP
19.93 -JAR 機能を使うと、クラスファイル、イメージ、サウンド、およびその他のデジタルデータ
19.94 -を単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。
19.95 -開発者は、
19.96 -.B jar
19.97 -という名前のツールを使って JAR ファイルを作成できます。技術的な観点から言えば、
19.98 -すべての ZIP ファイルも JAR ファイルとみなすことができます。
19.99 -.LP
19.100 -「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティ
19.101 -(人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、
19.102 -デジタル署名には多くの利点があります。
19.103 -.TP 2
19.104 -\(bu
19.105 -署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、
19.106 -デジタル署名が本物かどうかを検証できる
19.107 -.TP 2
19.108 -\(bu
19.109 -非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である
19.110 -.TP 2
19.111 -\(bu
19.112 -デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの
19.113 -署名として機能することはない
19.114 -.TP 2
19.115 -\(bu
19.116 -署名付きのデータは変更できない。データが変更された場合は、その署名によってデータ
19.117 -が本物ではないことが検証される
19.118 -.LP
19.119 -ファイルに対してエンティティの署名を生成するには、まず、そのエンティティが公開鍵と
19.120 -非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つ以上の証明書も
19.121 -必要です。「証明書」とは、あるエンティティからのデジタル署名付きの文書のことです。
19.122 -証明書には、ほかのあるエンティティの公開鍵が特別な値を持っていることが書かれて
19.123 -います。
19.124 -.LP
19.125 -.B jarsigner
19.126 -は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を
19.127 -生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明連鎖が
19.128 -収められたデータベースです。証明連鎖は、非公開鍵に対応する公開鍵を認証します。
19.129 -キーストアの作成と管理には、
19.130 -.B keytool
19.131 -ユーティリティを使います。
19.132 -.LP
19.133 -.B jarsigner
19.134 -は、エンティティの非公開鍵を使って署名を生成します。署名付き JAR ファイルには、
19.135 -キーストアからの証明書のコピーが含まれています。これは、JAR ファイルの署名に使わ
19.136 -れた非公開鍵に対応する公開鍵の証明書のコピーです。
19.137 -.B jarsigner
19.138 -は、署名付き JAR ファイルのデジタル署名を、ファイル内 (の署名ブロックファイル) に含
19.139 -まれている証明書を使って検証することができます。
19.140 -.LP
19.141 -J2SE 5.0 以降の \f3jarsigner\fP は、タイムスタンプを含む署名を生成できるようになりました。このため、システム/デプロイヤ (Java Plug\-in など) は、署名付きの証明書がまだ有効である期間中に JAR ファイルの署名が行われたかどうかを確認できます。さらに、そのタイムスタンプ情報をアプリケーションが取得するための API が、J2SE 5.0 で追加されました。
19.142 -.LP
19.143 -現時点では、
19.144 -.B jarsigner
19.145 -で署名できるのは、JDK の
19.146 -.B jar
19.147 -ツールで作成された JAR ファイル、または ZIP ファイルだけです。JAR ファイルは ZIP ファイルと同じですが、JAR ファイルには
19.148 -.B META-INF/MANIFEST.MF
19.149 -ファイルが含まれている点が異なります。
19.150 -.B META-INF/MANIFEST.MF
19.151 -ファイルは、
19.152 -.B jarsigner
19.153 -が ZIP ファイルに署名を付けるときに自動的に作成されます。
19.154 -.LP
19.155 -デフォルトでは、
19.156 -.B jarsigner
19.157 -は JAR ファイルに「署名」を付けます。
19.158 -署名付き JAR ファイルを「検証」する場合は、
19.159 -.I -verify
19.160 -オプションを指定します。
19.161 -.SS
19.162 -JDK 1.1 との互換性
19.163 -.LP
19.164 -.IX "jarsigner" "Compatibility with JDK 1.1" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.165 -.B keytool
19.166 -ツールと
19.167 -.B jarsigner
19.168 -ツールは、JDK 1.1 で提供されていた
19.169 -.B javakey
19.170 -ツールを完全に置き換えるものです。これらの新しいツールは
19.171 -.B javakey
19.172 -よりも多くの機能を備えており、キーストアと非公開鍵をパスワードで保護する機能や、
19.173 -署名の生成だけでなく署名を検証する機能を持っています。
19.174 -.LP
19.175 -新しいキーストアアーキテクチャは、
19.176 -.B javakey
19.177 -が作成して管理していたアイデンティティデータベースに代わるものです。キーストア形式と、JDK 1.1 の
19.178 -.B javakey
19.179 -が使っていたデータベース形式との間には下位互換性はありません。ただし、次のような
19.180 -ことは可能です。
19.181 -.TP 2
19.182 -\(bu
19.183 -.B keytool
19.184 -の
19.185 -.I -identitydb
19.186 -コマンドを使うと、アイデンティティデータベースの情報をキーストアにインポートできます。
19.187 -.TP 2
19.188 -\(bu
19.189
19.190 -.B jarsigner
19.191 -は、以前に
19.192 -.B javakey
19.193 -を使って署名された JAR ファイルに署名を付けることができます。
19.194 -.TP 2
19.195 -\(bu
19.196 -.B jarsigner
19.197 -は、
19.198 -.B javakey
19.199 -を使って署名された JAR ファイルを検証できます。したがって、
19.200 -.B jarsigner
19.201 -は、JDK 1.2 のキーストアではなく JDK 1.1 のアイデンティティデータベースからの署名者別
19.202 -名を認識し、これらを対象に処理を行うことができます。
19.203 -.LP
19.204 -次の表は、JDK 1.1.x で署名された JAR ファイルが、Java 2 プラットフォームでどのように扱われるかを
19.205 -示しています。
19.206 .LP
19.207 .nf
19.208 -.ft 3
19.209 - 1.1 データ
19.210 - 1.1 データ ベースから ポリシー
19.211 -JAR ベース内の 1.2 キース ファイル
19.212 -ファイル アイデン トアにイン がアイデン 与えられる
19.213 -のタイプ ティティ ポートされ ティティ/ 特権
19.214 - る信頼でき 別名に特権
19.215 - るアイデン を与える
19.216 - ティティ(4)
19.217 +\f3
19.218 +.fl
19.219 +\fP\f3jarsigner\fP [ options ] jar\-file alias
19.220 +.fl
19.221 +\f3jarsigner\fP \-verify [ options ] jar\-file
19.222 +.fl
19.223 +.fi
19.224
19.225 -署名付き すべてのコードに
19.226 -JAR x x x 与えられる
19.227 - デフォルトの
19.228 - 特権
19.229 -
19.230 -署名のない すべてのコードに
19.231 -JAR x x x 与えられる
19.232 - デフォルトの
19.233 - 特権
19.234 +.LP
19.235 +.SH "茯"
19.236 +.LP
19.237
19.238 -署名付き すべてのコードに
19.239 -JAR x ○ x 与えられる
19.240 - デフォルトの
19.241 - 特権
19.242 +.LP
19.243 +.LP
19.244 +\f3jarsigner\fP 若罨< 2 ゃт戎障
19.245 +.LP
19.246 +.RS 3
19.247 +.TP 3
19.248 +1.
19.249 +Java ARchive (JAR) <ゃ臀峨篁
19.250 +.TP 3
19.251 +2.
19.252 +臀峨篁 JAR <ゃ臀峨翫с罎荐若
19.253 +.RE
19.254
19.255 -署名付き すべてのコードに
19.256 -JAR ○/信頼で x x 与えられる
19.257 - きない デフォルトの
19.258 - 特権 (3)
19.259 +.LP
19.260 +.LP
19.261 +JAR 罘純篏帥鴻<ゃゃ<若吾泣潟潟篁吾帥若帥筝<ゃ宴若後сс<ゃ菴ゅ号絽с障肴jar(1) 若篏帥c JAR <ゃ篏с障茵荀括鴻荐違鴻 ZIP <ゃ JAR <ゃ帥с障 \f3jar\fP c篏 JAR <ゃ障 \f3jarsigner\fP c JAR <ゃMETA\-INF/MANIFEST.MF <ゃ障障
19.262 +.LP
19.263 +.LP
19.264 +吾帥臀峨若 (臀峨絲乗院若) 潟cc (篋冴篌腓障) 泣冴ャ荐膊с吾臀峨罕吾帥臀峨紊鴻障
19.265 +.LP
19.266 +.RS 3
19.267 +.TP 2
19.268 +o
19.269 +臀峨篏帥泣絲障泣篏帥c荐膊茵с吾帥臀峨罎荐若с
19.270 +.TP 2
19.271 +o
19.272 +泣篁篋冴ャ吾帥臀峨初筝純с
19.273 +.TP 2
19.274 +o
19.275 +吾帥臀峨臀峨篁若帥絲乗院с祉若帥臀峨罘純
19.276 +.TP 2
19.277 +o
19.278 +臀峨篁若帥紊眼с 若帥紊眼翫臀峨c若帥с罎荐若
19.279 +.RE
19.280
19.281 -署名付き すべてのコードに
19.282 -JAR ○/信頼で x ○ 与えられる
19.283 - きない デフォルトの
19.284 - 特権 (1,3)
19.285 -
19.286 -署名付き すべてのコードに
19.287 -JAR x ○ ○ 与えられる
19.288 - デフォルトの
19.289 - 特権とポリシー
19.290 - ファイル内
19.291 - で与えられる
19.292 - 特権
19.293 -
19.294 -署名付き すべてのコードに
19.295 -JAR ○/信頼 ○ ○ 与えられる
19.296 - できる デフォルトの
19.297 - 特権とポリシー
19.298 - ファイル内
19.299 - で与えられる
19.300 - 特権 (2)
19.301 -
19.302 -署名付き すべての
19.303 -JAR ○/信頼 x x 特権
19.304 - できる
19.305 -署名付き すべての
19.306 -JAR ○/信頼 ○ x 特権 (1)
19.307 - できる
19.308 -署名付き すべての
19.309 -JAR ○/信頼 x ○ 特権 (1)
19.310 - できる
19.311 -.fi
19.312 -.ft 1
19.313 .LP
19.314 -注:
19.315 -.TP 5
19.316 -1.
19.317 -ポリシーファイル内にアイデンティティ/別名についての言及がある場合、
19.318 -それをキーストアにインポートして、ポリシーファイルの設定が与えられた
19.319 -特権に反映されるようにする必要があります。
19.320 -.TP 5
19.321 -2.
19.322 -ポリシーファイル/キーストアの組み合わせは、アイデンティティデータベース
19.323 -内の信頼できるアイデンティティよりも優先されます。
19.324 -.TP 5
19.325 -3.
19.326 -Java 2 プラットフォームでは、信頼できないアイデンティティは無視されます。
19.327 -.TP 5
19.328 -4.
19.329 -JDK キーストアにインポートできるのは、信頼できるアイデンティティだけです。
19.330 -.SS
19.331 -キーストアの別名
19.332 .LP
19.333 -.IX "jarsigner" "Keystore Aliases" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.334 +<ゃ絲障潟cc若臀峨障潟cc若潟cc若∫c泣泣≪ゅ荀障 障泣茯荐若 1 ゃ障茲違荐惹吾綽荀с荐惹吾潟cc若肴吾帥臀峨篁吾сャ潟cc若泣劫ゃс荐惹障
19.335 .LP
19.336 -キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。
19.337 .LP
19.338 -.B jarsigner
19.339 -を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を
19.340 -含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、
19.341 -working ディレクトリの
19.342 -.B mystore
19.343 -という名前のキーストアに含まれる別名
19.344 -.B duke
19.345 -に関連付けられた非公開鍵を使って、
19.346 -.BR MyJARFile.jar
19.347 -という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていない
19.348 -ので、
19.349 -.BR MyJARFile.jar
19.350 -は署名付きの JAR ファイルによって上書きされます。
19.351 +\f3jarsigner\fP 若鴻≪障泣荐惹御宴篏帥cJAR <ゃ吾帥臀峨障若鴻≪泣泣∫d X.509 荐惹吾с若潟若帥若鴻с若鴻≪篏膊∞keytool(1) 若cc若篏帥障
19.352 .LP
19.353 -.ft 3
19.354 -.nf
19.355 -jarsigner -keystore /working/mystore -storepass
19.356 - myspass -keypass dukekeypasswd MyJARFile.jar duke
19.357 -.fi
19.358 -.ft 1
19.359 .LP
19.360 -キーストアはパスワードで保護されているので、ストアのパスワード (上の例では
19.361 -.BR myspass
19.362 -) を指定する必要があります。コマンド行でストアのパスワードを指定しなかった場合は、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているので、非公開鍵のパスワード (上の例では
19.363 -.BR dukekeypasswd
19.364 -) を指定する必要があります。コマンド行で非公開鍵のパスワードを指定しておらず、非公開鍵のパスワートがストアのパスワードと違っている場合は、非公開鍵のパスワードの入力を求められます。
19.365 +\f3jarsigner\fP 潟cc若泣篏帥c臀峨障臀峨篁 JAR <ゃ<ゃ臀峨篏睡泣絲上泣篆絖若鴻≪c荐惹吾潟若障障 \f3jarsigner\fP 臀峨篁 JAR <ゃ吾帥臀峨<ゃ (臀峨<ゃ) 障荐惹吾篏帥c罎荐若с障
19.366 +.LP
19.367 +.LP
19.368 +5.0 篁ラс\f3jarsigner\fP 帥ゃ鴻帥潟臀峨с激鴻ゃ (Java Plug\-in ) JAR <ゃ臀峨荐惹吾号筝臀峨сс障5.0 ц申 API 篏睡≪宴若激с潟帥ゃ鴻帥潟宴緇с障
19.369 +.LP
19.370 +.LP
19.371 +憝鴻с\f3jarsigner\fP х讐сJDK jar(1) 若т JAR <ゃ障 ZIP <ゃсJAR <ゃ ZIP <ゃсJAR <ゃ META\-INF/MANIFEST.MF <ゃ障鴻違障META\-INF/MANIFEST.MF <ゃ\f3jarsigner\fP ZIP <ゃ臀峨篁篏障
19.372 +.LP
19.373 +.LP
19.374 +с\f3jarsigner\fP JAR (障 ZIP) <ゃ臀峨篁障臀峨篁 JAR <ゃ罎荐若翫\f2\-verify\fP 激с潟絎障
19.375 .LP
19.376 .SS
19.377 -キーストアの場所
19.378 +JDK 1.1 篋
19.379 .LP
19.380 -.IX "jarsigner" "Keystore Location" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.381 +.RS 3
19.382 +
19.383 .LP
19.384 -.B jarsigner
19.385 -には、使用するキーストアの名前と場所を指定する
19.386 -.I -keystore
19.387 -オプションがあります。キーストアは、デフォルトではユーザのホームディレクトリの
19.388 -.I .keystore
19.389 -という名前のファイルに格納されます。ユーザのホームディレクトリは、
19.390 -.I user.home
19.391 -システムプロパティによって決まります。
19.392 .LP
19.393 -.I \-keystore
19.394 -オプションからの入力ストリームは
19.395 -.I KeyStore.load
19.396 -メソッドに渡されます。
19.397 -URL として NONE が指定された場合は、NULL ストリームが
19.398 -.I KeyStore.load
19.399 -メソッドに渡されます。キーストアがハードウェアトークンデバイス上にあるなど、
19.400 -ファイルベースでない場合は、
19.401 -.I NONE
19.402 -を指定してください。
19.403 +\f3keytool\fP 若 \f3jarsigner\fP 若JDK 1.1 ф箴 \f3javakey\fP 若絎臀с違若 \f3javakey\fP 紊罘純若鴻≪泣鴻若т茘激罘純臀峨臀峨罎荐若罘純c障
19.404 +.LP
19.405 +.LP
19.406 +違若鴻≪≪若c若\f3javakey\fP 篏膊∞≪ゃ潟cc若若帥若鴻篁cс若鴻√就綣JDK 1.1 \f3javakey\fP 篏帥c若帥若劫就綣筝篏篋с障罨<純с
19.407 +.LP
19.408 +.RS 3
19.409 +.TP 2
19.410 +o
19.411 +\f3keytool\fP \f2\-identitydb\fP 潟潟篏帥≪ゃ潟cc若若帥若鴻宴若鴻≪ゃ潟若с障
19.412 +.TP 2
19.413 +o
19.414 +\f3jarsigner\fP 篁ュ \f3javakey\fP 篏帥c臀峨 JAR <ゃ臀峨篁с障
19.415 +.TP 2
19.416 +o
19.417 +\f3jarsigner\fP \f3javakey\fP篏帥c臀峨 JAR <ゃ罎荐若с障cjarsigner Java 2 SDK 若鴻≪с JDK 1.1 ≪ゃ潟cc若若帥若鴻臀峨ュ茯茘絲乗院茵с障
19.418 +.RE
19.419 +
19.420 +.LP
19.421 +.LP
19.422 +罨<茵JDK 1.1.x х讐 JAR <ゃJava 2 若с宴腓冴障
19.423 +.LP
19.424 +.LP
19.425 +.TS
19.426 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
19.427 +.de 35
19.428 +.ps \n(.s
19.429 +.vs \n(.vu
19.430 +.in \n(.iu
19.431 +.if \n(.u .fi
19.432 +.if \n(.j .ad
19.433 +.if \n(.j=0 .na
19.434 +..
19.435 +.nf
19.436 +.nr #~ 0
19.437 +.if n .nr #~ 0.6n
19.438 +.ds #d .d
19.439 +.if \(ts\n(.z\(ts\(ts .ds #d nl
19.440 +.fc
19.441 +.nr 33 \n(.s
19.442 +.rm 80 81 82 83 84
19.443 +.nr 34 \n(.lu
19.444 +.eo
19.445 +.am 80
19.446 +.br
19.447 +.di a+
19.448 +.35
19.449 +.ft \n(.f
19.450 +.ll \n(34u*1u/6u
19.451 +.if \n(.l<\n(80 .ll \n(80u
19.452 +.in 0
19.453 +\f3JAR <ゃ帥ゃ\fP
19.454 +.br
19.455 +.di
19.456 +.nr a| \n(dn
19.457 +.nr a- \n(dl
19.458 +..
19.459 +.ec \
19.460 +.eo
19.461 +.am 81
19.462 +.br
19.463 +.di b+
19.464 +.35
19.465 +.ft \n(.f
19.466 +.ll \n(34u*1u/6u
19.467 +.if \n(.l<\n(81 .ll \n(81u
19.468 +.in 0
19.469 +\f31.1 若帥若劫≪ゃ潟cc\fP
19.470 +.br
19.471 +.di
19.472 +.nr b| \n(dn
19.473 +.nr b- \n(dl
19.474 +..
19.475 +.ec \
19.476 +.eo
19.477 +.am 82
19.478 +.br
19.479 +.di c+
19.480 +.35
19.481 +.ft \n(.f
19.482 +.ll \n(34u*1u/6u
19.483 +.if \n(.l<\n(82 .ll \n(82u
19.484 +.in 0
19.485 +\f31.1 若帥若鴻 Java 2 Platform 若鴻≪ゃ潟若篆♂若с≪ゃ潟cc (4)\fP
19.486 +.br
19.487 +.di
19.488 +.nr c| \n(dn
19.489 +.nr c- \n(dl
19.490 +..
19.491 +.ec \
19.492 +.eo
19.493 +.am 83
19.494 +.br
19.495 +.di d+
19.496 +.35
19.497 +.ft \n(.f
19.498 +.ll \n(34u*1u/6u
19.499 +.if \n(.l<\n(83 .ll \n(83u
19.500 +.in 0
19.501 +\f3激若<ゃ≪ゃ潟cc/ュ号┤筝\fP
19.502 +.br
19.503 +.di
19.504 +.nr d| \n(dn
19.505 +.nr d- \n(dl
19.506 +..
19.507 +.ec \
19.508 +.eo
19.509 +.am 84
19.510 +.br
19.511 +.di e+
19.512 +.35
19.513 +.ft \n(.f
19.514 +.ll \n(34u*1u/6u
19.515 +.if \n(.l<\n(84 .ll \n(84u
19.516 +.in 0
19.517 +鴻潟若筝号┤
19.518 +.br
19.519 +.di
19.520 +.nr e| \n(dn
19.521 +.nr e- \n(dl
19.522 +..
19.523 +.ec \
19.524 +.eo
19.525 +.am 84
19.526 +.br
19.527 +.di f+
19.528 +.35
19.529 +.ft \n(.f
19.530 +.ll \n(34u*1u/6u
19.531 +.if \n(.l<\n(84 .ll \n(84u
19.532 +.in 0
19.533 +鴻潟若筝号┤
19.534 +.br
19.535 +.di
19.536 +.nr f| \n(dn
19.537 +.nr f- \n(dl
19.538 +..
19.539 +.ec \
19.540 +.eo
19.541 +.am 84
19.542 +.br
19.543 +.di g+
19.544 +.35
19.545 +.ft \n(.f
19.546 +.ll \n(34u*1u/6u
19.547 +.if \n(.l<\n(84 .ll \n(84u
19.548 +.in 0
19.549 +鴻潟若筝号┤
19.550 +.br
19.551 +.di
19.552 +.nr g| \n(dn
19.553 +.nr g- \n(dl
19.554 +..
19.555 +.ec \
19.556 +.eo
19.557 +.am 81
19.558 +.br
19.559 +.di h+
19.560 +.35
19.561 +.ft \n(.f
19.562 +.ll \n(34u*1u/6u
19.563 +.if \n(.l<\n(81 .ll \n(81u
19.564 +.in 0
19.565 +/篆♂若с
19.566 +.br
19.567 +.di
19.568 +.nr h| \n(dn
19.569 +.nr h- \n(dl
19.570 +..
19.571 +.ec \
19.572 +.eo
19.573 +.am 84
19.574 +.br
19.575 +.di i+
19.576 +.35
19.577 +.ft \n(.f
19.578 +.ll \n(34u*1u/6u
19.579 +.if \n(.l<\n(84 .ll \n(84u
19.580 +.in 0
19.581 +鴻潟若筝号┤ (3)
19.582 +.br
19.583 +.di
19.584 +.nr i| \n(dn
19.585 +.nr i- \n(dl
19.586 +..
19.587 +.ec \
19.588 +.eo
19.589 +.am 81
19.590 +.br
19.591 +.di j+
19.592 +.35
19.593 +.ft \n(.f
19.594 +.ll \n(34u*1u/6u
19.595 +.if \n(.l<\n(81 .ll \n(81u
19.596 +.in 0
19.597 +/篆♂若с
19.598 +.br
19.599 +.di
19.600 +.nr j| \n(dn
19.601 +.nr j- \n(dl
19.602 +..
19.603 +.ec \
19.604 +.eo
19.605 +.am 84
19.606 +.br
19.607 +.di k+
19.608 +.35
19.609 +.ft \n(.f
19.610 +.ll \n(34u*1u/6u
19.611 +.if \n(.l<\n(84 .ll \n(84u
19.612 +.in 0
19.613 +鴻潟若筝号┤ (1,3)
19.614 +.br
19.615 +.di
19.616 +.nr k| \n(dn
19.617 +.nr k- \n(dl
19.618 +..
19.619 +.ec \
19.620 +.eo
19.621 +.am 84
19.622 +.br
19.623 +.di l+
19.624 +.35
19.625 +.ft \n(.f
19.626 +.ll \n(34u*1u/6u
19.627 +.if \n(.l<\n(84 .ll \n(84u
19.628 +.in 0
19.629 +鴻潟若筝号┤激若<ゃт号┤
19.630 +.br
19.631 +.di
19.632 +.nr l| \n(dn
19.633 +.nr l- \n(dl
19.634 +..
19.635 +.ec \
19.636 +.eo
19.637 +.am 84
19.638 +.br
19.639 +.di m+
19.640 +.35
19.641 +.ft \n(.f
19.642 +.ll \n(34u*1u/6u
19.643 +.if \n(.l<\n(84 .ll \n(84u
19.644 +.in 0
19.645 +鴻潟若筝号┤激若<ゃт号┤ (2)
19.646 +.br
19.647 +.di
19.648 +.nr m| \n(dn
19.649 +.nr m- \n(dl
19.650 +..
19.651 +.ec \
19.652 +.35
19.653 +.nf
19.654 +.ll \n(34u
19.655 +.nr 80 0
19.656 +.nr 38 \w臀峨篁 JAR
19.657 +.if \n(80<\n(38 .nr 80 \n(38
19.658 +.nr 38 \w臀峨 JAR
19.659 +.if \n(80<\n(38 .nr 80 \n(38
19.660 +.nr 38 \w臀峨篁 JAR
19.661 +.if \n(80<\n(38 .nr 80 \n(38
19.662 +.nr 38 \w臀峨篁 JAR
19.663 +.if \n(80<\n(38 .nr 80 \n(38
19.664 +.nr 38 \w臀峨篁 JAR
19.665 +.if \n(80<\n(38 .nr 80 \n(38
19.666 +.nr 38 \w臀峨篁 JAR
19.667 +.if \n(80<\n(38 .nr 80 \n(38
19.668 +.nr 38 \w臀峨篁 JAR
19.669 +.if \n(80<\n(38 .nr 80 \n(38
19.670 +.nr 38 \w臀峨篁 JAR
19.671 +.if \n(80<\n(38 .nr 80 \n(38
19.672 +.nr 38 \w臀峨篁 JAR
19.673 +.if \n(80<\n(38 .nr 80 \n(38
19.674 +.nr 38 \w臀峨篁 JAR
19.675 +.if \n(80<\n(38 .nr 80 \n(38
19.676 +.80
19.677 +.rm 80
19.678 +.nr 38 \n(a-
19.679 +.if \n(80<\n(38 .nr 80 \n(38
19.680 +.nr 81 0
19.681 +.nr 38 \w
19.682 +.if \n(81<\n(38 .nr 81 \n(38
19.683 +.nr 38 \w
19.684 +.if \n(81<\n(38 .nr 81 \n(38
19.685 +.nr 38 \w
19.686 +.if \n(81<\n(38 .nr 81 \n(38
19.687 +.nr 38 \w
19.688 +.if \n(81<\n(38 .nr 81 \n(38
19.689 +.nr 38 \w/篆♂若с
19.690 +.if \n(81<\n(38 .nr 81 \n(38
19.691 +.nr 38 \w/篆♂若с
19.692 +.if \n(81<\n(38 .nr 81 \n(38
19.693 +.nr 38 \w/篆♂若с
19.694 +.if \n(81<\n(38 .nr 81 \n(38
19.695 +.nr 38 \w/篆♂若с
19.696 +.if \n(81<\n(38 .nr 81 \n(38
19.697 +.81
19.698 +.rm 81
19.699 +.nr 38 \n(b-
19.700 +.if \n(81<\n(38 .nr 81 \n(38
19.701 +.nr 38 \n(h-
19.702 +.if \n(81<\n(38 .nr 81 \n(38
19.703 +.nr 38 \n(j-
19.704 +.if \n(81<\n(38 .nr 81 \n(38
19.705 +.nr 82 0
19.706 +.nr 38 \w
19.707 +.if \n(82<\n(38 .nr 82 \n(38
19.708 +.nr 38 \w
19.709 +.if \n(82<\n(38 .nr 82 \n(38
19.710 +.nr 38 \w
19.711 +.if \n(82<\n(38 .nr 82 \n(38
19.712 +.nr 38 \w
19.713 +.if \n(82<\n(38 .nr 82 \n(38
19.714 +.nr 38 \w
19.715 +.if \n(82<\n(38 .nr 82 \n(38
19.716 +.nr 38 \w
19.717 +.if \n(82<\n(38 .nr 82 \n(38
19.718 +.nr 38 \w
19.719 +.if \n(82<\n(38 .nr 82 \n(38
19.720 +.nr 38 \w
19.721 +.if \n(82<\n(38 .nr 82 \n(38
19.722 +.nr 38 \w
19.723 +.if \n(82<\n(38 .nr 82 \n(38
19.724 +.nr 38 \w
19.725 +.if \n(82<\n(38 .nr 82 \n(38
19.726 +.82
19.727 +.rm 82
19.728 +.nr 38 \n(c-
19.729 +.if \n(82<\n(38 .nr 82 \n(38
19.730 +.nr 83 0
19.731 +.nr 38 \w
19.732 +.if \n(83<\n(38 .nr 83 \n(38
19.733 +.nr 38 \w
19.734 +.if \n(83<\n(38 .nr 83 \n(38
19.735 +.nr 38 \w
19.736 +.if \n(83<\n(38 .nr 83 \n(38
19.737 +.nr 38 \w
19.738 +.if \n(83<\n(38 .nr 83 \n(38
19.739 +.nr 38 \w
19.740 +.if \n(83<\n(38 .nr 83 \n(38
19.741 +.nr 38 \w
19.742 +.if \n(83<\n(38 .nr 83 \n(38
19.743 +.nr 38 \w
19.744 +.if \n(83<\n(38 .nr 83 \n(38
19.745 +.nr 38 \w
19.746 +.if \n(83<\n(38 .nr 83 \n(38
19.747 +.nr 38 \w
19.748 +.if \n(83<\n(38 .nr 83 \n(38
19.749 +.nr 38 \w
19.750 +.if \n(83<\n(38 .nr 83 \n(38
19.751 +.83
19.752 +.rm 83
19.753 +.nr 38 \n(d-
19.754 +.if \n(83<\n(38 .nr 83 \n(38
19.755 +.nr 84 0
19.756 +.nr 38 \w\f3筝号┤\fP
19.757 +.if \n(84<\n(38 .nr 84 \n(38
19.758 +.nr 38 \w鴻号┤
19.759 +.if \n(84<\n(38 .nr 84 \n(38
19.760 +.nr 38 \w鴻号┤ (1)
19.761 +.if \n(84<\n(38 .nr 84 \n(38
19.762 +.nr 38 \w鴻号┤ (1)
19.763 +.if \n(84<\n(38 .nr 84 \n(38
19.764 +.84
19.765 +.rm 84
19.766 +.nr 38 \n(e-
19.767 +.if \n(84<\n(38 .nr 84 \n(38
19.768 +.nr 38 \n(f-
19.769 +.if \n(84<\n(38 .nr 84 \n(38
19.770 +.nr 38 \n(g-
19.771 +.if \n(84<\n(38 .nr 84 \n(38
19.772 +.nr 38 \n(i-
19.773 +.if \n(84<\n(38 .nr 84 \n(38
19.774 +.nr 38 \n(k-
19.775 +.if \n(84<\n(38 .nr 84 \n(38
19.776 +.nr 38 \n(l-
19.777 +.if \n(84<\n(38 .nr 84 \n(38
19.778 +.nr 38 \n(m-
19.779 +.if \n(84<\n(38 .nr 84 \n(38
19.780 +.35
19.781 +.nf
19.782 +.ll \n(34u
19.783 +.nr 38 1n
19.784 +.nr 79 0
19.785 +.nr 40 \n(79+(0*\n(38)
19.786 +.nr 80 +\n(40
19.787 +.nr 41 \n(80+(3*\n(38)
19.788 +.nr 81 +\n(41
19.789 +.nr 42 \n(81+(3*\n(38)
19.790 +.nr 82 +\n(42
19.791 +.nr 43 \n(82+(3*\n(38)
19.792 +.nr 83 +\n(43
19.793 +.nr 44 \n(83+(3*\n(38)
19.794 +.nr 84 +\n(44
19.795 +.nr TW \n(84
19.796 +.if t .if \n(TW>\n(.li .tm Table at line 186 file Input is too wide - \n(TW units
19.797 +.fc
19.798 +.nr #T 0-1
19.799 +.nr #a 0-1
19.800 +.eo
19.801 +.de T#
19.802 +.ds #d .d
19.803 +.if \(ts\n(.z\(ts\(ts .ds #d nl
19.804 +.mk ##
19.805 +.nr ## -1v
19.806 +.ls 1
19.807 +.ls
19.808 +..
19.809 +.ec
19.810 +.ne \n(a|u+\n(.Vu
19.811 +.ne \n(b|u+\n(.Vu
19.812 +.ne \n(c|u+\n(.Vu
19.813 +.ne \n(d|u+\n(.Vu
19.814 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
19.815 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
19.816 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
19.817 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
19.818 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.819 +.nr 31 \n(.f
19.820 +.nr 35 1m
19.821 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3筝号┤\fP
19.822 +.mk ##
19.823 +.nr 31 \n(##
19.824 +.sp |\n(##u-1v
19.825 +.nr 37 \n(40u
19.826 +.in +\n(37u
19.827 +.a+
19.828 +.in -\n(37u
19.829 +.mk 32
19.830 +.if \n(32>\n(31 .nr 31 \n(32
19.831 +.sp |\n(##u-1v
19.832 +.nr 37 \n(41u
19.833 +.in +\n(37u
19.834 +.b+
19.835 +.in -\n(37u
19.836 +.mk 32
19.837 +.if \n(32>\n(31 .nr 31 \n(32
19.838 +.sp |\n(##u-1v
19.839 +.nr 37 \n(42u
19.840 +.in +\n(37u
19.841 +.c+
19.842 +.in -\n(37u
19.843 +.mk 32
19.844 +.if \n(32>\n(31 .nr 31 \n(32
19.845 +.sp |\n(##u-1v
19.846 +.nr 37 \n(43u
19.847 +.in +\n(37u
19.848 +.d+
19.849 +.in -\n(37u
19.850 +.mk 32
19.851 +.if \n(32>\n(31 .nr 31 \n(32
19.852 +.sp |\n(31u
19.853 +.ne \n(e|u+\n(.Vu
19.854 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
19.855 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.856 +.nr 31 \n(.f
19.857 +.nr 35 1m
19.858 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.859 +.mk ##
19.860 +.nr 31 \n(##
19.861 +.sp |\n(##u-1v
19.862 +.nr 37 \n(44u
19.863 +.in +\n(37u
19.864 +.e+
19.865 +.in -\n(37u
19.866 +.mk 32
19.867 +.if \n(32>\n(31 .nr 31 \n(32
19.868 +.sp |\n(31u
19.869 +.ne \n(f|u+\n(.Vu
19.870 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
19.871 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.872 +.nr 31 \n(.f
19.873 +.nr 35 1m
19.874 +\&\h'|\n(40u'臀峨 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.875 +.mk ##
19.876 +.nr 31 \n(##
19.877 +.sp |\n(##u-1v
19.878 +.nr 37 \n(44u
19.879 +.in +\n(37u
19.880 +.f+
19.881 +.in -\n(37u
19.882 +.mk 32
19.883 +.if \n(32>\n(31 .nr 31 \n(32
19.884 +.sp |\n(31u
19.885 +.ne \n(g|u+\n(.Vu
19.886 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
19.887 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.888 +.nr 31 \n(.f
19.889 +.nr 35 1m
19.890 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.891 +.mk ##
19.892 +.nr 31 \n(##
19.893 +.sp |\n(##u-1v
19.894 +.nr 37 \n(44u
19.895 +.in +\n(37u
19.896 +.g+
19.897 +.in -\n(37u
19.898 +.mk 32
19.899 +.if \n(32>\n(31 .nr 31 \n(32
19.900 +.sp |\n(31u
19.901 +.ne \n(h|u+\n(.Vu
19.902 +.ne \n(i|u+\n(.Vu
19.903 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
19.904 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
19.905 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.906 +.nr 31 \n(.f
19.907 +.nr 35 1m
19.908 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.909 +.mk ##
19.910 +.nr 31 \n(##
19.911 +.sp |\n(##u-1v
19.912 +.nr 37 \n(41u
19.913 +.in +\n(37u
19.914 +.h+
19.915 +.in -\n(37u
19.916 +.mk 32
19.917 +.if \n(32>\n(31 .nr 31 \n(32
19.918 +.sp |\n(##u-1v
19.919 +.nr 37 \n(44u
19.920 +.in +\n(37u
19.921 +.i+
19.922 +.in -\n(37u
19.923 +.mk 32
19.924 +.if \n(32>\n(31 .nr 31 \n(32
19.925 +.sp |\n(31u
19.926 +.ne \n(j|u+\n(.Vu
19.927 +.ne \n(k|u+\n(.Vu
19.928 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
19.929 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
19.930 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.931 +.nr 31 \n(.f
19.932 +.nr 35 1m
19.933 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.934 +.mk ##
19.935 +.nr 31 \n(##
19.936 +.sp |\n(##u-1v
19.937 +.nr 37 \n(41u
19.938 +.in +\n(37u
19.939 +.j+
19.940 +.in -\n(37u
19.941 +.mk 32
19.942 +.if \n(32>\n(31 .nr 31 \n(32
19.943 +.sp |\n(##u-1v
19.944 +.nr 37 \n(44u
19.945 +.in +\n(37u
19.946 +.k+
19.947 +.in -\n(37u
19.948 +.mk 32
19.949 +.if \n(32>\n(31 .nr 31 \n(32
19.950 +.sp |\n(31u
19.951 +.ne \n(l|u+\n(.Vu
19.952 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
19.953 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.954 +.nr 31 \n(.f
19.955 +.nr 35 1m
19.956 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.957 +.mk ##
19.958 +.nr 31 \n(##
19.959 +.sp |\n(##u-1v
19.960 +.nr 37 \n(44u
19.961 +.in +\n(37u
19.962 +.l+
19.963 +.in -\n(37u
19.964 +.mk 32
19.965 +.if \n(32>\n(31 .nr 31 \n(32
19.966 +.sp |\n(31u
19.967 +.ne \n(m|u+\n(.Vu
19.968 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
19.969 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.970 +.nr 31 \n(.f
19.971 +.nr 35 1m
19.972 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
19.973 +.mk ##
19.974 +.nr 31 \n(##
19.975 +.sp |\n(##u-1v
19.976 +.nr 37 \n(44u
19.977 +.in +\n(37u
19.978 +.m+
19.979 +.in -\n(37u
19.980 +.mk 32
19.981 +.if \n(32>\n(31 .nr 31 \n(32
19.982 +.sp |\n(31u
19.983 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.984 +.nr 31 \n(.f
19.985 +.nr 35 1m
19.986 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤
19.987 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.988 +.nr 31 \n(.f
19.989 +.nr 35 1m
19.990 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
19.991 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
19.992 +.nr 31 \n(.f
19.993 +.nr 35 1m
19.994 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
19.995 +.fc
19.996 +.nr T. 1
19.997 +.T# 1
19.998 +.35
19.999 +.rm a+
19.1000 +.rm b+
19.1001 +.rm c+
19.1002 +.rm d+
19.1003 +.rm e+
19.1004 +.rm f+
19.1005 +.rm g+
19.1006 +.rm h+
19.1007 +.rm i+
19.1008 +.rm j+
19.1009 +.rm k+
19.1010 +.rm l+
19.1011 +.rm m+
19.1012 +.TE
19.1013 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-50
19.1014 +
19.1015 +.LP
19.1016 +.LP
19.1017 +羈 \-
19.1018 +.LP
19.1019 +.RS 3
19.1020 +.TP 3
19.1021 +1.
19.1022 +激若<ゃ≪ゃ潟cc/ュゃ荐翫若鴻≪ゃ潟若激若<ゃ荐絎筝号┤綽荀障
19.1023 +.TP 3
19.1024 +2.
19.1025 +激若<ゃ/若鴻≪腟水≪ゃ潟cc若若帥若劫篆♂若с≪ゃ潟cc若障
19.1026 +.TP 3
19.1027 +3.
19.1028 +Java 2 若с篆♂若с≪ゃ潟cc若∴障
19.1029 +.TP 3
19.1030 +4.
19.1031 +Java 2 SDK 若鴻≪ゃ潟若с篆♂若с≪ゃ潟cc若с
19.1032 +.RE
19.1033 +
19.1034 +.LP
19.1035 .SS
19.1036 -キーストアの実装
19.1037 +若鴻≪ュ
19.1038 .LP
19.1039 -.IX "jarsigner" "Keystore Implementation" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.1040 +.RS 3
19.1041 +
19.1042 .LP
19.1043 -.I java.security
19.1044 -パッケージ内にある
19.1045 -.I KeyStore
19.1046 -クラス
19.1047 -では、キーストア内の情報にアクセスし、変更できるように
19.1048 -適切に定義されたインタフェースが提供されています。
19.1049 -このクラスは複数のさまざまな固定実装が可能で、
19.1050 -それぞれの実装は、特定の種類のキーストア用の固定実装です。
19.1051 .LP
19.1052 -現在、キーストアの実装を使用するものとして、keytool と
19.1053 -.BR jarsigner
19.1054 -の 2 つのコマンド行ツールと、
19.1055 -.BR policytool
19.1056 -という名前の 1 つの GUI ベースのツールがあります。
19.1057 -.I KeyStore
19.1058 -クラスは public として使用可能なので、JDK ユーザは
19.1059 -.B KeyStore
19.1060 -を使ってほかのセキュリティアプリケーションも作成できます。
19.1061 +若鴻≪鴻潟筝ュ篁≪祉鴻障
19.1062 .LP
19.1063 -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、
19.1064 -JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアを
19.1065 -ファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワード
19.1066 -によって保護され、キーストア全体の完全性も (非公開鍵とは別の) パスワードに
19.1067 -よって保護されます。
19.1068 .LP
19.1069 +\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁臀峨綽荀泣若鴻≪潟ュ絎綽荀障違罨<箴working c mystore 若鴻≪障ュ duke ∫d泣篏帥cMyJARFile.jar JAR <ゃ臀峨篁障阪<ゃ絎сMyJARFile.jar 臀峨篁 JAR <ゃc筝吾障
19.1070 +.LP
19.1071 +.nf
19.1072 +\f3
19.1073 +.fl
19.1074 + jarsigner \-keystore /working/mystore \-storepass myspass
19.1075 +.fl
19.1076 + \-keypass dukekeypasswd MyJARFile.jar duke
19.1077 +.fl
19.1078 +\fP
19.1079 +.fi
19.1080
19.1081 -キーストアの実装は、プロバイダベースです。具体的には、
19.1082 -.I KeyStore
19.1083 -クラスが提供するアプリケーションインタフェースは、Service Provider Interface (SPI)
19.1084 -という形で実装されています。つまり、対応する
19.1085 -.I KeystoreSpi
19.1086 -抽象クラス (これも
19.1087 -.I java.security
19.1088 -パッケージに含まれている) があり、このクラスが Service Provider Interface の
19.1089 -メソッドを定義しています。これらのメソッドは、「プロバイダ」が実装しなければなりま
19.1090 -せん。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービス
19.1091 -のサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合の
19.1092 -ことです。したがって、キーストアの実装を提供するには、「Java 暗号化アーキテク
19.1093 -チャ用プロバイダの実装方法」(http://java.sun.com/javase/6/docs/technotes/guides/security/HowToImplAProvider.html) のページで説明しているように、クライアントがプロバイダを実装し、
19.1094 -.I KeystoreSpi
19.1095 -サブクラスの実装を提供する必要があります。
19.1096 .LP
19.1097 -アプリケーションでは、
19.1098 -.I KeyStore
19.1099 -クラスが提供する
19.1100 -.B getInstance
19.1101 -ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの
19.1102 -実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式、
19.1103 -およびキーストア内の非公開鍵とキーストア自体の完全性を保護するために使われる
19.1104 -アルゴリズムを定義します。異なるタイプのキーストアの実装には、互いに互換性は
19.1105 -ありません。keytool、jarsigner、および policytool の各ツールは、
19.1106 -.B KeyStore
19.1107 -が提供する共通のアプリケーションインタフェースだけを使っているので、任意の
19.1108 -タイプのキーストアで使用できます。
19.1109 .LP
19.1110 -.B keytool
19.1111 -は、ファイルベースのキーストア実装に対して機能します。
19.1112 -.B keytool
19.1113 -は、コマンド行で渡されたキーストアの位置をファイル名として扱い、
19.1114 -.BR FileInputStream
19.1115 -に変換して、そこからキーストア情報をロードします。一方、
19.1116 -.B jarsigner
19.1117 -ツールおよび
19.1118 -.B policytool
19.1119 -ツールは、URL を使って指定することが可能な任意の位置にあるキーストアを
19.1120 -読み取ることができます。
19.1121 +若鴻≪鴻若т茘激с鴻≪鴻若 (筝箴с mypass) 絎綽荀障潟潟茵с鴻≪鴻若絎鴻若ュ羆障罕泣若鴻√с鴻若c篆茘激泣鴻若 (筝箴с dukekeypasswd) 絎綽荀障 潟潟茵ч泣鴻若絎障絎鴻若篆絖鴻若c翫泣鴻若ュ羆障
19.1122 .LP
19.1123 -.B jarsigner
19.1124 -と
19.1125 -.BR keytool
19.1126 -の場合、
19.1127 -.I -storetype
19.1128 -オプションを使ってコマンド行でキーストアのタイプを指定できます。
19.1129 -.BR policytool
19.1130 -の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアの
19.1131 -タイプを指定できます。
19.1132 +.RE
19.1133 +.SS
19.1134 +若鴻≪贋
19.1135 .LP
19.1136 -キーストアのタイプを明示的に指定しない場合、
19.1137 -.B keytool
19.1138 -、
19.1139 -.B jarsigner
19.1140 -、および
19.1141 -.B policytool
19.1142 -の各ツールは、セキュリティプロパティファイル内で指定
19.1143 -された
19.1144 -.I keystore.type
19.1145 -プロパティの値に基づいてキーストアの実装を選択します。セキュリティプロパティファ
19.1146 -イルは、
19.1147 -.I java.security
19.1148 -という名前でセキュリティプロパティディレクトリ
19.1149 -.I java.home/lib/security
19.1150 -に置かれています。
19.1151 -.I java.home
19.1152 -は、JDK の実行環境ディレクトリです。(SDK 内の jre ディレクトリ
19.1153 -または Java Runtime Environment のトップレベルのディレクトリ)。
19.1154 +.RS 3
19.1155 +
19.1156 .LP
19.1157 -各ツールは、
19.1158 -.I keystore.type
19.1159 -の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが
19.1160 -見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的の
19.1161 -プロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
19.1162 .LP
19.1163 -.I KeyStore
19.1164 -クラスでは
19.1165 -.I getDefaultType
19.1166 -という名前の static メソッドが定義されており、アプリケーションとアプレットはこの
19.1167 -メソッドを使うことで
19.1168 -.I keystore.type
19.1169 -プロパティの値を取得できます。次のコードは、デフォルトのキーストアタイプ (
19.1170 -.I keystore.type
19.1171 -プロパティで指定されたタイプ) のインスタンスを生成します。
19.1172 +\f3jarsigner\fP 篏睡若鴻≪ URL 絎 \f2\-keystore\fP 激с潟障若鴻≪с若吟若若c \f2.keystore\fP <ゃ主障 若吟若若c\f2user.home\fP 激鴻c若c羆冴障障Solaris 激鴻翫\f2user.home\fP с若吟若若cc障
19.1173 +.LP
19.1174 +.LP
19.1175 +\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP <純羝<障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP <純羝<障\f2NONE\fP \f2KeyStore\fP <ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
19.1176 +.LP
19.1177 +.RE
19.1178 +.SS
19.1179 +若鴻≪絎茖
19.1180 +.LP
19.1181 +.RS 3
19.1182 +
19.1183 +.LP
19.1184 +.LP
19.1185 +\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
19.1186 +.LP
19.1187 +.LP
19.1188 +憜若鴻≪絎茖篏睡\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若障\f2KeyStore\fP public 篏睡純сJava 2 SDK 若吟若 KeyStore 篏帥c祉祉ャc若≪宴若激с潟篏с障
19.1189 +.LP
19.1190 +.LP
19.1191 +若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪<ゃ絎茖障絎茖с泣ャ鴻若c篆茘激若鴻√篏翫с (泣ャ) 鴻若c篆茘激障
19.1192 +.LP
19.1193 +.LP
19.1194 +若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface <純絎臂障 <純ゃ絎茖違障сゃJava Security API c≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сc若鴻≪絎茖箴
19.1195 +.na
19.1196 +\f2Java 垸≪若c主ゃ絎茖号\fP @
19.1197 +.fi
19.1198 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
19.1199 +.LP
19.1200 +.LP
19.1201 +≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance <<純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
19.1202 +.LP
19.1203 +.LP
19.1204 +\f3keytool\fP 篁紙<ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝<若鴻≪贋<ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
19.1205 +.LP
19.1206 +.LP
19.1207 +\f3jarsigner\fP \f3keytool\fP 翫\f2\-storetype\fP 激с潟篏帥c潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP 翫[Edit] <ャ若 [Change Keystore] 潟潟篏帥c若鴻≪帥ゃ絎с障
19.1208 +.LP
19.1209 +.LP
19.1210 +若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャc若c若<ゃф絎 \f2keystore.type\fP c若ゃ冴ャ若鴻≪絎茖御障祉ャc若c若<ゃ\f2java.security\fP SDK 祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
19.1211 +.LP
19.1212 +.LP
19.1213 +若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
19.1214 +.LP
19.1215 +.LP
19.1216 +\f2KeyStore\fP 鴻с \f2getDefaultType\fP static <純絎臂≪宴若激с潟≪<純篏帥 \f2keystore.type\fP c若ゃ緇с障罨<潟若若鴻≪帥ゃ (\f2keystore.type\fP c若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
19.1217 .LP
19.1218 .nf
19.1219 \f3
19.1220 @@ -437,144 +833,150 @@
19.1221
19.1222 .LP
19.1223 .LP
19.1224 -デフォルトのキーストアタイプは jks (Sun が提供する独自のタイプのキーストアの
19.1225 -実装) です。これは、セキュリティプロパティファイル内の次の行によって指定されて
19.1226 -います。
19.1227 +若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャc若c若<ゃ罨<茵c絎障
19.1228 .LP
19.1229 -.RS 5
19.1230 -.B keystore.type=jks
19.1231 +.nf
19.1232 +\f3
19.1233 +.fl
19.1234 + keystore.type=jks
19.1235 +.fl
19.1236 +\fP
19.1237 +.fi
19.1238 +
19.1239 +.LP
19.1240 +.LP
19.1241 +羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
19.1242 +.LP
19.1243 +.LP
19.1244 +若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨<紊眼障
19.1245 +.LP
19.1246 +.nf
19.1247 +\f3
19.1248 +.fl
19.1249 + keystore.type=pkcs12
19.1250 +.fl
19.1251 +\fP
19.1252 +.fi
19.1253 +
19.1254 +.LP
19.1255 +.LP
19.1256 +PKCS#11 ゃ宴若吾篏睡翫荅括完ゃJava PKCS#11 Reference Guide
19.1257 +.na
19.1258 +\f2KeyTool and JarSigner\fP @
19.1259 +.fi
19.1260 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner膀с
19.1261 +.LP
19.1262 .RE
19.1263 +.RE
19.1264 +.SS
19.1265 +泣若≪眼冴
19.1266 .LP
19.1267 -注: キーストアタイプの指定では、大文字と小文字は区別されません。たとえば、「JKS」と「jks」は同じものとみなされます。
19.1268 +.RS 3
19.1269 +
19.1270 .LP
19.1271 -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して
19.1272 -別のキーストアのタイプを指定します。
19.1273 -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供している
19.1274 -プロバイダパッケージを使用するには、上の行を次のように変更します。
19.1275 .LP
19.1276 -.B keystore.type=pkcs12
19.1277 +с\f3jarsigner\fP 罨<<≪眼冴篏帥c JAR <ゃ臀峨障
19.1278 .LP
19.1279 -PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」(
19.1280 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#keytooljarsigner)
19.1281 -にある
19.1282 -「\f2KeyTool and JarSigner\fP」節を参照してください。
19.1283 +.RS 3
19.1284 +.TP 2
19.1285 +o
19.1286 +SHA\-1 ゃ吾с鴻≪眼冴篏帥c DSA (吾帥臀峨≪眼冴)
19.1287 +.TP 2
19.1288 +o
19.1289 +MD5 ゃ吾с鴻≪眼冴篏帥c RSA ≪眼冴
19.1290 +.RE
19.1291 +
19.1292 .LP
19.1293 +.LP
19.1294 +隙臀峨泣泣 DSA 泣с翫\f3jarsigner\fP SHA1withDSA ≪眼冴篏帥c JAR <ゃ臀峨篁障臀峨泣 RSA 泣с翫\f3jarsigner\fP MD5withRSA ≪眼冴篏帥c JAR <ゃ臀峨篁障
19.1295 +.LP
19.1296 +.LP
19.1297 +臀峨≪眼冴\f2\-sigalg\fP 激с潟篏帥c若若ゃс障
19.1298 +.LP
19.1299 +.RE
19.1300 .SS
19.1301 -サポートされるアルゴリズム
19.1302 +臀峨篁 JAR <ゃ
19.1303 .LP
19.1304 -.IX "jarsigner" "Supported Algorithms and Key Sizes" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.1305 +.RS 3
19.1306 +
19.1307 .LP
19.1308 -デフォルトでは、
19.1309 -.B jarsigner
19.1310 -は次のどちらかのアルゴリズムを使って JAR ファイルに署名します。
19.1311 +.LP
19.1312 +\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁翫阪臀峨篁 JAR <ゃュ JAR <ゃс罨< 2 ゃ菴遵<ゃ META\-INF c臀鴻違障
19.1313 +.LP
19.1314 +.RS 3
19.1315 .TP 2
19.1316 -\(bu
19.1317 -SHA-1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム)
19.1318 +o
19.1319 +.SF ≦宍絖篁臀峨<ゃ
19.1320 .TP 2
19.1321 -\(bu
19.1322 -MD5 ダイジェストアルゴリズムを使った RSA アルゴリズム
19.1323 +o
19.1324 +.DSA ≦宍絖篁臀峨<ゃ
19.1325 +.RE
19.1326 +
19.1327 .LP
19.1328 -具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、
19.1329 -.B jarsigner
19.1330 -は「SHA1withDSA」アルゴリズムを使って JAR ファイルに署名を付けようとします。署名者の
19.1331 -鍵が RSA 鍵である場合、
19.1332 -.B jarsigner
19.1333 -は「MD5withRSA」アルゴリズムを使って JAR ファイルに署名を付けます。
19.1334 .LP
19.1335 -これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。
19.1336 + 2 ゃ<ゃ若鴻<ゃ\f2\-sigFile\fP 激с潟ゃ篏障違罨<激с潟絎障
19.1337 .LP
19.1338 +.nf
19.1339 +\f3
19.1340 +.fl
19.1341 + \-sigFile MKSIGN
19.1342 +.fl
19.1343 +\fP
19.1344 +.fi
19.1345 +
19.1346 +.LP
19.1347 +.LP
19.1348 +翫<ゃ MKSIGN.SF MKSIGN.DSA 障
19.1349 +.LP
19.1350 +.LP
19.1351 +潟潟茵 \f2\-sigfile\fP 激с潟絎c翫.SF <ゃ .DSA <ゃ若鴻<ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨<ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀<ゃ篏障篏睡с絖≪<医筝膩 (_)ゃ潟с
19.1352 +.LP
19.1353 +\f3臀峨 (.SF) <ゃ\fP
19.1354 +.LP
19.1355 +.RS 3
19.1356 +
19.1357 +.LP
19.1358 +.LP
19.1359 +臀峨<ゃ (.SF <ゃ) \f3jarsigner\fP х讐篁 JAR <ゃ絽吾障с鴻<ゃ篌若障ゃ障с鴻<ゃ罕.SF <ゃJAR <ゃ障純若鴻<ゃ罨< 3 ゃ茵障
19.1360 +.LP
19.1361 +.RS 3
19.1362 +.TP 2
19.1363 +o
19.1364 +<ゃ
19.1365 +.TP 2
19.1366 +o
19.1367 +篏帥ゃ吾с鴻≪眼冴 (SHA)
19.1368 +.TP 2
19.1369 +o
19.1370 +SHA ゃ吾с鴻
19.1371 +.RE
19.1372 +
19.1373 +.LP
19.1374 +.LP
19.1375 +с鴻<ゃсSHA ゃ吾с鴻ゃ純若鴻<ゃゃ若帥ゃ吾с鴻 (激) с筝鴻.SF <ゃс純若鴻<ゃゃ吾с鴻ゃс鴻<ゃ筝荅峨純若鴻<ゃ絲上 3 茵激ャс
19.1376 +.LP
19.1377 +.LP
19.1378 +臀峨<ゃсс鴻<ゃ篏激ャ障障緇菴違JAR <ゃ罎荐若ц若絖c罎荐若純c障
19.1379 +.LP
19.1380 +.RE
19.1381 +\f3臀峨 (.DSA) <ゃ\fP
19.1382 +.LP
19.1383 +.RS 3
19.1384 +
19.1385 +.LP
19.1386 +.LP
19.1387 +.SF <ゃ臀峨篁臀峨 .DSA <ゃ臀障.DSA <ゃ若鴻≪荐惹吾障荐惹吾с若潟膃垸綵≪у障障 荐惹吾障荐惹吾с若潟臀峨篏帥泣絲上泣茯荐若障
19.1388 +.LP
19.1389 +.RE
19.1390 +.RE
19.1391 .SS
19.1392 -署名付き JAR ファイル
19.1393 +臀峨帥ゃ鴻帥潟
19.1394 .LP
19.1395 -.IX "jarsigner" "The Signed JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.1396 +.RS 3
19.1397 +
19.1398 .LP
19.1399 -.B jarsigner
19.1400 -を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは
19.1401 -入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが
19.1402 -.B META-INF
19.1403 -ディレクトリに置かれる点が異なります。
19.1404 -.TP 2
19.1405 -\(bu
19.1406 -.B .SF
19.1407 -拡張子の付いた署名ファイル
19.1408 -.TP 2
19.1409 -\(bu
19.1410 -.B .DSA
19.1411 -拡張子の付いた署名ブロックファイル
19.1412 .LP
19.1413 -これら 2 つのファイルのベースファイル名は、
19.1414 -.I -sigFile
19.1415 -オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。
19.1416 -.LP
19.1417 -.B -sigFile MKSIGN
19.1418 -.LP
19.1419 -この場合、ファイル名はそれぞれ
19.1420 -.B MKSIGN.SF
19.1421 -と
19.1422 -.BR MKSIGN.DSA
19.1423 -になります。
19.1424 -.LP
19.1425 -コマンド行に
19.1426 -.I -sigfile
19.1427 -オプションの指定がない場合、
19.1428 -.B .SF
19.1429 -ファイルと
19.1430 -.B .DSA
19.1431 -ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字を
19.1432 -すべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名が
19.1433 -そのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれ
19.1434 -ている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
19.1435 -使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。
19.1436 -.LP
19.1437 -署名 (\f3.SF\f1) ファイル
19.1438 -.LP
19.1439 -署名ファイル (
19.1440 -.B .SF
19.1441 -ファイル) は、
19.1442 -.B jar
19.1443 -ツールで生成された JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、
19.1444 -.B .SF
19.1445 -ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。
19.1446 -.TP 2
19.1447 -\(bu
19.1448 -ファイル名
19.1449 -.TP 2
19.1450 -\(bu
19.1451 -使われているダイジェストアルゴリズム (SHA) の名前
19.1452 -.TP 2
19.1453 -\(bu
19.1454 -SHA ダイジェストの値
19.1455 -.LP
19.1456 -マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータ
19.1457 -のダイジェスト (ハッシュ) です。一方、
19.1458 -.B .SF
19.1459 -ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当する
19.1460 -ソースファイルに対応する 3 行のハッシュです。
19.1461 -.LP
19.1462 -署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。
19.1463 -後述の「JAR ファイルの検証」で説明するように、このヘッダの存在によって検証の
19.1464 -最適化が可能になっています。
19.1465 -.LP
19.1466 -署名ブロック (\f3.DSA\f1) ファイル
19.1467 -.LP
19.1468 -.B .SF
19.1469 -ファイルには署名が付けられ、署名は
19.1470 -.B .DSA
19.1471 -ファイルに置かれます。
19.1472 -.B .DSA
19.1473 -ファイルには、キーストアからの証明書または証明連鎖も符号化された形で含まれて
19.1474 -います。証明書または証明連鎖は、署名に使われた非公開鍵に対応する公開鍵を
19.1475 -認証します。
19.1476 -.LP
19.1477 -.SS
19.1478 -署名タイムスタンプ
19.1479 -.LP
19.1480 -.LP
19.1481 -J2SE 5.0 リリースの
19.1482 -.I jarsigner
19.1483 -ツールは、JAR ファイルの署名時に署名タイムスタンプを生成および格納できるようになりました。さらに、
19.1484 -.I jarsigner
19.1485 -は代替の署名機構もサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。
19.1486 +J2SE 5.0 若鴻 \f2jarsigner\fP 若JAR <ゃ臀峨臀峨帥ゃ鴻帥潟恰主с障\f2jarsigner\fP 篁f睡讐罘罕泣若障篏ュ純с臀峨罨<激с潟c九勝障
19.1487 .LP
19.1488 .RS 3
19.1489 .TP 2
19.1490 @@ -593,204 +995,143 @@
19.1491
19.1492 .LP
19.1493 .LP
19.1494 -これらの各オプションの詳細については、後述の「オプション」節を参照してください。
19.1495 +激с潟荅括完ゃ緇菴違激с潟膀с
19.1496 .LP
19.1497 +.RE
19.1498 .SS
19.1499 -JAR ファイルの検証
19.1500 +JAR <ゃ罎荐
19.1501 .LP
19.1502 -.IX "jarsigner" "JAR File Verification" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.1503 +.RS 3
19.1504 +
19.1505 .LP
19.1506 -JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に
19.1507 -JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。
19.1508 -.TP 5
19.1509 -1.
19.1510 -.B .SF
19.1511 -ファイルそれ自体の署名を検証します。
19.1512 -.RS
19.1513 .LP
19.1514 -この手順では、各署名ブロック (
19.1515 -.B .DSA
19.1516 -) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って
19.1517 -生成されたものであることを確認します。
19.1518 -.B .DSA
19.1519 -ファイルには、公開鍵の証明書も含まれています。また、この手順
19.1520 -では、目的の署名が、対応する署名 (
19.1521 -.B .SF
19.1522 -) ファイル内の有効な署名であるかどうかを調べ、
19.1523 -.B .SF
19.1524 -ファイルが改変されていないことも確認します。
19.1525 -.RE
19.1526 -.TP 5
19.1527 -2.
19.1528 -.B .SF
19.1529 -ファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突き
19.1530 -合わせて検証します。
19.1531 -.RS
19.1532 -.LP
19.1533 -.B .SF
19.1534 -ファイルには、マニフェストファイル全体のハッシュが格納されたヘッダがデフォルトで
19.1535 -含まれています。このヘッダが存在する場合は、ヘッダ内のハッシュが実際にマニフェ
19.1536 -ストファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致す
19.1537 -る場合は、次の手順に進みます。
19.1538 -.LP
19.1539 -ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。具体的
19.1540 -には、
19.1541 -.B .SF
19.1542 -ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の
19.1543 -対応するセクションのハッシュと一致するかどうかを確認します (「署名 (\f3.SF\f1)
19.1544 -ファイル」を参照)。
19.1545 -.LP
19.1546 -.B .SF
19.1547 -ファイルのヘッダに格納されたマニフェストファイルのハッシュと、実際のマニフェスト
19.1548 -ファイルのハッシュとが一致しない場合は、署名 (および
19.1549 -.B .SF
19.1550 -ファイル) の生成後に、ファイルに 1 つ以上のファイルが追加 (
19.1551 -.I jar
19.1552 -ツールを使用) された可能性があります。
19.1553 -.I jar
19.1554 -ツールを使ってファイルを追加した場合、マニフェストファイルは変更されますが
19.1555 -(新しいファイル用のセクションが追加される)、
19.1556 -.B .SF
19.1557 -ファイルは変更されません。この場合、
19.1558 -.B .SF
19.1559 -ファイルのヘッダ以外のセクションに格納されたハッシュが、マニフェストファイル内の
19.1560 -対応するセクションのハッシュと一致するときは、署名の生成時に JAR ファイル内に
19.1561 -存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功
19.1562 -したものとして扱われます。
19.1563 -.RE
19.1564 -.TP 5
19.1565 -3.
19.1566 -JAR ファイル内のファイルのうち、
19.1567 -.B .SF
19.1568 -ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルの
19.1569 -ダイジェストを計算し、結果をマニフェストセクション内の該当するファイルの
19.1570 -ダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない
19.1571 -場合は検証が失敗します。
19.1572 -.LP
19.1573 -検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセス
19.1574 -は中止され、セキュリティ例外がスローされます。スローされたセキュリティ例外は、
19.1575 -.BR jarsigner
19.1576 -がキャッチして表示します。
19.1577 -.LP
19.1578 -.SS
19.1579 -1 つの JAR ファイルを対象とする複数の署名
19.1580 -.LP
19.1581 -.IX "jarsigner" "Multiple Signatures for a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.1582 -.LP
19.1583 -1 つの JAR ファイルに対して
19.1584 -.B jarsigner
19.1585 -ツールを複数回実行し、実行のたびに、異なるユーザの別名を指定すれば、JAR
19.1586 -ファイルに複数のユーザの署名を付けることができます。たとえば、次のようにします。
19.1587 -.LP
19.1588 -.ft 3
19.1589 -.nf
19.1590 -jarsigner myBundle.jar susan
19.1591 -jarsigner myBundle.jar kevin
19.1592 -.fi
19.1593 -.ft 1
19.1594 -.LP
19.1595 -JAR ファイルが複数回署名されている場合、その JAR ファイルには
19.1596 -.B .SF
19.1597 -ファイルと
19.1598 -.B .DSA
19.1599 -ファイルの対が複数含まれることになります。
19.1600 -.B .SF
19.1601 -ファイルと
19.1602 -.B .DSA
19.1603 -ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力
19.1604 -される JAR ファイルには、次の名前を持つファイルが含まれます。
19.1605 -.LP
19.1606 -.ft 3
19.1607 -.nf
19.1608 -SUSAN.SF
19.1609 -SUSAN.DSA
19.1610 -KEVIN.SF
19.1611 -KEVIN.DSA
19.1612 -.fi
19.1613 -.ft 1
19.1614 -.LP
19.1615 -注: JDK 1.1 の
19.1616 -.B javakey
19.1617 -ツールで生成した署名と、
19.1618 -.B jarsigner
19.1619 -で生成した署名というように、
19.1620 -1 つの JAR ファイルに署名を混在させることができます。
19.1621 -つまり
19.1622 -.B javakey
19.1623 -ですでに以前署名した JAR ファイルに署名するために、
19.1624 -.B jarsigner
19.1625 -を使用できます。
19.1626 -.SH "オプション"
19.1627 -.LP
19.1628 -以下では、
19.1629 -.B jarsigner
19.1630 -のオプションについて説明します。オプションを指定するときは、次の点に注意
19.1631 -してください。
19.1632 -.TP 2
19.1633 -\(bu
19.1634 -どのオプション名にも先頭にマイナス記号 (-) が付く
19.1635 -.TP 2
19.1636 -\(bu
19.1637 -オプションは任意の順序で指定できる
19.1638 -.TP 2
19.1639 -\(bu
19.1640 -イタリック体の項目の実際の値 (オプションの値) は、ユーザが指定する必要がある
19.1641 -.TP 2
19.1642 -\(bu
19.1643 -.I -keystore、
19.1644 -.I -storepass、
19.1645 -.I -keypass、
19.1646 -.I -sigfile、
19.1647 -.I -sigalg、
19.1648 -.I -digestalg、
19.1649 -および
19.1650 -.I -signedjar
19.1651 -の各オプションを使用できるのは、JAR ファイルに署名を付ける場合だけである。
19.1652 -これらのオプションは、JAR ファイルを検証する場合には使用できない。同様に、
19.1653 -別名をコマンド行で指定するのは、JAR ファイルに署名を付ける場合だけである
19.1654 +JAR <ゃ罎荐若臀峨鴻сょ讐篁ュ JAR <ゃ<ゃ紊眼翫сJAR <ゃ罎荐若罨<ц障
19.1655 .LP
19.1656 .RS 3
19.1657 .TP 3
19.1658 -.B -keystore url
19.1659 -キーストアの場所を示す URL を指定します。デフォルトは、ユーザのホームディレクト
19.1660 -リ内のファイル
19.1661 -.I .keystore
19.1662 -です。ユーザのホームディレクトリは、
19.1663 -.I user.home
19.1664 -システムプロパティによって決まります。
19.1665 +1.
19.1666 +.SF <ゃ篏臀峨罎荐若障
19.1667 .LP
19.1668 -署名するときはキーストアが必要です。このため、デフォルトのキーストアが存在
19.1669 -しない場合、あるいはデフォルト以外のほかのキーストアを使用する場合は、
19.1670 -キーストアを明示的に指定する必要があります。
19.1671 +с臀峨 (.DSA) <ゃ主臀峨絎泣絲上泣篏帥cс腆肴障 .DSA <ゃ泣荐惹 (障荐惹吾с若) 障障障с臀峨絲上臀峨 (.SF) <ゃ鴻臀峨с茯帥鴻.SF <ゃ劫腆肴障
19.1672 +.TP 3
19.1673 +2.
19.1674 +.SF <ゃ潟ゃ吾с鴻с鴻絲上祉激с潟腦罎荐若障
19.1675 .LP
19.1676 -検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、
19.1677 -あるいはデフォルトのキーストアが存在していて、さらに
19.1678 -.I -verbose
19.1679 -オプションも指定されている場合は、JAR ファイルの検証に使われる証明書が
19.1680 -キーストアに存在するかどうかについての追加情報が出力されます。
19.1681 +.SF <ゃс鴻<ゃ篏激ャ主若у障障若絖翫弱激ャ絎с鴻<ゃ激ャ筝眼罎荐若с障激ャ筝眼翫罨<蚊帥障
19.1682 .LP
19.1683 -注:
19.1684 -.I -keystore
19.1685 -の引数には、URL の代わりにファイル名 (とパス) を指定できます。ファイル名
19.1686 -(とパス) を指定した場合は、「file:」URL として扱われます。たとえば、次のように
19.1687 -指定できます。
19.1688 +激ャ筝眼翫合c号篏帥c罎荐若茵障 隙.SF <ゃ純若鴻<ゃ宴祉激с潟激ャс鴻<ゃ絲上祉激с潟激ャ筝眼腆肴障 (臀峨 (.SF) <ゃ)
19.1689 .LP
19.1690 -.B -keystore filePathAndName
19.1691 +.SF <ゃ若主с鴻<ゃ激ャ絎с鴻<ゃ激ャ筝眼翫臀峨 ( .SF <ゃ) 緇JAR <ゃ 1 や札筝<ゃ菴遵 (\f2jar\fP 若篏睡) 醇с障\f2jar\fP 若篏帥c<ゃ菴遵翫с鴻<ゃ紊眼障 (違<ゃ祉激с潟菴遵).SF <ゃ紊眼障翫.SF <ゃ寂札紊祉激с潟主激ャс鴻<ゃ絲上祉激с潟激ャ筝眼臀峨 JAR <ゃ絖<ゃ<<ゃ紊眼罎荐若宴障
19.1692 +.TP 3
19.1693 +3.
19.1694 +JAR <ゃ<ゃ<.SF <ゃ潟ゅ<ゃ茯粋昭帥障茯粋昭推賢<ゃゃ吾с鴻荐膊腟с鴻祉激с喝荅峨<ゃゃ吾с鴻罸莠障2 ゃゃ吾с鴻с違с翫罎荐若紊掩障
19.1695 +.RE
19.1696 +
19.1697 .LP
19.1698 -これは、次の指定と同じものとして扱われます。
19.1699 .LP
19.1700 -.B -keystore file:filePathAndName
19.1701 +罎荐若祉鴻筝с紊с罎荐若若榊翫罎荐若祉鴻筝罩≪祉ャc寂紊鴻若障鴻若祉ャc寂紊\f3jarsigner\fP c茵腓冴障
19.1702 .LP
19.1703 +.RE
19.1704 +.SS
19.1705 +1 ゃ JAR <ゃ絲乗院茲違臀峨
19.1706 +.LP
19.1707 +.RS 3
19.1708 +
19.1709 +.LP
19.1710 +.LP
19.1711 +1 ゃ JAR <ゃ絲障 \f3jarsigner\fP 若茲医絎茵絎茵潟違若吟若ュ絎違JAR <ゃ茲違若吟若臀峨篁с障
19.1712 +.LP
19.1713 +.nf
19.1714 +\f3
19.1715 +.fl
19.1716 + jarsigner myBundle.jar susan
19.1717 +.fl
19.1718 + jarsigner myBundle.jar kevin
19.1719 +.fl
19.1720 \fP
19.1721 .fi
19.1722 -JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティプロパティファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。
19.1723 +
19.1724 +.LP
19.1725 +.LP
19.1726 +JAR <ゃ茲医臀峨翫 JAR <ゃ .SF <ゃ .DSA <ゃ絲障茲医障障 .SF <ゃ .DSA <ゃ絲障1 臀峨絲障 1 や障c筝箴у阪 JAR <ゃ罨<ゃ<ゃ障障
19.1727 +.LP
19.1728 +.nf
19.1729 +\f3
19.1730 +.fl
19.1731 + SUSAN.SF
19.1732 +.fl
19.1733 + SUSAN.DSA
19.1734 +.fl
19.1735 + KEVIN.SF
19.1736 +.fl
19.1737 + KEVIN.DSA
19.1738 +.fl
19.1739 +\fP
19.1740 +.fi
19.1741 +
19.1742 +.LP
19.1743 +.LP
19.1744 +羈:JAR <ゃсJDK 1.1 \f3javakey\fP 若х臀峨 \f3jarsigner\fP х臀峨羞桁с障ゃ障с \f3javakey\fP 篏帥c臀峨篁 JAR <ゃ\f3jarsigner\fP 篏帥c臀峨篁с障
19.1745 +.LP
19.1746 +.RE
19.1747 +.SH "激с"
19.1748 +.LP
19.1749 +
19.1750 +.LP
19.1751 +.LP
19.1752 +篁ヤс\f3jarsigner\fP 激с潟ゃ茯障羈:
19.1753 +.LP
19.1754 .RS 3
19.1755 .TP 2
19.1756 -o \f2\-keystore NONE\fP
19.1757 +o
19.1758 +激с喝ゃ壕 (\-) 篁
19.1759 .TP 2
19.1760 -o \f2\-storetype PKCS11\fP
19.1761 +o
19.1762 +激с潟篁紙綺ф絎с
19.1763 +.TP 2
19.1764 +o
19.1765 +ゃ帥篏絎 (激с潟) 若吟若絎綽荀
19.1766 +.TP 2
19.1767 +o
19.1768 +\f2\-keystore\fP\f2\-storepass\fP\f2\-keypass\fP\f2\-sigfile\fP\f2\-sigalg\fP\f2\-digestalg\fP \f2\-signedjar\fP 激с潟篏睡сJAR <ゃ臀峨篁翫с 激с潟JAR <ゃ罎荐若翫篏睡с罕ュ潟潟茵ф絎JAR <ゃ臀峨篁翫с
19.1769 .RE
19.1770 -たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。
19.1771 +
19.1772 +.LP
19.1773 +.RS 3
19.1774 +.TP 3
19.1775 +\-keystore url
19.1776 +若鴻≪贋腓冴 URL 絎障若吟若若c<ゃ \f2.keystore\fP с 若吟若若cuser.home 激鴻c若c羆冴障障
19.1777 +.LP
19.1778 +臀峨若鴻≪綽荀с 若鴻≪絖翫篁ュ祉若鴻≪篏睡翫若鴻≪腓榊絎綽荀障
19.1779 +.LP
19.1780 +罎荐若若鴻≪綽荀障 若鴻≪絎若鴻≪絖 \f2\-verbose\fP 激с潟絎翫JAR <ゃ罎荐若篏帥荐惹吾若鴻≪絖ゃ菴遵宴阪障
19.1781 +.LP
19.1782 +羈:\f2\-keystore\fP 綣違URL 篁c<ゃ () 絎с障 <ゃ () 絎翫file:URL 宴障違罨<絎с障
19.1783 +.nf
19.1784 +\f3
19.1785 +.fl
19.1786 + \-keystore \fP\f4filePathAndName\fP\f3
19.1787 +.fl
19.1788 +\fP
19.1789 +.fi
19.1790 +罨<絎宴障
19.1791 +.nf
19.1792 +\f3
19.1793 +.fl
19.1794 + \-keystore file:\fP\f4filePathAndName\fP\f3
19.1795 +.fl
19.1796 +\fP
19.1797 +.fi
19.1798 +JRE \f2$JAVA_HOME/lib/security\fP c主 \f2java.security\fP 祉ャc若c若<ゃ Sun PKCS#11 ゃ荐絎翫keytool jarsigner PKCS#11 若潟冴ャ篏с障 罨<激с潟絎障
19.1799 +.RS 3
19.1800 +.TP 2
19.1801 +o
19.1802 +\f2\-keystore NONE\fP
19.1803 +.TP 2
19.1804 +o
19.1805 +\f2\-storetype PKCS11\fP
19.1806 +.RE
19.1807 +違罨<潟潟荐絎 PKCS#11 若潟絎鴻筝荀ц;腓冴障
19.1808 .RS 3
19.1809
19.1810 .LP
19.1811 @@ -805,228 +1146,119 @@
19.1812 .fi
19.1813 .RE
19.1814 .TP 3
19.1815 -.B -storetype storetype
19.1816 -インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストアの
19.1817 -タイプは、セキュリティプロパティファイルで keystore.type プロパティの値として
19.1818 -指定されたタイプで、
19.1819 -.I java.security.KeyStore
19.1820 -の static
19.1821 -.I getDefaultType
19.1822 -メソッドによって返されます。
19.1823 +\-storetype storetype
19.1824 +ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障若鴻≪帥ゃ祉ャc若c若<ゃ keystore.type c若ゃф絎帥ゃс ゃ\f2java.security.KeyStore\fP static \f2getDefaultType\fP <純у緇с障
19.1825 .LP
19.1826 -\f2\-storepass\fP オプションを使って PCKS#11 トークンの PIN を指定することも
19.1827 -できます。何も指定しなかった場合、keytool と jarsigner はユーザにトークン PIN の
19.1828 -入力を求めます。トークンの認証パスが、専用の PIN パッドやバイオメトリックリーダの
19.1829 -ような保護されたパスである場合、\f2\-protected\fP オプションを指定する必要があります。
19.1830 -この場合、パスワードオプションは指定できません。
19.1831 -.TP
19.1832 -.B -storepass password
19.1833 -キーストアにアクセスするのに必要なパスワードを指定します。このオプションが必要
19.1834 -なのは、JAR ファイルに署名を付けるときだけです (JAR ファイルを検証するときは
19.1835 -不要)。署名を付けるときに、コマンド行で
19.1836 -.I -storepass
19.1837 -オプションを指定しなかった場合は、パスワードの入力を求められます。
19.1838 -.RS
19.1839 +\f2\-storepass\fP 激с潟篏帥c PCKS#11 若潟 PIN 絎с障篏絎c翫keytool jarsigner 若吟若若 PIN ュ羆障若潟篆茘激茯荐若 (絨 PIN 篏茯水罘) 翫\f2\-protected\fP 激с潟絎綽荀障鴻若激с潟絎綽荀障
19.1840 +.TP 3
19.1841 +\-storepass password
19.1842 +若鴻≪≪祉鴻綽荀鴻若絎障激с潟綽荀JAR <ゃ臀峨篁с (JAR <ゃ罎荐若筝荀)臀峨篁潟潟茵 \f2\-storepass\fP 激с潟絎c翫鴻若ュ羆障
19.1843 .LP
19.1844 -注: テストを目的とする場合、または安全が保障されたシステムで実行する場合
19.1845 -以外は、コマンド行やスクリプトでパスワードを指定しないでください。また、
19.1846 -password プロンプトでパスワードを入力すると、入力したパスワードがエコーされ、
19.1847 -そのまま画面に表示されます。このため、周囲にほかのユーザがいる場合は、
19.1848 -パスワードを見られないように注意してください。
19.1849 -.RE
19.1850 -.TP
19.1851 -.B -keypass password
19.1852 -コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するの
19.1853 -に使うパスワードを指定します。
19.1854 -.B jarsigner
19.1855 -を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行で
19.1856 -パスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる
19.1857 -場合は、パスワードの入力を求められます。
19.1858 -.RS
19.1859 +羈:鴻翫障祉ャc寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
19.1860 +.TP 3
19.1861 +\-keypass password
19.1862 +潟潟茵ф絎ュ絲上若鴻≪潟泣篆茘激篏帥鴻若絎障\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁鴻若綽荀с潟潟茵с鴻若絎綽荀鴻若鴻≪鴻若違翫鴻若ュ羆障
19.1863 .LP
19.1864 -注: テストを目的とする場合、または安全であることがわかっているシステムで
19.1865 -実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
19.1866 -また、password プロンプトでパスワードを入力すると、入力したパスワードがエコー
19.1867 -され、そのまま画面に表示されます。このため、周囲にほかのユーザがいる場合は、
19.1868 -パスワードを見られないように注意してください。
19.1869 -.RE
19.1870 -.TP
19.1871 -.B -sigfile file
19.1872 -SF ファイルと .DSA ファイルの生成に使うベースファイル名を指定します。
19.1873 -たとえば、file に DUKESIGN を指定すると、生成される .SF ファイルと
19.1874 -.DSA ファイルの名前は、それぞれ DUKESIGN.SF と DUKESIGN.DSA になります。
19.1875 -これらのファイルは、署名付き JAR ファイルの META-INF ディレクトリに置かれます。
19.1876 -.RS
19.1877 +羈:鴻翫障祉ャc寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
19.1878 +.TP 3
19.1879 +\-sigfile file
19.1880 +.SF <ゃ .DSA <ゃ篏帥若鴻<ゃ絎障違\f2file\fP DUKESIGN 絎 .SF <ゃ .DSA <ゃ DUKESIGN.SF DUKESIGN.DSA 障 <ゃ臀峨篁 JAR <ゃ META\-INF c臀障
19.1881 .LP
19.1882 -.I file
19.1883 -に使用できる文字は「a-zA-Z0-9_-」です。つまり、文字、数字、下線、
19.1884 -およびハイフンだけを使用できます。注:
19.1885 -.B .SF
19.1886 -および
19.1887 -.B .DSA
19.1888 -のファイル名では、小文字はすべて大文字に変換されます。
19.1889 +\f2file\fP 篏睡с絖a\-zA\-Z0\-9_\-сゃ障絖医筝膩潟ゃ潟篏睡с障羈:.SF .DSA <ゃс絨絖鴻紊ф絖紊障
19.1890 .LP
19.1891 -コマンド行で
19.1892 -.I -sigfile
19.1893 -オプションを指定しなかった場合、
19.1894 -.B .SF
19.1895 -ファイルと
19.1896 -.B .DSA
19.1897 -ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字を
19.1898 -すべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名が
19.1899 -そのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている
19.1900 -場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
19.1901 +潟潟茵 \f2\-sigfile\fP 激с潟絎c翫.SF <ゃ .DSA <ゃ若鴻<ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨<ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀<ゃ篏障
19.1902 .TP 3
19.1903 -\-sigalg algorithm
19.1904 +\-sigalg algorithm
19.1905 .RS 3
19.1906
19.1907 .LP
19.1908 -JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。
19.1909 +JAR <ゃ臀峨篏睡臀峨≪眼冴絎障
19.1910 .LP
19.1911 -標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」(
19.1912 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa)
19.1913 -にある
19.1914 -「
19.1915 -.I Appendix A
19.1916 -」を参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、MD5withRSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザがそのようなプロバイダを
19.1917 -.I \-providerClass
19.1918 -オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
19.1919 +罔羣臀峨≪眼冴筝荀сゃJava Cryptography Architecture
19.1920 +.na
19.1921 +\f2Appendix A \fP @
19.1922 +.fi
19.1923 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс≪眼冴JAR <ゃ臀峨篏睡腱絲泣篋сс違障激с潟絎c翫腱絲泣帥ゃ綽 SHA1withDSAMD5withRSA 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥c絎綽荀障 с翫潟潟絎茵紊掩障
19.1924 .LP
19.1925 .RE
19.1926 .TP 3
19.1927 -\-digestalg algorithm
19.1928 +\-digestalg algorithm
19.1929 .RS 3
19.1930 -JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。
19.1931 +JAR <ゃ潟ゃ吾с鴻篏睡<祉若吾ゃ吾с鴻≪眼冴絎障
19.1932 .LP
19.1933 -標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」(http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa)の
19.1934 -「
19.1935 -.I Appendix A
19.1936 -」を参照してください。このオプションを指定しなかった場合、SHA\-1 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザがそのようなプロバイダを
19.1937 -.I \-providerClass
19.1938 -オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
19.1939 +罔羣<祉若吾ゃ吾с鴻≪眼冴筝荀сゃJava Cryptography Architecture
19.1940 +.na
19.1941 +\f2Appendix A \fP @
19.1942 +.fi
19.1943 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс激с潟絎c翫SHA\-1 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥c絎綽荀障 с翫潟潟絎茵紊掩障
19.1944 +.LP
19.1945 .RE
19.1946 -.TP
19.1947 -.B -signedjar file
19.1948 -署名付き JAR ファイルの名前を指定します。
19.1949 -.RS
19.1950 +.TP 3
19.1951 +\-signedjar file
19.1952 +臀峨篁 JAR <ゃ絎障
19.1953 .LP
19.1954 -コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる
19.1955 -JAR ファイル) の名前と同じ名前が使われます。この場合、入力 JAR ファイルは署名
19.1956 -付き JAR ファイルによって上書きされます。
19.1957 +潟潟茵у絎c翫ュ JAR <ゃ (臀峨絲乗院 JAR <ゃ) 篏帥障 翫ュ JAR <ゃ臀峨篁 JAR <ゃc筝吾障
19.1958 +.TP 3
19.1959 +\-verify
19.1960 +潟潟茵с激с潟絎翫絎 JAR <ゃ罎荐若障JAR <ゃ吾臀峨茵障 罎荐若jar 罎荐若障 <祉若吾茵腓冴障臀峨 JAR <ゃ障泣若≪眼冴 (RSA ゃゃ潟鴻若腟篋翫 RSA ) 篏帥c臀峨 JAR <ゃ罎荐若jar 臀峨障(臀峨荀ゃ罕茹fс障)<祉若吾茵腓冴障
19.1961 +.LP
19.1962 +臀峨篁 JAR <ゃ\f3jarsigner\fP 障 JDK 1.1 \f3javakey\fP 若筝≧鴻篏帥c罎荐若с障
19.1963 +.LP
19.1964 +罎荐若ゃ荅括完JAR <ゃ罎荐若с
19.1965 +.TP 3
19.1966 +\-certs
19.1967 +潟潟茵с\f2\-verify\fP \f2\-verbose\fP 激с潟激с潟絎翫JAR <ゃ臀峨荐惹御宴阪障荐惹御宴罨<障障
19.1968 +.RS 3
19.1969 +.TP 2
19.1970 +o
19.1971 +臀峨泣荐惹 (.DSA <ゃ主) 荐惹吾腮蕁
19.1972 +.TP 2
19.1973 +o
19.1974 +荐惹吾 X.509 荐惹 (ゃ障\f2java.security.cert.X509Certificate\fP ゃ潟鴻帥潟) с翫臀峨茘ュ
19.1975 .RE
19.1976 -.TP
19.1977 -.B -verify
19.1978 -コマンド行でこのオプションが指定されている場合は、指定された JAR ファイルが
19.1979 -検証されます。JAR ファイルへの署名は行われません。検証が成功すると、
19.1980 -「jar verified」というメッセージが表示されます。署名されていない JAR ファイル、
19.1981 -またはサポートされていないアルゴリズム (RSA プロバイダがインストールされていない
19.1982 -場合の RSA など) を使って署名された JAR ファイルを検証しようとすると、
19.1983 -「jar is unsigned. (signatures missing or not parsable)」というメッセージが表示されます。
19.1984 -.RS
19.1985 .LP
19.1986 -署名付き JAR ファイルは、
19.1987 -.B jarsigner
19.1988 -または JDK 1.1 の
19.1989 -.B javakey
19.1990 -ツール、あるいはその両方を使って検証できます。
19.1991 +若鴻≪腆肴茵障潟潟茵с若鴻≪ゃ絎翫若鴻≪<ゃ違罎祉障臀峨泣荐惹吾若鴻√潟筝眼翫罨<宴茵腓冴障
19.1992 +.RS 3
19.1993 +.TP 2
19.1994 +o
19.1995 +臀峨荅峨若鴻≪潟ュ ュ綣су蚊障障若鴻≪с JDK 1.1 ≪ゃ潟cc若若帥若鴻掩ャ臀峨翫綣сс鎀ф綣су蚊障障
19.1996 +.RE
19.1997 +.TP 3
19.1998 +\-verbose
19.1999 +潟潟茵с激с潟絎翫\f3jarsigner\fP 激≪若у篏JAR 臀峨障罎荐若画倶≪菴遵宴阪障
19.2000 +.TP 3
19.2001 +\-internalsf
19.2002 +篁ュJAR <ゃ臀峨 .DSA (臀峨) <ゃ筝 .SF <ゃ (臀峨<ゃ) 絎潟若膃垸綵≪у障障篏紊眼障篏紊眼憜с阪 JAR <ゃ篏泣ゃ冴絨с .SF <ゃ .DSA <ゃ障c障潟潟茵 \f2\-internalsf\fP 激с潟絎篁ュ篏障\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
19.2003 +.TP 3
19.2004 +\-sectionsonly
19.2005 +潟潟茵с激с潟絎翫JAR <ゃ臀峨 .SF <ゃ (臀峨<ゃ) с鴻<ゃ篏激ャ若菴遵障翫.SF <ゃ障JAR <ゃ純若鴻<ゃ≪宴潟激ャс 荅括完臀峨 (.SF) <ゃс
19.2006 .LP
19.2007 -検証についての詳細は、「JAR ファイルの検証」を参照してください。
19.2008 +с茵с鴻<ゃ篏激ャ若菴遵障若絖翫JAR <ゃ罎荐惹障弱激ャс鴻<ゃ篏激ャ絎筝眼腆肴障激ャ筝眼翫罎荐若罨<蚊帥障激ャ筝眼翫合c号篏帥c罎荐若茵障 隙.SF <ゃ純若鴻<ゃ宴祉激с潟激ャс鴻<ゃ絲上祉激с潟激ャ筝眼腆肴障
19.2009 +.LP
19.2010 +荅括完JAR <ゃ罎荐若с
19.2011 +.LP
19.2012 +\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
19.2013 +.TP 3
19.2014 +\-protected
19.2015 +\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
19.2016 .RE
19.2017 -.TP
19.2018 -.B -certs
19.2019 -コマンド行で、
19.2020 -.I -verify
19.2021 -および
19.2022 -.I -verbose
19.2023 -オプションとともにこのオプションが指定されている場合は、JAR ファイルの各署名者
19.2024 -の証明書情報も出力されます。証明書情報には次のものが含まれます。
19.2025 -.RS
19.2026 -.TP 2
19.2027 -\(bu
19.2028 -署名者の公開鍵を証明する (
19.2029 -.B .DSA
19.2030 -ファイルに格納された) 証明書の種類の名前
19.2031 -.TP 2
19.2032 -\(bu
19.2033 -証明書が X.509 証明書 (具体的には
19.2034 -.I java.security.cert.X509Certificate
19.2035 -のインスタンス) である場合は、署名者の識別名
19.2036 +.RS 3
19.2037 +.TP 3
19.2038 +\-provider provider\-class\-name
19.2039 +泣若鴻ゃ祉ャc若c若<ゃ (\f2java.security\fP) 鴻ャc垸泣若鴻ゃ鴻帥若鴻<ゃ絎障
19.2040 .LP
19.2041 -キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない
19.2042 -場合、デフォルトのキーストアファイルがあれば、それが確認されます。署名者の
19.2043 -公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示
19.2044 -されます。
19.2045 -.TP 2
19.2046 -\(bu
19.2047 -署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。
19.2048 -ただし、キーストアではなく JDK 1.1 のアイデンティティデータベースに由来する
19.2049 -署名者の場合は、括弧ではなく角括弧で囲まれます。
19.2050 -.RE
19.2051 -.TP
19.2052 -.B -verbose
19.2053 -コマンド行でこのオプションが指定されている場合、
19.2054 -.B jarsigner
19.2055 -は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出
19.2056 -力します。
19.2057 -.TP
19.2058 -.B -internalsf
19.2059 -以前は、JAR ファイルの署名時に生成された
19.2060 -.B .DSA
19.2061 -(署名ブロック) ファイルの中に、生成された
19.2062 -.B .SF
19.2063 -ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この
19.2064 -動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、
19.2065 -デフォルトでは
19.2066 -.B .SF
19.2067 -ファイルが
19.2068 -.B .DSA
19.2069 -ファイルに含まれないようになっています。ただし、コマンド行で
19.2070 -.B -internalsf
19.2071 -オプションを指定すると、以前と同じように動作します。このオプションは、テストを行う
19.2072 -場合には便利ですが、それ以外には使用しないでください。このオプションを使用する
19.2073 -と、有益な最適化が行われなくなります。
19.2074 -.TP
19.2075 -.B -sectionsonly
19.2076 -コマンド行でこのオプションが指定されている場合、JAR ファイルの署名時に生成される
19.2077 -.B .SF
19.2078 -ファイル (署名ファイル) には、マニフェストファイル全体のハッシュを含むヘッダは追加されません。この場合、.SF ファイルに含まれるのは、JAR ファイル内の各ソースファイルに関する情報およびハッシュだけです。詳細は、「署名 (\f3.SF\f1) ファイル」を参照してください。
19.2079 -.RS
19.2080 -.LP
19.2081 -デフォルトでは、最適化を行うために、マニフェストファイル全体のハッシュを含むヘッダ
19.2082 -が追加されます。ヘッダが存在する場合は、JAR ファイルの検証時に、まずヘッダ内
19.2083 -のハッシュが、マニフェストファイル全体のハッシュと実際に一致するかどうかが確認
19.2084 -されます。ハッシュが一致する場合、検証は次の手順に進みます。ハッシュが一致
19.2085 -しない場合は、効率的には劣る方法を使って検証を行います。具体的には、
19.2086 -.B .SF
19.2087 -ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の
19.2088 -対応するセクションのハッシュと一致するかどうかを確認します。
19.2089 -.LP
19.2090 -詳細は、「JAR ファイルの検証」を参照してください。
19.2091 -.LP
19.2092 -このオプションは、テストを行う場合には便利ですが、それ以外には使用しないで
19.2093 -ください。このオプションを使用すると、有益な最適化が行われなくなります。
19.2094 -.TP
19.2095 -.B -protected
19.2096 -\f2true\fP、\f2false\fP のいずれか。専用 PIN リーダなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
19.2097 -.RE
19.2098 -.TP
19.2099 -.B \-provider provider_class_name
19.2100 -サービスプロバイダがセキュリティプロパティファイル (\f2java.security\fP) のリストに
19.2101 -入っていないときに、暗号化サービスプロバイダのマスタークラスファイルの
19.2102 -名前を指定します。
19.2103 -.LP
19.2104 -\f2\-providerArg\fP \f2ConfigFilePath\fP オプションと組み合わせて使用します。keytool と jarsigner はプロバイダを動的にインストールします (ここで、\f2ConfigFilePath\fP はトークン設定ファイルへのパスです)。セキュリティプロパティファイル内で Sun PKCS#11 プロバイダが設定されていない場合に PKCS#11 キーストアを一覧表示するコマンドの例を次に示します。
19.2105 +\f2\-providerArg\fP \f2ConfigFilePath\fP 激с潟腟水篏睡障 keytool jarsigner ゃゃ潟鴻若障 (с\f2ConfigFilePath\fP 若活┃絎<ゃ吾鴻с)祉ャc若c若<ゃ Sun PKCS#11 ゃ荐絎翫 PKCS#11 若鴻≪筝荀ц;腓冴潟潟箴罨<腓冴障
19.2106 .RS 3
19.2107
19.2108 .LP
19.2109 .nf
19.2110 \f3
19.2111 .fl
19.2112 -jarsigner \-keystore NONE \-storetype PKCS11 \\
19.2113 +jarsigner \-keystore NONE \-storetype PKCS11 \\
19.2114 .fl
19.2115 - \-providerClass sun.security.pkcs11.SunPKCS11 \\
19.2116 + \-providerClass sun.security.pkcs11.SunPKCS11 \\
19.2117 .fl
19.2118 - \-providerArg /foo/bar/token.config \\
19.2119 + \-providerArg /foo/bar/token.config \\
19.2120 .fl
19.2121 \-list
19.2122 .fl
19.2123 @@ -1034,81 +1266,62 @@
19.2124 .fi
19.2125 .RE
19.2126 .TP 3
19.2127 -.B \-providerName providerName
19.2128 -\f2java.security\fP セキュリティプロパティファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前になります。
19.2129 +\-providerName providerName
19.2130 +\f2java.security\fP 祉ャc若c若<ゃ 2 や札筝ゃ荐絎翫\f2\-providerName\fP 激с潟篏帥c劫ゃゃ潟鴻帥潟鴻御с障激с潟綣違ゃс
19.2131 .LP
19.2132 -Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP の形式になります。ここで、\f2TokenName\fP は、プロバイダインスタンスの設定時に使用した名前のサフィックスです。詳細については、
19.2133 +Sun PKCS#11 ゃ翫\f2providerName\fP \f2SunPKCS11\-\fP\f2TokenName\fP 綵√障 с\f2TokenName\fPゃゃ潟鴻帥潟鴻罕・絨乗с 荅括完
19.2134 +.na
19.2135 +\f2罕絮с茵\fP @
19.2136 .fi
19.2137 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner#ATTRS
19.2138 -の
19.2139 -.na
19.2140 -「\f2configuration attributes table\fP」を参照してください。たとえば、次のコマンドは、名前サフィックス \f2SmartCard\fP を持つ PKCS#11 キーストアプロバイダインスタンスの内容を一覧表示します。
19.2141 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSс違篁ヤ潟潟с・絨乗 \f2SmartCard\fP PKCS#11 若鴻≪ゃゃ潟鴻帥潟鴻絎鴻鴻障
19.2142 .RS 3
19.2143
19.2144 .LP
19.2145 .nf
19.2146 \f3
19.2147 .fl
19.2148 -jarsigner \-keystore NONE \-storetype PKCS11 \\
19.2149 +jarsigner \-keystore NONE \-storetype PKCS11 \\
19.2150 .fl
19.2151 - \-providerName SunPKCS11\-SmartCard \\
19.2152 + \-providerName SunPKCS11\-SmartCard \\
19.2153 .fl
19.2154 \-list
19.2155 .fl
19.2156 \fP
19.2157 .fi
19.2158 .RE
19.2159 -.TP
19.2160 -.B \-Jjavaoption
19.2161 -指定した
19.2162 -.I javaoption
19.2163 -文字列を直接実行時システムに渡します。
19.2164 -\f3jarsigner\f1 は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリ使用を調整する場合に便利です。指定できるフラグを一覧表示するには、コマンド行で
19.2165 -.I java -h
19.2166 -または
19.2167 -.I java -X
19.2168 -と入力してください。
19.2169 +.TP 3
19.2170 +\-Jjavaoption
19.2171 +絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋・羝<障(\f3jarsigner\fP 絎 Java ゃ潟帥帥絲障若с激с潟腥榊純с障激с潟絎茵医障<≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц;腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
19.2172 .LP
19.2173 .TP 3
19.2174 \-tsa url
19.2175 -JAR ファイル署名時にコマンド行に\f2「-tsa http://example.tsa.url」\fPと入力した場合、署名のタイムスタンプが生成されます。\f2http://example.tsa.url\fP という URL が、TSA (Time Stamping Authority) の場所を特定します。これは、\f2\-tsacert\fP オプション経由で見つかったどの URL よりも優先されます。\f2\-tsa\fP オプションを使用する場合、TSA の公開鍵証明書がキーストア内に存在している必要はありません。
19.2176 +JAR <ゃ臀峨潟潟茵\f2\-tsa http://example.tsa.url\fP茵腓冴翫臀峨帥ゃ鴻帥潟障URL \f2http://example.tsa.url\fP TSA (Time Stamping Authority) 贋劫障\f2\-tsacert\fP 激с潟ф冴 URL 若若ゃ障\f2\-tsa\fP 激с潟сTSA 笈┝吾若鴻≪臀綽荀障
19.2177 .LP
19.2178 -タイムスタンプを生成するために、\f2jarsigner\fP は、
19.2179 +帥ゃ鴻帥潟\f2jarsigner\fP
19.2180 +.na
19.2181 +\f2RFC 3161\fP @
19.2182 .fi
19.2183 -http://www.ietf.org/rfc/rfc3161.txt
19.2184 -の
19.2185 -.na
19.2186 -「\f2RFC 3161\fP」で規定された TSP (Time\-Stamp Protocol) を使って TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンが、署名とともに署名ブロックファイル内に格納されます。
19.2187 +http://www.ietf.org/rfc/rfc3161.txt у臂 TSP (Time\-Stamp Protocol) 篏睡 TSA 篆<障TSA 菴帥ゃ鴻帥潟若潟臀峨<ゃ臀峨篆絖障
19.2188 .LP
19.2189 .TP 3
19.2190 \-tsacert alias
19.2191 -JAR ファイル署名時にコマンド行に\f2「-tsacert alias」\fPと表示された場合、署名のタイムスタンプが生成されます。\f2alias\fP は、キーストア内で現在有効になっている TSA の公開鍵証明書を特定します。そのエントリの証明書内で、TSA の場所を特定する URL を含む Subject Information Access 拡張が検索されます。
19.2192 +JAR <ゃ臀峨潟潟茵\f2\-tsacert alias\fP茵腓冴翫臀峨帥ゃ鴻帥潟障\f2alias\fP 若鴻√憜鴻 TSA 笈┝吾劫障潟荐惹吾сTSA 贋劫 URL Subject Information Access ≦宍罘純腆肴障
19.2193 .LP
19.2194 -\f2\-tsacert\fP を使用する場合、TSA の公開鍵証明書がキーストア内に存在している必要があります。
19.2195 +TSA 笈┝吾\f2\-tsacert\fP 篏帥c翫若鴻≪臀綽荀障
19.2196 .LP
19.2197 .TP 3
19.2198 \-altsigner class
19.2199 -使用する代替署名機構を指定します。この完全修飾クラス名は、
19.2200 -.I com.sun.jarsigner.ContentSigner
19.2201 -抽象クラスを拡張するクラスファイルを特定します。このクラスファイルへのパスは、
19.2202 -.I \-altsignerpath
19.2203 -オプションを使って定義します。
19.2204 -.I \-altsigner
19.2205 -オプションが指定された場合、
19.2206 -.I jarsigner
19.2207 -はその指定されたクラスが提供する署名機構を使用します。それ以外の場合、
19.2208 -.I jarsigner
19.2209 -はデフォルトの署名機構を使用します。
19.2210 +篁f睡讐罘罕篏睡絎障絎篆蕋障劫\f2com.sun.jarsigner.ContentSigner\fP abstract 鴻≦宍鴻<ゃ劫障鴻<ゃ吾鴻\f2\-altsignerpath\fP 激с潟c絎臂障\f2\-altsigner\fP 激с潟篏睡翫\f2jarsigner\fP 絎鴻箴臀峨罘罕篏睡障障\f2jarsigner\fP 臀峨罘罕篏睡障
19.2211 .LP
19.2212 -たとえば、\f2com.sun.sun.jarsigner.AuthSigner\fP という名前のクラスが提供する署名機構を使用するには、\f2jarsigner\fP オプション\f2「-altsigner com.sun.jarsigner.AuthSigner」\fPを使用します。
19.2213 +違\f2com.sun.sun.jarsigner.AuthSigner\fP 鴻箴臀峨罘罕篏睡\f2jarsigner\fP 激с潟\f2\-altsigner com.sun.jarsigner.AuthSigner\fP篏睡障
19.2214 .LP
19.2215 .TP 3
19.2216 \-altsignerpath classpathlist
19.2217 -クラスファイル (このクラスファイル名は前述の \f2\-altsigner\fP オプションを使って指定) へのパスと、そのクラスが依存するすべての JAR ファイルへのパスを指定します。そのクラスファイルが JAR ファイル内に存在している場合には、次の例で示すように、その JAR ファイルへのパスを指定します。
19.2218 +鴻<ゃ (鴻<ゃ筝荐 \f2\-altsigner\fP 激с潟ф絎) 潟箴絖 JAR <ゃ吾鴻絎障鴻<ゃ JAR <ゃ翫篁ヤ箴 JAR <ゃ吾鴻絎障
19.2219 .LP
19.2220 -絶対パス、現在のディレクトリに対する相対パスのいずれかを指定できます。複数のパスまたは JAR ファイルを \f2classpathlist\fP に含める場合には、Solaris 上ではコロン (\f2:\fP)、Windows 上ではセミコロン (\f2;\fP) をそれぞれ使ってエントリを区切ってください。このクラスがすでに検索パスに含まれている場合、このオプションを指定する必要はありません。
19.2221 +腟九障鴻障憜c後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR <ゃс障 翫鴻障 JAR <ゃSolaris 翫潟 (\f2:\fP)Windows 翫祉潟 (\f2;\fP) у阪障鴻с罎膣≪劫翫激с潟筝荀с
19.2222 .LP
19.2223 -クラスファイルを含む JAR ファイルへのパスを指定する例:
19.2224 +鴻<ゃJAR <ゃ吾鴻絎箴腓冴障
19.2225 .RS 3
19.2226
19.2227 .LP
19.2228 @@ -1117,239 +1330,289 @@
19.2229 .LP
19.2230 .RE
19.2231 .LP
19.2232 -JAR ファイル名が含まれている点に注意してください。
19.2233 +JAR <ゃ障羈
19.2234 .LP
19.2235 -クラスファイルを含む JAR ファイルへのパスを指定する例:
19.2236 +鴻<ゃ JAR <ゃ吾鴻絎箴腓冴障
19.2237 .RS 3
19.2238 .LP
19.2239 \f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
19.2240 .LP
19.2241 .RE
19.2242 .LP
19.2243 -JAR ファイル名が含まれていない点に注意してください。
19.2244 +JAR <ゃ障
19.2245 .RE
19.2246 +.SH "箴"
19.2247 .LP
19.2248 -.SH "例"
19.2249 +
19.2250 .LP
19.2251 .SS
19.2252 -JAR ファイルの署名
19.2253 +JAR <ゃ臀峨
19.2254 .LP
19.2255 -.IX "jarsigner" "Signing a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.2256 +.RS 3
19.2257 +
19.2258 .LP
19.2259 -.B bundle.jar
19.2260 -という名前の JAR ファイルがあり、このファイルに、キーストアの別名が jane であるユーザの非公開鍵を使って、署名を付けるとします。キーストアは、mystore という名前で working ディレクトリにあり、キーストアのパスワードは mypass、
19.2261 -.I jane
19.2262 -の非公開鍵のパスワードは j638klm とします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
19.2263 .LP
19.2264 -.ft 3
19.2265 +bundle.jar JAR <ゃ障 <ゃ若鴻≪ュ jane с若吟若泣篏帥c臀峨篁障若鴻≪mystore сC ゃ working c若鴻≪鴻若 mypass\f2jane\fP 泣鴻若 j638klm 障翫罨<潟潟絎茵JAR <ゃ臀峨篁 sbundle.jar 臀峨篁 JAR <ゃ篏с障
19.2266 +.LP
19.2267 .nf
19.2268 -jarsigner \-keystore "/working/mystore" \-storepass myspass
19.2269 - -keypass j638klm -signedjar sbundle.jar bundle.jar jane
19.2270 +\f3
19.2271 +.fl
19.2272 + jarsigner \-keystore /working/mystore \-storepass myspass
19.2273 +.fl
19.2274 + \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
19.2275 +.fl
19.2276 +\fP
19.2277 .fi
19.2278 -.ft 1
19.2279 +
19.2280 .LP
19.2281 -上のコマンドでは
19.2282 -.I \-sigfile
19.2283 -オプションが指定されていないので、署名付き JAR ファイルに格納される
19.2284 -.B .SF
19.2285 -ファイルと
19.2286 -.B .DSA
19.2287 -ファイルの名前は、別名に基づくデフォルトの名前になり、それぞれ
19.2288 -.I JANE.SF
19.2289 -と
19.2290 -.I JANE.DSA
19.2291 -になります。
19.2292 .LP
19.2293 -ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、
19.2294 -上のコマンドを短縮して次のように入力できます。
19.2295 +筝潟潟с \f2\-sigfile\fP 激с潟絎臀峨篁 JAR <ゃ主 .SF <ゃ .DSA <ゃュゃ障ゃ障\f2JANE.SF\fP \f2JANE.DSA\fP 障
19.2296 .LP
19.2297 -.ft 3
19.2298 +.LP
19.2299 +鴻≪鴻若泣鴻若уュ翫筝潟潟膰罨<ュс障
19.2300 +.LP
19.2301 .nf
19.2302 -jarsigner \-keystore /working/mystore
19.2303 - -signedjar sbundle.jar bundle.jar jane
19.2304 +\f3
19.2305 +.fl
19.2306 + jarsigner \-keystore /working/mystore
19.2307 +.fl
19.2308 + \-signedjar sbundle.jar bundle.jar jane
19.2309 +.fl
19.2310 +\fP
19.2311 .fi
19.2312 -.ft 1
19.2313 +
19.2314 .LP
19.2315 -デフォルトのキーストア (ホームディレクトリ内の
19.2316 -.B .keystore
19.2317 -という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を
19.2318 -省略できます。
19.2319 .LP
19.2320 -.ft 3
19.2321 +若鴻 (若c .keystore 若鴻) 篏睡翫罨<腓冴若鴻≪絎ャс障
19.2322 +.LP
19.2323 .nf
19.2324 -jarsigner \-signedjar sbundle.jar bundle.jar jane
19.2325 +\f3
19.2326 +.fl
19.2327 + jarsigner \-signedjar sbundle.jar bundle.jar jane
19.2328 +.fl
19.2329 +\fP
19.2330 .fi
19.2331 -.ft 1
19.2332 +
19.2333 .LP
19.2334 -また、署名付き JAR ファイルで入力 JAR ファイル (
19.2335 -.I bundle.jar
19.2336 -) を上書きする場合は、
19.2337 -.I -signedjar
19.2338 -オプションの指定も省略できます。
19.2339 .LP
19.2340 -.ft 3
19.2341 +障臀峨篁 JAR <ゃуュ JAR <ゃ (\f2bundle.jar\fP) 筝吾翫\f2\-signedjar\fP 激с潟絎ャс障
19.2342 +.LP
19.2343 .nf
19.2344 -jarsigner bundle.jar jane
19.2345 +\f3
19.2346 +.fl
19.2347 + jarsigner bundle.jar jane
19.2348 +.fl
19.2349 +\fP
19.2350 .fi
19.2351 -.ft 1
19.2352 +.RE
19.2353 +
19.2354 .LP
19.2355 .SS
19.2356 -署名付き JAR ファイルの検証
19.2357 +臀峨篁 JAR <ゃ罎荐
19.2358 .LP
19.2359 -.IX "jarsigner" "Verifying a Signed JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.2360 +.RS 3
19.2361 +
19.2362 .LP
19.2363 -次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが
19.2364 -改変されていないことを確認するためのコマンド例です。
19.2365 .LP
19.2366 -.ft 3
19.2367 +罨<腓冴臀峨篁 JAR <ゃ罎荐若臀峨鴻 JAR <ゃ劫腆肴潟潟箴с
19.2368 +.LP
19.2369 .nf
19.2370 -jarsigner \-verify sbundle.jar
19.2371 +\f3
19.2372 +.fl
19.2373 + jarsigner \-verify sbundle.jar
19.2374 +.fl
19.2375 +\fP
19.2376 .fi
19.2377 -.ft 1
19.2378 +
19.2379 .LP
19.2380 -検証が成功すると、次のようなメッセージが表示されます。
19.2381 .LP
19.2382 -.ft 3
19.2383 +罎荐若罨<<祉若吾茵腓冴障
19.2384 +.LP
19.2385 .nf
19.2386 -jar verified.
19.2387 +\f3
19.2388 +.fl
19.2389 + jar 罎荐若障
19.2390 +.fl
19.2391 +\fP
19.2392 .fi
19.2393 -.ft 1
19.2394 +
19.2395 .LP
19.2396 -検証が成功しなかった場合は、エラーメッセージが表示されます。
19.2397 .LP
19.2398 -.I -verbose
19.2399 -オプションを使うと、より多くの情報が表示されます。次に示すのは、
19.2400 -.I -verbose
19.2401 -オプションを指定した
19.2402 -.B jarsigner
19.2403 -の実行例とその出力結果です。
19.2404 +<祉若吾茵腓冴障罎荐若c翫若<祉若吾茵腓冴障
19.2405 .LP
19.2406 -.ft 3
19.2407 +.LP
19.2408 +\f2\-verbose\fP 激с潟篏帥紊宴茵腓冴障罨<腓冴\f2\-verbose\fP 激с潟絎 \f3jarsigner\fP 絎茵箴阪腟с
19.2409 +.LP
19.2410 .nf
19.2411 -jarsigner -verify -verbose sbundle.jar
19.2412 +\f3
19.2413 +.fl
19.2414 + jarsigner \-verify \-verbose sbundle.jar
19.2415 +.fl
19.2416
19.2417 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
19.2418 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
19.2419 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
19.2420 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
19.2421 - smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
19.2422 +.fl
19.2423 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
19.2424 +.fl
19.2425 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
19.2426 +.fl
19.2427 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
19.2428 +.fl
19.2429 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
19.2430 +.fl
19.2431 + smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
19.2432 +.fl
19.2433
19.2434 - s = signature was verified
19.2435 - m = entry is listed in manifest
19.2436 - k = at least one certificate was found in keystore
19.2437 +.fl
19.2438 + s = 臀峨罎荐若障
19.2439 +.fl
19.2440 + m = 潟с鴻鴻障
19.2441 +.fl
19.2442 + k = 1 や札筝荐惹吾若鴻≪ф冴障
19.2443 +.fl
19.2444
19.2445 - jar verified.
19.2446 +.fl
19.2447 + jar 罎荐若障
19.2448 +.fl
19.2449 +\fP
19.2450 .fi
19.2451 -.ft 1
19.2452 +
19.2453 .LP
19.2454 .SS
19.2455 -証明書情報を使った検証
19.2456 +荐惹御宴篏帥c罎荐
19.2457 .LP
19.2458 -.IX "jarsigner" "Verification with Certificate Information" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.2459 +.LP
19.2460 +罎荐惹\f2\-verify\fP \f2\-verbose\fP 激с潟 \f2\-certs\fP 激с潟絎翫JAR <ゃ臀峨荐惹御宴阪障 荐惹吾帥ゃ臀峨茘ュ (X.509 荐惹吾翫) JAR <ゃ泣荐惹吾若鴻≪潟泣荐惹吾筝眼翫綣су蚊障臀峨若鴻√ュ障障罨<箴腓冴障
19.2461 +.LP
19.2462 +.nf
19.2463 +\f3
19.2464 +.fl
19.2465 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
19.2466 +.fl
19.2467
19.2468 -検証時に、
19.2469 -.I -verify
19.2470 -と
19.2471 -.I -verbose
19.2472 -オプションに加えて
19.2473 -.I -certs
19.2474 -オプションを指定した場合は、JAR ファイル内の各署名者の証明書情報も出力されま
19.2475 -す。これには、証明書のタイプ、署名者の識別名情報 (X.509 証明書の場合)、および、
19.2476 -JAR ファイルの公開鍵の証明書がキーストアエントリの公開鍵の証明書と一致する場合
19.2477 -には、括弧で囲まれた署名者のキーストア別名が含まれます。たとえば、次のように
19.2478 -出力されます。
19.2479 +.fl
19.2480 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
19.2481 +.fl
19.2482 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
19.2483 +.fl
19.2484 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
19.2485 +.fl
19.2486 + 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
19.2487 +.fl
19.2488 + 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
19.2489 +.fl
19.2490 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
19.2491 +.fl
19.2492 +
19.2493 +.fl
19.2494 + X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
19.2495 +.fl
19.2496 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
19.2497 +.fl
19.2498 +
19.2499 +.fl
19.2500 + s = 臀峨罎荐若障
19.2501 +.fl
19.2502 + m = 潟с鴻鴻障
19.2503 +.fl
19.2504 + k = 1 や札筝荐惹吾若鴻≪ф冴障
19.2505 +.fl
19.2506 +
19.2507 +.fl
19.2508 + jar 罎荐若障
19.2509 +.fl
19.2510 +\fP
19.2511 +.fi
19.2512 +
19.2513 .LP
19.2514 -.ft 3
19.2515 +.LP
19.2516 +臀峨荐惹吾 X.509 荐惹吾с翫茘ュ宴茵腓冴障翫荐惹吾帥ゃュ茵腓冴障違荐惹吾 PGP 荐惹吾сュ bob 翫罨<茵腓冴障
19.2517 +.LP
19.2518 .nf
19.2519 - jarsigner -keystore /working/mystore -verify -verbose -certs myTest.jar
19.2520 +\f3
19.2521 +.fl
19.2522 + PGP, (bob)
19.2523 +.fl
19.2524 +\fP
19.2525 +.fi
19.2526
19.2527 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
19.2528 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
19.2529 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
19.2530 - 208 Fri Sep 26 16:23:30 PDT 1997 META-INF/JAVATEST.SF
19.2531 - 1087 Fri Sep 26 16:23:30 PDT 1997 META-INF/JAVATEST.DSA
19.2532 -smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
19.2533 -
19.2534 - X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
19.2535 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
19.2536 -
19.2537 - s = signature was verified
19.2538 - m = entry is listed in manifest
19.2539 - k = at least one certificate was found in keystore
19.2540 -
19.2541 -jar verified.
19.2542 -.fi
19.2543 -.ft 1
19.2544 -.LP
19.2545 -署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されず、証明書の
19.2546 -タイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の
19.2547 -場合は、次のように表示されます。
19.2548 -.LP
19.2549 -.ft 3
19.2550 -.nf
19.2551 -PGP, (bob)
19.2552 -.fi
19.2553 -.ft 1
19.2554 .LP
19.2555 .SS
19.2556 -アイデンティティデータベース署名者を含む JAR ファイルの検証
19.2557 +≪ゃ潟cc若若帥若鴻臀峨 JAR <ゃ罎荐
19.2558 .LP
19.2559 -.IX "jarsigner" "Verification of a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
19.2560 -JAR ファイルが、JDK 1.1 の
19.2561 -.B javakey
19.2562 -ツールを使って署名されている場合、署名者はアイデンティティデータベース内の
19.2563 -別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、
19.2564 -アイデンティティデータベース内の別名とキーストア内の別名の両方によって署名
19.2565 -されている場合は、k と i の両方が表示されます。
19.2566 .LP
19.2567 -.I -certs
19.2568 -オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティ
19.2569 -ティデータベース内の別名は角括弧で囲まれて表示されます。たとえば、次のように
19.2570 -表示されます。
19.2571 +JAR <ゃJDK 1.1 \f3javakey\fP 若篏帥c臀峨翫臀峨≪ゃ潟cc若若帥若劫ュс 翫罎荐若阪 i 荐垩障障JAR <ゃ≪ゃ潟cc若若帥若劫ュ若鴻√ュ筝≧鴻c臀峨翫k i 筝≧鴻茵腓冴障
19.2572 .LP
19.2573 -.ft 3
19.2574 +.LP
19.2575 +\f2\-certs\fP 激с潟絎翫若鴻≪ュ綣су蚊障絲障≪ゃ潟cc若若帥若劫ュ茹綣су蚊障茵腓冴障箴腓冴障
19.2576 +.LP
19.2577 .nf
19.2578 -jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
19.2579 +\f3
19.2580 +.fl
19.2581 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
19.2582 +.fl
19.2583
19.2584 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
19.2585 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
19.2586 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
19.2587 - 199 Fri Sep 27 12:22:30 PDT 1997 META-INF/DUKE.SF
19.2588 - 1013 Fri Sep 27 12:22:30 PDT 1997 META-INF/DUKE.DSA
19.2589 -smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
19.2590 +.fl
19.2591 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
19.2592 +.fl
19.2593 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
19.2594 +.fl
19.2595 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
19.2596 +.fl
19.2597 + 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
19.2598 +.fl
19.2599 + 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
19.2600 +.fl
19.2601 + smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
19.2602 +.fl
19.2603
19.2604 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
19.2605 - X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
19.2606 +.fl
19.2607 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
19.2608 +.fl
19.2609 + X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
19.2610 +.fl
19.2611
19.2612 - s = signature was verified
19.2613 - m = entry is listed in manifest
19.2614 - k = at least one certificate was found in keystore
19.2615 - i = at least one certificate was found in identity scope
19.2616 +.fl
19.2617 + s = 臀峨罎荐若障
19.2618 +.fl
19.2619 + m = 潟с鴻鴻障
19.2620 +.fl
19.2621 + k = 1 や札筝荐惹吾若鴻≪ф冴障
19.2622 +.fl
19.2623 + i = 1 や札筝荐惹吾≪ゃ潟cc若鴻潟若ф冴障
19.2624 +.fl
19.2625
19.2626 -jar verified.
19.2627 +.fl
19.2628 + jar 罎荐若障
19.2629 +.fl
19.2630 +\fP
19.2631 .fi
19.2632 -.ft 1
19.2633 +
19.2634 .LP
19.2635 -別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、
19.2636 -アイデンティティデータベースの別名です。
19.2637 -.SH "関連項目"
19.2638 +.LP
19.2639 +ュ duke 茹綣су蚊障сュ若鴻≪ュс≪ゃ潟cc若若帥若鴻ュс
19.2640 +.LP
19.2641 +.RE
19.2642 +.SH "∫i"
19.2643 .LP
19.2644
19.2645 .LP
19.2646 .RS 3
19.2647 .TP 2
19.2648 o
19.2649 -jar ツールのドキュメント
19.2650 +jar(1) 若ャ<潟
19.2651 .TP 2
19.2652 o
19.2653 -keytool ツールのドキュメント
19.2654 +keytool(1) 若ャ<潟
19.2655 .TP 2
19.2656 o
19.2657 -\f3jarsigner\fP ツールの使用例については、「Java Tutorial」
19.2658 -(http://java.sun.com/docs/books/tutorial/trailmap.html)
19.2659 -の「Security」( http://java.sun.com/docs/books/tutorial/security1.2/index.html)
19.2660 -を参照
19.2661 +\f3jarsigner\fP 若篏睡箴ゃ
19.2662 .na
19.2663 +\f4Java Tutorial\fP @
19.2664 +.fi
19.2665 +http://java.sun.com/docs/books/tutorial/index.html
19.2666 +.na
19.2667 +\f4Security\fP @
19.2668 +.fi
19.2669 +http://java.sun.com/docs/books/tutorial/security/index.html
19.2670 .RE
19.2671
19.2672 .LP
20.1 --- a/src/linux/doc/man/ja/java.1 Tue May 12 15:21:55 2009 +0900
20.2 +++ b/src/linux/doc/man/ja/java.1 Thu May 14 00:17:25 2009 -0700
20.3 @@ -1,645 +1,437 @@
20.4 -'\" t
20.5 -.\"
20.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
20.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
20.8 -.\"
20.9 -.\" This code is free software; you can redistribute it and/or modify it
20.10 -.\" under the terms of the GNU General Public License version 2 only, as
20.11 -.\" published by the Free Software Foundation.
20.12 -.\"
20.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
20.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
20.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
20.17 -.\" accompanied this code).
20.18 -.\"
20.19 -.\" You should have received a copy of the GNU General Public License version
20.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
20.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20.22 -.\"
20.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
20.25 -.\" have any questions.
20.26 -.\"
20.27 -.\"
20.28 -.TH java 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
20.29 -.SH "名前"
20.30 -java \- Java アプリケーション起動プログラム
20.31 -.SH "形式"
20.32 -.B java
20.33 -[
20.34 -.B options
20.35 -]
20.36 -.B class
20.37 -[
20.38 -.B argument ...
20.39 -]
20.40 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
20.41 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
20.42 +."
20.43 +." This code is free software; you can redistribute it and/or modify it
20.44 +." under the terms of the GNU General Public License version 2 only, as
20.45 +." published by the Free Software Foundation.
20.46 +."
20.47 +." This code is distributed in the hope that it will be useful, but WITHOUT
20.48 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
20.49 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
20.50 +." version 2 for more details (a copy is included in the LICENSE file that
20.51 +." accompanied this code).
20.52 +."
20.53 +." You should have received a copy of the GNU General Public License version
20.54 +." 2 along with this work; if not, write to the Free Software Foundation,
20.55 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20.56 +."
20.57 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20.58 +." CA 95054 USA or visit www.sun.com if you need additional information or
20.59 +." have any questions.
20.60 +."
20.61 +.TH java 1 "04 May 2009"
20.62 +." Generated from HTML by html2man (author: Eric Armstrong)
20.63 +
20.64 .LP
20.65 -.B java
20.66 -[
20.67 -.B options
20.68 -]
20.69 -.B \-jar " file.jar"
20.70 -.if n .ti +5n
20.71 -[
20.72 -.B argument ...
20.73 -]
20.74 +.SH ""
20.75 +java \- Java ≪宴若激с活儀若
20.76 .LP
20.77 -.TP 15
20.78 -.B options
20.79 -コマンド行オプション。
20.80 -.TP
20.81 -.B class
20.82 -呼び出されるクラスの名前。
20.83 -.TP
20.84 -.B file.jar
20.85 -呼び出されるファイルの名前。必ず
20.86 -.I \-jar
20.87 -と同時に使用される。
20.88 -.TP
20.89 -.B argument
20.90 -.B main
20.91 -関数に渡される引数。
20.92 -.SH "機能説明"
20.93 -.IX "Java interpreter" "" "Java interpreter \(em \fLjava\fP"
20.94 -.IX "java" "" "\fLjava\fP \(em Java interpreter"
20.95 +.RS 3
20.96 +.TP 2
20.97 +o
20.98 +綵√
20.99 +.TP 2
20.100 +o
20.101 +茯
20.102 +.TP 2
20.103 +o
20.104 +激с
20.105 +.TP 2
20.106 +o
20.107 +∫i
20.108 +.RE
20.109 +
20.110 .LP
20.111 -.B java
20.112 -ツールは、Java アプリケーションを起動します。
20.113 -.B java
20.114 -ツールは、Java Runtime Environment を起動したあと、指定されたクラスをロードし、このクラスの
20.115 -.B main
20.116 -メソッドを呼び出して Java アプリケーションを起動します。
20.117 +.SH "綵√"
20.118 .LP
20.119 -このメソッドは
20.120 -.B public
20.121 -および
20.122 -.B static
20.123 -で宣言され、値を返さず、パラメータとして
20.124 -.I String
20.125 -配列を使用できなければなりません。
20.126 -メソッド宣言は次のようにする必要があります。
20.127 -.LP
20.128 -.ft 3
20.129 -.nf
20.130 - public static void main(String args[])
20.131 -.fi
20.132 -.ft 1
20.133 -.LP
20.134 -デフォルトでは、オプションではない最初の引数が、呼び出すクラスの名前に
20.135 -なります。この名前には、完全指定のクラス名を使用する必要があります。
20.136 -.B \-jar
20.137 -オプションを指定した場合、オプションではない最初の引数は、アプリケーションの
20.138 -クラスファイルとリソースファイルを含む JAR アーカイブの名前になります。
20.139 -この場合、Main-Class マニフェストヘッダで指定されたクラスがスタート
20.140 -アップクラスになります。
20.141 -.LP
20.142 -Java Runtime は、ブートストラップクラスパス、インストール型拡張機能、
20.143 -およびユーザクラスパスの 3 つの場所から、起動クラスとその他の
20.144 -使用するクラスを探します。
20.145 -.LP
20.146 -クラス名または JAR ファイル名のあとにあるオプションではない引数は、
20.147 -main 関数に渡されます。
20.148 -.LP
20.149 -.SH "オプション"
20.150 -起動コマンドには、現在の実行環境および将来のリリースでサポートされる
20.151 -標準オプションがあります。
20.152 -また、仮想マシンの現在の実装では、非標準オプションをサポートしています。
20.153 -この仕様は将来変更される可能性があります。
20.154 -.SS "標準オプション"
20.155 -.IX "java" "Standard Options" "\fLjava\fP \(em Java interpreter"
20.156 -.TP 3
20.157 -.LP
20.158 -.B \-client
20.159 -Java HotSpot Client
20.160 -.SM VM\s0
20.161 -を選択します。
20.162 -64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。
20.163 -デフォルトの VM の選択については、
20.164 -.fi
20.165 -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
20.166 -の
20.167 -.na
20.168 -「\f2Server\-Class Machine Detection\fP」を参照してください。
20.169 -.TP
20.170 -.B \-server
20.171 -Java HotSpot Server
20.172 -VM
20.173 -を選択します。
20.174 -64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。
20.175 -デフォルトの VM の選択については、
20.176 -.fi
20.177 -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
20.178 -の
20.179 -.na
20.180 -「\f2Server\-Class Machine Detection\fP」を参照してください。
20.181 -.TP
20.182 -.B \-agentlib:libname[=options]
20.183 -ネイティブのエージェントライブラリ
20.184 -.I libname
20.185 -を読み込みします。次に例を示します。
20.186 -.LP
20.187 -.RS 5
20.188 -.nf
20.189 -\-agentlib:hprof
20.190 -\-agentlib:jdwp=help
20.191 -\-agentlib:hprof=help
20.192 -.fi
20.193 -.RE
20.194 -.LP
20.195 -詳細は、
20.196 -.fi
20.197 -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting
20.198 -の
20.199 -.na
20.200 -「\f2JVMTI Agent Command Line Options\fP」を参照してください。
20.201 -.TP
20.202 -.B \-agentpath:pathname[=options]
20.203 -ネイティブのエージェントライブラリをフルパス名を使用して読み込みします。
20.204 -詳細は、
20.205 -.fi
20.206 -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting
20.207 -の
20.208 -.na
20.209 -「\f2JVMTI Agent Command Line Options\fP」を参照してください。
20.210 -.TP
20.211 -.B \-classpath " classpath"
20.212 -.TP
20.213 -.B \-cp " classpath"
20.214 -クラスファイルを探すディレクトリ、JAR アーカイブ、および ZIP アーカイブのリストを指定します。クラスパスの各エントリはコロン (:) で区切ります。
20.215 -.B \-classpath
20.216 -または
20.217 -.B \-cp
20.218 -を指定すると、これらのオプションの値によって
20.219 -.SB CLASSPATH
20.220 -環境変数の設定は上書きされます。
20.221 -.LP
20.222 -.B \-classpath
20.223 -と
20.224 -.B \-cp
20.225 -を使用せず、
20.226 -.SB CLASSPATH
20.227 -も設定されていない場合、ユーザクラスパスは現在のディレクトリ (.) になります。
20.228 -.LP
20.229 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
20.230 -.br
20.231 -.br
20.232 -たとえば、ディレクトリ
20.233 -.I foo
20.234 -に
20.235 -.I a.jar
20.236 -と
20.237 -.I b.JAR
20.238 -が含まれている場合、クラスパス要素
20.239 -.I foo/*
20.240 -は
20.241 -.I A.jar:b.JAR
20.242 -に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。
20.243 -* だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。
20.244 -.I CLASSPATH
20.245 -環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、
20.246 -.I System.getenv
20.247 -("
20.248 -.I CLASSPATH
20.249 -")
20.250 -呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
20.251 -.LP
20.252 -クラスパスの詳細については、「クラスパスの設定」を参照してください。
20.253 -.TP
20.254 -.B \-Dproperty=value
20.255 -システムプロパティの値を設定します。
20.256 -.TP
20.257 -.B \-d32
20.258 -.TP
20.259 -.B \-d64
20.260 -それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。
20.261 -.LP
20.262 -現時点では、64 ビット操作をサポートしているのは Java HotSpot Server VM
20.263 -だけであり、
20.264 -.B \-server
20.265 -オプションでは、
20.266 -.B \-d64
20.267 -が暗黙的に使用されます。
20.268 -したがって、\-d64 使用時には「-client」オプションは無視されます。
20.269 -この仕様は将来変更される場合があります。
20.270 -.LP
20.271 -.B \-d32
20.272 -と
20.273 -.B \-d64
20.274 -のどちらも指定しなかった場合、
20.275 -64 ビット専用システムを除いて、
20.276 -デフォルトでは 32 ビット環境で実行されます。
20.277 -この仕様は将来変更される場合があります。
20.278 -.TP 3
20.279 -\-enableassertions[:<package name>"..." | :<class name> ]
20.280 -.TP 3
20.281 -\-ea[:<package name>"..." | :<class name> ]
20.282 -.LP
20.283 -表明を有効にします。デフォルトで、表明は無効です。
20.284 -.sp 1n
20.285 -引数を指定しなくても、
20.286 -.BR enableassertions
20.287 -または
20.288 -.BR \-ea
20.289 -で表明が有効になります。
20.290 -「...」で終わる引数を 1 つ指定すると、
20.291 -スイッチにより、指定したパッケージおよびすべての
20.292 -サブパッケージ内の表明が有効になります。
20.293 -「...」という引数を指定すると、スイッチにより、
20.294 -現在の作業用ディレクトリ内にある名前のないパッケージ内の
20.295 -表明が有効になります。
20.296 -「...」で終わらない引数を 1 つ指定すると、
20.297 -スイッチにより、指定したクラス内の表明が有効になります。
20.298 -.LP
20.299 -1 行のコマンドに、これらのスイッチの複数のインスタンスが
20.300 -含まれている場合、クラスを読み込む前に、正しく処理されます。
20.301 -たとえば、パッケージ
20.302 -.I com.wombat.fruitbat
20.303 - (およびすべてのサブパッケージ) 内だけの有効な表明を
20.304 -含んだプログラムを実行する場合、次のコマンドを使用できます。
20.305 -.TP
20.306 -.BR java -ea:com.wombat.fruitbat... <Main Class>
20.307 -.LP
20.308 -.BR \-enableassertions
20.309 -および
20.310 -.BR \-ea
20.311 -スイッチは、すべての
20.312 -クラスローダおよびシステムクラス (クラスローダを持たない) に適用されます。
20.313 -この規則には 1 つ例外があります。引数がない形式の場合、
20.314 -スイッチはシステムに適用されません。これを利用して、簡単に、
20.315 -システムクラスを除くすべてのクラスの表明を有効にすることができます。
20.316 -すべてのシステムクラスの表明を有効にする個別のスイッチも
20.317 -用意されています。
20.318 -.BR \-enablesystemassertions
20.319 -を参照してください。
20.320 -.TP 3
20.321 -\-disableassertions[:<package name>"..." | :<class name> ]
20.322 -.TP 3
20.323 -\-da[:<package name>"..." | :<class name> ]
20.324 -.LP
20.325 -表明を無効にします。これはデフォルトです。
20.326 -.sp 1n
20.327 -引数を指定せずに、
20.328 -.BR disableassertions
20.329 -または
20.330 -.BR \-da
20.331 -で表明を無効にします。
20.332 -「...」で終わる引数を 1 つ指定すると、
20.333 -スイッチにより、指定したパッケージおよびすべての
20.334 -サブパッケージ内の表明が無効になります。
20.335 -「...」という引数を指定すると、スイッチにより、現在の作業用
20.336 -ディレクトリ内にある名前のないパッケージ内の表明が無効に
20.337 -なります。「...」で終わらない引数を 1 つ指定すると、スイッチにより、
20.338 -指定したクラス内の表明が無効になります。
20.339 -.LP
20.340 -パッケージ
20.341 -.I com.wombat.fruitbat
20.342 -の表明は有効に、クラス
20.343 -.I com.wombat.fruitbat.Brickbat
20.344 -の表明は無効にしてプログラムを実行するには、
20.345 -次のコマンドを使用します。
20.346 -
20.347 -java -ea:com.wombat.fruitbat... -da:com.wombat.fruitbat.Brickbat <Main Class>
20.348 -
20.349 -.BR \-disableassertions
20.350 -および
20.351 -.BR \-da
20.352 -スイッチは、すべての
20.353 -クラスローダおよびシステムクラス (クラスローダを持たない) に適用されます。
20.354 -この規則には 1 つ例外があります。
20.355 -引数を持たない形式の場合、スイッチはシステムに適用されません。
20.356 -これを利用して、簡単に、
20.357 -システムクラスを除くすべてのクラス内の表明を有効にすることができます。
20.358 -すべてのシステムクラス内内の表明を有効にする個別のスイッチも
20.359 -用意されています。
20.360 -.BR \-disablesystemassertions
20.361 -を参照してください。
20.362 -.TP
20.363 -.BR \-enablesystemassertions
20.364 -.TP 3
20.365 -\-esa
20.366 -すべてのシステムクラスの表明を有効にします (システムクラスの
20.367 -デフォルトの表明ステータスを true に設定します)。
20.368 -.TP
20.369 -.BR \-disablesystemassertions
20.370 -.TP 3
20.371 -\-dsa
20.372 -すべてのシステムクラスの表明を無効にします。
20.373 -.TP 3
20.374 -\-jar
20.375 -JAR の中にカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR アーカイブファイルの名前になります。
20.376 -このオプションが動作するためには、JAR ファイルのマニフェストに形式 \f3Main-Class:\f1\f2classname\f1 の行が入っていなければなりません。
20.377 -.I classname
20.378 -は、ユーザのアプリケーションの開始点となる
20.379 -.I public static void main(String[] args)
20.380 -メソッドを持つクラスを識別します。
20.381 -Jar ファイルと Jar ファイルのマニフェストを扱う方法については、Jar ツールのリファレンスページと、
20.382 -.na
20.383 -\f2Java Tutorial\fP
20.384 -.fi
20.385 -(http://java.sun.com/docs/books/tutorial/jar)
20.386 -の Jar トレールを参照してください。
20.387 -.LP
20.388 -このオプションを使用するときは、JAR ファイルがすべてのユーザクラスのソースとなるため、他のユーザクラスパスの設定は無視されます。
20.389 -.LP
20.390 -.B "java \-jar"
20.391 -オプションで実行できる JAR ファイルでは、
20.392 -.B "java \-jar"
20.393 -なしでも実行できるように、実行権限を設定できます。
20.394 -.fi
20.395 -http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html
20.396 -の
20.397 -.na
20.398 -「\f2Java Archive (JAR) Files\f」を参照してください。
20.399 -.TP
20.400 -.B \-javaagent:jarpath[=options]
20.401 -Java プログラミング言語エージェントを読み込みます。
20.402 -http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html
20.403 -の
20.404 -「\f2java.lang.instrument\fP」を参照してください。
20.405 -.LP
20.406 -.B \-verbose
20.407 -.LP
20.408 -.TP 3
20.409 -\-verbose: class
20.410 -クラスが読み込まれるたびにクラスに関する情報を表示します。
20.411 -.PD
20.412 -.LP
20.413 -.TP 3
20.414 -\-verbose:gc
20.415 -ガベージコレクションイベントが発生するたびに報告します。
20.416 -.TP 3
20.417 -.B \-verbose:jni
20.418 -ネイティブメソッドおよびその他の Java Native Interface (JNI) の使用に関する
20.419 -情報を報告します。
20.420 -.TP 3
20.421 -.B \-version
20.422 -バージョン情報を表示して終了します。
20.423 -.TP 3
20.424 -.B \-version:release
20.425 -コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。
20.426 -.LP
20.427 -\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。
20.428 .nf
20.429 \f3
20.430 .fl
20.431 --version:"1.5.0_04 1.5*&1.5.1_02+"
20.432 + \fP\f3java\fP [ options ] class [ argument ... ]
20.433 +.fl
20.434 + \f3java\fP [ options ] \f3\-jar\fP file.jar [ argument ... ]
20.435 +.fl
20.436 +.fi
20.437 +
20.438 +.LP
20.439 +.RS 3
20.440 +
20.441 +.LP
20.442 +.RS 3
20.443 +.TP 3
20.444 +options
20.445 +潟潟茵激с潟
20.446 +.TP 3
20.447 +class
20.448 +若喝冴鴻
20.449 +.TP 3
20.450 +file.jar
20.451 +若喝冴 JAR <ゃ綽 \f2\-jar\fP 篏睡
20.452 +.TP 3
20.453 +argument
20.454 +\f3main\fP ∽違羝<綣
20.455 +.RE
20.456 +
20.457 +.LP
20.458 +.RE
20.459 +.SH " 茯"
20.460 +.LP
20.461 +
20.462 +.LP
20.463 +.LP
20.464 +\f3java\fP 若Java ≪宴若激с潟莎桁障java 若Java Runtime Environment 莎桁絎鴻若鴻 \f3main\fP <純若喝冴Java ≪宴若激с潟莎桁障
20.465 +.LP
20.466 +.LP
20.467 +<純public static 絎h綽荀障 障ゃ菴障 \f2String\fP <若帥絎с違障<純絎h罨<c違障
20.468 +.LP
20.469 +.nf
20.470 +\f3
20.471 +.fl
20.472 + public static void main(String args[])
20.473 .fl
20.474 \fP
20.475 .fi
20.476 -上記の意味は、バージョン 1.5.0_04、または 1.5.1_02 以上で 1.5 をバージョン ID プレフィックスとして持つバージョン、のいずれかをクラスまたは JAR ファイルが必要とする、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol & API Specification (JSR\-56)」の「Appendix A」を参照してください。
20.477 +
20.478 .LP
20.479 -JAR ファイルの場合は通常、バージョン要件をコマンド行に指定するよりも、JAR ファイルのマニフェスト内に指定することが推奨されています。
20.480 .LP
20.481 -このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。
20.482 -.TP
20.483 -.B \-showversion
20.484 -バージョン情報を表示して、実行を継続します。
20.485 -.TP
20.486 -.B \-?
20.487 -.PD 0
20.488 -.TP
20.489 -.B \-help
20.490 -使用法を表示して終了します。
20.491 -.PD
20.492 -.TP
20.493 -.B \-X
20.494 -非標準オプションに関する情報を表示して終了します。
20.495 +с潟潟茵激с割札紊綣違若喝冴鴻障絎絎劫篏睡綽荀障\f3\-jar\fP 激с潟絎翫潟潟茵激с割札紊綣違≪宴若激с潟鴻<ゃ純若鴻<ゃ \f3JAR\fP ≪若ゃ障 翫с鴻 \f3Main\-Class\fP 若ф絎鴻莎桁鴻障
20.496 .LP
20.497 -.SS "非標準オプション"
20.498 .LP
20.499 -.IX "java" "Non-Standard Options" "\fLjava\fP \(em Java interpreter"
20.500 +Java Runtime 若鴻鴻鴻ゃ潟鴻若≦宍罘純潟若吟若鴻鴻 3 膊莎桁鴻篁篏睡鴻罎膣≪障
20.501 +.LP
20.502 +.LP
20.503 +劫障 JAR <ゃ潟潟茵激с割札紊綣違\f3main\fP ∽違羝<障
20.504 +.LP
20.505 +.SH "激с"
20.506 +.LP
20.507 +
20.508 +.LP
20.509 +.LP
20.510 +莎桁若憜絎茵医喝ャ若鴻с泣若罔羣激с潟障障篁潟激潟憜絎茖с罔羣激с潟祉泣若障 絨ャ若鴻у眼醇с障
20.511 +.LP
20.512 +.SH "罔羣激с"
20.513 +.LP
20.514 +
20.515 +.LP
20.516 +.RS 3
20.517 +.TP 3
20.518 +\-client
20.519 +.LP
20.520 +Java HotSpot Client VM 御障64 絲上 JDK 憝鴻с激с潟∴篁c Java Hotspot Server VM 篏睡障
20.521 +.LP
20.522 + VM 御ゃ
20.523 +.na
20.524 +\f2泣若 \- 鴻激潟罎冴\fP @
20.525 +.fi
20.526 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
20.527 +.TP 3
20.528 +\-server
20.529 +.LP
20.530 +Java HotSpot Server VM 御障64 絲上 JDK 筝с泣若 Java Hotspot Server VM с\-server 激с潟藥御障
20.531 +.LP
20.532 + VM 御ゃ
20.533 +.na
20.534 +\f2泣若 \- 鴻激潟罎冴\fP @
20.535 +.fi
20.536 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
20.537 +.TP 3
20.538 +\-agentlib:libname[=options]
20.539 +ゃc若吾с潟ゃ \f2libname\fP 若障 井<絎障
20.540 +.LP
20.541 +\-agentlib:hprof
20.542 +.LP
20.543 +\-agentlib:jdwp=help
20.544 +.LP
20.545 +\-agentlib:hprof=help
20.546 +.LP
20.547 +荅括完ゃ
20.548 +.na
20.549 +\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
20.550 +.fi
20.551 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
20.552 +.TP 3
20.553 +\-agentpath:pathname[=options]
20.554 +劫篏睡若c若吾с潟ゃ若障荅括完ゃ
20.555 +.na
20.556 +\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
20.557 +.fi
20.558 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
20.559 +.TP 3
20.560 +\-classpath classpath
20.561 +.TP 3
20.562 +\-cp classpath
20.563 +鴻<ゃ罎膣≪cJAR ≪若ゃ ZIP ≪若ゃ鴻絎障鴻鴻潟潟 (\f3:\fP) у阪障\f3\-classpath\fP 障 \f3\-cp\fP 絎激с潟ゃc \f3CLASSPATH\fP 医紊違荐絎若若ゃ障
20.564 +.LP
20.565 +\f3\-classpath\fP \f3\-cp\fP 篏睡\f3CLASSPATH\fP 荐絎翫若吟若鴻鴻憜c (\f4.\fP) 障
20.566 +.LP
20.567 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
20.568 +.br
20.569 +.br
20.570 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
20.571 +.LP
20.572 +鴻鴻荅括完
20.573 +.na
20.574 +\f2鴻鴻荐絎\fP @
20.575 +.fi
20.576 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
20.577 +.TP 3
20.578 +\-Dproperty=value
20.579 +激鴻c若ゃ荐絎障
20.580 +.TP 3
20.581 +\-d32
20.582 +.TP 3
20.583 +\-d64
20.584 + 32 医64 医с違絎茵荀羆障荀羆医ゃ潟鴻若泣若翫若怨障
20.585 +.LP
20.586 +憜Java HotSpot Server VM 64 篏泣若\-d64 篏睡 \-server 激с潟藥鴻障c\-d64 篏睡\-client激с潟∴障篁罕絨ャ若鴻с紊眼醇с障
20.587 +.LP
20.588 +\f3\-d32\fP \f3\-d64\fP <絎翫32 医у茵障篁罕絨ャ若鴻с紊眼醇с障
20.589 +.TP 3
20.590 +\-enableassertions[:<package name>"..."| :<class name> ]
20.591 +.TP 3
20.592 +\-ea[:<package name>"..."| :<class name> ]
20.593 +≪泣若激с潟鴻障≪泣若激с潟с≦鴻c障
20.594 +.LP
20.595 +綣違 \f3enableassertions\fP 障 \f3\-ea\fP 絎≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟鴻障綣違\f2...\fP絎憜篏罐c宴若後с≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟鴻障
20.596 +.LP
20.597 +筝潟潟茵鴻ゃゃ潟鴻帥潟鴻茲井絎翫絎鴻ゃ鴻若障c違宴若 \f2com.wombat.fruitbat\fP (泣宴若吾) с帥≪泣若激с潟鴻違絎茵罨<潟潟篏睡障
20.598 +.nf
20.599 +\f3
20.600 +.fl
20.601 +java \-ea:com.wombat.fruitbat... <Main Class>
20.602 +.fl
20.603 +\fP
20.604 +.fi
20.605 +.LP
20.606 +\f3\-enableassertions\fP \f3\-ea\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟鴻ャ鴻ゃ障 \f3\-enablesystemassertions\fP с
20.607 +.TP 3
20.608 +\-disableassertions[:<package name>"..."| :<class name> ]
20.609 +.TP 3
20.610 +\-da[:<package name>"..."| :<class name> ]
20.611 +≪泣若激с潟≦鴻障荐絎с
20.612 +.LP
20.613 +綣違 \f3disableassertions\fP 障 \f3\-da\fP 絎≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟≦鴻障綣違\f2...\fP絎憜篏罐c宴若後с≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟≦鴻障
20.614 +.LP
20.615 +宴若 \f2com.wombat.fruitbat\fP с≪泣若激с潟鴻 \f2com.wombat.fruitbat.Brickbat\fP с≪泣若激с潟≦鴻с違絎茵罨<潟潟篏睡障
20.616 +.nf
20.617 +\f3
20.618 +.fl
20.619 +java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat <Main Class>
20.620 +.fl
20.621 +\fP
20.622 +.fi
20.623 +.LP
20.624 +\f3\-disableassertions\fP \f3\-da\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟≦鴻ャ鴻ゃ障 \f3\-disablesystemassertions\fP с
20.625 +.TP 3
20.626 +\-enablesystemassertions
20.627 +.TP 3
20.628 +\-esa
20.629 +鴻激鴻劫с≪泣若激с潟鴻障 ゃ障激鴻鴻ゃ≪泣若激с潟鴻若帥鴻 \f2true\fP 荐絎障
20.630 +.TP 3
20.631 +\-disablesystemassertions
20.632 +.TP 3
20.633 +\-dsa
20.634 +鴻激鴻劫с≪泣若激с潟≦鴻障
20.635 .LP
20.636 .TP 3
20.637 -.B \-Xint
20.638 -インタプリタ専用モードで動作します。ネイティブコードへのコンパイルは
20.639 -無効になり、すべてのバイトコードがインタプリタによって実行されます。
20.640 -Java HotSpot VM 適応型コンパイラによって得られるパフォーマンス上の
20.641 -利点は、このモードでは実現されません。
20.642 +\-jar
20.643 +JAR <ゃ祉違絎茵障綣違莎桁鴻сJAR <ゃ障激с潟罘純JAR <ゃс鴻\f3Main\-Class:\fP\f4classname\fP\f3\fP綵√茵絎綽荀障\f2classname\fP ≪宴若激с潟紮篏臀罘純 \f2public\ static\ void\ main(String[]\ args)\fP <純鴻絎障JAR <ゃс鴻ゃjar(1)
20.644 +.na
20.645 +\f2Java ャ若≪\fP @
20.646 +.fi
20.647 +http://java.sun.com/docs/books/tutorial/jarTrail: Jar Filesс
20.648 +.LP
20.649 +激с潟篏睡絎 JAR <ゃ鴻若吟若鴻純若鴻若吟若鴻鴻祉荐絎∴障
20.650 +.LP
20.651 +Solaris 8 сjava \-jar激с潟у茵с JAR <ゃ絎茵罔祉篆障 java \-jar篏睡у茵純с
20.652 +.na
20.653 +\f2Java Archive (JAR) <ゃ\fP @
20.654 +.fi
20.655 +http://java.sun.com/javase/6/docs/technotes/guides/jar/index.htmlс
20.656 .TP 3
20.657 -.B \-Xbatch
20.658 -バックグラウンドコンパイルを無効にします。
20.659 -通常、VM ではメソッドをバックグラウンドタスクとしてコンパイルします。
20.660 -このとき、バックグラウンドコンパイルが終了するまでは、
20.661 -インタプリタモードでメソッドが実行されます。
20.662 -.B \-Xbatch
20.663 -フラグを使用すると、バックグラウンドコンパイルが
20.664 -無効になるため、すべてのメソッドのコンパイルは完了するまで
20.665 -フォアグラウンドのタスクとして処理されます。
20.666 +\-javaagent:jarpath[=options]
20.667 +Java 違潟域茯若吾с潟若障
20.668 +.na
20.669 +\f2java.lang.instrument\fP @
20.670 +.fi
20.671 +http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html с
20.672 .TP 3
20.673 -.B \-Xbootclasspath: bootclasspath
20.674 -ブートクラスファイルを探すため、ディレクトリ、JAR アーカイブ、および ZIP
20.675 -アーカイブをコロンで区切ったリストを指定します。指定されたパスに
20.676 -存在するブートクラスファイルは、JDK に含まれる
20.677 -ブートクラスファイルの代わりに使われます。
20.678 -注: rt.jar 内のクラスを上書きする目的でこのオプションを
20.679 -使用するアプリケーションは配備しないでください。
20.680 -配備すると、Java Runtime Environment
20.681 -バイナリコードライセンス違反になることがあります。
20.682 +\-verbose
20.683 .TP 3
20.684 -.B \-Xbootclasspath/a:path
20.685 -デフォルトのブートストラップクラスパスに追加するディレクトリ、
20.686 -.SM JAR
20.687 -アーカイブ、および
20.688 -.SM ZIP
20.689 -アーカイブのパスをコロンで区切って指定します。
20.690 +\-verbose:class
20.691 +鴻若潟鴻≪宴茵腓冴障
20.692 .TP 3
20.693 -.B \-Xbootclasspath/p:path
20.694 -デフォルトのブートストラップクラスパスの前に追加する
20.695 -ディレクトリ、
20.696 -.SM JAR
20.697 -アーカイブ、および
20.698 -.SM ZIP
20.699 -アーカイブのパスをコロンで区切って指定します。
20.700 -注: このオプションを、
20.701 -.B rt.jar
20.702 -内のクラスをオーバーライド
20.703 -する目的で使用するアプリケーションは指定しないでください。
20.704 -指定すると、Java Runtime Environment
20.705 -バイナリコードライセンス違反になることがあります。
20.706 +\-verbose:gc
20.707 +若吾潟激с潟ゃ潟榊潟怨障
20.708 .TP 3
20.709 -.B \-Xcheck:jni
20.710 -Java Native Interface (JNI) 機能に対して
20.711 -追加チェックを実行します。特に、Java 仮想マシン (JVM) は
20.712 -JNI 要求を処理する前に、JNI 機能に渡される
20.713 -パラメータおよび実行環境データを検証します。
20.714 -無効なデータを検出した場合、ネイティブコードに
20.715 -問題があると判断し、Java 仮想マシンは
20.716 -致命的なエラーで終了します。
20.717 -このオプションを使用すると、
20.718 -パフォーマンスが低下します。
20.719 +\-verbose:jni
20.720 +ゃc<純篏睡潟篁 Java Native Interface (JNI) ≪cc若≪宴怨障
20.721 .TP 3
20.722 -.B \-Xfuture
20.723 -厳密なクラスファイル形式の検査を実行します。下位互換性を維持
20.724 -するため、JDK の Virtual Machine で実行されるデフォルトの
20.725 -形式検査は、JDK ソフトウェアの 1.1.x バージョンで実行される検査よりも
20.726 -厳密ではありません。
20.727 -.B \-Xfuture
20.728 -フラグを使用すると、クラスファイル形式を
20.729 -より仕様に準拠したものにするための、さらに厳密なクラスファイル形式検査が
20.730 -有効になります。開発者が新しいコードを開発する際には、このフラグの
20.731 -使用を推奨します。Java アプリケーション起動ツールの
20.732 -将来のリリースでは、より厳密な検査がデフォルトになるからです。
20.733 +\-version
20.734 +若吾с恰宴茵腓冴腟篋障
20.735 .TP 3
20.736 -.B \-Xnoclassgc
20.737 -クラスのガベージコレクションを無効にします。
20.738 -このオプションを使用すると、ロード済みクラスからメモリが回復されることがなくなるため、全体的なメモリ使用量が増大します。この場合、アプリケーションによっては OutOfMemoryError がスローされる可能性があります。
20.739 +\-version:release
20.740 +潟潟茵絎鴻障 JAR <ゃ\f2release\fP ф絎若吾с潟綽荀腓冴障莎桁 java 潟潟若吾с潟絎絎鴻羣ら絎茖激鴻筝цゃc翫絎茖篏睡障
20.741 +.LP
20.742 +\f2release\fP с劫若吾с潟絎сс若吾с恰絖若違若吾с潟鴻絎с障若吾с恰絖ゃ若吾с括蚊腥榊純у阪c綵√綺鋌鴻с若吾с括蚊若吾с ID若吾с ID 緇≪鴻帥鴻 (*) 篁若吾с ID 緇壕 (+) 篁2 ゃ若吾с括蚊≪潟泣潟 (&) х障≪鴻帥鴻c剛眼壕垩絎若吾с割札筝≪潟泣潟 2 ゃ若吾с括蚊茫腥潟障箴腓冴障
20.743 +.nf
20.744 +\f3
20.745 +.fl
20.746 +\-version:"1.5.0_04 1.5*&1.5.1_02+"
20.747 +.fl
20.748 +\fP
20.749 +.fi
20.750 +筝荐潟若吾с 1.5.0_04障 1.5.1_02 篁ヤ 1.5 若吾с ID c鴻ゃ若吾с潟鴻障 JAR <ゃ綽荀с 若吾с恰絖ウ絲罕絎臂ゃJava Network Launching Protocol & API Specification (JSR\-56)Appendix Aс
20.751 +.LP
20.752 +JAR <ゃ翫絽吾若吾с活篁吟潟潟茵絎JAR <ゃс鴻絎ィ絅障
20.753 +.LP
20.754 +激с潟篏睡≪荀激惹宴ゃ緇菴違羈膀с
20.755 .TP 3
20.756 -.BI \-Xincgc
20.757 -インクリメンタルガベージコレクタを有効にします。
20.758 -インクリメンタルガベージコレクタは、デフォルトでは
20.759 -無効に設定されていますが、有効にするとプログラムの実行中の
20.760 -ガベージコレクションによる停止を防ぎます。
20.761 -インクリメンタルガベージコレクタは、場合によってはプログラムと同時に
20.762 -実行されます。同時に実行されている間は、プログラムで利用可能な
20.763 -プロセッサ能力が減少します。
20.764 +\-showversion
20.765 +若吾с恰宴茵腓冴膓茵障
20.766 .TP 3
20.767 -.B \-Xloggc:file
20.768 -.BR \-verbose:gc
20.769 -と同様、各ガベージコレクションイベントで
20.770 -レポートを作成し、このデータを
20.771 -.I file
20.772 -に記録します。
20.773 -.I \-verbose:gc
20.774 -により入手できる情報に加えて、レポートされるイベントには
20.775 -最初のガベージコレクションイベントからの経過時間 (秒数) が付けられます。
20.776 -.sp 1
20.777 -ネットワークの遅延による JVM の停止を避けるために、このファイルの
20.778 -記憶域として常にローカルファイルシステムを使用します。
20.779 -このファイルは、フルファイルシステムおよびロギングが不完全なファイル
20.780 -に追加される場合、切り詰められることがあります。
20.781 -コマンド行で
20.782 -.I \-verbose:gc
20.783 -といっしょに指定された場合、このオプションが優先されます。
20.784 +\-?
20.785 .TP 3
20.786 -.B \-Xmsn
20.787 -メモリ割り当てプールの初期サイズを指定します。
20.788 -指定する値は、1M バイトよりも大きな 1024 の倍数でなければなりません。
20.789 -文字
20.790 -.B k
20.791 -または
20.792 -.B K
20.793 -を付けると K バイト、文字
20.794 -.B m
20.795 -または
20.796 -.B M
20.797 -を付けると M バイトを表します。
20.798 -デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「HotSpot Ergonomics」を参照してください
20.799 +\-help
20.800 +篏睡羈茵腓冴腟篋障
20.801 +.TP 3
20.802 +\-X
20.803 +罔羣激с潟≪宴茵腓冴腟篋障
20.804 +.RE
20.805 +
20.806 +.LP
20.807 +.SS
20.808 +罔羣激с
20.809 +.LP
20.810 +.RS 3
20.811 +
20.812 +.LP
20.813 +.RS 3
20.814 +.TP 3
20.815 +\-Xint
20.816 +ゃ潟帥水≪若у篏障ゃc潟若吾潟潟ゃ≦鴻鴻ゃ潟若ゃ潟帥帥c絎茵障Java HotSpot VM 絲上潟潟ゃ箴若潟剛鴻≪若с絎憗障
20.817 +.TP 3
20.818 +\-Xbatch
20.819 +違潟潟潟ゃ≦鴻障絽吾VM с違潟潟潟ゃ腟篋障с<純違潟帥鴻潟潟ゃゃ潟帥帥≪若с<純絎茵障\f2\-Xbatch\fP 違絎違潟潟潟ゃ≦鴻鴻<純潟潟ゃ絎篋障с≪違潟帥鴻障
20.820 +.TP 3
20.821 +\-Xbootclasspath:bootclasspath
20.822 +若鴻<ゃ「cJAR ≪若ゃ ZIP ≪若ゃ潟潟у阪c鴻ф絎障絎鴻絖若鴻<ゃJava 2 SDK 障若鴻<ゃ篁c篏睡障\f2羈: rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava 2 Runtime Environment ゃ潟若ゃ祉潟拷障\fP
20.823 +.TP 3
20.824 +\-Xbootclasspath/a:path
20.825 +cJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪c絎障 鴻若鴻鴻鴻菴遵障
20.826 +.TP 3
20.827 +\-Xbootclasspath/p:path
20.828 +cJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪c絎障 鴻若鴻鴻鴻菴遵障\f2羈 rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava 2 Runtime Environment ゃ潟若ゃ祉潟拷障\fP
20.829 +.TP 3
20.830 +\-Xcheck:jni
20.831 +Java Native Interface (JNI) 罘純絲障菴遵с茵障隙Java 篁潟激潟 JNI 荀羆JNI ∽違羝<<若帥絎茵医若帥罎荐若障≦鴻若帥荀ゃc翫ゃc潟若馹腓冴Java 篁潟激潟翫順若榊腟篋障激с潟篏睡若潟剛筝篋潟障
20.832 +.TP 3
20.833 +\-Xfuture
20.834 +鴻<ゃ綵√ウ絲с障筝篏篋с篆ゃJava 2 SDK 篁潟激潟絎茵綵√сJDK 純с≪若吾с 1.1.x 絎茵с腮綺ウ絲c障\f3\-Xfuture\fP 違絎鴻<ゃ綵√篁罕吾羣綣桁ウ絲с鴻障Java ≪宴若激с活儀若絨ャ若鴻сウ絲с違潟若冴違篏睡с障
20.835 +.TP 3
20.836 +\-Xnoclassgc
20.837 +鴻若吾潟激с潟≦鴻障激с潟篏睡若羝帥鴻<≪若緇篏<≪寂戎紜紊с障翫≪宴若激с潟c OutOfMemoryError 鴻若醇с障
20.838 +.TP 3
20.839 +\-Xincgc
20.840 +ゃ潟<潟帥若吾潟帥鴻障ゃ潟<潟帥若吾潟帥с≦鴻c障 鴻違絎茵筝若吾潟激с潟筝罩≪榊障ゃ潟<潟帥若吾潟帥違絎茵翫違с祉笈遵篏筝障
20.841 +.TP 3
20.842 +\-Xloggc:file
20.843 +\-verbose:gc 罕若吾潟激с潟ゃ潟榊潟怨障若帥 \f2file\fP 荐蚊障\f2\-verbose:gc\fP 絎怨宴祉怨ゃ潟若吾潟激с潟ゃ潟腟 (腱篏) 篁障
20.844 +.LP
20.845 +若綽膈c JVM 絎茵綺篏筝帥<ゃ主絽吾若<ゃ激鴻<ゃ激鴻羣<ゃ荅違<ゃ若帥綣膓荐蚊障激с潟 \f2\-verbose:gc\fP 筝≧鴻潟潟茵絎翫激с潟障
20.846 +.LP
20.847 +.TP 3
20.848 +\-Xmsn
20.849 +<≪弱蚊綵若泣ゃ冴ゃ違ф絎障絎ゃ1M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 <ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
20.850 .br
20.851 -例:
20.852 +箴:
20.853 +.RS 3
20.854 +
20.855 .LP
20.856 -.RS 5
20.857 .nf
20.858 -\-Xms6291456
20.859 -\-Xms6144k
20.860 -\-Xms6m
20.861 +\f3
20.862 +.fl
20.863 + \-Xms6291456
20.864 +.fl
20.865 + \-Xms6144k
20.866 +.fl
20.867 + \-Xms6m
20.868 +.fl
20.869 +
20.870 +.fl
20.871 +\fP
20.872 .fi
20.873 .RE
20.874 .TP 3
20.875 -.B \-Xmxn
20.876 -メモリ割り当てプールの最大サイズをバイト単位で指定します。
20.877 -指定する値は、2M バイトよりも大きな 1024 の倍数でなければなりません。
20.878 -文字
20.879 -.B k
20.880 -または
20.881 -.B K
20.882 -を付けると K バイト、文字
20.883 -.B m
20.884 -または
20.885 -.B M
20.886 -を付けると M バイトを表します。
20.887 -デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「HotSpot Ergonomics」を参照してください
20.888 +\-Xmxn
20.889 +<≪弱蚊綵若紊с泣ゃ冴ゃ違ф絎障絎ゃ2M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 <ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
20.890 .br
20.891 -例:
20.892 +箴:
20.893 +.RS 3
20.894 +
20.895 .LP
20.896 -.RS 5
20.897 .nf
20.898 -\-Xmx83886080
20.899 -\-Xmx81920k
20.900 -\-Xmx80m
20.901 +\f3
20.902 +.fl
20.903 + \-Xmx83886080
20.904 +.fl
20.905 + \-Xmx81920k
20.906 +.fl
20.907 + \-Xmx80m
20.908 +.fl
20.909 +
20.910 +.fl
20.911 +\fP
20.912 .fi
20.913 .RE
20.914 +Solaris 7 Solaris 8 SPARC 若翫ゃ筝 4000m 若若綣сSolaris 2.6 x86 若翫 2000m 若若綣сLinux 若翫筝 2000m 若若綣с
20.915 +.TP 3
20.916 +\-Xprof
20.917 +絎茵筝違<ゃ<ゃ潟違若帥罔羣阪阪障激с潟違榊若cc若箴障 腮弱激鴻с篏睡с障
20.918 .LP
20.919 -Solaris 7 および Solaris 8 SPARC プラットフォームの場合、この値の上限はおよそ 4000m からオーバーヘッドの量を引いたものであり、Solaris 2.6 および x86 プラットフォームの場合は 2000m からオーバーヘッドの量を引いたものです。
20.920 -Linux プラットフォームの場合の上限は、およそ
20.921 -2000m からオーバーヘッドの量を引いたものです。
20.922 .TP 3
20.923 -.BI \-Xprof
20.924 -実行中のプログラムのプロファイルを生成し、プロファイリングデータを
20.925 -標準出力に送ります。このオプションは、プログラム開発に役立つ
20.926 -ユーティリティとして提供されているもので、本番稼動システムでの使用を
20.927 -目的としたものではありません。
20.928 -.TP 3
20.929 -\-Xrs
20.930 -Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの利用
20.931 -を減らします。
20.932 +\-Xrs
20.933 +Java 篁潟激 (JVM) 若c潟違激鴻激違篏睡羝障
20.934 .LP
20.935 -前回のリリースではシャットダウンフック機能が追加され、
20.936 -Java アプリケーションを順番にシャットダウンできるようになりました。
20.937 -この機能により、JVM が異常終了した場合でも、シャットダウン時に
20.938 -クリーンアップコード (データベース接続を閉じる、など) を
20.939 -実行できるようになりました。
20.940 +篁ュ若鴻сJava ≪宴若激с潟腱綺閫c激c潟激c潟罘純菴遵障罘純JVM 腦句篋翫с激c恰若吟若若潟≪潟若 (若帥若号・膓若冴) 絎茵с障
20.941 .LP
20.942 -Sun の JVM は、シグナルをキャッチして異常な JVM 終了
20.943 -に対するシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、SIGTERM を
20.944 -使用してシャットダウンフックの実行を開始します。
20.945 +Sun JVM 激違ccJVM 医幻腟篋激c潟絎茖障JVM SIGHUPSIGINT SIGTERM 篏睡激c潟絎茵紮障
20.946 .LP
20.947 -JVM では、同様の機構を使用して、1.2 以前のデバッグ用の
20.948 -スレッドスタックダンプ機能を実装しています。Sun の JVM は、
20.949 -SIGQUIT を使用してスレッドダンプを実行します。
20.950 +JVM 違с鴻鴻帥潟1.2 罘純絎憗罕罘罕篏睡障Sun JVM 鴻潟絎茵 SIGQUIT 篏睡障
20.951 .LP
20.952 -JVM を組み込んだアプリケーションは、SIGINT や SIGTERM のような
20.953 -シグナルを頻繁にトラップする必要があります。このような場合、JVM の
20.954 -シグナルハンドラとの間に干渉が発生する可能性があります。
20.955 -このような干渉を避けるために、\-Xrs コマンド行オプションを
20.956 -使用できます。
20.957 -Sun の JVM で \-Xrs が使用されると、SIGINT、SIGTERM、SIGHUP、
20.958 -および SIGQUIT のシグナルマスクは JVM によって変更されず、
20.959 -これらのシグナルのシグナルハンドラはインストールされません。
20.960 +JVM 莨若с≪宴若激с潟 SIGINT SIGTERM 激違紫綽荀JVM 激違潟冴醇с障\f3\-Xrs\fP 潟潟茵激с潟篏睡馹絲上с障Sun JVM 絲障 \f3\-Xrs\fP 篏睡SIGINTSIGTERMSIGHUP SIGQUIT 絲障激違鴻 JVM c紊眼激違絲障激違潟ゃ潟鴻若障
20.961 .LP
20.962 -\-Xrs を指定することによって、影響が 2 つあります。
20.963 +\f3\-Xrs\fP 絎翫罨< 2 ゃ綵演帥障
20.964 .RS 3
20.965 .TP 2
20.966 -*
20.967 -SIGQUIT スレッドダンプは使用できません。
20.968 +o
20.969 +SIGQUIT 鴻潟с
20.970 .TP 2
20.971 -*
20.972 -シャットダウンフックの実行は、ユーザコードが受け持ちます。
20.973 -たとえば JVM が終了するときに System.exit() を呼び出します。
20.974 -.TP
20.975 -.B \-Xssn
20.976 -スレッドスタックサイズを設定します。
20.977 -.TP
20.978 -.BI \-XX:+UseAltSigs
20.979 -VM ではデフォルトで
20.980 -.I SIGUSR1
20.981 -および
20.982 -.I SIGUSR2
20.983 -を使用しますが、
20.984 -.I SIGUSR1
20.985 -および
20.986 -.I SIGUSR2
20.987 -をシグナル連鎖するアプリケーションと
20.988 -競合する場合があります。
20.989 -.I \-XX:+UseAltSigs
20.990 -オプションは、VM にデフォルトとして
20.991 -.I SIGUSR1
20.992 -と
20.993 -.I SIGUSR2
20.994 -以外のシグナルを使用させます。
20.995 +o
20.996 +激c潟絎茵JVM 腟篋鴻 System.exit() 若喝冴若吟若潟若眼ц綽荀
20.997 +.RE
20.998 +.TP 3
20.999 +\-Xssn
20.1000 +鴻鴻帥泣ゃ冴荐絎障
20.1001 +.TP 3
20.1002 +\-XX:+UseAltSigs
20.1003 +VM с \f2SIGUSR1\fP \f2SIGUSR2\fP 篏睡障\f2SIGUSR1\fP \f2SIGUSR2\fP 激違i≪宴若激с潟 腴九翫障\f2\-XX:+UseAltSigs\fP 激с潟VM \f2SIGUSR1\fP \f2SIGUSR2\fP 篁ュ激違篏睡障
20.1004 +.RE
20.1005 +
20.1006 .LP
20.1007 -.SH "注"
20.1008 +.RE
20.1009 +.SH "羈"
20.1010 .LP
20.1011
20.1012 .LP
20.1013 -\f3\-version:\fP\f2release\fP コマンド行オプションでは、どんなに複雑にリリースを指定してもかまいません。ただし、現実的なリリース指定の限られたサブセットを使用するだけでも適切なポリシーを表現できるため、それらのサブセットのみが完全にサポートされます。それらのポリシーを次に示します。
20.1014 +\f3\-version:\fP\f2release\fP 潟潟茵激с潟с茲若鴻絎障障憜若号絎泣祉篏睡с激若茵憗с泣祉帥絎泣若障激若罨<腓冴障
20.1015 .RS 3
20.1016 .TP 3
20.1017 1.
20.1018 -任意のバージョン。これは、このオプションを使用しないことで表現できます。
20.1019 +篁紙若吾с潟 激с潟篏睡ц;憗с障
20.1020 .TP 3
20.1021 2.
20.1022 -ある特定のバージョン ID よりも大きい任意のバージョン。次に例を示します。
20.1023 +劫若吾с ID 紊с篁紙若吾с潟 罨<箴腓冴障
20.1024 .nf
20.1025 \f3
20.1026 .fl
20.1027 @@ -648,15 +440,20 @@
20.1028 \fP
20.1029 .fi
20.1030 .LP
20.1031 -この場合、1.5.0_03 よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。
20.1032 +翫1.5.0_03 紊с篁紙若吾с潟篏睡障 絎若吾с潟х劫ゃ潟帥с若鴻絨ャ (違篆罩c) 翫箴水с
20.1033 .TP 3
20.1034 3.
20.1035 -ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。
20.1036 -.TP
20.1037 +劫若吾с ID 紊с若吾с潟 若鴻<筝c狗箴腓冴障
20.1038 +.nf
20.1039 +\f3
20.1040 +.fl
20.1041 "1.5.0_03+&1.5*"
20.1042 +.fl
20.1043 +\fP
20.1044 +.fi
20.1045 .TP 3
20.1046 4.
20.1047 -上の項目 2 または 3 の「OR」表現。次に例を示します。
20.1048 +筝 2 障 3 OR茵憗箴腓冴障
20.1049 .nf
20.1050 \f3
20.1051 .fl
20.1052 @@ -664,48 +461,45 @@
20.1053 .fl
20.1054 \fP
20.1055 .fi
20.1056 -これは項目 2 に似ていますが、ある変更が特定のリリース (1.5) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。
20.1057 + 2 篌若障紊眼劫若 (1.5) уャ紊眼篁ュ若鴻≪若с純c翫箴水с
20.1058 .RE
20.1059
20.1060 .LP
20.1061 -.SH "関連項目"
20.1062 +.SH "∫i"
20.1063 .LP
20.1064
20.1065 .LP
20.1066 .RS 3
20.1067 .TP 2
20.1068 -*
20.1069 -javac \- Java プログラム言語コンパイラ
20.1070 +o
20.1071 +javac(1)
20.1072 .TP 2
20.1073 -*
20.1074 -jdb \- Java アプリケーションデバッガ
20.1075 +o
20.1076 +jdb(1)
20.1077 .TP 2
20.1078 -*
20.1079 -javah \- C ヘッダとスタブファイルジェネレータ
20.1080 +o
20.1081 +javah(1)
20.1082 .TP 2
20.1083 -*
20.1084 -jar \- JAR アーカイブツール
20.1085 +o
20.1086 +jar(1)
20.1087 .TP 2
20.1088 -*
20.1089 +o
20.1090 +.na
20.1091 +\f2Java ≦宍罘純若若\fP @
20.1092 .fi
20.1093 -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
20.1094 -の
20.1095 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
20.1096 +.TP 2
20.1097 +o
20.1098 .na
20.1099 -「\f2The Java Extensions Framework\fP」
20.1100 +\f2祉ャc若\fP @
20.1101 +.fi
20.1102 +http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
20.1103 .TP 2
20.1104 -*
20.1105 +o
20.1106 +.na
20.1107 +\f2HotSpot VM Specific Options\fP @
20.1108 .fi
20.1109 -http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
20.1110 -の
20.1111 -.na
20.1112 -「\f2Security Features\fP」
20.1113 -.TP 2
20.1114 -*
20.1115 -.fi
20.1116 -http://java.sun.com/docs/hotspot/VMOptions.html
20.1117 -の
20.1118 -.na
20.1119 -「\f2HotSpot VM Specific Options\fP」
20.1120 +http://java.sun.com/docs/hotspot/VMOptions.html
20.1121 .RE
20.1122
20.1123 .LP
21.1 --- a/src/linux/doc/man/ja/javac.1 Tue May 12 15:21:55 2009 +0900
21.2 +++ b/src/linux/doc/man/ja/javac.1 Thu May 14 00:17:25 2009 -0700
21.3 @@ -1,6 +1,4 @@
21.4 -.'" t
21.5 -."
21.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
21.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
21.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
21.9 ."
21.10 ." This code is free software; you can redistribute it and/or modify it
21.11 @@ -21,15 +19,45 @@
21.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
21.13 ." have any questions.
21.14 ."
21.15 -." `
21.16 -.TH javac 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
21.17 -." Generated by html2man
21.18 +.TH javac 1 "04 May 2009"
21.19 +." Generated from HTML by html2man (author: Eric Armstrong)
21.20
21.21 .LP
21.22 -.SH 名前
21.23 -javac \- Java プログラミング言語コンパイラ
21.24 +.SH ""
21.25 +javac \- Java 違潟域茯潟潟ゃ
21.26 .LP
21.27 -.SH "形式"
21.28 +.RS 3
21.29 +.TP 2
21.30 +o
21.31 +綵√
21.32 +.TP 2
21.33 +o
21.34 +茯
21.35 +.TP 2
21.36 +o
21.37 +激с
21.38 +.TP 2
21.39 +o
21.40 +潟潟茵綣違<ゃ
21.41 +.TP 2
21.42 +o
21.43 +羈
21.44 +.TP 2
21.45 +o
21.46 +罎膣
21.47 +.TP 2
21.48 +o
21.49 +違cゃ潟帥с若
21.50 +.TP 2
21.51 +o
21.52 +箴
21.53 +.TP 2
21.54 +o
21.55 +∫i
21.56 +.RE
21.57 +
21.58 +.LP
21.59 +.SH "綵√"
21.60 .LP
21.61
21.62 .LP
21.63 @@ -44,7 +72,7 @@
21.64
21.65 .LP
21.66 .LP
21.67 -引数は順不同です。
21.68 +綣違筝с
21.69 .LP
21.70 .RS 3
21.71
21.72 @@ -52,61 +80,61 @@
21.73 .RS 3
21.74 .TP 3
21.75 options
21.76 -コマンド行オプション
21.77 +潟潟茵激с潟
21.78 .TP 3
21.79 sourcefiles
21.80 -コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
21.81 +潟潟ゃ 1 や札筝純若鴻<ゃ (MyClass.java )
21.82 .TP 3
21.83 classes
21.84 -注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)。
21.85 +羈絲乗院 1 や札筝 (MyPackage.MyClass )
21.86 .TP 3
21.87 @argfiles
21.88 -オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では、\f2\-J\fP オプションは指定できません。
21.89 +激с潟純若鴻<ゃ 1 や札筝<ゃ<ゃ筝с\f2\-J\fP 激с潟絎с障
21.90 .RE
21.91
21.92 .LP
21.93 .RE
21.94 -.SH "機能説明"
21.95 +.SH "茯"
21.96 .LP
21.97
21.98 .LP
21.99 .LP
21.100 -\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
21.101 +\f3javac\fP 若Java 違潟域茯ц菴違鴻ゃ潟帥с若鴻絎臂茯水ゃ潟若鴻<ゃ潟潟ゃ障障Java 純若鴻<ゃ潟劫羈茵障
21.102 .LP
21.103 .LP
21.104 -ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
21.105 +純若鴻潟若<ゃ \f3javac\fP 羝<罨< 2 ゃ号障
21.106 .LP
21.107 .RS 3
21.108 .TP 2
21.109 o
21.110 -ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
21.111 +純若鴻<ゃ違絨翫<ゃ潟潟茵х贋・絎障
21.112 .TP 2
21.113 o
21.114 -ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
21.115 +純若鴻<ゃ違紊翫<ゃ腥榊純障壕у阪c1 ゃ<ゃ障罨<鴻<ゃ \f3@\fP 篁\f3javac\fP 潟潟茵ф絎障
21.116 .RE
21.117
21.118 .LP
21.119 .LP
21.120 -ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、\f2MyClass\fP という名前のクラスは、\f2MyClass.class\fP という名前のソースファイルに記述します。このソースファイルは、MyClass.class という名前のバイトコードクラスファイルにコンパイルされます。
21.121 +純若鴻潟若<ゃ \f2.java\fP ≦宍絖鴻<ゃ \f2.class\fP ≦宍絖c違障 障純若鴻<ゃ鴻<ゃ<荅峨鴻絲上若c違障違\f2MyClass\fP 鴻\f2MyClass.java\fP 純若鴻<ゃ荐菴違障 純若鴻<ゃ\f2MyClass.class\fP ゃ潟若鴻<ゃ潟潟ゃ障
21.122 .LP
21.123 .LP
21.124 -内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、\f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
21.125 +鴻絎臂菴遵鴻<ゃ障鴻<ゃ\f2MyClass$MyInnerClass.class\fP 紊劫劫腟水障
21.126 .LP
21.127 .LP
21.128 -ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、\f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
21.129 +純若鴻<ゃ宴若吾若c若臀綽荀障違鴻純若鴻<ゃ \f3/workspace\fP 臀翫\f2com.mysoft.mypack.MyClass\fP 純若鴻潟若 \f3/workspace/com/mysoft/mypack/MyClass.java\fP 綽荀障
21.130 .LP
21.131 .LP
21.132 -デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとの「オプション」を参照)。
21.133 +с潟潟ゃ鴻<ゃ絲上純若鴻<ゃc臀障ャ阪c絎\f3\-d\fP 篏睡障 (激с潟)
21.134 .LP
21.135 -.SH "オプション"
21.136 +.SH "激с"
21.137 .LP
21.138
21.139 .LP
21.140 .LP
21.141 -コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
21.142 +潟潟ゃ憜榊医с泣若絨ャ若鴻с泣若罔羣激с潟祉障篁ュ罔羣激с潟憜篁潟激潟潟潟潟ゃ絎茖堺激с潟с絨ャ紊眼醇с障罔羣激с潟\f3\-X\fP у障障
21.143 .LP
21.144 .SS
21.145 -標準オプション
21.146 +罔羣激с
21.147 .LP
21.148 .RS 3
21.149
21.150 @@ -114,162 +142,162 @@
21.151 .RS 3
21.152 .TP 3
21.153 \-Akey[=value]
21.154 -注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
21.155 +羈祉泣羝<激с潟javac c贋・茹i祉泣c篏睡障 \f2key\fP 1 ゃ障茲違茘ュ.у阪c絎
21.156 .TP 3
21.157 -\-cp path または \-classpath path
21.158 -ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、
21.159 +\-cp path 障 \-classpath path
21.160 +若吟若鴻<ゃ (翫c) 羈祉泣純若鴻<ゃ罎膣√贋絎障鴻鴻 \f3CLASSPATH\fP 医紊違若吟若鴻鴻若若ゃ障\f3CLASSPATH\fP\f3\-cp\fP\f3\-classpath\fP 絎翫若吟若鴻鴻憜c障荅括完
21.161 .na
21.162 -「\f2Setting the Class Path\fP」
21.163 +\f2鴻鴻荐絎\fP @
21.164 .fi
21.165 -(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
21.166 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
21.167 .LP
21.168 -\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
21.169 +\f3\-sourcepath\fP 激с潟絎翫純若鴻<ゃ若吟若鴻鴻罎膣≪障
21.170 .LP
21.171 -\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもクラスパス内で検索されます。
21.172 +\f3\-processorpath\fP 激с潟絎翫羈祉泣若吟若鴻鴻罎膣≪障
21.173 .LP
21.174 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じであるとみなされます。
21.175 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障
21.176 .br
21.177 .br
21.178 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。\f3注:\fP \ コマンド行環境の構成によっては、\f2javac \-cp "*.jar" MyClass.java\fP などのように、ワイルドカード文字を引用符で囲まなければならない場合があります。
21.179 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障\f3羈:\fP潟潟茵医罕c\f2javac \-cp "*.jar" MyClass.java\fP ゃ若絖綣膃у蚊障違翫障
21.180 .TP 3
21.181 \-Djava.ext.dirs=directories
21.182 -インストール型拡張機能の位置をオーバーライドします。
21.183 +ゃ潟鴻若≦宍罘純篏臀若若ゃ障
21.184 .TP 3
21.185 \-Djava.endorsed.dirs=directories
21.186 -承認された標準パスの位置をオーバーライドします。
21.187 +粋罔羣鴻篏臀若若ゃ障
21.188 .TP 3
21.189 \-d directory
21.190 -クラスファイルの出力先ディレクトリを設定します。このディレクトリはあらかじめ用意されている必要があります。\f3javac\fP はディレクトリの作成を行いません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
21.191 +鴻<ゃ阪c荐絎障cс絖綽荀障 \f3javac\fP c篏障鴻宴若吾筝с翫\f3javac\fP 綽荀綽c篏宴若後泣c鴻<ゃ臀障違\f3\-d /home/myclasses\fP 絎鴻 \f2com.mypackage.MyClass\fP с翫鴻<ゃ \f2/home/myclasses/com/mypackage/MyClass.class\fP 障
21.192 .LP
21.193 -\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
21.194 +\f3\-d\fP 絎c翫\f3javac\fP 鴻<ゃ純若鴻<ゃc主障
21.195 .LP
21.196 -\f3注:\fP \ \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
21.197 +\f3羈:\fP\f3\-d\fP ф絎c若吟若鴻鴻菴遵障
21.198 .TP 3
21.199 \-deprecation
21.200 -推奨されないメンバやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
21.201 +ィ絅<潟若鴻篏睡障若若ゃ潟茯茵腓冴障\f3\-deprecation\fP 絎翫\f3javac\fP ィ絅<潟若鴻篏睡障若若ゃ純若鴻<ゃ荀膣茵腓冴障\f3\-deprecation\fP \f3\-Xlint:deprecation\fP ヨ;荐с
21.202 .TP 3
21.203 \-encoding encoding
21.204 -ソースファイルのエンコーディング名 (\f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
21.205 +純若鴻<ゃ潟潟若c潟医 (\f2EUC\-JP\fP \f2UTF\-8\fP ) 絎障\f3\-encoding\fP 絎翫若潟潟若帥篏帥障
21.206 .TP 3
21.207 \-g
21.208 -局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
21.209 +絮紊違鴻井宴障с茵垩潟純若鴻<ゃ宴障
21.210 .TP 3
21.211 \-g:none
21.212 -デバッグ情報を生成しません。
21.213 +井宴障
21.214 .TP 3
21.215 \-g:{keyword list}
21.216 -コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
21.217 +潟潟у阪若若鴻絎劫腮蕁井宴障罨<若若鴻с
21.218 .RS 3
21.219 .TP 3
21.220 source
21.221 -ソースファイルのデバッグ情報
21.222 +純若鴻<ゃ井
21.223 .TP 3
21.224 lines
21.225 -行番号のデバッグ情報
21.226 +茵垩井
21.227 .TP 3
21.228 vars
21.229 -局所変数のデバッグ情報
21.230 +絮紊違井
21.231 .RE
21.232 .TP 3
21.233 \-help
21.234 -標準オプションの形式を表示します。
21.235 +罔羣激с潟綵√茵腓冴障
21.236 .TP 3
21.237 \-implicit:{class,none}
21.238 -暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。
21.239 +藥若純若鴻<ゃ絲障鴻<ゃ九勝障鴻<ゃ\f3\-implicit:class\fP 篏睡障鴻<ゃ吟\f3\-implicit:none\fP 篏睡障 激с潟絎c翫篏鴻<ゃ障翫鴻<ゃ羈絎茵潟潟ゃ茘肴障 激с潟腓榊荐絎翫茘肴障 罎膣≪с
21.240 .TP 3
21.241 \-nowarn
21.242 -警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
21.243 +茘<祉若吾≦鴻障 \f3\-Xlint:none\fP 潟с
21.244 .TP 3
21.245 \-proc: {none,only}
21.246 -注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
21.247 +羈潟潟ゃ筝≧鴻絎茵九勝障\f3\-proc:none\fP 羈с潟潟ゃ絎茵潟障\f3\-proc:only\fP 羈絎茵緇膓潟潟ゃ障c鎘茵潟障
21.248 .TP 3
21.249 \-processor class1[,class2,class3...]
21.250 -実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
21.251 +絎茵羈祉泣絎翫罎膣√ャ障
21.252 .TP 3
21.253 \-processorpath path
21.254 -注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
21.255 +羈祉泣罎膣√贋絎障 激с潟篏睡c翫鴻劫с祉泣罎膣≪茵障
21.256 .TP 3
21.257 \-s dir
21.258 -生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
21.259 +純若鴻<ゃ主c絎障cс絖綽荀障 \f3javac\fP 篏障鴻宴若吾筝c翫潟潟ゃ純若鴻<ゃ宴若後泣c主障 綽荀綽c篏障違若吟若 \f3\-s /home/mysrc\fP 絎鴻 \f2com.mypackage.MyClass\fP сc翫純若鴻<ゃ \f2/home/mysrc/com/mypackage/MyClass.java\fP 主障
21.260 .TP 3
21.261 \-source release
21.262 -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
21.263 +篁純若鴻潟若若吾с潟絎障\f2release\fP 罨<ゃ絎с障
21.264 .RS 3
21.265 .TP 3
21.266 1.3
21.267 -このコンパイラでは、JDK 1.3 以降に導入されたアサーション、汎用機能、または他の言語機能をサポート\f2しません\fP。
21.268 +潟潟ゃсJDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
21.269 .TP 3
21.270 1.4
21.271 -JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
21.272 +JDK 1.4 уャ≪泣若激с潟潟若篁障
21.273 .TP 3
21.274 1.5
21.275 -JDK 5 で導入された汎用機能および他の言語機能を含んだコードを受け付けます。
21.276 +JDK 5 уャ膩霡違割荐茯罘純潟若篁障
21.277 .TP 3
21.278 5
21.279 -1.5 と同義です。
21.280 +1.5 臂с
21.281 .TP 3
21.282 1.6
21.283 -これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
21.284 +ゃсJava SE 6 с荐茯絲障紊眼絨ャ障с純若鴻<ゃ潟潟若c潟違若篁ュ茘с若怨障
21.285 .TP 3
21.286 6
21.287 -1.6 と同義です。
21.288 +1.6 臂с
21.289 .RE
21.290 .TP 3
21.291 \-sourcepath sourcepath
21.292 -クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。 ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
21.293 +鴻障ゃ潟帥с若鴻絎臂罎膣≪純若鴻潟若鴻絎障若吟若鴻鴻罕純若鴻鴻茲違潟潟 (\f3:\fP) у阪障 純若鴻鴻潟cJAR ≪若ゃ障 ZIP ≪若ゃ絎с障宴若吾篏帥c翫c障≪若ゃ若劫宴若後違障
21.294 .LP
21.295 -\f3注:\fP \ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
21.296 +\f3羈:\fP\ 鴻鴻鴻с純若鴻荀ゃc翫鴻潟潟ゃ絲乗院障罎膣≪с
21.297 .TP 3
21.298 \-verbose
21.299 -詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
21.300 +荅括完阪茵腓冴障若鴻潟潟潟ゃ純若鴻<ゃ宴阪障
21.301 .TP 3
21.302 \-X
21.303 -非標準オプションに関する情報を表示して終了します。
21.304 +罔羣激с潟≪宴茵腓冴腟篋障
21.305 .RE
21.306
21.307 .LP
21.308 .RE
21.309 .SS
21.310 -クロスコンパイルオプション
21.311 +鴻潟潟ゃ激с
21.312 .LP
21.313 .RS 3
21.314
21.315 .LP
21.316 .LP
21.317 -デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「\f2クロスコンパイル\fP」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。
21.318 +с鴻潟潟ゃ\f3javac\fP 羞私若若鴻鴻恰≦宍罘純鴻絲障茵障\f3javac\fP 違 Java 若絎茖若鴻鴻恰≦宍罘純鴻絲障潟潟ゃ茵鴻潟潟ゃ泣若障鴻潟潟ゃ茵翫\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥荀с 鴻潟潟ゃ箴с
21.319 .LP
21.320 .RS 3
21.321 .TP 3
21.322 \-target version
21.323 -指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、および \f31.6\fP (\f36\fP も可) です。
21.324 +絎若吾с潟 VM 帥若蚊鴻<ゃ障鴻<ゃ絎帥若蚊篁ラ若吾с潟с篏障若吾с潟 VM с篏障鴻帥若蚊\f31.1\fP\f31.2\fP\f31.3\fP\f31.4\fP\f31.5\fP (\f35\fP ) \f31.6\fP (\f36\fP ) с
21.325 .LP
21.326 -\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
21.327 +\f3\-target\fP 罨< \f3\-source\fP ゃc羆冴障障
21.328 .RS 3
21.329 .TP 2
21.330 o
21.331 -\-source が\f3指定されなかった\fP場合、\-target の値は \f31.6\fP になります。
21.332 +\-source \f3絎c\fP翫\-target ゃ \f31.6\fP 障
21.333 .TP 2
21.334 o
21.335 -\-source が \f31.2\fP の場合、\-target の値は \f31.4\fP になります。
21.336 +\-source \f31.2\fP 翫\-target ゃ \f31.4\fP 障
21.337 .TP 2
21.338 o
21.339 -\-source が \f31.3\fP の場合、\-target の値は \f31.4\fP になります。
21.340 +\-source \f31.3\fP 翫\-target ゃ \f31.4\fP 障
21.341 .TP 2
21.342 o
21.343 -\-source が\f3それ以外の値の場合はすべて\fP、\-target の値は \f3\-source\fP の値になります。
21.344 +\-source \f3篁ュゃ翫鴻\fP\\\-target ゃ \f3\-source\fP ゃ障
21.345 .RE
21.346 .TP 3
21.347 \-bootclasspath bootclasspath
21.348 -指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
21.349 +絎筝c若鴻絲障鴻潟潟ゃ茵障若吟若鴻鴻罕若鴻鴻茲違潟潟 (\f3:\fP) у阪障 若鴻鴻潟cJAR ≪若ゃ障 ZIP ≪若ゃ絎с障
21.350 .TP 3
21.351 \-extdirs directories
21.352 -指定された拡張機能ディレクトリに対してクロスコンパイルを行います。\f2directories\fP には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。
21.353 +絎≦宍罘純c絲障鴻潟潟ゃ茵障\f2directories\fP 潟潟у阪cc鴻絎障絎c JAR ≪若ゃ鴻<ゃ罎膣≪障
21.354 .RE
21.355
21.356 .LP
21.357 .RE
21.358 .SS
21.359 -非標準オプション
21.360 +罔羣激с
21.361 .LP
21.362 .RS 3
21.363
21.364 @@ -277,37 +305,37 @@
21.365 .RS 3
21.366 .TP 3
21.367 \-Xbootclasspath/p:path
21.368 -ブートストラップクラスパスの前に追加します。
21.369 +若鴻鴻鴻菴遵障
21.370 .TP 3
21.371 \-Xbootclasspath/a:path
21.372 -ブートストラップクラスパスの後ろに追加します。
21.373 +若鴻鴻鴻緇菴遵障
21.374 .TP 3
21.375 \-Xbootclasspath/:path
21.376 -ブートストラップクラスファイルの位置をオーバーライドします。
21.377 +若鴻鴻<ゃ篏臀若若ゃ障
21.378 .TP 3
21.379 \-Xlint
21.380 -推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告が推奨されています。
21.381 +ィ絅鴻茘鴻障若鴻с純鴻茘ィ絅障
21.382 .TP 3
21.383 \-Xlint:none
21.384 -Java 言語仕様では指定されていないすべての警告を無効にします。
21.385 +Java 荐茯篁罕с絎鴻茘≦鴻障
21.386 .TP 3
21.387 \-Xlint:\-name
21.388 -警告 \f2name\fP を無効にします。ただし、\f2name\fP は、\f3\-Xlint:\fP\f2name\fP に使用できる警告名のいずれかになります。この警告名は次のとおりです。
21.389 +茘 \f2name\fP ≦鴻障 \f2name\fP \f3\-Xlint:\fP\f2name\fP 篏睡с茘障 茘罨<с
21.390 .TP 3
21.391 \-Xlint:unchecked
21.392 -Java 言語仕様で指定されている未検査変換警告の詳細を示します。
21.393 +Java 荐茯篁罕ф絎罎糸茘荅括完腓冴障
21.394 .TP 3
21.395 \-Xlint:path
21.396 -存在しないパス (classpath、sourcepath など) ディレクトリについて警告します。
21.397 +絖 (classpathsourcepath ) cゃ茘障
21.398 .TP 3
21.399 \-Xlint:serial
21.400 -\f2serialVersionUID\fP 定義が直列化可能クラスにないことを警告します。
21.401 +\f2serialVersionUID\fP 絎臂翫純鴻茘障
21.402 .TP 3
21.403 \-Xlint:finally
21.404 -正常に完了できない \f2finally\fP 節について警告します。
21.405 +罩e幻絎篋с \f2finally\fP 膀ゃ茘障
21.406 .TP 3
21.407 \-Xlint:fallthrough
21.408 -fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
21.409 +fall\-through 宴若鴻 \f2switch\fP с罎冴絲障茘<祉若吾茵腓冴障Fall\-through 宴若鴻\f2switch\fP 緇宴若鴻ゃ宴若鴻с 潟若 \f2break\fP 障障 潟若絎茵宴若鴻罨<宴若鴻悟Щ障違 \f2switch\fP \f2case 1\fP 膓潟若\f2break\fP хc障
21.410 .RS 3
21.411
21.412 .LP
21.413 @@ -333,34 +361,34 @@
21.414 \fP
21.415 .fi
21.416 .RE
21.417 -このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
21.418 +潟若潟潟ゃ \f2\-Xlint:fallthrough\fP 違篏睡翫潟潟ゃ 綵荅蚊宴若鴻茵垩fall\-through 宴若鴻醇с腓冴茘肴障
21.419 .TP 3
21.420 -\-Xmaxerrors number
21.421 -印刷するエラーの最大数を設定します。
21.422 +\-Xmaxerrs number
21.423 +医激若紊ф違荐絎障
21.424 .TP 3
21.425 \-Xmaxwarns number
21.426 -印刷する警告の最大数を設定します。
21.427 +医激茘紊ф違荐絎障
21.428 .TP 3
21.429 \-Xstdout filename
21.430 -コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
21.431 +潟潟ゃ<祉若吾絎<ゃ障с潟潟ゃ<祉若吾 \f2System.err\fP 障
21.432 .TP 3
21.433 \-Xprefer:{newer,source}
21.434 -ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。\f2SOURCE\fP の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにしたい場合は、\f2\-Xprefer:source\fP を使用してください。
21.435 +絲障純若鴻<ゃ鴻<ゃ筝≧鴻荀ゃc翫<<ゃ茯水鴻絎障 (罎膣≪)\f2\-Xprefer:newer\fP 篏睡翫絲障純若鴻<ゃ鴻<ゃ違鴻茯水障 ()\f2\-Xprefer:source\fP激с潟篏睡翫純若鴻<ゃ茯水障\f2SOURCE\fP 篆絖激若篏帥c絎h羈篁紙羈祉泣≪祉鴻с翫\f2\-Xprefer:source\fP篏睡
21.436 .TP 3
21.437 \-Xprint
21.438 -指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
21.439 +絎鴻茵憗亥у阪障 羈潟潟ゃ<絎茵障阪綵√紊眼醇с障
21.440 .TP 3
21.441 \-XprintProcessorInfo
21.442 -ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
21.443 +劫祉泣箴若羈≪宴阪障
21.444 .TP 3
21.445 \-XprintRounds
21.446 -初回および後続の注釈処理ラウンドに関する情報を出力します。
21.447 +喝膓羈潟≪宴阪障
21.448 .RE
21.449
21.450 .LP
21.451 .RE
21.452 .SS
21.453 -\-J オプション
21.454 +\-J 激с
21.455 .LP
21.456 .RS 3
21.457
21.458 @@ -368,34 +396,34 @@
21.459 .RS 3
21.460 .TP 3
21.461 \-Joption
21.462 -\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリは 48M バイトに設定されます。このオプションは \f3\-X\fP で始まっていませんが、\f3javac\fP の「標準オプション」ではありません。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
21.463 +\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟 \f3\-X\fP у障c障\f3javac\fP 罔羣激с潟с障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
21.464 .LP
21.465 -\f3注:\fP \ \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものでは\f2ありません\fP。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
21.466 +\f3羈:\fP \ \f3CLASSPATH\fP\f3\-classpath\fP\f3\-bootclasspath\fP \f3\-extdirs\fP \f3javac\fP 絎茵篏帥鴻絎с障号с潟潟ゃ絎茖篏絽吾≧潟с絽吾演冴篌眼障号篏帥綽荀翫\f3\-J\fP 激с潟篏帥c綽荀激с潟緇 \f3java\fP 莎桁若羝<
21.467 .RE
21.468
21.469 .LP
21.470 .RE
21.471 -.SH "コマンド行引数ファイル"
21.472 +.SH "潟潟茵綣違<ゃ"
21.473 .LP
21.474
21.475 .LP
21.476 .LP
21.477 -javac のコマンド行を短くしたり簡潔にしたりするために、\f2javac\fP コマンドに対する引数 (\f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
21.478 +\f2javac\fP 潟潟茵膂≧\f2javac\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝<ゃ絎с障号篏帥若c潟違激鴻筝с篁紙激 javac 潟潟篏с障
21.479 .LP
21.480 .LP
21.481 -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
21.482 +綣違<ゃjavac 激с潟純若鴻<ゃ宴腟水荐菴違с障<ゃ綣違鴻若鴻障壕у阪障<ゃ腥榊純障翫<ゃ篏篋綣膃у蚊帥障
21.483 .LP
21.484 .LP
21.485 -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、\f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
21.486 +綣違<ゃ<ゃ憜c荀後障鴻障綣違<ゃ篏臀荀後障鴻с障綣違<ゃ<ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
21.487 .LP
21.488 .LP
21.489 -javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
21.490 +javac 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障javac \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
21.491 .LP
21.492 .SS
21.493 -例 \- 引数ファイルを 1 つ指定
21.494 +綣違<ゃ 1 ゆ絎箴
21.495 .LP
21.496 .LP
21.497 -\f2argfile\fP という名前の引数ファイルにすべての javac 引数を格納する場合は、次のように指定します。
21.498 +\f2argfile\fP 綣違<ゃ鴻 javac 綣違主翫罨<絎障
21.499 .LP
21.500 .nf
21.501 \f3
21.502 @@ -408,16 +436,16 @@
21.503
21.504 .LP
21.505 .LP
21.506 -この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
21.507 +綣違<ゃ罨<箴хず 2 ゃ<ゃ絎鴻筝≧鴻ャс障
21.508 .LP
21.509 .SS
21.510 -例 \- 引数ファイルを 2 つ指定
21.511 +綣違<ゃ 2 ゆ絎箴
21.512 .LP
21.513 .LP
21.514 -たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
21.515 +違javac 激с括 1 <ゃ純若鴻<ゃ 1 <ゃ2 ゃ綣違<ゃ篏с障鴻с茵膓膓絖篏睡障
21.516 .LP
21.517 .LP
21.518 -以下の内容を含む \f2options\fP という名前のファイルを作成します。
21.519 +篁ヤ絎鴻 \f2options\fP <ゃ篏障
21.520 .LP
21.521 .nf
21.522 \f3
21.523 @@ -435,7 +463,7 @@
21.524
21.525 .LP
21.526 .LP
21.527 -以下の内容を含む \f2classes\fP という名前のファイルを作成します。
21.528 +篁ヤ絎鴻 \f2classes\fP <ゃ篏障
21.529 .LP
21.530 .nf
21.531 \f3
21.532 @@ -453,7 +481,7 @@
21.533
21.534 .LP
21.535 .LP
21.536 -次のコマンドを使用して \f3javac\fP を実行します。
21.537 +罨<潟潟篏睡 \f3javac\fP 絎茵障
21.538 .LP
21.539 .nf
21.540 \f3
21.541 @@ -466,10 +494,10 @@
21.542
21.543 .LP
21.544 .SS
21.545 -例 \- パス付きの引数ファイル
21.546 +剛綣違<ゃ箴
21.547 .LP
21.548 .LP
21.549 -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fP や \f2path2\fP から見た相対パスではありません。
21.550 +綣違<ゃ鴻絎с障 <ゃ絎<ゃ憜篏罐c荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
21.551 .LP
21.552 .nf
21.553 \f3
21.554 @@ -481,81 +509,85 @@
21.555 .fi
21.556
21.557 .LP
21.558 -.SH "注釈処理"
21.559 +.SH "羈"
21.560 .LP
21.561
21.562 .LP
21.563 .LP
21.564 -\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
21.565 +\f3javac\fP 羈贋・泣若腴羈若с \f3apt\fP 篏睡綽荀障
21.566 .LP
21.567 .LP
21.568 -注釈処理の API は、\f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
21.569 +羈 API \f2javax.annotation.processing\fP \f2javax.lang.model\fP 宴若吾泣宴若後絎臂障
21.570 .LP
21.571 .SS
21.572 -注釈処理の概要
21.573 +羈网荀
21.574 .LP
21.575 .LP
21.576 -\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META_INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
21.577 +\f3\-proc:none\fP 激с潟c羈≦劫潟潟ゃ篏睡純鴻羈祉泣罎膣≪障罎膣≪鴻 \f3\-processorpath\fP 激с潟篏帥c絎с障 罎膣≪鴻絎c翫若吟若鴻鴻篏睡障祉泣罎膣≪罎膣≪剛
21.578 +.br
21.579 +\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
21.580 +.br
21.581 +泣若鴻ゃ罕<ゃ冴ャ茵障<ゃ篏睡鴻羈祉泣1 茵 1 ゃゅ障ャ号\f3\-processor\fP 激с潟篏帥c祉泣腓榊絎с障
21.582 .LP
21.583 .LP
21.584 -コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。 その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
21.585 +潟潟ゃ潟潟茵純若鴻<ゃ鴻莎井祉с羈絖腆肴腟祉泣絲障茵祉泣羈с腆肴障筝眼荀ゃc翫祉泣若喝冴障祉泣荳羈荀羆с障 翫羈絲障ャ祉泣荀ゃ荅帥茵障鴻羈荀羆障潟潟ゃ篁ヤ祉泣罎膣≪茵障
21.586 .LP
21.587 .LP
21.588 -いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
21.589 +祉泣c違純若鴻<ゃ羈 2 潟紮障違鴻純若鴻<ゃ莎井祉罕羈障篁ュ潟у若喝冴祉泣鴻緇膓潟с若喝冴障違純若鴻<ゃ障х障
21.590 .LP
21.591 .LP
21.592 -あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
21.593 +潟ф違純若鴻<ゃc翫羈祉泣 1 若喝冴綽荀絎茵罘篌筝障 緇\f3\-proc:only\fP 激с潟篏睡潟潟ゃ純若鴻<ゃ鴻純若鴻<ゃ潟潟ゃ障
21.594 .LP
21.595 .SS
21.596 -暗黙的にロードされたソースファイル
21.597 +藥若純若鴻<ゃ
21.598 .LP
21.599 .LP
21.600 -コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードしなければならない場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
21.601 +潟潟ゃ筝c純若鴻<ゃ潟潟ゃャ純若鴻<ゃ藥若違翫障 (罎膣≪)<ゃ憝鴻с羈絲乗院障с羈絎茵ゆ藥若純若鴻<ゃ 1 ゃс潟潟ゃ翫潟潟ゃ茘肴障茘吟号ゃ\-implicit 激с潟с
21.602 .LP
21.603 -.SH "型の検索"
21.604 +.SH "罎膣"
21.605 .LP
21.606
21.607 .LP
21.608 .LP
21.609 -ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
21.610 +純若鴻<ゃ潟潟ゃ翫潟潟茵ф絎純若鴻<ゃ絎臂荀ゃ潟潟ゃ絽吾≪宴綽荀障潟潟ゃ純若鴻<ゃт戎鴻障ゃ潟帥с若鴻≦宍鴻障ゃ潟帥с若鴻絎茖鴻障ゃ潟帥с若鴻鴻ゃ宴綽荀障純若鴻<ゃф腓榊荐膓帥宴箴鴻ゃ潟帥с若鴻障障
21.611 .LP
21.612 .LP
21.613 -たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、アプレットの祖先のクラス (\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP) を使用していることになります。
21.614 +違\f3java.applet.Applet\fP 泣鴻翫\f3≪\fP腑刻\f3java.awt.Panel\fP\f3java.awt.Container\fP\f3java.awt.Component\fP\f3java.lang.Object\fP鐚篏睡障
21.615 .LP
21.616 .LP
21.617 -コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、
21.618 +潟潟ゃ宴綽荀絎臂純若鴻<ゃ障鴻<ゃ「障障若鴻鴻≦宍罘純鴻罎膣≪膓若吟若鴻 (с潟c) 罎膣≪障若吟若鴻鴻\f3CLASSPATH\fP 医紊違荐絎絎臂障 \f3\-classpath\fP 潟潟茵激с潟篏帥c荐絎障荅括完
21.619 .na
21.620 -「\f2Setting the Class Path\fP」
21.621 +\f2鴻鴻荐絎\fP @
21.622 .fi
21.623 -(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
21.624 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
21.625 .LP
21.626 .LP
21.627 -\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
21.628 +\-sourcepath 激с潟絎翫潟潟ゃ絎鴻純若鴻<ゃ罎膣≪障 篁ュ翫若吟若鴻鴻鴻<ゃ純若鴻<ゃ筝≧鴻罎膣≪障
21.629 .LP
21.630 .LP
21.631 -\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。このあとの「クロスコンパイルオプション」を参照してください。
21.632 +\f3\-bootclasspath\fP 激с潟 \f3\-extdirs\fP 激с潟篏帥ャ若鴻鴻≦宍罘純鴻絎с障 鴻潟潟ゃ激с潟с
21.633 .LP
21.634 .LP
21.635 -型の検索に成功した場合の結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
21.636 +罎膣≪緇腟鴻<ゃ純若鴻<ゃ障筝≧鴻с翫障筝≧鴻荀ゃc翫<篏睡鴻 \-Xprefer 激с潟с潟潟ゃ腓冴с障\f3newer\fP 絎翫潟潟ゃ 2 ゃ<ゃ違鴻篏睡障\f3source\fP 絎翫潟潟ゃ純若鴻<ゃ篏睡障 \f3newer\fP с
21.637 .LP
21.638 .LP
21.639 -型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
21.640 +罎膣∵篏c障 \f3\-Xprefer\fP 荐絎腟綽荀純若鴻<ゃ荀ゃc翫潟潟ゃ純若鴻<ゃ茯水綽荀宴緇障潟潟ゃс純若鴻<ゃ潟潟ゃ茵障\-implicit 激с潟篏帥違篏絎с障\f3none\fP 絎翫純若鴻<ゃ鴻<ゃ障\f3class\fP 絎翫純若鴻<ゃ鴻<ゃ障
21.641 .LP
21.642 .LP
21.643 -コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識する場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
21.644 +潟潟ゃ羈絎篋緇宴綽荀с茯茘翫障宴純若鴻<ゃ荀ゃ \f3\-implicit\fP 激с潟絎翫<ゃ羈絲乗院潟潟ゃ潟潟ゃ若吟若茘障茘≦鴻(<ゃ羈絲乗院) <ゃ潟潟茵絎純若鴻<ゃ絲障鴻<ゃ鴻 \f3\-implicit\fP 激с潟篏帥c絎障
21.645 .LP
21.646 -.SH "プログラマティックインタフェース"
21.647 +.SH "違cゃ潟帥с若"
21.648 .LP
21.649
21.650 .LP
21.651 .LP
21.652 -\f3javac\fP は、\f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
21.653 +\f3javac\fP \f2javax.tools\fP 宴若後鴻ゃ潟帥с若鴻c絎臂違 Java Compiler API 泣若障
21.654 .LP
21.655 .SS
21.656 -例
21.657 +箴
21.658 .LP
21.659 .LP
21.660 -コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
21.661 +潟潟茵絎綣違篏帥c潟潟ゃ絎茵罨<潟若篏睡障
21.662 .LP
21.663 .nf
21.664 \f3
21.665 @@ -571,22 +603,22 @@
21.666
21.667 .LP
21.668 .LP
21.669 -この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
21.670 +翫罔羣阪鴻若鴻荐堺<祉若吾吾冴潟潟茵若喝冴 \f3javac\fP 菴腟篋潟若菴障
21.671 .LP
21.672 .LP
21.673 -\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
21.674 +\f2javax.tools.JavaCompiler\fP ゃ潟帥с若剛祉<純篏帥違荐堺<祉若吾<ゃ茯水/吾莨若水九勝茵障
21.675 .LP
21.676 .SS
21.677 -旧式のインタフェース
21.678 +уゃ潟帥с若
21.679 .LP
21.680 .RS 3
21.681
21.682 .LP
21.683 .LP
21.684 -\f3注:\fP \ この API は、下位互換性を確保するためだけに残されています。新しいコードでは、必ず前述の Java Compiler API を使用してください。
21.685 +\f3羈:\fP \ API 筝篏篋с腆坂罧障 違潟若с綽菴違 Java Compiler API 篏睡
21.686 .LP
21.687 .LP
21.688 -\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。それらを次に示します。
21.689 +\f2com.sun.tools.javac.Main\fP 鴻違潟潟ゃ若喝冴 static <純 2 ょ障 罨<腓冴障
21.690 .LP
21.691 .nf
21.692 \f3
21.693 @@ -602,28 +634,28 @@
21.694
21.695 .LP
21.696 .LP
21.697 -\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。その概要については、前出の「形式」節を参照してください。
21.698 +\f2args\fP <若帥javac 違絽御検篁紙潟潟茵綣違茵障 网荀ゃ冴綵√膀с
21.699 .LP
21.700 .LP
21.701 -\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
21.702 +\f2out\fP <若帥潟潟ゃ荐堺<祉若吾阪腓冴障
21.703 .LP
21.704 .LP
21.705 -戻り値は、\f3javac\fP の終了値と同じです。
21.706 +祉ゃ\f3javac\fP 腟篋ゃс
21.707 .LP
21.708 .LP
21.709 -名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれる\f3その他の\fPクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
21.710 + \f2com.sun.tools.javac\fP у障宴若 (綣 \f2com.sun.tools.javac\fP 泣宴若吾ャ) 障\f3篁\fP鴻<純絎сゃс紊眼醇с障
21.711 .LP
21.712 .RE
21.713 -.SH "例"
21.714 +.SH "箴"
21.715 .LP
21.716 .SS
21.717 -簡単なプログラムのコンパイル
21.718 +膂≦違潟潟ゃ
21.719 .LP
21.720 .RS 3
21.721
21.722 .LP
21.723 .LP
21.724 -\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。\f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
21.725 +\f2Hello.java\fP 純若鴻<ゃс\f3greetings.Hello\fP 鴻絎臂障\f2greetings\fP c純若鴻<ゃ鴻<ゃ筝≧鴻宴若吾cс憜c筝障箴с若吟若鴻鴻篏睡с障障\f3\-d\fP 篏帥cャ阪c絎綽荀障
21.726 .LP
21.727 .RS 3
21.728
21.729 @@ -681,13 +713,13 @@
21.730 .LP
21.731 .RE
21.732 .SS
21.733 -複数のソースファイルのコンパイル
21.734 +茲違純若鴻<ゃ潟潟ゃ
21.735 .LP
21.736 .RS 3
21.737
21.738 .LP
21.739 .LP
21.740 -次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
21.741 +罨<箴с宴若 \f2greetings\fP 鴻純若鴻<ゃ潟潟ゃ障
21.742 .LP
21.743 .RS 3
21.744
21.745 @@ -721,13 +753,13 @@
21.746 .LP
21.747 .RE
21.748 .SS
21.749 -ユーザークラスパスの指定
21.750 +若吟若鴻鴻絎
21.751 .LP
21.752 .RS 3
21.753
21.754 .LP
21.755 .LP
21.756 -上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
21.757 +筝箴純若鴻<ゃ 1 ゃ紊眼紊翫<ゃ潟潟ゃ障
21.758 .LP
21.759 .RS 3
21.760
21.761 @@ -748,7 +780,7 @@
21.762
21.763 .LP
21.764 .LP
21.765 -\f2greetings.Hi\fP は、\f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
21.766 +\f2greetings.Hi\fP \f2greetings\fP 宴若後祉鴻с潟潟ゃ鴻「綽荀障筝箴с若吟若鴻鴻宴若吾ccс潟潟ゃ罩e幻絎茵障憜c≫<ゃ潟潟ゃ翫若吟若鴻鴻 \f2/examples\fP 菴遵綽荀障若吟若鴻鴻潟菴遵\f3CLASSPATH\fP 荐絎号障с \f3\-classpath\fP 激с潟篏帥障
21.767 .LP
21.768 .RS 3
21.769
21.770 @@ -765,7 +797,7 @@
21.771
21.772 .LP
21.773 .LP
21.774 -再度 \f2greetings.Hi\fp を変更してバナーユーティリティを使うようにした場合は、このバナーユーティリティもユーザークラスパスを通じてアクセスできるようになっている必要があります。
21.775 +綺 \f2greetings.Hi\fP 紊眼若若cc若篏帥翫若若cc若若吟若鴻鴻≪祉鴻сc綽荀障
21.776 .LP
21.777 .RS 3
21.778
21.779 @@ -784,7 +816,7 @@
21.780
21.781 .LP
21.782 .LP
21.783 -\f2greetings\fP 内のクラスを実行するには、\f2greetings\fP と、\f2greetings\fP が使うクラスの両方にアクセスできる必要があります。
21.784 +\f2greetings\fP 鴻絎茵\f2greetings\fP \f2greetings\fP 篏帥鴻筝≧鴻≪祉鴻с綽荀障
21.785 .LP
21.786 .RS 3
21.787
21.788 @@ -802,13 +834,13 @@
21.789 .LP
21.790 .RE
21.791 .SS
21.792 -ソースファイルとクラスファイルの分離
21.793 +純若鴻<ゃ鴻<ゃ
21.794 .LP
21.795 .RS 3
21.796
21.797 .LP
21.798 .LP
21.799 -特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
21.800 +鴻紊ц閞<吾с翫純若鴻<ゃ鴻<ゃャc臀箴水障鴻<ゃ阪ャ絎\f3\-d\fP 篏帥障純若鴻<ゃ若吟若鴻鴻с\f3\-sourcepath\fP 篏帥c潟潟ゃ純若鴻<ゃ荀ゃс障
21.801 .LP
21.802 .RS 3
21.803
21.804 @@ -855,17 +887,17 @@
21.805
21.806 .LP
21.807 .LP
21.808 -\f3注:\fP \ コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
21.809 +\f3羈:\fP \ 潟潟茵с \f2src/farewells/Base.java\fP 絎障<ゃ潟潟ゃc潟潟ゃ障潟潟ゃh\f3\-verbose\fP 激с潟篏帥障
21.810 .LP
21.811 .RE
21.812 .SS
21.813 -クロスコンパイルの例
21.814 +鴻潟潟ゃ箴
21.815 .LP
21.816 .RS 3
21.817
21.818 .LP
21.819 .LP
21.820 -ここでは、javac を使って、1.5 VM 上で実行するコードをコンパイルします。
21.821 +с\f3javac\fP 篏帥c1.5 VM 筝у茵潟若潟潟ゃ障
21.822 .LP
21.823 .RS 3
21.824
21.825 @@ -884,13 +916,13 @@
21.826
21.827 .LP
21.828 .LP
21.829 -\f3\-target 1.5\fP オプションにより、1.5 VM と互換性のあるクラスファイルが生成されます。デフォルトでは、\f3javac\fP は JDK 6 用にコンパイルします。
21.830 +\f3\-target 1.5\fP 激с潟1.5 VM 篋с鴻<ゃ障с\f3javac\fP JDK 6 潟潟ゃ障
21.831 .LP
21.832 .LP
21.833 -Java プラットフォーム JDK の \f3javac\fP は、デフォルトではそれ自身のブートストラップクラスに対してコンパイルを行うので、代わりに JDK 1.5 のブートストラップクラスに対してコンパイルを行うように \f3javac\fP を設定する必要があります。これは、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使って指定します。この指定を行わないと、1.5 VM には存在しない Java プラットフォーム API に対応したコンパイルが行われるため、プログラムの実行時に失敗するでしょう。
21.834 +Java 若 JDK \f3javac\fP сJava 2 SDK 若鴻鴻絲障潟潟ゃ茵сJava 2 SDK с JDK 1.5 若鴻鴻絲障潟潟ゃ茵絎綽荀障\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥c絎障絎茵1.5 VM 絖 Java 2 若 API 絲上潟潟ゃ茵違絎茵絎潟榊障
21.835 .LP
21.836 .RE
21.837 -.SH "関連項目"
21.838 +.SH "∫i"
21.839 .LP
21.840
21.841 .LP
21.842 @@ -898,33 +930,33 @@
21.843 .TP 2
21.844 o
21.845 .na
21.846 -「\f2The javac Guide\fP」
21.847 +\f2The javac Guide\fP @
21.848 .fi
21.849 -(http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html)
21.850 +http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
21.851 .TP 2
21.852 o
21.853 -java(1) \- Java アプリケーション起動プログラム
21.854 +java(1) \- Java ≪宴若激с活儀若
21.855 .TP 2
21.856 o
21.857 -jdb(1) \- Java デバッガ
21.858 +jdb(1) \- Java
21.859 .TP 2
21.860 o
21.861 -javah(1) \- C 言語のヘッダとスタブファイルのジェネレータ
21.862 +javah(1) \- C 若鴻帥<ゃ吾с若帥
21.863 .TP 2
21.864 o
21.865 -javap(1) \- Java クラスファイル逆アセンブラ
21.866 +javap(1) \- 鴻<ゃ≪祉潟
21.867 .TP 2
21.868 o
21.869 -javadoc(1) \- Java API ドキュメントジェネレータ
21.870 +javadoc(1) \- Java API ャ<潟吾с若帥
21.871 .TP 2
21.872 o
21.873 -jar(1) \- JAR アーカイブツール
21.874 +jar(1) \- JAR ≪若ゃ若
21.875 .TP 2
21.876 o
21.877 .na
21.878 -「\f2The Java Extensions Framework\fP」
21.879 +\f2Java ≦宍罘純若若\fP @
21.880 .fi
21.881 -(http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html)
21.882 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
21.883 .RE
21.884
21.885 .LP
22.1 --- a/src/linux/doc/man/ja/javadoc.1 Tue May 12 15:21:55 2009 +0900
22.2 +++ b/src/linux/doc/man/ja/javadoc.1 Thu May 14 00:17:25 2009 -0700
22.3 @@ -1,932 +1,844 @@
22.4 -'\" t
22.5 -.\"
22.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
22.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
22.8 -.\"
22.9 -.\" This code is free software; you can redistribute it and/or modify it
22.10 -.\" under the terms of the GNU General Public License version 2 only, as
22.11 -.\" published by the Free Software Foundation.
22.12 -.\"
22.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
22.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
22.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
22.17 -.\" accompanied this code).
22.18 -.\"
22.19 -.\" You should have received a copy of the GNU General Public License version
22.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
22.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
22.22 -.\"
22.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
22.25 -.\" have any questions.
22.26 -.\"
22.27 -.\"
22.28 -.TH javadoc 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
22.29 -.hw javadoc
22.30 -.SH "名前"
22.31 -javadoc \- Java API ドキュメントジェネレータ
22.32 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
22.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
22.34 +."
22.35 +." This code is free software; you can redistribute it and/or modify it
22.36 +." under the terms of the GNU General Public License version 2 only, as
22.37 +." published by the Free Software Foundation.
22.38 +."
22.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
22.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
22.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22.42 +." version 2 for more details (a copy is included in the LICENSE file that
22.43 +." accompanied this code).
22.44 +."
22.45 +." You should have received a copy of the GNU General Public License version
22.46 +." 2 along with this work; if not, write to the Free Software Foundation,
22.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
22.48 +."
22.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
22.51 +." have any questions.
22.52 +."
22.53 +.TH javadoc 1 "04 May 2009"
22.54 +." Generated from HTML by html2man (author: Eric Armstrong)
22.55 +.SH ""
22.56 +javadoc \- Java API ャ<潟吾с若
22.57 .RS 3
22.58
22.59 .LP
22.60 .LP
22.61 -Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、Sun Solaris を使用した場合のものです。
22.62 -.LP
22.63 -.SH "形式"
22.64 -.B javadoc
22.65 -[
22.66 -.I options
22.67 -] [
22.68 -.I packagenames
22.69 -] [
22.70 -.I sourcefilenames
22.71 -] [
22.72 -.I \-subpackages pkg1:pkg2:...
22.73 -] [
22.74 -.I @argfiles
22.75 -]
22.76 -.LP
22.77 -.LP
22.78 -引数を指定する順序は任意です。Javadoc ツールでの、処理対象の \f2.java\fP ファイルを決定する方法の詳細については、「ソースファイルの処理」を参照してください。
22.79 -.TP 15
22.80 -.I options
22.81 -このドキュメントで指定されているコマンド行オプションです。
22.82 -.B javadoc
22.83 -のオプションの一般的な使用法については、「使用例」を参照してください。
22.84 -.TP
22.85 -.I packagenames
22.86 -.BR "java.lang java.lang.reflect java.awt"
22.87 -などの、スペースで区切られた
22.88 -一連のパッケージ名です。ドキュメント化するパッケージごとに別個に
22.89 -指定する必要があります。
22.90 -.B javadoc
22.91 -ツールはこれらのパッケージ名を探すとき、
22.92 -.B \-sourcepath
22.93 -を使用します。
22.94 -.B javadoc
22.95 -ツールは、サブパッケージを再帰的に処理することはありません。
22.96 -アスタリスク (\f3*\f1) などのワイルドカードは使うことができません。
22.97 -「1 つ以上のパッケージのドキュメント化」の
22.98 -例を参照してください。
22.99 -.TP
22.100 -.I sourcefilenames
22.101 -スペースで区切られた一連のファイル名です。パス、および
22.102 -アスタリスク (\f3*\f1) などのワイルドカードを含めることができます。
22.103 -.B javadoc
22.104 -ツールが処理するのは、ファイル名が「.java」という拡張子で終わり、
22.105 -その拡張子を除いた名前が実際に有効なクラス名
22.106 +Java 純若鴻<ゃAPI ャ<潟 HTML 若吾障ャ<潟х換篁 Javadoc 箴Sun Solaris 篏睡翫с
22.107 +.LP
22.108 +.RE
22.109 +.SH "綵√"
22.110 +.LP
22.111 +.LP
22.112 +\f4javadoc\fP\f2\ [\ \fP\f2options\fP\f2\ ]\ [\ packagenames\ ]\ [\ sourcefilenames\ ]\ [\ \-subpackages\fP\ \f2pkg1:pkg2:...\fP\f2\ ]\ [\ \fP\f2@argfiles\fP\f2\ ]\fP
22.113 +.LP
22.114 +.LP
22.115 +綣違絎綺篁紙сJavadoc 若с絲乗院 \f2.java\fP <ゃ羆阪号荅括完ゃ純若鴻<ゃс
22.116 +.LP
22.117 +.RS 3
22.118 +
22.119 +.LP
22.120 +.RS 3
22.121 +.TP 3
22.122 +options
22.123 +ャ<潟ц潟潟茵激с潟сJavadoc 激с潟罔羣篏睡羈ゃ篏睡箴с
22.124 +.TP 3
22.125 +packagenames
22.126 +鴻若鴻у阪筝c宴若後с 違\f2java.lang\ java.lang.reflect\ java.awt\fP 絎障ャ<潟宴若吾ャ絎綽荀障ゃ若篏睡筝с 絽亥\-subpackages 篏睡障Javadoc 若\f2\-sourcepath\fP 篏帥c宴若後罎膣≪障1 や札筝宴若吾ャ<潟箴с
22.127 +.TP 3
22.128 +sourcefilenames
22.129 +鴻若鴻у阪筝c純若鴻<ゃс<ゃ鴻у障障≪鴻帥鴻 (*) ゃ若с障 Javadoc 若<ゃ.java≦宍絖х≦宍絖ゃ絎鴻劫с鴻<ゃс (
22.130 +.na
22.131 +\f2Identifiers\fP @
22.132 .fi
22.133 - (http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625
22.134 -の
22.135 -.na
22.136 -「\f2Identifiers\fP」を参照) であるすべてのファイルです。
22.137 -したがって、ハイフンを含む名前 (X-Buffer など) や、
22.138 -その他の無効な文字を含む名前を付けることによって、
22.139 -それらのファイルをドキュメント化の対象から除外できます。
22.140 -これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。
22.141 -.B javadoc
22.142 -ツールは、ソースファイル名の前に指定されたパスを使用して、
22.143 -ソースファイル名を探します。この場合、
22.144 -.B -sourcepath
22.145 -は使用しません。たとえば、
22.146 -.B Button.java
22.147 -を渡すことは
22.148 -.BR ./Button.java
22.149 -と指定することと同じです。完全パスを付けたソースファイル名の
22.150 -例は「
22.151 -.BR /home/src/java/awt/Graphics*.java
22.152 -」のようになります。「1 つ以上のクラスのドキュメント化」の例を
22.153 -参照してください。また、「パッケージとクラスのドキュメント化」の
22.154 -例のように、パッケージ名とソースファイル名を組み合わせることもできます。
22.155 -.TP
22.156 -.I \-subpackages pkg1:pkg2:...
22.157 -指定されたパッケージ内のソースファイルからドキュメントを生成し、
22.158 -再帰的にサブパッケージを処理します。 パッケージ名または
22.159 -ソールファイル名を指定するための代替手段です。
22.160 -.TP
22.161 -.I @argfiles
22.162 -Javadoc オプション、パッケージ名、およびソースファイル名を
22.163 -任意の順序で並べたリストが含まれる 1 つ以上のファイルです。
22.164 -このファイルの中では、ワイルドカード (*) および
22.165 -.B \-J
22.166 -オプションは指定できません。
22.167 -.SH "機能説明"
22.168 -.B javadoc
22.169 -ツールは、一連の Java ソースファイルの宣言およびドキュメント
22.170 -コメントを解析し、デフォルトでは public クラスと protected クラス、
22.171 -入れ子クラス(匿名の内部クラスを除く)、インタフェース、コンストラクタ、メソッド、および
22.172 -フィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。
22.173 -.LP
22.174 -.B javadoc
22.175 -ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して
22.176 -実行できます。
22.177 -.B javadoc
22.178 -ツールをパッケージ全体に対して実行する場合は、最上位ディレクトリから再帰的にたどるために -subpackages を使用するか、パッケージ名の明示的なリストを渡します。
22.179 -個々のクラスに対して javadoc を実行する場合は、一連の
22.180 -ソース (\f3.java\f1) ファイル名を渡します。具体的な例は、
22.181 -このページの最後で示します。
22.182 -次に、Javadoc によるソースファイルの処理について説明します。
22.183 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)cゃ潟 (\f2X\-Buffer\fP ) 篁≦鴻絖篁c<ゃャ<潟絲乗院ゅс障鴻<ゃ潟若<ゃ翫箴水с 純若鴻<ゃ絎鴻cjavadoc <ゃ罎膣≪贋羆冴障障Javadoc 若純若鴻<ゃ罎膣≪ \f2\-sourcepath\fP 篏帥障後障鴻憜c後障鴻с \f2Button.java\fP 羝<\f2./Button.java\fP 羝<с純若鴻<ゃ鴻ф絎\f2/home/src/java/awt/Graphics*.java\fP 障1 や札筝鴻ャ<潟箴с障宴若吾鴻ャ<潟箴宴若後純若鴻<ゃ羞桁с障
22.184 +.TP 3
22.185 +\-subpackages pkg1:pkg2:...
22.186 +純若鴻<ゃ絎宴若吾潟泣宴若後絽亥ャ<潟障宴若後障純若鴻<ゃ絎綽荀障
22.187 +.TP 3
22.188 +@argfiles
22.189 +Javadoc 激с潟宴若後潟純若鴻<ゃ篁紙綺т研鴻鴻障 1 や札筝<ゃс<ゃ筝сゃ若 (*) \f2\-J\fP 激с潟絎с障
22.190 +.RE
22.191 +
22.192 +.LP
22.193 +.RE
22.194 +.SH " 茯"
22.195 +.LP
22.196 +.LP
22.197 +\f3Javadoc\fP 若筝c Java 純若鴻<ゃ絎h潟ャ<潟若激с潟潟<潟茹fс public 鴻protected 鴻ャ絖 (水鴻ゃ)ゃ潟帥с若鴻潟潟鴻帥<純潟c若ゃ茯筝c HTML 若吾障障API (≪宴若激с潟違潟違ゃ潟帥с若) ャ<潟筝c純若鴻<ゃ絎茖ャ<潟篏睡с障
22.198 +.LP
22.199 +.LP
22.200 +Javadoc 若宴若後篏純若鴻<ゃ障筝≧鴻絲障絎茵с障javadoc 若宴若後篏絲障絎茵翫筝篏c絽亥 \f2\-subpackages\fP 篏睡宴若後腓榊鴻羝<障純若鴻<ゃ絲障 javadoc 絎茵翫筝c純若 (\f2.java\fP) <ゃ羝<障隙箴ャ<潟緇膣剛障罨<Javadoc 純若鴻<ゃゃ茯障
22.201 .LP
22.202 .SS
22.203 -ソースファイルの処理
22.204 -.LP
22.205 -.LP
22.206 -Javadoc ツールは、末尾に \f2.java\fP の付いたファイル以外に、ソースファイルで説明する他のファイルも処理します。個々のソースファイル名を明示的に渡すことによって Javadoc ツールを実行する場合、\f2.java\fP ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソースファイル名を明示的に指定しなくても、Javadoc ツールは 3 つの方法で実行できます。この方法は、(1) パッケージ名を渡す、(2) \f2\-subpackages\fP を使用する、(3) ソースファイル名にワイルドカードを使用する (\f2*.java\fP) という方法です。これらの方法を使用する場合、Javadoc ツールは、\f2*.java\fP ファイルが次のすべての要件を満たしている場合にかぎり、このファイルを処理します。
22.207 +純若鴻<ゃ
22.208 +.LP
22.209 +.LP
22.210 +Javadoc 若絨障 \f2.java\fP 篁<ゃ篁ュ純若鴻<ゃц篁<ゃ障純若鴻<ゃ腓榊羝<c Javadoc 若絎茵翫 \f2.java\fP <ゃ罩g∈絎с障紊肴号с篏罐障 宴若後羝<祉膂≦с純若鴻<ゃ腓榊絎Javadoc 若 3 ゃ号у茵с障号(1) 宴若後羝<(2) \f2\-subpackages\fP 篏睡(3) 純若鴻<ゃゃ若篏睡 (\f2*.java\fP) 号с号篏睡翫Javadoc 若\f2.java\fP <ゃ罨<鴻荀篁吟羣翫<ゃ障
22.211 .LP
22.212 .RS 3
22.213 .TP 2
22.214 o
22.215 -名前から \f2.java\fP の接尾辞を取り除くと、実際に有効なクラス名になっている (有効な文字については、
22.216 + \f2.java\fP ・絨乗ゃ絎鴻劫c (鴻絖ゃ
22.217 +.na
22.218 +\f2Identifiers\fP @
22.219 .fi
22.220 -http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625
22.221 -の
22.222 -.na
22.223 -「\f2Identifiers\fP」を参照)
22.224 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
22.225 .TP 2
22.226 o
22.227 -ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている
22.228 +純若鴻若若後丞c鴻阪絖紊絎鴻宴若後c
22.229 .TP 2
22.230 o
22.231 -パッケージ文には有効なパッケージ名が含まれる (前項目で指定)
22.232 +宴若御鴻宴若後障 (ф絎)
22.233 .RE
22.234
22.235 .LP
22.236 .LP
22.237 -\f3リンクの処理\fP \-
22.238 -実行時に、
22.239 -.B javadoc
22.240 -ツールはその実行の一部として記述されているパッケージ、クラス、
22.241 -およびメンバの名称にクロスリファレンスリンクを自動的に
22.242 -追加します。リンクは、次の箇所に現われます。
22.243 -.LP
22.244 -.TP 2
22.245 -\(bu
22.246 -宣言 (戻り値の型、引数の型、フィールドの型)
22.247 -.TP 2
22.248 -\(bu
22.249 -@see タグから生成される [関連項目] のセクション
22.250 -.TP 2
22.251 -\(bu
22.252 -{@link} タグから生成されるインラインテキスト
22.253 -.TP 2
22.254 -\(bu
22.255 -@throws タグから生成される例外の名称
22.256 -.TP 2
22.257 -\(bu
22.258 -インタフェースのメンバに対する [定義] リンクと、クラスのメンバに対する [オーバーライド] リンク
22.259 -.TP 2
22.260 -\(bu
22.261 -パッケージ、クラス、およびメンバを記述した一覧表
22.262 -.TP 2
22.263 -\(bu
22.264 -パッケージとクラスの継承ツリー
22.265 -.TP 2
22.266 -\(bu
22.267 -索引
22.268 -.LP
22.269 -\-link と \-linkoffline オプションを使用して、
22.270 -コマンド行に含まれていない、個別に生成されるクラスの既存のテキストに
22.271 -ハイパーリンクを追加できます。
22.272 -.LP
22.273 -\f3その他の処理についての詳細\fP \-
22.274 -javadoc ツールは、実行のたびにひとつの完全なドキュメントを生成します。javadoc は、
22.275 -追加生成を行えません。つまり、以前に実行した javadoc の結果を変更したり、
22.276 -それらを直接取り込むことはできません。しかし、前述のようにほかの
22.277 -実行の結果にリンクすることは可能です。
22.278 -.LP
22.279 -実装上の理由から、
22.280 -.B javadoc
22.281 -ツールは実行に java コンパイラを必要とし、java コンパイラに依存しています。
22.282 -.B javadoc
22.283 -ツールは
22.284 -.B javac
22.285 -の一部を呼び出して、宣言をコンパイルし、メンバの実装は無視します。
22.286 -.B javadoc
22.287 -ツールは、クラス階層を含むクラスの豊富な内部表現、および「使用」関係を
22.288 -構築し、そこから HTML を生成します。
22.289 -.B javadoc
22.290 -ツールは、ソースコードのドキュメンテーションコメントから、ユーザの
22.291 -提供するドキュメントも取得します。
22.292 -.LP
22.293 -.B javadoc
22.294 -ツールは、メソッド本体のない純粋なスタブファイルである
22.295 -.B .java
22.296 -ソースファイル上で実行されます。つまり、API の作成時には、コードを
22.297 -記述する前の設計の早い段階でドキュメンテーションコメントを記述し、
22.298 -.B javadoc
22.299 -を実行できます。
22.300 -.LP
22.301 -コンパイラに依存することによって、HTML 出力が、実際の実装に正確に対応
22.302 -することが保証されます。実際の実装は、明示的でなく暗黙的に
22.303 -ソースコードに依存している場合があります。たとえば、
22.304 -.B javadoc
22.305 -ツールは、
22.306 -.B .class
22.307 -ファイル内には存在するが、ソースコード内には存在しない
22.308 -デフォルトコンストラクタ (「Java Language Specification」のセクション 8.6.7: http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154)
22.309 -をドキュメント化します。
22.310 -.LP
22.311 -多くの場合、
22.312 -.B javadoc
22.313 -ツールでは、ソースファイルのコードが不完全またはエラーを
22.314 -含んでいる場合でもドキュメントを生成できます。
22.315 -このため、デバッグやトラブルシューティングが完了する前に
22.316 -ドキュメントを生成できます。 たとえば、Java 言語仕様によると、
22.317 -抽象メソッドを含むクラスはそれ自体を抽象と宣言しなければなりません。
22.318 -このエラーを検出すると、javac コンパイラの場合は、このエラーで
22.319 -停止しますが、javadoc ツールは警告を出さずに処理を進めます。
22.320 -javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。
22.321 -ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、
22.322 -DocCheck ドックレットを使用してください。
22.323 -.LP
22.324 -.B javadoc
22.325 -ツールがドキュメント用の内部構造を構築するときは、参照する
22.326 -クラスをすべてロードします。このため、ブートストラップクラス、
22.327 -拡張機能、またはユーザクラスにかかわらず、
22.328 -.B javadoc
22.329 -ツールは、参照するクラスをすべて検出できなければなりません。
22.330 -一般的に、作成する
22.331 -クラスは、拡張機能としてロードされるか、
22.332 -.BR javadoc
22.333 -ツールのクラスパス内にある必要があります。
22.334 -.SS "Javadoc ドックレット"
22.335 -.B javadoc
22.336 -ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。
22.337 -.B javadoc
22.338 -ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み型」
22.339 -ドックレットがあり、これによって HTML 形式の API
22.340 -ドキュメントを生成します。標準ドックレット
22.341 -の修正やサブクラス化を行なったり、HTML、XML、MIF、RTF などの好みの
22.342 -出力形式を生成する独自のドックレットを記述することも可能です。
22.343 -ドックレットとその使用法については、次を参照してください。
22.344 -.LP
22.345 -.TP 2
22.346 -\(bu
22.347 -.B Javadoc
22.348 -ドックレット
22.349 -.TP 2
22.350 -\(bu
22.351 -.B -doclet
22.352 -コマンド行オプション
22.353 -.LP
22.354 -.B -doclet
22.355 -コマンド行オプションでカスタムドックレットが指定されていない場合、
22.356 -.B javadoc
22.357 -ツールは、デフォルトの標準ドックレットを使用します。
22.358 -.B javadoc
22.359 -ツールには、どのドックレットが使われているかには関係なく使用できる
22.360 -コマンド行オプションがあります。標準ドックレットでは、これらの
22.361 -ほかに、いくつかのコマンド行オプションが追加されます。どちらの
22.362 -オプションについても、後述の「オプション」で説明します。
22.363 -.SS 関連ドキュメントおよびドックレット
22.364 -.TP 2
22.365 -\(bu
22.366 -Javadoc に施された機能強化 - Javadoc に追加された改良点の詳細
22.367 -.TP 2
22.368 -\(bu
22.369 -Javadoc FAQ - 頻繁に寄せられる質問に対する回答、Javadoc 関連のツールについての情報、およびバグの回避方法
22.370 -.TP 2
22.371 -\(bu
22.372 -Javadoc のドキュメンテーションを作成するには - Sun で
22.373 -一般的なドキュメンテーションコメントの記述方法の詳細
22.374 -.TP 2
22.375 -\(bu
22.376 -API 仕様を記述するための要件 - Java 2 プラットフォーム仕様を記述する際に
22.377 -使用された標準要件。 この情報は、ソースファイルのドキュメンテーションコメント
22.378 -形式で API 仕様を記述する場合にも、その他の形式で記述する場合にも
22.379 -役立ちます。 検証可能なアサーションを満たすパッケージ、クラス、
22.380 -インタフェース、フィールド、およびメソッドについての要件を定めています。
22.381 -.TP 2
22.382 -\(bu
22.383 -ドキュメンテーションコメントの仕様 - ドキュメンテーションコメントの
22.384 -オリジナル仕様については、『Java Language Specification』
22.385 -(James Gosling、Bill Joy、Guy Steele 共著) の初版の
22.386 -第 18 章「Documentation Comments」を参照してください。
22.387 -この章は、第 2 版では削除されました。
22.388 -.TP 2
22.389 -\(bu
22.390 -DocCheck ドックレット - ソースファイル内のドキュメンテーションコメントを検査し、
22.391 -見つかったエラーや不規則な箇所を一覧にしたレポートを生成します。
22.392 -これは Sun Doc チェックユーティリティの一部です。
22.393 -.TP 2
22.394 -\(bu
22.395 -MIF ドックレット - MIF、FrameMaker、および PDF 形式での API ドキュメントの
22.396 -生成を自動化します。 MIF は Adobe FrameMaker の互換形式です。
22.397 -.SS "用語"
22.398 -.LP
22.399 -.LP
22.400 -「\f2ドキュメンテーションコメント\fP」、「\f2doc コメント\fP」、「\f2主説明\fP」、「\f2タグ\fP」、「\f2ブロックタグ\fP」、および「\f2インラインタグ\fP」の用語については、「ドキュメンテーションコメント」で説明します。以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。
22.401 -.RS 3
22.402 -.TP 3
22.403 -生成されるドキュメント
22.404 -.B javadoc
22.405 -ツールが Java ソースコード内の doc コメントから生成したドキュメント
22.406 -のことです。デフォルトの生成ドキュメントは HTML 形式で、標準
22.407 -ドックレットによって作成されます。
22.408 -.LP
22.409 -.TP 3
22.410 -名前
22.411 -Java 言語での名前、つまりパッケージ、クラス、インタフェース、
22.412 -フィールド、コンストラクタ、またはメソッドの名前のことです。名前は、
22.413 -.BR java.lang.String.equals(java.lang.Object)
22.414 -のように完全修飾することも、
22.415 -.BR equals(Object)
22.416 -のように部分修飾することもできます。
22.417 -.LP
22.418 -.TP 3
22.419 -ドキュメント化されるクラス
22.420 -.B javadoc
22.421 -の実行によって完全なドキュメントが生成されるクラスと
22.422 -インタフェースです。ドキュメント化するには、ソースファイルが
22.423 -使用可能でなければならず、ソースファイル名またはパッケージ名の
22.424 -どちらかを
22.425 -.B javadoc
22.426 -コマンドに渡さなければなりません。ドキュメント化されるクラスは、
22.427 -.B javadoc
22.428 -の実行で組み込まれるクラス、つまり「組み込みクラス」とも呼ばれます。
22.429 -.LP
22.430 -.TP 3
22.431 -含まれるクラス
22.432 -対応するソースファイル名またはパッケージ名が javadoc コマンドに
22.433 -渡されるクラスおよびインタフェースのことです。
22.434 -.LP
22.435 -.TP 3
22.436 -除外されるクラス
22.437 -javadoc コマンドにソースファイル名またはパッケージ名が
22.438 -渡されないクラスとインタフェースです。
22.439 -.LP
22.440 -.TP 3
22.441 -参照クラス
22.442 -ドキュメント化されるクラスとインタフェースの定義
22.443 -(実装) またはドキュメンテーションコメント内で明示的に参照される
22.444 -クラスとインタフェースです。参照の例としては、
22.445 -戻り値の型、パラメータの型、キャストの型、
22.446 -拡張されるクラス、実装されるインタフェース、
22.447 -インポートされるクラス、メソッド本体で使用される
22.448 -クラス、@see、{@link}、{@linkplain}、
22.449 -および {@inheritDoc} タグなどがあります
22.450 -(この定義は 1.3
22.451 -.fi
22.452 -(http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses)
22.453 -から
22.454 -変更されていることに注意)。
22.455 -javadoc ツールは動作中、
22.456 -.B javadoc
22.457 -のブートクラスパスと
22.458 -クラスパス内にある参照されているクラスを
22.459 -すべてメモリにロードするためです。
22.460 -参照されているクラスが見つからなかった
22.461 -場合は、[クラスが見つかりません] という警告が表示されます。
22.462 -.B javadoc
22.463 -ツールは、クラスの存在とそのメンバの完全修飾名を決定するのに十分な情報を、
22.464 -.B .class
22.465 -ファイルから引き出すことができます。
22.466 -.LP
22.467 -.TP 3
22.468 -外部参照クラス
22.469 -参照されるクラスのうち、
22.470 -.B javadoc
22.471 -を実行してもドキュメントが生成されないクラスです。
22.472 -つまり、これらのクラスは、コマンド行で
22.473 -.B javadoc
22.474 -ツールに渡されていません。
22.475 -生成ドキュメント内でこれらのクラスにリンクしている箇所は、
22.476 -「外部参照」または「外部リンク」と呼ばれます。 たとえば、
22.477 -.B java.awt
22.478 -パッケージに対してだけ
22.479 -.B javadoc
22.480 -を実行した場合、Object などの
22.481 -.BR java.lang
22.482 -内のすべてのクラスは、外部参照クラスになります。外部参照クラスには、
22.483 -.B \-link
22.484 -および
22.485 -.B \-linkoffline
22.486 -オプションを使ってリンクすることができます。
22.487 -外部参照クラスには、通常そのソースコメントを
22.488 -.B \javadoc
22.489 -ツールの実行で利用できないという重要な特徴があります。
22.490 -この場合、それらのコメントを継承することはできません。
22.491 -.SH "ソースファイル"
22.492 -.B javadoc
22.493 -ツールは、クラスの Java 言語ソースファイル (\f3.java\f1)、パッケージコメントファイル、
22.494 -概要コメントファイル、およびその他の処理されないファイルの 4 種類の
22.495 -「ソース」ファイルを基にして、出力を生成します。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートについても説明します。
22.496 -.SS "クラスソースコードファイル"
22.497 -各クラスまたはインタフェース、およびそのメンバは、
22.498 -.B .java
22.499 -ファイルの中にそれ自身のドキュメンテーションコメントを
22.500 -持つことができます。ドキュメンテーションコメントの詳細については、
22.501 -「ドキュメンテーションコメント」の節を参照してください。
22.502 -.SS "パッケージコメントファイル"
22.503 -各パッケージは、独自のドキュメンテーションコメントを
22.504 -持つことができ、「ソース」ファイルに保持します。
22.505 -.B javadoc
22.506 -ツールは、生成するパッケージの要約ページにこのコメントをマージします。
22.507 -通常、このコメントには、パッケージ全体に適用される
22.508 -ドキュメントを含めます。
22.509 -.LP
22.510 -パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。
22.511 +\f3潟\fP \- Javadoc 若絎茵筝絎茵сャ<潟宴若吾鴻潟<潟若絲障娯с潟菴遵障潟罨<贋菴遵障
22.512 .LP
22.513 .RS 3
22.514 .TP 2
22.515 o
22.516 -\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは JDK 5.0 で導入されたものであり、package.html よりも推奨されています。
22.517 +絎h (祉ゃ綣違c若)
22.518 .TP 2
22.519 o
22.520 -\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。
22.521 +\f2@see\fP 帥違 [∫i] 祉激с
22.522 +.TP 2
22.523 +o
22.524 +\f2{@link}\fP 帥違ゃ潟ゃ潟鴻
22.525 +.TP 2
22.526 +o
22.527 +\f2@throws\fP 帥違箴紊
22.528 +.TP 2
22.529 +o
22.530 +"ゃ潟帥с若鴻<潟若絲障 [絎臂] 潟鴻<潟若絲障 [若若ゃ] 潟
22.531 +.TP 2
22.532 +o
22.533 +宴若吾鴻潟<潟若网荀若
22.534 +.TP 2
22.535 +o
22.536 +宴若吾潟鴻膓帥
22.537 +.TP 2
22.538 +o
22.539 +膣√
22.540 .RE
22.541
22.542 .LP
22.543 .LP
22.544 -各パッケージは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを持つことができますが、両方を持つことはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。
22.545 -.LP
22.546 -.LP
22.547 -\f4package\-info.java\fP このファイルには、次の構造のパッケージコメントを格納できます。コメントはパッケージ宣言の前に配置します。
22.548 -.LP
22.549 -.LP
22.550 -File: \f2java/applet/package\-info.java\fP
22.551 -.LP
22.552 -.ft 3
22.553 -.nf
22.554 -/**
22.555 - * Provides the classes necessary to create an
22.556 - * applet and the classes an applet uses
22.557 - * to communicate with its applet context.
22.558 - * <p>
22.559 - * The applet framework involves two entities:
22.560 - * the applet and the applet context.
22.561 - * An applet is an embeddable window (see the
22.562 - * {@link java.awt.Panel} class) with a few extra
22.563 - * methods that the applet context can use to
22.564 - * initialize, start, and stop the applet.
22.565 - *
22.566 - * @since 1.0
22.567 - * @see java.awt
22.568 - */
22.569 -package java.lang.applet;
22.570 +潟潟茵ф絎c鴻ゃ√鴻 (ャ鴻) 絲障ゃ若潟菴遵\f2\-link\fP \f2\-linkoffline\fP 激с潟с障
22.571 +.LP
22.572 +.LP
22.573 +\f3篁ゃ荅括完\fP \- Javadoc 若絎茵潟 1 ゃ絎ャ<潟篏障 ャ<潟菴遵с障 ゃ障Javadoc 若篁ュ絎茵腟篆罩c絎鴻贋・腟水ャс障菴違篁ュ絎茵腟絲障潟菴遵с障
22.574 +.LP
22.575 +.LP
22.576 +絎茖筝宴Javadoc 若絎茵 java 潟潟ゃ綽荀java 潟潟ゃ箴絖障Javadoc 若 \f2javac\fP 筝若喝冴絎h潟潟ゃ<潟若絎茖∴障Javadoc 若拷絮ゃ鴻莟絲茵憗鴻篏睡≫罕膀宴 HTML 障Javadoc 若純若鴻潟若ャ<潟若激с潟潟<潟若吟若箴ャ<潟緇障
22.577 +.LP
22.578 +.LP
22.579 +Javadoc 若<純篏膣膕鴻帥<ゃс \f2.java\fP 純若鴻<ゃ絲障絎茵с障cAPI 篏絎茖荐菴違荐荐罧級сャ<潟若激с潟潟<潟荐菴違 javadoc 若絎茵с障
22.580 +.LP
22.581 +.LP
22.582 +潟潟ゃ箴絖cHTML 阪絎絎茖罩g∈絲上障 絎絎茖腓榊純若鴻潟若с藥純若鴻潟若箴絖翫障違Javadoc 若\f2.class\fP <ゃ絖純若鴻潟若絖
22.583 +.na
22.584 +\f2潟潟鴻\fP @
22.585 .fi
22.586 -.ft 1
22.587 -.LP
22.588 -コメント区切り文字の \f2/**\fP と \f2*/\fP は記述する必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。
22.589 -.LP
22.590 -.LP
22.591 -\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。
22.592 -.LP
22.593 -.LP
22.594 -File: \f2java/applet/package.html\fP
22.595 -.LP
22.596 -.LP
22.597 -.ft 3
22.598 -.nf
22.599 -<HTML>
22.600 -<BODY>
22.601 -Provides the classes necessary to create an applet and the
22.602 -classes an applet uses to communicate with its applet context.
22.603 -<p>
22.604 -The applet framework involves two entities: the applet
22.605 -and the applet context. An applet is an embeddable
22.606 -window (see the {@link java.awt.Panel} class) with a
22.607 -few extra methods that the applet context can use to
22.608 -initialize, start, and stop the applet.
22.609 -
22.610 -@since 1.0
22.611 -@see java.awt
22.612 -</BODY>
22.613 -</HTML>
22.614 +http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 荐茯篁罕祉激с 8.6.7) ャ<潟障
22.615 +.LP
22.616 +.LP
22.617 +絽吾Javadoc 若с純若鴻<ゃ潟若筝絎障若с翫сャ<潟с障違激ャ若c潟違絎篋ャ<潟с障違Java 荐茯篁罕処院<純鴻篏処院絎h違障若罎冴javac 潟潟ゃ罩≪障Javadoc 若茘冴膓茵障Javadoc 若ャ<潟若激с潟潟<潟堺с茵障ャ<潟若激с潟潟<潟荅潟с綽荀翫DocCheck 篏睡
22.618 +.LP
22.619 +.LP
22.620 +Javadoc 若ャ<潟罕罕膀с鴻鴻若障Javadoc 若若鴻鴻≦宍罘純障若吟若鴻鴻с鴻罎膣≪с違障荅括完
22.621 +.na
22.622 +\f2鴻罎膣∽号\fP @
22.623 .fi
22.624 -.ft 1
22.625 -.LP
22.626 -.LP
22.627 -これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述されています。ただし、ほかのコメントと異なる点が 1 つだけあります。それは、このドキュメンテーションコメントには、コメント区切り文字である \f2/**\fP と \f2*/\fP、および行頭のアスタリスクを含めてはならない、ということです。コメントを書く場合は、最初の文をパッケージの概要とし、\f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、全てのブロックタグは説明のあとに置かなければなりません。パッケージコメントファイルに \f2@see\fP タグを追加する場合は、完全指定の名前を使用する必要があります。詳細は、
22.628 -.fi
22.629 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecomments
22.630 -の
22.631 -.na
22.632 -「\f2example of \fP\f2package.html\fP」を参照してください。
22.633 -.LP
22.634 -.LP
22.635 -\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。
22.636 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlс絽吾篏鴻≦宍罘純若Javadoc 若鴻劫臀鏆荀障
22.637 +.LP
22.638 +.SS
22.639 +Javadoc
22.640 +.LP
22.641 +.LP
22.642 +Javadoc 若阪絎鴻綵√篏帥c鴻帥ゃ冴с障Javadoc 若罔羣若違腟粋昭帥障 罔羣HTML 綵√ API ャ<潟障罔羣篆罩c障泣劫HTMLXMLMIFRTF 絅純帥阪綵√荐菴違純с篏睡羈ゃ罨<с
22.643 .LP
22.644 .RS 3
22.645 .TP 2
22.646 o
22.647 -処理できるようにコメントをコピーする (\f2package.html\fP の場合であれば、\f2<body>\fP と \f2</body>\fP HTML タグの間にある内容をすべてコピーする。\f2<head>\fP を含め、そこに \f2<title>\fP やソースファイルの著作権記述などの情報を配置することもできるが、生成後のドキュメンテーションにはそれらは一切表示されない)
22.648 +.na
22.649 +\f2Javadoc \fP @
22.650 +.fi
22.651 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
22.652 .TP 2
22.653 o
22.654 -パッケージタグがあれば、すべて処理する
22.655 +\f2\-doclet\fP 潟潟茵激с
22.656 +.RE
22.657 +
22.658 +.LP
22.659 +.LP
22.660 +\f2\-doclet\fP 潟潟茵激с潟с鴻帥絎翫Javadoc 若罔羣篏睡障javadoc 若篏睡≫鋎睡с潟潟茵激с潟障罔羣с祉ゃ潟潟茵激с潟菴遵障<激с潟ゃ激с潟ц障
22.661 +.LP
22.662 +.SS
22.663 +∫cャ<潟潟
22.664 +.LP
22.665 +.RS 3
22.666 .TP 2
22.667 o
22.668 -生成したパッケージの概要ページの最後に、処理したテキストを挿入する (例: パッケージの概要)
22.669 +.na
22.670 +\f2Javadoc 純罘遵七\fP @
22.671 +.fi
22.672 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc ц申壕鴻荅括完
22.673 .TP 2
22.674 o
22.675 -パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例: 概要の要約)。文の末尾は、クラスやメンバの主説明の最初の文の末尾と同じ規則によって判断される
22.676 +.na
22.677 +\f2Javadoc FAQ\fP @
22.678 +.fi
22.679 +http://java.sun.com/j2se/javadoc/faq/index.html \- 紫絲莖絲障膈Javadoc ∫c若ゃ宴潟違炊号
22.680 +.TP 2
22.681 +o
22.682 +.na
22.683 +\f2How to Write Doc Comments for Javadoc\fP @
22.684 +.fi
22.685 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ャ<潟若激с潟潟<潟荐菴井号≪ Sun 荀靘
22.686 +.TP 2
22.687 +o
22.688 +.na
22.689 +\f2Requirements for Writing API Specifications\fP @
22.690 +.fi
22.691 +http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java 2 若篁罕荐菴違篏睡罔羣荀篁吟宴純若鴻<ゃャ<潟若激с潟潟<潟綵√ API 篁罕荐菴違翫篁綵√ц菴違翫綵合<障罎荐弱純≪泣若激с潟羣宴若吾鴻ゃ潟帥с若鴻c若潟<純ゃ荀篁吟絎障
22.692 +.TP 2
22.693 +o
22.694 +.na
22.695 +\f2ャ<潟若激с潟潟<潟篁罕\fP @
22.696 +.fi
22.697 +http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ャ<潟若激с潟潟<潟吾篁罕ゃJava Language Specification (James GoslingBill JoyGuy Steele 沿) 膃 18 腴Documentation Commentsс腴膃 2 сゃ障
22.698 +.TP 2
22.699 +o
22.700 +.na
22.701 +\f2DocCheck \fP @
22.702 +.fi
22.703 +http://java.sun.com/javadoc/doccheck \- 純若鴻<ゃャ<潟若激с潟潟<潟с罎冴若筝罩c若障Sun Doc Check 若cc若筝сSun Doc Check 若cc若筝с
22.704 +.TP 2
22.705 +o
22.706 +.na
22.707 +\f2MIF \fP @
22.708 +.fi
22.709 +http://java.sun.com/javadoc/mifdoclet \- MIFFrameMakerPDF 後 API ャ<潟障MIF Adobe FrameMaker 篋ゆ後с
22.710 .RE
22.711
22.712 .LP
22.713 -.SS "概要コメントファイル"
22.714 -ドキュメント化する各アプリケーションまたはパッケージのセットは、
22.715 -独自の概要ドキュメンテーションコメントを持つことができ、それは
22.716 -「ソース」ファイルに保持されます。
22.717 -.B javadoc
22.718 -ツールは、生成する概要ページにこのコメントをマージします。通常、この
22.719 -コメントには、アプリケーションまたはパッケージのセット全体に
22.720 -当てはまるドキュメントを含めます。
22.721 -.LP
22.722 -概要コメントファイルを作成する場合、ファイルに好きな名前を付けて、
22.723 -好きな場所に置くことができますが、通常はファイル名を
22.724 -.B overview.html
22.725 -にして、ソースツリーの一番上の階層に置きます。
22.726 -たとえば、
22.727 -.B java.applet
22.728 -パッケージのソースファイルが
22.729 -.B /home/user/src/java/applet
22.730 -ディレクトリに含まれているとすると、
22.731 -.BR /home/user/src/overview.html
22.732 -に概要コメントファイルを作成することができます。
22.733 -.LP
22.734 -異なるパッケージのセットに対して javadoc を複数回実行する場合は、同じ 1 つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。
22.735 -たとえば、内部ドキュメンテーション用に \-private を指定して javadoc を 1 回実行したあと、公開ドキュメンテーション用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメントファイルの 1 文目で、そのドキュメンテーションを公開用または内部用として記述できます。
22.736 -.LP
22.737 -概要コメントファイルの内容は、前に述べたパッケージコメントファイルと
22.738 -同様、HTML で記述された 1 つの大きなドキュメント
22.739 -コメントです。詳細は、前述の説明を参照してください。繰り返しに
22.740 -なりますが、このコメントを書く場合は、最初の文をアプリケーション
22.741 -またはパッケージのセットの要約にし、
22.742 -.B <body>
22.743 -と最初の文の間にタイトルまたはその他のテキストを含めてはなりません。
22.744 -概要タグを含めることができます。どのドキュメンテーションコメントに
22.745 -ついても、{\f3@link\f1}
22.746 -以外のタグは、説明のあとに置く必要があります。
22.747 -.B @see
22.748 -タグを追加する場合は、完全指定の名前を使用する必要があります。
22.749 -.LP
22.750 -.BR javadoc
22.751 -ツールの実行時に、
22.752 -.B \-overview
22.753 -オプションを使って概要コメントファイル名を指定します。ファイルは、
22.754 -パッケージコメントファイルと同じように処理されます。
22.755 +.SS
22.756 +茯
22.757 +.LP
22.758 +.LP
22.759 +\f2ャ<潟若激с潟潟<潟\fP\f2doc 潟<潟\fP\f2筝肢\fP\f2帥違\fP\f2帥違\fP\f2ゃ潟ゃ潟帥違\fP茯ゃャ<潟若激с潟潟<潟ц障罨<篁茯Javadoc 若潟潟鴻х劫潟<障
22.760 +.LP
22.761 +.RS 3
22.762 +.TP 3
22.763 +ャ<潟 (generated document)
22.764 +javadoc 若 Java 純若鴻潟若ャ<潟若激с潟潟<潟ャ<潟сャ<潟 HTML 綵√с罔羣c篏障
22.765 +.LP
22.766 +.TP 3
22.767 + (name)
22.768 +Java 荐茯ф吾違荀膣ゃ障宴若吾鴻ゃ潟帥с若鴻c若潟潟鴻帥障<純с\f2java.lang.String.equals(java.lang.Object)\fP 絎篆蕋障\f2equals(Object)\fP 篆蕋障с障
22.769 +.LP
22.770 +.TP 3
22.771 +ャ<潟 (documented classes)
22.772 +javadoc 若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻сャ<潟純若鴻<ゃ篏睡純с違純若鴻<ゃ障宴若後 javadoc 潟潟羝<≪祉剛信蕋上 (publicprotectedpackage\-private 障 private) cc水違障ャ<潟鴻javadoc 若阪腟粋昭障鴻ゃ障鴻若違障
22.773 +.LP
22.774 +.TP 3
22.775 + (included classes)
22.776 +若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻сャ<潟鴻
22.777 +.LP
22.778 +.TP 3
22.779 +ゅ (excluded classes)
22.780 +若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻с
22.781 +.LP
22.782 +.TP 3
22.783 +с (referenced classes)
22.784 +ャ<潟鴻潟ゃ潟帥с若鴻絎臂 (絎茖) 障ャ<潟若激с潟潟<潟筝ф腓榊с鴻潟ゃ潟帥с若鴻сс箴祉ゃ<若帥c鴻≦宍鴻絎茖ゃ潟帥с若鴻ゃ潟若鴻<純篏т戎鴻@see{@link}{@linkplain}{@inheritDoc} 帥違障絎臂
22.785 +.na
22.786 +\f21.3\fP @
22.787 +.fi
22.788 +http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses 紊眼障javadoc 若絎茵Javadoc 若鴻鴻潟鴻劫鴻с鴻<≪若若綽荀障с鴻荀ゃ翫鴻荀ゃ障茘茵腓冴障Javadoc 若鴻絖<潟若絎絎ゅャ綽荀鴻宴.class <ゃ綣冴с障
22.789 +.LP
22.790 +.TP 3
22.791 +紊с (external referenced classes)
22.792 +с鴻<javadoc 若絎茵筝ャ<潟鴻сゃ障鴻潟潟茵 Javadoc 若羝<障ャ<潟с鴻潟膊紊с障紊潟若違障違\f2java.awt\fP 宴若吾絲障 Javadoc 若絎茵翫\f2Object\fP \f2java.lang\fP 鴻鴻紊с鴻障紊с鴻潟\f2\-link\fP \f2\-linkoffline\fP 激с潟篏睡障紊с鴻絽吾純若鴻潟<潟 javadoc 若絎茵ус荀劫彰障翫潟<潟膓帥с障
22.793 +.RE
22.794 +
22.795 +.LP
22.796 +.SH "純若鴻<ゃ"
22.797 +.LP
22.798 +.LP
22.799 +Javadoc 若4 腮蕁違純若鴻<ゃ阪腟障<ゃ鴻 Java 荐茯純若鴻<ゃ (\f2.java\fP)宴若吾潟<潟<ゃ网荀潟<潟<ゃ潟篁<ゃс障ャ<潟純若鴻若絖翫鴻<ゃ潟若<ゃゃ茯障
22.800 +.LP
22.801 +.SS
22.802 +鴻純若鴻潟若<ゃ
22.803 +.LP
22.804 +.LP
22.805 +鴻障ゃ潟帥с若鴻潟<潟若ャ<潟若激с潟潟<潟ゃс \f2.java\fP <ゃ篆障ャ<潟若激с潟潟<潟荅括完ャ<潟若激с潟潟<潟с
22.806 +.LP
22.807 +.SS
22.808 +宴若吾潟<潟<ゃ
22.809 +.LP
22.810 +.LP
22.811 +宴若吾ャ<潟若激с潟潟<潟ゃс絨純若鴻<ゃ篆障 絎鴻Javadoc 若c网荀若吾腟粋昭障障潟<潟絽吾宴若後篏綵障ャ<潟荐菴違障
22.812 +.LP
22.813 +.LP
22.814 +宴若吾潟<潟<ゃ篏翫潟<潟主罨< 2 ゃ<ゃ御с障
22.815 +.LP
22.816 +.RS 3
22.817 .TP 2
22.818 -\(bu
22.819 -.B <body>
22.820 -タグと
22.821 -.B </body>
22.822 -タグとの間にあるすべての内容を処理のためにコピーする
22.823 +o
22.824 +\f2package\-info.java\fP \- 宴若後h宴若御絵宴若吾潟<潟 Javadoc 帥違主с障<ゃ JDK 5.0 уャсpackage.html ィ絅障
22.825 .TP 2
22.826 -\(bu
22.827 -存在する概要タグを処理する
22.828 +o
22.829 +\f2package.html\fP \- 主с宴若吾潟<潟 Javadoc 帥違с 宴若御絵主с障
22.830 +.RE
22.831 +
22.832 +.LP
22.833 +.LP
22.834 +宴若吾筝 \f2package.html\fP <ゃ筝 \f2package\-info.java\fP <ゃゃс障筝≧鴻ゃс障<<ゃ \f2.java\fP <ゃ純若鴻弱宴若吾c臀
22.835 +.LP
22.836 +.LP
22.837 +\f4package\-info.java\fP \- <ゃ罨<罕宴若吾潟<潟主с障 潟<潟宴若後h臀障
22.838 +.LP
22.839 +.LP
22.840 +File:\f2java/applet/package\-info.java\fP
22.841 +.LP
22.842 +.LP
22.843 +.TS
22.844 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.845 +.de 35
22.846 +.ps \n(.s
22.847 +.vs \n(.vu
22.848 +.in \n(.iu
22.849 +.if \n(.u .fi
22.850 +.if \n(.j .ad
22.851 +.if \n(.j=0 .na
22.852 +..
22.853 +.nf
22.854 +.nr #~ 0
22.855 +.if n .nr #~ 0.6n
22.856 +.ds #d .d
22.857 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.858 +.fc
22.859 +.nr 33 \n(.s
22.860 +.rm 80
22.861 +.nr 34 \n(.lu
22.862 +.eo
22.863 +.am 80
22.864 +.br
22.865 +.di a+
22.866 +.35
22.867 +.ft \n(.f
22.868 +.ll \n(34u*1u/2u
22.869 +.if \n(.l<\n(80 .ll \n(80u
22.870 +.in 0
22.871 +.nf
22.872 +\f3
22.873 +.fl
22.874 +/**
22.875 +.fl
22.876 + * Provides the classes necessary to create an
22.877 +.fl
22.878 + * applet and the classes an applet uses
22.879 +.fl
22.880 + * to communicate with its applet context.
22.881 +.fl
22.882 + * <p>
22.883 +.fl
22.884 + * The applet framework involves two entities:
22.885 +.fl
22.886 + * the applet and the applet context.
22.887 +.fl
22.888 + * An applet is an embeddable window (see the
22.889 +.fl
22.890 + * {@link java.awt.Panel} class) with a few extra
22.891 +.fl
22.892 + * methods that the applet context can use to
22.893 +.fl
22.894 + * initialize, start, and stop the applet.
22.895 +.fl
22.896 + *
22.897 +.fl
22.898 + * @since 1.0
22.899 +.fl
22.900 + * @see java.awt
22.901 +.fl
22.902 + */
22.903 +.fl
22.904 +package java.lang.applet;
22.905 +.fl
22.906 +\fP
22.907 +.fi
22.908 +.br
22.909 +.di
22.910 +.nr a| \n(dn
22.911 +.nr a- \n(dl
22.912 +..
22.913 +.ec \
22.914 +.35
22.915 +.nf
22.916 +.ll \n(34u
22.917 +.nr 80 0
22.918 +.80
22.919 +.rm 80
22.920 +.nr 38 \n(a-
22.921 +.if \n(80<\n(38 .nr 80 \n(38
22.922 +.35
22.923 +.nf
22.924 +.ll \n(34u
22.925 +.nr 38 1n
22.926 +.nr 79 0
22.927 +.nr 40 \n(79+(0*\n(38)
22.928 +.nr 80 +\n(40
22.929 +.nr TW \n(80
22.930 +.if t .if \n(TW>\n(.li .tm Table at line 353 file Input is too wide - \n(TW units
22.931 +.fc
22.932 +.nr #T 0-1
22.933 +.nr #a 0-1
22.934 +.eo
22.935 +.de T#
22.936 +.ds #d .d
22.937 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.938 +.mk ##
22.939 +.nr ## -1v
22.940 +.ls 1
22.941 +.ls
22.942 +..
22.943 +.ec
22.944 +.ne \n(a|u+\n(.Vu
22.945 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.946 +.ta \n(80u
22.947 +.nr 31 \n(.f
22.948 +.nr 35 1m
22.949 +\&\h'|\n(40u'
22.950 +.mk ##
22.951 +.nr 31 \n(##
22.952 +.sp |\n(##u-1v
22.953 +.nr 37 \n(40u
22.954 +.in +\n(37u
22.955 +.a+
22.956 +.in -\n(37u
22.957 +.mk 32
22.958 +.if \n(32>\n(31 .nr 31 \n(32
22.959 +.sp |\n(31u
22.960 +.fc
22.961 +.nr T. 1
22.962 +.T# 1
22.963 +.35
22.964 +.rm a+
22.965 +.TE
22.966 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
22.967 +
22.968 +.LP
22.969 +.LP
22.970 +潟<潟阪絖 \f2/**\fP \f2/*\fP 荐菴違綽荀障筝茵茵≪鴻帥鴻ャ障障
22.971 +.LP
22.972 +.LP
22.973 +\f4package.html\fP \- <ゃ罨<罕宴若吾潟<潟主с障 潟<潟 \f2<body>\fP 荀膣臀障
22.974 +.LP
22.975 +.LP
22.976 +File:\f2java/applet/package.html\fP
22.977 +.LP
22.978 +.LP
22.979 +.TS
22.980 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.981 +.de 35
22.982 +.ps \n(.s
22.983 +.vs \n(.vu
22.984 +.in \n(.iu
22.985 +.if \n(.u .fi
22.986 +.if \n(.j .ad
22.987 +.if \n(.j=0 .na
22.988 +..
22.989 +.nf
22.990 +.nr #~ 0
22.991 +.if n .nr #~ 0.6n
22.992 +.ds #d .d
22.993 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.994 +.fc
22.995 +.nr 33 \n(.s
22.996 +.rm 80
22.997 +.nr 34 \n(.lu
22.998 +.eo
22.999 +.am 80
22.1000 +.br
22.1001 +.di a+
22.1002 +.35
22.1003 +.ft \n(.f
22.1004 +.ll \n(34u*1u/2u
22.1005 +.if \n(.l<\n(80 .ll \n(80u
22.1006 +.in 0
22.1007 +.nf
22.1008 +\f3
22.1009 +.fl
22.1010 +<HTML>
22.1011 +.fl
22.1012 +<BODY>
22.1013 +.fl
22.1014 +Provides the classes necessary to create an applet and the
22.1015 +.fl
22.1016 +classes an applet uses to communicate with its applet context.
22.1017 +.fl
22.1018 +<p>
22.1019 +.fl
22.1020 +The applet framework involves two entities: the applet
22.1021 +.fl
22.1022 +and the applet context. An applet is an embeddable
22.1023 +.fl
22.1024 +window (see the {@link java.awt.Panel} class) with a
22.1025 +.fl
22.1026 +few extra methods that the applet context can use to
22.1027 +.fl
22.1028 +initialize, start, and stop the applet.
22.1029 +.fl
22.1030 +
22.1031 +.fl
22.1032 +@since 1.0
22.1033 +.fl
22.1034 +@see java.awt
22.1035 +.fl
22.1036 +</BODY>
22.1037 +.fl
22.1038 +</HTML>
22.1039 +.fl
22.1040 +\fP
22.1041 +.fi
22.1042 +.br
22.1043 +.di
22.1044 +.nr a| \n(dn
22.1045 +.nr a- \n(dl
22.1046 +..
22.1047 +.ec \
22.1048 +.35
22.1049 +.nf
22.1050 +.ll \n(34u
22.1051 +.nr 80 0
22.1052 +.80
22.1053 +.rm 80
22.1054 +.nr 38 \n(a-
22.1055 +.if \n(80<\n(38 .nr 80 \n(38
22.1056 +.35
22.1057 +.nf
22.1058 +.ll \n(34u
22.1059 +.nr 38 1n
22.1060 +.nr 79 0
22.1061 +.nr 40 \n(79+(0*\n(38)
22.1062 +.nr 80 +\n(40
22.1063 +.nr TW \n(80
22.1064 +.if t .if \n(TW>\n(.li .tm Table at line 406 file Input is too wide - \n(TW units
22.1065 +.fc
22.1066 +.nr #T 0-1
22.1067 +.nr #a 0-1
22.1068 +.eo
22.1069 +.de T#
22.1070 +.ds #d .d
22.1071 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.1072 +.mk ##
22.1073 +.nr ## -1v
22.1074 +.ls 1
22.1075 +.ls
22.1076 +..
22.1077 +.ec
22.1078 +.ne \n(a|u+\n(.Vu
22.1079 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.1080 +.ta \n(80u
22.1081 +.nr 31 \n(.f
22.1082 +.nr 35 1m
22.1083 +\&\h'|\n(40u'
22.1084 +.mk ##
22.1085 +.nr 31 \n(##
22.1086 +.sp |\n(##u-1v
22.1087 +.nr 37 \n(40u
22.1088 +.in +\n(37u
22.1089 +.a+
22.1090 +.in -\n(37u
22.1091 +.mk 32
22.1092 +.if \n(32>\n(31 .nr 31 \n(32
22.1093 +.sp |\n(31u
22.1094 +.fc
22.1095 +.nr T. 1
22.1096 +.T# 1
22.1097 +.35
22.1098 +.rm a+
22.1099 +.TE
22.1100 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-40
22.1101 +
22.1102 +.LP
22.1103 +.LP
22.1104 +絽吾 HTML <ゃс宴若後hс鴻羈宴若吾潟<潟<ゃ絎鴻祉鴻潟<潟罕 HTML ц菴違障ャ<潟若激с潟潟<潟潟<潟阪絖с \f2/**\fP \f2*/\fP活≪鴻帥鴻с潟<潟吾翫宴若吾网荀\f2<body>\fP 帥ゃ篁鴻障宴若吾帥違с障祉ャ<潟若激с潟潟<潟罕鴻帥違筝肢臀違障宴若吾潟<潟<ゃ \f2@see\fP 帥違菴遵翫絎絎篏睡綽荀障荅括完
22.1105 +.na
22.1106 +\f2package.html\fP 箴 @
22.1107 +.fi
22.1108 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsс
22.1109 +.LP
22.1110 +.LP
22.1111 +\f3宴若吾潟<潟<ゃ\fP \- Javadoc 若絎茵宴若吾潟<潟<ゃ罎膣≪<ゃ荀ゃ罨<茵障
22.1112 +.LP
22.1113 +.RS 3
22.1114 .TP 2
22.1115 -\(bu
22.1116 -概要の要約などの Javadoc が生成する概要ページの最後に、
22.1117 -処理されたテキストを挿入する
22.1118 +o
22.1119 +с潟<潟潟若 (\f2package.html\fP 翫с違\f2<body>\fP \f2</body>\fP HTML 帥違絎鴻鴻潟若\f2<head>\fP \f2<title>\fP 純若鴻<ゃ篏罔荐菴違宴臀с緇ャ<潟若激с潟筝茵腓冴)
22.1120 .TP 2
22.1121 -\(bu
22.1122 -概要ページの先頭に、概要コメントの最初の文をコピーする
22.1123 -.SS "その他の処理されないファイル"
22.1124 -ソースには、
22.1125 -.B javadoc
22.1126 -ツールで生成先のディレクトリにコピーする、その他の任意のファイルを
22.1127 -含めることができます。一般に、このようなファイルには、
22.1128 -サンプルのグラフィックファイル、Java ソース
22.1129 -(\f3.java\f1) およびクラス (\f3.class\f1) ファイル、内容が
22.1130 -通常の Java ソース
22.1131 -ファイルのドキュメンテーションコメントの影響を受けない
22.1132 -独立した HTML ファイルなどがあります。
22.1133 -.LP
22.1134 -処理されないファイルを含めるには、それらのファイルを
22.1135 -.BR doc-files
22.1136 -というディレクトリに置きます。このディレクトリは、任意のパッケージ
22.1137 -ディレクトリの下に作成できます。パッケージごとにこのようなサブ
22.1138 -ディレクトリを 1 つ持つことができます。このサブディレクトリには、
22.1139 -イメージ、サンプルコード、ソースファイル、
22.1140 -.B .class
22.1141 -ファイル、アプレット、および HTML ファイルを入れることができます。
22.1142 -たとえば、ボタンの画像
22.1143 -.B button.gif
22.1144 -を
22.1145 -.B java.awt.Button
22.1146 -クラスドキュメントに含めたい場合は、そのファイルを
22.1147 -.B /home/user/src/java/awt/doc-files/
22.1148 -ディレクトリに置きます。
22.1149 -.BR doc-files
22.1150 -ディレクトリを
22.1151 -.B /home/user/src/java/doc-files
22.1152 -に置くことはできません。これは、
22.1153 -.B java
22.1154 -はパッケージではなく、そのディレクトリそのものにソースファイルが
22.1155 -入っていないからです。
22.1156 -.LP
22.1157 -これらの処理されないファイルへのリンクは
22.1158 -すべて明示的に記述する必要があります。これは、
22.1159 -.B javadoc
22.1160 -ツールがファイルを見ずに、単にディレクトリとその内容物を生成先に
22.1161 -コピーするだけだからです。たとえば、
22.1162 -.B Button.java
22.1163 -ドキュメンテーションコメント内のリンクは、次のようになります。
22.1164 -.LP
22.1165 -.ft 3
22.1166 +o
22.1167 +宴若吾帥違違鴻
22.1168 +.TP 2
22.1169 +o
22.1170 +宴若吾网荀若吾緇鴻水ャ (箴:
22.1171 +.na
22.1172 +\f2宴若吾网荀\fP @
22.1173 +.fi
22.1174 +http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html)
22.1175 +.TP 2
22.1176 +o
22.1177 +宴若吾网荀若吾宴若吾潟<潟潟若网荀若吾宴若吾鴻宴若後宴若吾潟<潟菴遵 (箴:
22.1178 +.na
22.1179 +\f2网荀荀膣\fP @
22.1180 +.fi
22.1181 +http://java.sun.com/javase/6/docs/api/overview\-summary.html)絨障鴻<潟若筝肢絨障荀cゆ
22.1182 +.RE
22.1183 +
22.1184 +.LP
22.1185 +.SS
22.1186 +网荀潟<潟<ゃ
22.1187 +.LP
22.1188 +.LP
22.1189 +ャ<潟≪宴若激с潟障宴若吾祉网荀ャ<潟若激с潟潟<潟ゃс絨純若鴻<ゃ篆障 絎鴻Javadoc 若c网荀若吾腟粋昭障障潟<潟絽吾≪宴若激с潟障宴若吾祉篏綵障ャ<潟荐菴違障
22.1190 +.LP
22.1191 +.LP
22.1192 +网荀潟<潟<ゃ篏翫<ゃ篁紙篁篁紙贋臀с障絽吾<ゃ \f4overview.html\fP 純若鴻若筝篏臀障違\f2java.applet\fP 宴若吾純若鴻<ゃ \f2/home/user/src/java/applet\fP c障翫\f2/home/user/src/overview.html\fP 网荀潟<潟<ゃ篏с障
22.1193 +.LP
22.1194 +.LP
22.1195 +違宴若吾祉絲障 javadoc 茲医絎茵翫 1 ゃ純若鴻<ゃ祉絲障茲違网荀潟<潟<ゃ篏с障違ャ<潟若激с括 \-private 絎 javadoc 1 絎茵ャ<潟若激с括激с潟絎у綺絎茵с障翫网荀潟<潟<ゃ 1 сャ<潟若激с潟障荐菴違с障
22.1196 +.LP
22.1197 +.LP
22.1198 +网荀潟<潟<ゃ絎鴻菴違宴若吾潟<潟<ゃ罕HTML ц菴違 1 ゃ紊сャ<潟若激с潟潟<潟с荅括完菴違茯с荀鴻膵違菴潟<潟荐菴違翫≪宴若激с潟障宴若吾祉荀膣\f2<body>\fP 帥ゃ篁鴻障网荀帥違с障 ャ<潟若激с潟潟<潟ゃゃ潟ゃ潟帥 (\f2{@link}\fP ) 篁ュ鴻帥違筝肢臀鏆荀障\f2@see\fP 帥違菴遵翫絎絎篏睡違障
22.1199 +.LP
22.1200 +.LP
22.1201 +Javadoc 若絎茵\-overview 激с潟篏帥c网荀潟<潟<ゃ絎障<ゃ宴若吾潟<潟<ゃ障
22.1202 +.LP
22.1203 +.RS 3
22.1204 +.TP 2
22.1205 +o
22.1206 +\f2<body>\fP 帥違 \f2</body>\fP 帥違鴻絎鴻潟若
22.1207 +.TP 2
22.1208 +o
22.1209 +网荀帥違違鴻
22.1210 +.TP 2
22.1211 +o
22.1212 +网荀若吾緇鴻水ャ (箴:
22.1213 +.na
22.1214 +\f2网荀荀膣\fP @
22.1215 +.fi
22.1216 +http://java.sun.com/javase/6/docs/api/overview\-summary.html)
22.1217 +.TP 2
22.1218 +o
22.1219 +网荀若吾网荀潟<潟潟若
22.1220 +.RE
22.1221 +
22.1222 +.LP
22.1223 +.SS
22.1224 +篁<ゃ
22.1225 +.LP
22.1226 +.LP
22.1227 +純若鴻Javadoc 若cc潟若篁篁紙<ゃс障筝<ゃ違c<ゃ泣潟 Java 純若 (.java) 潟 (.class) <ゃ絎鴻絽吾 Java 純若鴻<ゃャ<潟若激с潟潟<潟綵演帥腴 HTML <ゃ障
22.1228 +.LP
22.1229 +.LP
22.1230 +<ゃ純若鴻<ゃ \f4doc\-files\fP c臀障 c純若鴻<ゃ篁紙宴若吾c筝篏с障泣c宴若吾 1 ょс障ゃ<若吾泣潟潟若純若鴻<ゃ.class <ゃ≪ HTML <ゃc主с障違帥潟ゃ<若 \f2button.gif\fP \f2java.awt.Button\fP 鴻ャ<潟翫<ゃ \f2/home/user/src/java/awt/doc\-files/\fP c臀障\f2doc\-files\fP c \f2/home/user/src/java/doc\-files\fP 臀с障 \f2java\fP 宴若吾сc純若鴻<ゃャcс
22.1231 +.LP
22.1232 +.LP
22.1233 +<ゃ吾潟鴻腓榊荐菴違綽荀障 Javadoc 若<ゃ荀c絎鴻潟若с違\f2Button.java\fP ャ<潟若激с潟潟<潟潟罨<障
22.1234 +.LP
22.1235 .nf
22.1236 -/**
22.1237 -* This button looks like this:
22.1238 -* <img src="doc-files/Button.gif">
22.1239 -*/
22.1240 +\f3
22.1241 +.fl
22.1242 + /**
22.1243 +.fl
22.1244 + * This button looks like this:
22.1245 +.fl
22.1246 + * <img src="doc\-files/Button.gif">
22.1247 +.fl
22.1248 + */
22.1249 +.fl
22.1250 +\fP
22.1251 .fi
22.1252 -.ft 1
22.1253 -.SH "テストファイルおよびテンプレートファイル"
22.1254 -一部の開発者から、テストファイルおよびテンプレートファイルを
22.1255 -対応するソースファイルの近くのソースツリーに保存したいという要望がありました。
22.1256 -つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに
22.1257 -保存したいということです。
22.1258 -.LP
22.1259 -個別のソースファイル名で明示的に渡して
22.1260 -.B Javadoc
22.1261 -ツールを実行する場合は、
22.1262 -テストファイルおよびテンプレートファイルを意図的に除外して、
22.1263 -処理されないようにすることができます。ただし、パッケージ名または
22.1264 -ワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイル
22.1265 -およびテンプレートファイルが
22.1266 -処理されないようにする必要があります。
22.1267 -.LP
22.1268 -テストファイルとテンプレートファイルの違いは、
22.1269 -テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、
22.1270 -テンプレートファイルは、そうではないという点です。ただし、
22.1271 -テンプレートファイルも「.java」で終わることができます。
22.1272 -.TP
22.1273 -テストファイル \-
22.1274 -開発者の多くは、あるパッケージのコンパイル可能で実行可能な
22.1275 -テストファイルをそのパッケージのソースファイルと同じ
22.1276 -ディレクトリに配置したいと考えています。
22.1277 -しかしテストファイルは、名前なしパッケージなど、
22.1278 -ソースファイルパッケージとは別のパッケージに属させたいとも
22.1279 -考えています (そのため、テストファイルには package ステートメントがないか、
22.1280 -またはソースとは別の package ステートメントがあります)。
22.1281 -このような状況では、コマンド行で指定されているソースのパッケージ名を指定して
22.1282 -そのソースがドキュメント化されているときに、
22.1283 -テストファイルは警告またはエラーを引き起こします。
22.1284 -そのようなテストファイルはサブディレクトリに配置する必要があります。
22.1285 -たとえばソースファイルのテストファイルを
22.1286 -.B com.package1
22.1287 -に追加する場合は、それらのテストファイルを、ハイフンが含まれるため
22.1288 -パッケージ名としては無効になる
22.1289 -サブディレクトリに配置します。
22.1290 -.LP
22.1291 -.RS 5
22.1292 -com/package1/test-files/
22.1293 +
22.1294 +.LP
22.1295 +.SS
22.1296 +鴻<ゃ潟潟若<ゃ
22.1297 +.LP
22.1298 +.LP
22.1299 +筝肴鴻<ゃ潟潟若<ゃ絲上純若鴻<ゃ菴純若鴻若篆絖荀障ゃ障純若鴻<ゃc障泣c篆絖с
22.1300 +.LP
22.1301 +.LP
22.1302 +ャ純若鴻<ゃф腓榊羝< Javadoc 若絎茵翫鴻<ゃ潟潟若<ゃ括ゅс障宴若後障ゃ若ф検翫篁ヤ若緇c鴻<ゃ潟潟若<ゃ綽荀障
22.1303 +.LP
22.1304 +.LP
22.1305 +鴻<ゃ潟若<ゃ鴻<ゃ罩eс潟潟ゃ純純若鴻<ゃс絲障潟若<ゃс鴻с 潟若<ゃ.javaхс障
22.1306 +.LP
22.1307 +.LP
22.1308 +\f3鴻<ゃ\fP \- 肴紊宴若吾潟潟ゃ純у茵純鴻<ゃ宴若吾純若鴻<ゃc臀障鴻<ゃ宴若吾純若鴻<ゃ宴若吾ャ宴若吾絮障 (鴻<ゃ package 鴻若<潟障純若鴻ャ package 鴻若<潟)倶с潟潟茵ф絎純若鴻宴若後絎純若鴻ャ<潟鴻<ゃ茘障若綣莎激障鴻<ゃ泣c臀綽荀障\f2com.package1\fP 菴遵翫鴻<ゃゃ潟障宴若後≦鴻泣c臀障
22.1309 +.LP
22.1310 +.nf
22.1311 +\f3
22.1312 +.fl
22.1313 + com/package1/test\-files/
22.1314 +.fl
22.1315 +\fP
22.1316 +.fi
22.1317 +
22.1318 +.LP
22.1319 +.LP
22.1320 +Javadoc 若с茘 test c鴻障
22.1321 +.LP
22.1322 +.LP
22.1323 +鴻<ゃ doc 潟<潟障翫罨<ゃ若鴻純若鴻<ゃф検鴻<ゃャ<潟Javadoc 若ュ絎茵с荐絎с障 違\f2com/package1/test\-files/*.java\fP с
22.1324 +.LP
22.1325 +.LP
22.1326 +\f3純若鴻<ゃ潟若\fP \- 潟若<ゃ.javaх障潟若<ゃ潟潟ゃс障純若鴻c篆純若鴻<ゃ潟若翫<ゃゃ (\f2Buffer\-Template.java\fP ) 篁筝罩c Java 絖篏睡障 с障Javadoc 若.java・絨乗ゃ 罩h劫с純若鴻<ゃсс (
22.1327 +.na
22.1328 +\f2茘ュ\fP @
22.1329 +.fi
22.1330 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
22.1331 +.LP
22.1332 +.SH "<ゃ"
22.1333 +.LP
22.1334 +.LP
22.1335 +сjavadoc 若HTML 綵√ャ<潟罔羣篏帥障篁ヤ腮蕁<ゃ障 HTML 若吾<ゃ後障javadoc <ゃ鴻ゃ潟帥с若鴻<с (\f2package\-summary.html\fP ) 2 腮蕁障緇違若<ゃ違若<ゃ腴九ゃ潟障障
22.1336 +.LP
22.1337 +.LP
22.1338 +\f3堺絎鴻若\fP
22.1339 +.LP
22.1340 +.RS 3
22.1341 +.TP 2
22.1342 +o
22.1343 +ャ<潟鴻障ゃ潟帥с若鴻 1 ゃ\f3鴻若吾障ゃ潟帥с若鴻若\fP (\f2劫\fP\f2.html\fP)
22.1344 +.TP 2
22.1345 +o
22.1346 +ャ<潟宴若吾 1 ゃ\f3宴若吾若\fP (\f2package\-summary.html\fP)Javadoc 若純若鴻若宴若吾c \f2package.html\fP 障 \f2package\-info.java\fP <ゃ違筝 HTML 鴻若吾腟水ャ障
22.1347 +.TP 2
22.1348 +o
22.1349 +宴若吾祉篏絲障 1 ゃ\f3网荀若\fP (\f2overview\-summary.html\fP)ャ<潟若吾障Javadoc 若\f2\-overview\fP 激с潟ф絎<ゃ HTML 鴻若吾腟水ャ障若吾<ゃjavadoc 茲違宴若後羝<翫篏障荅括完HTML 若с
22.1350 .RE
22.1351 -.LP
22.1352 -こうすると、
22.1353 -.B Javadoc
22.1354 -ツールでは警告なしで
22.1355 -test ディレクトリをスキップします。
22.1356 -.LP
22.1357 -テストファイルに doc コメントが含まれる場合、
22.1358 -次のようにワイルドカードを含んだテストソースファイル名で渡して
22.1359 -テストファイルのドキュメントを生成するように、
22.1360 -.B Javadoc
22.1361 -ツールを別個に実行できるように設定できます。
22.1362 -\f2com/package1/test\-files/*.java\fP.
22.1363 -.TP
22.1364 -ソースファイルのテンプレート\-
22.1365 -テンプレートファイルの名前は「.java」で終わることもありますが、
22.1366 -テンプレートファイルはコンパイルできません。
22.1367 -ソースディレクトリに保持したいソースファイルの
22.1368 -テンプレートがある場合は、
22.1369 -このファイル名にハイフン (Buffer-Template.java など) や
22.1370 -その他の不正な Java 文字を使用します。
22.1371 -こうすることで、処理されないようになります。
22.1372 -これは、
22.1373 -.B Javadoc
22.1374 -ツールが処理するのは、「.java」接尾辞を除いた名前が
22.1375 -正規のクラス名であるソースファイルだけであるためです (「識別子」http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625 参照)。
22.1376 -.SS "生成されるファイル"
22.1377 -デフォルトでは、
22.1378 -.B javadoc
22.1379 -は、HTML 形式のドキュメントを生成する標準ドックレットを
22.1380 -使います。
22.1381 -このドックレットは、以下の種類のファイルを生成します。以下の
22.1382 -各 HTML「ページ」は、それぞれ別のファイルに対応します。
22.1383 -.B javadoc
22.1384 -が生成するファイルの名前には、クラスやインタフェースの名前に
22.1385 -ちなんだものと、そうでないもの (\f3package-summary.html\f1 など)
22.1386 -の 2 種類があります。後者のグループには、前者のグループの名前と
22.1387 -ファイル名が競合しないように、ハイフンが含まれています。
22.1388 -.SS "基本内容ページ"
22.1389 +
22.1390 +.LP
22.1391 +.LP
22.1392 +\f3娯с若\fP
22.1393 +.LP
22.1394 +.RS 3
22.1395 .TP 2
22.1396 -\(bu
22.1397 -ドキュメント化する各クラスまたは各インタフェースに対し、1 つのクラス
22.1398 -ページまたはインタフェースページ (\f3classname.html\f1)
22.1399 +o
22.1400 +\f3宴若吾祉篏絲障 1 ゃ拷絮ゃ若\fP (\f2overview\-tree.html\fP)若吾茵腓冴蚊若激с潟若 [网荀] [絮ゃ] 障
22.1401 .TP 2
22.1402 -\(bu
22.1403 -ドキュメント化する各パッケージに対し、1 つのパッケージ
22.1404 -ページ (\f3package-summary.html\f1)。
22.1405 -.B javadoc
22.1406 -ツールによって、ソースツリーのパッケージディレクトリ内の
22.1407 -.B package.html
22.1408 -または
22.1409 -package\-info.java
22.1410 -というファイル内のすべての HTML テキストが含められる
22.1411 +o
22.1412 +\f3宴若吾 1 ゃ拷絮ゃ若\fP (\f2package\-tree.html\fP) 劫宴若吾鴻障ゃ潟帥с若鴻若吾茵腓冴[絮ゃ] 宴若吾拷絮ゃ茵腓冴障
22.1413 .TP 2
22.1414 -\(bu
22.1415 -パッケージのセット全体に対して 1 つの概要
22.1416 -ページ (\f3overview-summary.html\f1)。これは、生成される
22.1417 -ドキュメントの先頭ページになる。
22.1418 -.B javadoc
22.1419 -ツールによって、
22.1420 -.B -overview
22.1421 -オプションで指定されたファイル内のすべての HTML テキストが含められる。
22.1422 -このファイルが作成されるのは、
22.1423 -.B javadoc
22.1424 -に 2 つ以上のパッケージ名を渡した
22.1425 -場合だけであることに注意する。詳細は、以下の「HTML フレーム」節を参照
22.1426 -.SS "相互参照ページ"
22.1427 +o
22.1428 +\f3宴若吾 1 ゃ [篏睡] 若\fP (\f2package\-use.html\fP)\f3鴻潟ゃ潟帥с若鴻 1 ゃゃ [篏睡] 若\fP (\f2class\-use/\fP\f2劫\fP\f2.html\fP)若吾劫鴻ゃ潟帥с若鴻障宴若吾筝篏帥c宴若吾鴻<純潟潟鴻帥潟c若ゃ荐菴違障鴻障ゃ潟帥с若 A 箴 [篏睡] 若吾A 泣鴻A 絎hc若A 菴<純A <若帥ゃ<純潟潟潟鴻帥茵腓冴障 若吾茵腓冴障宴若吾鴻障ゃ潟帥с若鴻若吾腱糸蚊若激с潟若 [篏睡] 潟障
22.1429 .TP 2
22.1430 -\(bu
22.1431 -パッケージのセット全体に対して 1 つのクラス階層ページ
22.1432 -(\f3overview-tree.html\f1)。これを表示するには、ナビゲーション
22.1433 -バーの [概要] をクリックしてから、[階層ツリー] をクリックする
22.1434 +o
22.1435 +\f3ィ絅 API 若\fP (\f2deprecated\-list.html\fP) ィ絅鴻筝荀ц;腓冴障ィ絅筝壕 API 絖篏睡ィ絅 API с絽吾臀腓冴障ィ絅 API 絨ャ絎茖сゃ醇с障
22.1436 .TP 2
22.1437 -\(bu
22.1438 -各パッケージに対して 1 つのクラス階層
22.1439 -ページ (\f3package-tree.html\f1)。
22.1440 -特定のパッケージページ、クラスページ、またはインタフェースページを
22.1441 -表示し、[階層ツリー] をクリックすると、そのパッケージの階層が
22.1442 -表示される
22.1443 +o
22.1444 +\f3絎違c若ゃ若\fP (\f2constant\-values.html\fP) static c若ょс
22.1445 .TP 2
22.1446 -\(bu
22.1447 -各パッケージに対して 1 つの [使用]
22.1448 -ページ (\f3package-use.html\f1)と、
22.1449 -各クラスおよびインタフェースに対して別に 1 つの [使用]
22.1450 -ページ(\f3class-use/classname.html\f1)。このページは、特定のクラス、
22.1451 -インタフェース、またはパッケージのなんらかの部分を使っている
22.1452 -パッケージ、クラス、メソッド、コンストラクタ、およびフィールドを
22.1453 -記述する。クラスまたはインタフェース A について考えると、
22.1454 -その[使用] ページには、A のサブクラス、A として宣言された
22.1455 -フィールド、A を返すメソッド、A 型のパラメータを持つメソッド
22.1456 -およびコンストラクタが表示される。このページには、パッケージ、
22.1457 -クラス、またはインタフェースに移動してから、ナビゲーションバー
22.1458 -の [使用] リンクをクリックすることによってアクセスできる
22.1459 +o
22.1460 +\f3翫若若\fP (\f2serialized\-form.html\fP) 翫喝純鴻с鴻翫c若潟<純≪茯障宴API 篏帥肴с絎茖茵肴綽荀宴с蚊若激с潟若若吾吾潟障翫鴻腱糸鴻茯 [∫i] 祉激с潟 [翫綵√] 宴緇с障罔羣翫綵√若吾障Serializable 絎茖 public 障 public 鴻腟粋昭障\f2readObject\fP <純\f2writeObject\fP <純翫c若 \f2@serial\fP 帥違\f2@serialField\fP 帥違\f2@serialData\fP 帥違ャ<潟若激с潟潟<潟腟粋昭障障翫純 public 鴻ゅ鴻障鴻絮宴若吾 \f2@serial exclude\fP 帥違ф絎障 翫純 package private 鴻鴻障鴻絮宴若吾 \f2@serial include\fP 帥違ф絎障若吾с 1.4 с\f2\-private\fP 激с潟絎 javadoc 若絎茵public 鴻 private 鴻絎翫鴻с障
22.1461 .TP 2
22.1462 -\(bu
22.1463 -非推奨 API ページ (\f3deprecated-list.html\f1)。推奨されない
22.1464 -名前すべての一覧が含まれている (非推奨名は、通常は改良された API が
22.1465 -存在するために使用が推奨されていない API の名前で、たいていはそれに
22.1466 -置き換わる名前が提示されている。非推奨 API は、将来の実装では
22.1467 -削除される可能性がある)
22.1468 +o
22.1469 +\f3膣√\fP (\f2index\-*.html\fP) 鴻劫ゃ潟帥с若劫潟潟鴻水c若潟<純≪<筝с障膣√Unicode 宴初障 1 ゃ<ゃ絖 (沿翫 A Z) ャ<ゃс障
22.1470 +.RE
22.1471 +
22.1472 +.LP
22.1473 +.LP
22.1474 +\f3泣若<ゃ\fP
22.1475 +.LP
22.1476 +.RS 3
22.1477 .TP 2
22.1478 -\(bu
22.1479 -定数フィールド値ページ (\f3constant-values.html\f1) 。
22.1480 -static フィールドの値が表示される。
22.1481 +o
22.1482 +\f3若\fP (\f2help\-doc.html\fP) 蚊若激с潟若菴違若吾≪茯荐莠障\f2\-helpfile\fP 篏帥<ゃ篁c鴻帥<ゃ箴с障
22.1483 .TP 2
22.1484 -\(bu
22.1485 -直列化形式ページ (\f3serialized-form.html\f1)。直列化可能クラス
22.1486 -および外部化可能クラスの情報用。これらの各クラスには、直列化
22.1487 -フィールドおよびメソッドに関する説明がある。これらの情報は、API を
22.1488 -使う開発者ではなく、再実装者に必要な情報である。ナビゲーションバーに
22.1489 -リンクがない場合、任意の直列化されたクラスに移動して、
22.1490 -クラスの [関連項目] セクション内の [直列化された形式] をクリック
22.1491 -するとこの情報を取得できる
22.1492 -標準ドックレットは、直列化された形式のページを自動的に生成する。
22.1493 -ここには、Serializable を実装する public または非 public の
22.1494 -クラスが組み込まれており、さらに、
22.1495 -.B readObject
22.1496 -メソッド、
22.1497 -.B writeObject
22.1498 -メソッド、直列化されたフィールド、
22.1499 -および @serial タグ、@serialField タグ、@serialData タグからの
22.1500 -ドキュメンテーションコメントが組み込まれている。
22.1501 -直列化が可能な public クラスを除外するには、
22.1502 -そのクラスまたはそのクラスが属するパッケージを @serial exclude タグで
22.1503 -指定する。直列化が可能な package private クラスを含めるには、
22.1504 -そのクラスまたはそのクラスが属するパッケージを @serial include タグで
22.1505 -指定する。 1.4 では、
22.1506 -\-private
22.1507 -オプションを指定せずに javadoc を実行することで、public クラスおよび
22.1508 -private クラスに完全な直列化形式を生成することができる。
22.1509 +o
22.1510 +茵腓榊 HTML 若篏 1 ゃ \f3index.html <ゃ\fP<ゃ若篁若吾茵腓冴翫若障<ゃ篏鴻絎鴻障障
22.1511 .TP 2
22.1512 -\(bu
22.1513 -索引 (\f3index-*.html\f1)。すべてのクラス名、
22.1514 -インタフェース名、コンストラクタ名、フィールド名、およびメソッド名を
22.1515 -アルファベット順に並べてある。索引は、Unicode を扱えるように
22.1516 -国際化されており、1 つのファイルとして生成するか、または先頭
22.1517 -文字 (英語の場合 A から Z) ごとに別のファイルとして生成できる
22.1518 -.SS "サポートファイル"
22.1519 +o
22.1520 +茲違\f3若<ゃ\fP (\f2*\-frame.html\fP) 宴若吾鴻潟ゃ潟帥с若鴻鴻障障 HTML 若茵腓冴篏睡障
22.1521 .TP 2
22.1522 -\(bu
22.1523 -ヘルプページ (\f3help-doc.html\f1)。ナビゲーションバーおよび
22.1524 -上記のページについて説明する。
22.1525 -.BR \-helpfile
22.1526 -を使って、デフォルトの
22.1527 -ヘルプファイルに置き換わる独自のカスタムヘルプファイルを提供する
22.1528 -こともできる
22.1529 +o
22.1530 +\f3宴若吾鴻\fP<ゃ (\f2package\-list\fP) \f2\-link\fP 激с潟 \f2\-linkoffline\fP 激с潟т戎障HTML <ゃс鴻<ゃс潟≪祉鴻с障
22.1531 .TP 2
22.1532 -\(bu
22.1533 -1 つの
22.1534 -.B index.html
22.1535 -ファイル。表示用 の HTML フレームを作成する。このファイルは、
22.1536 -フレーム付きの最初のページを表示する場合にロードする。このファイル
22.1537 -自体は、テキスト内容を含まない
22.1538 +o
22.1539 +\f3鴻帥ゃ激若\fP<ゃ (\f2stylesheet.css\fP) 若娯ゃ荀膣ゃ蚊潟<潟泣ゃ冴潟鴻帥ゃ渇臀九勝障
22.1540 .TP 2
22.1541 -\(bu
22.1542 -複数のフレームファイル (\f3*-frame.html\f1)。パッケージ、クラス、
22.1543 -およびインタフェースの一覧を含む。HTML フレームを表示するときに
22.1544 -使われる
22.1545 +o
22.1546 +\f3doc\-files\fP c c潟若ゃ<若吾泣潟潟若純若鴻潟若<ゃ鴻主障<ゃJavadoc 若c<ゃ javadoc 帥違c∴障c純若鴻若筝翫睡障
22.1547 +.RE
22.1548 +
22.1549 +.LP
22.1550 +.LP
22.1551 +\f3HTML 若\fP
22.1552 +.LP
22.1553 +.LP
22.1554 +Javadoc 若筝潟腓冴2 3 ゃ HTML 若障1 ゃ宴若吾翫 (障宴若吾翫) 宴若吾筝荀сャc篏綽荀違若篏障筝宴若吾絮純若鴻<ゃ (*.java) 障筝宴若後綣違 javadoc 潟潟羝<翫綏眼鴻筝荀с茵腓冴若 (C) 1 ゃ篏障Javadoc 茲違宴若後羝<翫网荀若 (Detail) 鴻宴若吾筝荀ц;腓冴膃 3 若 (P) 篏障网荀若吾<ゃ\f2overview\-summary.html\fP сc<ゃ2 や札筝宴若後羝<翫篏障[若] 潟overview\-summary.html 茵腓冴若ャс障
22.1555 +.LP
22.1556 +.LP
22.1557 +HTML 若c翫劫若医激潟鴻若若若鴻違羈若若鴻筝若障紊吟с√違若若吾若篏帥c若鴻若[医] <ャ若潟潟篏帥c若医激с障
22.1558 +.LP
22.1559 +.nf
22.1560 +\f3
22.1561 +.fl
22.1562 + \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
22.1563 +.fl
22.1564 + |C| Detail | |P| Detail |
22.1565 +.fl
22.1566 + | | | | | |
22.1567 +.fl
22.1568 + | | | |\-| |
22.1569 +.fl
22.1570 + | | | |C| |
22.1571 +.fl
22.1572 + | | | | | |
22.1573 +.fl
22.1574 + | | | | | |
22.1575 +.fl
22.1576 + \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
22.1577 +.fl
22.1578 + javadoc *.java javadoc java.lang java.awt
22.1579 +.fl
22.1580 +\fP
22.1581 +.fi
22.1582 +
22.1583 +.LP
22.1584 +.LP
22.1585 +HTML 若綽荀c罨<<<ゃ紮若吾若障
22.1586 +.LP
22.1587 +.RS 3
22.1588 .TP 2
22.1589 -\(bu
22.1590 -パッケージリストファイル (\f3package-list\f1)。
22.1591 -.B \-link
22.1592 -オプションおよび
22.1593 -.B \-linkoffline
22.1594 -オプションで使われる。これは、HTML ファイルではなくテキストファイル
22.1595 -のため、リンクではアクセスできない
22.1596 +o
22.1597 +\f2index.html\fP (若)
22.1598 .TP 2
22.1599 -\(bu
22.1600 -スタイルシートファイル (\f3stylesheet.css\f1)。生成されるページ上に
22.1601 -表示される限られた色数、フォントファミリ、フォントサイズ、フォントの
22.1602 -スタイルおよび配置を制御する
22.1603 -.TP 2
22.1604 -\(bu
22.1605 -コピー先ディレクトリにコピーしたいファイル (イメージ、サンプル、
22.1606 -ソースファイルなど) が入っている doc ファイルのディレクトリ。
22.1607 -.B javadoc
22.1608 -ツールはこのようなファイルを処理しない。つまり、このようなファイル内の
22.1609 -.B javadoc
22.1610 -タグはすべて無視される。ソースツリーに存在しない限り、この
22.1611 -ディレクトリは生成されない
22.1612 -.SS "HTML フレーム"
22.1613 -.B javadoc
22.1614 -ツールは、下の図に示すように、2 つか 3 つの HTML フレームを生成します。
22.1615 -1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。
22.1616 -ソースファイル (*\f3.java\f1) または単一のパッケージ名を引数として
22.1617 -.B javadoc
22.1618 -コマンドに渡す場合は、左側の列にクラスの一覧を表示する
22.1619 -フレーム (C) 1 つだけが作成されます。
22.1620 -.B javadoc
22.1621 -に複数のパッケージ名を渡す場合は、概要ページ (Detail) に加えて、
22.1622 -すべてのパッケージの一覧を表示する第 3 のフレーム (P) が
22.1623 -作成されます。この概要ページのファイル名は
22.1624 -.BR overview-summary.html
22.1625 -です。したがって、このファイルが作成されるのは、2 つ以上のパッケージ
22.1626 -名を渡した場合だけです。[フレームなし] リンクをクリックするか、
22.1627 -.BR overview-summary.html
22.1628 -から表示するようにすると、フレームを省略できます。
22.1629 -.LP
22.1630 -HTML フレームに慣れていない場合は、フレームには、印刷および
22.1631 -スクロール用の「フォーカス」が必要であることに注意する
22.1632 -必要があります。フレームにフォーカスを与えるには、そのフレームを
22.1633 -クリックします。すると、多くのブラウザでは、矢印キーおよびページキー
22.1634 -を使ってそのフレームをスクロールしたり、[印刷] メニュー
22.1635 -コマンドを使ってそのフレームを印刷したりできるようになります。
22.1636 -.LP
22.1637 -.ft 3
22.1638 -.nf
22.1639 - ------------ ------------
22.1640 - |C| Detail | |P| Detail |
22.1641 - | | | | | |
22.1642 - | | | |-| |
22.1643 - | | | |C| |
22.1644 - | | | | | |
22.1645 - | | | | | |
22.1646 - ------------ ------------
22.1647 - javadoc *.java javadoc java.lang java.awt
22.1648 -.fi
22.1649 -.ft 1
22.1650 -.LP
22.1651 -HTML フレームが必要かどうかによって、次のどちらかのファイルを
22.1652 -開始ページとしてロードします。
22.1653 -.LP
22.1654 -.TP 2
22.1655 -\(bu
22.1656 -.B index.html
22.1657 -(フレームあり)
22.1658 -.TP 2
22.1659 -\(bu
22.1660 -.B overview-summary.html
22.1661 -(フレームなし)
22.1662 -.SS "生成されるファイル構造"
22.1663 -生成されるクラスファイルおよびインタフェースファイルは、Java ソース
22.1664 -ファイルおよびクラスファイルと同じディレクトリ階層で組織
22.1665 -されます。この構造は、1 つのサブパッケージにつき 1 つのディレクトリ
22.1666 -で構成されます。
22.1667 -.LP
22.1668 -たとえば、
22.1669 -.B java.applet.Applet
22.1670 -クラスに対して生成されるドキュメントは、
22.1671 -.BR java/applet/Applet.html
22.1672 -に格納されます。生成先のディレクトリの名前が apidocs だと
22.1673 -すると、java.applet パッケージのファイル構造もこれに従います。
22.1674 -前述したように、「frame」という語を名前に含むファイルは、
22.1675 -すべて左上または左下のフレームに表示されます。それ
22.1676 -以外の HTML ファイルは、すべて右側のフレームに表示されます。
22.1677 -.LP
22.1678 -注: ディレクトリは、太字 (bold) で示してあります。
22.1679 -アスタリスク (*) は、
22.1680 -.B javadoc
22.1681 -への引数がパッケージ名でなくソースファイル名 (*\f3.java\f1) の
22.1682 -ときに、省略されるファイルおよびディレクトリを示しています。また、
22.1683 -引数がソースファイル名のときには、
22.1684 -.B package-list
22.1685 -は作成されますが、空です。
22.1686 -.B doc-files
22.1687 -ディレクトリは、ソースツリー内に存在しない限り、生成先に表示されません。
22.1688 +o
22.1689 +\f2overview\-summary.html\fP (若)
22.1690 +.RE
22.1691 +
22.1692 +.LP
22.1693 +.LP
22.1694 +\f3<ゃ罕\fP
22.1695 +.LP
22.1696 +.LP
22.1697 +鴻<ゃ潟ゃ潟帥с若鴻<ゃJava 純若鴻<ゃ潟鴻<ゃc絮ゃ膩障1 ゃ泣宴若吾ゃ 1 ゃc罕障
22.1698 +.LP
22.1699 +.LP
22.1700 +違\f2java.applet.Applet\fP 鴻絲障ャ<潟\f2java/applet/Applet.html\fP 主障c \f2apidocs\fP java.applet 宴若吾<ゃ罕筝罕膀障菴違frame茯<ゃ鴻綏筝障綏筝若茵腓冴障篁ュ HTML <ゃ鴻勀眼若茵腓冴障
22.1701 +.LP
22.1702 +.RS 3
22.1703 +
22.1704 +.LP
22.1705 +.LP
22.1706 +羈 \- 筝絮ゅ潟сc\f3紊絖\fP (\f3bold\fP) хず障≪鴻帥鴻 (\f2*\fP) javadoc 吾綣違宴若後с純若鴻<ゃ (*.java) с翫ャ<ゃ潟c腓冴障障綣違純若鴻<ゃ翫\f2package\-list\fP 篏障絎鴻腥冴сdoc\-files c純若鴻弱絖翫帥篏障
22.1707 .LP
22.1708 .RE
22.1709 .nf
22.1710 @@ -934,90 +846,90 @@
22.1711 .fl
22.1712
22.1713 .fl
22.1714 -\fP\f3apidocs\fP 最上位ディレクトリ
22.1715 -.fl
22.1716 - index.html HTML フレームを設定する初期ページ
22.1717 -.fl
22.1718 - * overview\-summary.html 全パッケージのリスト。先頭に要約文がある
22.1719 -.fl
22.1720 - overview\-tree.html 全パッケージのクラス階層のリスト
22.1721 -.fl
22.1722 - deprecated\-list.html 全パッケージの推奨されない API のリスト
22.1723 -.fl
22.1724 - constant\-values.html 全パッケージの static フィールドの値のリスト
22.1725 -.fl
22.1726 - serialized\-form.html 全パッケージの直列化された形式のリスト
22.1727 -.fl
22.1728 - * overview\-frame.html 全パッケージのリスト。左上のフレームに表示される
22.1729 -.fl
22.1730 - allclasses\-frame.html 全パッケージの全クラスのリスト。左下のフレームに表示される
22.1731 -.fl
22.1732 - help\-doc.html これらのページの構成を示すユーザヘルプを表示する
22.1733 -.fl
22.1734 - index\-all.html \-splitindex オプションなしで作成されたデフォルト索引
22.1735 -.fl
22.1736 - \f3index\-files\fP \-splitindex オプションを指定して作成されたディレクトリ
22.1737 -.fl
22.1738 - index\-<number>.html \-splitindex オプションを指定して作成された索引ファイル
22.1739 -.fl
22.1740 - package\-list パッケージ名のリスト。外部参照を解決するためだけに使用される
22.1741 -.fl
22.1742 - stylesheet.css フォント、色、配置を定義する HTML スタイルシート
22.1743 -.fl
22.1744 - \f3java\fP パッケージディレクトリ
22.1745 -.fl
22.1746 - \f3applet\fP サブパッケージディレクトリ
22.1747 -.fl
22.1748 - Applet.html Applet クラスのページ
22.1749 -.fl
22.1750 - AppletContext.html AppletContext インタフェースのページ
22.1751 -.fl
22.1752 - AppletStub.html AppletStub インタフェースのページ
22.1753 -.fl
22.1754 - AudioClip.html AudioClip インタフェースのページ
22.1755 -.fl
22.1756 - * package\-summary.html このパッケージのクラスのリスト。先頭に要約文がある
22.1757 -.fl
22.1758 - * package\-frame.html このパッケージのクラスのリスト。左下のフレームに表示される
22.1759 -.fl
22.1760 - * package\-tree.html このパッケージのクラス階層のリスト
22.1761 -.fl
22.1762 - package\-use このパッケージが使用されている場所のリスト
22.1763 -.fl
22.1764 - \f3doc\-files\fP イメージやサンプルのファイルが格納されるディレクトリ
22.1765 -.fl
22.1766 - \f3class\-use\fP API が使用されている場所のページを格納するディレクトリ
22.1767 -.fl
22.1768 - Applet.html Applet クラスを使用するページ
22.1769 -.fl
22.1770 - AppletContext.html AppletContext インタフェースを使用するページ
22.1771 -.fl
22.1772 - AppletStub.html AppletStub インタフェースを使用するページ
22.1773 -.fl
22.1774 - AudioClip.html AudioClip インタフェースを使用するページ
22.1775 -.fl
22.1776 - \f3src\-html\fP ソースコードディレクトリ
22.1777 -.fl
22.1778 - \f3java\fP パッケージディレクトリ
22.1779 -.fl
22.1780 - \f3applet\fP サブパッケージディレクトリ
22.1781 -.fl
22.1782 - Applet.html Applet ソースコードのページ
22.1783 -.fl
22.1784 - AppletContext.html AppletContext ソースコードのページ
22.1785 -.fl
22.1786 - AppletStub.html AppletStub ソースコードのページ
22.1787 -.fl
22.1788 - AudioClip.html AudioClip ソースコードのページ
22.1789 +\fP\f3apidocs\fP 筝篏c
22.1790 +.fl
22.1791 + index.html HTML 若荐絎若
22.1792 +.fl
22.1793 + * overview\-summary.html 宴若吾鴻 荀膣
22.1794 +.fl
22.1795 + overview\-tree.html 宴若吾拷絮ゃ鴻
22.1796 +.fl
22.1797 + deprecated\-list.html 宴若吾ィ絅 API 鴻
22.1798 +.fl
22.1799 + constant\-values.html 宴若吾 static c若ゃ鴻
22.1800 +.fl
22.1801 + serialized\-form.html 宴若吾翫綵√鴻
22.1802 +.fl
22.1803 + * overview\-frame.html 宴若吾鴻 綏筝若茵腓冴
22.1804 +.fl
22.1805 + allclasses\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
22.1806 +.fl
22.1807 + help\-doc.html 若吾罕腓冴若吟若茵腓冴
22.1808 +.fl
22.1809 + index\-all.html \-splitindex 激с潟т膣√
22.1810 +.fl
22.1811 + \f3index\-files\fP \-splitindex 激с潟絎篏c
22.1812 +.fl
22.1813 + index\-<number>.html \-splitindex 激с潟絎篏膣√<ゃ
22.1814 +.fl
22.1815 + package\-list 宴若後鴻 紊с茹f浦篏睡
22.1816 +.fl
22.1817 + stylesheet.css 潟蚊臀絎臂 HTML 鴻帥ゃ激若
22.1818 +.fl
22.1819 + \f3java\fP 宴若吾c
22.1820 +.fl
22.1821 + \f3applet\fP 泣宴若吾c
22.1822 +.fl
22.1823 + Applet.html Applet 鴻若
22.1824 +.fl
22.1825 + AppletContext.html AppletContext ゃ潟帥с若鴻若
22.1826 +.fl
22.1827 + AppletStub.html AppletStub ゃ潟帥с若鴻若
22.1828 +.fl
22.1829 + AudioClip.html AudioClip ゃ潟帥с若鴻若
22.1830 +.fl
22.1831 + * package\-summary.html 宴若吾鴻鴻 荀膣
22.1832 +.fl
22.1833 + * package\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
22.1834 +.fl
22.1835 + * package\-tree.html 宴若吾拷絮ゃ鴻
22.1836 +.fl
22.1837 + package\-use 宴若吾篏睡贋鴻
22.1838 +.fl
22.1839 + \f3doc\-files\fP ゃ<若吾泣潟<ゃ主c
22.1840 +.fl
22.1841 + \f3class\-use\fP API 篏睡贋若吾主c
22.1842 +.fl
22.1843 + Applet.html Applet 鴻篏睡若
22.1844 +.fl
22.1845 + AppletContext.html AppletContext ゃ潟帥с若鴻篏睡若
22.1846 +.fl
22.1847 + AppletStub.html AppletStub ゃ潟帥с若鴻篏睡若
22.1848 +.fl
22.1849 + AudioClip.html AudioClip ゃ潟帥с若鴻篏睡若
22.1850 +.fl
22.1851 + \f3src\-html\fP 純若鴻潟若c
22.1852 +.fl
22.1853 + \f3java\fP 宴若吾c
22.1854 +.fl
22.1855 + \f3applet\fP 泣宴若吾c
22.1856 +.fl
22.1857 + Applet.html Applet 純若鴻潟若若
22.1858 +.fl
22.1859 + AppletContext.html AppletContext 純若鴻潟若若
22.1860 +.fl
22.1861 + AppletStub.html AppletStub 純若鴻潟若若
22.1862 +.fl
22.1863 + AudioClip.html AudioClip 純若鴻潟若若
22.1864 .fl
22.1865 .fi
22.1866
22.1867 .LP
22.1868 -.SS "生成される API 宣言"
22.1869 -javadoc ツールは、各クラス、インタフェース、フィールド、コンストラクタ、
22.1870 -およびメソッドの説明の初めで宣言を生成します。
22.1871 -この宣言は、その API 項目の宣言です。たとえば、
22.1872 -ブール型クラスの宣言は次のようになります。
22.1873 +.SS
22.1874 + API 絎h
22.1875 +.LP
22.1876 +.LP
22.1877 +Javadoc 若鴻ゃ潟帥с若鴻c若潟潟鴻帥潟<純茯 API 絎h障 絎h API 絎hс違\f2Boolean\fP 鴻絎h罨<障
22.1878 .LP
22.1879 .LP
22.1880 \f2public final class Boolean\fP
22.1881 @@ -1027,145 +939,36 @@
22.1882 \f2implements Serializable\fP
22.1883 .LP
22.1884 .LP
22.1885 -Boolean.valueOf メソッドの宣言は次のようになります。
22.1886 +障\f2Boolean.valueOf\fP <純絎h罨<障
22.1887 .LP
22.1888 .LP
22.1889 \f2public static Boolean valueOf(String s)\fP
22.1890 .LP
22.1891 .LP
22.1892 -javadoc ツールは修飾子
22.1893 -.BR public
22.1894 -、
22.1895 -.BR protected
22.1896 -、
22.1897 -.BR private
22.1898 -、
22.1899 -.BR abstract
22.1900 -、
22.1901 -.BR final
22.1902 -、
22.1903 -.BR static
22.1904 -、
22.1905 -.BR transient
22.1906 -、
22.1907 -および
22.1908 -.BR volatile
22.1909 -を組み込むことができますが、
22.1910 -.BR synchronized
22.1911 -と
22.1912 -.BR native
22.1913 -は組み込むことができません。
22.1914 -.BR synchronized
22.1915 -と
22.1916 -.BR native
22.1917 -修飾子は実装の詳細と見なされ、API 仕様の一部とは見なされません。
22.1918 -.LP
22.1919 -キーワード
22.1920 -.BR synchronized
22.1921 -に依存するよりも、「複数のスレッドによって単一の
22.1922 -.BR Enumeration
22.1923 -を並行して使用してはならない」というように、並行処理のセマンティックスを
22.1924 -コメント説明の中でドキュメント化するべきです。ドキュメントでは、
22.1925 -これらのセマンティックスの達成方法を説明すべきではありません。別の
22.1926 -例を挙げると、
22.1927 -.BR Hashtable
22.1928 -はスレッドに対して安全でなければなりませんが、エクスポートされるその
22.1929 -メソッドすべてを同期させることによってこれを実現すると明記する必要
22.1930 -はないということです。バケットレベルで内部的に同期をとる権限を留保して、
22.1931 -より高度な並行性を提供すべきです。
22.1932 -.LP
22.1933 -.SH "ドキュメンテーションコメント"
22.1934 -.LP
22.1935 -.LP
22.1936 -オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。
22.1937 -.LP
22.1938 -.SS
22.1939 -ソースコードへのコメントの挿入
22.1940 -.LP
22.1941 -.LP
22.1942 -ソースコードの任意の宣言 (クラス、インタフェース、メソッド、コンストラクタ、
22.1943 -またはフィールド) の前に、ドキュメンテーションコメント (doc コメント)
22.1944 -を記述することができます。 各パッケージにドキュメンテーションコメントを
22.1945 -作成でき、構文は若干異なりますが、概要にもドキュメンテーションコメントを
22.1946 -作成できます。 ドキュメンテーションコメントは、Javadoc コメントとも呼ばれます。
22.1947 -ドキュメンテーションコメントは、コメントの始まりを示す文字列
22.1948 -.B /**
22.1949 - と、コメントの終わりを示す文字列
22.1950 -.B */
22.1951 -の間にある文字で構成されます。 行頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。 Linux ではテキストは、複数行にわたって記述できます。
22.1952 -.LP
22.1953 -.RS
22.1954 -.ft 3
22.1955 -.nf
22.1956 -/**
22.1957 -* This is the typical format of a simple documentation comment
22.1958 -* that spans two lines.
22.1959 -*/
22.1960 -.fi
22.1961 -.ft 1
22.1962 -.RE
22.1963 -.LP
22.1964 -次のように、コメントは 1 行にまとめることもできます。
22.1965 -.LP
22.1966 -.RS
22.1967 -.ft 3
22.1968 -.nf
22.1969 -/** This comment takes up only one line. */
22.1970 -.fi
22.1971 -.ft 1
22.1972 -.RE
22.1973 -.LP
22.1974 -コメントの配置 - ドキュメンテーションコメントが認識されるのは、クラス、
22.1975 -インタフェース、コンストラクタ、メソッド、またはフィールド
22.1976 -宣言の前に置かれた場合だけです (クラス、メソッド、およびフィールドの
22.1977 -例を参照)。メソッドの本体に置かれたドキュメント
22.1978 -コメントは無視されます。
22.1979 -.B javadoc
22.1980 -ツールは、宣言文ごとに 1 つのドキュメンテーションコメントだけを
22.1981 -認識します。
22.1982 -.LP
22.1983 -よく発生する間違いは、重要な文をクラスコメントとクラス宣言の間に
22.1984 -入れてしまうことです。
22.1985 -.B javadoc
22.1986 -はクラスコメントを無視するため、注意してください。
22.1987 -.LP
22.1988 -.RS
22.1989 -.ft 3
22.1990 -.nf
22.1991 -/**
22.1992 -* This is the class comment for the class Whatever.
22.1993 -*/
22.1994 -
22.1995 -import com.sun; // MISTAKE - Important not to put statements here
22.1996 -
22.1997 -public class Whatever {
22.1998 -}
22.1999 -.fi
22.2000 -.ft 1
22.2001 -.RE
22.2002 -.LP
22.2003 -コメントの説明のあとにタグが続く - コメントの開始区切り文字である
22.2004 -.B /**
22.2005 -のあとからタグセクションまでが説明になります。 タグセクションは、
22.2006 -先頭文字が
22.2007 -.B @
22.2008 -である行から始まります (行の先頭のアスタリスクおよび空白文字
22.2009 -は除く)。 説明を記述せず、コメントだけのタグを記述することもできます。
22.2010 -説明は、タグセクション以降に続けることはできません。
22.2011 -タグの引数は複数の行にまたがって記述できます。 タグの数に
22.2012 -制限はありません。何回も記述できるタグと、1 回しか記述できない
22.2013 -タグがあります。 次の例の
22.2014 -.B @see
22.2015 -からタグセクションが始まります。
22.2016 +Javadoc 若篆蕋上 \f2public\fP\f2protected\fP\f2private\fP\f2abstract\fP\f2final\fP\f2static\fP\f2transient\fP \f2volatile\fP 腟粋昭с障\f2synchronized\fP \f2native\fP 腟粋昭с障緇 2 ゃ篆蕋上絎茖荅括完荀API 篁罕障障
22.2017 +.LP
22.2018 +.LP
22.2019 +API с筝茵с祉潟c鴻ゃ若若 \f2synchronized\fP 箴絖с潟<潟筝肢ャ<潟綽荀障 違1 ゃ \f2Enumeration\fP 茲違鴻筝茵篏睡с潟<潟荐菴違障ャ<潟祉潟c鴻絎憗号荐菴違鴻с障違\f2Hashtable\fP 鴻絲障絎с綽荀障鴻若鴻<純違絎憗с絎号障宴у罔罧鏆荀障 違蕭綺筝茵с箴障
22.2020 +.LP
22.2021 +.SH "ャ<潟若激с潟潟<潟"
22.2022 +.LP
22.2023 +.LP
22.2024 +吾ャ<潟若激с潟潟<潟篁罕∫iс
22.2025 +.LP
22.2026 +.SS
22.2027 +純若鴻潟若吾潟<潟水
22.2028 +.LP
22.2029 +.LP
22.2030 +純若鴻潟若篁紙鴻ゃ潟帥с若鴻<純潟潟鴻帥障c若絎hャ<潟若激с潟潟<潟 ("doc comments") 荐菴違с障宴若吾ャ<潟若激с潟潟<潟篏с障 罕ュ慌違障网荀ャ<潟若激с潟潟<潟篏с障ャ<潟若激с潟潟<潟綣Javadoc 潟<潟若違障 (茯罔∫c篏睡羈)ャ<潟若激с潟潟<潟潟<潟紮障腓冴絖 \f2/**\fP 潟<潟腟腓冴絖 \f2*/\fP 絖ф障茵≪鴻帥鴻茵荐菴違с障 荅括完篁ヤц障潟<潟鴻茲域c荐菴違с障
22.2031 .LP
22.2032 .nf
22.2033 \f3
22.2034 .fl
22.2035 /**
22.2036 .fl
22.2037 - * This sentence would hold the main description for this doc comment.
22.2038 -.fl
22.2039 - * @see java.lang.Object
22.2040 + * This is the typical format of a simple documentation comment
22.2041 +.fl
22.2042 + * that spans two lines.
22.2043 .fl
22.2044 */
22.2045 .fl
22.2046 @@ -1174,4025 +977,4859 @@
22.2047
22.2048 .LP
22.2049 .LP
22.2050 -標準タグとインラインタグ: タグは、javadoc ツールが処理できる、
22.2051 -doc コメント内の特別なキーワードです。javadoc ツールには、@tag として現れる
22.2052 -標準タグと、中括弧内に
22.2053 -.B {\f3@tag\f1}
22.2054 -として現れるインラインタグがあります。解釈
22.2055 -させるためには、先頭のアスタリスク、空白、コメント区切り文字 (/**) を
22.2056 -除いては標準タグが行の先頭であるように配置する必要があります。つ
22.2057 -まり、ユーザはテキスト内の任意の位置で @ 文字を使用でき、
22.2058 -この文字はタグの始めとは解釈されません。@ 文字で行を開
22.2059 -始してこれが解釈されないようにしたい場合は、HTML エンティティの
22.2060 -@ を使用してください。各スタンドアロンタグには関連するテキストがあり
22.2061 -ます。これは、そのタグの後から次のタグの直前まで、または doc コメント
22.2062 -の最後までの任意のテキストです。関連付けられたテキストは、
22.2063 -複数行にまたがって記述できます。
22.2064 -インラインタグは、そのテキストが許
22.2065 -可される位置にはどこでも指定でき、解釈の対象となります。次の例は、
22.2066 -標準タグ
22.2067 -.BR @deprecated
22.2068 -とインラインタグ
22.2069 -.BR {@link}
22.2070 -が含まれています。
22.2071 -.LP
22.2072 -.RS
22.2073 -.ft 3
22.2074 +罨< 1 茵荐菴違鴻若鴻膀膣с障
22.2075 +.LP
22.2076 .nf
22.2077 +\f3
22.2078 +.fl
22.2079 +/** This comment takes up only one line. */
22.2080 +.fl
22.2081 +\fP
22.2082 +.fi
22.2083 +
22.2084 +.LP
22.2085 +.LP
22.2086 +\f3潟<潟臀\fP \- ャ<潟若激с潟潟<潟鴻ゃ潟帥с若鴻潟潟鴻帥<純障c若絎h翫臀茯茘障 鴻箴<純箴潟c若箴с<純篏臀ャ<潟若激с潟潟<潟∴障javadoc 若с1 ゃ絎hゃ 1 ゃャ<潟若激с潟潟<潟茯茘障
22.2087 +.LP
22.2088 +.LP
22.2089 +鴻潟<潟鴻絎h \f2import\fP 臀障с荐菴違с 鴻潟<潟∴障
22.2090 +.LP
22.2091 +.nf
22.2092 +\f3
22.2093 +.fl
22.2094 + /**
22.2095 +.fl
22.2096 + * This is the class comment for the class Whatever.
22.2097 +.fl
22.2098 + */
22.2099 +.fl
22.2100 +
22.2101 +.fl
22.2102 + import com.sun; // MISTAKE \- Important not to put import statement here
22.2103 +.fl
22.2104 +
22.2105 +.fl
22.2106 + public class Whatever {
22.2107 +.fl
22.2108 + }
22.2109 +.fl
22.2110 +\fP
22.2111 +.fi
22.2112 +
22.2113 +.LP
22.2114 +.LP
22.2115 +\f3ャ<潟若激с潟潟<潟筝肢帥違祉激с潟膓\fP \- 潟<潟紮阪絖с \f2/**\fP 帥違祉激с潟障с筝肢障帥違祉激с潟絖 \f2@\fP с茵у臂帥違紮障障 (茵≪鴻帥鴻腥榊純活阪絖 \f2/**\fP ゃ)筝肢荐菴違帥違祉激с潟潟<潟荐菴違с障筝肢帥違祉激с割札膓с障帥違綣違茲域c荐菴違с障帥違違狗障 篏荐菴違с帥違1 荐菴違с帥違障箴違罨< \f2@see\fP 帥違祉激с潟紮障障
22.2116 +.LP
22.2117 +.nf
22.2118 +\f3
22.2119 +.fl
22.2120 /**
22.2121 - * @deprecated As of JDk 1.1, replaced by {@link #setBounds(int,int,int,int)}
22.2122 +.fl
22.2123 + * This sentence would hold the main description for this doc comment.
22.2124 +.fl
22.2125 + * @see java.lang.Object
22.2126 +.fl
22.2127 */
22.2128 +.fl
22.2129 +\fP
22.2130 .fi
22.2131 -.ft 1
22.2132 +
22.2133 +.LP
22.2134 +.LP
22.2135 +\f3帥違ゃ潟ゃ潟帥\fP \- 帥違Javadoc сャ<潟若激с潟潟<潟劫ャ若若с\f2@tag\fP 荐菴違帥 (鴻帥潟≪潟帥違若違) ゃ潟ゃ潟帥 (\f2{@tag}\fP 筝綣су蚊ц菴) 2 腮蕁帥違障帥違罩c頵i茵≪鴻帥鴻腥榊純阪絖 (\f2/**\fP) ゃ茵臀違障鴻篁ュ篏臀 \f2@\fP 絖篏睡帥違紮茹i潟障茵 \f2@\fP 絖篏睡帥違茹iHTML 潟cc若\f2@\fP篏睡帥違絲上篁鴻障 鴻帥違罨<帥違障ャ<潟若激с潟潟<潟緇障с荐菴違鴻 (帥違潟<潟阪絖ゃ) с∫c鴻茲域c荐菴違с障ゃ潟ゃ潟帥違鴻荐菴違с贋с違с臀с罩c頵i障罨<潟若箴帥 \f2@deprecated\fP ゃ潟ゃ潟帥 \f2{@link}\fP 障障
22.2136 +.LP
22.2137 +.nf
22.2138 +\f3
22.2139 +.fl
22.2140 +/**
22.2141 +.fl
22.2142 + * @deprecated As of JDK 1.1, replaced by {@link #setBounds(int,int,int,int)}
22.2143 +.fl
22.2144 + */
22.2145 +.fl
22.2146 +\fP
22.2147 +.fi
22.2148 +
22.2149 +.LP
22.2150 +.LP
22.2151 +\f3潟<潟 HTML ц菴違\fP \- 鴻 HTML 綵√ц菴違違障 HTML 潟cc若篏帥綽荀 HTML 帥違篏睡с潟障荐菴違 HTML 若吾с潟篏睡吟泣若篁紙若吾с潟篏睡с障 罔羣鴻宴若c潟違鴻帥ゃ激若 (CSS) 若鴻 (ャ<潟若激с潟潟<潟篁ュ) HTML 3.2 羣潟若篏障若祉絲上<ゃHTML 4.0荐菴違障
22.2152 +.LP
22.2153 +.LP
22.2154 +違絨 (\f2<\fP) 潟紊с (\f2>\fP) 荐垩\f2<\fP \f2>\fP 荐菴違綽荀障罕≪潟泣潟 (\f2&\fP) \f2&\fP 荐菴違綽荀障罨<箴с若 HTML 帥 \f2<b>\fP 篏帥c障
22.2155 +.LP
22.2156 +.LP
22.2157 +罨<ャ<潟若激с潟潟<潟腓冴障
22.2158 +.LP
22.2159 +.nf
22.2160 +\f3
22.2161 +.fl
22.2162 +/**
22.2163 +.fl
22.2164 + * This is a <b>doc</b> comment.
22.2165 +.fl
22.2166 + * @see java.lang.Object
22.2167 +.fl
22.2168 + */
22.2169 +.fl
22.2170 +\fP
22.2171 +.fi
22.2172 +
22.2173 +.LP
22.2174 +.LP
22.2175 +\f3茵≪鴻帥鴻\fP \- Javadoc ャ<潟若激с潟潟<潟茹f茵≪鴻帥鴻 (\f2*\fP) 鴻贋障 障≪鴻帥鴻 (\f2*\fP) 腥榊純帥贋障若吾с 1.4 茵≪鴻帥鴻ャ腥榊醇絖ゃ障潟若箴贋・ャ<潟若激с潟潟<潟 \f2<PRE>\fP 帥医若鴻ゃ潟潟篆障絽吾吟腥榊醇絖帥筝緇茹i障ゃ潟潟阪絖 \f2/**\fP 障 \f2<PRE>\fP 帥違綏絲障
22.2176 +.LP
22.2177 +.LP
22.2178 +\f3\fP \- ャ<潟若激с潟潟<潟絎h潟cc若≪膂≧ゅ荀膣с綽荀障翫鴻若鴻帥障壕膓 (宴若沿荐絎翫)障帥違篏臀х障Javadoc 若c HTML 若吾<潟若网荀潟若障
22.2179 +.LP
22.2180 +.LP
22.2181 +\f3茲違c若絎h\fP \- Java с1 ゃц違c若絎hс障 1 ゃャ<潟若激с潟潟<潟荐菴違с障 潟<潟鴻c若絲障潟若障cc若ャ<潟若激с潟潟<潟荐菴違綽荀翫c若ャуh違障違罨<ャ<潟若激с潟潟<潟1 ゃ絎h荐菴違筝с 翫絎h 2 ゃс障
22.2182 +.LP
22.2183 +.RS 3
22.2184 +
22.2185 +.LP
22.2186 +.nf
22.2187 +\f3
22.2188 +.fl
22.2189 +/**
22.2190 +.fl
22.2191 + * The horizontal and vertical distances of point (x,y)
22.2192 +.fl
22.2193 + */
22.2194 +.fl
22.2195 +public int x, y; // Avoid this
22.2196 +.fl
22.2197 +\fP
22.2198 +.fi
22.2199 .RE
22.2200 -.LP
22.2201 -コメントは HTML で記述します。テキストは HTML で
22.2202 -記述しなければなりません。
22.2203 -これは、HTML のエンティティを使う必要があること、
22.2204 -および HTML タグを使用できること
22.2205 -を意味します。HTML は、使用するブラウザがサポートする
22.2206 -任意のバージョンを使うことが
22.2207 -できます。標準ドックレットは、階層式スタイルシートと
22.2208 -フレームを含むほかの部分 (ドキュメンテーションコメント
22.2209 -以外) は、HTML 3.2 に準拠したコードを生成するように記述
22.2210 -されています
22.2211 -(フレームセット対応のため、生成される各
22.2212 -ファイルは、「HTML 4.0」で始まる)。
22.2213 -.LP
22.2214 -たとえば、より小さい (<) およびより大きい (>) という
22.2215 -記号は、
22.2216 -.B <
22.2217 -と
22.2218 -.BR >
22.2219 -と記述する必要があります。同様に、アンパサンド (&) は、
22.2220 -.BR &
22.2221 -と記述する必要があります。次の例で
22.2222 -は、ボールドの HTML タグ <b> を示します。
22.2223 -.LP
22.2224 -次に doc コメントを示します。
22.2225 -.LP
22.2226 -.RS
22.2227 -.ft 3
22.2228 +
22.2229 +.LP
22.2230 +.LP
22.2231 +筝荐潟若罨<ャ<潟障
22.2232 +.LP
22.2233 +.RS 3
22.2234 +
22.2235 +.LP
22.2236 .nf
22.2237 -/**
22.2238 -* This is a <b>doc</b> comment.
22.2239 -* @see java.lang.Object
22.2240 -*/
22.2241 +\f3
22.2242 +.fl
22.2243 +public int \fP\f3x\fP
22.2244 +.fl
22.2245 .fi
22.2246 -.ft 1
22.2247 +
22.2248 +.LP
22.2249 +.RS 3
22.2250 +The horizontal and vertical distances of point (x,y)
22.2251 .RE
22.2252 -.LP
22.2253 -行頭のアスタリスク -
22.2254 -.B javadoc
22.2255 -は、doc コメントを解析するときに、各行の先頭にある
22.2256 -文字アスタリスク (*) をすべて破棄し
22.2257 -ます。また、最初のアスタリスク (*) より前の空白と
22.2258 -タブも破棄します。1.4 からは、行頭のアスタリスクを省略した場合、行頭の空白は削除されません。これにより、<PRE> タグの中の doc コメントに、サンプルコードをインデントを残したままで直接ペーストすることができます。空白は一般的に、タブよりも均一にブラウザで解釈されます。インデントは、区切り文字 /** や <PRE> タグではなく、左マージンに相対的です。
22.2259 -.LP
22.2260 -最初の文 - 各 doc コメントの最初の文は、宣言されている
22.2261 -エンティティに関する簡潔かつ完全
22.2262 -な説明を含む要約文でなければなりません。
22.2263 -この文は、空白、タブ、または行末記
22.2264 -号が続いている最初のピリオド、あるいは最初のスタンドアロンタグで終了します。
22.2265 -.B javadoc
22.2266 -ツールは、HTML ページの最初にあるメンバ要約に、この最初の文をコピーします。
22.2267 -.LP
22.2268 -複数フィールドの宣言 -
22.2269 -.B java
22.2270 -では、単一の文で複数のフィールドを宣言できます。
22.2271 -しかし、この文のドキュメンテ
22.2272 -ーションコメントは 1 つだけで、このコメントが
22.2273 -すべてのフィールドにコピーされます。
22.2274 -したがって、フィールドごとに個々の
22.2275 -ドキュメンテーションコメントを付けたい場合は、
22.2276 -各フィールドを異なる文で宣言しなければなりません。
22.2277 -たとえば、次のドキュメンテー
22.2278 -ションコメントは単一の宣言としては意味を成さず、
22.2279 -2 つの宣言として処理するべき
22.2280 -です。
22.2281 -.LP
22.2282 -.RS
22.2283 -.ft 3
22.2284 +
22.2285 +.LP
22.2286 .nf
22.2287 -/**
22.2288 -* The horizontal and vertical distances of point (x,y)
22.2289 -*/
22.2290 -public int x, y; // Avoid this
22.2291 +\f3
22.2292 +.fl
22.2293 +public int \fP\f3y\fP
22.2294 +.fl
22.2295 .fi
22.2296 -.ft 1
22.2297 +
22.2298 +.LP
22.2299 +.RS 3
22.2300 +The horizontal and vertical distances of point (x,y)
22.2301 .RE
22.2302 -.LP
22.2303 -.B javadoc
22.2304 -ツールは、上記コードから次のドキュメントを生成します。
22.2305 -.LP
22.2306 -.RS
22.2307 -.ft 3
22.2308 -public int x
22.2309 -.fi
22.2310 -.ft 1
22.2311 -The horizontal and vertical distances of point
22.2312 -(x,y).
22.2313 -.ft 3
22.2314 -.nf
22.2315 -public int y
22.2316 -.fi
22.2317 -.ft 1
22.2318 -The horizontal and vertical distances of point
22.2319 -(x,y).
22.2320 +
22.2321 +.LP
22.2322 .RE
22.2323 .LP
22.2324 -ヘッダタグを使用するときは注意してください。
22.2325 -メンバ用のドキュメントコ
22.2326 -メントを書くときは、
22.2327 -.B <H1>
22.2328 -や
22.2329 -.BR <H2>
22.2330 -などの HTML ヘッダタグを使用しないでください。これは、
22.2331 -.B javadoc
22.2332 -が全ドキュメントを構造化して生成するため、
22.2333 -これらの構造化タグを使用すると、
22.2334 -ドキュメントの書式が乱れる可能性があるためです。
22.2335 -しかし、クラスやパッケージの
22.2336 -コメントでは、これらのヘッダタグを使用して構造化を指示してください。
22.2337 -.LP
22.2338 -メソッドコメントの自動コピー
22.2339 -.LP
22.2340 -.LP
22.2341 -Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。
22.2342 +\f3荀冴帥違鴻鋎睡\fP \- <潟若絲障ャ<潟若激с潟潟<潟荐菴違<H1> <H2> HTML 荀冴帥違鴻鋎帥с Javadoc 若絎罕ャ<潟篏с罕帥違篏帥ャ<潟綵√綵演帥障鴻宴若吾潟<潟с荀冴帥違篏帥c罕腟睡障障
22.2343 +.LP
22.2344 +.SS
22.2345 +<純潟<潟潟
22.2346 +.LP
22.2347 +.LP
22.2348 +Javadoc 若罨< 2 ゃ翫鴻潟ゃ潟帥с若鴻<純潟<潟潟若障膓帥罘純障潟潟鴻帥c若喝ャ絖鴻ャ<潟若激с潟潟<潟膓帥障
22.2349 .LP
22.2350 .RS 3
22.2351 .TP 2
22.2352 o
22.2353 -\f3自動的にコメントを継承して、見つからないテキストを埋める\fP \- 主説明または、\f2@return\fP、\f2@param\fP、\f2@throws\fP タグが、メソッドコメントで見つからない場合、Javadoc ツールは、オーバーライドしたメソッドまたは実装している場合はそのメソッドから、対応する主説明およびタグコメントを、次のアルゴリズムに従ってコピーします。
22.2354 -.LP
22.2355 -厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、\f2その例外が宣言されている場合にかぎり\fP、その \f2@throws\fP タグがコピーされます。
22.2356 -.LP
22.2357 -この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。
22.2358 +\f3潟<潟膓帥荀ゃ鴻\fP \- 筝肢障 \f2@return\fP 帥違\f2@param\fP 帥違\f2@throws\fP 帥違<純潟<潟цゃ翫Javadoc 若若若ゃ<純障絎茖翫<純絲上筝肢障帥違潟<潟罨<≪眼冴緇c潟若障
22.2359 +.LP
22.2360 +ウ絲劫<若帥 \f2@param\fP 帥違荀ゃ翫<若帥潟<潟筝篏膓翠絮ゃ<純潟若障劫箴紊 \f2@throws\fP 帥違荀ゃ翫箴紊絎h翫 \f2@throws\fP 帥違潟若障
22.2361 +.LP
22.2362 +篏若吾с 1.3 篁ュ篏絲丞хс 障с若吾с潟с筝肢障帥違絖違潟<潟筝膓帥障с
22.2363 .TP 2
22.2364 o
22.2365 -\f3{@inheritDoc} タグを持つコメントを明示的に継承する\fP \- インラインタグ \f2{@inheritDoc}\fP を、メソッドの主説明、または \f2@return\fP、\f2@param\fP、\f2@throws\fP タグコメントに挿入します。継承した対応する主説明またはタグコメントは、その箇所にコピーされます。
22.2366 +\f3{@inheritDoc} 帥違ゃ潟<潟腓榊膓帥\fP \- ゃ潟ゃ潟帥 \f2{@inheritDoc}\fP <純筝肢障 \f2@return\fP\f2@param\fP\f2@throws\fP 帥違潟<潟水ャ障 膓帥絲上筝肢障帥違潟<潟膊潟若障
22.2367 .RE
22.2368
22.2369 .LP
22.2370 .LP
22.2371 -ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスが ドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。
22.2372 -.LP
22.2373 -.LP
22.2374 -\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。
22.2375 +ャ<潟若激с潟潟<潟絎潟若膓帥<純純若鴻<ゃ \-sourcepath ф絎鴻臀綽荀障潟潟茵с鴻宴若吾羝<綽荀障鴻鴻ャ<潟鴻с違c 1.3.x 篁ュ若鴻違障
22.2376 +.LP
22.2377 +.LP
22.2378 +\f3鴻潟ゃ潟帥с若鴻膓\fP \- 鴻潟ゃ潟帥с若鴻膓帥罨< 3 ゃ翫潟<潟膓帥茵障
22.2379 .LP
22.2380 .RS 3
22.2381 .TP 2
22.2382 o
22.2383 -クラスのメソッドがスーパークラスのメソッドをオーバーライドしている
22.2384 +鴻<純鴻若若鴻<純若若ゃ
22.2385 .TP 2
22.2386 o
22.2387 -インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている
22.2388 +ゃ潟帥с若鴻<純鴻若若ゃ潟帥с若鴻<純若若ゃ
22.2389 .TP 2
22.2390 o
22.2391 -クラスのメソッドがインタフェースのメソッドを実装している
22.2392 +鴻<純ゃ潟帥с若鴻<純絎茖
22.2393 .RE
22.2394
22.2395 .LP
22.2396 .LP
22.2397 -最初の 2 つのケース (メソッドがオーバーライドしている場合) では、
22.2398 -.B javadoc
22.2399 -ツールは、オーバーライドしているメソッドのドキュメント内に
22.2400 -「オーバーライド」という小見出しを生成し、コメントが継承されているかどうかにかかわらず、オーバーライドされている
22.2401 -メソッドへのリンクを書き込みます。
22.2402 -.LP
22.2403 -3 つ目のケース (特定のクラスのメソッドがインタフェースの
22.2404 -メソッドを実装している場合) では、
22.2405 -.B javadoc
22.2406 -ツールは、実装している
22.2407 -メソッドのドキュメント内に「定義」という小見出しを生成し、コメントが継承されているかどうかにかかわらず、
22.2408 -実装されているメソッドへのリンクを書き込みます。
22.2409 -.LP
22.2410 -メソッドの説明が継承されるアルゴリズム - あるメソッドに
22.2411 -ドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、
22.2412 -.B javadoc
22.2413 -ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。
22.2414 -このアルゴリズムは、もっとも適切なドキュメンテーションコメントを
22.2415 -検索できるように設計されており、スーパークラスよりも
22.2416 -インタフェースが優先されるようになっています。
22.2417 -.TP 4
22.2418 -1.
22.2419 -直接に実装されている (または、拡張されている) インタフェースを、
22.2420 -メソッドの宣言で implements (または extends) キーワードのあとに
22.2421 -登場する順序で、1 つずつ調べる。 このメソッドについて
22.2422 -最初に見つかったドキュメンテーションコメントを採用する
22.2423 -.TP 4
22.2424 -2.
22.2425 -手順 1 でドキュメンテーションコメントが見つからなかった場合は、
22.2426 -直接実装されている (または、拡張されている) インタフェースの
22.2427 -それぞれに対して、このアルゴリズム全体を再帰的に適用する (その際の順序は、手順 1 でインタフェースを調べたときの順序と同じ)
22.2428 -.TP 4
22.2429 -3.
22.2430 -手順 2 でドキュメンテーションコメントが見つからなかった場合で、
22.2431 -このクラスが Object 以外のクラスである (インタフェースではない) 場合は、
22.2432 -次のように処理する
22.2433 -.sp 1n
22.2434 + 2 ゃ宴若 (<純若若ゃ翫) сJavadoc 若潟<潟膓帥若若ゃ<純ャ<潟若若ゃ絨頳冴若若ゃ<純吾潟吾莨若帥障
22.2435 +.LP
22.2436 +.LP
22.2437 +3 ょ宴若 (劫鴻<純ゃ潟帥с若鴻<純絎茖翫) сjavadoc 若若若ゃ<純ャ<潟絎臂絨頳冴絎茖<純吾潟吾莨若帥障潟<潟膓帥障
22.2438 +.LP
22.2439 +.LP
22.2440 +\f3<純茯膓帥≪眼冴\fP \- <純ャ<潟若激с潟潟<潟荐菴違翫障 {@inheritDoc} 帥違翫Javadoc 若罨<≪眼冴篏睡潟<潟罎膣≪障 ≪眼冴cャ<潟若激с潟潟<潟罎膣≪с荐荐鴻若若鴻ゃ潟帥с若鴻c障
22.2441 +.LP
22.2442 +.RS 3
22.2443 +.TP 3
22.2444 +1.
22.2445 +贋・絎茖 (障≦宍) ゃ潟帥с若鴻<純絎h implements (障 extends) 若若糸眼綺с1 ゃよ帥鴻<純ゃ荀ゃcャ<潟若激с潟潟<潟。
22.2446 +.TP 3
22.2447 +2.
22.2448 + 1 сャ<潟若激с潟潟<潟荀ゃc翫贋・絎茖 (障≦宍) ゃ潟帥с若鴻絲障≪眼冴篏絽亥 (綺 1 сゃ潟帥с若鴻茯帥鴻綺)
22.2449 +.TP 3
22.2450 +3.
22.2451 + 2 сャ<潟若激с潟潟<潟荀ゃc翫с鴻 Object 篁ュ鴻с (ゃ潟帥с若鴻с) 翫罨<
22.2452 +.RS 3
22.2453 +.TP 3
22.2454 +a.
22.2455 +鴻若若鴻<純ゃャ<潟若激с潟潟<潟荐菴違違潟<潟。
22.2456 +.TP 3
22.2457 +b.
22.2458 + 3a сャ<潟若激с潟潟<潟荀ゃc翫鴻若若鴻絲障≪眼冴篏
22.2459 +.RE
22.2460 +.RE
22.2461 +
22.2462 +.LP
22.2463 +.SH "javadoc 帥"
22.2464 +.LP
22.2465 +.LP
22.2466 +Javadoc 若Java ャ<潟若激с潟潟<潟莨若障劫ャ帥違茹f障ャ<潟若激с潟帥違篏帥後眼c絎 API ャ<潟純若鴻潟若с障帥違箴∴ (\f2@\fP) у障紊ф絖絨絖阪ャ障 帥違絎紊ф絖絨絖篏睡荐菴違綽荀障帥違茵 (茵腥榊純ュ純≪鴻帥鴻ゃ) 臀違障d帥違 1 障荐菴違障違\f2@see\fP 帥違茲違翫鴻 1 障荐菴違障
22.2467 +.LP
22.2468 +.LP
22.2469 +帥違 2 ゃ帥ゃ障
22.2470 +.LP
22.2471 +.RS 3
22.2472 +.TP 2
22.2473 +o
22.2474 +\f3帥\fP \- 筝肢膓帥違祉激с喝粋菴医純帥違\f2@tag\fP 綵√障
22.2475 +.TP 2
22.2476 +o
22.2477 +\f3ゃ潟ゃ潟帥\fP \- 潟<潟筝肢障帥違潟<潟荐菴医純ゃ潟ゃ潟帥違\f2{@tag}\fP 筝綣су蚊帥障
22.2478 +.RE
22.2479 +
22.2480 +.LP
22.2481 +.LP
22.2482 +篁緇若鴻уャ帥違ゃ
22.2483 +.na
22.2484 +\f2Proposed Javadoc Tags\fP @
22.2485 +.fi
22.2486 +http://java.sun.com/j2se/javadoc/proposed\-tags.htmlс
22.2487 +.LP
22.2488 +.LP
22.2489 +憝鴻ф鴻帥違罨<с
22.2490 +.LP
22.2491 +.RS 3
22.2492 +
22.2493 +.LP
22.2494 +.LP
22.2495 +.TS
22.2496 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.2497 +.de 35
22.2498 +.ps \n(.s
22.2499 +.vs \n(.vu
22.2500 +.in \n(.iu
22.2501 +.if \n(.u .fi
22.2502 +.if \n(.j .ad
22.2503 +.if \n(.j=0 .na
22.2504 +..
22.2505 .nf
22.2506 -.ft 3
22.2507 -a. スーパークラスにこのメソッドについてのドキュメンテーションコメントが記述されていれば、そのコメントを採用する
22.2508 -b. 手順 3a でドキュメンテーションコメントが見つからなかった場合は、スーパークラスに対して、このアルゴリズム全体を適用する
22.2509 -.ft 1
22.2510 +.nr #~ 0
22.2511 +.if n .nr #~ 0.6n
22.2512 +.ds #d .d
22.2513 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.2514 +.fc
22.2515 +.nr 33 \n(.s
22.2516 +.rm 80 81
22.2517 +.nr 34 \n(.lu
22.2518 +.eo
22.2519 +.am 81
22.2520 +.br
22.2521 +.di a+
22.2522 +.35
22.2523 +.ft \n(.f
22.2524 +.ll \n(34u*1u/3u
22.2525 +.if \n(.l<\n(81 .ll \n(81u
22.2526 +.in 0
22.2527 +\f3絨ャ JDK/SDK 若吾с\fP
22.2528 +.br
22.2529 +.di
22.2530 +.nr a| \n(dn
22.2531 +.nr a- \n(dl
22.2532 +..
22.2533 +.ec \
22.2534 +.35
22.2535 +.nf
22.2536 +.ll \n(34u
22.2537 +.nr 80 0
22.2538 +.nr 38 \w\f3帥\fP
22.2539 +.if \n(80<\n(38 .nr 80 \n(38
22.2540 +.nr 38 \w\f2@author\fP
22.2541 +.if \n(80<\n(38 .nr 80 \n(38
22.2542 +.nr 38 \w\f2{@code}\fP
22.2543 +.if \n(80<\n(38 .nr 80 \n(38
22.2544 +.nr 38 \w\f2{@docRoot}\fP
22.2545 +.if \n(80<\n(38 .nr 80 \n(38
22.2546 +.nr 38 \w\f2@deprecated\fP
22.2547 +.if \n(80<\n(38 .nr 80 \n(38
22.2548 +.nr 38 \w\f2@exception\fP
22.2549 +.if \n(80<\n(38 .nr 80 \n(38
22.2550 +.nr 38 \w\f2{@inheritDoc}\fP
22.2551 +.if \n(80<\n(38 .nr 80 \n(38
22.2552 +.nr 38 \w\f2{@link}\fP
22.2553 +.if \n(80<\n(38 .nr 80 \n(38
22.2554 +.nr 38 \w\f2{@linkplain}\fP
22.2555 +.if \n(80<\n(38 .nr 80 \n(38
22.2556 +.nr 38 \w\f2{@literal}\fP
22.2557 +.if \n(80<\n(38 .nr 80 \n(38
22.2558 +.nr 38 \w\f2@param\fP
22.2559 +.if \n(80<\n(38 .nr 80 \n(38
22.2560 +.nr 38 \w\f2@return\fP
22.2561 +.if \n(80<\n(38 .nr 80 \n(38
22.2562 +.nr 38 \w\f2@see\fP
22.2563 +.if \n(80<\n(38 .nr 80 \n(38
22.2564 +.nr 38 \w\f2@serial\fP
22.2565 +.if \n(80<\n(38 .nr 80 \n(38
22.2566 +.nr 38 \w\f2@serialData\fP
22.2567 +.if \n(80<\n(38 .nr 80 \n(38
22.2568 +.nr 38 \w\f2@serialField\fP
22.2569 +.if \n(80<\n(38 .nr 80 \n(38
22.2570 +.nr 38 \w\f2@since\fP
22.2571 +.if \n(80<\n(38 .nr 80 \n(38
22.2572 +.nr 38 \w\f2@throws\fP
22.2573 +.if \n(80<\n(38 .nr 80 \n(38
22.2574 +.nr 38 \w\f2{@value}\fP
22.2575 +.if \n(80<\n(38 .nr 80 \n(38
22.2576 +.nr 38 \w\f2@version\fP
22.2577 +.if \n(80<\n(38 .nr 80 \n(38
22.2578 +.80
22.2579 +.rm 80
22.2580 +.nr 81 0
22.2581 +.nr 38 \w1.0
22.2582 +.if \n(81<\n(38 .nr 81 \n(38
22.2583 +.nr 38 \w1.5
22.2584 +.if \n(81<\n(38 .nr 81 \n(38
22.2585 +.nr 38 \w1.3
22.2586 +.if \n(81<\n(38 .nr 81 \n(38
22.2587 +.nr 38 \w1.0
22.2588 +.if \n(81<\n(38 .nr 81 \n(38
22.2589 +.nr 38 \w1.0
22.2590 +.if \n(81<\n(38 .nr 81 \n(38
22.2591 +.nr 38 \w1.4
22.2592 +.if \n(81<\n(38 .nr 81 \n(38
22.2593 +.nr 38 \w1.2
22.2594 +.if \n(81<\n(38 .nr 81 \n(38
22.2595 +.nr 38 \w1.4
22.2596 +.if \n(81<\n(38 .nr 81 \n(38
22.2597 +.nr 38 \w1.5
22.2598 +.if \n(81<\n(38 .nr 81 \n(38
22.2599 +.nr 38 \w1.0
22.2600 +.if \n(81<\n(38 .nr 81 \n(38
22.2601 +.nr 38 \w1.0
22.2602 +.if \n(81<\n(38 .nr 81 \n(38
22.2603 +.nr 38 \w1.0
22.2604 +.if \n(81<\n(38 .nr 81 \n(38
22.2605 +.nr 38 \w1.2
22.2606 +.if \n(81<\n(38 .nr 81 \n(38
22.2607 +.nr 38 \w1.2
22.2608 +.if \n(81<\n(38 .nr 81 \n(38
22.2609 +.nr 38 \w1.2
22.2610 +.if \n(81<\n(38 .nr 81 \n(38
22.2611 +.nr 38 \w1.1
22.2612 +.if \n(81<\n(38 .nr 81 \n(38
22.2613 +.nr 38 \w1.2
22.2614 +.if \n(81<\n(38 .nr 81 \n(38
22.2615 +.nr 38 \w1.4
22.2616 +.if \n(81<\n(38 .nr 81 \n(38
22.2617 +.nr 38 \w1.0
22.2618 +.if \n(81<\n(38 .nr 81 \n(38
22.2619 +.81
22.2620 +.rm 81
22.2621 +.nr 38 \n(a-
22.2622 +.if \n(81<\n(38 .nr 81 \n(38
22.2623 +.35
22.2624 +.nf
22.2625 +.ll \n(34u
22.2626 +.nr 38 1n
22.2627 +.nr 79 0
22.2628 +.nr 40 \n(79+(0*\n(38)
22.2629 +.nr 80 +\n(40
22.2630 +.nr 41 \n(80+(3*\n(38)
22.2631 +.nr 81 +\n(41
22.2632 +.nr TW \n(81
22.2633 +.if t .if \n(TW>\n(.li .tm Table at line 1125 file Input is too wide - \n(TW units
22.2634 +.fc
22.2635 +.nr #T 0-1
22.2636 +.nr #a 0-1
22.2637 +.eo
22.2638 +.de T#
22.2639 +.ds #d .d
22.2640 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.2641 +.mk ##
22.2642 +.nr ## -1v
22.2643 +.ls 1
22.2644 +.ls
22.2645 +..
22.2646 +.ec
22.2647 +.ne \n(a|u+\n(.Vu
22.2648 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.2649 +.ta \n(80u \n(81u
22.2650 +.nr 31 \n(.f
22.2651 +.nr 35 1m
22.2652 +\&\h'|\n(40u'\f3帥\fP\h'|\n(41u'
22.2653 +.mk ##
22.2654 +.nr 31 \n(##
22.2655 +.sp |\n(##u-1v
22.2656 +.nr 37 (\n(41u+\n(81u-\n(a-u)/2u
22.2657 +.in +\n(37u
22.2658 +.a+
22.2659 +.in -\n(37u
22.2660 +.mk 32
22.2661 +.if \n(32>\n(31 .nr 31 \n(32
22.2662 +.sp |\n(31u
22.2663 +.ta \n(80u \n(81u
22.2664 +.nr 31 \n(.f
22.2665 +.nr 35 1m
22.2666 +\&\h'|\n(40u'\f2@author\fP\h'|\n(41u'1.0
22.2667 +.ta \n(80u \n(81u
22.2668 +.nr 31 \n(.f
22.2669 +.nr 35 1m
22.2670 +\&\h'|\n(40u'\f2{@code}\fP\h'|\n(41u'1.5
22.2671 +.ta \n(80u \n(81u
22.2672 +.nr 31 \n(.f
22.2673 +.nr 35 1m
22.2674 +\&\h'|\n(40u'\f2{@docRoot}\fP\h'|\n(41u'1.3
22.2675 +.ta \n(80u \n(81u
22.2676 +.nr 31 \n(.f
22.2677 +.nr 35 1m
22.2678 +\&\h'|\n(40u'\f2@deprecated\fP\h'|\n(41u'1.0
22.2679 +.ta \n(80u \n(81u
22.2680 +.nr 31 \n(.f
22.2681 +.nr 35 1m
22.2682 +\&\h'|\n(40u'\f2@exception\fP\h'|\n(41u'1.0
22.2683 +.ta \n(80u \n(81u
22.2684 +.nr 31 \n(.f
22.2685 +.nr 35 1m
22.2686 +\&\h'|\n(40u'\f2{@inheritDoc}\fP\h'|\n(41u'1.4
22.2687 +.ta \n(80u \n(81u
22.2688 +.nr 31 \n(.f
22.2689 +.nr 35 1m
22.2690 +\&\h'|\n(40u'\f2{@link}\fP\h'|\n(41u'1.2
22.2691 +.ta \n(80u \n(81u
22.2692 +.nr 31 \n(.f
22.2693 +.nr 35 1m
22.2694 +\&\h'|\n(40u'\f2{@linkplain}\fP\h'|\n(41u'1.4
22.2695 +.ta \n(80u \n(81u
22.2696 +.nr 31 \n(.f
22.2697 +.nr 35 1m
22.2698 +\&\h'|\n(40u'\f2{@literal}\fP\h'|\n(41u'1.5
22.2699 +.ta \n(80u \n(81u
22.2700 +.nr 31 \n(.f
22.2701 +.nr 35 1m
22.2702 +\&\h'|\n(40u'\f2@param\fP\h'|\n(41u'1.0
22.2703 +.ta \n(80u \n(81u
22.2704 +.nr 31 \n(.f
22.2705 +.nr 35 1m
22.2706 +\&\h'|\n(40u'\f2@return\fP\h'|\n(41u'1.0
22.2707 +.ta \n(80u \n(81u
22.2708 +.nr 31 \n(.f
22.2709 +.nr 35 1m
22.2710 +\&\h'|\n(40u'\f2@see\fP\h'|\n(41u'1.0
22.2711 +.ta \n(80u \n(81u
22.2712 +.nr 31 \n(.f
22.2713 +.nr 35 1m
22.2714 +\&\h'|\n(40u'\f2@serial\fP\h'|\n(41u'1.2
22.2715 +.ta \n(80u \n(81u
22.2716 +.nr 31 \n(.f
22.2717 +.nr 35 1m
22.2718 +\&\h'|\n(40u'\f2@serialData\fP\h'|\n(41u'1.2
22.2719 +.ta \n(80u \n(81u
22.2720 +.nr 31 \n(.f
22.2721 +.nr 35 1m
22.2722 +\&\h'|\n(40u'\f2@serialField\fP\h'|\n(41u'1.2
22.2723 +.ta \n(80u \n(81u
22.2724 +.nr 31 \n(.f
22.2725 +.nr 35 1m
22.2726 +\&\h'|\n(40u'\f2@since\fP\h'|\n(41u'1.1
22.2727 +.ta \n(80u \n(81u
22.2728 +.nr 31 \n(.f
22.2729 +.nr 35 1m
22.2730 +\&\h'|\n(40u'\f2@throws\fP\h'|\n(41u'1.2
22.2731 +.ta \n(80u \n(81u
22.2732 +.nr 31 \n(.f
22.2733 +.nr 35 1m
22.2734 +\&\h'|\n(40u'\f2{@value}\fP\h'|\n(41u'1.4
22.2735 +.ta \n(80u \n(81u
22.2736 +.nr 31 \n(.f
22.2737 +.nr 35 1m
22.2738 +\&\h'|\n(40u'\f2@version\fP\h'|\n(41u'1.0
22.2739 +.fc
22.2740 +.nr T. 1
22.2741 +.T# 1
22.2742 +.35
22.2743 +.rm a+
22.2744 +.TE
22.2745 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
22.2746 +
22.2747 +.LP
22.2748 +.RE
22.2749 +.LP
22.2750 +鴻帥帥違ゃ\-tag 激с潟с
22.2751 +.LP
22.2752 +.RS 3
22.2753 +.TP 3
22.2754 +@author\ name\-text
22.2755 +\-author 激с潟篏帥翫ャ<潟菴遵絎 \f2name\-text\fP 吾莨若帥障1 ゃャ<潟若激с潟潟<潟茲違 \f2@author\fP 帥違с障1 ゃ \f2@author\fP 帥違 1 ゃ絎1 ゃ帥違茲違絎с障翫Javadoc 若c潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹fャ<潟障障潟若障c潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
22.2756 +.RE
22.2757 +
22.2758 +.LP
22.2759 +.RS 3
22.2760 +
22.2761 +.LP
22.2762 +.LP
22.2763 +荅括完ゃ帥違篏睡с贋
22.2764 +.na
22.2765 +\f2@author 帥違ャ<潟\fP @
22.2766 .fi
22.2767 -.LP
22.2768 -.SS "javadoc のタグ"
22.2769 -.LP
22.2770 -.B javadoc
22.2771 -ツールは、
22.2772 -.B java doc
22.2773 -コメント内に埋め込まれた特殊なタグを解析します。これらの
22.2774 -特殊な doc タグを使うと、
22.2775 -書式の整った完全な API ドキュメントをソース
22.2776 -コードから自動的に生成できます。
22.2777 -タグは、単価記号 (\f3@\f1) で始まり、大文字小文字が
22.2778 -区別されます。これらのタグは、
22.2779 -以下に示すとおりに、大文字と小文字を区別して入力する
22.2780 -必要があります。タグは、行
22.2781 -の先頭 (ただし先行する空白と省略可能なアスタリスクは除く) から
22.2782 -始めなければなり
22.2783 -ません。慣習上、同じ名前のタグは 1 個所にまとめて記述します。
22.2784 -たとえば、
22.2785 -.B @see
22.2786 -タグが複数ある場合は、すべてを 1 個所にまとめて記述します。
22.2787 -.LP
22.2788 -タグは次の 2 種類あります。
22.2789 -.LP
22.2790 -\(bu
22.2791 -スタンドアロンタグ - 説明のあとのタグセクションだけに
22.2792 -置くことができます。 このタグは、@tag のように中括弧で囲みません。
22.2793 -.LP
22.2794 -\(bu
22.2795 -インラインタグ - コメントの説明内またはスタンドアロンタグの
22.2796 -コメント中の任意の場所に置くことができます。 インラインタグは、{@tag} の
22.2797 -ように中括弧で囲みます。
22.2798 -.LP
22.2799 -今後のリリースで導入されるタグについては、
22.2800 -.fi
22.2801 -http://java.sun.com/j2se/javadoc/proposed\-tags.html
22.2802 -の
22.2803 -.na
22.2804 -「\f2Proposed Tags\fP」を参照してください。
22.2805 -.LP
22.2806 -.LP
22.2807 -現時点で有効なタグは、次のとおりです。
22.2808 -.LP
22.2809 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorс
22.2810 +.LP
22.2811 +.LP
22.2812 +
22.2813 +.LP
22.2814 +.RE
22.2815 .RS 3
22.2816 -
22.2817 -.LP
22.2818 -.LP
22.2819 -.TS
22.2820 -center;
22.2821 -cbp-1 cbp-1
22.2822 -l l.
22.2823 -タグ 導入された JDK/SDK のバージョン
22.2824 -@author 1.0
22.2825 -{@code} 1.5
22.2826 -{@docRoot} 1.3
22.2827 -@deprecated} 1.0
22.2828 -@exception 1.0
22.2829 -{@inheritDoc} 1.4
22.2830 -{@link} 1.2
22.2831 -{@linkplain} 1.4
22.2832 -{@literal} 1.5
22.2833 -@param 1.0
22.2834 -@return 1.0
22.2835 -@see 1.0
22.2836 -@serial 1.2
22.2837 -@serialData 1.2
22.2838 -@serialField 1.2
22.2839 -@since 1.1
22.2840 -@throws 1.2
22.2841 -{@value} 1.4
22.2842 -@version 1.0
22.2843 -.TE
22.2844 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
22.2845 -
22.2846 -.LP
22.2847 -.LP
22.2848 -カスタムタグについては、\-tag オプションを参照してください。
22.2849 -.TP
22.2850 -.BI @author " name-text"
22.2851 -.B \-author
22.2852 -オプションが使われている場合、
22.2853 -生成されるドキュメントに、指定された
22.2854 -name-text を持つ Author エントリを追加します。
22.2855 -1 つの doc コメントに複数の
22.2856 -.B @author
22.2857 -タグを含めることができます。
22.2858 -.B @author
22.2859 -タグごとに 1 つ、またはタグごとに複数の名前を
22.2860 -指定できます。前者の場合は、
22.2861 -.B javadoc
22.2862 -ツールは、名前と名前の間にコンマ (\f3,\f1) とスペースを挿入します。
22.2863 -後者の場合、テキスト全体が
22.2864 -解析されることなく生成されるドキュメントにコピーされるだけです。
22.2865 -このため、コンマ以外
22.2866 -の現地仕様の名前区切り文字を使う場合は、1 行に複数の名前を指定します。
22.2867 -.LP
22.2868 -詳細については、「タグを使用できる場所」および
22.2869 -.fi
22.2870 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@author
22.2871 -の
22.2872 -.na
22.2873 -\f2@author タグのドキュメント\fPを参照してください。
22.2874 -.LP
22.2875 .TP 3
22.2876 @deprecated\ deprecated\-text
22.2877 .RS 3
22.2878
22.2879 .LP
22.2880 .LP
22.2881 -注: JDK 5.0 から、@Deprecated 注釈を使って特定のプログラム要素を非推奨にできるようになりました。
22.2882 -.LP
22.2883 -この API は (動作はするが) 使用すべきでないことを示す
22.2884 -コメントを追加します。
22.2885 -.B javadoc
22.2886 - は、deprecated-text を説明の前に移動してイタリックにし、
22.2887 -その前にボールドの警告
22.2888 -「推奨されません。」を追加します。このタグはすべての doc コメント (概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、フィールド) で有効です。
22.2889 -.LP
22.2890 -.RS
22.2891 -deprecated-text の最初の文では、少なくともユーザにどのようなときに
22.2892 -その API が推奨されないか、およびそれに代わる API を提示する
22.2893 -必要があります。
22.2894 -.B javadoc
22.2895 -は、最初の文だけを要約セクションと索引にコピーします。
22.2896 -あとに続く文で、なぜその API が推奨されないかを
22.2897 -説明することもできます。代わりの API を
22.2898 -指し示す {\f3@link\f1} タグ (
22.2899 -.B javadoc
22.2900 -1.2 以降の場合) を含める必要があります。
22.2901 -.LP
22.2902 -詳細については、
22.2903 +羈: JDK 5.0
22.2904 +.na
22.2905 +\f2@Deprecated 羈\fP @
22.2906 .fi
22.2907 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated
22.2908 -の
22.2909 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html篏帥c劫違荀膣ィ絅с障
22.2910 +.LP
22.2911 +.RE
22.2912 +.RE
22.2913 +.RS 3
22.2914 +
22.2915 +.LP
22.2916 +.LP
22.2917 + API 篏膓障 API 篏睡鴻с腓冴潟<潟菴遵障Javadoc 若\f2deprecated\-text\fP 筝肢腱糸ゃ帥若茘ィ絅障菴遵障帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
22.2918 +.LP
22.2919 +.LP
22.2920 +\f2deprecated\-text\fP с絨 API ィ絅c篁f推戎鴻 API 茯腓冴綽荀障Javadoc 若网荀祉激с潟膣√潟若障с API ィ絅宴茯с障障篁c API 腓冴 \f2{@link}\fP 帥 (Javadoc 1.2 篁ラ翫) 綽荀障 罨<荐菴違障
22.2921 +.LP
22.2922 +.LP
22.2923 +荅括完ゃ
22.2924 .na
22.2925 -\f2@deprecated タグのドキュメント\fPを参照してください。
22.2926 -.LP
22.2927 -.TP 2
22.2928 -\(bu
22.2929 -.B javadoc
22.2930 -1.2 以降では、{\f3@link\f1} タグを使用してください。これにより、
22.2931 -必要な場所にインラインで
22.2932 -リンクが作成されます。たとえば、次のように使います。
22.2933 -.LP
22.2934 -.RS
22.2935 -.ft 3
22.2936 -.nf
22.2937 -/**
22.2938 - * @deprecated As of JDK 1.1, replaced by
22.2939 - * {@link #setBounds(int,int,int,int)}
22.2940 - */
22.2941 +\f2@deprecated 帥違ャ<潟\fP @
22.2942 .fi
22.2943 -.ft 1
22.2944 -.RE
22.2945 -.LP
22.2946 -.TP 2
22.2947 -\(bu
22.2948 -.B javadoc
22.2949 -1.1 では、各
22.2950 -.B @deprecated
22.2951 -タグに
22.2952 -.B @see
22.2953 -タグ (インラインにできない) を作成するのが標準の形式です。
22.2954 -.LP
22.2955 -推奨されないタグについての詳細は、「
22.2956 -.B @deprecated
22.2957 -タグ」 を参照してください。
22.2958 -.RE
22.2959 -.TP
22.2960 -.B {@code text}
22.2961 -<code>{@literal}</code> と同等です。
22.2962 -.LP
22.2963 -テキストを HTML マークアップまたは
22.2964 -入れ子になった javadoc タグとして解釈せずに、
22.2965 -テキストをコードフォントで表示します。
22.2966 -これにより doc コメントでは、
22.2967 -パラメータの種類 ( <Object> )、不等号 ( 3 < 4 )、
22.2968 -または矢印 ( <- ) などで、HTML エンティティ ( < および > ) ではなく、
22.2969 -通常の山括弧 (< および >) を使用できます。
22.2970 -たとえば doc コメントのテキスト
22.2971 -.LP
22.2972 -.RS 5
22.2973 -{@code A<B>C}
22.2974 -.RE
22.2975 -.LP
22.2976 -は、生成された HTML ページで、次のようにそのまま表示されます。
22.2977 -.LP
22.2978 -.RS 5
22.2979 -A<B>C
22.2980 -.RE
22.2981 -.LP
22.2982 -注目すべき点として、<B> は太字であると解釈されませんが、
22.2983 -コードフォントになります。
22.2984 -.LP
22.2985 -コードフォントなしで同じ機能を実現するには、
22.2986 -{@literal} を使用します。
22.2987 -.RE
22.2988 -.TP
22.2989 -.B {@docRoot}
22.2990 -生成された任意のページを起点とした、ドキュメントの (出力先)
22.2991 -ルートディレクトリの相対パスを表します。このタグは、著作権ページ
22.2992 -または会社のロゴなど、生成されるすべてのページから参照するファイル
22.2993 -を取り込むときに使います。通常は、各ページの最下部から著作権
22.2994 -ページにリンクします。
22.2995 -.RS
22.2996 -.LP
22.2997 -この \f2{@docRoot}\fP タグは、コマンド行からも、ドキュメンテーションコメントの中でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
22.2998 -.TP 4
22.2999 -1.
22.3000 -コマンド行では、次のようにヘッダ (header)、フッタ (footer)、
22.3001 -またはページの最下部 (bottom)を定義します。
22.3002 -.sp 1n
22.3003 -.B javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
22.3004 -.LP
22.3005 -注 - Makefile の中で {\f3@docRoot\f1}をこのように利用する場合、
22.3006 -一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする
22.3007 -必要があります。 たとえば、Inprise MAKE バージョン 5.2 を
22.3008 -Windows 上で実行する場合は、{{\f3@docRoot\f1}} のように、
22.3009 -中括弧を二重にする必要があります。さらに、\-bottom などの
22.3010 -オプションに対する引数を、単一引用符ではなく、
22.3011 -二重引用符で囲む必要があります。href
22.3012 -引数の値を囲む引用符は省略します。
22.3013 -.TP
22.3014 -2.
22.3015 -doc コメントには次のように記述します。
22.3016 -.sp 1n
22.3017 -.nf
22.3018 -.ft 3
22.3019 -/**
22.3020 -* See the <a href="{@docRoot}/copyright.html">Copyright</a>.
22.3021 -*/
22.3022 -.ft 1
22.3023 -.fi
22.3024 -.LP
22.3025 -このタグが必要な理由は、生成されるドキュメントが、サブパッケージと
22.3026 -同じ階層のディレクトリに格納されるためです。たとえば、次のように指定します。
22.3027 -.LP
22.3028 -.ti +5n
22.3029 -.B <a href="{@docRoot}/copyright.html">
22.3030 -.LP
22.3031 -次のように解決されます。
22.3032 -.LP
22.3033 -.ti +5n
22.3034 -\f3<a href=".\|.\|/.\|.\|/copyright.html">\f1 .\|.\|. java/lang/Object.java の場合
22.3035 -.sp 1n
22.3036 -および
22.3037 -.sp 1n
22.3038 -.ti +5n
22.3039 -\f3<a href=".\|.\|/.\|.\|/.\|.\|/copyright.html">\f1 .\|.\|. java/lang/ref/Reference.java の場合
22.3040 -.RE
22.3041 -.TP
22.3042 -.BI @exception " class-name description"
22.3043 -.B @exception
22.3044 -タグは、
22.3045 -.BR @throws
22.3046 -と同義です。
22.3047 -.TP
22.3048 -{\f3@inheritDoc\f1}
22.3049 -最も近いスーパークラスから現在の ドキュメンテーションコメントに、ドキュメントを継承します。 この機能により、コメントは継承ツリーの上位に移動し、開発者はコピーしたテキストに記述を追加することができます。
22.3050 -.LP
22.3051 -このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。
22.3052 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedс
22.3053 +.LP
22.3054 .RS 3
22.3055 .TP 2
22.3056 o
22.3057 -メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる
22.3058 +Javadoc 1.2 篁ラс\f2{@link}\fP 帥違篏睡障綽荀贋ゃ潟ゃ潟с潟篏с障箴腓冴障
22.3059 +.RE
22.3060 +
22.3061 +.LP
22.3062 +.RS 3
22.3063 +
22.3064 +.LP
22.3065 +.nf
22.3066 +\f3
22.3067 +.fl
22.3068 +/**
22.3069 +.fl
22.3070 + * @deprecated As of JDK 1.1, replaced by {@link #setBounds(int,int,int,int)}
22.3071 +.fl
22.3072 + */
22.3073 +.fl
22.3074 +
22.3075 +.fl
22.3076 +\fP
22.3077 +.fi
22.3078 +.RE
22.3079 +
22.3080 +.LP
22.3081 +.RS 3
22.3082 .TP 2
22.3083 o
22.3084 -メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる
22.3085 +Javadoc 1.1 с \f2@deprecated\fP 帥違絲障 \f2@see\fP 帥 (ゃ潟ゃ潟с) 荐菴違罔羣綵√с
22.3086 .RE
22.3087 -.LP
22.3088 -継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。
22.3089 -.LP
22.3090 +
22.3091 +.LP
22.3092 +.LP
22.3093 +ィ絅帥違ゃ荅括完
22.3094 +.na
22.3095 +\f2@deprecated 帥\fP @
22.3096 +.fi
22.3097 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlャ<潟с
22.3098 +.LP
22.3099 +.LP
22.3100 +
22.3101 +.LP
22.3102 +.RE
22.3103 +.RS 3
22.3104 .TP 3
22.3105 -{@link\ package.class#member\ label}
22.3106 -表示テキスト label とのインラインリンクを挿入します。\f2label\fP は、参照クラスの指定されたパッケージ、クラス、またはメンバの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
22.3107 -.LP
22.3108 -このタグは、
22.3109 -.B @see
22.3110 -タグとよく似ています。どちらのタグも、package.class#member および
22.3111 -.BI label
22.3112 -の参照の仕方が同じで、有効な構文もまったく同じです。
22.3113 -大きな違いは、{\f3@link\f1} は、リンクを [関連項目] セクションに
22.3114 -置くのではなく、インラインリンクを生成するということです。
22.3115 -また、インラインテキストのほかの部分と区別するために、
22.3116 -{\f3@link\f1} タグの最初と最後に中括弧を記述します。
22.3117 -ラベルの中で「}」を使う必要がある場合は、HTML
22.3118 -エンティティの「}」を使います。
22.3119 -.LP
22.3120 -1 つの文の中で使用できる {@link} タグの数に制限はありません。
22.3121 -このタグは、ドキュメンテーションコメントの説明部分、または
22.3122 -.BR @deprecated
22.3123 -、
22.3124 -.BR @return
22.3125 -、
22.3126 -.BR @param
22.3127 -などの任意のタグのテキスト部分で使うことができます。
22.3128 -.LP
22.3129 -たとえば、次のコメントでは、
22.3130 -.B getComponentAt(int, int)
22.3131 -メソッドを参照しています。
22.3132 -.LP
22.3133 -.ft 3
22.3134 -.nf
22.3135 -Use the {\f3@link #getComponentAt(int, int) getComponentAt\f1} method.
22.3136 -.fi
22.3137 -.ft 1
22.3138 -.LP
22.3139 -標準ドックレットでは、上記のコメントから次の HTML が
22.3140 -生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。
22.3141 -.LP
22.3142 -.ft 3
22.3143 -.nf
22.3144 -Use the
22.3145 -<a href="Component.html#getComponentAt(int, int)">getComponentAt</a>method.
22.3146 -.fi
22.3147 -.ft 1
22.3148 -.LP
22.3149 -この HTML は、Web ページ上では次のように表示されます。
22.3150 -.LP
22.3151 -.ft 3
22.3152 -.nf
22.3153 -Use the getComponentAt method.
22.3154 -.fi
22.3155 -.ft 1
22.3156 -.LP
22.3157 -{\f3@link\f1} を、ドキュメント化の対象にしていないクラスにまで
22.3158 -拡張するには、
22.3159 -.BR \-link
22.3160 -オプションを使用します。
22.3161 -.LP
22.3162 -詳細については、
22.3163 -.fi
22.3164 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}
22.3165 -の
22.3166 -.na
22.3167 -\f2{@link} タグのドキュメント\fPを参照してください。
22.3168 +{@code\ text}
22.3169 +\f2<code>{@literal}</code>\fP 膈с
22.3170 .RE
22.3171 -.TP
22.3172 -{@linkplain package.class#member label}
22.3173 -リンクのラベルがコードフォントではなくプレーンテキストで
22.3174 -表示されている点以外は、
22.3175 -{\f3@link\f1} と同じです。 ラベルがプレーンテキストで
22.3176 -記述されている場合に便利です。次の例を参照してください。
22.3177 -.LP
22.3178 -.ft 3
22.3179 -.nf
22.3180 -Refer to {\f3@linkplain\f1 add() the overridden method}.
22.3181 -.fi
22.3182 -.ft 1
22.3183 -.LP
22.3184 -これは以下のように表示されます。
22.3185 -.LP
22.3186 -.ft 3
22.3187 -.nf
22.3188 -Refer to the overridden method.
22.3189 -.fi
22.3190 -.ft 1
22.3191 -.LP
22.3192 -.TP
22.3193 -.B {@literal text}
22.3194 -テキストを HTML マークアップまたは
22.3195 -入れ子になった javadoc タグとして解釈せずに、
22.3196 -テキストをコードフォントで表示します。
22.3197 -これにより doc コメントでは、
22.3198 -パラメータの種類 ( <Object> )、不等号 ( 3 < 4 )、
22.3199 -または矢印 ( <- ) などで、HTML エンティティ ( < および > ) ではなく、
22.3200 -通常の山括弧 (< および >) を使用できます。
22.3201 -たとえば doc コメントのテキスト
22.3202 -.LP
22.3203 -.RS 5
22.3204 -{@literal A<B>C}
22.3205 -.RE
22.3206 -.LP
22.3207 -は、生成された HTML ページはブラウザで次のようにそのまま表示されます。
22.3208 -.LP
22.3209 -.RS 5
22.3210 -A<B>C
22.3211 -.RE
22.3212 -.LP
22.3213 -注目すべき点として、<B> は太字であると解釈され、
22.3214 -コードフォントになりません。
22.3215 -.LP
22.3216 -コードフォントで同じ機能を実現するには、
22.3217 -{@code} を使用します。
22.3218 -.TP
22.3219 -.BI @param " parameter-name description"
22.3220 -指定した parameter-name と指定した description を使用して
22.3221 -パラメータを「Parameters」セクションに追加します。
22.3222 -doc コメントを記述するときは、description を複数行に
22.3223 -続けることができます。このタグは、
22.3224 -メソッド、コンストラクタ、またはクラスの
22.3225 -doc コメント内でのみ有効です。
22.3226 -.LP
22.3227 -\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。
22.3228 -山括弧でパラメータ名を囲むと、型パラメータを使用することを
22.3229 -指定します。
22.3230 -.LP
22.3231 -クラスの型パラメータの例:
22.3232 +
22.3233 +.LP
22.3234 +.RS 3
22.3235 +
22.3236 +.LP
22.3237 +.LP
22.3238 +鴻 HTML 若≪障ャ絖c javadoc 帥違茹i\f2text\fP \f2code\fP 潟ц;腓冴障 doc 潟<潟с<若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟cc (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟<潟鴻
22.3239 +.LP
22.3240 .nf
22.3241 \f3
22.3242 .fl
22.3243 - /**
22.3244 -.fl
22.3245 - * @param <E> Type of element stored in a list
22.3246 -.fl
22.3247 - */
22.3248 -.fl
22.3249 - public interface List<E> extends Collection<E> {
22.3250 -.fl
22.3251 - }
22.3252 + \fP\f4{@code A<B>C}\fP\f3
22.3253 +.fl
22.3254 +
22.3255 .fl
22.3256 \fP
22.3257 .fi
22.3258 -.LP
22.3259 -メソッドの型パラメータの例:
22.3260 +
22.3261 +.LP
22.3262 +.LP
22.3263 + HTML 若吾с罨<障乗;腓冴障
22.3264 +.LP
22.3265 .nf
22.3266 \f3
22.3267 .fl
22.3268 - /**
22.3269 -.fl
22.3270 - * @param string the string to be converted
22.3271 -.fl
22.3272 - * @param type the type to convert the string to
22.3273 -.fl
22.3274 - * @param <T> the type of the element
22.3275 -.fl
22.3276 - * @param <V> the value of the element
22.3277 -.fl
22.3278 - */
22.3279 -.fl
22.3280 - <T, V extends T> V convert(String string, Class<T> type) {
22.3281 -.fl
22.3282 - }
22.3283 + \fP\f4A<B>C\fP\f3
22.3284 +.fl
22.3285 +
22.3286 .fl
22.3287 \fP
22.3288 .fi
22.3289 -詳細については、
22.3290 +
22.3291 +.LP
22.3292 +.LP
22.3293 +羈鴻鴻\f2<B>\fP 紊絖с茹i障潟若潟障
22.3294 +.LP
22.3295 +.LP
22.3296 +潟若潟у罘純絎憗\f2{@literal}\fP 篏睡障
22.3297 +.LP
22.3298 +.LP
22.3299 +
22.3300 +.LP
22.3301 +.RE
22.3302 +.RS 3
22.3303 +.TP 3
22.3304 +{@docRoot}
22.3305 +若吾荀ャ<潟 () 若c吾後障鴻茵障帥違篏罔若吾篌腓障眼鴻若吾с<ゃ腟粋昭箴水с絽吾若吾筝篏罔若吾潟障
22.3306 +.RE
22.3307 +
22.3308 +.LP
22.3309 +.RS 3
22.3310 +
22.3311 +.LP
22.3312 +.LP
22.3313 + \f2{@docRoot}\fP 帥違潟潟茵ャ<潟若激с潟潟<潟筝с篏睡с障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
22.3314 +.LP
22.3315 +.RS 3
22.3316 +.TP 3
22.3317 +1.
22.3318 +潟潟茵с若帥若障若罨<絎臂障
22.3319 +.nf
22.3320 +\f3
22.3321 +.fl
22.3322 + javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
22.3323 +.fl
22.3324 +
22.3325 +.fl
22.3326 +\fP
22.3327 .fi
22.3328 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@param
22.3329 -の
22.3330 +.LP
22.3331 +\- \f2{@docRoot}\fP 翫筝 Makefile 違с筝綣 { } 絖鴻宴若綽荀障違Inprise MAKE 若吾с 5.2 Windows 筝у茵翫\f2{{@docRoot}}\fP筝綣с篋綽荀障\f2\-bottom\fP 激с潟絲障綣違筝綣膃с篋綣膃у蚊綽荀障 \f2href\fP 綣違ゃ蚊綣膃ャ障
22.3332 +.TP 3
22.3333 +2.
22.3334 +ャ<潟若激с潟潟<潟筝с罨<篏睡障
22.3335 +.nf
22.3336 +\f3
22.3337 +.fl
22.3338 + /**
22.3339 +.fl
22.3340 + * See the <a href="{@docRoot}/copyright.html">Copyright</a>.
22.3341 +.fl
22.3342 + */
22.3343 +.fl
22.3344 +
22.3345 +.fl
22.3346 +\fP
22.3347 +.fi
22.3348 +.RE
22.3349 +
22.3350 +.LP
22.3351 +.LP
22.3352 +帥違綽荀宴ャ<潟泣宴若吾羞宴ら絮ゆc主с罨<箴腓冴障
22.3353 +.LP
22.3354 +.nf
22.3355 +\f3
22.3356 +.fl
22.3357 + <a href="{@docRoot}/copyright.html">
22.3358 +.fl
22.3359 +
22.3360 +.fl
22.3361 +\fP
22.3362 +.fi
22.3363 +
22.3364 +.LP
22.3365 +.LP
22.3366 +罨<茹f浦障
22.3367 +.LP
22.3368 +.nf
22.3369 +\f3
22.3370 +.fl
22.3371 + <a href="../../copyright.html"> java/lang/Object.java 翫
22.3372 +.fl
22.3373 +
22.3374 +.fl
22.3375 +\fP
22.3376 +.fi
22.3377 +
22.3378 +.LP
22.3379 +.LP
22.3380 +
22.3381 +.LP
22.3382 +.nf
22.3383 +\f3
22.3384 +.fl
22.3385 + <a href="../../../copyright.html"> java/lang/ref/Reference.java 翫
22.3386 +.fl
22.3387 +
22.3388 +.fl
22.3389 +\fP
22.3390 +.fi
22.3391 +
22.3392 +.LP
22.3393 +.LP
22.3394 +
22.3395 +.LP
22.3396 +.RE
22.3397 +.RS 3
22.3398 +.TP 3
22.3399 +@exception\ class\-name\ description
22.3400 +\f2@exception\fP 帥違\f2@throws\fP 帥違臂с
22.3401 +.RE
22.3402 +
22.3403 +.LP
22.3404 +.RS 3
22.3405 +
22.3406 +.LP
22.3407 +.LP
22.3408 +
22.3409 +.LP
22.3410 +.RE
22.3411 +.RS 3
22.3412 +.TP 3
22.3413 +{@inheritDoc}\
22.3414 +c菴膓水純鴻障絎茖純ゃ潟帥с若鴻帥違憜ャ<潟若激с潟潟<潟ャ<潟膓 (潟) 障罘純羆潟<潟膓帥若筝篏荐菴違潟若鴻篏帥c荐菴違с障
22.3415 +.RE
22.3416 +
22.3417 +.LP
22.3418 +.RS 3
22.3419 +
22.3420 +.LP
22.3421 +.LP
22.3422 +帥違ャ<潟若激с潟潟<潟罨<篏臀с炊鴻с
22.3423 +.LP
22.3424 +.RS 3
22.3425 +.TP 2
22.3426 +o
22.3427 +<純筝肢翫筝肢筝篏絮ゃ鴻障ゃ潟帥с若鴻潟若
22.3428 +.TP 2
22.3429 +o
22.3430 +<純 @return@param@throws 帥違鴻綣医翫帥違鴻筝篏絮ゃ絲上帥違潟若
22.3431 +.RE
22.3432 +
22.3433 +.LP
22.3434 +.LP
22.3435 +膓翠絮ゃс潟<潟荀ゃ号≪罩g∈茯ゃ<純潟<潟潟若с帥違荀ゃ翫潟<潟膀ц若綽膓帥羆冴障障
22.3436 +.LP
22.3437 +.LP
22.3438 +
22.3439 +.LP
22.3440 +.RE
22.3441 +.RS 3
22.3442 +.TP 3
22.3443 +{@link\ \ package.class#member\ \ label}\
22.3444 +茵腓冴鴻 \f2label\fP ゃ潟ゃ潟潟水ャ障 \f2label\fP с鴻絎宴若吾鴻障<潟若ャ<潟若激с潟腓冴障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
22.3445 +.RE
22.3446 +
22.3447 +.LP
22.3448 +.RS 3
22.3449 +
22.3450 +.LP
22.3451 +.LP
22.3452 +帥違\f2@see\fP 帥違鋍若障 <帥違\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP с篁鴻с鴻罕障cс紊с\f2{@link}\fP 潟 [∫i] 祉激с潟臀сゃ潟ゃ潟潟с障ゃ潟ゃ潟鴻祉阪ャ\f2{@link}\fP 帥違緇筝綣с荐菴違障筝с}篏帥綽荀翫HTML 潟cc若}篏帥障
22.3453 +.LP
22.3454 +.LP
22.3455 +1 ゃ筝т戎с \f2{@link}\fP 帥違違狗障帥違ャ<潟若激с潟潟<潟筝肢障 @deprecated@return@param 篁紙帥違鴻т戎с障
22.3456 +.LP
22.3457 +.LP
22.3458 +違罨<潟<潟с \f2getComponentAt(int, int)\fP <純с障
22.3459 +.LP
22.3460 +.nf
22.3461 +\f3
22.3462 +.fl
22.3463 +{@link #getComponentAt(int, int) getComponentAt} <純篏睡障
22.3464 +.fl
22.3465 +
22.3466 +.fl
22.3467 +\fP
22.3468 +.fi
22.3469 +
22.3470 +.LP
22.3471 +.LP
22.3472 +罔羣с筝荐潟<潟罨< HTML 障 (潟<潟宴若吾ャ鴻с翫)
22.3473 +.LP
22.3474 +.nf
22.3475 +\f3
22.3476 +.fl
22.3477 +<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> <純篏睡障
22.3478 +.fl
22.3479 +
22.3480 +.fl
22.3481 +\fP
22.3482 +.fi
22.3483 +
22.3484 +.LP
22.3485 +.LP
22.3486 + HTML Web 若娯с罨<茵腓冴障
22.3487 +.LP
22.3488 +.nf
22.3489 +\f3
22.3490 +.fl
22.3491 +getComponentAt <純篏睡障
22.3492 +.fl
22.3493 +
22.3494 +.fl
22.3495 +\fP
22.3496 +.fi
22.3497 +
22.3498 +.LP
22.3499 +.LP
22.3500 +\f2{@link}\fP ャ<潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
22.3501 +.LP
22.3502 +.LP
22.3503 +荅括完ゃ
22.3504 .na
22.3505 -\f2@param タグのドキュメント\fPを参照してください。
22.3506 -.LP
22.3507 +\f2{@link} 帥違ャ<潟\fP @
22.3508 +.fi
22.3509 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}с
22.3510 +.LP
22.3511 +.LP
22.3512 +
22.3513 +.LP
22.3514 +.RE
22.3515 +.RS 3
22.3516 +.TP 3
22.3517 +{@linkplain\ package.class#member\ label}
22.3518 +潟潟若潟с若潟鴻ц;腓冴剛札紊 \f2{@link}\fP с若潟鴻ц菴違箴水с箴:
22.3519 +.RE
22.3520 +
22.3521 +.LP
22.3522 +.RS 3
22.3523 +
22.3524 +.LP
22.3525 +.nf
22.3526 +\f3
22.3527 +.fl
22.3528 + {@linkplain add() the overridden method} с
22.3529 +.fl
22.3530 +
22.3531 +.fl
22.3532 +\fP
22.3533 +.fi
22.3534 +
22.3535 +.LP
22.3536 +.LP
22.3537 +篁ヤ茵腓冴障
22.3538 +.LP
22.3539 +.RS 3
22.3540 +
22.3541 +.LP
22.3542 +.LP
22.3543 +the overridden method с
22.3544 +.LP
22.3545 +.RE
22.3546 +.LP
22.3547 +
22.3548 +.LP
22.3549 +.RE
22.3550 +.RS 3
22.3551 +.TP 3
22.3552 +{@literal\ text}
22.3553 +鴻 HTML 若≪障ャ絖c javadoc 帥違茹i\f2text\fP 茵腓冴障 doc 潟<潟с<若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟cc (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟<潟鴻
22.3554 +.RE
22.3555 +
22.3556 +.LP
22.3557 +.RS 3
22.3558 +
22.3559 +.LP
22.3560 +.nf
22.3561 +\f3
22.3562 +.fl
22.3563 + \fP\f4{@literal A<B>C}\fP\f3
22.3564 +.fl
22.3565 +
22.3566 +.fl
22.3567 +\fP
22.3568 +.fi
22.3569 +
22.3570 +.LP
22.3571 +.LP
22.3572 + HTML 若吾吟ф<障乗;腓冴障
22.3573 +.LP
22.3574 +.LP
22.3575 +\f2\ \ \ \ \ \fPA<B>C
22.3576 +.LP
22.3577 +.LP
22.3578 +羈鴻鴻\f2<B>\fP 紊絖с茹i障 (潟若潟)
22.3579 +.LP
22.3580 +.LP
22.3581 +潟若潟у罘純絎憗\f2{@code}\fP 篏睡障
22.3582 +.LP
22.3583 +.LP
22.3584 +
22.3585 +.LP
22.3586 +.RE
22.3587 +.RS 3
22.3588 +.TP 3
22.3589 +@param\ parameter\-name description
22.3590 +絎 \f2parameter\-name\fP 絎 \f2description\fP 篏睡<若帥Parameters祉激с潟菴遵障doc 潟<潟荐菴違\f2description\fP 茲域膓с障帥違<純潟潟鴻帥障鴻 doc 潟<潟с炊鴻с
22.3591 +.RE
22.3592 +
22.3593 +.LP
22.3594 +.RS 3
22.3595 +
22.3596 +.LP
22.3597 +.LP
22.3598 +\f2parameter\-name\fP <純障潟潟鴻帥с<若帥鴻<純障潟潟鴻帥帥ゃ<若帥障絮掩綣сс<若水蚊<若帥篏睡絎障
22.3599 +.LP
22.3600 +.LP
22.3601 +鴻<若帥箴:
22.3602 +.LP
22.3603 +.nf
22.3604 +\f3
22.3605 +.fl
22.3606 + /**
22.3607 +.fl
22.3608 + * @param <E> Type of element stored in a list
22.3609 +.fl
22.3610 + */
22.3611 +.fl
22.3612 + public interface List<E> extends Collection<E> {
22.3613 +.fl
22.3614 + }
22.3615 +.fl
22.3616 +
22.3617 +.fl
22.3618 +\fP
22.3619 +.fi
22.3620 +
22.3621 +.LP
22.3622 +.LP
22.3623 +<純<若帥箴:
22.3624 +.LP
22.3625 +.nf
22.3626 +\f3
22.3627 +.fl
22.3628 + /**
22.3629 +.fl
22.3630 + * @param string the string to be converted
22.3631 +.fl
22.3632 + * @param type the type to convert the string to
22.3633 +.fl
22.3634 + * @param <T> the type of the element
22.3635 +.fl
22.3636 + * @param <V> the value of the element
22.3637 +.fl
22.3638 + */
22.3639 +.fl
22.3640 + <T, V extends T> V convert(String string, Class<T> type) {
22.3641 +.fl
22.3642 + }
22.3643 +.fl
22.3644 +
22.3645 +.fl
22.3646 +\fP
22.3647 +.fi
22.3648 +
22.3649 +.LP
22.3650 +.LP
22.3651 +荅括完ゃ
22.3652 +.na
22.3653 +\f2@param 帥違ャ<潟\fP @
22.3654 +.fi
22.3655 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramс
22.3656 +.LP
22.3657 +.LP
22.3658 +
22.3659 +.LP
22.3660 +.RE
22.3661 +.RS 3
22.3662 .TP 3
22.3663 @return\ description
22.3664 -「戻り値」セクションを追加して、\f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。
22.3665 -.LP
22.3666 -詳細については、
22.3667 +[祉] 祉激с潟菴遵\f2description\fP 鴻吾莨若帥障鴻с祉ゃ緇ゃ膀蚊ゃ荐菴違綽荀障帥違<純ャ<潟若激с潟潟<潟с炊鴻с
22.3668 +.RE
22.3669 +
22.3670 +.LP
22.3671 +.RS 3
22.3672 +
22.3673 +.LP
22.3674 +.LP
22.3675 +荅括完ゃ
22.3676 +.na
22.3677 +\f2@return 帥違ャ<潟\fP @
22.3678 .fi
22.3679 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@return
22.3680 -の
22.3681 -.na
22.3682 -\f2@return タグのドキュメント\fPを参照してください。
22.3683 -.LP
22.3684 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnс
22.3685 +.LP
22.3686 +.LP
22.3687 +
22.3688 +.LP
22.3689 +.RE
22.3690 +.RS 3
22.3691 .TP 3
22.3692 -@see\ reference
22.3693 -「関連項目」見出しを追加し、\f2reference\fP を指すリンクか、またはテキストエントリを書き込みます。1 つのドキュメンテーションコメントには、任意の数の \f2@see\fP タグを指定できます。すべての \f2@see\fP タグの内容は、同じ見出しの下にグループ化されます。\f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。
22.3694 +@see\ \ reference
22.3695 +[∫i] 荀冴菴遵\f2reference\fP 潟障鴻潟吾莨若帥障1 ゃャ<潟若激с潟潟<潟篁紙違 \f2@see\fP 帥違絎с障 鴻 \f2@see\fP 帥違絎鴻荀冴筝違若障\f2@see\fP 帥違罨< 3 腮蕁綵√障 c鋎帥3 綵√с帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с宴若吾鴻障<潟若絲障ゃ潟ゃ潟潟筝水ャ号\f2{@link}\fP с
22.3696 .RS 3
22.3697 .TP 3
22.3698 @see "string"
22.3699 -string のテキストエントリを追加します。
22.3700 -リンクは生成されません。string は、書籍、または
22.3701 -URL ではアクセスできない情報の参照先です。
22.3702 -.B javadoc
22.3703 -ツールは、最初の文字が二重引用符 (") かどうかを調べて、
22.3704 -上の 2 つの形式とこの形式とを区
22.3705 -別します。次に例を示します。
22.3706 -.LP
22.3707 -.RS
22.3708 -.ft 3
22.3709 -.nf
22.3710 - @see "The Java Programming Language"
22.3711 -.fi
22.3712 -.ft 1
22.3713 -.LP
22.3714 -これは次のようなテキストを生成します。
22.3715 -.LP
22.3716 -.ft 3
22.3717 -.nf
22.3718 - 関連項目:
22.3719 - "The Java Programming Language"
22.3720 -.fi
22.3721 -.ft 1
22.3722 -.RE
22.3723 -.TP
22.3724 -\f3@see <a href="\f2URL#value\f3">\f2label\f3</a>\f1
22.3725 -.IR URL#value
22.3726 -で定義されたとおりにリンクを追加します。
22.3727 -.I URL#value
22.3728 -は、相対 URL または絶対 URL です。
22.3729 -.B javadoc
22.3730 -ツールは、最初の文字として、小なり括弧 (\f3<\f1) を探すことで、
22.3731 -このリンクをその他の場合と区別します。
22.3732 -.LP
22.3733 -.RS
22.3734 -.ft 3
22.3735 -.nf
22.3736 - @see <a href="spec.html#section">Java Spec</a>
22.3737 -.fi
22.3738 -.ft 1
22.3739 -.LP
22.3740 -これは次のようなリンクを生成します。
22.3741 -.LP
22.3742 -.ft 3
22.3743 -.nf
22.3744 - 関連項目:
22.3745 - Java Spec
22.3746 -.fi
22.3747 -.ft 1
22.3748 -.RE
22.3749 -.TP
22.3750 -.BI @see " package.class#member label"
22.3751 -参照される Java 言語で指定された名前のドキュメントを指す、
22.3752 -表示テキスト label を持つ
22.3753 -リンクを追加します。label は省略可能です。label を省略した場合は、
22.3754 -該当する名前が
22.3755 -適切に短くされて (「名前の表示方法」を参照)、
22.3756 -表示テキストとして代わりに表示されます。-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。
22.3757 -.LP
22.3758 -.RS
22.3759 -バージョン 1.2 では、ラベルではなく、名前だけが
22.3760 -HTML タグ
22.3761 -.B <code>
22.3762 -に囲まれて自動的に表示されます。バージョン 1.2.2 以降は、
22.3763 -.B <code>
22.3764 -は常に、ラベルが使用されているかどうかにかかわらず、
22.3765 -表示可能なテキストを囲みます。
22.3766 -.TP 2
22.3767 -\(bu
22.3768 -.I package.class#member
22.3769 -には、Java 言語で有効な任意の名前、つまりパッケージ、
22.3770 -クラス、インタフェース、
22.3771 -コンストラクタ、メソッド、またはフィールドの名前を指定します
22.3772 -。ただし、メンバ名の前の
22.3773 -ドットは、ハッシュ文字 (#) で置き換えます。
22.3774 -指定した名前が、ドキュメント化されるクラス
22.3775 -にある場合、
22.3776 -.B javadoc
22.3777 -ツールは該当する名前へのリンクを自動的に作成します。
22.3778 -外部参照クラスへのリンクを作成する
22.3779 -には、
22.3780 -.B \-link
22.3781 -オプションを使います。参照されるクラスに属していない名前の
22.3782 -ドキュメントを参
22.3783 -照するには、ほかの 2 つの形式の
22.3784 -.B @see
22.3785 -タグを使います。1 番目の引数については、「名前の指定」 で
22.3786 -詳しく説明します。
22.3787 -.TP 2
22.3788 -\(bu
22.3789 -.I label
22.3790 -は省略可能なテキストで、
22.3791 -リンクのラベルとして表示されます。label には空白を含
22.3792 -めることができます。label を省略した場合は、
22.3793 -.I package.class.member
22.3794 -が、現在のクラスおよびパッケージに応じて
22.3795 -適切に短くされて表示されます。「名前の表示方法」を参照してください。
22.3796 -.TP 2
22.3797 -\(bu
22.3798 -空白文字は
22.3799 -.I package.class#member
22.3800 -と
22.3801 -.IR label
22.3802 -の間の区切り文字です。括弧内の空白文字は、
22.3803 -ラベルの開始を意味しないため、
22.3804 -メソッドのパラメータ間のデリミタとして使うことができます。
22.3805 -.LP
22.3806 -例-この例では、Character クラスの
22.3807 -.B @see
22.3808 -タグが String クラスの equals メソッドを参照しています。
22.3809 -タグには、名前 \f3String#equals(Object)\f1 とラベル \f3equals\f1 の
22.3810 -両方の引数が含まれています。
22.3811 -.LP
22.3812 -.ft 3
22.3813 -.nf
22.3814 - /**
22.3815 - * @see String#equals(Object) equals
22.3816 - */
22.3817 -.fi
22.3818 -.ft 1
22.3819 -.LP
22.3820 -標準ドックレットは、次のような HTML を生成します。
22.3821 -.LP
22.3822 -.ft 3
22.3823 -.nf
22.3824 - <dl>
22.3825 - <dt><b>関連項目:</b>
22.3826 - <dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals</code></a>
22.3827 - </dl>
22.3828 -.fi
22.3829 -.ft 1
22.3830 -.LP
22.3831 -これは、ブラウザでは次のように表示され、
22.3832 -ラベルがリンクテキストになります。
22.3833 -.LP
22.3834 -.ft 3
22.3835 -.nf
22.3836 - 関連項目:
22.3837 - equals
22.3838 -.fi
22.3839 -.ft 1
22.3840 -.LP
22.3841 -.B 名前の指定:
22.3842 -この
22.3843 -.I package.class#member
22.3844 -の名前は、
22.3845 -.BR java.lang.String#toUpperCase()
22.3846 -のように完全指定することも、
22.3847 -.B String#toUpperCase()
22.3848 -や
22.3849 -.BR #toUpperCase()
22.3850 -などのように完全指定しないことも可能です。
22.3851 -完全指定しない場合、
22.3852 -.B javadoc
22.3853 -ツールは、通常の Java コンパイラの検索順序で検索を行います。
22.3854 -詳細は、以下の「
22.3855 -.BR @see
22.3856 -の検索順序」を参照してください。指定する名前では、
22.3857 -メソッドの複数の引数の型の間など、
22.3858 -括弧内に空白を含めることができます。
22.3859 -.LP
22.3860 -短い部分修飾名を指定することの利点は、入力する
22.3861 -文字数が減ることと、ソースコードが
22.3862 -読みやすくなることです。以下の表に示すのは、さまざまな
22.3863 -形式の名前です。Class には
22.3864 -クラスかインタフェース、Type にはクラス、インタフェース、
22.3865 -配列、または基本データ型、
22.3866 -method にはメソッドまたはコンストラクタを指定できます。
22.3867 -.LP
22.3868 -.LP
22.3869 -.TS
22.3870 -box;
22.3871 -lp-1.
22.3872 -@see package.class#member の一般的な形式
22.3873 -_
22.3874 -現在のクラスのメンバを参照する
22.3875 -@see #field
22.3876 -@see #method(Type, Type,...)
22.3877 -@see #method(Type argname, Type argname,...)
22.3878 -@see #constructor(Type, Type,...)
22.3879 -@see #constructor(Type argname, Type argname,...)
22.3880 -_
22.3881 -T{
22.3882 -現在の、またはインポートされたパッケージの別のクラスを参照する
22.3883 -T}
22.3884 -@see Class#field
22.3885 -@see Class#method(Type, Type,...)
22.3886 -@see Class#method(Type argname, Type argname,...)
22.3887 -@see Class#constructor(Type, Type,...)
22.3888 -T{
22.3889 -@see Class#constructor(Type argname, Type argname,...)
22.3890 -T}
22.3891 -@see Class.NestedClass
22.3892 -@see Class
22.3893 -_
22.3894 -別のパッケージの要素を参照する (完全修飾)
22.3895 -@see package.Class#field
22.3896 -@see package.Class#method(Type, Type,...)
22.3897 -@see package.Class#method(Type argname, Type argname,...)
22.3898 -@see package.Class#constructor(Type, Type,...)
22.3899 -T{
22.3900 -@see package.Class#constructor(Type argname, Type argname,...)
22.3901 -T}
22.3902 -@see package.Class.NestedClass
22.3903 -@see package.Class
22.3904 -@see package
22.3905 -.TE
22.3906 -.LP
22.3907 -上の表に対する注を以下に示します。
22.3908 -.LP
22.3909 -.TP 2
22.3910 -\(bu
22.3911 -クラスまたはパッケージを省いた最初の形式のセットでは、
22.3912 -.B javadoc
22.3913 -ツールは現在のクラス階層だけで検索を行います。
22.3914 -.B javadoc
22.3915 -ツールは、現在のクラスかインタフェースのメンバ、スーパークラスか
22.3916 -スーパーインタフェースの 1 つ、または
22.3917 -親クラスかインタフェースの 1 つ (検索手順 1 〜 3) を検索します。
22.3918 -現在のパッケージのほかの部分やほかのパッケージ (検索手順 4 〜 5) は
22.3919 -検索しません。
22.3920 -.TP 2
22.3921 -\(bu
22.3922 -メソッドまたはコンストラクタが、getValue のように
22.3923 -括弧を付けずに名前として入力され、
22.3924 -かつ同じ名前のフィールドがない場合は、
22.3925 -.B javadoc
22.3926 -ツールは正確にリンクを作成しますが、括弧と引数を追加するように
22.3927 -促す警告メッセージを出力
22.3928 -します。このメソッドをオーバーロードした場合、
22.3929 -.B javadoc
22.3930 -ツールは、指定されたメソッドではなく、検索で見つかった
22.3931 -最初のメソッドにリンクします。
22.3932 -.TP 2
22.3933 -\(bu
22.3934 -入れ子の内部クラスは、どの形式の場合でも、単に
22.3935 -.BR inner
22.3936 -という形ではなく、
22.3937 -.BR outer.inner
22.3938 -という形で指定しなければなりません。
22.3939 -.TP 2
22.3940 -\(bu
22.3941 -すでに述べたとおり、クラスとメンバを区切るのに、ドット (\f3.\f1) ではなく
22.3942 -ハッシュ文字 (\f3#\f1) が
22.3943 -使われていることに注意してください。ドットは、クラス、
22.3944 -入れ子のクラス、パッケージ、および
22.3945 -サブパッケージを区切るのにも使われます。
22.3946 -ただし、
22.3947 -.B javadoc
22.3948 -ツールでは一般に許容範囲が広く、
22.3949 -あいまいさがなければ、ドットでも正しく解析されます。
22.3950 -その場合でも警告は表示されます。
22.3951 -
22.3952 -.LP
22.3953 -.B @see の検索順序:
22.3954 -.B javadoc
22.3955 -は、ソースファイル (\f3.java\f1)、パッケージ
22.3956 -ファイル (\f3package.html\f1 か \f3package\-info.java\f1)、または
22.3957 -概要ファイル (\f3overview.html\f1) 内で使われる
22.3958 -.B @see
22.3959 -タグを処理します。
22.3960 -あとの 2 つのファイルでは、
22.3961 -.BR @see
22.3962 -を使って指定する名前を完全修飾する必要があります。
22.3963 -ソースファイルでは、完全修飾名
22.3964 -と部分修飾名のどちらを指定することもできます。
22.3965 -.LP
22.3966 -.B javadoc
22.3967 -ツールが、完全修飾されていない
22.3968 -.B .java
22.3969 -ファイルで
22.3970 -.B @see
22.3971 -タグを見つけた場合、指定された名前を Java コンパイラと
22.3972 -同じ順序で検索します。ただし、
22.3973 -.B javadoc
22.3974 -ツールは、一部の名前空間のあいまいさは検出しません。これは、
22.3975 -.B javadoc
22.3976 -ツールが、ソースコードにこれらのエラーが存在していないことを
22.3977 -前提として動作するためです。
22.3978 -検索順序は、「Java Language Specification」第 2 版の第 6 章「Names」で
22.3979 -正式に定義されています。具体的には、検索は次の順序で行われます。
22.3980 -.LP
22.3981 -.TP 4
22.3982 -1.
22.3983 -現在のクラスまたはインタフェース
22.3984 -.PD 0
22.3985 -.TP 4
22.3986 -2.
22.3987 -名前を囲むクラスとインタフェース。もっとも近いものを最初に検索
22.3988 -.TP 4
22.3989 -3.
22.3990 -スーパークラスとスーパーインタフェース。もっとも近いものを最初に検索
22.3991 -.TP 4
22.3992 -4.
22.3993 -現在のパッケージ
22.3994 -.TP 4
22.3995 -5.
22.3996 -インポートされるパッケージ、クラス、
22.3997 -およびインタフェース。import 文の順序に従って検索
22.3998 -.PD
22.3999 -.LP
22.4000 -.B javadoc
22.4001 -ツールは、一致する名前が見つかるまで、各クラスについて
22.4002 -手順 1 〜 3 を繰り返して検索を続け
22.4003 -ます。つまり、現在のクラスとそのクラスを囲む
22.4004 -クラス E を検索したあと、E のスーパクラスを
22.4005 -検索し、最後に E を囲むクラスを検索します。手順 4 と 5 では、
22.4006 -.B javadoc
22.4007 -ツールは、1 つのパッケージ内でのクラスまたはインタフェースの検索を、
22.4008 -なんらかの決まった順
22.4009 -序で行うわけではありません (この検索順序はコンパイラに依存します)。
22.4010 -手順 5 では、
22.4011 -.B javadoc
22.4012 -ツールは、
22.4013 -.BR java.lang
22.4014 -を検索します。これは、
22.4015 -.BR java.lang
22.4016 -がすべてのプログラムによって自動的にインポートされるためです。
22.4017 -.LP
22.4018 -.B javadoc
22.4019 -ツールは、必ずしもサブクラスを検索するわけではなく、Javadoc ツールの
22.4020 -実行中にほかのパッケージ
22.4021 -のドキュメントが生成される場合でも、ほかのパッケージの
22.4022 -検索は行いません。
22.4023 -たとえば、
22.4024 -.B @see
22.4025 -タグが
22.4026 -.B java.awt.event.KeyEvent
22.4027 -クラスにあって、
22.4028 -.B java.awt
22.4029 -パッケージにある名前を参照する場合、
22.4030 -.B javadoc
22.4031 -は、そのクラスがインポートしない限りそのパッケージを検索しません。
22.4032 -.LP
22.4033 -.B 名前の表示方法:
22.4034 -.I label
22.4035 -が省略された場合は、
22.4036 -.I package.class.member
22.4037 -が表示されます。通常、package.class.member は、現在の
22.4038 -クラスおよびパッケージに
22.4039 -応じて適切に短くされます。「短くされる」とは、
22.4040 -.B javadoc
22.4041 -ツールが必要最小限の名前を表示するということです。
22.4042 -たとえば、String.toUpperCase() メソッドが同じ
22.4043 -クラスのメンバへの参照と、別のクラスのメンバへの
22.4044 -参照を含んでいる場合、クラス名は後者の場合だけ表示されます。
22.4045 -.LP
22.4046 -パッケージ名を広域的に削除するには、\-noqualifier を使用します。
22.4047 -.br
22.4048 -.LP
22.4049 -.TP 4
22.4050 -.TS
22.4051 -box, center;
22.4052 -cbp-1 | cbp-1 | cbp-1
22.4053 -l | l | l .
22.4054 -参照の種類 T{
22.4055 -String.toUppercase() での例
22.4056 -T} 表示
22.4057 -_
22.4058 -T{
22.4059 -@see タグが同じクラス、同じパッケージのメンバを参照している
22.4060 -T} T{
22.4061 -@see String#toLowerCase()
22.4062 -T} T{
22.4063 -toLowerCase() (パッケージおよびクラス名は省略)
22.4064 -T}
22.4065 -_
22.4066 -T{
22.4067 -@see タグが異なるクラス、同じパッケージのメンバを参照している
22.4068 -T} T{
22.4069 -@see Character#toLowerCase(char)
22.4070 -T} T{
22.4071 -Character.toLowerCase(char) (パッケージ名は省略し、クラス名を含む)
22.4072 -T}
22.4073 -_
22.4074 -T{
22.4075 -@see タグが異なるクラス、異なるパッケージのメンバを参照している
22.4076 -T} T{
22.4077 -@see java.io.File#exists()
22.4078 -T} T{
22.4079 -java.io.File.exists() (パッケージ名とクラス名を含む)
22.4080 -T}
22.4081 -.TE
22.4082 -.LP
22.4083 -\f3@see の例\fP
22.4084 -.br
22.4085 -右側のコメントは、\f2@see\fP タグが別のパッケージ (\f2java.applet.Applet\fP など) のクラス内にある場合に、名前がどのように表示されるかを示しています。
22.4086 +\f2string\fP 鴻潟菴遵障潟障\f2string\fP 悟障 URL с≪祉鴻с宴усJavadoc 若絖篋綣膃 (\f2"\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
22.4087 .nf
22.4088 \f3
22.4089 .fl
22.4090 - See also:
22.4091 -.fl
22.4092 -@see java.lang.String // String \fP\f3
22.4093 -.fl
22.4094 -@see java.lang.String The String class // The String class \fP\f3
22.4095 -.fl
22.4096 -@see String // String \fP\f3
22.4097 -.fl
22.4098 -@see String#equals(Object) // String.equals(Object) \fP\f3
22.4099 -.fl
22.4100 -@see String#equals // String.equals(java.lang.Object) \fP\f3
22.4101 -.fl
22.4102 -@see java.lang.Object#wait(long) // java.lang.Object.wait(long) \fP\f3
22.4103 -.fl
22.4104 -@see Character#MAX_RADIX // Character.MAX_RADIX \fP\f3
22.4105 -.fl
22.4106 -@see <a href="spec.html">Java Spec</a> // Java Spec \fP\f3
22.4107 -.fl
22.4108 -@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
22.4109 + @see "The Java Programming Language"
22.4110 +.fl
22.4111 +
22.4112 .fl
22.4113 \fP
22.4114 .fi
22.4115 -.I @see
22.4116 -を、ドキュメント化の対象にしていないクラスにまで拡張するには、
22.4117 -.I -link
22.4118 -オプションを使用します。
22.4119 -.LP
22.4120 -詳細については、
22.4121 -.fi
22.4122 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@see
22.4123 -の
22.4124 -.na
22.4125 -\f2@see タグのドキュメント\fPを参照してください。
22.4126 +.LP
22.4127 +罨<鴻障
22.4128 +.RE
22.4129 +.RS 3
22.4130 +.RS 3
22.4131 +
22.4132 +.LP
22.4133 +.RS 3
22.4134 +.TP 3
22.4135 +∫i:
22.4136 +The Java Programming Language
22.4137 +.RE
22.4138 +
22.4139 +.LP
22.4140 +.RE
22.4141 .RE
22.4142 .TP 3
22.4143 -.BI @serial " field-description" | include | exclude
22.4144 -デフォルトの直列化可能フィールドの doc コメントで使用します。
22.4145 -.RS
22.4146 -.LP
22.4147 -省略可能な field-description は、
22.4148 -フィールドの doc コメントを拡張します。
22.4149 -この説明では、フィールドの意味および
22.4150 -取り得る値のリストを指定しなければなりません。
22.4151 -必要な場合には、複数の行にまたがって説明を記述することができます。
22.4152 -標準ドックレットは、この情報を、直列化された形式のページに追加します。
22.4153 -.LP
22.4154 -クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。
22.4155 -.LP
22.4156 -.BR include
22.4157 -と
22.4158 -.BR exclude
22.4159 -引数は、直列化された形式のページにクラスまたはパッケージを含めるべきか、
22.4160 -あるいはこれらの引数を除くべきかを指定します。
22.4161 -これらは、次のように動作します。
22.4162 -.LP
22.4163 -.TP 2
22.4164 -\(bu
22.4165 -.BR Serializable
22.4166 -を実装する public クラスまたは protected クラスは、
22.4167 -そのクラス (またはそのパッケージ) が
22.4168 -.BR @serial
22.4169 -.BR exclude
22.4170 -とマークされていない限り含められます。
22.4171 -.TP 2
22.4172 -\(bu
22.4173 -.BR Serializable
22.4174 -を実装する private クラスまたは package\-private クラスは、
22.4175 -そのクラス (またはそのパッケージ) が
22.4176 -.BR @serial
22.4177 -.BR include
22.4178 -とマークされていない限り除かれます。
22.4179 -.LP
22.4180 -例:
22.4181 -.BR javax.swing
22.4182 -パッケージは、(package.html または \f2package\-info.java\fP 内で)
22.4183 -.BR @serial
22.4184 -.BR exclude
22.4185 -とマークされます。
22.4186 -public クラスである
22.4187 -.BR java.sercurity.BasicPermission
22.4188 -は、
22.4189 -.BR @serial
22.4190 -.BR exclude
22.4191 -とマークされます。package\-private クラスである
22.4192 -.BR java.util.PropertyPermissionCollection
22.4193 -は、
22.4194 -.BR @serial
22.4195 -.BR include
22.4196 -とマークされます。
22.4197 -.LP
22.4198 -クラスレベルのタグ
22.4199 -.BR @serial
22.4200 -は、パッケージレベルの
22.4201 -.BR @serial
22.4202 -をオーバーライドします。
22.4203 -.LP
22.4204 -これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節「クラスの直列化可能なフィールドおよびデータの文書化」を参照してください。また、
22.4205 -.fi
22.4206 -http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missing
22.4207 -の
22.4208 -.na
22.4209 -「\f2直列化の FAQ\fP」も参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、
22.4210 -.fi
22.4211 -http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.html
22.4212 -の
22.4213 -.na
22.4214 -「\f2Sun の仕様\fP」も参照してください。
22.4215 -.LP
22.4216 -.RE
22.4217 -.TP
22.4218 -.BI @serialField " field-name field-type field-description"
22.4219 -Serializable クラスの serialPersistentFields メンバの ObjectStreamField コンポーネント
22.4220 -をドキュメント化します。各 ObjectStreamField コンポーネントに対して
22.4221 -.B @serialField
22.4222 -タグを 1 つ使う必要があります。
22.4223 -.TP
22.4224 -.BI @serialData " data-description"
22.4225 -.I data-description
22.4226 -は、直列化された形式でのデータの型と順序を
22.4227 -説明するテキストです。 このデータには、
22.4228 -特に、writeObject メソッドによって書き込まれる省略可能な
22.4229 -データ、および Externalizable.writeExternal メソッドによって
22.4230 -書き込まれるすべてのデータ (基底クラスを含む) が含まれます。
22.4231 -.TP
22.4232 -.B @serialData
22.4233 -タグは、writeObject、readObject、writeExternal、および readExternal の各メソッドの
22.4234 -doc コメントで使用できます。
22.4235 -.LP
22.4236 -.TP 3
22.4237 -@since\ since\-text
22.4238 -生成ドキュメントに「導入されたバージョン」見出しを追加し、指定された \f2since\-text\fP を書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。このタグは、特定の変更または機能が、\f2since\-text\fP に示されたソフトウェアリリース以降、存在していることを意味します。次に例を示します。
22.4239 +@see <a href="URL#value">label</a>
22.4240 +\f2URL\fP#\f2value\fP у臂潟菴遵障\f2URL\fP#\f2value\fP 後 URL 障腟九 URL сJavadoc 若絖絨荐 (\f2<\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
22.4241 .nf
22.4242 \f3
22.4243 .fl
22.4244 - @since 1.5
22.4245 + @see <a href="spec.html#section">Java Spec</a>
22.4246 +.fl
22.4247 +
22.4248 .fl
22.4249 \fP
22.4250 .fi
22.4251 -Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。
22.4252 +.LP
22.4253 +罨<潟障
22.4254 +.RS 3
22.4255 +.RS 3
22.4256 +.TP 3
22.4257 +∫i:
22.4258 +Java Spec
22.4259 .RE
22.4260 -.TP
22.4261 -.BI @throws " class-name description"
22.4262 -.B @throws
22.4263 -タグと
22.4264 -.B @exception
22.4265 -タグは同義です。生成されるドキュメンテーションに、
22.4266 -.I class-name
22.4267 -および
22.4268 -.I description
22.4269 -テキストを持つ [例外] 小見出しを追加します。
22.4270 -.I class-name
22.4271 -は、該当するメソッドによって
22.4272 -スローされる可能性のある例外の名前です。このタグは、doc コメントまたはコンストラクタでのみ有効です。このクラスが完全
22.4273 -修飾されていない場合、
22.4274 -.B javadoc
22.4275 -ツールは検索順序に従ってクラスを探します。
22.4276 -同じまたは異なる例外の doc コメントで、
22.4277 -複数の @throws タグを使用できます。
22.4278 -.LP
22.4279 -すべてのチェック済み例外がドキュメント化されるようにするために、
22.4280 -@throws タグが throws 節内の例外用に存在しない場合は、
22.4281 -@throws タグのあるドキュメントであるかのように、
22.4282 -.B Javadoc
22.4283 -ツールによって例外が HTML 出力に説明なしで
22.4284 -自動的に追加されます。
22.4285 -.LP
22.4286 -オーバーライドされたメソッドで明示的に例外が宣言されている場合に限って、
22.4287 -オーバーライドされたメソッドからサブクラスへ
22.4288 -@throws ドキュメントがコピーされます。
22.4289 -インタフェースメソッドから実装メソッドにコピーされる場合も
22.4290 -同様です。{@inheritDoc} を使用して、継承ドキュメントに対して
22.4291 -強制的に @throws を適用することも可能です。
22.4292 -.LP
22.4293 -詳細は
22.4294 -.fi
22.4295 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exception
22.4296 -の
22.4297 -.na
22.4298 -\f2@throws タグのドキュメント\fPを参照してください。
22.4299 -.TP
22.4300 -.B {@value package.class#field}
22.4301 -{@value} が静的フィールドの doc コメントで
22.4302 -引数なしで使用されている場合、その定数の値が表示されます。
22.4303 -.LP
22.4304 -.RS 5
22.4305 -.nf
22.4306 -/**
22.4307 -* The value of this constant is {@value}.
22.4308 -*/
22.4309 -public static final String SCRIPT_START = "<script>"
22.4310 -.fi
22.4311 .RE
22.4312 -.LP
22.4313 -任意の doc コメント内で引数
22.4314 -.B package.class#field
22.4315 - ありで使用されている場合は、指定した定数の値が表示されます。
22.4316 -.LP
22.4317 -.RS 5
22.4318 -.nf
22.4319 -/**
22.4320 -* Evaluates the script starting with {@value #SCRIPT_START}.
22.4321 -*/
22.4322 -public String evalScript(String script) {
22.4323 -}
22.4324 -.fi
22.4325 .RE
22.4326 -.LP
22.4327 -引数 package.class#field は、@see 引数と同一の形式になります。
22.4328 -ただし、メンバが静的フィールドになければならない点が異なります。
22.4329 -.LP
22.4330 -これらの定数での値は、「定数フィールド値」ページにも表示されます。
22.4331 -.TP
22.4332 -.BI @version " version-text"
22.4333 -\-version オプションが使われている場合、生成ドキュメントに「バージョン」小見出しを追加して、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。\f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。
22.4334 -.LP
22.4335 -1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。必要に応じて、\f2@version\fP タグごとに 1 つのバージョン番号を指定することも、タグごとに複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって、名前と名前の間にコンマ (\f2,\fP) とスペースが挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要がある場合は、1 つのタグに複数の名前を指定できます。
22.4336 -.LP
22.4337 -詳細については、
22.4338 -.fi
22.4339 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@version
22.4340 -の
22.4341 -.na
22.4342 -\f2@version タグのドキュメント\fPを参照してください。
22.4343 -.SS "タグを使用できる場所"
22.4344 -以下では、タグを使用できる場所について説明します。@see、@since、@deprecated、{@link}、{@linkplain} および {@docroot} のタグは、すべての doc コメントで使用できます。
22.4345 -.SS "概要ドキュメントタグ"
22.4346 -概要タグは、概要ページのドキュメント
22.4347 -コメント (通常は \f3overview.html\f1
22.4348 -という名前のソースファイル内にある) で使用できるタグです。
22.4349 -ほかのドキュメント
22.4350 -コメントと同様に、これらのタグは、説明のあとで使う必要があります。
22.4351 -.LP
22.4352 -注:バージョン 1.2 では、概要ドキュメント内の {\f3@link\f1} タグに
22.4353 -バグがあります。テキストは適切に表示されますが、
22.4354 -リンクが設定されません。
22.4355 -現在のところ、{\f2@docRoot\f1} タグは、
22.4356 -概要ドキュメント内では動作しません。
22.4357 -.LP
22.4358 -.LP
22.4359 -.TS
22.4360 -;
22.4361 -cbp-1
22.4362 -l .
22.4363 -概要タグ
22.4364 -@see
22.4365 -@since
22.4366 -@author
22.4367 -@version
22.4368 -{@link}
22.4369 -{@linkplain}
22.4370 -{@docRoot}
22.4371 -.TE
22.4372 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
22.4373 -
22.4374 -.LP
22.4375 -.SS "パッケージドキュメントタグ"
22.4376 -パッケージタグは、パッケージのドキュメント
22.4377 -コメント (\f3package.html\f1 または \f2package\-info.java\fP という
22.4378 -名前のソースファイルに存在) で使用できるタグです。
22.4379 -ここで使用できる @serial タグは、include または
22.4380 -exclude 引数を指定したものだけです。
22.4381 -.LP
22.4382 -.LP
22.4383 -.TS
22.4384 -;
22.4385 -cbp-1
22.4386 -l .
22.4387 -パッケージタグ
22.4388 -@see
22.4389 -@since
22.4390 -@serial
22.4391 -@author
22.4392 -@version
22.4393 -{@link}
22.4394 -{@linkplain}
22.4395 -{@docRoot}
22.4396 -.TE
22.4397 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
22.4398 -
22.4399 -.LP
22.4400 -.SS "クラスおよびインタフェースドキュメントタグ"
22.4401 -次に示すのは、クラスまたはインタフェースのドキュメント
22.4402 -コメントで使用できるタグです。
22.4403 -ここで使用できる @serial タグは、
22.4404 -include または exclude 引数を指定したものだけです。
22.4405 -.LP
22.4406 -.LP
22.4407 -.TS
22.4408 -;
22.4409 -cbp-1
22.4410 -l .
22.4411 -クラスおよびインタフェースタグ
22.4412 -@see
22.4413 -@since
22.4414 -@deprecated
22.4415 -@serial
22.4416 -@author
22.4417 -@version
22.4418 -{@link}
22.4419 -{@linkplain}
22.4420 -{@docRoot}
22.4421 -.TE
22.4422 -
22.4423 -.LP
22.4424 -次は、クラスコメントの例です。
22.4425 -.LP
22.4426 -.RS
22.4427 -.ft 3
22.4428 -.nf
22.4429 -/**
22.4430 -* A class representing a window on the screen.
22.4431 -* For example:
22.4432 -* <pre>
22.4433 -* Window win = new Window(parent);
22.4434 -* win.show();
22.4435 -* </pre>
22.4436 -*
22.4437 -* @author Sami Shaio
22.4438 -* @version 1.13, 06/08/06
22.4439 -* @see java.awt.BaseWindow
22.4440 -* @see java.awt.Button
22.4441 -*/
22.4442 -class Window extends BaseWindow {
22.4443 -...
22.4444 -}
22.4445 -.fi
22.4446 -.ft 1
22.4447 +.RS 3
22.4448 +
22.4449 +.LP
22.4450 +.LP
22.4451 +
22.4452 +.LP
22.4453 .RE
22.4454 -.SS "フィールドドキュメントタグ"
22.4455 -次に示すのは、フィールドのドキュメンテーションコメントで
22.4456 -使用できるタグです。
22.4457 -.LP
22.4458 -.LP
22.4459 -.TS
22.4460 -;
22.4461 -cbp-1
22.4462 -l .
22.4463 -フィールドタグ
22.4464 -@see
22.4465 -@since
22.4466 -@deprecated
22.4467 -@serial
22.4468 -@serialField
22.4469 -{@link}
22.4470 -{@linkplain}
22.4471 -{@docRoot}
22.4472 -{@value}
22.4473 -.TE
22.4474 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
22.4475 -
22.4476 -.LP
22.4477 -次は、フィールドコメントの例です。
22.4478 -.LP
22.4479 -.RS
22.4480 -.ft 3
22.4481 -.nf
22.4482 -/**
22.4483 -* The X-coordinate of the component.
22.4484 -*
22.4485 -* @see #getLocation()
22.4486 -*/
22.4487 -int x = 1263732;
22.4488 -.fi
22.4489 -.ft 1
22.4490 -.RE
22.4491 -.SS "コンストラクタおよびメソッドドキュメントタグ"
22.4492 -次に、コンストラクタまたはメソッドのドキュメンテーションコメント内で表示できるタグを示します。ただし、@return はコンストラクタでは表示できず、{@inheritDoc} は
22.4493 -表示に制限があります。@serialData タグは特定の直列化メソッドの doc コメントでのみ使用できます。
22.4494 -.LP
22.4495 -.LP
22.4496 -.TS
22.4497 -;
22.4498 -cbp-1
22.4499 -l .
22.4500 -メソッドおよびコンストラクタタグ
22.4501 -@see
22.4502 -@since
22.4503 -@deprecated
22.4504 -@param
22.4505 -@return
22.4506 -@throws and @exception
22.4507 -@serialData
22.4508 -{@link}
22.4509 -{@linkplain}
22.4510 -{@inheritDoc}
22.4511 -{@docRoot}
22.4512 -.TE
22.4513 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
22.4514 -
22.4515 -.LP
22.4516 -次はメソッドの doc コメントの例です。
22.4517 -.LP
22.4518 -.RS
22.4519 -.ft 3
22.4520 -.nf
22.4521 -/**
22.4522 -* Returns the character at the specified index. An index
22.4523 -* ranges from <code>0</code> to <code>length() - 1</code>.
22.4524 -*
22.4525 -* @param index the index of the desired character.
22.4526 -* @return the desired character.
22.4527 -* @exception StringIndexOutOfRangeException
22.4528 -* if the index is not in the range <code>0</code>
22.4529 -* to <code>length()-1</code>.
22.4530 -* @see java.lang.Character#charValue()
22.4531 -*/
22.4532 -public char charAt(int index) {
22.4533 -...
22.4534 -}
22.4535 -.fi
22.4536 -.ft 1
22.4537 -.RE
22.4538 -.SH "オプション"
22.4539 -.B javadoc
22.4540 -ツールは、ドックレットを使って出力を決定します。
22.4541 -.B javadoc
22.4542 -ツールは、
22.4543 -.B \-doclet
22.4544 -オプションでカスタムドックレットが指定されている場合以外は、
22.4545 -デフォルトの標準ドック
22.4546 -レットを使います。
22.4547 -.B javadoc
22.4548 -ツールには、任意のドックレットとともに使用できるコマンド行
22.4549 -オプションがあります。これらのオプ
22.4550 -ションについては、後述の「javadoc のオプション」で説明します。
22.4551 -標準ドックレットでは、こ
22.4552 -のほかに、いくつかの追加のコマンド行オプションが提供されます。
22.4553 -これらのオプションに
22.4554 -ついては、後述の「標準ドックレットが提供するオプション」で
22.4555 -説明します。どのオプション
22.4556 -名も大文字と小文字を区別しません。ただし、オプションの引数では
22.4557 -大文字と小文字が区
22.4558 -別されることがあります。
22.4559 -.LP
22.4560 -オプションを以下に示します。
22.4561 -.LP
22.4562 .RS 3
22.4563 -
22.4564 -.LP
22.4565 -.LP
22.4566 -.TS
22.4567 -center;
22.4568 -li l li
22.4569 -l li li
22.4570 -li l li
22.4571 -l li li
22.4572 -li l l
22.4573 -l l li
22.4574 -li l li
22.4575 -l l l
22.4576 -l li l
22.4577 -l l li
22.4578 -li l l
22.4579 -li l l
22.4580 -l l l
22.4581 -li l l
22.4582 -li l l
22.4583 -l l li
22.4584 -li l l
22.4585 -l l l
22.4586 -l l l
22.4587 -l li l
22.4588 -l li l.
22.4589 --1.1 -header -private
22.4590 --author -help -protected
22.4591 --bootclasspath -helpfile -public
22.4592 --bottom -J -quiet
22.4593 --breakiterator -keywords -serialwarn
22.4594 --charset -link -source
22.4595 --classpath -linkoffline -sourcepath
22.4596 --d -linksource -splitindex
22.4597 --docencoding -locale -stylesheetfile
22.4598 --docfilessubdirs -nocomment -subpackages
22.4599 --doclet -nodeprecated -tag
22.4600 --docletpath -nodeprecatedlist -taglet
22.4601 --doctitle -nohelp -tagletpath
22.4602 --encoding -noindex -title
22.4603 --exclude -nonavbar -use
22.4604 --excludedocfilessubdir -noqualifier -verbose
22.4605 --extdirs -nosince -version
22.4606 --footer -notimestamp -windowtitle
22.4607 --group -notree
22.4608 - -overview
22.4609 - -package
22.4610 -.TE
22.4611 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
22.4612 -
22.4613 -.LP
22.4614 -.RE
22.4615 -.LP
22.4616 -\f2下線付き\fPで示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、下線付きでないオプションを提供します。
22.4617 -.LP
22.4618 -.SS "Javadoc のオプション"
22.4619 -.TP
22.4620 -.BI \-overview " path/filename"
22.4621 -.B javadoc
22.4622 -に対して、
22.4623 -.I path/filename
22.4624 -で指定された「ソース」ファイルから
22.4625 -概要ドキュメント用のテキスト
22.4626 -を取得し、概要ページ (\f3overview-summary.html\f1) に配置することを
22.4627 -指示します。
22.4628 -.I path/filename
22.4629 -は、
22.4630 -.BR \-sourcepath
22.4631 -への相対パスです。
22.4632 -.LP
22.4633 -.RS
22.4634 -.I filename
22.4635 -と
22.4636 -.IR path
22.4637 -には、それぞれ任意の名前と場所を指定できますが、通常は、
22.4638 -.B overview.html
22.4639 -という名前を付けて、ソースツリー内の最上位の
22.4640 -パッケージディレクトリを含むディレクトリ
22.4641 -に配置します。この場所では、
22.4642 -.B \-sourcepath
22.4643 -がこのファイルを指すので、パッケージを
22.4644 -ドキュメント化する際に path が必要ありません。
22.4645 -たとえば、java.lang パッケージのソースツリーが
22.4646 -.BR /src/classes/java/lang/
22.4647 -の場合、概要ファイルを
22.4648 -.BR /src/classes/overview.html
22.4649 -に配置できます。「使用例」を参照してください。
22.4650 -.LP
22.4651 -.IR path/filename
22.4652 -で指定するファイルについては、
22.4653 -「概要コメントファイル」を参照してください。
22.4654 -.LP
22.4655 -概要ページが作成されるのは、
22.4656 -.B javadoc
22.4657 -に 2 つ以上のパッケージ名を渡した場合だけです。
22.4658 -詳細は、「HTML フレーム」
22.4659 -節を参照してください。
22.4660 -.LP
22.4661 -概要ページのタイトルは、
22.4662 -.B \-doctitle
22.4663 -によって設定されます。
22.4664 -.RE
22.4665 -.TP
22.4666 -.B \-public
22.4667 -public なクラスとメンバだけを表示します。
22.4668 -.TP
22.4669 -.B \-protected
22.4670 -protected および public なクラスとメンバだけを表示します。
22.4671 -これはデフォルトの動作です。
22.4672 -.TP
22.4673 -.B \-package
22.4674 -パッケージ、および protected と public な
22.4675 -クラスとメンバだけを表示します。
22.4676 -.TP
22.4677 -.B \-private
22.4678 -すべてのクラスとメンバを表示します。
22.4679 -.TP
22.4680 -.B \-help
22.4681 -オンラインヘルプを表示します。
22.4682 -.B javadoc
22.4683 -とドックレットのコマンド行オプションの一覧が表示されます。
22.4684 -.TP
22.4685 -.BI \-doclet " class"
22.4686 -ドキュメントの生成に使う
22.4687 -ドックレットを起動するためのクラスファイルを指定します。
22.4688 -完全指定の名前を指定してください。
22.4689 -ドックレットでは、出力の内容と形式を定義します。
22.4690 -.B \-doclet
22.4691 -オプションが使われていない場合、
22.4692 -.B javadoc
22.4693 -は標準ドックレットを使ってデフォルトの HTML 形式を生成します。
22.4694 -このクラスには、
22.4695 -start(Root) メソッドが含まれていなければなりません。
22.4696 -この起動クラスへのパスは、
22.4697 -.B \-docletpath
22.4698 -オプションによって定義されます。
22.4699 -.LP
22.4700 -たとえば、MIF ドックレットを呼び出すには、次のように指定します。
22.4701 -.LP
22.4702 -.RS
22.4703 -.ft 3
22.4704 -.nf
22.4705 - -doclet com.sun.tools.doclets.mif.MIFDoclet
22.4706 -.fi
22.4707 -.ft 1
22.4708 -.LP
22.4709 -特定のドックレットを実行した完全な例については、
22.4710 -.fi
22.4711 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet
22.4712 -の
22.4713 -.na
22.4714 -「\f2Running the MIF Doclet\fP」を参照してください。
22.4715 -.RE
22.4716 -.TP
22.4717 -.BI \-docletpath " classpathlist"
22.4718 -.B \-doclet
22.4719 -オプションで指定されているドックレットクラスファイル、
22.4720 -およびそれに依存する jar ファイルへのパスを指定します。
22.4721 -起動クラスファイルが jar ファイル内にある場合、
22.4722 -例に従って、その jar ファイルへのパスを指定します。
22.4723 -絶対パス、または現在のディレクトリからの相対パスを指定できます。
22.4724 -.IR classpathlist
22.4725 -には、複数のパスまたは jar ファイルを含める
22.4726 -ことができます。その場合、各パスまたは jar ファイルを Solaris ではコロン (\f3:\f1)で、Windows ではセミコロン (;) で区切ります。
22.4727 -目的のドックレットの開始クラスがすでに検索パス内にある場合は、
22.4728 -このオプションは不要です。
22.4729 -.LP
22.4730 -次の例の jar ファイルへのパスには、ドックレットの
22.4731 -開始クラスファイルが含まれています。
22.4732 -jar ファイル名が含まれている点に注意してください。
22.4733 -.nf
22.4734 -\f3
22.4735 -.fl
22.4736 - \-docletpath /home/user/mifdoclet/lib/mifdoclet.jar
22.4737 -.fl
22.4738 -\fP
22.4739 -.fi
22.4740 -次はドックレットの開始クラスファイルのパスの例です。
22.4741 -クラスファイル名が省略されていることに注意してください。
22.4742 -.nf
22.4743 -\f3
22.4744 -.fl
22.4745 - \-docletpath /home/user/mifdoclet/classes/com/sun/tools/doclets/mif/
22.4746 -.fl
22.4747 -\fP
22.4748 -.fi
22.4749 -特定のドックレットを実行した完全な例については、
22.4750 -.fi
22.4751 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet
22.4752 -の
22.4753 -.na
22.4754 -「\f2Running the MIF Doclet\fP」を参照してください。
22.4755 -.RE
22.4756 -.LP
22.4757 -.TP
22.4758 -.B \-1.1
22.4759 -この機能は、javadoc 1.4 から削除されました。代替の機能は
22.4760 -存在しません。このオプションは、javadoc 1.1 で生成される
22.4761 -ドキュメントの外観と機能 (サポートされなくなった、入れ子になったクラスを
22.4762 -含む) を備えたドキュメントを作成するためのものでした。
22.4763 -このオプションが必要であれば、代わ
22.4764 -りに javadoc 1.2 または 1.3 を使用してください。
22.4765 .TP 3
22.4766 -\-source release
22.4767 -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
22.4768 -.LP
22.4769 -.TS
22.4770 -;
22.4771 -l l.
22.4772 -1.5 T{
22.4773 -Javadoc は、JDK 1.5 で導入された総称機能および他の言語機能を含んだコードを受け付けます。-source フラグを指定しないと、コンパイラはデフォルトとして 1.5 の動作をします。
22.4774 -T}
22.4775 -1.4 T{
22.4776 -Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
22.4777 -T}
22.4778 -1.3 T{
22.4779 -Javadoc は、JDK 1.3 以降に導入されたアサーション、総称機能、または他の言語機能をサポートしません。
22.4780 -T}
22.4781 -.TE
22.4782 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
22.4783 -.LP
22.4784 -javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。
22.4785 -.LP
22.4786 -.TP
22.4787 -.BI \-sourcepath " sourcepathlist"
22.4788 -.B javadoc
22.4789 -コマンドにパッケージ名または \-subpackages
22.4790 -を渡す際に、
22.4791 -ソースファイル (.java) 検索用のパスを指定します。
22.4792 -.BI sourcepathlist
22.4793 -には、コロン (\f3:\f1)
22.4794 -で区切った複数のパスを含めることができます。
22.4795 -.B Javadoc
22.4796 -ツールは、指定されたパス以下のすべての
22.4797 -サブディレクトリを検索します。 このオプションを使って、
22.4798 -ドキュメント化されるソースファイルの位置だけでなく、
22.4799 -それ自体はドキュメント化されていないが、ドキュメント化
22.4800 -されているソースファイルから継承されたコメントをもつ
22.4801 -ソースファイルの位置も確認できます。
22.4802 -.LP
22.4803 -.B \-sourcepath
22.4804 -オプションは、
22.4805 -.B javadoc
22.4806 -コマンドを使ってパッケージ名を指定するときにだけ使用でき、
22.4807 -.B javadoc
22.4808 -コマンドに渡される
22.4809 -.B .java
22.4810 -ファイルは検索できないことに注意してください。
22.4811 -.B .java
22.4812 -ファイルを検索するには、
22.4813 -そのディレクトリに移動するか、
22.4814 -各ファイルの前にそのパスを付けます (「1 つ以上
22.4815 -のパッケージのドキュメント化」を参照)。
22.4816 -.B \-sourcepath
22.4817 -が省略された場合は、
22.4818 -.B javadoc
22.4819 -はクラスパスを使ってソースファイルを検索します (
22.4820 -.B \-classpath
22.4821 -を参照)。 したがって、
22.4822 -.B \-sourcepath
22.4823 -のデフォルトは
22.4824 -.B \-classpath
22.4825 -の値です。
22.4826 -.B -classpath
22.4827 -を省略してパッケージ名を
22.4828 -.BR javadoc
22.4829 -に渡した場合、
22.4830 -.BR javadoc
22.4831 -は、ソースファイルの現在のディレクトリ (およびサブディレクトリ) を
22.4832 -検索します。
22.4833 -.LP
22.4834 -.RS
22.4835 -.I sourcepathlist
22.4836 -では、ドキュメント化するパッケージ名の
22.4837 -ソースツリーのルートディレクトリを
22.4838 -設定します。たとえば、ソースファイルが次の
22.4839 -場所にある
22.4840 -.B com.mypackage
22.4841 -という名前のパッケージをドキュメント化するとします。
22.4842 -.LP
22.4843 -.RS
22.4844 -.ft 3
22.4845 -.nf
22.4846 -/home/user/src/com/mypackage/*.java
22.4847 -.fi
22.4848 -.ft 1
22.4849 -.RE
22.4850 -.LP
22.4851 -この場合、次のようにしてソースパスを
22.4852 -.BR /home/user/src
22.4853 -、つまり
22.4854 -.BR com.mypackage
22.4855 -を含むディレクトリに指定し、それからパッケージ名
22.4856 -.BR com.mypackage
22.4857 -を指定します。
22.4858 -.LP
22.4859 -.RS
22.4860 -.ft 3
22.4861 -.nf
22.4862 -% javadoc \-sourcepath /home/user/src/ com.mypackage
22.4863 -.fi
22.4864 -.ft 1
22.4865 -.RE
22.4866 -.LP
22.4867 -これは、ソースパスの値とパッケージ名をつなげて、
22.4868 -ドットをスラッシュ (/) に変えると、以下のパッケージのフルパス
22.4869 -になることに注目すると覚えやすいでしょう。
22.4870 -.LP
22.4871 -.RS
22.4872 -.ft 3
22.4873 -.BR /home/user/src/com/mypackage
22.4874 -.RE
22.4875 -.LP
22.4876 -2 つのソースパスを指定するには、次のようにします。
22.4877 -.LP
22.4878 -.RS
22.4879 -.ft 3
22.4880 -.nf
22.4881 -% javadoc \-sourcepath /home/user/src/:/home/user2/src com.mypackage
22.4882 -.fi
22.4883 -.ft 1
22.4884 -.RE
22.4885 -.LP
22.4886 -.RE
22.4887 -.TP
22.4888 -.BI \-classpath " classpathlist"
22.4889 -.B javadoc
22.4890 -が参照されるクラスの検索を行うパスを指定します。
22.4891 -参照されるクラス (\f3.class\f1) とは、
22.4892 -ドキュメント化されるクラスとそれらのクラスによって
22.4893 -参照される任意のクラスのことです。
22.4894 -.B javadoc
22.4895 -は、指定されたパス以下のすべてのサブディレクトリで
22.4896 -検索を行います。
22.4897 -.I classpathlist
22.4898 -には、パス間をコロン (\f3:\f1) で区切って複数のパスを
22.4899 -含めることができます。
22.4900 -.B javadoc
22.4901 -ツールは、指定されたパス以下の
22.4902 -すべてのサブディレクトリを検索します。
22.4903 -.IR classpathlist
22.4904 -の指定
22.4905 -については、クラスパスのドキュメントを参照してください。
22.4906 -.LP
22.4907 -.RS
22.4908 -.B \-sourcepath
22.4909 -を省略した場合は、
22.4910 -.B javadoc
22.4911 -ツールは、クラスファイル (下位互換用) とともに、
22.4912 -.B \-classpath
22.4913 -を使ってソースファイルを検索します。このため、
22.4914 -異なるパス内のソースファイルおよびクラスファイルを検索する場合は、
22.4915 -.B \-sourcepath
22.4916 -と
22.4917 -.BR \-classpath
22.4918 -の両方を使います。
22.4919 -.LP
22.4920 -たとえば、
22.4921 -.BR com.mypackage
22.4922 -をドキュメント化したい場合に、パッケージのクラスがディレクトリ
22.4923 -.BR /home/user/src/com/mypackage
22.4924 -にあり、このパッケージが
22.4925 -.BR /home/user/lib
22.4926 -内のライブラリを使う場合は、次のように指定します。
22.4927 -.LP
22.4928 -.RS
22.4929 -.ft 3
22.4930 -.nf
22.4931 -% javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage
22.4932 -.fi
22.4933 -.ft 1
22.4934 -.RE
22.4935 -.LP
22.4936 -ほかのツールと同様に、
22.4937 -.BR \-classpath
22.4938 -を指定しない場合は、CLASSPATH 環境変数が
22.4939 -設定されていれば、
22.4940 -.B javadoc
22.4941 -ツールはこの環境変数を使います。
22.4942 -どちらも設定されていない場合
22.4943 -は、
22.4944 -.B javadoc
22.4945 -ツールは現在のディレクトリでクラスを検索します。
22.4946 -.LP
22.4947 -.B javadoc
22.4948 -ツールが拡張機能クラスおよびブートストラップクラスと通信する際に、
22.4949 -.B -classpath
22.4950 -を使ってユーザクラスを検索する方法についての
22.4951 -詳細は、「クラスの検索方法」を
22.4952 -参照してください。
22.4953 -.LP
22.4954 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じであるとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
22.4955 -.br
22.4956 -.br
22.4957 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しなどの環境に対する問い合わせを行わない限り、展開されていないワイルドカードを Java プログラムが認識することはありません。
22.4958 -.LP
22.4959 -.TP 3
22.4960 -\-subpackages\ \ package1:package2:...
22.4961 -ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソースコードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。各 package 引数は、任意の最上位サブパッケージ (java など) または完全指定のパッケージ (javax.swing など) になります。ソースファイルを含める必要はありません。引数は、コロンで区切られます (すべてのオペレーティングシステム)。ワイルドカードは不要です (使用不可)。パッケージの検索場所を指定するには、\-sourcepath を使用します。このオプションは、「ソースファイルの処理」で説明したとおり、ソースツリーにあるがパッケージには属していないソースファイルを処理しないので役立ちます。
22.4962 -.LP
22.4963 -次に例を示します。
22.4964 -.nf
22.4965 -\f3
22.4966 -.fl
22.4967 - % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
22.4968 -.fl
22.4969 -.fi
22.4970 -このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。
22.4971 -.LP
22.4972 -\f2\-exclude\fP とともに \f2\-subpackages\fP を使用すると、特定のパッケージを除外できます。
22.4973 -.LP
22.4974 -.TP 3
22.4975 -\-exclude\ \ packagename1:packagename2:...
22.4976 -指定されたパッケージとそのサブパッケージを \f2\-subpackages\fP によって作成されたリストから無条件に除外します。過去の \f2\-subpackages\fP オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。次に例を示します。
22.4977 -.nf
22.4978 -\f3
22.4979 -.fl
22.4980 - % \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
22.4981 -.fl
22.4982 -.fi
22.4983 -このうち、\f2java.io\fP、\f2java.util\fP、\f2java.math\fP は組み込まれますが、\f2java.net\fP と \f2java.lang\fP 以下のパッケージは除外されます。ただし、\f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP は除外されます。
22.4984 -.RE
22.4985 -.TP
22.4986 -.BI \-bootclasspath " classpathlist"
22.4987 -ブートクラスが存在するパスを指定します。
22.4988 -ブートクラスとは、Java プラットフォームクラスのことです。
22.4989 -.B bootclasspath
22.4990 -は、
22.4991 -.B javadoc
22.4992 -ツールがソースファイルとクラスファイルを探すときに
22.4993 -使う検索パスの一部です。詳細は、
22.4994 -「Javac と Javadoc がクラスを検索する方法」 を
22.4995 -参照してください。
22.4996 -.I classpathlist
22.4997 -内の複数の
22.4998 -クラスパスリストは、コロン (:) で区切ります。
22.4999 -.TP
22.5000 -.BI \-extdirs " dirlist"
22.5001 -拡張機能クラスが存在するディレクトリを指定します。
22.5002 -拡張機能クラスは、Java 拡張機能
22.5003 -機構を使うすべてのクラスです。拡張機能ディレクトリ (
22.5004 -.B extdirs
22.5005 -) は、
22.5006 -.B javadoc
22.5007 -ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。
22.5008 -詳細は、上の
22.5009 -.B \-classpath
22.5010 -を参照してください。
22.5011 -.I dirlist
22.5012 -内の複数のディレクトリは、
22.5013 -コロン (:) で区切ります。
22.5014 -.TP
22.5015 -.B \-verbose
22.5016 -.B javadoc
22.5017 -の実行中に詳細なメッセージを表示します。冗長オプションを
22.5018 -指定しない場合は、ソースファイルのロード時、ドキュメントの
22.5019 -生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時に
22.5020 -メッセージが表示されます。冗長オプションを指定した場合は、
22.5021 -各 java ソースファイルの解析に要したミリ秒数などの
22.5022 -追加メッセージを表示します。
22.5023 -.TP
22.5024 -.BI \-quiet
22.5025 -エラーメッセージ以外、および警告メッセージ以外の
22.5026 -メッセージを除外し、
22.5027 -エラーメッセージおよび警告メッセージだけを
22.5028 -表示して見つけやすくします。
22.5029 -また、バージョン文字列の表示も抑制します。
22.5030 -.LP
22.5031 -.TP 3
22.5032 -\-breakiterator\
22.5033 -英語言語というロケール固有のアルゴリズムではなく、\f2java.text.BreakIterator\fP の国際化された文境界を使用して、英文の最初の文の終わりを判断します (他のすべてのロケールはすでに \f2BreakIterator\fP を使用)。「\f2最初の文\fP」とは、パッケージ、クラス、またはメンバの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバの要約にコピーされ、アルファベット順のインデックスにコピーされます。
22.5034 -.LP
22.5035 -JDK 1.2 以降、BreakIterator クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、1.2 以降では、\f2\-breakiterator\fP オプションは英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。
22.5036 +@see\ package.class#member\ label
22.5037 +絎ゃс Java 荐茯<潟若ゃャ<潟潟茵腓冴鴻 \f2label\fP 菴遵障\f2label\fP ュ純с \f2label\fP ャ潟<潟若膰茵腓冴障 茵腓冴号с\-noqualifier 篏睡茵腓冴鴻宴若後篏ゃ障茵腓冴鴻違茵腓冴鴻絎翫篏帥障
22.5038 +.LP
22.5039 +若吾с 1.2 с <code> HTML 帥医茵腓冴障 1.2.2 篏睡<code> 絽吾茵腓冴鴻蚊<с障障
22.5040 +.LP
22.5041 .RS 3
22.5042 .TP 2
22.5043 o
22.5044 -英文のデフォルトの文区切りアルゴリズム \- 空白または HTML ブロックタグ (\f2<P>\fP など) が続くピリオドで停止する
22.5045 +\f4package.class\fP\f4#\fP\f4member\fP с篁紙鴻違荀膣絎障 ゃ障宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純障c若с <潟弱若激c若荐 (\f2#\fP) х舟障\f2class\fP 篁紙障ャ絖鴻障ゃ潟帥с若鴻茵障\f2member\fP 篁紙潟潟鴻帥<純障c若 (ャ絖鴻障ゃ潟帥с若鴻с) 茵障絎ャ<潟鴻障翫Javadoc 若吾潟篏障紊с鴻吾潟篏\f2\-link\fP 激с潟篏帥障с鴻絮ャ<潟с祉 2 ゃ綵√ \f2@see\fP 帥違篏帥障綣違ゃ絎ц潟顄障
22.5046 .TP 2
22.5047 o
22.5048 -breakiterator 文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止する。このアルゴリズムでは、ほとんどの省略表記が処理される (「The serial no. is valid」は処理されるが「Mr. Smith」は処理されない)。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する
22.5049 +\f4label\fP ュ純鴻с潟茵腓冴障\f2label\fP 腥榊純с障\f2label\fP ャ\f2package.class.member\fP 憜鴻潟宴若吾綽膰茵腓冴障 茵腓冴号с
22.5050 +.TP 2
22.5051 +o
22.5052 +腥榊醇絖\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP 阪絖с綣с眼腥榊醇絖茹i<純<若翠腥榊醇絖ャ障障
22.5053 +.RE
22.5054 +.LP
22.5055 +\f3箴\fP \- 箴с\f2Character\fP 鴻 \f2@see\fP 帥違\f2String\fP 鴻 \f2equals\fP <純с障帥違 \f2String#equals(Object)\fP \f2equals\fP 筝≧鴻綣違障障
22.5056 +.RS 3
22.5057 +
22.5058 +.LP
22.5059 +.nf
22.5060 +\f3
22.5061 +.fl
22.5062 + /**
22.5063 +.fl
22.5064 + * @see String#equals(Object) equals
22.5065 +.fl
22.5066 + */
22.5067 +.fl
22.5068 +
22.5069 +.fl
22.5070 +\fP
22.5071 +.fi
22.5072 +.RE
22.5073 +.LP
22.5074 +罔羣罨< HTML 障
22.5075 +.RS 3
22.5076 +
22.5077 +.LP
22.5078 +.nf
22.5079 +\f3
22.5080 +.fl
22.5081 +<dl>
22.5082 +.fl
22.5083 +<dt><b>See also:</b>
22.5084 +.fl
22.5085 +<dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
22.5086 +.fl
22.5087 +</dl>
22.5088 +.fl
22.5089 +
22.5090 +.fl
22.5091 +\fP
22.5092 +.fi
22.5093 +.RE
22.5094 +.LP
22.5095 +吟с罨<茵腓冴潟鴻障
22.5096 +.RS 3
22.5097 +.RS 3
22.5098 +.TP 3
22.5099 +∫i:
22.5100 +equals
22.5101 +.RE
22.5102 +.RE
22.5103 +.RE
22.5104 +
22.5105 +.LP
22.5106 +.RS 3
22.5107 +
22.5108 +.LP
22.5109 +.LP
22.5110 +
22.5111 +.LP
22.5112 +.LP
22.5113 +\f3絎\fP \- 帥違絎 \f2package.class\fP\f2#\fP\f2member\fP \f2java.lang.String#toUpperCase()\fP 絎絎\f2String#toUpperCase()\fP \f2#toUpperCase()\fP 絎с障絎絎翫Javadoc 若Java 潟潟ゃ絽吾罎膣∫綺с罎膣≪障荅括完@see 罎膣∫綺с<純茲違綣違綣с眼с亥榊純с障
22.5114 +.LP
22.5115 +.LP
22.5116 +絎絎鴻ュ絖違羝純若鴻潟若茯帥с罨<茵障障綵√腓冴障 茵筝с\f2Class\fP 鴻障ゃ潟帥с若鴻\f2Type\fP 鴻ゃ潟帥с若鴻障堺若水 \f2method\fP <純障潟潟鴻帥絎с障
22.5117 +.LP
22.5118 +.LP
22.5119 +
22.5120 +.LP
22.5121 .RE
22.5122 .RS 3
22.5123 -.LP
22.5124 -.LP
22.5125 -注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。これに費やした作業や混乱が無駄になり残念です。
22.5126 -.LP
22.5127 -.TP
22.5128 -.BI \-locale " language_country_variant"
22.5129 -.B 重要:
22.5130 -\-locale オプションは、標準ドックレットやその他のドックレット
22.5131 -によって提供されるオプションよりも前に (左側に)
22.5132 -指定する必要があります。そうでなければ、ナビゲーションバーは
22.5133 -英語で表示されます。順序に依存するコマンド行オプションは、
22.5134 -このオプションのみです。
22.5135 -.LP
22.5136 -.RS
22.5137 -.B javadoc
22.5138 -がドキュメントを生成するときに使うロケールを指定します。
22.5139 -引数には、java.util.Locale のドキュメントで説明されている
22.5140 -ロケールを指定します。
22.5141 -たとえば、en_US (英語、米国)、en_US_WIN (Windows で使われる英語) などを
22.5142 -指定します。
22.5143 -.LP
22.5144 -ロケールを指定すると、
22.5145 -.B javadoc
22.5146 -は指定されたロケールのリソースファイルを選択して
22.5147 -メッセージ (ナビゲーションバー、リストと表の見出し、
22.5148 -ヘルプファイルの目次、
22.5149 -.BR stylesheet.css
22.5150 -のコメントなどの文字列) に
22.5151 -使います。また、アルファベット順にソートされるリストのソート順、
22.5152 -および最初の文の末尾を決定する文の区切り文字も、
22.5153 -指定したロケールによって決まります。このオプションは、
22.5154 -ドキュメント化されるクラスのソースファイル内で
22.5155 -指定されている doc コメントテキストの
22.5156 -ロケールを決定するものではありません。
22.5157 +.RS 3
22.5158 +.LP
22.5159 +.TS
22.5160 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.5161 +.de 35
22.5162 +.ps \n(.s
22.5163 +.vs \n(.vu
22.5164 +.in \n(.iu
22.5165 +.if \n(.u .fi
22.5166 +.if \n(.j .ad
22.5167 +.if \n(.j=0 .na
22.5168 +..
22.5169 +.nf
22.5170 +.nr #~ 0
22.5171 +.if n .nr #~ 0.6n
22.5172 +.ds #d .d
22.5173 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.5174 +.fc
22.5175 +.nr 33 \n(.s
22.5176 +.rm 80
22.5177 +.nr 34 \n(.lu
22.5178 +.eo
22.5179 +.am 80
22.5180 +.br
22.5181 +.di a+
22.5182 +.35
22.5183 +.ft \n(.f
22.5184 +.ll \n(34u*1u/2u
22.5185 +.if \n(.l<\n(80 .ll \n(80u
22.5186 +.in 0
22.5187 +\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 筝綵√\fP
22.5188 +.br
22.5189 +.di
22.5190 +.nr a| \n(dn
22.5191 +.nr a- \n(dl
22.5192 +..
22.5193 +.ec \
22.5194 +.eo
22.5195 +.am 80
22.5196 +.br
22.5197 +.di b+
22.5198 +.35
22.5199 +.ft \n(.f
22.5200 +.ll \n(34u*1u/2u
22.5201 +.if \n(.l<\n(80 .ll \n(80u
22.5202 +.in 0
22.5203 +\f3憜鴻<潟若с\fP
22.5204 +.br
22.5205 +\f2@see\fP\ \f2#\fP\f2field\fP
22.5206 +.br
22.5207 +\f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP
22.5208 +.br
22.5209 +\f2@see\fP\ \f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
22.5210 +.br
22.5211 +\f2@see\fP\ \f2#\fP\f2constructor(Type,\ Type,...)\fP
22.5212 +.br
22.5213 +\f2@see\fP\ \f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
22.5214 +.br
22.5215 +.di
22.5216 +.nr b| \n(dn
22.5217 +.nr b- \n(dl
22.5218 +..
22.5219 +.ec \
22.5220 +.eo
22.5221 +.am 80
22.5222 +.br
22.5223 +.di c+
22.5224 +.35
22.5225 +.ft \n(.f
22.5226 +.ll \n(34u*1u/2u
22.5227 +.if \n(.l<\n(80 .ll \n(80u
22.5228 +.in 0
22.5229 +\f3憜障ゃ潟若宴若吾ャ鴻с\fP
22.5230 +.br
22.5231 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP
22.5232 +.br
22.5233 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
22.5234 +.br
22.5235 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
22.5236 +.br
22.5237 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
22.5238 +.br
22.5239 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
22.5240 +.br
22.5241 +\f2@see\fP\ \f2Class.NestedClass\fP
22.5242 +.br
22.5243 +\f2@see\fP\ \f2Class\fP
22.5244 +.br
22.5245 +.di
22.5246 +.nr c| \n(dn
22.5247 +.nr c- \n(dl
22.5248 +..
22.5249 +.ec \
22.5250 +.eo
22.5251 +.am 80
22.5252 +.br
22.5253 +.di d+
22.5254 +.35
22.5255 +.ft \n(.f
22.5256 +.ll \n(34u*1u/2u
22.5257 +.if \n(.l<\n(80 .ll \n(80u
22.5258 +.in 0
22.5259 +\f3ャ宴若吾荀膣с\fP\ (絎篆蕋)
22.5260 +.br
22.5261 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP
22.5262 +.br
22.5263 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
22.5264 +.br
22.5265 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
22.5266 +.br
22.5267 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
22.5268 +.br
22.5269 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
22.5270 +.br
22.5271 +\f2@see\fP\ \f2package.Class.NestedClass\fP
22.5272 +.br
22.5273 +\f2@see\fP\ \f2package.Class\fP
22.5274 +.br
22.5275 +\f2@see\fP\ \f2package\fP
22.5276 +.br
22.5277 +.di
22.5278 +.nr d| \n(dn
22.5279 +.nr d- \n(dl
22.5280 +..
22.5281 +.ec \
22.5282 +.35
22.5283 +.nf
22.5284 +.ll \n(34u
22.5285 +.nr 80 0
22.5286 +.80
22.5287 +.rm 80
22.5288 +.nr 38 \n(a-
22.5289 +.if \n(80<\n(38 .nr 80 \n(38
22.5290 +.nr 38 \n(b-
22.5291 +.if \n(80<\n(38 .nr 80 \n(38
22.5292 +.nr 38 \n(c-
22.5293 +.if \n(80<\n(38 .nr 80 \n(38
22.5294 +.nr 38 \n(d-
22.5295 +.if \n(80<\n(38 .nr 80 \n(38
22.5296 +.35
22.5297 +.nf
22.5298 +.ll \n(34u
22.5299 +.nr 38 1n
22.5300 +.nr 79 0
22.5301 +.nr 40 \n(79+(0*\n(38)
22.5302 +.nr 80 +\n(40
22.5303 +.nr TW \n(80
22.5304 +.if t .if \n(TW>\n(.li .tm Table at line 1861 file Input is too wide - \n(TW units
22.5305 +.fc
22.5306 +.nr #T 0-1
22.5307 +.nr #a 0-1
22.5308 +.eo
22.5309 +.de T#
22.5310 +.ds #d .d
22.5311 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.5312 +.mk ##
22.5313 +.nr ## -1v
22.5314 +.ls 1
22.5315 +.ls
22.5316 +..
22.5317 +.ec
22.5318 +.ne \n(a|u+\n(.Vu
22.5319 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.5320 +.ta \n(80u
22.5321 +.nr 31 \n(.f
22.5322 +.nr 35 1m
22.5323 +\&\h'|\n(40u'
22.5324 +.mk ##
22.5325 +.nr 31 \n(##
22.5326 +.sp |\n(##u-1v
22.5327 +.nr 37 \n(40u
22.5328 +.in +\n(37u
22.5329 +.a+
22.5330 +.in -\n(37u
22.5331 +.mk 32
22.5332 +.if \n(32>\n(31 .nr 31 \n(32
22.5333 +.sp |\n(31u
22.5334 +.ne \n(b|u+\n(.Vu
22.5335 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.5336 +.ta \n(80u
22.5337 +.nr 31 \n(.f
22.5338 +.nr 35 1m
22.5339 +\&\h'|\n(40u'
22.5340 +.mk ##
22.5341 +.nr 31 \n(##
22.5342 +.sp |\n(##u-1v
22.5343 +.nr 37 \n(40u
22.5344 +.in +\n(37u
22.5345 +.b+
22.5346 +.in -\n(37u
22.5347 +.mk 32
22.5348 +.if \n(32>\n(31 .nr 31 \n(32
22.5349 +.sp |\n(31u
22.5350 +.ne \n(c|u+\n(.Vu
22.5351 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
22.5352 +.ta \n(80u
22.5353 +.nr 31 \n(.f
22.5354 +.nr 35 1m
22.5355 +\&\h'|\n(40u'
22.5356 +.mk ##
22.5357 +.nr 31 \n(##
22.5358 +.sp |\n(##u-1v
22.5359 +.nr 37 \n(40u
22.5360 +.in +\n(37u
22.5361 +.c+
22.5362 +.in -\n(37u
22.5363 +.mk 32
22.5364 +.if \n(32>\n(31 .nr 31 \n(32
22.5365 +.sp |\n(31u
22.5366 +.ne \n(d|u+\n(.Vu
22.5367 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
22.5368 +.ta \n(80u
22.5369 +.nr 31 \n(.f
22.5370 +.nr 35 1m
22.5371 +\&\h'|\n(40u'
22.5372 +.mk ##
22.5373 +.nr 31 \n(##
22.5374 +.sp |\n(##u-1v
22.5375 +.nr 37 \n(40u
22.5376 +.in +\n(37u
22.5377 +.d+
22.5378 +.in -\n(37u
22.5379 +.mk 32
22.5380 +.if \n(32>\n(31 .nr 31 \n(32
22.5381 +.sp |\n(31u
22.5382 +.fc
22.5383 +.nr T. 1
22.5384 +.T# 1
22.5385 +.35
22.5386 +.rm a+
22.5387 +.rm b+
22.5388 +.rm c+
22.5389 +.rm d+
22.5390 +.TE
22.5391 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-58
22.5392 .RE
22.5393 -.TP
22.5394 -.BI \-encoding " name"
22.5395 -ソースファイルのエンコーディング名 (EUCJIS/SJIS など) を指定します。
22.5396 -このオプションが指定されていない場合は、プラットフォームの
22.5397 -デフォルトコンバータが使われます。
22.5398 -.LP
22.5399 -\-docencoding および \-charset も参照してください。
22.5400 -.TP
22.5401 -.BI \-J flag
22.5402 -.BR javadoc
22.5403 -を実行する実行システム java に flag を直接渡します。J と flag の間に
22.5404 -空白を入れてはなりません。たとえば、生成される
22.5405 -ドキュメントを処理するために、システムで 32M バイトを
22.5406 -確保する必要がある場合は、Java の
22.5407 -.B \-Xmx
22.5408 -オプションを次のように呼び出します。\-Xms はオプションです。初期メモリのサイズのみを設定するため、必要な最小メモリを知っている場合に便利です。
22.5409 -.LP
22.5410 -.RS
22.5411 -.ft 3
22.5412 -.nf
22.5413 -% javadoc \-J\-Xmx32m \-J\-Xms32m com.mypackage
22.5414 -.fi
22.5415 -.ft 1
22.5416 .RE
22.5417
22.5418 -
22.5419 -.LP
22.5420 -使用している javadoc のバージョンを確認するには、
22.5421 -次のように java の「-version」オプションを呼び出します。
22.5422 -.LP
22.5423 -.RS
22.5424 -.ft 3
22.5425 -.nf
22.5426 -% javadoc -J-version
22.5427 -java version "1.2"
22.5428 -Classic VM (build JDK-1.2-V, green threads, sunwjit)
22.5429 -.fi
22.5430 -.ft 1
22.5431 -.RE
22.5432 -.LP
22.5433 -(標準ドックレットのバージョン番号は出力ストリームに表示されます。)
22.5434 -.SS "標準ドックレットが提供するオプション"
22.5435 -.TP
22.5436 -.BI \-d " directory"
22.5437 -生成された HTML ファイルを保存するディレクトリを
22.5438 -指定します (d は「生成先 (destination)」の意味)。このオプションを
22.5439 -省略すると、生成されたファイルは現在のディレクトリに保存されます。
22.5440 -値
22.5441 -.I directory
22.5442 -には、絶対ディレクトリまたは現在の作業
22.5443 -ディレクトリからの相対ディレクトリを指定できます。
22.5444 -1.4 では、javadoc の実行時に
22.5445 -自動的に生成先ディレクトリが作成されます。
22.5446 -.LP
22.5447 -たとえば、
22.5448 -次の例は、com.mypackage パッケージのドキュメントを生成し、
22.5449 -結果を
22.5450 -.B /home/user/doc/
22.5451 -ディレクトリに保存します。
22.5452 -.LP
22.5453 -.RS
22.5454 -.ft 3
22.5455 -.nf
22.5456 -% javadoc \-d /home/user/doc com.mypackage
22.5457 -.fi
22.5458 -.ft 1
22.5459 -.RE
22.5460 -.TP
22.5461 -.B \-use
22.5462 -ドキュメント化されるクラスとパッケージごとに 1 つの [使用] ページを
22.5463 -含めます。このページには、ドキュメント化されるクラスまたは
22.5464 -パッケージの API を使っているパッケージ、クラス、メソッド、
22.5465 -コンストラクタ、およびフィールドが記述されます。たとえば、クラス
22.5466 -C およびクラス C を使うものは、C のサブクラス、C として
22.5467 -宣言されているフィールド、C を返すメソッド、および、型 C の
22.5468 -パラメータを持つメソッドとコンストラクタがページに含ま
22.5469 -れます。
22.5470 -.LP
22.5471 -.RS
22.5472 -たとえば、String について、[使用] ページに何が表示されるかを
22.5473 -見てみましょう。
22.5474 -.B java.awt.Font
22.5475 -クラスの
22.5476 -.B getName()
22.5477 -メソッドは、String 型を返します。
22.5478 -このため、
22.5479 -.B getName()
22.5480 -は String を使うので、[使用] ページの String で
22.5481 -このメソッドを見つけることができます。
22.5482 -.LP
22.5483 -このページでは API の使用だけがドキュメント化され、実装はドキュメント化されません。
22.5484 -あるメソッドが実装内に String を使っているが、引数として
22.5485 -文字列をとったり、文字列を返したりしない
22.5486 -場合は、String の「使用」とはみなされません。
22.5487 -.LP
22.5488 -生成された [使用] ページにアクセスするには、目的のクラスまたは
22.5489 -パッケージを表示して、ナビゲーションバーの [使用] リンクを
22.5490 -クリックします。
22.5491 -.RE
22.5492 -.TP
22.5493 -.B \-version
22.5494 -生成されるドキュメントに
22.5495 -.B @version
22.5496 -テキストを含めます。このテキストは、デフォルトでは省略されます。
22.5497 -使用している javadoc ツールのバージョンを確認するには、
22.5498 -.B \-J\-version
22.5499 -オプションを使用します。
22.5500 -.TP
22.5501 -.B \-author
22.5502 -生成されるドキュメントに
22.5503 -.B @author
22.5504 -テキストを含めます。
22.5505 -.TP
22.5506 -.B \-splitindex
22.5507 -索引ファイルをアルファベットごとに複数のファイルに分割し、
22.5508 -文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる
22.5509 -索引エントリ用のファイルを 1 つ作成します。
22.5510 -.TP
22.5511 -.BI \-windowtitle " title"
22.5512 -HTML の
22.5513 -.B <title>
22.5514 -タグで使うタイトルを指定します。指定したタイトルは、
22.5515 -ウィンドウタイトルと、該当するページに対して作成されたブラウザの
22.5516 -ブックマーク (よくアクセスする場所) に表示されます。
22.5517 -タイトルには HTML タグを含めないでください。タイトルに HTML タグが
22.5518 -含まれていると、ブラウザによるタグの解釈が不適切になる
22.5519 -可能性があります。
22.5520 -.I title
22.5521 -の中で引用符を使う場合は、引用符を
22.5522 -エスケープする必要があります。
22.5523 -.B -windowtitle
22.5524 -が省略されている場合、
22.5525 -.B javadoc
22.5526 -ツールはこのオプションの代わりに -doctitle の値を使います。
22.5527 -.LP
22.5528 -.RS
22.5529 -.ft 3
22.5530 -.nf
22.5531 -% javadoc -windowtitle "Java 2 Platform" com.mypackage
22.5532 -.fi
22.5533 -.ft 1
22.5534 -.RE
22.5535 -.TP
22.5536 -.BI \-doctitle " title"
22.5537 -概要ファイルの最上部近くに配置するタイトルを指定します。
22.5538 -タイトルは中央揃えされ、レベル 1 の見出しとして上部
22.5539 -ナビゲーションバーのすぐ下に置かれます。
22.5540 -.I title
22.5541 -には、HTML タグと
22.5542 -空白を含めることができますが、これらを含める場合は全体を引用符で囲
22.5543 -まなければなりません。
22.5544 -.I title
22.5545 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
22.5546 -.LP
22.5547 -.RS
22.5548 -.ft 3
22.5549 -.nf
22.5550 -% javadoc -doctitle "Java<sup><font size=\"-2\">TM</font></sup>" com.mypackage
22.5551 -.fi
22.5552 -.ft 1
22.5553 -.RE
22.5554 -.TP
22.5555 -.BI \-title " title"
22.5556 -このオプションは、現在は存在しません。
22.5557 -.B javadoc
22.5558 -1.2 のベータ版にだけ存在しました。このオプションは、
22.5559 -ウィンドウタイトルではなくドキュメントタイトルを定義することを
22.5560 -明確にするため、
22.5561 -.BR \-doctitle
22.5562 -に名前が変更されました。
22.5563 -.TP
22.5564 -.BI \-header " header"
22.5565 -各出力ファイルの上部に配置するヘッダテキストを指定します。ヘッダは、
22.5566 -上部ナビゲーションバーの右側に配置されます。
22.5567 -.I header
22.5568 -には、HTML タグと
22.5569 -空白を含めることができますが、これらを含める場合は全体を引用符で
22.5570 -囲まなければなりません。header の中で引用符を使う場合は、引用符を
22.5571 -エスケープする必要があります。
22.5572 -.nf
22.5573 -\f3
22.5574 -.fl
22.5575 - % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP
22.5576 -.fl
22.5577 -.fi
22.5578 -.LP
22.5579 -.TP
22.5580 -.BI \-footer " footer"
22.5581 -各出力ファイルの下部に配置するフッタテキストを指定します。フッタは、
22.5582 -下部ナビゲーションバーの右側に配置されます。
22.5583 -.I footer
22.5584 -には、HTML タグと
22.5585 -空白を含めることができますが、これらを含める場合は全体を引用符で
22.5586 -囲まなければなりません。
22.5587 -.I footer
22.5588 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
22.5589 -.TP
22.5590 -.BI \-bottom " text"
22.5591 -各出力ファイルの最下部に配置するテキストを指定します。
22.5592 -このテキストは、下部ナビゲーションバーの下のページの最下部に
22.5593 -配置されます。
22.5594 -.I text
22.5595 -には、HTML タグと空白を含めることができますが、
22.5596 -これらを含める場合は全体を引用符で囲まなければなりません。
22.5597 -.I text
22.5598 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
22.5599 -.TP
22.5600 -.BI \-link " extdocURL"
22.5601 -.B javadoc
22.5602 -ツールにより生成された既存の
22.5603 -外部参照クラスのドキュメンテーションへのリンクを作成します。
22.5604 -引数は 1 つです。
22.5605 -.TP
22.5606 -\(bu
22.5607 -.I extdocURL
22.5608 -は、javadoc によって生成され、リンク先として指定する
22.5609 -外部ドキュメントがあるディレクトリの絶対 URL または相対 URL です。 あとで例を示します。 このディレクトリ内に package-list ファイルが存在して
22.5610 -いなければなりません。存在しない場合は、\-linkoffline を使用します。
22.5611 -.B javadoc
22.5612 -ツールは package-list ファイルからパッケージ名を読み取り、それを
22.5613 -.I extdocURL
22.5614 -のパッケージにリンクします。 javadoc ツールを実行すると、
22.5615 -.I extdocURL
22.5616 -値は作成された <A HREF> リンクにそのままコピーされます。 したがって、
22.5617 -.I extdocURL
22.5618 -はファイルではなく、
22.5619 -.I extdocURL
22.5620 -の URL である必要があります。
22.5621 -.LP
22.5622 -ドキュメントを任意の Web サイト上のドキュメントにリンクするには
22.5623 -.I extdocURL
22.5624 -の絶対リンクを、相対ロケーションだけを指定するには
22.5625 -相対リンクを使用できます。相対リンクを使用する場合、生成先ディレクトリ (\-d で指定) からの相対パスを、
22.5626 -リンク先パッケージがあるディレクトリに渡す必要があります。
22.5627 -.LP
22.5628 -通常、絶対リンクを指定する場合は、http: リンクを使用します。
22.5629 -ただし、Web サーバをもたないファイルシステムに
22.5630 -リンクする場合は、file: リンクを使用できます。
22.5631 -ただし、この方法は、生成されたドキュメントに
22.5632 -アクセスしようとする
22.5633 -すべてのユーザが同じファイルシステムを共有している
22.5634 -場合以外は使用しないでください。
22.5635 -.LP
22.5636 -すべての場合、すべてのオペレーティングシステムで、絶対 URL と相対 URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します
22.5637 -.fi
22.5638 -(http://www.ietf.org/rfc/rfc1738.txt
22.5639 -の
22.5640 -.na
22.5641 -\f2URL Memo\fP で指定)。
22.5642 +.LP
22.5643 .RS 3
22.5644 -.TP 3
22.5645 -http: ベースの絶対リンク:
22.5646 -\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
22.5647 -.TP 3
22.5648 -file: ベースの絶対リンク:
22.5649 -\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
22.5650 -.TP 3
22.5651 -相対リンク:
22.5652 -\f2\-link <directory>/<directory>/.../<name>\fP
22.5653 -.RE
22.5654 -.RE
22.5655 -.LP
22.5656 -javadoc 実行時に複数の \-link オプションを指定して、
22.5657 -複数のドキュメントへのリンクを作成することもできます。
22.5658 -.LP
22.5659 -\-linkoffline または \-link の選択
22.5660 -.LP
22.5661 -\-link を使用する場合:
22.5662 -.TP 3
22.5663 -\(bu
22.5664 -外部 API ドキュメントへの相対パスを使用している
22.5665 -.TP 3
22.5666 -\(bu
22.5667 -外部 API ドキュメントへの絶対 URL を使用している (プログラムがその URL に接続し、読み取りを行うことが
22.5668 -シェルによって許可されている場合)
22.5669 -.LP
22.5670 -\-linkoffline を使用する場合:
22.5671 -.TP 3
22.5672 -\(bu
22.5673 -外部 API ドキュメントへの絶対 URL を使用している
22.5674 -(プログラムがその URL に接続し、読み取りを行うことが
22.5675 -シェルによって許可されていない場合)。このような状況は、
22.5676 -リンク先のドキュメントがファイアウォールの
22.5677 -向こう側にある場合に発生します。
22.5678 -.LP
22.5679 -外部ドキュメントへの絶対リンクの使用例 -
22.5680 -java.lang、java.io、および他の Java 2 プラットフォームパッケージ
22.5681 -(\f2http://java.sun.com/j2se/1.5.0/docs/api\fP) に
22.5682 -リンクしたい場合があります。
22.5683 -次のコマンドは、
22.5684 -Java 2 プラットフォームパッケージへのリンクを持つ
22.5685 -com.mypackage パッケージのドキュメントを生成します。
22.5686 -生成されたドキュメントには、たとえばクラスツリー内の
22.5687 -Object クラスへのリンクが含まれています
22.5688 -(\-sourcepath や \-d などの他のオプションは表示されません)。
22.5689 -.LP
22.5690 -.RS
22.5691 -.ft 3
22.5692 -.nf
22.5693 -% \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
22.5694 -.fi
22.5695 -.ft 1
22.5696 -.RE
22.5697 -.LP
22.5698 -外部 ドキュメントへの相対リンクの使用例 -
22.5699 -.B javadoc
22.5700 -ツールの異なる実行で生成されたドキュメントを持つ
22.5701 -2 つのパッケージがあり、それらが別々の
22.5702 -相対パスをもっているとします。
22.5703 -この例では、2 つのパッケージを
22.5704 -com.apipackage (API)、com.spipackage
22.5705 -(SPI - Service Provide Interface) とします。 ドキュメントの置き場所は docs/api/com/apipackage および
22.5706 -docs/spi/com/spipackage です。
22.5707 -API パッケージドキュメントはすでに生成され、ドキュメントが現在の
22.5708 -ディレクトリ内にある場合、次のように実行することで、
22.5709 -API ドキュメントにリンクした SPI パッケージをドキュメント化できます。
22.5710 -.LP
22.5711 -.RS
22.5712 -.ft 3
22.5713 -.nf
22.5714 -% javadoc \-d ./spi \-link ../api com.spipackage
22.5715 -.fi
22.5716 -.ft 1
22.5717 -.RE
22.5718 -.LP
22.5719 -\-link 引数が生成先ディレクトリの相対パス (docs/spi) で
22.5720 -あることに注意してください。
22.5721 -.LP
22.5722 -詳細 -
22.5723 -\-link オプションを使うと、コードからは参照されていても、
22.5724 -Javadoc の現在の実行ではドキュメント化されないクラスにリンク
22.5725 -できるようになります。 リンクから有効なページに
22.5726 -移動できるようにするには、それらの HTML ページが
22.5727 -ある場所を調べ、その場所を
22.5728 -.I extdocURL
22.5729 -に指定する必要があります。
22.5730 -このオプションを使うと、たとえば、サードパーティのドキュメントから、
22.5731 -http://java.sun.com にある java.* のドキュメントにリンクすることができます。
22.5732 -.LP
22.5733 -今回の実行で
22.5734 -.B javadoc
22.5735 -によって生成されるドキュメント内の
22.5736 -API だけを対象にリンクを作成する場合は、
22.5737 -\-link オプションを省略します。 \-link オプションが
22.5738 -指定されていない場合、
22.5739 -.B javadoc
22.5740 -ツールは、外部参照されたドキュメントへのリンクを
22.5741 -作成しません。これは、そのドキュメントが
22.5742 -存在するかどうか、あるいは存在していてもどこに
22.5743 -存在しているのかを判別できないからです。
22.5744 -.LP
22.5745 -このオプションは、生成ドキュメント内の複数の場所に
22.5746 -リンクを作成できます。
22.5747 -.LP
22.5748 -また、このオプションを使うと、複数のパッケージ群の間にクロスリンクを作成することもできます。つまり、ある一式のパッケージに対して javadoc を実行したあと、別の一式のパッケージに対して javadoc を実行し、これら 2 つのパッケージ群の間にクロスリンクを作成できます。
22.5749 -.LP
22.5750 -\f3クラスの参照方法\fP - 外部参照クラスへのリンクを、テキストラベルだけではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するだけでは十分ではありません。\f2import\fP 文または宣言で参照する必要があります。次に、クラス \f2java.io.File\fP を参照する方法の例を示します。
22.5751 +
22.5752 +.LP
22.5753 +.LP
22.5754 +筝茵絲障茖莇割罨<腓冴障
22.5755 +.LP
22.5756 .RS 3
22.5757 .TP 2
22.5758 o
22.5759 -すべての種類の \f2import\fP 文の場合: ワイルドカードによるインポート、名前による明示的なインポート、または \f2java.lang.*\fP に対する自動的なインポート。たとえば、次のようにすれば十分です。
22.5760 -.br
22.5761 -\f2import java.io.*;\fP
22.5762 -.br
22.5763 -1.3.x および 1.2.x では、名前による明示的なインポートだけです。ワイルドカードによるインポート文も、自動インポート \f2java.lang.*\fP も使用できません。
22.5764 +腮蕁綵√ (宴若吾鴻) 翫Javadoc 若憜鴻絮ゃ罎膣≪障ゃ障憜鴻ゃ潟帥с若鴻鴻若若鴻鴻若若ゃ潟帥с若鴻障憜鴻ゃ潟帥с若鴻蚊с鴻ゃ潟帥с若鴻<潟若罎膣≪障 (罎膣∽ 1 3)憜宴若吾祉祉宴若吾罎膣≪障 (罎膣∽ 4 5)
22.5765 .TP 2
22.5766 o
22.5767 -宣言の場合:
22.5768 -.br
22.5769 -\f2void foo(File f) {}\fP
22.5770 -.br
22.5771 -この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースのリターンタイプまたはパラメータタイプに置くか、\f2implements\fP、\f2extends\fP、または \f2throws\fP 文に置きます。
22.5772 +<純障潟潟鴻帥絎綣с篁 (\f2getValue\fP ) 篏睡翫c若絖違Javadoc 若<純絲障罩c潟篏障 綣с綣違菴遵篆茘<祉若吾阪障<純若若若翫Javadoc 若罎膣≪ф荀ゃc<純潟障 腟c劫с障
22.5773 +.TP 2
22.5774 +o
22.5775 +ャ絖鴻筝荐綵√翫\f2inner\fPс\f2outer\fP\f2.\fP\f2inner\fP絎違障
22.5776 +.TP 2
22.5777 +o
22.5778 +с菴違鴻鴻<潟若阪 (\f2.\fP) с激c若荐 (\f2#\fP) 篏睡羈絎Javadoc 若障茹f浦с障 鴻ャ絖鴻宴若吾潟泣宴若吾阪篏睡障Javadoc 若с筝荐怨合蚊綺障違с罩c頵f障 翫с茘茵腓冴障
22.5779 .RE
22.5780 -.LP
22.5781 -この結果、\f2\-link\fP オプションを使用しても、この制限のために誤って表示されない多くのリンクが多数発生する可能性があります。テキストはハイパーテキストリンクが付けられずに表示されます。これらのリンクが表示する警告から、このリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するためのもっとも安全な方法は上で説明したとおり、当該のクラスをインポートすることです。
22.5782 -.LP
22.5783 -.B パッケージリスト:
22.5784 -.B \-link
22.5785 -オプションでは、javadoc ツールによって生成された
22.5786 -.BR package-list
22.5787 -という名前のファイルが、このオプションで指定する URL に存在している
22.5788 -必要があります。
22.5789 -.BR package-list
22.5790 -ファイルは、その場所でドキュメント化されているパッケージの
22.5791 -名前のリストを含む単純なテキストファイルです。
22.5792 -前の例では、
22.5793 -.B javadoc
22.5794 -ツールは、指定された URL にある
22.5795 -.BR package-list
22.5796 -という名前のファイルを探し、パッケージ名を読み込んで、
22.5797 -その URL にあるそれらのパッケージへのリンクを作成しました。
22.5798 -.LP
22.5799 -たとえば、Java プラットフォーム v5.0 API のパッケージリストは以下にあり、
22.5800 -.na
22.5801 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP
22.5802 +
22.5803 +.LP
22.5804 +.LP
22.5805 +\f3@see 罎膣∫綺\fP \- Javadoc 若純若鴻<ゃ (.java)宴若吾<ゃ (package.html 障 package\-info.java)障网荀<ゃ (overview.html) 筝糸眼 \f2@see\fP 帥違障緇 2 ゃ<ゃс絎絎 \f2@see\fP 帥違絎違障純若鴻<ゃс絎絎障絎絎с障
22.5806 +.LP
22.5807 +.LP
22.5808 +Javadoc 若\f2.java\fP <ゃу絎с荐菴違 \f2@see\fP 帥違荀ゃJava 潟潟ゃ綺ф絎罎膣≪障 Javadoc 若劫腥咲障罎冴障 純若鴻潟若若絖с罎膣∫綺Java 荐茯篁罕膃 2 膃 6 腴Namesфe絎臂障Javadoc 若∫c鴻宴若吾潟ゃ潟若鴻宴若吾鴻罎膣≪障隙罨<綺ф膣≪障
22.5809 +.LP
22.5810 +.RS 3
22.5811 +.TP 3
22.5812 +1.
22.5813 +憜鴻障ゃ潟帥с若
22.5814 +.TP 3
22.5815 +2.
22.5816 +紊眼蚊с鴻ゃ潟帥с若 (c菴罎膣)
22.5817 +.TP 3
22.5818 +3.
22.5819 +鴻若若鴻鴻若若ゃ潟帥с若 (c菴罎膣)
22.5820 +.TP 3
22.5821 +4.
22.5822 +憜宴若
22.5823 +.TP 3
22.5824 +5.
22.5825 +ゃ潟若宴若吾鴻潟ゃ潟帥с若 (import 綺緇c罎膣)
22.5826 .RE
22.5827 -.LP
22.5828 -次のような内容で始まっています。
22.5829 -.LP
22.5830 -.RS
22.5831 -.ft 3
22.5832 +
22.5833 +.LP
22.5834 +.LP
22.5835 +Javadoc 若鴻ゃ 1 3 絽亥筝眼荀ゃ障ф膣≪膓障ゃ障障憜鴻罎膣≪罨<鴻蚊с E 罎膣≪罨< E 鴻若若鴻罎膣≪罨< E 蚊с鴻罎膣≪障 4 5 с1 ゃ宴若後鴻障ゃ潟帥с若鴻罎膣≪綺羆冴障c障 綺潟潟ゃc違障 5 сJavadoc 若java.lang 罎膣≪障 宴若吾鴻違ゃ潟若с
22.5836 +.LP
22.5837 +.LP
22.5838 +Javadoc 若綽泣鴻罎膣≪障 障javadoc 絎茵筝祉宴若吾ャ<潟翫с祉宴若吾罎膣≪障違\f2@see\fP 帥違 \f2java.awt.event.KeyEvent\fP 劫c\f2java.awt\fP 宴若吾с翫Javadoc 鴻ゃ潟若宴若吾罎膣≪障
22.5839 +.LP
22.5840 +.LP
22.5841 +\f3茵腓冴号\fP \- \f2label\fP ャ\f2package.class.member\fP 茵腓冴障筝package.class.member 憜鴻潟宴若吾綽膰障膰綽荀絨茵腓冴с違\f2String.toUpperCase()\fP <純鴻<潟若吾с祉鴻<潟若吾с障翫劫茵腓冴緇宴若鴻с (罨<茵)
22.5842 +.LP
22.5843 +.LP
22.5844 +宴若後綺ゃ\-noqualifier 篏睡障
22.5845 +.br
22.5846 +
22.5847 +.LP
22.5848 +.RE
22.5849 +.RS 3
22.5850 +.RS 3
22.5851 +.LP
22.5852 +.TS
22.5853 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.5854 +.de 35
22.5855 +.ps \n(.s
22.5856 +.vs \n(.vu
22.5857 +.in \n(.iu
22.5858 +.if \n(.u .fi
22.5859 +.if \n(.j .ad
22.5860 +.if \n(.j=0 .na
22.5861 +..
22.5862 .nf
22.5863 -java.applet
22.5864 -java.awt
22.5865 -java.awt.color
22.5866 -java.awt.datatransfer
22.5867 -java.awt.dnd
22.5868 -java.awt.event
22.5869 -java.awt.font
22.5870 -その他 ...
22.5871 -.fi
22.5872 -.ft 1
22.5873 +.nr #~ 0
22.5874 +.if n .nr #~ 0.6n
22.5875 +.ds #d .d
22.5876 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.5877 +.fc
22.5878 +.nr 33 \n(.s
22.5879 +.rm 80 81 82
22.5880 +.nr 34 \n(.lu
22.5881 +.eo
22.5882 +.am 81
22.5883 +.br
22.5884 +.di a+
22.5885 +.35
22.5886 +.ft \n(.f
22.5887 +.ll \n(34u*1u/4u
22.5888 +.if \n(.l<\n(81 .ll \n(81u
22.5889 +.in 0
22.5890 +\f4String.toUpperCase()\fP\f3 с箴\fP
22.5891 +.br
22.5892 +.di
22.5893 +.nr a| \n(dn
22.5894 +.nr a- \n(dl
22.5895 +..
22.5896 +.ec \
22.5897 +.eo
22.5898 +.am 80
22.5899 +.br
22.5900 +.di b+
22.5901 +.35
22.5902 +.ft \n(.f
22.5903 +.ll \n(34u*1u/4u
22.5904 +.if \n(.l<\n(80 .ll \n(80u
22.5905 +.in 0
22.5906 +\f2@see\fP 帥違鴻<潟若с
22.5907 +.br
22.5908 +.di
22.5909 +.nr b| \n(dn
22.5910 +.nr b- \n(dl
22.5911 +..
22.5912 +.ec \
22.5913 +.eo
22.5914 +.am 82
22.5915 +.br
22.5916 +.di c+
22.5917 +.35
22.5918 +.ft \n(.f
22.5919 +.ll \n(34u*1u/4u
22.5920 +.if \n(.l<\n(82 .ll \n(82u
22.5921 +.in 0
22.5922 +\f2toLowerCase()\fP (劫)
22.5923 +.br
22.5924 +.di
22.5925 +.nr c| \n(dn
22.5926 +.nr c- \n(dl
22.5927 +..
22.5928 +.ec \
22.5929 +.eo
22.5930 +.am 80
22.5931 +.br
22.5932 +.di d+
22.5933 +.35
22.5934 +.ft \n(.f
22.5935 +.ll \n(34u*1u/4u
22.5936 +.if \n(.l<\n(80 .ll \n(80u
22.5937 +.in 0
22.5938 +\f2@see\fP 帥違ャ鴻<潟若с
22.5939 +.br
22.5940 +.di
22.5941 +.nr d| \n(dn
22.5942 +.nr d- \n(dl
22.5943 +..
22.5944 +.ec \
22.5945 +.eo
22.5946 +.am 81
22.5947 +.br
22.5948 +.di e+
22.5949 +.35
22.5950 +.ft \n(.f
22.5951 +.ll \n(34u*1u/4u
22.5952 +.if \n(.l<\n(81 .ll \n(81u
22.5953 +.in 0
22.5954 +\f2@see Character#toLowerCase(char)\fP
22.5955 +.br
22.5956 +.di
22.5957 +.nr e| \n(dn
22.5958 +.nr e- \n(dl
22.5959 +..
22.5960 +.ec \
22.5961 +.eo
22.5962 +.am 82
22.5963 +.br
22.5964 +.di f+
22.5965 +.35
22.5966 +.ft \n(.f
22.5967 +.ll \n(34u*1u/4u
22.5968 +.if \n(.l<\n(82 .ll \n(82u
22.5969 +.in 0
22.5970 +\f2Character.toLowerCase(char)\fP (宴若後ャ劫)
22.5971 +.br
22.5972 +.di
22.5973 +.nr f| \n(dn
22.5974 +.nr f- \n(dl
22.5975 +..
22.5976 +.ec \
22.5977 +.eo
22.5978 +.am 80
22.5979 +.br
22.5980 +.di g+
22.5981 +.35
22.5982 +.ft \n(.f
22.5983 +.ll \n(34u*1u/4u
22.5984 +.if \n(.l<\n(80 .ll \n(80u
22.5985 +.in 0
22.5986 +\f2@see\fP 帥違ャ鴻<潟若с
22.5987 +.br
22.5988 +.di
22.5989 +.nr g| \n(dn
22.5990 +.nr g- \n(dl
22.5991 +..
22.5992 +.ec \
22.5993 +.eo
22.5994 +.am 81
22.5995 +.br
22.5996 +.di h+
22.5997 +.35
22.5998 +.ft \n(.f
22.5999 +.ll \n(34u*1u/4u
22.6000 +.if \n(.l<\n(81 .ll \n(81u
22.6001 +.in 0
22.6002 +\f2@see java.io.File#exists()\fP
22.6003 +.br
22.6004 +.di
22.6005 +.nr h| \n(dn
22.6006 +.nr h- \n(dl
22.6007 +..
22.6008 +.ec \
22.6009 +.eo
22.6010 +.am 82
22.6011 +.br
22.6012 +.di i+
22.6013 +.35
22.6014 +.ft \n(.f
22.6015 +.ll \n(34u*1u/4u
22.6016 +.if \n(.l<\n(82 .ll \n(82u
22.6017 +.in 0
22.6018 +\f2java.io.File.exists()\fP (宴若後劫)
22.6019 +.br
22.6020 +.di
22.6021 +.nr i| \n(dn
22.6022 +.nr i- \n(dl
22.6023 +..
22.6024 +.ec \
22.6025 +.35
22.6026 +.nf
22.6027 +.ll \n(34u
22.6028 +.nr 80 0
22.6029 +.nr 38 \w\f3с腮蕁\fP
22.6030 +.if \n(80<\n(38 .nr 80 \n(38
22.6031 +.80
22.6032 +.rm 80
22.6033 +.nr 38 \n(b-
22.6034 +.if \n(80<\n(38 .nr 80 \n(38
22.6035 +.nr 38 \n(d-
22.6036 +.if \n(80<\n(38 .nr 80 \n(38
22.6037 +.nr 38 \n(g-
22.6038 +.if \n(80<\n(38 .nr 80 \n(38
22.6039 +.nr 81 0
22.6040 +.nr 38 \w\f2@see String#toLowerCase()\fP
22.6041 +.if \n(81<\n(38 .nr 81 \n(38
22.6042 +.81
22.6043 +.rm 81
22.6044 +.nr 38 \n(a-
22.6045 +.if \n(81<\n(38 .nr 81 \n(38
22.6046 +.nr 38 \n(e-
22.6047 +.if \n(81<\n(38 .nr 81 \n(38
22.6048 +.nr 38 \n(h-
22.6049 +.if \n(81<\n(38 .nr 81 \n(38
22.6050 +.nr 82 0
22.6051 +.nr 38 \w\f3茵腓冴\fP
22.6052 +.if \n(82<\n(38 .nr 82 \n(38
22.6053 +.82
22.6054 +.rm 82
22.6055 +.nr 38 \n(c-
22.6056 +.if \n(82<\n(38 .nr 82 \n(38
22.6057 +.nr 38 \n(f-
22.6058 +.if \n(82<\n(38 .nr 82 \n(38
22.6059 +.nr 38 \n(i-
22.6060 +.if \n(82<\n(38 .nr 82 \n(38
22.6061 +.35
22.6062 +.nf
22.6063 +.ll \n(34u
22.6064 +.nr 38 1n
22.6065 +.nr 79 0
22.6066 +.nr 40 \n(79+(0*\n(38)
22.6067 +.nr 80 +\n(40
22.6068 +.nr 41 \n(80+(3*\n(38)
22.6069 +.nr 81 +\n(41
22.6070 +.nr 42 \n(81+(3*\n(38)
22.6071 +.nr 82 +\n(42
22.6072 +.nr TW \n(82
22.6073 +.if t .if \n(TW>\n(.li .tm Table at line 1959 file Input is too wide - \n(TW units
22.6074 +.fc
22.6075 +.nr #T 0-1
22.6076 +.nr #a 0-1
22.6077 +.eo
22.6078 +.de T#
22.6079 +.ds #d .d
22.6080 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.6081 +.mk ##
22.6082 +.nr ## -1v
22.6083 +.ls 1
22.6084 +.ls
22.6085 +..
22.6086 +.ec
22.6087 +.ne \n(a|u+\n(.Vu
22.6088 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.6089 +.ta \n(80u \n(81u \n(82u
22.6090 +.nr 31 \n(.f
22.6091 +.nr 35 1m
22.6092 +\&\h'|\n(40u'\f3с腮蕁\fP\h'|\n(41u'\h'|\n(42u'\f3茵腓冴\fP
22.6093 +.mk ##
22.6094 +.nr 31 \n(##
22.6095 +.sp |\n(##u-1v
22.6096 +.nr 37 \n(41u
22.6097 +.in +\n(37u
22.6098 +.a+
22.6099 +.in -\n(37u
22.6100 +.mk 32
22.6101 +.if \n(32>\n(31 .nr 31 \n(32
22.6102 +.sp |\n(31u
22.6103 +.ne \n(b|u+\n(.Vu
22.6104 +.ne \n(c|u+\n(.Vu
22.6105 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.6106 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
22.6107 +.ta \n(80u \n(81u \n(82u
22.6108 +.nr 31 \n(.f
22.6109 +.nr 35 1m
22.6110 +\&\h'|\n(40u'\h'|\n(41u'\f2@see String#toLowerCase()\fP\h'|\n(42u'
22.6111 +.mk ##
22.6112 +.nr 31 \n(##
22.6113 +.sp |\n(##u-1v
22.6114 +.nr 37 \n(40u
22.6115 +.in +\n(37u
22.6116 +.b+
22.6117 +.in -\n(37u
22.6118 +.mk 32
22.6119 +.if \n(32>\n(31 .nr 31 \n(32
22.6120 +.sp |\n(##u-1v
22.6121 +.nr 37 \n(42u
22.6122 +.in +\n(37u
22.6123 +.c+
22.6124 +.in -\n(37u
22.6125 +.mk 32
22.6126 +.if \n(32>\n(31 .nr 31 \n(32
22.6127 +.sp |\n(31u
22.6128 +.ne \n(d|u+\n(.Vu
22.6129 +.ne \n(e|u+\n(.Vu
22.6130 +.ne \n(f|u+\n(.Vu
22.6131 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
22.6132 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
22.6133 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
22.6134 +.ta \n(80u \n(81u \n(82u
22.6135 +.nr 31 \n(.f
22.6136 +.nr 35 1m
22.6137 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
22.6138 +.mk ##
22.6139 +.nr 31 \n(##
22.6140 +.sp |\n(##u-1v
22.6141 +.nr 37 \n(40u
22.6142 +.in +\n(37u
22.6143 +.d+
22.6144 +.in -\n(37u
22.6145 +.mk 32
22.6146 +.if \n(32>\n(31 .nr 31 \n(32
22.6147 +.sp |\n(##u-1v
22.6148 +.nr 37 \n(41u
22.6149 +.in +\n(37u
22.6150 +.e+
22.6151 +.in -\n(37u
22.6152 +.mk 32
22.6153 +.if \n(32>\n(31 .nr 31 \n(32
22.6154 +.sp |\n(##u-1v
22.6155 +.nr 37 \n(42u
22.6156 +.in +\n(37u
22.6157 +.f+
22.6158 +.in -\n(37u
22.6159 +.mk 32
22.6160 +.if \n(32>\n(31 .nr 31 \n(32
22.6161 +.sp |\n(31u
22.6162 +.ne \n(g|u+\n(.Vu
22.6163 +.ne \n(h|u+\n(.Vu
22.6164 +.ne \n(i|u+\n(.Vu
22.6165 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
22.6166 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
22.6167 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
22.6168 +.ta \n(80u \n(81u \n(82u
22.6169 +.nr 31 \n(.f
22.6170 +.nr 35 1m
22.6171 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
22.6172 +.mk ##
22.6173 +.nr 31 \n(##
22.6174 +.sp |\n(##u-1v
22.6175 +.nr 37 \n(40u
22.6176 +.in +\n(37u
22.6177 +.g+
22.6178 +.in -\n(37u
22.6179 +.mk 32
22.6180 +.if \n(32>\n(31 .nr 31 \n(32
22.6181 +.sp |\n(##u-1v
22.6182 +.nr 37 \n(41u
22.6183 +.in +\n(37u
22.6184 +.h+
22.6185 +.in -\n(37u
22.6186 +.mk 32
22.6187 +.if \n(32>\n(31 .nr 31 \n(32
22.6188 +.sp |\n(##u-1v
22.6189 +.nr 37 \n(42u
22.6190 +.in +\n(37u
22.6191 +.i+
22.6192 +.in -\n(37u
22.6193 +.mk 32
22.6194 +.if \n(32>\n(31 .nr 31 \n(32
22.6195 +.sp |\n(31u
22.6196 +.fc
22.6197 +.nr T. 1
22.6198 +.T# 1
22.6199 +.35
22.6200 +.rm a+
22.6201 +.rm b+
22.6202 +.rm c+
22.6203 +.rm d+
22.6204 +.rm e+
22.6205 +.rm f+
22.6206 +.rm g+
22.6207 +.rm h+
22.6208 +.rm i+
22.6209 +.TE
22.6210 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
22.6211 .RE
22.6212 -.LP
22.6213 -.B \-link
22.6214 -オプションを指定せずに
22.6215 -.B javadoc
22.6216 -ツールを実行した場合、ドキュメントの生成時に外部参照
22.6217 -クラスに属する名前を
22.6218 -見つけると、
22.6219 -.B javadoc
22.6220 -はその名前をリンクを持たない形で出力します。一方、
22.6221 -.B \-link
22.6222 -オプションが指定されている場合、
22.6223 -.B javadoc
22.6224 -ツールは、指定された
22.6225 -.IR extdocURL
22.6226 -の場所にある
22.6227 -.B package-list
22.6228 -ファイルから、該当する名前のパッケージを探します。パッケージ名が
22.6229 -見つかった場合は、その
22.6230 -.IR extdocURL
22.6231 -を名前の前に付けます。
22.6232 -.LP
22.6233 -すべてのリンクが正しく機能するためには、外部参照の
22.6234 -ドキュメントのすべてが、指定された URL に
22.6235 -存在していなければなりません。
22.6236 -.B javadoc
22.6237 -ツールは、
22.6238 -.B package-list
22.6239 -が存在するかどうかを調べるだけで、指定された URL に
22.6240 -目的のページが存在するかどうかはチェックしません。
22.6241 -.LP
22.6242 -.B 複数のリンク:
22.6243 -複数の
22.6244 -.B \-link
22.6245 -オプションを提供して、外部で生成されたドキュメントに任意数のリンクを設定できます。Javadoc 1.2 には、複数の
22.6246 -.B -link
22.6247 -コマンドを提供できないというバグがあります。このバグは、
22.6248 -1.2.2 で修正されました。
22.6249 -.LP
22.6250 -リンクする外部ドキュメントごとに別のリンクオプションを指定します。
22.6251 -.LP
22.6252 -.RS
22.6253 -.ft 3
22.6254 -.nf
22.6255 -% javadoc \-link extdocURL1 \-link extdocURL2 ... \-link extdocURLn com.mypackage
22.6256 -.fi
22.6257 -.ft 1
22.6258 .RE
22.6259 -.LP
22.6260 -.BR extdocURL1、
22.6261 -.BR extdocURL2、...
22.6262 -.BR extdocURLn
22.6263 -は、それぞれ外部ドキュメントの
22.6264 -ルートを指し、各ルートには、
22.6265 -.BR package-list
22.6266 -という名前のファイルが含まれています。
22.6267 -.LP
22.6268 -クロスリンク - まだ生成されていない 2 つ以上のドキュメントを
22.6269 -クロスリンクする場合は、「ブートストラッピング」が必要になることに
22.6270 -注意してください。言い換えると、どのドキュメントの
22.6271 -.B package-list
22.6272 -も存在していない場合、最初のドキュメントに対して
22.6273 -.B javadoc
22.6274 -ツールを実行した時点では、2 番目のドキュメントの
22.6275 -.B package-list
22.6276 -はまだ存在していません。したがって、外部リンクを作成するには、
22.6277 -2 番目のドキュメントを
22.6278 -生成したあと、最初のドキュメントを生成し直す必要があります。
22.6279 -.LP
22.6280 -この場合、最初に行うドキュメント生成の目的は、
22.6281 -.B package-list
22.6282 -を作成することです。パッケージ名をすべて把握している場合は、
22.6283 -.B package-list
22.6284 -を手動で作成することもできます。次に、2 番目のドキュメントと
22.6285 -その外部リンクを生成します。
22.6286 -.B javadoc
22.6287 -ツールは、必要な外部の
22.6288 -.B package-list
22.6289 -ファイルが存在しない場合は、警告を表示します。
22.6290 -.TP
22.6291 -.BI \-linkoffline " extdocURL packagelistLoc"
22.6292 -このオプションは、
22.6293 -.BR \-link
22.6294 -オプションを変えたものです。どちらも、javadoc で
22.6295 -生成された外部参照クラスのドキュメントへのリンクを作成します。
22.6296 -.B Javadoc
22.6297 -ツールが「オフライン」で、Web 上のドキュメントに
22.6298 -リンクする場合は、Web 接続経由ではドキュメントに
22.6299 -アクセスできないため、
22.6300 -.B \-linkoffline
22.6301 -オプションを使用します。
22.6302 -.LP
22.6303 -厳密には、外部ドキュメントの \f2package\-list\fP ファイルにアクセスできないとき、またはこのファイルが \f2extdocURL\fP で指定された場所とは異なる場所 (通常、\f2packageListLoc\fP で指定可能なローカルな場所) に存在するとき、\f2\-linkoffline\fP を使用します。したがって、\f2extdocURL\fP に WWW 上でしかアクセスできない場合は、\f2\-linkoffline\fP を指定することにより、ドキュメントの生成時に javadoc ツールが Web に接続できなければならないという制約がなくなります。
22.6304 -.LP
22.6305 -さらに、ドキュメントを更新するための「ハッキング」としての使用も可能です。パッケージのセット全体に対して javadoc を実行したあと、変更した一部のパッケージだけに対して javadoc を実行します。こうして、更新されたファイルを、オリジナルのファイルセットに挿入できるようにします。例をあとで示します。
22.6306 -.LP
22.6307 -.BR \-linkoffline
22.6308 -オプションには 2 つの引数があります。1 つは
22.6309 -<a href> リンクに埋め込む文字列、もう 1 つは
22.6310 -.BR package-list:
22.6311 -の検索場所を示します。
22.6312 -.LP
22.6313 -.RS
22.6314 -.TP 2
22.6315 -\(bu
22.6316 -.I extdocURL
22.6317 -は、\f3javadoc\f1 によって生成され、リンク先として指定する
22.6318 -外部ドキュメントがあるディレクトリの絶対
22.6319 -URL または相対 URL です。 相対リンクの場合、
22.6320 -生成先ディレクトリ (\-d で指定) からの相対パスを、
22.6321 -リンク先パッケージのルートに渡す必要があります。 詳細は、
22.6322 -.B \-link
22.6323 -オプションの
22.6324 -.I extdocURL
22.6325 -を参照してください。
22.6326 -.TP 2
22.6327 -\(bu
22.6328 -.I packagelistLoc
22.6329 -には、外部ドキュメントの
22.6330 -.B package-list
22.6331 -ファイルが入っているディレクトリのパスまたは
22.6332 -URL を指定します。 URL (http: または file:)
22.6333 -またはファイルパスを指定できます。
22.6334 -また、絶対パスと相対パスのどちらでもかまいません。
22.6335 -相対パスの場合は、javadoc が実行される現在の
22.6336 -ディレクトリからの相対パスとして指定します。
22.6337 -.BR package-list
22.6338 -というファイル名は含めないでください。
22.6339 -.LP
22.6340 -.B javadoc
22.6341 -の 1 回の実行で、複数の
22.6342 -.B \-linkoffline
22.6343 -オプションを指定できます。
22.6344 -1.2.2 より前のバージョンでは、複数のオプションは指定できませんでした。
22.6345 -.LP
22.6346 -外部ドキュメントへの絶対リンクを使った例 -
22.6347 -.BR java.lang
22.6348 -、
22.6349 -.BR java.io
22.6350 -、およびその他の Java 2 プラットフォームパッケージ (\f2http://java.sun.com/j2se/1.5.0/docs/api\fP)
22.6351 -にリンクしたくても、Web にアクセスできない
22.6352 -場合について考えてみます。
22.6353 -.BR package-list
22.6354 -ファイルをブラウザで開き (\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP)、
22.6355 -ローカルディレクトリに保存します。
22.6356 -次に、2 番目の引数
22.6357 -.I packagelistLoc
22.6358 -でそのローカルコピーを指定します。このとき
22.6359 -パッケージリストファイルは現在のディレクトリ
22.6360 -「.」に保存されています。 次のコマンドは、
22.6361 -Java 2 プラットフォームパッケージへのリンクを含む、
22.6362 -com.mypackage パッケージのドキュメントを生成します。
22.6363 -生成されたドキュメントには、たとえばクラスツリー内の
22.6364 -Object クラスへのリンクが含まれています
22.6365 -(\-sourcepath などの他の必要なオプションは表示されません)。
22.6366 -.LP
22.6367 -.RS
22.6368 -.ft 3
22.6369 -.nf
22.6370 -% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
22.6371 -.fi
22.6372 -.ft 1
22.6373 -.RE
22.6374 -.LP
22.6375 -外部ドキュメントへの相対リンクを使った例 -
22.6376 -.B \-linkoffline
22.6377 -を相対パスで指定するのはあまり一般的ではありません。通常は、
22.6378 -.B \-link
22.6379 -で十分だからです。
22.6380 -.B \-linkoffline
22.6381 -を使用している場合、
22.6382 -.BR package-list
22.6383 -ファイルは通常ローカルで、相対リンクを使用している場合は、
22.6384 -リンク先のファイルもローカルであるのが普通です。
22.6385 -そのため、
22.6386 -.B \-linkoffline
22.6387 -に 2 つの異なる引数のパスを
22.6388 -与える必要はありません。 2 つの引数が同じである場合、
22.6389 -.B \-link
22.6390 -を使用できます。
22.6391 -.B \-link
22.6392 -の相対リンクの使用例を参照してください。
22.6393 -.LP
22.6394 -package-list ファイルの手動作成 -
22.6395 -.BR package-list
22.6396 -ファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを自分で作成し、
22.6397 -.I packagelistLoc
22.6398 -でそのパスを指定することができます。
22.6399 -com.apipackage が最初に作成されたときに
22.6400 -com.spipackage のパッケージリストが存在しなかった、
22.6401 -以前の場合がその例です。
22.6402 -この方法は、パッケージ名はわかっているものの、
22.6403 -まだ公開されていない、新しい外部ドキュメントにリンクする
22.6404 -ドキュメントを生成する場合に便利です。
22.6405 -また、Javadoc 1.0 または 1.1 では package-list ファイルが
22.6406 -生成されないため、この方法で、これらのバージョンで
22.6407 -生成されたパッケージの package-list ファイルを生成できます。
22.6408 -2 つの会社が未公開の package-list ファイルを
22.6409 -共有することもできるため、クロスリンクを設定した
22.6410 -ドキュメントを同時にリリースすることも可能です。
22.6411 -.LP
22.6412 -複数のドキュメントにリンク -
22.6413 -.B \-linkoffline
22.6414 -は、参照先の生成ドキュメントごとに 1 つずつ指定します。
22.6415 -次の例では、わかりやすくするために
22.6416 -オプションごとに行を分けています。
22.6417 -.LP
22.6418 -.RS
22.6419 -.ft 3
22.6420 -.nf
22.6421 -.ta 18n
22.6422 -% javadoc \-linkoffline docURL1 packagelistURL1 \\
22.6423 - \-linkoffline docURL2 packagelistURL2 \\
22.6424 -.ft 1
22.6425 - ...
22.6426 -.fi
22.6427 -.RE
22.6428 -.LP
22.6429 -.B ドキュメントの更新:
22.6430 -.B \-linkoffline
22.6431 -オプションのもう 1 つの用途は、プロジェクトで多数のパッケージを使い、
22.6432 -すでにツリー全体に対して
22.6433 -.B javadoc
22.6434 -を実行してある場合に、次の実行では、すばやく細かい
22.6435 -変更を行なってから、ソース
22.6436 -ツリーの一部に対してだけ
22.6437 -.B javadoc
22.6438 -を実行し直したい場合に便利です。これは、
22.6439 -変更がドキュメンテーションコメントに対し
22.6440 -てであり、シグニチャに対してではない場合にだけ正常に
22.6441 -処理されるので、ハッキング
22.6442 -のようなものです。ソースコードに対してシグニチャを追加、
22.6443 -削除または変更した場合は、索引、パッケージツリー、
22.6444 -継承されるメンバのリスト、[使用] ページなどの場所
22.6445 -で壊れたリンクが表示されます。
22.6446 -.LP
22.6447 -まず、新しい実行のため、新規の
22.6448 -生成先ディレクトリ (update) を作成します。オリジナルの生成先ディレクトリを html とします。もっとも簡単な例として、html の親に移動します。
22.6449 -.B \-linkoffline
22.6450 -の 1 番目の引数に現在のディレクトリ「.」を
22.6451 -設定し、2 番目の引数に package-list
22.6452 -を検索する場所である html への相対パスを設定します。更新したいパッケージのパッケージ名のみを渡します。
22.6453 -.LP
22.6454 -.RS
22.6455 -.ft 3
22.6456 -.nf
22.6457 -% javadoc \-d update \-linkoffline . html com.mypackage
22.6458 -.fi
22.6459 -.ft 1
22.6460 -.RE
22.6461 -.LP
22.6462 -.B javadoc
22.6463 -の実行が終了したとき、
22.6464 -.B update/com/package
22.6465 -内に生成されたクラス (概要や索引ではない) で、
22.6466 -html/com/package 内にあるオリジナルのファイルを上書きコピーします。
22.6467 -.TP
22.6468 -\-linksource
22.6469 -各ソースファイル (行番号付き) の HTML バージョンを作成し、標準 HTML ドキュメントからソースファイルへのリンクを追加します。リンクは、ソースファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルトコンストラクタ、生成されたクラスに対しては作成されません。
22.6470 -.LP
22.6471 -\f3このオプションは、\fP\f4\-public\fP\f3、\fP\f4\-package\fP\f3、\fP\f4\-protected\fP\f3、\fP\f4\-private\fP\f3 の各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソースファイル内の\fP\f4すべての\fP\f3非公開実装の詳細を公開します。\fP\f2\-private\fP オプションを指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。
22.6472 -.LP
22.6473 -各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\f2Button\fP クラスのソースコードヘのリンクは、「Button」という語の上に作成されます。
22.6474 +
22.6475 +.LP
22.6476 +.RS 3
22.6477 +
22.6478 +.LP
22.6479 +.LP
22.6480 +\f3@see 箴\fP
22.6481 +.br
22.6482 +勀眼潟<潟\f2@see\fP 帥違ャ宴若 (\f2java.applet.Applet\fP ) 劫翫茵腓冴腓冴障
22.6483 +.LP
22.6484 .nf
22.6485 \f3
22.6486 .fl
22.6487 - public class Button
22.6488 -.fl
22.6489 - extends Component
22.6490 -.fl
22.6491 - implements Accessible
22.6492 + ∫i:
22.6493 +.fl
22.6494 +@see java.lang.String // String \fP\f3
22.6495 +.fl
22.6496 +@see java.lang.String The String class // The String class \fP\f3
22.6497 +.fl
22.6498 +@see String // String \fP\f3
22.6499 +.fl
22.6500 +@see String#equals(Object) // String.equals(Object) \fP\f3
22.6501 +.fl
22.6502 +@see String#equals // String.equals(java.lang.Object) \fP\f3
22.6503 +.fl
22.6504 +@see java.lang.Object#wait(long) // java.lang.Object.wait(long) \fP\f3
22.6505 +.fl
22.6506 +@see Character#MAX_RADIX // Character.MAX_RADIX \fP\f3
22.6507 +.fl
22.6508 +@see <a href="spec.html">Java Spec</a> // Java Spec \fP\f3
22.6509 +.fl
22.6510 +@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
22.6511 +.fl
22.6512 +
22.6513 .fl
22.6514 \fP
22.6515 .fi
22.6516 -Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。
22.6517 -.nf
22.6518 -\f3
22.6519 -.fl
22.6520 - public String getLabel()
22.6521 -.fl
22.6522 -\fP
22.6523 +
22.6524 +.LP
22.6525 +.LP
22.6526 +\f2@see\fP ャ<潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
22.6527 +.LP
22.6528 +.LP
22.6529 +荅括完ゃ
22.6530 +.na
22.6531 +\f2@see 帥違ャ<潟\fP @
22.6532 .fi
22.6533 -.LP
22.6534 -.TP
22.6535 -.BI \-group " groupheading packagepattern:packagepattern:..."
22.6536 -概要ページの複数のパッケージを指定のグループに分け、
22.6537 -グループ単位で表を作成
22.6538 -します。各グループは、それぞれ別の
22.6539 -.B \-group
22.6540 -オプションで指定します。これらのグループは、
22.6541 -コマンド行で指定した順序でページに
22.6542 -表示されます。パッケージは、1 つのグループ内では
22.6543 -アルファベット順に並べられます。各
22.6544 -.B \-group
22.6545 -オプションでは、
22.6546 -.I packagepattern
22.6547 -式のリストに一致する
22.6548 -パッケージが、見出し
22.6549 -.IR groupheading
22.6550 -を持つ 1 つの表にまとめて表示されます。
22.6551 -.RS
22.6552 -.TP 2
22.6553 -\(bu
22.6554 -.I groupheading
22.6555 -には任意のテキストを指定でき、空白を含めることができます。
22.6556 -指定したテキストは、グループの表見出しになります。
22.6557 -.TP 2
22.6558 -\(bu
22.6559 -.I packagepattern
22.6560 -には、任意のパッケージ名、または任意のパッケージ名の先頭部分とそれに続く 1 つのアスタリスク (*)を指定できます。
22.6561 -アスタリスクは、「任意の文字に一致する」という意味のワイルドカードです。ワイルドカードとして許容されるのは、アスタリスクだけです。1 つのグループには、
22.6562 -コロン (:) で区切った複数のパターンを含めることができます。
22.6563 -.LP
22.6564 -注: パターンやパターンリスト内でアスタリスクを
22.6565 -使う場合は、"java.lang*:java.util"
22.6566 -のように、パターンリストを引用符で囲む必要があります。
22.6567 -.LP
22.6568 -.B \-group
22.6569 -オプションが 1 つも指定されていない場合は、すべての
22.6570 -パッケージが、[パッケージ]
22.6571 -という見出しを持つ 1 つのグループに入れられます。
22.6572 -ドキュメント化されるパッケージの
22.6573 -中に、指定したグループのどのグループにも入らない
22.6574 -パッケージがある場合、このような
22.6575 -パッケージは [その他のパッケージ] という見出しを
22.6576 -持つ独立したグループに入れられます。
22.6577 -.LP
22.6578 -たとえば、次のようにオプションを指定すると、
22.6579 -ドキュメント化される 4 つのパッケージは、
22.6580 -コアパッケージ、拡張機能パッケージ、
22.6581 -およびその他のパッケージに分かれます。
22.6582 -\f3java.lang*\f1 では、後続のドットがないことに
22.6583 -注意してください。\f3java.lang.*\f1 のようにドットを
22.6584 -入れると、
22.6585 -.B java.lang
22.6586 -パッケージは含まれないことになります。
22.6587 -.LP
22.6588 -.RS
22.6589 -.ft 3
22.6590 -.nf
22.6591 -% javadoc \-group "Core Packages" "java.lang*:java.util"
22.6592 - \-group "Extension Packages" "javax.*"
22.6593 - java.lang java.lang.reflect java.util javax.servlet java.new
22.6594 -.fi
22.6595 -.ft 1
22.6596 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeс
22.6597 +.LP
22.6598 .RE
22.6599 .LP
22.6600 -この結果、次のようなグループ化が行われます。
22.6601 -.LP
22.6602 -.RS
22.6603 -.ft 3
22.6604 -.nf
22.6605 -Core Packages
22.6606 - java.lang
22.6607 - java.lang.reflect
22.6608 - java.util
22.6609 -Extension Packages
22.6610 - javax.servlet
22.6611 -Other Packages
22.6612 - java.new
22.6613 -.fi
22.6614 -.ft 1
22.6615 +
22.6616 +.LP
22.6617 +.RS 3
22.6618 +.TP 3
22.6619 +@serial\ field\-description | include | exclude
22.6620 +翫純c若ャ<潟若激с潟潟<潟т戎障
22.6621 .RE
22.6622 -.RE
22.6623 -.TP
22.6624 -.B \-nodeprecated
22.6625 -推奨されない API をドキュメントに生成することを禁止します。
22.6626 -これは、
22.6627 -.B \-nodeprecatedlist
22.6628 -オプションを指定した場合の動作に加えて、
22.6629 -ドキュメントのほかの部分を通じて、
22.6630 -推奨されない API を生成しないことと同じです。
22.6631 -このオプションは、コードを記述していて、
22.6632 -推奨されないコードを無視したい場合に便利です。
22.6633 -.TP
22.6634 -.B \-nodeprecatedlist
22.6635 -推奨されない API のリストを含む
22.6636 -ファイル (\f3deprecated-list.html\f1) の生成を禁止
22.6637 -します。また、このページへのリンクを
22.6638 -ナビゲーションバーに生成することを禁止します。
22.6639 -ただし、ドキュメントのほかの部分では、
22.6640 -推奨されない API の生成を続行します。この
22.6641 -オプションは、推奨されない API がソースコードに
22.6642 -含まれておらず、ナビゲーションバーを
22.6643 -すっきりと見せたい場合に便利です。
22.6644 -.TP
22.6645 -.B \-nosince
22.6646 -生成されるドキュメントから、
22.6647 -.BR @since
22.6648 -タグに関連した「Since」セクションを削除します。
22.6649 -.TP
22.6650 -.B \-notree
22.6651 -生成されるドキュメントからクラスおよびインタフェース
22.6652 -階層を省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。
22.6653 -デフォルトでは、階層が作成されます。
22.6654 -.TP
22.6655 -.B \-noindex
22.6656 -生成されるドキュメントから索引を省略します。
22.6657 -デフォルトでは、
22.6658 -索引が作成されます。
22.6659 -.TP
22.6660 -.B \-nohelp
22.6661 -各出力ページの最上部と最下部の
22.6662 -ナビゲーションバーから [ヘルプ] リンクを
22.6663 -省略します。
22.6664 -.TP
22.6665 -.B \-nonavbar
22.6666 -生成されるページの最上部と最下部に表示される
22.6667 -ナビゲーションバー、ヘッダ、
22.6668 -およびフッタの生成を禁止します。
22.6669 -このオプションは、bottom オプションには影響しません。
22.6670 -.B \-nonavbar
22.6671 -オプションは、印刷するためだけに
22.6672 -ファイルを PostScript または PDF に変換する
22.6673 -場合など、内容だけが重要でナビゲーションの
22.6674 -必要性がない場合に便利です。
22.6675 -.TP
22.6676 -.BI \-helpfile " path/filename"
22.6677 -上部と下部のナビゲーションバーの [ヘルプ] リンクの
22.6678 -リンク先となる代替ヘルプファイル
22.6679 -.I path/filename
22.6680 -のパスを指定します。このオプションが指定されていない場合、
22.6681 -.B javadoc
22.6682 -は、javadoc にハードコードされているヘルプファイル
22.6683 -.B help-doc.html
22.6684 -を自動的に作成します。このオプションを使えば、
22.6685 -デフォルトの設定をオーバーライドでき
22.6686 -ます。ファイル名にはどのような
22.6687 -名前も指定でき、\f3help-doc.html\f1 には限定されま
22.6688 -せん。
22.6689 -.B javadoc
22.6690 -は、それに従って、ナビゲーションバーにある
22.6691 -リンクに調整を加えます。
22.6692 -次に例を示します。
22.6693 -.LP
22.6694 -.RS
22.6695 -.RS
22.6696 -.ft 3
22.6697 -.nf
22.6698 -% javadoc \-helpfile /home/doc/myhelp.html java.awt
22.6699 -.fi
22.6700 -.RE
22.6701 -.RE
22.6702 -.ft 1
22.6703 -.TP
22.6704 -.BI \-stylesheetfile " path/filename"
22.6705 -代替 HTML スタイルシートファイルのパスを指定します。
22.6706 -このオプションが指定されてい
22.6707 -ない場合、
22.6708 -.B javadoc
22.6709 -ツールは、内部的にハードコードされている
22.6710 -スタイルシートファイル
22.6711 -.BR stylesheet.css
22.6712 -を自動的に作成します。このオプションを使えば、
22.6713 -デフォルトの設定をオーバーライドできます。
22.6714 -filename にはどんなファイル名でも指定でき、
22.6715 -.BR stylesheet.css
22.6716 -には限定されません。
22.6717 -次に例を示します。
22.6718 -.LP
22.6719 -.RS
22.6720 -.RS
22.6721 -.ft 3
22.6722 -.nf
22.6723 -% javadoc \-stylesheetfile /home/user/mystylesheet.css com.mypackage
22.6724 -.fi
22.6725 -.ft 1
22.6726 -.RE
22.6727 -.RE
22.6728 -.TP
22.6729 -.B \-serialwarn
22.6730 -.B @serial
22.6731 -タグがない場合、コンパイル時に警告を生成します。デフォルトでは、
22.6732 -.B javadoc
22.6733 -1.2.2 (およびそれ以降) は
22.6734 -.B @serial
22.6735 -の警告を生成しません。
22.6736 -(これは、以前のバージョンとは逆です。)
22.6737 -.B @serial
22.6738 -の警告を生成するには、
22.6739 -このオプションを使用してください。このオプションは、デフォルトの
22.6740 -直列化可能なフィールドと writeExternal メソッドを正しく
22.6741 -ドキュメント化するのに役立ちます。
22.6742 -.TP
22.6743 -.BI \-charset " name"
22.6744 -このドキュメント用の HTML 文字セットを指定します。この名前は、
22.6745 -.na
22.6746 -\f2IANA Registry\fP
22.6747 -.fi
22.6748 -(http://www.iana.org/assignments/character\-sets) で与えられた、推奨される MIME 名でなければなりません。次に例を示します。
22.6749 -.nf
22.6750 -\f3
22.6751 -.fl
22.6752 - % \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
22.6753 -.fl
22.6754 -.fi
22.6755 -生成されるすべてのページの先頭に、次の行が挿入されます。
22.6756 -.nf
22.6757 -\f3
22.6758 -.fl
22.6759 - <META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">
22.6760 -.fl
22.6761 -\fP
22.6762 -.fi
22.6763 -この META タグについては、
22.6764 -.fi
22.6765 -http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2
22.6766 -の
22.6767 -.na
22.6768 -\f2HTML の標準\fP (4197265 および 4137321) を参照してください。
22.6769 -.LP
22.6770 -\-encoding と \-docencoding も参照してください。
22.6771 -.LP
22.6772 -.TP 3
22.6773 -\-docencoding\ name
22.6774 -生成される HTML ファイルのエンコーディングを指定します。この名前は、
22.6775 -.na
22.6776 -\f2IANA Registry\fP
22.6777 -.fi
22.6778 -(http://www.iana.org/assignments/character\-sets) で与えられた、推奨される MIME 名でなければなりません。このオプションを省略しながら \-encoding を使用した場合、生成される HTML ファイルのエンコードは、\-encoding によって決められます。次に例を示します。
22.6779 -.nf
22.6780 -\f3
22.6781 -.fl
22.6782 - % \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
22.6783 -.fl
22.6784 -.fi
22.6785 -\-encoding および \-charset も参照してください。
22.6786 -.LP
22.6787 -.TP 3
22.6788 -\-keywords
22.6789 -HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。
22.6790 -.LP
22.6791 -メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。
22.6792 -.nf
22.6793 -\f3
22.6794 -.fl
22.6795 - <META NAME="keywords" CONTENT="java.lang.String class">
22.6796 -.fl
22.6797 - <META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">
22.6798 -.fl
22.6799 - <META NAME="keywords" CONTENT="length()">
22.6800 -.fl
22.6801 - <META NAME="keywords" CONTENT="charAt()">
22.6802 -.fl
22.6803 -\fP
22.6804 -.fi
22.6805 -.LP
22.6806 -.TP 3
22.6807 -\-tag\ \ tagname:Xaoptcmf:"taghead"
22.6808 -Javadoc ツールがドキュメンテーションコメント内の引数を 1 つ取る単純なカスタムブロックタグ \f2@\fP\f2tagname\fP を解釈できるようにします。これにより、Javadoc ツールはタグ名の「スペルチェック」を行うことができるので、ソースコード内のすべてのカスタムタグに \f2\-tag\fP オプションを組み込むことをお勧めします。今回の実行で出力されないタグは、\f2X\fP を付けて無効にします。
22.6809 -.LP
22.6810 -コロン (\f4:\fP) は常に区切り文字になります。\f2tagname\fP でコロンを使用するには、「タグ名でのコロンの使用」を参照してください。
22.6811 -.LP
22.6812 -\f2\-tag\fP オプションは、タグの見出し「\f2taghead\fP」を太字で出力します。その次の行には、このオプションの引数で指定したテキストが続きます。以下の例を参照してください。ブロックタグと同様、この引数のテキストにはインラインタグを含めることができます。このインラインタグも解釈されます。出力は、引数を 1 つ取る標準のタグ (\f2@return\fP、\f2@author\fP など) の出力とよく似ています。\f2taghead\fP を省略すると、\f2tagname\fP が見出しとして表示されます。
22.6813 -.LP
22.6814 -\f3タグの配置\fP \- 引数の \f4Xaoptcmf\fP 部分は、ソースコード内のタグを配置できる位置と、\f2X\fP を使ってこのタグを無効にできるかどうかを特定します。タグの配置位置を制限しない場合は \f4a\fP を指定します。それ以外の文字の組み合わせも可能です。
22.6815 -.br
22.6816 -\f4X\fP (タグの無効化)
22.6817 -.br
22.6818 -\f4a\fP (すべての位置)
22.6819 -.br
22.6820 -\f4o\fP (概要)
22.6821 -.br
22.6822 -\f4p\fP (パッケージ)
22.6823 -.br
22.6824 -\f4t\fP (型すなわちクラスおよびインタフェース)
22.6825 -.br
22.6826 -\f4c\fP (コンストラクタ)
22.6827 -.br
22.6828 -\f4m\fP (メソッド)
22.6829 -.br
22.6830 -\f4f\fP (フィールド)
22.6831 -.LP
22.6832 -シングルタグの例 -
22.6833 -ソースコードの任意の場所で使用できる
22.6834 -タグのタグオプションの例を示します。
22.6835 -.LP
22.6836 -.RS
22.6837 -.TP 3
22.6838 -\-tag todo:a:"To Do:"
22.6839 -.RE
22.6840 -.LP
22.6841 -コンストラクタ、メソッド、およびフィールドだけで @todo を
22.6842 -使用させるには、次のようにします。
22.6843 -.LP
22.6844 -.RS
22.6845 -.ft 3
22.6846 -.nf
22.6847 -\-tag todo:cmf:"To Do:"
22.6848 -.fi
22.6849 -.ft 1
22.6850 -.RE
22.6851 -.LP
22.6852 -上記では、末尾のコロン (:) がパラメータの
22.6853 -区切り記号ではなく、表示のとおり、
22.6854 -見出しテキストの一部であることに注意してください。
22.6855 -次のように、@todo タグを含むソースコードに
22.6856 -どちらかのタグオプションを使用します。
22.6857 -.LP
22.6858 -.RS
22.6859 -.ft 3
22.6860 -.nf
22.6861 -@todo The documentation for this method needs work.
22.6862 -.fi
22.6863 -.ft 1
22.6864 -.LP
22.6865 -タグ名にコロンを使用する \-
22.6866 -コロン (:) をバックスラッシュでエスケープすると、
22.6867 -コロンをタグ名に使用することができます。
22.6868 -.LP
22.6869 -.RS 5
22.6870 -.nf
22.6871 -/**
22.6872 -* @ejb:bean
22.6873 -*/
22.6874 -.RE
22.6875 -.fi
22.6876 -.LP
22.6877 -でこのタグオプションを使用すると、
22.6878 -.LP
22.6879 -.RS 5
22.6880 -.nf
22.6881 -\-tag ejb\\:bean:a:"EJB Bean:"
22.6882 -.RE
22.6883 -.LP
22.6884 -となります。
22.6885 -.fi
22.6886 -.ft 1
22.6887 -.RE
22.6888 -.LP
22.6889 -タグ名のスペルチェック (タグの無効化) - 開発者は、ソースコードの中で出力できないカスタムタグを使用することがあります。その場合、ソースタグに存在するすべてのタグをリストし、出力するタグを有効化し、出力しないタグを無効化することが重要です。 X を使用するとタグを無効化でき、これがない場合はタグが有効となります。 この文字の存在によって、
22.6890 -.B Javadoc
22.6891 -ツールは、検出したタグが未知のタグで、おそらく綴り間違いであると判断できます。 この場合、警告メッセージが表示されます。
22.6892 -.LP
22.6893 -すでに存在する、配置を指定する引数の値に X を追加した場合、タグを有効にしたいときに X を削除できます。 たとえば、@todo が出力したくないタグの場合、次のようにします。
22.6894 -.LP
22.6895 -.RS
22.6896 -.ft 3
22.6897 -.nf
22.6898 -\-tag todo:Xcmf:"To Do:"
22.6899 -.fi
22.6900 -.ft 1
22.6901 -.RE
22.6902 -.LP
22.6903 -または、次のようにより簡単にすることもできます。
22.6904 -.LP
22.6905 -.RS
22.6906 -.ft 3
22.6907 -.nf
22.6908 -\-tag todo:X
22.6909 -.fi
22.6910 -.ft 1
22.6911 -.RE
22.6912 -.LP
22.6913 -\-tag todo:X の構文は、@todo がタグレットで
22.6914 -定義されている場合も有効です。
22.6915 -.LP
22.6916 -タグの順序 -
22.6917 -\-tag (および \-taglet) オプションの順序に従って
22.6918 -タグが出力されます。 カスタムタグと標準タグを
22.6919 -混在させることができます。 標準タグのタグオプションは、
22.6920 -順序を決定するためだけのプレースホルダです。
22.6921 -これらは標準タグ名だけを使用します
22.6922 -(標準タグの小見出しは変更できません)。
22.6923 -これを次の例に示します。
22.6924 -.LP
22.6925 -\-tag がない場合、\-taglet の場所によってその順序が決まります。
22.6926 -この 2 つが両方ある場合は、コマンド行の最後に使用された方が
22.6927 -順序を決定します (これは、タグとタグレットが、
22.6928 -コマンド行で使用された順に処理されるためです)。
22.6929 -たとえば、\-taglet と \-tag が両方とも todo という
22.6930 -名前である場合、コマンド行の最後で使用された
22.6931 -方が順序を決定します。
22.6932 -.LP
22.6933 -タグの完全なセットの例 -
22.6934 -この例では、出力の Parameters と Throws の間に
22.6935 -To Do を挿入します。 「X」を使用して、@example が
22.6936 -ソースコード内の今回の実行で出力されないタグで
22.6937 -あることを指定できます。 @argfile を使用すると、
22.6938 -次のように行の継続文字なしで、
22.6939 -引数ファイルの異なる行にタグを配置できます。
22.6940 -.LP
22.6941 -.RS
22.6942 -.ft 3
22.6943 -.nf
22.6944 -\-tag param
22.6945 -\-tag return
22.6946 -\-tag todo:a:"To Do:"
22.6947 -\-tag throws
22.6948 -\-tag see
22.6949 -\-tag example:X
22.6950 -.fi
22.6951 -.ft 1
22.6952 -.RE
22.6953 -.LP
22.6954 -javadoc がドキュメンテーションコメントを解析する際に、
22.6955 -検出されたタグのうち、標準タグでもなく、
22.6956 -\-tag や \-taglet で渡されるタグでもないものは、
22.6957 -不明なタグとして認識し、警告がスローされます。
22.6958 -.LP
22.6959 -標準タグは、最初、デフォルトの順序で
22.6960 -リスト内部的に格納されます。
22.6961 -\-tag オプションを使用すると、このタグがリストに追加されます。
22.6962 -標準タグはデフォルトの位置から移動します。
22.6963 -そのため、標準タグで \-tag オプションが省略されると、
22.6964 -デフォルトの位置に配置されたままになります。
22.6965 -.LP
22.6966 -競合の回避 -
22.6967 -固有のネームスペースを細かく分けるには、
22.6968 -パッケージに使用されている com.mycompany.todo
22.6969 -という名前のように、ドット (.) を区切り記号とする名前を使います。
22.6970 -Sun は今後もドットを含まない標準タグを作成します。
22.6971 -ユーザが作成したタグは、Sun が定義した同じ
22.6972 -名前のタグの動作をオーバーライドします。
22.6973 -つまり、ユーザが @todo という名前のタグまたは
22.6974 -タグレットを作成していた場合、そのあとで Sun が
22.6975 -同じ名前の標準タグを作成しても、ユーザが定義した
22.6976 -動作はそのまま維持されます。
22.6977 -.LP
22.6978 -\f3注釈 vs. Javadoc タグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメンテーションに影響を与えたりドキュメンテーションを生成したりするためのものである場合、そのマークアップは javadoc タグにすべきです。それ以外の場合は注釈にすべきです。
22.6979 -.na
22.6980 -「\f2Comparing Annotations and Javadoc Tags\fP」
22.6981 -.fi
22.6982 -(http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotations) を参照してください。
22.6983 -.LP
22.6984 -\-taglet オプションを使用して、より複雑な
22.6985 -スタンドアロンタグやカスタムインラインタグを
22.6986 -作成することができます。
22.6987 -.TP
22.6988 -\-taglet class
22.6989 -タグのドキュメントの生成に使うタグレットを起動するための
22.6990 -クラスファイルを指定します。
22.6991 -クラスの完全修飾名を指定してください。
22.6992 -このタグレットは、カスタムタグが持っているテキスト引数の
22.6993 -数も定義します。 タグレットはこれらの引数を受け取り、
22.6994 -処理し、出力を生成します。 タグレットの例の詳細については、
22.6995 -タグレットの概要を参照してください。
22.6996 -.LP
22.6997 -タグレットはスタンドアロンタグまたはインラインタグに
22.6998 -使用すると便利です。 タグレットでは任意の
22.6999 -数の引数を持つことができ、カスタムの動作を実装できます。
22.7000 -たとえば、テキストを太字にしたり、箇条書き形式にしたり、
22.7001 -テキストをファイルに書き出したり、
22.7002 -他のプロセスを起動したりすることができるのです。
22.7003 -.LP
22.7004 -タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガするなどの副作用は得られます。
22.7005 -.LP
22.7006 -タグレットへのパスを指定するには、
22.7007 -.B \-tagletpath
22.7008 -オプションを使用します。
22.7009 -生成されたページの Parameters と Throws の間に
22.7010 -To Do タグレットを挿入する例を示します。
22.7011 -.LP
22.7012 -.RS
22.7013 -.ft 3
22.7014 -.nf
22.7015 -\-taglet com.sun.tools.doclets.ToDoTaglet
22.7016 -\-tagletpath /home/taglets
22.7017 -\-tag return
22.7018 -\-tag param
22.7019 -\-tag todo
22.7020 -\-tag throws
22.7021 -\-tag see
22.7022 -.fi
22.7023 -.ft 1
22.7024 -.RE
22.7025 -.LP
22.7026 -.B \-taglet
22.7027 -オプションを
22.7028 -.B \-tag
22.7029 -オプションの代わりに使用することもできますが、
22.7030 -その結果、読みにくくなります。
22.7031 -.TP
22.7032 -\-tagletpath tagletpathlist
22.7033 -taglet クラスファイル (.class) を探すための検索パスを指定します。
22.7034 -.I tagletpathlist
22.7035 -には、コロン (:) で
22.7036 -区切って複数のパスを含めることができます。
22.7037 -.B Javadoc
22.7038 -ツールは、指定されたパス以下のすべての
22.7039 -サブディレクトリを検索します。
22.7040 -.TP
22.7041 -\-docfilessubdirs
22.7042 -doc-files ディレクトリを、下の階層を含めてコピー
22.7043 -できるようにします。 つまり、サブディレクトリとすべての
22.7044 -コンテンツが、生成先ディレクトリに再帰的にコピーされます。
22.7045 -たとえば、
22.7046 -.BR doc-files/example/images
22.7047 -ディレクトリとその中のファイルがコピーされます。
22.7048 -サブディレクトリを除外するためのオプションもあります。
22.7049 -.TP
22.7050 -\-excludedocfilessubdirs name1:name2:...
22.7051 -doc-files のサブディレクトリで、指定された
22.7052 -名前のものを除外します。 このオプションを使用すると、
22.7053 -SCCS およびその他のソースコード管理の
22.7054 -サブディレクトリをコピーしないようにできます。
22.7055 -.TP
22.7056 -\-noqualifier all | packagename1:packagename2:...
22.7057 -修飾パッケージ名を、出力のクラス名の前から削除します。
22.7058 -\-noqualifier の引数は
22.7059 -all (すべてのパッケージ修飾子を削除)、
22.7060 -またはコロンで区切られたパッケージリストの
22.7061 -いずれかで、修飾子として削除されます。
22.7062 -ワイルドカードも使用できます。
22.7063 -パッケージ名はクラス名またはインタフェース名が
22.7064 -表示されたところから削除されます。
22.7065 -.LP
22.7066 -次の例では、すべてのパッケージ修飾子を省略します。
22.7067 -.LP
22.7068 -.RS
22.7069 -.ft 3
22.7070 -.nf
22.7071 -\-noqualifier all
22.7072 -.fi
22.7073 -.ft 1
22.7074 -.RE
22.7075 -.LP
22.7076 -次の例では、パッケージ修飾子 java.lang
22.7077 -および java.io を省略します。
22.7078 -.LP
22.7079 -.RS
22.7080 -.ft 3
22.7081 -.nf
22.7082 -\-noqualifier java.lang:java.io
22.7083 -.fi
22.7084 -.ft 1
22.7085 -.RE
22.7086 -.LP
22.7087 -次の例では、java および com.sun から
22.7088 -始まる (javax を除く)
22.7089 -サブパッケージのパッケージ修飾子を削除します。
22.7090 -.LP
22.7091 -.RS
22.7092 -.ft 3
22.7093 -.nf
22.7094 -\-noqualifier java.*:com.sun.*
22.7095 -.fi
22.7096 -.ft 1
22.7097 -.RE
22.7098 -.LP
22.7099 -パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、
22.7100 -\-noqualifier が
22.7101 -使用されているかどうかにかかわらず存在します。
22.7102 -.TP
22.7103 -.BI \-notimestamp
22.7104 -タイムスタンプが抑制されます。
22.7105 -各ページ先頭近くにある、生成された HTML 内の
22.7106 -HTML コメントでタイムスタンプが隠されます。
22.7107 -.B Javadoc
22.7108 -を 2 つのソースベースで実行し、それらに対して
22.7109 -diff を実行するときにこのオプションを使用すると、
22.7110 -タイムスタンプによって diff が発生しなくなるので
22.7111 -便利です (このオプションを使用しないと、
22.7112 -各ページで diff になります)。
22.7113 -タイムスタンプには
22.7114 -.B Javadoc
22.7115 -のバージョン番号が含まれており、
22.7116 -次のようになります。
22.7117 -.LP
22.7118 -.RS 5
22.7119 - <!-- Generated by javadoc (build 1.5.0-internal)
22.7120 - on Tue Jun 22 09:57:24 PDT 2004 -->
22.7121 -.RE
22.7122 -.TP
22.7123 -\-nocomment
22.7124 -記述およびすべてのタグを含むコメント
22.7125 -本文全体を抑制し、宣言だけを生成します。
22.7126 -このオプションにより、元は異なる目的のためだった
22.7127 -ソースファイルを再利用し、
22.7128 -新しいプロジェクトのためのスケルトンを
22.7129 -作成できるようになりました。
22.7130 -.SS コマンド行引数ファイル
22.7131 -.BR javadoc
22.7132 -のコマンド行を短くしたり簡潔にしたりするために、
22.7133 -.BR javadoc
22.7134 -コマンドに対する引数 (\-J オプションを除く) が
22.7135 -入った 1 つ以上のファイルを指定することができます。
22.7136 -このことを利用すれば、どのオペレーティングシステム
22.7137 -上でも、任意の長さの
22.7138 -.BR javadoc
22.7139 -コマンドを作成できます。
22.7140 -.LP
22.7141 -引数ファイルには、javac オプションとソースファイル名を
22.7142 -自由に組み合わせて記述できます。
22.7143 -また、Javadoc オプションに対する引数だけを記述してもかまいません。
22.7144 -ファイル内の各引数は、空白文字または改行で区切ります。
22.7145 -ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲む必要があります。
22.7146 -.LP
22.7147 -.LP
22.7148 -引数ファイル内のファイル名は、
22.7149 -現在のディレクトリから見た相対パスになります。
22.7150 -引数ファイルの位置から見た相対パスではありません。
22.7151 -引数ファイル内のファイル名リストでは、
22.7152 -ワイルドカード (*) は使用できません。
22.7153 -たとえば、*.java とは指定できません。
22.7154 -引数ファイル内の引数で @ 文字を使用して、
22.7155 -複数のファイルを再帰的に解釈することはサポートされていません。
22.7156 -また、\-J オプションもサポートされていません。
22.7157 -このオプションは起動ツールに渡されますが、
22.7158 -起動ツールでは引数ファイルをサポートしていないからです。
22.7159 -.LP
22.7160 -.BR javadoc
22.7161 -を実行するときに、各引数ファイルのパスとファイル名の
22.7162 -先頭に @ 文字を付けて渡します。
22.7163 -.BR javadoc
22.7164 -は、@ 文字で始まる引数を見つけると、
22.7165 -そのファイルの内容を展開して引数リストに挿入します。
22.7166 -.LP
22.7167 -引数ファイルを 1 つ指定する例
22.7168 -.LP
22.7169 -argfile という名前の引数ファイルにすべての
22.7170 -Javadoc 引数を格納し、次のように使用することができます。
22.7171 -.LP
22.7172 -.RS
22.7173 -.ft 3
22.7174 -.nf
22.7175 -% javadoc @argfile
22.7176 -.fi
22.7177 -.ft 1
22.7178 -.RE
22.7179 -.LP
22.7180 -この引数ファイルには、次の例で示されている
22.7181 -2 つのファイルの内容を両方とも入れることができます。
22.7182 -.LP
22.7183 -引数ファイルを 2 つ指定する例
22.7184 -.LP
22.7185 -Javadoc オプション用に 1 つ、パッケージ名またはソースファイル名用に
22.7186 -1 つというように、2 つの引数ファイルを作成し、
22.7187 -次のようにして使用することができます。
22.7188 -なお、このあとのリストでは、行の継続文字を使用していません。
22.7189 -.LP
22.7190 -以下の内容を含む options という名前のファイルを作成します。
22.7191 -.LP
22.7192 -.RS
22.7193 -.ft 3
22.7194 -.nf
22.7195 -\-d docs-filelist
22.7196 -\-use
22.7197 -\-splitindex
22.7198 -\-windowtitle 'Java 2 Platform v1.3 API Specification'
22.7199 -\-doctitle 'Java<sup><font size="-2">TM</font></sup> 2\\
22.7200 - Platform 5.0 API Specification'
22.7201 -\-header '<b>Java 2 Platform </b><br><font size="-1">5.0</font>'
22.7202 -\-bottom 'Copyright 1993-2000 Sun Microsystems, Inc. All Rights Reserved.'
22.7203 -\-group "Core Packages" "java.*"
22.7204 -\-overview /java/pubs/ws/1.5/src/share/classes/overview-core.html
22.7205 -\-sourcepath /java/pubs/ws/1.5/src/share/classes
22.7206 -.fi
22.7207 -.ft 1
22.7208 -.RE
22.7209 -.LP
22.7210 -以下の内容を含む packages という名前のファイルを作成します。
22.7211 -.LP
22.7212 -.RS
22.7213 -.ft 3
22.7214 -.nf
22.7215 -com.mypackage1
22.7216 -com.mypackage2
22.7217 -com.mypackage3
22.7218 -.fi
22.7219 -.ft 1
22.7220 -.RE
22.7221 -.LP
22.7222 -そのあと、次のコマンドを使用して javadoc を実行します。
22.7223 -.LP
22.7224 -.RS
22.7225 -.ft 3
22.7226 -.nf
22.7227 -% javadoc @options @packages
22.7228 -.fi
22.7229 -.ft 1
22.7230 -.RE
22.7231 -.LP
22.7232 -パス付きの引数ファイルの例
22.7233 -.LP
22.7234 -引数ファイルには、パスを指定できます。
22.7235 -ただし、そのファイル内に指定されたファイル名は、
22.7236 -現在の作業ディレクトリから見た相対パスになります。
22.7237 -つまり、下の例の場合は、path1 や
22.7238 -path2 から見た相対パスではありません。
22.7239 -.LP
22.7240 -.RS
22.7241 -.ft 3
22.7242 -.nf
22.7243 -% javadoc @path1/options @path2/packages
22.7244 -.fi
22.7245 -.ft 1
22.7246 -.RE
22.7247 -.LP
22.7248 -オプションの引数の例
22.7249 -.LP
22.7250 -次に、javadoc オプションに対する引数だけを引数ファイルに
22.7251 -格納する例を示します。 ここでは、\-bottom オプションを
22.7252 -例に取り上げます。そのオプションには、
22.7253 -かなり長い引数を指定することがあるからです。
22.7254 -まず、このオプションのテキスト引数になる
22.7255 -次のような内容を含む、bottom という名前の
22.7256 -ファイルを作成します。
22.7257 -.LP
22.7258 -'<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">
22.7259 -Submit a bug or feature</a><br><br>Java is a
22.7260 -trademark or registered trademark of
22.7261 -Sun Microsystems, Inc. in the US and other
22.7262 -countries.<br>Copyright 1993-2000 Sun
22.7263 -Microsystems, Inc. 901 San Antonio Road,<br>Palo
22.7264 -Alto, California, 94303, U.S.A.
22.7265 -All Rights Reserved.</font>'
22.7266 -.LP
22.7267 -そのあと、次のようにして
22.7268 -.B javadoc
22.7269 -ツールを実行します。
22.7270 -.LP
22.7271 -.TP 3
22.7272 -% javadoc \-bottom @bottom @packages
22.7273 -.LP
22.7274 -また、引数ファイルの先頭に
22.7275 -\-bottom オプションを組み込んでおけば、次のようにして実行できます。
22.7276 -.LP
22.7277 -.RS
22.7278 -.ft 3
22.7279 -.nf
22.7280 -% javadoc @bottom @packages
22.7281 -.fi
22.7282 -.ft 1
22.7283 -.RE
22.7284 -.TP
22.7285 -.SH 実行
22.7286 -.SS Javadoc の実行
22.7287 -バージョン番号 -
22.7288 -.LP
22.7289 -javadoc のバージョン番号は
22.7290 -.BR javadoc \-J\-version
22.7291 -を使用することで確認できます。
22.7292 -標準ドックレットのバージョン番号は出力ストリームに
22.7293 -表示されます。
22.7294 -これは \-quiet オプションでオフにできます。
22.7295 -.LP
22.7296 -プログラムから利用できる public インタフェース -
22.7297 -Java 言語で書かれたプログラム内から
22.7298 -.B javadoc
22.7299 -ツールを呼び出します。
22.7300 -このインタフェースは
22.7301 -.BR com.sun.tools.javadoc.Main
22.7302 -(javadoc は再入)
22.7303 -にあります。 詳細は、「標準ドックレット」
22.7304 -を参照してください。
22.7305 -.LP
22.7306 -\f3ドックレットの実行\fP \-
22.7307 -下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、
22.7308 -.na
22.7309 -「\f2Running the MIF Doclet\fP」
22.7310 -.fi
22.7311 -(http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet) を参照してください。
22.7312 -.LP
22.7313 -.SH "使用例"
22.7314 -.B javadoc
22.7315 -は、パッケージ全体に対して実行することも、
22.7316 -個々のソースファイルに対して実行することも
22.7317 -できます。各パッケージ名は、それぞれの
22.7318 -パッケージ名に対応するディレクトリ名を
22.7319 -持ちます。次の例では、ソースファイルは
22.7320 -.BR /home/src/java/awt/*java
22.7321 -にあります。生成先ディレクトリは
22.7322 -.BR /home/html
22.7323 -です。
22.7324 -.SS "1 つ以上のパッケージのドキュメント化"
22.7325 -パッケージをドキュメント化するには、その
22.7326 -パッケージのソースファイル (*\f3.java\f1)
22.7327 -が、パッケージと同じ名前を持つディレクトリ
22.7328 -内に存在していなければなりません。
22.7329 -パッケージ名が複数の識別子で構成されている
22.7330 -(java.awt.color のように、各識別子はドットで
22.7331 -区切られている) 場合は、後続の各識別子が下位の
22.7332 -サブディレクトリに対応して
22.7333 -いなければなりません (java/awt/color など)。
22.7334 -1 つのパッケージのための複数のソースファイルを、
22.7335 -異なる場所にある 2 つのディレクトリツリーに分けて
22.7336 -格納することも可能です
22.7337 - (
22.7338 -.BR src1/java/awt/color
22.7339 -と
22.7340 -.BR src2/java/awt/color
22.7341 -など)。
22.7342 -ただし、その場合は、\-sourcepath によって、
22.7343 -その両方の場所を指定しなければなりません。
22.7344 -.LP
22.7345 -.B javadoc
22.7346 -を実行するには、cd コマンドを使って
22.7347 -ディレクトリを変更するか、
22.7348 -または
22.7349 -.B \-sourcepath
22.7350 -オプションを使用します。
22.7351 -それぞれの例を次に示します。
22.7352 -.TP 2
22.7353 -\(bu
22.7354 -.B ケース 1 - 1 つ以上のパッケージからの起動を再帰的に実行 -
22.7355 -この例では javadoc が任意のディレクトリから実行できるように、
22.7356 -.BR \-sourcepath
22.7357 -を使用し、再帰的処理のために -subpackages (1.4 の新オプション) を使用します。 これは、java のサブパッケージ (
22.7358 -.BR java.net
22.7359 -および
22.7360 -.BR java.lang
22.7361 -をルートとするパッケージを除く) を処理します。
22.7362 -これによって
22.7363 -.BR java.lang.ref (
22.7364 -.BR java.lang
22.7365 -のサブパッケージ) が
22.7366 -除外されることに注意してください。
22.7367 -.LP
22.7368 -.RS
22.7369 -.ft 3
22.7370 -.nf
22.7371 -% javadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java.net:java.lang
22.7372 -.fi
22.7373 -.ft 1
22.7374 -.RE
22.7375 -.LP
22.7376 -他のパッケージツリーを処理するには、
22.7377 -.BR java:javax:org.xml.sax
22.7378 -のように、その名前を
22.7379 -.BR \-subpackages
22.7380 -引数に追加します。
22.7381 -.TP 2
22.7382 -\(bu
22.7383 -.B ケース 2 - ルートソースディレクトリに移ってから明示的なパッケージを実行 -
22.7384 -完全修飾パッケージの
22.7385 -親ディレクトリに移動します。
22.7386 -次に、ドキュメント化する
22.7387 -1 つ以上のパッケージ名を指定して
22.7388 -.BR javadoc
22.7389 -を実行します。
22.7390 -.LP
22.7391 -.RS
22.7392 -.ft 3
22.7393 -.nf
22.7394 -% cd /home/src/
22.7395 -% javadoc \-d /home/html java.awt java.awt.event
22.7396 -.fi
22.7397 -.ft 1
22.7398 -.RE
22.7399 -.TP 2
22.7400 -\(bu
22.7401 -.B ケース 3 - 任意のディレクトリから実行。ソースファイルは 1 つのディレクトリツリー内にある - このケースでは、現在のディレクトリがどこであってもかまいません。 トップレベルのパッケージの親ディレクトリを
22.7402 -.B \-sourcepath
22.7403 -に指定し、ドキュメント化する 1 つ以上のパッケージ名を指定して、
22.7404 -.B javadoc
22.7405 -を実行します。
22.7406 -.LP
22.7407 -.RS
22.7408 -.ft 3
22.7409 -.nf
22.7410 - % javadoc -d /home/html -sourcepath /home/src java.awt java.awt.event
22.7411 -.fi
22.7412 -.ft 1
22.7413 -.RE
22.7414 -.TP 2
22.7415 -\(bu
22.7416 -.B ケース 4 - 任意のディレクトリから実行。ソースファイルは複数のディレクトリツリー内にある - これはケース 3 と似ていますが、パッケージが複数のディレクトリツリーに存在します。 各ツリーのルートへのパスを
22.7417 -.B \-sourcepath
22.7418 -に指定し (コロンで区切る)、ドキュメント化する 1 つ以上のパッケージ名を指定して、javadoc を実行します。 1 つのパッケージのすべてのソースファイルが、1 つのルートディレクトリの下に存在しなければならない、ということはありません。ソースパスとして指定された場所のどこかで見付かれば十分です。
22.7419 -.LP
22.7420 -.RS
22.7421 -.ft 3
22.7422 -.nf
22.7423 -% javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java.awt java.awt.event
22.7424 -.fi
22.7425 -.ft 1
22.7426 -.RE
22.7427 -.LP
22.7428 -結果: どちらのケースでも、パッケージ
22.7429 -.B java.awt
22.7430 -と
22.7431 -.B java.awt.event
22.7432 -の public および protected
22.7433 -なクラスとインタフェースを対象に、HTML 形式の
22.7434 -ドキュメントが生成され、指定
22.7435 -された生成先ディレクトリ (\f3/home/html\f1) に HTML ファイルが
22.7436 -保存されます。2 つ
22.7437 -以上のパッケージが生成されるので、ドキュメントは、
22.7438 -パッケージのリスト、クラスのリスト、
22.7439 -およびメインページの 3 つのフレームを持つことになります。
22.7440 -.SS "1 つ以上のクラスのドキュメント化"
22.7441 -.B javadoc
22.7442 -ツールを実行する 2 番目の方法は、1 つ以上のソースファイル (
22.7443 -.B .java
22.7444 -) を渡すことです。
22.7445 -.B javadoc
22.7446 -は、次の 2 つのどちらかの方法で実行できます。
22.7447 -1 つは、(cd によって) ディレクトリを
22.7448 -変更する方法、もう 1 つは
22.7449 -.B .java
22.7450 -ファイルへのパスを完全指定する方法です。
22.7451 -相対パスは、現在のディレクトリからの相対パスです。
22.7452 -ソースファイルを渡した場合、
22.7453 -.B \-sourcepath
22.7454 -オプションは無視されます。
22.7455 -アスタリスク (*) の
22.7456 -ようなコマンド行ワイルドカードを使用すると、
22.7457 -クラスのグループを指定できます。
22.7458 -.TP 2
22.7459 -\(bu
22.7460 -.B ケース 1 ソースディレクトリへの移動:
22.7461 -.B .java
22.7462 -ファイルのあるディレクトリに移動します。
22.7463 -次に、ドキュメント化する 1 つ以上の
22.7464 -ソースファイルの名前を指定して
22.7465 -.BR javadoc
22.7466 -を実行します。
22.7467 -.LP
22.7468 -.RS
22.7469 -.ft 3
22.7470 -.nf
22.7471 -% cd /home/src/java/awt
22.7472 -% javadoc \-d /home/html Button.java Canvas.java Graphics*.java
22.7473 -.fi
22.7474 -.ft 1
22.7475 -.RE
22.7476 -.LP
22.7477 -.RS 2
22.7478 -この例では、クラス Button と Canvas、
22.7479 -および先頭が Graphics で始まるクラスの
22.7480 -HTML 形式のドキュメントが生成されます。
22.7481 -.BR javadoc
22.7482 -の引数として渡されているのは、
22.7483 -パッケージ名ではなくソースファイルなので、
22.7484 -ドキュメントは、クラスのリストと
22.7485 -メインページの 2 つのフレームを持つことになります。
22.7486 -.RE
22.7487 -.TP 2
22.7488 -\(bu
22.7489 -.B ケース 2 パッケージのルートディレクトリへの移動:
22.7490 -これは、同じルート内にある複数のサブパッケージのソースファイルを個々に
22.7491 -ドキュメント化する場合に便利です。パッケージの
22.7492 -ルートディレクトリに移動し、各ソースファイルを
22.7493 -ルートからのパスで指定します。
22.7494 -.LP
22.7495 -.RS
22.7496 -.ft 3
22.7497 -.nf
22.7498 -% cd /home/src/
22.7499 -% javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java
22.7500 -.fi
22.7501 -.ft 1
22.7502 -.RE
22.7503 -.LP
22.7504 -.RS 2
22.7505 -この例では、Button クラスおよび Applet クラス
22.7506 -用の HTML 形式のドキュメント
22.7507 -が生成されます。
22.7508 -.RE
22.7509 -.TP 2
22.7510 -\(bu
22.7511 -.B ケース 3 すべてのディレクトリから:
22.7512 -このケースでは、現在のディレクトリがどの
22.7513 -ディレクトリでも問題はありません。
22.7514 -ドキュメント化する
22.7515 -.B .java
22.7516 -ファイルへの絶対パスまたは
22.7517 -相対パスを指定して
22.7518 -.BR javadoc
22.7519 -を実行します。
22.7520 -.LP
22.7521 -.RS
22.7522 -.ft 3
22.7523 -.nf
22.7524 -% javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java
22.7525 -.fi
22.7526 -.ft 1
22.7527 -.RE
22.7528 -.LP
22.7529 -.RS 2
22.7530 -この例では、クラス
22.7531 -.B Button
22.7532 -および先頭が
22.7533 -.BR Graphics
22.7534 -で始まるクラスの HTML 形式
22.7535 -のドキュメントが生成されます。
22.7536 -.RE
22.7537 -.SS "パッケージとクラスのドキュメント化"
22.7538 -パッケージ全体と個々のクラスを同時にドキュメント
22.7539 -化できます。次に示すのは、上に示
22.7540 -した 2 つの例を組み合わせた例です。
22.7541 -.B \-sourcepath
22.7542 -は、パッケージへのパスに対しては使用できますが、
22.7543 -個々のクラスのパスに対しては使用
22.7544 -できません。
22.7545 -.LP
22.7546 -.RS
22.7547 -.ft 3
22.7548 -.nf
22.7549 -% javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java
22.7550 -.fi
22.7551 -.ft 1
22.7552 -.RE
22.7553 -.LP
22.7554 -この例では、パッケージ
22.7555 -.B java.awt
22.7556 -とクラス
22.7557 -.B Applet
22.7558 -の HTML 形式のドキュメントが
22.7559 -生成されます。
22.7560 -.B javadoc
22.7561 -は、Applet のパッケージ名を、
22.7562 -.B Applet.java
22.7563 -ソースファイル内のパッケージの宣言 (宣言がある場合) から決定します。
22.7564 -.SS "使用例"
22.7565 -.B javadoc
22.7566 -ツールには、多くの便利なオプションがあり、
22.7567 -その中のいくつかは、ほかのオプションよりもよく
22.7568 -使われます。以下は、makefile 変数を使って Java プラット
22.7569 -フォーム API 上で
22.7570 -.B javadoc
22.7571 -ツールを実行するために使う効果的なコマンドです。
22.7572 -ここでは 180M バイトのメモリを使用して、
22.7573 -Java 2 Platform, Standard Edition, v1.2 に
22.7574 -存在する、約 1500 個の public および protected
22.7575 -クラスについてドキュメントを生成します。
22.7576 -.LP
22.7577 -同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。 オプションの引数に絶対パスを使用しているため、任意のディレクトリからこの
22.7578 -.B javadoc
22.7579 -コマンドを実行できます。
22.7580 -.SS コマンド行の例
22.7581 -次のコマンド行の例は 900 文字を超えているため、
22.7582 -DOS などのシェルには大きすぎます。
22.7583 -この制限を回避するには、コマンド行
22.7584 -引数ファイルを使用します。
22.7585 -または、シェルスクリプトを記述します。
22.7586 -.LP
22.7587 -.nf
22.7588 -\f3
22.7589 -.fl
22.7590 -% javadoc \-sourcepath /java/jdk/src/share/classes \\
22.7591 -.fl
22.7592 - \-overview /java/jdk/src/share/classes/overview.html \\
22.7593 -.fl
22.7594 - \-d /java/jdk/build/api \\
22.7595 -.fl
22.7596 - \-use \\
22.7597 -.fl
22.7598 - \-splitIndex \\
22.7599 -.fl
22.7600 - \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
22.7601 -.fl
22.7602 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification' \\
22.7603 -.fl
22.7604 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
22.7605 -.fl
22.7606 - \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
22.7607 -.fl
22.7608 -a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
22.7609 -.fl
22.7610 -Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
22.7611 -.fl
22.7612 -901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
22.7613 -.fl
22.7614 - \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
22.7615 -.fl
22.7616 - \-group "Extension Packages" "javax.*" \\
22.7617 -.fl
22.7618 - \-J\-Xmx180m \\
22.7619 -.fl
22.7620 - @packages
22.7621 -.fl
22.7622 -\fP
22.7623 -.fi
22.7624 -
22.7625 -.LP
22.7626 -.LP
22.7627 -上記のコマンドで、packages は、
22.7628 -処理対象のパッケージ名 (
22.7629 -.BR java.applett
22.7630 -.BR java.lang など) が
22.7631 -入っているファイルの名前です。 各オプションの、
22.7632 -単一引用符で囲まれた引数の内側には、
22.7633 -改行文字を挿入できません。 たとえば、
22.7634 -この例をコピー&ペーストする場合は、
22.7635 -.B \-bottom
22.7636 -オプションから改行文字を削除してください。
22.7637 -さらに、このあとの「注」も参照してください。
22.7638 -.SS Makefile の例
22.7639 -ここでは、GNU Makefile の例を示します。
22.7640 -Windows の Makefile の例については、
22.7641 -.na
22.7642 -「\f2creating a makefile for Windows\fP」
22.7643 -.fi
22.7644 -(http://java.sun.com/j2se/javadoc/faq/index.html#makefiles) を参照してください。
22.7645 -.LP
22.7646 -.nf
22.7647 -\f3
22.7648 -.fl
22.7649 -javadoc \-\fP\f3sourcepath\fP\f3 $(SRCDIR) \\ /* Sets path for source files */
22.7650 -.fl
22.7651 - \-\fP\f3overview\fP\f3 $(SRCDIR)/overview.html \\ /* Sets file for overview text */
22.7652 -.fl
22.7653 - \-\fP\f3d\fP\f3 /java/jdk/build/api \\ /* Sets destination directory */
22.7654 -.fl
22.7655 - \-\fP\f3use\fP\f3 \\ /* Adds "Use" files */
22.7656 -.fl
22.7657 - \-\fP\f3splitIndex\fP\f3 \\ /* Splits index A\-Z */
22.7658 -.fl
22.7659 - \-\fP\f3windowtitle\fP\f3 $(WINDOWTITLE) \\ /* Adds a window title */
22.7660 -.fl
22.7661 - \-\fP\f3doctitle\fP\f3 $(DOCTITLE) \\ /* Adds a doc title */
22.7662 -.fl
22.7663 - \-\fP\f3header\fP\f3 $(HEADER) \\ /* Adds running header text */
22.7664 -.fl
22.7665 - \-\fP\f3bottom\fP\f3 $(BOTTOM) \\ /* Adds text at bottom */
22.7666 -.fl
22.7667 - \-\fP\f3group\fP\f3 $(GROUPCORE) \\ /* 1st subhead on overview page */
22.7668 -.fl
22.7669 - \-\fP\f3group\fP\f3 $(GROUPEXT) \\ /* 2nd subhead on overview page */
22.7670 -.fl
22.7671 - \-\fP\f3J\fP\f3\-Xmx180m \\ /* Sets memory to 180MB */
22.7672 -.fl
22.7673 - java.lang java.lang.reflect \\ /* Sets packages to document */
22.7674 -.fl
22.7675 - java.util java.io java.net \\
22.7676 -.fl
22.7677 - java.applet
22.7678 -.fl
22.7679 -
22.7680 -.fl
22.7681 -WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
22.7682 -.fl
22.7683 -DOCTITLE = 'Java<sup><font size="\-2">TM</font></sup> 2 Platform v1.2 API Specification'
22.7684 -.fl
22.7685 -HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
22.7686 -.fl
22.7687 -BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
22.7688 -.fl
22.7689 - a bug or feature</a><br><br>Java is a trademark or registered trademark
22.7690 -.fl
22.7691 - of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
22.7692 -.fl
22.7693 - Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
22.7694 -.fl
22.7695 - All Rights Reserved.</font>'
22.7696 -.fl
22.7697 -GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
22.7698 -.fl
22.7699 -GROUPEXT = '"Extension Packages" "javax.*"'
22.7700 -.fl
22.7701 -SRCDIR = '/java/jdk/1.2/src/share/classes'
22.7702 -.fl
22.7703 -\fP
22.7704 -.fi
22.7705 -
22.7706 -.LP
22.7707 -.LP
22.7708 -Makefile の引数は、単一引用符で囲みます。
22.7709 -.SS 注
22.7710 -.TP 2
22.7711 -\(bu
22.7712 -.B \-windowtitle
22.7713 -オプションを省略すると、
22.7714 -.B Javadoc
22.7715 -ツールによってドキュメントタイトルが
22.7716 -ウィンドウタイトルにコピーされます。
22.7717 -.B \-windowtitle
22.7718 -のテキストは、基本的に
22.7719 -.B \-doctitle
22.7720 -と同じです。ただし、HTML タグは使用しません。
22.7721 -HTML タグは、ウィンドウタイトルにそのままの
22.7722 -テキストとして表示されてしまいます。
22.7723 -.TP 2
22.7724 -\(bu
22.7725 -この例のように
22.7726 -.B \-footer
22.7727 -オプションを省略すると、
22.7728 -.B Javadoc
22.7729 -ツールによってヘッダテキストが
22.7730 -フッタにコピーされます。
22.7731 -.TP 2
22.7732 -\(bu
22.7733 -この例では必要ありませんが、
22.7734 -.B \-classpath
22.7735 -および
22.7736 -.BR \-link
22.7737 -も重要なオプションです。
22.7738 -
22.7739 -.LP
22.7740 -.SH トラブルシューティング
22.7741 -.SS 一般的なトラブルシューティング
22.7742 -.TP 2
22.7743 -\(bu
22.7744 -Javadoc FAQ - よく問題となるバグや
22.7745 -トラブルシューティングの
22.7746 -ヒントは
22.7747 -.na
22.7748 -「\f2Javadoc FAQ\fP」
22.7749 -.fi
22.7750 -(http://java.sun.com/j2se/javadoc/faq/index.html#B) にあります。
22.7751 -.TP 2
22.7752 -\(bu
22.7753 -バグおよび制限事項 - また、バグの一部は、
22.7754 -.na
22.7755 -「\f2Important Bug Fixes and Changes\fP」
22.7756 -.fi
22.7757 -(http://java.sun.com/j2se/1.5.0/fixedbugs/index.html) でも参照できます。
22.7758 -.TP 2
22.7759 -\(bu
22.7760 -バージョン番号 - バージョン番号を参照してください。
22.7761 -.TP 2
22.7762 -\(bu
22.7763 -有効なクラスだけをドキュメント化 -
22.7764 -javadoc がパッケージをドキュメント化するとき、
22.7765 -有効なクラス名で構成されているファイルだけを
22.7766 -読み込むようになりました。
22.7767 -ファイル名にハイフン (-) などを含めることで、
22.7768 -javadoc がファイルを解析しないようにできます。
22.7769 -.SS エラーと警告
22.7770 -エラーメッセージおよび警告メッセージには、
22.7771 -ファイル名と宣言行に対する行番号が
22.7772 -含まれますが、doc コメントの特定の
22.7773 -行に対する行番号は含まれません。
22.7774 -.TP 2
22.7775 -\(bu
22.7776 -"error: cannot read: Class1.java" -
22.7777 -.B Javadoc
22.7778 -ツールは現在のディレクトリの
22.7779 -.BR Class1.java
22.7780 -クラスを読み込もうとしています。
22.7781 -クラス名は、絶対パスまたは相対パスで表示されます。
22.7782 -この場合、./Class1.java と同じです。
22.7783 -.LP
22.7784 -.SH "環境"
22.7785 -.TP 20
22.7786 -.SB CLASSPATH
22.7787 -環境変数は、
22.7788 -.B javadoc
22.7789 -がユーザクラスファイルを探すときに使う、パスを指定します。環境変数は、
22.7790 -.B \-classpath
22.7791 -オプションによってオーバーライドされます。ディレクトリは
22.7792 -コロンで分割します。たとえば、
22.7793 -次のとおりです。
22.7794 -.RS 15
22.7795 -.sp 1n
22.7796 -.B .:/home/classes:/usr/local/java/classes
22.7797 -.RE
22.7798 -.br
22.7799 -.ne 11
22.7800 -.SH "関連項目"
22.7801 +
22.7802 +.LP
22.7803 +.RS 3
22.7804 +
22.7805 +.LP
22.7806 +.LP
22.7807 +\f2field\-description\fP (ュ) сc若潟茯緇ゃ鴻腓冴綽荀障綽荀綽茲違茵羝<c茯荐菴違с障罔羣宴翫綵√若吾菴遵障
22.7808 +.LP
22.7809 +.LP
22.7810 +鴻翫違翫純c若鴻菴遵翫筝肢菴遵若吾с潟茘ャ菴遵綽荀障
22.7811 +.LP
22.7812 +.LP
22.7813 +\f2include\fP \f2exclude\fP 綣違翫綵√若吾鴻障宴若吾ゅ腓冴障綣違罨<号障
22.7814 .LP
22.7815 .RS 3
22.7816 .TP 2
22.7817 o
22.7818 -javac
22.7819 +\f2Serializable\fP 絎茖 public 障 protected 鴻絽吾若吾障 鴻障鴻絮宴若吾 \f2@serial exclude\fP ф絎若吾ゅ障
22.7820 .TP 2
22.7821 o
22.7822 -java
22.7823 +\f2Serializable\fP 絎茖 private 障 package private 鴻絽吾若吾ゅ障 鴻障鴻絮宴若吾 \f2@serial include\fP ф絎若吾障
22.7824 +.RE
22.7825 +
22.7826 +.LP
22.7827 +.LP
22.7828 +箴: \f2javax.swing\fP 宴若吾\f2@serial exclude\fP ф絎障 (\f2package.html\fP 障 \f2package\-info.java\fP )public \f2java.security.BasicPermission\fP \f2@serial exclude\fP ф絎障package private \f2java.util.PropertyPermissionCollection\fP \f2@serial include\fP ф絎障
22.7829 +.LP
22.7830 +.LP
22.7831 +鴻ф絎 @serial 帥違宴若吾ф絎 @serial 帥違若若ゃ障
22.7832 +.LP
22.7833 +.LP
22.7834 +帥違篏睡羈ゃ荅括完篏睡箴Java 吾с翫篁罕膃 1.6 膀
22.7835 +.na
22.7836 +\f2鴻翫純c若潟若帥後\fP @
22.7837 +.fi
22.7838 +http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlс障
22.7839 +.na
22.7840 +\f2翫 FAQ\fP @
22.7841 +.fi
22.7842 +http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingс FAQ \-private 鴻ゃ絎 javadoc 絎茵 private c若 @serial 帥違荀ゃ javadoc 茘茵腓冴筝莖吾膈荐莠障翫綵√鋌罕鴻翫
22.7843 +.na
22.7844 +\f2Sun 篁罕\fP @
22.7845 +.fi
22.7846 +http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlс
22.7847 +.LP
22.7848 +.LP
22.7849 +
22.7850 +.LP
22.7851 +.RE
22.7852 +.RS 3
22.7853 +.TP 3
22.7854 +@serialField\ field\-name\ field\-type\ field\-description
22.7855 +\f2Serializable\fP 鴻 \f2serialPersistentFields\fP <潟若 \f2ObjectStreamField\fP 潟潟若潟ャ<潟障 \f2ObjectStreamField\fP 潟潟若潟絲障 \f2@serialField\fP 帥違 1 や戎綽荀障
22.7856 +.RE
22.7857 +
22.7858 +.LP
22.7859 +.RS 3
22.7860 +
22.7861 +.LP
22.7862 +.LP
22.7863 +
22.7864 +.LP
22.7865 +.RE
22.7866 +.RS 3
22.7867 +.TP 3
22.7868 +@serialData\ data\-description
22.7869 +\f2data\-description\fP 翫綵√с若帥綺茯鴻с若帥鴻\f2writeObject\fP <純c吾莨若障ュ純若帥 \f2Externalizable.writeExternal\fP <純c吾莨若障鴻若 (阪鴻) 障障
22.7870 +.RE
22.7871 +
22.7872 +.LP
22.7873 +.RS 3
22.7874 +
22.7875 +.LP
22.7876 +.LP
22.7877 +\f2@serialData\fP 帥違\f2writeObject\fP\f2readObject\fP\f2writeExternal\fP\f2readExternal\fP\f2writeReplace\fP \f2readResolve\fP <純ャ<潟若激с潟潟<潟т戎с障
22.7878 +.LP
22.7879 +.LP
22.7880 +
22.7881 +.LP
22.7882 +.RE
22.7883 +.RS 3
22.7884 +.TP 3
22.7885 +@since\ since\-text
22.7886 +ャ<潟 [絨ャ若吾с] 荀冴菴遵絎 \f2since\-text\fP 吾莨若帥障鴻劫ャ罕障帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с帥違劫紊眼障罘純\f2since\-text\fP 腓冴純с≪若剛札絖潟障箴腓冴障
22.7887 +.RE
22.7888 +
22.7889 +.LP
22.7890 +.RS 3
22.7891 +
22.7892 +.LP
22.7893 +.nf
22.7894 +\f3
22.7895 +.fl
22.7896 + @since 1.5
22.7897 +.fl
22.7898 +
22.7899 +.fl
22.7900 +\fP
22.7901 +.fi
22.7902 +
22.7903 +.LP
22.7904 +.LP
22.7905 +Java 若純若鴻潟若翫帥違Java 若 API 篁罕若吾с潟腓冴障 紊眼罘純<潟劫茖菴遵腓冴障茲違 @since 帥違篏睡с茲違 @author 帥違宴障違荀膣茲違 API т戎翫茲違帥違篏睡с障
22.7906 +.LP
22.7907 +.LP
22.7908 +
22.7909 +.LP
22.7910 +.RE
22.7911 +.RS 3
22.7912 +.TP 3
22.7913 +@throws\ class\-name\ description\
22.7914 +\f2@throws\fP 帥違 \f2@exception\fP 帥違臂сャ<潟 [箴紊] 絨頳冴菴遵\f2class\-name\fP \f2description\fP 鴻吾莨若帥障\f2class\-name\fP <純鴻若醇с箴紊с帥違<純潟潟鴻帥 doc 潟<潟с炊鴻с鴻絎絎ц菴違翫Javadoc 若罎膣∫綺緇c鴻「障障違箴紊 doc 潟<潟с茲違 \f2@throws\fP 帥違篏睡с障
22.7915 +.RE
22.7916 +
22.7917 +.LP
22.7918 +.RS 3
22.7919 +
22.7920 +.LP
22.7921 +.LP
22.7922 +鴻с羝推紊ャ<潟\f2@throws\fP 帥違 throws 膀箴紊絖翫@throws 帥違ャ<潟сJavadoc 若c箴紊 HTML 阪茯ц菴遵障
22.7923 +.LP
22.7924 +.LP
22.7925 +若若ゃ<純т紊腓榊絎h翫帥\f2@throws\fP ャ<潟若激с潟<純泣鴻潟若障ゃ潟帥с若鴻<純絎茖<純潟若翫罕с@throws ャ<潟若激с潟膓帥{@inheritDoc} 篏睡с障
22.7926 +.LP
22.7927 +.LP
22.7928 +荅括完ゃ
22.7929 +.na
22.7930 +\f2@throws 帥違ャ<潟\fP @
22.7931 +.fi
22.7932 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionс
22.7933 +.LP
22.7934 +.LP
22.7935 +
22.7936 +.LP
22.7937 +.RE
22.7938 +.RS 3
22.7939 +.TP 3
22.7940 +{@value\ package.class#field}
22.7941 +\f2{@value}\fP c若 doc 潟<潟 綣違т戎翫絎違ゃ茵腓冴障
22.7942 +.RE
22.7943 +
22.7944 +.LP
22.7945 +.RS 3
22.7946 +
22.7947 +.LP
22.7948 +.nf
22.7949 +\f3
22.7950 +.fl
22.7951 + /**
22.7952 +.fl
22.7953 + * The value of this constant is {@value}.
22.7954 +.fl
22.7955 + */
22.7956 +.fl
22.7957 + public static final String SCRIPT_START = "<script>"
22.7958 +.fl
22.7959 +
22.7960 +.fl
22.7961 +\fP
22.7962 +.fi
22.7963 +
22.7964 +.LP
22.7965 +.LP
22.7966 +篁紙 doc 潟<潟у \f2package.class#field\fP т戎翫絎絎違ゃ茵腓冴障
22.7967 +.LP
22.7968 +.nf
22.7969 +\f3
22.7970 +.fl
22.7971 + /**
22.7972 +.fl
22.7973 + * Evaluates the script starting with {@value #SCRIPT_START}.
22.7974 +.fl
22.7975 + */
22.7976 +.fl
22.7977 + public String evalScript(String script) {
22.7978 +.fl
22.7979 + }
22.7980 +.fl
22.7981 +
22.7982 +.fl
22.7983 +\fP
22.7984 +.fi
22.7985 +
22.7986 +.LP
22.7987 +.LP
22.7988 +綣 \f2package.class#field\fP @see 綣違筝綵√障<潟若c若違鴻違障
22.7989 +.LP
22.7990 +.LP
22.7991 +絎違сゃ
22.7992 +.na
22.7993 +\f2絎違c若\fP @
22.7994 +.fi
22.7995 +http://java.sun.com/javase/6/docs/api/constant\-values.html若吾茵腓冴障
22.7996 +.LP
22.7997 +.LP
22.7998 +
22.7999 +.LP
22.8000 +.RE
22.8001 +.RS 3
22.8002 +.TP 3
22.8003 +@version\ version\-text
22.8004 +\-version 激с潟篏帥翫ャ<潟 [若吾с] 絨頳冴菴遵絎 \f2version\-text\fP 吾莨若帥障帥違潟若障純с≪憜若吾с括垩篆潟障 絲障@since 潟若絨ャ若吾с括垩篆障\f2version\-text\fP 劫ャ罕障若吾с潟帥違篏睡с贋茯帥鴻帥違篏睡с贋с
22.8005 +.RE
22.8006 +
22.8007 +.LP
22.8008 +.RS 3
22.8009 +
22.8010 +.LP
22.8011 +.LP
22.8012 +1 ゃャ<潟若激с潟潟<潟茲違 \f2@version\fP 帥違с障綽荀綽\f2@version\fP 帥違 1 ゃ若吾с括垩絎帥違茲違若吾с括垩絎с障翫Javadoc 若c潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹fャ<潟障障潟若障c潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
22.8013 +.LP
22.8014 +.LP
22.8015 +荅括完ゃ
22.8016 +.na
22.8017 +\f2@version 帥違ャ<潟\fP @
22.8018 +.fi
22.8019 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionс
22.8020 +.LP
22.8021 +.RE
22.8022 +.LP
22.8023 +.SS
22.8024 +帥違篏睡с贋
22.8025 +.LP
22.8026 +с帥違篏睡с贋ゃ茯障\f2@see\fP\f2@since\fP\f2@deprecated\fP\f2{@link}\fP\f2{@linkplain}\fP \f2{@docroot}\fP 帥違鴻 doc 潟<潟т戎с障
22.8027 +.RS 3
22.8028 +
22.8029 +.LP
22.8030 +.SS
22.8031 +网荀ャ<潟若激с潟帥
22.8032 +.LP
22.8033 +.LP
22.8034 +网荀帥違网荀若吾ャ<潟若激с潟潟<潟т戎с帥違с ャ<潟若激с潟潟<潟絽 \f2overview.html\fP 純若鴻<ゃ障祉ャ<潟若激с潟潟<潟翫罕帥違筝肢т戎綽荀障
22.8035 +.LP
22.8036 +.LP
22.8037 +\f3羈\fP \- 若吾с 1.2 с网荀ャ<潟 \f2{@link}\fP 帥違違障鴻罩c頫腓冴障潟荐絎障憜\f2{@docRoot}\fP 帥違网荀ャ<潟с篏障
22.8038 +.LP
22.8039 +.RS 3
22.8040 +
22.8041 +.LP
22.8042 +.LP
22.8043 +.TS
22.8044 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8045 +.de 35
22.8046 +.ps \n(.s
22.8047 +.vs \n(.vu
22.8048 +.in \n(.iu
22.8049 +.if \n(.u .fi
22.8050 +.if \n(.j .ad
22.8051 +.if \n(.j=0 .na
22.8052 +..
22.8053 +.nf
22.8054 +.nr #~ 0
22.8055 +.if n .nr #~ 0.6n
22.8056 +.ds #d .d
22.8057 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8058 +.fc
22.8059 +.nr 33 \n(.s
22.8060 +.rm 80
22.8061 +.nr 34 \n(.lu
22.8062 +.eo
22.8063 +.am 80
22.8064 +.br
22.8065 +.di a+
22.8066 +.35
22.8067 +.ft \n(.f
22.8068 +.ll \n(34u*1u/2u
22.8069 +.if \n(.l<\n(80 .ll \n(80u
22.8070 +.in 0
22.8071 +\f2@see\fP
22.8072 +.br
22.8073 +\f2@since\fP
22.8074 +.br
22.8075 +\f2@author\fP
22.8076 +.br
22.8077 +\f2@version\fP
22.8078 +.br
22.8079 +\f2{@link}\fP
22.8080 +.br
22.8081 +\f2{@linkplain}\fP
22.8082 +.br
22.8083 +\f2{@docRoot}\fP
22.8084 +.br
22.8085 +.di
22.8086 +.nr a| \n(dn
22.8087 +.nr a- \n(dl
22.8088 +..
22.8089 +.ec \
22.8090 +.35
22.8091 +.nf
22.8092 +.ll \n(34u
22.8093 +.nr 80 0
22.8094 +.nr 38 \w\f3网荀帥\fP
22.8095 +.if \n(80<\n(38 .nr 80 \n(38
22.8096 +.80
22.8097 +.rm 80
22.8098 +.nr 38 \n(a-
22.8099 +.if \n(80<\n(38 .nr 80 \n(38
22.8100 +.35
22.8101 +.nf
22.8102 +.ll \n(34u
22.8103 +.nr 38 1n
22.8104 +.nr 79 0
22.8105 +.nr 40 \n(79+(0*\n(38)
22.8106 +.nr 80 +\n(40
22.8107 +.nr TW \n(80
22.8108 +.if t .if \n(TW>\n(.li .tm Table at line 2280 file Input is too wide - \n(TW units
22.8109 +.fc
22.8110 +.nr #T 0-1
22.8111 +.nr #a 0-1
22.8112 +.eo
22.8113 +.de T#
22.8114 +.ds #d .d
22.8115 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8116 +.mk ##
22.8117 +.nr ## -1v
22.8118 +.ls 1
22.8119 +.ls
22.8120 +..
22.8121 +.ec
22.8122 +.ta \n(80u
22.8123 +.nr 31 \n(.f
22.8124 +.nr 35 1m
22.8125 +\&\h'|\n(40u'\f3网荀帥\fP
22.8126 +.ne \n(a|u+\n(.Vu
22.8127 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.8128 +.ta \n(80u
22.8129 +.nr 31 \n(.f
22.8130 +.nr 35 1m
22.8131 +\&\h'|\n(40u'
22.8132 +.mk ##
22.8133 +.nr 31 \n(##
22.8134 +.sp |\n(##u-1v
22.8135 +.nr 37 \n(40u
22.8136 +.in +\n(37u
22.8137 +.a+
22.8138 +.in -\n(37u
22.8139 +.mk 32
22.8140 +.if \n(32>\n(31 .nr 31 \n(32
22.8141 +.sp |\n(31u
22.8142 +.fc
22.8143 +.nr T. 1
22.8144 +.T# 1
22.8145 +.35
22.8146 +.rm a+
22.8147 +.TE
22.8148 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
22.8149 +
22.8150 +.LP
22.8151 +.RE
22.8152 +.SS
22.8153 +宴若吾ャ<潟若激с潟帥
22.8154 +.LP
22.8155 +.LP
22.8156 +宴若吾帥違宴若吾ャ<潟若激с潟潟<潟т戎с帥違с ャ<潟若激с潟潟<潟\f2package.html\fP 障 \f2package\-info.java\fP 純若鴻<ゃ障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
22.8157 +.LP
22.8158 +.RS 3
22.8159 +
22.8160 +.LP
22.8161 +.LP
22.8162 +.TS
22.8163 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8164 +.de 35
22.8165 +.ps \n(.s
22.8166 +.vs \n(.vu
22.8167 +.in \n(.iu
22.8168 +.if \n(.u .fi
22.8169 +.if \n(.j .ad
22.8170 +.if \n(.j=0 .na
22.8171 +..
22.8172 +.nf
22.8173 +.nr #~ 0
22.8174 +.if n .nr #~ 0.6n
22.8175 +.ds #d .d
22.8176 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8177 +.fc
22.8178 +.nr 33 \n(.s
22.8179 +.rm 80
22.8180 +.nr 34 \n(.lu
22.8181 +.eo
22.8182 +.am 80
22.8183 +.br
22.8184 +.di a+
22.8185 +.35
22.8186 +.ft \n(.f
22.8187 +.ll \n(34u*1u/2u
22.8188 +.if \n(.l<\n(80 .ll \n(80u
22.8189 +.in 0
22.8190 +\f2@see\fP
22.8191 +.br
22.8192 +\f2@since\fP
22.8193 +.br
22.8194 +\f2@serial\fP
22.8195 +.br
22.8196 +\f2@author\fP
22.8197 +.br
22.8198 +\f2@version\fP
22.8199 +.br
22.8200 +\f2{@link}\fP
22.8201 +.br
22.8202 +\f2{@linkplain}\fP
22.8203 +.br
22.8204 +\f2{@docRoot}\fP
22.8205 +.br
22.8206 +.di
22.8207 +.nr a| \n(dn
22.8208 +.nr a- \n(dl
22.8209 +..
22.8210 +.ec \
22.8211 +.35
22.8212 +.nf
22.8213 +.ll \n(34u
22.8214 +.nr 80 0
22.8215 +.nr 38 \w\f3宴若吾帥\fP
22.8216 +.if \n(80<\n(38 .nr 80 \n(38
22.8217 +.80
22.8218 +.rm 80
22.8219 +.nr 38 \n(a-
22.8220 +.if \n(80<\n(38 .nr 80 \n(38
22.8221 +.35
22.8222 +.nf
22.8223 +.ll \n(34u
22.8224 +.nr 38 1n
22.8225 +.nr 79 0
22.8226 +.nr 40 \n(79+(0*\n(38)
22.8227 +.nr 80 +\n(40
22.8228 +.nr TW \n(80
22.8229 +.if t .if \n(TW>\n(.li .tm Table at line 2316 file Input is too wide - \n(TW units
22.8230 +.fc
22.8231 +.nr #T 0-1
22.8232 +.nr #a 0-1
22.8233 +.eo
22.8234 +.de T#
22.8235 +.ds #d .d
22.8236 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8237 +.mk ##
22.8238 +.nr ## -1v
22.8239 +.ls 1
22.8240 +.ls
22.8241 +..
22.8242 +.ec
22.8243 +.ta \n(80u
22.8244 +.nr 31 \n(.f
22.8245 +.nr 35 1m
22.8246 +\&\h'|\n(40u'\f3宴若吾帥\fP
22.8247 +.ne \n(a|u+\n(.Vu
22.8248 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.8249 +.ta \n(80u
22.8250 +.nr 31 \n(.f
22.8251 +.nr 35 1m
22.8252 +\&\h'|\n(40u'
22.8253 +.mk ##
22.8254 +.nr 31 \n(##
22.8255 +.sp |\n(##u-1v
22.8256 +.nr 37 \n(40u
22.8257 +.in +\n(37u
22.8258 +.a+
22.8259 +.in -\n(37u
22.8260 +.mk 32
22.8261 +.if \n(32>\n(31 .nr 31 \n(32
22.8262 +.sp |\n(31u
22.8263 +.fc
22.8264 +.nr T. 1
22.8265 +.T# 1
22.8266 +.35
22.8267 +.rm a+
22.8268 +.TE
22.8269 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
22.8270 +
22.8271 +.LP
22.8272 +.RE
22.8273 +.SS
22.8274 +鴻潟ゃ潟帥с若鴻ャ<潟若激с潟帥
22.8275 +.LP
22.8276 +.LP
22.8277 +罨<鴻障ゃ潟帥с若鴻ャ<潟若激с潟潟<潟т戎с帥違腓冴障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
22.8278 +.LP
22.8279 +.RS 3
22.8280 +
22.8281 +.LP
22.8282 +.LP
22.8283 +.TS
22.8284 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8285 +.de 35
22.8286 +.ps \n(.s
22.8287 +.vs \n(.vu
22.8288 +.in \n(.iu
22.8289 +.if \n(.u .fi
22.8290 +.if \n(.j .ad
22.8291 +.if \n(.j=0 .na
22.8292 +..
22.8293 +.nf
22.8294 +.nr #~ 0
22.8295 +.if n .nr #~ 0.6n
22.8296 +.ds #d .d
22.8297 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8298 +.fc
22.8299 +.nr 33 \n(.s
22.8300 +.rm 80
22.8301 +.nr 34 \n(.lu
22.8302 +.eo
22.8303 +.am 80
22.8304 +.br
22.8305 +.di a+
22.8306 +.35
22.8307 +.ft \n(.f
22.8308 +.ll \n(34u*1u/2u
22.8309 +.if \n(.l<\n(80 .ll \n(80u
22.8310 +.in 0
22.8311 +\f3鴻潟ゃ潟帥с若鴻帥\fP
22.8312 +.br
22.8313 +.di
22.8314 +.nr a| \n(dn
22.8315 +.nr a- \n(dl
22.8316 +..
22.8317 +.ec \
22.8318 +.eo
22.8319 +.am 80
22.8320 +.br
22.8321 +.di b+
22.8322 +.35
22.8323 +.ft \n(.f
22.8324 +.ll \n(34u*1u/2u
22.8325 +.if \n(.l<\n(80 .ll \n(80u
22.8326 +.in 0
22.8327 +\f2@see\fP
22.8328 +.br
22.8329 +\f2@since\fP
22.8330 +.br
22.8331 +\f2@deprecated\fP
22.8332 +.br
22.8333 +\f2@serial\fP
22.8334 +.br
22.8335 +\f2@author\fP
22.8336 +.br
22.8337 +\f2@version\fP
22.8338 +.br
22.8339 +\f2{@link}\fP
22.8340 +.br
22.8341 +\f2{@linkplain}\fP
22.8342 +.br
22.8343 +\f2{@docRoot}\fP
22.8344 +.br
22.8345 +.di
22.8346 +.nr b| \n(dn
22.8347 +.nr b- \n(dl
22.8348 +..
22.8349 +.ec \
22.8350 +.35
22.8351 +.nf
22.8352 +.ll \n(34u
22.8353 +.nr 80 0
22.8354 +.80
22.8355 +.rm 80
22.8356 +.nr 38 \n(a-
22.8357 +.if \n(80<\n(38 .nr 80 \n(38
22.8358 +.nr 38 \n(b-
22.8359 +.if \n(80<\n(38 .nr 80 \n(38
22.8360 +.35
22.8361 +.nf
22.8362 +.ll \n(34u
22.8363 +.nr 38 1n
22.8364 +.nr 79 0
22.8365 +.nr 40 \n(79+(0*\n(38)
22.8366 +.nr 80 +\n(40
22.8367 +.nr TW \n(80
22.8368 +.if t .if \n(TW>\n(.li .tm Table at line 2356 file Input is too wide - \n(TW units
22.8369 +.fc
22.8370 +.nr #T 0-1
22.8371 +.nr #a 0-1
22.8372 +.eo
22.8373 +.de T#
22.8374 +.ds #d .d
22.8375 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8376 +.mk ##
22.8377 +.nr ## -1v
22.8378 +.ls 1
22.8379 +.ls
22.8380 +..
22.8381 +.ec
22.8382 +.ne \n(a|u+\n(.Vu
22.8383 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.8384 +.ta \n(80u
22.8385 +.nr 31 \n(.f
22.8386 +.nr 35 1m
22.8387 +\&\h'|\n(40u'
22.8388 +.mk ##
22.8389 +.nr 31 \n(##
22.8390 +.sp |\n(##u-1v
22.8391 +.nr 37 \n(40u
22.8392 +.in +\n(37u
22.8393 +.a+
22.8394 +.in -\n(37u
22.8395 +.mk 32
22.8396 +.if \n(32>\n(31 .nr 31 \n(32
22.8397 +.sp |\n(31u
22.8398 +.ne \n(b|u+\n(.Vu
22.8399 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.8400 +.ta \n(80u
22.8401 +.nr 31 \n(.f
22.8402 +.nr 35 1m
22.8403 +\&\h'|\n(40u'
22.8404 +.mk ##
22.8405 +.nr 31 \n(##
22.8406 +.sp |\n(##u-1v
22.8407 +.nr 37 \n(40u
22.8408 +.in +\n(37u
22.8409 +.b+
22.8410 +.in -\n(37u
22.8411 +.mk 32
22.8412 +.if \n(32>\n(31 .nr 31 \n(32
22.8413 +.sp |\n(31u
22.8414 +.fc
22.8415 +.nr T. 1
22.8416 +.T# 1
22.8417 +.35
22.8418 +.rm a+
22.8419 +.rm b+
22.8420 +.TE
22.8421 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
22.8422 +
22.8423 +.LP
22.8424 +.RE
22.8425 +\f3罨<鴻潟<潟箴腓冴障\fP
22.8426 +.LP
22.8427 +.nf
22.8428 +\f3
22.8429 +.fl
22.8430 +/**
22.8431 +.fl
22.8432 + * A class representing a window on the screen.
22.8433 +.fl
22.8434 + * For example:
22.8435 +.fl
22.8436 + * <pre>
22.8437 +.fl
22.8438 + * Window win = new Window(parent);
22.8439 +.fl
22.8440 + * win.show();
22.8441 +.fl
22.8442 + * </pre>
22.8443 +.fl
22.8444 + *
22.8445 +.fl
22.8446 + * @author Sami Shaio
22.8447 +.fl
22.8448 + * @version 1.13, 06/08/06
22.8449 +.fl
22.8450 + * @see java.awt.BaseWindow
22.8451 +.fl
22.8452 + * @see java.awt.Button
22.8453 +.fl
22.8454 + */
22.8455 +.fl
22.8456 +class Window extends BaseWindow {
22.8457 +.fl
22.8458 + ...
22.8459 +.fl
22.8460 +}
22.8461 +.fl
22.8462 +
22.8463 +.fl
22.8464 +\fP
22.8465 +.fi
22.8466 +
22.8467 +.LP
22.8468 +.SS
22.8469 +c若ャ<潟若激с潟帥
22.8470 +.LP
22.8471 +.LP
22.8472 +罨<c若ャ<潟若激с潟潟<潟т戎с帥違腓冴障
22.8473 +.LP
22.8474 +.RS 3
22.8475 +
22.8476 +.LP
22.8477 +.LP
22.8478 +.TS
22.8479 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8480 +.de 35
22.8481 +.ps \n(.s
22.8482 +.vs \n(.vu
22.8483 +.in \n(.iu
22.8484 +.if \n(.u .fi
22.8485 +.if \n(.j .ad
22.8486 +.if \n(.j=0 .na
22.8487 +..
22.8488 +.nf
22.8489 +.nr #~ 0
22.8490 +.if n .nr #~ 0.6n
22.8491 +.ds #d .d
22.8492 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8493 +.fc
22.8494 +.nr 33 \n(.s
22.8495 +.rm 80
22.8496 +.nr 34 \n(.lu
22.8497 +.eo
22.8498 +.am 80
22.8499 +.br
22.8500 +.di a+
22.8501 +.35
22.8502 +.ft \n(.f
22.8503 +.ll \n(34u*1u/2u
22.8504 +.if \n(.l<\n(80 .ll \n(80u
22.8505 +.in 0
22.8506 +\f2@see\fP
22.8507 +.br
22.8508 +\f2@since\fP
22.8509 +.br
22.8510 +\f2@deprecated\fP
22.8511 +.br
22.8512 +\f2@serial\fP
22.8513 +.br
22.8514 +\f2@serialField\fP
22.8515 +.br
22.8516 +\f2{@link}\fP
22.8517 +.br
22.8518 +\f2{@linkplain}\fP
22.8519 +.br
22.8520 +\f2{@docRoot}\fP
22.8521 +.br
22.8522 +\f2{@value}\fP
22.8523 +.br
22.8524 +.di
22.8525 +.nr a| \n(dn
22.8526 +.nr a- \n(dl
22.8527 +..
22.8528 +.ec \
22.8529 +.35
22.8530 +.nf
22.8531 +.ll \n(34u
22.8532 +.nr 80 0
22.8533 +.nr 38 \w\f3c若帥\fP
22.8534 +.if \n(80<\n(38 .nr 80 \n(38
22.8535 +.80
22.8536 +.rm 80
22.8537 +.nr 38 \n(a-
22.8538 +.if \n(80<\n(38 .nr 80 \n(38
22.8539 +.35
22.8540 +.nf
22.8541 +.ll \n(34u
22.8542 +.nr 38 1n
22.8543 +.nr 79 0
22.8544 +.nr 40 \n(79+(0*\n(38)
22.8545 +.nr 80 +\n(40
22.8546 +.nr TW \n(80
22.8547 +.if t .if \n(TW>\n(.li .tm Table at line 2437 file Input is too wide - \n(TW units
22.8548 +.fc
22.8549 +.nr #T 0-1
22.8550 +.nr #a 0-1
22.8551 +.eo
22.8552 +.de T#
22.8553 +.ds #d .d
22.8554 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8555 +.mk ##
22.8556 +.nr ## -1v
22.8557 +.ls 1
22.8558 +.ls
22.8559 +..
22.8560 +.ec
22.8561 +.ta \n(80u
22.8562 +.nr 31 \n(.f
22.8563 +.nr 35 1m
22.8564 +\&\h'|\n(40u'\f3c若帥\fP
22.8565 +.ne \n(a|u+\n(.Vu
22.8566 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.8567 +.ta \n(80u
22.8568 +.nr 31 \n(.f
22.8569 +.nr 35 1m
22.8570 +\&\h'|\n(40u'
22.8571 +.mk ##
22.8572 +.nr 31 \n(##
22.8573 +.sp |\n(##u-1v
22.8574 +.nr 37 \n(40u
22.8575 +.in +\n(37u
22.8576 +.a+
22.8577 +.in -\n(37u
22.8578 +.mk 32
22.8579 +.if \n(32>\n(31 .nr 31 \n(32
22.8580 +.sp |\n(31u
22.8581 +.fc
22.8582 +.nr T. 1
22.8583 +.T# 1
22.8584 +.35
22.8585 +.rm a+
22.8586 +.TE
22.8587 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
22.8588 +
22.8589 +.LP
22.8590 +.RE
22.8591 +\f3罨<c若潟<潟箴腓冴障\fP
22.8592 +.LP
22.8593 +.nf
22.8594 +\f3
22.8595 +.fl
22.8596 + /**
22.8597 +.fl
22.8598 + * The X\-coordinate of the component.
22.8599 +.fl
22.8600 + *
22.8601 +.fl
22.8602 + * @see #getLocation()
22.8603 +.fl
22.8604 + */
22.8605 +.fl
22.8606 + int x = 1263732;
22.8607 +.fl
22.8608 +
22.8609 +.fl
22.8610 +\fP
22.8611 +.fi
22.8612 +
22.8613 +.LP
22.8614 +.SS
22.8615 +潟潟鴻帥潟<純ャ<潟若激с潟帥
22.8616 +.LP
22.8617 +.LP
22.8618 +罨<潟潟鴻帥障<純ャ<潟若激с潟潟<潟ц;腓冴с帥違腓冴障 \f2@return\fP 潟潟鴻帥с茵腓冴с\f2{@inheritDoc}\fP 茵腓冴狗障\f2@serialData\fP 帥違劫翫<純 doc 潟<潟с推戎с障
22.8619 +.LP
22.8620 +.RS 3
22.8621 +
22.8622 +.LP
22.8623 +.LP
22.8624 +.TS
22.8625 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8626 +.de 35
22.8627 +.ps \n(.s
22.8628 +.vs \n(.vu
22.8629 +.in \n(.iu
22.8630 +.if \n(.u .fi
22.8631 +.if \n(.j .ad
22.8632 +.if \n(.j=0 .na
22.8633 +..
22.8634 +.nf
22.8635 +.nr #~ 0
22.8636 +.if n .nr #~ 0.6n
22.8637 +.ds #d .d
22.8638 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8639 +.fc
22.8640 +.nr 33 \n(.s
22.8641 +.rm 80
22.8642 +.nr 34 \n(.lu
22.8643 +.eo
22.8644 +.am 80
22.8645 +.br
22.8646 +.di a+
22.8647 +.35
22.8648 +.ft \n(.f
22.8649 +.ll \n(34u*1u/2u
22.8650 +.if \n(.l<\n(80 .ll \n(80u
22.8651 +.in 0
22.8652 +\f3<純潟潟潟鴻帥帥\fP
22.8653 +.br
22.8654 +.di
22.8655 +.nr a| \n(dn
22.8656 +.nr a- \n(dl
22.8657 +..
22.8658 +.ec \
22.8659 +.eo
22.8660 +.am 80
22.8661 +.br
22.8662 +.di b+
22.8663 +.35
22.8664 +.ft \n(.f
22.8665 +.ll \n(34u*1u/2u
22.8666 +.if \n(.l<\n(80 .ll \n(80u
22.8667 +.in 0
22.8668 +\f2@see\fP
22.8669 +.br
22.8670 +\f2@since\fP
22.8671 +.br
22.8672 +\f2@deprecated\fP
22.8673 +.br
22.8674 +\f2@param\fP
22.8675 +.br
22.8676 +\f2@return\fP
22.8677 +.br
22.8678 +\f2@throws\fP \f2@exception\fP
22.8679 +.br
22.8680 +\f2@serialData\fP
22.8681 +.br
22.8682 +\f2{@link}\fP
22.8683 +.br
22.8684 +\f2{@linkplain}\fP
22.8685 +.br
22.8686 +\f2{@inheritDoc}\fP
22.8687 +.br
22.8688 +\f2{@docRoot}\fP
22.8689 +.br
22.8690 +.di
22.8691 +.nr b| \n(dn
22.8692 +.nr b- \n(dl
22.8693 +..
22.8694 +.ec \
22.8695 +.35
22.8696 +.nf
22.8697 +.ll \n(34u
22.8698 +.nr 80 0
22.8699 +.80
22.8700 +.rm 80
22.8701 +.nr 38 \n(a-
22.8702 +.if \n(80<\n(38 .nr 80 \n(38
22.8703 +.nr 38 \n(b-
22.8704 +.if \n(80<\n(38 .nr 80 \n(38
22.8705 +.35
22.8706 +.nf
22.8707 +.ll \n(34u
22.8708 +.nr 38 1n
22.8709 +.nr 79 0
22.8710 +.nr 40 \n(79+(0*\n(38)
22.8711 +.nr 80 +\n(40
22.8712 +.nr TW \n(80
22.8713 +.if t .if \n(TW>\n(.li .tm Table at line 2504 file Input is too wide - \n(TW units
22.8714 +.fc
22.8715 +.nr #T 0-1
22.8716 +.nr #a 0-1
22.8717 +.eo
22.8718 +.de T#
22.8719 +.ds #d .d
22.8720 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8721 +.mk ##
22.8722 +.nr ## -1v
22.8723 +.ls 1
22.8724 +.ls
22.8725 +..
22.8726 +.ec
22.8727 +.ne \n(a|u+\n(.Vu
22.8728 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.8729 +.ta \n(80u
22.8730 +.nr 31 \n(.f
22.8731 +.nr 35 1m
22.8732 +\&\h'|\n(40u'
22.8733 +.mk ##
22.8734 +.nr 31 \n(##
22.8735 +.sp |\n(##u-1v
22.8736 +.nr 37 \n(40u
22.8737 +.in +\n(37u
22.8738 +.a+
22.8739 +.in -\n(37u
22.8740 +.mk 32
22.8741 +.if \n(32>\n(31 .nr 31 \n(32
22.8742 +.sp |\n(31u
22.8743 +.ne \n(b|u+\n(.Vu
22.8744 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.8745 +.ta \n(80u
22.8746 +.nr 31 \n(.f
22.8747 +.nr 35 1m
22.8748 +\&\h'|\n(40u'
22.8749 +.mk ##
22.8750 +.nr 31 \n(##
22.8751 +.sp |\n(##u-1v
22.8752 +.nr 37 \n(40u
22.8753 +.in +\n(37u
22.8754 +.b+
22.8755 +.in -\n(37u
22.8756 +.mk 32
22.8757 +.if \n(32>\n(31 .nr 31 \n(32
22.8758 +.sp |\n(31u
22.8759 +.fc
22.8760 +.nr T. 1
22.8761 +.T# 1
22.8762 +.35
22.8763 +.rm a+
22.8764 +.rm b+
22.8765 +.TE
22.8766 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-30
22.8767 +
22.8768 +.LP
22.8769 +.RE
22.8770 +\f3罨<<純ャ<潟若激с潟潟<潟箴腓冴障\fP
22.8771 +.LP
22.8772 +.nf
22.8773 +\f3
22.8774 +.fl
22.8775 + /**
22.8776 +.fl
22.8777 + * Returns the character at the specified index. An index
22.8778 +.fl
22.8779 + * ranges from <code>0</code> to <code>length() \- 1</code>.
22.8780 +.fl
22.8781 + *
22.8782 +.fl
22.8783 + * @param index the index of the desired character.
22.8784 +.fl
22.8785 + * @return the desired character.
22.8786 +.fl
22.8787 + * @exception StringIndexOutOfRangeException
22.8788 +.fl
22.8789 + * if the index is not in the range <code>0</code>
22.8790 +.fl
22.8791 + * to <code>length()\-1</code>.
22.8792 +.fl
22.8793 + * @see java.lang.Character#charValue()
22.8794 +.fl
22.8795 + */
22.8796 +.fl
22.8797 + public char charAt(int index) {
22.8798 +.fl
22.8799 + ...
22.8800 +.fl
22.8801 + }
22.8802 +.fl
22.8803 +
22.8804 +.fl
22.8805 +\fP
22.8806 +.fi
22.8807 +.RE
22.8808 +.SH "激с"
22.8809 +.LP
22.8810 +.LP
22.8811 +javadoc 若篏帥c阪羆阪障Javadoc 若\-doclet 激с潟с鴻帥絎翫篁ュ罔羣篏帥障Javadoc 若篁紙篏睡с潟潟茵激с潟障 激с潟ゃJavadoc 激с潟ц障罔羣с祉ゃ菴遵潟潟茵激с潟箴障 激с潟ゃ罔羣箴激с潟ц障激с喝紊ф絖絨絖阪ャ障 激с潟綣違с紊ф絖絨絖阪ャ障
22.8812 +.LP
22.8813 +.LP
22.8814 +激с潟罨<腓冴障
22.8815 +.LP
22.8816 +.RS 3
22.8817 +
22.8818 +.LP
22.8819 +.LP
22.8820 +.TS
22.8821 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.8822 +.de 35
22.8823 +.ps \n(.s
22.8824 +.vs \n(.vu
22.8825 +.in \n(.iu
22.8826 +.if \n(.u .fi
22.8827 +.if \n(.j .ad
22.8828 +.if \n(.j=0 .na
22.8829 +..
22.8830 +.nf
22.8831 +.nr #~ 0
22.8832 +.if n .nr #~ 0.6n
22.8833 +.ds #d .d
22.8834 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.8835 +.fc
22.8836 +.nr 33 \n(.s
22.8837 +.rm 80 81 82
22.8838 +.nr 34 \n(.lu
22.8839 +.eo
22.8840 +.am 80
22.8841 +.br
22.8842 +.di a+
22.8843 +.35
22.8844 +.ft \n(.f
22.8845 +.ll \n(34u*1u/4u
22.8846 +.if \n(.l<\n(80 .ll \n(80u
22.8847 +.in 0
22.8848 +\-\f21.1\fP
22.8849 +.br
22.8850 +\-author
22.8851 +.br
22.8852 +\-\f2bootclasspath\fP
22.8853 +.br
22.8854 +\-bottom
22.8855 +.br
22.8856 +\-\f2breakiterator\fP
22.8857 +.br
22.8858 +\-charset
22.8859 +.br
22.8860 +\-\f2classpath\fP
22.8861 +.br
22.8862 +\-d
22.8863 +.br
22.8864 +\-docencoding
22.8865 +.br
22.8866 +\-docfilessubdirs
22.8867 +.br
22.8868 +\-\f2doclet\fP
22.8869 +.br
22.8870 +\-\f2docletpath\fP
22.8871 +.br
22.8872 +\-doctitle
22.8873 +.br
22.8874 +\-\f2encoding\fP
22.8875 +.br
22.8876 +\-\f2exclude\fP
22.8877 +.br
22.8878 +\-excludedocfilessubdir
22.8879 +.br
22.8880 +\-\f2extdirs\fP
22.8881 +.br
22.8882 +\-footer
22.8883 +.br
22.8884 +\-group
22.8885 +.br
22.8886 +.br
22.8887 +.di
22.8888 +.nr a| \n(dn
22.8889 +.nr a- \n(dl
22.8890 +..
22.8891 +.ec \
22.8892 +.eo
22.8893 +.am 81
22.8894 +.br
22.8895 +.di b+
22.8896 +.35
22.8897 +.ft \n(.f
22.8898 +.ll \n(34u*1u/4u
22.8899 +.if \n(.l<\n(81 .ll \n(81u
22.8900 +.in 0
22.8901 +\-header
22.8902 +.br
22.8903 +\-\f2help\fP
22.8904 +.br
22.8905 +\-helpfile
22.8906 +.br
22.8907 +\-\f2J\fP
22.8908 +.br
22.8909 +\-keywords
22.8910 +.br
22.8911 +\-link
22.8912 +.br
22.8913 +\-linkoffline
22.8914 +.br
22.8915 +\-linksource
22.8916 +.br
22.8917 +\-\f2locale\fP
22.8918 +.br
22.8919 +\-nocomment
22.8920 +.br
22.8921 +\-nodeprecated
22.8922 +.br
22.8923 +\-nodeprecatedlist
22.8924 +.br
22.8925 +\-nohelp
22.8926 +.br
22.8927 +\-noindex
22.8928 +.br
22.8929 +\-nonavbar
22.8930 +.br
22.8931 +\-noqualifier
22.8932 +.br
22.8933 +\-nosince
22.8934 +.br
22.8935 +\-notimestamp
22.8936 +.br
22.8937 +\-notree
22.8938 +.br
22.8939 +\-\f2overview\fP
22.8940 +.br
22.8941 +\-\f2package\fP
22.8942 +.br
22.8943 +.br
22.8944 +.di
22.8945 +.nr b| \n(dn
22.8946 +.nr b- \n(dl
22.8947 +..
22.8948 +.ec \
22.8949 +.eo
22.8950 +.am 82
22.8951 +.br
22.8952 +.di c+
22.8953 +.35
22.8954 +.ft \n(.f
22.8955 +.ll \n(34u*1u/4u
22.8956 +.if \n(.l<\n(82 .ll \n(82u
22.8957 +.in 0
22.8958 +\-\f2private\fP
22.8959 +.br
22.8960 +\-\f2protected\fP
22.8961 +.br
22.8962 +\-\f2public\fP
22.8963 +.br
22.8964 +\-\f2quiet\fP
22.8965 +.br
22.8966 +\-serialwarn
22.8967 +.br
22.8968 +\-\f2source\fP
22.8969 +.br
22.8970 +\-\f2sourcepath\fP
22.8971 +.br
22.8972 +\-splitindex
22.8973 +.br
22.8974 +\-stylesheetfile
22.8975 +.br
22.8976 +\-\f2subpackages\fP
22.8977 +.br
22.8978 +\-tag
22.8979 +.br
22.8980 +\-taglet
22.8981 +.br
22.8982 +\-tagletpath
22.8983 +.br
22.8984 +\-title
22.8985 +.br
22.8986 +\-use
22.8987 +.br
22.8988 +\-\f2verbose\fP
22.8989 +.br
22.8990 +\-version
22.8991 +.br
22.8992 +\-windowtitle
22.8993 +.br
22.8994 +.br
22.8995 +.di
22.8996 +.nr c| \n(dn
22.8997 +.nr c- \n(dl
22.8998 +..
22.8999 +.ec \
22.9000 +.35
22.9001 +.nf
22.9002 +.ll \n(34u
22.9003 +.nr 80 0
22.9004 +.80
22.9005 +.rm 80
22.9006 +.nr 38 \n(a-
22.9007 +.if \n(80<\n(38 .nr 80 \n(38
22.9008 +.nr 81 0
22.9009 +.81
22.9010 +.rm 81
22.9011 +.nr 38 \n(b-
22.9012 +.if \n(81<\n(38 .nr 81 \n(38
22.9013 +.nr 82 0
22.9014 +.82
22.9015 +.rm 82
22.9016 +.nr 38 \n(c-
22.9017 +.if \n(82<\n(38 .nr 82 \n(38
22.9018 +.35
22.9019 +.nf
22.9020 +.ll \n(34u
22.9021 +.nr 38 1n
22.9022 +.nr 79 0
22.9023 +.nr 40 \n(79+(0*\n(38)
22.9024 +.nr 80 +\n(40
22.9025 +.nr 41 \n(80+(3*\n(38)
22.9026 +.nr 81 +\n(41
22.9027 +.nr 42 \n(81+(3*\n(38)
22.9028 +.nr 82 +\n(42
22.9029 +.nr TW \n(82
22.9030 +.if t .if \n(TW>\n(.li .tm Table at line 2681 file Input is too wide - \n(TW units
22.9031 +.fc
22.9032 +.nr #T 0-1
22.9033 +.nr #a 0-1
22.9034 +.eo
22.9035 +.de T#
22.9036 +.ds #d .d
22.9037 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.9038 +.mk ##
22.9039 +.nr ## -1v
22.9040 +.ls 1
22.9041 +.ls
22.9042 +..
22.9043 +.ec
22.9044 +.ne \n(a|u+\n(.Vu
22.9045 +.ne \n(b|u+\n(.Vu
22.9046 +.ne \n(c|u+\n(.Vu
22.9047 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.9048 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.9049 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
22.9050 +.ta \n(80u \n(81u \n(82u
22.9051 +.nr 31 \n(.f
22.9052 +.nr 35 1m
22.9053 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
22.9054 +.mk ##
22.9055 +.nr 31 \n(##
22.9056 +.sp |\n(##u-1v
22.9057 +.nr 37 \n(40u
22.9058 +.in +\n(37u
22.9059 +.a+
22.9060 +.in -\n(37u
22.9061 +.mk 32
22.9062 +.if \n(32>\n(31 .nr 31 \n(32
22.9063 +.sp |\n(##u-1v
22.9064 +.nr 37 \n(41u
22.9065 +.in +\n(37u
22.9066 +.b+
22.9067 +.in -\n(37u
22.9068 +.mk 32
22.9069 +.if \n(32>\n(31 .nr 31 \n(32
22.9070 +.sp |\n(##u-1v
22.9071 +.nr 37 \n(42u
22.9072 +.in +\n(37u
22.9073 +.c+
22.9074 +.in -\n(37u
22.9075 +.mk 32
22.9076 +.if \n(32>\n(31 .nr 31 \n(32
22.9077 +.sp |\n(31u
22.9078 +.fc
22.9079 +.nr T. 1
22.9080 +.T# 1
22.9081 +.35
22.9082 +.rm a+
22.9083 +.rm b+
22.9084 +.rm c+
22.9085 +.TE
22.9086 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
22.9087 +
22.9088 +.LP
22.9089 +.RE
22.9090 +.LP
22.9091 +\f2ゃ帥\fPхず激с潟Javadoc 堺激с潟сJavadoc 若潟潟c箴鴻т戎с障罔羣篏ゃ帥с激с潟箴障
22.9092 +.LP
22.9093 +.SS
22.9094 +Javadoc 激с
22.9095 +.LP
22.9096 +.RS 3
22.9097 +.TP 3
22.9098 +\-overview \ path/filename
22.9099 +Javadoc 絲障\f2path/filename\fP ф絎純若鴻<ゃ网荀ャ<潟鴻緇鴻网荀若 (\f2overview\-summary.html\fP) 臀絎障\f2path/filename\fP \f2\-sourcepath\fP 吾後障鴻с
22.9100 +.LP
22.9101 +\f2filename\fP \f2path\fP 篁紙贋絎с障絽吾\f2overview.html\fP 篁純若鴻弱筝篏宴若吾cc臀障贋臀\f2\-sourcepath\fP c<ゃ腓冴с宴若吾ャ<潟 \f2path\fP 筝荀障違\f2java.lang\fP 宴若吾純若鴻若 \f2/src/classes/java/lang/\fP 翫网荀<ゃ \f2/src/classes/overview.html\fP 臀с障篏睡箴с
22.9102 +.LP
22.9103 +\f2path/filename\fP ф絎<ゃゃ网荀潟<潟<ゃс
22.9104 +.LP
22.9105 +网荀若吾篏Javadoc 茲違宴若後羝<翫с荅括完HTML 若с
22.9106 +.LP
22.9107 +网荀若吾帥ゃ\f2\-doctitle\fP c荐絎障
22.9108 +.LP
22.9109 +.TP 3
22.9110 +\-public
22.9111 +public 鴻潟<潟若茵腓冴障
22.9112 +.LP
22.9113 +.TP 3
22.9114 +\-protected
22.9115 +protected public 鴻<潟若茵腓冴障荐絎с
22.9116 +.LP
22.9117 +.TP 3
22.9118 +\-package
22.9119 +packageprotected public 鴻<潟若茵腓冴障
22.9120 +.LP
22.9121 +.TP 3
22.9122 +\-private
22.9123 +鴻鴻<潟若茵腓冴障
22.9124 +.LP
22.9125 +.TP 3
22.9126 +\-help
22.9127 +潟ゃ潟茵腓冴障 Javadoc 潟潟茵激с潟筝荀ц;腓冴障
22.9128 +.LP
22.9129 +.TP 3
22.9130 +\-doclet\ class
22.9131 +ャ<潟篏帥莎桁鴻<ゃ絎障絎絎絎阪絎鴻綵√絎臂障\f4\-doclet\fP 激с潟篏帥翫Javadoc 罔羣篏帥c HTML 綵√障鴻\f2start(Root)\fP <純障違障莎桁鴻吾鴻\f2\-docletpath\fP 激с潟c絎臂障
22.9132 +.LP
22.9133 +違MIF 若喝冴罨<絎障
22.9134 +.nf
22.9135 +\f3
22.9136 +.fl
22.9137 + \-doclet com.sun.tools.doclets.mif.MIFDoclet
22.9138 +.fl
22.9139 +\fP
22.9140 +.fi
22.9141 +.LP
22.9142 +劫絎茵絎箴ゃ
22.9143 +.na
22.9144 +\f2MIF Doclet ャ<潟\fP @
22.9145 +.fi
22.9146 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
22.9147 +.LP
22.9148 +.TP 3
22.9149 +\-docletpath\ classpathlist
22.9150 +\f2\-doclet\fP 激с潟ф絎紮鴻<ゃ潟箴絖鴻 jar <ゃ吾鴻絎障紮鴻<ゃ jar <ゃ翫篁ヤ箴 jar <ゃ鴻絎障腟九障鴻障憜c後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR <ゃс障 翫鴻障 JAR <ゃSolaris 翫潟 (:)Windows 翫祉潟 (;) у阪障紮鴻с罎膣≪劫翫激с潟筝荀с
22.9151 +.LP
22.9152 +jar <ゃ吾鴻箴紮鴻<ゃ障障jar <ゃ障鴻羈
22.9153 +.nf
22.9154 +\f3
22.9155 +.fl
22.9156 + \-docletpath /home/user/mifdoclet/lib/mifdoclet.jar
22.9157 +.fl
22.9158 +\fP
22.9159 +.fi
22.9160 +紮鴻<ゃ鴻箴鴻<ゃャ鴻羈
22.9161 +.nf
22.9162 +\f3
22.9163 +.fl
22.9164 + \-docletpath /home/user/mifdoclet/classes/com/sun/tools/doclets/mif/
22.9165 +.fl
22.9166 +\fP
22.9167 +.fi
22.9168 +劫絎茵絎箴ゃ
22.9169 +.na
22.9170 +\f2MIF Doclet ャ<潟\fP @
22.9171 +.fi
22.9172 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
22.9173 +.LP
22.9174 +.TP 3
22.9175 +\-1.1
22.9176 +\f2罘純Javadoc 1.4 сゃ障篁f炊純障激с潟Javadoc 1.1 c紊荀罘純ゃャ<潟篏с ャ絖鴻泣若障激с潟綽荀翫Javadoc 1.2 障 1.3 篏睡\fP
22.9177 +.LP
22.9178 +.TP 3
22.9179 +\-source release
22.9180 +篁純若鴻潟若若吾с潟絎障\f2release\fP 罨<ゃ絎с障
22.9181 +.LP
22.9182 +.TS
22.9183 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
22.9184 +.de 35
22.9185 +.ps \n(.s
22.9186 +.vs \n(.vu
22.9187 +.in \n(.iu
22.9188 +.if \n(.u .fi
22.9189 +.if \n(.j .ad
22.9190 +.if \n(.j=0 .na
22.9191 +..
22.9192 +.nf
22.9193 +.nr #~ 0
22.9194 +.if n .nr #~ 0.6n
22.9195 +.ds #d .d
22.9196 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.9197 +.fc
22.9198 +.nr 33 \n(.s
22.9199 +.rm 80 81
22.9200 +.nr 34 \n(.lu
22.9201 +.eo
22.9202 +.am 81
22.9203 +.br
22.9204 +.di a+
22.9205 +.35
22.9206 +.ft \n(.f
22.9207 +.ll \n(34u*1u/3u
22.9208 +.if \n(.l<\n(81 .ll \n(81u
22.9209 +.in 0
22.9210 +Javadoc JDK 1.5 уャ膩霡違割荐茯罘純潟若篁障\f3\-source\fP 違絎潟潟ゃ 1.5 篏障
22.9211 +.br
22.9212 +.di
22.9213 +.nr a| \n(dn
22.9214 +.nr a- \n(dl
22.9215 +..
22.9216 +.ec \
22.9217 +.eo
22.9218 +.am 81
22.9219 +.br
22.9220 +.di b+
22.9221 +.35
22.9222 +.ft \n(.f
22.9223 +.ll \n(34u*1u/3u
22.9224 +.if \n(.l<\n(81 .ll \n(81u
22.9225 +.in 0
22.9226 +Javadoc JDK 1.4 уャ≪泣若激с潟潟若篁障
22.9227 +.br
22.9228 +.di
22.9229 +.nr b| \n(dn
22.9230 +.nr b- \n(dl
22.9231 +..
22.9232 +.ec \
22.9233 +.eo
22.9234 +.am 81
22.9235 +.br
22.9236 +.di c+
22.9237 +.35
22.9238 +.ft \n(.f
22.9239 +.ll \n(34u*1u/3u
22.9240 +.if \n(.l<\n(81 .ll \n(81u
22.9241 +.in 0
22.9242 +Javadoc JDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
22.9243 +.br
22.9244 +.di
22.9245 +.nr c| \n(dn
22.9246 +.nr c- \n(dl
22.9247 +..
22.9248 +.ec \
22.9249 +.35
22.9250 +.nf
22.9251 +.ll \n(34u
22.9252 +.nr 80 0
22.9253 +.nr 31 0
22.9254 +.nr 32 0
22.9255 +.nr 38 \w\f31
22.9256 +.if \n(31<\n(38 .nr 31 \n(38
22.9257 +.nr 38 \w.5\fP
22.9258 +.if \n(32<\n(38 .nr 32 \n(38
22.9259 +.nr 38 \w\f31
22.9260 +.if \n(31<\n(38 .nr 31 \n(38
22.9261 +.nr 38 \w.4\fP
22.9262 +.if \n(32<\n(38 .nr 32 \n(38
22.9263 +.nr 38 \w\f31
22.9264 +.if \n(31<\n(38 .nr 31 \n(38
22.9265 +.nr 38 \w.3\fP
22.9266 +.if \n(32<\n(38 .nr 32 \n(38
22.9267 +.80
22.9268 +.rm 80
22.9269 +.nr 60 \n(31
22.9270 +.nr 38 \n(60+\n(32
22.9271 +.if \n(38>\n(80 .nr 80 \n(38
22.9272 +.if \n(38<\n(80 .nr 60 +(\n(80-\n(38)/2
22.9273 +.nr 81 0
22.9274 +.81
22.9275 +.rm 81
22.9276 +.nr 38 \n(a-
22.9277 +.if \n(81<\n(38 .nr 81 \n(38
22.9278 +.nr 38 \n(b-
22.9279 +.if \n(81<\n(38 .nr 81 \n(38
22.9280 +.nr 38 \n(c-
22.9281 +.if \n(81<\n(38 .nr 81 \n(38
22.9282 +.35
22.9283 +.nf
22.9284 +.ll \n(34u
22.9285 +.nr 38 1n
22.9286 +.nr 79 0
22.9287 +.nr 40 \n(79+(0*\n(38)
22.9288 +.nr 80 +\n(40
22.9289 +.nr 60 +\n(40
22.9290 +.nr 41 \n(80+(3*\n(38)
22.9291 +.nr 81 +\n(41
22.9292 +.nr TW \n(81
22.9293 +.if t .if \n(TW>\n(.li .tm Table at line 2791 file Input is too wide - \n(TW units
22.9294 +.fc
22.9295 +.nr #T 0-1
22.9296 +.nr #a 0-1
22.9297 +.eo
22.9298 +.de T#
22.9299 +.ds #d .d
22.9300 +.if \(ts\n(.z\(ts\(ts .ds #d nl
22.9301 +.mk ##
22.9302 +.nr ## -1v
22.9303 +.ls 1
22.9304 +.ls
22.9305 +..
22.9306 +.ec
22.9307 +.ne \n(a|u+\n(.Vu
22.9308 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
22.9309 +.ta \n(60u \n(80u \n(81u
22.9310 +.nr 31 \n(.f
22.9311 +.nr 35 1m
22.9312 +\&\h'|\n(40u'\f31.5\fP\h'|\n(41u'
22.9313 +.mk ##
22.9314 +.nr 31 \n(##
22.9315 +.sp |\n(##u-1v
22.9316 +.nr 37 \n(41u
22.9317 +.in +\n(37u
22.9318 +.a+
22.9319 +.in -\n(37u
22.9320 +.mk 32
22.9321 +.if \n(32>\n(31 .nr 31 \n(32
22.9322 +.sp |\n(31u
22.9323 +.ne \n(b|u+\n(.Vu
22.9324 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
22.9325 +.ta \n(60u \n(80u \n(81u
22.9326 +.nr 31 \n(.f
22.9327 +.nr 35 1m
22.9328 +\&\h'|\n(40u'\f31.4\fP\h'|\n(41u'
22.9329 +.mk ##
22.9330 +.nr 31 \n(##
22.9331 +.sp |\n(##u-1v
22.9332 +.nr 37 \n(41u
22.9333 +.in +\n(37u
22.9334 +.b+
22.9335 +.in -\n(37u
22.9336 +.mk 32
22.9337 +.if \n(32>\n(31 .nr 31 \n(32
22.9338 +.sp |\n(31u
22.9339 +.ne \n(c|u+\n(.Vu
22.9340 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
22.9341 +.ta \n(60u \n(80u \n(81u
22.9342 +.nr 31 \n(.f
22.9343 +.nr 35 1m
22.9344 +\&\h'|\n(40u'\f31.3\fP\h'|\n(41u'
22.9345 +.mk ##
22.9346 +.nr 31 \n(##
22.9347 +.sp |\n(##u-1v
22.9348 +.nr 37 \n(41u
22.9349 +.in +\n(37u
22.9350 +.c+
22.9351 +.in -\n(37u
22.9352 +.mk 32
22.9353 +.if \n(32>\n(31 .nr 31 \n(32
22.9354 +.sp |\n(31u
22.9355 +.fc
22.9356 +.nr T. 1
22.9357 +.T# 1
22.9358 +.35
22.9359 +.rm a+
22.9360 +.rm b+
22.9361 +.rm c+
22.9362 +.TE
22.9363 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
22.9364 +.LP
22.9365 +javac с潟若潟潟ゃ篏睡ゃ絲上 \f2release\fP ゃ篏睡障
22.9366 +.LP
22.9367 +.TP 3
22.9368 +\-sourcepath\ sourcepathlist
22.9369 +\f2javadoc\fP 潟潟宴若後障 \f2\-subpackages\fP 羝<純若鴻<ゃ (\f2.java\fP) 罎膣≪鴻絎障\f2sourcepathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎剛札筝鴻泣c罎膣≪障激с潟篏帥cャ<潟純若鴻<ゃ篏臀с篏ャ<潟ャ<潟純若鴻<ゃ膓帥潟<潟ゃ純若鴻<ゃ篏臀腆肴с障
22.9370 +.LP
22.9371 +\f2\-sourcepath\fP 激с潟javadoc 潟潟宴若後羝<篏睡с障 \f2javadoc\fP 潟潟羝< \f2.java\fP <ゃ鴻罎膣≪障\f2.java\fP <ゃ罎膣≪<ゃc cd c腱糸障<ゃ鴻障 (1 や札筝鴻ャ<潟)\f2\-sourcepath\fP ャ翫Javadoc 鴻鴻篏帥c純若鴻<ゃ罎膣≪障 (\-classpath )c \-sourcepath 鴻鴻ゃс\-classpath ャ宴若後 Javadoc 羝<Javadoc 憜c潟泣c純若鴻<ゃ罎膣≪障
22.9372 +.LP
22.9373 +\f2sourcepathlist\fP ャ<潟宴若後純若鴻若若c荐絎障違\f2com.mypackage\fP 宴若吾ャ<潟翫純若鴻<ゃ罨<贋障
22.9374 +.nf
22.9375 +\f3
22.9376 +.fl
22.9377 + /home/user/src/com/mypackage/*.java
22.9378 +.fl
22.9379 +\fP
22.9380 +.fi
22.9381 +翫罨< \f2sourcepath\fP \f2/home/user/src\fPゃ障 \f2com/mypackage\fP c絎宴若後 \f2com.mypackage\fP 絎障
22.9382 +.nf
22.9383 +\f3
22.9384 +.fl
22.9385 + % \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP
22.9386 +.fl
22.9387 +.fi
22.9388 +号純若鴻鴻ゃ宴若後g (荐) \\紊宴若吾 (C:\\user\\src\\com\\mypackage) 茹c膂≦с\f2/home/user/src/com/mypackage\fP.
22.9389 +.LP
22.9390 +2 ゃ純若鴻鴻荐絎罨<障
22.9391 +.nf
22.9392 +\f3
22.9393 +.fl
22.9394 + % \fP\f3javadoc \-sourcepath /home/user1/src:/home/user2/src com.mypackage\fP
22.9395 +.fl
22.9396 +.fi
22.9397 +.LP
22.9398 +.TP 3
22.9399 +\-classpath\ classpathlist
22.9400 +Javadoc с (\f2.class\fP <ゃ) 罎膣≪鴻絎障 с鴻ャ<潟鴻鴻cс鴻鴻с\f2classpathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣c罎膣≪障\f2classpathlist\fP 絎
22.9401 +.na
22.9402 +\f2鴻\fP @
22.9403 +.fi
22.9404 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalャ<潟腓冴緇c
22.9405 +.LP
22.9406 +\f2\-sourcepath\fP ャ翫Javadoc 若\f2\-classpath\fP 篏帥c鴻<ゃс純若鴻<ゃ罎膣≪障 (筝篏篋с)c純若鴻<ゃ鴻<ゃャ鴻罎膣≪綽荀翫\f2\-sourcepath\fP \f2\-classpath\fP 筝≧鴻篏帥障
22.9407 +.LP
22.9408 +違\f2com.mypackage\fP ャ<潟翫純若鴻<ゃc \f2/home/user/src/com/mypackage\fP 宴若吾 \f2/home/user/lib\fP ゃ篏帥с違罨<絎障
22.9409 +.nf
22.9410 +\f3
22.9411 +.fl
22.9412 + % \fP\f3javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage\fP
22.9413 +.fl
22.9414 +.fi
22.9415 +祉若罕\f2\-classpath\fP 絎翫CLASSPATH 医紊違荐絎違Javadoc 若医紊違篏帥障<荐絎翫Javadoc 若憜c鴻罎膣≪障
22.9416 +.LP
22.9417 +Javadoc 若≦宍罘純鴻潟若鴻鴻∫cJavadoc 若 \f2\-classpath\fP 篏睡若吟若鴻罎膣≪号ゃ荅括完
22.9418 +.na
22.9419 +\f2鴻罎膣∽号\fP @
22.9420 +.fi
22.9421 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html荀с
22.9422 +.LP
22.9423 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
22.9424 +.br
22.9425 +.br
22.9426 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
22.9427 +.LP
22.9428 +.TP 3
22.9429 +\-subpackages\ \ package1:package2:...
22.9430 +純若鴻<ゃ絎宴若吾潟泣宴若後絽亥ャ<潟障激с潟純若鴻潟若違泣宴若吾菴遵箴水с違泣宴若吾腟粋昭障障 \f2package\fP 綣違篁紙筝篏泣宴若 (\f2java\fP ) 障絎絎宴若 (\f2javax.swing\fP ) 障純若鴻<ゃ綽荀障綣違潟潟у阪障 (鴻若c潟違激鴻)ゃ若筝荀с (篏睡筝)宴若吾罎膣√贋絎\f2\-sourcepath\fP 篏睡障激с潟純若鴻<ゃц純若鴻若宴若吾絮純若鴻<ゃу醜腴<障
22.9431 +.LP
22.9432 +箴腓冴障
22.9433 +.nf
22.9434 +\f3
22.9435 +.fl
22.9436 + % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
22.9437 +.fl
22.9438 +.fi
22.9439 +潟潟java潟javax.swing宴若吾泣宴若後ャ<潟障
22.9440 +.LP
22.9441 +\f2\-exclude\fP \f2\-subpackages\fP 篏睡劫宴若吾ゅс障
22.9442 +.LP
22.9443 +.TP 3
22.9444 +\-exclude\ \ packagename1:packagename2:...
22.9445 +絎宴若吾泣宴若吾 \f2\-subpackages\fP c篏鴻≧>散ゅ障サ \f2\-subpackages\fP 激с潟絎c腟粋昭障宴若吾障絨ョ粋昭障宴若吾ゅ絲乗院障箴腓冴障
22.9446 +.nf
22.9447 +\f3
22.9448 +.fl
22.9449 + % \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
22.9450 +.fl
22.9451 +.fi
22.9452 +<\f2java.io\fP\f2java.util\fP\f2java.math\fP 腟粋昭障障\f2java.net\fP \f2java.lang\fP 篁ヤ宴若吾ゅ障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
22.9453 +.LP
22.9454 +.TP 3
22.9455 +\-bootclasspath\ classpathlist
22.9456 +若鴻絖鴻絎障若鴻絽吾Java 若潟≪鴻с若鴻鴻Javadoc 若純若鴻<ゃ鴻<ゃ「篏帥罎膣≪鴻筝с荅括完
22.9457 +.na
22.9458 +\f2javac javadoc 鴻罎膣≪号\fP @
22.9459 +.fi
22.9460 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesс\f2classpathlist\fP 茲違c潟 (:) у阪障
22.9461 +.LP
22.9462 +.TP 3
22.9463 +\-extdirs\ dirlist
22.9464 +≦宍罘純鴻絖c絎障≦宍罘純鴻Java ≦宍罘醇罕篏帥鴻鴻сextdirs Javadoc 若純若鴻<ゃ鴻<ゃ「篏帥罎膣≪鴻筝с荅括完菴違 \f2\-classpath\fP с\f2dirlist\fP 茲違c潟 (:) у阪障
22.9465 +.LP
22.9466 +.TP 3
22.9467 +\-verbose
22.9468 +javadoc 絎茵筝荅括完<祉若吾茵腓冴障verbose 激с潟絎純若鴻<ゃ若ャ<潟 (純若鴻<ゃ 1 ゃ<祉若)潟純若<祉若吾茵腓冴障verbose 激с潟絎 Java 純若鴻<ゃ茹f荀 (腱篏) 菴遵<祉若吾茵腓冴障
22.9469 +.LP
22.9470 +.TP 3
22.9471 +\-quiet
22.9472 +若<祉若吾障茘<祉若娯札紊<祉若吾吟茘若茵腓冴劫障若吾с恰絖吟障
22.9473 +.LP
22.9474 +.TP 3
22.9475 +\-breakiterator\
22.9476 +沿荐茯宴若堺≪眼冴с
22.9477 +.na
22.9478 +\f2java.text.BreakIterator\fP @
22.9479 +.fi
22.9480 +http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html 初紜篏睡掩腟ゆ障 (篁鴻宴若с \f2BreakIterator\fP 篏睡)\f2\fP宴若吾鴻障<潟若筝肢сс宴若吾鴻障<潟若荀膣潟若≪<ゃ潟鴻潟若障
22.9481 +.LP
22.9482 +JDK 1.2 篁ラBreakIterator 鴻沿ゃ鴻荐茯腟ゆс篏睡障c1.2 篁ラс\f2\-breakiterator\fP 激с潟掩篁ュ号障掩罨<≪眼冴障
22.9483 +.RS 3
22.9484 .TP 2
22.9485 o
22.9486 -jdb
22.9487 +掩阪≪眼冴 \- 腥榊純障 HTML 帥 (\f2<P>\fP ) 膓у罩≪
22.9488 .TP 2
22.9489 o
22.9490 -javah
22.9491 +breakiterator 阪≪眼冴 \- 筝罨<茯紊ф絖у障翫腥榊醇絖膓霳障膃у罩≪≪眼冴с祉ヨ;荐 (The serial no. is validMr. Smith)HTML 帥違医障荐垩у障с罩≪HTML 帥違莨若障翫с../filename緇у罩≪
22.9492 +.RE
22.9493 +.RS 3
22.9494 +
22.9495 +.LP
22.9496 +.LP
22.9497 +羈: 1.5.0 1.4.x 荐 breakiterator 茘<祉若吾ゃ阪≪眼冴紊眼障ゃ障\\\-breakiterator 激с潟1.5.0 сс障ゃ障罨<<吾c若若鴻(1.5.0) с紊眼篁ュc障ゃ障純若鴻潟若紊眼1.4.x с breakiterator 茘ゅサ翫с1.5.0 篏綽荀茘羔羯障 祉宴breakiterator <綽荀篋с純若鴻紊眼鴻莢紊сcс篁吟х罕篏羞隙恒荅潟障
22.9498 +.LP
22.9499 +.RE
22.9500 +.TP 3
22.9501 +\-locale\ language_country_variant
22.9502 +.RS 3
22.9503 +.LP
22.9504 +\f3荀\fP \- \f2\-locale\fP 激с潟罔羣箴鴻激с潟障篁篁紙箴鴻激с潟 (綏) 絎綽荀障蚊若激с潟若沿ц;腓冴障潟潟茵激с潟絎綺箴絖障
22.9505 +.LP
22.9506 +.RE
22.9507 +.LP
22.9508 +Javadoc ャ<潟篏帥宴若絎障綣違java.util.Locale ャ<潟ц宴若絎障違\f2en_US\fP (沿膠喝)\f2en_US_WIN\fP (Windows т戎沿) 絎障
22.9509 +.LP
22.9510 +宴若絎絎宴若純若鴻<ゃ Javadoc c御<祉若 (蚊若激с潟若鴻茵荀冴<ゃ罨<stylesheet.css 潟<潟絖) 篏帥障障≪<純若鴻純若恰絨障ゅャ阪絖絎宴若c羆冴障障激с潟ャ<潟鴻純若鴻<ゃф絎ャ<潟若激с潟潟<潟鴻宴若羆阪с障
22.9511 +.LP
22.9512 +.TP 3
22.9513 +\-encoding\ name
22.9514 +純若鴻<ゃ潟潟若c潟違 (\f2EUCJIS/SJIS\fP ) 絎障激с潟絎翫若潟潟若帥篏帥障
22.9515 +.LP
22.9516 +\-docencoding \-charset с
22.9517 +.LP
22.9518 +.TP 3
22.9519 +\-Jflag
22.9520 +javadoc 絎茵絎茵激鴻 java \f2flag\fP 贋・羝<障\f2J\fP \f2flag\fP 腥榊純ャ障違ャ<潟激鴻 32M ゃ<≪若腆坂鏆荀翫Java \f2\-Xmx\fP 激с潟罨<若喝冴障 \f2\-Xms\fP ュ純с <≪若泣ゃ冴荐絎激с潟с綽荀<≪若絨泣ゃ冴c翫箴水с
22.9521 +.nf
22.9522 +\f3
22.9523 +.fl
22.9524 + % \fP\f3javadoc \-J\-Xmx32m \-J\-Xms32m\fP \f3com.mypackage\fP
22.9525 +.fl
22.9526 +.fi
22.9527 +篏睡 javadoc 若吾с潟腆肴罨< java \f2\-version\fP激с潟若喝冴障
22.9528 +.nf
22.9529 +\f3
22.9530 +.fl
22.9531 + % \fP\f3javadoc \-J\-version\fP
22.9532 +.fl
22.9533 + java version "1.2"
22.9534 +.fl
22.9535 + Classic VM (build JDK\-1.2\-V, green threads, sunwjit)
22.9536 +.fl
22.9537 +.fi
22.9538 +阪鴻若罔羣若吾с括垩障障
22.9539 +.RE
22.9540 +.SS
22.9541 +罔羣箴激с
22.9542 +.LP
22.9543 +.RS 3
22.9544 +.TP 3
22.9545 +\-d\ directory
22.9546 + HTML <ゃ篆絖c絎障(d (destination))激с潟ャ<ゃ憜c篆絖障 \f2directory\fP 腟九障c障憜篏罐c後障c絎с障若吾с 1.4 сjavadoc 絎茵c篏障
22.9547 +.LP
22.9548 +違罨<箴с\f2com.mypackage\fP 宴若吾ャ<潟腟 \f2/home/user/doc/\fP c篆絖障
22.9549 +.nf
22.9550 +\f3
22.9551 +.fl
22.9552 + % \fP\f3javadoc \-d /home/user/doc com.mypackage\fP
22.9553 +.fl
22.9554 +.fi
22.9555 +.LP
22.9556 +.TP 3
22.9557 +\-use
22.9558 +ャ<潟鴻潟宴若吾 1 ゃ [篏睡] 若吾腟粋昭帥障若吾劫鴻障宴若吾 API 篏帥c宴若吾鴻<純潟潟鴻帥潟c若荐菴違障違 C 箴 C 篏帥cC 泣鴻C 絎hc若C 菴<純潟 C <若帥ゃ<純潟潟鴻帥障
22.9559 +.LP
22.9560 +違String [篏睡] 若吾篏茵腓冴荀帥障\f2java.awt.Font\fP 鴻 \f2getName()\fP <純\f2String\fP 菴障c\f2getName()\fP \f2String\fP 篏帥cс\f2String\fP [篏睡] 若吾<純障
22.9561 +.LP
22.9562 +ャ<潟 API 篏睡сc絎茖ャ<潟障<純絎茖筝 \f2String\fP 篏帥c綣違絖c絖菴翫\f2String\fP 篏睡帥障
22.9563 +.LP
22.9564 + [篏睡] 若吾≪祉鴻鴻障宴若吾腱糸蚊若激с潟若 [篏睡] 潟障
22.9565 +.TP 3
22.9566 +\-version
22.9567 +ャ<潟@version 鴻腟粋昭帥障鴻сャ障篏睡 Javadoc 若若吾с潟腆肴\f2\-J\-version\fP 激с潟篏睡障
22.9568 +.LP
22.9569 +.TP 3
22.9570 +\-author
22.9571 +ャ<潟@author 鴻腟粋昭帥障
22.9572 +.LP
22.9573 +.TP 3
22.9574 +\-splitindex
22.9575 +膣√<ゃ≪<茲違<ゃ蚊絖 1 ゃ<ゃ≪<篁ュ絖у障膣√潟 1 ゃ<ゃ篏障
22.9576 +.LP
22.9577 +.TP 3
22.9578 +\-windowtitle\ title
22.9579 +HTML <title> 帥違臀帥ゃ絎障絎帥ゃc潟帥ゃ若吾絲障篏吟若 (羂ャ) 茵腓冴障帥ゃ HTML 帥違с 帥ゃ HTML 帥違障吟帥違罩c頵iс障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障\-windowtitle ャ翫Javadoc 若激с潟篁c \-doctitle ゃ篏帥障
22.9580 +.nf
22.9581 +\f3
22.9582 +.fl
22.9583 + % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
22.9584 +.fl
22.9585 +.fi
22.9586 +.TP 3
22.9587 +\-doctitle\ title
22.9588 +网荀<ゃ筝菴臀帥ゃ絎障帥ゃ筝紊 1 荀冴筝蚊若激с潟若筝臀障\f2title\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
22.9589 +.nf
22.9590 +\f3
22.9591 +.fl
22.9592 + % \fP\f3javadoc \-doctitle "Java (TM)" com.mypackage\fP
22.9593 +.fl
22.9594 +.fi
22.9595 +.TP 3
22.9596 +\-title\ title
22.9597 +\f3激с潟憜絖障\fPJavadoc 1.2 若睡絖障激с潟\f2\-doctitle\fP 紊眼障紊眼宴激с潟c潟帥ゃсャ<潟帥ゃ絎臂腆冴с
22.9598 +.LP
22.9599 +.TP 3
22.9600 +\-header\ header
22.9601 +阪<ゃ筝腴臀若鴻絎障若筝蚊若激с潟若勀眼臀障\f2header\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2header\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
22.9602 +.nf
22.9603 +\f3
22.9604 +.fl
22.9605 + % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP
22.9606 +.fl
22.9607 +.fi
22.9608 +.LP
22.9609 +.TP 3
22.9610 +\-footer\ footer
22.9611 +阪<ゃ筝腴臀帥若鴻絎障帥若筝蚊若激с潟若勀眼臀障 \f2footer\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2footer\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
22.9612 +.LP
22.9613 +.TP 3
22.9614 +\-bottom\ text
22.9615 +阪<ゃ筝臀鴻絎障鴻筝蚊若激с潟若筝若吾筝臀障\f2text\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2text\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
22.9616 +.LP
22.9617 +.TP 3
22.9618 +\-link\ extdocURL
22.9619 +javadoc √紊с鴻ャ<潟若激с潟吾潟篏障綣違 1 ゃ障
22.9620 +.LP
22.9621 +.RS 3
22.9622 .TP 2
22.9623 o
22.9624 -javap
22.9625 +\f4extdocURL\fP 潟絎javadoc c紊ャ<潟c腟九 URL 障後 URL ст腓冴障c宴若吾鴻<ゃ絖違障 絖翫\f2\-linkoffline\fP 篏睡障Javadoc 若\f2宴若吾鴻\fP<ゃ宴若後茯水宴若吾 URL 潟障Javadoc 若絎茵篏 \f2<A HREF>\fP 潟 \f2extdocURL\fP ゃ障障潟若障c\f2extdocURL\fP <ゃ吾 URL сc吾 URLс違障
22.9626 +.LP
22.9627 +\f2extdocURL\fP 吾腟九障潟篏睡若吟若ャ<潟篁紙 Web 泣ゃ筝ャ<潟潟с障 後鞘臀吾潟с翫後障潟篏睡с障後障潟篏睡翫\f2\-d\fP 篏帥cc潟宴若吾c後障鴻絎綽荀障
22.9628 +.LP
22.9629 +絽吾腟九障潟絎翫\f2http:\fP潟篏睡障Web 泣若若<ゃ激鴻潟翫\f2file:\fP 潟篏睡с障号鴻若吟若<ゃ激鴻掩ャ<潟≪祉鴻綽荀翫篁ュ篏睡с
22.9630 +.LP
22.9631 +翫若c潟違激鴻с腟九 URL 後 URL http:若鴻file:若鴻鴻激ャ阪絖篏睡障 (
22.9632 +.na
22.9633 +\f2URL Memo\fP @
22.9634 +.fi
22.9635 +http://www.ietf.org/rfc/rfc1738.txt ф絎)
22.9636 +.RS 3
22.9637 +.TP 3
22.9638 +http:若鴻腟九障潟:
22.9639 +\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
22.9640 +.TP 3
22.9641 +file:若鴻腟九障潟:
22.9642 +\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
22.9643 +.TP 3
22.9644 +後障潟:
22.9645 +\f2\-link <directory>/<directory>/.../<name>\fP
22.9646 +.RE
22.9647 +.RE
22.9648 +.LP
22.9649 +javadoc 絎茵茲違 \f2\-link\fP 激с潟絎茲違ャ<潟吾潟篏с障 \f3\-linkoffline 障 \-link 御\fP
22.9650 +.br
22.9651 +\f2\-link\fP 篏睡翫:
22.9652 +.RS 3
22.9653 .TP 2
22.9654 o
22.9655 +紊 API ャ<潟吾後障鴻篏睡翫
22.9656 +.TP 2
22.9657 +o
22.9658 +紊 API ャ<潟吾腟九 URL 篏睡翫 (違 URL ・膓茯水茵激сc荐怨翫)
22.9659 +.RE
22.9660 +罨<翫\f2\-linkoffline\fP 激с潟篏睡障
22.9661 +.RS 3
22.9662 +.TP 2
22.9663 +o
22.9664 +違 URL ・膓茯水茵激сc荐怨翫紊 API ャ<潟吾腟九 URL 篏睡翫倶潟ャ<潟<ゃ≪若眼翫榊障
22.9665 +.RE
22.9666 +.LP
22.9667 +\f3紊ャ<潟吾腟九障潟篏睡箴\fP \-
22.9668 +.na
22.9669 +\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
22.9670 +.fi
22.9671 +http://java.sun.com/j2se/1.5.0/docs/api \f2java.lang\fP\f2java.io\fP篁 Java 2 若宴若吾潟翫障 罨<潟潟\f2com.mypackage\fP 宴若吾ャ<潟 Java 2 若宴若吾吾潟障ャ<潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP \f2\-d\fP 篁激с潟茵腓冴障
22.9672 +.nf
22.9673 +\f3
22.9674 +.fl
22.9675 + % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
22.9676 +.fl
22.9677 +.fi
22.9678 +\f3紊ャ<潟吾後障潟篏睡箴\fP \- 2 ゃ宴若吾ャ<潟 Javadoc 若茲医絎茵腟с障 ャ<潟後障鴻у蚊障箴翫2 ゃ宴若吾API с \f2com.apipackage\fP SPI (泣若鴻ゃゃ潟帥с若) с \f2com.spipackage\fP сャ<潟主 \f2docs/api/com/apipackage\fP 宴若吾 \f2docs/spi/com/spipackage\fP 宴若吾сAPI 宴若吾ャ<潟с憜c \f2docs\fP с翫罨<潟潟絎茵c API ャ<潟吾潟 SPI 宴若吾ャ<潟障
22.9679 +.nf
22.9680 +\f3
22.9681 +.fl
22.9682 + % \fP\f3javadoc \-d ./spi \-link ../api com.spipackage\fP
22.9683 +.fl
22.9684 +.fi
22.9685 +.LP
22.9686 +\f2\-link\fP 綣違c (\f2docs/spi\fP) 後障鴻с
22.9687 +.LP
22.9688 +\f3荅括完\fP \- \f2\-link\fP 激с潟篏帥潟若сJavadoc 篁絎茵сャ<潟鴻潟с障潟鴻若吾腱糸с HTML 若吾贋茯帥鴻贋 \f2extdocURL\fP 絎綽荀障激с潟篏帥違泣若若c若ャ<潟\f2http://java.sun.com\fP \f2java.*\fP ャ<潟潟с障
22.9689 +.LP
22.9690 +篁絎茵 Javadoc cャ<潟 API 絲乗院潟篏翫\f2\-link\fP 激с潟ャ障\f2\-link\fP 激с潟絎翫Javadoc 若紊сャ<潟吾潟篏障ャ<潟絖喝翫贋ゅャсс
22.9691 +.LP
22.9692 +激с潟сャ<潟茲違贋潟篏с障
22.9693 +.LP
22.9694 +障激с潟篏帥茲違宴若悟召鴻潟篏с障ゃ障筝綣宴若吾絲障 javadoc 絎茵ャ筝綣宴若吾絲障 javadoc 絎茵 2 ゃ宴若悟召鴻潟篏с障
22.9695 +.LP
22.9696 +\f3鴻ф号\fP \- 紊с鴻吾潟鴻с鎘茵腓冴罨<号с鴻с綽荀障<純篏с鴻ссс障\f2import\fP 障絎hус綽荀障罨< \f2java.io.File\fP с号箴腓冴障
22.9697 +.RS 3
22.9698 +.TP 2
22.9699 +o
22.9700 +鴻腮蕁 \f2import\fP 翫: ゃ若ゃ潟若腓榊ゃ潟若障 \f2java.lang.*\fP 絲障ゃ潟若違罨<医с
22.9701 +.br
22.9702 +\f2import java.io.*;\fP
22.9703 +.br
22.9704 +1.3.x 1.2.x с腓榊ゃ潟若сゃ若ゃ潟若ゃ潟若 \f2java.lang.*\fP 篏睡с障
22.9705 +.TP 2
22.9706 +o
22.9707 +絎h翫:
22.9708 +.br
22.9709 +\f2void foo(File f) {}\fP
22.9710 +.br
22.9711 +с篏睡<純潟潟鴻帥c若鴻障ゃ潟帥с若鴻祉ゃ障<若帥臀\f2implements\fP\f2extends\fP障 \f2throws\fP 臀障
22.9712 +.RE
22.9713 +.LP
22.9714 +腟\f2\-link\fP 激с潟篏睡狗茯ゃc茵腓冴紊潟紊亥榊醇с障鴻ゃ若鴻潟篁茵腓冴障潟茵腓冴茘潟茯茘с障鴻罩cсc潟菴遵c絎号筝ц綵荅蚊鴻ゃ潟若с
22.9715 +.LP
22.9716 +\f3宴若吾鴻\fP \- \f2\-link\fP 激с潟\f2package\-list\fP <ゃ荀羆障 <ゃJavadoc 若c\f2\-link\fP c絎 URL 絖障\f2package\-list\fP <ゃ贋ャ<潟宴若吾鴻ャc膣鴻<ゃс箴сJavadoc 若絎 URL \f2package\-list\fP <ゃ「宴若後茯粋昭с URL 宴若吾吾潟篏障
22.9717 +.LP
22.9718 +違Java 若 v5.0 API 宴若吾鴻
22.9719 +.na
22.9720 +\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
22.9721 +.fi
22.9722 +http://java.sun.com/j2se/1.5.0/docs/api/package\-list 罨<絎鴻у障c障
22.9723 +.nf
22.9724 +\f3
22.9725 +.fl
22.9726 + java.applet
22.9727 +.fl
22.9728 + java.awt
22.9729 +.fl
22.9730 + java.awt.color
22.9731 +.fl
22.9732 + java.awt.datatransfer
22.9733 +.fl
22.9734 + java.awt.dnd
22.9735 +.fl
22.9736 + java.awt.event
22.9737 +.fl
22.9738 + java.awt.font
22.9739 +.fl
22.9740 + 篁 ...
22.9741 +.fl
22.9742 +\fP
22.9743 +.fi
22.9744 +.LP
22.9745 +\f2\-link\fP 激с潟絎 javadoc 絎茵翫紊с鴻絮荀ゃjavadoc 潟綵≪у阪障筝鴻\f2\-link\fP 激с潟絎翫絎 \f2extdocURL\fP \f2package\-list\fP <ゃ荅峨宴若後罎膣≪障宴若後荀ゃ\f2extdocURL\fP 篁障
22.9746 +.LP
22.9747 +鴻潟罩c閟純紊с鴻ャ<潟絎 URL 絖違障Javadoc 若絎 package\-list 絖茯帥鴻с絎 URL 若吾絖с障
22.9748 +.LP
22.9749 +\f3茲違潟\fP \- 茲違 \f2\-link\fP 激с潟絎篁紙違紊ャ<潟絲障潟荐絎с障Javadoc 1.2 茲違 \f2\-link\fP 激с潟絎с違障 1.2.2 т信罩c障
22.9750 +.LP
22.9751 +潟紊ャ<潟罨<ャ潟激с潟絎障
22.9752 +.LP
22.9753 +\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2...\fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
22.9754 +.LP
22.9755 +\f2extdocURL1\fP\f2extdocURL2\fP... \f2extdocURLn\fP 紊ャ<潟若若 \f2package\-list\fP <ゃャc障
22.9756 +.LP
22.9757 +\f3鴻潟\fP \- 障 2 や札筝ャ<潟鴻潟翫若鴻綽荀障ゃ障ャ<潟ゃ \f2package\-list\fP 絖翫ャ<潟絲障 javadoc 若絎茵鴻с2 ャ<潟 \f2package\-list\fP 障絖障c紊潟篏2 ャ<潟сャ<潟眼綽荀障
22.9758 +.LP
22.9759 +翫ャ<潟ャ<潟 \f2package\-list\fP 篏с 宴若後鴻<翫package\-list тс障罨<2 ャ<潟紊潟障綽荀紊 \f2package\-list\fP <ゃ絖翫Javadoc 若茘茵腓冴障
22.9760 +.LP
22.9761 +.TP 3
22.9762 +\-linkoffline\ extdocURL\ packagelistLoc
22.9763 +激с潟\f2\-link\fP 激с潟紊с <javadoc c紊с鴻ャ<潟吾潟篏障Javadoc 若篏ゃ潟c (Web ・膓篏帥cャ<潟≪祉鴻с)Web 筝ャ<潟潟\f2\-linkoffline\fP 激с潟篏睡障
22.9764 +.LP
22.9765 +ウ絲紊ャ<潟 \f2package\-list\fP <ゃ≪祉鴻с障<ゃ \f2extdocURL\fP ф絎贋違贋 (絽吾\f2packageListLoc\fP ф絎純若贋) 絖\f2\-linkoffline\fP 篏睡障c\f2extdocURL\fP WWW 筝с≪祉鴻с翫\f2\-linkoffline\fP 絎ャ<潟 javadoc 若 Web ・膓с違句障
22.9766 +.LP
22.9767 +ャ<潟贋違潟違篏睡純с宴若吾祉篏絲障 javadoc 絎茵紊眼筝宴若吾絲障 javadoc 絎茵障 贋違<ゃ吾<ゃ祉水ャс障箴хず障
22.9768 +.LP
22.9769 +\f2\-linkoffline\fP 激с潟綣違 2 ゅ障 綣違 \f2<a href>\fP 潟腟粋昭障絖絎綣違2 綣違 \f2package\-list\fP 罎膣√贋絎綣違с
22.9770 +.RS 3
22.9771 +.TP 2
22.9772 +o
22.9773 +\f4extdocURL\fP 潟絎javadoc c紊ャ<潟c腟九 URL 障後 URL с後障潟篏睡翫\f2\-d\fP 篏帥cc潟宴若吾若後障鴻絎綽荀障荅括完\f2\-link\fP 激с潟 \f2extdocURL\fP с
22.9774 +.TP 2
22.9775 +o
22.9776 +\f4packagelistLoc\fP 紊ャ<潟 \f2package\-list\fP <ゃャcc鴻障 URL 絎障URL (http: 障 file:)or file:)<ゃ鴻<с障障障腟九障鴻後障鴻<с絎с障後障鴻翫javadoc 絎茵潟c後障鴻絎障\f2package\-list\fP <ゃс
22.9777 +.RE
22.9778 +.LP
22.9779 +javadoc 1 絎茵с茲違 \f2\-linkoffline\fP 激с潟絎с障1.2.2 茲違激с潟絎с障с
22.9780 +.LP
22.9781 +\f3紊ャ<潟吾腟九障潟篏帥c箴\fP \- \f2http://java.sun.com/j2se/1.5.0/docs/api\fP \f2java.lang\fP\f2java.io\fP潟篁 Java 2 若宴若吾潟Web ≪祉鴻с 翫ゃ帥障翫吟
22.9782 +.na
22.9783 +\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
22.9784 +.fi
22.9785 +http://java.sun.com/j2se/1.5.0/docs/api/package\-list \f2package\-list\fP <ゃ若c篆絖障 2 綣 \f2packagelistLoc\fP 若潟若贋絎障箴с宴若吾鴻<ゃ潟c "\f2.\fP" 篆絖障罨<潟潟Java 2 若 API 吾潟\f2com.mypackage\fP 宴若吾ャ<潟障ャ<潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP 篁綽荀激с潟茵腓冴障
22.9786 +.nf
22.9787 +\f3
22.9788 +.fl
22.9789 +% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
22.9790 +.fl
22.9791 +.fi
22.9792 +.LP
22.9793 +\f3紊ャ<潟吾後障潟篏睡箴\fP \- 絽吾\f2\-linkoffline\fP 後障鴻絎障 \f2\-link\fP усс\f2\-linkoffline\fP 篏睡\f2package\-list\fP 絽吾若<ゃ絎障 後障潟篏睡潟<ゃ絽吾若<ゃ絎障c\f2\-linkoffline\fP 2 ゃ綣違ャ鴻絎綽荀障2 ゃ綣違筝с翫\f2\-link\fP 篏睡с障\f2\-link\fP 後障潟箴с
22.9794 +.LP
22.9795 +\f4package\-list\fP\f3 <ゃт\fP \- \f2package\-list\fP <ゃ障絖ャ<潟潟宴若後c翫<ゃт\f2packagelistLoc\fP с鴻絎с障\f2com.apipackage\fP \f2com.spipackage\fP 宴若吾鴻絖冴箴с号宴若後c障違紊ャ<潟潟ャ<潟綽荀翫箴水с障\f2package\-list\fP <ゃ Javadoc 1.0 1.1 х宴若後 \f2package\-list\fP <ゃ篏号障罕2 ゃ篌腓障 \f2package\-list\fP <ゃ掩с鴻潟荐絎ャ<潟若鴻純с
22.9796 +.LP
22.9797 +\f3茲違ャ<潟吾潟\fP \- \f2\-linkoffline\fP уャ<潟 1 ゃゆ絎障 罨<箴с激с潟茵障
22.9798 +.LP
22.9799 +\f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP
22.9800 +.br
22.9801 +\f2\ \ \ \ \ \ \ \ \ \ \fP\f4\-linkoffline\fP \f2extdocURL2\fP \f2packagelistLoc2\fP \f2\\\fP
22.9802 +.br
22.9803 +\f2\ \ \ \ \ \ \ \ \ \ ...\fP
22.9804 +.LP
22.9805 +\f3ャ<潟贋\fP \- 菴違 \f2\-linkoffline\fP 激с潟蚊ゃ吾с紊ч宴若吾障с弱篏絲障 javadoc 絎茵絎篋翫罨<絎茵с絨紊眼純若鴻若鋇絲障 javadoc 絎茵翫箴水сャ<潟若激с潟潟<潟絲障紊眼絎h紊眼翫炊cс潟違с純若鴻潟若絎h菴遵ゃ障紊眼翫膣√宴若吾若膓帥<潟若鴻[篏睡] 若吾贋с潟紕障
22.9806 +.LP
22.9807 +障篁絎茵т戎違c (\f2update\fP) 篏障c \f2html\fP 障c膣箴с\f2html\fP c荀c腱糸 (cd) 障\f2\-linkoffline\fP 綣違潟c "." 絎2 綣違 \f2html\fP 吾後障鴻絎障 с\f2package\-list\fP 罎膣≪障 贋医丞с宴若吾宴若後絎
22.9808 +.nf
22.9809 +\f3
22.9810 +.fl
22.9811 + % \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP
22.9812 +.fl
22.9813 +.fi
22.9814 +Javadoc 若腟篋緇\f2update/com/package\fP 鴻若吾潟若 (网荀膣√ゃ)\f2html/com/package\fP <ゃ筝吾障
22.9815 +.LP
22.9816 +.TP 3
22.9817 +\-linksource\
22.9818 +純若鴻<ゃ (茵垬) HTML 若吾с潟篏罔羣 HTML ャ<潟純若鴻<ゃ吾潟菴遵障潟純若鴻<ゃ絎h鴻ゃ潟帥с若鴻潟潟鴻帥<純c若絲障篏障潟潟鴻帥鴻絲障篏障
22.9819 +.LP
22.9820 +\f3激с潟\fP\f4\-public\fP\f3\fP\f4\-package\fP\f3\fP\f4\-protected\fP\f3\fP\f4\-private\fP\f3 激с潟≫鴻c若<純篏腟粋昭障純若鴻<ゃ鴻絎茖荅括完障\fP\f2\-private\fP 激с潟絎鴻ゃ潟帥с若鴻筝潟篁≪祉鴻с障
22.9821 +.LP
22.9822 +潟絎h茘ュ筝篏障違\f2Button\fP 鴻純若鴻潟若潟Button茯筝篏障
22.9823 +.nf
22.9824 +\f3
22.9825 +.fl
22.9826 + public class Button
22.9827 +.fl
22.9828 + extends Component
22.9829 +.fl
22.9830 + implements Accessible
22.9831 +.fl
22.9832 +\fP
22.9833 +.fi
22.9834 +Button 鴻 \f2getLabel()\fP <純純若鴻潟若吾潟getLabel茯筝篏障
22.9835 +.nf
22.9836 +\f3
22.9837 +.fl
22.9838 + public String getLabel()
22.9839 +.fl
22.9840 +\fP
22.9841 +.fi
22.9842 +.LP
22.9843 +.TP 3
22.9844 +\-group\ groupheading\ packagepattern:packagepattern:...
22.9845 +网荀若吾茲違宴若吾絎違若違若茵篏障違若ャ \f2\-group\fP 激с潟ф絎障違若潟潟茵ф絎綺с若吾茵腓冴障 違若с宴若吾≪<筝鴻障絎 \f2\-group\fP 激с潟\f2packagepattern\fP 綣鴻筝眼宴若吾荀冴 \f2groupheading\fP 1 ゃ茵障茵腓冴障
22.9846 +.RS 3
22.9847 +.TP 2
22.9848 +o
22.9849 +\f4groupheading\fP 篁紙鴻絎с腥榊純с障絎鴻違若茵荀冴障
22.9850 +.TP 2
22.9851 +o
22.9852 +\f4packagepattern\fP 篁紙宴若後障篁紙宴若後膓 1 ゃ≪鴻帥鴻 (\f2*\fP) 絎с障≪鴻帥鴻篁紙絖筝眼潟ゃ若сゃ若絎с≪鴻帥鴻с1 ゃ違若潟 (\f2:\fP) у阪c茲違帥若潟с障
22.9853 +.RE
22.9854 +.RS 3
22.9855 +
22.9856 +.LP
22.9857 +.LP
22.9858 +\f3羈: 帥若潟帥若潟鴻с≪鴻帥鴻篏帥翫\fP\f4"java.lang*:java.util"\fP\f3 帥若潟鴻綣膃у蚊綽荀障\fP
22.9859 +.LP
22.9860 +.RE
22.9861 +.LP
22.9862 +\f2\-group\fP 激с潟絎翫鴻宴若吾宴若吾荀冴 1 ゃ違若ャ障ャ<潟宴若吾筝絎違若違若ャ宴若吾翫宴若吾篁宴若吾荀冴ょ腴違若ャ障
22.9863 +.LP
22.9864 +違罨<激с潟絎ャ<潟 5 ゃ宴若吾潟≪宴若吾≦宍罘純宴若吾潟篁宴若吾障java.lang*с緇絎羈 java.lang.*ャjava.lang 宴若吾ゅ障
22.9865 +.nf
22.9866 +\f3
22.9867 +.fl
22.9868 + % \fP\f3javadoc \-group "Core Packages" "java.lang*:java.util"
22.9869 +.fl
22.9870 + \-group "Extension Packages" "javax.*"
22.9871 +.fl
22.9872 + java.lang java.lang.reflect java.util javax.servlet java.new\fP
22.9873 +.fl
22.9874 +.fi
22.9875 +腟罨<違若茵障
22.9876 +.RS 3
22.9877 +.RS 3
22.9878 +.TP 3
22.9879 +潟≪宴若
22.9880 +\f2java.lang\fP
22.9881 +\f2java.lang.reflect\fP
22.9882 +\f2java.util\fP
22.9883 +.TP 3
22.9884 +≦宍罘純宴若
22.9885 +\f2javax.servlet\fP
22.9886 +.TP 3
22.9887 +篁宴若
22.9888 +\f2java.new\fP
22.9889 +.RE
22.9890 +
22.9891 +.LP
22.9892 +.RE
22.9893 +.LP
22.9894 +.TP 3
22.9895 +\-nodeprecated
22.9896 +ィ絅 API ャ<潟障激с潟絎\-nodeprecatedlist 激с潟絎翫号ャ<潟祉篏сィ絅 API 障激с潟潟若荐菴違ィ絅潟若c羂c翫箴水с
22.9897 +.LP
22.9898 +.TP 3
22.9899 +\-nodeprecatedlist
22.9900 +ィ絅 API 鴻<ゃ (deprecated\-list.html)潟蚊若激с潟若若吾吾潟障ャ<潟祉сィ絅 API 障激с潟ィ絅 API 純若鴻潟若障蚊若激с潟若c荀翫箴水с
22.9901 +.LP
22.9902 +.TP 3
22.9903 +\-nosince
22.9904 +ャ<潟@since 帥違絲上絨ャ若吾с潟 祉激с潟ャ障
22.9905 +.LP
22.9906 +.TP 3
22.9907 +\-notree
22.9908 +ャ<潟鴻潟ゃ潟帥с若鴻絮ゃ若吾ャ障若吾蚊若激с潟若若帥潟≪祉鴻с障с絮ゃ障
22.9909 +.LP
22.9910 +.TP 3
22.9911 +\-noindex
22.9912 +ャ<潟膣√ャ障с膣√障
22.9913 +.LP
22.9914 +.TP 3
22.9915 +\-nohelp
22.9916 +阪若吾筝筝蚊若激с潟若 [] 潟ャ障
22.9917 +.LP
22.9918 +.TP 3
22.9919 +\-nonavbar
22.9920 +若吾筝筝茵腓冴蚊若激с潟若若潟帥若障激с潟bottom 激с潟綵演帥筝障\f2\-nonavbar\fP 激с潟医激<ゃ PostScript 障 PDF 紊翫絎鴻荀с蚊若激с潟綽荀翫箴水с
22.9921 +.LP
22.9922 +.TP 3
22.9923 +\-helpfile\ path/filename
22.9924 +筝筝蚊若激с潟若 [] 潟潟篁f帥<ゃ \f2path/filename\fP 鴻絎障激с潟絎翫Javadoc 若若潟若<ゃ \f2help\-doc.html\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP <ゃс絎с\f2help\-doc.html\fP 絎障箴腓冴障
22.9925 +.nf
22.9926 +\f3
22.9927 +.fl
22.9928 + % \fP\f3javadoc \-helpfile /home/user/myhelp.html java.awt\fP
22.9929 +.fl
22.9930 +.fi
22.9931 +.TP 3
22.9932 +\-stylesheetfile\ path/filename
22.9933 +篁f HTML 鴻帥ゃ激若<ゃ鴻絎障激с潟絎翫Javadoc 若若潟若鴻帥ゃ激若<ゃ \f2stylesheet.css\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP <ゃс絎с\f2stylesheet.css\fP 絎障箴腓冴障
22.9934 +.nf
22.9935 +\f3
22.9936 +.fl
22.9937 + % \fP\f3javadoc \-stylesheetfile /home/user/mystylesheet.css com.mypackage\fP
22.9938 +.fl
22.9939 +.fi
22.9940 +.TP 3
22.9941 +\-serialwarn
22.9942 +@serial 帥違翫潟潟ゃ茘障сJavadoc 1.2.2 篁ラ若吾с潟с翫茘障1.2.2 若吾с潟с茘障激с潟篏睡翫茘茵腓冴с翫純c若 \f2writeExternal\fP <純ャ<潟綵合<障
22.9943 +.LP
22.9944 +.TP 3
22.9945 +\-charset\ name
22.9946 +ャ<潟 HTML 絖祉絎障
22.9947 +.na
22.9948 +\f2IANA Registry\fP @
22.9949 +.fi
22.9950 +http://www.iana.org/assignments/character\-sets тィ絅 MIME с違障箴腓冴障
22.9951 +.nf
22.9952 +\f3
22.9953 +.fl
22.9954 + % \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
22.9955 +.fl
22.9956 +.fi
22.9957 +鴻若吾罨<茵水ャ障
22.9958 +.nf
22.9959 +\f3
22.9960 +.fl
22.9961 + <META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">
22.9962 +.fl
22.9963 +\fP
22.9964 +.fi
22.9965 + META 帥違ゃ
22.9966 +.na
22.9967 +\f2HTML 罔羣\fP @
22.9968 +.fi
22.9969 +http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 4137321) с
22.9970 +.LP
22.9971 +\-encoding \-docencoding с
22.9972 +.LP
22.9973 +.TP 3
22.9974 +\-docencoding\ name
22.9975 + HTML <ゃ潟潟若c潟違絎障
22.9976 +.na
22.9977 +\f2IANA Registry\fP @
22.9978 +.fi
22.9979 +http://www.iana.org/assignments/character\-sets тィ絅 MIME с違障激с潟ャ \-encoding 篏睡翫 HTML <ゃ潟潟若\-encoding c羆冴障箴:
22.9980 +.nf
22.9981 +\f3
22.9982 +.fl
22.9983 + % \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
22.9984 +.fl
22.9985 +.fi
22.9986 +\-encoding \-charset с
22.9987 +.LP
22.9988 +.TP 3
22.9989 +\-keywords
22.9990 +HTML <帥若若帥違鴻<ゃ菴遵障帥違<帥帥違罎膣≪泣若潟吾潟若吾荀ゃ翫綵合<障ゃ潟帥若篏罎膣≪紊泣若潟吾潟若吾<帥帥違茯ょ<帥帥違茯帥鴻障 筝鴻罎膣≪荳 Web 泣ゃ絎篌罐с泣若潟吾潟<帥帥違茯帥鴻c<緇障
22.9991 +.LP
22.9992 +<帥帥違鴻絎篆蕋上c若潟<純篆蕋障障障潟潟鴻帥劫с障障違 String 罨<若若ч紮障
22.9993 +.nf
22.9994 +\f3
22.9995 +.fl
22.9996 + <META NAME="keywords" CONTENT="java.lang.String class">
22.9997 +.fl
22.9998 + <META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">
22.9999 +.fl
22.10000 + <META NAME="keywords" CONTENT="length()">
22.10001 +.fl
22.10002 + <META NAME="keywords" CONTENT="charAt()">
22.10003 +.fl
22.10004 +\fP
22.10005 +.fi
22.10006 +.LP
22.10007 +.TP 3
22.10008 +\-tag\ \ tagname:Xaoptcmf:"taghead"
22.10009 +Javadoc 若ャ<潟若激с潟潟<潟綣違 1 ゅ膣鴻帥帥 \f2@\fP\f2tagname\fP 茹iс障Javadoc 若帥医鴻с茵сс純若鴻潟若鴻鴻帥帥違 \f2\-tag\fP 激с潟腟粋昭с障篁絎茵у阪帥違\f2X\fP 篁≦鴻障
22.10010 +.LP
22.10011 +潟 (\f4:\fP) 絽吾阪絖障\f2tagname\fP с潟潟篏睡帥医с潟潟篏睡с
22.10012 +.LP
22.10013 +\f2\-tag\fP 激с潟帥違荀冴taghead紊絖у阪障 罨<茵激с潟綣違ф絎鴻膓障 篁ヤ箴с帥違罕綣違鴻ゃ潟ゃ潟帥違с障 ゃ潟ゃ潟帥違茹i障阪綣違 1 ゅ罔羣帥 (\f2@return\fP\f2@author\fP ) 阪鋍若障\f2taghead\fP ャ\f2tagname\fP 荀冴茵腓冴障
22.10014 +.LP
22.10015 +\f3帥違臀\fP \- 綣違 \f4Xaoptcmf\fP 純若鴻潟若帥違臀с篏臀\f2X\fP 篏帥c帥違≦鴻с劫障帥違臀篏臀狗翫 \f4a\fP 絎障 篁ュ絖腟水純с \f4X\fP (帥違≦劫)
22.10016 +.br
22.10017 +\f4a\fP (鴻篏臀)
22.10018 +.br
22.10019 +\f4o\fP (网荀)
22.10020 +.br
22.10021 +\f4p\fP (宴若)
22.10022 +.br
22.10023 +\f4t\fP (<鴻潟ゃ潟帥с若)
22.10024 +.br
22.10025 +\f4c\fP (潟潟鴻)
22.10026 +.br
22.10027 +\f4m\fP (<純)
22.10028 +.br
22.10029 +\f4f\fP (c若)
22.10030 +.LP
22.10031 +\f3激潟違帥違箴\fP \- 純若鴻潟若篁紙篏臀т戎ф帥違帥違激с潟箴腓冴障
22.10032 +.nf
22.10033 +\f3
22.10034 +.fl
22.10035 + \-tag todo:a:"To Do:"
22.10036 +.fl
22.10037 +\fP
22.10038 +.fi
22.10039 +@todo 潟潟鴻帥<純c若帥т戎翫篁ヤ激с潟篏睡障
22.10040 +.nf
22.10041 +\f3
22.10042 +.fl
22.10043 + \-tag todo:cmf:"To Do:"
22.10044 +.fl
22.10045 +\fP
22.10046 +.fi
22.10047 +筝箴緇潟 (\f2:\fP) <若水阪絖с荀冴鴻筝c障 (篁ヤ箴)罨<箴\f2@todo\fP 帥違純若鴻潟若с帥違激с潟篏睡障
22.10048 +.nf
22.10049 +\f3
22.10050 +.fl
22.10051 + @todo The documentation for this method needs work.
22.10052 +.fl
22.10053 +\fP
22.10054 +.fi
22.10055 +\f3帥医潟潟篏睡\fP \- 潟 (:) 鴻激ャс鴻宴若潟潟帥医篏睡с障ャ<潟若激с潟潟<潟筝с罨<篏睡障
22.10056 +.nf
22.10057 +\f3
22.10058 +.fl
22.10059 + /**
22.10060 +.fl
22.10061 + * @ejb:bean
22.10062 +.fl
22.10063 + */
22.10064 +.fl
22.10065 +\fP
22.10066 +.fi
22.10067 +с帥違激с潟篏睡
22.10068 +.nf
22.10069 +\f3
22.10070 +.fl
22.10071 + \-tag ejb\\\\:bean:a:"EJB Bean:"
22.10072 +.fl
22.10073 +\fP
22.10074 +.fi
22.10075 +\f3帥医鴻с (帥違≦劫)\fP \- 純若鴻潟若臀筝鴻帥帥違阪吟翫障翫純若鴻潟若鴻帥違臀阪吟帥違鴻阪吟帥違≦鴻障帥違≦鴻\f2X\fP 絎障絎帥違鴻障 Javadoc 若罎冴帥違ュ鴻ャ帥違с劫с障ャ帥違罎冴翫Javadoc 若茘阪障
22.10076 +.LP
22.10077 +с臀ゃ \f2X\fP 菴遵с障 違\f2X\fP ゃс帥違鴻с障違@todo 帥違阪吟翫罨<絎障
22.10078 +.nf
22.10079 +\f3
22.10080 +.fl
22.10081 + \-tag todo:Xcmf:"To Do:"
22.10082 +.fl
22.10083 +\fP
22.10084 +.fi
22.10085 +膣絎号障
22.10086 +.nf
22.10087 +\f3
22.10088 +.fl
22.10089 + \-tag todo:X
22.10090 +.fl
22.10091 +\fP
22.10092 +.fi
22.10093 +.LP
22.10094 +罕 \f2\-tag todo:X\fP \f2@todo\fP taglet у臂翫鴻с
22.10095 +.LP
22.10096 +\f3帥違綺\fP \- \f2\-tag\fP ( \f2\-taglet\fP) 激с潟綺c阪綺羆阪障鴻帥帥違罔羣帥違腟水篏睡с障罔羣帥違帥違激с潟綺羆阪若鴻с罔羣帥医帥篏睡障(罔羣帥違絨頳冴紊眼с障)ゃ篁ヤ箴ц障
22.10097 +.LP
22.10098 +\f2\-tag\fP 翫\f2\-taglet\fP 篏臀c綺羆阪障帥違筝≧鴻絖翫潟潟茵緇祉綺羆阪障帥違帥違潟潟茵絎с違\f2\-taglet\fP \f2\-tag\fP 筝≧鴻 todo c翫潟潟茵緇祉綺羆阪障
22.10099 +.LP
22.10100 +\f3帥違絎祉箴\fP \- 箴с阪ParametersThrowsTo Do水ャ障X 篏睡@example 純若鴻潟若篁絎茵с阪帥違с絎障@argfile 篏睡翫罨<綣違<ゃャ茵帥違臀с障 茵膓膓腓冴絖筝荀с
22.10101 +.nf
22.10102 +\f3
22.10103 +.fl
22.10104 + \-tag param
22.10105 +.fl
22.10106 + \-tag return
22.10107 +.fl
22.10108 + \-tag todo:a:"To Do:"
22.10109 +.fl
22.10110 + \-tag throws
22.10111 +.fl
22.10112 + \-tag see
22.10113 +.fl
22.10114 + \-tag example:X
22.10115 +.fl
22.10116 +\fP
22.10117 +.fi
22.10118 +.LP
22.10119 +javadoc ャ<潟若激с潟潟<潟茹f罎冴帥違<罔羣帥違с \f2\-tag\fP \f2\-taglet\fP ф検帥違сャ帥違荀障 翫茘鴻若障
22.10120 +.LP
22.10121 +罔羣帥違綺с鴻主障\f2\-tag\fP 激с潟篏睡鴻菴遵帥違≧羣帥違篏臀篏臀腱糸障ゃ障罔羣帥違 \f2\-tag\fP 激с潟篁違篏臀臀障障障
22.10122 +.LP
22.10123 +\f3腴九\fP \- 堺腥咲蚊宴若吾篏睡 \f2com.mycompany.todo\fP (.) 阪遵荀篏睡障Sun 篁緇障罔羣帥違篏障若吟若篏帥違Sun 箴帥違篏若若ゃ障ゃ障若吟若 \f2@todo\fP 帥違障帥違篏翫Sun 罔羣帥違篏帥違障帥違篏篆障
22.10124 +.LP
22.10125 +\f3羈 vs. Javadoc 帥\fP \- 筝菴遵綽荀若≪ャ<潟若激с潟綵演帥筝ャ<潟若激с潟с翫若≪ javadoc 帥違鴻с 篁ュ翫羈鴻с
22.10126 +.na
22.10127 +\f2Comparing Annotations and Javadoc Tags\fP @
22.10128 +.fi
22.10129 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsс
22.10130 +.LP
22.10131 +\-taglet 激с潟篏睡茲帥違鴻帥ゃ潟ゃ潟帥違 篏с障
22.10132 +.LP
22.10133 +.TP 3
22.10134 +\-taglet\ \ class
22.10135 +帥違ャ<潟篏帥莎桁鴻<ゃ絎障鴻絎絎絎帥違鴻帥帥違鴻綣違違絎臂障帥違綣違篁阪障紊ャ<潟泣潟帥違ゃ篁ヤс
22.10136 +.RS 3
22.10137 +.TP 2
22.10138 +o
22.10139 +.na
22.10140 +\f2帥違网荀\fP @
22.10141 +.fi
22.10142 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
22.10143 +.RE
22.10144 +.LP
22.10145 +帥違罔羣帥違障ゃ潟ゃ潟帥違т梢с帥違篁紙違綣違с障 障鴻紊絖膊≧吾篏鴻<ゃ吾冴篁祉鴻紮鴻帥篏絎茖с障
22.10146 +.LP
22.10147 +帥違ф絎с帥違臀贋臀綵√帥с篁鴻羆阪c茵障帥違篏睡鴻鴻劫ゃ絎茵с障帥違鴻<ゃ阪ャ祉鴻若篏緇障
22.10148 +.LP
22.10149 +帥違鴻絎\f2\-tagletpath\fP 激с潟篏睡障篁ヤ若吾ParameterThrowsTo Do帥違水ャ箴с
22.10150 +.nf
22.10151 +\f3
22.10152 +.fl
22.10153 + \-taglet com.sun.tools.doclets.ToDoTaglet
22.10154 +.fl
22.10155 + \-tagletpath /home/taglets
22.10156 +.fl
22.10157 + \-tag return
22.10158 +.fl
22.10159 + \-tag param
22.10160 +.fl
22.10161 + \-tag todo
22.10162 +.fl
22.10163 + \-tag throws
22.10164 +.fl
22.10165 + \-tag see
22.10166 +.fl
22.10167 +\fP
22.10168 +.fi
22.10169 +.LP
22.10170 +\f2\-tag\fP 激с潟篁c \f2\-taglet\fP 激с潟篏睡с障茯帥\f2\-tag\fP 激с潟篏睡祉с
22.10171 +.LP
22.10172 +.TP 3
22.10173 +\-tagletpath\ \ tagletpathlist
22.10174 +taglet 鴻<ゃ (.class) 罎膣≪鴻絎障\f2tagletpathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣c罎膣≪障
22.10175 +.LP
22.10176 +.TP 3
22.10177 +\-docfilessubdirs\
22.10178 +\f2doc\-files\fP c羞宴潟若鴻障ゃ障潟弱泣c鴻潟潟潟潟若障違\f2doc\-files/example/images\fP c筝<ゃ潟若障с泣cゅ絎純с
22.10179 +.LP
22.10180 +.TP 3
22.10181 +\-excludedocfilessubdir\ \ name1:name2...
22.10182 +絎 \f2doc\-files\fP 泣cゅ障SCCS 篁純若鴻潟若九勝泣c潟若蚊障
22.10183 +.LP
22.10184 +.TP 3
22.10185 +\-noqualifier\ \ all\ | \ packagename1:packagename2:...
22.10186 +阪劫宴若後 (宴若娯信蕋上) ャ障\f2\-noqualifier\fP 綣違 \f2all\fP 絎翫鴻宴若娯信蕋上鴻ャ障 ゃ茲違宴若後潟潟у阪cゃ若絎с障鴻障ゃ潟帥с若劫茵腓冴篏臀宴若後ゃ障
22.10187 +.LP
22.10188 +罨<箴с鴻宴若娯信蕋上ャ障
22.10189 +.nf
22.10190 +\f3
22.10191 +.fl
22.10192 + \-noqualifier all
22.10193 +.fl
22.10194 +\fP
22.10195 +.fi
22.10196 +罨<箴с宴若娯信蕋上 java.lang java.io ャ障
22.10197 +.nf
22.10198 +\f3
22.10199 +.fl
22.10200 + \-noqualifier java.lang:java.io
22.10201 +.fl
22.10202 +\fP
22.10203 +.fi
22.10204 +罨<箴сjava у障宴若娯信蕋上 com.sun 泣宴若 (javax с) ャ障
22.10205 +.nf
22.10206 +\f3
22.10207 +.fl
22.10208 + \-noqualifier java.*:com.sun.*
22.10209 +.fl
22.10210 +\fP
22.10211 +.fi
22.10212 +宴若娯信蕋上筝荐篏緇c茵腓冴翫障 荅括完茵腓堺号с荀\f2\-noqualifier\fP 篏睡鴻с
22.10213 +.LP
22.10214 +.TP 3
22.10215 +\-notimestamp\
22.10216 +帥ゃ鴻帥潟吟障 若後菴 HTML HTML 潟<潟с帥ゃ鴻帥潟障Javadoc 2 ゃ純若鴻若鴻у茵絲障 diff 絎茵激с潟篏睡帥ゃ鴻帥潟c diff 榊т梢с (激с潟篏睡若吾 diff 障)帥ゃ鴻帥潟 Javadoc 若吾с括垩障罨<障
22.10217 +.nf
22.10218 +\f3
22.10219 +.fl
22.10220 + <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
22.10221 +.fl
22.10222 +\fP
22.10223 +.fi
22.10224 +.LP
22.10225 +.TP 3
22.10226 +\-nocomment\
22.10227 +筝肢潟鴻帥違潟<潟篏吟絎h障激с潟違c純若鴻<ゃ違吾с罧級с鴻宴 HTML ャ<潟篏с障
22.10228 +.RE
22.10229 +.SH "潟潟茵綣違<ゃ"
22.10230 +.LP
22.10231 +.LP
22.10232 +\f2javadoc\fP 潟潟茵膂≧\f2javadoc\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) ャc 1 や札筝<ゃ絎с障違若c潟違激鴻筝с篁紙激 javadoc 潟潟篏с障
22.10233 +.LP
22.10234 +.LP
22.10235 +綣違<ゃjavac 激с潟純若鴻<ゃ宴腟水荐菴違с障<ゃ綣違鴻若鴻障壕у阪障<ゃ腥榊純障翫<ゃ篏篋綣膃у蚊帥障
22.10236 +.LP
22.10237 +.LP
22.10238 +綣違<ゃ<ゃ憜c荀後障鴻障綣違<ゃ篏臀荀後障鴻с障綣違<ゃ<ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
22.10239 +.LP
22.10240 +.LP
22.10241 +javadoc 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障javadoc \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
22.10242 +.LP
22.10243 +.SS
22.10244 +綣違<ゃ 1 ゆ絎箴
22.10245 +.LP
22.10246 +.LP
22.10247 +\f2argfile\fP 綣違<ゃ鴻 Javadoc 綣違主罨<篏睡с障
22.10248 +.LP
22.10249 +.nf
22.10250 +\f3
22.10251 +.fl
22.10252 + % \fP\f3javadoc @argfile\fP
22.10253 +.fl
22.10254 +.fi
22.10255 +
22.10256 +.LP
22.10257 +.LP
22.10258 +綣違<ゃ罨<箴хず 2 ゃ<ゃ絎鴻筝≧鴻ャс障
22.10259 +.LP
22.10260 +.SS
22.10261 +綣違<ゃ 2 ゆ絎箴
22.10262 +.LP
22.10263 +.LP
22.10264 +Javadoc 激с括 1 ゃ純若鴻<ゃ 1 ゃ2 ゃ綣違<ゃ篏罨<篏睡с障鴻с茵膓膓絖篏睡障
22.10265 +.LP
22.10266 +.LP
22.10267 +篁ヤ絎鴻 \f2options\fP <ゃ篏障
22.10268 +.LP
22.10269 +.nf
22.10270 +\f3
22.10271 +.fl
22.10272 + \-d docs\-filelist
22.10273 +.fl
22.10274 + \-use
22.10275 +.fl
22.10276 + \-splitindex
22.10277 +.fl
22.10278 + \-windowtitle 'Java 2 Platform v1.3 API Specification'
22.10279 +.fl
22.10280 + \-doctitle 'Java(TM) 2 Platform 5.0 API Specification'
22.10281 +.fl
22.10282 + \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
22.10283 +.fl
22.10284 + \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
22.10285 +.fl
22.10286 + \-group "Core Packages" "java.*"
22.10287 +.fl
22.10288 + \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
22.10289 +.fl
22.10290 + \-sourcepath /java/pubs/ws/1.5/src/share/classes
22.10291 +.fl
22.10292 +\fP
22.10293 +.fi
22.10294 +
22.10295 +.LP
22.10296 +.LP
22.10297 +篁ヤ絎鴻 \f2packages\fP <ゃ篏障
22.10298 +.LP
22.10299 +.nf
22.10300 +\f3
22.10301 +.fl
22.10302 + com.mypackage1
22.10303 +.fl
22.10304 + com.mypackage2
22.10305 +.fl
22.10306 + com.mypackage3
22.10307 +.fl
22.10308 +\fP
22.10309 +.fi
22.10310 +
22.10311 +.LP
22.10312 +.LP
22.10313 +罨<潟潟篏睡 javadoc 絎茵障
22.10314 +.LP
22.10315 +.nf
22.10316 +\f3
22.10317 +.fl
22.10318 + % \fP\f3javadoc @options @packages\fP
22.10319 +.fl
22.10320 +.fi
22.10321 +
22.10322 +.LP
22.10323 +.SS
22.10324 +剛綣違<ゃ箴
22.10325 +.LP
22.10326 +.LP
22.10327 +綣違<ゃ鴻絎с障 <ゃ絎<ゃ憜篏罐c荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
22.10328 +.LP
22.10329 +.nf
22.10330 +\f3
22.10331 +.fl
22.10332 + % \fP\f3javadoc @path1/options @path2/packages\fP
22.10333 +.fl
22.10334 +.fi
22.10335 +
22.10336 +.LP
22.10337 +.SS
22.10338 +激с潟綣違箴
22.10339 +.LP
22.10340 +.LP
22.10341 +罨<Javadoc 激с潟絲障綣違綣違<ゃ主箴腓冴障с\f2\-bottom\fP 箴筝障 激с潟激綣違絎с障激с潟鴻綣違罨<絎鴻\f2bottom\fP <ゃ篏障
22.10342 +.LP
22.10343 +.nf
22.10344 +\f3
22.10345 +.fl
22.10346 +'<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a
22.10347 +.fl
22.10348 +bug or feature</a><br><br>Java is a trademark or registered trademark of
22.10349 +.fl
22.10350 +Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-2000 Sun
22.10351 +.fl
22.10352 +Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
22.10353 +.fl
22.10354 +All Rights Reserved.</font>'
22.10355 +.fl
22.10356 +\fP
22.10357 +.fi
22.10358 +
22.10359 +.LP
22.10360 +.LP
22.10361 +罨< Javadoc 若絎茵障
22.10362 +.LP
22.10363 +.nf
22.10364 +\f3
22.10365 +.fl
22.10366 + % \fP\f3javadoc \-bottom @bottom @packages\fP
22.10367 +.fl
22.10368 +.fi
22.10369 +
22.10370 +.LP
22.10371 +.LP
22.10372 +障綣違<ゃ \f2\-bottom\fP 激с潟腟粋昭с違罨<絎茵с障
22.10373 +.LP
22.10374 +.nf
22.10375 +\f3
22.10376 +.fl
22.10377 + % \fP\f3javadoc @bottom @packages\fP
22.10378 +.fl
22.10379 +.fi
22.10380 +.SH ""
22.10381 +絎茵
22.10382 +.SH "Javadoc 絎茵"
22.10383 +.LP
22.10384 +.LP
22.10385 +\f3若吾с括\fP \- javadoc 若吾с括垩ゅャ\f3javadoc \-J\-version\fP 篏睡障阪鴻若罔羣若吾с括垩障障\f2\-quiet\fP х≦鴻с障
22.10386 +.LP
22.10387 +.LP
22.10388 +\f3違ゃ潟帥с若\fP \- Java 荐茯ц菴違違 Javadoc 若莎桁篏睡障ゃ潟帥с若鴻 \f2com.sun.tools.javadoc.Main\fP 障 (javadoc ュ)荅括完
22.10389 +.na
22.10390 +\f2罔羣\fP @
22.10391 +.fi
22.10392 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyс
22.10393 +.LP
22.10394 +.LP
22.10395 +\f3絎茵\fP \- 筝荐茯罔羣 HTML 若喝冴с鴻帥若喝冴\-doclet \-docletpath 激с潟篏睡障劫絎茵絎箴ゃ
22.10396 +.na
22.10397 +\f2MIF Doclet ャ<潟\fP @
22.10398 +.fi
22.10399 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
22.10400 +.LP
22.10401 +.SH "膂≦箴"
22.10402 +.LP
22.10403 +.LP
22.10404 +javadoc 宴若後篏絲障絎茵純若鴻<ゃ絲障絎茵с障宴若後宴若後絲上c<障罨<箴с純若鴻<ゃ \f2/home/src/java/awt/*.java\fP 障c \f2/home/html\fP с
22.10405 +.LP
22.10406 +.SS
22.10407 +1 や札筝宴若吾ャ<潟
22.10408 +.LP
22.10409 +.LP
22.10410 +宴若吾ャ<潟宴若吾純若鴻<ゃ (\f2*.java\fP) 宴若吾ゃc絖違障宴若後茲違茘ュф (\f2java.awt.color\fP 茘ュу阪) 翫緇膓茘ュ筝篏泣c絲上違障 (\f2java/awt/color\fP )1 ゃ宴若吾茲違純若鴻<ゃ違贋 2 ゃc若主純с (\f2src1/java/awt/color\fP \f2src2/java/awt/color\fP ) 翫\f2\-sourcepath\fP c筝≧鴻贋絎違障
22.10411 +.LP
22.10412 +.LP
22.10413 +javadoc 絎茵\f2cd\fP 潟潟篏帥cc紊眼障 \f2\-sourcepath\fP 激с潟篏睡障篁ヤ箴с筝≧鴻号ゃ茯障
22.10414 +.LP
22.10415 +.RS 3
22.10416 +.TP 2
22.10417 +o
22.10418 +\f3宴若 1 \- 1 や札筝宴若吾莎桁絽亥絎茵\fP \- 箴с javadoc 篁紙c絎茵с\-sourcepath 篏睡絽亥 \-subpackages (1.4 違激с) 篏睡障\f2java\fP 泣宴若 (\f2java.net\fP \f2java.lang\fP 若宴若吾ゃ) 障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
22.10419 +.nf
22.10420 +\f3
22.10421 +.fl
22.10422 + % \fP\f3javadoc \fP\f3\-d\fP\f3 /home/html \fP\f3\-sourcepath\fP\f3 /home/src \fP\f3\-subpackages\fP\f3 java \fP\f3\-exclude\fP\f3 java.net:java.lang\fP
22.10423 +.fl
22.10424 +.fi
22.10425 +.LP
22.10426 +篁宴若吾若綏≦\f2java:javax:org.xml.sax\fP \f2\-subpackages\fP 綣違菴遵障
22.10427 +.TP 2
22.10428 +o
22.10429 +\f3宴若 2 \- 若純若鴻c腱祉c腓榊宴若吾絲障絎茵\fP \- 絎絎宴若後荀c腱祉障罨<ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障
22.10430 +.nf
22.10431 +\f3
22.10432 +.fl
22.10433 + % \fP\f3cd /home/src/\fP
22.10434 +.fl
22.10435 + % \f3javadoc \-d /home/html java.awt java.awt.event\fP
22.10436 +.fl
22.10437 +.fi
22.10438 +.TP 2
22.10439 +o
22.10440 +\f3宴若 3 \- 篁紙c絎茵 純若鴻<ゃ 1 ゃc弱\fP \- 宴若鴻с憜cсc障障筝篏宴若吾荀c \f2\-sourcepath\fP 絎ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障
22.10441 +.nf
22.10442 +\f3
22.10443 +.fl
22.10444 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt java.awt.event\fP
22.10445 +.fl
22.10446 +.fi
22.10447 +.TP 2
22.10448 +o
22.10449 +\f3宴若 4 \- 篁紙c絎茵 純若鴻<ゃ茲違c弱\fP \- 宴若 3 篌若障宴若吾茲違c若絖障若若吾鴻 \f2\-sourcepath\fP 絎 (潟潟у阪)ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障1 ゃ宴若吾鴻純若鴻<ゃ1 ゃ若c筝絖違障 純若鴻鴻絎贋цゃ医с
22.10450 +.nf
22.10451 +\f3
22.10452 +.fl
22.10453 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java.awt java.awt.event\fP
22.10454 +.fl
22.10455 +.fi
22.10456 +.RE
22.10457 +
22.10458 +.LP
22.10459 +.LP
22.10460 +腟: 筝荐宴若鴻с\f2java.awt\fP \f2java.awt.event\fP 宴若後 public protected 鴻ゃ潟帥с若鴻ゃHTML 綵√ャ<潟絎c (\f2/home/html\fP) HTML <ゃ篆絖障2 や札筝宴若吾сャ<潟宴若吾鴻鴻鴻潟<ゃ潟鴻若吾 3 ゃ若ゃ障
22.10461 +.LP
22.10462 +.SS
22.10463 +1 や札筝鴻ャ<潟
22.10464 +.LP
22.10465 +.LP
22.10466 +障1 や札筝純若鴻<ゃ (\f2.java\fP) 羝<Javadoc 若絎茵с障javadoc 罨< 2 ゃ<号у茵с障 1 ゃ\f2cd\fP 潟潟сc紊眼号 1 ゃ \f2.java\fP <ゃ吾鴻絎絎号с後障鴻憜c莎欠鴻障純若鴻<ゃ羝<\f2\-sourcepath\fP 激с潟∴障≪鴻帥鴻 (*) 潟潟茵ゃ若篏睡鴻違若絎с障
22.10467 +.LP
22.10468 +.RS 3
22.10469 +.TP 2
22.10470 +o
22.10471 +\f3宴若 1 \- 純若鴻c腱祉\fP \- \f2.java\fP <ゃc腱祉障罨<ャ<潟 1 や札筝純若鴻<ゃ絎 javadoc 絎茵障
22.10472 +.nf
22.10473 +\f3
22.10474 +.fl
22.10475 + % \fP\f3cd /home/src/java/awt\fP
22.10476 +.fl
22.10477 + % \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP
22.10478 +.fl
22.10479 +.fi
22.10480 +箴с \f2Button\fP \f2Canvas\fP喝 \f2Graphics\fP у障鴻ゃHTML 綵√ャ<潟障宴若後с純若鴻<ゃ javadoc 綣違羝<сャ<潟鴻鴻<ゃ潟若吾 2 ゃ若ゃ障
22.10481 +.TP 2
22.10482 +o
22.10483 +\f3宴若 2 \- 宴若吾若c腱祉\fP \- 若茲違泣宴若吾純若鴻<ゃャ<潟翫箴水с宴若吾若c腱祉純若鴻<ゃ若鴻絎障
22.10484 +.nf
22.10485 +\f3
22.10486 +.fl
22.10487 + % \fP\f3cd /home/src/\fP
22.10488 +.fl
22.10489 + % \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP
22.10490 +.fl
22.10491 +.fi
22.10492 +箴с\f2Button\fP 鴻 \f2Applet\fP 鴻ゃHTML 綵√ャ<潟障
22.10493 +.TP 2
22.10494 +o
22.10495 +\f3宴若 3 \- 篁紙c\fP \- 宴若鴻с憜cсc障障ャ<潟 \f2.java\fP <ゃ吾腟九障 (障憜c後障) 絎 javadoc 絎茵障
22.10496 +.nf
22.10497 +\f3
22.10498 +.fl
22.10499 + % \fP\f3javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java\fP
22.10500 +.fl
22.10501 +.fi
22.10502 +箴с \f2Button\fP \f2Graphics\fP у障鴻ゃHTML 綵√ャ<潟障
22.10503 +.RE
22.10504 +
22.10505 +.LP
22.10506 +.SS
22.10507 +宴若吾鴻ャ<潟
22.10508 +.LP
22.10509 +.LP
22.10510 +宴若後篏鴻絎ャ<潟с障罨<菴違 2 ゃ箴腟水箴腓冴障\f2\-sourcepath\fP 宴若吾吾鴻絲障篏睡с障鴻鴻絲障篏睡с障
22.10511 +.LP
22.10512 +.nf
22.10513 +\f3
22.10514 +.fl
22.10515 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java\fP
22.10516 +.fl
22.10517 +.fi
22.10518 +
22.10519 +.LP
22.10520 +.LP
22.10521 +箴с宴若 \f2java.awt\fP \f2Applet\fP ゃHTML 綵√ャ<潟障Javadoc 若\f2Applet\fP 宴若後\f2Applet.java\fP 純若鴻<ゃ宴若後h (絎h翫) ゅャ障
22.10522 +.LP
22.10523 +.SH "篏睡箴"
22.10524 +.LP
22.10525 +.LP
22.10526 +Javadoc 若紊箴水激с潟筝祉激с潟紫篏帥障х換篁Java 若 API 絲障 Javadoc 若絎茵篏睡絎潟潟сJava 2 Platform, Standard Edition, v1.2 絖膣 1500 public protected 鴻ゃャ<潟180M ゃ<≪若篏睡障
22.10527 +.LP
22.10528 +.LP
22.10529 +箴 2 イ莠障 箴潟潟茵絎茵с2 箴 Makefile 絎茵с激с潟綣違腟九障鴻篏睡篁紙c \f2javadoc\fP 潟潟絎茵с障
22.10530 +.LP
22.10531 +.SS
22.10532 +潟潟茵箴
22.10533 +.LP
22.10534 +.LP
22.10535 +罨<潟潟茵箴 900 絖莇DOS 激с紊с障狗帥潟潟茵綣違<ゃ篏睡障 障激с鴻荐菴違障
22.10536 +.LP
22.10537 +.nf
22.10538 +\f3
22.10539 +.fl
22.10540 +% javadoc \-sourcepath /java/jdk/src/share/classes \\
22.10541 +.fl
22.10542 + \-overview /java/jdk/src/share/classes/overview.html \\
22.10543 +.fl
22.10544 + \-d /java/jdk/build/api \\
22.10545 +.fl
22.10546 + \-use \\
22.10547 +.fl
22.10548 + \-splitIndex \\
22.10549 +.fl
22.10550 + \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
22.10551 +.fl
22.10552 + \-doctitle 'Java(TM) 2 Platform 5.0 API Specification' \\
22.10553 +.fl
22.10554 + \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
22.10555 +.fl
22.10556 + \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
22.10557 +.fl
22.10558 +a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
22.10559 +.fl
22.10560 +Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
22.10561 +.fl
22.10562 +901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
22.10563 +.fl
22.10564 + \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
22.10565 +.fl
22.10566 + \-group "Extension Packages" "javax.*" \\
22.10567 +.fl
22.10568 + \-J\-Xmx180m \\
22.10569 +.fl
22.10570 + @packages
22.10571 +.fl
22.10572 +\fP
22.10573 +.fi
22.10574 +
22.10575 +.LP
22.10576 +.LP
22.10577 +筝荐潟潟с\f2packages\fP 絲乗院宴若後 (\f2java.applet java.lang\fP ) ャc<ゃс激с潟筝綣膃у蚊障綣違眼壕絖水ャс障違箴潟種若鴻翫\f2\-bottom\fP 激с潟壕絖ゃ羈с
22.10578 +.LP
22.10579 +.SS
22.10580 +Makefile 箴
22.10581 +.LP
22.10582 +.LP
22.10583 +сGNU Makefile 箴腓冴障Windows Makefile 箴ゃ
22.10584 +.na
22.10585 +\f2Windows Makefile 篏号\fP @
22.10586 +.fi
22.10587 +http://java.sun.com/j2se/javadoc/faq/index.html#makefilesс
22.10588 +.LP
22.10589 +.nf
22.10590 +\f3
22.10591 +.fl
22.10592 +javadoc \-\fP\f3sourcepath\fP\f3 $(SRCDIR) \\ /* Sets path for source files */
22.10593 +.fl
22.10594 + \-\fP\f3overview\fP\f3 $(SRCDIR)/overview.html \\ /* Sets file for overview text */
22.10595 +.fl
22.10596 + \-\fP\f3d\fP\f3 /java/jdk/build/api \\ /* Sets destination directory */
22.10597 +.fl
22.10598 + \-\fP\f3use\fP\f3 \\ /* Adds "Use" files */
22.10599 +.fl
22.10600 + \-\fP\f3splitIndex\fP\f3 \\ /* Splits index A\-Z */
22.10601 +.fl
22.10602 + \-\fP\f3windowtitle\fP\f3 $(WINDOWTITLE) \\ /* Adds a window title */
22.10603 +.fl
22.10604 + \-\fP\f3doctitle\fP\f3 $(DOCTITLE) \\ /* Adds a doc title */
22.10605 +.fl
22.10606 + \-\fP\f3header\fP\f3 $(HEADER) \\ /* Adds running header text */
22.10607 +.fl
22.10608 + \-\fP\f3bottom\fP\f3 $(BOTTOM) \\ /* Adds text at bottom */
22.10609 +.fl
22.10610 + \-\fP\f3group\fP\f3 $(GROUPCORE) \\ /* 1st subhead on overview page */
22.10611 +.fl
22.10612 + \-\fP\f3group\fP\f3 $(GROUPEXT) \\ /* 2nd subhead on overview page */
22.10613 +.fl
22.10614 + \-\fP\f3J\fP\f3\-Xmx180m \\ /* Sets memory to 180MB */
22.10615 +.fl
22.10616 + java.lang java.lang.reflect \\ /* Sets packages to document */
22.10617 +.fl
22.10618 + java.util java.io java.net \\
22.10619 +.fl
22.10620 + java.applet
22.10621 +.fl
22.10622 +
22.10623 +.fl
22.10624 +WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
22.10625 +.fl
22.10626 +DOCTITLE = 'Java(TM) 2 Platform v1.2 API Specification'
22.10627 +.fl
22.10628 +HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
22.10629 +.fl
22.10630 +BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
22.10631 +.fl
22.10632 + a bug or feature</a><br><br>Java is a trademark or registered trademark
22.10633 +.fl
22.10634 + of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
22.10635 +.fl
22.10636 + Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
22.10637 +.fl
22.10638 + All Rights Reserved.</font>'
22.10639 +.fl
22.10640 +GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
22.10641 +.fl
22.10642 +GROUPEXT = '"Extension Packages" "javax.*"'
22.10643 +.fl
22.10644 +SRCDIR = '/java/jdk/1.2/src/share/classes'
22.10645 +.fl
22.10646 +\fP
22.10647 +.fi
22.10648 +
22.10649 +.LP
22.10650 +.LP
22.10651 +Makefile 綣違筝綣膃у蚊帥障
22.10652 +.LP
22.10653 +.LP
22.10654 +\f3羈\fP
22.10655 +.LP
22.10656 +.RS 3
22.10657 +.TP 2
22.10658 +o
22.10659 +\f2\-windowtitle\fP 激с潟ャJavadoc 若cャ<潟帥ゃc潟帥ゃ潟若障\f2\-windowtitle\fP 鴻堺 \f2\-doctitle\fP с HTML 帥違篏睡障 HTML 帥違c潟帥ゃ障障鴻茵腓冴障障
22.10660 +.TP 2
22.10661 +o
22.10662 +箴 \f2\-footer\fP 激с潟ャJavadoc 若c若鴻帥若潟若障
22.10663 +.TP 2
22.10664 +o
22.10665 +箴с綽荀障\-\f2classpath\fP \-\f2link\fP 荀激с潟с
22.10666 +.RE
22.10667 +
22.10668 +.LP
22.10669 +.SH "激ャ若c潟"
22.10670 +.LP
22.10671 +.SS
22.10672 +筝激ャ若c潟
22.10673 +.LP
22.10674 +.RS 3
22.10675 +.TP 2
22.10676 +o
22.10677 +\f3Javadoc FAQ\fP \- 筝違潟激ャ若c潟違潟
22.10678 +.na
22.10679 +\f2Javadoc FAQ\fP @
22.10680 +.fi
22.10681 +http://java.sun.com/j2se/javadoc/faq/index.html#B усс障
22.10682 +.TP 2
22.10683 +o
22.10684 +\f3違喝狗篋\fP \- 違筝Important Bug Fixes and Changes ссс障
22.10685 +.TP 2
22.10686 +o
22.10687 +\f3若吾с括\fP \- 若吾с括垩с
22.10688 +.TP 2
22.10689 +o
22.10690 +\f3鴻鴻ャ<潟\fP \- 宴若吾ャ<潟Javadoc 鴻劫ф<ゃ帥茯粋昭帥障違<ゃゃ潟\-сjavadoc <ゃ茹f蚊с障
22.10691 +.RE
22.10692 +
22.10693 +.LP
22.10694 +.SS
22.10695 +若茘
22.10696 +.LP
22.10697 +.LP
22.10698 +若活<祉若吾<ゃ絎h茵 (ャ<潟若激с潟潟<潟劫茵с) 茵垩障障
22.10699 +.LP
22.10700 +.RS 3
22.10701 +.TP 2
22.10702 +o
22.10703 +\f2"error:cannot read:Class1.java"\fP Javadoc 若潟c Class1.java 鴻若障腟九障鴻障後障鴻茵腓冴劫箴翫 \f2./Class1.java\fP с
22.10704 +.RE
22.10705 +
22.10706 +.LP
22.10707 +.SH "医"
22.10708 +.LP
22.10709 +.RS 3
22.10710 +.TP 3
22.10711 +CLASSPATH
22.10712 +Javadoc 若吟若鴻<ゃ「篏帥鴻絎医紊違с医紊違\f2\-classpath\fP 激с潟c若若ゃ障c罨<潟潟у阪障
22.10713 +.:/home/classes:/usr/local/java/classes
22.10714 +.RE
22.10715 +
22.10716 +.LP
22.10717 +.SH "∫i"
22.10718 +.LP
22.10719 +.RS 3
22.10720 +.TP 2
22.10721 +o
22.10722 +javac(1)
22.10723 +.TP 2
22.10724 +o
22.10725 +java(1)
22.10726 +.TP 2
22.10727 +o
22.10728 +jdb(1)
22.10729 +.TP 2
22.10730 +o
22.10731 +javah(1)
22.10732 +.TP 2
22.10733 +o
22.10734 +javap(1)
22.10735 +.TP 2
22.10736 +o
22.10737 +.na
22.10738 +\f2Javadoc 若若\fP @
22.10739 .fi
22.10740 http://java.sun.com/j2se/javadoc/index.jsp
22.10741 -の
22.10742 -.na
22.10743 -「\f2Javadoc Home Page\fP」
22.10744 .TP 2
22.10745 o
22.10746 +.na
22.10747 +\f2How to Write Doc Comments for Javadoc\fP @
22.10748 .fi
22.10749 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
22.10750 -の
22.10751 -.na
22.10752 -「\f2How to Write Doc Comments for Javadoc\fP」
22.10753 .TP 2
22.10754 o
22.10755 -クラスパスの設定
22.10756 +.na
22.10757 +\f2鴻鴻荐絎\fP @
22.10758 +.fi
22.10759 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
22.10760 .TP 2
22.10761 o
22.10762 -javac と javadoc がクラスを検索する方法 (tools.jar)
22.10763 +.na
22.10764 +\f2javac javadoc 鴻罎膣≪号\fP @
22.10765 +.fi
22.10766 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
22.10767 .RE
22.10768
22.10769 .LP
22.10770 .LP
22.10771 -Javadoc は、Sun Microsystems, Inc の商標です (\f2javadoc\fP コマンド自体には商標シンボルは不要)。
22.10772 +javadoc Sun Microsystems, Inc 罔с (\f2javadoc\fP 潟潟篏罔激潟筝荀)
23.1 --- a/src/linux/doc/man/ja/javah.1 Tue May 12 15:21:55 2009 +0900
23.2 +++ b/src/linux/doc/man/ja/javah.1 Thu May 14 00:17:25 2009 -0700
23.3 @@ -1,227 +1,160 @@
23.4 -'\" t
23.5 -.\"
23.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
23.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
23.8 -.\"
23.9 -.\" This code is free software; you can redistribute it and/or modify it
23.10 -.\" under the terms of the GNU General Public License version 2 only, as
23.11 -.\" published by the Free Software Foundation.
23.12 -.\"
23.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
23.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
23.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
23.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
23.17 -.\" accompanied this code).
23.18 -.\"
23.19 -.\" You should have received a copy of the GNU General Public License version
23.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
23.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
23.22 -.\"
23.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
23.25 -.\" have any questions.
23.26 -.\"
23.27 -.\"
23.28 -'\"macro stdmacro
23.29 -.TH javah 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
23.30 -.SH "名前"
23.31 -javah \- C 言語のヘッダとスタブファイルのジェネレータ
23.32 -.\"
23.33 -.\" This document was created by saving an HTML file as text
23.34 -.\" from the JavaSoft web site:
23.35 -.\"
23.36 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
23.37 -.\"
23.38 -.\" and adding appropriate troff macros. Because the JavaSoft web site
23.39 -.\" man pages can change without notice, it may be helpful to diff
23.40 -.\" files to identify changes other than new functionality.
23.41 -.\"
23.42 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
23.43 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
23.44 +."
23.45 +." This code is free software; you can redistribute it and/or modify it
23.46 +." under the terms of the GNU General Public License version 2 only, as
23.47 +." published by the Free Software Foundation.
23.48 +."
23.49 +." This code is distributed in the hope that it will be useful, but WITHOUT
23.50 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
23.51 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
23.52 +." version 2 for more details (a copy is included in the LICENSE file that
23.53 +." accompanied this code).
23.54 +."
23.55 +." You should have received a copy of the GNU General Public License version
23.56 +." 2 along with this work; if not, write to the Free Software Foundation,
23.57 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
23.58 +."
23.59 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23.60 +." CA 95054 USA or visit www.sun.com if you need additional information or
23.61 +." have any questions.
23.62 +."
23.63 +.TH javah 1 "04 May 2009"
23.64 +." Generated from HTML by html2man (author: Eric Armstrong)
23.65 +
23.66 +.LP
23.67 +.SH ""
23.68 +javah \- C 若鴻帥<ゃ吾с若
23.69 +.LP
23.70 +.RS 3
23.71 +
23.72 +.LP
23.73 +.LP
23.74 +\f3javah\fP Java 鴻 C 若<ゃ C 純若鴻<ゃ篏障<ゃJava 違潟域茯ф吾潟若C 篁荐茯ф吾潟若・膓潟若娯篏障
23.75 +.LP
23.76 +.RE
23.77 +.SH "綵√"
23.78 .LP
23.79
23.80 .LP
23.81 +.nf
23.82 +\f3
23.83 +.fl
23.84 +javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
23.85 +.fl
23.86 +javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
23.87 +.fl
23.88 +\fP
23.89 +.fi
23.90 +
23.91 .LP
23.92 -\f3javah\fP は、Java クラスから C ヘッダファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
23.93 -.LP
23.94 -.SH "形式"
23.95 -.B javah
23.96 -[
23.97 -.B options
23.98 -]
23.99 -.I fully-qualified-classname . . .
23.100 -.br
23.101 -.B javah_g
23.102 -[
23.103 -.B options
23.104 -]
23.105 -.I fully-qualified-classname . . .
23.106 -.SH "機能説明"
23.107 -.IX "stub file generator" "" "stub file generator \(em \fLjavah\fP"
23.108 -.IX "C header and stub file generator" "" "C header and stub file generator \(em \fLjavah\fP"
23.109 -.IX "javah" "" "\fLjavah\fP \(em C header and stub file generator"
23.110 -.B javah
23.111 -コマンドは、ネイティブメソッドを実装するのに必要な
23.112 -C
23.113 -言語のヘッダおよびソースファイルを生成します。
23.114 -C
23.115 -のプログラムは、
23.116 -生成されたヘッダとソースファイルを使って、
23.117 -ネイティブソースコードからオブジェクトのインスタンス
23.118 -変数を参照できます。
23.119 -.B .h
23.120 -ファイルは、対応するクラスに合ったレイアウトの
23.121 -構造体定義を含んでいます。
23.122 -構造体に含まれるフィールドは、クラス内のインスタンス変数に
23.123 -対応しています。
23.124 -.LP
23.125 -ヘッダファイル名およびヘッダファイル中で定義される構造体名は、
23.126 -クラス名から派生します。
23.127 -.B javah
23.128 -に渡されるクラスがパッケージ内部にあれば、
23.129 -そのパッケージ名がファイル名および構造体名の先頭に付加されます。
23.130 -名前の間は下線
23.131 -(_)
23.132 -で区切られます。
23.133 -.LP
23.134 -デフォルトでは、
23.135 -.B javah
23.136 -はコマンド行で指定された個々のクラスに対して
23.137 -ヘッダファイルを作成し、現在のディレクトリに出力します。
23.138 -.B \-stubs
23.139 -オプションを指定するとソースファイルが生成されます。
23.140 -.B \-o
23.141 -オプションを指定すると、指定した全クラスに対する出力ファイル
23.142 -を連結して
23.143 -1
23.144 -個のファイルとして生成します。
23.145 -.LP
23.146 -新しいネイティブメソッドインタフェースの
23.147 -Java Native Interface (JNI)
23.148 -は、ヘッダ情報やスタブファイルを必要としません。
23.149 -ただし
23.150 -.B javah
23.151 -コマンドは現在も JNI 形式のネイティブメソッドに必要な
23.152 -ネイティブメソッド関数プロトタイプを生成できます。
23.153 -.B javah
23.154 -はデフォルトで JNI 形式で出力し、その結果を
23.155 -.B .h
23.156 -ファイルに格納します。
23.157 -.LP
23.158 -.B javah_g
23.159 -は非最適化バージョンの
23.160 -.B javah
23.161 -で、
23.162 -.B jdb
23.163 -などのデバッガ用の使用に適しています。
23.164 -.SH "オプション"
23.165 -.TP 15
23.166 -.BI \-o " outputfile"
23.167 -コマンド行で指定したすべてのクラスに対する結果のヘッダファイルまたは
23.168 -ソースファイルを連結し、
23.169 -.BR outputfile
23.170 -に格納します。
23.171 -.B \-o
23.172 -オプションまたは
23.173 -.B \-d
23.174 -オプションだけを使用できます。
23.175 -.TP 15
23.176 -.BI \-d " directory"
23.177 -.B javah
23.178 -がヘッダファイルまたはスタブファイルを書き出す
23.179 -ディレクトリを指定します。
23.180 -.TP 15
23.181 -.B \-stubs
23.182 -Java オブジェクトファイルから C 言語の宣言を生成します。
23.183 -.TP 15
23.184 -.B \-verbose
23.185 -詳細情報の出力を要求します。
23.186 -.B javah
23.187 -は、生成されたファイルの状態に関するメッセージを
23.188 -.B stdout
23.189 -に書き出します。
23.190 -.TP 15
23.191 -.B \-help
23.192 -.B javah
23.193 -の使用法についてヘルプメッセージを出力します。
23.194 -.TP 15
23.195 -.B \-version
23.196 -javah バージョン情報を出力します。
23.197 -.TP 15
23.198 -.B \-jni
23.199 -JNI 形式のネイティブなメソッド関数のプロトタイプが入った出力ファイルを
23.200 -作成します。これはデフォルトの出力であるため、
23.201 --B \-jni
23.202 -は省略可能です。
23.203 -.TP 15
23.204 -.BI \-classpath " path"
23.205 -.B javah
23.206 -がクラスを検索するために用いるパスを
23.207 -.I path
23.208 -で指定します。この指定値は、デフォルトおよび
23.209 -.B CLASSPATH
23.210 -環境変数の設定値をオーバーライドします。
23.211 -複数のディレクトリを指定する場合はコロンで区切ります。
23.212 -したがって
23.213 -.I path
23.214 -の通常の形式は次のようになります。
23.215 -.RS 20
23.216 -.sp 1n
23.217 -.LP
23.218 -.BI .:< your_path >
23.219 -.sp 1n
23.220 -.RE
23.221 -.RS 15
23.222 -.LP
23.223 -パスの指定例:
23.224 -.RE
23.225 -.RS 20
23.226 -.sp 1n
23.227 -.LP
23.228 -.B .:/home/avh/classes:/usr/local/java/classes
23.229 -.sp 1n
23.230 -.RE
23.231 -.LP
23.232 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
23.233 -.br
23.234 -.br
23.235 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しなどの環境に対する問い合わせを行わない限り、展開されていないワイルドカードを Java プログラムは認識しません。
23.236 -.TP 15
23.237 -.BI \-bootclasspath " path"
23.238 -bootstrap クラスをロードするパスを指定します。デフォルトでは、bootstrap
23.239 -クラスはコアとなる Java 2 プラットフォームを実装するクラスで、
23.240 -.B jre/lib/rt.jar
23.241 -および他の重要な jar ファイルに含まれています。
23.242 -.TP 15
23.243 -.B \-old
23.244 -古い JDK 1.0 形式のヘッダファイルを生成します。
23.245 -.TP 15
23.246 -.B \-force
23.247 -常に出力ファイルに書き込むことを指定します。
23.248 -.TP 15
23.249 -.BI \-J "option"
23.250 -.I option
23.251 -を Java 仮想マシンに渡します。ここで、
23.252 -.I option
23.253 -は、Java アプリケーション起動プログラムの参照ページで
23.254 -説明されているオプションの 1 つです。たとえば、
23.255 -.I \-J-Xms48m
23.256 -は、起動時に使用するメモリを 48M バイトに設定します。
23.257 -.SH "環境変数"
23.258 -.TP 15
23.259 -.B CLASSPATH
23.260 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
23.261 -複数のディレクトリを指定する場合はコロンで区切ります。
23.262 -以下に例を示します。
23.263 -.RS 10
23.264 -.sp 1n
23.265 -.LP
23.266 -.B .:/home/avh/classes:/usr/local/java/classes
23.267 -.RE
23.268 -.SH "関連項目"
23.269 +.SH "茯"
23.270 .LP
23.271
23.272 .LP
23.273 .LP
23.274 -javac、java、jdb、javap、javadoc
23.275 +\f3javah\fP ゃc<純絎茖綽荀 C 若純若鴻<ゃ障篏若純若鴻<ゃゃc純若鴻潟若吾сゃ潟鴻帥潟劫違с C 違c篏睡障.h <ゃ絲上鴻筝眼臀ゆ篏絎臂帥障罕篏c若鴻ゃ潟鴻帥潟劫違絲上障
23.276 +.LP
23.277 +.LP
23.278 +若<ゃ筝уh罕篏鴻羇丞障\f3javah\fP 羝<鴻宴若吾筝翫宴若後若<ゃ罕篏筝≧鴻篁障筝膩 (_) 阪絖篏睡障
23.279 +.LP
23.280 +.LP
23.281 +с \f3javah\fP 潟潟茵鴻鴻若<ゃ篏憜c<ゃ臀障純若鴻<ゃ篏\f2\-stubs\fP 激с潟篏睡1 ゃ<ゃ筝鴻鴻鴻腟g\f2\-o\fP 激с潟篏睡
23.282 +.LP
23.283 +.LP
23.284 +違ゃc<純ゃ潟帥с若鴻с Java Native Interface (JNI) 惹宴障鴻帥<ゃ綽荀障 憜с\f3javah\fP JNI 綵√ゃc<純綽荀ゃc<純罘純帥ゃ障 с\f3javah\fP JNI 綵√у阪腟 .h <ゃ主障
23.285 +.LP
23.286 +.LP
23.287 +\f3javah_g\fP jdb(1) \f3javah\fP 若吾с潟с
23.288 +.LP
23.289 +.SH "激с"
23.290 +.LP
23.291 +
23.292 +.LP
23.293 +.RS 3
23.294 +.TP 3
23.295 +\-o outputfile
23.296 +潟潟茵鴻鴻鴻絲障腟若障純若鴻<ゃg \f2outputfile\fP 主障\f3\-o\fP 障 \f3\-d\fP <筝鴻篏帥障
23.297 +.TP 3
23.298 +\-d directory
23.299 +\f3javah\fP 若<ゃ障鴻帥<ゃ篆絖c荐絎障\f3\-d\fP 障 \f3\-o\fP <筝鴻篏帥障
23.300 +.TP 3
23.301 +\-stubs
23.302 +\f3javah\fP Java 吾с<ゃ C 絎h障
23.303 +.TP 3
23.304 +\-verbose
23.305 +荅括完阪絎篏<ゃ倶≪<祉若吾\f3javah\fP 罔羣阪阪障
23.306 +.TP 3
23.307 +\-help
23.308 +\f3javah\fP 篏睡羈ゃ<祉若吾阪障
23.309 +.TP 3
23.310 +\-version
23.311 +\f3javah\fP 若吾с恰宴阪障
23.312 +.TP 3
23.313 +\-jni
23.314 +JNI 綵√ゃc<ゃ罘純帥ゃ阪<ゃ\f3javah\fP 篏障罔羣阪с\f3\-jni\fP 篏睡激с潟с
23.315 +.TP 3
23.316 +\-classpath path
23.317 +鴻「 \f3javah\fP 篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
23.318 +.nf
23.319 +\f3
23.320 +.fl
23.321 + .:<your_path>
23.322 +.fl
23.323 +\fP
23.324 +.fi
23.325 +箴腓冴障
23.326 +.nf
23.327 +\f3
23.328 +.fl
23.329 + .:/home/avh/classes:/usr/local/java/classes
23.330 +.fl
23.331 +\fP
23.332 +.fi
23.333 +.LP
23.334 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
23.335 +.br
23.336 +.br
23.337 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
23.338 +.TP 3
23.339 +\-bootclasspath path
23.340 +若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR <ゃ 潟 Java 2 若絎茖鴻с
23.341 +.TP 3
23.342 +\-old
23.343 +ゃ JDK1.0 綵√若<ゃ絎障
23.344 +.TP 3
23.345 +\-force
23.346 +阪<ゃ絽吾吾莨若障絎障
23.347 +.TP 3
23.348 +\-Joption
23.349 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
23.350 +.RE
23.351 +
23.352 +.LP
23.353 +.SH "医紊"
23.354 +.LP
23.355 +
23.356 +.LP
23.357 +.RS 3
23.358 +.TP 3
23.359 +CLASSPATH
23.360 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障
23.361 +.nf
23.362 +\f3
23.363 +.fl
23.364 +.:/home/avh/classes:/usr/local/java/classes
23.365 +.fl
23.366 +\fP
23.367 +.fi
23.368 +.RE
23.369 +
23.370 +.LP
23.371 +.SH "∫i"
23.372 +.LP
23.373 +
23.374 +.LP
23.375 +.LP
23.376 +javac(1)java(1)jdb(1)javap(1)javadoc(1)
23.377 .LP
23.378
23.379 .LP
24.1 --- a/src/linux/doc/man/ja/javap.1 Tue May 12 15:21:55 2009 +0900
24.2 +++ b/src/linux/doc/man/ja/javap.1 Thu May 14 00:17:25 2009 -0700
24.3 @@ -1,117 +1,137 @@
24.4 -'\" t
24.5 -.\"
24.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
24.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
24.8 -.\"
24.9 -.\" This code is free software; you can redistribute it and/or modify it
24.10 -.\" under the terms of the GNU General Public License version 2 only, as
24.11 -.\" published by the Free Software Foundation.
24.12 -.\"
24.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
24.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
24.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
24.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
24.17 -.\" accompanied this code).
24.18 -.\"
24.19 -.\" You should have received a copy of the GNU General Public License version
24.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
24.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24.22 -.\"
24.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
24.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
24.25 -.\" have any questions.
24.26 -.\"
24.27 -.\"
24.28 -'\"macro stdmacro
24.29 -.TH javap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
24.30 -.SH "名前"
24.31 -javap \- Java クラスファイル逆アセンブラ
24.32 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
24.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
24.34 +."
24.35 +." This code is free software; you can redistribute it and/or modify it
24.36 +." under the terms of the GNU General Public License version 2 only, as
24.37 +." published by the Free Software Foundation.
24.38 +."
24.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
24.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
24.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
24.42 +." version 2 for more details (a copy is included in the LICENSE file that
24.43 +." accompanied this code).
24.44 +."
24.45 +." You should have received a copy of the GNU General Public License version
24.46 +." 2 along with this work; if not, write to the Free Software Foundation,
24.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24.48 +."
24.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
24.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
24.51 +." have any questions.
24.52 +."
24.53 +.TH javap 1 "04 May 2009"
24.54 +." Generated from HTML by html2man (author: Eric Armstrong)
24.55 +
24.56 +.LP
24.57 +.SH ""
24.58 +javap \- Java 鴻<ゃ≪祉潟
24.59 +.LP
24.60 +.RS 3
24.61 +
24.62 +.LP
24.63 +.LP
24.64 +鴻<ゃ≪祉潟障
24.65 +.LP
24.66 +.RE
24.67 +.SH "綵√"
24.68 .LP
24.69
24.70 .LP
24.71 -.LP
24.72 -クラスファイルを逆アセンブルします。
24.73 -.LP
24.74 -.\"
24.75 -.\" This document was created by saving an HTML file as text
24.76 -.\" from the JavaSoft web site:
24.77 -.\"
24.78 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
24.79 -.\"
24.80 -.\" and adding appropriate troff macros. Because the JavaSoft web site
24.81 -.\" man pages can change without notice, it may be helpful to diff
24.82 -.\" files to identify changes other than new functionality.
24.83 -.\"
24.84 -.SH "形式"
24.85 -.B javap
24.86 -[
24.87 -.B options
24.88 -]
24.89 -.IR class .\|.\|.
24.90 -.SH "機能説明"
24.91 -.IX "Java class file disassembler" "" "Java class file disassembler \(em \fLjavap\fP"
24.92 -.IX "javap" "" "\fLjavap\fP \(em Java class file disassembler"
24.93 -.B javap
24.94 -コマンドは、
24.95 -Java クラスファイルを逆アセンブルします。
24.96 -出力内容はオプションで指定します。
24.97 -オプションを
24.98 -1
24.99 -つも指定しないと、
24.100 -.B javap
24.101 -は渡されたクラスの
24.102 -.BR package、
24.103 -.BR protected、
24.104 -および
24.105 -.B public
24.106 -フィールドとメソッドを出力します。
24.107 -.B javap
24.108 -コマンドの出力先は
24.109 -.B stdout
24.110 -です。たとえば、以下のクラス宣言をコンパイルします。
24.111 -.RS
24.112 .nf
24.113 \f3
24.114 +.fl
24.115 +javap [ \fP\f3options\fP\f3 ] class. . .
24.116 +.fl
24.117 +\fP
24.118 +.fi
24.119 +
24.120 +.LP
24.121 +.SH "茯"
24.122 +.LP
24.123 +
24.124 +.LP
24.125 +.LP
24.126 +\f3javap\fP 潟潟鴻<ゃ≪祉潟障阪絎激с潟違障激с潟絎翫\f3javap\fP 宴若吾羝<鴻 protected public c若<純阪障 \f3javap\fP 阪罔羣阪茵腓冴障違罨<劫h潟潟ゃ障
24.127 +.LP
24.128 +.RS 3
24.129 +
24.130 +.LP
24.131 +.nf
24.132 +\f3
24.133 +.fl
24.134 import java.awt.*;
24.135 +.fl
24.136 import java.applet.*;
24.137 +.fl
24.138
24.139 +.fl
24.140 public class DocFooter extends Applet {
24.141 - String date;
24.142 - String email;
24.143 +.fl
24.144 + String date;
24.145 +.fl
24.146 + String email;
24.147 +.fl
24.148
24.149 - public void init() {
24.150 - resize(500,100);
24.151 - date = getParameter("LAST_UPDATED");
24.152 - email = getParameter("EMAIL");
24.153 - }
24.154 +.fl
24.155 + public void init() {
24.156 +.fl
24.157 + resize(500,100);
24.158 +.fl
24.159 + date = getParameter("LAST_UPDATED");
24.160 +.fl
24.161 + email = getParameter("EMAIL");
24.162 +.fl
24.163 + }
24.164 +.fl
24.165
24.166 - public void paint(Graphics g) {
24.167 - g.drawString(date + " by ",100, 15);
24.168 - g.drawString(email,290,15);
24.169 - }
24.170 +.fl
24.171 + public void paint(Graphics g) {
24.172 +.fl
24.173 + g.drawString(date + " by ",100, 15);
24.174 +.fl
24.175 + g.drawString(email,290,15);
24.176 +.fl
24.177 + }
24.178 +.fl
24.179 }
24.180 -\f1
24.181 +.fl
24.182 +\fP
24.183 .fi
24.184 .RE
24.185 +
24.186 .LP
24.187 -この場合、
24.188 -.B javap DocFooter
24.189 -を実行すると以下の出力が得られます。
24.190 -.RS
24.191 +.LP
24.192 +\f3javap DocFooter\fP 阪罨<障
24.193 +.LP
24.194 +.RS 3
24.195 +
24.196 +.LP
24.197 +.nf
24.198 \f3
24.199 -.nf
24.200 +.fl
24.201 Compiled from DocFooter.java
24.202 +.fl
24.203 public class DocFooter extends java.applet.Applet {
24.204 - java.lang.String date;
24.205 - java.lang.String email;
24.206 - public void init();
24.207 - public void paint(java.awt.Graphics);
24.208 - public DocFooter();
24.209 +.fl
24.210 + java.lang.String date;
24.211 +.fl
24.212 + java.lang.String email;
24.213 +.fl
24.214 + public DocFooter();
24.215 +.fl
24.216 + public void init();
24.217 +.fl
24.218 + public void paint(java.awt.Graphics);
24.219 +.fl
24.220 }
24.221 -\f1
24.222 +.fl
24.223 +\fP
24.224 .fi
24.225 +.RE
24.226 +
24.227 .LP
24.228 -\f3javap \-c DocFooter\fP を実行すると以下の出力が得られます。
24.229 +.LP
24.230 +\f3javap \-c DocFooter\fP 阪罨<障
24.231 .LP
24.232 .RS 3
24.233
24.234 @@ -228,34 +248,35 @@
24.235 .RE
24.236
24.237 .LP
24.238 -.SH "オプション"
24.239 +.SH "激с"
24.240 .LP
24.241
24.242 .LP
24.243 +.RS 3
24.244 .TP 3
24.245 \-help
24.246 -\f3javap\fP のヘルプメッセージを出力します。
24.247 +\f3javap\fP <祉若吾阪障
24.248 .TP 3
24.249 \-l
24.250 -行番号と局所変数テーブルを表示します。
24.251 +茵垩絮紊違若茵腓冴障
24.252 .TP 3
24.253 \-b
24.254 -JDK 1.1 の \f3javap\fP との下位互換性を保証します。
24.255 +JDK 1.1 \f3javap\fP 筝篏篋с篆荐若障
24.256 .TP 3
24.257 \-public
24.258 -public クラスおよびメンバだけを表示します。
24.259 +public 鴻潟<潟若茵腓冴障
24.260 .TP 3
24.261 \-protected
24.262 -protected および public のクラスとメンバだけを表示します。
24.263 +protected public 鴻<潟若茵腓冴障
24.264 .TP 3
24.265 \-package
24.266 -package、protected、および public のクラスとメンバだけを表示します。これはデフォルトの設定です。
24.267 +packageprotected public 鴻<潟若茵腓冴障荐絎с
24.268 .TP 3
24.269 \-private
24.270 -すべてのクラスとメンバを表示します。
24.271 +鴻鴻<潟若茵腓冴障
24.272 .TP 3
24.273 \-Jflag
24.274 -ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
24.275 +潟帥ゃ激鴻贋・ \f2flag\fP 羝<障篏睡箴罨<腓冴障
24.276 .RS 3
24.277
24.278 .LP
24.279 @@ -271,21 +292,20 @@
24.280 .RE
24.281 .TP 3
24.282 \-s
24.283 -内部の型シグニチャーを出力します。
24.284 +激違c若阪障
24.285 .TP 3
24.286 \-c
24.287 -クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
24.288 +鴻<純≪祉潟潟若 Java ゃ潟若巡擦茵腓冴障
24.289 +.na
24.290 +\f2Java Virtual Machine Specification\fP @
24.291 .fi
24.292 -http://java.sun.com/docs/books/vmspec/
24.293 -の
24.294 -.na
24.295 -「\f2Java Virtual Machine Specification\fP」にドキュメント化されています。
24.296 +http://java.sun.com/docs/books/vmspec/ャ<潟障
24.297 .TP 3
24.298 \-verbose
24.299 -メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
24.300 +<純鴻帥泣ゃ冴 \f2locals\fP \f2args\fP 違阪障
24.301 .TP 3
24.302 \-classpath path
24.303 -\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
24.304 +\f3javap\fP 鴻「篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
24.305 .nf
24.306 \f3
24.307 .fl
24.308 @@ -293,7 +313,7 @@
24.309 .fl
24.310 \fP
24.311 .fi
24.312 -次に例を示します。
24.313 +箴腓冴障
24.314 .nf
24.315 \f3
24.316 .fl
24.317 @@ -303,27 +323,41 @@
24.318 .fi
24.319 .TP 3
24.320 \-bootclasspath path
24.321 -ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java プラットフォームを実装するクラスです。
24.322 +若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR <ゃ 潟 Java 2 若絎茖鴻с
24.323 .TP 3
24.324 \-extdirs dirs
24.325 -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
24.326 +ゃ潟鴻若≦宍罘純罎膣≪贋若若ゃ障The default location for extensions is the value of \f2java.ext.dirs\fP.
24.327 +.RE
24.328 +
24.329 .LP
24.330 -.SH "環境変数"
24.331 -.TP 15
24.332 -.B CLASSPATH
24.333 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
24.334 -複数のディレクトリを指定する場合はコロンで区切ります。
24.335 -以下に例を示します。
24.336 -.sp 1n
24.337 -.RS 10
24.338 -.B .:/home/avh/classes:/usr/local/java/classes
24.339 -.RE
24.340 -.SH "関連項目"
24.341 +.SH "医紊"
24.342 .LP
24.343
24.344 .LP
24.345 +.RS 3
24.346 +.TP 3
24.347 +CLASSPATH
24.348 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障 罨<箴腓冴障
24.349 +.RS 3
24.350 +
24.351 .LP
24.352 -javac、java、jdb、javah、javadoc
24.353 +.nf
24.354 +\f3
24.355 +.fl
24.356 +.:/home/avh/classes:/usr/local/java/classes
24.357 +.fl
24.358 +\fP
24.359 +.fi
24.360 +.RE
24.361 +.RE
24.362 +
24.363 +.LP
24.364 +.SH "∫i"
24.365 +.LP
24.366 +
24.367 +.LP
24.368 +.LP
24.369 +javac(1) java(1)jdb(1)javah(1)javadoc(1)
24.370 .LP
24.371
24.372 .LP
25.1 --- a/src/linux/doc/man/ja/javaws.1 Tue May 12 15:21:55 2009 +0900
25.2 +++ b/src/linux/doc/man/ja/javaws.1 Thu May 14 00:17:25 2009 -0700
25.3 @@ -1,31 +1,51 @@
25.4 -'\" t
25.5 -.\"
25.6 -.\" Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
25.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
25.8 -.\"
25.9 -.\" This code is free software; you can redistribute it and/or modify it
25.10 -.\" under the terms of the GNU General Public License version 2 only, as
25.11 -.\" published by the Free Software Foundation.
25.12 -.\"
25.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
25.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
25.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
25.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
25.17 -.\" accompanied this code).
25.18 -.\"
25.19 -.\" You should have received a copy of the GNU General Public License version
25.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
25.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
25.22 -.\"
25.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
25.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
25.25 -.\" have any questions.
25.26 -.\"
25.27 -.TH javaws 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
25.28 -.SH 名前
25.29 -\fBjavaws \fP- Java Web Start 起動コマンド
25.30 -\fB
25.31 -.SH 形式
25.32 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
25.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
25.34 +."
25.35 +." This code is free software; you can redistribute it and/or modify it
25.36 +." under the terms of the GNU General Public License version 2 only, as
25.37 +." published by the Free Software Foundation.
25.38 +."
25.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
25.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
25.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
25.42 +." version 2 for more details (a copy is included in the LICENSE file that
25.43 +." accompanied this code).
25.44 +."
25.45 +." You should have received a copy of the GNU General Public License version
25.46 +." 2 along with this work; if not, write to the Free Software Foundation,
25.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
25.48 +."
25.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
25.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
25.51 +." have any questions.
25.52 +."
25.53 +.TH javaws 1 "04 May 2009"
25.54 +." Generated from HTML by html2man (author: Eric Armstrong)
25.55 +
25.56 +.LP
25.57 +
25.58 +.LP
25.59 +.SH ""
25.60 +\f2javaws\fP 潟潟茵
25.61 +.LP
25.62 +
25.63 +.LP
25.64 +.LP
25.65 +\
25.66 +.LP
25.67 +.SS
25.68 +NAME
25.69 +.LP
25.70 +.RS 3
25.71 +
25.72 +.LP
25.73 +.LP
25.74 +\f2javaws\fP \- Java Web Start 莎桁潟潟
25.75 +.LP
25.76 +.RE
25.77 +.SS
25.78 +綵√
25.79 +.LP
25.80 .RS 3
25.81
25.82 .LP
25.83 @@ -36,21 +56,20 @@
25.84 \f2javaws [control\-options]\fP
25.85 .LP
25.86 .RE
25.87 -.SS
25.88 -パラメータ
25.89 +.SS
25.90 +<若
25.91 .LP
25.92 .RS 3
25.93
25.94 .LP
25.95 .LP
25.96 -[run\-options]
25.97 +\f2[run\-options]\fP
25.98 .LP
25.99 .RS 3
25.100
25.101 .LP
25.102 .LP
25.103 -コマンド行実行オプション。
25.104 -実行オプションの順序は任意です。個々の実行オプションについては、後述の「実行オプション」節を参照してください。
25.105 +潟潟茵絎茵激с潟 絎茵激с潟篁紙綺ф絎с障腮激с潟ゃ筝 絎茵激с潟с
25.106 .LP
25.107 .RE
25.108 .LP
25.109 @@ -60,7 +79,7 @@
25.110
25.111 .LP
25.112 .LP
25.113 -パスまたは JNLP (Java Network Launching Protocol) ファイルの URL (Uniform Resource Locater) を指定できます。
25.114 +JNLP (Java Network Launching Protocol) <ゃ鴻障 URL (Uniform Resource Locator) <с
25.115 .LP
25.116 .RE
25.117 .LP
25.118 @@ -70,28 +89,28 @@
25.119
25.120 .LP
25.121 .LP
25.122 -コマンド行制御オプション。制御オプションの順序は任意です。個々の制御オプションについては、後述の「制御オプション」節を参照してください。
25.123 +潟潟茵九勝激с潟 九勝激с潟篁紙綺ф絎с障腮激с潟ゃ筝 九勝激с潟с
25.124 .LP
25.125 .RE
25.126 .RE
25.127 -.SS
25.128 -機能説明
25.129 +.SS
25.130 +茯
25.131 .LP
25.132 .RS 3
25.133
25.134 .LP
25.135 .LP
25.136 -\fBjavaws\fP コマンドにより JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動できます。Java Web Start はネットワーク上に置かれる Java アプリケーションまたはアプレットを起動します。
25.137 +\f2javaws\fP 潟潟JNLP (Java Network Launching Protocol) <潟劫茖с Java Web Start 莎桁障Java Web Start 若筝у篏 Java ≪宴若激с潟障≪莎桁障
25.138 .LP
25.139 .LP
25.140 -JNLP ファイルを指定すると、\fBjavaws\fP は JNLP ファイルに指定されている Java アプリケーションまたはアプレットを起動します。
25.141 +JNLP <ゃ絎\f2javaws\fP JNLP <ゃ絎 Java ≪宴若激с潟障≪莎桁障
25.142 .LP
25.143 .LP
25.144 -現在のリリースでサポートされている \f2javaws\fP 起動ツールの一連のオプションは、将来のリリースで削除される可能性があります。
25.145 +\f2javaws\fP 莎桁若憜若鴻с泣若 1 腟激с潟障激с潟絨ャ若鴻сゃ醇с障
25.146 .LP
25.147 .RE
25.148 -.SS
25.149 -実行オプション
25.150 +.SS
25.151 +絎茵激с
25.152 .LP
25.153 .RS 3
25.154
25.155 @@ -103,7 +122,7 @@
25.156
25.157 .LP
25.158 .LP
25.159 -Java Web Start をオフラインモードで実行します。
25.160 +Java Web Start ゃ潟≪若у茵障
25.161 .LP
25.162 .RE
25.163 .LP
25.164 @@ -113,7 +132,7 @@
25.165
25.166 .LP
25.167 .LP
25.168 -初期スプラッシュ画面の表示を無効にします。
25.169 +鴻激ョ脂≪茵腓冴≦鴻障
25.170 .LP
25.171 .RE
25.172 .LP
25.173 @@ -123,8 +142,7 @@
25.174
25.175 .LP
25.176 .LP
25.177 -jnlp ファイルの引数を \f2\-open <arguments> と置き換えます。
25.178 -\fP.
25.179 +激с潟絎JNLP <ゃ綣違 \f2\-open <arguments>\fP 臀障
25.180 .LP
25.181 .RE
25.182 .LP
25.183 @@ -134,7 +152,7 @@
25.184
25.185 .LP
25.186 .LP
25.187 -jnlp ファイルの引数を \f2\-print <arguments>\fP と置き換えます。
25.188 +激с潟絎JNLP <ゃ綣違 \f2\-print <arguments>\fP 臀障
25.189 .LP
25.190 .RE
25.191 .LP
25.192 @@ -144,7 +162,7 @@
25.193
25.194 .LP
25.195 .LP
25.196 -オンラインモードで実行します (デフォルトの動作)。
25.197 +潟ゃ潟≪若у茵障 (篏)
25.198 .LP
25.199 .RE
25.200 .LP
25.201 @@ -154,7 +172,7 @@
25.202
25.203 .LP
25.204 .LP
25.205 -アプリケーションが終了するまで \f2javaws\fP プロセスは終了しません。
25.206 +激с潟絎≪宴若激с潟腟篋障 \f2javaws\fP 祉鴻腟篋障
25.207 .LP
25.208 .RE
25.209 .LP
25.210 @@ -164,7 +182,7 @@
25.211
25.212 .LP
25.213 .LP
25.214 -追加の出力を表示します。
25.215 +菴遵阪茵腓冴障
25.216 .LP
25.217 .RE
25.218 .LP
25.219 @@ -174,7 +192,7 @@
25.220
25.221 .LP
25.222 .LP
25.223 -vm にオプションを補います。
25.224 +vm 激с潟茖障
25.225 .LP
25.226 .RE
25.227 .LP
25.228 @@ -184,12 +202,12 @@
25.229
25.230 .LP
25.231 .LP
25.232 -アプリケーションをシステムキャッシュからのみ実行します。
25.233 +≪宴若激с潟激鴻c激ャ水茵障
25.234 .LP
25.235 .RE
25.236 .RE
25.237 -.SS
25.238 -制御オプション
25.239 +.SS
25.240 +九勝激с
25.241 .LP
25.242 .RS 3
25.243
25.244 @@ -201,7 +219,7 @@
25.245
25.246 .LP
25.247 .LP
25.248 -Java コントロールパネルでキャッシュビューアを表示します。
25.249 +Java 潟潟若сc激ャャ若≪茵腓冴障
25.250 .LP
25.251 .RE
25.252 .LP
25.253 @@ -211,7 +229,7 @@
25.254
25.255 .LP
25.256 .LP
25.257 -指定された配備プロパティをクリアします。
25.258 +絎c若≪障
25.259 .LP
25.260 .RE
25.261 .LP
25.262 @@ -221,7 +239,7 @@
25.263
25.264 .LP
25.265 .LP
25.266 -指定された配備プロパティを指定された値に設定します。
25.267 +絎c若絎ゃ荐絎障
25.268 .LP
25.269 .RE
25.270 .LP
25.271 @@ -231,7 +249,7 @@
25.272
25.273 .LP
25.274 .LP
25.275 -キャッシュからすべてのアプリケーションを削除します。
25.276 +c激ャ鴻≪宴若激с潟ゃ障
25.277 .LP
25.278 .RE
25.279 .LP
25.280 @@ -241,7 +259,7 @@
25.281
25.282 .LP
25.283 .LP
25.284 -キャッシュからアプリケーションを削除します。
25.285 +c激ャ≪宴若激с潟ゃ障
25.286 .LP
25.287 .RE
25.288 .LP
25.289 @@ -251,10 +269,10 @@
25.290
25.291 .LP
25.292 .LP
25.293 -キャッシュにアプリケーションをインポートします。
25.294 +c激ャ≪宴若激с潟ゃ潟若障
25.295 .LP
25.296 .RE
25.297 -インポートオプション
25.298 +\f3ゃ潟若激с\fP
25.299 .LP
25.300 .LP
25.301 \f2\-silent\fP
25.302 @@ -263,7 +281,7 @@
25.303
25.304 .LP
25.305 .LP
25.306 -サイレントモードでインポートします (UI は表示されません)。
25.307 +泣ゃ潟≪若сゃ潟若障 (UI 茵腓冴障)
25.308 .LP
25.309 .RE
25.310 .LP
25.311 @@ -273,7 +291,7 @@
25.312
25.313 .LP
25.314 .LP
25.315 -システムキャッシュにアプリケーションをインポートします。
25.316 +激鴻c激ャ≪宴若激с潟ゃ潟若障
25.317 .LP
25.318 .RE
25.319 .LP
25.320 @@ -283,7 +301,7 @@
25.321
25.322 .LP
25.323 .LP
25.324 -任意の codebase からリソースを取得します。
25.325 +篁紙 codebase 純若鴻緇障
25.326 .LP
25.327 .RE
25.328 .LP
25.329 @@ -293,7 +311,7 @@
25.330
25.331 .LP
25.332 .LP
25.333 -ユーザ許容プロンプトのようにショートカットをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
25.334 +若吟取┗絎鴻潟激с若ゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
25.335 .LP
25.336 .RE
25.337 .LP
25.338 @@ -303,20 +321,43 @@
25.339
25.340 .LP
25.341 .LP
25.342 -ユーザ許容プロンプトのように関連付けをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
25.343 +若吟取┗絎鴻潟∫dゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
25.344 .LP
25.345 .RE
25.346 .RE
25.347 -.SS
25.348 -.SH ファイル
25.349 +.SS
25.350 +<ゃ
25.351 .LP
25.352 -ユーザキャッシュ、システムキャッシュ、および deployment.properties ファイルの詳細は、
25.353 +.RS 3
25.354 +
25.355 +.LP
25.356 +.LP
25.357 +若吟若c激ャ激鴻c激ャ deployment.properties <ゃゃ
25.358 .na
25.359 -「\f2System\- and User\-Level Properties\fP」
25.360 +\f2激鴻潟若吟若c\fP @
25.361 .fi
25.362 -(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html)
25.363 -を参照してください。
25.364 -.SH 詳細情報
25.365 -Java Web Start の詳細は、
25.366 -http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html
25.367 -を参照してください。
25.368 +http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlс
25.369 +.LP
25.370 +.RE
25.371 +.SS
25.372 +荅括完
25.373 +.LP
25.374 +.RS 3
25.375 +
25.376 +.LP
25.377 +.LP
25.378 +Java Web Start 荅括完
25.379 +.na
25.380 +\f2Java Web Start\fP @
25.381 +.fi
25.382 +http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlс
25.383 +.LP
25.384 +.RS 3
25.385 +
25.386 +.LP
25.387 +.LP
25.388 +\
25.389 +.LP
25.390 +.RE
25.391 +.RE
25.392 +
26.1 --- a/src/linux/doc/man/ja/jconsole.1 Tue May 12 15:21:55 2009 +0900
26.2 +++ b/src/linux/doc/man/ja/jconsole.1 Thu May 14 00:17:25 2009 -0700
26.3 @@ -1,31 +1,51 @@
26.4 -'\" t
26.5 -.\"
26.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
26.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
26.8 -.\"
26.9 -.\" This code is free software; you can redistribute it and/or modify it
26.10 -.\" under the terms of the GNU General Public License version 2 only, as
26.11 -.\" published by the Free Software Foundation.
26.12 -.\"
26.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
26.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
26.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
26.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
26.17 -.\" accompanied this code).
26.18 -.\"
26.19 -.\" You should have received a copy of the GNU General Public License version
26.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
26.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
26.22 -.\"
26.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
26.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
26.25 -.\" have any questions.
26.26 -.\"
26.27 -.\"
26.28 -.TH "jconsole" 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
26.29 -.SH 名前
26.30 -jconsole \- Java 監視/管理コンソール
26.31 -.SH 形式
26.32 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
26.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
26.34 +."
26.35 +." This code is free software; you can redistribute it and/or modify it
26.36 +." under the terms of the GNU General Public License version 2 only, as
26.37 +." published by the Free Software Foundation.
26.38 +."
26.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
26.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
26.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
26.42 +." version 2 for more details (a copy is included in the LICENSE file that
26.43 +." accompanied this code).
26.44 +."
26.45 +." You should have received a copy of the GNU General Public License version
26.46 +." 2 along with this work; if not, write to the Free Software Foundation,
26.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
26.48 +."
26.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
26.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
26.51 +." have any questions.
26.52 +."
26.53 +.TH jconsole 1 "04 May 2009"
26.54 +." Generated from HTML by html2man (author: Eric Armstrong)
26.55 +
26.56 +.LP
26.57 +.SH ""
26.58 +jconsole \- Java h括∞潟潟純若
26.59 +.LP
26.60 +.RS 3
26.61 +.TP 2
26.62 +o
26.63 +綵√
26.64 +.TP 2
26.65 +o
26.66 +<若
26.67 +.TP 2
26.68 +o
26.69 +茯
26.70 +.TP 2
26.71 +o
26.72 +激с
26.73 +.TP 2
26.74 +o
26.75 +∫i
26.76 +.RE
26.77 +
26.78 +.LP
26.79 +.SH "綵√"
26.80 .LP
26.81
26.82 .LP
26.83 @@ -39,49 +59,63 @@
26.84 .fi
26.85
26.86 .LP
26.87 -.SH "パラメータ"
26.88 +.SH "<若"
26.89 .LP
26.90
26.91 .LP
26.92 +.RS 3
26.93 .TP 3
26.94 -options
26.95 -オプションを使用する場合、コマンド名の直後に記述してください。
26.96 -.TP
26.97 +options
26.98 +激с潟篏睡翫潟潟翫荐菴違
26.99 +.br
26.100 +.TP 3
26.101 connection = pid | host:port | jmxUrl
26.102 +.RS 3
26.103 +\f2pid\fP\ \ \ 若 Java VM 祉 IDJava VM jconsole 絎茵若吟 ID 若吟 ID 篏睡絎茵綽荀障荅括完ゃ
26.104 +.na
26.105 +\f2JMX h括∞\fP @
26.106 +.fi
26.107 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
26.108 +.br
26.109 +\f2host\fP:\f2port\fP\ \ Java VM 絎茵鴻激鴻JVM 莎桁激鴻c \f2com.sun.management.jmxremote.port\fP ф絎若垩荅括完ゃ
26.110 +.na
26.111 +\f2JMX h括∞\fP @
26.112 +.fi
26.113 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
26.114 +.br
26.115 +\f2jmxUrl\fP ・膓 JMX 若吾с潟≪鴻 ゃ
26.116 +.na
26.117 +\f2JMXServiceURL\fP @
26.118 +.fi
26.119 +http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html с
26.120 +.RE
26.121 +.RE
26.122 +
26.123 .LP
26.124 -\f2pid\fP\ \ \ ローカルの Java VM のプロセス ID。この Java VM は、jconsole を実行しているユーザ ID と同じユーザ ID で実行されている必要があります。詳細については、
26.125 -.na
26.126 -「\f2JMX Monitoring and Management\fP」
26.127 -.fi
26.128 -(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
26.129 +.SH " 茯"
26.130 .LP
26.131 -\f2host\fP:\f2port\fP\ \ Java VM が実行されているホストシステムの名前と、その Java VM の起動時にシステムプロパティ \f2com.sun.management.jmxremote.port\fP に指定されたポート番号。詳細については、
26.132 -.na
26.133 -「\f2JMX Monitoring and Management\fP」
26.134 -.fi
26.135 -(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
26.136 +
26.137 .LP
26.138 -\f2jmxUrl\fP\ \ 接続先の JMX エージェントのアドレス。これについては、
26.139 -.na
26.140 -「\f2JMXServiceURL\fP」
26.141 -.fi
26.142 -(http://java.sun.com/javase/6/docs/api/javax/management/remote/jmxserviceurl.html) を参照してください。
26.143 .LP
26.144 -.SH 機能説明
26.145 +\f3jconsole\fP 潟潟若激潟障≪若激割 Java ≪宴若激с潟篁潟激潟h膊∞茵違c潟潟純若若莎桁障
26.146 +.LP
26.147 +.LP
26.148 +Windows 筝с\f3jconsole\fP 潟潟純若c潟∫d障宴 \f3jconsole\fP 潟潟紊掩惹宴腓冴ゃ≪違鴻茵腓冴障
26.149 +.LP
26.150 +.SH "激с"
26.151 +.LP
26.152
26.153 -.B jconsole
26.154 -コマンドは、ローカルまたはリモートマシン上の Java アプリケーションと仮想マシンを監視および管理するためのグラフィカルコンソールツールを起動します。
26.155 .LP
26.156 -.SH オプション
26.157 -.TP 15
26.158 -.B \-interval=n
26.159 -更新間隔を n 秒に設定します。(デフォルトは 4 秒)
26.160 -.TP
26.161 -.B \-notile
26.162 -初期状態でウィンドウを並べて表示しません。(接続が 2 つ以上ある場合)
26.163 +.RS 3
26.164 +.TP 3
26.165 +\-interval=n
26.166 +贋育 \f2n\fP 腱荐絎障 ( 4 腱)
26.167 +.TP 3
26.168 +\-notile\
26.169 +c潟帥ゃ潟違障 (茲違・膓)
26.170 .TP 3
26.171 \-pluginpath\ plugins
26.172 -JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
26.173 +JConsole 違ゃ潟罎膣√c障 JAR <ゃ鴻絎障\f2plugins\fP 鴻罨<ゃ罕<ゃ
26.174 .br
26.175 .nf
26.176 \f3
26.177 @@ -91,38 +125,38 @@
26.178 \fP
26.179 .fi
26.180 .LP
26.181 -これには、
26.182 +
26.183 .na
26.184 -\f2com.sun.tools.jconsole.JConsolePlugin\fP
26.185 +\f2com.sun.tools.jconsole.JConsolePlugin\fP @
26.186 .fi
26.187 -(http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/jconsoleplugin.html) クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
26.188 -.TP
26.189 -.B \-version
26.190 -バージョン情報を出力して終了します。
26.191 -.TP
26.192 -.B \-help
26.193 -ヘルプメッセージを出力して終了します。
26.194 +http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html 鴻絎茖鴻絎篆蕋障劫絎茵違ゃ潟 1 茵ゅ障障
26.195 +.TP 3
26.196 +\-version\
26.197 +若吾с恰宴阪腟篋障
26.198 +.TP 3
26.199 +\-help\
26.200 +<祉若吾阪腟篋障
26.201 .TP 3
26.202 \-J<flag>\
26.203 -jconsole が実行されている Java 仮想マシンに <flag> を渡します。
26.204 +jconsole 絎茵 Java 篁潟激潟 <flag> 羝<障
26.205 +.RE
26.206 +
26.207 .LP
26.208 -.SH "関連項目"
26.209 +.SH "∫i"
26.210 .LP
26.211 .RS 3
26.212 .TP 2
26.213 -*
26.214 +o
26.215 +.na
26.216 +\f2jconsole 篏睡\fP @
26.217 .fi
26.218 http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
26.219 -の
26.220 +.TP 2
26.221 +o
26.222 .na
26.223 -「\f2Using JConsole\fP」
26.224 -.TP 2
26.225 -*
26.226 +\f2Java 若h括∞\fP @
26.227 .fi
26.228 http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
26.229 -の
26.230 -.na
26.231 -「\f2Monitoring and Management for Java Platform\fP」
26.232 .RE
26.233
26.234 .LP
27.1 --- a/src/linux/doc/man/ja/jdb.1 Tue May 12 15:21:55 2009 +0900
27.2 +++ b/src/linux/doc/man/ja/jdb.1 Thu May 14 00:17:25 2009 -0700
27.3 @@ -1,109 +1,101 @@
27.4 -'\" t
27.5 -.\"
27.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
27.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
27.8 -.\"
27.9 -.\" This code is free software; you can redistribute it and/or modify it
27.10 -.\" under the terms of the GNU General Public License version 2 only, as
27.11 -.\" published by the Free Software Foundation.
27.12 -.\"
27.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
27.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
27.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
27.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
27.17 -.\" accompanied this code).
27.18 -.\"
27.19 -.\" You should have received a copy of the GNU General Public License version
27.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
27.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
27.22 -.\"
27.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
27.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
27.25 -.\" have any questions.
27.26 -.\"
27.27 -.\"
27.28 -.\"
27.29 -.\" This document was created by saving an HTML file as text
27.30 -.\" from the JavaSoft web site:
27.31 -.\"
27.32 -.\" http://java.sun.com/j2se/1.4/docs/tooldocs/tools.html
27.33 -.\"
27.34 -.\" and adding appropriate troff macros. Because the JavaSoft web site
27.35 -.\" man pages can change without notice, it may be helpful to diff
27.36 -.\" files to identify changes other than new functionality.
27.37 -.\"
27.38 -.TH jdb 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
27.39 -.SH "名前"
27.40 -jdb \- Java デバッガ
27.41 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
27.42 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
27.43 +."
27.44 +." This code is free software; you can redistribute it and/or modify it
27.45 +." under the terms of the GNU General Public License version 2 only, as
27.46 +." published by the Free Software Foundation.
27.47 +."
27.48 +." This code is distributed in the hope that it will be useful, but WITHOUT
27.49 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
27.50 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
27.51 +." version 2 for more details (a copy is included in the LICENSE file that
27.52 +." accompanied this code).
27.53 +."
27.54 +." You should have received a copy of the GNU General Public License version
27.55 +." 2 along with this work; if not, write to the Free Software Foundation,
27.56 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
27.57 +."
27.58 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
27.59 +." CA 95054 USA or visit www.sun.com if you need additional information or
27.60 +." have any questions.
27.61 +."
27.62 +.TH jdb 1 "04 May 2009"
27.63 +." Generated from HTML by html2man (author: Eric Armstrong)
27.64 +
27.65 +.LP
27.66 +.SH ""
27.67 +jdb \- Java
27.68 +.LP
27.69 +.RS 3
27.70 +
27.71 +.LP
27.72 +.LP
27.73 +\f3jdb\fP Java 荐茯違違荀ゃ篆罩c篏睡若с
27.74 +.LP
27.75 +.RE
27.76 +.SH "綵√"
27.77 .LP
27.78
27.79 .LP
27.80 +.nf
27.81 +\f3
27.82 +.fl
27.83 +\fP\f3jdb\fP [ options ] [ class ] [ arguments ]
27.84 +.fl
27.85 +.fi
27.86 +
27.87 .LP
27.88 -\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
27.89 +.RS 3
27.90 +
27.91 .LP
27.92 -.SH "形式"
27.93 -.B jdb
27.94 -[
27.95 -.I options
27.96 -] [
27.97 -.I class
27.98 -] [
27.99 -.I arguments
27.100 -]
27.101 +.RS 3
27.102 +.TP 3
27.103 +options
27.104 +罨<腓冴潟潟茵激с
27.105 +.TP 3
27.106 +class
27.107 +違紮鴻
27.108 +.TP 3
27.109 +arguments
27.110 +\f2class\fP \f2main()\fP <純羝<綣
27.111 +.RE
27.112 +
27.113 .LP
27.114 -.TP 15
27.115 -.I options
27.116 -以下に指定するコマンド行オプション
27.117 -.TP
27.118 -.I class
27.119 -デバッグを開始するクラス名
27.120 -.TP
27.121 -.I arguments
27.122 -クラスの
27.123 -.B main(\|)
27.124 -メソッドに渡される引数
27.125 -.SH "機能説明"
27.126 -.IX "Java debugger" "" "Java debugger \(em \fLjdb\fP"
27.127 -.IX "jdb" "" "\fLjdb\fP \(em Java debugger"
27.128 -Java デバッガの
27.129 -.BR jdb
27.130 -は、
27.131 -Java
27.132 -クラス用の単純なコマンド行デバッガです。
27.133 +.RE
27.134 +.SH " 茯"
27.135 +.LP
27.136 +
27.137 +.LP
27.138 +.LP
27.139 +Java \f3jdb\fP Java 合膂≦潟潟茵с
27.140 .na
27.141 -「\f2Java Platform Debugger Architecture\fP」
27.142 +\f2Java Platform Debugger Architecture\fP @
27.143 .fi
27.144 - (http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html)
27.145 -を画面に表示しながら実行し、ローカルまたはリモートの Java 仮想マシン
27.146 -の検査とデバッグを行うことができます。
27.147 -.SS "jdb セッションの開始"
27.148 -.IX "jdb" "Starting a jdb Session" "\fLjdb\fP \(em Java debugger"
27.149 -jdb セッションを開始するにはさまざまな方法があります。 もっとも頻繁に使
27.150 -われるのは、アプリケーションのメインクラスをデバッグして、
27.151 -.B jdb
27.152 -から新しく Java 仮想マシン (VM) を起動する方法です。 コマンド行で、
27.153 -.BR java (1)
27.154 -の代わりに
27.155 -.B jdb
27.156 -コマンドを入力します。たとえば、アプリケーションのメインクラスが
27.157 -.BR MyClass
27.158 -の場合は、次のコマンドを使用して jdb 環境でデバッグします。
27.159 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html 荀荀絎茵若障≪若 Java Virtual Machine 罎祉違茵с障
27.160 .LP
27.161 -.RS
27.162 -.B % jdb MyClass
27.163 -.RE
27.164 +.SS
27.165 +jdb 祉激с潟紮
27.166 .LP
27.167 -このようにして起動すると、
27.168 -.B jdb
27.169 -は 2 つ目の Java VM を呼び出し、指定されたパラメータを渡し、
27.170 -指定されたクラスをロードします。そのあと、
27.171 -クラスの最初の命令を実行する前に VM を停止させます。
27.172 +.RS 3
27.173 +
27.174 .LP
27.175 -.B jdb
27.176 -のもう 1 つの使用方法は、すでに起動している Java VM に
27.177 -.B jdb
27.178 -を接続することです。
27.179 -jdb が接続する VM を、その実行中に起動するための構文を次に示します。 これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
27.180 +.LP
27.181 +jdb 祉激с潟紮障障号障c紫篏帥違≪宴若激с潟<ゃ潟鴻篏睡\f3jdb\fP 違 Java 篁潟激 (VM) 莎桁号с潟潟茵с \f3java\fP 篁c \f3jdb\fP 潟潟ュ障違≪宴若激с潟<ゃ潟鴻 MyClass 翫JDB 医с違罨<潟潟篏睡障
27.182 +.LP
27.183 +.nf
27.184 +\f3
27.185 +.fl
27.186 + % jdb MyClass
27.187 +.fl
27.188 +\fP
27.189 +.fi
27.190 +
27.191 +.LP
27.192 +.LP
27.193 +号ц儀\f3jdb\fP 絎<若帥篏帥c 2 ょ Java VM 若喝冴障 罨<絎鴻若鴻巡擦絎茵 VM 罩≪障
27.194 +.LP
27.195 +.LP
27.196 +\f3jdb\fP 1 ゃ篏睡号с莎桁 Java VM jdb ・膓сjdb ・膓 VM 絎茵筝莎桁罕罨<腓冴障ゃ潟祉鴻亥ゃ若・膓腮蕁絎障
27.197 .LP
27.198 .nf
27.199 \f3
27.200 @@ -115,11 +107,7 @@
27.201
27.202 .LP
27.203 .LP
27.204 -たとえば、次のコマンドは
27.205 -.B MyClass
27.206 -アプリケーションを実行し、後で
27.207 -.B jdb
27.208 -を接続できるようにします。
27.209 +違罨<潟潟MyClass ≪宴若激с潟絎茵\f3jdb\fP с≪宴若激с潟・膓с障
27.210 .LP
27.211 .nf
27.212 \f3
27.213 @@ -131,375 +119,250 @@
27.214
27.215 .LP
27.216 .LP
27.217 -次のコマンドで
27.218 -.B jdb
27.219 -を VM に接続できます。
27.220 +罨<潟潟篏睡\f3jdb\fP VM ・膓с障
27.221 .LP
27.222 -.RS
27.223 -.B % jdb \-attach 8000
27.224 -.RE
27.225 -.LP
27.226 -このとき、
27.227 -.B jdb
27.228 -は新しい VM を起動するのではなく、既存の VM に接続するので、
27.229 -.B jdb
27.230 -コマンド行で
27.231 -.B MyClass
27.232 -を指定しないことに注意してください。
27.233 -.LP
27.234 -これ以外にもデバッガ (jdb) を VM に接続する方法はたくさんあり、
27.235 -.BR jdb
27.236 -はそのすべての方法をサポートしています。
27.237 -このような接続オプションについては、
27.238 +.nf
27.239 +\f3
27.240 +.fl
27.241 + % jdb \-attach 8000
27.242 +.fl
27.243 +\fP
27.244 .fi
27.245 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
27.246 -で Java Platform Debugger Architecture のマニュアルを参照してください。
27.247 -\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
27.248 -.fi
27.249 -http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
27.250 -の 1.4.2 のドキュメントを参照してください。
27.251 -.SS " jdb 基本コマンド"
27.252 -.IX "jdb" "Basic jdb Commands" "\fLjdb\fP \(em Java debugger"
27.253 -以下に
27.254 -.B jdb
27.255 -基本コマンドの一覧を示します。
27.256 -Java
27.257 -デバッガで使用可能なその他のコマンドは、
27.258 -.B help
27.259 -コマンドで表示できます。
27.260 -.TP 15
27.261 -.B help または ?
27.262 -.BR jdb
27.263 -のコマンドの中でもっとも重要なのが、この
27.264 -.B help
27.265 -コマンドです。利用可能なコマンドの一覧を、
27.266 -各コマンドの簡単な説明つきで表示します。
27.267 -.TP 15
27.268 -.B run
27.269 -.BR jdb
27.270 -を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、
27.271 -デバッグするアプリケーションの実行を開始します。このコマンドは、
27.272 -デバッグするアプリケーションを
27.273 -.B jdb
27.274 -から起動するときにだけ使用できます。
27.275 -既存の VM に接続する場合とは異なります。
27.276 -.TP
27.277 -.B cont
27.278 -ブレークポイント、例外、またはステップ実行のあとで、デバッグ中の
27.279 -アプリケーションの実行を継続します。
27.280 -.TP 15
27.281 -.B print
27.282 -Java オブジェクトおよびプリミティブ値を表示します。 プリミティブ型の変数
27.283 -またはフィールドの場合には、実際の値を出力します。 オブジェクトの場合
27.284 -には、短い説明を出力します。 オブジェクトについては、以降の
27.285 -.B dump
27.286 -コマンドの説明を参照してください。
27.287 -.sp 1n
27.288 -.LP
27.289 -注: 局所
27.290 -(スタック)
27.291 -変数をブラウズするには、そのクラスが
27.292 -.B javac \-g
27.293 -オプションでコンパイルされている必要があります。
27.294 -.sp 1n
27.295 -.LP
27.296 -.B print
27.297 -は、メソッドの呼び出しを含む多数の簡単な Java 式をサポートします。
27.298 -次に例を示します。
27.299 -.RS
27.300 -.TP 3
27.301 -\(bu
27.302 -.B print MyClass.myStaticField
27.303 -.PD 0
27.304 -.TP
27.305 -\(bu
27.306 -.B print myObj.myInstanceField
27.307 -.TP
27.308 -\(bu
27.309 -\f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 (
27.310 -.IR i、
27.311 -.IR j 、
27.312 -および
27.313 -.I k
27.314 -はプリミティブであり、フィールドまたは局所変数のいずれか)
27.315 -.TP
27.316 -\(bu
27.317 -\f3print myObj.myMethod(\|)\f1 (
27.318 -.B myMethod
27.319 -が null 以外を返す場合)
27.320 -.TP
27.321 -\(bu
27.322 -.B print new java.lang.String("Hello").length(\|)
27.323 -.RE
27.324 -.PD
27.325 -.TP
27.326 -.B dump
27.327 -プリミティブ値の場合には、このコマンドは
27.328 -.BR print
27.329 -と同じです。オブジェクトの場合には、オブジェクト内に定義されている
27.330 -各フィールドの現在の値を出力します。 static フィールドと instance
27.331 -フィールドを出力します。
27.332 -.sp 1n
27.333 -.LP
27.334 -.B dump
27.335 -コマンドは、
27.336 -.B print
27.337 -コマンドと同じ式をサポートします。
27.338 -.TP
27.339 -.B threads
27.340 -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、
27.341 -およびほかのコマンドに使用できるインデックスを出力します。次に例を
27.342 -示します。
27.343 -.sp 1n
27.344 -.RS 20
27.345 -.LP
27.346 -.B 4. (java.lang.Thread)0x1 main running
27.347 -.RE
27.348 -.RS
27.349 -.sp 1n
27.350 -.LP
27.351 -この例では、スレッドインデックスは
27.352 -.BR 4
27.353 -であり、スレッドは
27.354 -.BR java.lang.Thread
27.355 -のインスタンスです。スレッドの名前は「
27.356 -.BR main
27.357 -」であり、現在実行中です。
27.358 -.RE
27.359 -.TP 15
27.360 -.B thread
27.361 -現在のスレッドを選択します。 多くの
27.362 -.B jdb
27.363 -コマンドは、現在のスレッドの設定に基づいて実行されます。 スレッドは、
27.364 -.B threads
27.365 -コマンドで説明するスレッドインデックスとともに指定します。
27.366 -.TP 15
27.367 -.B where
27.368 -引数のない
27.369 -.B where
27.370 -コマンドは、現在のスレッド
27.371 -(
27.372 -.B thread
27.373 -コマンドで設定)
27.374 -のスタックをダンプします。
27.375 -.B where all
27.376 -と指定すると、現在のスレッドグループにある全スレッドの
27.377 -スタックをダンプします。
27.378 -.BI where " threadindex"
27.379 -と指定すると、
27.380 -.I threadindex
27.381 -が示すスレッドのスタックだけをダンプします。
27.382 -.sp 1n
27.383 -.LP
27.384 -現在のスレッドが (ブレークポイントなどのイベントや
27.385 -.B suspend
27.386 -コマンドで) 中断している場合、
27.387 -.B print
27.388 -コマンドや
27.389 -.B dump
27.390 -コマンドを使用すれば、局所変数やフィールドを表示できます。
27.391 -どのスタックフレームを現在のフレームにするかは、
27.392 -.B up
27.393 -および
27.394 -.B down
27.395 -コマンドで選択できます。
27.396 -.SS "ブレークポイント用コマンド"
27.397 -.IX "jdb" "Breakpoints" "\fLjdb\fP \(em Java debugger"
27.398 -.B jdb
27.399 -では、ブレークポイントを行番号で、
27.400 -またはメソッドの最初の命令で
27.401 -設定できます。次に例を示します。
27.402 -.TP 25
27.403 -.B stop at MyClass:22
27.404 -.BR MyClass
27.405 -が含まれるソースファイルの
27.406 -.B 22
27.407 -行目の最初の命令にブレークポイントを設定する
27.408 -.TP
27.409 -.B stop in java.lang.String.length
27.410 -.BR java.lang.String.length
27.411 -メソッドの最初にブレークポイントを設定する
27.412 -.TP
27.413 -.BI "stop in MyClass." init
27.414 -.I init
27.415 -は
27.416 -.B MyClass
27.417 -コンストラクタを識別する
27.418 -.TP
27.419 -.BI "stop in MyClass." clinit
27.420 -.I clinit
27.421 -は
27.422 -.BR MyClass
27.423 -の静的な初期化コードを識別する
27.424 -.LP
27.425 -メソッドがオーバーロードされる場合には、メソッドの引数の型も指定して、
27.426 -ブレークポイントに対して適切なメソッドが選択されるようにしなければなりませ
27.427 -ん。 たとえば、次のように指定します。
27.428 -.LP
27.429 -.RS 15
27.430 -.B MyClass.myMethod(int,java.lang.String)
27.431 -.RE
27.432 -.LP
27.433 -または
27.434 -.LP
27.435 -.RS 15
27.436 -.B MyClass.myMethod()
27.437 -.RE
27.438 -.LP
27.439 -.B clear
27.440 -コマンドは、「
27.441 -.BR clear MyClass:45
27.442 -」のような構文を使用してブレークポイントを削除します。
27.443 -引数を指定しないで
27.444 -.B clear
27.445 -コマンドを使用すると、現在設定されてい
27.446 -るすべてのブレークポイントが表示されます。
27.447 -.B cont
27.448 -コマンドで実行が継続します。
27.449 -.SS "コマンドのステップ実行"
27.450 -.IX "jdb" "Stepping" "\fLjdb\fP \(em Java debugger"
27.451 -.B step
27.452 -コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、
27.453 -次の行を実行します。
27.454 -.B next
27.455 -コマンドは、現在のスタックフレームの次の行を
27.456 -実行します。
27.457 -.SS "例外処理用コマンド"
27.458 -.IX "jdb" "Exceptions" "\fLjdb\fP \(em Java debugger"
27.459 -スローしているスレッドの呼び出しスタック上のどこにも catch 文がないような
27.460 -例外が発生すると、VM は通常、例外トレースを出力して終了します。 ただし、
27.461 -.BR jdb
27.462 -環境で実行している場合は、このような例外が発生すると
27.463 -.B jdb
27.464 -に制御が戻ります。 次に、
27.465 -.BR jdb
27.466 -を使用して例外の原因を診断します。
27.467 -.TP 15
27.468 -.B catch
27.469 -デバッグ中のアプリケーションは他の例外がスローされたところで停止します。
27.470 -次に例を示します。
27.471 -.LP
27.472 -.RS 20
27.473 -.B catch java.io.FileNotFoundException
27.474 -.RE
27.475 -.sp 1n
27.476 -.RS 15
27.477 -または
27.478 -.RE
27.479 -.LP
27.480 -.RS 20
27.481 -.B catch mypackage.BigTroubleException
27.482 -.RE
27.483 -.sp 1n
27.484 -.RS 15
27.485 -例外が指定したクラス (または、サブクラス) のインスタンスである場合、
27.486 -アプリケーションはスローされたところで停止します。
27.487 -.RE
27.488 -.TP 15
27.489 -.B ignore
27.490 -以前の
27.491 -.B catch
27.492 -コマンドの効果を無効にします。なお、この指定によって例外を無視するのは
27.493 -デバッガだけであり、デバッグされた VM は無視しません。
27.494 -.SH "コマンド行オプション"
27.495 -コマンド行で Java アプリケーション起動ツールの代わりに
27.496 -.B jdb
27.497 -を使用する場合、
27.498 -.B jdb
27.499 -は、
27.500 -.BR \-D、
27.501 -.BR \-classpath、
27.502 -.BI \-X option\f1
27.503 -など、
27.504 -.BR java (1)
27.505 -コマンドと同じオプションを多数使用できます。
27.506 -.LP
27.507 -.B jdb
27.508 -は、そのほかに次のオプションも使用できます。
27.509 -.TP 3
27.510 -.BI \-help
27.511 -ヘルプメッセージを表示します。
27.512 -.TP 3
27.513 -.BI \-sourcepath " dir1\f1:\f2dir2\f1:..."
27.514 -指定されたパスで、ソースファイルを検索します。 このオプションが
27.515 -指定されていない場合は、デフォルトパスの「.」を検索します。
27.516 -.TP
27.517 -.BI \-attach " address"
27.518 -デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続
27.519 -します。
27.520 -.TP
27.521 -.BI \-listen " address"
27.522 -実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
27.523 -.TP
27.524 -.BI \-listenany
27.525 -実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
27.526 -.TP
27.527 -.B \-launch
27.528 -デバッグするアプリケーションを
27.529 -.BR jdb
27.530 -の起動後ただちに起動します。 このオプションを使用すると、
27.531 -.B run
27.532 -コマンドを使用する必要はありません。 デバッグするアプリケーションは、
27.533 -起動後、最初のアプリケーションクラスがロードされる直前に停止します。
27.534 -その時点で、必要なブレークポイントを設定できます。
27.535 -実行を継続するには
27.536 -.B cont
27.537 -コマンドを使用します。
27.538 -.TP 3
27.539 -\-listconnectors
27.540 -この VM で利用できるコネクタを一覧表示します。
27.541 -.TP 3
27.542 -\-connect
27.543 -<connector\-name>:<name1>=<value1>,...
27.544 -一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
27.545 -.TP 3
27.546 -\-dbgtrace [flags]
27.547 -jdb のデバッグ情報を出力します。
27.548 -.TP 3
27.549 -\-tclient
27.550 -Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
27.551 -.TP 3
27.552 -\-tserver
27.553 -Java HotSpot(tm) VM (サーバ) 内でアプリケーションを実行します。
27.554 -.TP
27.555 -.BI \-J "option"
27.556 -jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される。)
27.557 -たとえば、
27.558 -.I \-J-Xms48m
27.559 -は、起動時に使用するメモリを 48M バイトに設定します。
27.560 -
27.561
27.562 .LP
27.563 -これ以外にも、デバッガをデバッグされる VM に接続するための代替機構
27.564 -用のオプションがサポートされています。
27.565 -このような接続の代替機構については、
27.566 +.LP
27.567 +翫\f3jdb\fP 違 VM 莎桁篁c√ VM ・膓\f3jdb\fP 潟潟茵MyClass絎障
27.568 +.LP
27.569 +.LP
27.570 + VM ・膓祉障障号鴻 \f3jdb\fP с泣若障・膓激с潟ゃJava Platform Debugger Architecture
27.571 +.na
27.572 +\f2ャ<潟\fP @
27.573 .fi
27.574 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
27.575 -の Java Platform Debugger Architecture のマニュアルを参照してください。
27.576 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс\f3jdb\fP т戎 J2SE 1.4.2 篁ュ VM 莎桁号ゃ
27.577 +.na
27.578 +\f21.4.2 ャ<潟\fP @
27.579 +.fi
27.580 +http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlс
27.581 .LP
27.582 .SS
27.583 -デバッグ対象のプロセスに転送されるオプション
27.584 +堺 jdb 潟潟
27.585 .LP
27.586 +.LP
27.587 +堺 \f3jdb\fP 潟潟筝荀с腓冴障Java 泣若潟潟篁ュ \f3jdb\fP \f2help\fP 潟潟篏睡茵腓冴с障
27.588 +.LP
27.589 +.RS 3
27.590 +
27.591 +.LP
27.592 +.RS 3
27.593 .TP 3
27.594 -\-v \-verbose[:class|gc|jni]
27.595 -冗長モードにします。
27.596 +help 障 ?
27.597 +c荀 \f3jdb\fP 潟潟 \f2help\fP 茯茘潟潟鴻膂≧茯篁茵腓冴障
27.598 .TP 3
27.599 -\-D<name>=<value>
27.600 -システムプロパティを設定します。
27.601 +run
27.602 +\f3jdb\fP 莎桁綽荀若ゃ潟荐絎潟潟篏睡違≪宴若激с潟絎茵紮с障潟潟√ VM ・膓翫違違≪宴若激с潟 \f3jdb\fP 莎桁篏睡с障
27.603 .TP 3
27.604 -\-classpath <directories separated by
27.605 -":">
27.606 -クラスを検索するディレクトリを一覧表示します。
27.607 +cont
27.608 +若ゃ潟箴紊障鴻絎茵с違≪宴若激с潟絎茵膓膓障
27.609 .TP 3
27.610 -\-X<option>
27.611 -非標準ターゲット VM オプションです。
27.612 +print
27.613 +Java 吾с潟cゃ茵腓冴障c紊違障c若翫絎ゃ阪障吾с翫茯阪障吾сゃ篁ラ \f2dump\fP 潟潟茯с
27.614 .LP
27.615 -.SH "関連項目"
27.616 +\f2羈:絮紊違茵腓冴紊違鴻 \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP 激с潟с潟潟ゃ違障
27.617 +.LP
27.618 +\f2print\fP с<純若喝冴紊違膂≦ Java 綣泣若障 罨<箴腓冴障
27.619 +.RS 3
27.620 +.TP 2
27.621 +o
27.622 +\f2print MyClass.myStaticField\fP
27.623 +.TP 2
27.624 +o
27.625 +\f2print myObj.myInstanceField\fP
27.626 +.TP 2
27.627 +o
27.628 +\f2print i + j + k\fP (ij k cсc若障絮紊違)
27.629 +.TP 2
27.630 +o
27.631 +\f2print myObj.myMethod()\fP (myMethod null 篁ュ菴翫)
27.632 +.TP 2
27.633 +o
27.634 +\f2print new java.lang.String("Hello").length()\fP
27.635 +.RE
27.636 +.TP 3
27.637 +dump
27.638 +cゃ翫潟潟 \f2print\fP с吾с翫吾с絎臂c若憜ゃ阪障static c若 instance c若阪障
27.639 +.LP
27.640 +\f2dump\fP 潟潟с\f2print\fP 潟潟綣泣若障
27.641 +.TP 3
27.642 +threads
27.643 +憜絎茵筝鴻筝荀ц;腓冴障鴻憜倶潟祉潟潟篏睡сゃ潟鴻阪障 罨<箴腓冴障
27.644 +.RS 3
27.645 +
27.646 +.LP
27.647 +.nf
27.648 +\f3
27.649 +.fl
27.650 +4. (java.lang.Thread)0x1 main running
27.651 +.fl
27.652 +\fP
27.653 +.fi
27.654 +.RE
27.655 +箴с鴻ゃ潟鴻 4 с鴻 java.lang.Thread ゃ潟鴻帥潟鴻с 鴻mainс憜絎茵筝с
27.656 +.TP 3
27.657 +thread
27.658 +憜鴻鴻御障紊 \f3jdb\fP 潟潟憜鴻荐絎冴ャ絎茵障鴻\f2threads\fP 潟潟ц鴻ゃ潟鴻絎障
27.659 +.TP 3
27.660 +where
27.661 +綣違絎 \f2where\fP 絎茵憜鴻鴻帥潟障 \f2where all\fP 潟潟憜鴻違若鴻鴻帥鴻潟障 \f2where\fP \f2threadindex\fP 絎鴻鴻帥潟障
27.662 +.LP
27.663 +憜鴻 (若ゃ潟 \f2suspend\fP 潟潟c) 筝翫絮紊違c若 \f2print\fP 潟潟 \f2dump\fP 潟潟ц;腓冴с障\f2up\fP 潟潟 \f2down\fP 潟潟с鴻帥若潟吾吟с障
27.664 +.RE
27.665 +
27.666 +.LP
27.667 +.RE
27.668 +.SS
27.669 +若ゃ潟
27.670 +.LP
27.671 +.RS 3
27.672 +
27.673 +.LP
27.674 +.LP
27.675 +若ゃ潟茵垩障<純巡擦 \f3jdb\fP 荐絎с障 罨<箴腓冴障
27.676 +.LP
27.677 +.RS 3
27.678 +.TP 2
27.679 +o
27.680 +\f2stop at MyClass:22\fP (MyClass 障純若鴻<ゃ 22 茵巡擦若ゃ潟荐絎)
27.681 +.TP 2
27.682 +o
27.683 +\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP <純若ゃ潟荐絎)
27.684 +.TP 2
27.685 +o
27.686 +\f2stop in MyClass.<init>\fP (<init> MyClass 潟潟鴻帥茘)
27.687 +.TP 2
27.688 +o
27.689 +\f2stop in MyClass.<clinit>\fP (<clinit> MyClass 潟若茘)
27.690 +.RE
27.691 +
27.692 +.LP
27.693 +.LP
27.694 +<純若若若翫<純綣違絎若ゃ潟絲障<純御違障違\f2MyClass.myMethod(int,java.lang.String)\fP障\f2MyClass.myMethod()\fP絎障
27.695 +.LP
27.696 +.LP
27.697 +\f2clear\fP 潟潟\f2clear\ MyClass:45\fP罕篏睡若ゃ潟ゃ障\f2clear\fP 篏睡綣違絎с潟潟篏睡憜荐絎鴻若ゃ潟茵腓冴障\f2cont\fP 潟潟絎茵膓膓障
27.698 +.LP
27.699 +.RE
27.700 +.SS
27.701 +鴻絎茵
27.702 +.LP
27.703 +.RS 3
27.704 +
27.705 +.LP
27.706 +.LP
27.707 +\f2step\fP 潟潟憜鴻帥若障若喝冴<純с罨<茵絎茵障\f2next\fP 潟潟憜鴻帥若罨<茵絎茵障
27.708 +.LP
27.709 +.RE
27.710 +.SS
27.711 +箴紊
27.712 +.LP
27.713 +.RS 3
27.714 +
27.715 +.LP
27.716 +.LP
27.717 +鴻若鴻若喝冴鴻帥筝 catch 翫箴紊榊VM 絽吾箴紊若鴻阪腟篋障\f3jdb\fP 医у茵翫箴紊榊 \f3jdb\fP 九勝祉障罨<\f3jdb\fP 篏睡箴紊荐堺障
27.718 +.LP
27.719 +.LP
27.720 +違\f2catch java.io.FileNotFoundException\fP障\f2catch mypackage.BigTroubleException\fP \f2catch\fP 潟潟篏睡違≪宴若激с潟祉箴紊鴻若罩≪障箴紊劫 (障泣) ゃ潟鴻帥潟鴻翫≪宴若激с潟箴紊鴻若贋у罩≪障
27.721 +.LP
27.722 +.LP
27.723 +\f2ignore\fP 潟潟篏帥篁ュ \f2catch\fP 潟潟号≦鴻障
27.724 +.LP
27.725 +.LP
27.726 +\f2羈:\fP\f2ignore\fP 潟潟с違 VM 箴紊∴箴紊∴障
27.727 +.LP
27.728 +.RE
27.729 +.RE
27.730 +.SH "潟潟茵激с"
27.731 .LP
27.732
27.733 .LP
27.734 .LP
27.735 -javac、java、javah、javap、javadoc
27.736 +潟潟茵 Java ≪宴若激с活儀若篁c \f3jdb\fP 篏睡翫\f3jdb\fP \f2\-D\fP\f2\-classpath\fP\f2\-X<option>\fP java 潟潟違激с潟ャ障
27.737 +.LP
27.738 +.LP
27.739 +\f3jdb\fP 祉罨<激с潟ャ障
27.740 +.LP
27.741 +.RS 3
27.742 +.TP 3
27.743 +\-help
27.744 +<祉若吾茵腓冴障
27.745 +.TP 3
27.746 +\-sourcepath <dir1:dir2:...>
27.747 +絎鴻篏睡純若鴻<ゃ罎膣≪障激с潟絎翫鴻.篏帥障
27.748 +.TP 3
27.749 +\-attach <address>
27.750 +・膓罘罕篏睡с絎茵筝 VM ・膓障
27.751 +.TP 3
27.752 +\-listen <address>
27.753 +絎茵筝 VM 罔羣潟帥篏帥c絎≪鴻・膓緇罘障
27.754 +.TP 3
27.755 +\-listenany
27.756 +絎茵筝 VM 罔羣潟帥篏帥c純篁紙≪鴻・膓緇罘障
27.757 +.TP 3
27.758 +\-launch
27.759 +違≪宴若激с潟 jdb 莎桁緇<莎桁障激с潟c\f2run\fP 潟潟篏睡綽荀障違≪宴若激с潟莎桁緇≪宴若激с潟鴻若翫罩≪障鴻с綽荀若ゃ潟荐絎\f2cont\fP 篏睡絎茵膓膓с障
27.760 +.TP 3
27.761 +\-listconnectors
27.762 + VM ус潟帥筝荀ц;腓冴障
27.763 +.TP 3
27.764 +\-connect <connector\-name>:<name1>=<value1>,...
27.765 +筝荀ц;腓冴綣違ゃ絎潟帥篏帥c帥若蚊 VM ・膓障
27.766 +.TP 3
27.767 +\-dbgtrace [flags]
27.768 +jdb 井宴阪障
27.769 +.TP 3
27.770 +\-tclient
27.771 +Java HotSpot(tm) VM (ゃ≪潟) с≪宴若激с潟絎茵障
27.772 +.TP 3
27.773 +\-tserver
27.774 +Java HotSpot(tm) VM (泣若) с≪宴若激с潟絎茵障
27.775 +.TP 3
27.776 +\-Joption
27.777 +jdb 絎茵篏睡 Java 篁潟激潟 \f2option\fP 羝<障(≪宴若激с Java 篁潟激潟絲障激с潟\f3run\fP 潟潟羝<)違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
27.778 +.RE
27.779 +
27.780 +.LP
27.781 +.LP
27.782 +違茵 VM ・膓篁f炊罕絲障篁激с潟泣若障篁・膓激с潟ゃJava Platform Debugger Architecture
27.783 +.na
27.784 +\f2ャ<潟\fP @
27.785 +.fi
27.786 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс
27.787 +.LP
27.788 +.SS
27.789 +医乗院祉鴻荵∫激с
27.790 +.LP
27.791 +.RS 3
27.792 +.TP 3
27.793 +\-v \-verbose[:class|gc|jni]
27.794 +激≪若障
27.795 +.TP 3
27.796 +\-D<name>=<value>
27.797 +激鴻c若荐絎障
27.798 +.TP 3
27.799 +\-classpath <directories separated by ":">
27.800 +鴻罎膣≪c筝荀ц;腓冴障
27.801 +.TP 3
27.802 +\-X<option>
27.803 +罔羣帥若蚊 VM 激с潟с
27.804 +.RE
27.805 +
27.806 +.LP
27.807 +.SH "∫i"
27.808 +.LP
27.809 +
27.810 +.LP
27.811 +.LP
27.812 +javac(1)java(1)javah(1)javap(1)javadoc(1)
27.813 .LP
27.814
27.815 .LP
28.1 --- a/src/linux/doc/man/ja/jhat.1 Tue May 12 15:21:55 2009 +0900
28.2 +++ b/src/linux/doc/man/ja/jhat.1 Thu May 14 00:17:25 2009 -0700
28.3 @@ -1,5 +1,3 @@
28.4 -.'" t
28.5 -."
28.6 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
28.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
28.8 ."
28.9 @@ -20,16 +18,34 @@
28.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
28.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
28.12 ." have any questions.
28.13 -."
28.14 -." `
28.15 -.TH jhat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
28.16 -." Generated by html2roff
28.17 +."
28.18 +.TH jhat 1 "04 May 2009"
28.19 +." Generated from HTML by html2man (author: Eric Armstrong)
28.20
28.21 .LP
28.22 -.SH 名前
28.23 -jhat \- Java ヒープ解析ツール
28.24 +.SH ""
28.25 +jhat \- Java 若茹f若
28.26 .LP
28.27 -.SH "形式"
28.28 +.RS 3
28.29 +.TP 2
28.30 +o
28.31 +綵√
28.32 +.TP 2
28.33 +o
28.34 +<若
28.35 +.TP 2
28.36 +o
28.37 +茯
28.38 +.TP 2
28.39 +o
28.40 +激с
28.41 +.TP 2
28.42 +o
28.43 +∫i
28.44 +.RE
28.45 +
28.46 +.LP
28.47 +.SH "綵√"
28.48 .LP
28.49
28.50 .LP
28.51 @@ -43,107 +59,101 @@
28.52 .fi
28.53
28.54 .LP
28.55 -.SH "パラメータ"
28.56 +.SH "<若"
28.57 .LP
28.58
28.59 .LP
28.60 +.RS 3
28.61 .TP 3
28.62 options
28.63 -オプションを使用する場合、コマンド名の直後に記述してください。
28.64 +激с潟篏睡翫潟潟翫荐菴違
28.65 +.br
28.66 .TP 3
28.67 heap\-dump\-file
28.68 -ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
28.69 +阪乗院 Java ゃ若潟<ゃ茲違若潟潟<ゃ翫foo.hprof#3<ゃ緇#<number>篁с<ゃ劫潟絎с障
28.70 +.SH "茯"
28.71 .LP
28.72 -.SH "説明"
28.73 .LP
28.74 -
28.75 +\f3jhat\fP 潟潟java 若潟<ゃ茹fWeb 泣若若莎桁障 jhat 篏帥違絅純帥 Web 吟篏帥c若潟冴с障 jhat ∝ャ鴻Foo鴻ゃ潟鴻帥潟鴻茵腓冴c篋荐荐祉\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) 泣若障OQL jhat c茵腓冴 OQL 若吾≪祉鴻с障若篏睡翫OQL http://localhost:7000/oqlhelp/ у純с
28.76 .LP
28.77 .LP
28.78 -\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。\f3OQL\fP は、ヒープダンプに対するクエリを行うための、SQL に似たクエリ言語です。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
28.79 -.LP
28.80 -.LP
28.81 -Java のヒープダンプを生成するには、いくつかの方法があります。
28.82 +Java 若潟ゃ号障
28.83 .LP
28.84 .RS 3
28.85 .TP 2
28.86 -*
28.87 -jmap の \-dump オプションを使って実行時にヒープダンプを取得する。
28.88 +o
28.89 +jmap(1) \-dump 激с潟篏帥c絎茵若潟緇
28.90 .TP 2
28.91 -*
28.92 -jconsole のオプションを使って
28.93 +o
28.94 +jconsole(1) 激с潟篏帥c
28.95 .na
28.96 -\f2HotSpotDiagnosticMXBean\fP
28.97 +\f2HotSpotDiagnosticMXBean\fP @
28.98 .fi
28.99 -(http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html) 経由で実行時にヒープダンプを取得する。
28.100 +http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 腟宴у茵若潟緇
28.101 .TP 2
28.102 -*
28.103 -\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
28.104 +o
28.105 +\-XX:+HeapDumpOnOutOfMemoryError VM 激с潟絎OutOfMemoryError 鴻惹若潟
28.106 .TP 2
28.107 -*
28.108 -
28.109 +o
28.110 .na
28.111 -\f2hprof\fP
28.112 +\f2hprof\fP @
28.113 .fi
28.114 -(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) を使用する。
28.115 +http://java.sun.com/developer/technicalArticles/Programming/HPROF.html 篏睡
28.116 .RE
28.117
28.118 .LP
28.119 .LP
28.120 -\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
28.121 +\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
28.122 .LP
28.123 -.SH "オプション"
28.124 -.LP
28.125 -
28.126 -.LP
28.127 +.SH "激с"
28.128 +.RS 3
28.129 .TP 3
28.130 \-stack false/true
28.131 -オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
28.132 +吾с蚊綵若喝冴鴻帥菴処掘≦鴻障若潟у蚊綵泣ゃ宴篏睡с翫違 false 荐絎綽荀障 true с
28.133 .TP 3
28.134 \-refs false/true
28.135 -オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。つまり、参照者または受信参照) が計算されます。
28.136 +吾с吾с菴処掘≦鴻障 true сс若鴻吾сゃゃ潟 (絎吾сゃ潟吾с ц障篆≦с若違) 荐膊障
28.137 .TP 3
28.138 \-port port\-number
28.139 -jhat の HTTP サーバのポートを設定します。デフォルトは 7000 です。
28.140 +jhat HTTP 泣若若若荐絎障 7000 с
28.141 .TP 3
28.142 \-exclude exclude\-file
28.143 -「到達可能なオブジェクト」のクエリから除外すべきデータメンバの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
28.144 +育純吾сゅ鴻若帥<潟若筝荀с<ゃ絎障違<ゃ \f2java.lang.String.value\fP 障翫劫吾сo育純吾с鴻荐膊\f2java.lang.String.value\fP c若∫cс鴻障
28.145 .TP 3
28.146 \-baseline baseline\-dump\-file
28.147 -ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
28.148 +若鴻ゃ潟若潟絎障筝≧鴻若潟у吾с ID ゃ吾с域с若障篁吾с域若障違 2 ゃ若潟罸莠綵合<障
28.149 .TP 3
28.150 \-debug int
28.151 -このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
28.152 +若違荐絎障0 医阪潟障紊сゃ荐絎激≪若障
28.153 .TP 3
28.154 \-version\
28.155 -バージョン番号を報告したあと、終了します。
28.156 +若吾с括垩怨腟篋障
28.157 .TP 3
28.158 \-h\
28.159 -ヘルプメッセージを出力したあと、終了します。
28.160 +<祉若吾阪腟篋障
28.161 .TP 3
28.162 \-help\
28.163 -ヘルプメッセージを出力したあと、終了します。
28.164 +<祉若吾阪腟篋障
28.165 .TP 3
28.166 \-J<flag>\
28.167 -jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
28.168 -.LP
28.169 -.SH "関連項目"
28.170 -.LP
28.171 -.RS 3
28.172 -.TP 2
28.173 -*
28.174 -jmap \- Java メモリマップ
28.175 -.TP 2
28.176 -*
28.177 -jconsole \- Java 監視および管理コンソール
28.178 -.TP 2
28.179 -*
28.180 -.na
28.181 -\f2hprof \- ヒープおよび CPU プロファイリングツール\fP
28.182 -.fi
28.183 -(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html)
28.184 +jhat 絎茵 Java 篁潟激潟 <flag> 羝<障違512M ゃ紊с若泣ゃ冴篏睡\-J\-Xmx512m 障
28.185 .RE
28.186
28.187 .LP
28.188 -
28.189 -.LP
28.190 +.SH "∫i"
28.191 +.RS 3
28.192 +.TP 2
28.193 +o
28.194 +jmap(1)
28.195 +.TP 2
28.196 +o
28.197 +jconsole(1)
28.198 +.TP 2
28.199 +o
28.200 +.na
28.201 +\f2hprof \- 若 CPU <ゃ潟違若\fP @
28.202 +.fi
28.203 +http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
28.204 +.RE
28.205 +.RE
28.206
29.1 --- a/src/linux/doc/man/ja/jinfo.1 Tue May 12 15:21:55 2009 +0900
29.2 +++ b/src/linux/doc/man/ja/jinfo.1 Thu May 14 00:17:25 2009 -0700
29.3 @@ -1,72 +1,108 @@
29.4 -'\" t
29.5 -.\"
29.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
29.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
29.8 -.\"
29.9 -.\" This code is free software; you can redistribute it and/or modify it
29.10 -.\" under the terms of the GNU General Public License version 2 only, as
29.11 -.\" published by the Free Software Foundation.
29.12 -.\"
29.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
29.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
29.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
29.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
29.17 -.\" accompanied this code).
29.18 -.\"
29.19 -.\" You should have received a copy of the GNU General Public License version
29.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
29.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
29.22 -.\"
29.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
29.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
29.25 -.\" have any questions.
29.26 -.\"
29.27 -.\"
29.28 -.TH jinfo 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
29.29 -.SH 名前
29.30 -jinfo \- 構成情報
29.31 -.\"
29.32 -.SH 形式
29.33 -.B jinfo
29.34 -.BI [ option ] " pid"
29.35 -.br
29.36 -.B jinfo
29.37 -.BI [ option ] " executable core"
29.38 -.br
29.39 -.B jinfo
29.40 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
29.41 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
29.42 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
29.43 +."
29.44 +." This code is free software; you can redistribute it and/or modify it
29.45 +." under the terms of the GNU General Public License version 2 only, as
29.46 +." published by the Free Software Foundation.
29.47 +."
29.48 +." This code is distributed in the hope that it will be useful, but WITHOUT
29.49 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
29.50 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
29.51 +." version 2 for more details (a copy is included in the LICENSE file that
29.52 +." accompanied this code).
29.53 +."
29.54 +." You should have received a copy of the GNU General Public License version
29.55 +." 2 along with this work; if not, write to the Free Software Foundation,
29.56 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
29.57 +."
29.58 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
29.59 +." CA 95054 USA or visit www.sun.com if you need additional information or
29.60 +." have any questions.
29.61 +."
29.62 +.TH jinfo 1 "04 May 2009"
29.63 +." Generated from HTML by html2man (author: Eric Armstrong)
29.64 +
29.65 .LP
29.66 -.SH パラメータ
29.67 +.SH ""
29.68 +jinfo \- 罕
29.69 +.LP
29.70 +.RS 3
29.71 +.TP 2
29.72 +o
29.73 +綵√
29.74 +.TP 2
29.75 +o
29.76 +<若
29.77 +.TP 2
29.78 +o
29.79 +茯
29.80 +.TP 2
29.81 +o
29.82 +激с
29.83 +.TP 2
29.84 +o
29.85 +∫i
29.86 +.RE
29.87 +
29.88 +.LP
29.89 +.SH "綵√"
29.90 .LP
29.91
29.92 .LP
29.93 +.nf
29.94 +\f3
29.95 +.fl
29.96 +\fP\f3jinfo\fP [ option ] pid
29.97 +.fl
29.98 +\f3jinfo\fP [ option ] executable core
29.99 +.fl
29.100 +\f3jinfo\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
29.101 +.fl
29.102 +.fi
29.103 +
29.104 +.LP
29.105 +.SH "<若"
29.106 +.LP
29.107 +
29.108 +.LP
29.109 +.RS 3
29.110 .TP 3
29.111 -option
29.112 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
29.113 +option
29.114 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
29.115 +.RS 3
29.116 .TP 3
29.117 -pid
29.118 -構成情報を出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
29.119 -.B jps
29.120 -を使用します。
29.121 +pid
29.122 +阪罕宴祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
29.123 +.RE
29.124 +.RS 3
29.125 .TP 3
29.126 executable
29.127 -コアダンプが生成された Java 実行可能ファイル。
29.128 +潟≪潟篏 Java 絎茵純<ゃс
29.129 +.RE
29.130 +.RS 3
29.131 .TP 3
29.132 core
29.133 -構成情報を出力するコアファイル。
29.134 +阪罕宴潟≪<ゃ
29.135 +.RE
29.136 +.RS 3
29.137 .TP 3
29.138 remote\-hostname\-or\-IP
29.139 -リモートデバッグサーバ (
29.140 -.B jsadebugd
29.141 -を参照) のホスト名または IP アドレス。
29.142 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
29.143 +.RE
29.144 +.RS 3
29.145 .TP 3
29.146 server\-id
29.147 -同じリモートホスト上で複数のデバッグサーバが実行している場合の、オプションの一意 ID。
29.148 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
29.149 +.RE
29.150 +.RE
29.151 +
29.152 .LP
29.153 -.SH 機能説明
29.154 -.B jinfo
29.155 -は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバの Java 構成情報を出力します。構成情報には、Java システムプロパティと Java 仮想マシンコマンド行フラグが含まれます。
29.156 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
29.157 +.SH "茯"
29.158 +.LP
29.159 +
29.160 +.LP
29.161 +.LP
29.162 +\f3jinfo\fP 絎 Java 祉鴻潟≪<ゃ障≪若違泣若若 Java 罕宴阪障罕宴Java 激鴻c若 Java 篁潟激潟潟潟茵違罕障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
29.163 .br
29.164
29.165 .LP
29.166 @@ -76,51 +112,55 @@
29.167 jinfo \-J\-d64 \-sysprops pid
29.168 .RE
29.169 .LP
29.170 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
29.171 -Windows 上の jinfo でサポートされているのは、実行中のプロセスの \-flag オプションだけです。
29.172 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 筝 jinfo с泣若絎茵筝祉鴻 \-flag 激с潟с\fP
29.173 .LP
29.174 -.SH オプション
29.175 -.if t .TP 20
29.176 -.if n .TP 15
29.177 -.B " <no option>"
29.178 -コマンド行フラグとシステムプロパティと値のペアの両方を出力します。
29.179 +.SH "激с"
29.180 +.LP
29.181 +
29.182 +.LP
29.183 +.RS 3
29.184 +.TP 3
29.185 +<激с潟>
29.186 +潟潟茵違激鴻c弱ゃ≪阪障
29.187 .br
29.188 .TP 3
29.189 \-flag name
29.190 -指定されたコマンド行フラグの名前と値を出力します。
29.191 +絎潟潟茵違ゃ阪障
29.192 .br
29.193 .TP 3
29.194 \-flag [+|\-]name
29.195 -指定されたブール型のコマンド行フラグを有効または無効にします。
29.196 +絎若潟潟茵違鴻障≦鴻障
29.197 .br
29.198 .TP 3
29.199 \-flag name=value
29.200 -指定されたコマンド行フラグを指定された値に設定します。
29.201 -.if t .TP 20
29.202 -.if n .TP 15
29.203 -.B \-flags
29.204 -JVM に渡されるコマンド行フラグをペアで出力します。
29.205 -.if t .TP 20
29.206 -.if n .TP 15
29.207 -.B \-sysprops
29.208 -Java システムプロパティを名前と値のペアとして出力します。
29.209 -.if t .TP 20
29.210 -.if n .TP 15
29.211 -.B \-h
29.212 -ヘルプメッセージを出力します。
29.213 -.if t .TP 20
29.214 -.if n .TP 15
29.215 -.B \-help
29.216 -ヘルプメッセージを出力します。
29.217 -.SH 関連項目
29.218 +絎潟潟茵違絎ゃ荐絎障
29.219 +.br
29.220 +.TP 3
29.221 +\-flags
29.222 +JVM 羝<潟潟茵違≪у阪障
29.223 +.br
29.224 +.TP 3
29.225 +\-sysprops
29.226 +Java 激鴻c若ゃ≪阪障
29.227 +.br
29.228 +.TP 3
29.229 +\-h
29.230 +<祉若吾阪障
29.231 +.TP 3
29.232 +\-help
29.233 +<祉若吾阪障
29.234 +.RE
29.235 +
29.236 +.LP
29.237 +.SH "∫i"
29.238 .LP
29.239 .RS 3
29.240 .TP 2
29.241 -*
29.242 -jps
29.243 +o
29.244 +jps(1)
29.245 .TP 2
29.246 -*
29.247 -jsadebugd
29.248 +o
29.249 +jsadebugd(1)
29.250 .RE
29.251
29.252 .LP
30.1 --- a/src/linux/doc/man/ja/jmap.1 Tue May 12 15:21:55 2009 +0900
30.2 +++ b/src/linux/doc/man/ja/jmap.1 Thu May 14 00:17:25 2009 -0700
30.3 @@ -1,73 +1,103 @@
30.4 -'\" t
30.5 -.\"
30.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
30.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
30.8 -.\"
30.9 -.\" This code is free software; you can redistribute it and/or modify it
30.10 -.\" under the terms of the GNU General Public License version 2 only, as
30.11 -.\" published by the Free Software Foundation.
30.12 -.\"
30.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
30.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
30.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
30.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
30.17 -.\" accompanied this code).
30.18 -.\"
30.19 -.\" You should have received a copy of the GNU General Public License version
30.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
30.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
30.22 -.\"
30.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
30.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
30.25 -.\" have any questions.
30.26 -.\"
30.27 -.\"
30.28 -.TH jmap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
30.29 -.SH 名前
30.30 -jmap \- メモリマップ
30.31 -.\"
30.32 -.SH 形式
30.33 -.B jmap
30.34 -.BI [ option ] " pid"
30.35 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
30.36 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
30.37 +."
30.38 +." This code is free software; you can redistribute it and/or modify it
30.39 +." under the terms of the GNU General Public License version 2 only, as
30.40 +." published by the Free Software Foundation.
30.41 +."
30.42 +." This code is distributed in the hope that it will be useful, but WITHOUT
30.43 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
30.44 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
30.45 +." version 2 for more details (a copy is included in the LICENSE file that
30.46 +." accompanied this code).
30.47 +."
30.48 +." You should have received a copy of the GNU General Public License version
30.49 +." 2 along with this work; if not, write to the Free Software Foundation,
30.50 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
30.51 +."
30.52 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
30.53 +." CA 95054 USA or visit www.sun.com if you need additional information or
30.54 +." have any questions.
30.55 +."
30.56 +.TH jmap 1 "04 May 2009"
30.57 +." Generated from HTML by html2man (author: Eric Armstrong)
30.58 +
30.59 +.LP
30.60 +.SH ""
30.61 +jmap \- <≪若
30.62 +.LP
30.63 +.RS 3
30.64 +.TP 2
30.65 +o
30.66 +綵√
30.67 +.TP 2
30.68 +o
30.69 +<若
30.70 +.TP 2
30.71 +o
30.72 +茯
30.73 +.TP 2
30.74 +o
30.75 +激с
30.76 +.TP 2
30.77 +o
30.78 +∫i
30.79 +.RE
30.80 +
30.81 +.LP
30.82 +.SH "綵√"
30.83 +.LP
30.84 +
30.85 +.LP
30.86 +.nf
30.87 +\f3
30.88 +.fl
30.89 +\fP\f3jmap\fP [ option ] pid
30.90 +.fl
30.91 +\f3jmap\fP [ option ] executable core
30.92 +.fl
30.93 +\f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
30.94 +.fl
30.95 +.fi
30.96 +
30.97 +.LP
30.98 +.SH "<若"
30.99 +.LP
30.100 +
30.101 +.LP
30.102 +.RS 3
30.103 +.TP 3
30.104 +option
30.105 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
30.106 +.TP 3
30.107 +pid
30.108 +医激<≪若祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
30.109 .br
30.110 -.B jmap
30.111 -.BI [ option ] " executable core"
30.112 +.TP 3
30.113 +executable
30.114 +潟≪潟篏 Java 絎茵純<ゃс
30.115 .br
30.116 -.B jmap
30.117 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
30.118 -.SH パラメータ
30.119 -.if t .TP 20
30.120 -.if n .TP 15
30.121 -.BI option
30.122 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
30.123 -.if t .TP 20
30.124 -.if n .TP 15
30.125 -.I pid
30.126 -メモリマップを表示するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
30.127 -.B jps
30.128 -を使用します。
30.129 -.if t .TP 20
30.130 -.if n .TP 15
30.131 -.I executable
30.132 -コアダンプが生成された Java 実行可能ファイル。
30.133 -.if t .TP 20
30.134 -.if n .TP 15
30.135 -.I core
30.136 -メモリマップを表示するコアファイル。
30.137 -.if t .TP 20
30.138 -.if n .TP 15
30.139 -.I remote-hostname-or-IP
30.140 -リモートデバッグサーバ (
30.141 -.B jsadebugd
30.142 -を参照) のホスト名または IP アドレス。
30.143 -.if t .TP 20
30.144 -.if n .TP 15
30.145 -.I server-id
30.146 -同じリモートホスト上で複数のデバッグサーバが実行している場合、オプションの一意 ID。
30.147 -.SH 機能説明
30.148 -.B jmap
30.149 -は、指定されたプロセスまたはコアファイルまたはリモートデバッグサーバの、共有オブジェクトメモリマップまたはヒープメモリの詳細を表示します。
30.150 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
30.151 +.TP 3
30.152 +core
30.153 +医激<≪若潟≪<ゃ
30.154 +.br
30.155 +.TP 3
30.156 +remote\-hostname\-or\-IP
30.157 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
30.158 +.br
30.159 +.TP 3
30.160 +server\-id
30.161 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
30.162 +.br
30.163 +.RE
30.164 +
30.165 +.LP
30.166 +.SH " 茯"
30.167 +.LP
30.168 +
30.169 +.LP
30.170 +.LP
30.171 +\f3jmap\fP 絎祉鴻潟≪<ゃ障≪若違泣若若援吾с<≪若障若<≪若荅括完医激障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
30.172 .LP
30.173 .RS 3
30.174
30.175 @@ -82,82 +112,87 @@
30.176 .RE
30.177
30.178 .LP
30.179 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
30.180 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障\fP
30.181 .br
30.182
30.183 .LP
30.184 -Windows プラットフォーム上で使用可能な唯一の jmap 形式は、次のとおりです。
30.185 +Windows 若筝т戎純筝 jmap 綵√罨<с
30.186 .RS 3
30.187
30.188 .LP
30.189 jmap \-dump:<\f2dump\-options\fP> pid
30.190 .RE
30.191 -および
30.192 +
30.193 .RS 3
30.194
30.195 .LP
30.196 jmap \-histo[:live] pid
30.197 .RE
30.198 -.SH オプション
30.199 -.if t .TP 20
30.200 -.if n .TP 15
30.201 -.BI " <no option>"
30.202 -オプションが使用されなかった場合、
30.203 -.B jmap
30.204 -は共有オブジェクトマッピングを表示します。ターゲット VM に読み込まれた各共有オブジェクトについて、開始アドレス、マッピングのサイズ、および共有オブジェクトファイルのフルパスが表示されます。これは、Solaris の
30.205 -.B pmap
30.206 -ユーティリティと同様です。
30.207 +.SH "激с"
30.208 +.LP
30.209 +
30.210 +.LP
30.211 +.RS 3
30.212 +.TP 3
30.213 +<激с潟>
30.214 +激с潟篏睡翫\f3jmap\fP 援吾с潟違医激障帥若蚊 VM 若援吾с紮≪鴻潟違泣ゃ冴喝援吾с<ゃ鴻医激障Solaris \f3pmap\fP 若cc若蕁篌若障
30.215 +.br
30.216 .TP 3
30.217 \-dump:[live,]format=b,file=<filename>
30.218 -Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat (Java Heap Analysis Tool) を使って読み取ります。
30.219 +Java 若 hprof ゃ綵√ filename 潟障\f2live\fP 泣激с潟ュ純с絎翫若х絖筝吾с帥潟障若潟с<ゃ jhat(1) (Java Heap Analysis Tool) 篏帥c茯水障
30.220 +.br
30.221 .TP 3
30.222 \-finalizerinfo
30.223 -ファイナライズを待っているオブジェクトに関する情報を出力します。
30.224 -.if t .TP 20
30.225 -.if n .TP 15
30.226 -.B \-heap
30.227 -ヒープのサマリを表示します。使用された GC アルゴリズム、ヒープ構成、および生成規模のヒープ使用率が表示されます。
30.228 -.if t .TP 20
30.229 -.if n .TP 15
30.230 -.B \-histo[:live]
30.231 -ヒープのヒストグラムを表示します。各 Java クラスについて、オブジェクト数、メモリサイズ(バイト数)、および完全修飾クラス名が表示されます。VM 内部クラス名の前には '*' が表示されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
30.232 -.if t .TP 20
30.233 -.if n .TP 15
30.234 -.B \-permstat
30.235 -Java ヒープの永続的生成のクラスローダ規模の統計を表示します。各クラスローダについて、名前、活動性、アドレス、親クラスローダ、および読み込まれたクラスのサイズが表示されます。
30.236 -さらに、intern された文字列の数とサイズも出力されます。
30.237 +<ゃゃ冴緇c吾с≪宴阪障
30.238 +.br
30.239 +.TP 3
30.240 +\-heap
30.241 +若泣若医激障篏睡 GC ≪眼冴若罕割篁c若篏睡医激障
30.242 +.br
30.243 +.TP 3
30.244 +\-histo[:live]
30.245 +若鴻違医激障Java 鴻吾с違ゃ篏с<≪若泣ゃ冴喝篆蕋障劫医激障VM 劫*・莨篁医激障\f2live\fP 泣激с潟絎翫絖筝吾с帥潟障
30.246 +.br
30.247 +.TP 3
30.248 +\-permstat
30.249 +Permanent 筝篁c Java 若鴻若守∫c腟沿若帥医激障鴻若若倶≪鴻荀鴻若若潟鴻若若若鴻違泣ゃ冴医激障intern 絖違泣ゃ冴阪障
30.250 +.br
30.251 .TP 3
30.252 \-F
30.253 -強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
30.254 -.if t .TP 20
30.255 -.if n .TP 15
30.256 -.B \-h
30.257 -ヘルプメッセージを表示します。
30.258 -.if t .TP 20
30.259 -.if n .TP 15
30.260 -.B \-help
30.261 -ヘルプメッセージを表示します。
30.262 +綣桁 (Force)pid 綽膈翫jmap \-dump 障 jmap \-histo 激с潟篏睡障≪若с\f2live\fP 泣激с潟泣若障
30.263 +.br
30.264 +.TP 3
30.265 +\-h
30.266 +<祉若吾医激障
30.267 +.br
30.268 +.br
30.269 +.TP 3
30.270 +\-help
30.271 +<祉若吾医激障
30.272 +.br
30.273 .br
30.274 .TP 3
30.275 \-J<flag>
30.276 -jmap が実行されている Java 仮想マシンに <flag> を渡します。
30.277 +jmap 絎茵 Java 篁潟激潟 <flag> 羝<障
30.278 +.br
30.279 +.RE
30.280
30.281 .LP
30.282 -.SH 関連項目
30.283 +.SH "∫i"
30.284 .LP
30.285 .RS 3
30.286 .TP 2
30.287 -*
30.288 +o
30.289 pmap (1)
30.290 .TP 2
30.291 -*
30.292 -jhat
30.293 +o
30.294 +jhat(1)
30.295 .TP 2
30.296 -*
30.297 -jps
30.298 +o
30.299 +jps(1)
30.300 .TP 2
30.301 -*
30.302 -jsadebugd
30.303 +o
30.304 +jsadebugd(1)
30.305 .RE
30.306
30.307 .LP
31.1 --- a/src/linux/doc/man/ja/jps.1 Tue May 12 15:21:55 2009 +0900
31.2 +++ b/src/linux/doc/man/ja/jps.1 Thu May 14 00:17:25 2009 -0700
31.3 @@ -1,204 +1,294 @@
31.4 -'\" t
31.5 -.\"
31.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
31.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
31.8 -.\"
31.9 -.\" This code is free software; you can redistribute it and/or modify it
31.10 -.\" under the terms of the GNU General Public License version 2 only, as
31.11 -.\" published by the Free Software Foundation.
31.12 -.\"
31.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
31.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
31.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
31.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
31.17 -.\" accompanied this code).
31.18 -.\"
31.19 -.\" You should have received a copy of the GNU General Public License version
31.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
31.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
31.22 -.\"
31.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
31.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
31.25 -.\" have any questions.
31.26 -.\"
31.27 -.\"
31.28 -.TH jps 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
31.29 -.SH 名前
31.30 -jps \- Java 仮想マシンプロセスステータスツール
31.31 -.\"
31.32 -.SH 形式
31.33 -.B jps
31.34 -.BI [ options ]
31.35 -.BI [ hostid ]
31.36 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
31.37 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
31.38 +."
31.39 +." This code is free software; you can redistribute it and/or modify it
31.40 +." under the terms of the GNU General Public License version 2 only, as
31.41 +." published by the Free Software Foundation.
31.42 +."
31.43 +." This code is distributed in the hope that it will be useful, but WITHOUT
31.44 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
31.45 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
31.46 +." version 2 for more details (a copy is included in the LICENSE file that
31.47 +." accompanied this code).
31.48 +."
31.49 +." You should have received a copy of the GNU General Public License version
31.50 +." 2 along with this work; if not, write to the Free Software Foundation,
31.51 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
31.52 +."
31.53 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
31.54 +." CA 95054 USA or visit www.sun.com if you need additional information or
31.55 +." have any questions.
31.56 +."
31.57 +.TH jps 1 "04 May 2009"
31.58 +." Generated from HTML by html2man (author: Eric Armstrong)
31.59 +
31.60 .LP
31.61 -.SH パラメータ
31.62 -.if t .TP 20
31.63 -.if n .TP 15
31.64 -.I options
31.65 -コマンド行オプション。
31.66 -.if t .TP 20
31.67 -.if n .TP 15
31.68 -.I hostid
31.69 -プロセスレポートを生成するホストのホスト識別子。
31.70 -.I hostid
31.71 -には、通信プロトコル、ポート番号、およびその他固有の実装データを示すオプションコンポーネントを含めることができます。
31.72 -.SH 機能説明
31.73 -.B jps
31.74 -ツールは、ターゲットシステム上の計測機構付き HotSpot Java 仮想マシン (JVM) をリストします。このツールは、アクセス権がある JVM 上の情報だけを報告します。
31.75 -.LP
31.76 -ホスト ID を指定せずに
31.77 -.B jps
31.78 -が実行された場合は、ローカルホスト上の計測機構付き JVM を探します。ホスト ID が指定された場合は、指定されたホスト上の JVM を、指定されたプロトコルとポートを使用して探します。
31.79 -.B jstatd
31.80 -プロセスがターゲットホスト上で稼動していることが前提となります。
31.81 -.LP
31.82 -.B jps
31.83 -コマンドは、ターゲットシステム上で見つかった計測機構付き JVM のそれぞれについて、ローカル VM 識別子 (lvmid) を報告します。lvmid は、一般に、オペレーティングシステムの JVM プロセスのプロセス識別子ですが、必ずしもそうとは限りません。オプションが指定されなかった場合、
31.84 -.B jps
31.85 -は各 Java アプリケーションの lvmid の後に短い形式のアプリケーションのクラス名または jar ファイル名を続けてリストします。短い形式のクラス名または JAR ファイル名では、クラスのパッケージ情報や JAR ファイルのパス情報は省かれます。
31.86 -.LP
31.87 -.B jps
31.88 -コマンドは java 起動ツールを使用して、クラス名と main メソッドに渡された引数を探します。ターゲット JVM がカスタム起動ツールで起動された場合、クラス名 (または JAR ファイル名) と main メソッドに渡された引数は入手できません。この場合、
31.89 -.B jps
31.90 -コマンドは、クラス名または JAR ファイル名と main メソッドの引数として、Unknown という文字列を出力します。
31.91 -.LP
31.92 -.B jps
31.93 -コマンドによって生成される JVM のリストは、コマンドを実行した主体に許可されているアクセス権によって制限されることがあります。このコマンドは、オペレーティングシステム固有のアクセス制御機構に従って、主体がアクセス権を持っている JVM だけをリストします。
31.94 -.LP
31.95 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現在、Windows 98 および Windows ME プラットフォームでは使用できません。
31.96 -.SH オプション
31.97 -.B jps
31.98 -コマンドは、コマンド出力を変更する多数のオプションをサポートしています。これらのオプションは、将来、変更または削除されることがあります。
31.99 -.if t .TP 20
31.100 -.if n .TP 15
31.101 -.BI \-q
31.102 -クラス名、JAR ファイル名、および main メソッドに渡された引数の出力を抑制して、ローカル VM 識別子のリストだけを生成します。
31.103 -.if t .TP 20
31.104 -.if n .TP 15
31.105 -.BI \-m
31.106 -main メソッドに渡された引数を出力します。埋め込み JVM の場合、出力は NULL になることがあります。
31.107 -.if t .TP 20
31.108 -.if n .TP 15
31.109 -.BI \-l
31.110 -アプリケーションの main クラスのフルパッケージ名、またはアプリケーションの JAR ファイルのフルパス名を出力します。
31.111 -.if t .TP 20
31.112 -.if n .TP 15
31.113 -.BI \-v
31.114 -JVM に渡された引数を出力します。
31.115 -.if t .TP 20
31.116 -.if n .TP 15
31.117 -.BI \-V
31.118 -フラグファイル (.hotspotrc ファイル、または -XX:Flags=<filename> 引数によって指定されたファイル) を通じて JVM に渡された引数を出力します。
31.119 -.if t .TP 20
31.120 -.if n .TP 15
31.121 -.BI \-J "option"
31.122 -.B jps
31.123 -によって呼び出された java 起動ツールにオプションを渡します。
31.124 -たとえば、-J-Xms48m は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、\-J の一般的規則です。
31.125 -.SH ホスト識別子
31.126 -ホスト識別子 (hostid) は、ターゲットシステムを示す文字列です。hostid 文字列の構文は、URI の構文とほぼ同じです。
31.127 -.LP
31.128 -.RS
31.129 -.ft 3
31.130 -.nf
31.131 -[protocol:][[//]hostname][:port][/servername]
31.132 -.fi
31.133 -.ft 1
31.134 -.RE
31.135 -.if t .TP 20
31.136 -.if n .TP 15
31.137 -.B protocol
31.138 -通信プロトコル。protocol が省かれ、hostname が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。protocol が省かれ、hostname が指定された場合、デフォルトのプロトコルは rmi です。
31.139 -.if t .TP 20
31.140 -.if n .TP 15
31.141 -.I hostname
31.142 -ターゲットホストを示すホスト名または IP アドレス。hostname が省かれた場合、ターゲットホストはローカルホストです。
31.143 -.if t .TP 20
31.144 -.if n .TP 15
31.145 -.I port
31.146 -リモートサーバーと通信するためのデフォルトポート。hostname が省かれるか、protocol が最適化されたローカルプロトコルを指定している場合、port は無視されます。そうでない場合、port パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、port はリモートホスト上の rmiregistry のポート番号を示します。port が省かれ、protocol が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。
31.147 -.if t .TP 20
31.148 -.if n .TP 15
31.149 -.I servername
31.150 -このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表す文字列です。
31.151 -.B jstatd
31.152 -コマンドの \-n オプションを参照してください。
31.153 -.SH 出力形式
31.154 -jps コマンドの出力は、次のパターンに従います。
31.155 -.LP
31.156 -.RS
31.157 -.ft 3
31.158 -.nf
31.159 -lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]
31.160 -.fi
31.161 -.ft 1
31.162 -.RE
31.163 -.LP
31.164 -出力トークンはすべて、空白で区切られます。埋め込まれた空白を含む arg があると、引数を実際の位置パラメータにマップするときにあいまいさが生じます。
31.165 -.LP
31.166 -注 - 将来のリリースで形式が変更される可能性があるので、
31.167 -.B jps
31.168 -の出力を解析するスクリプトは書かない方がよいでしょう。jps 出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを予想しておいてください。
31.169 -.SH 使用例
31.170 -このセクションでは、
31.171 -.B jps
31.172 -コマンドの例を示します。
31.173 -.LP
31.174 -ローカルホスト上の計測機構付き JVM をリストする:
31.175 -.LP
31.176 -.RS
31.177 -.ft 3
31.178 -.nf
31.179 -jps
31.180 -18027 Java2Demo.JAR
31.181 -18032 jps
31.182 -18005 jstat
31.183 -.fi
31.184 -.ft 1
31.185 -.RE
31.186 -.TP
31.187 -リモートホスト上の計測機構付き JVM をリストする:
31.188 -.LP
31.189 -この例では、jstat サーバーとその内部 RMI レジストリまたは個別の外部 rmiregistry プロセスがリモートホストのデフォルトポート (ポート 1099) で実行していることを前提としています。また、ローカルホストはリモートホストにアクセスするための適切なアクセス権を持っているものとします。また、この例には、長い形式のクラス名または JAR ファイル名を出力するための -l オプションが含まれています。
31.190 -.LP
31.191 -.RS
31.192 -.ft 3
31.193 -.nf
31.194 -jps -l remote.domain
31.195 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
31.196 -2857 sun.tools.jstatd.jstatd
31.197 -.fi
31.198 -.ft 1
31.199 -.RE
31.200 -.LP
31.201 -RMI レジストリ用にデフォルト以外のポートを使用するリモートホスト上の計測機構付き Java 仮想マシンをリストする:
31.202 -.LP
31.203 -この例では、jstatd サーバーがリモートホスト上で実行していて、内部 RMI レジストリがポート 2002 にバインドされていることを前提としています。また、この例では、リストされる各 Java アプリケーションの main メソッドに渡された引数を含めるために、-m オプションを使用しています。
31.204 -.LP
31.205 -.RS
31.206 -.ft 3
31.207 -.nf
31.208 -jps -m remote.domain:2002
31.209 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
31.210 -3102 sun.tools.jstatd.jstatd -p 2002
31.211 -.fi
31.212 -.ft 1
31.213 -.RE
31.214 -.SH 関連項目
31.215 +.SH ""
31.216 +jps \- Java 篁潟激潟祉鴻鴻若帥鴻若
31.217 .LP
31.218 .RS 3
31.219 .TP 2
31.220 -*
31.221 -java \- Java アプリケーション起動プログラム
31.222 +o
31.223 +綵√
31.224 .TP 2
31.225 -*
31.226 -jstat \- Java 仮想マシン統計監視ツール
31.227 +o
31.228 +<若
31.229 .TP 2
31.230 -*
31.231 -jstatd \- 仮想マシン jstat デーモン
31.232 +o
31.233 +茯
31.234 .TP 2
31.235 -*
31.236 -rmiregistry \- Java リモートオブジェクトレジストリ
31.237 +o
31.238 +激с
31.239 +.TP 2
31.240 +o
31.241 +鴻茘ュ
31.242 +.TP 2
31.243 +o
31.244 +阪綵√
31.245 +.TP 2
31.246 +o
31.247 +箴
31.248 +.TP 2
31.249 +o
31.250 +∫i
31.251 +.RE
31.252 +
31.253 +.LP
31.254 +.SH "綵√"
31.255 +.LP
31.256 +
31.257 +.LP
31.258 +.nf
31.259 +\f3
31.260 +.fl
31.261 +\fP\f3jps\fP [ \f2options\fP ] [ \f2hostid\fP ]
31.262 +.br
31.263 +
31.264 +.fl
31.265 +.fi
31.266 +
31.267 +.LP
31.268 +.SH "<若"
31.269 +.LP
31.270 +
31.271 +.LP
31.272 +.RS 3
31.273 +.TP 3
31.274 +options
31.275 +潟潟茵激с潟
31.276 +.TP 3
31.277 +hostid
31.278 +祉鴻若鴻鴻茘ュ\f2hostid\fP 篆<潟若垩絎茖堺篁若帥絎激с潟潟潟若潟с障
31.279 +.RE
31.280 +
31.281 +.LP
31.282 +.SH " 茯"
31.283 +.LP
31.284 +
31.285 +.LP
31.286 +.LP
31.287 +\f3jps\fP 若帥若蚊激鴻筝ц羝 HotSpot Java 篁潟激 (JVM) 筝荀ц;腓冴障若ц;腓冴с若宴≪祉号┤c JVM ≪絎障
31.288 +.LP
31.289 +.LP
31.290 +\f2hostid\fP 絎 \f3jps\fP 絎茵翫若鴻ц羝 JVM 罎膣≪障\f2hostid\fP 絎莎桁翫絎潟若篏睡絎鴻筝 JVM 罎膣≪障\f3jstatd\fP 祉鴻帥若蚊鴻筝у茵喝障
31.291 +.LP
31.292 +.LP
31.293 +\f3jps\fP 潟潟帥若蚊激鴻ц羝 JVM ゃ若 VM 茘ュゃ障 \f2lvmid\fP 若障\f3lvmid\fP 綽с障筝 JVM 祉鴻絲障若c潟違激鴻祉壕ュс激с潟絎翫\f3jps\fP c Java ≪宴若激с潟 \f2lvmid\fP 筝荀ц;腓冴≪宴若激с潟劫障 JAR <ゃ膂≦綵√хず障膂≦綵√劫 JAR <ゃс鴻宴若御宴障 JAR <ゃ号宴ャ障
31.294 +.LP
31.295 +.LP
31.296 +\f3jps\fP 潟潟\f3Java\fP 莎桁若篏睡\f2main\fP <純羝<劫綣違罎膣≪障莎桁若篏睡帥若蚊 JVM 莎桁翫\f2main\fP <純羝<劫 (障 JAR <ゃ) 綣違с障翫\f3jps\fP 潟潟main <純御検劫 (障 JAR <ゃ) 綣違絲障絖 \f2Unknown\fP 阪障
31.297 +.LP
31.298 +.LP
31.299 +\f3jps\fP 潟潟х JVM 鴻潟潟絎茵筝私筝≪祉号┤冴ャ狗翫障潟潟若c潟違激鴻≪祉劫九勝罘罕羆阪冴ャ筝私≪祉号┤筝 JVM 筝荀ц;腓冴障
31.300 +.LP
31.301 +.LP
31.302 +\f3羈:\fP 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
31.303 +.LP
31.304 +.SH "激с"
31.305 +.LP
31.306 +
31.307 +.LP
31.308 +.LP
31.309 +\f3jps\fP 潟潟с潟潟阪紊眼激с潟紊違泣若障絨ャ激с潟紊眼障綮罩≪醇с障
31.310 +.LP
31.311 +.RS 3
31.312 +.TP 3
31.313 +\-q
31.314 +若 VM 茘ュ鴻\f2main\fP <純羝<劫JAR <ゃ喝違阪九勝障
31.315 +.TP 3
31.316 +\-m
31.317 +main <純羝<綣違阪障阪腟粋昭障 JVM 絲障 null 障
31.318 +.TP 3
31.319 +\-l
31.320 +≪宴若激с潟筝肢鴻宴若後障≪宴若激с潟 JAR <ゃ吾劫阪障
31.321 +.TP 3
31.322 +\-v
31.323 +JVM 羝<綣違阪障
31.324 +.TP 3
31.325 +\-V
31.326 +違<ゃ (.hotspotrc <ゃ障 \-XX:Flags=<\f2filename\fP> 綣違ф絎<ゃ) JVM 羝<綣違阪障
31.327 +.TP 3
31.328 +\-Joption
31.329 +\f3jps\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
31.330 +.RE
31.331 +
31.332 +.LP
31.333 +.SS
31.334 +鴻茘ュ
31.335 +.LP
31.336 +.RS 3
31.337 +
31.338 +.LP
31.339 +.LP
31.340 +鴻茘ュゃ障 \f2hostid\fP 帥若蚊激鴻腓冴絖с\f2hostid\fP 絖罕紊чURI 罕絲上障
31.341 +.LP
31.342 +.nf
31.343 +\f3
31.344 +.fl
31.345 +[\fP\f4protocol\fP\f3:][[//]\fP\f4hostname\fP\f3][:\fP\f4port\fP\f3][/\fP\f4servername\fP\f3]\fP
31.346 +.br
31.347 +\f3
31.348 +.fl
31.349 +\fP
31.350 +.fi
31.351 +
31.352 +.LP
31.353 +.RS 3
31.354 +.TP 3
31.355 +protocol
31.356 +篆<潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
31.357 +.TP 3
31.358 +hostname
31.359 +帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
31.360 +.TP 3
31.361 +port
31.362 +≪若泣若若篆<若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP <若帥宴絎茖c違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
31.363 +.TP 3
31.364 +servername
31.365 +<若帥宴絎茖c違障若潟翫c若∴障\f3rmi\fP 潟翫<若帥≪若鴻筝 RMI ≪若吾с腓冴絖障jstatd(1) 潟潟ゃ\f3\-n\fP 激с潟с
31.366 +.RE
31.367 +
31.368 +.LP
31.369 +.RE
31.370 +.SH "阪綵√"
31.371 +.LP
31.372 +
31.373 +.LP
31.374 +.LP
31.375 +\f3jps\fP 潟潟阪罨<帥若潟緇障
31.376 +.LP
31.377 +.nf
31.378 +\f3
31.379 +.fl
31.380 +\fP\f4lvmid\fP\f3 [ [ \fP\f4classname\fP\f3 | \fP\f4JARfilename\fP\f3 | "Unknown"] [ \fP\f4arg\fP\f3* ] [ \fP\f4jvmarg\fP\f3* ] ]\fP
31.381 +.br
31.382 +\f3
31.383 +.fl
31.384 +\fP
31.385 +.fi
31.386 +
31.387 +.LP
31.388 +.LP
31.389 +鴻阪若潟腥榊純у阪障\f2arg\fP 筝х榊純篏睡絎絎篏臀<若帥綣違潟違障障
31.390 +.br
31.391 +.br
31.392 +\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jps\fP 阪茹f鴻篏с障\f3jps\fP 阪茹f鴻篏若絨ャ若鴻с篏鴻紊眼綽荀篋羝障
31.393 +.br
31.394 +
31.395 +.LP
31.396 +.SH "箴"
31.397 +.LP
31.398 +
31.399 +.LP
31.400 +.LP
31.401 +膀с\f3jps\fP 潟潟箴腓冴障
31.402 +.LP
31.403 +.LP
31.404 +若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
31.405 +.LP
31.406 +.nf
31.407 +\f3
31.408 +.fl
31.409 +\fP\f3jps\fP
31.410 +.br
31.411 +
31.412 +.fl
31.413 +18027 Java2Demo.JAR
31.414 +.br
31.415 +
31.416 +.fl
31.417 +18032 jps
31.418 +.br
31.419 +
31.420 +.fl
31.421 +18005 jstat
31.422 +.br
31.423 +
31.424 +.fl
31.425 +.fi
31.426 +
31.427 +.LP
31.428 +.LP
31.429 +≪若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
31.430 +.LP
31.431 +.LP
31.432 +箴с\f3jstat\fP 泣若若 RMI 吾鴻障ャ紊 \f3rmiregistry\fP 祉鴻≪若鴻若 (若 1099) у茵喝障障若鴻≪若鴻吾鴻≪祉号┤c喝障箴\f2\-l\fP 激с潟障劫障 JAR <ゃ荅括完綵√у阪障
31.433 +.LP
31.434 +.nf
31.435 +\f3
31.436 +.fl
31.437 +\fP\f3jps \-l remote.domain\fP
31.438 +.br
31.439 +
31.440 +.fl
31.441 +3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
31.442 +.br
31.443 +
31.444 +.fl
31.445 +2857 sun.tools.jstatd.jstatd
31.446 +.br
31.447 +
31.448 +.fl
31.449 +.fi
31.450 +
31.451 +.LP
31.452 +.LP
31.453 +RMI 吾鴻с若篏睡≪若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
31.454 +.LP
31.455 +.LP
31.456 +箴с RMI 吾鴻若 2002 ゃ潟 \f3jstatd\fP 泣若若≪若鴻筝у茵喝障障\f2\-m\fP 激с潟篏睡筝荀ц;腓冴 Java ≪宴若激с潟 \f2main\fP <純羝<綣違腟粋昭с障
31.457 +.LP
31.458 +.nf
31.459 +\f3
31.460 +.fl
31.461 +\fP\f3jps \-m remote.domain:2002\fP
31.462 +.br
31.463 +
31.464 +.fl
31.465 +3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
31.466 +.br
31.467 +
31.468 +.fl
31.469 +3102 sun.tools.jstatd.jstatd \-p 2002
31.470 +.fl
31.471 +.fi
31.472 +
31.473 +.LP
31.474 +.SH "∫i"
31.475 +.LP
31.476 +.RS 3
31.477 +.TP 2
31.478 +o
31.479 +java(1) \- Java ≪宴若激с活儀若
31.480 +.TP 2
31.481 +o
31.482 +jstat(1) \- Java 篁潟激括輝荐若睡h若
31.483 +.TP 2
31.484 +o
31.485 +jstatd(1) \- 篁潟激 jstat 若≪潟
31.486 +.TP 2
31.487 +o
31.488 +rmiregistry(1) \- Java ≪若吾с吾鴻
31.489 .RE
31.490
31.491 .LP
32.1 --- a/src/linux/doc/man/ja/jrunscript.1 Tue May 12 15:21:55 2009 +0900
32.2 +++ b/src/linux/doc/man/ja/jrunscript.1 Thu May 14 00:17:25 2009 -0700
32.3 @@ -1,5 +1,3 @@
32.4 -.'" t
32.5 -."
32.6 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
32.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
32.8 ."
32.9 @@ -21,15 +19,39 @@
32.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
32.11 ." have any questions.
32.12 ."
32.13 -." `
32.14 -.TH jrunscript 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
32.15 -." Generated by html2roff
32.16 +.TH jrunscript 1 "04 May 2009"
32.17 +." Generated from HTML by html2man (author: Eric Armstrong)
32.18
32.19 .LP
32.20 -.SH 名前
32.21 -jrunscript \- コマンド行スクリプトシェル
32.22 +.SH ""
32.23 +jrunscript \- 潟潟茵鴻激с
32.24 .LP
32.25 -.SH "形式"
32.26 +.RS 3
32.27 +.TP 2
32.28 +o
32.29 +綵√
32.30 +.TP 2
32.31 +o
32.32 +<若
32.33 +.TP 2
32.34 +o
32.35 +茯
32.36 +.TP 2
32.37 +o
32.38 +激с
32.39 +.TP 2
32.40 +o
32.41 +綣
32.42 +.TP 2
32.43 +o
32.44 +箴
32.45 +.TP 2
32.46 +o
32.47 +∫i
32.48 +.RE
32.49 +
32.50 +.LP
32.51 +.SH "綵√"
32.52 .LP
32.53
32.54 .LP
32.55 @@ -38,148 +60,166 @@
32.56 .fl
32.57 \fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
32.58 .fl
32.59 -
32.60 -.fl
32.61 .fi
32.62
32.63 .LP
32.64 -.SH "パラメータ"
32.65 +.SH "<若"
32.66 .LP
32.67
32.68 .LP
32.69 +.RS 3
32.70 .TP 3
32.71 options
32.72 -オプションを使用する場合、コマンド名の直後に記述してください。
32.73 +激с潟篏睡翫潟潟翫荐菴違
32.74 .TP 3
32.75 arguments
32.76 -引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
32.77 +綣違篏睡翫激с潟障潟潟翫荐菴違
32.78 +.RE
32.79 +
32.80 .LP
32.81 -.SH "説明"
32.82 +.SH " 茯"
32.83 .LP
32.84
32.85 .LP
32.86 .LP
32.87 -\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
32.88 +\f3jrunscript\fP 潟潟茵鴻激сс jrunscript 絲乗怨 (茯水 \- 荅箴 \- 阪) ≪若 (\-f 激с) ≪若筝≧鴻鴻絎茵泣若障鴻荐茯箴絖激сс篏睡荐茯 JavaScript с\-l 激с潟篏帥違祉荐茯絎с障jrunscript Java 鴻荐茯篆<c「羆違潟違鴻帥ゃ泣若障
32.89 .LP
32.90 .LP
32.91 -\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
32.92 +\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
32.93 .LP
32.94 -.SH "オプション"
32.95 +.SH "激с"
32.96 .LP
32.97
32.98 .LP
32.99 +.RS 3
32.100 .TP 3
32.101 \-classpath path
32.102 -スクリプトからのアクセス対象となるユーザの .class ファイルの検索場所を指定します。
32.103 +鴻≪祉劫乗院若吟若 .class <ゃ罎膣√贋絎障
32.104 .TP 3
32.105 \-cp path
32.106 -\-classpath \f2path\fP と同義です。
32.107 +\-classpath \f2path\fP 臂с
32.108 .TP 3
32.109 \-Dname=value
32.110 -Java のシステムプロパティを設定します。
32.111 +Java 激鴻c若荐絎障
32.112 .TP 3
32.113 \-J<flag>
32.114 -jrunscript が実行されている Java 仮想マシンに、直接 <flag> を渡します。
32.115 +jrunscript 絎茵 Java 篁潟激潟 <flag> 羝<障
32.116 .TP 3
32.117 \-l language
32.118 -指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。
32.119 +絎鴻荐茯篏睡障с JavaScript 篏睡障祉鴻荐茯篏睡絲上鴻潟吾潟 JAR <ゃ絎綽荀障 \-cp\-classpath 激с潟篏睡障
32.120 .TP 3
32.121 \-e script
32.122 -指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
32.123 +絎鴻荅箴<障激с潟篏帥違潟潟茵鴻絎1 茵鴻絎茵с障
32.124 .TP 3
32.125 \-encoding encoding
32.126 -スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
32.127 +鴻<ゃ茯水篏睡絖潟潟若c潟違絎障
32.128 .TP 3
32.129 \-f script\-file
32.130 -指定されたスクリプトファイルを評価します (バッチモード)。
32.131 +絎鴻<ゃ荅箴<障 (≪若)
32.132 .TP 3
32.133 \-f \-
32.134 -標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
32.135 +罔羣ュ鴻茯水荅箴<障 (絲乗怨≪若)
32.136 .TP 3
32.137 \-help\
32.138 -ヘルプメッセージを出力したあと、終了します。
32.139 +<祉若吾阪腟篋障
32.140 .TP 3
32.141 \-?\
32.142 -ヘルプメッセージを出力したあと、終了します。
32.143 +<祉若吾阪腟篋障
32.144 .TP 3
32.145 \-q\
32.146 -利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
32.147 +純鴻鴻潟吾潟筝荀ц;腓冴腟篋障
32.148 +.RE
32.149 +
32.150 .LP
32.151 -.SH "引数"
32.152 +.SH "綣"
32.153 .LP
32.154 .LP
32.155 -[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ \f3\-e\fP、\f3\-f\fP のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
32.156 +[arguments...] 絖 \f3\-e\fP\f3\-f\fP 激с潟篏睡c翫綣違鴻<ゃ篁綣違絖翫鴻綣違羝<障[arguments..] 篏睡 \f3\-e\fP\f3\-f\fP 激с潟篏睡翫鴻 [arguments..] 鴻綣違羝<障[arguments..]\f3\-e\fP\f3\-f\fP 絖c翫絲乗怨≪若篏睡障鴻鴻綣違篏睡arguments String 潟吾喝違篏睡障
32.157 .LP
32.158 -.SH "例"
32.159 +.SH "箴"
32.160 .LP
32.161 -\f3インラインスクリプトの実行\fP
32.162 +\f3ゃ潟ゃ潟鴻絎茵\fP
32.163 +.LP
32.164 +.RS 3
32.165 +
32.166 .LP
32.167 .nf
32.168 \f3
32.169 .fl
32.170 - jrunscript \-e "print('hello world')"
32.171 +jrunscript \-e "print('hello world')"
32.172 .fl
32.173 - jrunscript \-e "cat('http://java.sun.com')"
32.174 +jrunscript \-e "cat('http://java.sun.com')"
32.175 .fl
32.176 \fP
32.177 .fi
32.178 +.RE
32.179
32.180 .LP
32.181 -\f3指定された言語を使用し、指定されたスクリプトファイルを評価する\fP
32.182 +\f3絎荐茯篏睡絎鴻<ゃ荅箴<\fP
32.183 +.LP
32.184 +.RS 3
32.185 +
32.186 .LP
32.187 .nf
32.188 \f3
32.189 .fl
32.190 - jrunscript \-l js \-f test.js
32.191 +jrunscript \-l js \-f test.js
32.192 .fl
32.193 \fP
32.194 .fi
32.195 +.RE
32.196
32.197 .LP
32.198 -\f3対話型モード\fP
32.199 +\f3絲乗怨≪若\fP
32.200 +.LP
32.201 +.RS 3
32.202 +
32.203 .LP
32.204 .nf
32.205 \f3
32.206 .fl
32.207 - jrunscript
32.208 +jrunscript
32.209 .fl
32.210 - js>print('hello world');
32.211 +js>print('hello world');
32.212 .fl
32.213 - hello world
32.214 +hello world
32.215 .fl
32.216 - js>34 + 55
32.217 +js>34 + 55
32.218 .fl
32.219 - 89
32.220 +89
32.221 .fl
32.222 - js> thread(function() { print('hello world'); }
32.223 +js> thread(function() { print('hello world'); }
32.224 .fl
32.225 - hello world
32.226 +hello world
32.227 .fl
32.228 - js>
32.229 +js>
32.230 .fl
32.231 \fP
32.232 .fi
32.233 +.RE
32.234
32.235 .LP
32.236 -\f3スクリプト引数を指定してスクリプトファイルを実行する\fP
32.237 +\f3鴻綣違絎鴻<ゃ絎茵\fP
32.238 +.LP
32.239 +.RS 3
32.240 +
32.241 .LP
32.242 .nf
32.243 \f3
32.244 .fl
32.245 - jrunscript test.js arg1 arg2 arg3
32.246 +jrunscript test.js arg1 arg2 arg3
32.247 .fl
32.248 \fP
32.249 .fi
32.250 -
32.251 -.LP
32.252 -test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
32.253 -.SH "関連項目"
32.254 -.LP
32.255 -.LP
32.256 -JavaScript が使用される場合、jrunscript は、最初のユーザ定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
32.257 -.LP
32.258 -.RS 3
32.259 .RE
32.260
32.261 .LP
32.262 +test.js 絎茵絲乗院鴻<ゃсarg1arg2 arg3 鴻綣違鴻羝<障鴻arguments篏帥c≪祉鴻с障
32.263 +.SH "∫i"
32.264 +.LP
32.265 +.LP
32.266 +JavaScript 篏睡翫jrunscript 若吟弱臂鴻荅箴<ゃ腟粋昭翠∽違腟粋昭帥吾с障 JavaScript 腟粋昭炊純ゃjsdocs с
32.267 +.LP
32.268 +
32.269 +.LP
32.270
33.1 --- a/src/linux/doc/man/ja/jsadebugd.1 Tue May 12 15:21:55 2009 +0900
33.2 +++ b/src/linux/doc/man/ja/jsadebugd.1 Thu May 14 00:17:25 2009 -0700
33.3 @@ -1,107 +1,149 @@
33.4 -'\" t
33.5 -.\"
33.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
33.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
33.8 -.\"
33.9 -.\" This code is free software; you can redistribute it and/or modify it
33.10 -.\" under the terms of the GNU General Public License version 2 only, as
33.11 -.\" published by the Free Software Foundation.
33.12 -.\"
33.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
33.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
33.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
33.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
33.17 -.\" accompanied this code).
33.18 -.\"
33.19 -.\" You should have received a copy of the GNU General Public License version
33.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
33.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
33.22 -.\"
33.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
33.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
33.25 -.\" have any questions.
33.26 -.\"
33.27 -.\"
33.28 -.TH jsadebugd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
33.29 -.SH 名前
33.30 -jsadebugd \- サービスエージェントデバッグデーモン
33.31 -.\"
33.32 -.SH 形式
33.33 -.B jsadebugd
33.34 -.I pid [ server-id ]
33.35 -.br
33.36 -.B jsadebugd
33.37 -.I executable core [ server-id ]
33.38 -.SH パラメータ
33.39 -.if t .TP 20
33.40 -.if n .TP 15
33.41 -.I pid
33.42 -デバッグサーバがアタッチするプロセスのプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
33.43 -.B jps
33.44 -を使用します。1 つのプロセスにアタッチできるのは、1 つのデバッグサーバだけです。
33.45 -.if t .TP 20
33.46 -.if n .TP 15
33.47 -.I executable
33.48 -コアダンプが生成された Java 実行可能ファイル。
33.49 -.if t .TP 20
33.50 -.if n .TP 15
33.51 -.I core
33.52 -デバッグサーバがアタッチするコアファイル。
33.53 -.if t .TP 20
33.54 -.if n .TP 15
33.55 -.I server-id
33.56 -同じマシン上で複数のデバッグサーバを起動する場合に必要な、オプションの一意 ID。リモートクライアントがアタッチする特定のデバッグサーバを識別するには、この ID を使用する必要があります。1 つのマシン内で、この ID は一意でなければなりません。
33.57 -.SH 機能説明
33.58 -.B jsadebugd
33.59 -は、Java プロセスまたはコアファイルにアタッチして、デバッグサーバとして機能します。
33.60 -.B jstack
33.61 -、
33.62 -.B jmap
33.63 -、
33.64 -.B jinfo
33.65 -などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用してサーバにアタッチできます。
33.66 -.B jsadebugd
33.67 -を起動する前に、次のように指定して
33.68 -.B rmiregistry
33.69 -を起動する必要があります。
33.70 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
33.71 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
33.72 +."
33.73 +." This code is free software; you can redistribute it and/or modify it
33.74 +." under the terms of the GNU General Public License version 2 only, as
33.75 +." published by the Free Software Foundation.
33.76 +."
33.77 +." This code is distributed in the hope that it will be useful, but WITHOUT
33.78 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
33.79 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
33.80 +." version 2 for more details (a copy is included in the LICENSE file that
33.81 +." accompanied this code).
33.82 +."
33.83 +." You should have received a copy of the GNU General Public License version
33.84 +." 2 along with this work; if not, write to the Free Software Foundation,
33.85 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
33.86 +."
33.87 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
33.88 +." CA 95054 USA or visit www.sun.com if you need additional information or
33.89 +." have any questions.
33.90 +."
33.91 +.TH jsadebugd 1 "04 May 2009"
33.92 +." Generated from HTML by html2man (author: Eric Armstrong)
33.93 +
33.94 .LP
33.95 -.RS
33.96 -.ft 3
33.97 -.nf
33.98 -rmiregistry -J-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar
33.99 -.fi
33.100 -.ft 1
33.101 -.RE
33.102 -.LP
33.103 -$JAVA_HOME は、JDK のインストールディレクトリです。
33.104 -.B rmiregistry
33.105 -が起動していなかった場合、
33.106 -.B jsadebugd
33.107 -は標準 (1099) ポートで内部的に
33.108 -.B rmiregistry
33.109 -を起動します。デバッグサーバを停止するには、SIGINT を送信します (Ctrl-C を押す) 。
33.110 -.LP
33.111 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
33.112 -.B jsadebugd
33.113 -は、現時点では、Windows プラットフォームでは使用できません。
33.114 -.SH 関連項目
33.115 +.SH ""
33.116 +jsadebugd \- 泣若鴻≪c若若吾с潟違若≪
33.117 .LP
33.118 .RS 3
33.119 .TP 2
33.120 -*
33.121 -jinfo
33.122 +o
33.123 +綵√
33.124 .TP 2
33.125 -*
33.126 -jmap
33.127 +o
33.128 +<若
33.129 .TP 2
33.130 -*
33.131 -jps
33.132 +o
33.133 +茯
33.134 .TP 2
33.135 -*
33.136 -jstack
33.137 +o
33.138 +∫i
33.139 +.RE
33.140 +
33.141 +.LP
33.142 +.SH "綵√"
33.143 +.LP
33.144 +
33.145 +.LP
33.146 +.nf
33.147 +\f3
33.148 +.fl
33.149 +\fP\f3jsadebugd\fP pid [ server\-id ]
33.150 +.fl
33.151 +\f3jsadebugd\fP executable core [ server\-id ]
33.152 +.fl
33.153 +.fi
33.154 +
33.155 +.LP
33.156 +.SH "<若"
33.157 +.LP
33.158 +
33.159 +.LP
33.160 +.RS 3
33.161 +.TP 3
33.162 +pid
33.163 +違泣若若・膓祉鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障筝祉鴻・膓с違泣若若ゃ潟鴻帥潟鴻1 ゃ狗障
33.164 +.RE
33.165 +
33.166 +.LP
33.167 +.RS 3
33.168 +.TP 3
33.169 +executable
33.170 +.RE
33.171 +
33.172 +.LP
33.173 +.RS 3
33.174 +.TP 3
33.175 +潟≪潟篏 Java 絎茵純<ゃс
33.176 +.RE
33.177 +
33.178 +.LP
33.179 +.RS 3
33.180 +.TP 3
33.181 +core
33.182 +違泣若若・膓潟≪<ゃс
33.183 +.RE
33.184 +
33.185 +.LP
33.186 +.RS 3
33.187 +.TP 3
33.188 +server\-id
33.189 +茲違違泣若若筝激割у茵翫綽荀激с喝堺 ID с ID ≪若ゃ≪潟・膓違泣若若劫篏睡綽荀障 ID 筝激喝тс違障
33.190 +.RE
33.191 +
33.192 +.LP
33.193 +.SH "茯"
33.194 +.LP
33.195 +
33.196 +.LP
33.197 +.LP
33.198 +\f3jsadebugd\fP Java 祉鴻障潟≪<ゃ・膓違泣若若罘純障jstack(1)jmap(1) jinfo(1) ≪若ゃ≪潟Java Remote Method Invocation (RMI) 篏睡泣若若・膓с障\f2jsadebugd\fP 莎桁罨<絎
33.199 +.na
33.200 +\f2rmiregistry\fP @
33.201 +.fi
33.202 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi 莎桁綽荀障
33.203 +.LP
33.204 +.RS 3
33.205 +
33.206 +.LP
33.207 +.nf
33.208 +\f3
33.209 +.fl
33.210 +\fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3
33.211 +.fl
33.212 +\fP
33.213 +.fi
33.214 +.RE
33.215 +
33.216 +.LP
33.217 +.LP
33.218 +с\f2$JAVA_HOME\fP JDK ゃ潟鴻若cсrmiregistry 莎桁翫jsadebugd 罔羣 (1099) 若 rmiregistry ц儀障違泣若若SIGINT 篆< (Ctrl+C 若) 罩≪с障
33.219 +.LP
33.220 +.LP
33.221 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障 jsadebugd 憝鴻сWindows 若с篏睡с障\fP
33.222 +.LP
33.223 +.SH "∫i"
33.224 +.LP
33.225 +.RS 3
33.226 .TP 2
33.227 -*
33.228 -rmiregistry
33.229 +o
33.230 +jinfo(1)
33.231 +.TP 2
33.232 +o
33.233 +jmap(1)
33.234 +.TP 2
33.235 +o
33.236 +jps(1)
33.237 +.TP 2
33.238 +o
33.239 +jstack(1)
33.240 +.TP 2
33.241 +o
33.242 +.na
33.243 +\f2rmiregistry\fP @
33.244 +.fi
33.245 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
33.246 .RE
33.247
33.248 .LP
34.1 --- a/src/linux/doc/man/ja/jstack.1 Tue May 12 15:21:55 2009 +0900
34.2 +++ b/src/linux/doc/man/ja/jstack.1 Thu May 14 00:17:25 2009 -0700
34.3 @@ -1,75 +1,112 @@
34.4 -'\" t
34.5 -.\"
34.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
34.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
34.8 -.\"
34.9 -.\" This code is free software; you can redistribute it and/or modify it
34.10 -.\" under the terms of the GNU General Public License version 2 only, as
34.11 -.\" published by the Free Software Foundation.
34.12 -.\"
34.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
34.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
34.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
34.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
34.17 -.\" accompanied this code).
34.18 -.\"
34.19 -.\" You should have received a copy of the GNU General Public License version
34.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
34.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
34.22 -.\"
34.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
34.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
34.25 -.\" have any questions.
34.26 -.\"
34.27 -.\"
34.28 -.TH jstack 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
34.29 -.SH 名前
34.30 -jstack \- スタックトレース
34.31 -.\"
34.32 -.SH 形式
34.33 -.B jstack
34.34 -.BI [ option ] " pid"
34.35 -.br
34.36 -.B jstack
34.37 -.BI [ option ] " executable core"
34.38 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
34.39 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
34.40 +."
34.41 +." This code is free software; you can redistribute it and/or modify it
34.42 +." under the terms of the GNU General Public License version 2 only, as
34.43 +." published by the Free Software Foundation.
34.44 +."
34.45 +." This code is distributed in the hope that it will be useful, but WITHOUT
34.46 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
34.47 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
34.48 +." version 2 for more details (a copy is included in the LICENSE file that
34.49 +." accompanied this code).
34.50 +."
34.51 +." You should have received a copy of the GNU General Public License version
34.52 +." 2 along with this work; if not, write to the Free Software Foundation,
34.53 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
34.54 +."
34.55 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
34.56 +." CA 95054 USA or visit www.sun.com if you need additional information or
34.57 +." have any questions.
34.58 +."
34.59 +.TH jstack 1 "04 May 2009"
34.60 +." Generated from HTML by html2man (author: Eric Armstrong)
34.61 +
34.62 +.LP
34.63 +.SH ""
34.64 +jstack \- 鴻帥若
34.65 .br
34.66 -.B jstack
34.67 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
34.68 -.SH パラメータ
34.69 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
34.70 -「オプション」を参照してください。
34.71 -.if t .TP 20
34.72 -.if n .TP 15
34.73 -.I pid
34.74 -スタックトレースを出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
34.75 -.B jps
34.76 -を使用します。
34.77 -.if t .TP 20
34.78 -.if n .TP 15
34.79 -.I executable
34.80 -コアダンプが生成された Java 実行可能ファイル。
34.81 -.if t .TP 20
34.82 -.if n .TP 15
34.83 -.I core
34.84 -スタックトレースを出力するコアファイル。
34.85 -.if t .TP 20
34.86 -.if n .TP 15
34.87 -.BI remote-hostname-or-IP
34.88 -リモートデバッグサーバー (
34.89 -.B jsadebugd
34.90 -を参照) のホスト名または IP アドレス。
34.91 -.if t .TP 20
34.92 -.if n .TP 15
34.93 -.I server-id
34.94 -同じリモートホスト上で複数のデバッグサーバーが動作している場合の、オプションの一意 ID。
34.95 -.SH 機能説明
34.96 -.B jstack
34.97 -は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバーの Java スレッドの Java スタックトレースを出力します。それぞれの Java フレームについて、完全なクラス名、メソッド名、'bci' (バイトコードインデックス) 、および行番号 (入手可能な場合) が出力されます。
34.98 -.B \-m
34.99 -オプションを指定した場合、
34.100 -.B jstack
34.101 -は、すべてのスレッドの Java とネイティブの両方のフレームを 'pc' (プログラムカウンタ) とともに出力します。それぞれのネイティブフレームについて、'pc' に最も近いネイティブシンボル (入手可能な場合) が出力されます。C++ の符号化された (mangled) 名前は復号化 (demangled) されません。C++ 名を復号化するには、このコマンドの出力を c++filt にパイプで渡します。
34.102 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
34.103 +
34.104 +.LP
34.105 +.RS 3
34.106 +.TP 2
34.107 +o
34.108 +綵√
34.109 +.TP 2
34.110 +o
34.111 +<若
34.112 +.br
34.113 +.TP 2
34.114 +o
34.115 +茯
34.116 +.TP 2
34.117 +o
34.118 +激с
34.119 +.TP 2
34.120 +o
34.121 +∫i
34.122 +.TP 2
34.123 +o
34.124 +∝ャ
34.125 +.br
34.126 +.RE
34.127 +
34.128 +.LP
34.129 +.SH "綵√"
34.130 +.LP
34.131 +
34.132 +.LP
34.133 +.nf
34.134 +\f3
34.135 +.fl
34.136 +\fP\f3jstack\fP [ option ] pid
34.137 +.fl
34.138 +\f3jstack\fP [ option ] executable core
34.139 +.fl
34.140 +\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
34.141 +.fl
34.142 +.fi
34.143 +
34.144 +.LP
34.145 +.SH "<若"
34.146 +.LP
34.147 +
34.148 +.LP
34.149 +.LP
34.150 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障激с潟с
34.151 +.LP
34.152 +.RS 3
34.153 +.TP 3
34.154 +pid
34.155 +医激鴻帥若鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
34.156 +.RE
34.157 +
34.158 +.LP
34.159 +.RS 3
34.160 +.TP 3
34.161 +executable
34.162 +潟≪潟篏 Java 絎茵純<ゃс
34.163 +.br
34.164 +.TP 3
34.165 +core
34.166 +医激鴻帥若鴻潟≪<ゃс
34.167 +.br
34.168 +.TP 3
34.169 +remote\-hostname\-or\-IP
34.170 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
34.171 +.br
34.172 +.TP 3
34.173 +server\-id
34.174 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
34.175 +.RE
34.176 +
34.177 +.LP
34.178 +.SH "茯"
34.179 +.LP
34.180 +
34.181 +.LP
34.182 +.LP
34.183 +\f3jstack\fP 絎 Java 祉鴻潟≪<ゃ障≪若違泣若若絲障 Java 鴻 Java 鴻帥若鴻医激障Java 若劫<純bci(ゃ潟若ゃ潟)活 (純翫) 医激障\-m 激с潟篏睡jstack 鴻鴻 Java 若ゃc若筝≧鴻pc(違潟) 医激障ゃc若pcc菴ゃc激潟 (純翫) 医激障C++ 茹e茹hВゃ障C++ 茹hВゃ潟潟阪 \f3c++filt\fP ゃ障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
34.184 .br
34.185
34.186 .LP
34.187 @@ -86,57 +123,72 @@
34.188 .RE
34.189
34.190 .LP
34.191 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
34.192 -Windows プラットフォーム上で使用可能な唯一の jstack 形式は、次のとおりです。
34.193 +.LP
34.194 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 若筝т戎純筝 jstack 綵√罨<с\fP
34.195 .LP
34.196 .nf
34.197 \f3
34.198 .fl
34.199 -\fP\f3 jstack pid \fP
34.200 +\fP\f3 jstack [\-l] pid \fP
34.201 .fl
34.202 .fi
34.203
34.204 .LP
34.205 -.SH オプション
34.206 +.SH "激с"
34.207 .LP
34.208
34.209 .LP
34.210 +.RS 3
34.211 .TP 3
34.212 \-F
34.213 -「jstack pid」が応答しない場合にスタックダンプを強制します。
34.214 +jstack [\-l] pid綽膈翫鴻帥潟綣桁吟障
34.215 +.TP 3
34.216 +\-l
34.217 +桁就綣鴻 java.util.concurrent
34.218 +.na
34.219 +\f2с激潟ゃ\fP @
34.220 +.fi
34.221 +http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html筝荀сゃ菴遵宴医激障
34.222 .TP 3
34.223 \-m
34.224 -混合モード (Java とネイティブの両方の C/C++ フレーム) のスタックトレースを出力します。
34.225 +羞桁≪若 (Java 潟ゃc C/C++ 若筝≧) 鴻帥若鴻医激障
34.226 .TP 3
34.227 -\-h
34.228 -ヘルプメッセージを出力します。
34.229 +\-h
34.230 +<祉若吾医激障
34.231 .br
34.232 .br
34.233 .TP 3
34.234 -\-help
34.235 -ヘルプメッセージを出力します。
34.236 +\-help
34.237 +<祉若吾医激障
34.238 .br
34.239 +.RE
34.240
34.241 .LP
34.242 -.SH 関連項目
34.243 +.SH "∫i"
34.244 .LP
34.245 .RS 3
34.246 .TP 2
34.247 -*
34.248 +o
34.249 pstack(1)
34.250 .TP 2
34.251 -*
34.252 +o
34.253 c++filt(1)
34.254 .TP 2
34.255 -*
34.256 -jps
34.257 +o
34.258 +jps(1)
34.259 .TP 2
34.260 -*
34.261 -jsadebugd
34.262 +o
34.263 +jsadebugd(1)
34.264 .RE
34.265
34.266 .LP
34.267 -.SH 既知の問題
34.268 -混合モードのスタックトレース (
34.269 -.B \-m
34.270 -オプション) は、リモートデバッグサーバーでは機能しません。
34.271 +.SH "∝ャ"
34.272 +.LP
34.273 +
34.274 +.LP
34.275 +.LP
34.276 +羞桁≪若鴻帥若 (\-m 激с割戎) ≪若違泣若若с罘純障
34.277 +.LP
34.278 +
34.279 +.LP
34.280 +
35.1 --- a/src/linux/doc/man/ja/jstat.1 Tue May 12 15:21:55 2009 +0900
35.2 +++ b/src/linux/doc/man/ja/jstat.1 Thu May 14 00:17:25 2009 -0700
35.3 @@ -1,667 +1,5467 @@
35.4 -'\" t
35.5 -.\"
35.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
35.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
35.8 -.\"
35.9 -.\" This code is free software; you can redistribute it and/or modify it
35.10 -.\" under the terms of the GNU General Public License version 2 only, as
35.11 -.\" published by the Free Software Foundation.
35.12 -.\"
35.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
35.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
35.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
35.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
35.17 -.\" accompanied this code).
35.18 -.\"
35.19 -.\" You should have received a copy of the GNU General Public License version
35.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
35.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
35.22 -.\"
35.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
35.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
35.25 -.\" have any questions.
35.26 -.\"
35.27 -.\"
35.28 -.TH jstat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
35.29 -.SH 名前
35.30 -jstat \- Java 仮想マシン統計監視ツール
35.31 -.\"
35.32 -.SH 形式
35.33 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
35.34 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
35.35 +."
35.36 +." This code is free software; you can redistribute it and/or modify it
35.37 +." under the terms of the GNU General Public License version 2 only, as
35.38 +." published by the Free Software Foundation.
35.39 +."
35.40 +." This code is distributed in the hope that it will be useful, but WITHOUT
35.41 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
35.42 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
35.43 +." version 2 for more details (a copy is included in the LICENSE file that
35.44 +." accompanied this code).
35.45 +."
35.46 +." You should have received a copy of the GNU General Public License version
35.47 +." 2 along with this work; if not, write to the Free Software Foundation,
35.48 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
35.49 +."
35.50 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
35.51 +." CA 95054 USA or visit www.sun.com if you need additional information or
35.52 +." have any questions.
35.53 +."
35.54 +.TH jstat 1 "04 May 2009"
35.55 +." Generated from HTML by html2man (author: Eric Armstrong)
35.56 +
35.57 +.LP
35.58 +.SH ""
35.59 +jstat \- Java 篁潟激括輝荐若睡h若
35.60 +.LP
35.61 +.RS 3
35.62 +.TP 2
35.63 +o
35.64 +綵√
35.65 +.TP 2
35.66 +o
35.67 +<若
35.68 +.TP 2
35.69 +o
35.70 +茯
35.71 +.TP 2
35.72 +o
35.73 +篁潟激活ュ
35.74 +.TP 2
35.75 +o
35.76 +激с
35.77 +.br
35.78 +\ \ \- 筝激с
35.79 +.br
35.80 +\ \ \- 阪激с
35.81 +.TP 2
35.82 +o
35.83 +箴
35.84 +.TP 2
35.85 +o
35.86 +∫i
35.87 +.RE
35.88 +
35.89 +.LP
35.90 +.SH "綵√"
35.91 +.LP
35.92 +
35.93 +.LP
35.94 .nf
35.95 -\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP\f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
35.96 +\f3
35.97 +.fl
35.98 +\fP\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP \f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
35.99 .fl
35.100 .fi
35.101 -.SH パラメータ
35.102 -.if t .TP 20
35.103 -.if n .TP 15
35.104 -.I generalOption
35.105 -単一の汎用コマンド行オプション (
35.106 -.B \-help
35.107 -、
35.108 -.B \-options
35.109 -、または
35.110 -.B \-version
35.111 -)
35.112 -.if t .TP 20
35.113 -.if n .TP 15
35.114 -.I outputOptions
35.115 -1 つ以上の出力オプション。1 つの statOption と
35.116 -.B \-t
35.117 -、
35.118 -.B \-h
35.119 -、および
35.120 -.B \-J
35.121 -オプションのいずれかで構成されます。
35.122 -.if t .TP 20
35.123 -.if n .TP 15
35.124 -.I vmid
35.125 -仮想マシン識別子。ターゲットの Java 仮想マシン (JVM) を示す文字列。一般的な構文は、次のとおりです。
35.126 +
35.127 .LP
35.128 -.RS
35.129 -.ft 3
35.130 +.SH "<若"
35.131 +.LP
35.132 +
35.133 +.LP
35.134 +.RS 3
35.135 +.TP 3
35.136 +generalOption
35.137 +т戎筝潟潟茵激с潟с (\-help\-options障 \-version)
35.138 +.TP 3
35.139 +outputOptions
35.140 +筝 \f2statOption\fP \-t\-h \-J 激с潟腟水1 ゃ障茲違阪激с潟с
35.141 +.TP 3
35.142 +vmid
35.143 +帥若蚊 Java 篁潟激 (JVM) 腓冴絖с篁潟激活ュс筝罕罨<障
35.144 .nf
35.145 +\f3
35.146 +.fl
35.147 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
35.148 +.fl
35.149 .fi
35.150 -.ft 1
35.151 +vmid 絖罕紊чURI 罕絲上障\f2vmid\fP 若 JVM 茵膣贋違篆<潟若垩割絎茖堺ゃ腓冴茲罕障с障障違障荅括完篁潟激活ュс
35.152 +.TP 3
35.153 +interval[s|ms]
35.154 +腱 (s) 障腱 (ms) ≧絎篏с泣潟潟育с篏腱с\ 罩c贋違с違障\ 絎翫\f3jstat\fP interval 阪障
35.155 +.TP 3
35.156 +count
35.157 +茵腓冴泣潟違сゃ♂с ゃ障\f3jstat\fP 帥若蚊 JVM 腟篋障с障 \f3jstat\fP 潟潟腟篋障с腟沿若帥茵腓冴障 罩c贋医ゃ篏睡綽荀障
35.158 .RE
35.159 +
35.160 .LP
35.161 -vmid 文字列の構文は、URI の構文とほぼ同じです。vmid は、ローカル JVM を表す単純な整数から、通信プロトコル、ポート番号、およびその他の実装固有の値を指定する複雑な構造までさまざまです。詳しくは、以下の「仮想マシン識別子」を参照してください。
35.162 -.if t .TP 20
35.163 -.if n .TP 15
35.164 -.I interval[s|ms]
35.165 -指定された単位 (秒 (s) またはミリ秒 (ms) ) でのサンプリング間隔。デフォルトの単位はミリ秒です。正の整数でなければなりません。これが指定された場合、
35.166 -.B jstat
35.167 -は
35.168 -.I interval
35.169 -ごとに出力を生成します。
35.170 -.if t .TP 20
35.171 -.if n .TP 15
35.172 -.I count
35.173 -表示するサンプル数。デフォルトの値は infinity です。つまり、
35.174 -.B jstat
35.175 -はターゲット JVM が終了するか
35.176 -.B jstat
35.177 -コマンドが終了されるまで統計を表示します。正の整数でなければなりません。
35.178 -.SH 機能説明
35.179 -.B jstat
35.180 -ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) のパフォーマンス統計を表示します。ターゲット JVM は、仮想マシン識別子、すなわち、以下の
35.181 -.I vmid
35.182 -オプションによって識別されます。
35.183 +.SH " 茯"
35.184 .LP
35.185 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
35.186 -.SS 仮想マシン識別子
35.187 -vmid 文字列の構文は、URI の構文とほぼ同じです。
35.188 +
35.189 .LP
35.190 -.RS
35.191 -.ft 3
35.192 +.LP
35.193 +\f3jstat\fP 若荐臀 HotSpot Java 篁潟激 (JVM) 若潟合輝荐若帥茵腓冴障帥若蚊 JVM 篁潟激活ュゃ障筝荐 \f2vmid\fP 激с潟c茘ャ障
35.194 +.LP
35.195 +.LP
35.196 +\f3羈\fP: 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
35.197 +.br
35.198 +
35.199 +.LP
35.200 +.SS
35.201 +篁潟激活ュ
35.202 +.LP
35.203 +.RS 3
35.204 +
35.205 +.LP
35.206 +.LP
35.207 +\f2vmid\fP 絖罕紊чURI 罕絲上障
35.208 +.LP
35.209 .nf
35.210 -[protocol:][//]lvmid[@hostname][:port][/servername]
35.211 +\f3
35.212 +.fl
35.213 +[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP][:\f2port\fP][/\f2servername\fP]
35.214 +.fl
35.215 .fi
35.216 -.ft 1
35.217 +
35.218 +.LP
35.219 +.RS 3
35.220 +.TP 3
35.221 +protocol
35.222 +篆<潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
35.223 +.TP 3
35.224 +lvmid
35.225 +帥若蚊 JVM 若篁潟激活ュс\f2lvmid\fP 激鴻筝 JVM 筝茘ャ若堺ゃс\f2lvmid\fP 篁潟激活ュ筝綽荀膣с\f2lvmid\fP 腟九障с障筝帥若蚊 JVM 祉鴻絲障若c潟違激鴻祉壕ュсjps(1) 潟潟篏睡\f2lvmid\fP 絎с障障Unix 若с\f3ps\fP 潟潟篏睡Windows с Windows 帥鴻若吾c若篏睡\f2lvmid\fP 絎с障
35.226 +.TP 3
35.227 +hostname
35.228 +帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
35.229 +.TP 3
35.230 +port
35.231 +≪若泣若若篆<若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP <若帥宴絎茖c違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
35.232 +.TP 3
35.233 +servername
35.234 +<若帥宴絎茖c違障若潟翫c若∴障\f3rmi\fP 潟翫<若帥≪若鴻筝 RMI 純若鴻吾с腓冴障
35.235 .RE
35.236 -.if t .TP 20
35.237 -.if n .TP 15
35.238 -.I protocol
35.239 -通信プロトコル。
35.240 -.I protocol
35.241 -が省かれ、
35.242 -.I hostname
35.243 -が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。
35.244 -.I protocol
35.245 -が省かれ、
35.246 -.I hostname
35.247 -が指定された場合、デフォルトのプロトコルは rmi です。
35.248 -.if t .TP 20
35.249 -.if n .TP 15
35.250 -.I lvmid
35.251 -ターゲット JVM のローカル仮想マシン識別子。
35.252 -.I lvmid
35.253 -は、プラットフォーム固有の値であり、システム上の JVM を一意に識別します。
35.254 -.I lvmid
35.255 -は、仮想マシン識別子の唯一の必須コンポーネントです。
35.256 -.I lvmid
35.257 -は、一般に、ターゲット JVM プロセスのオペレーティングシステムのプロセス識別子ですが、必ずしもそうとは限りません。
35.258 -.B jps
35.259 -コマンドを使用して、
35.260 -.I lvmid
35.261 -を調べることができます。また、UNIX プラットフォームでは
35.262 -.B ps
35.263 -コマンドで、Windows ではタスクマネージャで
35.264 -.I lvmid
35.265 -を調べることができます。
35.266 -.if t .TP 20
35.267 -.if n .TP 15
35.268 -.I hostname
35.269 -ターゲットホストを示すホスト名または IP アドレス。
35.270 -.I hostname
35.271 -が省かれた場合、ターゲットホストはローカルホストです。
35.272 -.if t .TP 20
35.273 -.if n .TP 15
35.274 -.B port
35.275 -リモートサーバと通信するためのデフォルトポート。
35.276 -.I hostname
35.277 -が省かれるか、
35.278 -.I protocol
35.279 -が最適化されたローカルプロトコルを指定している場合、
35.280 -.B port
35.281 -は無視されます。そうでない場合、
35.282 -.B port
35.283 -パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、
35.284 -.B port
35.285 -はリモートホスト上の
35.286 -.B rmiregistry
35.287 -のポート番号を示します。
35.288 -.B port
35.289 -が省かれ、
35.290 -.I protocol
35.291 -が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。
35.292 -.if t .TP 20
35.293 -.if n .TP 15
35.294 -.I servername
35.295 -このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表します。
35.296 -.SH オプション
35.297 -.B jstat
35.298 -コマンドは、汎用オプションと出力オプションの 2 種類のオプションをサポートしています。汎用オプションを指定すると、
35.299 -.B jstat
35.300 -は簡単な使用法とバージョン情報を表示します。出力オプションによって、統計出力の内容と形式が決まります。
35.301 +
35.302 .LP
35.303 -注 - すべてのオプションとそれらの機能は、将来のリリースで変更または削除されることがあります。
35.304 -.SS 汎用オプション
35.305 -汎用オプションの 1 つを指定した場合、他のオプションやパラメータを指定することはできません。
35.306 -.if t .TP 20
35.307 -.if n .TP 15
35.308 -.BI \-help
35.309 -ヘルプメッセージを表示します。
35.310 -.if t .TP 20
35.311 -.if n .TP 15
35.312 -.BI \-version
35.313 -バージョン情報を表示します。
35.314 -.if t .TP 20
35.315 -.if n .TP 15
35.316 -.BI \-options
35.317 -統計オプションのリストを表示します。次の「出力オプション」を参照してください。
35.318 -.SS 出力オプション
35.319 -汎用オプションを指定しなかった場合は、出力オプションを指定することができます。出力オプションは、
35.320 -.B jstat
35.321 -の出力の内容と形式を決め、1 つの statOption と他のオプション (
35.322 -.B \-h
35.323 -、
35.324 -.B \-t
35.325 -、および
35.326 -.B \-J
35.327 -) のいずれかで構成されます。statOption は最初に指定する必要があります。
35.328 +.RE
35.329 +.SH "激с"
35.330 .LP
35.331 -出力は、列が空白文字で区切られた表として書式化されます。タイトルの付いた見出し行が列の内容を表します。
35.332 -.B \-h
35.333 -オプションを使用すると、見出しを表示する頻度を設定できます。列見出しの名前は、一般にオプション間で整合性が取れています。一般に、2 つのオプションで列の名前が同じになる場合、2 つの列のデータソースは同じです。
35.334 +
35.335 .LP
35.336 -.B \-t
35.337 -オプションを使用すると、出力の最初の列に Timestamp というラベルの付いたタイムスタンプ列が表示されます。Timestamp 列には、ターゲット JVM の起動からの経過時間が秒単位で表示されます。タイムスタンプの分解能は、さまざまな要因によって異なり、高負荷システムでは、遅延スレッドスケジューリングによって変動が生じることがあります。
35.338 .LP
35.339 -.I interval
35.340 -および
35.341 -.I count
35.342 -パラメータは、それぞれ
35.343 -.B jstat
35.344 -が出力を表示する頻度と回数を決めます。
35.345 +\f3jstat\fP 潟潟筝激с潟阪激с潟 2 ゃ帥ゃ激с潟泣若障筝激с潟篏睡翫\f3jstat\fP 膂≦篏睡潟若吾с恰宴茵腓冴障阪激с潟с腟沿若水阪絎鴻綵√絎障
35.346 +.br
35.347 +
35.348 .LP
35.349 -注 - 将来のリリースで形式が変更される可能性があるので、
35.350 -.B jstat
35.351 -の出力を解析するスクリプトは書かない方がよいでしょう。
35.352 -.B jstat
35.353 -出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを想定しておいてください。
35.354 -.if t .TP 20
35.355 -.if n .TP 15
35.356 -.BI \-statOption
35.357 -.B jstat が表示する統計情報を決めます。次の表に、使用可能なオプションを示します。\-options 汎用オプションを使用すると、特定のプラットフォームインストールでのオプションのリストが表示されます。
35.358 .LP
35.359 -.sp 1n
35.360 +\f3羈\fP: 鴻激с潟罘純絨ャ若鴻у眼障綮罩≪醇с障
35.361 +.LP
35.362 +.SS
35.363 +筝激с
35.364 +.LP
35.365 +.LP
35.366 +筝激с潟絎翫篁激с潟障<若帥筝絎с障
35.367 +.LP
35.368 +.RS 3
35.369 +.TP 3
35.370 +\-help
35.371 +<祉若吾茵腓冴障
35.372 +.TP 3
35.373 +\-version
35.374 +若吾с恰宴茵腓冴障
35.375 +.TP 3
35.376 +\-options
35.377 +腟沿若帥激с潟筝荀ц;腓冴障筝荐阪激с潟膀с
35.378 +.RE
35.379 +
35.380 +.LP
35.381 +.SS
35.382 +阪激с
35.383 +.LP
35.384 +.RS 3
35.385 +
35.386 +.LP
35.387 +.LP
35.388 +筝激с潟絎翫阪激с潟絎с障阪激с潟\f3jstat\fP 阪絎鴻喝就綣絎筝 \f2statOption\fP 篁阪激с (\-h\-t \-J) ф障\ \f2statOption\fP 荐菴違綽荀障
35.389 +.LP
35.390 +.LP
35.391 +阪腥榊純у阪若綵√ф障帥ゃ荐取茯荐障 \f3\-h\fP 激с潟篏睡若茵腓冴糸墾荐絎障\ 絽吾弱激с潟違c翫с筝莢障筝2 ゃ激с潟у篏睡違2 ゃ若帥純若鴻障
35.392 +.LP
35.393 +.LP
35.394 +\f3\-t\fP 激с潟篏睡\f2Timestamp\fP 篁帥ゃ鴻帥潟阪茵腓冴障\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏ц;腓冴障帥ゃ鴻帥潟膕上墾障障荀c違紊ч莢激c激鴻с鴻鴻宴吾ャ若綮吟紊障
35.395 +.LP
35.396 +.LP
35.397 +\f2interval\fP \f2count\fP <若帥篏睡\f3jstat\fP 阪茵腓冴糸墾違絎障
35.398 +.LP
35.399 +.LP
35.400 +\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jstat\fP 阪茹f鴻篏с障\f3jstat\fP 阪茹f鴻篏翫若絨ャ若鴻с鴻紊眼違
35.401 +.LP
35.402 +.RS 3
35.403 +.TP 3
35.404 +\-statOption
35.405 +\f3jstat\fP 茵腓冴腟沿若炊宴絎障罨<茵純激с潟筝荀ц;腓冴障 劫若ゃ潟鴻若ゃ激с潟筝荀ц;腓冴筝激с潟 \f3\-options\fP 篏睡障
35.406 +.br
35.407 +.br
35.408 +.LP
35.409 .TS
35.410 -box;
35.411 -cbp-1 | cbp-1
35.412 -l | l .
35.413 -オプション 表示される情報
35.414 -_
35.415 -class クラスローダの動作に関する統計
35.416 -compiler T{
35.417 -HotSpot Just-In-Time コンパイラの動作に関する統計
35.418 -T}
35.419 -gc T{
35.420 -ガベージコレクトされたヒープの動作に関する統計
35.421 -T}
35.422 -gccapacity 世代の容量とそれらに対応する空間の統計
35.423 -gccause T{
35.424 -ガベージコレクション統計の要約 ( \-gcutil と同じ) と、
35.425 -前回および現在 (該当する場合) のガベージコレクション
35.426 -イベントの原因
35.427 -T}
35.428 -gcnew 新しい世代の動作の統計
35.429 -gcnewcapacity 新しい世代とそれらに対応する空間のサイズの統計
35.430 -gcold T{
35.431 -古い永続的世代の動作の統計
35.432 -T}
35.433 -gcoldcapacity 古い世代のサイズの統計
35.434 -gcpermcapacity 永続的世代のサイズの統計
35.435 -gcutil ガベージコレクション統計の要約
35.436 -printcompilation ガベージコレクション統計の要約
35.437 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.438 +.de 35
35.439 +.ps \n(.s
35.440 +.vs \n(.vu
35.441 +.in \n(.iu
35.442 +.if \n(.u .fi
35.443 +.if \n(.j .ad
35.444 +.if \n(.j=0 .na
35.445 +..
35.446 +.nf
35.447 +.nr #~ 0
35.448 +.if n .nr #~ 0.6n
35.449 +.ds #d .d
35.450 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.451 +.fc
35.452 +.nr 33 \n(.s
35.453 +.rm 80 81
35.454 +.nr 34 \n(.lu
35.455 +.eo
35.456 +.am 81
35.457 +.br
35.458 +.di a+
35.459 +.35
35.460 +.ft \n(.f
35.461 +.ll \n(34u*1u/3u
35.462 +.if \n(.l<\n(81 .ll \n(81u
35.463 +.in 0
35.464 +鴻若若篏≪腟沿若
35.465 +.br
35.466 +.di
35.467 +.nr a| \n(dn
35.468 +.nr a- \n(dl
35.469 +..
35.470 +.ec \
35.471 +.eo
35.472 +.am 81
35.473 +.br
35.474 +.di b+
35.475 +.35
35.476 +.ft \n(.f
35.477 +.ll \n(34u*1u/3u
35.478 +.if \n(.l<\n(81 .ll \n(81u
35.479 +.in 0
35.480 +HotSpot Just\-in\-Time 潟潟ゃ篏≪腟沿若
35.481 +.br
35.482 +.di
35.483 +.nr b| \n(dn
35.484 +.nr b- \n(dl
35.485 +..
35.486 +.ec \
35.487 +.eo
35.488 +.am 81
35.489 +.br
35.490 +.di c+
35.491 +.35
35.492 +.ft \n(.f
35.493 +.ll \n(34u*1u/3u
35.494 +.if \n(.l<\n(81 .ll \n(81u
35.495 +.in 0
35.496 +若吾潟若篏≪腟沿若
35.497 +.br
35.498 +.di
35.499 +.nr c| \n(dn
35.500 +.nr c- \n(dl
35.501 +..
35.502 +.ec \
35.503 +.eo
35.504 +.am 81
35.505 +.br
35.506 +.di d+
35.507 +.35
35.508 +.ft \n(.f
35.509 +.ll \n(34u*1u/3u
35.510 +.if \n(.l<\n(81 .ll \n(81u
35.511 +.in 0
35.512 +筝篁c絎拷絲上≪腟沿若
35.513 +.br
35.514 +.di
35.515 +.nr d| \n(dn
35.516 +.nr d- \n(dl
35.517 +..
35.518 +.ec \
35.519 +.eo
35.520 +.am 81
35.521 +.br
35.522 +.di e+
35.523 +.35
35.524 +.ft \n(.f
35.525 +.ll \n(34u*1u/3u
35.526 +.if \n(.l<\n(81 .ll \n(81u
35.527 +.in 0
35.528 +若吾潟激с括輝荐若帥网荀 (\f3\-gcutil\fP ) 翫括憜 (純翫) 若吾潟激с潟ゃ潟
35.529 +.br
35.530 +.di
35.531 +.nr e| \n(dn
35.532 +.nr e- \n(dl
35.533 +..
35.534 +.ec \
35.535 +.eo
35.536 +.am 81
35.537 +.br
35.538 +.di f+
35.539 +.35
35.540 +.ft \n(.f
35.541 +.ll \n(34u*1u/3u
35.542 +.if \n(.l<\n(81 .ll \n(81u
35.543 +.in 0
35.544 +New 筝篁c篏≪腟沿若
35.545 +.br
35.546 +.di
35.547 +.nr f| \n(dn
35.548 +.nr f- \n(dl
35.549 +..
35.550 +.ec \
35.551 +.eo
35.552 +.am 81
35.553 +.br
35.554 +.di g+
35.555 +.35
35.556 +.ft \n(.f
35.557 +.ll \n(34u*1u/3u
35.558 +.if \n(.l<\n(81 .ll \n(81u
35.559 +.in 0
35.560 +New 筝篁c泣ゃ冴絲上≪腟沿若
35.561 +.br
35.562 +.di
35.563 +.nr g| \n(dn
35.564 +.nr g- \n(dl
35.565 +..
35.566 +.ec \
35.567 +.eo
35.568 +.am 81
35.569 +.br
35.570 +.di h+
35.571 +.35
35.572 +.ft \n(.f
35.573 +.ll \n(34u*1u/3u
35.574 +.if \n(.l<\n(81 .ll \n(81u
35.575 +.in 0
35.576 +Old 筝篁c Permanent 筝篁c篏≪腟沿若
35.577 +.br
35.578 +.di
35.579 +.nr h| \n(dn
35.580 +.nr h- \n(dl
35.581 +..
35.582 +.ec \
35.583 +.eo
35.584 +.am 81
35.585 +.br
35.586 +.di i+
35.587 +.35
35.588 +.ft \n(.f
35.589 +.ll \n(34u*1u/3u
35.590 +.if \n(.l<\n(81 .ll \n(81u
35.591 +.in 0
35.592 +Old 筝篁c泣ゃ冴≪腟沿若
35.593 +.br
35.594 +.di
35.595 +.nr i| \n(dn
35.596 +.nr i- \n(dl
35.597 +..
35.598 +.ec \
35.599 +.eo
35.600 +.am 81
35.601 +.br
35.602 +.di j+
35.603 +.35
35.604 +.ft \n(.f
35.605 +.ll \n(34u*1u/3u
35.606 +.if \n(.l<\n(81 .ll \n(81u
35.607 +.in 0
35.608 +Permanent 筝篁c泣ゃ冴≪腟沿若
35.609 +.br
35.610 +.di
35.611 +.nr j| \n(dn
35.612 +.nr j- \n(dl
35.613 +..
35.614 +.ec \
35.615 +.eo
35.616 +.am 81
35.617 +.br
35.618 +.di k+
35.619 +.35
35.620 +.ft \n(.f
35.621 +.ll \n(34u*1u/3u
35.622 +.if \n(.l<\n(81 .ll \n(81u
35.623 +.in 0
35.624 +若吾潟激с括輝荐若帥网荀
35.625 +.br
35.626 +.di
35.627 +.nr k| \n(dn
35.628 +.nr k- \n(dl
35.629 +..
35.630 +.ec \
35.631 +.eo
35.632 +.am 81
35.633 +.br
35.634 +.di l+
35.635 +.35
35.636 +.ft \n(.f
35.637 +.ll \n(34u*1u/3u
35.638 +.if \n(.l<\n(81 .ll \n(81u
35.639 +.in 0
35.640 +HotSpot 潟潟ゃ号腟沿若
35.641 +.br
35.642 +.di
35.643 +.nr l| \n(dn
35.644 +.nr l- \n(dl
35.645 +..
35.646 +.ec \
35.647 +.35
35.648 +.nf
35.649 +.ll \n(34u
35.650 +.nr 80 0
35.651 +.nr 38 \w\f3激с\fP
35.652 +.if \n(80<\n(38 .nr 80 \n(38
35.653 +.nr 38 \wclass
35.654 +.if \n(80<\n(38 .nr 80 \n(38
35.655 +.nr 38 \wcompiler
35.656 +.if \n(80<\n(38 .nr 80 \n(38
35.657 +.nr 38 \wgc
35.658 +.if \n(80<\n(38 .nr 80 \n(38
35.659 +.nr 38 \wgccapacity
35.660 +.if \n(80<\n(38 .nr 80 \n(38
35.661 +.nr 38 \wgccause
35.662 +.if \n(80<\n(38 .nr 80 \n(38
35.663 +.nr 38 \wgcnew
35.664 +.if \n(80<\n(38 .nr 80 \n(38
35.665 +.nr 38 \wgcnewcapacity
35.666 +.if \n(80<\n(38 .nr 80 \n(38
35.667 +.nr 38 \wgcold
35.668 +.if \n(80<\n(38 .nr 80 \n(38
35.669 +.nr 38 \wgcoldcapacity
35.670 +.if \n(80<\n(38 .nr 80 \n(38
35.671 +.nr 38 \wgcpermcapacity
35.672 +.if \n(80<\n(38 .nr 80 \n(38
35.673 +.nr 38 \wgcutil
35.674 +.if \n(80<\n(38 .nr 80 \n(38
35.675 +.nr 38 \wprintcompilation
35.676 +.if \n(80<\n(38 .nr 80 \n(38
35.677 +.80
35.678 +.rm 80
35.679 +.nr 81 0
35.680 +.nr 38 \w\f3茵腓阪絎\fP
35.681 +.if \n(81<\n(38 .nr 81 \n(38
35.682 +.81
35.683 +.rm 81
35.684 +.nr 38 \n(a-
35.685 +.if \n(81<\n(38 .nr 81 \n(38
35.686 +.nr 38 \n(b-
35.687 +.if \n(81<\n(38 .nr 81 \n(38
35.688 +.nr 38 \n(c-
35.689 +.if \n(81<\n(38 .nr 81 \n(38
35.690 +.nr 38 \n(d-
35.691 +.if \n(81<\n(38 .nr 81 \n(38
35.692 +.nr 38 \n(e-
35.693 +.if \n(81<\n(38 .nr 81 \n(38
35.694 +.nr 38 \n(f-
35.695 +.if \n(81<\n(38 .nr 81 \n(38
35.696 +.nr 38 \n(g-
35.697 +.if \n(81<\n(38 .nr 81 \n(38
35.698 +.nr 38 \n(h-
35.699 +.if \n(81<\n(38 .nr 81 \n(38
35.700 +.nr 38 \n(i-
35.701 +.if \n(81<\n(38 .nr 81 \n(38
35.702 +.nr 38 \n(j-
35.703 +.if \n(81<\n(38 .nr 81 \n(38
35.704 +.nr 38 \n(k-
35.705 +.if \n(81<\n(38 .nr 81 \n(38
35.706 +.nr 38 \n(l-
35.707 +.if \n(81<\n(38 .nr 81 \n(38
35.708 +.35
35.709 +.nf
35.710 +.ll \n(34u
35.711 +.nr 38 1n
35.712 +.nr 79 0
35.713 +.nr 40 \n(79+(0*\n(38)
35.714 +.nr 80 +\n(40
35.715 +.nr 41 \n(80+(3*\n(38)
35.716 +.nr 81 +\n(41
35.717 +.nr TW \n(81
35.718 +.if t .if \n(TW>\n(.li .tm Table at line 260 file Input is too wide - \n(TW units
35.719 +.fc
35.720 +.nr #T 0-1
35.721 +.nr #a 0-1
35.722 +.eo
35.723 +.de T#
35.724 +.ds #d .d
35.725 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.726 +.mk ##
35.727 +.nr ## -1v
35.728 +.ls 1
35.729 +.ls
35.730 +..
35.731 +.ec
35.732 +.ta \n(80u \n(81u
35.733 +.nr 31 \n(.f
35.734 +.nr 35 1m
35.735 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茵腓阪絎\fP
35.736 +.ne \n(a|u+\n(.Vu
35.737 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.738 +.ta \n(80u \n(81u
35.739 +.nr 31 \n(.f
35.740 +.nr 35 1m
35.741 +\&\h'|\n(40u'class\h'|\n(41u'
35.742 +.mk ##
35.743 +.nr 31 \n(##
35.744 +.sp |\n(##u-1v
35.745 +.nr 37 \n(41u
35.746 +.in +\n(37u
35.747 +.a+
35.748 +.in -\n(37u
35.749 +.mk 32
35.750 +.if \n(32>\n(31 .nr 31 \n(32
35.751 +.sp |\n(31u
35.752 +.ne \n(b|u+\n(.Vu
35.753 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.754 +.ta \n(80u \n(81u
35.755 +.nr 31 \n(.f
35.756 +.nr 35 1m
35.757 +\&\h'|\n(40u'compiler\h'|\n(41u'
35.758 +.mk ##
35.759 +.nr 31 \n(##
35.760 +.sp |\n(##u-1v
35.761 +.nr 37 \n(41u
35.762 +.in +\n(37u
35.763 +.b+
35.764 +.in -\n(37u
35.765 +.mk 32
35.766 +.if \n(32>\n(31 .nr 31 \n(32
35.767 +.sp |\n(31u
35.768 +.ne \n(c|u+\n(.Vu
35.769 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.770 +.ta \n(80u \n(81u
35.771 +.nr 31 \n(.f
35.772 +.nr 35 1m
35.773 +\&\h'|\n(40u'gc\h'|\n(41u'
35.774 +.mk ##
35.775 +.nr 31 \n(##
35.776 +.sp |\n(##u-1v
35.777 +.nr 37 \n(41u
35.778 +.in +\n(37u
35.779 +.c+
35.780 +.in -\n(37u
35.781 +.mk 32
35.782 +.if \n(32>\n(31 .nr 31 \n(32
35.783 +.sp |\n(31u
35.784 +.ne \n(d|u+\n(.Vu
35.785 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.786 +.ta \n(80u \n(81u
35.787 +.nr 31 \n(.f
35.788 +.nr 35 1m
35.789 +\&\h'|\n(40u'gccapacity\h'|\n(41u'
35.790 +.mk ##
35.791 +.nr 31 \n(##
35.792 +.sp |\n(##u-1v
35.793 +.nr 37 \n(41u
35.794 +.in +\n(37u
35.795 +.d+
35.796 +.in -\n(37u
35.797 +.mk 32
35.798 +.if \n(32>\n(31 .nr 31 \n(32
35.799 +.sp |\n(31u
35.800 +.ne \n(e|u+\n(.Vu
35.801 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.802 +.ta \n(80u \n(81u
35.803 +.nr 31 \n(.f
35.804 +.nr 35 1m
35.805 +\&\h'|\n(40u'gccause\h'|\n(41u'
35.806 +.mk ##
35.807 +.nr 31 \n(##
35.808 +.sp |\n(##u-1v
35.809 +.nr 37 \n(41u
35.810 +.in +\n(37u
35.811 +.e+
35.812 +.in -\n(37u
35.813 +.mk 32
35.814 +.if \n(32>\n(31 .nr 31 \n(32
35.815 +.sp |\n(31u
35.816 +.ne \n(f|u+\n(.Vu
35.817 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.818 +.ta \n(80u \n(81u
35.819 +.nr 31 \n(.f
35.820 +.nr 35 1m
35.821 +\&\h'|\n(40u'gcnew\h'|\n(41u'
35.822 +.mk ##
35.823 +.nr 31 \n(##
35.824 +.sp |\n(##u-1v
35.825 +.nr 37 \n(41u
35.826 +.in +\n(37u
35.827 +.f+
35.828 +.in -\n(37u
35.829 +.mk 32
35.830 +.if \n(32>\n(31 .nr 31 \n(32
35.831 +.sp |\n(31u
35.832 +.ne \n(g|u+\n(.Vu
35.833 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.834 +.ta \n(80u \n(81u
35.835 +.nr 31 \n(.f
35.836 +.nr 35 1m
35.837 +\&\h'|\n(40u'gcnewcapacity\h'|\n(41u'
35.838 +.mk ##
35.839 +.nr 31 \n(##
35.840 +.sp |\n(##u-1v
35.841 +.nr 37 \n(41u
35.842 +.in +\n(37u
35.843 +.g+
35.844 +.in -\n(37u
35.845 +.mk 32
35.846 +.if \n(32>\n(31 .nr 31 \n(32
35.847 +.sp |\n(31u
35.848 +.ne \n(h|u+\n(.Vu
35.849 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.850 +.ta \n(80u \n(81u
35.851 +.nr 31 \n(.f
35.852 +.nr 35 1m
35.853 +\&\h'|\n(40u'gcold\h'|\n(41u'
35.854 +.mk ##
35.855 +.nr 31 \n(##
35.856 +.sp |\n(##u-1v
35.857 +.nr 37 \n(41u
35.858 +.in +\n(37u
35.859 +.h+
35.860 +.in -\n(37u
35.861 +.mk 32
35.862 +.if \n(32>\n(31 .nr 31 \n(32
35.863 +.sp |\n(31u
35.864 +.ne \n(i|u+\n(.Vu
35.865 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.866 +.ta \n(80u \n(81u
35.867 +.nr 31 \n(.f
35.868 +.nr 35 1m
35.869 +\&\h'|\n(40u'gcoldcapacity\h'|\n(41u'
35.870 +.mk ##
35.871 +.nr 31 \n(##
35.872 +.sp |\n(##u-1v
35.873 +.nr 37 \n(41u
35.874 +.in +\n(37u
35.875 +.i+
35.876 +.in -\n(37u
35.877 +.mk 32
35.878 +.if \n(32>\n(31 .nr 31 \n(32
35.879 +.sp |\n(31u
35.880 +.ne \n(j|u+\n(.Vu
35.881 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
35.882 +.ta \n(80u \n(81u
35.883 +.nr 31 \n(.f
35.884 +.nr 35 1m
35.885 +\&\h'|\n(40u'gcpermcapacity\h'|\n(41u'
35.886 +.mk ##
35.887 +.nr 31 \n(##
35.888 +.sp |\n(##u-1v
35.889 +.nr 37 \n(41u
35.890 +.in +\n(37u
35.891 +.j+
35.892 +.in -\n(37u
35.893 +.mk 32
35.894 +.if \n(32>\n(31 .nr 31 \n(32
35.895 +.sp |\n(31u
35.896 +.ne \n(k|u+\n(.Vu
35.897 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
35.898 +.ta \n(80u \n(81u
35.899 +.nr 31 \n(.f
35.900 +.nr 35 1m
35.901 +\&\h'|\n(40u'gcutil\h'|\n(41u'
35.902 +.mk ##
35.903 +.nr 31 \n(##
35.904 +.sp |\n(##u-1v
35.905 +.nr 37 \n(41u
35.906 +.in +\n(37u
35.907 +.k+
35.908 +.in -\n(37u
35.909 +.mk 32
35.910 +.if \n(32>\n(31 .nr 31 \n(32
35.911 +.sp |\n(31u
35.912 +.ne \n(l|u+\n(.Vu
35.913 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
35.914 +.ta \n(80u \n(81u
35.915 +.nr 31 \n(.f
35.916 +.nr 35 1m
35.917 +\&\h'|\n(40u'printcompilation\h'|\n(41u'
35.918 +.mk ##
35.919 +.nr 31 \n(##
35.920 +.sp |\n(##u-1v
35.921 +.nr 37 \n(41u
35.922 +.in +\n(37u
35.923 +.l+
35.924 +.in -\n(37u
35.925 +.mk 32
35.926 +.if \n(32>\n(31 .nr 31 \n(32
35.927 +.sp |\n(31u
35.928 +.fc
35.929 +.nr T. 1
35.930 +.T# 1
35.931 +.35
35.932 +.rm a+
35.933 +.rm b+
35.934 +.rm c+
35.935 +.rm d+
35.936 +.rm e+
35.937 +.rm f+
35.938 +.rm g+
35.939 +.rm h+
35.940 +.rm i+
35.941 +.rm j+
35.942 +.rm k+
35.943 +.rm l+
35.944 .TE
35.945 -.if t .TP 20
35.946 -.if n .TP 15
35.947 -.BI \-h " n"
35.948 -.I n
35.949 -個のサンプル (出力行
35.950 -.I n
35.951 -行) ごとに列見出しを表示します。
35.952 -.I n
35.953 -は正の整数です。デフォルト値は 0 であり、データの最初の行の上に列見出しを表示します。
35.954 -.if t .TP
35.955 -.if n .TP
35.956 -.BI \-t " n"
35.957 -出力の最初の列としてタイムスタンプ列を表示します。タイムスタンプは、ターゲット JVM が起動してからの時間です。
35.958 -.if t .TP
35.959 -.if n .TP
35.960 -.BI \-J javaOption
35.961 -.I javaOption
35.962 -を Java アプリケーション起動ツールに渡します。たとえば、
35.963 -.BI \-J \-Xms48m
35.964 -は、起動メモリを 48M バイトに設定します。オプションの完全なリストについては、以下のドキュメントを参照してください。
35.965 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-52
35.966 +.TP 3
35.967 +\-h n
35.968 +\f2n\fP 泣潟 (阪茵) 若茵腓冴 \f2n\fP 罩c贋医ゃゃ 0 若帥茵筝若茵腓冴
35.969 +.TP 3
35.970 +\-t n
35.971 +帥ゃ鴻帥潟阪茵腓冴帥ゃ鴻帥潟帥若蚊 JVM 莎桁腟
35.972 +.TP 3
35.973 +\-J javaOption
35.974 +\f2javaOption\fP \f3java\fP ≪宴若激с活儀若御検違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟絎鴻ゃjava(1)ャ<潟с
35.975 +.RE
35.976 +
35.977 +.LP
35.978 +.RE
35.979 +.SS
35.980 +statOption 阪
35.981 +.LP
35.982 +.RS 3
35.983 +
35.984 +.LP
35.985 +.LP
35.986 +篁ラ茵с\f3jstat\fP \f2statOption\fP 阪ゃ网荀腓冴障
35.987 +.br
35.988 +
35.989 +.LP
35.990 +.SS
35.991 +\-class 激с
35.992 +.LP
35.993 +.LP
35.994 +.TS
35.995 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.996 +.de 35
35.997 +.ps \n(.s
35.998 +.vs \n(.vu
35.999 +.in \n(.iu
35.1000 +.if \n(.u .fi
35.1001 +.if \n(.j .ad
35.1002 +.if \n(.j=0 .na
35.1003 +..
35.1004 +.nf
35.1005 +.nr #~ 0
35.1006 +.if n .nr #~ 0.6n
35.1007 +.ds #d .d
35.1008 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1009 +.fc
35.1010 +.nr 33 \n(.s
35.1011 +.rm 80 81
35.1012 +.nr 34 \n(.lu
35.1013 +.eo
35.1014 +.am 81
35.1015 +.br
35.1016 +.di a+
35.1017 +.35
35.1018 +.ft \n(.f
35.1019 +.ll \n(34u*1u/3u
35.1020 +.if \n(.l<\n(81 .ll \n(81u
35.1021 +.in 0
35.1022 +若鴻
35.1023 +.br
35.1024 +.di
35.1025 +.nr a| \n(dn
35.1026 +.nr a- \n(dl
35.1027 +..
35.1028 +.ec \
35.1029 +.eo
35.1030 +.am 81
35.1031 +.br
35.1032 +.di b+
35.1033 +.35
35.1034 +.ft \n(.f
35.1035 +.ll \n(34u*1u/3u
35.1036 +.if \n(.l<\n(81 .ll \n(81u
35.1037 +.in 0
35.1038 +若 K ゃ
35.1039 +.br
35.1040 +.di
35.1041 +.nr b| \n(dn
35.1042 +.nr b- \n(dl
35.1043 +..
35.1044 +.ec \
35.1045 +.eo
35.1046 +.am 81
35.1047 +.br
35.1048 +.di c+
35.1049 +.35
35.1050 +.ft \n(.f
35.1051 +.ll \n(34u*1u/3u
35.1052 +.if \n(.l<\n(81 .ll \n(81u
35.1053 +.in 0
35.1054 +≪潟若鴻
35.1055 +.br
35.1056 +.di
35.1057 +.nr c| \n(dn
35.1058 +.nr c- \n(dl
35.1059 +..
35.1060 +.ec \
35.1061 +.eo
35.1062 +.am 81
35.1063 +.br
35.1064 +.di d+
35.1065 +.35
35.1066 +.ft \n(.f
35.1067 +.ll \n(34u*1u/3u
35.1068 +.if \n(.l<\n(81 .ll \n(81u
35.1069 +.in 0
35.1070 +≪潟若 K ゃ
35.1071 +.br
35.1072 +.di
35.1073 +.nr d| \n(dn
35.1074 +.nr d- \n(dl
35.1075 +..
35.1076 +.ec \
35.1077 +.eo
35.1078 +.am 81
35.1079 +.br
35.1080 +.di e+
35.1081 +.35
35.1082 +.ft \n(.f
35.1083 +.ll \n(34u*1u/3u
35.1084 +.if \n(.l<\n(81 .ll \n(81u
35.1085 +.in 0
35.1086 +鴻若≪潟若荀
35.1087 +.br
35.1088 +.di
35.1089 +.nr e| \n(dn
35.1090 +.nr e- \n(dl
35.1091 +..
35.1092 +.ec \
35.1093 +.35
35.1094 +.nf
35.1095 +.ll \n(34u
35.1096 +.nr 80 0
35.1097 +.nr 38 \w鴻若若腟沿若
35.1098 +.if \n(80<\n(38 .nr 80 \n(38
35.1099 +.nr 38 \w\f3\fP
35.1100 +.if \n(80<\n(38 .nr 80 \n(38
35.1101 +.nr 38 \wLoaded
35.1102 +.if \n(80<\n(38 .nr 80 \n(38
35.1103 +.nr 38 \wBytes
35.1104 +.if \n(80<\n(38 .nr 80 \n(38
35.1105 +.nr 38 \wUnloaded
35.1106 +.if \n(80<\n(38 .nr 80 \n(38
35.1107 +.nr 38 \wBytes
35.1108 +.if \n(80<\n(38 .nr 80 \n(38
35.1109 +.nr 38 \wTime
35.1110 +.if \n(80<\n(38 .nr 80 \n(38
35.1111 +.80
35.1112 +.rm 80
35.1113 +.nr 81 0
35.1114 +.nr 38 \w\f3茯\fP
35.1115 +.if \n(81<\n(38 .nr 81 \n(38
35.1116 +.81
35.1117 +.rm 81
35.1118 +.nr 38 \n(a-
35.1119 +.if \n(81<\n(38 .nr 81 \n(38
35.1120 +.nr 38 \n(b-
35.1121 +.if \n(81<\n(38 .nr 81 \n(38
35.1122 +.nr 38 \n(c-
35.1123 +.if \n(81<\n(38 .nr 81 \n(38
35.1124 +.nr 38 \n(d-
35.1125 +.if \n(81<\n(38 .nr 81 \n(38
35.1126 +.nr 38 \n(e-
35.1127 +.if \n(81<\n(38 .nr 81 \n(38
35.1128 +.35
35.1129 +.nf
35.1130 +.ll \n(34u
35.1131 +.nr 38 1n
35.1132 +.nr 79 0
35.1133 +.nr 40 \n(79+(0*\n(38)
35.1134 +.nr 80 +\n(40
35.1135 +.nr 41 \n(80+(3*\n(38)
35.1136 +.nr 81 +\n(41
35.1137 +.nr TW \n(81
35.1138 +.if t .if \n(TW>\n(.li .tm Table at line 314 file Input is too wide - \n(TW units
35.1139 +.fc
35.1140 +.nr #T 0-1
35.1141 +.nr #a 0-1
35.1142 +.eo
35.1143 +.de T#
35.1144 +.ds #d .d
35.1145 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1146 +.mk ##
35.1147 +.nr ## -1v
35.1148 +.ls 1
35.1149 +.ls
35.1150 +..
35.1151 +.ec
35.1152 +.ta \n(80u \n(81u
35.1153 +.nr 31 \n(.f
35.1154 +.nr 35 1m
35.1155 +\&\h'|\n(40u'鴻若若腟沿若\h'|\n(41u'
35.1156 +.ta \n(80u \n(81u
35.1157 +.nr 31 \n(.f
35.1158 +.nr 35 1m
35.1159 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.1160 +.ne \n(a|u+\n(.Vu
35.1161 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.1162 +.ta \n(80u \n(81u
35.1163 +.nr 31 \n(.f
35.1164 +.nr 35 1m
35.1165 +\&\h'|\n(40u'Loaded\h'|\n(41u'
35.1166 +.mk ##
35.1167 +.nr 31 \n(##
35.1168 +.sp |\n(##u-1v
35.1169 +.nr 37 \n(41u
35.1170 +.in +\n(37u
35.1171 +.a+
35.1172 +.in -\n(37u
35.1173 +.mk 32
35.1174 +.if \n(32>\n(31 .nr 31 \n(32
35.1175 +.sp |\n(31u
35.1176 +.ne \n(b|u+\n(.Vu
35.1177 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.1178 +.ta \n(80u \n(81u
35.1179 +.nr 31 \n(.f
35.1180 +.nr 35 1m
35.1181 +\&\h'|\n(40u'Bytes\h'|\n(41u'
35.1182 +.mk ##
35.1183 +.nr 31 \n(##
35.1184 +.sp |\n(##u-1v
35.1185 +.nr 37 \n(41u
35.1186 +.in +\n(37u
35.1187 +.b+
35.1188 +.in -\n(37u
35.1189 +.mk 32
35.1190 +.if \n(32>\n(31 .nr 31 \n(32
35.1191 +.sp |\n(31u
35.1192 +.ne \n(c|u+\n(.Vu
35.1193 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.1194 +.ta \n(80u \n(81u
35.1195 +.nr 31 \n(.f
35.1196 +.nr 35 1m
35.1197 +\&\h'|\n(40u'Unloaded\h'|\n(41u'
35.1198 +.mk ##
35.1199 +.nr 31 \n(##
35.1200 +.sp |\n(##u-1v
35.1201 +.nr 37 \n(41u
35.1202 +.in +\n(37u
35.1203 +.c+
35.1204 +.in -\n(37u
35.1205 +.mk 32
35.1206 +.if \n(32>\n(31 .nr 31 \n(32
35.1207 +.sp |\n(31u
35.1208 +.ne \n(d|u+\n(.Vu
35.1209 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.1210 +.ta \n(80u \n(81u
35.1211 +.nr 31 \n(.f
35.1212 +.nr 35 1m
35.1213 +\&\h'|\n(40u'Bytes\h'|\n(41u'
35.1214 +.mk ##
35.1215 +.nr 31 \n(##
35.1216 +.sp |\n(##u-1v
35.1217 +.nr 37 \n(41u
35.1218 +.in +\n(37u
35.1219 +.d+
35.1220 +.in -\n(37u
35.1221 +.mk 32
35.1222 +.if \n(32>\n(31 .nr 31 \n(32
35.1223 +.sp |\n(31u
35.1224 +.ne \n(e|u+\n(.Vu
35.1225 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.1226 +.ta \n(80u \n(81u
35.1227 +.nr 31 \n(.f
35.1228 +.nr 35 1m
35.1229 +\&\h'|\n(40u'Time\h'|\n(41u'
35.1230 +.mk ##
35.1231 +.nr 31 \n(##
35.1232 +.sp |\n(##u-1v
35.1233 +.nr 37 \n(41u
35.1234 +.in +\n(37u
35.1235 +.e+
35.1236 +.in -\n(37u
35.1237 +.mk 32
35.1238 +.if \n(32>\n(31 .nr 31 \n(32
35.1239 +.sp |\n(31u
35.1240 +.fc
35.1241 +.nr T. 1
35.1242 +.T# 1
35.1243 +.35
35.1244 +.rm a+
35.1245 +.rm b+
35.1246 +.rm c+
35.1247 +.rm d+
35.1248 +.rm e+
35.1249 +.TE
35.1250 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-25
35.1251 +
35.1252 +.LP
35.1253 +.SS
35.1254 +\-compiler 激с
35.1255 +.LP
35.1256 +.LP
35.1257 +.TS
35.1258 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.1259 +.de 35
35.1260 +.ps \n(.s
35.1261 +.vs \n(.vu
35.1262 +.in \n(.iu
35.1263 +.if \n(.u .fi
35.1264 +.if \n(.j .ad
35.1265 +.if \n(.j=0 .na
35.1266 +..
35.1267 +.nf
35.1268 +.nr #~ 0
35.1269 +.if n .nr #~ 0.6n
35.1270 +.ds #d .d
35.1271 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1272 +.fc
35.1273 +.nr 33 \n(.s
35.1274 +.rm 80 81
35.1275 +.nr 34 \n(.lu
35.1276 +.eo
35.1277 +.am 81
35.1278 +.br
35.1279 +.di a+
35.1280 +.35
35.1281 +.ft \n(.f
35.1282 +.ll \n(34u*1u/3u
35.1283 +.if \n(.l<\n(81 .ll \n(81u
35.1284 +.in 0
35.1285 +絎茵潟潟ゃ帥鴻
35.1286 +.br
35.1287 +.di
35.1288 +.nr a| \n(dn
35.1289 +.nr a- \n(dl
35.1290 +..
35.1291 +.ec \
35.1292 +.eo
35.1293 +.am 81
35.1294 +.br
35.1295 +.di b+
35.1296 +.35
35.1297 +.ft \n(.f
35.1298 +.ll \n(34u*1u/3u
35.1299 +.if \n(.l<\n(81 .ll \n(81u
35.1300 +.in 0
35.1301 +紊掩潟潟ゃ帥鴻
35.1302 +.br
35.1303 +.di
35.1304 +.nr b| \n(dn
35.1305 +.nr b- \n(dl
35.1306 +..
35.1307 +.ec \
35.1308 +.eo
35.1309 +.am 81
35.1310 +.br
35.1311 +.di c+
35.1312 +.35
35.1313 +.ft \n(.f
35.1314 +.ll \n(34u*1u/3u
35.1315 +.if \n(.l<\n(81 .ll \n(81u
35.1316 +.in 0
35.1317 +≦鴻潟潟ゃ帥鴻
35.1318 +.br
35.1319 +.di
35.1320 +.nr c| \n(dn
35.1321 +.nr c- \n(dl
35.1322 +..
35.1323 +.ec \
35.1324 +.eo
35.1325 +.am 81
35.1326 +.br
35.1327 +.di d+
35.1328 +.35
35.1329 +.ft \n(.f
35.1330 +.ll \n(34u*1u/3u
35.1331 +.if \n(.l<\n(81 .ll \n(81u
35.1332 +.in 0
35.1333 +潟潟ゃ帥鴻絎茵荀
35.1334 +.br
35.1335 +.di
35.1336 +.nr d| \n(dn
35.1337 +.nr d- \n(dl
35.1338 +..
35.1339 +.ec \
35.1340 +.eo
35.1341 +.am 81
35.1342 +.br
35.1343 +.di e+
35.1344 +.35
35.1345 +.ft \n(.f
35.1346 +.ll \n(34u*1u/3u
35.1347 +.if \n(.l<\n(81 .ll \n(81u
35.1348 +.in 0
35.1349 +緇紊掩潟潟ゃ潟潟ゃ帥ゃ
35.1350 +.br
35.1351 +.di
35.1352 +.nr e| \n(dn
35.1353 +.nr e- \n(dl
35.1354 +..
35.1355 +.ec \
35.1356 +.eo
35.1357 +.am 81
35.1358 +.br
35.1359 +.di f+
35.1360 +.35
35.1361 +.ft \n(.f
35.1362 +.ll \n(34u*1u/3u
35.1363 +.if \n(.l<\n(81 .ll \n(81u
35.1364 +.in 0
35.1365 +緇紊掩潟潟ゃ劫<純
35.1366 +.br
35.1367 +.di
35.1368 +.nr f| \n(dn
35.1369 +.nr f- \n(dl
35.1370 +..
35.1371 +.ec \
35.1372 +.35
35.1373 +.nf
35.1374 +.ll \n(34u
35.1375 +.nr 80 0
35.1376 +.nr 38 \wHotSpot Just\-In\-Time 潟潟ゃ腟沿若
35.1377 +.if \n(80<\n(38 .nr 80 \n(38
35.1378 +.nr 38 \w\f3\fP
35.1379 +.if \n(80<\n(38 .nr 80 \n(38
35.1380 +.nr 38 \wCompiled
35.1381 +.if \n(80<\n(38 .nr 80 \n(38
35.1382 +.nr 38 \wFailed
35.1383 +.if \n(80<\n(38 .nr 80 \n(38
35.1384 +.nr 38 \wInvalid
35.1385 +.if \n(80<\n(38 .nr 80 \n(38
35.1386 +.nr 38 \wTime
35.1387 +.if \n(80<\n(38 .nr 80 \n(38
35.1388 +.nr 38 \wFailedType
35.1389 +.if \n(80<\n(38 .nr 80 \n(38
35.1390 +.nr 38 \wFailedMethod
35.1391 +.if \n(80<\n(38 .nr 80 \n(38
35.1392 +.80
35.1393 +.rm 80
35.1394 +.nr 81 0
35.1395 +.nr 38 \w\f3茯\fP
35.1396 +.if \n(81<\n(38 .nr 81 \n(38
35.1397 +.81
35.1398 +.rm 81
35.1399 +.nr 38 \n(a-
35.1400 +.if \n(81<\n(38 .nr 81 \n(38
35.1401 +.nr 38 \n(b-
35.1402 +.if \n(81<\n(38 .nr 81 \n(38
35.1403 +.nr 38 \n(c-
35.1404 +.if \n(81<\n(38 .nr 81 \n(38
35.1405 +.nr 38 \n(d-
35.1406 +.if \n(81<\n(38 .nr 81 \n(38
35.1407 +.nr 38 \n(e-
35.1408 +.if \n(81<\n(38 .nr 81 \n(38
35.1409 +.nr 38 \n(f-
35.1410 +.if \n(81<\n(38 .nr 81 \n(38
35.1411 +.35
35.1412 +.nf
35.1413 +.ll \n(34u
35.1414 +.nr 38 1n
35.1415 +.nr 79 0
35.1416 +.nr 40 \n(79+(0*\n(38)
35.1417 +.nr 80 +\n(40
35.1418 +.nr 41 \n(80+(3*\n(38)
35.1419 +.nr 81 +\n(41
35.1420 +.nr TW \n(81
35.1421 +.if t .if \n(TW>\n(.li .tm Table at line 350 file Input is too wide - \n(TW units
35.1422 +.fc
35.1423 +.nr #T 0-1
35.1424 +.nr #a 0-1
35.1425 +.eo
35.1426 +.de T#
35.1427 +.ds #d .d
35.1428 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1429 +.mk ##
35.1430 +.nr ## -1v
35.1431 +.ls 1
35.1432 +.ls
35.1433 +..
35.1434 +.ec
35.1435 +.ta \n(80u \n(81u
35.1436 +.nr 31 \n(.f
35.1437 +.nr 35 1m
35.1438 +\&\h'|\n(40u'HotSpot Just\-In\-Time 潟潟ゃ腟沿若\h'|\n(41u'
35.1439 +.ta \n(80u \n(81u
35.1440 +.nr 31 \n(.f
35.1441 +.nr 35 1m
35.1442 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.1443 +.ne \n(a|u+\n(.Vu
35.1444 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.1445 +.ta \n(80u \n(81u
35.1446 +.nr 31 \n(.f
35.1447 +.nr 35 1m
35.1448 +\&\h'|\n(40u'Compiled\h'|\n(41u'
35.1449 +.mk ##
35.1450 +.nr 31 \n(##
35.1451 +.sp |\n(##u-1v
35.1452 +.nr 37 \n(41u
35.1453 +.in +\n(37u
35.1454 +.a+
35.1455 +.in -\n(37u
35.1456 +.mk 32
35.1457 +.if \n(32>\n(31 .nr 31 \n(32
35.1458 +.sp |\n(31u
35.1459 +.ne \n(b|u+\n(.Vu
35.1460 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.1461 +.ta \n(80u \n(81u
35.1462 +.nr 31 \n(.f
35.1463 +.nr 35 1m
35.1464 +\&\h'|\n(40u'Failed\h'|\n(41u'
35.1465 +.mk ##
35.1466 +.nr 31 \n(##
35.1467 +.sp |\n(##u-1v
35.1468 +.nr 37 \n(41u
35.1469 +.in +\n(37u
35.1470 +.b+
35.1471 +.in -\n(37u
35.1472 +.mk 32
35.1473 +.if \n(32>\n(31 .nr 31 \n(32
35.1474 +.sp |\n(31u
35.1475 +.ne \n(c|u+\n(.Vu
35.1476 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.1477 +.ta \n(80u \n(81u
35.1478 +.nr 31 \n(.f
35.1479 +.nr 35 1m
35.1480 +\&\h'|\n(40u'Invalid\h'|\n(41u'
35.1481 +.mk ##
35.1482 +.nr 31 \n(##
35.1483 +.sp |\n(##u-1v
35.1484 +.nr 37 \n(41u
35.1485 +.in +\n(37u
35.1486 +.c+
35.1487 +.in -\n(37u
35.1488 +.mk 32
35.1489 +.if \n(32>\n(31 .nr 31 \n(32
35.1490 +.sp |\n(31u
35.1491 +.ne \n(d|u+\n(.Vu
35.1492 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.1493 +.ta \n(80u \n(81u
35.1494 +.nr 31 \n(.f
35.1495 +.nr 35 1m
35.1496 +\&\h'|\n(40u'Time\h'|\n(41u'
35.1497 +.mk ##
35.1498 +.nr 31 \n(##
35.1499 +.sp |\n(##u-1v
35.1500 +.nr 37 \n(41u
35.1501 +.in +\n(37u
35.1502 +.d+
35.1503 +.in -\n(37u
35.1504 +.mk 32
35.1505 +.if \n(32>\n(31 .nr 31 \n(32
35.1506 +.sp |\n(31u
35.1507 +.ne \n(e|u+\n(.Vu
35.1508 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.1509 +.ta \n(80u \n(81u
35.1510 +.nr 31 \n(.f
35.1511 +.nr 35 1m
35.1512 +\&\h'|\n(40u'FailedType\h'|\n(41u'
35.1513 +.mk ##
35.1514 +.nr 31 \n(##
35.1515 +.sp |\n(##u-1v
35.1516 +.nr 37 \n(41u
35.1517 +.in +\n(37u
35.1518 +.e+
35.1519 +.in -\n(37u
35.1520 +.mk 32
35.1521 +.if \n(32>\n(31 .nr 31 \n(32
35.1522 +.sp |\n(31u
35.1523 +.ne \n(f|u+\n(.Vu
35.1524 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.1525 +.ta \n(80u \n(81u
35.1526 +.nr 31 \n(.f
35.1527 +.nr 35 1m
35.1528 +\&\h'|\n(40u'FailedMethod\h'|\n(41u'
35.1529 +.mk ##
35.1530 +.nr 31 \n(##
35.1531 +.sp |\n(##u-1v
35.1532 +.nr 37 \n(41u
35.1533 +.in +\n(37u
35.1534 +.f+
35.1535 +.in -\n(37u
35.1536 +.mk 32
35.1537 +.if \n(32>\n(31 .nr 31 \n(32
35.1538 +.sp |\n(31u
35.1539 +.fc
35.1540 +.nr T. 1
35.1541 +.T# 1
35.1542 +.35
35.1543 +.rm a+
35.1544 +.rm b+
35.1545 +.rm c+
35.1546 +.rm d+
35.1547 +.rm e+
35.1548 +.rm f+
35.1549 +.TE
35.1550 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-29
35.1551 +
35.1552 +.LP
35.1553 +.SS
35.1554 +\-gc 激с
35.1555 +.LP
35.1556 +.LP
35.1557 +.TS
35.1558 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.1559 +.de 35
35.1560 +.ps \n(.s
35.1561 +.vs \n(.vu
35.1562 +.in \n(.iu
35.1563 +.if \n(.u .fi
35.1564 +.if \n(.j .ad
35.1565 +.if \n(.j=0 .na
35.1566 +..
35.1567 +.nf
35.1568 +.nr #~ 0
35.1569 +.if n .nr #~ 0.6n
35.1570 +.ds #d .d
35.1571 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1572 +.fc
35.1573 +.nr 33 \n(.s
35.1574 +.rm 80 81
35.1575 +.nr 34 \n(.lu
35.1576 +.eo
35.1577 +.am 81
35.1578 +.br
35.1579 +.di a+
35.1580 +.35
35.1581 +.ft \n(.f
35.1582 +.ll \n(34u*1u/3u
35.1583 +.if \n(.l<\n(81 .ll \n(81u
35.1584 +.in 0
35.1585 +Survivor 0 憜絎拷 (KB)
35.1586 +.br
35.1587 +.di
35.1588 +.nr a| \n(dn
35.1589 +.nr a- \n(dl
35.1590 +..
35.1591 +.ec \
35.1592 +.eo
35.1593 +.am 81
35.1594 +.br
35.1595 +.di b+
35.1596 +.35
35.1597 +.ft \n(.f
35.1598 +.ll \n(34u*1u/3u
35.1599 +.if \n(.l<\n(81 .ll \n(81u
35.1600 +.in 0
35.1601 +Survivor 1 憜絎拷 (KB)
35.1602 +.br
35.1603 +.di
35.1604 +.nr b| \n(dn
35.1605 +.nr b- \n(dl
35.1606 +..
35.1607 +.ec \
35.1608 +.eo
35.1609 +.am 81
35.1610 +.br
35.1611 +.di c+
35.1612 +.35
35.1613 +.ft \n(.f
35.1614 +.ll \n(34u*1u/3u
35.1615 +.if \n(.l<\n(81 .ll \n(81u
35.1616 +.in 0
35.1617 +Survivor 0 篏睡 (KB)
35.1618 +.br
35.1619 +.di
35.1620 +.nr c| \n(dn
35.1621 +.nr c- \n(dl
35.1622 +..
35.1623 +.ec \
35.1624 +.eo
35.1625 +.am 81
35.1626 +.br
35.1627 +.di d+
35.1628 +.35
35.1629 +.ft \n(.f
35.1630 +.ll \n(34u*1u/3u
35.1631 +.if \n(.l<\n(81 .ll \n(81u
35.1632 +.in 0
35.1633 +Survivor 1 篏睡 (KB)
35.1634 +.br
35.1635 +.di
35.1636 +.nr d| \n(dn
35.1637 +.nr d- \n(dl
35.1638 +..
35.1639 +.ec \
35.1640 +.eo
35.1641 +.am 81
35.1642 +.br
35.1643 +.di e+
35.1644 +.35
35.1645 +.ft \n(.f
35.1646 +.ll \n(34u*1u/3u
35.1647 +.if \n(.l<\n(81 .ll \n(81u
35.1648 +.in 0
35.1649 +Eden 憜絎拷 (KB)
35.1650 +.br
35.1651 +.di
35.1652 +.nr e| \n(dn
35.1653 +.nr e- \n(dl
35.1654 +..
35.1655 +.ec \
35.1656 +.eo
35.1657 +.am 81
35.1658 +.br
35.1659 +.di f+
35.1660 +.35
35.1661 +.ft \n(.f
35.1662 +.ll \n(34u*1u/3u
35.1663 +.if \n(.l<\n(81 .ll \n(81u
35.1664 +.in 0
35.1665 +Eden 篏睡 (KB)
35.1666 +.br
35.1667 +.di
35.1668 +.nr f| \n(dn
35.1669 +.nr f- \n(dl
35.1670 +..
35.1671 +.ec \
35.1672 +.eo
35.1673 +.am 81
35.1674 +.br
35.1675 +.di g+
35.1676 +.35
35.1677 +.ft \n(.f
35.1678 +.ll \n(34u*1u/3u
35.1679 +.if \n(.l<\n(81 .ll \n(81u
35.1680 +.in 0
35.1681 +Old 憜絎拷 (KB)
35.1682 +.br
35.1683 +.di
35.1684 +.nr g| \n(dn
35.1685 +.nr g- \n(dl
35.1686 +..
35.1687 +.ec \
35.1688 +.eo
35.1689 +.am 81
35.1690 +.br
35.1691 +.di h+
35.1692 +.35
35.1693 +.ft \n(.f
35.1694 +.ll \n(34u*1u/3u
35.1695 +.if \n(.l<\n(81 .ll \n(81u
35.1696 +.in 0
35.1697 +Old 篏睡 (KB)
35.1698 +.br
35.1699 +.di
35.1700 +.nr h| \n(dn
35.1701 +.nr h- \n(dl
35.1702 +..
35.1703 +.ec \
35.1704 +.eo
35.1705 +.am 81
35.1706 +.br
35.1707 +.di i+
35.1708 +.35
35.1709 +.ft \n(.f
35.1710 +.ll \n(34u*1u/3u
35.1711 +.if \n(.l<\n(81 .ll \n(81u
35.1712 +.in 0
35.1713 +Permanent 憜絎拷 (KB)
35.1714 +.br
35.1715 +.di
35.1716 +.nr i| \n(dn
35.1717 +.nr i- \n(dl
35.1718 +..
35.1719 +.ec \
35.1720 +.eo
35.1721 +.am 81
35.1722 +.br
35.1723 +.di j+
35.1724 +.35
35.1725 +.ft \n(.f
35.1726 +.ll \n(34u*1u/3u
35.1727 +.if \n(.l<\n(81 .ll \n(81u
35.1728 +.in 0
35.1729 +Permanent 篏睡 (KB)
35.1730 +.br
35.1731 +.di
35.1732 +.nr j| \n(dn
35.1733 +.nr j- \n(dl
35.1734 +..
35.1735 +.ec \
35.1736 +.eo
35.1737 +.am 81
35.1738 +.br
35.1739 +.di k+
35.1740 +.35
35.1741 +.ft \n(.f
35.1742 +.ll \n(34u*1u/3u
35.1743 +.if \n(.l<\n(81 .ll \n(81u
35.1744 +.in 0
35.1745 +ャ筝篁c GC ゃ潟
35.1746 +.br
35.1747 +.di
35.1748 +.nr k| \n(dn
35.1749 +.nr k- \n(dl
35.1750 +..
35.1751 +.ec \
35.1752 +.eo
35.1753 +.am 81
35.1754 +.br
35.1755 +.di l+
35.1756 +.35
35.1757 +.ft \n(.f
35.1758 +.ll \n(34u*1u/3u
35.1759 +.if \n(.l<\n(81 .ll \n(81u
35.1760 +.in 0
35.1761 +ャ筝篁c若吾潟激с恰
35.1762 +.br
35.1763 +.di
35.1764 +.nr l| \n(dn
35.1765 +.nr l- \n(dl
35.1766 +..
35.1767 +.ec \
35.1768 +.eo
35.1769 +.am 81
35.1770 +.br
35.1771 +.di m+
35.1772 +.35
35.1773 +.ft \n(.f
35.1774 +.ll \n(34u*1u/3u
35.1775 +.if \n(.l<\n(81 .ll \n(81u
35.1776 +.in 0
35.1777 +若吾潟激с恰
35.1778 +.br
35.1779 +.di
35.1780 +.nr m| \n(dn
35.1781 +.nr m- \n(dl
35.1782 +..
35.1783 +.ec \
35.1784 +.eo
35.1785 +.am 81
35.1786 +.br
35.1787 +.di n+
35.1788 +.35
35.1789 +.ft \n(.f
35.1790 +.ll \n(34u*1u/3u
35.1791 +.if \n(.l<\n(81 .ll \n(81u
35.1792 +.in 0
35.1793 +若吾潟激с括
35.1794 +.br
35.1795 +.di
35.1796 +.nr n| \n(dn
35.1797 +.nr n- \n(dl
35.1798 +..
35.1799 +.ec \
35.1800 +.35
35.1801 +.nf
35.1802 +.ll \n(34u
35.1803 +.nr 80 0
35.1804 +.nr 38 \w若吾潟若腟沿若
35.1805 +.if \n(80<\n(38 .nr 80 \n(38
35.1806 +.nr 38 \w\f3\fP
35.1807 +.if \n(80<\n(38 .nr 80 \n(38
35.1808 +.nr 38 \wS0C
35.1809 +.if \n(80<\n(38 .nr 80 \n(38
35.1810 +.nr 38 \wS1C
35.1811 +.if \n(80<\n(38 .nr 80 \n(38
35.1812 +.nr 38 \wS0U
35.1813 +.if \n(80<\n(38 .nr 80 \n(38
35.1814 +.nr 38 \wS1U
35.1815 +.if \n(80<\n(38 .nr 80 \n(38
35.1816 +.nr 38 \wEC
35.1817 +.if \n(80<\n(38 .nr 80 \n(38
35.1818 +.nr 38 \wEU
35.1819 +.if \n(80<\n(38 .nr 80 \n(38
35.1820 +.nr 38 \wOC
35.1821 +.if \n(80<\n(38 .nr 80 \n(38
35.1822 +.nr 38 \wOU
35.1823 +.if \n(80<\n(38 .nr 80 \n(38
35.1824 +.nr 38 \wPC
35.1825 +.if \n(80<\n(38 .nr 80 \n(38
35.1826 +.nr 38 \wPU
35.1827 +.if \n(80<\n(38 .nr 80 \n(38
35.1828 +.nr 38 \wYGC
35.1829 +.if \n(80<\n(38 .nr 80 \n(38
35.1830 +.nr 38 \wYGCT
35.1831 +.if \n(80<\n(38 .nr 80 \n(38
35.1832 +.nr 38 \wFGC
35.1833 +.if \n(80<\n(38 .nr 80 \n(38
35.1834 +.nr 38 \wFGCT
35.1835 +.if \n(80<\n(38 .nr 80 \n(38
35.1836 +.nr 38 \wGCT
35.1837 +.if \n(80<\n(38 .nr 80 \n(38
35.1838 +.80
35.1839 +.rm 80
35.1840 +.nr 81 0
35.1841 +.nr 38 \w\f3茯\fP
35.1842 +.if \n(81<\n(38 .nr 81 \n(38
35.1843 +.nr 38 \w GC ゃ潟
35.1844 +.if \n(81<\n(38 .nr 81 \n(38
35.1845 +.81
35.1846 +.rm 81
35.1847 +.nr 38 \n(a-
35.1848 +.if \n(81<\n(38 .nr 81 \n(38
35.1849 +.nr 38 \n(b-
35.1850 +.if \n(81<\n(38 .nr 81 \n(38
35.1851 +.nr 38 \n(c-
35.1852 +.if \n(81<\n(38 .nr 81 \n(38
35.1853 +.nr 38 \n(d-
35.1854 +.if \n(81<\n(38 .nr 81 \n(38
35.1855 +.nr 38 \n(e-
35.1856 +.if \n(81<\n(38 .nr 81 \n(38
35.1857 +.nr 38 \n(f-
35.1858 +.if \n(81<\n(38 .nr 81 \n(38
35.1859 +.nr 38 \n(g-
35.1860 +.if \n(81<\n(38 .nr 81 \n(38
35.1861 +.nr 38 \n(h-
35.1862 +.if \n(81<\n(38 .nr 81 \n(38
35.1863 +.nr 38 \n(i-
35.1864 +.if \n(81<\n(38 .nr 81 \n(38
35.1865 +.nr 38 \n(j-
35.1866 +.if \n(81<\n(38 .nr 81 \n(38
35.1867 +.nr 38 \n(k-
35.1868 +.if \n(81<\n(38 .nr 81 \n(38
35.1869 +.nr 38 \n(l-
35.1870 +.if \n(81<\n(38 .nr 81 \n(38
35.1871 +.nr 38 \n(m-
35.1872 +.if \n(81<\n(38 .nr 81 \n(38
35.1873 +.nr 38 \n(n-
35.1874 +.if \n(81<\n(38 .nr 81 \n(38
35.1875 +.35
35.1876 +.nf
35.1877 +.ll \n(34u
35.1878 +.nr 38 1n
35.1879 +.nr 79 0
35.1880 +.nr 40 \n(79+(0*\n(38)
35.1881 +.nr 80 +\n(40
35.1882 +.nr 41 \n(80+(3*\n(38)
35.1883 +.nr 81 +\n(41
35.1884 +.nr TW \n(81
35.1885 +.if t .if \n(TW>\n(.li .tm Table at line 420 file Input is too wide - \n(TW units
35.1886 +.fc
35.1887 +.nr #T 0-1
35.1888 +.nr #a 0-1
35.1889 +.eo
35.1890 +.de T#
35.1891 +.ds #d .d
35.1892 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.1893 +.mk ##
35.1894 +.nr ## -1v
35.1895 +.ls 1
35.1896 +.ls
35.1897 +..
35.1898 +.ec
35.1899 +.ta \n(80u \n(81u
35.1900 +.nr 31 \n(.f
35.1901 +.nr 35 1m
35.1902 +\&\h'|\n(40u'若吾潟若腟沿若\h'|\n(41u'
35.1903 +.ta \n(80u \n(81u
35.1904 +.nr 31 \n(.f
35.1905 +.nr 35 1m
35.1906 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.1907 +.ne \n(a|u+\n(.Vu
35.1908 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.1909 +.ta \n(80u \n(81u
35.1910 +.nr 31 \n(.f
35.1911 +.nr 35 1m
35.1912 +\&\h'|\n(40u'S0C\h'|\n(41u'
35.1913 +.mk ##
35.1914 +.nr 31 \n(##
35.1915 +.sp |\n(##u-1v
35.1916 +.nr 37 \n(41u
35.1917 +.in +\n(37u
35.1918 +.a+
35.1919 +.in -\n(37u
35.1920 +.mk 32
35.1921 +.if \n(32>\n(31 .nr 31 \n(32
35.1922 +.sp |\n(31u
35.1923 +.ne \n(b|u+\n(.Vu
35.1924 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.1925 +.ta \n(80u \n(81u
35.1926 +.nr 31 \n(.f
35.1927 +.nr 35 1m
35.1928 +\&\h'|\n(40u'S1C\h'|\n(41u'
35.1929 +.mk ##
35.1930 +.nr 31 \n(##
35.1931 +.sp |\n(##u-1v
35.1932 +.nr 37 \n(41u
35.1933 +.in +\n(37u
35.1934 +.b+
35.1935 +.in -\n(37u
35.1936 +.mk 32
35.1937 +.if \n(32>\n(31 .nr 31 \n(32
35.1938 +.sp |\n(31u
35.1939 +.ne \n(c|u+\n(.Vu
35.1940 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.1941 +.ta \n(80u \n(81u
35.1942 +.nr 31 \n(.f
35.1943 +.nr 35 1m
35.1944 +\&\h'|\n(40u'S0U\h'|\n(41u'
35.1945 +.mk ##
35.1946 +.nr 31 \n(##
35.1947 +.sp |\n(##u-1v
35.1948 +.nr 37 \n(41u
35.1949 +.in +\n(37u
35.1950 +.c+
35.1951 +.in -\n(37u
35.1952 +.mk 32
35.1953 +.if \n(32>\n(31 .nr 31 \n(32
35.1954 +.sp |\n(31u
35.1955 +.ne \n(d|u+\n(.Vu
35.1956 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.1957 +.ta \n(80u \n(81u
35.1958 +.nr 31 \n(.f
35.1959 +.nr 35 1m
35.1960 +\&\h'|\n(40u'S1U\h'|\n(41u'
35.1961 +.mk ##
35.1962 +.nr 31 \n(##
35.1963 +.sp |\n(##u-1v
35.1964 +.nr 37 \n(41u
35.1965 +.in +\n(37u
35.1966 +.d+
35.1967 +.in -\n(37u
35.1968 +.mk 32
35.1969 +.if \n(32>\n(31 .nr 31 \n(32
35.1970 +.sp |\n(31u
35.1971 +.ne \n(e|u+\n(.Vu
35.1972 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.1973 +.ta \n(80u \n(81u
35.1974 +.nr 31 \n(.f
35.1975 +.nr 35 1m
35.1976 +\&\h'|\n(40u'EC\h'|\n(41u'
35.1977 +.mk ##
35.1978 +.nr 31 \n(##
35.1979 +.sp |\n(##u-1v
35.1980 +.nr 37 \n(41u
35.1981 +.in +\n(37u
35.1982 +.e+
35.1983 +.in -\n(37u
35.1984 +.mk 32
35.1985 +.if \n(32>\n(31 .nr 31 \n(32
35.1986 +.sp |\n(31u
35.1987 +.ne \n(f|u+\n(.Vu
35.1988 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.1989 +.ta \n(80u \n(81u
35.1990 +.nr 31 \n(.f
35.1991 +.nr 35 1m
35.1992 +\&\h'|\n(40u'EU\h'|\n(41u'
35.1993 +.mk ##
35.1994 +.nr 31 \n(##
35.1995 +.sp |\n(##u-1v
35.1996 +.nr 37 \n(41u
35.1997 +.in +\n(37u
35.1998 +.f+
35.1999 +.in -\n(37u
35.2000 +.mk 32
35.2001 +.if \n(32>\n(31 .nr 31 \n(32
35.2002 +.sp |\n(31u
35.2003 +.ne \n(g|u+\n(.Vu
35.2004 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.2005 +.ta \n(80u \n(81u
35.2006 +.nr 31 \n(.f
35.2007 +.nr 35 1m
35.2008 +\&\h'|\n(40u'OC\h'|\n(41u'
35.2009 +.mk ##
35.2010 +.nr 31 \n(##
35.2011 +.sp |\n(##u-1v
35.2012 +.nr 37 \n(41u
35.2013 +.in +\n(37u
35.2014 +.g+
35.2015 +.in -\n(37u
35.2016 +.mk 32
35.2017 +.if \n(32>\n(31 .nr 31 \n(32
35.2018 +.sp |\n(31u
35.2019 +.ne \n(h|u+\n(.Vu
35.2020 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.2021 +.ta \n(80u \n(81u
35.2022 +.nr 31 \n(.f
35.2023 +.nr 35 1m
35.2024 +\&\h'|\n(40u'OU\h'|\n(41u'
35.2025 +.mk ##
35.2026 +.nr 31 \n(##
35.2027 +.sp |\n(##u-1v
35.2028 +.nr 37 \n(41u
35.2029 +.in +\n(37u
35.2030 +.h+
35.2031 +.in -\n(37u
35.2032 +.mk 32
35.2033 +.if \n(32>\n(31 .nr 31 \n(32
35.2034 +.sp |\n(31u
35.2035 +.ne \n(i|u+\n(.Vu
35.2036 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.2037 +.ta \n(80u \n(81u
35.2038 +.nr 31 \n(.f
35.2039 +.nr 35 1m
35.2040 +\&\h'|\n(40u'PC\h'|\n(41u'
35.2041 +.mk ##
35.2042 +.nr 31 \n(##
35.2043 +.sp |\n(##u-1v
35.2044 +.nr 37 \n(41u
35.2045 +.in +\n(37u
35.2046 +.i+
35.2047 +.in -\n(37u
35.2048 +.mk 32
35.2049 +.if \n(32>\n(31 .nr 31 \n(32
35.2050 +.sp |\n(31u
35.2051 +.ne \n(j|u+\n(.Vu
35.2052 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
35.2053 +.ta \n(80u \n(81u
35.2054 +.nr 31 \n(.f
35.2055 +.nr 35 1m
35.2056 +\&\h'|\n(40u'PU\h'|\n(41u'
35.2057 +.mk ##
35.2058 +.nr 31 \n(##
35.2059 +.sp |\n(##u-1v
35.2060 +.nr 37 \n(41u
35.2061 +.in +\n(37u
35.2062 +.j+
35.2063 +.in -\n(37u
35.2064 +.mk 32
35.2065 +.if \n(32>\n(31 .nr 31 \n(32
35.2066 +.sp |\n(31u
35.2067 +.ne \n(k|u+\n(.Vu
35.2068 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
35.2069 +.ta \n(80u \n(81u
35.2070 +.nr 31 \n(.f
35.2071 +.nr 35 1m
35.2072 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.2073 +.mk ##
35.2074 +.nr 31 \n(##
35.2075 +.sp |\n(##u-1v
35.2076 +.nr 37 \n(41u
35.2077 +.in +\n(37u
35.2078 +.k+
35.2079 +.in -\n(37u
35.2080 +.mk 32
35.2081 +.if \n(32>\n(31 .nr 31 \n(32
35.2082 +.sp |\n(31u
35.2083 +.ne \n(l|u+\n(.Vu
35.2084 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
35.2085 +.ta \n(80u \n(81u
35.2086 +.nr 31 \n(.f
35.2087 +.nr 35 1m
35.2088 +\&\h'|\n(40u'YGCT\h'|\n(41u'
35.2089 +.mk ##
35.2090 +.nr 31 \n(##
35.2091 +.sp |\n(##u-1v
35.2092 +.nr 37 \n(41u
35.2093 +.in +\n(37u
35.2094 +.l+
35.2095 +.in -\n(37u
35.2096 +.mk 32
35.2097 +.if \n(32>\n(31 .nr 31 \n(32
35.2098 +.sp |\n(31u
35.2099 +.ta \n(80u \n(81u
35.2100 +.nr 31 \n(.f
35.2101 +.nr 35 1m
35.2102 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.2103 +.ne \n(m|u+\n(.Vu
35.2104 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
35.2105 +.ta \n(80u \n(81u
35.2106 +.nr 31 \n(.f
35.2107 +.nr 35 1m
35.2108 +\&\h'|\n(40u'FGCT\h'|\n(41u'
35.2109 +.mk ##
35.2110 +.nr 31 \n(##
35.2111 +.sp |\n(##u-1v
35.2112 +.nr 37 \n(41u
35.2113 +.in +\n(37u
35.2114 +.m+
35.2115 +.in -\n(37u
35.2116 +.mk 32
35.2117 +.if \n(32>\n(31 .nr 31 \n(32
35.2118 +.sp |\n(31u
35.2119 +.ne \n(n|u+\n(.Vu
35.2120 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
35.2121 +.ta \n(80u \n(81u
35.2122 +.nr 31 \n(.f
35.2123 +.nr 35 1m
35.2124 +\&\h'|\n(40u'GCT\h'|\n(41u'
35.2125 +.mk ##
35.2126 +.nr 31 \n(##
35.2127 +.sp |\n(##u-1v
35.2128 +.nr 37 \n(41u
35.2129 +.in +\n(37u
35.2130 +.n+
35.2131 +.in -\n(37u
35.2132 +.mk 32
35.2133 +.if \n(32>\n(31 .nr 31 \n(32
35.2134 +.sp |\n(31u
35.2135 +.fc
35.2136 +.nr T. 1
35.2137 +.T# 1
35.2138 +.35
35.2139 +.rm a+
35.2140 +.rm b+
35.2141 +.rm c+
35.2142 +.rm d+
35.2143 +.rm e+
35.2144 +.rm f+
35.2145 +.rm g+
35.2146 +.rm h+
35.2147 +.rm i+
35.2148 +.rm j+
35.2149 +.rm k+
35.2150 +.rm l+
35.2151 +.rm m+
35.2152 +.rm n+
35.2153 +.TE
35.2154 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
35.2155 +
35.2156 +.LP
35.2157 +.SS
35.2158 +\-gccapacity 激с
35.2159 +.LP
35.2160 +.LP
35.2161 +.TS
35.2162 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.2163 +.de 35
35.2164 +.ps \n(.s
35.2165 +.vs \n(.vu
35.2166 +.in \n(.iu
35.2167 +.if \n(.u .fi
35.2168 +.if \n(.j .ad
35.2169 +.if \n(.j=0 .na
35.2170 +..
35.2171 +.nf
35.2172 +.nr #~ 0
35.2173 +.if n .nr #~ 0.6n
35.2174 +.ds #d .d
35.2175 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.2176 +.fc
35.2177 +.nr 33 \n(.s
35.2178 +.rm 80 81
35.2179 +.nr 34 \n(.lu
35.2180 +.eo
35.2181 +.am 81
35.2182 +.br
35.2183 +.di a+
35.2184 +.35
35.2185 +.ft \n(.f
35.2186 +.ll \n(34u*1u/3u
35.2187 +.if \n(.l<\n(81 .ll \n(81u
35.2188 +.in 0
35.2189 +New 筝篁c絨鎘拷 (KB)
35.2190 +.br
35.2191 +.di
35.2192 +.nr a| \n(dn
35.2193 +.nr a- \n(dl
35.2194 +..
35.2195 +.ec \
35.2196 +.eo
35.2197 +.am 81
35.2198 +.br
35.2199 +.di b+
35.2200 +.35
35.2201 +.ft \n(.f
35.2202 +.ll \n(34u*1u/3u
35.2203 +.if \n(.l<\n(81 .ll \n(81u
35.2204 +.in 0
35.2205 +New 筝篁c紊у拷 (KB)
35.2206 +.br
35.2207 +.di
35.2208 +.nr b| \n(dn
35.2209 +.nr b- \n(dl
35.2210 +..
35.2211 +.ec \
35.2212 +.eo
35.2213 +.am 81
35.2214 +.br
35.2215 +.di c+
35.2216 +.35
35.2217 +.ft \n(.f
35.2218 +.ll \n(34u*1u/3u
35.2219 +.if \n(.l<\n(81 .ll \n(81u
35.2220 +.in 0
35.2221 +New 筝篁c憜絎拷 (KB)
35.2222 +.br
35.2223 +.di
35.2224 +.nr c| \n(dn
35.2225 +.nr c- \n(dl
35.2226 +..
35.2227 +.ec \
35.2228 +.eo
35.2229 +.am 81
35.2230 +.br
35.2231 +.di d+
35.2232 +.35
35.2233 +.ft \n(.f
35.2234 +.ll \n(34u*1u/3u
35.2235 +.if \n(.l<\n(81 .ll \n(81u
35.2236 +.in 0
35.2237 +Survivor 0 憜絎拷 (KB)
35.2238 +.br
35.2239 +.di
35.2240 +.nr d| \n(dn
35.2241 +.nr d- \n(dl
35.2242 +..
35.2243 +.ec \
35.2244 +.eo
35.2245 +.am 81
35.2246 +.br
35.2247 +.di e+
35.2248 +.35
35.2249 +.ft \n(.f
35.2250 +.ll \n(34u*1u/3u
35.2251 +.if \n(.l<\n(81 .ll \n(81u
35.2252 +.in 0
35.2253 +Survivor 1 憜絎拷 (KB)
35.2254 +.br
35.2255 +.di
35.2256 +.nr e| \n(dn
35.2257 +.nr e- \n(dl
35.2258 +..
35.2259 +.ec \
35.2260 +.eo
35.2261 +.am 81
35.2262 +.br
35.2263 +.di f+
35.2264 +.35
35.2265 +.ft \n(.f
35.2266 +.ll \n(34u*1u/3u
35.2267 +.if \n(.l<\n(81 .ll \n(81u
35.2268 +.in 0
35.2269 +Eden 憜絎拷 (KB)
35.2270 +.br
35.2271 +.di
35.2272 +.nr f| \n(dn
35.2273 +.nr f- \n(dl
35.2274 +..
35.2275 +.ec \
35.2276 +.eo
35.2277 +.am 81
35.2278 +.br
35.2279 +.di g+
35.2280 +.35
35.2281 +.ft \n(.f
35.2282 +.ll \n(34u*1u/3u
35.2283 +.if \n(.l<\n(81 .ll \n(81u
35.2284 +.in 0
35.2285 +Old 筝篁c絨鎘拷 (KB)
35.2286 +.br
35.2287 +.di
35.2288 +.nr g| \n(dn
35.2289 +.nr g- \n(dl
35.2290 +..
35.2291 +.ec \
35.2292 +.eo
35.2293 +.am 81
35.2294 +.br
35.2295 +.di h+
35.2296 +.35
35.2297 +.ft \n(.f
35.2298 +.ll \n(34u*1u/3u
35.2299 +.if \n(.l<\n(81 .ll \n(81u
35.2300 +.in 0
35.2301 +Old 筝篁c紊у拷 (KB)
35.2302 +.br
35.2303 +.di
35.2304 +.nr h| \n(dn
35.2305 +.nr h- \n(dl
35.2306 +..
35.2307 +.ec \
35.2308 +.eo
35.2309 +.am 81
35.2310 +.br
35.2311 +.di i+
35.2312 +.35
35.2313 +.ft \n(.f
35.2314 +.ll \n(34u*1u/3u
35.2315 +.if \n(.l<\n(81 .ll \n(81u
35.2316 +.in 0
35.2317 +Old 筝篁c憜絎拷 (KB)
35.2318 +.br
35.2319 +.di
35.2320 +.nr i| \n(dn
35.2321 +.nr i- \n(dl
35.2322 +..
35.2323 +.ec \
35.2324 +.eo
35.2325 +.am 81
35.2326 +.br
35.2327 +.di j+
35.2328 +.35
35.2329 +.ft \n(.f
35.2330 +.ll \n(34u*1u/3u
35.2331 +.if \n(.l<\n(81 .ll \n(81u
35.2332 +.in 0
35.2333 +Old 憜絎拷 (KB)
35.2334 +.br
35.2335 +.di
35.2336 +.nr j| \n(dn
35.2337 +.nr j- \n(dl
35.2338 +..
35.2339 +.ec \
35.2340 +.eo
35.2341 +.am 81
35.2342 +.br
35.2343 +.di k+
35.2344 +.35
35.2345 +.ft \n(.f
35.2346 +.ll \n(34u*1u/3u
35.2347 +.if \n(.l<\n(81 .ll \n(81u
35.2348 +.in 0
35.2349 +Permanent 筝篁c絨鎘拷 (KB)
35.2350 +.br
35.2351 +.di
35.2352 +.nr k| \n(dn
35.2353 +.nr k- \n(dl
35.2354 +..
35.2355 +.ec \
35.2356 +.eo
35.2357 +.am 81
35.2358 +.br
35.2359 +.di l+
35.2360 +.35
35.2361 +.ft \n(.f
35.2362 +.ll \n(34u*1u/3u
35.2363 +.if \n(.l<\n(81 .ll \n(81u
35.2364 +.in 0
35.2365 +Permanent 筝篁c紊у拷 (KB)
35.2366 +.br
35.2367 +.di
35.2368 +.nr l| \n(dn
35.2369 +.nr l- \n(dl
35.2370 +..
35.2371 +.ec \
35.2372 +.eo
35.2373 +.am 81
35.2374 +.br
35.2375 +.di m+
35.2376 +.35
35.2377 +.ft \n(.f
35.2378 +.ll \n(34u*1u/3u
35.2379 +.if \n(.l<\n(81 .ll \n(81u
35.2380 +.in 0
35.2381 +Permanent 筝篁c憜絎拷 (KB)
35.2382 +.br
35.2383 +.di
35.2384 +.nr m| \n(dn
35.2385 +.nr m- \n(dl
35.2386 +..
35.2387 +.ec \
35.2388 +.eo
35.2389 +.am 81
35.2390 +.br
35.2391 +.di n+
35.2392 +.35
35.2393 +.ft \n(.f
35.2394 +.ll \n(34u*1u/3u
35.2395 +.if \n(.l<\n(81 .ll \n(81u
35.2396 +.in 0
35.2397 +Permanent 憜絎拷 (KB)
35.2398 +.br
35.2399 +.di
35.2400 +.nr n| \n(dn
35.2401 +.nr n- \n(dl
35.2402 +..
35.2403 +.ec \
35.2404 +.eo
35.2405 +.am 81
35.2406 +.br
35.2407 +.di o+
35.2408 +.35
35.2409 +.ft \n(.f
35.2410 +.ll \n(34u*1u/3u
35.2411 +.if \n(.l<\n(81 .ll \n(81u
35.2412 +.in 0
35.2413 +ャ筝篁c GC ゃ潟
35.2414 +.br
35.2415 +.di
35.2416 +.nr o| \n(dn
35.2417 +.nr o- \n(dl
35.2418 +..
35.2419 +.ec \
35.2420 +.35
35.2421 +.nf
35.2422 +.ll \n(34u
35.2423 +.nr 80 0
35.2424 +.nr 38 \w<≪若若筝篁c渇絎拷
35.2425 +.if \n(80<\n(38 .nr 80 \n(38
35.2426 +.nr 38 \w\f3\fP
35.2427 +.if \n(80<\n(38 .nr 80 \n(38
35.2428 +.nr 38 \wNGCMN
35.2429 +.if \n(80<\n(38 .nr 80 \n(38
35.2430 +.nr 38 \wNGCMX
35.2431 +.if \n(80<\n(38 .nr 80 \n(38
35.2432 +.nr 38 \wNGC
35.2433 +.if \n(80<\n(38 .nr 80 \n(38
35.2434 +.nr 38 \wS0C
35.2435 +.if \n(80<\n(38 .nr 80 \n(38
35.2436 +.nr 38 \wS1C
35.2437 +.if \n(80<\n(38 .nr 80 \n(38
35.2438 +.nr 38 \wEC
35.2439 +.if \n(80<\n(38 .nr 80 \n(38
35.2440 +.nr 38 \wOGCMN
35.2441 +.if \n(80<\n(38 .nr 80 \n(38
35.2442 +.nr 38 \wOGCMX
35.2443 +.if \n(80<\n(38 .nr 80 \n(38
35.2444 +.nr 38 \wOGC
35.2445 +.if \n(80<\n(38 .nr 80 \n(38
35.2446 +.nr 38 \wOC
35.2447 +.if \n(80<\n(38 .nr 80 \n(38
35.2448 +.nr 38 \wPGCMN
35.2449 +.if \n(80<\n(38 .nr 80 \n(38
35.2450 +.nr 38 \wPGCMX
35.2451 +.if \n(80<\n(38 .nr 80 \n(38
35.2452 +.nr 38 \wPGC
35.2453 +.if \n(80<\n(38 .nr 80 \n(38
35.2454 +.nr 38 \wPC
35.2455 +.if \n(80<\n(38 .nr 80 \n(38
35.2456 +.nr 38 \wYGC
35.2457 +.if \n(80<\n(38 .nr 80 \n(38
35.2458 +.nr 38 \wFGC
35.2459 +.if \n(80<\n(38 .nr 80 \n(38
35.2460 +.80
35.2461 +.rm 80
35.2462 +.nr 81 0
35.2463 +.nr 38 \w\f3茯\fP
35.2464 +.if \n(81<\n(38 .nr 81 \n(38
35.2465 +.nr 38 \w GC ゃ潟
35.2466 +.if \n(81<\n(38 .nr 81 \n(38
35.2467 +.81
35.2468 +.rm 81
35.2469 +.nr 38 \n(a-
35.2470 +.if \n(81<\n(38 .nr 81 \n(38
35.2471 +.nr 38 \n(b-
35.2472 +.if \n(81<\n(38 .nr 81 \n(38
35.2473 +.nr 38 \n(c-
35.2474 +.if \n(81<\n(38 .nr 81 \n(38
35.2475 +.nr 38 \n(d-
35.2476 +.if \n(81<\n(38 .nr 81 \n(38
35.2477 +.nr 38 \n(e-
35.2478 +.if \n(81<\n(38 .nr 81 \n(38
35.2479 +.nr 38 \n(f-
35.2480 +.if \n(81<\n(38 .nr 81 \n(38
35.2481 +.nr 38 \n(g-
35.2482 +.if \n(81<\n(38 .nr 81 \n(38
35.2483 +.nr 38 \n(h-
35.2484 +.if \n(81<\n(38 .nr 81 \n(38
35.2485 +.nr 38 \n(i-
35.2486 +.if \n(81<\n(38 .nr 81 \n(38
35.2487 +.nr 38 \n(j-
35.2488 +.if \n(81<\n(38 .nr 81 \n(38
35.2489 +.nr 38 \n(k-
35.2490 +.if \n(81<\n(38 .nr 81 \n(38
35.2491 +.nr 38 \n(l-
35.2492 +.if \n(81<\n(38 .nr 81 \n(38
35.2493 +.nr 38 \n(m-
35.2494 +.if \n(81<\n(38 .nr 81 \n(38
35.2495 +.nr 38 \n(n-
35.2496 +.if \n(81<\n(38 .nr 81 \n(38
35.2497 +.nr 38 \n(o-
35.2498 +.if \n(81<\n(38 .nr 81 \n(38
35.2499 +.35
35.2500 +.nf
35.2501 +.ll \n(34u
35.2502 +.nr 38 1n
35.2503 +.nr 79 0
35.2504 +.nr 40 \n(79+(0*\n(38)
35.2505 +.nr 80 +\n(40
35.2506 +.nr 41 \n(80+(3*\n(38)
35.2507 +.nr 81 +\n(41
35.2508 +.nr TW \n(81
35.2509 +.if t .if \n(TW>\n(.li .tm Table at line 494 file Input is too wide - \n(TW units
35.2510 +.fc
35.2511 +.nr #T 0-1
35.2512 +.nr #a 0-1
35.2513 +.eo
35.2514 +.de T#
35.2515 +.ds #d .d
35.2516 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.2517 +.mk ##
35.2518 +.nr ## -1v
35.2519 +.ls 1
35.2520 +.ls
35.2521 +..
35.2522 +.ec
35.2523 +.ta \n(80u \n(81u
35.2524 +.nr 31 \n(.f
35.2525 +.nr 35 1m
35.2526 +\&\h'|\n(40u'<≪若若筝篁c渇絎拷\h'|\n(41u'
35.2527 +.ta \n(80u \n(81u
35.2528 +.nr 31 \n(.f
35.2529 +.nr 35 1m
35.2530 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.2531 +.ne \n(a|u+\n(.Vu
35.2532 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.2533 +.ta \n(80u \n(81u
35.2534 +.nr 31 \n(.f
35.2535 +.nr 35 1m
35.2536 +\&\h'|\n(40u'NGCMN\h'|\n(41u'
35.2537 +.mk ##
35.2538 +.nr 31 \n(##
35.2539 +.sp |\n(##u-1v
35.2540 +.nr 37 \n(41u
35.2541 +.in +\n(37u
35.2542 +.a+
35.2543 +.in -\n(37u
35.2544 +.mk 32
35.2545 +.if \n(32>\n(31 .nr 31 \n(32
35.2546 +.sp |\n(31u
35.2547 +.ne \n(b|u+\n(.Vu
35.2548 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.2549 +.ta \n(80u \n(81u
35.2550 +.nr 31 \n(.f
35.2551 +.nr 35 1m
35.2552 +\&\h'|\n(40u'NGCMX\h'|\n(41u'
35.2553 +.mk ##
35.2554 +.nr 31 \n(##
35.2555 +.sp |\n(##u-1v
35.2556 +.nr 37 \n(41u
35.2557 +.in +\n(37u
35.2558 +.b+
35.2559 +.in -\n(37u
35.2560 +.mk 32
35.2561 +.if \n(32>\n(31 .nr 31 \n(32
35.2562 +.sp |\n(31u
35.2563 +.ne \n(c|u+\n(.Vu
35.2564 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.2565 +.ta \n(80u \n(81u
35.2566 +.nr 31 \n(.f
35.2567 +.nr 35 1m
35.2568 +\&\h'|\n(40u'NGC\h'|\n(41u'
35.2569 +.mk ##
35.2570 +.nr 31 \n(##
35.2571 +.sp |\n(##u-1v
35.2572 +.nr 37 \n(41u
35.2573 +.in +\n(37u
35.2574 +.c+
35.2575 +.in -\n(37u
35.2576 +.mk 32
35.2577 +.if \n(32>\n(31 .nr 31 \n(32
35.2578 +.sp |\n(31u
35.2579 +.ne \n(d|u+\n(.Vu
35.2580 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.2581 +.ta \n(80u \n(81u
35.2582 +.nr 31 \n(.f
35.2583 +.nr 35 1m
35.2584 +\&\h'|\n(40u'S0C\h'|\n(41u'
35.2585 +.mk ##
35.2586 +.nr 31 \n(##
35.2587 +.sp |\n(##u-1v
35.2588 +.nr 37 \n(41u
35.2589 +.in +\n(37u
35.2590 +.d+
35.2591 +.in -\n(37u
35.2592 +.mk 32
35.2593 +.if \n(32>\n(31 .nr 31 \n(32
35.2594 +.sp |\n(31u
35.2595 +.ne \n(e|u+\n(.Vu
35.2596 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.2597 +.ta \n(80u \n(81u
35.2598 +.nr 31 \n(.f
35.2599 +.nr 35 1m
35.2600 +\&\h'|\n(40u'S1C\h'|\n(41u'
35.2601 +.mk ##
35.2602 +.nr 31 \n(##
35.2603 +.sp |\n(##u-1v
35.2604 +.nr 37 \n(41u
35.2605 +.in +\n(37u
35.2606 +.e+
35.2607 +.in -\n(37u
35.2608 +.mk 32
35.2609 +.if \n(32>\n(31 .nr 31 \n(32
35.2610 +.sp |\n(31u
35.2611 +.ne \n(f|u+\n(.Vu
35.2612 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.2613 +.ta \n(80u \n(81u
35.2614 +.nr 31 \n(.f
35.2615 +.nr 35 1m
35.2616 +\&\h'|\n(40u'EC\h'|\n(41u'
35.2617 +.mk ##
35.2618 +.nr 31 \n(##
35.2619 +.sp |\n(##u-1v
35.2620 +.nr 37 \n(41u
35.2621 +.in +\n(37u
35.2622 +.f+
35.2623 +.in -\n(37u
35.2624 +.mk 32
35.2625 +.if \n(32>\n(31 .nr 31 \n(32
35.2626 +.sp |\n(31u
35.2627 +.ne \n(g|u+\n(.Vu
35.2628 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.2629 +.ta \n(80u \n(81u
35.2630 +.nr 31 \n(.f
35.2631 +.nr 35 1m
35.2632 +\&\h'|\n(40u'OGCMN\h'|\n(41u'
35.2633 +.mk ##
35.2634 +.nr 31 \n(##
35.2635 +.sp |\n(##u-1v
35.2636 +.nr 37 \n(41u
35.2637 +.in +\n(37u
35.2638 +.g+
35.2639 +.in -\n(37u
35.2640 +.mk 32
35.2641 +.if \n(32>\n(31 .nr 31 \n(32
35.2642 +.sp |\n(31u
35.2643 +.ne \n(h|u+\n(.Vu
35.2644 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.2645 +.ta \n(80u \n(81u
35.2646 +.nr 31 \n(.f
35.2647 +.nr 35 1m
35.2648 +\&\h'|\n(40u'OGCMX\h'|\n(41u'
35.2649 +.mk ##
35.2650 +.nr 31 \n(##
35.2651 +.sp |\n(##u-1v
35.2652 +.nr 37 \n(41u
35.2653 +.in +\n(37u
35.2654 +.h+
35.2655 +.in -\n(37u
35.2656 +.mk 32
35.2657 +.if \n(32>\n(31 .nr 31 \n(32
35.2658 +.sp |\n(31u
35.2659 +.ne \n(i|u+\n(.Vu
35.2660 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.2661 +.ta \n(80u \n(81u
35.2662 +.nr 31 \n(.f
35.2663 +.nr 35 1m
35.2664 +\&\h'|\n(40u'OGC\h'|\n(41u'
35.2665 +.mk ##
35.2666 +.nr 31 \n(##
35.2667 +.sp |\n(##u-1v
35.2668 +.nr 37 \n(41u
35.2669 +.in +\n(37u
35.2670 +.i+
35.2671 +.in -\n(37u
35.2672 +.mk 32
35.2673 +.if \n(32>\n(31 .nr 31 \n(32
35.2674 +.sp |\n(31u
35.2675 +.ne \n(j|u+\n(.Vu
35.2676 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
35.2677 +.ta \n(80u \n(81u
35.2678 +.nr 31 \n(.f
35.2679 +.nr 35 1m
35.2680 +\&\h'|\n(40u'OC\h'|\n(41u'
35.2681 +.mk ##
35.2682 +.nr 31 \n(##
35.2683 +.sp |\n(##u-1v
35.2684 +.nr 37 \n(41u
35.2685 +.in +\n(37u
35.2686 +.j+
35.2687 +.in -\n(37u
35.2688 +.mk 32
35.2689 +.if \n(32>\n(31 .nr 31 \n(32
35.2690 +.sp |\n(31u
35.2691 +.ne \n(k|u+\n(.Vu
35.2692 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
35.2693 +.ta \n(80u \n(81u
35.2694 +.nr 31 \n(.f
35.2695 +.nr 35 1m
35.2696 +\&\h'|\n(40u'PGCMN\h'|\n(41u'
35.2697 +.mk ##
35.2698 +.nr 31 \n(##
35.2699 +.sp |\n(##u-1v
35.2700 +.nr 37 \n(41u
35.2701 +.in +\n(37u
35.2702 +.k+
35.2703 +.in -\n(37u
35.2704 +.mk 32
35.2705 +.if \n(32>\n(31 .nr 31 \n(32
35.2706 +.sp |\n(31u
35.2707 +.ne \n(l|u+\n(.Vu
35.2708 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
35.2709 +.ta \n(80u \n(81u
35.2710 +.nr 31 \n(.f
35.2711 +.nr 35 1m
35.2712 +\&\h'|\n(40u'PGCMX\h'|\n(41u'
35.2713 +.mk ##
35.2714 +.nr 31 \n(##
35.2715 +.sp |\n(##u-1v
35.2716 +.nr 37 \n(41u
35.2717 +.in +\n(37u
35.2718 +.l+
35.2719 +.in -\n(37u
35.2720 +.mk 32
35.2721 +.if \n(32>\n(31 .nr 31 \n(32
35.2722 +.sp |\n(31u
35.2723 +.ne \n(m|u+\n(.Vu
35.2724 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
35.2725 +.ta \n(80u \n(81u
35.2726 +.nr 31 \n(.f
35.2727 +.nr 35 1m
35.2728 +\&\h'|\n(40u'PGC\h'|\n(41u'
35.2729 +.mk ##
35.2730 +.nr 31 \n(##
35.2731 +.sp |\n(##u-1v
35.2732 +.nr 37 \n(41u
35.2733 +.in +\n(37u
35.2734 +.m+
35.2735 +.in -\n(37u
35.2736 +.mk 32
35.2737 +.if \n(32>\n(31 .nr 31 \n(32
35.2738 +.sp |\n(31u
35.2739 +.ne \n(n|u+\n(.Vu
35.2740 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
35.2741 +.ta \n(80u \n(81u
35.2742 +.nr 31 \n(.f
35.2743 +.nr 35 1m
35.2744 +\&\h'|\n(40u'PC\h'|\n(41u'
35.2745 +.mk ##
35.2746 +.nr 31 \n(##
35.2747 +.sp |\n(##u-1v
35.2748 +.nr 37 \n(41u
35.2749 +.in +\n(37u
35.2750 +.n+
35.2751 +.in -\n(37u
35.2752 +.mk 32
35.2753 +.if \n(32>\n(31 .nr 31 \n(32
35.2754 +.sp |\n(31u
35.2755 +.ne \n(o|u+\n(.Vu
35.2756 +.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
35.2757 +.ta \n(80u \n(81u
35.2758 +.nr 31 \n(.f
35.2759 +.nr 35 1m
35.2760 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.2761 +.mk ##
35.2762 +.nr 31 \n(##
35.2763 +.sp |\n(##u-1v
35.2764 +.nr 37 \n(41u
35.2765 +.in +\n(37u
35.2766 +.o+
35.2767 +.in -\n(37u
35.2768 +.mk 32
35.2769 +.if \n(32>\n(31 .nr 31 \n(32
35.2770 +.sp |\n(31u
35.2771 +.ta \n(80u \n(81u
35.2772 +.nr 31 \n(.f
35.2773 +.nr 35 1m
35.2774 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.2775 +.fc
35.2776 +.nr T. 1
35.2777 +.T# 1
35.2778 +.35
35.2779 +.rm a+
35.2780 +.rm b+
35.2781 +.rm c+
35.2782 +.rm d+
35.2783 +.rm e+
35.2784 +.rm f+
35.2785 +.rm g+
35.2786 +.rm h+
35.2787 +.rm i+
35.2788 +.rm j+
35.2789 +.rm k+
35.2790 +.rm l+
35.2791 +.rm m+
35.2792 +.rm n+
35.2793 +.rm o+
35.2794 +.TE
35.2795 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-67
35.2796 +
35.2797 +.LP
35.2798 +.SS
35.2799 +\-gccause 激с
35.2800 +.LP
35.2801 +.LP
35.2802 +激с潟\f3\-gcutil\fP 激с潟若吾潟激с括輝荐若帥网荀茵腓冴障緇若吾潟激с潟ゃ潟 (純翫) 憜若吾潟激с潟ゃ潟障障\f3\-gcutil\fP т荀ц;腓冴篁激с潟с罨<菴遵障
35.2803 +.LP
35.2804 +.LP
35.2805 +.TS
35.2806 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.2807 +.de 35
35.2808 +.ps \n(.s
35.2809 +.vs \n(.vu
35.2810 +.in \n(.iu
35.2811 +.if \n(.u .fi
35.2812 +.if \n(.j .ad
35.2813 +.if \n(.j=0 .na
35.2814 +..
35.2815 +.nf
35.2816 +.nr #~ 0
35.2817 +.if n .nr #~ 0.6n
35.2818 +.ds #d .d
35.2819 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.2820 +.fc
35.2821 +.nr 33 \n(.s
35.2822 +.rm 80 81
35.2823 +.nr 34 \n(.lu
35.2824 +.eo
35.2825 +.am 81
35.2826 +.br
35.2827 +.di a+
35.2828 +.35
35.2829 +.ft \n(.f
35.2830 +.ll \n(34u*1u/3u
35.2831 +.if \n(.l<\n(81 .ll \n(81u
35.2832 +.in 0
35.2833 +緇若吾潟激с潟
35.2834 +.br
35.2835 +.di
35.2836 +.nr a| \n(dn
35.2837 +.nr a- \n(dl
35.2838 +..
35.2839 +.ec \
35.2840 +.eo
35.2841 +.am 81
35.2842 +.br
35.2843 +.di b+
35.2844 +.35
35.2845 +.ft \n(.f
35.2846 +.ll \n(34u*1u/3u
35.2847 +.if \n(.l<\n(81 .ll \n(81u
35.2848 +.in 0
35.2849 +憜若吾潟激с潟
35.2850 +.br
35.2851 +.di
35.2852 +.nr b| \n(dn
35.2853 +.nr b- \n(dl
35.2854 +..
35.2855 +.ec \
35.2856 +.35
35.2857 +.nf
35.2858 +.ll \n(34u
35.2859 +.nr 80 0
35.2860 +.nr 38 \wGC ゃ潟若吾潟激с括輝荐若
35.2861 +.if \n(80<\n(38 .nr 80 \n(38
35.2862 +.nr 38 \w\f3\fP
35.2863 +.if \n(80<\n(38 .nr 80 \n(38
35.2864 +.nr 38 \wLGCC
35.2865 +.if \n(80<\n(38 .nr 80 \n(38
35.2866 +.nr 38 \wGCC
35.2867 +.if \n(80<\n(38 .nr 80 \n(38
35.2868 +.80
35.2869 +.rm 80
35.2870 +.nr 81 0
35.2871 +.nr 38 \w\f3茯\fP
35.2872 +.if \n(81<\n(38 .nr 81 \n(38
35.2873 +.81
35.2874 +.rm 81
35.2875 +.nr 38 \n(a-
35.2876 +.if \n(81<\n(38 .nr 81 \n(38
35.2877 +.nr 38 \n(b-
35.2878 +.if \n(81<\n(38 .nr 81 \n(38
35.2879 +.35
35.2880 +.nf
35.2881 +.ll \n(34u
35.2882 +.nr 38 1n
35.2883 +.nr 79 0
35.2884 +.nr 40 \n(79+(0*\n(38)
35.2885 +.nr 80 +\n(40
35.2886 +.nr 41 \n(80+(3*\n(38)
35.2887 +.nr 81 +\n(41
35.2888 +.nr TW \n(81
35.2889 +.if t .if \n(TW>\n(.li .tm Table at line 517 file Input is too wide - \n(TW units
35.2890 +.fc
35.2891 +.nr #T 0-1
35.2892 +.nr #a 0-1
35.2893 +.eo
35.2894 +.de T#
35.2895 +.ds #d .d
35.2896 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.2897 +.mk ##
35.2898 +.nr ## -1v
35.2899 +.ls 1
35.2900 +.ls
35.2901 +..
35.2902 +.ec
35.2903 +.ta \n(80u \n(81u
35.2904 +.nr 31 \n(.f
35.2905 +.nr 35 1m
35.2906 +\&\h'|\n(40u'GC ゃ潟若吾潟激с括輝荐若\h'|\n(41u'
35.2907 +.ta \n(80u \n(81u
35.2908 +.nr 31 \n(.f
35.2909 +.nr 35 1m
35.2910 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.2911 +.ne \n(a|u+\n(.Vu
35.2912 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.2913 +.ta \n(80u \n(81u
35.2914 +.nr 31 \n(.f
35.2915 +.nr 35 1m
35.2916 +\&\h'|\n(40u'LGCC\h'|\n(41u'
35.2917 +.mk ##
35.2918 +.nr 31 \n(##
35.2919 +.sp |\n(##u-1v
35.2920 +.nr 37 \n(41u
35.2921 +.in +\n(37u
35.2922 +.a+
35.2923 +.in -\n(37u
35.2924 +.mk 32
35.2925 +.if \n(32>\n(31 .nr 31 \n(32
35.2926 +.sp |\n(31u
35.2927 +.ne \n(b|u+\n(.Vu
35.2928 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.2929 +.ta \n(80u \n(81u
35.2930 +.nr 31 \n(.f
35.2931 +.nr 35 1m
35.2932 +\&\h'|\n(40u'GCC\h'|\n(41u'
35.2933 +.mk ##
35.2934 +.nr 31 \n(##
35.2935 +.sp |\n(##u-1v
35.2936 +.nr 37 \n(41u
35.2937 +.in +\n(37u
35.2938 +.b+
35.2939 +.in -\n(37u
35.2940 +.mk 32
35.2941 +.if \n(32>\n(31 .nr 31 \n(32
35.2942 +.sp |\n(31u
35.2943 +.fc
35.2944 +.nr T. 1
35.2945 +.T# 1
35.2946 +.35
35.2947 +.rm a+
35.2948 +.rm b+
35.2949 +.TE
35.2950 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-13
35.2951 +
35.2952 +.LP
35.2953 +.SS
35.2954 +\-gcnew 激с
35.2955 +.LP
35.2956 +.LP
35.2957 +.TS
35.2958 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.2959 +.de 35
35.2960 +.ps \n(.s
35.2961 +.vs \n(.vu
35.2962 +.in \n(.iu
35.2963 +.if \n(.u .fi
35.2964 +.if \n(.j .ad
35.2965 +.if \n(.j=0 .na
35.2966 +..
35.2967 +.nf
35.2968 +.nr #~ 0
35.2969 +.if n .nr #~ 0.6n
35.2970 +.ds #d .d
35.2971 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.2972 +.fc
35.2973 +.nr 33 \n(.s
35.2974 +.rm 80 81
35.2975 +.nr 34 \n(.lu
35.2976 +.eo
35.2977 +.am 81
35.2978 +.br
35.2979 +.di a+
35.2980 +.35
35.2981 +.ft \n(.f
35.2982 +.ll \n(34u*1u/3u
35.2983 +.if \n(.l<\n(81 .ll \n(81u
35.2984 +.in 0
35.2985 +Survivor 0 憜絎拷 (KB)
35.2986 +.br
35.2987 +.di
35.2988 +.nr a| \n(dn
35.2989 +.nr a- \n(dl
35.2990 +..
35.2991 +.ec \
35.2992 +.eo
35.2993 +.am 81
35.2994 +.br
35.2995 +.di b+
35.2996 +.35
35.2997 +.ft \n(.f
35.2998 +.ll \n(34u*1u/3u
35.2999 +.if \n(.l<\n(81 .ll \n(81u
35.3000 +.in 0
35.3001 +Survivor 1 憜絎拷 (KB)
35.3002 +.br
35.3003 +.di
35.3004 +.nr b| \n(dn
35.3005 +.nr b- \n(dl
35.3006 +..
35.3007 +.ec \
35.3008 +.eo
35.3009 +.am 81
35.3010 +.br
35.3011 +.di c+
35.3012 +.35
35.3013 +.ft \n(.f
35.3014 +.ll \n(34u*1u/3u
35.3015 +.if \n(.l<\n(81 .ll \n(81u
35.3016 +.in 0
35.3017 +Survivor 0 篏睡 (KB)
35.3018 +.br
35.3019 +.di
35.3020 +.nr c| \n(dn
35.3021 +.nr c- \n(dl
35.3022 +..
35.3023 +.ec \
35.3024 +.eo
35.3025 +.am 81
35.3026 +.br
35.3027 +.di d+
35.3028 +.35
35.3029 +.ft \n(.f
35.3030 +.ll \n(34u*1u/3u
35.3031 +.if \n(.l<\n(81 .ll \n(81u
35.3032 +.in 0
35.3033 +Survivor 1 篏睡 (KB)
35.3034 +.br
35.3035 +.di
35.3036 +.nr d| \n(dn
35.3037 +.nr d- \n(dl
35.3038 +..
35.3039 +.ec \
35.3040 +.eo
35.3041 +.am 81
35.3042 +.br
35.3043 +.di e+
35.3044 +.35
35.3045 +.ft \n(.f
35.3046 +.ll \n(34u*1u/3u
35.3047 +.if \n(.l<\n(81 .ll \n(81u
35.3048 +.in 0
35.3049 +紊ф水ャ
35.3050 +.br
35.3051 +.di
35.3052 +.nr e| \n(dn
35.3053 +.nr e- \n(dl
35.3054 +..
35.3055 +.ec \
35.3056 +.eo
35.3057 +.am 81
35.3058 +.br
35.3059 +.di f+
35.3060 +.35
35.3061 +.ft \n(.f
35.3062 +.ll \n(34u*1u/3u
35.3063 +.if \n(.l<\n(81 .ll \n(81u
35.3064 +.in 0
35.3065 + Survivor 泣ゃ (KB)
35.3066 +.br
35.3067 +.di
35.3068 +.nr f| \n(dn
35.3069 +.nr f- \n(dl
35.3070 +..
35.3071 +.ec \
35.3072 +.eo
35.3073 +.am 81
35.3074 +.br
35.3075 +.di g+
35.3076 +.35
35.3077 +.ft \n(.f
35.3078 +.ll \n(34u*1u/3u
35.3079 +.if \n(.l<\n(81 .ll \n(81u
35.3080 +.in 0
35.3081 +Eden 憜絎拷 (KB)
35.3082 +.br
35.3083 +.di
35.3084 +.nr g| \n(dn
35.3085 +.nr g- \n(dl
35.3086 +..
35.3087 +.ec \
35.3088 +.eo
35.3089 +.am 81
35.3090 +.br
35.3091 +.di h+
35.3092 +.35
35.3093 +.ft \n(.f
35.3094 +.ll \n(34u*1u/3u
35.3095 +.if \n(.l<\n(81 .ll \n(81u
35.3096 +.in 0
35.3097 +Eden 篏睡 (KB)
35.3098 +.br
35.3099 +.di
35.3100 +.nr h| \n(dn
35.3101 +.nr h- \n(dl
35.3102 +..
35.3103 +.ec \
35.3104 +.eo
35.3105 +.am 81
35.3106 +.br
35.3107 +.di i+
35.3108 +.35
35.3109 +.ft \n(.f
35.3110 +.ll \n(34u*1u/3u
35.3111 +.if \n(.l<\n(81 .ll \n(81u
35.3112 +.in 0
35.3113 +ャ筝篁c GC ゃ潟
35.3114 +.br
35.3115 +.di
35.3116 +.nr i| \n(dn
35.3117 +.nr i- \n(dl
35.3118 +..
35.3119 +.ec \
35.3120 +.eo
35.3121 +.am 81
35.3122 +.br
35.3123 +.di j+
35.3124 +.35
35.3125 +.ft \n(.f
35.3126 +.ll \n(34u*1u/3u
35.3127 +.if \n(.l<\n(81 .ll \n(81u
35.3128 +.in 0
35.3129 +ャ筝篁c若吾潟激с恰
35.3130 +.br
35.3131 +.di
35.3132 +.nr j| \n(dn
35.3133 +.nr j- \n(dl
35.3134 +..
35.3135 +.ec \
35.3136 +.35
35.3137 +.nf
35.3138 +.ll \n(34u
35.3139 +.nr 80 0
35.3140 +.nr 38 \wNew 筝篁c腟沿若
35.3141 +.if \n(80<\n(38 .nr 80 \n(38
35.3142 +.nr 38 \w\f3\fP
35.3143 +.if \n(80<\n(38 .nr 80 \n(38
35.3144 +.nr 38 \wS0C
35.3145 +.if \n(80<\n(38 .nr 80 \n(38
35.3146 +.nr 38 \wS1C
35.3147 +.if \n(80<\n(38 .nr 80 \n(38
35.3148 +.nr 38 \wS0U
35.3149 +.if \n(80<\n(38 .nr 80 \n(38
35.3150 +.nr 38 \wS1U
35.3151 +.if \n(80<\n(38 .nr 80 \n(38
35.3152 +.nr 38 \wTT
35.3153 +.if \n(80<\n(38 .nr 80 \n(38
35.3154 +.nr 38 \wMTT
35.3155 +.if \n(80<\n(38 .nr 80 \n(38
35.3156 +.nr 38 \wDSS
35.3157 +.if \n(80<\n(38 .nr 80 \n(38
35.3158 +.nr 38 \wEC
35.3159 +.if \n(80<\n(38 .nr 80 \n(38
35.3160 +.nr 38 \wEU
35.3161 +.if \n(80<\n(38 .nr 80 \n(38
35.3162 +.nr 38 \wYGC
35.3163 +.if \n(80<\n(38 .nr 80 \n(38
35.3164 +.nr 38 \wYGCT
35.3165 +.if \n(80<\n(38 .nr 80 \n(38
35.3166 +.80
35.3167 +.rm 80
35.3168 +.nr 81 0
35.3169 +.nr 38 \w\f3茯\fP
35.3170 +.if \n(81<\n(38 .nr 81 \n(38
35.3171 +.nr 38 \w罧水ャ
35.3172 +.if \n(81<\n(38 .nr 81 \n(38
35.3173 +.81
35.3174 +.rm 81
35.3175 +.nr 38 \n(a-
35.3176 +.if \n(81<\n(38 .nr 81 \n(38
35.3177 +.nr 38 \n(b-
35.3178 +.if \n(81<\n(38 .nr 81 \n(38
35.3179 +.nr 38 \n(c-
35.3180 +.if \n(81<\n(38 .nr 81 \n(38
35.3181 +.nr 38 \n(d-
35.3182 +.if \n(81<\n(38 .nr 81 \n(38
35.3183 +.nr 38 \n(e-
35.3184 +.if \n(81<\n(38 .nr 81 \n(38
35.3185 +.nr 38 \n(f-
35.3186 +.if \n(81<\n(38 .nr 81 \n(38
35.3187 +.nr 38 \n(g-
35.3188 +.if \n(81<\n(38 .nr 81 \n(38
35.3189 +.nr 38 \n(h-
35.3190 +.if \n(81<\n(38 .nr 81 \n(38
35.3191 +.nr 38 \n(i-
35.3192 +.if \n(81<\n(38 .nr 81 \n(38
35.3193 +.nr 38 \n(j-
35.3194 +.if \n(81<\n(38 .nr 81 \n(38
35.3195 +.35
35.3196 +.nf
35.3197 +.ll \n(34u
35.3198 +.nr 38 1n
35.3199 +.nr 79 0
35.3200 +.nr 40 \n(79+(0*\n(38)
35.3201 +.nr 80 +\n(40
35.3202 +.nr 41 \n(80+(3*\n(38)
35.3203 +.nr 81 +\n(41
35.3204 +.nr TW \n(81
35.3205 +.if t .if \n(TW>\n(.li .tm Table at line 571 file Input is too wide - \n(TW units
35.3206 +.fc
35.3207 +.nr #T 0-1
35.3208 +.nr #a 0-1
35.3209 +.eo
35.3210 +.de T#
35.3211 +.ds #d .d
35.3212 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.3213 +.mk ##
35.3214 +.nr ## -1v
35.3215 +.ls 1
35.3216 +.ls
35.3217 +..
35.3218 +.ec
35.3219 +.ta \n(80u \n(81u
35.3220 +.nr 31 \n(.f
35.3221 +.nr 35 1m
35.3222 +\&\h'|\n(40u'New 筝篁c腟沿若\h'|\n(41u'
35.3223 +.ta \n(80u \n(81u
35.3224 +.nr 31 \n(.f
35.3225 +.nr 35 1m
35.3226 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.3227 +.ne \n(a|u+\n(.Vu
35.3228 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.3229 +.ta \n(80u \n(81u
35.3230 +.nr 31 \n(.f
35.3231 +.nr 35 1m
35.3232 +\&\h'|\n(40u'S0C\h'|\n(41u'
35.3233 +.mk ##
35.3234 +.nr 31 \n(##
35.3235 +.sp |\n(##u-1v
35.3236 +.nr 37 \n(41u
35.3237 +.in +\n(37u
35.3238 +.a+
35.3239 +.in -\n(37u
35.3240 +.mk 32
35.3241 +.if \n(32>\n(31 .nr 31 \n(32
35.3242 +.sp |\n(31u
35.3243 +.ne \n(b|u+\n(.Vu
35.3244 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.3245 +.ta \n(80u \n(81u
35.3246 +.nr 31 \n(.f
35.3247 +.nr 35 1m
35.3248 +\&\h'|\n(40u'S1C\h'|\n(41u'
35.3249 +.mk ##
35.3250 +.nr 31 \n(##
35.3251 +.sp |\n(##u-1v
35.3252 +.nr 37 \n(41u
35.3253 +.in +\n(37u
35.3254 +.b+
35.3255 +.in -\n(37u
35.3256 +.mk 32
35.3257 +.if \n(32>\n(31 .nr 31 \n(32
35.3258 +.sp |\n(31u
35.3259 +.ne \n(c|u+\n(.Vu
35.3260 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.3261 +.ta \n(80u \n(81u
35.3262 +.nr 31 \n(.f
35.3263 +.nr 35 1m
35.3264 +\&\h'|\n(40u'S0U\h'|\n(41u'
35.3265 +.mk ##
35.3266 +.nr 31 \n(##
35.3267 +.sp |\n(##u-1v
35.3268 +.nr 37 \n(41u
35.3269 +.in +\n(37u
35.3270 +.c+
35.3271 +.in -\n(37u
35.3272 +.mk 32
35.3273 +.if \n(32>\n(31 .nr 31 \n(32
35.3274 +.sp |\n(31u
35.3275 +.ne \n(d|u+\n(.Vu
35.3276 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.3277 +.ta \n(80u \n(81u
35.3278 +.nr 31 \n(.f
35.3279 +.nr 35 1m
35.3280 +\&\h'|\n(40u'S1U\h'|\n(41u'
35.3281 +.mk ##
35.3282 +.nr 31 \n(##
35.3283 +.sp |\n(##u-1v
35.3284 +.nr 37 \n(41u
35.3285 +.in +\n(37u
35.3286 +.d+
35.3287 +.in -\n(37u
35.3288 +.mk 32
35.3289 +.if \n(32>\n(31 .nr 31 \n(32
35.3290 +.sp |\n(31u
35.3291 +.ta \n(80u \n(81u
35.3292 +.nr 31 \n(.f
35.3293 +.nr 35 1m
35.3294 +\&\h'|\n(40u'TT\h'|\n(41u'罧水ャ
35.3295 +.ne \n(e|u+\n(.Vu
35.3296 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.3297 +.ta \n(80u \n(81u
35.3298 +.nr 31 \n(.f
35.3299 +.nr 35 1m
35.3300 +\&\h'|\n(40u'MTT\h'|\n(41u'
35.3301 +.mk ##
35.3302 +.nr 31 \n(##
35.3303 +.sp |\n(##u-1v
35.3304 +.nr 37 \n(41u
35.3305 +.in +\n(37u
35.3306 +.e+
35.3307 +.in -\n(37u
35.3308 +.mk 32
35.3309 +.if \n(32>\n(31 .nr 31 \n(32
35.3310 +.sp |\n(31u
35.3311 +.ne \n(f|u+\n(.Vu
35.3312 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.3313 +.ta \n(80u \n(81u
35.3314 +.nr 31 \n(.f
35.3315 +.nr 35 1m
35.3316 +\&\h'|\n(40u'DSS\h'|\n(41u'
35.3317 +.mk ##
35.3318 +.nr 31 \n(##
35.3319 +.sp |\n(##u-1v
35.3320 +.nr 37 \n(41u
35.3321 +.in +\n(37u
35.3322 +.f+
35.3323 +.in -\n(37u
35.3324 +.mk 32
35.3325 +.if \n(32>\n(31 .nr 31 \n(32
35.3326 +.sp |\n(31u
35.3327 +.ne \n(g|u+\n(.Vu
35.3328 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.3329 +.ta \n(80u \n(81u
35.3330 +.nr 31 \n(.f
35.3331 +.nr 35 1m
35.3332 +\&\h'|\n(40u'EC\h'|\n(41u'
35.3333 +.mk ##
35.3334 +.nr 31 \n(##
35.3335 +.sp |\n(##u-1v
35.3336 +.nr 37 \n(41u
35.3337 +.in +\n(37u
35.3338 +.g+
35.3339 +.in -\n(37u
35.3340 +.mk 32
35.3341 +.if \n(32>\n(31 .nr 31 \n(32
35.3342 +.sp |\n(31u
35.3343 +.ne \n(h|u+\n(.Vu
35.3344 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.3345 +.ta \n(80u \n(81u
35.3346 +.nr 31 \n(.f
35.3347 +.nr 35 1m
35.3348 +\&\h'|\n(40u'EU\h'|\n(41u'
35.3349 +.mk ##
35.3350 +.nr 31 \n(##
35.3351 +.sp |\n(##u-1v
35.3352 +.nr 37 \n(41u
35.3353 +.in +\n(37u
35.3354 +.h+
35.3355 +.in -\n(37u
35.3356 +.mk 32
35.3357 +.if \n(32>\n(31 .nr 31 \n(32
35.3358 +.sp |\n(31u
35.3359 +.ne \n(i|u+\n(.Vu
35.3360 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.3361 +.ta \n(80u \n(81u
35.3362 +.nr 31 \n(.f
35.3363 +.nr 35 1m
35.3364 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.3365 +.mk ##
35.3366 +.nr 31 \n(##
35.3367 +.sp |\n(##u-1v
35.3368 +.nr 37 \n(41u
35.3369 +.in +\n(37u
35.3370 +.i+
35.3371 +.in -\n(37u
35.3372 +.mk 32
35.3373 +.if \n(32>\n(31 .nr 31 \n(32
35.3374 +.sp |\n(31u
35.3375 +.ne \n(j|u+\n(.Vu
35.3376 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
35.3377 +.ta \n(80u \n(81u
35.3378 +.nr 31 \n(.f
35.3379 +.nr 35 1m
35.3380 +\&\h'|\n(40u'YGCT\h'|\n(41u'
35.3381 +.mk ##
35.3382 +.nr 31 \n(##
35.3383 +.sp |\n(##u-1v
35.3384 +.nr 37 \n(41u
35.3385 +.in +\n(37u
35.3386 +.j+
35.3387 +.in -\n(37u
35.3388 +.mk 32
35.3389 +.if \n(32>\n(31 .nr 31 \n(32
35.3390 +.sp |\n(31u
35.3391 +.fc
35.3392 +.nr T. 1
35.3393 +.T# 1
35.3394 +.35
35.3395 +.rm a+
35.3396 +.rm b+
35.3397 +.rm c+
35.3398 +.rm d+
35.3399 +.rm e+
35.3400 +.rm f+
35.3401 +.rm g+
35.3402 +.rm h+
35.3403 +.rm i+
35.3404 +.rm j+
35.3405 +.TE
35.3406 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
35.3407 +
35.3408 +.LP
35.3409 +.SS
35.3410 +\-gcnewcapacity 激с
35.3411 +.LP
35.3412 +.LP
35.3413 +.TS
35.3414 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.3415 +.de 35
35.3416 +.ps \n(.s
35.3417 +.vs \n(.vu
35.3418 +.in \n(.iu
35.3419 +.if \n(.u .fi
35.3420 +.if \n(.j .ad
35.3421 +.if \n(.j=0 .na
35.3422 +..
35.3423 +.nf
35.3424 +.nr #~ 0
35.3425 +.if n .nr #~ 0.6n
35.3426 +.ds #d .d
35.3427 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.3428 +.fc
35.3429 +.nr 33 \n(.s
35.3430 +.rm 80 81
35.3431 +.nr 34 \n(.lu
35.3432 +.eo
35.3433 +.am 80
35.3434 +.br
35.3435 +.di a+
35.3436 +.35
35.3437 +.ft \n(.f
35.3438 +.ll \n(34u*1u/3u
35.3439 +.if \n(.l<\n(80 .ll \n(80u
35.3440 +.in 0
35.3441 +NGCMN\ \ \ \ \ \ \ \ \ T}~T{
35.3442 +New 筝篁c絨鎘拷 (KB)
35.3443 +.br
35.3444 +.di
35.3445 +.nr a| \n(dn
35.3446 +.nr a- \n(dl
35.3447 +..
35.3448 +.ec \
35.3449 +.eo
35.3450 +.am 81
35.3451 +.br
35.3452 +.di b+
35.3453 +.35
35.3454 +.ft \n(.f
35.3455 +.ll \n(34u*1u/3u
35.3456 +.if \n(.l<\n(81 .ll \n(81u
35.3457 +.in 0
35.3458 +New 筝篁c紊у拷 (KB)
35.3459 +.br
35.3460 +.di
35.3461 +.nr b| \n(dn
35.3462 +.nr b- \n(dl
35.3463 +..
35.3464 +.ec \
35.3465 +.eo
35.3466 +.am 81
35.3467 +.br
35.3468 +.di c+
35.3469 +.35
35.3470 +.ft \n(.f
35.3471 +.ll \n(34u*1u/3u
35.3472 +.if \n(.l<\n(81 .ll \n(81u
35.3473 +.in 0
35.3474 +New 筝篁c憜絎拷 (KB)
35.3475 +.br
35.3476 +.di
35.3477 +.nr c| \n(dn
35.3478 +.nr c- \n(dl
35.3479 +..
35.3480 +.ec \
35.3481 +.eo
35.3482 +.am 81
35.3483 +.br
35.3484 +.di d+
35.3485 +.35
35.3486 +.ft \n(.f
35.3487 +.ll \n(34u*1u/3u
35.3488 +.if \n(.l<\n(81 .ll \n(81u
35.3489 +.in 0
35.3490 +Survivor 0 紊у拷 (KB)
35.3491 +.br
35.3492 +.di
35.3493 +.nr d| \n(dn
35.3494 +.nr d- \n(dl
35.3495 +..
35.3496 +.ec \
35.3497 +.eo
35.3498 +.am 81
35.3499 +.br
35.3500 +.di e+
35.3501 +.35
35.3502 +.ft \n(.f
35.3503 +.ll \n(34u*1u/3u
35.3504 +.if \n(.l<\n(81 .ll \n(81u
35.3505 +.in 0
35.3506 +Survivor 0 憜絎拷 (KB)
35.3507 +.br
35.3508 +.di
35.3509 +.nr e| \n(dn
35.3510 +.nr e- \n(dl
35.3511 +..
35.3512 +.ec \
35.3513 +.eo
35.3514 +.am 81
35.3515 +.br
35.3516 +.di f+
35.3517 +.35
35.3518 +.ft \n(.f
35.3519 +.ll \n(34u*1u/3u
35.3520 +.if \n(.l<\n(81 .ll \n(81u
35.3521 +.in 0
35.3522 +Survivor 1 紊у拷 (KB)
35.3523 +.br
35.3524 +.di
35.3525 +.nr f| \n(dn
35.3526 +.nr f- \n(dl
35.3527 +..
35.3528 +.ec \
35.3529 +.eo
35.3530 +.am 81
35.3531 +.br
35.3532 +.di g+
35.3533 +.35
35.3534 +.ft \n(.f
35.3535 +.ll \n(34u*1u/3u
35.3536 +.if \n(.l<\n(81 .ll \n(81u
35.3537 +.in 0
35.3538 +Survivor 1 憜絎拷 (KB)
35.3539 +.br
35.3540 +.di
35.3541 +.nr g| \n(dn
35.3542 +.nr g- \n(dl
35.3543 +..
35.3544 +.ec \
35.3545 +.eo
35.3546 +.am 81
35.3547 +.br
35.3548 +.di h+
35.3549 +.35
35.3550 +.ft \n(.f
35.3551 +.ll \n(34u*1u/3u
35.3552 +.if \n(.l<\n(81 .ll \n(81u
35.3553 +.in 0
35.3554 +Eden 紊у拷 (KB)
35.3555 +.br
35.3556 +.di
35.3557 +.nr h| \n(dn
35.3558 +.nr h- \n(dl
35.3559 +..
35.3560 +.ec \
35.3561 +.eo
35.3562 +.am 81
35.3563 +.br
35.3564 +.di i+
35.3565 +.35
35.3566 +.ft \n(.f
35.3567 +.ll \n(34u*1u/3u
35.3568 +.if \n(.l<\n(81 .ll \n(81u
35.3569 +.in 0
35.3570 +Eden 憜絎拷 (KB)
35.3571 +.br
35.3572 +.di
35.3573 +.nr i| \n(dn
35.3574 +.nr i- \n(dl
35.3575 +..
35.3576 +.ec \
35.3577 +.eo
35.3578 +.am 81
35.3579 +.br
35.3580 +.di j+
35.3581 +.35
35.3582 +.ft \n(.f
35.3583 +.ll \n(34u*1u/3u
35.3584 +.if \n(.l<\n(81 .ll \n(81u
35.3585 +.in 0
35.3586 +ャ筝篁c GC ゃ潟
35.3587 +.br
35.3588 +.di
35.3589 +.nr j| \n(dn
35.3590 +.nr j- \n(dl
35.3591 +..
35.3592 +.ec \
35.3593 +.35
35.3594 +.nf
35.3595 +.ll \n(34u
35.3596 +.nr 80 0
35.3597 +.nr 38 \wNew 筝篁i泣ゃ冴腟沿若
35.3598 +.if \n(80<\n(38 .nr 80 \n(38
35.3599 +.nr 38 \w\f3\fP
35.3600 +.if \n(80<\n(38 .nr 80 \n(38
35.3601 +.nr 38 \wNGCMX \ \ \
35.3602 +.if \n(80<\n(38 .nr 80 \n(38
35.3603 +.nr 38 \wNGC \ \ \
35.3604 +.if \n(80<\n(38 .nr 80 \n(38
35.3605 +.nr 38 \wS0CMX
35.3606 +.if \n(80<\n(38 .nr 80 \n(38
35.3607 +.nr 38 \wS0C
35.3608 +.if \n(80<\n(38 .nr 80 \n(38
35.3609 +.nr 38 \wS1CMX
35.3610 +.if \n(80<\n(38 .nr 80 \n(38
35.3611 +.nr 38 \wS1C
35.3612 +.if \n(80<\n(38 .nr 80 \n(38
35.3613 +.nr 38 \wECMX
35.3614 +.if \n(80<\n(38 .nr 80 \n(38
35.3615 +.nr 38 \wEC
35.3616 +.if \n(80<\n(38 .nr 80 \n(38
35.3617 +.nr 38 \wYGC
35.3618 +.if \n(80<\n(38 .nr 80 \n(38
35.3619 +.nr 38 \wFGC
35.3620 +.if \n(80<\n(38 .nr 80 \n(38
35.3621 +.80
35.3622 +.rm 80
35.3623 +.nr 38 \n(a-
35.3624 +.if \n(80<\n(38 .nr 80 \n(38
35.3625 +.nr 81 0
35.3626 +.nr 38 \w\f3茯\fP
35.3627 +.if \n(81<\n(38 .nr 81 \n(38
35.3628 +.nr 38 \w GC ゃ潟
35.3629 +.if \n(81<\n(38 .nr 81 \n(38
35.3630 +.81
35.3631 +.rm 81
35.3632 +.nr 38 \n(b-
35.3633 +.if \n(81<\n(38 .nr 81 \n(38
35.3634 +.nr 38 \n(c-
35.3635 +.if \n(81<\n(38 .nr 81 \n(38
35.3636 +.nr 38 \n(d-
35.3637 +.if \n(81<\n(38 .nr 81 \n(38
35.3638 +.nr 38 \n(e-
35.3639 +.if \n(81<\n(38 .nr 81 \n(38
35.3640 +.nr 38 \n(f-
35.3641 +.if \n(81<\n(38 .nr 81 \n(38
35.3642 +.nr 38 \n(g-
35.3643 +.if \n(81<\n(38 .nr 81 \n(38
35.3644 +.nr 38 \n(h-
35.3645 +.if \n(81<\n(38 .nr 81 \n(38
35.3646 +.nr 38 \n(i-
35.3647 +.if \n(81<\n(38 .nr 81 \n(38
35.3648 +.nr 38 \n(j-
35.3649 +.if \n(81<\n(38 .nr 81 \n(38
35.3650 +.35
35.3651 +.nf
35.3652 +.ll \n(34u
35.3653 +.nr 38 1n
35.3654 +.nr 79 0
35.3655 +.nr 40 \n(79+(0*\n(38)
35.3656 +.nr 80 +\n(40
35.3657 +.nr 41 \n(80+(3*\n(38)
35.3658 +.nr 81 +\n(41
35.3659 +.nr TW \n(81
35.3660 +.if t .if \n(TW>\n(.li .tm Table at line 627 file Input is too wide - \n(TW units
35.3661 +.fc
35.3662 +.nr #T 0-1
35.3663 +.nr #a 0-1
35.3664 +.eo
35.3665 +.de T#
35.3666 +.ds #d .d
35.3667 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.3668 +.mk ##
35.3669 +.nr ## -1v
35.3670 +.ls 1
35.3671 +.ls
35.3672 +..
35.3673 +.ec
35.3674 +.ta \n(80u \n(81u
35.3675 +.nr 31 \n(.f
35.3676 +.nr 35 1m
35.3677 +\&\h'|\n(40u'New 筝篁i泣ゃ冴腟沿若\h'|\n(41u'
35.3678 +.ta \n(80u \n(81u
35.3679 +.nr 31 \n(.f
35.3680 +.nr 35 1m
35.3681 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.3682 +.ne \n(a|u+\n(.Vu
35.3683 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.3684 +.ta \n(80u \n(81u
35.3685 +.nr 31 \n(.f
35.3686 +.nr 35 1m
35.3687 +\&\h'|\n(40u'\h'|\n(41u'
35.3688 +.mk ##
35.3689 +.nr 31 \n(##
35.3690 +.sp |\n(##u-1v
35.3691 +.nr 37 \n(40u
35.3692 +.in +\n(37u
35.3693 +.a+
35.3694 +.in -\n(37u
35.3695 +.mk 32
35.3696 +.if \n(32>\n(31 .nr 31 \n(32
35.3697 +.sp |\n(31u
35.3698 +.ne \n(b|u+\n(.Vu
35.3699 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.3700 +.ta \n(80u \n(81u
35.3701 +.nr 31 \n(.f
35.3702 +.nr 35 1m
35.3703 +\&\h'|\n(40u'NGCMX \ \ \\h'|\n(41u'
35.3704 +.mk ##
35.3705 +.nr 31 \n(##
35.3706 +.sp |\n(##u-1v
35.3707 +.nr 37 \n(41u
35.3708 +.in +\n(37u
35.3709 +.b+
35.3710 +.in -\n(37u
35.3711 +.mk 32
35.3712 +.if \n(32>\n(31 .nr 31 \n(32
35.3713 +.sp |\n(31u
35.3714 +.ne \n(c|u+\n(.Vu
35.3715 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.3716 +.ta \n(80u \n(81u
35.3717 +.nr 31 \n(.f
35.3718 +.nr 35 1m
35.3719 +\&\h'|\n(40u'NGC \ \ \\h'|\n(41u'
35.3720 +.mk ##
35.3721 +.nr 31 \n(##
35.3722 +.sp |\n(##u-1v
35.3723 +.nr 37 \n(41u
35.3724 +.in +\n(37u
35.3725 +.c+
35.3726 +.in -\n(37u
35.3727 +.mk 32
35.3728 +.if \n(32>\n(31 .nr 31 \n(32
35.3729 +.sp |\n(31u
35.3730 +.ne \n(d|u+\n(.Vu
35.3731 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.3732 +.ta \n(80u \n(81u
35.3733 +.nr 31 \n(.f
35.3734 +.nr 35 1m
35.3735 +\&\h'|\n(40u'S0CMX\h'|\n(41u'
35.3736 +.mk ##
35.3737 +.nr 31 \n(##
35.3738 +.sp |\n(##u-1v
35.3739 +.nr 37 \n(41u
35.3740 +.in +\n(37u
35.3741 +.d+
35.3742 +.in -\n(37u
35.3743 +.mk 32
35.3744 +.if \n(32>\n(31 .nr 31 \n(32
35.3745 +.sp |\n(31u
35.3746 +.ne \n(e|u+\n(.Vu
35.3747 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.3748 +.ta \n(80u \n(81u
35.3749 +.nr 31 \n(.f
35.3750 +.nr 35 1m
35.3751 +\&\h'|\n(40u'S0C\h'|\n(41u'
35.3752 +.mk ##
35.3753 +.nr 31 \n(##
35.3754 +.sp |\n(##u-1v
35.3755 +.nr 37 \n(41u
35.3756 +.in +\n(37u
35.3757 +.e+
35.3758 +.in -\n(37u
35.3759 +.mk 32
35.3760 +.if \n(32>\n(31 .nr 31 \n(32
35.3761 +.sp |\n(31u
35.3762 +.ne \n(f|u+\n(.Vu
35.3763 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.3764 +.ta \n(80u \n(81u
35.3765 +.nr 31 \n(.f
35.3766 +.nr 35 1m
35.3767 +\&\h'|\n(40u'S1CMX\h'|\n(41u'
35.3768 +.mk ##
35.3769 +.nr 31 \n(##
35.3770 +.sp |\n(##u-1v
35.3771 +.nr 37 \n(41u
35.3772 +.in +\n(37u
35.3773 +.f+
35.3774 +.in -\n(37u
35.3775 +.mk 32
35.3776 +.if \n(32>\n(31 .nr 31 \n(32
35.3777 +.sp |\n(31u
35.3778 +.ne \n(g|u+\n(.Vu
35.3779 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.3780 +.ta \n(80u \n(81u
35.3781 +.nr 31 \n(.f
35.3782 +.nr 35 1m
35.3783 +\&\h'|\n(40u'S1C\h'|\n(41u'
35.3784 +.mk ##
35.3785 +.nr 31 \n(##
35.3786 +.sp |\n(##u-1v
35.3787 +.nr 37 \n(41u
35.3788 +.in +\n(37u
35.3789 +.g+
35.3790 +.in -\n(37u
35.3791 +.mk 32
35.3792 +.if \n(32>\n(31 .nr 31 \n(32
35.3793 +.sp |\n(31u
35.3794 +.ne \n(h|u+\n(.Vu
35.3795 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.3796 +.ta \n(80u \n(81u
35.3797 +.nr 31 \n(.f
35.3798 +.nr 35 1m
35.3799 +\&\h'|\n(40u'ECMX\h'|\n(41u'
35.3800 +.mk ##
35.3801 +.nr 31 \n(##
35.3802 +.sp |\n(##u-1v
35.3803 +.nr 37 \n(41u
35.3804 +.in +\n(37u
35.3805 +.h+
35.3806 +.in -\n(37u
35.3807 +.mk 32
35.3808 +.if \n(32>\n(31 .nr 31 \n(32
35.3809 +.sp |\n(31u
35.3810 +.ne \n(i|u+\n(.Vu
35.3811 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.3812 +.ta \n(80u \n(81u
35.3813 +.nr 31 \n(.f
35.3814 +.nr 35 1m
35.3815 +\&\h'|\n(40u'EC\h'|\n(41u'
35.3816 +.mk ##
35.3817 +.nr 31 \n(##
35.3818 +.sp |\n(##u-1v
35.3819 +.nr 37 \n(41u
35.3820 +.in +\n(37u
35.3821 +.i+
35.3822 +.in -\n(37u
35.3823 +.mk 32
35.3824 +.if \n(32>\n(31 .nr 31 \n(32
35.3825 +.sp |\n(31u
35.3826 +.ne \n(j|u+\n(.Vu
35.3827 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
35.3828 +.ta \n(80u \n(81u
35.3829 +.nr 31 \n(.f
35.3830 +.nr 35 1m
35.3831 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.3832 +.mk ##
35.3833 +.nr 31 \n(##
35.3834 +.sp |\n(##u-1v
35.3835 +.nr 37 \n(41u
35.3836 +.in +\n(37u
35.3837 +.j+
35.3838 +.in -\n(37u
35.3839 +.mk 32
35.3840 +.if \n(32>\n(31 .nr 31 \n(32
35.3841 +.sp |\n(31u
35.3842 +.ta \n(80u \n(81u
35.3843 +.nr 31 \n(.f
35.3844 +.nr 35 1m
35.3845 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.3846 +.fc
35.3847 +.nr T. 1
35.3848 +.T# 1
35.3849 +.35
35.3850 +.rm a+
35.3851 +.rm b+
35.3852 +.rm c+
35.3853 +.rm d+
35.3854 +.rm e+
35.3855 +.rm f+
35.3856 +.rm g+
35.3857 +.rm h+
35.3858 +.rm i+
35.3859 +.rm j+
35.3860 +.TE
35.3861 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
35.3862 +
35.3863 +.LP
35.3864 +.SS
35.3865 +\-gcold 激с
35.3866 +.LP
35.3867 +.LP
35.3868 +.TS
35.3869 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.3870 +.de 35
35.3871 +.ps \n(.s
35.3872 +.vs \n(.vu
35.3873 +.in \n(.iu
35.3874 +.if \n(.u .fi
35.3875 +.if \n(.j .ad
35.3876 +.if \n(.j=0 .na
35.3877 +..
35.3878 +.nf
35.3879 +.nr #~ 0
35.3880 +.if n .nr #~ 0.6n
35.3881 +.ds #d .d
35.3882 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.3883 +.fc
35.3884 +.nr 33 \n(.s
35.3885 +.rm 80 81
35.3886 +.nr 34 \n(.lu
35.3887 +.eo
35.3888 +.am 81
35.3889 +.br
35.3890 +.di a+
35.3891 +.35
35.3892 +.ft \n(.f
35.3893 +.ll \n(34u*1u/3u
35.3894 +.if \n(.l<\n(81 .ll \n(81u
35.3895 +.in 0
35.3896 +Permanent 憜絎拷 (KB)
35.3897 +.br
35.3898 +.di
35.3899 +.nr a| \n(dn
35.3900 +.nr a- \n(dl
35.3901 +..
35.3902 +.ec \
35.3903 +.eo
35.3904 +.am 81
35.3905 +.br
35.3906 +.di b+
35.3907 +.35
35.3908 +.ft \n(.f
35.3909 +.ll \n(34u*1u/3u
35.3910 +.if \n(.l<\n(81 .ll \n(81u
35.3911 +.in 0
35.3912 +Permanent 篏睡 (KB)
35.3913 +.br
35.3914 +.di
35.3915 +.nr b| \n(dn
35.3916 +.nr b- \n(dl
35.3917 +..
35.3918 +.ec \
35.3919 +.eo
35.3920 +.am 81
35.3921 +.br
35.3922 +.di c+
35.3923 +.35
35.3924 +.ft \n(.f
35.3925 +.ll \n(34u*1u/3u
35.3926 +.if \n(.l<\n(81 .ll \n(81u
35.3927 +.in 0
35.3928 +Old 憜絎拷 (KB)
35.3929 +.br
35.3930 +.di
35.3931 +.nr c| \n(dn
35.3932 +.nr c- \n(dl
35.3933 +..
35.3934 +.ec \
35.3935 +.eo
35.3936 +.am 81
35.3937 +.br
35.3938 +.di d+
35.3939 +.35
35.3940 +.ft \n(.f
35.3941 +.ll \n(34u*1u/3u
35.3942 +.if \n(.l<\n(81 .ll \n(81u
35.3943 +.in 0
35.3944 +Old 篏睡 (KB)
35.3945 +.br
35.3946 +.di
35.3947 +.nr d| \n(dn
35.3948 +.nr d- \n(dl
35.3949 +..
35.3950 +.ec \
35.3951 +.eo
35.3952 +.am 81
35.3953 +.br
35.3954 +.di e+
35.3955 +.35
35.3956 +.ft \n(.f
35.3957 +.ll \n(34u*1u/3u
35.3958 +.if \n(.l<\n(81 .ll \n(81u
35.3959 +.in 0
35.3960 +ャ筝篁c GC ゃ潟
35.3961 +.br
35.3962 +.di
35.3963 +.nr e| \n(dn
35.3964 +.nr e- \n(dl
35.3965 +..
35.3966 +.ec \
35.3967 +.eo
35.3968 +.am 81
35.3969 +.br
35.3970 +.di f+
35.3971 +.35
35.3972 +.ft \n(.f
35.3973 +.ll \n(34u*1u/3u
35.3974 +.if \n(.l<\n(81 .ll \n(81u
35.3975 +.in 0
35.3976 +若吾潟激с恰
35.3977 +.br
35.3978 +.di
35.3979 +.nr f| \n(dn
35.3980 +.nr f- \n(dl
35.3981 +..
35.3982 +.ec \
35.3983 +.eo
35.3984 +.am 81
35.3985 +.br
35.3986 +.di g+
35.3987 +.35
35.3988 +.ft \n(.f
35.3989 +.ll \n(34u*1u/3u
35.3990 +.if \n(.l<\n(81 .ll \n(81u
35.3991 +.in 0
35.3992 +若吾潟激с括
35.3993 +.br
35.3994 +.di
35.3995 +.nr g| \n(dn
35.3996 +.nr g- \n(dl
35.3997 +..
35.3998 +.ec \
35.3999 +.35
35.4000 +.nf
35.4001 +.ll \n(34u
35.4002 +.nr 80 0
35.4003 +.nr 38 \wOld Permanent 筝篁c腟沿若
35.4004 +.if \n(80<\n(38 .nr 80 \n(38
35.4005 +.nr 38 \w\f3\fP
35.4006 +.if \n(80<\n(38 .nr 80 \n(38
35.4007 +.nr 38 \wPC
35.4008 +.if \n(80<\n(38 .nr 80 \n(38
35.4009 +.nr 38 \wPU
35.4010 +.if \n(80<\n(38 .nr 80 \n(38
35.4011 +.nr 38 \wOC
35.4012 +.if \n(80<\n(38 .nr 80 \n(38
35.4013 +.nr 38 \wOU
35.4014 +.if \n(80<\n(38 .nr 80 \n(38
35.4015 +.nr 38 \wYGC
35.4016 +.if \n(80<\n(38 .nr 80 \n(38
35.4017 +.nr 38 \wFGC
35.4018 +.if \n(80<\n(38 .nr 80 \n(38
35.4019 +.nr 38 \wFGCT
35.4020 +.if \n(80<\n(38 .nr 80 \n(38
35.4021 +.nr 38 \wGCT
35.4022 +.if \n(80<\n(38 .nr 80 \n(38
35.4023 +.80
35.4024 +.rm 80
35.4025 +.nr 81 0
35.4026 +.nr 38 \w\f3茯\fP
35.4027 +.if \n(81<\n(38 .nr 81 \n(38
35.4028 +.nr 38 \w GC ゃ潟
35.4029 +.if \n(81<\n(38 .nr 81 \n(38
35.4030 +.81
35.4031 +.rm 81
35.4032 +.nr 38 \n(a-
35.4033 +.if \n(81<\n(38 .nr 81 \n(38
35.4034 +.nr 38 \n(b-
35.4035 +.if \n(81<\n(38 .nr 81 \n(38
35.4036 +.nr 38 \n(c-
35.4037 +.if \n(81<\n(38 .nr 81 \n(38
35.4038 +.nr 38 \n(d-
35.4039 +.if \n(81<\n(38 .nr 81 \n(38
35.4040 +.nr 38 \n(e-
35.4041 +.if \n(81<\n(38 .nr 81 \n(38
35.4042 +.nr 38 \n(f-
35.4043 +.if \n(81<\n(38 .nr 81 \n(38
35.4044 +.nr 38 \n(g-
35.4045 +.if \n(81<\n(38 .nr 81 \n(38
35.4046 +.35
35.4047 +.nf
35.4048 +.ll \n(34u
35.4049 +.nr 38 1n
35.4050 +.nr 79 0
35.4051 +.nr 40 \n(79+(0*\n(38)
35.4052 +.nr 80 +\n(40
35.4053 +.nr 41 \n(80+(3*\n(38)
35.4054 +.nr 81 +\n(41
35.4055 +.nr TW \n(81
35.4056 +.if t .if \n(TW>\n(.li .tm Table at line 669 file Input is too wide - \n(TW units
35.4057 +.fc
35.4058 +.nr #T 0-1
35.4059 +.nr #a 0-1
35.4060 +.eo
35.4061 +.de T#
35.4062 +.ds #d .d
35.4063 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4064 +.mk ##
35.4065 +.nr ## -1v
35.4066 +.ls 1
35.4067 +.ls
35.4068 +..
35.4069 +.ec
35.4070 +.ta \n(80u \n(81u
35.4071 +.nr 31 \n(.f
35.4072 +.nr 35 1m
35.4073 +\&\h'|\n(40u'Old Permanent 筝篁c腟沿若\h'|\n(41u'
35.4074 +.ta \n(80u \n(81u
35.4075 +.nr 31 \n(.f
35.4076 +.nr 35 1m
35.4077 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.4078 +.ne \n(a|u+\n(.Vu
35.4079 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.4080 +.ta \n(80u \n(81u
35.4081 +.nr 31 \n(.f
35.4082 +.nr 35 1m
35.4083 +\&\h'|\n(40u'PC\h'|\n(41u'
35.4084 +.mk ##
35.4085 +.nr 31 \n(##
35.4086 +.sp |\n(##u-1v
35.4087 +.nr 37 \n(41u
35.4088 +.in +\n(37u
35.4089 +.a+
35.4090 +.in -\n(37u
35.4091 +.mk 32
35.4092 +.if \n(32>\n(31 .nr 31 \n(32
35.4093 +.sp |\n(31u
35.4094 +.ne \n(b|u+\n(.Vu
35.4095 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.4096 +.ta \n(80u \n(81u
35.4097 +.nr 31 \n(.f
35.4098 +.nr 35 1m
35.4099 +\&\h'|\n(40u'PU\h'|\n(41u'
35.4100 +.mk ##
35.4101 +.nr 31 \n(##
35.4102 +.sp |\n(##u-1v
35.4103 +.nr 37 \n(41u
35.4104 +.in +\n(37u
35.4105 +.b+
35.4106 +.in -\n(37u
35.4107 +.mk 32
35.4108 +.if \n(32>\n(31 .nr 31 \n(32
35.4109 +.sp |\n(31u
35.4110 +.ne \n(c|u+\n(.Vu
35.4111 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.4112 +.ta \n(80u \n(81u
35.4113 +.nr 31 \n(.f
35.4114 +.nr 35 1m
35.4115 +\&\h'|\n(40u'OC\h'|\n(41u'
35.4116 +.mk ##
35.4117 +.nr 31 \n(##
35.4118 +.sp |\n(##u-1v
35.4119 +.nr 37 \n(41u
35.4120 +.in +\n(37u
35.4121 +.c+
35.4122 +.in -\n(37u
35.4123 +.mk 32
35.4124 +.if \n(32>\n(31 .nr 31 \n(32
35.4125 +.sp |\n(31u
35.4126 +.ne \n(d|u+\n(.Vu
35.4127 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.4128 +.ta \n(80u \n(81u
35.4129 +.nr 31 \n(.f
35.4130 +.nr 35 1m
35.4131 +\&\h'|\n(40u'OU\h'|\n(41u'
35.4132 +.mk ##
35.4133 +.nr 31 \n(##
35.4134 +.sp |\n(##u-1v
35.4135 +.nr 37 \n(41u
35.4136 +.in +\n(37u
35.4137 +.d+
35.4138 +.in -\n(37u
35.4139 +.mk 32
35.4140 +.if \n(32>\n(31 .nr 31 \n(32
35.4141 +.sp |\n(31u
35.4142 +.ne \n(e|u+\n(.Vu
35.4143 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.4144 +.ta \n(80u \n(81u
35.4145 +.nr 31 \n(.f
35.4146 +.nr 35 1m
35.4147 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.4148 +.mk ##
35.4149 +.nr 31 \n(##
35.4150 +.sp |\n(##u-1v
35.4151 +.nr 37 \n(41u
35.4152 +.in +\n(37u
35.4153 +.e+
35.4154 +.in -\n(37u
35.4155 +.mk 32
35.4156 +.if \n(32>\n(31 .nr 31 \n(32
35.4157 +.sp |\n(31u
35.4158 +.ta \n(80u \n(81u
35.4159 +.nr 31 \n(.f
35.4160 +.nr 35 1m
35.4161 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.4162 +.ne \n(f|u+\n(.Vu
35.4163 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.4164 +.ta \n(80u \n(81u
35.4165 +.nr 31 \n(.f
35.4166 +.nr 35 1m
35.4167 +\&\h'|\n(40u'FGCT\h'|\n(41u'
35.4168 +.mk ##
35.4169 +.nr 31 \n(##
35.4170 +.sp |\n(##u-1v
35.4171 +.nr 37 \n(41u
35.4172 +.in +\n(37u
35.4173 +.f+
35.4174 +.in -\n(37u
35.4175 +.mk 32
35.4176 +.if \n(32>\n(31 .nr 31 \n(32
35.4177 +.sp |\n(31u
35.4178 +.ne \n(g|u+\n(.Vu
35.4179 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.4180 +.ta \n(80u \n(81u
35.4181 +.nr 31 \n(.f
35.4182 +.nr 35 1m
35.4183 +\&\h'|\n(40u'GCT\h'|\n(41u'
35.4184 +.mk ##
35.4185 +.nr 31 \n(##
35.4186 +.sp |\n(##u-1v
35.4187 +.nr 37 \n(41u
35.4188 +.in +\n(37u
35.4189 +.g+
35.4190 +.in -\n(37u
35.4191 +.mk 32
35.4192 +.if \n(32>\n(31 .nr 31 \n(32
35.4193 +.sp |\n(31u
35.4194 +.fc
35.4195 +.nr T. 1
35.4196 +.T# 1
35.4197 +.35
35.4198 +.rm a+
35.4199 +.rm b+
35.4200 +.rm c+
35.4201 +.rm d+
35.4202 +.rm e+
35.4203 +.rm f+
35.4204 +.rm g+
35.4205 +.TE
35.4206 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.4207 +
35.4208 +.LP
35.4209 +.SS
35.4210 +\-gcoldcapacity 激с
35.4211 +.LP
35.4212 +.LP
35.4213 +.TS
35.4214 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.4215 +.de 35
35.4216 +.ps \n(.s
35.4217 +.vs \n(.vu
35.4218 +.in \n(.iu
35.4219 +.if \n(.u .fi
35.4220 +.if \n(.j .ad
35.4221 +.if \n(.j=0 .na
35.4222 +..
35.4223 +.nf
35.4224 +.nr #~ 0
35.4225 +.if n .nr #~ 0.6n
35.4226 +.ds #d .d
35.4227 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4228 +.fc
35.4229 +.nr 33 \n(.s
35.4230 +.rm 80 81
35.4231 +.nr 34 \n(.lu
35.4232 +.eo
35.4233 +.am 81
35.4234 +.br
35.4235 +.di a+
35.4236 +.35
35.4237 +.ft \n(.f
35.4238 +.ll \n(34u*1u/3u
35.4239 +.if \n(.l<\n(81 .ll \n(81u
35.4240 +.in 0
35.4241 +Old 筝篁c絨鎘拷 (KB)
35.4242 +.br
35.4243 +.di
35.4244 +.nr a| \n(dn
35.4245 +.nr a- \n(dl
35.4246 +..
35.4247 +.ec \
35.4248 +.eo
35.4249 +.am 81
35.4250 +.br
35.4251 +.di b+
35.4252 +.35
35.4253 +.ft \n(.f
35.4254 +.ll \n(34u*1u/3u
35.4255 +.if \n(.l<\n(81 .ll \n(81u
35.4256 +.in 0
35.4257 +Old 筝篁c紊у拷 (KB)
35.4258 +.br
35.4259 +.di
35.4260 +.nr b| \n(dn
35.4261 +.nr b- \n(dl
35.4262 +..
35.4263 +.ec \
35.4264 +.eo
35.4265 +.am 81
35.4266 +.br
35.4267 +.di c+
35.4268 +.35
35.4269 +.ft \n(.f
35.4270 +.ll \n(34u*1u/3u
35.4271 +.if \n(.l<\n(81 .ll \n(81u
35.4272 +.in 0
35.4273 +Old 筝篁c憜絎拷 (KB)
35.4274 +.br
35.4275 +.di
35.4276 +.nr c| \n(dn
35.4277 +.nr c- \n(dl
35.4278 +..
35.4279 +.ec \
35.4280 +.eo
35.4281 +.am 81
35.4282 +.br
35.4283 +.di d+
35.4284 +.35
35.4285 +.ft \n(.f
35.4286 +.ll \n(34u*1u/3u
35.4287 +.if \n(.l<\n(81 .ll \n(81u
35.4288 +.in 0
35.4289 +Old 憜絎拷 (KB)
35.4290 +.br
35.4291 +.di
35.4292 +.nr d| \n(dn
35.4293 +.nr d- \n(dl
35.4294 +..
35.4295 +.ec \
35.4296 +.eo
35.4297 +.am 81
35.4298 +.br
35.4299 +.di e+
35.4300 +.35
35.4301 +.ft \n(.f
35.4302 +.ll \n(34u*1u/3u
35.4303 +.if \n(.l<\n(81 .ll \n(81u
35.4304 +.in 0
35.4305 +ャ筝篁c GC ゃ潟
35.4306 +.br
35.4307 +.di
35.4308 +.nr e| \n(dn
35.4309 +.nr e- \n(dl
35.4310 +..
35.4311 +.ec \
35.4312 +.eo
35.4313 +.am 81
35.4314 +.br
35.4315 +.di f+
35.4316 +.35
35.4317 +.ft \n(.f
35.4318 +.ll \n(34u*1u/3u
35.4319 +.if \n(.l<\n(81 .ll \n(81u
35.4320 +.in 0
35.4321 +若吾潟激с恰
35.4322 +.br
35.4323 +.di
35.4324 +.nr f| \n(dn
35.4325 +.nr f- \n(dl
35.4326 +..
35.4327 +.ec \
35.4328 +.eo
35.4329 +.am 81
35.4330 +.br
35.4331 +.di g+
35.4332 +.35
35.4333 +.ft \n(.f
35.4334 +.ll \n(34u*1u/3u
35.4335 +.if \n(.l<\n(81 .ll \n(81u
35.4336 +.in 0
35.4337 +若吾潟激с括
35.4338 +.br
35.4339 +.di
35.4340 +.nr g| \n(dn
35.4341 +.nr g- \n(dl
35.4342 +..
35.4343 +.ec \
35.4344 +.35
35.4345 +.nf
35.4346 +.ll \n(34u
35.4347 +.nr 80 0
35.4348 +.nr 38 \wOld 筝篁c腟沿若
35.4349 +.if \n(80<\n(38 .nr 80 \n(38
35.4350 +.nr 38 \w\f3\fP
35.4351 +.if \n(80<\n(38 .nr 80 \n(38
35.4352 +.nr 38 \wOGCMN
35.4353 +.if \n(80<\n(38 .nr 80 \n(38
35.4354 +.nr 38 \wOGCMX
35.4355 +.if \n(80<\n(38 .nr 80 \n(38
35.4356 +.nr 38 \wOGC
35.4357 +.if \n(80<\n(38 .nr 80 \n(38
35.4358 +.nr 38 \wOC
35.4359 +.if \n(80<\n(38 .nr 80 \n(38
35.4360 +.nr 38 \wYGC
35.4361 +.if \n(80<\n(38 .nr 80 \n(38
35.4362 +.nr 38 \wFGC
35.4363 +.if \n(80<\n(38 .nr 80 \n(38
35.4364 +.nr 38 \wFGCT
35.4365 +.if \n(80<\n(38 .nr 80 \n(38
35.4366 +.nr 38 \wGCT
35.4367 +.if \n(80<\n(38 .nr 80 \n(38
35.4368 +.80
35.4369 +.rm 80
35.4370 +.nr 81 0
35.4371 +.nr 38 \w\f3茯\fP
35.4372 +.if \n(81<\n(38 .nr 81 \n(38
35.4373 +.nr 38 \w GC ゃ潟
35.4374 +.if \n(81<\n(38 .nr 81 \n(38
35.4375 +.81
35.4376 +.rm 81
35.4377 +.nr 38 \n(a-
35.4378 +.if \n(81<\n(38 .nr 81 \n(38
35.4379 +.nr 38 \n(b-
35.4380 +.if \n(81<\n(38 .nr 81 \n(38
35.4381 +.nr 38 \n(c-
35.4382 +.if \n(81<\n(38 .nr 81 \n(38
35.4383 +.nr 38 \n(d-
35.4384 +.if \n(81<\n(38 .nr 81 \n(38
35.4385 +.nr 38 \n(e-
35.4386 +.if \n(81<\n(38 .nr 81 \n(38
35.4387 +.nr 38 \n(f-
35.4388 +.if \n(81<\n(38 .nr 81 \n(38
35.4389 +.nr 38 \n(g-
35.4390 +.if \n(81<\n(38 .nr 81 \n(38
35.4391 +.35
35.4392 +.nf
35.4393 +.ll \n(34u
35.4394 +.nr 38 1n
35.4395 +.nr 79 0
35.4396 +.nr 40 \n(79+(0*\n(38)
35.4397 +.nr 80 +\n(40
35.4398 +.nr 41 \n(80+(3*\n(38)
35.4399 +.nr 81 +\n(41
35.4400 +.nr TW \n(81
35.4401 +.if t .if \n(TW>\n(.li .tm Table at line 711 file Input is too wide - \n(TW units
35.4402 +.fc
35.4403 +.nr #T 0-1
35.4404 +.nr #a 0-1
35.4405 +.eo
35.4406 +.de T#
35.4407 +.ds #d .d
35.4408 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4409 +.mk ##
35.4410 +.nr ## -1v
35.4411 +.ls 1
35.4412 +.ls
35.4413 +..
35.4414 +.ec
35.4415 +.ta \n(80u \n(81u
35.4416 +.nr 31 \n(.f
35.4417 +.nr 35 1m
35.4418 +\&\h'|\n(40u'Old 筝篁c腟沿若\h'|\n(41u'
35.4419 +.ta \n(80u \n(81u
35.4420 +.nr 31 \n(.f
35.4421 +.nr 35 1m
35.4422 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.4423 +.ne \n(a|u+\n(.Vu
35.4424 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.4425 +.ta \n(80u \n(81u
35.4426 +.nr 31 \n(.f
35.4427 +.nr 35 1m
35.4428 +\&\h'|\n(40u'OGCMN\h'|\n(41u'
35.4429 +.mk ##
35.4430 +.nr 31 \n(##
35.4431 +.sp |\n(##u-1v
35.4432 +.nr 37 \n(41u
35.4433 +.in +\n(37u
35.4434 +.a+
35.4435 +.in -\n(37u
35.4436 +.mk 32
35.4437 +.if \n(32>\n(31 .nr 31 \n(32
35.4438 +.sp |\n(31u
35.4439 +.ne \n(b|u+\n(.Vu
35.4440 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.4441 +.ta \n(80u \n(81u
35.4442 +.nr 31 \n(.f
35.4443 +.nr 35 1m
35.4444 +\&\h'|\n(40u'OGCMX\h'|\n(41u'
35.4445 +.mk ##
35.4446 +.nr 31 \n(##
35.4447 +.sp |\n(##u-1v
35.4448 +.nr 37 \n(41u
35.4449 +.in +\n(37u
35.4450 +.b+
35.4451 +.in -\n(37u
35.4452 +.mk 32
35.4453 +.if \n(32>\n(31 .nr 31 \n(32
35.4454 +.sp |\n(31u
35.4455 +.ne \n(c|u+\n(.Vu
35.4456 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.4457 +.ta \n(80u \n(81u
35.4458 +.nr 31 \n(.f
35.4459 +.nr 35 1m
35.4460 +\&\h'|\n(40u'OGC\h'|\n(41u'
35.4461 +.mk ##
35.4462 +.nr 31 \n(##
35.4463 +.sp |\n(##u-1v
35.4464 +.nr 37 \n(41u
35.4465 +.in +\n(37u
35.4466 +.c+
35.4467 +.in -\n(37u
35.4468 +.mk 32
35.4469 +.if \n(32>\n(31 .nr 31 \n(32
35.4470 +.sp |\n(31u
35.4471 +.ne \n(d|u+\n(.Vu
35.4472 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.4473 +.ta \n(80u \n(81u
35.4474 +.nr 31 \n(.f
35.4475 +.nr 35 1m
35.4476 +\&\h'|\n(40u'OC\h'|\n(41u'
35.4477 +.mk ##
35.4478 +.nr 31 \n(##
35.4479 +.sp |\n(##u-1v
35.4480 +.nr 37 \n(41u
35.4481 +.in +\n(37u
35.4482 +.d+
35.4483 +.in -\n(37u
35.4484 +.mk 32
35.4485 +.if \n(32>\n(31 .nr 31 \n(32
35.4486 +.sp |\n(31u
35.4487 +.ne \n(e|u+\n(.Vu
35.4488 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.4489 +.ta \n(80u \n(81u
35.4490 +.nr 31 \n(.f
35.4491 +.nr 35 1m
35.4492 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.4493 +.mk ##
35.4494 +.nr 31 \n(##
35.4495 +.sp |\n(##u-1v
35.4496 +.nr 37 \n(41u
35.4497 +.in +\n(37u
35.4498 +.e+
35.4499 +.in -\n(37u
35.4500 +.mk 32
35.4501 +.if \n(32>\n(31 .nr 31 \n(32
35.4502 +.sp |\n(31u
35.4503 +.ta \n(80u \n(81u
35.4504 +.nr 31 \n(.f
35.4505 +.nr 35 1m
35.4506 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.4507 +.ne \n(f|u+\n(.Vu
35.4508 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.4509 +.ta \n(80u \n(81u
35.4510 +.nr 31 \n(.f
35.4511 +.nr 35 1m
35.4512 +\&\h'|\n(40u'FGCT\h'|\n(41u'
35.4513 +.mk ##
35.4514 +.nr 31 \n(##
35.4515 +.sp |\n(##u-1v
35.4516 +.nr 37 \n(41u
35.4517 +.in +\n(37u
35.4518 +.f+
35.4519 +.in -\n(37u
35.4520 +.mk 32
35.4521 +.if \n(32>\n(31 .nr 31 \n(32
35.4522 +.sp |\n(31u
35.4523 +.ne \n(g|u+\n(.Vu
35.4524 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.4525 +.ta \n(80u \n(81u
35.4526 +.nr 31 \n(.f
35.4527 +.nr 35 1m
35.4528 +\&\h'|\n(40u'GCT\h'|\n(41u'
35.4529 +.mk ##
35.4530 +.nr 31 \n(##
35.4531 +.sp |\n(##u-1v
35.4532 +.nr 37 \n(41u
35.4533 +.in +\n(37u
35.4534 +.g+
35.4535 +.in -\n(37u
35.4536 +.mk 32
35.4537 +.if \n(32>\n(31 .nr 31 \n(32
35.4538 +.sp |\n(31u
35.4539 +.fc
35.4540 +.nr T. 1
35.4541 +.T# 1
35.4542 +.35
35.4543 +.rm a+
35.4544 +.rm b+
35.4545 +.rm c+
35.4546 +.rm d+
35.4547 +.rm e+
35.4548 +.rm f+
35.4549 +.rm g+
35.4550 +.TE
35.4551 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.4552 +
35.4553 +.LP
35.4554 +.SS
35.4555 +\-gcpermcapacity 激с
35.4556 +.LP
35.4557 +.LP
35.4558 +.TS
35.4559 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.4560 +.de 35
35.4561 +.ps \n(.s
35.4562 +.vs \n(.vu
35.4563 +.in \n(.iu
35.4564 +.if \n(.u .fi
35.4565 +.if \n(.j .ad
35.4566 +.if \n(.j=0 .na
35.4567 +..
35.4568 +.nf
35.4569 +.nr #~ 0
35.4570 +.if n .nr #~ 0.6n
35.4571 +.ds #d .d
35.4572 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4573 +.fc
35.4574 +.nr 33 \n(.s
35.4575 +.rm 80 81
35.4576 +.nr 34 \n(.lu
35.4577 +.eo
35.4578 +.am 81
35.4579 +.br
35.4580 +.di a+
35.4581 +.35
35.4582 +.ft \n(.f
35.4583 +.ll \n(34u*1u/3u
35.4584 +.if \n(.l<\n(81 .ll \n(81u
35.4585 +.in 0
35.4586 +Permanent 筝篁c絨鎘拷 (KB)
35.4587 +.br
35.4588 +.di
35.4589 +.nr a| \n(dn
35.4590 +.nr a- \n(dl
35.4591 +..
35.4592 +.ec \
35.4593 +.eo
35.4594 +.am 81
35.4595 +.br
35.4596 +.di b+
35.4597 +.35
35.4598 +.ft \n(.f
35.4599 +.ll \n(34u*1u/3u
35.4600 +.if \n(.l<\n(81 .ll \n(81u
35.4601 +.in 0
35.4602 +Permanent 筝篁c紊у拷 (KB)
35.4603 +.br
35.4604 +.di
35.4605 +.nr b| \n(dn
35.4606 +.nr b- \n(dl
35.4607 +..
35.4608 +.ec \
35.4609 +.eo
35.4610 +.am 81
35.4611 +.br
35.4612 +.di c+
35.4613 +.35
35.4614 +.ft \n(.f
35.4615 +.ll \n(34u*1u/3u
35.4616 +.if \n(.l<\n(81 .ll \n(81u
35.4617 +.in 0
35.4618 +Permanent 筝篁c憜絎拷 (KB)
35.4619 +.br
35.4620 +.di
35.4621 +.nr c| \n(dn
35.4622 +.nr c- \n(dl
35.4623 +..
35.4624 +.ec \
35.4625 +.eo
35.4626 +.am 81
35.4627 +.br
35.4628 +.di d+
35.4629 +.35
35.4630 +.ft \n(.f
35.4631 +.ll \n(34u*1u/3u
35.4632 +.if \n(.l<\n(81 .ll \n(81u
35.4633 +.in 0
35.4634 +Permanent 憜絎拷 (KB)
35.4635 +.br
35.4636 +.di
35.4637 +.nr d| \n(dn
35.4638 +.nr d- \n(dl
35.4639 +..
35.4640 +.ec \
35.4641 +.eo
35.4642 +.am 81
35.4643 +.br
35.4644 +.di e+
35.4645 +.35
35.4646 +.ft \n(.f
35.4647 +.ll \n(34u*1u/3u
35.4648 +.if \n(.l<\n(81 .ll \n(81u
35.4649 +.in 0
35.4650 +ャ筝篁c GC ゃ潟
35.4651 +.br
35.4652 +.di
35.4653 +.nr e| \n(dn
35.4654 +.nr e- \n(dl
35.4655 +..
35.4656 +.ec \
35.4657 +.eo
35.4658 +.am 81
35.4659 +.br
35.4660 +.di f+
35.4661 +.35
35.4662 +.ft \n(.f
35.4663 +.ll \n(34u*1u/3u
35.4664 +.if \n(.l<\n(81 .ll \n(81u
35.4665 +.in 0
35.4666 +若吾潟激с恰
35.4667 +.br
35.4668 +.di
35.4669 +.nr f| \n(dn
35.4670 +.nr f- \n(dl
35.4671 +..
35.4672 +.ec \
35.4673 +.eo
35.4674 +.am 81
35.4675 +.br
35.4676 +.di g+
35.4677 +.35
35.4678 +.ft \n(.f
35.4679 +.ll \n(34u*1u/3u
35.4680 +.if \n(.l<\n(81 .ll \n(81u
35.4681 +.in 0
35.4682 +若吾潟激с括
35.4683 +.br
35.4684 +.di
35.4685 +.nr g| \n(dn
35.4686 +.nr g- \n(dl
35.4687 +..
35.4688 +.ec \
35.4689 +.35
35.4690 +.nf
35.4691 +.ll \n(34u
35.4692 +.nr 80 0
35.4693 +.nr 38 \wPermanent 筝篁c腟沿若
35.4694 +.if \n(80<\n(38 .nr 80 \n(38
35.4695 +.nr 38 \w\f3\fP
35.4696 +.if \n(80<\n(38 .nr 80 \n(38
35.4697 +.nr 38 \wPGCMN
35.4698 +.if \n(80<\n(38 .nr 80 \n(38
35.4699 +.nr 38 \wPGCMX
35.4700 +.if \n(80<\n(38 .nr 80 \n(38
35.4701 +.nr 38 \wPGC
35.4702 +.if \n(80<\n(38 .nr 80 \n(38
35.4703 +.nr 38 \wPC
35.4704 +.if \n(80<\n(38 .nr 80 \n(38
35.4705 +.nr 38 \wYGC
35.4706 +.if \n(80<\n(38 .nr 80 \n(38
35.4707 +.nr 38 \wFGC
35.4708 +.if \n(80<\n(38 .nr 80 \n(38
35.4709 +.nr 38 \wFGCT
35.4710 +.if \n(80<\n(38 .nr 80 \n(38
35.4711 +.nr 38 \wGCT
35.4712 +.if \n(80<\n(38 .nr 80 \n(38
35.4713 +.80
35.4714 +.rm 80
35.4715 +.nr 81 0
35.4716 +.nr 38 \w\f3茯\fP
35.4717 +.if \n(81<\n(38 .nr 81 \n(38
35.4718 +.nr 38 \w GC ゃ潟
35.4719 +.if \n(81<\n(38 .nr 81 \n(38
35.4720 +.81
35.4721 +.rm 81
35.4722 +.nr 38 \n(a-
35.4723 +.if \n(81<\n(38 .nr 81 \n(38
35.4724 +.nr 38 \n(b-
35.4725 +.if \n(81<\n(38 .nr 81 \n(38
35.4726 +.nr 38 \n(c-
35.4727 +.if \n(81<\n(38 .nr 81 \n(38
35.4728 +.nr 38 \n(d-
35.4729 +.if \n(81<\n(38 .nr 81 \n(38
35.4730 +.nr 38 \n(e-
35.4731 +.if \n(81<\n(38 .nr 81 \n(38
35.4732 +.nr 38 \n(f-
35.4733 +.if \n(81<\n(38 .nr 81 \n(38
35.4734 +.nr 38 \n(g-
35.4735 +.if \n(81<\n(38 .nr 81 \n(38
35.4736 +.35
35.4737 +.nf
35.4738 +.ll \n(34u
35.4739 +.nr 38 1n
35.4740 +.nr 79 0
35.4741 +.nr 40 \n(79+(0*\n(38)
35.4742 +.nr 80 +\n(40
35.4743 +.nr 41 \n(80+(3*\n(38)
35.4744 +.nr 81 +\n(41
35.4745 +.nr TW \n(81
35.4746 +.if t .if \n(TW>\n(.li .tm Table at line 753 file Input is too wide - \n(TW units
35.4747 +.fc
35.4748 +.nr #T 0-1
35.4749 +.nr #a 0-1
35.4750 +.eo
35.4751 +.de T#
35.4752 +.ds #d .d
35.4753 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4754 +.mk ##
35.4755 +.nr ## -1v
35.4756 +.ls 1
35.4757 +.ls
35.4758 +..
35.4759 +.ec
35.4760 +.ta \n(80u \n(81u
35.4761 +.nr 31 \n(.f
35.4762 +.nr 35 1m
35.4763 +\&\h'|\n(40u'Permanent 筝篁c腟沿若\h'|\n(41u'
35.4764 +.ta \n(80u \n(81u
35.4765 +.nr 31 \n(.f
35.4766 +.nr 35 1m
35.4767 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.4768 +.ne \n(a|u+\n(.Vu
35.4769 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.4770 +.ta \n(80u \n(81u
35.4771 +.nr 31 \n(.f
35.4772 +.nr 35 1m
35.4773 +\&\h'|\n(40u'PGCMN\h'|\n(41u'
35.4774 +.mk ##
35.4775 +.nr 31 \n(##
35.4776 +.sp |\n(##u-1v
35.4777 +.nr 37 \n(41u
35.4778 +.in +\n(37u
35.4779 +.a+
35.4780 +.in -\n(37u
35.4781 +.mk 32
35.4782 +.if \n(32>\n(31 .nr 31 \n(32
35.4783 +.sp |\n(31u
35.4784 +.ne \n(b|u+\n(.Vu
35.4785 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.4786 +.ta \n(80u \n(81u
35.4787 +.nr 31 \n(.f
35.4788 +.nr 35 1m
35.4789 +\&\h'|\n(40u'PGCMX\h'|\n(41u'
35.4790 +.mk ##
35.4791 +.nr 31 \n(##
35.4792 +.sp |\n(##u-1v
35.4793 +.nr 37 \n(41u
35.4794 +.in +\n(37u
35.4795 +.b+
35.4796 +.in -\n(37u
35.4797 +.mk 32
35.4798 +.if \n(32>\n(31 .nr 31 \n(32
35.4799 +.sp |\n(31u
35.4800 +.ne \n(c|u+\n(.Vu
35.4801 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.4802 +.ta \n(80u \n(81u
35.4803 +.nr 31 \n(.f
35.4804 +.nr 35 1m
35.4805 +\&\h'|\n(40u'PGC\h'|\n(41u'
35.4806 +.mk ##
35.4807 +.nr 31 \n(##
35.4808 +.sp |\n(##u-1v
35.4809 +.nr 37 \n(41u
35.4810 +.in +\n(37u
35.4811 +.c+
35.4812 +.in -\n(37u
35.4813 +.mk 32
35.4814 +.if \n(32>\n(31 .nr 31 \n(32
35.4815 +.sp |\n(31u
35.4816 +.ne \n(d|u+\n(.Vu
35.4817 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.4818 +.ta \n(80u \n(81u
35.4819 +.nr 31 \n(.f
35.4820 +.nr 35 1m
35.4821 +\&\h'|\n(40u'PC\h'|\n(41u'
35.4822 +.mk ##
35.4823 +.nr 31 \n(##
35.4824 +.sp |\n(##u-1v
35.4825 +.nr 37 \n(41u
35.4826 +.in +\n(37u
35.4827 +.d+
35.4828 +.in -\n(37u
35.4829 +.mk 32
35.4830 +.if \n(32>\n(31 .nr 31 \n(32
35.4831 +.sp |\n(31u
35.4832 +.ne \n(e|u+\n(.Vu
35.4833 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.4834 +.ta \n(80u \n(81u
35.4835 +.nr 31 \n(.f
35.4836 +.nr 35 1m
35.4837 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.4838 +.mk ##
35.4839 +.nr 31 \n(##
35.4840 +.sp |\n(##u-1v
35.4841 +.nr 37 \n(41u
35.4842 +.in +\n(37u
35.4843 +.e+
35.4844 +.in -\n(37u
35.4845 +.mk 32
35.4846 +.if \n(32>\n(31 .nr 31 \n(32
35.4847 +.sp |\n(31u
35.4848 +.ta \n(80u \n(81u
35.4849 +.nr 31 \n(.f
35.4850 +.nr 35 1m
35.4851 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.4852 +.ne \n(f|u+\n(.Vu
35.4853 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.4854 +.ta \n(80u \n(81u
35.4855 +.nr 31 \n(.f
35.4856 +.nr 35 1m
35.4857 +\&\h'|\n(40u'FGCT\h'|\n(41u'
35.4858 +.mk ##
35.4859 +.nr 31 \n(##
35.4860 +.sp |\n(##u-1v
35.4861 +.nr 37 \n(41u
35.4862 +.in +\n(37u
35.4863 +.f+
35.4864 +.in -\n(37u
35.4865 +.mk 32
35.4866 +.if \n(32>\n(31 .nr 31 \n(32
35.4867 +.sp |\n(31u
35.4868 +.ne \n(g|u+\n(.Vu
35.4869 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.4870 +.ta \n(80u \n(81u
35.4871 +.nr 31 \n(.f
35.4872 +.nr 35 1m
35.4873 +\&\h'|\n(40u'GCT\h'|\n(41u'
35.4874 +.mk ##
35.4875 +.nr 31 \n(##
35.4876 +.sp |\n(##u-1v
35.4877 +.nr 37 \n(41u
35.4878 +.in +\n(37u
35.4879 +.g+
35.4880 +.in -\n(37u
35.4881 +.mk 32
35.4882 +.if \n(32>\n(31 .nr 31 \n(32
35.4883 +.sp |\n(31u
35.4884 +.fc
35.4885 +.nr T. 1
35.4886 +.T# 1
35.4887 +.35
35.4888 +.rm a+
35.4889 +.rm b+
35.4890 +.rm c+
35.4891 +.rm d+
35.4892 +.rm e+
35.4893 +.rm f+
35.4894 +.rm g+
35.4895 +.TE
35.4896 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.4897 +
35.4898 +.LP
35.4899 +.SS
35.4900 +\-gcutil 激с
35.4901 +.LP
35.4902 +.LP
35.4903 +.TS
35.4904 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.4905 +.de 35
35.4906 +.ps \n(.s
35.4907 +.vs \n(.vu
35.4908 +.in \n(.iu
35.4909 +.if \n(.u .fi
35.4910 +.if \n(.j .ad
35.4911 +.if \n(.j=0 .na
35.4912 +..
35.4913 +.nf
35.4914 +.nr #~ 0
35.4915 +.if n .nr #~ 0.6n
35.4916 +.ds #d .d
35.4917 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.4918 +.fc
35.4919 +.nr 33 \n(.s
35.4920 +.rm 80 81
35.4921 +.nr 34 \n(.lu
35.4922 +.eo
35.4923 +.am 81
35.4924 +.br
35.4925 +.di a+
35.4926 +.35
35.4927 +.ft \n(.f
35.4928 +.ll \n(34u*1u/3u
35.4929 +.if \n(.l<\n(81 .ll \n(81u
35.4930 +.in 0
35.4931 +Survivor 0 篏睡 (憜絎拷絲障若祉潟若)
35.4932 +.br
35.4933 +.di
35.4934 +.nr a| \n(dn
35.4935 +.nr a- \n(dl
35.4936 +..
35.4937 +.ec \
35.4938 +.eo
35.4939 +.am 81
35.4940 +.br
35.4941 +.di b+
35.4942 +.35
35.4943 +.ft \n(.f
35.4944 +.ll \n(34u*1u/3u
35.4945 +.if \n(.l<\n(81 .ll \n(81u
35.4946 +.in 0
35.4947 +Survivor 1 篏睡 (憜絎拷絲障若祉潟若)
35.4948 +.br
35.4949 +.di
35.4950 +.nr b| \n(dn
35.4951 +.nr b- \n(dl
35.4952 +..
35.4953 +.ec \
35.4954 +.eo
35.4955 +.am 81
35.4956 +.br
35.4957 +.di c+
35.4958 +.35
35.4959 +.ft \n(.f
35.4960 +.ll \n(34u*1u/3u
35.4961 +.if \n(.l<\n(81 .ll \n(81u
35.4962 +.in 0
35.4963 +Eden 篏睡 (憜絎拷絲障若祉潟若)
35.4964 +.br
35.4965 +.di
35.4966 +.nr c| \n(dn
35.4967 +.nr c- \n(dl
35.4968 +..
35.4969 +.ec \
35.4970 +.eo
35.4971 +.am 81
35.4972 +.br
35.4973 +.di d+
35.4974 +.35
35.4975 +.ft \n(.f
35.4976 +.ll \n(34u*1u/3u
35.4977 +.if \n(.l<\n(81 .ll \n(81u
35.4978 +.in 0
35.4979 +Old 篏睡 (憜絎拷絲障若祉潟若)
35.4980 +.br
35.4981 +.di
35.4982 +.nr d| \n(dn
35.4983 +.nr d- \n(dl
35.4984 +..
35.4985 +.ec \
35.4986 +.eo
35.4987 +.am 81
35.4988 +.br
35.4989 +.di e+
35.4990 +.35
35.4991 +.ft \n(.f
35.4992 +.ll \n(34u*1u/3u
35.4993 +.if \n(.l<\n(81 .ll \n(81u
35.4994 +.in 0
35.4995 +Permanent 篏睡 (憜絎拷絲障若祉潟若)
35.4996 +.br
35.4997 +.di
35.4998 +.nr e| \n(dn
35.4999 +.nr e- \n(dl
35.5000 +..
35.5001 +.ec \
35.5002 +.eo
35.5003 +.am 81
35.5004 +.br
35.5005 +.di f+
35.5006 +.35
35.5007 +.ft \n(.f
35.5008 +.ll \n(34u*1u/3u
35.5009 +.if \n(.l<\n(81 .ll \n(81u
35.5010 +.in 0
35.5011 +ャ筝篁c GC ゃ潟
35.5012 +.br
35.5013 +.di
35.5014 +.nr f| \n(dn
35.5015 +.nr f- \n(dl
35.5016 +..
35.5017 +.ec \
35.5018 +.eo
35.5019 +.am 81
35.5020 +.br
35.5021 +.di g+
35.5022 +.35
35.5023 +.ft \n(.f
35.5024 +.ll \n(34u*1u/3u
35.5025 +.if \n(.l<\n(81 .ll \n(81u
35.5026 +.in 0
35.5027 +ャ筝篁c若吾潟激с恰
35.5028 +.br
35.5029 +.di
35.5030 +.nr g| \n(dn
35.5031 +.nr g- \n(dl
35.5032 +..
35.5033 +.ec \
35.5034 +.eo
35.5035 +.am 81
35.5036 +.br
35.5037 +.di h+
35.5038 +.35
35.5039 +.ft \n(.f
35.5040 +.ll \n(34u*1u/3u
35.5041 +.if \n(.l<\n(81 .ll \n(81u
35.5042 +.in 0
35.5043 +若吾潟激с恰
35.5044 +.br
35.5045 +.di
35.5046 +.nr h| \n(dn
35.5047 +.nr h- \n(dl
35.5048 +..
35.5049 +.ec \
35.5050 +.eo
35.5051 +.am 81
35.5052 +.br
35.5053 +.di i+
35.5054 +.35
35.5055 +.ft \n(.f
35.5056 +.ll \n(34u*1u/3u
35.5057 +.if \n(.l<\n(81 .ll \n(81u
35.5058 +.in 0
35.5059 +若吾潟激с括
35.5060 +.br
35.5061 +.di
35.5062 +.nr i| \n(dn
35.5063 +.nr i- \n(dl
35.5064 +..
35.5065 +.ec \
35.5066 +.35
35.5067 +.nf
35.5068 +.ll \n(34u
35.5069 +.nr 80 0
35.5070 +.nr 38 \w若吾潟激с括輝荐若帥网荀
35.5071 +.if \n(80<\n(38 .nr 80 \n(38
35.5072 +.nr 38 \w\f3\fP
35.5073 +.if \n(80<\n(38 .nr 80 \n(38
35.5074 +.nr 38 \wS0
35.5075 +.if \n(80<\n(38 .nr 80 \n(38
35.5076 +.nr 38 \wS1
35.5077 +.if \n(80<\n(38 .nr 80 \n(38
35.5078 +.nr 38 \wE
35.5079 +.if \n(80<\n(38 .nr 80 \n(38
35.5080 +.nr 38 \wO
35.5081 +.if \n(80<\n(38 .nr 80 \n(38
35.5082 +.nr 38 \wP
35.5083 +.if \n(80<\n(38 .nr 80 \n(38
35.5084 +.nr 38 \wYGC
35.5085 +.if \n(80<\n(38 .nr 80 \n(38
35.5086 +.nr 38 \wYGCT
35.5087 +.if \n(80<\n(38 .nr 80 \n(38
35.5088 +.nr 38 \wFGC
35.5089 +.if \n(80<\n(38 .nr 80 \n(38
35.5090 +.nr 38 \wFGCT
35.5091 +.if \n(80<\n(38 .nr 80 \n(38
35.5092 +.nr 38 \wGCT
35.5093 +.if \n(80<\n(38 .nr 80 \n(38
35.5094 +.80
35.5095 +.rm 80
35.5096 +.nr 81 0
35.5097 +.nr 38 \w\f3茯\fP
35.5098 +.if \n(81<\n(38 .nr 81 \n(38
35.5099 +.nr 38 \w GC ゃ潟
35.5100 +.if \n(81<\n(38 .nr 81 \n(38
35.5101 +.81
35.5102 +.rm 81
35.5103 +.nr 38 \n(a-
35.5104 +.if \n(81<\n(38 .nr 81 \n(38
35.5105 +.nr 38 \n(b-
35.5106 +.if \n(81<\n(38 .nr 81 \n(38
35.5107 +.nr 38 \n(c-
35.5108 +.if \n(81<\n(38 .nr 81 \n(38
35.5109 +.nr 38 \n(d-
35.5110 +.if \n(81<\n(38 .nr 81 \n(38
35.5111 +.nr 38 \n(e-
35.5112 +.if \n(81<\n(38 .nr 81 \n(38
35.5113 +.nr 38 \n(f-
35.5114 +.if \n(81<\n(38 .nr 81 \n(38
35.5115 +.nr 38 \n(g-
35.5116 +.if \n(81<\n(38 .nr 81 \n(38
35.5117 +.nr 38 \n(h-
35.5118 +.if \n(81<\n(38 .nr 81 \n(38
35.5119 +.nr 38 \n(i-
35.5120 +.if \n(81<\n(38 .nr 81 \n(38
35.5121 +.35
35.5122 +.nf
35.5123 +.ll \n(34u
35.5124 +.nr 38 1n
35.5125 +.nr 79 0
35.5126 +.nr 40 \n(79+(0*\n(38)
35.5127 +.nr 80 +\n(40
35.5128 +.nr 41 \n(80+(3*\n(38)
35.5129 +.nr 81 +\n(41
35.5130 +.nr TW \n(81
35.5131 +.if t .if \n(TW>\n(.li .tm Table at line 803 file Input is too wide - \n(TW units
35.5132 +.fc
35.5133 +.nr #T 0-1
35.5134 +.nr #a 0-1
35.5135 +.eo
35.5136 +.de T#
35.5137 +.ds #d .d
35.5138 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.5139 +.mk ##
35.5140 +.nr ## -1v
35.5141 +.ls 1
35.5142 +.ls
35.5143 +..
35.5144 +.ec
35.5145 +.ta \n(80u \n(81u
35.5146 +.nr 31 \n(.f
35.5147 +.nr 35 1m
35.5148 +\&\h'|\n(40u'若吾潟激с括輝荐若帥网荀\h'|\n(41u'
35.5149 +.ta \n(80u \n(81u
35.5150 +.nr 31 \n(.f
35.5151 +.nr 35 1m
35.5152 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.5153 +.ne \n(a|u+\n(.Vu
35.5154 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.5155 +.ta \n(80u \n(81u
35.5156 +.nr 31 \n(.f
35.5157 +.nr 35 1m
35.5158 +\&\h'|\n(40u'S0\h'|\n(41u'
35.5159 +.mk ##
35.5160 +.nr 31 \n(##
35.5161 +.sp |\n(##u-1v
35.5162 +.nr 37 \n(41u
35.5163 +.in +\n(37u
35.5164 +.a+
35.5165 +.in -\n(37u
35.5166 +.mk 32
35.5167 +.if \n(32>\n(31 .nr 31 \n(32
35.5168 +.sp |\n(31u
35.5169 +.ne \n(b|u+\n(.Vu
35.5170 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.5171 +.ta \n(80u \n(81u
35.5172 +.nr 31 \n(.f
35.5173 +.nr 35 1m
35.5174 +\&\h'|\n(40u'S1\h'|\n(41u'
35.5175 +.mk ##
35.5176 +.nr 31 \n(##
35.5177 +.sp |\n(##u-1v
35.5178 +.nr 37 \n(41u
35.5179 +.in +\n(37u
35.5180 +.b+
35.5181 +.in -\n(37u
35.5182 +.mk 32
35.5183 +.if \n(32>\n(31 .nr 31 \n(32
35.5184 +.sp |\n(31u
35.5185 +.ne \n(c|u+\n(.Vu
35.5186 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.5187 +.ta \n(80u \n(81u
35.5188 +.nr 31 \n(.f
35.5189 +.nr 35 1m
35.5190 +\&\h'|\n(40u'E\h'|\n(41u'
35.5191 +.mk ##
35.5192 +.nr 31 \n(##
35.5193 +.sp |\n(##u-1v
35.5194 +.nr 37 \n(41u
35.5195 +.in +\n(37u
35.5196 +.c+
35.5197 +.in -\n(37u
35.5198 +.mk 32
35.5199 +.if \n(32>\n(31 .nr 31 \n(32
35.5200 +.sp |\n(31u
35.5201 +.ne \n(d|u+\n(.Vu
35.5202 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
35.5203 +.ta \n(80u \n(81u
35.5204 +.nr 31 \n(.f
35.5205 +.nr 35 1m
35.5206 +\&\h'|\n(40u'O\h'|\n(41u'
35.5207 +.mk ##
35.5208 +.nr 31 \n(##
35.5209 +.sp |\n(##u-1v
35.5210 +.nr 37 \n(41u
35.5211 +.in +\n(37u
35.5212 +.d+
35.5213 +.in -\n(37u
35.5214 +.mk 32
35.5215 +.if \n(32>\n(31 .nr 31 \n(32
35.5216 +.sp |\n(31u
35.5217 +.ne \n(e|u+\n(.Vu
35.5218 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
35.5219 +.ta \n(80u \n(81u
35.5220 +.nr 31 \n(.f
35.5221 +.nr 35 1m
35.5222 +\&\h'|\n(40u'P\h'|\n(41u'
35.5223 +.mk ##
35.5224 +.nr 31 \n(##
35.5225 +.sp |\n(##u-1v
35.5226 +.nr 37 \n(41u
35.5227 +.in +\n(37u
35.5228 +.e+
35.5229 +.in -\n(37u
35.5230 +.mk 32
35.5231 +.if \n(32>\n(31 .nr 31 \n(32
35.5232 +.sp |\n(31u
35.5233 +.ne \n(f|u+\n(.Vu
35.5234 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
35.5235 +.ta \n(80u \n(81u
35.5236 +.nr 31 \n(.f
35.5237 +.nr 35 1m
35.5238 +\&\h'|\n(40u'YGC\h'|\n(41u'
35.5239 +.mk ##
35.5240 +.nr 31 \n(##
35.5241 +.sp |\n(##u-1v
35.5242 +.nr 37 \n(41u
35.5243 +.in +\n(37u
35.5244 +.f+
35.5245 +.in -\n(37u
35.5246 +.mk 32
35.5247 +.if \n(32>\n(31 .nr 31 \n(32
35.5248 +.sp |\n(31u
35.5249 +.ne \n(g|u+\n(.Vu
35.5250 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
35.5251 +.ta \n(80u \n(81u
35.5252 +.nr 31 \n(.f
35.5253 +.nr 35 1m
35.5254 +\&\h'|\n(40u'YGCT\h'|\n(41u'
35.5255 +.mk ##
35.5256 +.nr 31 \n(##
35.5257 +.sp |\n(##u-1v
35.5258 +.nr 37 \n(41u
35.5259 +.in +\n(37u
35.5260 +.g+
35.5261 +.in -\n(37u
35.5262 +.mk 32
35.5263 +.if \n(32>\n(31 .nr 31 \n(32
35.5264 +.sp |\n(31u
35.5265 +.ta \n(80u \n(81u
35.5266 +.nr 31 \n(.f
35.5267 +.nr 35 1m
35.5268 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
35.5269 +.ne \n(h|u+\n(.Vu
35.5270 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
35.5271 +.ta \n(80u \n(81u
35.5272 +.nr 31 \n(.f
35.5273 +.nr 35 1m
35.5274 +\&\h'|\n(40u'FGCT\h'|\n(41u'
35.5275 +.mk ##
35.5276 +.nr 31 \n(##
35.5277 +.sp |\n(##u-1v
35.5278 +.nr 37 \n(41u
35.5279 +.in +\n(37u
35.5280 +.h+
35.5281 +.in -\n(37u
35.5282 +.mk 32
35.5283 +.if \n(32>\n(31 .nr 31 \n(32
35.5284 +.sp |\n(31u
35.5285 +.ne \n(i|u+\n(.Vu
35.5286 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
35.5287 +.ta \n(80u \n(81u
35.5288 +.nr 31 \n(.f
35.5289 +.nr 35 1m
35.5290 +\&\h'|\n(40u'GCT\h'|\n(41u'
35.5291 +.mk ##
35.5292 +.nr 31 \n(##
35.5293 +.sp |\n(##u-1v
35.5294 +.nr 37 \n(41u
35.5295 +.in +\n(37u
35.5296 +.i+
35.5297 +.in -\n(37u
35.5298 +.mk 32
35.5299 +.if \n(32>\n(31 .nr 31 \n(32
35.5300 +.sp |\n(31u
35.5301 +.fc
35.5302 +.nr T. 1
35.5303 +.T# 1
35.5304 +.35
35.5305 +.rm a+
35.5306 +.rm b+
35.5307 +.rm c+
35.5308 +.rm d+
35.5309 +.rm e+
35.5310 +.rm f+
35.5311 +.rm g+
35.5312 +.rm h+
35.5313 +.rm i+
35.5314 +.TE
35.5315 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-43
35.5316 +
35.5317 +.LP
35.5318 +.SS
35.5319 +\-printcompilation 激с
35.5320 +.LP
35.5321 +.LP
35.5322 +.TS
35.5323 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
35.5324 +.de 35
35.5325 +.ps \n(.s
35.5326 +.vs \n(.vu
35.5327 +.in \n(.iu
35.5328 +.if \n(.u .fi
35.5329 +.if \n(.j .ad
35.5330 +.if \n(.j=0 .na
35.5331 +..
35.5332 +.nf
35.5333 +.nr #~ 0
35.5334 +.if n .nr #~ 0.6n
35.5335 +.ds #d .d
35.5336 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.5337 +.fc
35.5338 +.nr 33 \n(.s
35.5339 +.rm 80 81
35.5340 +.nr 34 \n(.lu
35.5341 +.eo
35.5342 +.am 81
35.5343 +.br
35.5344 +.di a+
35.5345 +.35
35.5346 +.ft \n(.f
35.5347 +.ll \n(34u*1u/3u
35.5348 +.if \n(.l<\n(81 .ll \n(81u
35.5349 +.in 0
35.5350 +絎茵潟潟ゃ帥鴻
35.5351 +.br
35.5352 +.di
35.5353 +.nr a| \n(dn
35.5354 +.nr a- \n(dl
35.5355 +..
35.5356 +.ec \
35.5357 +.eo
35.5358 +.am 81
35.5359 +.br
35.5360 +.di b+
35.5361 +.35
35.5362 +.ft \n(.f
35.5363 +.ll \n(34u*1u/3u
35.5364 +.if \n(.l<\n(81 .ll \n(81u
35.5365 +.in 0
35.5366 +<純ゃ潟若ゃ
35.5367 +.br
35.5368 +.di
35.5369 +.nr b| \n(dn
35.5370 +.nr b- \n(dl
35.5371 +..
35.5372 +.ec \
35.5373 +.eo
35.5374 +.am 81
35.5375 +.br
35.5376 +.di c+
35.5377 +.35
35.5378 +.ft \n(.f
35.5379 +.ll \n(34u*1u/3u
35.5380 +.if \n(.l<\n(81 .ll \n(81u
35.5381 +.in 0
35.5382 +潟潟ゃ号劫劫<純劫с腥咲阪絖.с/篏睡<純絎劫<純с 2 ゃc若綵√HotSpot \- \f3XX:+PrintComplation\fP 激с潟絲上
35.5383 +.br
35.5384 +.di
35.5385 +.nr c| \n(dn
35.5386 +.nr c- \n(dl
35.5387 +..
35.5388 +.ec \
35.5389 +.35
35.5390 +.nf
35.5391 +.ll \n(34u
35.5392 +.nr 80 0
35.5393 +.nr 38 \wHotSpot 潟潟ゃ号腟沿若
35.5394 +.if \n(80<\n(38 .nr 80 \n(38
35.5395 +.nr 38 \w\f3\fP
35.5396 +.if \n(80<\n(38 .nr 80 \n(38
35.5397 +.nr 38 \wCompiled
35.5398 +.if \n(80<\n(38 .nr 80 \n(38
35.5399 +.nr 38 \w泣ゃ
35.5400 +.if \n(80<\n(38 .nr 80 \n(38
35.5401 +.nr 38 \w
35.5402 +.if \n(80<\n(38 .nr 80 \n(38
35.5403 +.nr 38 \w<純
35.5404 +.if \n(80<\n(38 .nr 80 \n(38
35.5405 +.80
35.5406 +.rm 80
35.5407 +.nr 81 0
35.5408 +.nr 38 \w\f3茯\fP
35.5409 +.if \n(81<\n(38 .nr 81 \n(38
35.5410 +.nr 38 \w潟潟ゃ帥ゃ
35.5411 +.if \n(81<\n(38 .nr 81 \n(38
35.5412 +.81
35.5413 +.rm 81
35.5414 +.nr 38 \n(a-
35.5415 +.if \n(81<\n(38 .nr 81 \n(38
35.5416 +.nr 38 \n(b-
35.5417 +.if \n(81<\n(38 .nr 81 \n(38
35.5418 +.nr 38 \n(c-
35.5419 +.if \n(81<\n(38 .nr 81 \n(38
35.5420 +.35
35.5421 +.nf
35.5422 +.ll \n(34u
35.5423 +.nr 38 1n
35.5424 +.nr 79 0
35.5425 +.nr 40 \n(79+(0*\n(38)
35.5426 +.nr 80 +\n(40
35.5427 +.nr 41 \n(80+(3*\n(38)
35.5428 +.nr 81 +\n(41
35.5429 +.nr TW \n(81
35.5430 +.if t .if \n(TW>\n(.li .tm Table at line 829 file Input is too wide - \n(TW units
35.5431 +.fc
35.5432 +.nr #T 0-1
35.5433 +.nr #a 0-1
35.5434 +.eo
35.5435 +.de T#
35.5436 +.ds #d .d
35.5437 +.if \(ts\n(.z\(ts\(ts .ds #d nl
35.5438 +.mk ##
35.5439 +.nr ## -1v
35.5440 +.ls 1
35.5441 +.ls
35.5442 +..
35.5443 +.ec
35.5444 +.ta \n(80u \n(81u
35.5445 +.nr 31 \n(.f
35.5446 +.nr 35 1m
35.5447 +\&\h'|\n(40u'HotSpot 潟潟ゃ号腟沿若\h'|\n(41u'
35.5448 +.ta \n(80u \n(81u
35.5449 +.nr 31 \n(.f
35.5450 +.nr 35 1m
35.5451 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
35.5452 +.ne \n(a|u+\n(.Vu
35.5453 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
35.5454 +.ta \n(80u \n(81u
35.5455 +.nr 31 \n(.f
35.5456 +.nr 35 1m
35.5457 +\&\h'|\n(40u'Compiled\h'|\n(41u'
35.5458 +.mk ##
35.5459 +.nr 31 \n(##
35.5460 +.sp |\n(##u-1v
35.5461 +.nr 37 \n(41u
35.5462 +.in +\n(37u
35.5463 +.a+
35.5464 +.in -\n(37u
35.5465 +.mk 32
35.5466 +.if \n(32>\n(31 .nr 31 \n(32
35.5467 +.sp |\n(31u
35.5468 +.ne \n(b|u+\n(.Vu
35.5469 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
35.5470 +.ta \n(80u \n(81u
35.5471 +.nr 31 \n(.f
35.5472 +.nr 35 1m
35.5473 +\&\h'|\n(40u'泣ゃ\h'|\n(41u'
35.5474 +.mk ##
35.5475 +.nr 31 \n(##
35.5476 +.sp |\n(##u-1v
35.5477 +.nr 37 \n(41u
35.5478 +.in +\n(37u
35.5479 +.b+
35.5480 +.in -\n(37u
35.5481 +.mk 32
35.5482 +.if \n(32>\n(31 .nr 31 \n(32
35.5483 +.sp |\n(31u
35.5484 +.ta \n(80u \n(81u
35.5485 +.nr 31 \n(.f
35.5486 +.nr 35 1m
35.5487 +\&\h'|\n(40u'\h'|\n(41u'潟潟ゃ帥ゃ
35.5488 +.ne \n(c|u+\n(.Vu
35.5489 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
35.5490 +.ta \n(80u \n(81u
35.5491 +.nr 31 \n(.f
35.5492 +.nr 35 1m
35.5493 +\&\h'|\n(40u'<純\h'|\n(41u'
35.5494 +.mk ##
35.5495 +.nr 31 \n(##
35.5496 +.sp |\n(##u-1v
35.5497 +.nr 37 \n(41u
35.5498 +.in +\n(37u
35.5499 +.c+
35.5500 +.in -\n(37u
35.5501 +.mk 32
35.5502 +.if \n(32>\n(31 .nr 31 \n(32
35.5503 +.sp |\n(31u
35.5504 +.fc
35.5505 +.nr T. 1
35.5506 +.T# 1
35.5507 +.35
35.5508 +.rm a+
35.5509 +.rm b+
35.5510 +.rm c+
35.5511 +.TE
35.5512 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
35.5513 +
35.5514 +.LP
35.5515 +.SS
35.5516 +
35.5517 +.LP
35.5518 +.SH ""
35.5519 +.LP
35.5520 +.LP
35.5521 +с21891 \f2lvmid\fP ゃ若 JVM h箴腓冴障
35.5522 +.LP
35.5523 +.SS
35.5524 +gcutil 激с潟篏睡
35.5525 +.LP
35.5526 +.LP
35.5527 +箴\f2lvmid\fP 21891 ・膓250 腱 7 ゃ泣潟緇\f3\-gcutil\fP 激с潟с絎緇c阪茵腓冴障
35.5528 +.LP
35.5529 +.nf
35.5530 +\f3
35.5531 +.fl
35.5532 +\fP\f3jstat \-gcutil 21891 250 7\fP
35.5533 +.br
35.5534 +
35.5535 +.fl
35.5536 + S0 S1 E O P YGC YGCT FGC FGCT GCT
35.5537 +.br
35.5538 +
35.5539 +.fl
35.5540 + 12.44 0.00 27.20 9.49 96.70 78 0.176 5 0.495 0.672
35.5541 +.br
35.5542 +
35.5543 +.fl
35.5544 + 12.44 0.00 62.16 9.49 96.70 78 0.176 5 0.495 0.672
35.5545 +.br
35.5546 +
35.5547 +.fl
35.5548 + 12.44 0.00 83.97 9.49 96.70 78 0.176 5 0.495 0.672
35.5549 +.br
35.5550 +
35.5551 +.fl
35.5552 + 0.00 7.74 0.00 9.51 96.70 79 0.177 5 0.495 0.673
35.5553 +.br
35.5554 +
35.5555 +.fl
35.5556 + 0.00 7.74 23.37 9.51 96.70 79 0.177 5 0.495 0.673
35.5557 +.br
35.5558 +
35.5559 +.fl
35.5560 + 0.00 7.74 43.82 9.51 96.70 79 0.177 5 0.495 0.673
35.5561 +.br
35.5562 +
35.5563 +.fl
35.5564 + 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
35.5565 +.br
35.5566 +
35.5567 +.fl
35.5568 +.fi
35.5569 +
35.5570 +.LP
35.5571 +.LP
35.5572 +箴阪ャ筝篁c潟激с潟 3 4 泣潟ц腓冴障潟激с潟 0.001 腱c吾с Eden (E) Old (O) 若Old 篏睡 9.49% 9.51% 紜障Survivor 潟激с喝 12.44% 篏睡障潟激с喝 7.74% 篏睡障
35.5573 +.LP
35.5574 +.SS
35.5575 +惹絖膵違菴
35.5576 +.LP
35.5577 +.LP
35.5578 +箴\f2lvmid\fP 21891 ・膓250 腱с泣潟緇\f3\-gcutil\fP 激с潟с絎緇c阪茵腓冴障\f3\-h3\fP 激с潟篏睡若帥 3 茵茵腓冴若阪障
35.5579 +.LP
35.5580 +.nf
35.5581 +\f3
35.5582 +.fl
35.5583 +\fP\f3jstat \-gcnew \-h3 21891 250\fP
35.5584 +.br
35.5585 +
35.5586 +.fl
35.5587 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.5588 +.br
35.5589 +
35.5590 +.fl
35.5591 + 64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203
35.5592 +.br
35.5593 +
35.5594 +.fl
35.5595 + 64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203
35.5596 +.br
35.5597 +
35.5598 +.fl
35.5599 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204
35.5600 +.br
35.5601 +
35.5602 +.fl
35.5603 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.5604 +.br
35.5605 +
35.5606 +.fl
35.5607 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204
35.5608 +.br
35.5609 +
35.5610 +.fl
35.5611 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204
35.5612 +.br
35.5613 +
35.5614 +.fl
35.5615 + 64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204
35.5616 +.br
35.5617 +
35.5618 +.fl
35.5619 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.5620 +.br
35.5621 +
35.5622 +.fl
35.5623 + 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
35.5624 +.br
35.5625 +
35.5626 +.fl
35.5627 +.fi
35.5628 +
35.5629 +.LP
35.5630 +.LP
35.5631 +箴с惹絖膵違菴荀祉2 3 泣潟 Young GC 茵障膓膓 0.001 腱с潟激с潟сSurvivor 0 篏睡 (S0U) Survivor 泣ゃ (DSS) 莇ゃ若帥罎冴障腟吾сOld 筝篁 (阪茵腓) 御若罧水ャ (TT) 31 2 檎若障
35.5632 +.LP
35.5633 +.LP
35.5634 +ャ潟激с潟5 6 泣潟ц障潟激с潟сSurvivor 祉荀罧水ャゃ 31 祉障
35.5635 +.LP
35.5636 +.SS
35.5637 +泣潟帥ゃ鴻帥潟水
35.5638 +.LP
35.5639 +.LP
35.5640 +箴\f2lvmid\fP 21891 御・膓250 腱 3 ゃ泣潟緇障\f3\-t\fP 激с潟篏睡泣潟帥ゃ鴻帥潟茵腓冴障
35.5641 +.LP
35.5642 +.nf
35.5643 +\f3
35.5644 +.fl
35.5645 +\fP\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
35.5646 +.br
35.5647 +
35.5648 +.fl
35.5649 +Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT
35.5650 +.br
35.5651 +
35.5652 +.fl
35.5653 + 150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799
35.5654 +.br
35.5655 +
35.5656 +.fl
35.5657 + 150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
35.5658 +.br
35.5659 +
35.5660 +.fl
35.5661 + 150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
35.5662 +.br
35.5663 +
35.5664 +.fl
35.5665 +.fi
35.5666 +
35.5667 +.LP
35.5668 +.LP
35.5669 +\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏с若障\f3\-gcoldcapacity\fP 阪с蚊綵荀羆障取羆筝≧鴻羣若≦宍Old 筝篁c絎拷 (OGC) Old 絎拷 (OC) 紜障Old 筝篁c絎拷 (OGC) 81 GC (FGC) 緇11696 KB 13820 KB 後障Old 筝篁 (渇) 紊у拷60544 KB (OGCMX) с障≦宍с篏茖罧障
35.5670 +.LP
35.5671 +.SS
35.5672 +≪若 JVM ゃ潟鴻ャ<潟若激с潟h
35.5673 +.LP
35.5674 +.LP
35.5675 +箴\f3\-gcutil\fP 激с潟篏睡\f2remote.domain\fP 激鴻筝 \f2lvmid\fP 40496 ・膓泣潟腱篏х≧緇障
35.5676 +.LP
35.5677 +.nf
35.5678 +\f3
35.5679 +.fl
35.5680 +\fP\f3jstat \-gcutil 40496@remote.domain 1000\fP
35.5681 +.br
35.5682 +
35.5683 +.fl
35.5684 +... \f2output omitted\fP
35.5685 +.br
35.5686 +
35.5687 +.fl
35.5688 +.fi
35.5689 +
35.5690 +.LP
35.5691 +.LP
35.5692 +\f2lvmid\fP ≪若鴻腟\f240496@remote.domain\fP \f2vmid\fP 罕障腟 \f2vmid\fP \f3rmi\fP 潟篏睡≪若鴻筝 \f3jstatd\fP 泣若若篆<障\f3jstatd\fP 泣若若\f3rmiregistry\fP 篏睡 \f3rmiregistry\fP 若 (若 1099) ゃ潟 \f2remote.domain\fP 臀障
35.5693 +.LP
35.5694 +.RE
35.5695 +.SH "∫i"
35.5696 +.LP
35.5697 .RS 3
35.5698 .TP 2
35.5699 -*
35.5700 -.na
35.5701 -java \- Java アプリケーション起動ツール (Solaris) @
35.5702 -.fi
35.5703 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html
35.5704 +o
35.5705 +java(1) \- Java ≪宴若激с活儀若
35.5706 .TP 2
35.5707 -*
35.5708 -.na
35.5709 -java \- Java アプリケーション起動ツール(Linux) @
35.5710 -.fi
35.5711 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html
35.5712 +o
35.5713 +jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
35.5714 .TP 2
35.5715 -*
35.5716 -.na
35.5717 -java \- Java アプリケーション起動ツール (Windows) @
35.5718 -.fi
35.5719 -http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html
35.5720 +o
35.5721 +jstatd(1) \- 篁潟激 jstat 若≪潟
35.5722 +.TP 2
35.5723 +o
35.5724 +rmiregistry(1) \- Java ≪若吾с吾鴻
35.5725 .RE
35.5726 -.SS statOption と出力
35.5727 -次の表に、各
35.5728 -.I statOption
35.5729 -に対して
35.5730 -.B jstat
35.5731 -が出力する列の要約を示します。
35.5732 -.br
35.5733 -.SS
35.5734 -\-class オプション
35.5735 -.br
35.5736 -クラスローダ統計
35.5737 -.br
35.5738 +
35.5739 .LP
35.5740 -.sp 1n
35.5741 -.TS
35.5742 -box;
35.5743 -cbp-1 | cbp-1
35.5744 -l | l .
35.5745 -列 説明
35.5746 -_
35.5747 -Loaded ロードされたクラスの数
35.5748 -Bytes ロードされた K バイト数
35.5749 -Unloaded アンロードされたクラスの数
35.5750 -Bytes アンロードされた K バイト数
35.5751 -Time クラスのロードおよびアンロード操作の実行に要した時間
35.5752 -.TE
35.5753 -.SS
35.5754 -\-compiler
35.5755 -オプション
35.5756 -.br
35.5757 -HotSpot Just-In-Time コンパイラ統計
35.5758 -.br
35.5759 -.sp 1n
35.5760 -.TS
35.5761 -box;
35.5762 -cbp-1 | cbp-1
35.5763 -l | l .
35.5764 -列 説明
35.5765 -_
35.5766 -Compiled 実行されたコンパイルタスクの数
35.5767 -Failed 失敗したコンパイルタスクの数
35.5768 -Invalid 無効化されたコンパイルタスクの数
35.5769 -Time コンパイルタスクの実行に要した時間
35.5770 -FailedType 前回失敗したコンパイルのコンパイルタイプ
35.5771 -FailedMethod 前回失敗したコンパイルのクラス名とメソッド
35.5772 -.TE
35.5773 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-29
35.5774 -.SS
35.5775 -\-gc オプション
35.5776 -.br
35.5777 -ガベージコレクトされたヒープの統計
35.5778 -.br
35.5779 -.TS
35.5780 -box;
35.5781 -cbp-1 | cbp-1
35.5782 -l | l .
35.5783 -列 説明
35.5784 -_
35.5785 -SOC 現在のサバイバースペース 0 の容量 (K バイト)
35.5786 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
35.5787 -S0U サバイバースペース 0 の使用量 (K バイト)
35.5788 -S1U サバイバースペース 1 の使用量 (K バイト)
35.5789 -EC 現在のエデンスペースの容量 (K バイト)
35.5790 -EU エデンスペースの使用量 (K バイト)
35.5791 -OC 現在のオールドスペースの容量 (K バイト)
35.5792 -OU オールドスペースの使用量 (K バイト)
35.5793 -PC 現在の永続的スペースの容量 (K バイト)
35.5794 -PU 永続的スペースの使用量 (K バイト)
35.5795 -YGC 若い世代の GC イベントの数
35.5796 -YGCT 若い世代のガベージコレクション時間
35.5797 -FGC フル GC イベントの数
35.5798 -FGCT フルガベージコレクション時間
35.5799 -GCT ガベージコレクション合計時間
35.5800 -.TE
35.5801 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
35.5802 -.SS
35.5803 -\-gccapacity オプション
35.5804 -.br
35.5805 -メモリプール世代とスペース容量
35.5806 -.br
35.5807 -.TS
35.5808 -box;
35.5809 -cbp-1 | cbp-1
35.5810 -l | l .
35.5811 -列 説明
35.5812 -_
35.5813 -NGCMN 新世代の最小容量 (K バイト)
35.5814 -NGCMX 新世代の最大容量 (K バイト)
35.5815 -NGC 新世代の現在の容量 (K バイト)
35.5816 -S0C 現在のサバイバースペース 0 の容量 (K バイト)
35.5817 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
35.5818 -EC 現在のエデンスペースの容量 (K バイト)
35.5819 -OGCMN 旧世代の最小容量 (K バイト)
35.5820 -OGCMX 旧世代の最大容量 (K バイト)
35.5821 -OGC 旧世代の現在の容量 (K バイト)
35.5822 -OC 現在のオールドスペースの容量 (K バイト)
35.5823 -PGCMN 永続的世代の最小容量 (K バイト)
35.5824 -PGCMX 永続的世代の最大容量 (K バイト)
35.5825 -PGC 永続的世代の現在の容量 (K バイト)
35.5826 -PC 永続的スペースの現在の容量 (K バイト)
35.5827 -YGC 若い世代の GC イベントの数。
35.5828 -FGC フル GC イベントの数。
35.5829 -.TE
35.5830 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-67
35.5831 -.SS
35.5832 -\-gccause
35.5833 -オプション
35.5834 +
35.5835 .LP
35.5836 -このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。
35.5837 -.TS
35.5838 -box;
35.5839 -cbp-1 | cbp-1
35.5840 -l | l .
35.5841 -列 説明
35.5842 -_
35.5843 -LGCC 前回のガベージコレクションの原因
35.5844 -GCC 現在のガベージコレクションの原因
35.5845 -.TE
35.5846 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-13
35.5847 -.SS
35.5848 -\-gcnew オプション
35.5849 -.br
35.5850 -新世代統計
35.5851 -.br
35.5852 -.TS
35.5853 -box;
35.5854 -cbp-1 | cbp-1
35.5855 -l | l .
35.5856 -列 説明
35.5857 -_
35.5858 -SOC 現在のサバイバースペース 0 の容量 (K バイト)
35.5859 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
35.5860 -S0U サバイバースペース 0 の使用量 (K バイト)
35.5861 -S1U サバイバースペース 1 の使用量 (K バイト)
35.5862 -TT 保有しきい値
35.5863 -MTT 最大保有しきい値
35.5864 -DSS 目標サバイバーサイズ (K バイト)
35.5865 -EC 現在のエデンスペースの容量 (K バイト)
35.5866 -EU エデンスペースの使用量 (K バイト)
35.5867 -YGC 若い世代の GC イベントの数。
35.5868 -YGCT 若い世代のガベージコレクション時間。
35.5869 -.TE
35.5870 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
35.5871 -.SS
35.5872 -\-gcnewcapacity オプション
35.5873 -.br
35.5874 -新世代のスペースサイズ統計
35.5875 -.br
35.5876 -.TS
35.5877 -box;
35.5878 -cbp-1 | cbp-1
35.5879 -l | l .
35.5880 -列 説明
35.5881 -_
35.5882 -NGCMN 新世代の最小容量 (K バイト)
35.5883 -NGCMX 新世代の最大容量 (K バイト)
35.5884 -NGC 現在の新世代容量 (K バイト)
35.5885 -S0CMX サバイバースペース 0 の最大容量 (K バイト)
35.5886 -S0C 現在のサバイバースペース 0 の容量 (K バイト)
35.5887 -S1CMX サバイバースペース 1 の最大容量 (K バイト)
35.5888 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
35.5889 -ECMX エデンスペースの最大容量 (K バイト)
35.5890 -EC 現在のエデンスペースの容量 (K バイト)
35.5891 -YGC 若い世代の GC イベントの数
35.5892 -FGC フル GC イベントの数
35.5893 -.TE
35.5894 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
35.5895 -.SS
35.5896 -\-gcold オプション
35.5897 -.br
35.5898 -旧および永続世代統計
35.5899 -.br
35.5900 -.TS
35.5901 -box;
35.5902 -cbp-1 | cbp-1
35.5903 -l | l .
35.5904 -列 説明
35.5905 -_
35.5906 -PC 現在の永続スペースの容量 (K バイト)
35.5907 -PU 永続スペースの使用量 (K バイト)
35.5908 -OC 現在のオールドスペースの容量 (K バイト)
35.5909 -OU オールドスペースの使用量 (K バイト)
35.5910 -YGC 若い世代の GC イベントの数
35.5911 -FGC フル GC イベントの数
35.5912 -FGCT フルガベージコレクション時間
35.5913 -GCT ガベージコレクション合計時間
35.5914 -.TE
35.5915 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.5916 -.SS
35.5917 -\-gcoldcapacity オプション
35.5918 -.br
35.5919 -旧世代統計
35.5920 -.br
35.5921 -.TS
35.5922 -box;
35.5923 -cbp-1 | cbp-1
35.5924 -l | l .
35.5925 -列 説明
35.5926 -_
35.5927 -OGCMN 旧世代の最小容量 (K バイト)
35.5928 -OGCMV 旧世代の最大容量 (K バイト)
35.5929 -OGC 旧世代の現在の容量 (K バイト)
35.5930 -OC 現在のオールドスペースの容量 (K バイト)
35.5931 -YGC 若い世代の GC イベントの数
35.5932 -FGC フル GC イベントの数
35.5933 -FGCT フルガベージコレクション時間
35.5934 -GCT ガベージコレクション合計時間
35.5935 -.TE
35.5936 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.5937 -.SS
35.5938 -\-gcpermcapacity オプション
35.5939 -.br
35.5940 -永続世代統計
35.5941 -.br
35.5942 -.TS
35.5943 -box;
35.5944 -cbp-1 | cbp-1
35.5945 -l | l .
35.5946 -列 説明
35.5947 -_
35.5948 -PGCMN 永続世代の最小容量 (K バイト)
35.5949 -PGCMX 永続世代の最大容量 (K バイト)
35.5950 -PGC 永続世代の現在の容量 (K バイト)
35.5951 -PC 永続スペースの現在の容量 (K バイト)
35.5952 -YGC 若い世代の GC イベントの数
35.5953 -FGC フル GC イベントの数
35.5954 -FGCT フルガベージコレクション時間
35.5955 -GCT ガベージコレクション合計時間
35.5956 -.TE
35.5957 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
35.5958 -.SS
35.5959 -\-gcutil
35.5960 -オプション
35.5961 -.br
35.5962 -ガベージコレクション統計の要約
35.5963 -.br
35.5964 -.TS
35.5965 -box;
35.5966 -cbp-1 | cbp-1
35.5967 -l | l .
35.5968 -列 説明
35.5969 -_
35.5970 -S0 T{
35.5971 -サバイバースペース 0 の使用率 (スペースの現在の容量に対するパーセンテージ)
35.5972 -T}
35.5973 -S1 T{
35.5974 -サバイバースペース 1 の使用率 (スペースの現在の容量に対するパーセンテージ)
35.5975 -T}
35.5976 -E T{
35.5977 -エデンスペースの使用率 (スペースの現在の容量に対するパーセンテージ)
35.5978 -T}
35.5979 -O T{
35.5980 -オールドスペースの使用率 (スペースの現在の容量に対するパーセンテージ)
35.5981 -T}
35.5982 -P T{
35.5983 -永続スペースの使用率 (スペースの現在の容量に対するパーセンテージ)
35.5984 -T}
35.5985 -YGC 若い世代の GC イベントの数
35.5986 -YGCT 若い世代のガベージコレクション時間
35.5987 -FGC フル GC イベントの数
35.5988 -FGCT フルガベージコレクション時間
35.5989 -GCT ガベージコレクション合計時間
35.5990 -.TE
35.5991 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-43
35.5992 -.SS
35.5993 -\-printcompilation オプション
35.5994 -.br
35.5995 -HotSpot コンパイラメソッド統計
35.5996 -.br
35.5997 -.TS
35.5998 -box;
35.5999 -cbp-1 | cbp-1
35.6000 -l | l .
35.6001 -列 説明
35.6002 -_
35.6003 -Compiled 実行されたコンパイルタスクの数
35.6004 -Size メソッドのバイトコードのバイト数
35.6005 -Type コンパイルタイプ
35.6006 -Method T{
35.6007 -コンパイルされたメソッドを識別するクラス名とメソッド名。クラス名では、名前空間セパレータとして "." の代わりに "/" を使用します。メソッド名は、指定されたクラス内のメソッドです。この 2 つのフィールドの形式は、
35.6008 -"HotSpot \- XX:+PrintComplation"
35.6009 -オプションと同じです。
35.6010 -T}
35.6011 -.TE
35.6012 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
35.6013 -.SS
35.6014 -.SH
35.6015 -このセクションでは、lvmid が 21891 であるローカル JVM の監視例をいくつか示します。
35.6016 -.SS gcutil オプションの使用
35.6017 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔で 7 つのサンプルを採取し、
35.6018 -.B \-gcutil
35.6019 -オプションでの指定に従って出力を表示します。
35.6020 -.LP
35.6021 -.ft 3
35.6022 -.nf
35.6023 -jstat -gcutil 21891 250 7
35.6024 - S0 S1 E O P YGC YGCT FGC FGCT GCT
35.6025 - 12.44 0.00 27.20 9.49 96.70 78 0.176 5 0.495 0.672
35.6026 - 12.44 0.00 62.16 9.49 96.70 78 0.176 5 0.495 0.672
35.6027 - 12.44 0.00 83.97 9.49 96.70 78 0.176 5 0.495 0.672
35.6028 - 0.00 7.74 0.00 9.51 96.70 79 0.177 5 0.495 0.673
35.6029 - 0.00 7.74 23.37 9.51 96.70 79 0.177 5 0.495 0.673
35.6030 - 0.00 7.74 43.82 9.51 96.70 79 0.177 5 0.495 0.673
35.6031 - 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
35.6032 -.fi
35.6033 -.ft 1
35.6034 -.LP
35.6035 -この例の出力は、3 番目と 4 番目のサンプルの間に若い世代のコレクションが発生したことを示しています。コレクションの所要時間は 0.001 秒であり、オブジェクトがエデンスペース (E) からオールドスペース (O) に昇格されたため、オールドスペースの使用率が 9.49% から 9.51% に増加しています。コレクションの前のサバイバースペースの使用率は 12.44% でしたが、このコレクションの後の使用率は、わずか 7.74% です。
35.6036 -.SS 列見出し文字列の繰り返し
35.6037 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔でサンプルを採取し、
35.6038 -.B \-gcutil
35.6039 -オプションでの指定に従って出力を表示します。また、
35.6040 -.B \-h3
35.6041 -オプションを使用して、3 行のデータごとに列見出しを出力します。
35.6042 -.LP
35.6043 -.ft 3
35.6044 -.nf
35.6045 -jstat -gcnew -h3 21891 250
35.6046 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.6047 - 64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203
35.6048 - 64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203
35.6049 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204
35.6050 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.6051 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204
35.6052 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204
35.6053 - 64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204
35.6054 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
35.6055 - 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
35.6056 -.fi
35.6057 -.ft 1
35.6058 -.LP
35.6059 -見出し文字列の繰り返しを示しているほかに、この例は、2 番目と 3 番目のサンプルの間に若い世代の GC が発生したことを示しています。その所要時間は 0.001 秒でした。コレクションによって、サバイバースペース 0 の使用量 (S0U) が目標サバイバーサイズ (DSS) を超える十分なライブデータが見つかりました。結果として、オブジェクトは旧世代に昇格され (この出力には示されていない)、保有しきい値 (TT) が 31 から 2 に下がっています。
35.6060 -.LP
35.6061 -5 番目と 6 番目のサンプルの間にもう 1 つのコレクションが発生しています。このコレクションでは、ごくわずかのサバイバーが見つかり、保有しきい値が 31 に戻っています。
35.6062 -.SS 各サンプルのタイムスタンプの表示
35.6063 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔で 3 つのサンプルを採取します。
35.6064 -.B \-t
35.6065 -オプションを使用して、最初の列に各サンプルのタイムスタンプを生成します。
35.6066 -.LP
35.6067 -.ft 3
35.6068 -.nf
35.6069 -jstat \-gcoldcapacity \-t 21891 250 3
35.6070 -Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT
35.6071 -150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799
35.6072 -150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
35.6073 -150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
35.6074 -.br
35.6075 -.fi
35.6076 -.LP
35.6077 -\f2Timestamp\fP 列には、ターゲット JVM の起動時からの経過時間が、秒単位でレポートされています。さらに、\f3\-gcoldcapacity\fP 出力では、割り当て要求または昇格要求あるいはその両方を満たすためにヒープが拡張するごとに、Old 世代の容量 (OGC) と Old 領域の容量 (OC) とが増加していることがわかります。Old 世代の容量 (OGC) は、81 番目のフル GC (FGC) 後に、11696 KB から 13820 KB へ増加しています。Old 世代 (および領域) の最大容量は、60544 KB (OGCMX) なので、まだ拡張できる余裕が残されています。
35.6078 -.SS
35.6079 -リモート JVM のインストゥルメンテーションの監視
35.6080 -.LP
35.6081 -この例は、\f3\-gcutil\fP オプションを使用して、\f2remote.domain\fP というシステム上の \f2lvmid\fP 40496 に接続し、サンプルを秒単位で無期限に取得しています。
35.6082 -.nf
35.6083 -\f3jstat \-gcutil 40496@remote.domain 1000\fP
35.6084 -.br
35.6085 -
35.6086 -.fl
35.6087 -... \f2出力省略\fP
35.6088 -.br
35.6089 -.fi
35.6090 -.LP
35.6091 -\f2lvmid\fP は、リモートホストの名前と結合されて、\f240496@remote.domain\fP の \f2vmid\fP を構成しています。結果として、この \f2vmid\fP は、\f3rmi\fP プロトコルを使用して、リモートホスト上のデフォルトの \f3jstatd\fP サーバと通信します。\f3jstatd\fP サーバは、\f3rmiregistry\fP を使用して、デフォルトの \f3rmiregistry\fP ポート (ポート 1099) にバインドされた \f2remote.domain\fP に配置されれます。
35.6092 -.SH 関連項目
35.6093 -.RS 3
35.6094 -.TP 2
35.6095 -*
35.6096 -java \- Java アプリケーション起動ツール
35.6097 -.TP 2
35.6098 -*
35.6099 -jps \- Java プロセスステータスツール
35.6100 -.TP 2
35.6101 -*
35.6102 -jstatd \- jvmstat デーモン
35.6103 -.TP 2
35.6104 -*
35.6105 -rmiregistry \- Java リモートオブジェクトレジストリ
35.6106 -.RE
35.6107
36.1 --- a/src/linux/doc/man/ja/jstatd.1 Tue May 12 15:21:55 2009 +0900
36.2 +++ b/src/linux/doc/man/ja/jstatd.1 Thu May 14 00:17:25 2009 -0700
36.3 @@ -1,248 +1,300 @@
36.4 -'\" t
36.5 -.\"
36.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
36.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
36.8 -.\"
36.9 -.\" This code is free software; you can redistribute it and/or modify it
36.10 -.\" under the terms of the GNU General Public License version 2 only, as
36.11 -.\" published by the Free Software Foundation.
36.12 -.\"
36.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
36.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
36.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
36.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
36.17 -.\" accompanied this code).
36.18 -.\"
36.19 -.\" You should have received a copy of the GNU General Public License version
36.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
36.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
36.22 -.\"
36.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
36.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
36.25 -.\" have any questions.
36.26 -.\"
36.27 -.\"
36.28 -.TH jstatd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
36.29 -.SH 名前
36.30 -jstatd \- 仮想マシン jstat デーモン
36.31 -.\"
36.32 -.SH 形式
36.33 -.B jstatd
36.34 -.BI [ options ]
36.35 -.SH パラメータ
36.36 -.if t .TP 20
36.37 -.if n .TP 15
36.38 -.BI options
36.39 -コマンド行オプション。オプションは任意の順序で指定できます。冗長または矛盾するオプションがあった場合は、最後に指定されたオプションが優先されます。
36.40 -.SH 機能説明
36.41 -.B jstatd
36.42 -ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) の作成と終了を監視する RMI サーバーアプリケーションであり、リモート監視ツールがローカルホスト上で実行している JVM にアタッチするためのインタフェースを備えています。
36.43 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
36.44 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
36.45 +."
36.46 +." This code is free software; you can redistribute it and/or modify it
36.47 +." under the terms of the GNU General Public License version 2 only, as
36.48 +." published by the Free Software Foundation.
36.49 +."
36.50 +." This code is distributed in the hope that it will be useful, but WITHOUT
36.51 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
36.52 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
36.53 +." version 2 for more details (a copy is included in the LICENSE file that
36.54 +." accompanied this code).
36.55 +."
36.56 +." You should have received a copy of the GNU General Public License version
36.57 +." 2 along with this work; if not, write to the Free Software Foundation,
36.58 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
36.59 +."
36.60 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
36.61 +." CA 95054 USA or visit www.sun.com if you need additional information or
36.62 +." have any questions.
36.63 +."
36.64 +.TH jstatd 1 "04 May 2009"
36.65 +." Generated from HTML by html2man (author: Eric Armstrong)
36.66 +
36.67 .LP
36.68 -jstatd サーバーが機能するためには、ローカルホスト上に RMI レジストリが存在する必要があります。jstatd サーバーは、デフォルトポートまたは
36.69 -.BI \-p " port"
36.70 -オプションによって示されたポート上の RMI レジストリへのアタッチを試みます。RMI レジストリが見つからなかった場合は、
36.71 -.BI \-p " port"
36.72 -オプションによって示されたポートにバインドされた jstatd アプリケーション内で作成され、
36.73 -.BI \-p " port"
36.74 -が省かれた場合はデフォルトの RMI レジストリにバインドされた jstatd アプリケーション内で作成されます。内部 RMI レジストリの作成は、
36.75 -.B \-nr
36.76 -オプションを指定することによって禁止できます。
36.77 -.LP
36.78 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
36.79 -.SH オプション
36.80 -.B jstatd
36.81 -コマンドは、以下のオプションをサポートします。
36.82 -.if t .TP 20
36.83 -.if n .TP 15
36.84 -.BI \-nr
36.85 -既存の RMI レジストリが見つからないときに、
36.86 -.B jstatd
36.87 -プロセス内での内部 RMI レジストリの作成を試みません。
36.88 -.if t .TP 20
36.89 -.if n .TP 15
36.90 -.BI \-p " port"
36.91 -RMI レジストリを探すポート番号。または、RMI レジストリが見つからず、
36.92 -.B \-nr
36.93 -が指定されなかった場合に、RMI レジストリが作成されるポート番号。
36.94 -.if t .TP 20
36.95 -.if n .TP 15
36.96 -.BI \-n " rminame"
36.97 -RMI レジストリでリモート RMI オブジェクトがバインドされる名前。デフォルトの名前は、JStatRemoteHost です。同じホスト上で複数の
36.98 -.B jstatd
36.99 -サーバーが起動している場合、各サーバーのエクスポート RMI オブジェクトの名前を一意にするには、このオプションを指定します。ただし、そのためには、監視クライアントの hostid および vmid 文字列に一意のサーバー名が含まれている必要があります。
36.100 -.if t .TP 20
36.101 -.if n .TP 15
36.102 -.BI \-J option
36.103 -.I option
36.104 -を
36.105 -.B javac
36.106 -によって呼び出された java 起動ツールに渡します。たとえば、
36.107 -.B \-J-Xms48m
36.108 -は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、
36.109 -.B \-J
36.110 -の一般的規則です。
36.111 -.SH セキュリティ
36.112 -
36.113 -.B jstatd
36.114 -サーバーは、適切なネイティブアクセス権を持っている JVM だけを監視できます。
36.115 -このため、jstatd プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。
36.116 -UNIX(TM) ベースのシステムの root ユーザーなど、一部のユーザー資格には、
36.117 -そのシステム上の任意の JVM によってエクスポートされた計測機構への
36.118 -アクセス権が割り当てられています。
36.119 -このような資格で実行中の jstatd プロセスは、そのシステム上の任意の JVM を監視できますが、
36.120 -これに伴うセキュリティ上の問題も考慮する必要があります。
36.121 -.LP
36.122 -jstatd サーバーは、リモートクライアントの認証は行いません。
36.123 -つまり、jstatd サーバープロセスを実行すると、
36.124 -jstatd プロセスがアクセス権を持つすべての JVM から
36.125 -エクスポートされる計測機構が、ネットワーク上の任意のユーザーに公開されます。
36.126 -計測機構が公開されると、環境によっては望ましくない場合があります。
36.127 -特に運用環境や安全性の低いネットワークでは、
36.128 -jstatd プロセスを開始する前に
36.129 -ローカルセキュリティポリシーを検討する必要があります。
36.130 -.LP
36.131 -.B jstatd
36.132 -サーバーは、他にセキュリティマネージャがインストールされていない場合は、RMISecurityPolicy のインスタンスをインストールするので、セキュリティポリシーファイルを指定する必要があります。
36.133 -ポリシーファイルは、デフォルトのポリシー実装のポリシーファイル構文
36.134 -.fi
36.135 - (http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html)
36.136 -に従う必要があります。
36.137 -.LP
36.138 -次のポリシーファイルでは、
36.139 -.B jstatd
36.140 -サーバーはセキュリティ例外を起こさずに実行できます。このポリシーは、
36.141 -すべてのコードベースへのすべてのアクセス権を許可するよりは自由度が低いですが、
36.142 -.B jstatd
36.143 -サーバーの実行に必要な最小限度のアクセス権を許可するポリシーよりは自由度が高いです。
36.144 -.LP
36.145 -.RS
36.146 -.ft 3
36.147 -.nf
36.148 -grant codebase "file:${java.home}/../lib/tools.jar" {
36.149 - permission java.security.AllPermission;
36.150 -};
36.151 -.fi
36.152 -.ft 1
36.153 -.RE
36.154 -.LP
36.155 -このポリシーを使用するには、テキストを jstatd.all.policy という名前のファイルにコピーしたあと、次のようにして
36.156 -.B jstatd
36.157 -サーバーを実行します。
36.158 -.LP
36.159 -.RS
36.160 -.ft 3
36.161 -.nf
36.162 -jstatd -J-Djava.security.policy=jstatd.all.policy
36.163 -.fi
36.164 -.ft 1
36.165 -.RE
36.166 -.LP
36.167 -より厳格なセキュリティを採用しているサイトでは、
36.168 -カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークに
36.169 -アクセスを制限できます。ただし、この方法を使用しても、
36.170 -IP アドレスのスプーフィング攻撃にさらされます。
36.171 -カスタムポリシーファイルを使用することでセキュリティの問題に対応できない場合には、
36.172 -jstatd サーバーを実行せずに、
36.173 -jstat および jps ツールをローカルで使用するのが最も安全です。
36.174 -.SH リモートインタフェース
36.175 -.B jstatd
36.176 -プロセスによってエクスポートされるインタフェースはプロプライエタリであり、変更が保証されています。ユーザーおよび開発者は、このインタフェースに書き込まないようにしてください。
36.177 -.SH 使用例
36.178 -.B jstatd
36.179 -の起動例をいくつか示します。これらの
36.180 -.B jstatd
36.181 -スクリプトは、バックグラウンドで自動的にサーバーを起動します。
36.182 -.SS 内部 RMI レジストリの使用
36.183 -この例は、内部 RMI レジストリを使用した
36.184 -.B jstatd
36.185 -の起動を示しています。この例では、他のサーバーがデフォルトの RMI レジストリポート (ポート 1099) にバインドされていないことを前提としています。
36.186 -.LP
36.187 -.RS
36.188 -.ft 3
36.189 -.nf
36.190 -jstatd -J-Djava.security.policy=all.policy
36.191 -.fi
36.192 -.ft 1
36.193 -.RE
36.194 -.SS 外部 RMI レジストリの使用
36.195 -この例は、外部 RMI レジストリを使用した
36.196 -.B jstatd
36.197 -の起動を示しています。
36.198 -.LP
36.199 -.RS
36.200 -.ft 3
36.201 -.nf
36.202 -rmiregistry&
36.203 -jstatd -J-Djava.security.policy=all.policy
36.204 -.fi
36.205 -.ft 1
36.206 -.RE
36.207 -.LP
36.208 -この例は、ポート 2020 上の外部 RMI レジストリサーバーを使用した
36.209 -.B jstatd
36.210 -の起動を示しています。
36.211 -.LP
36.212 -.RS
36.213 -.ft 3
36.214 -.nf
36.215 -rmiregistry 2020&
36.216 -jstatd -J-Djava.security.policy=all.policy -p 2020
36.217 -.fi
36.218 -.ft 1
36.219 -.RE
36.220 -.LP
36.221 -この例は、ポート 2020 上の、AlternateJstatdServerName という名前にバインドされた外部 RMI レジストリを使用した
36.222 -.B jstatd
36.223 -の起動を示しています。
36.224 -.LP
36.225 -.RS
36.226 -.ft 3
36.227 -.nf
36.228 -rmiregistry 2020&
36.229 -jstatd -J-Djava.security.policy=all.policy -p 2020 -n AlternateJstatdServerName
36.230 -.fi
36.231 -.ft 1
36.232 -.RE
36.233 -.SS プロセス内 RMI レジストリの作成の禁止
36.234 -この例は、RMI レジストリが見つからない場合も RMI レジストリを作成しないように
36.235 -.B jstatd
36.236 -を起動する例を示しています。この例では、RMI がすでに実行していることを前提としています。実行していなかった場合は、適切なエラーメッセージが表示されます。
36.237 -.LP
36.238 -.RS
36.239 -.ft 3
36.240 -.nf
36.241 -jstatd -J-Djava.security.policy=all.policy -nr
36.242 -.fi
36.243 -.ft 1
36.244 -.RE
36.245 -.SS RMI ロギング機能の有効化
36.246 -この例は、RMI ロギング機能を有効にして
36.247 -.B jstatd
36.248 -を起動する例を示しています。この方法は、障害追跡やサーバー活動の監視に役立ちます。
36.249 -.LP
36.250 -.RS
36.251 -.ft 3
36.252 -.nf
36.253 -jstatd -J-Djava.security.policy=all.policy -J-Djava.rmi.server.logCalls=true
36.254 -.fi
36.255 -.ft 1
36.256 -.RE
36.257 -.LP
36.258 -.SH 関連項目
36.259 +.SH ""
36.260 +jstatd \- 篁潟激 jstat 若≪
36.261 .LP
36.262 .RS 3
36.263 .TP 2
36.264 -*
36.265 -java \- Java アプリケーション起動プログラム
36.266 +o
36.267 +綵√
36.268 .TP 2
36.269 -*
36.270 -jps \- Java 仮想マシンプロセスステータスツール
36.271 +o
36.272 +<若
36.273 .TP 2
36.274 -*
36.275 -jstat \- Java 仮想マシン統計監視ツール
36.276 +o
36.277 +茯
36.278 .TP 2
36.279 -*
36.280 -rmiregistry \- Java リモートオブジェクトレジストリ
36.281 +o
36.282 +激с
36.283 +.TP 2
36.284 +o
36.285 +祉ャc
36.286 +.TP 2
36.287 +o
36.288 +≪若ゃ潟帥с若
36.289 +.TP 2
36.290 +o
36.291 +箴
36.292 +.TP 2
36.293 +o
36.294 +∫i
36.295 +.RE
36.296 +
36.297 +.LP
36.298 +.SH "綵√"
36.299 +.LP
36.300 +
36.301 +.LP
36.302 +.nf
36.303 +\f3
36.304 +.fl
36.305 +jstatd [ \fP\f4options\fP\f3 ]\fP
36.306 +.br
36.307 +\f3
36.308 +.fl
36.309 +\fP
36.310 +.fi
36.311 +
36.312 +.LP
36.313 +.SH "<若"
36.314 +.LP
36.315 +
36.316 +.LP
36.317 +.RS 3
36.318 +.TP 3
36.319 +options
36.320 +潟潟茵激с潟激с潟篁紙綺ф絎с障茲障障激с潟翫緇絎激с潟障
36.321 +.RE
36.322 +
36.323 +.LP
36.324 +.SH " 茯"
36.325 +.LP
36.326 +
36.327 +.LP
36.328 +.LP
36.329 +\f3jstatd\fP 若荐羝 HotSpot Java 篁潟激 (JVM) 篏腟篋h若激鴻筝у茵 Java 篁潟激潟≪若h若・膓сゃ潟帥с若鴻箴 RMI 泣若若≪宴若激с潟с
36.330 +.LP
36.331 +.LP
36.332 +\f3jstatd\fP 泣若若с若鴻 RMI 吾鴻絖綽荀障\f3jstatd\fP 泣若若若障 \f2\-p port\fP 激с潟ф絎若筝 RMI 吾鴻・膓障RMI 吾鴻荀ゃ翫\f2\-p port\fP 激с潟ф絎若障 \f2\-p port\fP ャ翫 RMI 吾鴻ゃ潟 \f3jstatd\fP ≪宴若激с喝1 ゃ RMI 吾鴻篏障 RMI 吾鴻篏\f2\-nr\fP 激с潟絎c胼罩≪с障
36.333 +.LP
36.334 +.LP
36.335 +\f3羈:\fP 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
36.336 +.LP
36.337 +.SH "激с"
36.338 +.LP
36.339 +
36.340 +.LP
36.341 +.LP
36.342 +\f3jstatd\fP 潟潟罨<激с潟泣若障
36.343 +.LP
36.344 +.RS 3
36.345 +.TP 3
36.346 +\-nr
36.347 +√ RMI 吾鴻荀ゃ翫\f2jstatd\fP 祉劫 RMI 吾鴻篏障
36.348 +.TP 3
36.349 +\-p\ port
36.350 +RMI 吾鴻篋潟若垩с 荀ゃ翫\f2\-nr\fP 絎遺障
36.351 +.TP 3
36.352 +\-n\ rminame
36.353 +RMI 吾鴻≪若 RMI 吾сゃ潟с \f2JStatRemoteHost\fP с茲違 \f3jstatd\fP 泣若若鴻筝ц儀翫泣若若鴻若 RMI 吾с激с潟絎c筝с障激с潟篏睡翫hゃ≪潟 \f2hostid\fP \f2vmid\fP 絖筝泣若弱綽荀障
36.354 +.TP 3
36.355 +\-Joption
36.356 +\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
36.357 +.RE
36.358 +
36.359 +.LP
36.360 +.SH "祉ャc"
36.361 +.LP
36.362 +
36.363 +.LP
36.364 +.LP
36.365 +\f3jstatd\fP 泣若若鴻ゃc≪祉号┤ JVM hс障c\f3jstatd\fP 祉鴻帥若蚊 JVM 若吟取若у茵綽荀障筝若吟取若Unix(TM) 若鴻激鴻 \f2root\fP 若吟若激鴻筝篁紙 JVM c鴻若ゃ潟鴻ャ<潟若激с潟吾≪祉号┤c障莖若у茵 \f3jstatd\fP 祉鴻激鴻筝鴻 JVM hс障祉ャc寂ャ馹莎激障
36.366 +.LP
36.367 +.LP
36.368 +\f3jstatd\fP 泣若若≪若ゃ≪潟茯荐若筝筝障\f3jstatd\fP 泣若若祉鴻絎茵\f3jstatd\fP 祉鴻≪祉号┤ゃ鴻 JVM ゃ潟鴻ャ<潟若激с潟鴻若若筝鴻若吟若障♂峨倶医障翫障 鴻絎腮弱医障絎с若с\f3jstatd\fP 祉鴻莎桁若祉ャc若激若罎荐綽荀障
36.369 +.LP
36.370 +.LP
36.371 +\f3jstatd\fP 泣若若篁祉ャc若若吾c若ゃ潟鴻若翫RMISecurityPolicy ゃ潟鴻帥潟鴻ゃ潟鴻若障 祉ャc若激若<ゃ絎綽荀障激若<ゃ激弱茖
36.372 +.na
36.373 +\f2激若<ゃ罕\fP @
36.374 +.fi
36.375 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html羣綽荀障
36.376 +.LP
36.377 +.LP
36.378 +罨<激若<ゃ翫\f3jstatd\fP 泣若若筝祉ャc寂紊篏睡絎茵с障激若鴻潟若若鴻吾≪祉号┤茯激若怨墾篏с\f3jstatd\fP 泣若若絎茵篏綽荀≪祉号┤茯激若怨墾蕭c障
36.379 +.LP
36.380 +.nf
36.381 +\f3
36.382 +.fl
36.383 +grant codebase "file:${java.home}/../lib/tools.jar" {\fP
36.384 +.br
36.385 +\f3
36.386 +.fl
36.387 + permission java.security.AllPermission;\fP
36.388 +.br
36.389 +\f3
36.390 +.fl
36.391 +};\fP
36.392 +.br
36.393 +\f3
36.394 +.fl
36.395 +\fP
36.396 +.fi
36.397 +
36.398 +.LP
36.399 +.LP
36.400 +激若篏睡鴻 \f2jstatd.all.policy\fP <ゃ潟若罨< \f3jstatd\fP 泣若若絎茵障
36.401 +.LP
36.402 +.nf
36.403 +\f3
36.404 +.fl
36.405 +jstatd \-J\-Djava.security.policy=jstatd.all.policy\fP
36.406 +.br
36.407 +\f3
36.408 +.fl
36.409 +\fP
36.410 +.fi
36.411 +
36.412 +.LP
36.413 +.LP
36.414 +ウ祉ャc若絎純泣ゃ翫鴻帥激若<ゃ篏睡劫篆♂若с鴻障若≪祉鴻狗с障 号IP ≪鴻贋紙障祉ャc若馹ゃ鴻帥ゃ冴激若<ゃс絲上с翫\f3jstatd\fP 泣若若絎茵\f3jstat\fP \f3jps\fP 若若т戎c絎号障
36.415 +.LP
36.416 +.SH "≪若ゃ潟帥с若"
36.417 +.LP
36.418 +
36.419 +.LP
36.420 +.LP
36.421 +\f3jstatd\fP 祉鴻鴻若ゃ潟帥с若鴻冴с紊眼篋絎с若吟若渇肴ゃ潟帥с若鴻吾吾莨若帥茵с
36.422 +.LP
36.423 +.SH "箴"
36.424 +.LP
36.425 +
36.426 +.LP
36.427 +.LP
36.428 +罨< \f3jstatd\fP 莎桁箴膣剛障\f3jstatd\fP 鴻c泣若若違潟ц莎桁障
36.429 +.LP
36.430 +.SS
36.431 + RMI 吾鴻篏睡
36.432 +.LP
36.433 +.LP
36.434 +箴 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障箴с RMI 吾鴻若 (若 1099) 篁泣若若ゃ潟喝障
36.435 +.LP
36.436 +.nf
36.437 +\f3
36.438 +.fl
36.439 +jstatd \-J\-Djava.security.policy=all.policy
36.440 +.fl
36.441 +\fP
36.442 +.fi
36.443 +
36.444 +.LP
36.445 +.SS
36.446 +紊 RMI 吾鴻篏睡
36.447 +.LP
36.448 +.LP
36.449 +箴紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
36.450 +.LP
36.451 +.nf
36.452 +\f3
36.453 +.fl
36.454 +rmiregistry&
36.455 +.fl
36.456 +jstatd \-J\-Djava.security.policy=all.policy
36.457 +.fl
36.458 +\fP
36.459 +.fi
36.460 +
36.461 +.LP
36.462 +.LP
36.463 +箴若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
36.464 +.LP
36.465 +.nf
36.466 +\f3
36.467 +.fl
36.468 +rmiregistry 2020&
36.469 +.fl
36.470 +jstatd \-J\-Djava.security.policy=all.policy \-p 2020
36.471 +.fl
36.472 +\fP
36.473 +.fi
36.474 +
36.475 +.LP
36.476 +.LP
36.477 +箴AlternateJstatdServerName ゃ潟若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
36.478 +.LP
36.479 +.nf
36.480 +\f3
36.481 +.fl
36.482 +rmiregistry 2020&
36.483 +.fl
36.484 +jstatd \-J\-Djava.security.policy=all.policy \-p 2020 \-n AlternateJstatdServerName
36.485 +.fl
36.486 +\fP
36.487 +.fi
36.488 +
36.489 +.LP
36.490 +.SS
36.491 +ゃ潟祉 RMI 吾鴻篏胼罩
36.492 +.LP
36.493 +.LP
36.494 +箴RMI 吾鴻荀ゃ翫 RMI 吾鴻篏 \f3jstatd\fP 莎桁茵障箴сRMI 吾鴻с絎茵喝障絎茵翫荅峨若<祉若吾茵腓冴障
36.495 +.LP
36.496 +.nf
36.497 +\f3
36.498 +.fl
36.499 +jstatd \-J\-Djava.security.policy=all.policy \-nr
36.500 +.fl
36.501 +\fP
36.502 +.fi
36.503 +
36.504 +.LP
36.505 +.SS
36.506 +RMI 井純劫
36.507 +.LP
36.508 +.LP
36.509 +箴RMI 井純鴻 \f3jstatd\fP 莎桁茵障号激ャ若c潟違障泣若惹柑h綵合<障
36.510 +.LP
36.511 +.nf
36.512 +\f3
36.513 +.fl
36.514 +jstatd \-J\-Djava.security.policy=all.policy \-J\-Djava.rmi.server.logCalls=true
36.515 +.fl
36.516 +\fP
36.517 +.fi
36.518 +
36.519 +.LP
36.520 +.SH "∫i"
36.521 +.LP
36.522 +.RS 3
36.523 +.TP 2
36.524 +o
36.525 +java(1) \- Java ≪宴若激с活儀若
36.526 +.TP 2
36.527 +o
36.528 +jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
36.529 +.TP 2
36.530 +o
36.531 +jstat(1) \- Java 篁潟激括輝荐若睡h若
36.532 +.TP 2
36.533 +o
36.534 +
36.535 +.na
36.536 +\f2rmiregistry\fP @
36.537 +.fi
36.538 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java ≪若吾с吾鴻
36.539 .RE
36.540
36.541 .LP
37.1 --- a/src/linux/doc/man/ja/keytool.1 Tue May 12 15:21:55 2009 +0900
37.2 +++ b/src/linux/doc/man/ja/keytool.1 Thu May 14 00:17:25 2009 -0700
37.3 @@ -1,6 +1,4 @@
37.4 -.'" t
37.5 -."
37.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
37.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
37.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
37.9 ."
37.10 ." This code is free software; you can redistribute it and/or modify it
37.11 @@ -21,20 +19,19 @@
37.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
37.13 ." have any questions.
37.14 ."
37.15 -." `
37.16 -.TH keytool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
37.17 -." Generated by html2man
37.18 +.TH keytool 1 "04 May 2009"
37.19 +." Generated from HTML by html2man (author: Eric Armstrong)
37.20
37.21 .LP
37.22 -.SH 名前
37.23 -keytool \- 鍵と証明書の管理ツール
37.24 +.SH ""
37.25 +keytool \- 泣荐惹吾膊∞若
37.26 .LP
37.27 .RS 3
37.28
37.29 .LP
37.30 -暗号化鍵、X.509 証明連鎖、および信頼できる証明書を含むキーストア (データベース) を管理します。
37.31 +垸泣X.509 荐惹吾с若潟割拭若с荐惹吾若鴻 (若帥若) 膊∞障
37.32 .RE
37.33 -.SH "形式"
37.34 +.SH "綵√"
37.35 .LP
37.36
37.37 .LP
37.38 @@ -47,48 +44,48 @@
37.39
37.40 .LP
37.41 .LP
37.42 -Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。
37.43 +Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障 荅括完ゃ紊雁鴻膀с篁ュ絎臂潟潟綣膓泣若障
37.44 .LP
37.45 -.SH "説明"
37.46 +.SH "茯"
37.47 .LP
37.48
37.49 .LP
37.50 -\f3keytool\fP は、鍵と証明書を管理するためのユーティリティです。\f3keytool\fP を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザまたはサービスに対して自分自身を認証すること) や、データの完全性と証明書に関するサービスを利用することができます。\f3keytool\fP では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。
37.51 +\f3keytool\fP 泣荐惹吾膊∞若cc若сkeytool 篏帥泣泣≪渇∫c荐惹吾膊∞吾帥臀峨篏帥c綏沿荐 (祉若吟若障泣若鴻絲障荳茯荐若) 若帥翫с荐惹吾≪泣若鴻с障keytool с篆∞御泣 (荐惹吾綵≪) c激ャс障
37.52 .LP
37.53 -「証明書」とは、あるエンティティ (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの完全性およびデータが本物であることをチェックできます。データの「完全性」とは、データが変更されたり、改変されたりしていないことを意味します。また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。
37.54 +荐惹吾潟cc (篋榊篌腓障) 吾帥臀峨篁吾с 荐惹吾祉潟cc若 (潟篁) 劫ャゃc吾障(荐惹吾)若帥吾帥臀峨篁翫吾帥臀峨罎荐若с若帥翫с潟若帥ссс障若帥翫с若帥紊眼劫潟障 障若帥с若帥若帥篏臀峨腱違篋榊絎羝<若帥с潟障
37.55 .LP
37.56 .LP
37.57 -また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。
37.58 +障\f3keytool\fP 篏帥違DES 絲丞О垸/緇垸т戎腱絲泣膊∞с障
37.59 .LP
37.60 .LP
37.61 -\f3keytool\fP は、鍵と証明書をキーストアに格納します。
37.62 +\f3keytool\fP 泣荐惹吾\f2若鴻≪\fP主障
37.63 .LP
37.64 -.SH "コマンドとオプションに関する注意"
37.65 +.SH "潟潟激с潟≪羈"
37.66 .LP
37.67
37.68 .LP
37.69 .LP
37.70 -以下では、コマンドとそのオプションについて説明します。次の点に注意してください。
37.71 +篁ヤс潟潟激с潟ゃ茯障羈:
37.72 .LP
37.73 .RS 3
37.74 .TP 2
37.75 o
37.76 -どのコマンド名およびオプション名にも先頭にマイナス記号 (\-) が付く
37.77 +潟潟潟激с喝ゃ壕 (\-) 篁
37.78 .TP 2
37.79 o
37.80 -各コマンドのオプションは任意の順序で指定できる
37.81 +潟潟激с潟篁紙綺ф絎с
37.82 .TP 2
37.83 o
37.84 -イタリック体になっていないすべての項目、または中括弧か角括弧で囲まれているすべての項目は、そのとおりに指定する必要がある
37.85 +ゃ帥篏c鴻障筝綣с茹綣су蚊障鴻絎綽荀
37.86 .TP 2
37.87 o
37.88 -オプションを囲む中括弧は、一般に、そのオプションをコマンド行で指定しなかった場合に、既定値が使われることを意味する。中括弧は、\f2\-v\fP、\f2\-rfc\fP、および \f2\-J\fP オプションを囲むのにも使われるが、これらのオプションはコマンド行で指定された場合にのみ意味を持つ (つまり、これらのオプションには、オプション自体を指定しないこと以外に「既定値」は存在しない)
37.89 +激с潟蚊筝綣с筝激с潟潟潟茵ф絎c翫ゃ篏帥潟筝綣с\f2\-v\fP\f2\-rfc\fP \f2\-J\fP 激с潟蚊篏帥激с潟潟潟茵ф絎翫炊潟 (ゃ障激с潟激с活篏絎篁ュゃ絖)
37.90 .TP 2
37.91 o
37.92 -オプションを囲む角括弧は、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味する。ただし、\f2\-keypass\fP オプションをコマンド行で指定しなかった場合は、\f3keytool\fP がキーストアのパスワードから非公開/秘密鍵の復元を試みる。ユーザは、この試みが失敗した場合に非公開/秘密鍵パスワードの入力を求められる
37.93 +激с潟蚊茹綣с激с潟潟潟茵ф絎c翫ゃュ羆潟\f2\-keypass\fP 激с潟潟潟茵ф絎c翫\f3keytool\fP 若鴻≪鴻若/腱絲泣緇荅帥 若吟若荅帥紊掩翫/腱絲泣ュ羆
37.94 .TP 2
37.95 o
37.96 -イタリック体の項目の実際の値 (オプションの値) は、ユーザが指定する必要がある。たとえば、\f2\-printcert\fP コマンドの形式は次のとおりである
37.97 +ゃ帥篏絎 (激с潟) 若吟若絎綽荀違\f2\-printcert\fP 潟潟綵√罨<с
37.98 .nf
37.99 \f3
37.100 .fl
37.101 @@ -97,7 +94,7 @@
37.102 \fP
37.103 .fi
37.104 .LP
37.105 -\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。 次に例を示す
37.106 +\f2\-printcert\fP 潟潟絎\f2cert_file\fP 篁c絎<ゃ絎罨<箴腓冴
37.107 .nf
37.108 \f3
37.109 .fl
37.110 @@ -107,10 +104,10 @@
37.111 .fi
37.112 .TP 2
37.113 o
37.114 -オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある
37.115 +激с潟ゃ腥榊 (鴻若) 障翫ゃ綣膃у蚊綽荀
37.116 .TP 2
37.117 o
37.118 -\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする
37.119 +\f2\-help\fP 潟潟潟潟с違罨<潟潟茵絎
37.120 .nf
37.121 \f3
37.122 .fl
37.123 @@ -118,7 +115,7 @@
37.124 .fl
37.125 \fP
37.126 .fi
37.127 -これは、次のように指定することと同じである
37.128 +罨<絎с
37.129 .nf
37.130 \f3
37.131 .fl
37.132 @@ -130,12 +127,12 @@
37.133
37.134 .LP
37.135 .SS
37.136 -オプションの既定値
37.137 +激с潟
37.138 .LP
37.139 .RS 3
37.140
37.141 .LP
37.142 -オプションの既定値は、次のとおりです。
37.143 +激с潟ゃ罨<с
37.144 .nf
37.145 \f3
37.146 .fl
37.147 @@ -145,19 +142,19 @@
37.148 .fl
37.149 \-keyalg
37.150 .fl
37.151 - "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合)
37.152 + "DSA" (\fP\f3\-genkeypair\fP\f3 篏睡翫)
37.153 .fl
37.154 - "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合)
37.155 + "DES" (\fP\f3\-genseckey\fP\f3 篏睡翫)
37.156 .fl
37.157
37.158 .fl
37.159 \-keysize
37.160 .fl
37.161 - 1024 (\fP\f3\-genkeypair\fP\f3 を使用している場合)
37.162 + 1024 (\fP\f3\-genkeypair\fP\f3 篏睡翫)
37.163 .fl
37.164 - 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合)
37.165 + 56 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DES" 翫)
37.166 .fl
37.167 - 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合)
37.168 + 168 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DESede" 翫)
37.169 .fl
37.170
37.171 .fl
37.172 @@ -165,15 +162,17 @@
37.173 .fl
37.174
37.175 .fl
37.176 -\-keystore ユーザのホームディレクトリの .keystore というファイル
37.177 +\-keystore \fP\f4若吟若若c \fP\f4.keystore\fP\f3 <ゃ\fP\f3
37.178 .fl
37.179
37.180 .fl
37.181 -\-storetype セキュリティプロパティファイルの「keystore.type」プロパティの値で、 java.security.KeyStore の静的な getDefaultType メソッドから返される
37.182 +\-storetype \fP\f4祉ャc若c若<ゃkeystore.typec若ゃс
37.183 +.fl
37.184 + \fP\f4java.security.KeyStore\fP\f3 \fP\f4getDefaultType\fP\f3 <純菴\fP\f3
37.185 .fl
37.186
37.187 .fl
37.188 -\-file 読み込みの場合は標準入力、書き込みの場合は標準出力
37.189 +\-file \fP\f4茯粋昭帥翫罔羣ュ吾莨若帥翫罔羣阪\fP\f3
37.190 .fl
37.191
37.192 .fl
37.193 @@ -185,293 +184,265 @@
37.194 .fi
37.195
37.196 .LP
37.197 -非公開/秘密鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションの既定値は SHA1withDSA になり、基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションの既定値は MD5withRSA になります。選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、
37.198 +/泣≪臀峨≪眼冴 (\f2\-sigalg\fP 激с) 冴泣≪眼冴羇丞障冴泣 DSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ SHA1withDSA 冴泣 RSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ MD5withRSA 障御純 \f2\-keyalg\fP \f2\-sigalg\fP 絎筝荀сゃ
37.199 +.na
37.200 +\f2Java Cryptography Architecture API Specification & Reference\fP @
37.201 .fi
37.202 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA
37.203 -の
37.204 -.na
37.205 -「\f2Java Cryptography Architecture API Specification & Reference\fP」を参照してください。
37.206 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс
37.207 .RE
37.208 .SS
37.209 -一般オプション
37.210 +筝激с
37.211 .LP
37.212 .RS 3
37.213
37.214 .LP
37.215 -\f2\-v\fP オプションは、\f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な情報が出力されます。
37.216 +\f2\-v\fP 激с潟\f2\-help\fP 潟潟ゃ鴻潟潟т戎с障激с潟絎翫潟潟激≪若у茵荅括完荐惹御宴阪障
37.217 .LP
37.218 -また、\f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。
37.219 -このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリ使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。
37.220 +障\f2\-J\fP\f2javaoption\fP 激с潟篁紙潟潟т戎с障激с潟絎翫絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋・羝<障激с潟腥榊純с障激с潟絎茵医障<≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц;腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
37.221 .LP
37.222 .LP
37.223 -次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。
37.224 +罨<激с潟若鴻≪絲障篏茵鴻潟潟ф絎с障
37.225 .LP
37.226 .RS 3
37.227 .TP 3
37.228 \-storetype storetype
37.229 -この修飾子は、インスタンスを生成するキーストアのタイプを指定します。
37.230 +篆蕋上ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障
37.231 .TP 3
37.232 \-keystore keystore
37.233 -キーストアの場所を指定します。
37.234 +若鴻≪贋絎障
37.235 .LP
37.236 -特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、\f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、\f2.keystore\fP という名前のデフォルトキーストアファイルがユーザのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。
37.237 +劫 \f3keytool\fP 潟潟絎茵JKS 鴻≪帥ゃ篏睡ゃ若鴻≪<ゃ障絖c翫違若鴻≪<ゃ篏障違\f2keytool \-genkeypair\fP 絎茵 \f2\-keystore\fP 激с潟絎c翫\f2.keystore\fP 若鴻≪<ゃ若吟若若c障絖違篏障罕\f2\-keystore \fP\f2ks_file\fP 激с潟絎 \f2ks_file\fP 絖c翫<ゃ篏障
37.238 .LP
37.239 -\f2\-keystore\fP オプションからの入力ストリームは \f2KeyStore.load\fP メソッドに渡されます。\f2NONE\fP が URL として指定された場合は、null ストリームが \f2KeyStore.load\fP メソッドに渡されます。\f2KeyStore\fP がファイルベースでない場合 (ハードウェアトークンデバイス上に存在している場合など)、\f2NONE\fP を指定してください。
37.240 +\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP <純羝<障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP <純羝<障\f2NONE\fP \f2KeyStore\fP <ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
37.241 .TP 3
37.242 \-storepass storepass
37.243 -キーストアの完全性を保護するために使うパスワードを指定します。
37.244 +若鴻≪翫с篆茘激篏帥鴻若絎障
37.245 .LP
37.246 -\f2storepass\fP は、6 文字以上でなければなりません。指定したパスワードは、キーストアの内容にアクセスするすべてのコマンドで使われます。この種のコマンドを実行するときに、コマンド行で \f2\-storepass\fP オプションを指定しなかった場合は、パスワードの入力を求められます。
37.247 +\f2storepass\fP 6 絖篁ヤ綽荀障絎鴻若若鴻≪絎鴻≪祉鴻鴻潟潟т戎障腮潟潟絎茵潟潟茵 \f2\-storepass\fP 激с潟絎c翫鴻若ュ羆障
37.248 .LP
37.249 -キーストアから情報を取り出す場合は、パスワードを省略できます。 パスワードを省略すると、取り出す情報の完全性をチェックできないので、警告が表示されます。
37.250 +若鴻≪宴冴翫鴻若ャс障 鴻若ャ冴宴翫сссс茘茵腓冴障
37.251 .TP 3
37.252 \-providerName provider_name
37.253 -セキュリティプロパティファイル内に含まれる暗号化サービスプロバイダ名を特定するために使用されます。
37.254 +祉ャc若c若<ゃ障垸泣若鴻ゃ劫篏睡障
37.255 .TP 3
37.256 \-providerClass provider_class_name
37.257 -暗号化サービスプロバイダがセキュリティプロパティファイルに指定されていない場合は、そのマスタークラスファイルの名前を指定するときに使われます。
37.258 +垸泣若鴻ゃ祉ャc若c若<ゃ絎鴻帥若鴻<ゃ絎篏帥障
37.259 .TP 3
37.260 \-providerArg provider_arg
37.261 -\f2\-providerClass\fP と組み合わせて使用します。\f2provider_class_name\fP のコンストラクタに対する省略可能な文字列入力引数を表します。
37.262 +\f2\-providerClass\fP 腟水篏睡障\f2provider_class_name\fP 潟潟鴻帥絲障ュ純絖ュ綣違茵障
37.263 .TP 3
37.264 \-protected
37.265 -\f2true\fP、\f2false\fP のいずれか。専用 PIN リーダなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
37.266 +\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
37.267 .RE
37.268
37.269 .LP
37.270 .RE
37.271 -.SH "コマンド"
37.272 +.SH "潟潟"
37.273 .LP
37.274
37.275 .LP
37.276 .SS
37.277 -キーストアへのデータの作成および追加
37.278 +若鴻≪吾若帥篏障菴遵
37.279 .LP
37.280 .RS 3
37.281
37.282 .LP
37.283 .RS 3
37.284 .TP 3
37.285 -\-genkeypair {\-alias alias}
37.286 -{\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.287 +\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.288 .LP
37.289 -鍵のペア (公開鍵および関連する非公開鍵) を生成します。公開鍵は X.509 v3 自己署名証明書でラップされます。
37.290 -証明書は、単一の要素を持つ証明連鎖として格納されます。この証明連鎖と非公開鍵は、\f2alias\fP で特定される新しいキーストアエントリに格納されます。
37.291 +泣 (泣渇∫c) 障泣 X.509 v3 綏援讐荐惹吾с障 荐惹吾筝荀膣よ┝吾с若潟主障荐惹吾с若潟泣\f2alias\fP х劫違若鴻≪潟主障
37.292 .LP
37.293 -\f2keyalg\fP には、鍵のペアを生成するのに使うアルゴリズムを指定し、\f2keysize\fP には、生成する各鍵のサイズを指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。 このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。
37.294 +\f2keyalg\fP 泣≪篏帥≪眼冴絎\f2keysize\fP 泣泣ゃ冴絎障 \f2sigalg\fP 綏援讐荐惹吾臀峨篁篏帥≪眼冴絎障≪眼冴\f2keyalg\fP 篋сс違障
37.295 .LP
37.296 -\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の \f2issuer\fP フィールドと \f2subject\fP フィールドとして使う X.500 識別名を指定します。コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。
37.297 +\f2dname\fP \f2alias\fP ∫d綏援讐荐惹吾 \f2issuer\fP c若 \f2subject\fP c若篏帥 X.500 茘ュ絎障潟潟茵цュ絎c翫茘ュュ羆障
37.298 .LP
37.299 -\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上でなければなりません。
37.300 +\f2keypass\fP 泣≪<泣篆茘激篏帥鴻若絎障鴻若絎c翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
37.301 .LP
37.302 -\f2valDays\fP には、証明書の有効日数を指定します。
37.303 +\f2valDays\fP 荐惹吾号ユ違絎障
37.304 .LP
37.305 -このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\fP を使用することをお勧めします。
37.306 +潟潟篁ュ若鴻с \f2\-genkey\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-genkeypair\fP 篏睡с障
37.307 .TP 3
37.308 -\-genseckey {\-alias alias}
37.309 -{\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.310 +\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.311 .LP
37.312 -秘密鍵を生成し、それを \f2alias\fP で特定される新しい \f2KeyStore.SecretKeyEntry\fP 内に格納します。
37.313 +腱絲泣 \f2alias\fP х劫違 \f2KeyStore.SecretKeyEntry\fP 主障
37.314 .LP
37.315 -\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合、ユーザはその入力を求められます。ユーザがプロンプトで RETURN キーを押した場合、鍵のパスワードはキーストアと同じパスワードに設定されます。\f2keypass\fP の長さは 6 文字以上でなければいけません。
37.316 +\f2keyalg\fP 腱絲泣篏睡≪眼冴\f2keysize\fP 泣泣ゃ冴絎障\f2keypass\fP 腱絲泣篆茘激篏睡鴻若с鴻若絎c翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
37.317 .TP 3
37.318 -\-importcert {\-alias alias}
37.319 -{\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.320 +\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.321 .LP
37.322 -ファイル \f2cert_file\fP から証明書または証明連鎖 (証明連鎖の場合は、PKCS#7 形式の応答で提供されるもの) を読み込み、\f2alias\fP によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または PKCS#7 応答を読み込みます。
37.323 +<ゃ \f2cert_file\fP 荐惹吾障荐惹吾с若 (荐惹吾с若潟翫PKCS#7 綵√綽膈ф箴) 茯粋昭帥\f2alias\fP c劫若鴻≪潟主障<ゃ絎翫罔羣ュ荐惹吾障 PKCS#7 綽膈茯粋昭帥障
37.324 .LP
37.325 -\f3keytool\fP では、X.509 v1、v2、v3 の証明書、および、PKCS#7 形式の証明書から構成されている PKCS#7 形式の証明連鎖をインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式 (Base64 符号化とも呼ばれる) のどちらかで提供する必要があります。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了しなければなりません。
37.326 +\f3keytool\fP сX.509 v1v2v3 荐惹吾潟PKCS#7 綵√荐惹吾罕 PKCS#7 綵√荐惹吾с若潟ゃ潟若с障ゃ潟若若帥ゃ膃垸劫障阪順垸劫 (Base64 膃垸若違) <ф箴綽荀障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障膃垸劫翫荐惹吾\-\-\-\-\-BEGINу障絖ч紮\-\-\-\-\-ENDу障絖х篋違障
37.327 .LP
37.328 -証明書のインポートには、次の 2 つの目的があります。
37.329 +荐惹吾ゃ潟若罨< 2 ゃ障
37.330 .RS 3
37.331 .TP 3
37.332 1.
37.333 -信頼できる証明書のリストに証明書を追加する
37.334 +篆♂若с荐惹吾鴻荐惹吾菴遵
37.335 .TP 3
37.336 2.
37.337 -CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする
37.338 +CA 荐惹悟讐荀羆 (\-certreq 潟潟) 篆<腟CA c荐惹綽膈ゃ潟若
37.339 .RE
37.340 .LP
37.341 -ユーザがどのタイプのインポートを意図しているかは、次のように \f2\-alias\fP オプションの値によって示されます。
37.342 +<腮蕁ゃ潟若茵\f2\-alias\fP 激с潟ゃc絎障
37.343 .RS 3
37.344 .TP 3
37.345 1.
37.346 -\f3別名が特定の鍵エントリを指していない場合\fP、\f3keytool\fP は、ユーザが信頼できる証明書のエントリを追加しようとしていると見なします。この場合、その別名がキーストア内にすでに存在していてはいけません。その別名がすでに存在していた場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。
37.347 +\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障翫ュ若鴻√с絖障ュс絖翫ュ篆♂若с荐惹吾с絖с\f3keytool\fP 若阪荐惹吾ゃ潟若茵障
37.348 .TP 3
37.349 2.
37.350 -\f3別名が特定の鍵エントリを指している場合\fP、\f3keytool\fP は、ユーザが証明書応答をインポートしようとしていると見なします。
37.351 +\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障
37.352 .RE
37.353 -.LP
37.354 -\f3新しい信頼できる証明書のインポート\fP
37.355 +\f3違篆♂若с荐惹吾ゃ潟若\fP
37.356 .RS 3
37.357
37.358 .LP
37.359 .LP
37.360 -\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼の連鎖の構築を試みます。
37.361 +\f3keytool\fP 若鴻≪荐惹吾菴遵若鴻√с絖篆♂若с荐惹吾篏帥cゃ潟若荐惹吾 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟罕膀荅帥障
37.362 .LP
37.363 .LP
37.364 -\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できる、すなわち cacerts という名前のファイルに含まれる証明書の連鎖と見なされます。
37.365 +\f2\-trustcacerts\fP 激с潟絎翫菴遵荐惹吾篆♂若с cacerts <ゃ障荐惹吾с若潟荀障
37.366 .LP
37.367 .LP
37.368 -\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザに確認を求めます。この場合は、表示された証明書のフィンガープリントと、ほかの何らかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
37.369 +\f3keytool\fP ゃ潟若荐惹吾綏援讐荐惹 (若鴻≪障 cacerts <ゃ障綏援讐荐惹) 潟障с篆♂若鴻罕膀紊掩翫ゃ潟若荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾c潟若潟祉 (篆♂若с) 掩 (荐惹吾篋冴) ユc潟若潟罸莠障篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障荅括完篆♂若с荐惹吾ゃ潟若≪羈鋋сゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
37.370 .LP
37.371 .RE
37.372 -\f3証明応答のインポート\fP
37.373 +\f3荐惹綽膈ゃ潟若\fP
37.374 .RS 3
37.375 .LP
37.376 -「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\f2\-trustcacerts\fP オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。
37.377 +荐惹綽膈ゃ潟若若鴻√篆♂若с荐惹吾 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪<ゃф荐惹吾篏帥c荐惹綽膈罎祉障
37.378 .LP
37.379 .LP
37.380 -証明応答が信頼できるかどうかを決定する方法は次のとおりです。
37.381 +荐惹綽膈篆♂若с羆阪号罨<с
37.382 .LP
37.383 .RS 3
37.384 .TP 2
37.385 o
37.386 -\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼連鎖の確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明連鎖を形成します。信頼連鎖が確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザに検証を求めるプロンプトを表示します。ユーザが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。
37.387 +\f3荐惹綽膈筝 X.509 荐惹吾с翫\fP\f3keytool\fP 荐惹綽膈 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟腆榊荅帥障荐惹綽膈荐惹綽膈茯荐若篏帥荐惹吾絮ゆ\f2alias\fP 違荐惹吾с若潟綵∽障篆♂若с若潟腆榊翫荐惹綽膈ゃ潟若障翫\f3keytool\fP 荐惹吾阪若吟若罎荐若羆潟茵腓冴障 若吟若荐惹綽膈篆♂惹сゆ筝純с絽吾育cс
37.388 .TP 2
37.389 o
37.390 -\f3証明応答が PKCS#7 形式の証明連鎖である場合\fP、\f3keytool\fP は、まず連鎖を並べ替えて、ユーザの証明書が最初に、ルート CA の自己署名証明書が最後にくるようにしたあと、証明応答に含まれるルート CA の証明書と、キーストア内または (\f2\-trustcacerts\fP オプションが指定されている場合は) cacerts キーストアファイル内の信頼できる証明書とをすべて比較し、一致するものがあるかどうかを調べます。一致するものが見つからなかった場合は、ルート CA の証明書の情報を表示し、ユーザに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかの何らかの (信頼できる) 情報源 (ルート CA 自身など) から入手したフィンガープリントとを比較します。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
37.391 +\f3荐惹綽膈 PKCS#7 綵√荐惹吾с若潟с翫\fP\f3keytool\fP 障с若潟筝号帥若吟若荐惹吾若 CA 綏援讐荐惹吾緇荐惹綽膈障若 CA 荐惹吾若鴻√障 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪<ゃ篆♂若с荐惹吾鴻罸莠筝眼茯帥鴻障筝眼荀ゃc翫若 CA 荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾c潟若潟祉 (篆♂若с) 掩 (若 CA 荳) ユc潟若潟罸莠障ゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
37.392 .RE
37.393
37.394 .LP
37.395 .LP
37.396 -証明書応答内の公開鍵が \f2alias\fP の下にすでに格納されているユーザの公開鍵に一致した場合、古い証明連鎖が応答内の新しい証明連鎖で置き換えられます。
37.397 -以前の証明連鎖を新しい証明連鎖で置き換えることができるのは、有効な \f2keypass\fP、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
37.398 +荐惹後膈泣 \f2alias\fP 筝с主若吟若泣筝眼翫ゃ荐惹吾с若潟綽膈違荐惹吾с若潟х舟障篁ュ荐惹吾с若潟違荐惹吾с若潟х舟с鴻 \f2keypass\fPゃ障荅峨潟泣篆茘激鴻若絎翫с鴻若絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
37.399 .LP
37.400 .RE
37.401 .LP
37.402 -このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。
37.403 +潟潟篁ュ若鴻с \f2\-import\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-importcert\fP 篏睡с障
37.404 .TP 3
37.405 -\-importkeystore \-srckeystore srckeystore
37.406 -\-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.407 +\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.408 .LP
37.409 -ソースキーストアからターゲットキーストアへ、単一のエントリまたはすべてのエントリをインポートします。
37.410 +純若鴻若鴻≪帥若蚊若鴻≪吾筝潟障鴻潟ゃ潟若障
37.411 .LP
37.412 -\f2srcalias\fP オプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲットキーストアにインポートします。\f2destalias\fP 経由でターゲット別名が指定されなかった場合、\f2srcalias\fP がターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\f2srckeypass\fP を使ってそのエントリが回復されます。\f2srckeypass\fP が指定されなかった場合、\f3keytool\fP は \f2srcstorepass\fP を使ってそのエントリを回復しようとします。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザはパスワードの入力を求められます。ターゲットエントリは \f2destkeypass\fP によって保護されます。\f2destkeypass\fP が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。
37.413 +\f2srcalias\fP 激с潟絎翫潟潟ュх劫筝潟帥若蚊若鴻≪ゃ潟若障\f2destalias\fP 腟宴с帥若蚊ュ絎c翫\f2srcalias\fP 帥若蚊ュ篏睡障純若鴻潟鴻若т茘激翫\f2srckeypass\fP 篏帥c潟緇障\f2srckeypass\fP 絎c翫\f3keytool\fP \f2srcstorepass\fP 篏帥c潟緇障\f2srcstorepass\fP 絎c罩cc翫若吟若鴻若ュ羆障帥若蚊潟 \f2destkeypass\fP c篆茘激障\f2destkeypass\fP 絎c翫帥若蚊潟純若鴻潟鴻若c篆茘激障
37.414 .LP
37.415 -\f2srcalias\fP オプションが指定されなかった場合、ソースキーストア内のすべてのエントリがターゲットキーストア内にインポートされます。各ターゲットエントリは対応するソースエントリの別名の下に格納されます。ソースエントリがパスワードで保護されていた場合、\f2srcstorepass\fP を使ってそのエントリが回復されます。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。
37.416 +\f2srcalias\fP 激с潟絎c翫純若鴻若鴻√鴻潟帥若蚊若鴻√ゃ潟若障帥若蚊潟絲上純若鴻潟ュ筝主障純若鴻潟鴻若т茘激翫\f2srcstorepass\fP 篏帥c潟緇障\f2srcstorepass\fP 絎c罩cc翫若吟若鴻若ュ羆障純若鴻若鴻√潟帥ゃ帥若蚊若鴻≪с泣若翫潟帥若蚊若鴻≪主若榊翫若吟若潟鴻膓茵筝御羆障帥若蚊潟純若鴻潟鴻若c篆茘激障
37.417 .LP
37.418 -ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。
37.419 +帥若蚊ュ帥若蚊若鴻√с絖翫若吟若潟筝吾違ュ筝ф違潟篏御羆障
37.420 .LP
37.421 -\f2\-noprompt\fP を指定した場合、ユーザは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。
37.422 +\f2\-noprompt\fP 絎翫若吟若違帥若蚊ュュ羆障√潟帥若蚊ュц筝吾障緇ゃ潟若с潟鴻茘阪障
37.423 .RE
37.424 .RE
37.425 .SS
37.426 -データのエクスポート
37.427 +若帥鴻若
37.428 .LP
37.429 .RS 3
37.430
37.431 .LP
37.432 .RS 3
37.433 .TP 3
37.434 -\-certreq {\-alias alias}
37.435 -{\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.436 +\-certreq {\-alias alias} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.437 .LP
37.438 -PKCS#10 形式を使って証明書署名要求 (CSR) を生成します。
37.439 +PKCS#10 綵√篏帥c荐惹悟讐荀羆 (CSR) 障
37.440 .LP
37.441 -CSR は、認証局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明連鎖を送り返します。 この証明書または証明連鎖は、キーストア内の既存の証明連鎖 (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。
37.442 +CSR 荐惹悟肴絮 (CA) 篆<сCA 荐惹梧羆 (絽吾ゃ潟) 茯荐若荐惹吾障荐惹吾с若潟菴障 荐惹吾障荐惹吾с若潟若鴻√√荐惹吾с若 ( 1 ゃ綏援讐荐惹吾罕) 臀篏帥障
37.443 .LP
37.444 -\f2alias\fP に関連付けられた非公開鍵と X.500 識別名は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
37.445 +\f2alias\fP ∫d泣 X.500 茘ュPKCS#10 荐惹梧羆篏篏帥障泣若鴻√с鴻若c篆茘激с泣≪祉鴻鴻若箴綽荀障潟潟茵 \f2keypass\fP 絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
37.446 .LP
37.447 -\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。
37.448 +\f2sigalg\fP CSR 臀峨篁篏帥≪眼冴絎障
37.449 .LP
37.450 -CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。
37.451 +CSR <ゃ \f2certreq_file\fP 主障<ゃ絎翫罔羣阪 CSR 阪障
37.452 .LP
37.453 -CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。
37.454 +CA 綽膈ゃ潟若\f2importcert\fP 潟潟篏帥障
37.455 .TP 3
37.456 -\-exportcert {\-alias alias}
37.457 -{\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
37.458 +\-exportcert {\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
37.459 .LP
37.460 -\f2alias\fP に関連付けられた証明書を (キーストアから) 読み込み、ファイル \f2cert_file\fP に格納します。
37.461 +\f2alias\fP ∫d荐惹吾 (若鴻≪) 茯粋昭帥<ゃ \f2cert_file\fP 主障
37.462 .LP
37.463 -ファイルが指定されていない場合は、標準出力に証明書が出力されます。
37.464 +<ゃ絎翫罔羣阪荐惹吾阪障
37.465 .LP
37.466 -デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
37.467 +сゃ膃垸劫荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
37.468 .LP
37.469 -\f2alias\fP が、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\f2alias\fP は、関連付けられた証明連鎖を持つ鍵エントリを参照します。この場合は、連鎖内の最初の証明書が返されます。この証明書は、\f2alias\fP によって表されるエンティティの公開鍵を認証する証明書です。
37.470 +\f2alias\fP 篆♂若с荐惹吾с翫荅峨荐惹吾阪障篁ュ翫\f2alias\fP ∫d荐惹吾с若潟ら泣潟с障翫с若喝荐惹吾菴障荐惹吾\f2alias\fP c茵潟cc若泣茯荐若荐惹吾с
37.471 .LP
37.472 -このコマンドは、以前のリリースでは \f2\-export\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-exportcert\fP を使用することをお勧めします。
37.473 +潟潟篁ュ若鴻с \f2\-export\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-exportcert\fP 篏睡с障
37.474 .RE
37.475
37.476 .LP
37.477 .RE
37.478 .SS
37.479 -データの表示
37.480 +若帥茵腓
37.481 .LP
37.482 .RS 3
37.483
37.484 .LP
37.485 .RS 3
37.486 .TP 3
37.487 -\-list {\-alias alias}
37.488 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
37.489 +\-list {\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
37.490 .LP
37.491 -\f2alias\fP で特定されるキーストアエントリの内容を (標準出力に) 出力します。別名が指定されていない場合は、キーストア全体の内容が表示されます。
37.492 +\f2alias\fP х劫若鴻≪潟絎鴻 (罔羣阪) 阪障ュ絎翫若鴻√篏絎鴻茵腓冴障
37.493 .LP
37.494 -このコマンドは、デフォルトでは証明書の MD5 フィンガープリントを表示します。
37.495 -\f2\-v\fP オプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。
37.496 --rfc オプションが指定されている場合は、出力可能符号化方式で証明書の内容が表示されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
37.497 +潟潟с荐惹吾 MD5 c潟若潟茵腓冴障\f2\-v\fP 激с潟絎翫肴激≪垩≦宍罘純篁宴篋咲茯с綵√ц┝吾茵腓冴障\f2\-rfc\fP 激с潟絎翫阪順垸劫ц┝吾絎鴻茵腓冴障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
37.498 .LP
37.499 -\f2\-v\fP オプションと \f2\-rfc\fP オプションとを同時に指定することはできません。
37.500 +\f2\-v\fP 激с潟 \f2\-rfc\fP 激с潟絎с障
37.501 .TP 3
37.502 \-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
37.503 .LP
37.504 +<ゃ
37.505 .LP
37.506 -\f2cert_file\fP ファイルから証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ファイルが指定されていない場合は、標準入力から証明書を読み込みます。
37.507 +ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
37.508 .LP
37.509 -証明書は、バイナリ符号化方式または出力可能符号化方式で表示できます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
37.510 -.LP
37.511 -注: このコマンドはキーストアとは関係なく動作します。
37.512 +羈:潟潟若鴻≪≫篏障
37.513 .RE
37.514
37.515 .LP
37.516 .RE
37.517 .SS
37.518 -キーストアの管理
37.519 +若鴻≪膊∞
37.520 .LP
37.521 .RS 3
37.522
37.523 .LP
37.524 .RS 3
37.525 .TP 3
37.526 -\-storepasswd [\-new new_storepass]
37.527 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
37.528 +\-storepasswd [\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
37.529 .LP
37.530 -キーストアの内容の完全性を保護するために使うパスワードを変更します。\f2new_storepass\fP には、新しいパスワードを指定します。\f2new_storepass\fP は、6 文字以上でなければなりません。
37.531 +若鴻≪絎鴻翫с篆茘激篏帥鴻若紊眼障\f2new_storepass\fP 違鴻若絎障 \f2new_storepass\fP 6 絖篁ヤс違障
37.532 .TP 3
37.533 -\-keypasswd {\-alias alias}
37.534 -[\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
37.535 +\-keypasswd {\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
37.536 .LP
37.537 -.I
37.538 -alias
37.539 -によって特定される非公開/秘密鍵を保護するためのパスワードを、
37.540 -.I old_keypass
37.541 -から
37.542 -.I new_keypass
37.543 -に変更します。
37.544 -.I new_keypass
37.545 -は、6 文字以上でなければなりません。
37.546 +\f2alias\fP c劫/腱絲泣篆茘激鴻若\f2old_keypass\fP \f2new_keypass\fP 紊眼障 \f2new_keypass\fP 6 絖篁ヤс違障
37.547 .LP
37.548 -コマンド行で \f2\-keypass\fP オプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
37.549 +潟潟茵 \f2\-keypass\fP 激с潟絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
37.550 .LP
37.551 -コマンド行で \f2\-new\fP オプションを指定しなかった場合は、新しいパスワードの入力を求められます。
37.552 +潟潟茵 \f2\-new\fP 激с潟絎c翫違鴻若ュ羆障
37.553 .TP 3
37.554 -\-delete [\-alias alias]
37.555 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.556 +\-delete [\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.557 .LP
37.558 -.I alias
37.559 -によって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。
37.560 +\f2alias\fP c劫潟若鴻≪ゃ障潟潟茵уュ絎c翫ュュ羆障
37.561 .TP 3
37.562 -\-changealias {\-alias alias}
37.563 -[\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.564 +\-changealias {\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
37.565 .LP
37.566 -指定された \f2alias\fP から新しい別名 \f2destalias\fP へ、既存のキーストアエントリを移動します。ターゲット別名が指定されなかった場合、このコマンドはその入力を求めます。元のエントリがエントリパスワードで保護されていた場合、「-keypass」オプション経由でそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\f2storepass\fP (指定された場合) がまず試みられます。その試みが失敗すると、ユーザはパスワードの入力を求められます。
37.567 +絎 \f2alias\fP 違ュ \f2destalias\fP 吾√若鴻≪潟腱糸障帥若蚊ュ絎c翫潟潟ュ羆障潟潟鴻若т茘激翫\-keypass激с括宴с鴻若絎с障泣鴻若絎c翫\f2storepass\fP (絎翫) 障荅帥障荅帥紊掩若吟若鴻若ュ羆障
37.568 .RE
37.569
37.570 .LP
37.571 .RE
37.572 .SS
37.573 -ヘルプの表示
37.574 +茵腓
37.575 .LP
37.576 .RS 3
37.577
37.578 @@ -480,26 +451,26 @@
37.579 .TP 3
37.580 \-help
37.581 .LP
37.582 -基本的なコマンドとそのオプションの一覧を表示します。
37.583 +堺潟潟激с潟筝荀с茵腓冴障
37.584 .RE
37.585
37.586 .LP
37.587 .RE
37.588 -.SH "例"
37.589 +.SH "箴"
37.590 .LP
37.591
37.592 .LP
37.593 .LP
37.594 -ここでは、自分の鍵のペアおよび信頼できるエンティティからの証明書を管理するためのキーストアを作成する場合を例として示します。
37.595 +с泣≪割拭若с潟cc若荐惹吾膊∞若鴻≪篏翫箴腓冴障
37.596 .LP
37.597 .SS
37.598 -鍵のペアの生成
37.599 +泣≪
37.600 .LP
37.601 .RS 3
37.602
37.603 .LP
37.604 .LP
37.605 -まず、キーストアを作成して鍵のペアを生成する必要があります。次に示すのは、実行するコマンドの例です。
37.606 +障若鴻≪篏泣≪綽荀障罨<腓冴絎茵潟潟箴с
37.607 .LP
37.608 .nf
37.609 \f3
37.610 @@ -515,16 +486,16 @@
37.611
37.612 .LP
37.613 .LP
37.614 -注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。
37.615 +羈:潟潟 1 茵ュ違障箴ц域ュ茯帥с
37.616 .LP
37.617 .LP
37.618 -この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアにパスワード ab987c を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティの「識別名」は、通称が「Mark Jones」、組織単位が「JavaSoft」、組織が「Sun」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
37.619 +箴сworking c mykeystore 若鴻≪篏 (若鴻≪障絖篁絎)篏若鴻≪鴻若 ab987c 蚊綵障泣泣≪絲上潟cc若茘ュ腱違Mark Jones腟膵篏JavaSoft腟膵Sun2 絖順垩USс泣泣泣ゃ冴< 1024 с泣篏 DSA 窮≪眼冴篏睡障
37.620 .LP
37.621 .LP
37.622 -このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵にはパスワード「kpi135」が割り当てられます。
37.623 +潟潟泣茘ュ宴綏援讐荐惹 ( SHA1withDSA 臀峨≪眼冴篏睡) 篏障荐惹吾号 180 ャс 荐惹吾ュbusinessх劫若鴻≪潟泣∫d障泣鴻若kpi135蚊綵障
37.624 .LP
37.625 .LP
37.626 -オプションの既定値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。既定値を持つオプションでは、オプションを指定しなければ既定値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。
37.627 +激с潟ゃ篏帥翫筝腓冴潟潟紊ус障絎激с潟 1 ゃ絎潟潟絎茵純с ゃゃ激с潟с激с潟絎違ゃ篏帥綽荀ゃゃュ羆障違罨<ュс障
37.628 .LP
37.629 .nf
37.630 \f3
37.631 @@ -535,19 +506,19 @@
37.632 .fi
37.633
37.634 .LP
37.635 -この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。
37.636 +翫mykey ュс若鴻≪潟篏違泣≪ 90 ラ鴻荐惹吾潟主障潟若c .keystore 若鴻≪臀障若鴻≪障絖翫篏障茘ュ宴若鴻≪鴻若渇泣鴻若ゃュ羆障
37.637 .LP
37.638 -以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行した場合の例を示します。 情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、非公開鍵のパスワードには kpi135 と指定)。
37.639 +篁ヤс激с潟絎 \f2\-genkeypair\fP 潟潟絎茵箴腓冴障 宴ュ羆翫腓冴 \f2\-genkeypair\fP 潟潟ゃュ障 (違泣鴻若 kpi135 絎)
37.640 .LP
37.641 .RE
37.642 .SS
37.643 -認証局に対する署名付き証明書の要求
37.644 +荐惹悟肴絮絲障臀峨篁荐惹吾荀羆
37.645 .LP
37.646 .RS 3
37.647
37.648 .LP
37.649 .LP
37.650 -現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に認証局 (CA) の署名が付いていれば、ほかのユーザから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。
37.651 +憝鴻ф1 綏援讐荐惹吾с荐惹吾荐惹悟肴絮 (CA) 臀峨篁違祉若吟若荐惹吾篆♂若с醇с蕭障CA 臀峨緇障荐惹悟讐荀羆 (CSR) 障 違罨<障
37.652 .LP
37.653 .nf
37.654 \f3
37.655 @@ -558,43 +529,41 @@
37.656 .fi
37.657
37.658 .LP
37.659 -CSR (デフォルト別名「mykey」によって特定されるエンティティの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書の連鎖を返すこともあります。証明書の連鎖では、各証明書が連鎖内のその前の署名者の公開鍵を認証します。
37.660 -
37.661 +CSR (ュmykeyc劫潟cc若 CSR) 篏MarkJ.csr <ゃ臀障<ゃVeriSign CA 冴障 CA 荀羆 (絽吾ゃ潟) 茯荐若荀羆泣茯荐若臀峨篁荐惹吾菴障翫cCA 荐惹吾с若潟菴障 荐惹吾с若潟с荐惹吾с若喝臀峨泣茯荐若障
37.662 +.RE
37.663 .SS
37.664 -CA からの証明書のインポート
37.665 +CA 荐惹吾ゃ潟若
37.666 .LP
37.667 .RS 3
37.668
37.669 .LP
37.670 .LP
37.671 -作成した自己署名証明書は、証明連鎖で置き換える必要があります。 証明連鎖では、各証明書が、「ルート」CA を起点とする連鎖内の次の証明書の署名者の公開鍵を認証します。
37.672 +篏綏援讐荐惹吾荐惹吾с若潟х舟綽荀障 荐惹吾с若潟с荐惹吾若CA 莎欠鴻с若喝罨<荐惹吾臀峨泣茯荐若障
37.673 .LP
37.674 .LP
37.675 -CA からの証明応答をインポートするには、キーストアか、(importcert コマンドで説明しているように) \f2cacerts\fP キーストアファイル内に 1 つまたは複数の「信頼できる証明書」がある必要があります。
37.676 +CA 荐惹綽膈ゃ潟若若鴻≪(importcert 潟潟 ц) \f2cacerts\fP 若鴻≪<ゃ 1 や札筝篆♂若с荐惹吾綽荀障
37.677 .LP
37.678 .RS 3
37.679 .TP 2
37.680 o
37.681 -証明応答が証明連鎖の場合は、連鎖のトップの証明書 (その CA の公開鍵を認証する「ルート」CA の証明書) だけを必要とする
37.682 +荐惹綽膈荐惹吾с若潟翫с若潟荐惹 ( CA 泣茯荐若若CA 荐惹) 綽荀
37.683 .TP 2
37.684 o
37.685 -証明応答が単一の証明書の場合は、証明書に署名した CA の発行用の証明書が必要で、その証明書が自己署名されない場合は、さらにその証明書の署名者用の証明書を必要とする。 このようにして自己署名される「ルート」CA の証明書までそれぞれ証明書を必要とする
37.686 +荐惹綽膈筝荐惹吾翫荐惹吾臀峨 CA 肴荐惹吾綽荀с荐惹吾綏援讐翫荐惹吾臀峨荐惹吾綽荀 綏援讐若CA 荐惹吾障с荐惹吾綽荀
37.687 .RE
37.688
37.689 .LP
37.690 .LP
37.691 -cacerts キーストアファイルは、5 つの VeriSign ルート CA 証明書を含んだ状態で出荷されているので、VeriSign の証明書を、信頼できる証明書としてキーストア内にインポートする必要はないかもしれません。ただし、ほかの CA に対して署名付き証明書を要求していて、この CA の公開鍵を認証する証明書が、cacerts にまだ追加されていない場合は、該当する CA からの証明書を、「信頼できる証明書」としてインポートする必要があります。
37.692 +cacerts 若鴻≪<ゃ5 ゃ VeriSign 若 CA 荐惹吾倶у肴激сVeriSign 荐惹吾篆♂若с荐惹吾若鴻√ゃ潟若綽荀障祉 CA 絲障臀峨篁荐惹吾荀羆 CA 泣茯荐若荐惹吾cacerts 障菴遵翫荅峨 CA 荐惹吾篆♂若с荐惹吾ゃ潟若綽荀障
37.693 .LP
37.694 .LP
37.695 -通常、CA からの証明書は、自己署名証明書、またはほかの CA によって署名された証明書です (後者の場合は、該当するほかの CA の公開鍵を認証する証明書も必要)。たとえば、ABC という企業が CA だとします。 このとき、この CA の公開鍵を認証する自己署名証明書と考えられる ABCCA.cer という名前のファイルを、ABC から入手したとします。
37.696 +絽吾CA 荐惹吾綏援讐荐惹吾障祉 CA c臀峨荐惹吾с (緇翫荅峨祉 CA 泣茯荐若荐惹吾綽荀)違ABC 篌罐 CA 障 CA 泣茯荐若綏援讐荐惹吾 ABCCA.cer <ゃABC ユ障
37.697 .LP
37.698 .LP
37.699 -「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。
37.700 -まず、証明書の内容を表示し (\f3keytool\fP \f2\-printcert\fP コマンドを使用するか、または \f2\-noprompt\fP オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。
37.701 -証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。
37.702 +篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障障荐惹吾絎鴻茵腓冴 (\f3keytool\fP \f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f3keytool\fP \f2\-importcert\fP 潟潟篏睡)茵腓冴荐惹吾c潟若潟緇c潟若潟筝眼腆肴障荐惹吾篆<篋榊g機篋榊腓冴 (障絎泣吾c腓冴) c潟若潟筝潟潟ц;腓冴c潟若潟罸莠障c潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙c臀峨鴻篆♂若障
37.703 .LP
37.704 .LP
37.705 -ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。
37.706 +ABCCA.cer 鴻荐惹吾篆♂若翫荐惹吾若鴻≪菴遵с障 違罨<障
37.707 .LP
37.708 .nf
37.709 \f3
37.710 @@ -605,19 +574,19 @@
37.711 .fi
37.712
37.713 .LP
37.714 -ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。
37.715 +ABCCA.cer <ゃ若帥篆♂若с荐惹吾潟若鴻√篏荅峨潟 abc ュ蚊綵障
37.716 .RE
37.717 .SS
37.718 -CA からの証明応答のインポート
37.719 +CA 荐惹綽膈ゃ潟若
37.720 .LP
37.721 .RS 3
37.722
37.723 .LP
37.724 .LP
37.725 -証明書署名要求の提出先の CA の公開鍵を認証する証明書をインポートしたあとは (または同種の証明書がすでに cacerts ファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明連鎖で置き換えることができます。この証明連鎖は、CA の応答が連鎖の場合、証明書署名要求に対する応答として CA から送り返された証明連鎖です。 また、CA の応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または cacerts キーストアファイル内にすでに存在する信頼できる証明書とを使って構築した証明連鎖です。
37.726 +荐惹悟讐荀羆阪 CA 泣茯荐若荐惹吾ゃ潟若 (障腮荐惹吾с cacerts <ゃ絖翫)荐惹綽膈ゃ潟若綏援讐荐惹吾荐惹吾с若潟х舟с障荐惹吾с若潟CA 綽膈с若潟翫荐惹悟讐荀羆絲障綽膈 CA 菴荐惹吾с若潟с 障CA 綽膈筝荐惹吾翫荐惹綽膈ゃ潟若若鴻√障 cacerts 若鴻≪<ゃс絖篆♂若с荐惹吾篏帥c罕膀荐惹吾с若潟с
37.727 .LP
37.728 .LP
37.729 -たとえば、証明書署名要求を VeriSign に送信したとします。送り返された証明書の名前が VSMarkJ.cer だとすると、次のようにして応答をインポートできます。
37.730 +違荐惹悟讐荀羆 VeriSign 篆<障菴荐惹吾 VSMarkJ.cer 罨<綽膈ゃ潟若с障
37.731 .LP
37.732 .nf
37.733 \f3
37.734 @@ -630,17 +599,14 @@
37.735
37.736 .LP
37.737 .SS
37.738 -公開鍵を認証する証明書のエクスポート
37.739 +泣茯荐若荐惹吾鴻若
37.740 .LP
37.741 .RS 3
37.742
37.743 .LP
37.744 -たとえば、
37.745 -.fi
37.746 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html
37.747 -の \f2jarsigner\fP ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。
37.748 +違jarsigner(1) 篏帥c Java ARchive (JAR) <ゃ臀峨障 JAR <ゃゃ≪潟c篏帥障ゃ≪潟眼с臀峨茯荐若障
37.749 .LP
37.750 -クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。 このエントリには「mykey」という別名が使われているとします。
37.751 +ゃ≪潟臀峨茯荐若号 1 ゃ障泣荐惹吾篆♂若с潟ゃ≪潟若鴻≪ゃ潟若号障荐惹吾鴻若ゃ≪潟箴障違罨<荐惹吾 \f2MJ.cer\fP <ゃ潟若障 潟mykeyュ篏帥障
37.752 .LP
37.753 .nf
37.754 \f3
37.755 @@ -651,19 +617,19 @@
37.756 .fi
37.757
37.758 .LP
37.759 -証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。
37.760 +荐惹吾臀峨篁 JAR <ゃユゃ≪潟\f3jarsigner\fP 若篏帥c臀峨茯荐若с障
37.761 .RE
37.762 .SS
37.763 -キーストアのインポート
37.764 +若鴻≪ゃ潟若
37.765 .LP
37.766 .RS 3
37.767
37.768 .LP
37.769 .LP
37.770 -コマンド「importkeystore」を使えば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使ってターゲットキーストア内にインポートされることを意味します。このコマンドを使えば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲットキーストア内の新しいエントリはすべて、元と同じ別名および (秘密鍵や非公開鍵の場合は) 保護用パスワードを持ちます。ソースキーストア内の非公開鍵や秘密鍵の回復時に問題が発生した場合、\f3keytool\fP はユーザにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザに新しい別名の入力を求めます。ユーザは、新しい別名を指定することも、単純に既存の別名の上書きを \f3keytool\fP に許可することもできます。
37.771 +潟潟importkeystore篏帥違若鴻≪篏ャ若鴻√ゃ潟若с障 泣荐惹吾c純若鴻若鴻√鴻潟筝潟潟篏帥c帥若蚊若鴻√ゃ潟若潟障潟潟篏帥違違帥ゃ若鴻√障潟ゃ潟若с障ゃ潟若帥若蚊若鴻√違潟鴻ュ (腱絲泣泣翫) 篆茘欠鴻若<障純若鴻若鴻√泣腱絲泣緇馹榊翫\f3keytool\fP 若吟若鴻若ュ羆障潟潟ュ茲罎冴若吟若違ュュ羆障 若吟若違ュ絎膣√ュ筝吾 \f3keytool\fP 荐怨с障
37.772 .LP
37.773 .LP
37.774 -たとえば、通常の JKS タイプのキーストア key.jks 内のエントリを PKCS #11 タイプのハードウェアベースのキーストア内にインポートするには、次のコマンドを使用できます。
37.775 +違絽吾 JKS 帥ゃ若鴻 key.jks 潟 PKCS #11 帥ゃ若с≪若鴻若鴻√ゃ潟若罨<潟潟篏睡с障
37.776 .LP
37.777 .nf
37.778 \f3
37.779 @@ -681,7 +647,7 @@
37.780
37.781 .LP
37.782 .LP
37.783 -また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。そうすれば、プロンプトのまったく表示されない \f3keytool\fP コマンドを発行できます。これは、\f3keytool\fP コマンドをスクリプトファイルに含める際に非常に便利です。次に例を示します。
37.784 +障importkeystore 潟潟篏帥違純若鴻若鴻√筝潟帥若蚊若鴻≪ゃ潟若с障翫筝荐箴хず激с潟ゃ潟若絲乗院ュ絎綽荀障srcalias 激с潟絎翫帥若蚊ュ潟潟茵絎с祉腱絲/泣篆茘欠鴻若帥若蚊篆茘欠鴻若絎с障違潟障c頫腓冴 \f3keytool\fP 潟潟肴с障\f3keytool\fP 潟潟鴻<ゃ絽吾箴水с 罨<箴腓冴障
37.785 .LP
37.786 .nf
37.787 \f3
37.788 @@ -705,51 +671,51 @@
37.789 .RE
37.790
37.791 .LP
37.792 -.SH "用語と警告"
37.793 +.SH "茯茘"
37.794 .LP
37.795
37.796 .LP
37.797 .SS
37.798 -キーストア
37.799 +若鴻
37.800 .LP
37.801 .RS 3
37.802
37.803 .LP
37.804 -キーストアは、暗号化の鍵と証明書を格納するための機構です。
37.805 +若鴻≪垸泣荐惹吾主罘純с
37.806 .RE
37.807 .RS 3
37.808 .TP 2
37.809 o
37.810 -\f3キーストアのエントリ\fP
37.811 +.TP 2
37.812 +o
37.813 +\f3若鴻≪潟\fP
37.814 .RS 3
37.815
37.816 .LP
37.817 -キーストアには異なるタイプのエントリを含めることができます。\f3keytool\fP でもっとも適用範囲の広いエントリタイプは、次の 2 つです。
37.818 +若鴻≪違帥ゃ潟с障\f3keytool\fP сc膀蚊綺潟帥ゃ罨< 2 ゃс
37.819 .RS 3
37.820 .TP 3
37.821 1.
37.822 -\f3鍵のエントリ\fP \- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明連鎖を伴う非公開鍵です。
37.823 -\f3keytool\fP がこの両方のタイプのエントリを処理できるのに対し、\f3jarsigner\fP ツールは後者のタイプのエントリ、つまり非公開鍵とそれに関連付けられた証明連鎖のみを処理します。
37.824 +\f3泣潟\fP \- 潟絽吾荀垸泣宴篆障宴荐怨≪祉鴻蚊篆茘激綵≪ф主障筝腮潟主泣腱絲泣絲上泣荐惹吾с若潟篌眼泣с\f3keytool\fP 筝≧鴻帥ゃ潟с絲障\f3jarsigner\fP 若緇帥ゃ潟ゃ障泣∫d荐惹吾с若潟帥障
37.825 .TP 3
37.826 2.
37.827 -\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を 1 つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。 それは、証明書内の公開鍵が、証明書の「Subject」(所有者) によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。
37.828 +\f3篆♂若с荐惹吾潟\fP \- 潟膃筝笈┝吾 1 ゅс障荐惹吾篆♂若с荐惹吾若違障 荐惹後泣荐惹吾Subject() c劫≪ゃ潟cc若掩ャс若鴻≪篆♂若с荐惹吾肴荐惹吾臀峨篁c絎鴻篆荐若障
37.829 .RE
37.830
37.831 .LP
37.832 .RE
37.833 .TP 2
37.834 o
37.835 -\f3キーストアの別名\fP
37.836 +\f3若鴻≪ュ\fP
37.837 .RS 3
37.838 .LP
37.839 -キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。
37.840 +若鴻≪鴻潟 (泣割拭若с荐惹) 筝ュ篁≪祉鴻障
37.841 .LP
37.842 .LP
37.843 -別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明連鎖を信頼できる証明書のリストに追加したりするなど、特定のエンティティをキーストアに追加する場合です。
37.844 -これ以後、\f3keytool\fP コマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。
37.845 +ュ絎\-genseckey 潟潟篏帥c腱絲泣\-genkeypair 潟潟篏帥c泣 (泣) \-importcert 潟潟篏帥c荐惹吾障荐惹吾с若潟篆♂若с荐惹吾鴻菴遵劫潟cc若若鴻≪菴遵翫с篁ュ\f3keytool\fP 潟潟с潟cc若с翫絎ュ篏睡綽荀障
37.846 .LP
37.847 .LP
37.848 -たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明連鎖」を参照) でラップするとします。 この場合は、次のコマンドを実行します。
37.849 +違\f2duke\fP ュ篏帥c違泣泣≪泣綏援讐荐惹 (荐惹吾с若潟) с障 翫罨<潟潟絎茵障
37.850 .LP
37.851 .nf
37.852 \f3
37.853 @@ -760,7 +726,7 @@
37.854 .fi
37.855
37.856 .LP
37.857 -ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 \f2duke\fP に関連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。
37.858 +с鴻若 dukekeypasswd 絎障 篁ュュ \f2duke\fP ∫d泣≪祉鴻潟潟絎茵鴻若綽荀障duke 泣鴻若紊眼罨<潟潟絎茵障
37.859 .nf
37.860 \f3
37.861 .fl
37.862 @@ -770,44 +736,46 @@
37.863 .fi
37.864
37.865 .LP
37.866 -パスワードが、dukekeypasswd から newpass に変更されます。
37.867 +鴻若dukekeypasswd newpass 紊眼障
37.868 .LP
37.869 -注 - テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
37.870 +羈 \-鴻翫障絎сc激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с綽荀鴻若激с潟潟潟茵ф絎c翫鴻若ュ羆障
37.871 .LP
37.872 .RE
37.873 .TP 2
37.874 o
37.875 -\f3キーストアの実装\fP
37.876 +\f3若鴻≪絎茖\fP
37.877 .RS 3
37.878 -\f2java.security\fP パッケージで提供される \f2KeyStore\fP クラスには、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
37.879 +\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
37.880 .LP
37.881 -現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。\f2KeyStore\fP は public として使用可能なので、JDK ユーザは \f2KeyStore\fP を使ったほかのセキュリティアプリケーションも作成できます。
37.882 +憜\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若若鴻≪絎茖篏睡障\f2KeyStore\fP public 篏睡純сJDK 若吟若 \f2KeyStore\fP 篏帥c祉祉ャc若≪宴若激с潟篏с障
37.883 .LP
37.884 .LP
37.885 -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の完全性も (非公開鍵とは別の) パスワードによって保護されます。
37.886 +若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪<ゃ絎茖障絎茖с泣ャ鴻若c篆茘激若鴻√篏翫с (泣ャ) 鴻若c篆茘激障
37.887 .LP
37.888 .LP
37.889 -キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが Service Provider Interface のメソッドを定義しています。これらのメソッドは、「プロバイダ」が実装しなければなりません。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、「Java(TM) 暗号化アーキテクチャ用プロバイダの実装方法」で説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
37.890 +若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface <純絎臂障 <純ゃ絎茖違障сゃJava Security API c≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сc若鴻≪絎茖箴
37.891 +.na
37.892 +\f2Java(TM) 垸≪若c主ゃ絎茖号\fP @
37.893 +.fi
37.894 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
37.895 .LP
37.896 .LP
37.897 -アプリケーションでは、\f2KeyStore\fP クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。
37.898 -キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の完全性を保護するために使われるアルゴリズムを定義します。
37.899 -異なるタイプのキーストアの実装には、互換性はありません。
37.900 +≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance <<純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√/腱絲泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
37.901 .LP
37.902 .LP
37.903 -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。\f3keytool\fP は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP と \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
37.904 +\f3keytool\fP 篁紙<ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝<若鴻≪贋<ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
37.905 .LP
37.906 .LP
37.907 -\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、「キーストア」メニューによってキーストアのタイプを指定できます。
37.908 +\f3keytool\fP \f3jarsigner\fP 翫\f2\-storetype\fP 激с潟篏帥c潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP翫若鴻≪<ャ若c若鴻≪帥ゃ絎с障
37.909 .LP
37.910 .LP
37.911 -キーストアのタイプを明示的に指定しない場合、keytool、jarsigner、および policytool の各ツールは、セキュリティプロパティファイル内で指定された \f2keystore.type\fP プロパティの値に基づいてキーストアの実装を選択します。セキュリティプロパティファイルは、\f2java.security\fP という名前でセキュリティプロパティディレクトリ \f2java.home\fP/lib/security に置かれています。 \f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
37.912 +若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャc若c若<ゃф絎 \f2keystore.type\fP c若ゃ冴ャ若鴻≪絎茖御障祉ャc若c若<ゃ\f2java.security\fP с祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
37.913 .LP
37.914 .LP
37.915 -各ツールは、\f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
37.916 +若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
37.917 .LP
37.918 .LP
37.919 -\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティの値を取得できます。次のコードは、デフォルトのキーストアタイプ (\f2keystore.type\fP プロパティで指定されたタイプ) のインスタンスを生成します。
37.920 +\f2KeyStore\fP 鴻с \f2getDefaultType\fP static <純絎臂≪宴若激с潟≪<純篏帥 \f2keystore.type\fP c若ゃ緇с障罨<潟若若鴻≪帥ゃ (\f2keystore.type\fP c若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
37.921 .LP
37.922 .nf
37.923 \f3
37.924 @@ -819,7 +787,7 @@
37.925
37.926 .LP
37.927 .LP
37.928 -デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティプロパティファイル内の次の行によって指定されています。
37.929 +若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャc若c若<ゃ罨<茵c絎障
37.930 .LP
37.931 .nf
37.932 \f3
37.933 @@ -831,10 +799,10 @@
37.934
37.935 .LP
37.936 .LP
37.937 -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。
37.938 +若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障
37.939 .LP
37.940 .LP
37.941 -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
37.942 +違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨<紊眼障
37.943 .LP
37.944 .nf
37.945 \f3
37.946 @@ -845,103 +813,103 @@
37.947 .fi
37.948
37.949 .LP
37.950 -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
37.951 +羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
37.952 .RE
37.953 .RE
37.954 .SS
37.955 -証明書
37.956 +荐惹
37.957 .LP
37.958 .RS 3
37.959
37.960 .LP
37.961 -証明書 (公開鍵証明書とも呼ぶ) とは、あるエンティティ (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティ (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。
37.962 +\f3荐惹\fP (\f3笈┝\fP若) 潟cc (肴) 吾帥臀峨篁吾с 荐惹吾祉潟cc (臀峨) (潟篁) 劫ャゃc吾障
37.963 .RE
37.964 .RS 3
37.965 .TP 2
37.966 o
37.967 -\f3証明書の用語\fP
37.968 +.TP 2
37.969 +o
37.970 +\f3荐惹吾茯\fP
37.971 .RS 3
37.972
37.973 .LP
37.974 .RS 3
37.975 .TP 3
37.976 -公開鍵
37.977 -公開鍵は、特定のエンティティに関連付けられた数です。公開鍵は、該当するエンティティとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。
37.978 +
37.979 +泣劫潟cc若∫d違с 泣荅峨潟cc若篆♂若с≫ゅ荀鴻篋冴絲障潟с泣臀峨罎荐若篏帥障
37.980 .TP 3
37.981 -デジタル署名
37.982 -データが「デジタル署名」されると、そのデータは、エンティティの「アイデンティティ」と、そのエンティティがデータの内容について知っていることを証明する署名とともに格納されます。エンティティの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。
37.983 +吾帥臀峨
37.984 +若帥\f2吾帥臀峨\fP若帥潟cc若≪ゃ潟cc若潟cc若若帥絎鴻ゃャc荐惹臀峨主障潟cc若泣篏帥c若帥臀峨篁若帥初筝純障
37.985 .TP 3
37.986 -アイデンティティ
37.987 -エンティティを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティとすることができます。
37.988 +≪ゃ潟cc
37.989 +潟cc若劫∝ャ号с激鴻c泣≪ゃ潟cc若障 泣祉Unix UID 糸<若≪鴻X.509 茘ュ障障≪ゃ潟cc若с障
37.990 .TP 3
37.991 -署名
37.992 -署名は、何らかのデータを基にエンティティ (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。
37.993 +臀峨
37.994 +臀峨若帥冴潟cc (臀峨 荐惹吾≪肴若違) 泣篏帥c荐膊障
37.995 .TP 3
37.996 -非公開鍵
37.997 -非公開鍵は特定のエンティティだけが知っている数のことで、この数のことを、そのエンティティの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。
37.998 +
37.999 +泣劫潟cc若ャc違с違潟cc若泣障泣祉ャ腱絲c障 泣泣鴻究垸激鴻у障c絖障DSA 後究垸激鴻翫1 ゃ泣罩g∈ 1 ゃ泣絲上障泣臀峨荐膊篏帥障
37.1000 .TP 3
37.1001 -エンティティ
37.1002 -エンテンティは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。
37.1003 +潟cc
37.1004 +潟潟c若篋冴腟膵違潟潟ャ若帥篌罐茵筝絎綺т拭若絲乗院障障障
37.1005 .RE
37.1006
37.1007 .LP
37.1008 .LP
37.1009 -公開鍵暗号化では、その性質上、ユーザの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「認証局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティの証明書に署名する (発行する) 行為を、信頼して任されているエンティティ (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。
37.1010 +究垸сц蟹筝若吟若泣≪祉鴻綽荀障紊ц閞<若医с篋篆<潟cc守т札≫綣膓腆榊篁絎篏帥鴻泣篆♂若с吾絖篁絎筝純с泣絽≪馹茹f浦荐惹吾罅障憜с荐惹悟肴絮 (CA)篆♂若с膃筝罘純障CA 祉潟cc若荐惹吾臀峨 (肴) 茵冴篆♂若篁祉潟cc (篌罐) сCA 羈緇筝絅膣с鴻や拭若с荐惹吾篏宴障
37.1011 .na
37.1012 -\f2VeriSign\fP
37.1013 +\f2VeriSign\fP @
37.1014 .fi
37.1015 -(http://www.verisign.com/)、
37.1016 +http://www.verisign.com/
37.1017 .na
37.1018 -\f2Thawte\fP
37.1019 +\f2Thawte\fP @
37.1020 .fi
37.1021 -(http://www.thawte.com/)、
37.1022 +http://www.thawte.com/
37.1023 .na
37.1024 -\f2Entrust\fP
37.1025 +\f2Entrust\fP @
37.1026 .fi
37.1027 -(http://www.entrust.com/) をはじめ、多くの CA が存在します。
37.1028 -Netscape や Microsoft の認証サーバ、Entrust の CA 製品などを所属組織内で利用すれば、独自の認証局を運営することも可能です。
37.1029 +http://www.entrust.com/ 紊 CA 絖障Netscape Microsoft 茯荐若泣若若Entrust CA 茖遵絮腟膵у違荐惹悟肴絮吟純с
37.1030 .LP
37.1031 .LP
37.1032 -\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。
37.1033 +\f3keytool\fP 篏帥荐惹吾茵腓冴ゃ潟若潟鴻若茵с障障綏援讐荐惹吾с障
37.1034 .LP
37.1035 .LP
37.1036 -現在、\f3keytool\fP は X.509 証明書を対象にしています。
37.1037 +憜\f3keytool\fP X.509 荐惹吾絲乗院障
37.1038 .LP
37.1039 .RE
37.1040 .TP 2
37.1041 o
37.1042 -\f3X.509 証明書\fP
37.1043 +\f3X.509 荐惹\fP
37.1044 .RS 3
37.1045 -X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。
37.1046 +X.509 荀若с荐惹吾宴絎臂宴荐惹吾吾莨若号 (若水就綣) ゃ荐菴違障荐惹吾鴻若帥ASN.1/DER 若違 2 ゃ∫h若篏帥c膃垸障\f2Abstract Syntax Notation 1\fP 若帥ゃ荐菴違障\f2Definite Encoding Rules\fP 若帥篆絖活拶号ゃ荐菴違障
37.1047 .LP
37.1048 -すべての X.509 証明書は、署名のほかに次のデータを含んでいます。
37.1049 +鴻 X.509 荐惹吾臀峨祉罨<若帥с障
37.1050 .LP
37.1051 .RS 3
37.1052 .TP 3
37.1053 -バージョン
37.1054 -証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。
37.1055 -\f3keytool\fP が生成するのは、v3 の証明書です。
37.1056 +若吾с
37.1057 +荐惹吾 X.509 荀若若吾с潟劫障 荐惹吾絎с宴若吾с潟c違障障с3 ゃ若吾с潟絎臂障\f3keytool\fP сv1v2 v3 荐惹吾ゃ潟若鴻若純сkeytool v3 荐惹吾с
37.1058 .LP
37.1059 -「\f2X.509 Version 1\fP」は、1988 年から利用されて広く普及しており、もっとも一般的です。
37.1060 +X.509 Version 11988 綛眼綺c筝с
37.1061 .LP
37.1062 -「\f2X.509 Version 2\fP」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。
37.1063 +X.509 Version 2сSubject 肴усSubject 肴筝顑ュ网綽泣絨ャ障祉荐惹吾<ゃ吾с篏睡荐惹吾т茘ュ篏帥綣激ィ絅障Version 2 荐惹吾綺篏帥障
37.1064 .LP
37.1065 -「\f2X.509 Version 3\fP」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、\f2KeyUsage\fP (「署名専用」など、鍵の使用を特定の目的に制限する)、\f2AlternativeNames\fP (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティを公開鍵に関連付けることができる) などがあります。エクステンションには、\f2critical\fP というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。
37.1066 +X.509 Version 3c違 (1996 綛) 荀若с鴻潟激с潟网綽泣泣若障鴻潟激с潟茯違с絎臂с荐惹吾с障憜篏帥筝鴻潟激с潟KeyUsage (臀峨絨泣篏睡劫狗)AlternativeNames (DNS 糸<若≪鴻IP ≪鴻祉≪ゃ潟cc若泣∫dс) 障鴻潟激с潟critical 若篁鴻潟激с潟с篏睡臂ャс障違critical 若KeyCertSign 荐絎 KeyUsage 鴻潟激с潟荐惹吾障翫荐惹吾 SSL 篆>賢腓冴荐惹吾障 荐惹吾鴻潟激с潟c∫c泣荐惹吾臀峨絨絎SSL с篏睡сс
37.1067 .TP 3
37.1068 -シリアル番号
37.1069 -証明書を作成したエンティティは、そのエンティティが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。
37.1070 +激≪
37.1071 +荐惹吾篏潟cc若潟cc若肴祉荐惹吾阪ャ荐惹吾激≪垩蚊綵障宴障障号т戎障 違荐惹吾羔激≪垩荐惹吾羔鴻 (CRL) 主障
37.1072 .TP 3
37.1073 -署名アルゴリズム識別子
37.1074 -証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。
37.1075 +臀峨≪眼冴茘ュ
37.1076 +荐惹吾臀峨篁 CA 篏帥c≪眼冴劫障
37.1077 .TP 3
37.1078 -発行者名
37.1079 -証明書に署名を付けたエンティティの X.500 識別名です。エンティティは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。
37.1080 +肴
37.1081 +荐惹吾臀峨篁潟cc若 X.500 茘ュс潟cc若絽吾 CA с荐惹吾篏帥荐惹吾臀峨篁潟cc若篆♂若潟障若ゃ障 CA 荐惹吾翫c肴荳荐惹吾臀峨篁鴻羈
37.1082 .TP 3
37.1083 -有効期間
37.1084 -各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティが公開鍵を信頼できると期待される期間です。
37.1085 +号
37.1086 +荐惹吾鴻障紮ユ腟篋ユc絎亥 100 綛眼傑障御号荐惹吾吾臀峨篏帥泣綣桁墾荐惹吾蕁障障荀х違障号篏睡泣翫潟cc若泣篆♂若с緇с
37.1087 .TP 3
37.1088 -Subject 名
37.1089 -証明書で公開鍵が識別されているエンティティの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティの X.500 識別名 (DN) です。 次に例を示します。
37.1090 +Subject
37.1091 +荐惹吾у泣茘ャ潟cc若с X.500 罔羣篏帥сゃ潟帥若篏т喝障潟cc若 X.500 茘ュ (DN) с 罨<箴腓冴障
37.1092 .nf
37.1093 \f3
37.1094 .fl
37.1095 @@ -949,56 +917,56 @@
37.1096 .fl
37.1097 \fP
37.1098 .fi
37.1099 -これらはそれぞれ主体の通称、組織単位、組織、国を表します。
37.1100 +筝私腱違腟膵篏腟膵純茵障
37.1101 .TP 3
37.1102 -Subject の公開鍵情報
37.1103 -名前を付けられたエンティティの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。
37.1104 +Subject 究
37.1105 +篁潟cc若泣≪眼冴茘ュс ≪眼冴茘ュс泣絲障篏帥究垸激鴻渇∫c泣<若帥絎障
37.1106 .RE
37.1107
37.1108 .LP
37.1109 .RE
37.1110 .TP 2
37.1111 o
37.1112 -\f3証明連鎖\fP
37.1113 +\f3荐惹吾с若\fP
37.1114 .RS 3
37.1115 .LP
37.1116 -\f3keytool\fP では、非公開鍵および関連する証明「連鎖」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、連鎖の最初の証明書に含まれています。
37.1117 +\f3keytool\fP с泣渇∫c荐惹吾с若潟若鴻≪泣潟篏膊∞с障潟с泣絲上泣с若潟荐惹吾障障
37.1118 .LP
37.1119 .LP
37.1120 -鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含む連鎖が開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。\f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。
37.1121 +泣篏 (\-genkeypair 潟潟)綏援讐荐惹吾 1 ゃ荀膣с若潟紮障綏援讐荐惹吾肴 (臀峨) 筝私 (荐惹吾ц荐若泣>源) с荐惹吾с\f2\-genkeypair\fP 潟潟若喝冴違泣泣≪篏泣絽吾綏援讐荐惹吾с障
37.1122 .LP
37.1123 .LP
37.1124 -このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が認証局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明連鎖によって置き換えられます。連鎖の最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。連鎖内のその前の証明書は、「CA」の公開鍵を認証する証明書です。
37.1125 +荐惹悟讐荀羆 (CSR) (\-certreq 潟潟)CSR 荐惹悟肴絮 (CA) 篆<CA 綽膈ゃ潟若 (\-importcert 潟潟)綏援讐荐惹吾荐惹吾с若潟c臀障с若潟緇Subject 泣茯荐若 CA 肴荐惹 (綽膈) сс若喝荐惹吾CA泣茯荐若荐惹吾с
37.1126 .LP
37.1127 .LP
37.1128 -CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これは連鎖の最初の証明書になります。場合によっては、CA が証明書の連鎖を返すこともあります。この場合、連鎖内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、連鎖内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、連鎖内のその前の証明書は、次の CA の鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまで連鎖が続きます。したがって、連鎖内の (最初の証明書以後の) 各証明書では、連鎖内の次の証明書の署名者の公開鍵が認証されていることになります。
37.1129 +CA 泣茯荐若荐惹吾紊翫綏援讐荐惹 (ゃ障 CA 荳泣茯荐若荐惹) сс若潟荐惹吾障翫cCA 荐惹吾с若潟菴障翫с若喝緇荐惹 (CA c臀峨泣潟泣茯荐若荐惹) 紊障с若喝荐惹吾CSR 篆≦ CA ャCA c臀峨CSR 篆≦ CA 泣茯荐若荐惹吾障с若喝荐惹吾罨< CA 泣茯荐若荐惹吾障 篁ヤ罕綏援讐若荐惹吾障сс若潟膓障cс若喝 (荐惹娯札緇) 荐惹吾сс若喝罨<荐惹吾臀峨泣茯荐若障
37.1130 .LP
37.1131 .LP
37.1132 -多くの CA は、連鎖をサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明連鎖を確立する必要があります。
37.1133 +紊 CA с若潟泣若肴羝帥荐惹吾菴障 鴻筝 CA 絖絮ゆ翫上蕁с翫若鴻≪с主篆♂若с荐惹御宴荐惹吾с若潟腆榊綽荀障
37.1134 .LP
37.1135 .LP
37.1136 -別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明連鎖のサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。
37.1137 +ャ綽膈綵√ (PKCS#7 у臂綵√) с肴羝粋┝吾荐惹吾с若潟泣若障障\f3keytool\fP с<綽膈綵√宴с障
37.1138 .LP
37.1139 .LP
37.1140 -トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し (\f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。
37.1141 + (若) CA 荐惹吾綏援讐荐惹吾с若泣絲障篆♂若若荐惹梧篏絨冴с (違VeriSign 若 CA 茘ュ篏帥c綏援讐荐惹吾篏篏茯違с)域祉掩掩ャс若 CA 泣綺ャ障若 CA 泣荐惹吾主宴荐惹吾綵√у若с障 ゃ障荐惹吾若 CA 泣吟紵篏с若 CA 荐惹吾若鴻≪菴遵荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 激с潟篏睡)茵腓冴c潟若潟域若 CA Web 若吾ユ∝ャc潟若潟罸莠綽荀障
37.1142 .LP
37.1143 .RE
37.1144 .TP 2
37.1145 o
37.1146 -\f3cacerts 証明書ファイル\fP
37.1147 +\f3cacerts 荐惹吾<ゃ\fP
37.1148 .RS 3
37.1149 .LP
37.1150 -cacerts 証明書ファイルは、セキュリティプロパティディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
37.1151 +\f3cacerts\fP 荐惹吾<ゃ祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
37.1152 .LP
37.1153 .LP
37.1154 -cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、次の別名および X.500 所有者識別名を持ついくつかのルート CA 証明書を含んだ状態で出荷されています。
37.1155 +cacerts <ゃCA 荐惹吾激鴻篏若鴻≪с激鴻膊∞若鴻≪帥ゃ jks 絎с\f3keytool\fP 篏帥c<ゃ罕膊∞茵с障cacerts 若鴻≪<ゃ罨<ュ X.500 茘ュゃゃ若 CA 荐惹吾倶у肴激障
37.1156 .LP
37.1157 .RS 3
37.1158 .TP 2
37.1159 *
37.1160 -\f3Alias\fP: thawtepersonalfreemailca
37.1161 +\f3Alias\fP:thawtepersonalfreemailca
37.1162 .br
37.1163 -\f3Owner DN\fP: EmailAddress=personal\-freemail@thawte.com,
37.1164 +\f3Owner DN\fP:EmailAddress=personal\-freemail@thawte.com,
37.1165 .br
37.1166 CN=Thawte Personal Freemail CA,
37.1167 .br
37.1168 @@ -1007,9 +975,9 @@
37.1169 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
37.1170 .TP 2
37.1171 *
37.1172 -\f3Alias\fP: thawtepersonalbasicca
37.1173 +\f3Alias\fP:thawtepersonalbasicca
37.1174 .br
37.1175 -\f3Owner DN\fP: EmailAddress=personal\-basic@thawte.com,
37.1176 +\f3Owner DN\fP:EmailAddress=personal\-basic@thawte.com,
37.1177 .br
37.1178 CN=Thawte Personal Basic CA,
37.1179 .br
37.1180 @@ -1018,8 +986,9 @@
37.1181 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
37.1182 .TP 2
37.1183 *
37.1184 +\f3Alias\fP:thawtepersonalpremiumca
37.1185 .br
37.1186 -\f3Owner DN\fP: EmailAddress=personal\-premium@thawte.com,
37.1187 +\f3Owner DN\fP:EmailAddress=personal\-premium@thawte.com,
37.1188 .br
37.1189 CN=Thawte Personal Premium CA,
37.1190 .br
37.1191 @@ -1028,18 +997,18 @@
37.1192 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
37.1193 .TP 2
37.1194 *
37.1195 -\f3Alias\fP: thawteserverca
37.1196 +\f3Alias\fP:thawteserverca
37.1197 .br
37.1198 -\f3Owner DN\fP: EmailAddress=server\-certs@thawte.com,
37.1199 +\f3Owner DN\fP:EmailAddress=server\-certs@thawte.com,
37.1200 .br
37.1201 CN=Thawte Server CA, OU=Certification Services Division,
37.1202 .br
37.1203 O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
37.1204 .TP 2
37.1205 *
37.1206 -\f3Alias\fP: thawtepremiumserverca
37.1207 +\f3Alias\fP:thawtepremiumserverca
37.1208 .br
37.1209 -\f3Owner DN\fP: EmailAddress=premium\-server@thawte.com,
37.1210 +\f3Owner DN\fP:EmailAddress=premium\-server@thawte.com,
37.1211 .br
37.1212 CN=Thawte Premium Server CA,
37.1213 .br
37.1214 @@ -1048,37 +1017,37 @@
37.1215 O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
37.1216 .TP 2
37.1217 *
37.1218 -\f3Alias\fP: verisignclass1ca
37.1219 +\f3Alias\fP:verisignclass1ca
37.1220 .br
37.1221 -\f3Owner DN\fP: OU=Class 1 Public Primary Certification Authority,
37.1222 +\f3Owner DN\fP:OU=Class 1 Public Primary Certification Authority,
37.1223 .br
37.1224 O="VeriSign, Inc.", C=US
37.1225 .TP 2
37.1226 *
37.1227 -\f3Alias\fP: verisignclass2ca
37.1228 +\f3Alias\fP:verisignclass2ca
37.1229 .br
37.1230 -\f3Owner DN\fP: OU=Class 2 Public Primary Certification Authority,
37.1231 +\f3Owner DN\fP:OU=Class 2 Public Primary Certification Authority,
37.1232 .br
37.1233 O="VeriSign, Inc.", C=US
37.1234 .TP 2
37.1235 *
37.1236 -\f3Alias\fP: verisignclass3ca
37.1237 +\f3Alias\fP:verisignclass3ca
37.1238 .br
37.1239 -\f3Owner DN\fP: OU=Class 3 Public Primary Certification Authority,
37.1240 +\f3Owner DN\fP:OU=Class 3 Public Primary Certification Authority,
37.1241 .br
37.1242 O="VeriSign, Inc.", C=US
37.1243 .TP 2
37.1244 *
37.1245 -\f3Alias\fP: verisignserverca
37.1246 +\f3Alias\fP:verisignserverca
37.1247 .br
37.1248 -\f3Owner DN\fP: OU=Secure Server Certification Authority,
37.1249 +\f3Owner DN\fP:OU=Secure Server Certification Authority,
37.1250 .br
37.1251 O="RSA Data Security, Inc.", C=US
37.1252 .TP 2
37.1253 *
37.1254 -\f3Alias\fP: verisignclass1g2ca
37.1255 +\f3Alias\fP:verisignclass1g2ca
37.1256 .br
37.1257 -\f3Owner DN\fP: OU=VeriSign Trust Network,
37.1258 +\f3Owner DN\fP:OU=VeriSign Trust Network,
37.1259 .br
37.1260 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
37.1261 .br
37.1262 @@ -1087,18 +1056,18 @@
37.1263 O="VeriSign, Inc.", C=US
37.1264 .TP 2
37.1265 *
37.1266 -\f3Alias\fP: verisignclass1g3ca
37.1267 +\f3Alias\fP:verisignclass1g3ca
37.1268 .br
37.1269 -\f3Owner DN\fP: CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
37.1270 +\f3Owner DN\fP:CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
37.1271 .br
37.1272 OU=VeriSign Trust Network,
37.1273 .br
37.1274 O="VeriSign, Inc.", C=US
37.1275 .TP 2
37.1276 *
37.1277 -\f3Alias\fP: verisignclass2g2ca
37.1278 +\f3Alias\fP:verisignclass2g2ca
37.1279 .br
37.1280 -\f3Owner DN\fP: OU=VeriSign Trust Network,
37.1281 +\f3Owner DN\fP:OU=VeriSign Trust Network,
37.1282 .br
37.1283 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
37.1284 .br
37.1285 @@ -1107,9 +1076,9 @@
37.1286 O="VeriSign, Inc.", C=US
37.1287 .TP 2
37.1288 *
37.1289 -\f3Alias\fP: verisignclass2g3ca
37.1290 +\f3Alias\fP:verisignclass2g3ca
37.1291 .br
37.1292 -\f3Owner DN\fP: CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
37.1293 +\f3Owner DN\fP:CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
37.1294 .br
37.1295 OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
37.1296 .br
37.1297 @@ -1118,9 +1087,9 @@
37.1298 O="VeriSign, Inc.", C=US
37.1299 .TP 2
37.1300 *
37.1301 -\f3Alias\fP: verisignclass3g2ca
37.1302 +\f3Alias\fP:verisignclass3g2ca
37.1303 .br
37.1304 -\f3Owner DN\fP: OU=VeriSign Trust Network,
37.1305 +\f3Owner DN\fP:OU=VeriSign Trust Network,
37.1306 .br
37.1307 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
37.1308 .br
37.1309 @@ -1129,9 +1098,9 @@
37.1310 O="VeriSign, Inc.", C=US
37.1311 .TP 2
37.1312 *
37.1313 -\f3Alias\fP: verisignclass3g3ca
37.1314 +\f3Alias\fP:verisignclass3g3ca
37.1315 .br
37.1316 -\f3Owner DN\fP: CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
37.1317 +\f3Owner DN\fP:CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
37.1318 .br
37.1319 OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
37.1320 .br
37.1321 @@ -1140,44 +1109,37 @@
37.1322 O="VeriSign, Inc.", C=US
37.1323 .TP 2
37.1324 *
37.1325 -\f3Alias\fP: baltimorecodesigningca
37.1326 +\f3Alias\fP:baltimorecodesigningca
37.1327 .br
37.1328 -\f3Owner DN\fP: CN=Baltimore CyberTrust Code Signing Root,
37.1329 +\f3Owner DN\fP:CN=Baltimore CyberTrust Code Signing Root,
37.1330 .br
37.1331 OU=CyberTrust, O=Baltimore, C=IE
37.1332 .TP 2
37.1333 *
37.1334 -\f3Alias\fP: gtecybertrustglobalca
37.1335 +\f3Alias\fP:gtecybertrustglobalca
37.1336 .br
37.1337 -\f3Owner DN\fP: CN=GTE CyberTrust Global Root,
37.1338 +\f3Owner DN\fP:CN=GTE CyberTrust Global Root,
37.1339 .br
37.1340 OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
37.1341 .TP 2
37.1342 *
37.1343 -\f3Alias\fP: baltimorecybertrustca
37.1344 +\f3Alias\fP:baltimorecybertrustca
37.1345 .br
37.1346 -\f3Owner DN\fP: CN=Baltimore CyberTrust Root,
37.1347 +\f3Owner DN\fP:CN=Baltimore CyberTrust Root,
37.1348 .br
37.1349 OU=CyberTrust, O=Baltimore, C=IE
37.1350 .TP 2
37.1351 *
37.1352 -\f3Alias\fP: gtecybertrustca
37.1353 +\f3Alias\fP:gtecybertrust5ca
37.1354 .br
37.1355 -\f3Owner DN\fP: CN=GTE CyberTrust Root,
37.1356 -.br
37.1357 -O=GTE Corporation, C=US
37.1358 -.TP 2
37.1359 -*
37.1360 -\f3Alias\fP: gtecybertrust5ca
37.1361 -.br
37.1362 -\f3Owner DN\fP: CN=GTE CyberTrust Root 5,
37.1363 +\f3Owner DN\fP:CN=GTE CyberTrust Root 5,
37.1364 .br
37.1365 OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
37.1366 .TP 2
37.1367 *
37.1368 -\f3Alias\fP: entrustclientca
37.1369 +\f3Alias\fP:entrustclientca
37.1370 .br
37.1371 -\f3Owner DN\fP: CN=Entrust.net Client Certification Authority,
37.1372 +\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
37.1373 .br
37.1374 OU=(c) 1999 Entrust.net Limited,
37.1375 .br
37.1376 @@ -1186,9 +1148,9 @@
37.1377 O=Entrust.net, C=US
37.1378 .TP 2
37.1379 *
37.1380 -\f3Alias\fP: entrustglobalclientca
37.1381 +\f3Alias\fP:entrustglobalclientca
37.1382 .br
37.1383 -\f3Owner DN\fP: CN=Entrust.net Client Certification Authority,
37.1384 +\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
37.1385 .br
37.1386 OU=(c) 2000 Entrust.net Limited,
37.1387 .br
37.1388 @@ -1197,9 +1159,9 @@
37.1389 O=Entrust.net
37.1390 .TP 2
37.1391 *
37.1392 -\f3Alias\fP: entrust2048ca
37.1393 +\f3Alias\fP:entrust2048ca
37.1394 .br
37.1395 -\f3Owner DN\fP: CN=Entrust.net Certification Authority (2048),
37.1396 +\f3Owner DN\fP:CN=Entrust.net Certification Authority (2048),
37.1397 .br
37.1398 OU=(c) 1999 Entrust.net Limited,
37.1399 .br
37.1400 @@ -1208,9 +1170,9 @@
37.1401 O=Entrust.net
37.1402 .TP 2
37.1403 *
37.1404 -\f3Alias\fP: entrustsslca
37.1405 +\f3Alias\fP:entrustsslca
37.1406 .br
37.1407 -\f3Owner DN\fP: CN=Entrust.net Secure Server Certification Authority,
37.1408 +\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
37.1409 .br
37.1410 OU=(c) 1999 Entrust.net Limited,
37.1411 .br
37.1412 @@ -1219,9 +1181,9 @@
37.1413 O=Entrust.net, C=US
37.1414 .TP 2
37.1415 *
37.1416 -\f3Alias\fP: entrustgsslca
37.1417 +\f3Alias\fP:entrustgsslca
37.1418 .br
37.1419 -\f3Owner DN\fP: CN=Entrust.net Secure Server Certification Authority,
37.1420 +\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
37.1421 .br
37.1422 OU=(c) 2000 Entrust.net Limited,
37.1423 .br
37.1424 @@ -1230,23 +1192,23 @@
37.1425 O=Entrust.net
37.1426 .TP 2
37.1427 *
37.1428 -\f3Alias\fP: godaddyclass2ca
37.1429 +\f3Alias\fP:godaddyclass2ca
37.1430 .br
37.1431 -\f3Owner DN\fP: OU=Go Daddy Class 2 Certification Authority,
37.1432 +\f3Owner DN\fP:OU=Go Daddy Class 2 Certification Authority,
37.1433 .br
37.1434 O="The Go Daddy Group, Inc.", C=US
37.1435 .TP 2
37.1436 *
37.1437 -\f3Alias\fP: starfieldclass2ca
37.1438 +\f3Alias\fP:starfieldclass2ca
37.1439 .br
37.1440 -\f3Owner DN\fP: OU=Starfield Class 2 Certification Authority,
37.1441 +\f3Owner DN\fP:OU=Starfield Class 2 Certification Authority,
37.1442 .br
37.1443 O="Starfield Technologies, Inc.", C=US
37.1444 .TP 2
37.1445 *
37.1446 -\f3Alias\fP: valicertclass2ca
37.1447 +\f3Alias\fP:valicertclass2ca
37.1448 .br
37.1449 -\f3Owner DN\fP: EMAILADDRESS=info@valicert.com,
37.1450 +\f3Owner DN\fP:EMAILADDRESS=info@valicert.com,
37.1451 .br
37.1452 CN=http://www.valicert.com/,
37.1453 .br
37.1454 @@ -1255,109 +1217,109 @@
37.1455 O="ValiCert, Inc.", L=ValiCert Validation Network
37.1456 .TP 2
37.1457 *
37.1458 -\f3Alias\fP: geotrustglobalca
37.1459 +\f3Alias\fP:geotrustglobalca
37.1460 .br
37.1461 -\f3Owner DN\fP: CN=GeoTrust Global CA,
37.1462 +\f3Owner DN\fP:CN=GeoTrust Global CA,
37.1463 .br
37.1464 O=GeoTrust Inc., C=US
37.1465 .TP 2
37.1466 *
37.1467 -\f3Alias\fP: equifaxsecureca
37.1468 +\f3Alias\fP:equifaxsecureca
37.1469 .br
37.1470 -\f3Owner DN\fP: OU=Equifax Secure Certificate Authority,
37.1471 +\f3Owner DN\fP:OU=Equifax Secure Certificate Authority,
37.1472 .br
37.1473 O=Equifax, C=US
37.1474 .TP 2
37.1475 *
37.1476 -\f3Alias\fP: equifaxsecureebusinessca1
37.1477 +\f3Alias\fP:equifaxsecureebusinessca1
37.1478 .br
37.1479 -\f3Owner DN\fP: CN=Equifax Secure eBusiness CA\-1,
37.1480 +\f3Owner DN\fP:CN=Equifax Secure eBusiness CA\-1,
37.1481 .br
37.1482 O=Equifax Secure Inc., C=US
37.1483 .TP 2
37.1484 *
37.1485 -\f3Alias\fP: equifaxsecureebusinessca2
37.1486 +\f3Alias\fP:equifaxsecureebusinessca2
37.1487 .br
37.1488 -\f3Owner DN\fP: OU=Equifax Secure eBusiness CA\-2,
37.1489 +\f3Owner DN\fP:OU=Equifax Secure eBusiness CA\-2,
37.1490 .br
37.1491 O=Equifax Secure, C=US
37.1492 .TP 2
37.1493 *
37.1494 -\f3Alias\fP: equifaxsecureglobalebusinessca1
37.1495 +\f3Alias\fP:equifaxsecureglobalebusinessca1
37.1496 .br
37.1497 -\f3Owner DN\fP: CN=Equifax Secure Global eBusiness CA\-1,
37.1498 +\f3Owner DN\fP:CN=Equifax Secure Global eBusiness CA\-1,
37.1499 .br
37.1500 O=Equifax Secure Inc., C=US
37.1501 .TP 2
37.1502 *
37.1503 -\f3Alias\fP: soneraclass1ca
37.1504 +\f3Alias\fP:soneraclass1ca
37.1505 .br
37.1506 -\f3Owner DN\fP: CN=Sonera Class1 CA, O=Sonera, C=FI
37.1507 +\f3Owner DN\fP:CN=Sonera Class1 CA, O=Sonera, C=FI
37.1508 .TP 2
37.1509 *
37.1510 -\f3Alias\fP: soneraclass2ca
37.1511 +\f3Alias\fP:soneraclass2ca
37.1512 .br
37.1513 -\f3Owner DN\fP: CN=Sonera Class2 CA, O=Sonera, C=FI
37.1514 +\f3Owner DN\fP:CN=Sonera Class2 CA, O=Sonera, C=FI
37.1515 .TP 2
37.1516 *
37.1517 -\f3Alias\fP: comodoaaaca
37.1518 +\f3Alias\fP:comodoaaaca
37.1519 .br
37.1520 -\f3Owner DN\fP: CN=AAA Certificate Services,
37.1521 +\f3Owner DN\fP:CN=AAA Certificate Services,
37.1522 .br
37.1523 O=Comodo CA Limited, L=Salford, ST=Greater Manchester, C=GB
37.1524 .TP 2
37.1525 *
37.1526 -\f3Alias\fP: addtrustclass1ca
37.1527 +\f3Alias\fP:addtrustclass1ca
37.1528 .br
37.1529 -\f3Owner DN\fP: CN=AddTrust Class 1 CA Root,
37.1530 +\f3Owner DN\fP:CN=AddTrust Class 1 CA Root,
37.1531 .br
37.1532 OU=AddTrust TTP Network, O=AddTrust AB, C=SE
37.1533 .TP 2
37.1534 *
37.1535 -\f3Alias\fP: addtrustexternalca
37.1536 +\f3Alias\fP:addtrustexternalca
37.1537 .br
37.1538 -\f3Owner DN\fP: CN=AddTrust External CA Root,
37.1539 +\f3Owner DN\fP:CN=AddTrust External CA Root,
37.1540 .br
37.1541 OU=AddTrust External TTP Network, O=AddTrust AB, C=SE
37.1542 .TP 2
37.1543 *
37.1544 -\f3Alias\fP: addtrustqualifiedca
37.1545 +\f3Alias\fP:addtrustqualifiedca
37.1546 .br
37.1547 -\f3Owner DN\fP: CN=AddTrust Qualified CA Root,
37.1548 +\f3Owner DN\fP:CN=AddTrust Qualified CA Root,
37.1549 .br
37.1550 OU=AddTrust TTP Network, O=AddTrust AB, C=SE
37.1551 .TP 2
37.1552 *
37.1553 -\f3Alias\fP: utnuserfirsthardwareca
37.1554 +\f3Alias\fP:utnuserfirsthardwareca
37.1555 .br
37.1556 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Hardware,
37.1557 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Hardware,
37.1558 .br
37.1559 OU=http://www.usertrust.com, O=The USERTRUST Network,
37.1560 .br
37.1561 L=Salt Lake City, ST=UT, C=US
37.1562 .TP 2
37.1563 *
37.1564 -\f3Alias\fP: utnuserfirstclientauthemailca
37.1565 +\f3Alias\fP:utnuserfirstclientauthemailca
37.1566 .br
37.1567 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Client Authentication and Email,
37.1568 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Client Authentication and Email,
37.1569 .br
37.1570 OU=http://www.usertrust.com, O=The USERTRUST Network,
37.1571 .br
37.1572 L=Salt Lake City, ST=UT, C=US
37.1573 .TP 2
37.1574 *
37.1575 -\f3Alias\fP: utndatacorpsgcca
37.1576 +\f3Alias\fP:utndatacorpsgcca
37.1577 .br
37.1578 -\f3Owner DN\fP: CN=UTN \- DATACorp SGC,
37.1579 +\f3Owner DN\fP:CN=UTN \- DATACorp SGC,
37.1580 .br
37.1581 OU=http://www.usertrust.com, O=The USERTRUST Network,
37.1582 .br
37.1583 L=Salt Lake City, ST=UT, C=US
37.1584 .TP 2
37.1585 *
37.1586 -\f3Alias\fP: utnuserfirstobjectca
37.1587 +\f3Alias\fP:utnuserfirstobjectca
37.1588 .br
37.1589 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Object,
37.1590 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Object,
37.1591 .br
37.1592 OU=http://www.usertrust.com, O=The USERTRUST Network,
37.1593 .br
37.1594 @@ -1366,18 +1328,18 @@
37.1595
37.1596 .LP
37.1597 .LP
37.1598 -cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。
37.1599 +cacerts 若鴻≪<ゃ鴻若changeit с激鴻膊∞SDK ゃ潟鴻若緇<ゃ鴻若≪祉号┤紊眼綽荀障
37.1600 .LP
37.1601 .RS 3
37.1602
37.1603 .LP
37.1604
37.1605 .LP
37.1606 -\f3重要: \fP\f4cacerts\fP\f3 ファイルを確認してください。\fP
37.1607 +\f3荀:\fP\f4cacerts\fP\f3 <ゃ腆肴\fP
37.1608 .br
37.1609
37.1610 .LP
37.1611 -\f2cacerts\fP ファイル内の CA は、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\f2cacerts\fP ファイルの管理は慎重に行う必要があります。\f2cacerts\fP ファイルには、信頼する CA の証明書だけが含まれていなければなりません。ユーザは、自身の責任において、\f2cacerts\fP ファイルにバンドルされている信頼できるルート CA 証明書を検証し、信頼性に関する独自の決定を行います。信頼できない CA 証明書を \f2cacerts\fP ファイルから削除するには、\f2keytool\fP コマンドの削除オプションを使用します。\f2cacerts\fP ファイルは JRE のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。
37.1612 +\f2cacerts\fP <ゃ CA 臀峨割潟cc若吾荐惹悟肴潟cc若篆♂若\f2cacerts\fP <ゃ膊∞茵綽荀障\f2cacerts\fP <ゃ篆♂若 CA 荐惹吾障違障若吟若荳莢篁祉\f2cacerts\fP <ゃ潟篆♂若с若 CA 荐惹吾罎荐若篆♂惹с≪羆阪茵障篆♂若с CA 荐惹吾 \f2cacerts\fP <ゃゃ\f2keytool\fP 潟潟ゃ激с潟篏睡障\f2cacerts\fP <ゃ JRE ゃ潟鴻若c障<ゃ膩≪祉号┤翫激鴻膊∞g機
37.1613 .br
37.1614
37.1615 .LP
37.1616 @@ -1387,23 +1349,22 @@
37.1617 .RE
37.1618 .TP 2
37.1619 o
37.1620 -\f3インターネット RFC 1421 証明書符号化規格\fP
37.1621 +\f3ゃ潟帥若 RFC 1421 荐惹悟垸荀\fP
37.1622 .RS 3
37.1623 .LP
37.1624 -多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。
37.1625 +紊翫荐惹吾ゃ膃垸сゃ潟帥若 RFC 1421 荀若у臂阪順垸劫篏帥c主障Base 64 膃垸若違荐惹後就綣с糸<若篁罘罕祉≪宴若激с潟荐惹吾絎号鴻若с障
37.1626 .LP
37.1627 .LP
37.1628 -\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。
37.1629 +\f2\-importcert\fP 潟潟 \f2\-printcert\fP 潟潟с綵√荐惹吾ゃ膃垸荐惹吾茯粋昭с障
37.1630 .LP
37.1631 .LP
37.1632 -\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。
37.1633 -ただし、\f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。
37.1634 +\f2\-exportcert\fP 潟潟ссゃ膃垸荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障
37.1635 .LP
37.1636 .LP
37.1637 -\f2\-list\fP コマンドでは、デフォルトで証明書の MD5 フィンガープリントが出力されます。\f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、\f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。
37.1638 +\f2\-list\fP 潟潟сц┝吾 MD5 c潟若潟阪障\f2\-v\fP 激с潟絎篋咲茯с綵√ц┝吾阪障 筝鴻\f2\-rfc\fP 激с潟絎阪順垸劫ц┝吾阪障
37.1639 .LP
37.1640 .LP
37.1641 -出力可能符号化方式で符号化された証明書は、次の行で始まります。
37.1642 +阪順垸劫х垸荐惹吾罨<茵у障障
37.1643 .LP
37.1644 .nf
37.1645 \f3
37.1646 @@ -1415,7 +1376,7 @@
37.1647
37.1648 .LP
37.1649 .LP
37.1650 -最後は、次の行で終わります。
37.1651 +緇罨<茵х障
37.1652 .LP
37.1653 .nf
37.1654 \f3
37.1655 @@ -1429,36 +1390,36 @@
37.1656
37.1657 .LP
37.1658 .SS
37.1659 -X.500 識別名
37.1660 +X.500 茘ュ
37.1661 .LP
37.1662 .RS 3
37.1663
37.1664 .LP
37.1665 -X.500 識別名は、エンティティを特定するために使われます。 たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。
37.1666 +X.500 茘ュ潟cc若劫篏帥障 違X.509 荐惹吾 \f2subject\fP c若 \f2issuer\fP (臀峨) c若ф絎X.500 茘ュс \f3keytool\fP 罨<泣若泣若障
37.1667 .RS 3
37.1668 .TP 2
37.1669 o
37.1670 -\f2commonName\fP \- 人の通称。「Susan Jones」など
37.1671 +\f2commonName\fP \- 篋冴腱違 Susan Jones
37.1672 .TP 2
37.1673 o
37.1674 -\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。「仕入部」など
37.1675 +\f2organizationUnit\fP \- 絨腟膵 (茯蚊) 腱違 篁ラ
37.1676 .TP 2
37.1677 o
37.1678 -\f2organizationName\fP \- 大きな組織の名称。「ABCSystems, Inc.」など
37.1679 +\f2organizationName\fP \- 紊с腟膵腱違 ABCSystems, Inc.
37.1680 .TP 2
37.1681 o
37.1682 -\f2localityName\fP \- 地域 (都市) 名。「Palo Alto」など
37.1683 +\f2localityName\fP \- 医 (遵) Palo Alto
37.1684 .TP 2
37.1685 o
37.1686 -\f2stateName\fP \- 州名または地方名。「California」など
37.1687 +\f2stateName\fP \- 綏障井劫 California
37.1688 .TP 2
37.1689 o
37.1690 -\f2country\fP \- 2 文字の国番号。「CH」など
37.1691 +\f2country\fP \- 2 絖順垩 CH
37.1692 .RE
37.1693
37.1694 .LP
37.1695 .LP
37.1696 -\f2\-genkeypair\fP コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、次の形式で指定する必要があります。
37.1697 +\f2\-genkeypair\fP 潟潟 \f2\-dname\fP 激с潟ゃ茘ュ絖絎翫罨<綵√ф絎綽荀障
37.1698 .LP
37.1699 .nf
37.1700 \f3
37.1701 @@ -1470,7 +1431,7 @@
37.1702
37.1703 .LP
37.1704 .LP
37.1705 -イタリック体の項目は、実際に指定する値を表します。短縮形のキーワードの意味は、次のとおりです。
37.1706 +ゃ帥篏絎絎ゃ茵障 膰綵≪若若潟罨<с
37.1707 .LP
37.1708 .nf
37.1709 \f3
37.1710 @@ -1492,7 +1453,7 @@
37.1711
37.1712 .LP
37.1713 .LP
37.1714 -次に示すのは、識別名文字列の例です。
37.1715 +罨<腓冴茘ュ絖箴с
37.1716 .LP
37.1717 .nf
37.1718 \f3
37.1719 @@ -1503,7 +1464,7 @@
37.1720 .fi
37.1721
37.1722 .LP
37.1723 -次は、この文字列を使ったコマンドの例です。
37.1724 +罨<絖篏帥c潟潟箴с
37.1725 .nf
37.1726 \f3
37.1727 .fl
37.1728 @@ -1516,10 +1477,10 @@
37.1729
37.1730 .LP
37.1731 .LP
37.1732 -キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。
37.1733 +若若膰綵≪с紊ф絖絨絖阪ャ障違CNcn Cn 宴障
37.1734 .LP
37.1735 .LP
37.1736 -一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。
37.1737 +筝鴻若若絎綺潟泣潟潟若潟筝腓冴綺ф絎綽荀障泣潟潟若潟鴻絎綽荀障違罨<筝泣潟潟若潟絎с障
37.1738 .LP
37.1739 .nf
37.1740 \f3
37.1741 @@ -1531,7 +1492,7 @@
37.1742
37.1743 .LP
37.1744 .LP
37.1745 -識別名文字列の値にコンマが含まれる場合に、コマンド行の文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。
37.1746 +茘ュ絖ゃ潟潟障翫潟潟茵ф絖絎罨<潟潟絖 \\ с鴻宴若綽荀障
37.1747 .LP
37.1748 .nf
37.1749 \f3
37.1750 @@ -1543,19 +1504,18 @@
37.1751
37.1752 .LP
37.1753 .LP
37.1754 -識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。
37.1755 +茘ュ絖潟潟茵ф絎綽荀障茘ュ綽荀潟潟絎茵潟潟茵цュ絎c翫泣潟潟若潟ュ羆障翫潟潟絖 \\ с鴻宴若綽荀障
37.1756 .LP
37.1757 .RE
37.1758 .SS
37.1759 -信頼できる証明書のインポートに関する注意事項
37.1760 +篆♂若с荐惹吾ゃ潟若≪羈鋋
37.1761 .LP
37.1762 .RS 3
37.1763
37.1764 .LP
37.1765 -重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。
37.1766 +荀:篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾絎鴻茯帥鴻
37.1767 .LP
37.1768 -まず、証明書の内容を表示し (\f2\-printcert\fP コマンドを使用するか、または \f2\-noprompt\fP オプションを指定しないで \f2\-importcert\fP コマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。
37.1769 -たとえば、あるユーザから証明書が送られてきて、この証明書を \f2/tmp/cert\fP という名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
37.1770 +障荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f2\-import\fP 潟潟篏睡)茵腓冴荐惹吾c潟若潟緇c潟若潟筝眼腆肴障違若吟若荐惹吾荐惹吾 \f2/tmp/cert\fP с<ゃ主障翫篆♂若с荐惹吾鴻荐惹吾菴遵\f2\-printcert\fP 潟潟絎茵c潟若潟茵腓冴с障 違罨<障
37.1771 .LP
37.1772 .nf
37.1773 \f3
37.1774 @@ -1580,119 +1540,106 @@
37.1775 .fi
37.1776
37.1777 .LP
37.1778 -次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。
37.1779 +罨<荐惹吾篆<篋榊g機篋榊腓冴c潟若潟筝潟潟ц;腓冴c潟若潟罸莠障c潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙c臀峨鴻 (紙潟ゃ鴻<ゃ JAR <ゃ) 篆♂若障
37.1780 .LP
37.1781 -注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。
37.1782 -\f2\-importcert\fP コマンドを実行すると、キーストア内の信頼できる証明書のリストに証明書を追加する前に、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\f2\-importcert\fP コマンドを \f2\-noprompt\fP オプションを指定せずに実行した場合だけです。
37.1783 -\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
37.1784 +羈:荐惹吾ゃ潟若綽 \f2\-printcert\fP 潟潟絎茵違с障 若鴻√篆♂若с荐惹吾鴻荐惹吾菴遵 \f2\-importcert\fP 潟潟絎茵荐惹吾宴茵腓冴腆肴羆<祉若吾茵腓冴障ゃ潟若篏鴻т賢罩≪с障腆肴<祉若吾茵腓冴\f2\-importcert\fP 潟潟 \f2\-noprompt\fP 激с潟絎絎茵翫с\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
37.1785 .LP
37.1786 .RE
37.1787 .SS
37.1788 -パスワードに関する注意事項
37.1789 +鴻若≪羈鋋
37.1790 .LP
37.1791 .RS 3
37.1792
37.1793 .LP
37.1794 .LP
37.1795 -キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。
37.1796 -また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。
37.1797 +若鴻≪絲障篏茵祉潟潟с鴻≪鴻若綽荀с障筝潟潟с/腱絲泣鴻若綽荀障
37.1798 .LP
37.1799 .LP
37.1800 -パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
37.1801 +鴻若潟潟茵ф絎с障 (鴻≪鴻若 \f2\-storepass\fP 激с潟泣鴻若 \f2\-keypass\fP 激с潟篏睡)鴻翫障絎сc激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с
37.1802 .LP
37.1803 .LP
37.1804 -必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
37.1805 +綽荀鴻若激с潟潟潟茵ф絎c翫鴻若ュ羆障
37.1806 .LP
37.1807 .RE
37.1808 -.SH "関連項目"
37.1809 +.SH "∫i"
37.1810 .LP
37.1811
37.1812 .LP
37.1813 .RS 3
37.1814 .TP 2
37.1815 o
37.1816 -.fi
37.1817 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jar.html
37.1818 -の
37.1819 -.na
37.1820 -「\f2jar\fP」ツールのドキュメント
37.1821 +.LP
37.1822 +jar(1) 若ャ<潟
37.1823 .TP 2
37.1824 o
37.1825 -.fi
37.1826 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html
37.1827 -の
37.1828 -.na
37.1829 -「\f2jarsigner\fP」ツールのドキュメント
37.1830 +.LP
37.1831 +jarsigner(1) 若ャ<潟
37.1832 .TP 2
37.1833 o
37.1834 -\f3keytool\fP の使用例については、
37.1835 +.LP
37.1836 +\f3keytool\fP 篏睡箴ゃ
37.1837 +.na
37.1838 +\f4Java Tutorial\fP @
37.1839 .fi
37.1840 -http://java.sun.com/docs/books/tutorial/security/index.html
37.1841 -の
37.1842 +http://java.sun.com/docs/books/tutorial
37.1843 .na
37.1844 -「\f4Java Tutorial\fP」にある
37.1845 +\f4Security\fP @
37.1846 .fi
37.1847 -http://java.sun.com/docs/books/tutorial/trailmap.html
37.1848 -の
37.1849 -.na
37.1850 -「\f4Security\fP」トレール
37.1851 +http://java.sun.com/docs/books/tutorial/security/index.html
37.1852 .RE
37.1853
37.1854 .LP
37.1855 -.SH "変更点"
37.1856 +.SH "紊雁"
37.1857 .LP
37.1858
37.1859 .LP
37.1860 .LP
37.1861 -Java SE 6 で keytool のコマンドインタフェースが変更されました。
37.1862 +Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障
37.1863 .LP
37.1864 .LP
37.1865 -\f3keytool\fP は、ユーザがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。
37.1866 +\f3keytool\fP 若吟若鴻若ュュ絎鴻茵腓冴障若吟若鴻若ュュ絎鴻腆肴сc若鴻≪鴻若荐絎泣鴻若紊眼鴻若荐絎紊眼茵潟鴻若ュ羆障
37.1867 .LP
37.1868 .LP
37.1869 -変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。
37.1870 +紊眼潟潟筝紊眼違綮罩≪ャ<潟荐莠c障篁ュ鴻潟潟 (紊眼綮罩≪筝≧) 若鴻с綣膓泣若篁緇若鴻с泣若篋絎сkeytool 潟潟ゃ潟帥с若鴻鴻紊雁鴻网荀罨<腓冴障
37.1871 .LP
37.1872 .LP
37.1873 -名前が変更されたコマンド:
37.1874 +紊眼潟潟:
37.1875 .LP
37.1876 .RS 3
37.1877 .TP 2
37.1878 o
37.1879 -\f2\-export\fP の名前が \f2\-exportcert\fP に変更
37.1880 +\f2\-export\fP \f2\-exportcert\fP 紊
37.1881 .TP 2
37.1882 o
37.1883 -\f2\-genkey\fP の名前が \f2\-genkeypair\fP に変更
37.1884 +\f2\-genkey\fP \f2\-genkeypair\fP 紊
37.1885 .TP 2
37.1886 o
37.1887 -\f2\-import\fP の名前が \f2\-importcert\fP に変更
37.1888 +\f2\-import\fP \f2\-importcert\fP 紊
37.1889 .RE
37.1890
37.1891 .LP
37.1892 .LP
37.1893 -廃止されてドキュメントに記載されなくなったコマンド:
37.1894 +綮罩≪ャ<潟荐莠c潟潟:
37.1895 .LP
37.1896 .RS 3
37.1897 .TP 2
37.1898 o
37.1899 +.na
37.1900 +\f2\-keyclone\fP @
37.1901 .fi
37.1902 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#keycloneCmd
37.1903 -の
37.1904 -.na
37.1905 -\f2\-keyclone\fP
37.1906 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#keycloneCmd
37.1907 .TP 2
37.1908 o
37.1909 +.na
37.1910 +\f2\-identitydb\fP @
37.1911 .fi
37.1912 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#identitydbCmd
37.1913 -の
37.1914 -.na
37.1915 -\f2\-identitydb\fP
37.1916 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#identitydbCmd
37.1917 .TP 2
37.1918 o
37.1919 +.na
37.1920 +\f2\-selfcert\fP @
37.1921 .fi
37.1922 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#selfcertCmd
37.1923 -の
37.1924 -.na
37.1925 -\f2\-selfcert\fP
37.1926 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#selfcertCmd
37.1927 .RE
37.1928
37.1929 .LP
38.1 --- a/src/linux/doc/man/ja/native2ascii.1 Tue May 12 15:21:55 2009 +0900
38.2 +++ b/src/linux/doc/man/ja/native2ascii.1 Thu May 14 00:17:25 2009 -0700
38.3 @@ -1,103 +1,83 @@
38.4 -'\" t
38.5 -.\"
38.6 -.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
38.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
38.8 -.\"
38.9 -.\" This code is free software; you can redistribute it and/or modify it
38.10 -.\" under the terms of the GNU General Public License version 2 only, as
38.11 -.\" published by the Free Software Foundation.
38.12 -.\"
38.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
38.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
38.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
38.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
38.17 -.\" accompanied this code).
38.18 -.\"
38.19 -.\" You should have received a copy of the GNU General Public License version
38.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
38.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
38.22 -.\"
38.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
38.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
38.25 -.\" have any questions.
38.26 -.\"
38.27 -.\"
38.28 -.TH native2ascii 1 "2004 年 6 月 22 日"
38.29 -.SH "名前"
38.30 -native2ascii \- ネイティブコードから ASCII への変換
38.31 -.\"
38.32 -.\" This document was created by saving an HTML file as text
38.33 -.\" from the JavaSoft web site:
38.34 -.\"
38.35 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
38.36 -.\"
38.37 -.\" and adding appropriate troff macros. Because the JavaSoft web site
38.38 -.\" man pages can change without notice, it may be helpful to diff
38.39 -.\" files to identify changes other than new functionality.
38.40 -.\"
38.41 -.SH "形式"
38.42 -.B native2ascii
38.43 -[
38.44 -.B options
38.45 -]
38.46 -.if n .ti +5n
38.47 -[
38.48 -.IR inputfile " [" outputfile "]]"
38.49 -.SH "機能説明"
38.50 -.IX "native to ASCII converter" "" "native to ASCII converter \(em \fLnative2ascii\fP"
38.51 -.IX "native2ascii" "" "\fLnative2ascii\fP \(em native to ASCII converter"
38.52 -Java コンパイラなどの
38.53 -Java
38.54 -ツールが処理できるファイルは、
38.55 -Latin-1
38.56 -文字もしくは\^
38.57 -Unicode
38.58 -でエンコードされた文字
38.59 -(\\udddd)
38.60 -からなるファイルだけです。
38.61 -.B native2ascii
38.62 -は、他の文字コードのファイルを
38.63 -Latin-1
38.64 -または
38.65 -Unicode
38.66 -エンコーディングのファイルに変換します。
38.67 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
38.68 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
38.69 +."
38.70 +." This code is free software; you can redistribute it and/or modify it
38.71 +." under the terms of the GNU General Public License version 2 only, as
38.72 +." published by the Free Software Foundation.
38.73 +."
38.74 +." This code is distributed in the hope that it will be useful, but WITHOUT
38.75 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
38.76 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
38.77 +." version 2 for more details (a copy is included in the LICENSE file that
38.78 +." accompanied this code).
38.79 +."
38.80 +." You should have received a copy of the GNU General Public License version
38.81 +." 2 along with this work; if not, write to the Free Software Foundation,
38.82 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
38.83 +."
38.84 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
38.85 +." CA 95054 USA or visit www.sun.com if you need additional information or
38.86 +." have any questions.
38.87 +."
38.88 +.TH native2ascii 1 "04 May 2009"
38.89 +." Generated from HTML by html2man (author: Eric Armstrong)
38.90 +
38.91 .LP
38.92 -.I outputfile
38.93 -引数を省略すると、出力先は標準出力となります。
38.94 -また、
38.95 -.I inputfile
38.96 -引数を省略すると、入力元は標準入力となります。
38.97 -.SH "オプション"
38.98 -以下のオプションが使用できます。
38.99 -.TP 5
38.100 -.B \-encoding \f2encoding_name\f1
38.101 -変換処理で用いるエンコーディング名を指定します。
38.102 -デフォルトのエンコーディング名は、システムプロパティの
38.103 -\f3file.encoding\f1
38.104 -から得られます。
38.105 -.I encoding_name
38.106 -文字列は、ドキュメント「サポートされているエンコーディング」の、
38.107 -サポートされるエンコーディングの表で最初の列にある文字列の 1 つでなければ
38.108 -なりません。
38.109 +.SH ""
38.110 +native2ascii \- ゃc \- ASCII 潟潟若
38.111 +.LP
38.112 +.RS 3
38.113 +
38.114 +.LP
38.115 +.LP
38.116 +ゃc潟若 (Latin 1 Unicode 篁ュ) <ゃ Unicode 潟若紊障
38.117 +.LP
38.118 +.RE
38.119 +.SH "綵√"
38.120 +.LP
38.121 +
38.122 +.LP
38.123 +.nf
38.124 +\f3
38.125 +.fl
38.126 +\fP\f4native2ascii\fP\f2 [options] [inputfile [outputfile]]\fP
38.127 +.fl
38.128 +.fi
38.129 +
38.130 +.LP
38.131 +.SH "茯"
38.132 +.LP
38.133 +
38.134 +.LP
38.135 +.LP
38.136 +Java 潟潟ゃ潟篁 Java 若Latin\-1 障 Unicode 潟若 (\\udddd 茵荐) 絖<ゃс障 \f2native2ascii\fP 篁ュ絖潟若<ゃ Latin\-1 障 Unicode 潟若<ゃ紊障
38.137 +.LP
38.138 +.LP
38.139 +\f2outputfile\fP ャ翫罔羣阪阪障\f2inputfile\fP ャ翫罔羣ュュ障
38.140 +.LP
38.141 +.SH "激с"
38.142 +.LP
38.143 +
38.144 +.LP
38.145 +.RS 3
38.146 +.TP 3
38.147 +\-reverse
38.148 +茵障ゃ障Latin\-1 障 Unicode 潟若<ゃゃc潟若紊障
38.149 .br
38.150 -http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
38.151 -.\" http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
38.152 -.TP 5
38.153 -.B \-reverse
38.154 -逆の変換処理を行います。つまり
38.155 -Latin-1
38.156 -または
38.157 -Unicode
38.158 -でエンコーディングされている文字を、ネイティブコードに変換します。
38.159 -.TP 15
38.160 -.BI \-J "option"
38.161 -.I option
38.162 -を Java 仮想マシンに渡します。ここで、
38.163 -.I option
38.164 -は、Java アプリケーション起動プログラム java(1) のマニュアルページで
38.165 -説明されているオプションの 1 つです。たとえば、
38.166 -.I \-J-Xms48m
38.167 -は、起動時に使用するメモリを 48M バイトに設定します。
38.168 -.B \-J
38.169 -が基本となる仮想マシンにオプションを渡すことは、共通の規約です。
38.170 +.br
38.171 +.TP 3
38.172 +\-encoding encoding_name
38.173 +紊т戎潟若絎障潟若激鴻c若 \f2file.encoding\fP 緇障\f2encoding_name\fP 絖
38.174 +.na
38.175 +\f4泣若潟潟若c潟違\fP @
38.176 +.fi
38.177 +http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlャ<潟腓冴泣若潟潟若c潟違茵緇綽荀障
38.178 +.TP 3
38.179 +\-Joption
38.180 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
38.181 +.RE
38.182
38.183 +.LP
38.184 +
38.185 +.LP
38.186 +
39.1 --- a/src/linux/doc/man/ja/orbd.1 Tue May 12 15:21:55 2009 +0900
39.2 +++ b/src/linux/doc/man/ja/orbd.1 Thu May 14 00:17:25 2009 -0700
39.3 @@ -1,42 +1,46 @@
39.4 -'\" t
39.5 -.\"
39.6 -.\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
39.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
39.8 -.\"
39.9 -.\" This code is free software; you can redistribute it and/or modify it
39.10 -.\" under the terms of the GNU General Public License version 2 only, as
39.11 -.\" published by the Free Software Foundation.
39.12 -.\"
39.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
39.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
39.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
39.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
39.17 -.\" accompanied this code).
39.18 -.\"
39.19 -.\" You should have received a copy of the GNU General Public License version
39.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
39.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
39.22 -.\"
39.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
39.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
39.25 -.\" have any questions.
39.26 -.\"
39.27 -.\"
39.28 -.TH orbd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
39.29 -.SH "名前"
39.30 -orbd - Object Request Broker デーモン
39.31 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
39.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
39.33 +."
39.34 +." This code is free software; you can redistribute it and/or modify it
39.35 +." under the terms of the GNU General Public License version 2 only, as
39.36 +." published by the Free Software Foundation.
39.37 +."
39.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
39.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
39.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
39.41 +." version 2 for more details (a copy is included in the LICENSE file that
39.42 +." accompanied this code).
39.43 +."
39.44 +." You should have received a copy of the GNU General Public License version
39.45 +." 2 along with this work; if not, write to the Free Software Foundation,
39.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
39.47 +."
39.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
39.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
39.50 +." have any questions.
39.51 +."
39.52 +.TH orbd 1 "04 May 2009"
39.53 +." Generated from HTML by html2man (author: Eric Armstrong)
39.54 +
39.55 .LP
39.56 -.B orbd
39.57 -は、クライアントが CORBA 環境内のサーバー上に存在する
39.58 -持続オブジェクトを透過的に特定して呼び出す場合に使用します。
39.59 +.SH ""
39.60 +orbd \- The Object Request Broker Daemon
39.61 .LP
39.62 -\f3関連項目:\fP
39.63 +.RS 3
39.64 +
39.65 +.LP
39.66 +.LP
39.67 +\f3orbd\fP ゃ≪潟 CORBA 医泣若若膓吾с罎膣≪若喝冴篏睡障
39.68 +.LP
39.69 +.LP
39.70 +\f3∫i:\fP
39.71 .na
39.72 -\f2「Naming Service」\fP
39.73 +\f2若泣若\fP @
39.74 .fi
39.75 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
39.76 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
39.77 .LP
39.78 -.SH "形式"
39.79 +.RE
39.80 +.SH "綵√"
39.81 .LP
39.82
39.83 .LP
39.84 @@ -49,86 +53,118 @@
39.85 .fi
39.86
39.87 .LP
39.88 -.SH "機能説明"
39.89 -\f3orbd\fP ツールを含むサーバーマネージャは、クライアントが CORBA 環境内のサーバー上に存在する持続オブジェクトを透過的に特定して呼び出す場合に使用します。持続サーバーは、ネームサービス内の持続オブジェクト参照を発行する一方で、オブジェクト参照内にサーバーのポート番号ではなく ORBD のポート番号を組み込みます。持続オブジェクト参照のためにオブジェクト参照内に ORBD ポート番号を組み込むと、以下の利点が得られます。
39.90 +.SH "茯"
39.91 +.LP
39.92 +
39.93 +.LP
39.94 +.LP
39.95 +\f3orbd\fP 若障泣若若若吾c若篏帥ゃ≪潟 CORBA 医с泣若寂膓吾с罎膣≪若喝冴с障膓泣若若若泣若鴻膓吾сс肴泣若若若垩篁c OBRD 若垩吾сс障膓吾сс吾сс ORBD 若垩罨<鴻障
39.96 .LP
39.97 .RS 3
39.98 .TP 2
39.99 -*
39.100 -ネームサービス内のオブジェクト参照は、サーバーのライフサイクルとは無関係に維持されます。たとえば、オブジェクト参照はサーバーの最初のインストール時にネームサービス内でサーバーによって発行され、その後は何度サーバーの起動または停止が行われても ORBD は常に呼び出し側のクライアントに正しいオブジェクト参照を返します。
39.101 +o
39.102 +若泣若鴻吾сс泣若若ゃ帥ゃ♂≫吾сс紮ゃ潟鴻若若泣若鴻泣若若若泣若鴻肴障緇泣若若紮障激c潟違ORBD ゃс若喝冴ゃ≪潟罩c吾сс菴障
39.103 .TP 2
39.104 -*
39.105 -クライアントはネームサービス内でオブジェクト参照を 1 度確認する必要があり、サーバーのライフサイクルが原因で起きる変更に関係なくこの参照を繰り返し使用できます。
39.106 +o
39.107 +ゃ≪潟筝綺若潟違泣若鴻吾сс≪綽荀緇泣若若ゃ帥ゃ紊眼♂≫сс
39.108 .RE
39.109
39.110 .LP
39.111 .LP
39.112 -ORBD のサーバーマネージャにアクセスするには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2サーバーマネージャ\fPの詳細については、このドキュメントの「サーバーマネージャ」の節を参照してください。
39.113 +ORBD 泣若若若吾c若≪祉鴻servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激c潟茵潟潟茵ゃ潟帥с若鴻с泣若若若吾c若荅括完ゃャ<潟\f2泣若若若吾c若\fPс
39.114 .LP
39.115 .LP
39.116 -\f2orbd\fP の起動時にはネームサービスも起動されます。ネームサービスの詳細については、
39.117 +\f2orbd\fP 莎桁若泣若鴻莎桁障若泣若鴻ゃ
39.118 .na
39.119 -「\f2Naming Service\fP」
39.120 +\f2若泣若鴻\fP @
39.121 .fi
39.122 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
39.123 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
39.124 .LP
39.125 -.SH 必須オプション
39.126 +.SH "激с"
39.127 +.LP
39.128 +.SS
39.129 +綽激с
39.130 +.LP
39.131 +.RS 3
39.132 +.TP 3
39.133 +\-ORBInitialPort nameserverport
39.134 +若泣若若莎桁若垩絎障\f2orbd\fP 莎桁若筝х篆∴羆緇罘障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 (綽)
39.135 +.RE
39.136 +
39.137 +.LP
39.138 .LP
39.139
39.140 .LP
39.141 -.TP 3
39.142 -\-ORBInitialPort nameserverport
39.143 -ネームサーバーを起動するポートを指定します。起動後に \f2orbd\fP はこのポートで着信要求を待機します。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。 (必須)
39.144 -.LP
39.145 -.SH その他のオプション
39.146 -.LP
39.147 -
39.148 -.LP
39.149 -.TP 3
39.150 -\-port port
39.151 -ORBD を開始する起動ポートを指定します。ORBD はこのポートで、持続オブジェクトの要求を受け付けます。このポートのデフォルト値は 1049 です。このポート番号は、持続 Interoperable Object References (IOR) のポートフィールドに追加されます。(省略可能)
39.152 -.TP 3
39.153 -\-defaultdb directory
39.154 -ORBD 持続ストレージディレクトリである \f2orb.db\fP が作成されるベースを指定します。このオプションが指定されない場合、デフォルト値は "./orb.db" です。(省略可能)
39.155 -.TP 3
39.156 -\-serverPollingTime milliseconds
39.157 -\f2servertool\fP 経由で登録された持続サーバーの健全性を ORBD が検査する頻度を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
39.158 -.TP 3
39.159 -\-serverStartupDelay milliseconds
39.160 -\f2servertool\fP 経由で登録された持続サーバーが再起動されてから ORBD がロケーション転送例外を送信するまでの、ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
39.161 -.TP 3
39.162 -\-Joption
39.163 -\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、「\f2Java アプリケーション起動プログラム\fP」
39.164 -.fi
39.165 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP は、起動時に使用するメモリを 48M バイトに設定します。\f3\-J\fP が基本にする仮想マシンにオプションを渡すことは、共通の規約です。
39.166 -.LP
39.167 -.SH ネームサービスの起動と停止
39.168 -.LP
39.169 -.LP
39.170 -ネームサービスは、名前をオブジェクト参照にバインドすることによって、「\f2CORBA objects\fP」
39.171 -.fi
39.172 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object) を指定できるようにする CORBA サービスです。「\f2name binding\fP」
39.173 -.fi
39.174 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding) は、ネーミングサービスに保存できます。クライアントは名前を指定して、目的のオブジェクト参照を取得できます。
39.175 -.LP
39.176 -.LP
39.177 -クライアントまたはサーバーを実行する前に、ORBD を開始します。ORBD には、持続ネーミングサービスと一時ネーミングサービスが含まれています。これらは両方とも COS ネーミングサービスの実装です。
39.178 +.SS
39.179 +篁激с
39.180 .LP
39.181 .RS 3
39.182 -.TP 2
39.183 -*
39.184 -\f4持続\fP\f3ネーミングサービス\fPは、ネーミングコンテキストに持続性を提供します。つまり、この情報はサービスの停止と起動の間で持続し、サービスに障害が発生した場合に回復可能です。ORBD が再起動されると、持続ネーミングサービスはネーミングコンテキストグラフを復元するため、すべてのクライアントとサーバーの名前のバインディングは損傷を受けません (持続する)。
39.185 -.TP 2
39.186 -*
39.187 -以前のバージョンとの互換性のため、\f2tnameserv\fP (以前のバージョンの JDK と一緒に出荷された\f4一時\fP\f3ネーミングサービス\fP) もこのリリースの J2SE に含まれています。一時ネーミングサービスが実行されている限り、ネーミングコンテキストは保持されます。サービスが中断された場合、ネーミングコンテキストグラフは失われます。
39.188 +.TP 3
39.189 +\-port port
39.190 +ORBD 莎桁若絎障 ORBD 若с膓吾с絲障荀羆障若ゃ 1049 с 若垩膓 Interoperable Object References (IOR) 若c若菴遵障(ュ)
39.191 .RE
39.192
39.193 .LP
39.194 +.RS 3
39.195 +.TP 3
39.196 +\-defaultdb directory
39.197 +ORBD 膓主c \f2orb.db\fP 篏若鴻c絎障激с潟絎翫ゃ./orb.db障(ュ)
39.198 +.RE
39.199 +
39.200 .LP
39.201 -\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP に必須のコマンド行引数で、ネーミングサービスが実行されるポート番号の設定に使用されます。以下の説明は、Java\ IDL Object Request Broker Daemon にポート 1050 を使用できると仮定しています。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。必要な場合は、別のポートを使用することもできます。
39.202 +.RS 3
39.203 +.TP 3
39.204 +\-serverPollingTime milliseconds
39.205 +\f2servertool\fP 篏睡脂蚊膓泣若若罩e幻篏 ORBD 腆肴違絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
39.206 +.RE
39.207 +
39.208 .LP
39.209 +.RS 3
39.210 +.TP 3
39.211 +\-serverStartupDelay milliseconds
39.212 +\f2servertool\fP 篏睡脂蚊膓泣若若莎桁篏臀荵∫箴紊篆<障с ORBD 緇罘絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
39.213 +.RE
39.214 +
39.215 .LP
39.216 -UNIX コマンドシェルから \f2orbd\fP を起動するには、次のように入力します。
39.217 +.RS 3
39.218 +.TP 3
39.219 +\-Joption
39.220 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
39.221 +.TP 3
39.222 +
39.223 +.RE
39.224 +
39.225 +.LP
39.226 +.SH "若泣若鴻莎桁罩"
39.227 +.LP
39.228 +.LP
39.229 +若泣若鴻
39.230 +.na
39.231 +\f2CORBA 吾с\fP @
39.232 +.fi
39.233 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object若潟違純 CORBA 泣若鴻с 若潟違吾ссゃ潟純障
39.234 +.na
39.235 +\f2若ゃ潟c潟違\fP @
39.236 +.fi
39.237 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding若泣若鴻主ゃ≪潟筝吾сс緇с障
39.238 +.LP
39.239 +.LP
39.240 +ORBD ゃ≪潟障泣若若絎茵莎桁障ORBD 膓若泣若鴻割若泣若鴻腟粋昭障障 < COS 若泣若鴻絎茖с
39.241 +.LP
39.242 +.LP
39.243 +\f3膓若泣若\fP若潟違潟潟鴻絲障膓с箴障ゃ障宴泣若鴻罩≪莎桁緇膓泣若鴻絎潟榊翫с緇с障ORBD 莎桁膓若泣若鴻若潟違潟潟鴻違緇鴻ゃ≪潟泣若若ゃ潟c潟違篆障
39.244 +.LP
39.245 +.LP
39.246 +\
39.247 +.LP
39.248 +.LP
39.249 +筝篏篋сс若吾с潟 JDK 罌宴\f3筝若泣若\fP篁若鴻 J2SE 罌宴障筝若泣若鴻с若泣若鴻絎茵筝帥若潟違潟潟鴻篆障泣若鴻筝若潟違潟潟鴻紊宴障
39.250 +.LP
39.251 +.LP
39.252 +\f2\-ORBInitialPort\fP 綣違\f2orbd\fP 綽潟潟茵綣違с若泣若鴻絎茵若垩荐絎篏帥障篁ヤ茯сJava\ IDL Object Request Broker Daemon 若 1050 篏睡с障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
39.253 +.LP
39.254 +.LP
39.255 +UNIX 潟潟激с \f2orbd\fP 莎桁罨<ュ障
39.256 .LP
39.257 .nf
39.258 \f3
39.259 @@ -140,7 +176,7 @@
39.260
39.261 .LP
39.262 .LP
39.263 -MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
39.264 +Windows MS\-DOS 激鴻潟с罨<ュ障
39.265 .LP
39.266 .nf
39.267 \f3
39.268 @@ -152,7 +188,7 @@
39.269
39.270 .LP
39.271 .LP
39.272 -ORBD の実行後に、サーバーおよびクライアントアプリケーションを実行できます。クライアントおよびサーバーアプリケーションを実行する場合は、ネーミングサービスが実行されているポート番号 (および該当する場合は、マシン名) をアプリケーションに認識させる必要があります。これを実行する方法の 1 つとして、次のコードをアプリケーションに追加することができます。
39.273 + ORBD 絎茵泣若若ゃ≪潟≪宴若激с潟絎茵с障ゃ≪潟泣若若≪宴若激с潟絎茵若泣若鴻絎茵若 (綽荀翫激喝) 茯茘綽荀障絎憗 1 ゃ号罨<潟若≪宴若激с潟菴遵с
39.274 .LP
39.275 .nf
39.276 \f3
39.277 @@ -170,7 +206,7 @@
39.278
39.279 .LP
39.280 .LP
39.281 -この例では、ネーミングサービスはホスト「MyHost」のポート 1050 で実行されています。また、サーバーまたはクライアントアプリケーションの実行時にコマンド行からポート番号またはマシン名を指定することもできます。たとえば、「HelloApplication」を次のコマンド行で起動します。
39.282 +箴с若泣若鴻鴻 MyHost 若 1050 筝у茵障ャ号潟潟茵泣若若障ゃ≪潟≪宴若激с潟絎茵若垩障激喝筝≧鴻絎号障違罨<潟潟茵激с潟篏睡HelloApplication莎桁с障
39.283 .LP
39.284 .nf
39.285 \f3
39.286 @@ -182,31 +218,39 @@
39.287
39.288 .LP
39.289 .LP
39.290 -ネーミングサービスを停止するには、該当するオペレーティングシステムコマンドを使用します (Solaris での \f2pkill orbd\fP、または \f2orbd\fP が実行されている DOS ウィンドウでの \f2Ctrl+C\fP など)。一時ネームサービスの場合、サービスが終了すると、ネーミングサービスに登録されている名前が消失する可能性があります。Java IDL ネーミングサービスは明示的に停止されるまで実行します。
39.291 +若泣若鴻罩≪若c潟違激鴻潟潟篏睡障 違Solaris с \f2pkill orbd\fP 篏睡\f2orbd\fP 絎茵 DOS c潟с \f2Ctrl+C\fP 若篏睡障筝若泣若鴻翫泣若鴻腟篋若泣若鴻脂蚊羔サ翫障Java IDL 若泣若鴻腓榊罩≪障у茵障
39.292 .LP
39.293 -ORBD に含まれているネーミングサービスの詳細については、「\f2Naming Service\fP」
39.294 +.LP
39.295 +ORDB 障若泣若鴻荅括完ゃ
39.296 +.na
39.297 +\f2若泣若鴻\fP @
39.298 .fi
39.299 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
39.300 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
39.301 .LP
39.302 -.SH サーバーマネージャ
39.303 +.SH "泣若若若吾c"
39.304 .LP
39.305 .LP
39.306 -ORBD のサーバーマネージャにアクセスして持続サーバーを実行するには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合、\f2orbd\fP と同じホストおよびポートで起動する必要があります。異なるポートでサーバーが起動された場合、ローカルコンテキストのデータベースに格納されている情報は無効になり、サービスは正常に機能しなくなります。
39.307 +ORBD 泣若若若吾c若≪祉鴻膓泣若若絎茵servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激c潟茵潟潟茵ゃ潟帥с若鴻сservertool 篏睡泣若若莎桁翫\f2orbd\fP 絎茵贋若鴻ц儀綽荀障泣若若違若у茵若潟潟鴻若帥若鴻篆絖宴≦鴻泣若鴻罩c篏障
39.308 .LP
39.309 -.SS
39.310 -サーバーマネージャ: 例
39.311 +.SS
39.312 +泣若若若吾c:箴
39.313 .LP
39.314 .LP
39.315 -デモ用のサンプルチュートリアル
39.316 +∝
39.317 +.na
39.318 +\f2泣潟ャ若≪\fP @
39.319 .fi
39.320 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html) を使って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラをチュートリアルで示されているように実行します。サーバーマネージャを実行するには、以下の手順に従ってアプリケーションを実行します。
39.321 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html篏睡ャ若≪緇c\f2idlj\fP 潟潟ゃ \f2javac\fP 潟潟ゃ絎茵障泣若若若吾c若絎茵罨<緇c≪宴若激с潟絎茵障
39.322 .LP
39.323 -.RS 3
39.324 -.TP 3
39.325 -1.
39.326 -orbd を起動します。
39.327 .LP
39.328 -\f2orbd\fP を UNIX コマンドシェルから起動するには、次のように入力します。
39.329 +\f2orbd\fP 莎桁障
39.330 +.LP
39.331 +.LP
39.332 +UNIX 潟潟激с \f2orbd\fP 莎桁罨<ュ障
39.333 +.LP
39.334 +.LP
39.335 +\
39.336 +.LP
39.337 .nf
39.338 \f3
39.339 .fl
39.340 @@ -214,8 +258,11 @@
39.341 .fl
39.342 \fP
39.343 .fi
39.344 +
39.345 .LP
39.346 -MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
39.347 +.LP
39.348 +Windows MS\-DOS 激鴻潟с罨<ュ障
39.349 +.LP
39.350 .nf
39.351 \f3
39.352 .fl
39.353 @@ -223,13 +270,17 @@
39.354 .fl
39.355 \fP
39.356 .fi
39.357 +
39.358 .LP
39.359 -\f21050\fP は、ネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必須のコマンド行引数です。Solaris ソフトウェアを使用する場合は、ルートから 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。
39.360 -.TP 3
39.361 -2.
39.362 -\f2servertool\fP を起動します。
39.363 .LP
39.364 -Hello サーバーを起動するには、次のように入力します。
39.365 +\f21050\fP 若泣若若絎茵若с\f2\-ORBInitialPort\fP 綽荀潟潟茵綣違сSolaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
39.366 +.LP
39.367 +.LP
39.368 +\f2servertool\fP 莎桁障
39.369 +.LP
39.370 +.LP
39.371 +Hello 泣若若莎桁罨<ュ障
39.372 +.LP
39.373 .nf
39.374 \f3
39.375 .fl
39.376 @@ -237,26 +288,43 @@
39.377 .fl
39.378 \fP
39.379 .fi
39.380 +
39.381 .LP
39.382 -ネームサーバー (\f2orbd\fP) のポートが前の手順で使用したポート (たとえば、\f2\-ORBInitialPort 1050\fP) と同じであることを確認してください。\f2servertool\fP は、ネームサーバーと同じポートで起動する必要があります。
39.383 .LP
39.384 -\f2servertool\fP コマンド行インタフェースが表示されます。
39.385 -.TP 3
39.386 -3.
39.387 -Hello サーバーを \f2servertool\fP プロンプトから起動します。
39.388 +罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障\f2servertool\fP 若泣若若若筝ц儀綽荀障
39.389 +.LP
39.390 +.LP
39.391 +\f2servertool\fP 潟潟茵ゃ潟帥с若鴻茵腓冴障
39.392 +.LP
39.393 +.LP
39.394 +
39.395 +.LP
39.396 +.LP
39.397 +\f2servertool\fP 潟 Hello 泣若若莎桁障
39.398 +.LP
39.399 .nf
39.400 \f3
39.401 .fl
39.402 - servertool > register \-server HelloServer \-classpath .
39.403 - \-applicationName HelloServerApName
39.404 + servertool > register \-server HelloServer \-classpath . \-applicationName
39.405 +.fl
39.406 + HelloServerApName
39.407 .fl
39.408 \fP
39.409 .fi
39.410 +
39.411 .LP
39.412 -\f2servertool\fP は、このサーバーを登録し、それに「HelloServerApName」という名前を割り当て、そのサーバー ID と登録されているすべてのサーバーの一覧を表示します。
39.413 -.TP 3
39.414 -4.
39.415 -クライアントアプリケーションを別のターミナルウィンドウまたはプロンプトから実行します。
39.416 +.LP
39.417 +\f2servertool\fP c泣若若脂蚊HelloServerApName泣若若蚊綵泣若 ID 茵腓冴障
39.418 +.LP
39.419 +.LP
39.420 +
39.421 +.LP
39.422 +.LP
39.423 +ャ腴c潟障潟ゃ≪潟≪宴若激с潟絎茵障
39.424 +.LP
39.425 +.LP
39.426 +\
39.427 +.LP
39.428 .nf
39.429 \f3
39.430 .fl
39.431 @@ -264,32 +332,42 @@
39.432 .fl
39.433 \fP
39.434 .fi
39.435 -.LP
39.436 -この例の場合、ネームサーバーは Hello クライアントと同じホストで実行されているので、\f2\-ORBInitialHost localhost\fP を省くことができます。ネームサーバーが別のホストで実行されている場合は、\f2\-ORBInitialHost\fP \f2nameserverhost\fP を使用して IDL ネームサーバーが実行されているホストを指定します。
39.437 -.LP
39.438 -前の手順と同様に、ネームサーバー (\f2orbd\fP) のポート (たとえば、\f2\-ORBInitialPort 1050\fP) を指定します。
39.439 -.TP 3
39.440 -5.
39.441 -サーバーマネージャの実験が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を必ず停止 (終了) してください。
39.442 -.LP
39.443 -\f2orbd\fP を DOS プロンプトから停止するには、サーバーが実行されているウィンドウを選択し、\f2Ctrl+C\fP を押して停止します。\f2orbd\fP を UNIX シェルから停止するには、プロセスを検索して終了します。サーバーは、明示的に停止されるまで起動を引き続き待機します。
39.444 -.LP
39.445 -\f2servertool\fP を停止するには、\f2quit\fP と入力し、キーボードの \f2Enter\fP キーを押します。
39.446 -.RE
39.447
39.448 .LP
39.449 -.SH 関連項目
39.450 +.LP
39.451 +箴 \f2\-ORBInitialHost localhost\fP ャс障 若泣若若 Hello ゃ≪潟筝鴻筝у篏с若泣若若ャ鴻у篏翫IDL 若泣若若篏鴻 \f2\-ORBInitialHost\fP \f2nameserverhost\fP ф絎障
39.452 +.LP
39.453 +.LP
39.454 +罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障
39.455 +.LP
39.456 +.LP
39.457 +\
39.458 +.LP
39.459 +.LP
39.460 +\
39.461 +.LP
39.462 +.LP
39.463 +泣若若若吾c若篏腟篋若泣若 (\f2orbd\fP) \f2servertool\fP 罩≪腟篋
39.464 +.LP
39.465 +.LP
39.466 +DOS 潟 \f2orbd\fP 激c潟泣若若絎茵c潟御 \f2Ctrl+C\fP ュ障UNIX 激с \f2orbd\fP 激c潟祉鴻罎冴腟篋 (kill) 障泣若若腓榊罩≪障с若喝冴緇罘倶膓障
39.467 +.LP
39.468 +.LP
39.469 +\f2servertool\fP 激c潟\f2quit\fP ュ若若 \f2Enter\fP 若若障
39.470 +.LP
39.471 +.SH "∫i"
39.472 .LP
39.473 .RS 3
39.474 .TP 2
39.475 -*
39.476 -「\f2Naming Service\fP」
39.477 +o
39.478 +.na
39.479 +\f2若泣若\fP @
39.480 .fi
39.481 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
39.482 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
39.483 .br
39.484 .TP 2
39.485 -*
39.486 -servertool
39.487 +o
39.488 +servertool(1)
39.489 .RE
39.490
39.491 .LP
40.1 --- a/src/linux/doc/man/ja/pack200.1 Tue May 12 15:21:55 2009 +0900
40.2 +++ b/src/linux/doc/man/ja/pack200.1 Thu May 14 00:17:25 2009 -0700
40.3 @@ -1,92 +1,121 @@
40.4 -'\t" t
40.5 -.\"
40.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
40.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
40.8 -.\"
40.9 -.\" This code is free software; you can redistribute it and/or modify it
40.10 -.\" under the terms of the GNU General Public License version 2 only, as
40.11 -.\" published by the Free Software Foundation.
40.12 -.\"
40.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
40.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
40.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
40.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
40.17 -.\" accompanied this code).
40.18 -.\"
40.19 -.\" You should have received a copy of the GNU General Public License version
40.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
40.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
40.22 -.\"
40.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
40.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
40.25 -.\" have any questions.
40.26 -.\"
40.27 -.\"
40.28 -.TH pack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
40.29 -.SH 名前
40.30 -pack200 \- JAR パックツール
40.31 -.SH 形式
40.32 -.B pack200
40.33 -[
40.34 -.I options
40.35 -]
40.36 -.I output\-file
40.37 -.I JAR\-file
40.38 -.SH
40.39 -オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
40.40 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
40.41 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
40.42 +."
40.43 +." This code is free software; you can redistribute it and/or modify it
40.44 +." under the terms of the GNU General Public License version 2 only, as
40.45 +." published by the Free Software Foundation.
40.46 +."
40.47 +." This code is distributed in the hope that it will be useful, but WITHOUT
40.48 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
40.49 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
40.50 +." version 2 for more details (a copy is included in the LICENSE file that
40.51 +." accompanied this code).
40.52 +."
40.53 +." You should have received a copy of the GNU General Public License version
40.54 +." 2 along with this work; if not, write to the Free Software Foundation,
40.55 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
40.56 +."
40.57 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
40.58 +." CA 95054 USA or visit www.sun.com if you need additional information or
40.59 +." have any questions.
40.60 +."
40.61 +.TH pack200 1 "04 May 2009"
40.62 +." Generated from HTML by html2man (author: Eric Armstrong)
40.63 +
40.64 +.LP
40.65 +.SH ""
40.66 +pack200 \- JAR 若
40.67 +.LP
40.68 +.RS 3
40.69 +.TP 2
40.70 +o
40.71 +綵√
40.72 +.TP 2
40.73 +o
40.74 +茯
40.75 +.TP 2
40.76 +o
40.77 +激с
40.78 +.TP 2
40.79 +o
40.80 +腟篋鴻若帥
40.81 +.TP 2
40.82 +o
40.83 +∫i
40.84 +.TP 2
40.85 +o
40.86 +茯
40.87 +.RE
40.88 +
40.89 +.LP
40.90 +.SH "綵√"
40.91 +.LP
40.92 +
40.93 +.LP
40.94 +.LP
40.95 +\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
40.96 +.LP
40.97 +.LP
40.98 +激с潟絎綺羆冴障障潟潟茵障 properties <ゃ絎緇激с潟篁ュ絎鴻激с潟障
40.99 .LP
40.100 .RS 3
40.101
40.102 -.JP
40.103 +.LP
40.104 +.RS 3
40.105 .TP 3
40.106 options
40.107 -コマンド行オプション。
40.108 +潟潟茵激с潟
40.109 .TP 3
40.110 -output\-file
40.111 -出力ファイルの名前。
40.112 +output\-file
40.113 +阪<ゃ
40.114 .TP 3
40.115 -JAR\-file
40.116 -入力ファイルの名前。
40.117 +JAR\-file
40.118 +ュ<ゃ
40.119 +.RE
40.120 +
40.121 .LP
40.122 .RE
40.123 -.SH 機能説明
40.124 +.SH " 茯"
40.125 .LP
40.126
40.127 .LP
40.128 .LP
40.129 -\f2pack200\fP ツールは、Java \f2gzip\fP 圧縮ツールを使って JAR ファイルを圧縮 \f2pack200\fP ファイルに変換する Java アプリケーションです。\f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
40.130 -.LP
40.131 +\f2pack200\fP 若Java \f2gzip\fP х軒違篏睡JAR <ゃ \f2pack200\fP х軒<ゃ紊 Java ≪宴若激с潟с\f2pack200\fP <ゃ蕭х軒<ゃс絽綛膀膣潟若膰贋・с障
40.132 .LP
40.133 -\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
40.134 -.TP
40.135 -一般的な使用方法:
40.136 .LP
40.137 -.ft 3
40.138 -.nf
40.139 +\f2pack200\fP 若х軒潟吾潟荐絎緇茯炊眼茵激с潟障
40.140 +.LP
40.141 +.SS
40.142 +筝篏睡号:
40.143 +.LP
40.144 +.RS 3
40.145 +
40.146 +.LP
40.147 +.LP
40.148 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
40.149 -.fi
40.150 -.ft 1
40.151 .LP
40.152 -この例では、デフォルトの \f2pack200\fP 設定で、\f2myarchive.pack.gz\fP が作成されます。
40.153 +.RE
40.154 .LP
40.155 -.SH オプション
40.156 +箴с \f2pack200\fP 荐絎с\f2myarchive.pack.gz\fP 篏障
40.157 +.LP
40.158 +.SH "激с"
40.159 .LP
40.160
40.161 .LP
40.162 -.LP
40.163 +.LP
40.164 \f4\-r \-\-repack\fP
40.165 .LP
40.166 .RS 3
40.167
40.168 .LP
40.169 .LP
40.170 -\f2myarchive.jar\fP ファイルのパックまたはアンパックにより、JAR ファイルを作成します。作成されたファイルは、\f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
40.171 +\f2myarchive.jar\fP <ゃ緇≪潟JAR <ゃ障<ゃ\f2jarsigner(1)\fP 若ュ<ゃ篏睡с障
40.172 .LP
40.173 .RS 3
40.174
40.175 .LP
40.176 .LP
40.177 -\f2% pack200 \-\-repack myarchive\-packed.jar myarchive.jar\fP
40.178 +\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
40.179 .LP
40.180 .LP
40.181 \f2% pack200 \-\-repack myarchive.jar\fP
40.182 @@ -100,7 +129,7 @@
40.183
40.184 .LP
40.185 .LP
40.186 -\f2pack200\fP ファイルを作成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
40.187 +\f2pack200\fP <ゃ障激с潟絎х軒若篏睡綽荀障 障帥若蚊激鴻с絲上х軒茹iゃ若篏睡綽荀障
40.188 .LP
40.189 .RS 3
40.190
40.191 @@ -111,13 +140,13 @@
40.192 .RE
40.193 .RE
40.194 .LP
40.195 -\f4\-G \-\-strip-debug\fP
40.196 +\f4\-G \-\-strip\-debug\fP
40.197 .LP
40.198 .RS 3
40.199
40.200 .LP
40.201 .LP
40.202 -出力からデバッグ用の属性を削除します。対象となる属性には、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、および \f2LocalVariableTypeTable\fP などがあります。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
40.203 +阪亥絮сゃ障絲乗院絮с\f2SourceFile\fP\f2LineNumberTable\fP\f2LocalVariableTable\fP \f2LocalVariableTypeTable\fP 障絮сゃ違潟若ゃ潟鴻若泣ゃ冴絨障罘純狗障
40.204 .LP
40.205 .RE
40.206 .LP
40.207 @@ -127,7 +156,7 @@
40.208
40.209 .LP
40.210 .LP
40.211 -パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
40.212 +若鴻荀膣筝号帥荵∫障障JAR cゃ障潟若泣ゃ冴絨障ゃ潟鴻 JAR <ゃ罘純罩e幻篏障
40.213 .LP
40.214 .RE
40.215 .LP
40.216 @@ -137,16 +166,18 @@
40.217
40.218 .LP
40.219 .LP
40.220 -各アーカイブセグメントの予測ターゲットサイズ N (バイト) を指定します。N バイト以上を必要とする単一の入力ファイルには、独立したアーカイブセグメントが割り当てられます。たとえば、これは特殊な例ですが、値が \f2-1\fP の場合、すべての入力ファイルを含む単一の巨大なセグメントが生成されます。一方、値が \f20\fP の場合、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントのサイズが大きければ大きいほど断片化は起こりにくく、圧縮率も高くなります。しかし、こうしたセグメントを処理するためには、大量のメモリが必要になります。
40.221 +ゃ≪若ゃ祉違<潟篋潟帥若蚊泣ゃ N (ゃ篏) сN ゃ篁ヤ綽荀筝ュ<ゃ
40.222 +.br
40.223 +腴≪若ゃ祉違<潟蚊綵障違号箴сゃ \f2\-1\fP 翫鴻ュ<ゃ筝綏紊с祉違<潟障 筝鴻ゃ \f20\fP 翫鴻祉違<潟 1 ゃょ障≪若ゃ祉違<潟泣ゃ冴紊с医ぇ祉莎激х軒蕭障祉違<潟紊ч<≪若綽荀障
40.224 .LP
40.225 .LP
40.226 -各セグメントのサイズは、セグメント内で転送される入力ファイルのサイズと、このファイルの名前のサイズ、およびその他の転送プロパティによって予測されます。
40.227 +祉違<潟泣ゃ冴祉違<潟ц拶ュ<ゃ泣ゃ冴<ゃ泣ゃ冴潟篁荵∫c若c篋羝障
40.228 .LP
40.229 .LP
40.230 -デフォルトのサイズは \f21000000\fP (百万バイト) です。これは、標準サイズの入力 JAR ファイルを単一セグメント内で転送できるサイズです。パックツールおよびアンパックツールのメモリ要件には制限が課されます。
40.231 +泣ゃ冴 \f21000000\fP (100 筝ゃ) с罔羣泣ゃ冴ュ JAR <ゃ筝祉違<潟ц拶с泣ゃ冴с若潟≪潟若<≪取篁吟狗茯蚊障
40.232 .LP
40.233 .LP
40.234 -この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
40.235 +狗茯蚊 10M ゃ JAR <ゃ絽吾 10% 腮綺泣ゃ冴障 若с紊с Java 若 (祉違<潟狗膣 10 ) 綽荀翫障
40.236 .LP
40.237 .RE
40.238 .LP
40.239 @@ -156,11 +187,10 @@
40.240
40.241 .LP
40.242 .LP
40.243 -単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合、圧縮速度は速くても圧縮率はそれほど高くありません。レベル \f29\fP の場合、圧縮速度は遅くても圧縮率は高くなります。
40.244 -特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべてのアンパックツールはこの特殊な処理をアーカイブ全体のパススルーとして理解する必要があります。
40.245 +筝 10 我医ゃ絎翫若絎х軒с≪若ゃх軒障 \f21\fP 翫х軒綺х軒祉蕭障 \f29\fP 翫х軒綺х軒蕭障号 \f20\fP 絎翫 JAR <ゃх軒х贋・潟若障JSR 200 罔羣с鴻≪潟若号≪若ゃ篏鴻鴻若茹c綽荀障
40.246 .LP
40.247 .LP
40.248 -デフォルト値は \f25\fP です。この場合、標準的な時間で、適度な圧縮が行われます。
40.249 +ゃ \f25\fP с 翫罔羣с綺х軒茵障
40.250 .LP
40.251 .RE
40.252 .LP
40.253 @@ -170,33 +200,43 @@
40.254
40.255 .LP
40.256 .LP
40.257 -デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。可能な値:
40.258 +ゃ筝吾ュ宴篆障 荵∫≪若ゃ泣ゃ冴紊с障純:
40.259 .LP
40.260 +.RS 3
40.261 .TP 3
40.262 -true
40.263 +true
40.264 .TP 3
40.265 -false
40.266 -どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
40.267 +false
40.268 +<翫с若若激с潟潟阪≪若ゃ荐絎障 ≪若ゃ荀膣若激с潟潟荵∫障
40.269 +.RE
40.270 +
40.271 .LP
40.272 +.RS 3
40.273 .TP 3
40.274 -keep
40.275 -入力 JAR 内のデフレーションヒントを保存します (デフォルト)。
40.276 -.in
40.277 -.TP
40.278 +keep
40.279 +ュ JAR 若激с潟潟篆障 ()
40.280 +.RE
40.281 +
40.282 +.LP
40.283 +.RE
40.284 +.LP
40.285 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP
40.286 .LP
40.287 .RS 3
40.288
40.289 .LP
40.290 .LP
40.291 -可能な値:
40.292 +純:
40.293 .LP
40.294 +.RS 3
40.295 .TP 3
40.296 -latest
40.297 -パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
40.298 +latest
40.299 +若≪若ゃ潟腟贋井祉祉違<潟鴻潟腟贋井祉劫障筝ゃ祉違<潟筝荵∫祉違<潟潟障翫鴻ゃ潟鴻若<ゃ筝ヤ荐絎馹障≪若ゃ荵∫泣ゃ冴絨絨с障
40.300 .TP 3
40.301 -keep
40.302 -入力 JAR 内の更新時刻を保存します (デフォルト)。
40.303 +keep
40.304 +ュ JAR 贋井祉篆障 ()
40.305 +.RE
40.306 +
40.307 .LP
40.308 .RE
40.309 .LP
40.310 @@ -206,7 +246,7 @@
40.311
40.312 .LP
40.313 .LP
40.314 -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。パス名の変換は行われません。システムファイルの区切り文字が JAR ファイルの区切り文字 "\f2/\fP" で置き換えられるだけです。ファイル名は、JAR ファイル内の文字列と完全に一致していなければなりません。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
40.315 +<ゃх軒ゃ篏ц拶絎障激с潟膵違菴篏睡茲違<ゃ絎с障劫紊茵障 激鴻<ゃ阪絖 JAR <ゃ阪絖\f2/\fPх舟с<ゃJAR <ゃ絖絎筝眼違障file c絎翫c鴻<ゃ荵∫障
40.316 .LP
40.317 .RE
40.318 .LP
40.319 @@ -216,48 +256,54 @@
40.320
40.321 .LP
40.322 .LP
40.323 -デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
40.324 +篏≦鴻障 違筝絮с鴻<ゃ絎≪激с潟ц拶障≪激с潟絎純:
40.325 .LP
40.326 +.RS 3
40.327 .TP 3
40.328 -error
40.329 -\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
40.330 +error
40.331 +\f2pack200\fP 篏紊掩茹h茵腓冴障
40.332 .TP 3
40.333 -strip
40.334 -属性はドロップされます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
40.335 +strip
40.336 +絮с障羈: VM 綽絮сゃ鴻若若絎潟榊障
40.337 .TP 3
40.338 -pass
40.339 -この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
40.340 +pass
40.341 +絮с罎冴翫劫篏 1 ゃ純若鴻荵∫障
40.342 +.RE
40.343 +
40.344 .LP
40.345 .RE
40.346 .LP
40.347 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
40.348 .br
40.349 - \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
40.350 +\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
40.351 .br
40.352 - \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
40.353 +\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
40.354 .br
40.355 - \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
40.356 +\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
40.357 .LP
40.358 .RS 3
40.359
40.360 .LP
40.361 .LP
40.362 -これら 4 つのオプションでは、クラスエンティティに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
40.363 + 4 ゃ激с潟с鴻潟cc若 Class 絮сField 絮сMethod 絮сCode 絮с絮сゃ≪絎с障attribute\-name ゃ≪障≪激с潟絎臂絮с絎障≪激с潟絎純:
40.364 .LP
40.365 +.RS 3
40.366 .TP 3
40.367 -(一部のレイアウト文字列)
40.368 -レイアウト言語は、JSR 200 仕様に定義されています。
40.369 +(筝ゃ≪絖)
40.370 +ゃ≪荐茯JSR 200 篁罕絎臂障
40.371 .LP
40.372 -例: \f2\-\-class\-attribute=SourceFile=RUH\fP
40.373 +箴: \f2\-\-class\-attribute=SourceFile=RUH\fP
40.374 .TP 3
40.375 -error
40.376 -この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
40.377 +error
40.378 +絮с罎冴翫pack200 篏紊掩茹h茵腓冴障
40.379 .TP 3
40.380 -strip
40.381 -この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
40.382 +strip
40.383 +絮с罎冴翫絮с阪ゃ障羈: VM 綽絮сゃ鴻若若絎潟榊障
40.384 +.RE
40.385 +
40.386 .LP
40.387 .LP
40.388 -例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。
40.389 +箴: \f2\-\-class\-attribute=CompilationID=pass\fP 絮с鴻<ゃ荵∫障 若篁≪激с潟茵障
40.390 .LP
40.391 .RE
40.392 .LP
40.393 @@ -267,7 +313,7 @@
40.394
40.395 .LP
40.396 .LP
40.397 -コマンド行に、パックツールを初期化するための Java プロパティが含まれている設定ファイルを指定できます。
40.398 +潟潟茵若 Java c若障荐絎<ゃ絎с障
40.399 .LP
40.400 .RS 3
40.401
40.402 @@ -307,7 +353,7 @@
40.403
40.404 .LP
40.405 .LP
40.406 -最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
40.407 +絨<祉若吾阪障激с潟茲井絎激<祉若吾阪障
40.408 .LP
40.409 .RE
40.410 .LP
40.411 @@ -317,7 +363,7 @@
40.412
40.413 .LP
40.414 .LP
40.415 -メッセージを表示せずに動作します。
40.416 +<祉若吾茵腓冴篏障
40.417 .LP
40.418 .RE
40.419 .LP
40.420 @@ -327,7 +373,7 @@
40.421
40.422 .LP
40.423 .LP
40.424 -出力メッセージのログファイルを指定します。
40.425 +阪<祉若吾違<ゃ絎障
40.426 .LP
40.427 .RE
40.428 .LP
40.429 @@ -337,65 +383,65 @@
40.430
40.431 .LP
40.432 .LP
40.433 -\f2pack200\fP によって呼び出される Java 起動ツールにオプションを渡します。たとえば \f2\-J\-Xms48m\fP と指定した場合、起動メモリが 48M バイトに設定されます。\f2\-X\fP で始まってはいませんが、\f2pack200\fP の標準オプションではありません。慣習として、\f2\-J\fP には、Java で書かれたアプリケーションを実行する VM にオプションを渡す働きがあります。
40.434 +\f2pack200\fP c若喝冴 Java 莎桁若激с潟羝<障違\f2\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟 \f2\-X\fP у障c障\f2pack200\fP 罔羣激с潟с障\f2\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
40.435 .LP
40.436 .RE
40.437 .RE
40.438 -.SH 終了ステータス
40.439 +.SH "腟篋鴻若帥"
40.440 .LP
40.441
40.442 .LP
40.443 .LP
40.444 -次の終了値が返されます。
40.445 +罨<腟篋ゃ菴障
40.446 .LP
40.447 .RS 3
40.448
40.449 .LP
40.450 .LP
40.451 -\f2\ 0\fP "成功"
40.452 +\f2\ 0\fP ""
40.453 .LP
40.454 .LP
40.455 -\f2>0\fP "エラー"
40.456 +\f2>0\fP ""
40.457 .LP
40.458 .RE
40.459 -.SH 関連項目
40.460 +.SH "∫i"
40.461 .LP
40.462 .RS 3
40.463 .TP 2
40.464 -*
40.465 -unpack200 \- JAR アンパックツール
40.466 +o
40.467 +unpack200(1)
40.468 .TP 2
40.469 -*
40.470 -\f2unpack200(1)\fP、\f2jar(1)\fP、\f2jarsigner(1)\fP、\f2attributes(5)\fP のマニュアルページ
40.471 +o
40.472 +.na
40.473 +\f2Java SE ャ<潟\fP @
40.474 +.fi
40.475 +http://java.sun.com/javase/6/docs/index.html
40.476 .TP 2
40.477 -*
40.478 -Java SE のドキュメント
40.479 +o
40.480 +.na
40.481 +\f2Java ゃ \- Pack200\fP @
40.482 +.fi
40.483 +http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
40.484 .TP 2
40.485 -*
40.486 -.na
40.487 -\f2Java Deployment Guide \- Pack200\fP
40.488 -.fi
40.489 -(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html)
40.490 +o
40.491 +jar(1) \- Java Archive 若
40.492 .TP 2
40.493 -*
40.494 -\f2jar\fP \- Java アーカイブツール
40.495 +o
40.496 +jarsigner(1) \- JAR 臀峨恰荐若若
40.497 .TP 2
40.498 -*
40.499 -.na
40.500 -\f2jarsigner\fP \- JAR 署名および検証ツール
40.501 -.fi
40.502 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html)
40.503 +o
40.504 +\f2attributes(5)\fP ャ≪若
40.505 .RE
40.506
40.507 .LP
40.508 -.SH 注意事項
40.509 +.SH "羈鋋"
40.510 .LP
40.511
40.512 .LP
40.513 .LP
40.514 -このコマンドと \f2pack(1)\fP コマンドを混同しないでください。これらは別製品です。
40.515 +潟潟 \f2pack(1)\fP 羞桁сヨ遵с
40.516 .LP
40.517 .LP
40.518 -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
40.519 +SDK 篁絮 Java SE API 篁罕檎荀ゃc翫篁罕
40.520 .LP
40.521 -
40.522 +
41.1 --- a/src/linux/doc/man/ja/policytool.1 Tue May 12 15:21:55 2009 +0900
41.2 +++ b/src/linux/doc/man/ja/policytool.1 Thu May 14 00:17:25 2009 -0700
41.3 @@ -1,6 +1,4 @@
41.4 -.'" t
41.5 -."
41.6 -." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
41.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
41.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
41.9 ."
41.10 ." This code is free software; you can redistribute it and/or modify it
41.11 @@ -21,100 +19,90 @@
41.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
41.13 ." have any questions.
41.14 ."
41.15 -." `
41.16 -.TH policytool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
41.17 -." Generated by html2roff
41.18 +.TH policytool 1 "04 May 2009"
41.19 +." Generated from HTML by html2man (author: Eric Armstrong)
41.20
41.21 .LP
41.22 -.SH 名前
41.23 -policytool \- PolicyTool 管理 GUI ユーティリティ
41.24 +.SH ""
41.25 +policytool \- PolicyTool 膊∞ GUI 若cc
41.26 .LP
41.27 -\f3policytool\fP は、ユーティリティ GUI 経由で取得したユーザ入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
41.28 -.SH "形式"
41.29 +\f3policytool\fP 若cc GUI 腟宴у緇若吟弱ュ冴ャ若潟鴻激若<ゃ茯炊吾障
41.30 +.RS 3
41.31 +.TP 2
41.32 +o
41.33 +綵√
41.34 +.TP 2
41.35 +o
41.36 +茯
41.37 +.TP 2
41.38 +o
41.39 +激с
41.40 +.TP 2
41.41 +o
41.42 +∫i
41.43 +.RE
41.44 +
41.45 +.LP
41.46 +.SH "綵√"
41.47 .LP
41.48
41.49 .LP
41.50 +.RS 3
41.51 .TP 3
41.52 \
41.53 .TP 3
41.54 -policytool 管理者ユーティリティを実行します
41.55 +policytool 膊∞若cc若絎茵障
41.56 \f4policytool\fP
41.57 .TP 3
41.58 -policytool を実行し、指定されたポリシーファイルを読み込みます
41.59 -\f4policytool\fP\f2[\-file][\fP\f2filename\fP\f2]\fP
41.60 +policytool 絎茵絎激若<ゃ茯粋昭帥障
41.61 +\f4policytool\fP\f2 [\-file\ \fP\f2filename\fP\f2]\fP
41.62 .TP 3
41.63 \
41.64 .TP 3
41.65 -各要素は次のとおりです。
41.66 +荀膣罨<с
41.67 +.RS 3
41.68 .TP 3
41.69 file
41.70 -ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
41.71 +若激若<ゃ茯粋昭 \f2policytool\fP 腓冴障
41.72 .TP 3
41.73 - filename
41.74 -ファイル名
41.75 +filename
41.76 +<ゃ
41.77 +.RE
41.78 +.SH "茯"
41.79 .LP
41.80 -.SH "機能説明"
41.81 -.LP
41.82 -
41.83 -.LP
41.84 -.LP
41.85 -\f3policytool\fP は、システム管理者がローカルポリシーファイルの内容を管理することを可能にする管理者用の GUI です。ポリシーファイルは \f2.policy\fP を拡張子に持つプレーンテキストファイルであり、ドメイン別のリモート要求者をアクセス権オブジェクトにマッピングします。詳細については、
41.86 +\f3policytool\fP 若吟若若激若<ゃ絎鴻膊∞純 GUI с荅括完ゃ
41.87 +.na
41.88 +\f2激若<ゃ篏括∞若\fP @
41.89 +.fi
41.90 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlс
41.91 +.SH "激с"
41.92 +.RS 3
41.93 +.TP 3
41.94 +file
41.95 +\f2filename\fP 茯粋昭帥障
41.96 +.SH "∫i"
41.97 +.na
41.98 +\f2Default Policy Implementation and Syntax\fP @
41.99 .fi
41.100 http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
41.101 -の
41.102 +.br
41.103 .na
41.104 -「\f2Default Policy Implementation and Syntax\fP」を参照してください。
41.105 -.LP
41.106 -.SH "オプション"
41.107 -.LP
41.108 -
41.109 -.LP
41.110 -.TP 3
41.111 -file
41.112 -\f2filename\fP を読み込みます。
41.113 -.LP
41.114 -.SH "関連項目"
41.115 -.LP
41.116 -
41.117 -.LP
41.118 -.fi
41.119 -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
41.120 -の
41.121 -.na
41.122 -「\f2Default Policy Implementation and Syntax\fP」
41.123 -.br
41.124 -
41.125 -.LP
41.126 +\f2Policy Tool Users' Guide\fP @
41.127 .fi
41.128 http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
41.129 -の
41.130 +.br
41.131 .na
41.132 -「\f2Policy Tool Users' Guide\fP」
41.133 -.br
41.134 -
41.135 -.LP
41.136 +\f2Security Permissions\fP @
41.137 .fi
41.138 http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
41.139 -の
41.140 +.br
41.141 .na
41.142 -「\f2Security Permissions\fP」
41.143 -.br
41.144 -
41.145 -.LP
41.146 +\f2Security Overview\fP @
41.147 .fi
41.148 http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
41.149 -の
41.150 -.na
41.151 -「\f2Security Overview\fP」
41.152 .br
41.153 -
41.154 -.LP
41.155 -.fi
41.156 -http://java.sun.com/javase/6/docs/technotes/guides/security/arch.html
41.157 -の
41.158 -.na
41.159 -「\f2Security Architecture\fP」
41.160 -.br
41.161 +.RE
41.162 +.RE
41.163
41.164 .LP
41.165
42.1 --- a/src/linux/doc/man/ja/rmic.1 Tue May 12 15:21:55 2009 +0900
42.2 +++ b/src/linux/doc/man/ja/rmic.1 Thu May 14 00:17:25 2009 -0700
42.3 @@ -1,370 +1,270 @@
42.4 -'\" t
42.5 -.\"
42.6 -.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
42.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
42.8 -.\"
42.9 -.\" This code is free software; you can redistribute it and/or modify it
42.10 -.\" under the terms of the GNU General Public License version 2 only, as
42.11 -.\" published by the Free Software Foundation.
42.12 -.\"
42.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
42.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
42.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
42.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
42.17 -.\" accompanied this code).
42.18 -.\"
42.19 -.\" You should have received a copy of the GNU General Public License version
42.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
42.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
42.22 -.\"
42.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
42.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
42.25 -.\" have any questions.
42.26 -.\"
42.27 -.\"
42.28 -.TH rmic 1 "2004 年 6 月 22 日"
42.29 -.SH "名前"
42.30 -rmic \- Java RMI スタブコンパイラ
42.31 -.\"
42.32 -.\" This document was created by saving an HTML file as text
42.33 -.\" from the JavaSoft web site:
42.34 -.\"
42.35 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
42.36 -.\"
42.37 -.\" and adding appropriate troff macros. Because the JavaSoft web site
42.38 -.\" man pages can change without notice, it may be helpful to diff
42.39 -.\" files to identify changes other than new functionality.
42.40 -.\"
42.41 -.SH "形式"
42.42 -.B rmic
42.43 -[
42.44 -.BI options
42.45 -]
42.46 -.I package-qualified-class-names
42.47 -.SH "機能説明"
42.48 -.IX "Java RMI stub compiler" "" "Java RMI stub compiler \(em \fLrmic\fP"
42.49 -.IX "rmic" "" "\fLrmic\fP \(em Java RMI stub compiler"
42.50 -.B rmic
42.51 -コンパイラは、リモートオブジェクト用のスタブおよび
42.52 -スケルトンクラスファイル (JRMP プロトコル) とスタブ
42.53 -および Tie クラスファイル (IIOP プロトコル) を生成します。
42.54 -これらのクラスファイルは、リモートオブジェクト
42.55 -実装クラスである、コンパイルされた Java プログラミング言語
42.56 -クラスから生成されます。リモート実装クラスは、
42.57 -インタフェース \f3java.rmi.Remote\f1
42.58 -を実装するクラスです。
42.59 -.B rmic
42.60 -コマンドで指定されるクラスは、
42.61 -.BR javac (1)
42.62 -コマンドで正常にコンパイルされ、
42.63 -完全にパッケージ修飾されたクラスで
42.64 -なければなりません。
42.65 -次に示す例では、
42.66 -.B HelloImpl
42.67 -というクラスファイルに対して
42.68 -.B rmic
42.69 -を実行しています。
42.70 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
42.71 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
42.72 +."
42.73 +." This code is free software; you can redistribute it and/or modify it
42.74 +." under the terms of the GNU General Public License version 2 only, as
42.75 +." published by the Free Software Foundation.
42.76 +."
42.77 +." This code is distributed in the hope that it will be useful, but WITHOUT
42.78 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
42.79 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
42.80 +." version 2 for more details (a copy is included in the LICENSE file that
42.81 +." accompanied this code).
42.82 +."
42.83 +." You should have received a copy of the GNU General Public License version
42.84 +." 2 along with this work; if not, write to the Free Software Foundation,
42.85 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
42.86 +."
42.87 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
42.88 +." CA 95054 USA or visit www.sun.com if you need additional information or
42.89 +." have any questions.
42.90 +."
42.91 +.TH rmic 1 "04 May 2009"
42.92 +." Generated from HTML by html2man (author: Eric Armstrong)
42.93 +
42.94 .LP
42.95 -.RS
42.96 +.SH ""
42.97 +rmic \- Java RMI 潟潟ゃ
42.98 +.LP
42.99 +.RS 3
42.100 +
42.101 +.LP
42.102 +.LP
42.103 +\f3rmic\fP cJRMP 障 IIOP 潟篏睡≪若吾с鴻帥鴻宴潟 Tie 鴻障障OMG IDL 障
42.104 +.LP
42.105 +.RE
42.106 +.SH "綵√"
42.107 +.LP
42.108 +
42.109 +.LP
42.110 +.nf
42.111 +\f3
42.112 +.fl
42.113 +rmic [ \fP\f3options\fP\f3 ] \fP\f4package\-qualified\-class\-name(s)\fP\f3
42.114 +.fl
42.115 +\fP
42.116 +.fi
42.117 +
42.118 +.LP
42.119 +.SH "茯"
42.120 +.LP
42.121 +
42.122 +.LP
42.123 +.LP
42.124 +\f3rmic\fP 潟潟ゃc≪若吾с鴻帥鴻宴潟鴻<ゃ (JRMP 潟)潟鴻帥 Tie 鴻<ゃ腟水 (IIOP 潟) 障≪若吾с絎茖鴻с鴻<ゃJava 違潟域茯鴻潟潟ゃ障≪若絎茖鴻\f2java.rmi.Remote\fP ゃ潟帥с若鴻絎茖鴻с\f3rmic\fP 潟潟с劫鴻 \f3javac\fP 潟潟с潟潟ゃゅ宴若後絎綽荀障違鴻<ゃ \f2HelloImpl\fP \f3rmic\fP 絎茵罨<障
42.125 +.LP
42.126 +.nf
42.127 +\f3
42.128 +.fl
42.129 rmic hello.HelloImpl
42.130 +.fl
42.131 +\fP
42.132 +.fi
42.133 +
42.134 +.LP
42.135 +.LP
42.136 +\f2HelloImpl_Stub.class\fP <ゃ鴻宴若後篁 \f2hello\fP 泣c篏障
42.137 +.LP
42.138 +.LP
42.139 +≪若吾с鴻宴潟 JRMP 潟泣若弱眼潟cc若с絎≪若吾с絎茖若喝冴<純帥障
42.140 +.LP
42.141 +.LP
42.142 +≪若吾сTie鴻宴潟罕泣若弱眼潟cc若сIIOP 潟篏帥cゃ≪潟篆<障
42.143 +.LP
42.144 +.LP
42.145 +鴻帥≪若吾сゃ≪潟眼с篁gс 鴻帥≪若吾с<純若喝冴絎≪若吾с絽檎泣若若篆<綵劫蚊<障cゃ≪潟≪若吾с吾с絎若鴻帥吾с障
42.146 +.LP
42.147 +.LP
42.148 + \f3rmic\fP с1.2 JRMP 鴻帥潟若吾с潟篏睡鴻帥鴻障 \f2\-v1.2\fP 激с潟絎翫篏с(5.0 篁ュс \f2\-vcompat\fP 激с潟сc羈) IIOP 潟鴻帥 Tie 鴻 \f2\-iiop\fP 激с潟篏睡障
42.149 +.LP
42.150 +.LP
42.151 +鴻帥≪若ゃ潟帥с若鴻絎茖≪若吾с絎茖絮ゃ潟帥с若鴻絎茖障JRMP 鴻帥≪若吾с篏絎茖≪若ゃ潟帥с若鴻絎茖сゃ≪潟c鴻с Java 違潟域茯腟粋昭障羲膊絖篏睡с障IIOP 翫\f2PortableRemoteObject.narrow\fP <純篏帥違障
42.152 +.LP
42.153 +.SH "激с"
42.154 +.LP
42.155 +
42.156 +.LP
42.157 +.RS 3
42.158 +.TP 3
42.159 +\-bootclasspath path
42.160 +若鴻鴻<ゃ篏臀若若ゃ障
42.161 +.TP 3
42.162 +\-classpath path
42.163 +\f3rmic\fP 鴻「鴻絎障激с潟 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
42.164 +.RS 3
42.165 +
42.166 +.LP
42.167 +.nf
42.168 +\f3
42.169 +.fl
42.170 +.:<your_path>
42.171 +.fl
42.172 +\fP
42.173 +.fi
42.174 +.RE
42.175 +箴腓冴障
42.176 +.RS 3
42.177 +
42.178 +.LP
42.179 +.nf
42.180 +\f3
42.181 +.fl
42.182 +.:/usr/local/java/classes
42.183 +.fl
42.184 +\fP
42.185 +.fi
42.186 +.RE
42.187 +.TP 3
42.188 +\-d directory
42.189 +拷絮ゃ阪c若絎障激с潟篏帥違鴻帥鴻宴潟 Tie <ゃ主c絎с障違罨<篏帥障
42.190 +.RS 3
42.191 +
42.192 +.LP
42.193 +.nf
42.194 +\f3
42.195 +.fl
42.196 +% rmic \-d /java/classes foo.MyClass
42.197 +.fl
42.198 +\fP
42.199 +.fi
42.200 +.RE
42.201 +\f2MyClass\fP 緇鴻帥鴻宴潟鴻 \f2/java/classes/foo\fP c臀障\f2\-d\fP 激с潟絎翫\f2\-d\ .\fP絎荀障帥若蚊鴻宴若檎絮ゃ憜c篏鴻帥Tie潟鴻宴潟<ゃc主障(篁ュ若吾с潟 \f3rmic\fP с\f2\-d\fP 絎翫宴若檎絮ゃ篏阪<ゃ鴻憜c贋・主)
42.202 +.br
42.203 +\
42.204 +.TP 3
42.205 +\-extdirs path
42.206 +ゃ潟鴻若≦宍罘純篏臀若若ゃ障
42.207 +.TP 3
42.208 +\-g
42.209 +絮紊違鴻井宴障с茵垽宴障
42.210 +.LP
42.211 +.TP 3
42.212 +\-idl
42.213 +\f2rmic\fP c絎鴻喝с鴻 OMG IDL 障IDL с違潟域茯箴絖絎hс吾с API 絎с障IDL <純潟若帥篁罕篏睡障 CORBA ゃ潟c潟違箴篁紙荐茯с<純潟若帥篏喝若喝冴茵с障荐茯Java C++ 障障荅括完
42.214 +.na
42.215 +\f2Java Language to IDL Mapping\fP @
42.216 +.fi
42.217 +http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) с
42.218 +.LP
42.219 +\f2\-idl\fP 激с潟篏帥祉激с潟絎с障
42.220 +.RS 3
42.221 +.TP 3
42.222 +\-always 障 \-alwaysgenerate
42.223 +√鴻帥Tie IDL ュ鴻違с綣桁句眼障
42.224 +.TP 3
42.225 +\-factory
42.226 + IDL factory 若若篏帥障
42.227 +.TP 3
42.228 +\-idlModule\ fromJavaPackage[.class]\ toIDLModule
42.229 +IDLEntity 宴若吾絎障箴腓冴障 \f2\-idlModule foo.bar my::real::idlmod\fP
42.230 +.TP 3
42.231 +\-idlFile\ fromJavaPackage[.class]\ toIDLFile
42.232 +IDLEntity <ゃ絎障箴腓冴障 \f2\-idlFile test.pkg.X TEST16.idl\fP\
42.233 .RE
42.234 .LP
42.235 -.B HelloImpl_Stub.class
42.236 -ファイルを (クラスのパッケージに対して指定された)
42.237 -.B hello
42.238 -サブディレクトリに作成します。
42.239 +.TP 3
42.240 +\-iiop
42.241 +\f2rmic\fP cJRMP 鴻帥鴻宴潟鴻篁cIIOP 鴻帥 Tie 鴻障鴻帥鴻≪若吾с若激сゃ≪潟泣若若若喝冴篆<篏帥障≪若ゃ潟帥с若鴻鴻帥鴻綽荀с 鴻帥鴻c≪若ゃ潟帥с若鴻絎茖障ゃ≪潟с≪若吾сс絎鴻帥с障帥ゃ鴻泣若弱眼х若若喝冴絎茖鴻c鴻篏帥障絎茖鴻帥ゃ鴻綽荀с
42.242 .LP
42.243 -JRMP プロトコルサーバ側エンティティである
42.244 -リモートオブジェクトのスケルトンには、
42.245 -リモートオブジェクト実装の呼び出しを
42.246 -ディスパッチするメソッドがあります。
42.247 +\f2\-iiop\fP 篏帥c \f2rmic\fP 若喝冴罨<遵荀靘羣鴻帥 Tie 障
42.248 +.RS 3
42.249 +
42.250 .LP
42.251 -リモートオブジェクトの Tie は、スケルトンに似た
42.252 -サーバ側エンティティですが、IIOP プロトコル
42.253 -を使用してクライアントと通信します。
42.254 -.LP
42.255 -スタブは、リモートオブジェクトのプロキシで、
42.256 -実際のリモートオブジェクト実装が存在するサーバに、
42.257 -リモートオブジェクトに対するメソッド呼び出しを転送します。
42.258 -クライアントのリモートオブジェクトへの参照は、
42.259 -実際にはローカルスタブへの参照です。
42.260 -.LP
42.261 -デフォルトでは、
42.262 -.B rmic
42.263 -は \-v1.2 オプションが
42.264 -指定された場合と同様に 1.2 JRMP スタブプロトコルを
42.265 -使用するスタブクラスを生成します (1.5 より前の
42.266 -リリースでは、\-vcompat オプションがデフォルト)。
42.267 -IIOP プロトコル用のスタブクラスおよび Tie クラスを
42.268 -生成するには、\-iiop オプションを使用します。
42.269 -.LP
42.270 -スタブは、リモートインタフェースのみを実装し、
42.271 -リモートオブジェクトによっても実装されるローカル
42.272 -インタフェースは実装しません。スタブはリモート
42.273 -オブジェクトとまったく同じリモートインタフェースの
42.274 -セットを実装するため、クライアントはキャストおよび
42.275 -型チェックに Java 言語の組み込み演算子を使用できます。
42.276 -IIOP の場合は、
42.277 -.B PortableRemoteObject.narrow
42.278 -メソッドを
42.279 -使用する必要があります。
42.280 -.SH オプション
42.281 -.if t .TP 20
42.282 -.if n .TP 15
42.283 -.BI \-bootclasspath " path"
42.284 -ブートストラップクラスファイルの位置をオーバーライドします。
42.285 -.if t .TP 20
42.286 -.if n .TP 15
42.287 -.BI \-classpath " path"
42.288 -.B rmic
42.289 -がクラスを探すのに用いるパスを
42.290 -.I path
42.291 -で指定します。この指定値は、デフォルトおよび
42.292 -.B CLASSPATH
42.293 -環境変数の設定値をオーバーライドします。
42.294 -複数のディレクトリを指定する場合はコロンで区切ります。
42.295 -したがって
42.296 -.I path
42.297 -の通常の形式は次のようになります。
42.298 -.sp 1n
42.299 -.ti +5n
42.300 -.BI .:< your_path >
42.301 -.sp 1n
42.302 -以下に例を示します。
42.303 -.sp 1n
42.304 -.ti +5n
42.305 -.B .:/usr/local/java/classes
42.306 -.if t .TP 20
42.307 -.if n .TP 15
42.308 -.BI \-d " directory"
42.309 -クラス階層のルートディレクトリを指定します。
42.310 -このオプションを使用して、スタブ、スケルトン、および Tie ファイルの出力先ディレクトリを指定できます。
42.311 -たとえば、次のコマンドを入力します。
42.312 -.LP
42.313 -.RS 5
42.314 -rmic \-d /java/classes foo.MyClass
42.315 +.nf
42.316 +\f3
42.317 +.fl
42.318 +_<implementationName>_stub.class
42.319 +.fl
42.320 +\fP
42.321 +.br
42.322 +\f3
42.323 +.fl
42.324 +_<interfaceName>_tie.class
42.325 +.fl
42.326 +\fP
42.327 +.fi
42.328 .RE
42.329 .LP
42.330 -この例では、MyClass から派生したスタブおよび
42.331 -スケルトンクラスをディレクトリ /java/classes/foo
42.332 -に配置します。\-d オプションが指定されていない場合、
42.333 -デフォルトの動作は「\-d .」が指定された場合と同様です。
42.334 -ターゲットクラスのパッケージ階層は、
42.335 -現在のディレクトリに作成され、スタブ/Tie/スケルトン
42.336 -ファイルはその階層内に配置されます。
42.337 -(以前の一部のバージョンの
42.338 -.B rmic
42.339 -では、
42.340 -\-d が指定されなかった場合、パッケージ階層は作成されず、
42.341 -すべての出力ファイル
42.342 -は、現在のディレクトリ内に直接配置されました。)
42.343 -.if t .TP 20
42.344 -.if n .TP 15
42.345 -.BI \-extdirs " path"
42.346 -インストールされている拡張機能の位置を上書きします。
42.347 -.if t .TP 20
42.348 -.if n .TP 15
42.349 -.B \-g
42.350 -ローカル変数を含む、すべてのデバッグ情報の
42.351 -生成を有効にします。デフォルトでは、
42.352 -行番号情報のみが生成されます。
42.353 -.if t .TP 20
42.354 -.if n .TP 15
42.355 -.B \-idl
42.356 -.B rmic
42.357 -によって、指定したクラスおよび参照されたクラスの
42.358 -.SM OMG IDL
42.359 -が生成されます。
42.360 -.SM IDL
42.361 -では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの
42.362 -.SM API
42.363 -を指定できます。
42.364 -.SM IDL
42.365 -は、
42.366 -.SM CORBA
42.367 -バインディングを提供する任意の言語 (Java、C++ など) を使用して、メソッドおよびデータの
42.368 -書き込みおよび呼び出しを行うときの仕様として使われます。
42.369 -.B \-idl
42.370 -オプションは、合わせて以下のオプションも指定できます。
42.371 -.RS
42.372 -.TP 5
42.373 -.BR \-always " または " \-alwaysgenerate
42.374 -既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的に生成し直します。
42.375 -.PD 0
42.376 -.TP
42.377 -.B \-factory
42.378 -生成された IDL で factory キーワードを使います。
42.379 -.TP
42.380 -.B \-idlModule fromJavaPackage[.class] toIDLModule
42.381 -.B IDLEntity
42.382 -パッケージのマッピングを指定します。次に例を示します。
42.383 -.sp 1n
42.384 -.in +5n
42.385 -.ft 3
42.386 +\f2\-iiop\fP 激с潟篏帥祉激с潟絎с障
42.387 +.RS 3
42.388 +.TP 3
42.389 +\-always 障 \-alwaysgenerate
42.390 +√鴻帥Tie IDL ュ鴻違с綣桁句眼障
42.391 +.TP 3
42.392 +\-nolocalstubs
42.393 +祉鴻ゃ≪潟泣若若絲障鴻帥篏障
42.394 +.TP 3
42.395 +\-noValueMethods
42.396 +\f2\-idl\fP 激с潟篏帥違障肴 IDL \f2valuetype\fP <純喝絖菴遵障<純喝絖\f2valuetype\fP 翫激с潟с \f2\-idl\fP 激с潟篏帥 \f2\-noValueMethods\fP 激с潟絎障
42.397 +.TP 3
42.398 +\-poa
42.399 +膓帥 \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP \f2org.omg.PortableServer.Servant\fP 紊障
42.400 +.LP
42.401 +.na
42.402 +\f2Portable Object Adapter\fP @
42.403 +.fi
42.404 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) \f2PortableServer\fP ≪吾ャ若ゃc \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違<純箴障 <純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫c泣若潟篏九勝若吟若若若ゃ障OMG IDL to Java Language Mapping SpecificationCORBA V 2.3.1 ptc/00\-01\-08.pdf 羣障
42.405 +.RE
42.406 +.TP 3
42.407 +\-J
42.408 +\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝<障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
42.409 +.TP 3
42.410 +\-keep 障 \-keepgenerated
42.411 +鴻帥鴻宴潟障 Tie 鴻 \f2.java\fP 純若鴻<ゃ \f2.class\fP <ゃc罧障
42.412 +.TP 3
42.413 +\-nowarn
42.414 +茘障激с潟絎潟潟ゃ茘茵腓冴障
42.415 +.LP
42.416 +.TP 3
42.417 +\-vcompat
42.418 +1.1 1.2 筝≧鴻 JRMP 鴻帥潟若吾с潟篋с鴻帥潟鴻宴潟鴻篏障(5.0 篁ュ若鴻с激с潟)鴻帥鴻JDK 1.1 篁潟激潟若 1.1 鴻帥潟若吾с潟篏睡JDK 1.2 篁ラ篁潟激潟若 1.2 鴻帥潟若吾с潟篏睡障鴻宴潟鴻с1.1 1.2 筝≧鴻鴻帥潟若吾с潟泣若障鴻筝≧鴻篏≪若泣若泣ゃ冴紊с障
42.419 +.TP 3
42.420 +\-verbose
42.421 +潟潟ゃ潟若潟潟ゃ鴻若鴻<ゃゃ<祉若吾茵腓冴障
42.422 +.LP
42.423 +.TP 3
42.424 +\-v1.1
42.425 +1.1 JRMP 鴻帥潟若吾с潟帥鴻帥潟鴻宴潟鴻障激с潟篏睡сJDK 1.1 \f3rmic\fP 若х≪違若с (ゃ鴻若c潟違篏睡) √鴻帥鴻絲障翫篋с鴻帥鴻翫с
42.426 +.LP
42.427 +.TP 3
42.428 +\-v1.2
42.429 +() 1.2 JRMP 鴻帥潟若吾с潟帥鴻帥鴻障鴻宴潟鴻 1.2 鴻帥潟若吾с潟т戎с激с潟с鴻宴潟鴻障鴻帥鴻JDK 1.1 篁潟激潟若篏障
42.430 +.RE
42.431 +
42.432 +.LP
42.433 +.SH "医紊"
42.434 +.LP
42.435 +
42.436 +.LP
42.437 +.RS 3
42.438 +.TP 3
42.439 +CLASSPATH
42.440 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障罨<箴腓冴障
42.441 +.RS 3
42.442 +
42.443 +.LP
42.444 .nf
42.445 -\-idlModule foo.bar
42.446 -my::real::idlmod.
42.447 +\f3
42.448 +.fl
42.449 +.:/usr/local/java/classes
42.450 +.fl
42.451 +\fP
42.452 .fi
42.453 -.ft 1
42.454 -.in
42.455 -.sp 1n
42.456 -.TP
42.457 -.B \-idlFile fromJavaPackage[.class] toIDLFile
42.458 -.B IDLEntity
42.459 -ファイルのマッピングを指定します。次に例を示します。
42.460 -.sp 1n
42.461 -.ti +5n
42.462 -.B \-idlFile test.pkg.X TEST16.idl
42.463 .RE
42.464 -.PD
42.465 -.if t .TP 20
42.466 -.if n .TP 15
42.467 -.B \-iiop
42.468 -.B rmic
42.469 -は、
42.470 -.SM JRMP
42.471 -のスタブとスケルトンクラスの代わりに、
42.472 -.SM IIOP
42.473 -のスタブと Tie クラスを生成します。スタブクラスは、リモートオブジェクトの
42.474 -ローカルプロキシで、クライアントがサーバに呼び出しを送信するときに
42.475 -使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラス
42.476 -によってリモートインタフェースが実装されます。クライアントでリモートオブジェクト
42.477 -を参照すると、実際にはスタブを参照することになります。Tie クラスは、
42.478 -サーバ側で受信した呼び出しを処理し、その呼び出しを適切な実装クラスにディスパッチ
42.479 -するときに使われます。各実装クラスには、Tie クラスが必要です。
42.480 -.sp 1n
42.481 -.B \-iiop
42.482 -を指定して
42.483 -.B rmic
42.484 -を起動すると、次の命名規約に準拠したスタブと Tie が生成されます。
42.485 -.sp 1n
42.486 -.in +5n
42.487 -.ft 3
42.488 -.nf
42.489 -_<implementationName>_stub.class
42.490 -.sp 1n
42.491 -_<interfaceName>_tie.class
42.492 -.ft 1
42.493 +.RE
42.494 +
42.495 +.LP
42.496 +.SH "∫i"
42.497 +.LP
42.498 +
42.499 +.LP
42.500 +.LP
42.501 +java(1)javac(1)
42.502 +.na
42.503 +\f2CLASSPATH\fP @
42.504 .fi
42.505 -.in
42.506 -.sp 1n
42.507 -.B \-iiop
42.508 -オプションは、合わせて以下のオプションも指定できます。
42.509 -.sp 1n
42.510 -.ne 1
42.511 -.bp
42.512 -.RS
42.513 -.PD 0
42.514 -.TP 5
42.515 -.BR \-always " または " \-alwaysgenerate
42.516 -既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的
42.517 -に生成し直します。
42.518 -.TP
42.519 -.B \-nolocalstubs
42.520 -同じプロセスのクライアントとサーバに対して最適化されたスタブを作成しません。
42.521 -.TP
42.522 -.B \-noValueMethods
42.523 -.B \-idl
42.524 -オプションとともに使用する必要があります。発行された
42.525 -.SM IDL\s0
42.526 -に、valuetype メソッドおよび初期化子を追加しません。このメソッドおよび初期化子
42.527 -は、valuetype のオプションです。
42.528 -.B \-idl
42.529 -オプションを使うときは、
42.530 -.B \-noValueMethods
42.531 -オプションを指定しない限り生成されます。
42.532 -.TP
42.533 -.B \-poa
42.534 -.br
42.535 -継承を
42.536 -.BR org.omg.CORBA_2_3.portable.ObjectImpl から
42.537 -.BR org.omg.PortableServer.Servant\. へ変更します。
42.538 -.RS
42.539 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
42.540 .LP
42.541 -Portable Object Adapter (POA) の
42.542 -.BR PortableServer
42.543 -モジュールは、ネイティブ の servant 型を定義します。
42.544 -Java プログラミング言語では、servant 型は、Java の
42.545 -.BR org.omg.PortableServer.Servant
42.546 -クラスにマップされます。これはすべての POA サーバント実装の基底クラスとして
42.547 -機能し、アプリケーション開発者が呼び出せる多数のメソッドを提供します。また、
42.548 -POA 自体が読み出したり、サーバント動作を制御するためにユーザが上書きした
42.549 -りできるメソッドも提供します。CORBA V 2.3.1 の「OMG IDL to Java Language Mapping Specfication (ptc/00-01-08.pdf)」に基づいています。
42.550 -.RE
42.551 -.PD
42.552 -.RE
42.553 -.TP 20
42.554 -.if t .TP 20
42.555 -.if n .TP 15
42.556 -.B \-J
42.557 -任意の java オプションと
42.558 -併用した場合、
42.559 -\-J の後のオプション (
42.560 -.B \-J
42.561 -とオプションの間は空白文字をいれない)
42.562 -を java インタプリタに
42.563 -渡します。
42.564 -.if t .TP 20
42.565 -.if n .TP 15
42.566 -.B \-keepgenerated
42.567 -スタブ、スケルトンおよび tie クラス用に生成された .java ソースファイルを保持し、.class ファイルと同じディレクトリに書き込みます。
42.568 -.if t .TP 20
42.569 -.if n .TP 15
42.570 -.B \-nowarn
42.571 -警告をオフにします。このオプションを使用した場合、コンパイラは警告を出力しません。
42.572 -.if t .TP 20
42.573 -.if n .TP 15
42.574 -.B \-vcompat
42.575 -1.1 と 1.2 の両方の JRMP スタブプロトコル
42.576 -バージョンと互換性があるスタブおよび
42.577 -スケルトンクラスを生成します (1.5 より前の
42.578 -リリースでは、このオプションはデフォルト)。
42.579 -生成されたスタブクラスは、JDK 1.1 の仮想マシンに
42.580 -読み込まれる場合、1.1 のスタブプロトコルバージョンを
42.581 -使用し、1.2 以降の仮想マシンに読み込まれる場合は、
42.582 -1.2 のスタブプロトコルバージョンを使用します。
42.583 -生成されたスケルトンクラスは、1.1 と 1.2 の両方の
42.584 -スタブプロトコルバージョンをサポートします。
42.585 -生成されたクラスは、両方の操作モードをサポート
42.586 -するため、比較的サイズが大きくなります。
42.587 -.if t .TP 20
42.588 -.if n .TP 15
42.589 -.B \-verbose
42.590 -コンパイラとリンカに詳細情報を出力させます。具体的には、
42.591 -コンパイルされるクラスファイル、およびロードされる
42.592 -クラスファイルに関する情報が出力されます。
42.593 -.TP 15
42.594 -.B \-v1.1
42.595 -JDK 1.1 のスタブプロトコルバージョン
42.596 -専用のスタブおよびスケルトンを作成します。
42.597 -このオプションは、JDK 1.1 から
42.598 -.B rmic
42.599 -によって生成され、アップグレードできない
42.600 -(および動的クラスローディングが使用
42.601 -されていない) 既存の静的に配備された
42.602 -スタブクラスと直列化互換性のあるスタブ
42.603 -クラスを生成する場合にのみ使用します。
42.604 -.if t .TP 20
42.605 -.if n .TP 15
42.606 -.B \-v1.2
42.607 -(デフォルト) 1.2 JRMP のスタブプロトコル
42.608 -バージョン専用のスタブクラスを生成します。
42.609 -スケルトンクラスは 1.2 のスタブプロトコル
42.610 -バージョンで使用されないため、このオプション
42.611 -ではスケルトンクラスが生成されません。
42.612 -生成されたスタブクラスが JDK 1.1 の仮想マシンに
42.613 -読み込まれた場合は、機能しません。
42.614 -.SH 環境変数
42.615 -.if t .TP 20
42.616 -.if n .TP 15
42.617 -.B CLASSPATH
42.618 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
42.619 -ディレクトリはコロンで
42.620 -区切ります。以下に例を示します。
42.621 -.sp 1n
42.622 -.ti +5n
42.623 -.B .:/usr/local/java/classes
42.624 -.SH 関連項目
42.625 -.BR java (1),
42.626 -.BR javac (1),
42.627 -.BR CLASSPATH
42.628 +
42.629 +.LP
42.630 +
43.1 --- a/src/linux/doc/man/ja/rmid.1 Tue May 12 15:21:55 2009 +0900
43.2 +++ b/src/linux/doc/man/ja/rmid.1 Thu May 14 00:17:25 2009 -0700
43.3 @@ -1,563 +1,358 @@
43.4 -'\" t
43.5 -.\"
43.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
43.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
43.8 -.\"
43.9 -.\" This code is free software; you can redistribute it and/or modify it
43.10 -.\" under the terms of the GNU General Public License version 2 only, as
43.11 -.\" published by the Free Software Foundation.
43.12 -.\"
43.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
43.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
43.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
43.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
43.17 -.\" accompanied this code).
43.18 -.\"
43.19 -.\" You should have received a copy of the GNU General Public License version
43.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
43.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
43.22 -.\"
43.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
43.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
43.25 -.\" have any questions.
43.26 -.\"
43.27 -.\"
43.28 -.TH rmid 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
43.29 -.SH "名前"
43.30 -rmid \- RMI 起動システムデーモン
43.31 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
43.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
43.33 +."
43.34 +." This code is free software; you can redistribute it and/or modify it
43.35 +." under the terms of the GNU General Public License version 2 only, as
43.36 +." published by the Free Software Foundation.
43.37 +."
43.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
43.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
43.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
43.41 +." version 2 for more details (a copy is included in the LICENSE file that
43.42 +." accompanied this code).
43.43 +."
43.44 +." You should have received a copy of the GNU General Public License version
43.45 +." 2 along with this work; if not, write to the Free Software Foundation,
43.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
43.47 +."
43.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
43.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
43.50 +." have any questions.
43.51 +."
43.52 +.TH rmid 1 "04 May 2009"
43.53 +." Generated from HTML by html2man (author: Eric Armstrong)
43.54 +
43.55 +.LP
43.56 +.SH ""
43.57 +rmid \- Java RMI 莎桁激鴻若≪
43.58 +.LP
43.59 +.RS 3
43.60 +
43.61 +.LP
43.62 +.LP
43.63 +\f3rmid\fP ц儀激鴻若≪潟紮吾с篁潟激 (VM) 脂蚊莎桁с障
43.64 +.LP
43.65 +.RE
43.66 +.SH "綵√"
43.67 .LP
43.68
43.69 .LP
43.70 -.LP
43.71 -\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
43.72 -.LP
43.73 -.SH "形式"
43.74 -.B rmid
43.75 -[
43.76 -.I options
43.77 -]
43.78 -.SH "機能説明"
43.79 -.IX "RMI activation system daemon" "" "RMI activation system daemon \(em \fLrmid\fP"
43.80 -.IX "rmid" "" "\fLrmid\fP \(em RMI activation system daemon"
43.81 -.B rmid
43.82 -ツールは、起動システムデーモンを開始します。起動可能なオブジェクトを起動
43.83 -システムに登録したり、Java VM でアクティブにしたりするには、あらかじめ起動
43.84 -システムデーモンを開始しておく必要があります。
43.85 -起動可能なリモートオブジェクト
43.86 -を使ったプログラムの作成方法についての詳細は、Java RMI の仕様
43.87 +.nf
43.88 +\f3
43.89 +.fl
43.90 +rmid [options]
43.91 +.fl
43.92 +\fP
43.93 .fi
43.94 - (http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html)
43.95 -および起動のチュートリアル
43.96 -.fi
43.97 - (http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.html)
43.98 -を参照してください。
43.99 -.LP
43.100 -起動システムデーモンは、次のようにセキュリティポリシーファイルを指定して
43.101 -.B rmid
43.102 -コマンドを実行することによって開始できます。
43.103 -.LP
43.104 -.ti +5n
43.105 -.B % rmid \-J\-Djava.security.policy=rmid.policy
43.106 -.LP
43.107 -注: Sun の
43.108 -.BR rmid
43.109 -実装を実行する場合、デフォルトではセキュリティポリシーファイルを指定する必要があります。そうすることで、起動グループ用の JVM の起動に、各
43.110 -.B ActivationGroupDesc
43.111 -内の情報を使用できるかどうかを
43.112 -.B rmid
43.113 -が確認できます。特に、
43.114 -.B CommandEnvironment
43.115 -により指定されるコマンドやオプション、および
43.116 -.B ActivationGroupDesc
43.117 -のコンストラクタに渡されるすべての
43.118 -.B プロパティ
43.119 -は、
43.120 -.BR rmid
43.121 -用のセキュリティポリシーファイルで明示的に許可することが必要になりました。
43.122 -.B sun.rmi.activation.execPolicy
43.123 -プロパティの値は、起動グループの JVM の起動に
43.124 -.B ActivationGroupDesc
43.125 -内の情報を使用できるかどうかの判断に
43.126 -.B rmid
43.127 -が使用するポリシーを定義します。
43.128 -.LP
43.129 -.B rmid
43.130 -をデフォルト設定で実行することにより、以下が行われます。
43.131 -.LP
43.132 -.RS
43.133 -.TP 2
43.134 -\(bu
43.135 -このコマンドはアクティベータを起動するとともにデフォルトポートの
43.136 -.BR 1098
43.137 -で内部レジストリを
43.138 -開始し、
43.139 -.LP
43.140 -.PD 0
43.141 -.TP
43.142 -\(bu
43.143 -.B ActivationSystem
43.144 -を
43.145 -.B java.rmi.activation.ActivationSystem
43.146 -という名前に内部レジストリ上でバインドします。
43.147
43.148 .LP
43.149 -.RE
43.150 -レジストリにほかのポートを指定するには、
43.151 -.BR rmid
43.152 -の起動時に
43.153 -.B -port
43.154 -オプションを指定しなければなりません。たとえば、次のようにします。
43.155 -
43.156 -.ti +5n
43.157 -.LP
43.158 -.B rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
43.159 -
43.160 -.LP
43.161 -このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート
43.162 -.B 1099
43.163 -でレジストリを開始します。
43.164 -
43.165 -.LP
43.166 -.SS inetd/xinetd からの rmid の起動
43.167 -
43.168 -コマンド行から
43.169 -.B rmid
43.170 -を起動しないで、
43.171 -inetd (Solaris) または xinetd (Linux) を設定し、
43.172 -.B rmid
43.173 -を必要に応じて起動することができます。
43.174 -
43.175 -.LP
43.176 -起動時に
43.177 -.B rmid
43.178 -は、System.inheritedChannel メソッドを呼び出して
43.179 -継承チャネル (inetd/xinetd からの継承) の
43.180 -取得を試みます。
43.181 -継承されたチャンネルが \f2null\fP であるか、\f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、\f2rmid\fP はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
43.182 -
43.183 -.LP
43.184 -.LP
43.185 -継承チャンネルが ServerSocketChannel
43.186 -インスタンスの場合、
43.187 -.B rmid
43.188 -は ServerSocketChannel から
43.189 -取得した java.net.ServerSocket を、
43.190 -エクスポートするリモートオブジェクト
43.191 -(java.rmi.activation.ActivationSystem が
43.192 -バインドされるレジストリと
43.193 -java.rmi.activation.Activator
43.194 -リモートオブジェクト) に対する要求を
43.195 -受け入れるサーバソケットとして使用します。
43.196 -.LP
43.197 -このモードでは、
43.198 -.B rmid
43.199 -の動作は、次のことを除いて、
43.200 -コマンド行から起動した場合と同じです。
43.201 -
43.202 -.TP 2
43.203 -\(bu System.err に表示される出力はファイルにリダイレクト
43.204 -されます。このファイルは、接頭辞「rmid-err」と接尾辞「tmp」を
43.205 -使用して java.io.tmpdir システムプロパティ
43.206 -(通常 /var/tmp または /tmp) で指定したディレクトリにあります。
43.207 -
43.208 -.TP 2
43.209 -\(bu \-port オプションは許可されていません。このオプションが
43.210 -指定されている場合、
43.211 -.B rmid
43.212 -はエラーメッセージを表示して
43.213 -終了します。
43.214 -
43.215 -.TP 2
43.216 -\(bu \-log オプションは必須です。このオプションが
43.217 -指定されていない場合、
43.218 -.B rmid
43.219 -はエラーメッセージを表示して
43.220 -終了します。
43.221 -
43.222 -.LP
43.223 -必要に応じて開始するサービスの設定方法についての詳細は、
43.224 -inetd (Solaris) または xinetd (Linux) のマニュアルページを
43.225 -参照してください。
43.226 -
43.227 -.SH "オプション"
43.228 -
43.229 -.TP
43.230 -.BI \-C someCommandLineOption
43.231 -.B rmid
43.232 -の子プロセス (起動グループ) が作成されたときに、各子プロセスにコマンド行引数
43.233 -として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム
43.234 -デーモンによって生成される各 Java Virtual Machine にプロパティを渡すことができます。
43.235 -
43.236 -.sp 1n
43.237 -.ti +5n
43.238 -.B rmid \-C\-Dsome.property=value
43.239 -
43.240 -.sp 1n
43.241 -コマンド行引数を子プロセスに渡す機能は、デバッグを行う際に便利です。
43.242 -たとえば、次のようなコマンドを実行できます。
43.243 -
43.244 -.sp 1n
43.245 -.ti +5n
43.246 -.B rmid \-C\-Djava.rmi.server.logCalls=true
43.247 -
43.248 -.sp 1n
43.249 -このコマンドによって、すべての子 JVM でサーバ呼び出しのログが残るようになります。
43.250 -
43.251 -.TP
43.252 -.BI \-J<someCommandLineOption>
43.253 -.B rmid
43.254 -を実行中の java インタプリタに渡すオプションを指定します。たとえば、
43.255 -.B rmid
43.256 -で
43.257 -.BR rmid.policy
43.258 -という名前のポリシーファイルを使用する場合、
43.259 -.BR rmid
43.260 -のコマンド行で
43.261 -.B \-J
43.262 -オプションを使って
43.263 -.B java.security.policy
43.264 -プロパティを定義します。次に例を示します。
43.265 -
43.266 -.sp 1n
43.267 -.ti +5n
43.268 -.B rmid \-J\-Djava.security.policy=rmid.policy
43.269 -
43.270 -.TP
43.271 -.BI \-J\-Dsun.rmi.activation.execPolicy=<policy>
43.272 -起動グループの実行対象となる JVM の起動に使用するコマンドおよびコマンド行オプションを検査するために、
43.273 -.B rmid
43.274 -が採用するポリシーを指定します。このオプションは、Sun の RMI 起動デーモン実装だけに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は
43.275 -.B \-J-Dsun.rmi.activation.execPolicy=default
43.276 -を指定した場合と同じになります。
43.277 -.IR policy
43.278 -に指定可能な値は、
43.279 -.BR default
43.280 -、
43.281 -.IR policyClassName
43.282 -、または none です。
43.283 -.BR
43.284 -
43.285 -.RS
43.286 -.TP 2
43.287 -\(bu
43.288 -.B default
43.289 -(または、このプロパティを指定しない場合)
43.290 -
43.291 -.LP
43.292 -デフォルトの
43.293 -.B execPolicy
43.294 -では、使用するセキュリティポリシーファイル内のコマンドおよびオプションを実行する権限が
43.295 -.B rmid
43.296 -に与えられる場合にのみ、
43.297 -.B rmid
43.298 -は特定のコマンド行オプションを指定してコマンドを実行できます。
43.299 -.BR default
43.300 -の実行ポリシーを使用できるのは、
43.301 -デフォルトの起動グループ実装だけです。
43.302 -.sp 1n
43.303 -
43.304 -.B rmid
43.305 -は、起動グループの JVM を起動する際、その登録された起動グループ記述子である
43.306 -.BR ActivationGroupDesc
43.307 -内の情報を使用します。グループ記述子では、オプションの
43.308 -.B ActivationGroupDesc.CommandEnvironment
43.309 -を指定します。これには、起動グループを開始する「コマンド」、およびコマンド行に追加する
43.310 -任意のコマンド行「オプション」が含まれます。デフォルトでは、
43.311 -.B rmid
43.312 -は
43.313 -.BR java.home
43.314 -にある
43.315 -.B java
43.316 -コマンドを使用します。グループ記述子には、次に示すように、オプションとしてコマンド行に
43.317 -追加される「プロパティ」オーバーライドも含まれます。
43.318 -
43.319 -.sp 1n
43.320 -.ti +5n
43.321 -.BI \-D<property>=<value>
43.322 -
43.323 -.sp 1n
43.324 -アクセス権
43.325 -.B com.sun.rmi.rmid.ExecPermission
43.326 -を使用すると、
43.327 -.B rmid
43.328 -に対し、グループ記述子の
43.329 -.B CommandEnvironment
43.330 -で指定されたコマンドを実行して起動グループを開始する権限を与えることができます。
43.331 -アクセス権
43.332 -.B com.sun.rmi.rmid.ExecOptionPermission
43.333 -を使用すると、起動グループを開始するときに、
43.334 -グループ記述子でプロパティオーバーライドとして指定されたコマンド行
43.335 -オプション、または
43.336 -.BR CommandEnvironment
43.337 -でオプションとして指定されたコマンド行オプションを
43.338 -.B rmid
43.339 -から使用できます。
43.340 -
43.341 -.sp 1n
43.342 -.B rmid
43.343 -にさまざまなコマンドおよびオプションを実行する権限を与える場合、アクセス権
43.344 -.B ExecPermission
43.345 -および
43.346 -.B ExecOptionPermission
43.347 -を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
43.348 -
43.349 -.TP
43.350 -.BI ExecPermission
43.351 -.B ExecPermission
43.352 -クラスは、起動グループを開始するために
43.353 -.B rmid
43.354 -が特定の「コマンド」を実行する権限を表します。
43.355 -.sp 1n
43.356 -.TP
43.357 -.B 構文
43.358 -.br
43.359 -.B ExecPermission
43.360 -の「名前」は、
43.361 -.B rmid
43.362 -に実行権限を与えるコマンドのパス名です。「/*」(「/」はファイル区切り文字、つまり
43.363 -.BR File.separatorChar
43.364 -) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを表します。「/-」
43.365 -で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ
43.366 -(再帰的に) を表します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、
43.367 -任意のファイルに一致します。
43.368 -.sp 1n
43.369 -
43.370 -.B 注:
43.371 -「*」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルを表し、
43.372 -「-」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルと、
43.373 -現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
43.374 -
43.375 -.TP
43.376 -.BI ExecOptionPermission
43.377 -.B ExecOptionPermission
43.378 -クラスは、起動グループの開始時に
43.379 -.B rmid
43.380 -が特定のコマンド行「オプション」を使用する権限を表します。
43.381 -.B ExecOptionPermission
43.382 -の「名前」は、コマンド行オプションの値です。
43.383 -.sp 1n
43.384 -.TP
43.385 -.B 構文
43.386 -.br
43.387 -オプションでは、制限付きワイルドカード指定がサポートされます。
43.388 -アスタリスクは、ワイルドカードマッチングを指定します。アスタリスクは、
43.389 -オプション名自体を表す (つまり、すべてのオプションに一致する) ために
43.390 -使用できます。また、「.」および「=」の次に指定する場合にのみ、
43.391 -オプション名の最後にアスタリスクを使用できます。
43.392 -.sp 1n
43.393 -
43.394 -例を示します。「*」、「-Dfoo.*」、「-Da.b.c=*」は有効です。「*foo」、「-Da*b」
43.395 -、「ab*」は無効です。
43.396 -
43.397 -.TP
43.398 -.BI rmid のポリシーファイル
43.399 -.B rmid
43.400 -にさまざまなコマンドおよびオプションを実行する権限を与える場合は、アクセス権
43.401 -.B ExecPermission
43.402 -および
43.403 -.B ExecOptionPermission
43.404 -を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
43.405 -これらのアクセス権を検査するのは
43.406 -.B rmid
43.407 -だけであるため、普遍的に許可しても安全です。
43.408 -
43.409 -.sp 1n
43.410 -.B rmid
43.411 -にさまざまな実行権限を許可するポリシーファイルの例を、次に示します。
43.412 -
43.413 -.sp 1n
43.414 -.ft 3
43.415 -.nf
43.416 -grant {
43.417 - permission com.sun.rmi.rmid.ExecPermission
43.418 - "/files/apps/java/jdk1.2.2/solaris/bin/java";
43.419 -
43.420 - permission com.sun.rmi.rmid.ExecPermission
43.421 - "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
43.422 -
43.423 - permission com.sun.rmi.rmid.ExecPermission
43.424 - "/files/apps/rmidcmds/*";
43.425 -
43.426 - permission com.sun.rmi.rmid.ExecOptionPermission
43.427 - "-Djava.security.policy=/files/policies/group.policy";
43.428 -
43.429 - permission com.sun.rmi.rmid.ExecOptionPermission
43.430 - "-Djava.security.debug=*";
43.431 -
43.432 - permission com.sun.rmi.rmid.ExecOptionPermission
43.433 - "-Dsun.rmi.*";
43.434 -};
43.435 -
43.436 -.fi
43.437 -.ft 1
43.438 -
43.439 -.sp 1n
43.440 -最初の 2 つのアクセス権は、
43.441 -.B rmid
43.442 -に対し、パス名により明示された 1.2.2 バージョンの
43.443 -.B java
43.444 -コマンドを実行する許可を与えます。デフォルトでは、
43.445 -.B java.home
43.446 -にある
43.447 -.B java
43.448 -コマンドのバージョン (
43.449 -.B rmid
43.450 -が使用するのと同じもの) が使用されるため、ポリシーファイルで指定する必要はありません。
43.451 -3 番目のアクセス権は、
43.452 -.B rmid
43.453 -に対し、ディレクトリ
43.454 -.BR /files/apps/rmidcmds
43.455 -内の任意のコマンドを実行する権限を与えます。
43.456 -
43.457 -.sp 1n
43.458 -4 番目に許可されたアクセス権
43.459 -.BR ExecOptionPermission
43.460 -は、
43.461 -.B rmid
43.462 -に対し、セキュリティポリシーファイルを
43.463 -.BR /files/policies/group.policy
43.464 -に定義する起動グループを開始する権限を与えます。次のアクセス権は、起動グループが
43.465 -.B java.security.debug
43.466 -プロパティを使用する権限を与えます。最後のアクセス権は、
43.467 -起動グループが
43.468 -.B sun.rmi
43.469 -プロパティ名階層内の任意のプロパティを使用する権限を与えます。
43.470 -
43.471 -.sp 1n
43.472 -ポリシーファイルを使って
43.473 -.B rmid
43.474 -を起動するには、
43.475 -.BR rmid
43.476 -のコマンド行で
43.477 -.B java.security.policy
43.478 -プロパティを指定する必要があります。次に例を示します。
43.479 -
43.480 -.sp 1n
43.481 -.ti +5n
43.482 -.B rmid \-J\-Djava.security.policy=rmid.policy
43.483 -
43.484 -.TP 2
43.485 -\(bu
43.486 -.I <policyClassName>
43.487 -
43.488 -.sp 1n
43.489 -デフォルトの動作では十分な柔軟性が得られない場合、管理者は
43.490 -.BR rmid
43.491 -の起動時に、
43.492 -.B checkExecCommand
43.493 -メソッドが実行されるクラスの名前を指定することにより、
43.494 -.BR rmid
43.495 -が実行するコマンドを検査できます。
43.496 -.sp 1n
43.497 -
43.498 -.IR policyClassName
43.499 -には、public で引数を必要としないコンストラクタとともに public クラスを指定します。また、次の
43.500 -.B checkExecCommand
43.501 -メソッド実装も指定します。
43.502 -
43.503 -.sp 1n
43.504 -.ft 3
43.505 -.nf
43.506 -.in +5n
43.507 -public void checkExecCommand(ActivationGroupDesc desc,
43.508 - String[] command)
43.509 - throws SecurityException;
43.510 -.in
43.511 -.fi
43.512 -.ft 1
43.513 -
43.514 -.sp 1n
43.515 -起動グループを開始する前に、
43.516 -.B rmid
43.517 -は、ポリシーの
43.518 -.BR checkExecCommand
43.519 -メソッドを呼び出して、起動グループの記述子および起動グループを開始する完全な
43.520 -コマンドを含む配列を渡します。
43.521 -.B checkExecCommand
43.522 -が
43.523 -.BR SecurityException
43.524 -をスローする場合、
43.525 -.B rmid
43.526 -は起動グループを開始せず、オブジェクトの起動を試みている呼び出し側に
43.527 -.B ActivationException
43.528 -がスローされます。
43.529 -
43.530 -.TP
43.531 -\(bu
43.532 -.B none
43.533 -
43.534 -.sp 1n
43.535 -.B sun.rmi.activation.execPolicy
43.536 -プロパティの値が「none」の場合、
43.537 -.B rmid
43.538 -は、起動グループの開始コマンドの検証を一切行いません。
43.539 -
43.540 -.TP
43.541 -
43.542 -.BI \-log " dir"
43.543 -起動システムデーモンがデータベースおよび関連情報を書き込むのに使う、
43.544 -ディレクトリの名前を指定します。デフォルトでは、
43.545 -.B rmid
43.546 -コマンドを実行したディレクトリに
43.547 -.B log
43.548 -というログディレクトリが作成されます。
43.549 -
43.550 -.TP
43.551 -.BI \-port " port"
43.552 -.BR rmid
43.553 -のレジストリが使うポートを指定します。起動システムデーモンは、
43.554 -.BR java.rmi.activation.ActivationSystem
43.555 -という名前で
43.556 -.BR ActivationSystem
43.557 -をレジストリにバインドします。したがって、ローカルマシンの
43.558 -.B ActivationSystem
43.559 -は、次のように
43.560 -.B Naming.lookup
43.561 -メソッドを呼び出すことによって取得できます。
43.562 -
43.563 -.LP
43.564 -.RS
43.565 -.ft 3
43.566 -.nf
43.567 -import java.rmi.*;
43.568 -import java.rmi.activation.*;
43.569 -
43.570 -ActivationSystem system;
43.571 -system = (ActivationSystem)
43.572 -Naming.lookup("//:port/java.rmi.activation.ActivationSystem");
43.573 -.fl
43.574 -.fi
43.575 -
43.576 -.RE
43.577 -.TP
43.578 -.BI \-stop
43.579 -.B -port
43.580 -オプションによって指定されたポートの、現在の
43.581 -.B rmid
43.582 -の呼び出しを停止します。ポートの指定がない場合は、ポート 1098 で実行されている
43.583 -.B rmid
43.584 -を停止します。
43.585 -.SH "環境変数"
43.586 -.TP 20
43.587 -.SB "CLASSPATH"
43.588 -ユーザ定義クラスへのパスをシステムに通知するために使用します。ディレクトリはコロンで
43.589 -区切ります。以下に例を示します。
43.590 -.RS
43.591 -.LP
43.592 -.ft 3
43.593 -
43.594 -.nf
43.595 -% .:/usr/local/java/classes
43.596 -
43.597 -.fi
43.598 -.ft 1
43.599 -.RE
43.600 -.SH "関連項目"
43.601 +.SH "茯"
43.602 .LP
43.603
43.604 .LP
43.605 .LP
43.606 -rmic、CLASSPATH、java
43.607 +\f3rmid\fP 若莎桁激鴻若≪潟紮障莎桁激鴻若≪潟紮с莎桁純吾с莎桁激鴻脂蚊VM ц儀с障莎桁純≪若吾с篏帥c違篏号荅括完
43.608 +.na
43.609 +\f2Java RMI 篁罕\fP @
43.610 +.fi
43.611 +http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html
43.612 +.na
43.613 +\f2莎桁ャ若≪\fP @
43.614 +.fi
43.615 +http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlс
43.616 +.LP
43.617 +.LP
43.618 +若≪潟莎桁罨<祉ャc若激若<ゃ絎 \f2rmid\fP 潟潟絎茵障
43.619 +.LP
43.620 +.nf
43.621 +\f3
43.622 +.fl
43.623 + rmid \-J\-Djava.security.policy=rmid.policy
43.624 +.fl
43.625 +\fP
43.626 +.fi
43.627 +
43.628 +.LP
43.629 +.LP
43.630 +\f3羈:\fP\f2rmid\fP Sun 絎茖絎茵翫с祉ャc若激若<ゃ絎綽荀障 莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡с \f2rmid\fP 罎荐若сс鴻\f2ActivationGroupDesc\fP 潟潟鴻帥羝< \f2CommandEnvironment\fP 篁紙 \f2Properties\fP c絎潟潟潟激с潟\f2rmid\fP 祉ャc若激若<ゃ筝ф腓榊荐怨綽荀障\f2sun.rmi.activation.execPolicy\fP c若ゃ莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡сゆ \f2rmid\fP 篏睡激若羆阪障
43.631 +.LP
43.632 +.LP
43.633 +\f2rmid\fP 荐絎у茵罨<茵障
43.634 +.LP
43.635 +.RS 3
43.636 +.TP 2
43.637 +o
43.638 +≪c若帥莎桁若 1098 у吾鴻莎桁
43.639 +.TP 2
43.640 +o
43.641 +吾鴻筝с\f2ActivationSystem\fP \f2java.rmi.activation.ActivationSystem\fP ゃ潟
43.642 +.RE
43.643 +
43.644 +.LP
43.645 +.LP
43.646 +吾鴻祉若絎\f2rmid\fP 莎桁 \f2\-port\fP 激с潟絎違障罨<箴腓冴障
43.647 +.LP
43.648 +.nf
43.649 +\f3
43.650 +.fl
43.651 + rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
43.652 +.fl
43.653 +\fP
43.654 +.fi
43.655 +
43.656 +.LP
43.657 +.LP
43.658 +潟潟莎桁激鴻若≪潟紮吾鴻若 1099 с吾鴻紮障
43.659 +.LP
43.660 +.SS
43.661 +rmid inetd/xinetd 紮
43.662 +.LP
43.663 +.LP
43.664 +\f2rmid\fP 潟潟茵紮\f2inetd\fP (Solaris 翫)障 \f2xinetd\fP (Linux) 罕 \f2rmid\fP 綽荀綽紮号障
43.665 +.LP
43.666 +.LP
43.667 +\f2rmid\fP 紮\f2System.inheritedChannel\fP <純若喝冴膓帥c潟 (\f2inetd\fP/\f2xinetd\fP 膓) 緇障膓帥c潟 \f2null\fP с\f2java.nio.channels.ServerSocketChannel\fP ゃ潟鴻帥潟鴻сc翫\f2rmid\fP c潟 \f2inetd\fP/\f2xinetd\fP c莎桁сゆ菴違莎桁障
43.668 +.LP
43.669 +.LP
43.670 +膓帥c潟 \f2ServerSocketChannel\fP ゃ潟鴻帥潟鴻с翫鴻若≪若吾сゃ障 \f2java.rmi.activation.ActivationSystem\fP ゃ潟吾鴻 \f2java.rmi.activation.Activator\fP ≪若吾с絲障荀羆篆<泣若若純宴\f2ServerSocketChannel\fP 緇 \f2java.net.ServerSocket\fP \f2rmid\fP с篏睡障≪若с\f2rmid\fP 篏罨<ゃ 潟潟茵莎桁翫с
43.671 +.LP
43.672 +.RS 3
43.673 +.TP 2
43.674 +o
43.675 +\f2System.err\fP 絲障阪<ゃゃ<ゃ \f2java.io.tmpdir\fP 激鴻c若ф絎c (絽吾 \f2/var/tmp\fP 障 \f2/tmp\fP) <ゃ・莨 \f2rmid\-err\fP с・絨乗 \f2"tmp"\fP с
43.676 +.TP 2
43.677 +o
43.678 +\f2\-port\fP 激с潟激с潟絎\f2rmid\fP 若<祉若吾冴腟篋
43.679 +.TP 2
43.680 +o
43.681 +\f2\-log\fP 激с潟綽激с潟絎\f2rmid\fP 若<祉若吾冴腟篋
43.682 +.RE
43.683 +
43.684 +.LP
43.685 +.LP
43.686 +綽荀綽泣若鴻紮荐絎荅括完ゃ\f2inetd\fP (Solaris) 障 \f2xinetd\fP (Linux) ャ≪若吾с
43.687 +.LP
43.688 +.SH "激с"
43.689 +.LP
43.690 +
43.691 +.LP
43.692 +.RS 3
43.693 +.TP 3
43.694 +\-C<someCommandLineOption>
43.695 +\f2rmid\fP 絖祉 (莎桁違若) 篏絖祉鴻潟潟茵綣違羝<激с潟絎障違罨<絎莎桁激鴻若 潟c篁潟激潟c若羝<с障
43.696 +.nf
43.697 +\f3
43.698 +.fl
43.699 + rmid \-C\-Dsome.property=value
43.700 +.fl
43.701 +\fP
43.702 +.fi
43.703 +潟潟茵綣違絖祉鴻羝<罘純違茵翫箴水с違罨<潟潟絎茵с障
43.704 +.nf
43.705 +\f3
43.706 +.fl
43.707 + rmid \-C\-Djava.rmi.server.logCalls=true
43.708 +.fl
43.709 +\fP
43.710 +.fi
43.711 +潟潟鴻絖 VM с泣若弱若喝冴違篏障
43.712 +.LP
43.713 +.TP 3
43.714 +\-J<someCommandLineOption>
43.715 +\f2rmid\fP 絎茵 \f2java\fP ゃ潟帥帥羝<激с潟絎障違\f2rmid\fP \f2rmid.policy\fP 激若<ゃ篏睡絎\f2rmid\fP 潟潟茵 \f2\-J\fP 激с潟篏帥c\f2java.security.policy\fP c若絎臂障 罨<箴腓冴障
43.716 +.nf
43.717 +\f3
43.718 +.fl
43.719 + rmid \-J\-Djava.security.policy=rmid.policy
43.720 +.fl
43.721 +\fP
43.722 +.fi
43.723 +.TP 3
43.724 +\-J\-Dsun.rmi.activation.execPolicy=<policy>
43.725 +莎桁違若絎茵 VM 莎桁篏睡潟潟潟潟潟茵激с潟с\f2rmid\fP 。激若絎障激с潟Java RMI 莎桁若≪潟 Sun 絎茖絖羈潟潟茵c若絎翫腟 \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP 絎翫障\f2<policy>\fP 絎純ゃ\f2default\fP\f2<policyClassName>\fP障 \f2none\fP с ゃゃ茯障
43.726 +.LP
43.727 +.RS 3
43.728 +.TP 2
43.729 +o
43.730 +\f3default (障c若絎翫)\fP
43.731 +.LP
43.732 + \f2execPolicy\fP 翫\f2rmid\fP 絎茵с\f2rmid\fP 篏睡 祉ャc若激若<ゃ筝с絎茵罔 \f2rmid\fP 筝潟潟潟潟潟茵激с潟с絎茵激若т戎с莎桁違若絎茖с
43.733 +.LP
43.734 +\f2rmid\fP 莎桁違若 VM 莎桁違若ゃ脂蚊莎桁違若荐菴医с \f2ActivationGroupDesc\fP 宴篏睡障違若荐菴医\f2ActivationGroupDesc.CommandEnvironment\fP 絎障 (ュ) 莎桁違若紮潟潟潟潟茵菴遵с潟潟茵激с潟障障с\f2rmid\fP \f2java.home\fP \f2java\fP 潟潟篏睡障違若荐菴医激с潟潟潟茵菴遵c若若若ゃ障障 c若罨<絎臂障
43.735 +.nf
43.736 +\f3
43.737 +.fl
43.738 + \-D\fP\f4<property>\fP\f3=\fP\f4<value>\fP\f3
43.739 +.fl
43.740 +\fP
43.741 +.fi
43.742 +.LP
43.743 +≪祉号┤ \f2com.sun.rmi.rmid.ExecPermission\fP 篏睡違若荐菴医 \f2CommandEnvironment\fP ф絎潟潟絎茵莎桁違若紮罔\f2rmid\fP 絲障荐怨с障≪祉号┤ \f2com.sun.rmi.rmid.ExecOptionPermission\fP 篏睡違若荐菴医сc若若若ゃ絎潟潟茵激с潟障 \f2CommandEnvironment\fP с激с潟絎潟潟茵激с潟莎桁違若紮 \f2rmid\fP 篏睡с障
43.744 +.LP
43.745 +\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障
43.746 +.RS 3
43.747 +.TP 3
43.748 +ExecPermission
43.749 +\f2ExecPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟絎茵罔茵障
43.750 +.LP
43.751 +\f3罕\fP
43.752 +.br
43.753 +\f2ExecPermission\fP \f2rmid\fP 絎茵荐怨潟潟劫с/* (/<ゃ阪絖 \f2File.separatorChar\fP) х劫c障鴻<ゃ腓冴障/\-х劫c障鴻<ゃ泣c (絽亥) 腓冴障劫劫ャ若潟<<ALL FILES>>絎翫\f3篁紙\fP<ゃ腓冴障
43.754 +.LP
43.755 +\f3羈:\fP* 1 ゆ絎劫憜c鴻<ゃ茵障 障\- 1 ゆ絎劫憜c鴻<ゃ憜c障鴻<ゃ泣c (絽亥) 茵障
43.756 +.TP 3
43.757 +ExecOptionPermission
43.758 +\f2ExecOptionPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟茵激с潟篏睡с罔茵障\f2ExecOptionPermission\fP 潟潟茵激с潟ゃс
43.759 +.LP
43.760 +\f3罕\fP
43.761 +.br
43.762 +激с潟сゃ若絎泣若障≪鴻帥鴻ゃ若茵障 ≪鴻帥鴻激с喝篏睡с障 ゃ障篁紙激с潟茵с障 障激с喝絨障篏睡с障 .=翫≪鴻帥鴻絎綽荀障
43.763 +.LP
43.764 +箴腓冴障*\-Dfoo.*\-Da.b.c=*鴻с*foo\-Da*bab*≦鴻с
43.765 +.TP 3
43.766 +rmid 激若<ゃ
43.767 +\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障≪祉号┤с \f2rmid\fP с≪祉号┤羆荐怨絎с
43.768 +.LP
43.769 +\f2rmid\fP 腮絎茵罔荐怨激若<ゃ箴罨<腓冴障
43.770 +.nf
43.771 +\f3
43.772 +.fl
43.773 +grant {
43.774 +.fl
43.775 + permission com.sun.rmi.rmid.ExecPermission
43.776 +.fl
43.777 + "/files/apps/java/jdk1.2.2/solaris/bin/java";
43.778 +.fl
43.779 +
43.780 +.fl
43.781 + permission com.sun.rmi.rmid.ExecPermission
43.782 +.fl
43.783 + "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
43.784 +.fl
43.785 +
43.786 +.fl
43.787 + permission com.sun.rmi.rmid.ExecPermission
43.788 +.fl
43.789 + "/files/apps/rmidcmds/*";
43.790 +.fl
43.791 +
43.792 +.fl
43.793 + permission com.sun.rmi.rmid.ExecOptionPermission
43.794 +.fl
43.795 + "\-Djava.security.policy=/files/policies/group.policy";
43.796 +.fl
43.797 +
43.798 +.fl
43.799 + permission com.sun.rmi.rmid.ExecOptionPermission
43.800 +.fl
43.801 + "\-Djava.security.debug=*";
43.802 +.fl
43.803 +
43.804 +.fl
43.805 + permission com.sun.rmi.rmid.ExecOptionPermission
43.806 +.fl
43.807 + "\-Dsun.rmi.*";
43.808 +.fl
43.809 +};
43.810 +.fl
43.811 +\fP
43.812 +.fi
43.813 + 2 ゃ篁筝≪祉号┤\f2rmid\fP 絲障劫腓榊絎 \f2java\fP 潟潟 \f2java_g\fP 潟潟 1.2.2 若吾с潟絎茵荐怨障с\f2java.home\fP 若吾с潟 \f2java\fP 潟潟 (\f2rmid\fP 篏睡若吾с) 篏睡潟潟激若<ゃф絎綽荀障3 ≪祉号┤\f2rmid\fP 絲障c \f2/files/apps/rmidcmds\fP 篁紙潟潟絎茵罔荐怨障
43.814 +.LP
43.815 +4 ≪祉号┤ \f2ExecOptionPermission\fP \f2rmid\fP 絲障祉ャc若激若<ゃ \f2/files/policies/group.policy\fP 絎臂莎桁違若紮荐怨障5 ≪祉号┤莎桁違若 \f2java.security.debug\fP c若篏睡荐怨障緇≪祉号┤莎桁違若 \f2sun.rmi\fP c弱絮ゅ篁紙c若篏睡荐怨障
43.816 +.LP
43.817 +激若<ゃ絎 \f2rmid\fP 莎桁\f2rmid\fP 潟潟茵 \f2java.security.policy\fP c若絎綽荀障 罨<箴腓冴障
43.818 +.RS 3
43.819 +
43.820 +.LP
43.821 +.LP
43.822 +\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
43.823 +.LP
43.824 +.RE
43.825 +.RE
43.826 +.TP 2
43.827 +o
43.828 +.LP
43.829 +.TP 2
43.830 +o
43.831 +\f4<policyClassName>\fP
43.832 +.LP
43.833 +篏с荵с緇翫膊∞\f2rmid\fP 莎桁\f2checkExecCommand\fP <純絮鴻絎rmid 絎茵潟潟сс障
43.834 +.LP
43.835 +\f2policyClassName\fP 綣違潟潟鴻帥<罨< \f2checkExecCommand\fP <純絎茖 public 鴻絎障
43.836 +.nf
43.837 +\f3
43.838 +.fl
43.839 + public void checkExecCommand(ActivationGroupDesc desc,
43.840 +.fl
43.841 + String[] command)
43.842 +.fl
43.843 + throws SecurityException;
43.844 +.fl
43.845 +\fP
43.846 +.fi
43.847 +莎桁違若紮\f2rmid\fP 激若 \f2checkExecCommand\fP <純若喝冴障莎桁違若荐菴医莎桁違若紮絎潟潟<純羝<障\f2checkExecCommand\fP \f2SecurityException\fP 鴻若\f2rmid\fP 莎桁違若紮吾с莎桁荅茵若喝冴眼 \f2ActivationException\fP 鴻若障
43.848 +.LP
43.849 +.TP 2
43.850 +o
43.851 +\f3none\fP
43.852 +.LP
43.853 +\f2sun.rmi.activation.execPolicy\fP c若ゃnone翫\f2rmid\fP 莎桁違若紮潟潟障c閌荐若障
43.854 +.RE
43.855 +.LP
43.856 +.TP 3
43.857 +\-log dir
43.858 +莎桁激鴻若≪潟若帥若鴻渇∫f宴吾莨若篏帥c絎障с\f2rmid\fP 潟潟絎茵c\f2log\fP 違c篏障
43.859 +.LP
43.860 +.TP 3
43.861 +\-port port
43.862 +\f2rmid\fP 吾鴻篏帥若絎障莎桁激鴻若≪潟吾鴻筝с\f2java.rmi.activation.ActivationSystem\fP \f2ActivationSystem\fP ゃ潟障c若激割 \f2ActivationSystem\fP 罨< \f2Naming.lookup\fP <純若喝冴c緇с障
43.863 +.nf
43.864 +\f3
43.865 +.fl
43.866 + import java.rmi.*;
43.867 +.fl
43.868 + import java.rmi.activation.*;
43.869 +.fl
43.870 +
43.871 +.fl
43.872 + ActivationSystem system; system = (ActivationSystem)
43.873 +.fl
43.874 + Naming.lookup("//:\fP\f4port\fP/java.rmi.activation.ActivationSystem");
43.875 +.fl
43.876 +.fi
43.877 +.TP 3
43.878 +\-stop
43.879 +\f2\-port\fP 激с潟c絎若憜 \f2rmid\fP 若喝冴罩≪障若絎翫若 1098 у茵 \f2rmid\fP 罩≪障
43.880 +.RE
43.881 +.SH "医紊"
43.882 +.LP
43.883 +
43.884 +.LP
43.885 +.RS 3
43.886 +.TP 3
43.887 +CLASSPATH
43.888 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障箴腓冴障
43.889 +.nf
43.890 +\f3
43.891 +.fl
43.892 + .:/usr/local/java/classes
43.893 +.fl
43.894 +\fP
43.895 +.fi
43.896 +.RE
43.897 +
43.898 +.LP
43.899 +.SH "∫i"
43.900 +.LP
43.901 +
43.902 +.LP
43.903 +.LP
43.904 +rmic(1)
43.905 +.na
43.906 +\f2CLASSPATH\fP @
43.907 +.fi
43.908 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathjava(1)
43.909 .LP
43.910
43.911 .LP
44.1 --- a/src/linux/doc/man/ja/rmiregistry.1 Tue May 12 15:21:55 2009 +0900
44.2 +++ b/src/linux/doc/man/ja/rmiregistry.1 Thu May 14 00:17:25 2009 -0700
44.3 @@ -1,108 +1,99 @@
44.4 -'\" t
44.5 -.\"
44.6 -.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
44.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
44.8 -.\"
44.9 -.\" This code is free software; you can redistribute it and/or modify it
44.10 -.\" under the terms of the GNU General Public License version 2 only, as
44.11 -.\" published by the Free Software Foundation.
44.12 -.\"
44.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
44.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
44.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
44.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
44.17 -.\" accompanied this code).
44.18 -.\"
44.19 -.\" You should have received a copy of the GNU General Public License version
44.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
44.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
44.22 -.\"
44.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
44.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
44.25 -.\" have any questions.
44.26 -.\"
44.27 -.\"
44.28 -.TH rmiregistry 1 "2004 年 6 月 22 日"
44.29 -.SH "名前"
44.30 -rmiregistry \- Java リモートオブジェクトレジストリ
44.31 -.\"
44.32 -.\" This document was created by saving an HTML file as text
44.33 -.\" from the JavaSoft web site:
44.34 -.\"
44.35 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
44.36 -.\"
44.37 -.\" and adding appropriate troff macros. Because the JavaSoft web site
44.38 -.\" man pages can change without notice, it may be helpful to diff
44.39 -.\" files to identify changes other than new functionality.
44.40 -.\"
44.41 -.SH "形式"
44.42 -.B rmiregistry
44.43 -[
44.44 -.I port
44.45 -]
44.46 -.SH "機能説明"
44.47 -.IX "Java remote object registry" "" "Java remote object registry \(em \fLrmiregistry\fP"
44.48 -.IX "rmiregistry" "" "\fLrmiregistry\fP \(em Java remote object registry"
44.49 -.B rmiregistry
44.50 -コマンドは、現在のホスト上の指定されたポートに、リモートオブジェクト
44.51 -レジストリを作成し起動します。
44.52 -ポート番号が省略された場合には、ポート
44.53 -1099
44.54 -が使用されます。
44.55 -.B rmiregistry
44.56 -はバックグラウンドで実行され、何も出力しません。
44.57 -以下に指定例を示します。
44.58 +." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
44.59 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
44.60 +."
44.61 +." This code is free software; you can redistribute it and/or modify it
44.62 +." under the terms of the GNU General Public License version 2 only, as
44.63 +." published by the Free Software Foundation.
44.64 +."
44.65 +." This code is distributed in the hope that it will be useful, but WITHOUT
44.66 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
44.67 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
44.68 +." version 2 for more details (a copy is included in the LICENSE file that
44.69 +." accompanied this code).
44.70 +."
44.71 +." You should have received a copy of the GNU General Public License version
44.72 +." 2 along with this work; if not, write to the Free Software Foundation,
44.73 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
44.74 +."
44.75 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
44.76 +." CA 95054 USA or visit www.sun.com if you need additional information or
44.77 +." have any questions.
44.78 +."
44.79 +.TH rmiregistry 1 "04 May 2009"
44.80 +." Generated from HTML by html2man (author: Eric Armstrong)
44.81 +
44.82 .LP
44.83 -.RS
44.84 -.B example% rmiregistry &
44.85 +.SH ""
44.86 +rmiregistry \- Java ≪若吾с吾鴻
44.87 +.LP
44.88 +.RS 3
44.89 +
44.90 +.LP
44.91 +.LP
44.92 +\f3rmiregistry\fP 潟潟憜鴻絎若筝≪若吾с吾鴻紮障
44.93 +.LP
44.94 .RE
44.95 +.SH "綵√"
44.96 .LP
44.97 -リモートオブジェクトレジストリはブートストラップネームサービスで、
44.98 -ホスト上の
44.99 -RMI
44.100 -サーバがリモートオブジェクトに名前をバインドするために使用します。
44.101 -名前がついたあとは、クライアント側でリモートオブジェクトを探して
44.102 -リモートメソッドを呼び出すことができます。
44.103 +
44.104 .LP
44.105 -レジストリは通常、アプリケーションがメソッドを呼び出す必要がある
44.106 -最初のリモートオブジェクトを指定するために使用されます。
44.107 -そのあと、そのオブジェクトを使って、アプリケーション固有の
44.108 -方法で他のオブジェクトを探すことが可能になります。
44.109 +.nf
44.110 +\f3
44.111 +.fl
44.112 +rmiregistry [\fP\f4port\fP\f3]
44.113 +.fl
44.114 +\fP
44.115 +.fi
44.116 +
44.117 .LP
44.118 -.B java.rmi.registry.LocateRegistry
44.119 -クラスのメソッドは、特定のホストまたは特定のホストとポート上で
44.120 -動作しているレジストリを得るために用いられます。
44.121 +.SH "茯"
44.122 .LP
44.123 -.B java.rmi.Naming
44.124 -クラスの
44.125 -URL
44.126 -用のメソッドはレジストリを操作するもので、
44.127 -リモートオブジェクトの探索、リモートオブジェクトへの
44.128 -名前
44.129 -(文字列)
44.130 -のバインド、新たな名前のバインド
44.131 -(以前のバインドを上書き)、
44.132 -バインドの取り消し、およびレジストリ中でバインドされている
44.133 -URL
44.134 -の一覧表示が可能です。
44.135 -.SH "オプション"
44.136 -以下のオプションが使用できます。
44.137 -.TP 15
44.138 -.BI \-J option
44.139 -java オプションと組み合わせて使います
44.140 -(
44.141 -.B \-J
44.142 -と java オプションの間にスペースは必要ありません)。
44.143 -.B \-J
44.144 -の後ろに続くオプションを java インタプリタに渡します。
44.145 -.SH "関連項目"
44.146 -次については、
44.147 -.BR java.sun.com
44.148 -を参照または検索してください。
44.149 -.TP 5
44.150 -.B java.rmi.Naming @
44.151 -http://java.sun.com/j2se/1.5/docs/api/java/rmi/Naming.html
44.152 -.TP 5
44.153 -.B java.rmi.registry.LocateRegistry @
44.154 -http://java.sun.com/j2se/1.5/docs/api/java/rmi/registry/LocateRegistry.html
44.155
44.156 +.LP
44.157 +.LP
44.158 +\f3rmiregistry\fP 潟潟憜鴻絎 \f2port\fP 筝≪若吾с吾鴻篏紮障\f2port\fP 絎ャ翫吾鴻若 1099 ч紮障\f3rmiregistry\fP 潟潟阪罘純障絽吾違潟у茵障箴腓冴障
44.159 +.LP
44.160 +.LP
44.161 +\f2rmiregistry&\fP
44.162 +.LP
44.163 +.LP
44.164 +≪若吾с吾鴻若鴻若泣若鴻с 筝鴻 RMI 泣若若≪若吾сゃ潟篏睡障罨<若潟≪若鴻ゃ≪潟≪若吾с罎膣≪≪若<純若喝冴茵障
44.165 +.LP
44.166 +.LP
44.167 +吾鴻筝≪若吾с篏臀絎障 с≪宴若激с潟<純若喝冴綽荀障篁cc吾с≪宴若激с恰絎泣若箴篁吾с「障
44.168 +.LP
44.169 +.LP
44.170 +\f2java.rmi.registry.LocateRegistry\fP 鴻<純若鴻障若鴻若у篏吾鴻緇篏睡障
44.171 +.LP
44.172 +.LP
44.173 +\f2java.rmi.Naming\fP 鴻 URL 若鴻<純吾鴻у篏篁紙鴻潟若鴻筝≪若吾с罎膣≪篏睡障≪若吾с膣 (絖) ゃ潟違ゃ潟 (ゃゃ潟若若ゃ) 障 障≪若吾с≪潟ゃ潟吾鴻ゃ潟 URL 阪障
44.174 +.LP
44.175 +.SH "激с"
44.176 +.LP
44.177 +
44.178 +.LP
44.179 +.RS 3
44.180 +.TP 3
44.181 +\-J
44.182 +\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝<障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
44.183 +.RE
44.184 +
44.185 +.LP
44.186 +.SH "∫i"
44.187 +.LP
44.188 +
44.189 +.LP
44.190 +.LP
44.191 +java(1)
44.192 +.na
44.193 +\f2java.rmi.registry.LocateRegistry\fP @
44.194 +.fi
44.195 +http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html
44.196 +.na
44.197 +\f2java.rmi.Naming\fP @
44.198 +.fi
44.199 +http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
44.200 +.LP
44.201 +
44.202 +.LP
44.203 +
45.1 --- a/src/linux/doc/man/ja/schemagen.1 Tue May 12 15:21:55 2009 +0900
45.2 +++ b/src/linux/doc/man/ja/schemagen.1 Thu May 14 00:17:25 2009 -0700
45.3 @@ -1,6 +1,4 @@
45.4 -.'" t
45.5 -."
45.6 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
45.7 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
45.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
45.9 ."
45.10 ." This code is free software; you can redistribute it and/or modify it
45.11 @@ -20,62 +18,44 @@
45.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
45.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
45.14 ." have any questions.
45.15 -."
45.16 -." `
45.17 -.TH schemagen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
45.18 -." Generated by html2roff
45.19 +."
45.20 +.TH schemagen 1 "04 May 2009"
45.21 +." Generated from HTML by html2man (author: Eric Armstrong)
45.22
45.23 .LP
45.24 -.ad c
45.25 -.SH 名前
45.26 -XML バインドのための Java(TM) アーキテクチャ
45.27 +.SH ""
45.28 +schemagen \- XML ゃ潟 Java(TM) ≪若c若鴻若吾с若
45.29 +.LP
45.30 +.LP
45.31 +\f3篁罕若吾с:\fP 2.1
45.32 .br
45.33 -スキーマジェネレータ\f3仕様のバージョン:\fP 2.0
45.34 -.br
45.35 -\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
45.36 -.br
45.37 -.ad l
45.38 +\f3絎茖若吾с:\fP 2.1.3
45.39 .LP
45.40 .SS
45.41 -schemagen の起動
45.42 +schemagen 莎桁
45.43 .LP
45.44 .LP
45.45 -スキーマジェネレータは、ユーザーのプラットフォームの \f2bin\fP ディレクトリにある \f2schemagen\fP シェルスクリプトを使って起動できます。
45.46 +鴻若吾с若帥若吟若若 \f2bin\fP c \f2schemagen\fP 激с鴻篏帥c莎桁с障
45.47 .LP
45.48 .LP
45.49 -現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
45.50 +憜鴻若吾с若帥Java 純若鴻<ゃ鴻<ゃс障
45.51 .LP
45.52 .LP
45.53 -また、スキーマジェネレータを実行するための Ant タスクも用意されています。schemagen を Ant とともに使用するための手順を参照してください。
45.54 +障鴻若吾с若帥絎茵 Ant 帥鴻障
45.55 +.na
45.56 +\f2schemagen Ant 篏睡\fP @
45.57 +.fi
45.58 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlс
45.59 .LP
45.60 .RS 3
45.61
45.62 .LP
45.63 -\f3Solaris/Linux の場合\fP
45.64 -.LP
45.65 .nf
45.66 \f3
45.67 .fl
45.68 - % path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
45.69 +% schemagen.sh Foo.java Bar.java ...
45.70 .fl
45.71 - Note: Writing schema1.xsd
45.72 -.fl
45.73 -
45.74 -.fl
45.75 -\fP
45.76 -.fi
45.77 -
45.78 -.LP
45.79 -\f3WindowsNT/2000/XP の場合\fP
45.80 -.LP
45.81 -.nf
45.82 -\f3
45.83 -.fl
45.84 - > path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
45.85 -.fl
45.86 - Note: Writing schema1.xsd
45.87 -.fl
45.88 -
45.89 +羈: Writing schema1.xsd
45.90 .fl
45.91 \fP
45.92 .fi
45.93 @@ -83,43 +63,70 @@
45.94
45.95 .LP
45.96 .LP
45.97 -ユーザの Java ソース/クラスがほかのクラスを参照している場合、システムの CLASSPATH 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP オプションを使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
45.98 +若吟若 Java 純若/鴻祉鴻с翫激鴻 CLASSPATH 医紊亥宴с鴻≪祉鴻сc \f2\-classpath\fP/\f2\-cp\fP 激с潟篏帥c鴻若絎綽荀障鴻若若榊障
45.99 .LP
45.100 .RS 3
45.101
45.102 .LP
45.103 -\f3コマンド行オプション\fP
45.104 +\f3潟潟茵激с\fP
45.105 .LP
45.106 +.RS 3
45.107
45.108 .LP
45.109 .nf
45.110 \f3
45.111 .fl
45.112 -使用法: schemagen [\-options ...] <java files>
45.113 +篏睡号: schemagen [\-options ...] <java files>
45.114 .fl
45.115
45.116 .fl
45.117 -オプション:
45.118 +激с:
45.119 .fl
45.120 - \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します
45.121 + \-d <path> : 祉泣 javac 鴻<ゃ臀贋絎障
45.122 .fl
45.123 - \-cp <path> : ユーザ指定ファイルの検索場所を指定します
45.124 + \-cp <path> : 若吟惹絎<ゃ罎膣√贋絎障
45.125 .fl
45.126 - \-classpath <path> : ユーザ指定ファイルの検索場所を指定します
45.127 + \-classpath <path> : 若吟惹絎<ゃ罎膣√贋絎障
45.128 .fl
45.129 - \-help : この使用方法に関するメッセージを表示します
45.130 -.fl
45.131 -
45.132 + \-help : 篏睡号≪<祉若吾茵腓冴障
45.133 .fl
45.134 \fP
45.135 .fi
45.136 +.RE
45.137
45.138 .LP
45.139 .RE
45.140 .SS
45.141 -生成されるリソースファイル
45.142 +純若鴻<ゃ
45.143 .LP
45.144 .LP
45.145 -現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、スキーマジェネレータの ant タスクを使用してください。
45.146 +憜鴻若吾с若帥膣Java 劫ус腥咲 1 ゃ鴻若<ゃ篏障鴻若<ゃ九勝号憝鴻с絖障
45.147 +.na
45.148 +\f2鴻若吾с若帥 Ant 帥鴻\fP @
45.149 +.fi
45.150 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html篏睡
45.151 +.LP
45.152 +.SH "∫i"
45.153 +.LP
45.154 +.RS 3
45.155 +.TP 2
45.156 +o
45.157 +鴻若吾с若帥絎茵 (schemagen):[
45.158 +.na
45.159 +\f2潟潟茵巡擦\fP @
45.160 +.fi
45.161 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html
45.162 +.na
45.163 +\f2SchemaGen Ant 篏睡\fP @
45.164 +.fi
45.165 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
45.166 +.TP 2
45.167 +o
45.168 +.na
45.169 +\f2XML ゃ潟 JavaTM ≪若c (JAXB)\fP @
45.170 +.fi
45.171 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
45.172 +.RE
45.173 +
45.174 .LP
45.175
46.1 --- a/src/linux/doc/man/ja/serialver.1 Tue May 12 15:21:55 2009 +0900
46.2 +++ b/src/linux/doc/man/ja/serialver.1 Thu May 14 00:17:25 2009 -0700
46.3 @@ -1,100 +1,98 @@
46.4 -'\" t
46.5 -.\"
46.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
46.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
46.8 -.\"
46.9 -.\" This code is free software; you can redistribute it and/or modify it
46.10 -.\" under the terms of the GNU General Public License version 2 only, as
46.11 -.\" published by the Free Software Foundation.
46.12 -.\"
46.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
46.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
46.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
46.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
46.17 -.\" accompanied this code).
46.18 -.\"
46.19 -.\" You should have received a copy of the GNU General Public License version
46.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
46.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
46.22 -.\"
46.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
46.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
46.25 -.\" have any questions.
46.26 -.\"
46.27 -.\"
46.28 -.TH serialver 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
46.29 -.SH "名前"
46.30 -serialver \- シリアルバージョンコマンド
46.31 -.\"
46.32 -.\" This document was created by saving an HTML file as text
46.33 -.\" from the JavaSoft web site:
46.34 -.\"
46.35 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
46.36 -.\"
46.37 -.\" and adding appropriate troff macros. Because the JavaSoft web site
46.38 -.\" man pages can change without notice, it may be helpful to diff
46.39 -.\" files to identify changes other than new functionality.
46.40 -.\"
46.41 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
46.42 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
46.43 +."
46.44 +." This code is free software; you can redistribute it and/or modify it
46.45 +." under the terms of the GNU General Public License version 2 only, as
46.46 +." published by the Free Software Foundation.
46.47 +."
46.48 +." This code is distributed in the hope that it will be useful, but WITHOUT
46.49 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
46.50 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
46.51 +." version 2 for more details (a copy is included in the LICENSE file that
46.52 +." accompanied this code).
46.53 +."
46.54 +." You should have received a copy of the GNU General Public License version
46.55 +." 2 along with this work; if not, write to the Free Software Foundation,
46.56 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
46.57 +."
46.58 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
46.59 +." CA 95054 USA or visit www.sun.com if you need additional information or
46.60 +." have any questions.
46.61 +."
46.62 +.TH serialver 1 "04 May 2009"
46.63 +." Generated from HTML by html2man (author: Eric Armstrong)
46.64 +
46.65 +.LP
46.66 +.SH ""
46.67 +serialver \- 激≪若吾с潟潟潟
46.68 +.LP
46.69 +.RS 3
46.70 +
46.71 +.LP
46.72 +.LP
46.73 +\f3serialver\fP 潟潟 \f2serialVersionUID\fP 菴障
46.74 +.LP
46.75 +.RE
46.76 +.SH "綵√"
46.77 .LP
46.78
46.79 .LP
46.80 +.nf
46.81 +\f3
46.82 +.fl
46.83 +\fP\f3serialver\fP [ options ] [ classnames ]
46.84 +.fl
46.85 +.fi
46.86 +
46.87 .LP
46.88 -\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
46.89 +.RS 3
46.90 +
46.91 .LP
46.92 -.SH "形式"
46.93 -.B serialver
46.94 -[
46.95 -.B options
46.96 -] [
46.97 -.I classnames
46.98 -]
46.99 -.TP
46.100 -.BI options
46.101 -このドキュメントで指定されているコマンド行オプション。
46.102 -.TP
46.103 -.BI classnames
46.104 -1 つまたは複数のクラス名。
46.105 -.SH "機能説明"
46.106 -.IX "serial version command" "" "serial version command \(em \fLserialver\fP"
46.107 -.IX "serialver" "" "\fLserialver\fP \(em serial version command"
46.108 -.B serialver
46.109 -は、指定された 1 個
46.110 -または複数個のクラスの
46.111 -.B シリアルバージョン UID
46.112 -を、展開しているクラスへコピーするのに適した形式で返します。
46.113 -引数なしで呼び出した場合、
46.114 -.B serialver
46.115 -は使用方法を説明する行を表示します。
46.116 -.SH "オプション"
46.117 -.TP 15
46.118 -.B \-classpath " <directories and zip/jar files separated by:>"
46.119 -アプリケーションのクラスおよびリソースの検索パスを設定します。
46.120 -.TP 15
46.121 -.B \-show
46.122 -単なるユーザインタフェースを表示します。
46.123 -ここで完全クラス名を入力し、
46.124 -Enter
46.125 -キーまたは
46.126 -Show
46.127 -ボタンを押すと、シリアルバージョン
46.128 -UID
46.129 -が表示されます。
46.130 -.TP 15
46.131 -.BI \-J "option"
46.132 -.I option
46.133 -を Java 仮想マシンに渡します。ここで、
46.134 -.I option
46.135 -は、Java アプリケーション起動プログラムの参照ページで
46.136 -説明されているオプションの 1 つです。たとえば、
46.137 -.I \-J-Xms48m
46.138 -は、起動時に使用するメモリを 48M バイトに設定します。
46.139 +.RS 3
46.140 +.TP 3
46.141 +options
46.142 +ャ<潟ц潟潟茵激с潟с
46.143 +.TP 3
46.144 +classnames
46.145 +1 や札筝劫с
46.146 +.RE
46.147 +
46.148 .LP
46.149 -.SH "注意"
46.150 +.RE
46.151 +.SH "茯"
46.152 .LP
46.153
46.154 .LP
46.155 .LP
46.156 -\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティマネージャの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティマネージャを設定できます。
46.157 +\f3serialver\fP 1 や札筝鴻 \f2serialVersionUID\fP 絮鴻吾潟若綵√ц障綣違絎у若喝冴篏睡号茵腓冴障
46.158 +.LP
46.159 +.SH "激с"
46.160 +.LP
46.161 +
46.162 +.LP
46.163 +.RS 3
46.164 +.TP 3
46.165 +\-classpath <: у阪c zip jar <ゃ>
46.166 +≪宴若激с潟鴻潟純若鴻罎膣≪鴻荐絎障
46.167 +.RE
46.168 +
46.169 +.LP
46.170 +.RS 3
46.171 +.TP 3
46.172 +\-show
46.173 +膂≦若吟若ゃ潟帥с若鴻茵腓冴障絎絎劫ュEnter 若 [Show] 帥潟若激≪若吾с UID 茵腓冴障
46.174 +.TP 3
46.175 +\-Joption
46.176 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
46.177 +.RE
46.178 +
46.179 +.LP
46.180 +.SH "羈"
46.181 +.LP
46.182 +
46.183 +.LP
46.184 +.LP
46.185 +\f3serialver\fP 潟潟絎鴻篁潟激喝茯粋昭у障с祉ャc若若吾c若荐絎茵障篆♂若с鴻 \f3serialver\fP 絎茵翫罨<激с潟篏帥c祉ャc若若吾c若荐絎с障
46.186 .LP
46.187 .RS 3
46.188
46.189 @@ -104,7 +102,7 @@
46.190 .LP
46.191 .RE
46.192 .LP
46.193 -また、必要であれば、次のオプションを使ってセキュリティポリシーを指定できます。
46.194 +障綽荀с違罨<激с潟篏帥c祉ャc若激若絎с障
46.195 .LP
46.196 .RS 3
46.197
46.198 @@ -112,16 +110,16 @@
46.199 .LP
46.200 \f2\-J\-Djava.security.policy=<policy file>\fP
46.201 .LP
46.202 -.SH "関連項目"
46.203 +.RE
46.204 +.SH "∫i"
46.205 .LP
46.206
46.207 .LP
46.208 .LP
46.209 +.na
46.210 +\f2java.io.ObjectStreamClass\fP @
46.211 .fi
46.212 -http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
46.213 -の
46.214 -.na
46.215 -「\f2java.io.ObjectStreamClass\fP」
46.216 +http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
46.217 .LP
46.218
46.219 .LP
47.1 --- a/src/linux/doc/man/ja/servertool.1 Tue May 12 15:21:55 2009 +0900
47.2 +++ b/src/linux/doc/man/ja/servertool.1 Thu May 14 00:17:25 2009 -0700
47.3 @@ -1,226 +1,130 @@
47.4 -'\" t
47.5 -.\"
47.6 -.\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
47.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
47.8 -.\"
47.9 -.\" This code is free software; you can redistribute it and/or modify it
47.10 -.\" under the terms of the GNU General Public License version 2 only, as
47.11 -.\" published by the Free Software Foundation.
47.12 -.\"
47.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
47.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
47.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
47.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
47.17 -.\" accompanied this code).
47.18 -.\"
47.19 -.\" You should have received a copy of the GNU General Public License version
47.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
47.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
47.22 -.\"
47.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
47.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
47.25 -.\" have any questions.
47.26 -.\"
47.27 -.\"
47.28 -.TH servertool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
47.29 -.SH "名前"
47.30 -servertool - Java(TM) IDL サーバツール
47.31 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
47.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
47.33 +."
47.34 +." This code is free software; you can redistribute it and/or modify it
47.35 +." under the terms of the GNU General Public License version 2 only, as
47.36 +." published by the Free Software Foundation.
47.37 +."
47.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
47.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
47.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
47.41 +." version 2 for more details (a copy is included in the LICENSE file that
47.42 +." accompanied this code).
47.43 +."
47.44 +." You should have received a copy of the GNU General Public License version
47.45 +." 2 along with this work; if not, write to the Free Software Foundation,
47.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
47.47 +."
47.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
47.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
47.50 +." have any questions.
47.51 +."
47.52 +.TH servertool 1 "04 May 2009"
47.53 +." Generated from HTML by html2man (author: Eric Armstrong)
47.54 +
47.55 .LP
47.56 -.B servertool
47.57 -は、アプリケーション開発者が持続サーバの登録、登録解除、起動、停止を行うためのコマンド行インタフェースを提供します。
47.58 -.SH "形式"
47.59 -.B servertool
47.60 -\-ORBInitialPort nameserverport options [ commands ]
47.61 +.SH ""
47.62 +servertool \- Java(TM) IDL 泣若若若
47.63 .LP
47.64 -.B servertool
47.65 -の起動時にコマンドを
47.66 -入力しなかった場合は、
47.67 -コマンド行ツールが
47.68 -.B servertool >
47.69 -プロンプトを表示します。
47.70 -.B servertool >
47.71 -プロンプトで
47.72 -コマンドを入力します。
47.73 +.RS 3
47.74 +
47.75 .LP
47.76 -.B servertool
47.77 -の起動時にコマンドを入力した場合は、
47.78 -Java IDL サーバツールが起動し、
47.79 -コマンドを実行して終了します。
47.80 -.LP
47.81 -\-ORBInitialPort nameserverport オプションは、必須です。
47.82 -nameserverport の値は、orbd を実行し、
47.83 -着信要求を待機しているポートを指定します。
47.84 -Solaris ソフトウェアを使用する場合は、
47.85 -スーパーユーザになって 1024 未満のポートでプロセスを開始する
47.86 -必要があります。このため、1024 以上のポート番号の
47.87 -使用を推奨します。
47.88 -.SH 機能説明
47.89 -.BR servertool
47.90 -はアプリケーション
47.91 -プログラマが、持続サーバの登録、登録解除、起動、停止を
47.92 -行うためのコマンド行インタフェースです。
47.93 -サーバに関するさまざまな統計情報を取得するために
47.94 -その他のコマンドが用意されています。
47.95 -.SH オプション
47.96 -.TP
47.97 -.BI \-ORBInitialHost " nameserverhost"
47.98 -ネームサーバを実行し、着信要求を待機している
47.99 -ホストマシンを指定します。このオプションを
47.100 -指定しない場合、nameserverhost はデフォルトの
47.101 -localhost になります。
47.102 -.B orbd
47.103 -と
47.104 -.B servertool
47.105 -が異なるマシンで実行されている場合は、orbd が
47.106 -実行されているホストの名前または IP アドレスを
47.107 -指定する必要があります。
47.108 -.TP
47.109 -.BI \-J option
47.110 -オプションを Java 仮想マシンに渡します。
47.111 -ここで option は、Java アプリケーション
47.112 -起動プログラム
47.113 -.fi
47.114 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html)
47.115 -のリファレンスページで説明されている
47.116 -オプションの 1 つです。
47.117 -たとえば、\-J-Xms48m は、
47.118 -起動メモリを 48M バイトに設定します。
47.119 -\-J が基本にする仮想マシンにオプションを
47.120 -渡すことは、共通の規約です。
47.121 -.SH コマンド
47.122 -.TP
47.123 -.B register \-server <server class name>
47.124 -.B \-classpath <classpath to server>
47.125 -[
47.126 -.B \-applicationName <application\ name>
47.127 -.B \-args <args to server>
47.128 -.B \-vmargs <flags to be passed
47.129 -.B to Java VM>
47.130 -]
47.131 -.RS
47.132 -.LP
47.133 -新しい持続サーバを Object Request Broker Daemon (ORBD) に登録します。
47.134 -まだ登録されていない場合は、サーバが登録され、有効化されます。
47.135 -このコマンドを使用すると、
47.136 -\-server オプションによって
47.137 -識別されるサーバのメインクラスでインストールメソッドが
47.138 -呼び出されます。インストールメソッドは、
47.139 -public static void install (org.omg.CORBA.ORB) で
47.140 -なければなりません。このインストールメソッドを
47.141 -オプションで使用すると、開発者は独自の
47.142 -サーバインストール動作 (データベーススキーマの作成など)
47.143 -を指定できます。
47.144 +\f3servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障
47.145 .RE
47.146 -.TP
47.147 -.B unregister \-serverid <server id >
47.148 -.B | \-applicationName <application\ name>
47.149 -.RS
47.150 -.LP
47.151 -サーバ ID またはアプリケーション名を使用して、
47.152 -ORBD からサーバを登録解除します。
47.153 -このコマンドを使用すると、\-server オプションによって
47.154 -識別されたサーバのメインクラスでアンインストール
47.155 -メソッドが呼び出されます。アンインストールメソッドは、
47.156 -public static void uninstall(org.omg.CORBA.ORB)
47.157 -でなければなりません。このアンインストールメソッドを
47.158 -オプションで使用すると、
47.159 -開発者は独自のサーバアンインストール動作
47.160 -(インストールメソッドの動作の取り消しなど)
47.161 -を指定できます。
47.162 -.RE
47.163 -.TP
47.164 -.B getserverid \-applicationName <application name>
47.165 -アプリケーションに対応するサーバ ID を返します。
47.166 -.TP
47.167 -.B list
47.168 -.br
47.169 -ORBD に登録されているすべての持続サーバに関する情報を
47.170 -一覧表示します。
47.171 -.TP
47.172 -.B listappnames
47.173 -ORBD に現在登録されているすべてのサーバのアプリケーション名を
47.174 -一覧表示します。
47.175 -.TP
47.176 -.B listactive
47.177 -ORBD によって起動され、稼動しているすべての
47.178 -持続サーバに関する情報を
47.179 -すべて一覧表示します。
47.180 -.TP 3
47.181 -locate \-serverid\ <server\ id\ >\ |
47.182 -\-applicationName\ <application\ name>
47.183 -[\-endpointType\ <endpointType>\ ]
47.184 -.RS
47.185 -.LP
47.186 -登録されているサーバによって作成されたすべての ORB の特定のタイプ
47.187 -のエンドポイント (ポート) を特定します。サーバがまだ稼動していな
47.188 -い場合は、起動されます。エンドポイントタイプが指定されないと、サ
47.189 -ーバ内の各 ORB に関連したプレーン/非保護の
47.190 -エンドポイントが返されます。
47.191 -.RE
47.192 -.TP 3
47.193 -locateperorb
47.194 -\-serverid\ <server\ id\ >\ |
47.195 -\-applicationName\ <application\ name>
47.196 -[\-orbid\ <ORB\ name>\ ]
47.197 -登録されているサーバの特定の ORB によって登録されたすべてのエンド
47.198 -ポイント (ポート) を特定します。サーバがまだ動作していない場合は、
47.199 -起動されます。
47.200 -.BR orbid
47.201 -が指定されないと、デフォルト値である "" が
47.202 -.BR orbid
47.203 -に割り当てられます。空の文字列の
47.204 -.BR orbid
47.205 -を使用して ORB が作成されると、それによって登録されているす
47.206 -べてのポートが返されます。
47.207 -.RE
47.208 -.TP
47.209 -.B orblist \-serverid <server id> |
47.210 -.B \-applicationName <application name> ]
47.211 -.RS
47.212 -.LP
47.213 -サーバで定義されている ORB の ORBId を一覧表示します。
47.214 -ORBId は、サーバによって作成された ORB の
47.215 -文字列名です。サーバがまだ稼動していない場合は、
47.216 -サーバを起動します。
47.217 -.RE
47.218 -.TP
47.219 -.B shutdown \-serverid <server id> |
47.220 -.B \-applicationName <application name> ]
47.221 -.RS
47.222 -.LP
47.223 -ORBD に登録されているアクティブなサーバを停止します。
47.224 -このコマンドの
47.225 -実行中に、
47.226 -サーバプロセスを適切に停止するために、
47.227 -\-serverid または \-applicationName パラメータで
47.228 -指定されたクラスで定義されている
47.229 -.BR shutdown()
47.230 -メソッドも呼び出されます。
47.231 -.RE
47.232 -.TP
47.233 -.B startup \-serverid <server id> |
47.234 -.B \-applicationName <application name>
47.235 -.RS
47.236 -.LP
47.237 -ORBD に登録されているサーバを起動します。
47.238 -サーバが稼動していな
47.239 -い場合、このコマンドはサーバを起動します。サーバが既に稼動して
47.240 -いる場合は、エラーメッセージがユーザに返されます。
47.241 -.RE
47.242 -.TP
47.243 -.B help
47.244 -.br
47.245 -このサーバツールを使用してサーバに対して実行できるすべての
47.246 -コマンドを一覧表示します。
47.247 -.TP
47.248 -.B quit
47.249 -.br
47.250 -このサーバツールを終了します。
47.251 -.RE
47.252 -.SS "関連項目"
47.253 +.SH "綵√"
47.254 .LP
47.255
47.256 .LP
47.257 -orbd
47.258 +.nf
47.259 +\f3
47.260 +.fl
47.261 +servertool \-ORBInitialPort \fP\f4nameserverport\fP\f3 \fP\f3options\fP\f3 [ \fP\f3commands\fP\f3 ]
47.262 +.fl
47.263 +\fP
47.264 +.fi
47.265 +
47.266 +.LP
47.267 +.LP
47.268 +潟潟ュ \f2servertool\fP 莎桁潟潟茵若 \f2servertool >\fP 潟茵腓冴障\f2servertool >\fP 潟潟潟ュ障
47.269 +.LP
47.270 +.LP
47.271 +潟潟ュ \f2servertool\fP 莎桁Java IDL 泣若若若莎桁潟潟絎茵腟篋障
47.272 +.LP
47.273 +.LP
47.274 +\f2\-ORBInitialPort\fP \f2nameserverport\fP 激с潟\f3綽\fPс\f2nameserverport\fP ゃ\f2orbd\fP 絎茵篆∴羆緇罘若絎綽荀障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 \f2nameserverport\fP 1024 障 1024 紊с若篏睡с障
47.275 +.LP
47.276 +.SH "茯"
47.277 +.LP
47.278 +
47.279 +.LP
47.280 +.LP
47.281 +\f2servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障祉泣若若≪障障腟沿宴緇潟潟箴障
47.282 +.LP
47.283 +.SH "激с"
47.284 +.LP
47.285 +
47.286 +.LP
47.287 +.RS 3
47.288 +.TP 3
47.289 +\-ORBInitialHost nameserverhost
47.290 +若泣若若絎茵篆∴羆緇罘鴻激潟絎障激с潟絎翫\f2nameserverhost\fP \f2localhost\fP 荐絎障\f2orbd\fP \f2servertool\fP 違激割у茵翫\f2orbd\fP 絎茵鴻 IP ≪鴻絎綽荀障
47.291 +.TP 3
47.292 +\-Joption
47.293 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
47.294 +.RE
47.295 +
47.296 +.LP
47.297 +.SH "潟潟"
47.298 +.LP
47.299 +
47.300 +.LP
47.301 +.RS 3
47.302 +.TP 3
47.303 +register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
47.304 +Object Request Broker Daemon (ORBD) 域膓泣若若脂蚊障泣若若脂蚊翫脂蚊莎桁障潟潟c\f2\-server\fP 激с潟цャ泣若若<ゃ潟劫сゃ潟鴻若<純若喝冴障ゃ潟鴻若<純\f2public static void install(org.omg.CORBA.ORB)\fP c綽荀障ゃ潟鴻若<純激с潟с若帥若鴻鴻若篏泣若若ゃ潟鴻若篏肴絎с障
47.305 +.TP 3
47.306 +unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
47.307 +泣若 ID 障≪宴若激с喝篏睡ORBD 泣若若脂蚊茹iゃ障潟潟c\f2\-server\fP 激с潟цャ泣若若<ゃ潟劫с≪潟ゃ潟鴻若<純若喝冴障≪潟ゃ潟鴻若<純\f2public static void uninstall(org.omg.CORBA.ORB)\fP c綽荀障≪潟ゃ潟鴻若<純激с潟сゃ潟鴻若<純篏羔泣若若≪潟ゃ潟鴻若篏肴絎с障
47.308 +.TP 3
47.309 +getserverid \-applicationName\ <application\ name>
47.310 +≪宴若激с潟∫d泣若 ID 菴障
47.311 +.TP 3
47.312 +list
47.313 +ORBD 脂蚊鴻膓泣若若≪宴筝荀ц;腓冴障
47.314 +.TP 3
47.315 +listappnames
47.316 +憜 ORBD 脂蚊鴻泣若若≪宴若激с喝筝荀ц;腓冴障
47.317 +.TP 3
47.318 +listactive
47.319 +ORDB c莎桁憜絎茵鴻膓泣若若≪宴筝荀ц;腓冴障
47.320 +.TP 3
47.321 +locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
47.322 +脂蚊泣若若т鴻 ORB 劫ゃ腴 (若) 罎冴障泣若若絎茵翫莎桁障腴鴻絎翫泣若若 ORB ∫d plain 障 non\-protected 腴鴻菴障
47.323 +.TP 3
47.324 +locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
47.325 +脂蚊泣若若劫 ORB х脂蚊腴 (若) 罎冴障泣若若絎茵翫莎桁障\f2orbid\fP 絎翫ゃ""\f2orbid\fP蚊綵障ORB 腥堺絖 \f2orbid\fP т翫脂蚊若鴻菴障
47.326 +.TP 3
47.327 +orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
47.328 +泣若寂絎臂 ORB ORBId 筝荀ц;腓冴障ORBId 泣若若т ORB 絖с泣若若絎茵翫莎桁障
47.329 +.TP 3
47.330 +shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
47.331 +ORBD 脂蚊≪c泣若若罩≪障潟潟絎茵筝\f2\-serverid\fP <若帥障 \f2\-applicationName\fP <若帥ф絎劫絎臂 \f2shutdown()\fP <純若喝冴泣若若祉鴻罩c罩≪障
47.332 +.TP 3
47.333 +startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
47.334 +ORBD 脂蚊泣若若莎桁障泣若若絎茵翫潟潟с泣若若莎桁障泣若若с絎茵翫若吟若若<祉若吾菴障
47.335 +.TP 3
47.336 +help
47.337 +泣若若泣若若若т戎с鴻潟潟茵腓冴障
47.338 +.TP 3
47.339 +quit
47.340 +泣若若若腟篋障
47.341 +.RE
47.342 +
47.343 +.LP
47.344 +.SH "∫i"
47.345 +.LP
47.346 +
47.347 +.LP
47.348 +orbd(1)
47.349 .LP
47.350
48.1 --- a/src/linux/doc/man/ja/tnameserv.1 Tue May 12 15:21:55 2009 +0900
48.2 +++ b/src/linux/doc/man/ja/tnameserv.1 Thu May 14 00:17:25 2009 -0700
48.3 @@ -1,121 +1,80 @@
48.4 -'\" t
48.5 -.\"
48.6 -.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
48.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
48.8 -.\"
48.9 -.\" This code is free software; you can redistribute it and/or modify it
48.10 -.\" under the terms of the GNU General Public License version 2 only, as
48.11 -.\" published by the Free Software Foundation.
48.12 -.\"
48.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
48.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
48.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
48.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
48.17 -.\" accompanied this code).
48.18 -.\"
48.19 -.\" You should have received a copy of the GNU General Public License version
48.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
48.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
48.22 -.\"
48.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
48.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
48.25 -.\" have any questions.
48.26 -.\"
48.27 -.\"
48.28 -.TH tnameserv 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
48.29 -.SH "名前"
48.30 -Java IDL: 一時ネームサービス \- \f2tnameserv\fP
48.31 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
48.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
48.33 +."
48.34 +." This code is free software; you can redistribute it and/or modify it
48.35 +." under the terms of the GNU General Public License version 2 only, as
48.36 +." published by the Free Software Foundation.
48.37 +."
48.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
48.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
48.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
48.41 +." version 2 for more details (a copy is included in the LICENSE file that
48.42 +." accompanied this code).
48.43 +."
48.44 +." You should have received a copy of the GNU General Public License version
48.45 +." 2 along with this work; if not, write to the Free Software Foundation,
48.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
48.47 +."
48.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
48.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
48.50 +." have any questions.
48.51 +."
48.52 +.TH tnameserv 1 "04 May 2009"
48.53 +." Generated from HTML by html2man (author: Eric Armstrong)
48.54 +
48.55 +.LP
48.56 +.SH ""
48.57 +Java IDL:筝若泣若 \- \f2tnameserv\fP
48.58 .LP
48.59
48.60 .LP
48.61 .LP
48.62 -このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には ORBD (Object Request Broker Daemon) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD が使用されていますが、一時ネームサービスを使用する例の \f2orbd\fP はどれも、\f2tnameserv\fP で置き換えることができます。\f2orbd\fP ツールのドキュメントについては、そのマニュアルページか、
48.63 +ャ<潟сJava IDL 筝若泣若 \f2tnameserv\fP 篏睡号ゃ茯障Java IDL Object Request Broker Daemon (ORBD) 障障ORBD 若鴻泣若鴻筝若泣若鴻\f3膓\fP若泣若鴻潟泣若若若吾c若若≪潟祉鴻сJava IDL 鴻ャ若≪с ORBD 篏睡障筝若泣若鴻篏睡箴с\f2orbd\fP 篁c \f2tnameserv\fP 篏睡с障\f2orbd\fP 若荅括完ゃ\f2orbd\fP orbd(1)障
48.64 .na
48.65 -\f2Java IDL Naming Service Included with ORBD\fP
48.66 +\f2ORBD 障 Java IDL 若泣若\fP @
48.67 .fi
48.68 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) のトピックを参照してください。
48.69 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html≪с
48.70 .LP
48.71 .LP
48.72 -ここでは、次の項目について説明します。
48.73 +с篁ヤゃ茯障
48.74 .LP
48.75 .RS 3
48.76 .TP 2
48.77 o
48.78 -Java\ IDL 一時ネームサービス
48.79 +Java\ IDL 筝若泣若
48.80 .TP 2
48.81 o
48.82 -Java\ IDL 一時ネームサービスの起動
48.83 +Java\ IDL 筝若泣若鴻莎桁
48.84 .TP 2
48.85 o
48.86 -Java\ IDL 一時ネームサービスの停止
48.87 +Java\ IDL 筝若泣若鴻罩
48.88 .TP 2
48.89 o
48.90 -サンプルクライアント: 名前空間へのオブジェクトの追加
48.91 +泣潟ゃ≪潟:腥咲吾吾с菴遵
48.92 .TP 2
48.93 o
48.94 -サンプルクライアント: 名前空間のブラウズ
48.95 +泣潟ゃ≪潟:腥咲
48.96 .RE
48.97
48.98 .LP
48.99 -.SH "Java\ IDL 一時ネームサービス"
48.100 -.IX "Java IDL name server starter script" "" "Java IDL name server starter script \(em \fLtnameserv\fP"
48.101 -.IX "tnameserv" "" "\fLtnameserv\fP \(em Java IDL name server starter script"
48.102 -.SM CORBA
48.103 -の
48.104 -.SM COS
48.105 -(Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ
48.106 -構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供し
48.107 -ます。
48.108 -Java
48.109 -.SM IDL
48.110 -の一時ネームサービス、\f2tnameserv\fP は、
48.111 -.SM COS
48.112 -ネームサービスの仕様を単純な形で実装したものです。
48.113 +.SH "Java\ IDL 筝若泣若"
48.114 .LP
48.115 -オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前の組は、
48.116 -それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミ
48.117 -ングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体
48.118 -がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機
48.119 -能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納さ
48.120 -れます。名前空間において、初期ネーミングコンテキストは唯一の持続的バイン
48.121 -ディングです。それ以外のネーミングコンテキストは、Java
48.122 -.SM IDL
48.123 -のネームサーバープロセスが停止し、再起動されると失われます。
48.124 .LP
48.125 -アプレットまたはアプリケーションから
48.126 -.SM COS
48.127 -ネームサービスを使用するためには、その
48.128 -.SM ORB
48.129 -はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの
48.130 -文字列化された初期ネーミングコンテキストにアクセスできなければなりません。
48.131 -ネームサービスは、Java
48.132 -.SM IDL
48.133 -のネームサービスでもその他の
48.134 -.SM COS
48.135 -準拠のネームサービスでもかまいません。
48.136 +CORBA COS (Common Object Services) 若泣若鴻<ゃ激鴻<ゃ絲障c罕箴吾сс絲障惹c箴障Java IDL 筝若泣若鴻с \f2tnameserv\fP COS 若泣若鴻篁罕膣綵≪у茖с
48.137 .LP
48.138 -.SH "Java\ IDL 一時ネームサービスの起動"
48.139 .LP
48.140 +吾сс腥咲ф主吾сс≪若ゃ潟c潟違若違障若ゃ潟c潟違若潟違潟潟鴻腟粋昭с障若潟違潟潟鴻篏若ゃ潟c潟違с<ゃ激鴻泣c膩罘純<障鴻ゃ潟c潟違若潟違潟潟鴻主障腥咲若潟違潟潟鴻筝膓ゃ潟c潟違с 篁ュ若潟違潟潟鴻Java IDL 若潟違泣若鴻祉鴻罩≪莎桁紊宴障
48.141 .LP
48.142 -.IX "tnameserv" "Starting the Java IDL Name Server" "\fLtnameserv\fP \(em Java IDL name server starter script"
48.143 -Java
48.144 -.SM IDL
48.145 -ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に
48.146 -起動しておかなければなりません。
48.147 -Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するためのスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。
48.148 -バックグラウンドで
48.149 -動作するように、ネームサービスを起動してください。
48.150 .LP
48.151 -特に指定しない場合、Java
48.152 -.SM IDL
48.153 -ネームサービスは、
48.154 -.SM ORB
48.155 -の
48.156 -.I resolve_initial_references(\|)
48.157 -メソッドと
48.158 -.I list_initial_references(\|)
48.159 -メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
48.160 -次のようにします。
48.161 +≪障≪宴若激с潟 COS 若泣若鴻篏睡 ORB 若泣若鴻篏鴻若ャc若泣若鴻絖若潟違潟潟鴻≪祉鴻с違障若泣若鴻Java\ IDL 若泣若鴻с篁 COS 羣若泣若鴻с障障
48.162 +.LP
48.163 +.SH "Java\ IDL 筝若泣若鴻莎桁"
48.164 +.LP
48.165 +.LP
48.166 +Java\ IDL 若泣若鴻若泣若鴻篏睡≪宴若激с潟障≪莎桁違障Java\ IDL 茖遵ゃ潟鴻若Java IDL 若泣若鴻莎桁鴻 (Solaris: \f2tnameserv\fP) 絎茵純<ゃ (Windows NT: \f2tnameserv.exe\fP) 篏障違潟у篏若泣若鴻莎桁
48.167 +.LP
48.168 +.LP
48.169 +鴻絎翫Java IDL 若泣若鴻ORB \f2resolve_initial_references()\fP <純 \f2list_initial_references()\fP <純絎茖篏睡若鴻潟絲障若 900 у罘障
48.170 .LP
48.171 .nf
48.172 \f3
48.173 @@ -127,7 +86,7 @@
48.174
48.175 .LP
48.176 .LP
48.177 -ネームサーバーのポートを指定しなかった場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアを実行する場合、1024 よりも小さいポートでプロセスを起動するには root になる必要があります。このため、1024 かそれよりも大きいポート番号を使用することをお勧めします。1050 などの異なるポートを指定し、かつネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルから次のように入力します。
48.178 +若泣若若若絎翫с若 900 篏睡障Solaris 純с≪絎茵1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 1050 ャ若絎若泣若鴻違潟у茵UNIX 潟潟激сф<ュ障
48.179 .LP
48.180 .nf
48.181 \f3
48.182 @@ -139,7 +98,7 @@
48.183
48.184 .LP
48.185 .LP
48.186 -Windows の場合は、MS\-DOS システムプロンプトから次のように入力します。
48.187 +Windows MS\-DOS 激鴻潟с罨<ュ障
48.188 .LP
48.189 .nf
48.190 \f3
48.191 @@ -151,32 +110,32 @@
48.192
48.193 .LP
48.194 .LP
48.195 -ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティに新しいポート番号を設定します。
48.196 +若泣若若ゃ≪潟違若垩ャ綽荀障ORB 吾с篏 \f2org.omg.CORBA.ORBInitialPort\fP c若違若垩荐絎障
48.197 .LP
48.198 .SS
48.199 -異なるホスト上でのサーバーとクライアントの実行
48.200 +違激割сゃ≪潟泣若若絎茵
48.201 .LP
48.202 .LP
48.203 -Java IDL および RMI\-IIOP に関するチュートリアルの大部分では、ネームサービス、サーバー、クライアントのすべてが開発マシン上で実行されています。実際の配備では通常、ネームサービスとは異なるホストマシン上でクライアントとサーバーが実行されます。
48.204 +Java IDL RMI\-IIOP 祉ャ若≪с若泣若鴻泣若若潟ゃ≪潟鴻榊激割у茵障絎翫ゃ≪潟泣若若若泣若鴻違鴻筝у茵紊障
48.205 .LP
48.206 .LP
48.207 -クライアントとサーバーでネームサービスを検索するには、ネームサービスが実行されているポート番号とホストをそれらが知っている必要があります。そこで、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP と \f2org.omg.CORBA.ORBInitialHost\fP プロパティを、ネームサービスが実行されているマシン名とポート番号に設定します。この例については、
48.208 +ゃ≪潟泣若若若泣若鴻荀ゃゃ≪潟泣若若若泣若鴻絎茵若垩鴻茯茘綽荀障ゃ≪潟泣若若<ゃ \f2org.omg.CORBA.ORBInitialPort\fP c若 \f2org.omg.CORBA.ORBInitialHost\fP c若若泣若鴻絎茵若垩激潟荐絎障箴
48.209 .na
48.210 -「\f2The Hello World Example Using RMI\-IIOP\fP」
48.211 +\f2RMI\-IIOP 篏帥c Hello World 箴\fP @
48.212 .fi
48.213 -(http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html) を参照してください。また、コマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使ってネームサービスの検索場所をクライアントとサーバーに知らせることも可能です。
48.214 +http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html腓冴障潟潟茵激с \f2\-ORBInitialPort\fP \f2nameserverport#\fP \f2\-ORBInitialHost\fP \f2nameserverhostname\fP 篏睡ゃ≪潟泣若若絲障若泣若鴻「贋絎с障
48.215 .na
48.216 -「\f2Java IDL: Running the Hello World Example on TWO Machines\fP」
48.217 +\f2Java IDL: 2 伹激割у茵 Hello World 違\fP @
48.218 .fi
48.219 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html) では、このコマンド行オプションを使う方法の 1 つが示されています。
48.220 +http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html 潟潟茵激с潟篏睡絎号腓冴障
48.221 .LP
48.222 .LP
48.223 -たとえば、一時ネームサービス \f2tnameserv\fP がホスト \f2nameserverhost\fP のポート 1050 上で、クライアントがホスト \f2clienthost\fP 上で、サーバーがホスト \f2serverhost\fP 上で、それぞれ実行されているとします。
48.224 +違筝若泣若 \f2tnameserv\fP 鴻 \f2nameserverhost\fP 若 1050 筝у茵障ゃ≪潟鴻 \f2clienthost\fP 筝у茵泣若若鴻 \f2serverhost\fP 筝у茵障
48.225 .LP
48.226 .RS 3
48.227 .TP 2
48.228 o
48.229 -ホスト \f2nameserverhost\fP 上の \f2tnameserv\fP を次のようにして起動します。
48.230 +罨<鴻 \f2nameserverhost\fP 筝 \f2tnameserv\fP 莎桁障
48.231 .nf
48.232 \f3
48.233 .fl
48.234 @@ -188,7 +147,7 @@
48.235 .fi
48.236 .TP 2
48.237 o
48.238 -\f2serverhost\fP 上のサーバーを次のようにして起動します。
48.239 +\f2serverhost\fP 筝с泣若若莎桁障
48.240 .nf
48.241 \f3
48.242 .fl
48.243 @@ -198,7 +157,7 @@
48.244 .fi
48.245 .TP 2
48.246 o
48.247 -\f2clienthost\fP 上のクライアントを次のようにして起動します。
48.248 +\f2clienthost\fP 筝сゃ≪潟莎桁障
48.249 .nf
48.250 \f3
48.251 .fl
48.252 @@ -210,48 +169,48 @@
48.253
48.254 .LP
48.255 .SS
48.256 -\-J オプション
48.257 +\-J 激с
48.258 .LP
48.259 -\f2tnameserv\fP で使用可能なコマンド行オプションは、次のとおりです。
48.260 +潟潟茵激с潟\f2tnameserve\fP 篏睡с障
48.261 .RS 3
48.262
48.263 .LP
48.264 +.RS 3
48.265 .TP 3
48.266 \-Joption
48.267 -\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、
48.268 -.na
48.269 -\f2Java アプリケーション起動ツール\fP
48.270 -.fi
48.271 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP とすると、起動時のメモリが 48M バイトに設定されます。\f3\-J\fP を使って実行元の仮想マシンにオプションを渡すことは、よく行われています。
48.272 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
48.273 +.RE
48.274 +
48.275 .LP
48.276 -.SH "Java IDL 一時ネームサービスの停止"
48.277 +.RE
48.278 +.SH "Java\ IDL 筝若泣若鴻罩"
48.279 .LP
48.280 .LP
48.281 -Java\ IDL ネームサービスを停止するには、対応するオペレーティングシステムコマンドを使用します。たとえば、Unix プロセスの場合は \f2kill\fP を、Windows プロセスの場合は \f2Ctrl\-C\fP を、それぞれ使用します。ネームサービスは明示的にシャットダウンされるまで、呼び出しを待ち続けます。なお、ネームサービスを終了させると、Java\ IDL ネームサービスに登録されている名前は失われます。
48.282 +Java IDL 若泣若鴻罩≪Unix 翫\f2kill\fP 若c潟違激鴻潟潟篏帥Windows 翫\f2Ctrl\-C\fP 篏帥障若泣若鴻腓榊罩≪障с若喝冴緇罘倶膓障泣若鴻腟篋Java\ IDL 若泣若鴻脂蚊紊宴障
48.283 .LP
48.284 -.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
48.285 +.SH "泣潟ゃ≪潟:腥咲吾吾с菴遵"
48.286 .LP
48.287 .LP
48.288 -以下に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
48.289 +罨<腓冴泣潟違腥咲菴遵号腓冴с泣潟違障障倶у篏筝若泣若鴻ゃ≪潟с罨<膣若篏с
48.290 .LP
48.291 .nf
48.292 \f3
48.293 .fl
48.294 \fP\f3
48.295 .fl
48.296 - \fP\f4初期\fP\f3
48.297 + \fP\f4\fP\f3
48.298 .fl
48.299 - \fP\f4ネーミングコンテキスト\fP\f3
48.300 + \fP\f4若潟違潟潟鴻\fP\f3
48.301 .fl
48.302 - / \\
48.303 + / \\
48.304 .fl
48.305 - / \\
48.306 + / \\
48.307 .fl
48.308 plans \fP\f4Personal\fP\f3
48.309 .fl
48.310 - / \\
48.311 + / \\
48.312 .fl
48.313 - / \\
48.314 + / \\
48.315 .fl
48.316 calendar schedule\fP
48.317 .fl
48.318 @@ -259,7 +218,7 @@
48.319
48.320 .LP
48.321 .LP
48.322 -この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照が含まれるネーミングコンテキストです。
48.323 +箴с\f3plans\fP 吾сс\f3Personal\fP \f3calendar\fP \f3schedule\fP 2 ゃ吾сс若潟違潟潟鴻с
48.324 .LP
48.325 .nf
48.326 \f3
48.327 @@ -286,7 +245,7 @@
48.328 .fi
48.329
48.330 .LP
48.331 -前述の「Java IDL 一時ネームサービスの起動」では、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
48.332 +菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨<潟若с若垩ゃ≪潟違ャ障
48.333 .nf
48.334 \f3
48.335 .fl
48.336 @@ -302,7 +261,7 @@
48.337 .fi
48.338
48.339 .LP
48.340 -このコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この \f3objref\fP には、あとでさまざまな名前を割り当てて名前空間に追加します。
48.341 +罨<潟若с若潟違潟潟鴻緇 \f3ctx\fP 篁eャ障2 茵с\f3ctx\fP 若吾с \f3objref\fP 潟若障 \f3objref\fP с障障蚊綵腥咲菴遵障
48.342 .nf
48.343 \f3
48.344 .fl
48.345 @@ -318,7 +277,7 @@
48.346 .fi
48.347
48.348 .LP
48.349 -このコードでは、text 型の名前「plans」を作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fP を使用して初期ネーミングコンテキストの下に「plans」を追加しています。\f2rebind\fP メソッドを使用すれば、\f2bind\fP を使用した場合に発生する例外を発生させずに、このプログラムを何度も繰り返し実行できます。
48.350 +罨<潟若сtext plans 篏若吾ссゃ潟障緇\f2rebind\fP 篏睡若潟違潟潟鴻筝 "plans" 菴遵障\f2rebind\fP <純篏睡違\f2bind\fP 篏睡翫榊箴紊榊違篏綺膵違菴絎茵с障
48.351 .nf
48.352 \f3
48.353 .fl
48.354 @@ -336,7 +295,7 @@
48.355 .fi
48.356
48.357 .LP
48.358 -このコードでは、directory 型の「Personal」というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
48.359 +罨<潟若сdirectory Personal 若潟違潟潟鴻篏障腟緇吾с \f3ctx2\fP ゃ潟若潟違潟潟鴻菴遵障
48.360 .nf
48.361 \f3
48.362 .fl
48.363 @@ -354,7 +313,7 @@
48.364 .fi
48.365
48.366 .LP
48.367 -残りのコードでは、ダミーのオブジェクト参照を「schedule」と「calendar」という名前でネーミングコンテキスト「Personal」(\f3ctx2\fP) にバインドします。
48.368 +罧潟若с若吾сс schedule calendar с若潟違潟潟鴻 "Personal" (\f3ctx2\fP) ゃ潟障
48.369 .nf
48.370 \f3
48.371 .fl
48.372 @@ -394,10 +353,10 @@
48.373 .fi
48.374
48.375 .LP
48.376 -.SH "サンプルクライアント: 名前空間のブラウズ"
48.377 +.SH "泣潟ゃ≪潟:腥咲"
48.378 .LP
48.379 .LP
48.380 -次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
48.381 +罨<泣潟違с腥咲冴号腓冴障
48.382 .LP
48.383 .nf
48.384 \f3
48.385 @@ -424,7 +383,7 @@
48.386 .fi
48.387
48.388 .LP
48.389 -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
48.390 +菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨<潟若с若垩ゃ≪潟違ャ障
48.391 .nf
48.392 \f3
48.393 .fl
48.394 @@ -444,7 +403,7 @@
48.395 .fi
48.396
48.397 .LP
48.398 -次のコードでは、初期ネーミングコンテキストを取得しています。
48.399 +罨<潟若с若潟違潟潟鴻緇障
48.400 .nf
48.401 \f3
48.402 .fl
48.403 @@ -458,7 +417,7 @@
48.404 .fi
48.405
48.406 .LP
48.407 -\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
48.408 +\f2list\fP <純若潟違潟潟鴻菴遵ゃ潟c潟違鴻障翫紊 1000 障сゃ潟c潟違若潟違潟潟鴻 BindingListHolder 菴障 罧ゃ潟c潟違BindingIteratorHolder 菴障
48.409 .nf
48.410 \f3
48.411 .fl
48.412 @@ -474,7 +433,7 @@
48.413 .fi
48.414
48.415 .LP
48.416 -このコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
48.417 +罨<潟若с菴 BindingListHolder ゃ潟c潟違緇障ゃ潟c潟違翫違腟篋障
48.418 .nf
48.419 \f3
48.420 .fl
48.421 @@ -488,7 +447,7 @@
48.422 .fi
48.423
48.424 .LP
48.425 -残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
48.426 +罧潟若сゃ潟c潟違絲障若茵阪障
48.427 .nf
48.428 \f3
48.429 .fl
48.430 @@ -542,4 +501,4 @@
48.431 .LP
48.432
48.433 .LP
48.434 -
48.435 +
49.1 --- a/src/linux/doc/man/ja/unpack200.1 Tue May 12 15:21:55 2009 +0900
49.2 +++ b/src/linux/doc/man/ja/unpack200.1 Thu May 14 00:17:25 2009 -0700
49.3 @@ -1,31 +1,54 @@
49.4 -'\" t
49.5 -.\"
49.6 -.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
49.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
49.8 -.\"
49.9 -.\" This code is free software; you can redistribute it and/or modify it
49.10 -.\" under the terms of the GNU General Public License version 2 only, as
49.11 -.\" published by the Free Software Foundation.
49.12 -.\"
49.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
49.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
49.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
49.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
49.17 -.\" accompanied this code).
49.18 -.\"
49.19 -.\" You should have received a copy of the GNU General Public License version
49.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
49.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
49.22 -.\"
49.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
49.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
49.25 -.\" have any questions.
49.26 -.\"
49.27 -.\"
49.28 -.TH unpack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
49.29 -.SH 名前
49.30 -unpack200 \- JAR アンパックツール
49.31 -.SH 形式
49.32 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
49.33 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
49.34 +."
49.35 +." This code is free software; you can redistribute it and/or modify it
49.36 +." under the terms of the GNU General Public License version 2 only, as
49.37 +." published by the Free Software Foundation.
49.38 +."
49.39 +." This code is distributed in the hope that it will be useful, but WITHOUT
49.40 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
49.41 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
49.42 +." version 2 for more details (a copy is included in the LICENSE file that
49.43 +." accompanied this code).
49.44 +."
49.45 +." You should have received a copy of the GNU General Public License version
49.46 +." 2 along with this work; if not, write to the Free Software Foundation,
49.47 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
49.48 +."
49.49 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
49.50 +." CA 95054 USA or visit www.sun.com if you need additional information or
49.51 +." have any questions.
49.52 +."
49.53 +.TH unpack200 1 "04 May 2009"
49.54 +." Generated from HTML by html2man (author: Eric Armstrong)
49.55 +
49.56 +.LP
49.57 +.SH ""
49.58 +unpack200 \- JAR ≪潟若
49.59 +.LP
49.60 +.RS 3
49.61 +.TP 2
49.62 +o
49.63 +綵√
49.64 +.TP 2
49.65 +o
49.66 +茯
49.67 +.TP 2
49.68 +o
49.69 +激с
49.70 +.TP 2
49.71 +o
49.72 +腟篋鴻若帥
49.73 +.TP 2
49.74 +o
49.75 +∫i
49.76 +.TP 2
49.77 +o
49.78 +茯
49.79 +.RE
49.80 +
49.81 +.LP
49.82 +.SH "綵√"
49.83 .LP
49.84
49.85 .LP
49.86 @@ -33,39 +56,62 @@
49.87 \f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
49.88 .LP
49.89 .LP
49.90 -オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
49.91 -.TP
49.92 -.I input\-file
49.93 -入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
49.94 -.TP
49.95 -.I JAR\-file
49.96 -出力 JAR ファイル名。
49.97 -.SH 機能説明
49.98 -unpack200 ツールは pack200(1) で作成されたパックファイルを JAR ファイルに変換するネイティブ実装です。
49.99 -.TP
49.100 -一般的な使用方法:
49.101 +激с潟絎綺羆冴障障潟潟茵絎緇激с潟篁ュ絎鴻激с潟障
49.102 .LP
49.103 -.RS
49.104 -.ft 3
49.105 -.nf
49.106 -% unpack200 myarchive.pack.gz myarchive.jar
49.107 -.fi
49.108 -.ft 1
49.109 +.RS 3
49.110 +
49.111 +.LP
49.112 +.RS 3
49.113 +.TP 3
49.114 +input\-file
49.115 +ュ<ゃ ュ<ゃ絽吾pack200 gzip <ゃ pack200 <ゃс祉0 荐絎 pack200(1) 篏 JAR <ゃュ<ゃ篏睡с障 翫ュ<ゃ絎鴻 Pack200 若若阪 JAR <ゃ潟若障
49.116 +.TP 3
49.117 +JAR\-file
49.118 +阪 JAR <ゃ
49.119 +.RE
49.120 +
49.121 +.LP
49.122 +.RE
49.123 +.SH " 茯"
49.124 +.LP
49.125 +
49.126 +.LP
49.127 +.LP
49.128 +\f2unpack200\fP \f2pack200\fP(1) т<ゃ JAR <ゃ紊ゃc絎茖с筝篏睡号:
49.129 +.LP
49.130 +.RS 3
49.131 +
49.132 +.LP
49.133 +.LP
49.134 +\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
49.135 +.LP
49.136 .RE
49.137 .LP
49.138 -この例では、デフォルトの unpack200 設定で、myarchive.pack.gz から myarchive.jar が作成されます。
49.139 -.SH オプション
49.140 +箴с \f2unpack200\fP 荐絎с\f2myarchive.jar\fP \f2myarchive.pack.gz\fP 篏障
49.141 +.LP
49.142 +.SH "激с"
49.143 .LP
49.144 .SS
49.145 -標準オプション
49.146 -.TP
49.147 -.B \-Hvalue \--deflate-hint=value
49.148 -JAR ファイル内のすべてのエントリに true、false、keep としてデフレーションを設定します。デフォルトモードは keep です。true または false の場合、デフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
49.149 +罔羣激с
49.150 +.LP
49.151 +.RS 3
49.152 +
49.153 +.LP
49.154 +.LP
49.155 +\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
49.156 +.LP
49.157 +.RS 3
49.158 +
49.159 +.LP
49.160 +.LP
49.161 +JAR <ゃ鴻潟 \f2true\fP\f2false\fP\f2keep\fP 若激с潟荐絎障≪若 \f2keep\fP с\f2true\fP 障 \f2false\fP 翫篏若若ゃ阪 JAR <ゃ鴻潟若激с潟≪若荐絎障
49.162 .LP
49.163 .RE
49.164 +.RE
49.165 .SS
49.166 -非標準オプション
49.167 +罔羣激с
49.168 .LP
49.169 +.RS 3
49.170
49.171 .LP
49.172 .LP
49.173 @@ -75,7 +121,7 @@
49.174
49.175 .LP
49.176 .LP
49.177 -入力パックファイルを削除します。
49.178 +ュ<ゃゃ障
49.179 .LP
49.180 .RE
49.181 .LP
49.182 @@ -85,7 +131,7 @@
49.183
49.184 .LP
49.185 .LP
49.186 -最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
49.187 +絨<祉若吾阪障激с潟茲井絎激<祉若吾阪障
49.188 .LP
49.189 .RE
49.190 .LP
49.191 @@ -95,7 +141,7 @@
49.192
49.193 .LP
49.194 .LP
49.195 -メッセージを表示せずに動作します。
49.196 +<祉若吾茵腓冴篏障
49.197 .LP
49.198 .RE
49.199 .LP
49.200 @@ -105,51 +151,65 @@
49.201
49.202 .LP
49.203 .LP
49.204 -メッセージを出力するログファイルを指定します。
49.205 +阪<祉若吾違<ゃ絎障
49.206 .LP
49.207 .RE
49.208 -.SH 終了ステータス
49.209 -次の終了値が返されます。
49.210 -.TP
49.211 -.B 0 " 成功"
49.212 -.TP
49.213 -.B >0 " エラー"
49.214 -.SH 関連項目
49.215 +.RE
49.216 +.SH "腟篋鴻若帥"
49.217 +.LP
49.218 +
49.219 +.LP
49.220 +.LP
49.221 +罨<腟篋ゃ菴障
49.222 +.LP
49.223 +.RS 3
49.224 +
49.225 +.LP
49.226 +.LP
49.227 +\f2\ 0\fP " "
49.228 +.LP
49.229 +.LP
49.230 +\f2>0\fP " "
49.231 +.LP
49.232 +.RE
49.233 +.SH "∫i"
49.234 .LP
49.235 .RS 3
49.236 .TP 2
49.237 -*
49.238 -pack200 \- JAR パックツール
49.239 +o
49.240 +pack200(1)
49.241 .TP 2
49.242 -*
49.243 -\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP のマニュアルページ
49.244 +o
49.245 +.na
49.246 +\f2Java SE ャ<潟\fP @
49.247 +.fi
49.248 +http://java.sun.com/javase/6/docs/index.html
49.249 .TP 2
49.250 -*
49.251 -Java SE のドキュメント
49.252 -.TP 2
49.253 -*
49.254 +o
49.255 +.na
49.256 +\f2Java ゃ \- Pack200\fP @
49.257 .fi
49.258 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
49.259 -の
49.260 -.na
49.261 -「\f2Java Deployment Guide」 \- Pack200\fP
49.262 .TP 2
49.263 -*
49.264 -\f2jar\fP \- Java アーカイブツール
49.265 +o
49.266 +jar(1) \- Java Archive 若
49.267 .TP 2
49.268 -*
49.269 -.fi
49.270 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
49.271 -の
49.272 -.na
49.273 -「\f2jarsigner\fP」 \- JAR 署名ツール
49.274 +o
49.275 +jarsigner(1) \- JAR 臀峨恰荐若若
49.276 +.TP 2
49.277 +o
49.278 +\f2attributes(5)\fP ャ≪若
49.279 .RE
49.280
49.281 .LP
49.282 -.SH 注意事項
49.283 -このコマンドと unpack(1) コマンドを混同しないでください。これらは別製品です。
49.284 +.SH "羈鋋"
49.285 .LP
49.286 +
49.287 .LP
49.288 -ドキュメント間に矛盾がある場合、SDK に付属する Java SE API 仕様が最優先されます。
49.289 +.LP
49.290 +潟潟 \f2unpack(1)\fP 羞桁сヨ遵с
49.291 +.LP
49.292 +.LP
49.293 +SDK 篁絮 Java SE API 篁罕檎荀ゃc翫篁罕
49.294 .LP
49.295
50.1 --- a/src/linux/doc/man/ja/wsgen.1 Tue May 12 15:21:55 2009 +0900
50.2 +++ b/src/linux/doc/man/ja/wsgen.1 Thu May 14 00:17:25 2009 -0700
50.3 @@ -1,245 +1,663 @@
50.4 -'\" t
50.5 -.\"
50.6 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
50.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
50.8 -.\"
50.9 -.\" This code is free software; you can redistribute it and/or modify it
50.10 -.\" under the terms of the GNU General Public License version 2 only, as
50.11 -.\" published by the Free Software Foundation.
50.12 -.\"
50.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
50.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
50.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
50.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
50.17 -.\" accompanied this code).
50.18 -.\"
50.19 -.\" You should have received a copy of the GNU General Public License version
50.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
50.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
50.22 -.\"
50.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
50.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
50.25 -.\" have any questions.
50.26 -.\"
50.27 -.\" `
50.28 -.TH wsgen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
50.29 -." Generated by html2man
50.30 -
50.31 -.LP
50.32 -.SH 名前
50.33 -wsgen \- JAX\-WS 2.0 ベータ
50.34 -.LP
50.35 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
50.36 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
50.37 +."
50.38 +." This code is free software; you can redistribute it and/or modify it
50.39 +." under the terms of the GNU General Public License version 2 only, as
50.40 +." published by the Free Software Foundation.
50.41 +."
50.42 +." This code is distributed in the hope that it will be useful, but WITHOUT
50.43 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
50.44 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
50.45 +." version 2 for more details (a copy is included in the LICENSE file that
50.46 +." accompanied this code).
50.47 +."
50.48 +." You should have received a copy of the GNU General Public License version
50.49 +." 2 along with this work; if not, write to the Free Software Foundation,
50.50 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
50.51 +."
50.52 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
50.53 +." CA 95054 USA or visit www.sun.com if you need additional information or
50.54 +." have any questions.
50.55 +."
50.56 +.TH wsgen 1 "04 May 2009"
50.57 +." Generated from HTML by html2man (author: Eric Armstrong)
50.58 +.SH ""
50.59 +wsgen \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
50.60 .RS 3
50.61
50.62 .LP
50.63 .LP
50.64 -\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、サービスエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
50.65 +\f3篁罕若吾с:\fP 2.1
50.66 +.br
50.67 +\f3絎茖若吾с:\fP 2.1.1
50.68 +.LP
50.69 +.LP
50.70 +\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若c<障若Web 泣若鴻潟ゃ潟絎茖 (SEI) 茯水Web 泣若鴻若喝冴綽荀鴻≪若c<障
50.71 .LP
50.72 .RE
50.73 -.SH "形式"
50.74 +.SH "网荀"
50.75 .LP
50.76 +\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若c<障若Web 泣若鴻潟ゃ潟鴻茯水Web 泣若鴻若喝冴綽荀鴻≪若c<障JAXWS 2.1.1 RI wsgen Ant 帥鴻障荅括完
50.77 +.na
50.78 +\f2Wsgen Ant 帥鴻\fP @
50.79 +.fi
50.80 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlс
50.81 +.LP
50.82 +.SH "wsgen 莎桁"
50.83 +.RS 3
50.84 +.TP 2
50.85 +o
50.86 +\f3Solaris/Linux\fP
50.87 +.RS 3
50.88 +.TP 2
50.89 +*
50.90 +\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
50.91 +.TP 2
50.92 +*
50.93 +\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
50.94 +.RE
50.95 +.TP 2
50.96 +o
50.97 +\f3Windows\fP
50.98 +.RS 3
50.99 +.TP 2
50.100 +*
50.101 +\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
50.102 +.TP 2
50.103 +*
50.104 +\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
50.105 +.RE
50.106 +.RE
50.107
50.108 .LP
50.109 +.SH "罕"
50.110 .nf
50.111 \f3
50.112 .fl
50.113 -wsgen [options] <SEI>
50.114 +wsgen [options] <SEI>\fP
50.115 +.br
50.116 +\f3
50.117 .fl
50.118 \fP
50.119 .fi
50.120 -
50.121 .LP
50.122 -.SH "オプション"
50.123 +罨<茵\f2wsgen\fP 激с潟腓冴障
50.124 +.br
50.125 .LP
50.126 -.LP
50.127 -次の表に、\f2wsgen\fP のオプションを示します。
50.128 -.LP
50.129 -.LP
50.130 -表 1\-1 wsgen のオプション
50.131 -.LP
50.132 -.LP
50.133 -.sp 1n
50.134 .TS
50.135 -center;
50.136 -cbp-1 cbp-1
50.137 -li l .
50.138 -オプション 詳細
50.139 -_
50.140 --classpath <path> 入力クラスファイルの検索場所を指定します
50.141 --cp <path> T{
50.142 --classpath <path> と同じ
50.143 -T}
50.144 --d <directory> 生成される出力ファイルを格納する場所を指定する
50.145 --extension T{
50.146 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
50.147 -T}
50.148 --help T{
50.149 -ヘルプを表示します
50.150 -T}
50.151 --keep T{
50.152 -生成されたファイルを保持します
50.153 -T}
50.154 --r <directory> T{
50.155 -常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
50.156 -T}
50.157 --s <directory> T{
50.158 -生成されるソースファイルを格納する場所を指定する
50.159 -T}
50.160 --verbose T{
50.161 -コンパイラが実行している処理に関するメッセージを出力します
50.162 -T}
50.163 --version T{
50.164 -バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
50.165 -T}
50.166 --wsdl[:protocol] T{
50.167 -wsgen はデフォルトでは WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は wsgen が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。protocol は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために使用されます。有効なプロトコルは次のとおりで す。 soap1.1 と Xsoap1.2。デフォルトは soap1.1 です。Xsoap1.2 は標準ではないた め、-extension オプションと組み合わせないと使用できません。
50.168 -T}
50.169 --servicename <name> T{
50.170 -常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:service の名前を指定するために使用します。例 : -servicename "{http://mynamespace/}MyService"
50.171 -T}
50.172 --portname <name> T{
50.173 -常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:port の名 前を指定するために使用します。例 : -portname "{http://mynamespace/}MyPort"
50.174 -T}
50.175 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
50.176 +.de 35
50.177 +.ps \n(.s
50.178 +.vs \n(.vu
50.179 +.in \n(.iu
50.180 +.if \n(.u .fi
50.181 +.if \n(.j .ad
50.182 +.if \n(.j=0 .na
50.183 +..
50.184 +.nf
50.185 +.nr #~ 0
50.186 +.if n .nr #~ 0.6n
50.187 +.ds #d .d
50.188 +.if \(ts\n(.z\(ts\(ts .ds #d nl
50.189 +.fc
50.190 +.nr 33 \n(.s
50.191 +.rm 80 81
50.192 +.nr 34 \n(.lu
50.193 +.eo
50.194 +.am 81
50.195 +.br
50.196 +.di a+
50.197 +.35
50.198 +.ft \n(.f
50.199 +.ll \n(34u*1u/3u
50.200 +.if \n(.l<\n(81 .ll \n(81u
50.201 +.in 0
50.202 +ュ鴻<ゃ罎膣√贋絎障
50.203 +.br
50.204 +.di
50.205 +.nr a| \n(dn
50.206 +.nr a- \n(dl
50.207 +..
50.208 +.ec \
50.209 +.eo
50.210 +.am 81
50.211 +.br
50.212 +.di b+
50.213 +.35
50.214 +.ft \n(.f
50.215 +.ll \n(34u*1u/3u
50.216 +.if \n(.l<\n(81 .ll \n(81u
50.217 +.in 0
50.218 +\f2\-classpath <path>\fP
50.219 +.br
50.220 +.di
50.221 +.nr b| \n(dn
50.222 +.nr b- \n(dl
50.223 +..
50.224 +.ec \
50.225 +.eo
50.226 +.am 81
50.227 +.br
50.228 +.di c+
50.229 +.35
50.230 +.ft \n(.f
50.231 +.ll \n(34u*1u/3u
50.232 +.if \n(.l<\n(81 .ll \n(81u
50.233 +.in 0
50.234 +阪<ゃ主贋絎
50.235 +.br
50.236 +.di
50.237 +.nr c| \n(dn
50.238 +.nr c- \n(dl
50.239 +..
50.240 +.ec \
50.241 +.eo
50.242 +.am 81
50.243 +.br
50.244 +.di d+
50.245 +.35
50.246 +.ft \n(.f
50.247 +.ll \n(34u*1u/3u
50.248 +.if \n(.l<\n(81 .ll \n(81u
50.249 +.in 0
50.250 +潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵с障
50.251 +.br
50.252 +.di
50.253 +.nr d| \n(dn
50.254 +.nr d- \n(dl
50.255 +..
50.256 +.ec \
50.257 +.eo
50.258 +.am 81
50.259 +.br
50.260 +.di e+
50.261 +.35
50.262 +.ft \n(.f
50.263 +.ll \n(34u*1u/3u
50.264 +.if \n(.l<\n(81 .ll \n(81u
50.265 +.in 0
50.266 +茵腓冴障
50.267 +.br
50.268 +.di
50.269 +.nr e| \n(dn
50.270 +.nr e- \n(dl
50.271 +..
50.272 +.ec \
50.273 +.eo
50.274 +.am 81
50.275 +.br
50.276 +.di f+
50.277 +.35
50.278 +.ft \n(.f
50.279 +.ll \n(34u*1u/3u
50.280 +.if \n(.l<\n(81 .ll \n(81u
50.281 +.in 0
50.282 +<ゃ篆障
50.283 +.br
50.284 +.di
50.285 +.nr f| \n(dn
50.286 +.nr f- \n(dl
50.287 +..
50.288 +.ec \
50.289 +.eo
50.290 +.am 81
50.291 +.br
50.292 +.di g+
50.293 +.35
50.294 +.ft \n(.f
50.295 +.ll \n(34u*1u/3u
50.296 +.if \n(.l<\n(81 .ll \n(81u
50.297 +.in 0
50.298 +絽吾 \-wsdl 激с潟腟水篏睡障WSDL 純若鴻<ゃ主贋絎障
50.299 +.br
50.300 +.di
50.301 +.nr g| \n(dn
50.302 +.nr g- \n(dl
50.303 +..
50.304 +.ec \
50.305 +.eo
50.306 +.am 81
50.307 +.br
50.308 +.di h+
50.309 +.35
50.310 +.ft \n(.f
50.311 +.ll \n(34u*1u/3u
50.312 +.if \n(.l<\n(81 .ll \n(81u
50.313 +.in 0
50.314 +純若鴻<ゃ主贋絎
50.315 +.br
50.316 +.di
50.317 +.nr h| \n(dn
50.318 +.nr h- \n(dl
50.319 +..
50.320 +.ec \
50.321 +.eo
50.322 +.am 81
50.323 +.br
50.324 +.di i+
50.325 +.35
50.326 +.ft \n(.f
50.327 +.ll \n(34u*1u/3u
50.328 +.if \n(.l<\n(81 .ll \n(81u
50.329 +.in 0
50.330 +潟潟ゃ絎茵≪<祉若吾阪障
50.331 +.br
50.332 +.di
50.333 +.nr i| \n(dn
50.334 +.nr i- \n(dl
50.335 +..
50.336 +.ec \
50.337 +.eo
50.338 +.am 81
50.339 +.br
50.340 +.di j+
50.341 +.35
50.342 +.ft \n(.f
50.343 +.ll \n(34u*1u/3u
50.344 +.if \n(.l<\n(81 .ll \n(81u
50.345 +.in 0
50.346 +若吾с恰宴阪障激с潟篏睡翫若吾с恰宴阪с絽吾絎茵障
50.347 +.br
50.348 +.di
50.349 +.nr j| \n(dn
50.350 +.nr j- \n(dl
50.351 +..
50.352 +.ec \
50.353 +.eo
50.354 +.am 81
50.355 +.br
50.356 +.di k+
50.357 +.35
50.358 +.ft \n(.f
50.359 +.ll \n(34u*1u/3u
50.360 +.if \n(.l<\n(81 .ll \n(81u
50.361 +.in 0
50.362 +\f2wsgen\fP с WSDL <ゃ障違ュ純с絎翫 \f2wsgen\fP WSDL <ゃ障違絽吾潟ゃ潟肴 WSDL сс篏睡障\f2protocol\fP ュ純с\f2wsdl:binding\fP т戎鴻潟絎篏睡障鴻潟罨<с\f2soap1.1\fP \f2Xsoap1.2\fP \f2soap1.1\fP с\f2Xsoap1.2\fP 罔羣с\f2\-extension\fP 激с潟腟水篏睡с障
50.363 +.br
50.364 +.di
50.365 +.nr k| \n(dn
50.366 +.nr k- \n(dl
50.367 +..
50.368 +.ec \
50.369 +.eo
50.370 +.am 81
50.371 +.br
50.372 +.di l+
50.373 +.35
50.374 +.ft \n(.f
50.375 +.ll \n(34u*1u/3u
50.376 +.if \n(.l<\n(81 .ll \n(81u
50.377 +.in 0
50.378 +絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:service\fP 絎篏睡障箴 : \f2\-servicename "{http://mynamespace/}MyService"\fP
50.379 +.br
50.380 +.di
50.381 +.nr l| \n(dn
50.382 +.nr l- \n(dl
50.383 +..
50.384 +.ec \
50.385 +.eo
50.386 +.am 81
50.387 +.br
50.388 +.di m+
50.389 +.35
50.390 +.ft \n(.f
50.391 +.ll \n(34u*1u/3u
50.392 +.if \n(.l<\n(81 .ll \n(81u
50.393 +.in 0
50.394 +絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:port\fP 絎篏睡障箴 : \f2\-portname "{http://mynamespace/}MyPort"\fP
50.395 +.br
50.396 +.br
50.397 +.di
50.398 +.nr m| \n(dn
50.399 +.nr m- \n(dl
50.400 +..
50.401 +.ec \
50.402 +.35
50.403 +.nf
50.404 +.ll \n(34u
50.405 +.nr 80 0
50.406 +.nr 38 \w\f3激с\fP
50.407 +.if \n(80<\n(38 .nr 80 \n(38
50.408 +.nr 38 \w\f4\-classpath <path>\fP
50.409 +.if \n(80<\n(38 .nr 80 \n(38
50.410 +.nr 38 \w\f4\-cp <path>\fP
50.411 +.if \n(80<\n(38 .nr 80 \n(38
50.412 +.nr 38 \w\f4\-d <directory>\fP
50.413 +.if \n(80<\n(38 .nr 80 \n(38
50.414 +.nr 38 \w\f4\-extension\fP
50.415 +.if \n(80<\n(38 .nr 80 \n(38
50.416 +.nr 38 \w\f4\-help\fP
50.417 +.if \n(80<\n(38 .nr 80 \n(38
50.418 +.nr 38 \w\f4\-keep\fP
50.419 +.if \n(80<\n(38 .nr 80 \n(38
50.420 +.nr 38 \w\f4\-r <directory>\fP
50.421 +.if \n(80<\n(38 .nr 80 \n(38
50.422 +.nr 38 \w\f4\-s <directory>\fP
50.423 +.if \n(80<\n(38 .nr 80 \n(38
50.424 +.nr 38 \w\f4\-verbose\fP
50.425 +.if \n(80<\n(38 .nr 80 \n(38
50.426 +.nr 38 \w\f4\-version\fP
50.427 +.if \n(80<\n(38 .nr 80 \n(38
50.428 +.nr 38 \w\f4\-wsdl[:protocol]\fP
50.429 +.if \n(80<\n(38 .nr 80 \n(38
50.430 +.nr 38 \w\f4\-servicename <name>\fP
50.431 +.if \n(80<\n(38 .nr 80 \n(38
50.432 +.nr 38 \w\f4\-portname <name>\fP
50.433 +.if \n(80<\n(38 .nr 80 \n(38
50.434 +.80
50.435 +.rm 80
50.436 +.nr 81 0
50.437 +.nr 38 \w\f3茯\fP
50.438 +.if \n(81<\n(38 .nr 81 \n(38
50.439 +.81
50.440 +.rm 81
50.441 +.nr 38 \n(a-
50.442 +.if \n(81<\n(38 .nr 81 \n(38
50.443 +.nr 38 \n(b-
50.444 +.if \n(81<\n(38 .nr 81 \n(38
50.445 +.nr 38 \n(c-
50.446 +.if \n(81<\n(38 .nr 81 \n(38
50.447 +.nr 38 \n(d-
50.448 +.if \n(81<\n(38 .nr 81 \n(38
50.449 +.nr 38 \n(e-
50.450 +.if \n(81<\n(38 .nr 81 \n(38
50.451 +.nr 38 \n(f-
50.452 +.if \n(81<\n(38 .nr 81 \n(38
50.453 +.nr 38 \n(g-
50.454 +.if \n(81<\n(38 .nr 81 \n(38
50.455 +.nr 38 \n(h-
50.456 +.if \n(81<\n(38 .nr 81 \n(38
50.457 +.nr 38 \n(i-
50.458 +.if \n(81<\n(38 .nr 81 \n(38
50.459 +.nr 38 \n(j-
50.460 +.if \n(81<\n(38 .nr 81 \n(38
50.461 +.nr 38 \n(k-
50.462 +.if \n(81<\n(38 .nr 81 \n(38
50.463 +.nr 38 \n(l-
50.464 +.if \n(81<\n(38 .nr 81 \n(38
50.465 +.nr 38 \n(m-
50.466 +.if \n(81<\n(38 .nr 81 \n(38
50.467 +.35
50.468 +.nf
50.469 +.ll \n(34u
50.470 +.nr 38 1n
50.471 +.nr 79 0
50.472 +.nr 40 \n(79+(0*\n(38)
50.473 +.nr 80 +\n(40
50.474 +.nr 41 \n(80+(3*\n(38)
50.475 +.nr 81 +\n(41
50.476 +.nr TW \n(81
50.477 +.if t .if \n(TW>\n(.li .tm Table at line 144 file Input is too wide - \n(TW units
50.478 +.fc
50.479 +.nr #T 0-1
50.480 +.nr #a 0-1
50.481 +.eo
50.482 +.de T#
50.483 +.ds #d .d
50.484 +.if \(ts\n(.z\(ts\(ts .ds #d nl
50.485 +.mk ##
50.486 +.nr ## -1v
50.487 +.ls 1
50.488 +.ls
50.489 +..
50.490 +.ec
50.491 +.ta \n(80u \n(81u
50.492 +.nr 31 \n(.f
50.493 +.nr 35 1m
50.494 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
50.495 +.ne \n(a|u+\n(.Vu
50.496 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
50.497 +.ta \n(80u \n(81u
50.498 +.nr 31 \n(.f
50.499 +.nr 35 1m
50.500 +\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
50.501 +.mk ##
50.502 +.nr 31 \n(##
50.503 +.sp |\n(##u-1v
50.504 +.nr 37 \n(41u
50.505 +.in +\n(37u
50.506 +.a+
50.507 +.in -\n(37u
50.508 +.mk 32
50.509 +.if \n(32>\n(31 .nr 31 \n(32
50.510 +.sp |\n(31u
50.511 +.ne \n(b|u+\n(.Vu
50.512 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
50.513 +.ta \n(80u \n(81u
50.514 +.nr 31 \n(.f
50.515 +.nr 35 1m
50.516 +\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
50.517 +.mk ##
50.518 +.nr 31 \n(##
50.519 +.sp |\n(##u-1v
50.520 +.nr 37 \n(41u
50.521 +.in +\n(37u
50.522 +.b+
50.523 +.in -\n(37u
50.524 +.mk 32
50.525 +.if \n(32>\n(31 .nr 31 \n(32
50.526 +.sp |\n(31u
50.527 +.ne \n(c|u+\n(.Vu
50.528 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
50.529 +.ta \n(80u \n(81u
50.530 +.nr 31 \n(.f
50.531 +.nr 35 1m
50.532 +\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
50.533 +.mk ##
50.534 +.nr 31 \n(##
50.535 +.sp |\n(##u-1v
50.536 +.nr 37 \n(41u
50.537 +.in +\n(37u
50.538 +.c+
50.539 +.in -\n(37u
50.540 +.mk 32
50.541 +.if \n(32>\n(31 .nr 31 \n(32
50.542 +.sp |\n(31u
50.543 +.ne \n(d|u+\n(.Vu
50.544 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
50.545 +.ta \n(80u \n(81u
50.546 +.nr 31 \n(.f
50.547 +.nr 35 1m
50.548 +\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
50.549 +.mk ##
50.550 +.nr 31 \n(##
50.551 +.sp |\n(##u-1v
50.552 +.nr 37 \n(41u
50.553 +.in +\n(37u
50.554 +.d+
50.555 +.in -\n(37u
50.556 +.mk 32
50.557 +.if \n(32>\n(31 .nr 31 \n(32
50.558 +.sp |\n(31u
50.559 +.ne \n(e|u+\n(.Vu
50.560 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
50.561 +.ta \n(80u \n(81u
50.562 +.nr 31 \n(.f
50.563 +.nr 35 1m
50.564 +\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'
50.565 +.mk ##
50.566 +.nr 31 \n(##
50.567 +.sp |\n(##u-1v
50.568 +.nr 37 \n(41u
50.569 +.in +\n(37u
50.570 +.e+
50.571 +.in -\n(37u
50.572 +.mk 32
50.573 +.if \n(32>\n(31 .nr 31 \n(32
50.574 +.sp |\n(31u
50.575 +.ne \n(f|u+\n(.Vu
50.576 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
50.577 +.ta \n(80u \n(81u
50.578 +.nr 31 \n(.f
50.579 +.nr 35 1m
50.580 +\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'
50.581 +.mk ##
50.582 +.nr 31 \n(##
50.583 +.sp |\n(##u-1v
50.584 +.nr 37 \n(41u
50.585 +.in +\n(37u
50.586 +.f+
50.587 +.in -\n(37u
50.588 +.mk 32
50.589 +.if \n(32>\n(31 .nr 31 \n(32
50.590 +.sp |\n(31u
50.591 +.ne \n(g|u+\n(.Vu
50.592 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
50.593 +.ta \n(80u \n(81u
50.594 +.nr 31 \n(.f
50.595 +.nr 35 1m
50.596 +\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
50.597 +.mk ##
50.598 +.nr 31 \n(##
50.599 +.sp |\n(##u-1v
50.600 +.nr 37 \n(41u
50.601 +.in +\n(37u
50.602 +.g+
50.603 +.in -\n(37u
50.604 +.mk 32
50.605 +.if \n(32>\n(31 .nr 31 \n(32
50.606 +.sp |\n(31u
50.607 +.ne \n(h|u+\n(.Vu
50.608 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
50.609 +.ta \n(80u \n(81u
50.610 +.nr 31 \n(.f
50.611 +.nr 35 1m
50.612 +\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
50.613 +.mk ##
50.614 +.nr 31 \n(##
50.615 +.sp |\n(##u-1v
50.616 +.nr 37 \n(41u
50.617 +.in +\n(37u
50.618 +.h+
50.619 +.in -\n(37u
50.620 +.mk 32
50.621 +.if \n(32>\n(31 .nr 31 \n(32
50.622 +.sp |\n(31u
50.623 +.ne \n(i|u+\n(.Vu
50.624 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
50.625 +.ta \n(80u \n(81u
50.626 +.nr 31 \n(.f
50.627 +.nr 35 1m
50.628 +\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
50.629 +.mk ##
50.630 +.nr 31 \n(##
50.631 +.sp |\n(##u-1v
50.632 +.nr 37 \n(41u
50.633 +.in +\n(37u
50.634 +.i+
50.635 +.in -\n(37u
50.636 +.mk 32
50.637 +.if \n(32>\n(31 .nr 31 \n(32
50.638 +.sp |\n(31u
50.639 +.ne \n(j|u+\n(.Vu
50.640 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
50.641 +.ta \n(80u \n(81u
50.642 +.nr 31 \n(.f
50.643 +.nr 35 1m
50.644 +\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
50.645 +.mk ##
50.646 +.nr 31 \n(##
50.647 +.sp |\n(##u-1v
50.648 +.nr 37 \n(41u
50.649 +.in +\n(37u
50.650 +.j+
50.651 +.in -\n(37u
50.652 +.mk 32
50.653 +.if \n(32>\n(31 .nr 31 \n(32
50.654 +.sp |\n(31u
50.655 +.ne \n(k|u+\n(.Vu
50.656 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
50.657 +.ta \n(80u \n(81u
50.658 +.nr 31 \n(.f
50.659 +.nr 35 1m
50.660 +\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
50.661 +.mk ##
50.662 +.nr 31 \n(##
50.663 +.sp |\n(##u-1v
50.664 +.nr 37 \n(41u
50.665 +.in +\n(37u
50.666 +.k+
50.667 +.in -\n(37u
50.668 +.mk 32
50.669 +.if \n(32>\n(31 .nr 31 \n(32
50.670 +.sp |\n(31u
50.671 +.ne \n(l|u+\n(.Vu
50.672 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
50.673 +.ta \n(80u \n(81u
50.674 +.nr 31 \n(.f
50.675 +.nr 35 1m
50.676 +\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
50.677 +.mk ##
50.678 +.nr 31 \n(##
50.679 +.sp |\n(##u-1v
50.680 +.nr 37 \n(41u
50.681 +.in +\n(37u
50.682 +.l+
50.683 +.in -\n(37u
50.684 +.mk 32
50.685 +.if \n(32>\n(31 .nr 31 \n(32
50.686 +.sp |\n(31u
50.687 +.ne \n(m|u+\n(.Vu
50.688 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
50.689 +.ta \n(80u \n(81u
50.690 +.nr 31 \n(.f
50.691 +.nr 35 1m
50.692 +\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
50.693 +.mk ##
50.694 +.nr 31 \n(##
50.695 +.sp |\n(##u-1v
50.696 +.nr 37 \n(41u
50.697 +.in +\n(37u
50.698 +.m+
50.699 +.in -\n(37u
50.700 +.mk 32
50.701 +.if \n(32>\n(31 .nr 31 \n(32
50.702 +.sp |\n(31u
50.703 +.fc
50.704 +.nr T. 1
50.705 +.T# 1
50.706 +.35
50.707 +.rm a+
50.708 +.rm b+
50.709 +.rm c+
50.710 +.rm d+
50.711 +.rm e+
50.712 +.rm f+
50.713 +.rm g+
50.714 +.rm h+
50.715 +.rm i+
50.716 +.rm j+
50.717 +.rm k+
50.718 +.rm l+
50.719 +.rm m+
50.720 .TE
50.721 .if \n-(b.=0 .nr c. \n(.c-\n(d.-57
50.722
50.723 .LP
50.724 -.SS
50.725 -Ant タスク
50.726 -.LP
50.727 -.LP
50.728 -\f2wsgen\fP ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
50.729 -.LP
50.730 +.SH "箴"
50.731 .nf
50.732 \f3
50.733 .fl
50.734 -
50.735 +\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
50.736 .fl
50.737 - <wsgen
50.738 -.fl
50.739 - sei="..."
50.740 -.fl
50.741 - destdir="directory for generated class files"
50.742 -.fl
50.743 - classpath="classpath" | cp="classpath"
50.744 -.fl
50.745 - resourcedestdir="directory for generated resource files such as WSDLs"
50.746 -.fl
50.747 - sourcedestdir="directory for generated source files"
50.748 -.fl
50.749 - keep="true|false"
50.750 -.fl
50.751 - verbose="true|false"
50.752 -.fl
50.753 - genwsdl="true|false"
50.754 -.fl
50.755 - protocol="soap1.1|Xsoap1.2"
50.756 -.fl
50.757 - servicename="..."
50.758 -.fl
50.759 - portname="...">
50.760 -.fl
50.761 - extension="true|false"
50.762 -.fl
50.763 - <classpath refid="..."/>
50.764 -.fl
50.765 - </wsgen>
50.766 -.fl
50.767 -\fP
50.768 .fi
50.769 -
50.770 .LP
50.771 -.LP
50.772 -.TS
50.773 -center;
50.774 -lbp-1 lbp-1 lbp-1
50.775 -li l l
50.776 -li l li .
50.777 -属性 説明 コマンド行
50.778 -_
50.779 -sei サービスエンドポイント実装クラスの名前 SEI
50.780 -destdir T{
50.781 -生成される出力クラスを格納する場所を指定します
50.782 -T} -d
50.783 -classpath 入力クラスファイルの検索場所を指定します -classpath
50.784 -cp -classpath と同じ -cp
50.785 -resourcedestdir T{
50.786 -常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
50.787 -T} -r
50.788 -sourcedestdir T{
50.789 -生成されるソースファイルを格納する場所を指定します
50.790 -T} -s
50.791 -keep 生成されたファイルを保持します -keep
50.792 -verbose T{
50.793 -コンパイラが実行している処理に関するメッセージを出力します
50.794 -T} -verbose
50.795 -genwsdl T{
50.796 -WSDL ファイルを生 成すべきかどうかを指定します
50.797 -T} -wsdl
50.798 -protocol T{
50.799 -genwsdl と組み合わせて使用します。wsdl:binding で使用するプロトコルを指定します。有効な値は「soap1.1」と「Xsoap1.2」で、デフォルトは「soap1.1」です。「Xsoap1.2」は標準ではないため、-extensions オプションと組み合わせないと使用できません
50.800 -T} -wsdl:soap11
50.801 -servicename T{
50.802 -genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:service の名前を指定するために使用します。例 : servicename="{http://mynamespace/}MyService"
50.803 -T} -servicename
50.804 -portname T{
50.805 -genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:portname の名前を指定するために使用します。例 : portname="{http://mynamespace/}MyPort"
50.806 -T} -servicename
50.807 -extension T{
50.808 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
50.809 -T} -extension
50.810 -.TE
50.811 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
50.812 -
50.813 -.LP
50.814 -.LP
50.815 -\f2classpath\fP 属性は、
50.816 -.na
50.817 -\f2Path\-like Structure\fP
50.818 -.fi
50.819 -(http://ant.apache.org/manual/using.html#path) であり、入れ子になった \f2<classpath>\fP 要素を使って設定することもできます。このタスクを使用するには、次の \f2<taskdef>\fP 要素をプロジェクトに追加しておく必要があります。
50.820 -.LP
50.821 +\f3stock\fP c @WebService 羈篁StockService 綽荀若鴻障
50.822 .nf
50.823 \f3
50.824 .fl
50.825 - <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">
50.826 +\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
50.827 .fl
50.828 - <classpath path="jaxws.classpath"/>
50.829 -.fl
50.830 - </taskdef>
50.831 -.fl
50.832 -\fP
50.833 .fi
50.834 -
50.835 .LP
50.836 -.LP
50.837 -ここで、\f2jaxws.classpath\fP は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された
50.838 -.na
50.839 -\f2Path\-like Structure\fP
50.840 -.fi
50.841 -(http://ant.apache.org/manual/using.html#path) への参照です。
50.842 -.LP
50.843 -.SH "例"
50.844 -.LP
50.845 -
50.846 -.LP
50.847 +SOAP 1.1 WSDL @WebService 羈篁 Java stock.StockService 鴻若障
50.848 .nf
50.849 \f3
50.850 .fl
50.851 -<wsgen
50.852 +\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
50.853 .fl
50.854 - resourcedestdir="${wsdl.dir}"
50.855 -.fl
50.856 - sei="fromjava.server.AddNumbersImpl">
50.857 -.fl
50.858 - <classpath refid="compile.classpath"/>
50.859 -.fl
50.860 -</wsgen>
50.861 -.fl
50.862 -\fP
50.863 .fi
50.864 -
50.865 .LP
50.866 -
50.867 +SOAP 1.2 WSDL 障
50.868 .LP
50.869 -
50.870 +泣若鴻 JAXWS 潟帥ゃc WSDL 堺 WSDL 綽荀障
51.1 --- a/src/linux/doc/man/ja/wsimport.1 Tue May 12 15:21:55 2009 +0900
51.2 +++ b/src/linux/doc/man/ja/wsimport.1 Thu May 14 00:17:25 2009 -0700
51.3 @@ -1,38 +1,84 @@
51.4 -'\" t
51.5 -.\"
51.6 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
51.7 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
51.8 -.\"
51.9 -.\" This code is free software; you can redistribute it and/or modify it
51.10 -.\" under the terms of the GNU General Public License version 2 only, as
51.11 -.\" published by the Free Software Foundation.
51.12 -.\"
51.13 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
51.14 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
51.15 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
51.16 -.\" version 2 for more details (a copy is included in the LICENSE file that
51.17 -.\" accompanied this code).
51.18 -.\"
51.19 -.\" You should have received a copy of the GNU General Public License version
51.20 -.\" 2 along with this work; if not, write to the Free Software Foundation,
51.21 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
51.22 -.\"
51.23 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
51.24 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
51.25 -.\" have any questions.
51.26 -.\"
51.27 -.\" `
51.28 -.TH wsimport 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
51.29 -." Generated by html2man
51.30 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
51.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
51.32 +."
51.33 +." This code is free software; you can redistribute it and/or modify it
51.34 +." under the terms of the GNU General Public License version 2 only, as
51.35 +." published by the Free Software Foundation.
51.36 +."
51.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
51.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
51.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
51.40 +." version 2 for more details (a copy is included in the LICENSE file that
51.41 +." accompanied this code).
51.42 +."
51.43 +." You should have received a copy of the GNU General Public License version
51.44 +." 2 along with this work; if not, write to the Free Software Foundation,
51.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
51.46 +."
51.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
51.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
51.49 +." have any questions.
51.50 +."
51.51 +.TH wsimport 1 "04 May 2009"
51.52 +." Generated from HTML by html2man (author: Eric Armstrong)
51.53 +.SH ""
51.54 +wsimport \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
51.55 +.LP
51.56 +\f3篁罕若吾с:\fP 2.1
51.57 +.br
51.58 +\f3絎茖若吾с:\fP 2.1.1
51.59 +.br
51.60 +.SH "网荀"
51.61 +.LP
51.62 +\f2wsimport\fP 若罨< JAX\-WS 若帥≪若c<障
51.63 +.RS 3
51.64 +.TP 2
51.65 +o
51.66 +泣若鴻潟ゃ潟ゃ潟帥с若 (SEI)
51.67 +.TP 2
51.68 +o
51.69 +泣若
51.70 +.TP 2
51.71 +o
51.72 +wsdl:fault 箴紊 (絖翫)
51.73 +.TP 2
51.74 +o
51.75 +綽膈 wsdl:message 羇丞綽膈 Bean (絖翫)
51.76 +.TP 2
51.77 +o
51.78 +JAX\-B ゃ帥ゃ (鴻若 Java )
51.79 +.RE
51.80 +.LP
51.81 +≪若c<WSDL ャ<潟鴻若ャ<潟潟潟ゃ潟絎茖 WAR <ゃ宴若後с障障wsimport Ant 帥鴻障
51.82 +.na
51.83 +\f2Wsimport Ant 帥鴻\fP @
51.84 +.fi
51.85 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlс
51.86 +.br
51.87
51.88 .LP
51.89 -.SH 名前
51.90 -wsimport \- JAX\-WS 2.0 ベータ
51.91 -.LP
51.92 -.SH "形式"
51.93 -.LP
51.94 +.SH "wsimport 莎桁"
51.95 +.RS 3
51.96 +.TP 2
51.97 +o
51.98 +\f3Solaris/Linux\fP
51.99 +.RS 3
51.100 +.TP 2
51.101 +*
51.102 +\f2/bin/wsimport.sh \-help\fP
51.103 +.RE
51.104 +.TP 2
51.105 +o
51.106 +\f3Windows\fP
51.107 +.RS 3
51.108 +.TP 2
51.109 +*
51.110 +\f2\\bin\\wsimport.bat \-help\fP
51.111 +.RE
51.112 +.RE
51.113
51.114 .LP
51.115 +.SH "罕"
51.116 .nf
51.117 \f3
51.118 .fl
51.119 @@ -40,277 +86,701 @@
51.120 .fl
51.121 \fP
51.122 .fi
51.123 -
51.124 .LP
51.125 -.SH "機能説明"
51.126 -.LP
51.127 -.LP
51.128 -\f2wsimport\fP ツールは、次のような JAX-WS ポータブルアーティファクトを生成します。
51.129 -.LP
51.130 -.RS 3
51.131 -.TP 2
51.132 -o
51.133 -サービスエンドポイントインタフェース (SEI)
51.134 -.TP 2
51.135 -o
51.136 -サービス
51.137 -.TP 2
51.138 -o
51.139 -wsdl:fault からマップされる例外クラス (存在する場合)
51.140 -.TP 2
51.141 -o
51.142 -応答 wsdl:message から派生する非同期応答 Bean (存在する場合)
51.143 -.TP 2
51.144 -o
51.145 -JAX-B が生成する値タイプ (スキーマの型からマップされた Java クラス)
51.146 -.RE
51.147 -
51.148 -.LP
51.149 -.LP
51.150 -これらのアーティファクトは、WSDL ドキュメント、スキーマドキュメント、およびエンドポイント実装とともに WAR ファイル内にパッケージ化して配備することができます。
51.151 -.br
51.152 -
51.153 -.LP
51.154 -.LP
51.155 -wsimport ツールを起動するには、コマンド行スクリプト wsimport.sh (Unix) または wsimport.bat (Windows) を使用します。WSDL をインポートおよびコンパイルするための Ant タスクも存在しています。詳しくは後述の説明を参照してください。
51.156 -.br
51.157 -
51.158 -.LP
51.159 -.SH "オプション"
51.160 -.LP
51.161 -.LP
51.162 -次の表に、\f2wsimport\fP のオプションを示します。
51.163 -.br
51.164 -
51.165 -.LP
51.166 -.LP
51.167 -表 1\-1 wsimport のオプション
51.168 -.LP
51.169 +罨<茵\f2wsimport\fP 激с潟腓冴障
51.170 .LP
51.171 .TS
51.172 -center;
51.173 -cbp-1 cbp-1
51.174 -li l.
51.175 -オプション 説明
51.176 -_
51.177 --d <directory> 生成される出力ファイルを格納する場所を指定します
51.178 --b <path> T{
51.179 -外部の JAX-WS または JAXB バインディングファイルを指定します (<file> ごとに -b が必要となる)
51.180 -T}
51.181 --catalog T{
51.182 -外部エンティティ参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。「XML Entity and URI Resolvers」ドキュメントをお読みになるか、wsimport_catalog サンプルを参照してください。
51.183 -T}
51.184 --extension T{
51.185 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
51.186 -T}
51.187 --help ヘルプを表示します
51.188 --httpproxy:<host>:<port> T{
51.189 -HTTP プロキシサーバーを指定します (デフォルトのポートは 8080)
51.190 -T}
51.191 --keep 生成されたファイルを保持します
51.192 --p T{
51.193 -このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべての WSDL/スキーマバインディングカスタマイズや、 仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます
51.194 -T}
51.195 --s <directory> T{
51.196 -生成されるソースファイルを格納する場所を指定します
51.197 -T}
51.198 --verbose T{
51.199 -コンパイラが実行している処理に関するメッセージを出力します
51.200 -T}
51.201 --version バージョン情報を出力します
51.202 --wsdllocation <location> T{
51.203 -@WebService.wsdlLocation と @WebServiceClient.wsdlLocation の値
51.204 -T}
51.205 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
51.206 +.de 35
51.207 +.ps \n(.s
51.208 +.vs \n(.vu
51.209 +.in \n(.iu
51.210 +.if \n(.u .fi
51.211 +.if \n(.j .ad
51.212 +.if \n(.j=0 .na
51.213 +..
51.214 +.nf
51.215 +.nr #~ 0
51.216 +.if n .nr #~ 0.6n
51.217 +.ds #d .d
51.218 +.if \(ts\n(.z\(ts\(ts .ds #d nl
51.219 +.fc
51.220 +.nr 33 \n(.s
51.221 +.rm 80 81
51.222 +.nr 34 \n(.lu
51.223 +.eo
51.224 +.am 81
51.225 +.br
51.226 +.di a+
51.227 +.35
51.228 +.ft \n(.f
51.229 +.ll \n(34u*1u/3u
51.230 +.if \n(.l<\n(81 .ll \n(81u
51.231 +.in 0
51.232 +阪<ゃ主贋絎障
51.233 +.br
51.234 +.di
51.235 +.nr a| \n(dn
51.236 +.nr a- \n(dl
51.237 +..
51.238 +.ec \
51.239 +.eo
51.240 +.am 81
51.241 +.br
51.242 +.di b+
51.243 +.35
51.244 +.ft \n(.f
51.245 +.ll \n(34u*1u/3u
51.246 +.if \n(.l<\n(81 .ll \n(81u
51.247 +.in 0
51.248 +紊 JAX\-WS 障 JAXB ゃ潟c潟違<ゃ絎障 (\f2<file>\fP \f2\-b\fP 綽荀)
51.249 +.br
51.250 +.di
51.251 +.nr b| \n(dn
51.252 +.nr b- \n(dl
51.253 +..
51.254 +.ec \
51.255 +.eo
51.256 +.am 81
51.257 +.br
51.258 +.di c+
51.259 +.35
51.260 +.ft \n(.f
51.261 +.ll \n(34u*1u/3u
51.262 +.if \n(.l<\n(81 .ll \n(81u
51.263 +.in 0
51.264 +激с潟 JAXB 鴻若潟潟ゃ羝<障
51.265 +.br
51.266 +.di
51.267 +.nr c| \n(dn
51.268 +.nr c- \n(dl
51.269 +..
51.270 +.ec \
51.271 +.eo
51.272 +.am 81
51.273 +.br
51.274 +.di d+
51.275 +.35
51.276 +.ft \n(.f
51.277 +.ll \n(34u*1u/3u
51.278 +.if \n(.l<\n(81 .ll \n(81u
51.279 +.in 0
51.280 +紊潟cc弱с茹f浦帥違<ゃ絎障 TR9401XCatalogOASIS XML Catalog 綵√泣若障
51.281 +.na
51.282 +\f2帥\fP @
51.283 +.fi
51.284 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlャ<潟茯帥\f3帥\fP泣潟с
51.285 +.br
51.286 +.di
51.287 +.nr d| \n(dn
51.288 +.nr d- \n(dl
51.289 +..
51.290 +.ec \
51.291 +.eo
51.292 +.am 81
51.293 +.br
51.294 +.di e+
51.295 +.35
51.296 +.ft \n(.f
51.297 +.ll \n(34u*1u/3u
51.298 +.if \n(.l<\n(81 .ll \n(81u
51.299 +.in 0
51.300 +潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵醇с障
51.301 +.br
51.302 +.di
51.303 +.nr e| \n(dn
51.304 +.nr e- \n(dl
51.305 +..
51.306 +.ec \
51.307 +.eo
51.308 +.am 81
51.309 +.br
51.310 +.di f+
51.311 +.35
51.312 +.ft \n(.f
51.313 +.ll \n(34u*1u/3u
51.314 +.if \n(.l<\n(81 .ll \n(81u
51.315 +.in 0
51.316 +茵腓冴障
51.317 +.br
51.318 +.di
51.319 +.nr f| \n(dn
51.320 +.nr f- \n(dl
51.321 +..
51.322 +.ec \
51.323 +.eo
51.324 +.am 80
51.325 +.br
51.326 +.di g+
51.327 +.35
51.328 +.ft \n(.f
51.329 +.ll \n(34u*1u/3u
51.330 +.if \n(.l<\n(80 .ll \n(80u
51.331 +.in 0
51.332 +\f3\-httpproxy:<host>:<port> \fP
51.333 +.br
51.334 +.di
51.335 +.nr g| \n(dn
51.336 +.nr g- \n(dl
51.337 +..
51.338 +.ec \
51.339 +.eo
51.340 +.am 81
51.341 +.br
51.342 +.di h+
51.343 +.35
51.344 +.ft \n(.f
51.345 +.ll \n(34u*1u/3u
51.346 +.if \n(.l<\n(81 .ll \n(81u
51.347 +.in 0
51.348 +HTTP 激泣若若絎障 (若 8080)
51.349 +.br
51.350 +.di
51.351 +.nr h| \n(dn
51.352 +.nr h- \n(dl
51.353 +..
51.354 +.ec \
51.355 +.eo
51.356 +.am 81
51.357 +.br
51.358 +.di i+
51.359 +.35
51.360 +.ft \n(.f
51.361 +.ll \n(34u*1u/3u
51.362 +.if \n(.l<\n(81 .ll \n(81u
51.363 +.in 0
51.364 +<ゃ篆障
51.365 +.br
51.366 +.di
51.367 +.nr i| \n(dn
51.368 +.nr i- \n(dl
51.369 +..
51.370 +.ec \
51.371 +.eo
51.372 +.am 81
51.373 +.br
51.374 +.di j+
51.375 +.35
51.376 +.ft \n(.f
51.377 +.ll \n(34u*1u/3u
51.378 +.if \n(.l<\n(81 .ll \n(81u
51.379 +.in 0
51.380 +潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻 WSDL/鴻若ゃ潟c潟違鴻帥ゃ冴 篁罕ц鎘宴若後≪眼冴障
51.381 +.br
51.382 +.di
51.383 +.nr j| \n(dn
51.384 +.nr j- \n(dl
51.385 +..
51.386 +.ec \
51.387 +.eo
51.388 +.am 81
51.389 +.br
51.390 +.di k+
51.391 +.35
51.392 +.ft \n(.f
51.393 +.ll \n(34u*1u/3u
51.394 +.if \n(.l<\n(81 .ll \n(81u
51.395 +.in 0
51.396 +純若鴻<ゃ主贋絎障
51.397 +.br
51.398 +.di
51.399 +.nr k| \n(dn
51.400 +.nr k- \n(dl
51.401 +..
51.402 +.ec \
51.403 +.eo
51.404 +.am 81
51.405 +.br
51.406 +.di l+
51.407 +.35
51.408 +.ft \n(.f
51.409 +.ll \n(34u*1u/3u
51.410 +.if \n(.l<\n(81 .ll \n(81u
51.411 +.in 0
51.412 +潟潟ゃ絎茵≪<祉若吾阪障
51.413 +.br
51.414 +.di
51.415 +.nr l| \n(dn
51.416 +.nr l- \n(dl
51.417 +..
51.418 +.ec \
51.419 +.eo
51.420 +.am 81
51.421 +.br
51.422 +.di m+
51.423 +.35
51.424 +.ft \n(.f
51.425 +.ll \n(34u*1u/3u
51.426 +.if \n(.l<\n(81 .ll \n(81u
51.427 +.in 0
51.428 +若吾с恰宴阪障
51.429 +.br
51.430 +.di
51.431 +.nr m| \n(dn
51.432 +.nr m- \n(dl
51.433 +..
51.434 +.ec \
51.435 +.eo
51.436 +.am 80
51.437 +.br
51.438 +.di n+
51.439 +.35
51.440 +.ft \n(.f
51.441 +.ll \n(34u*1u/3u
51.442 +.if \n(.l<\n(80 .ll \n(80u
51.443 +.in 0
51.444 +\f3\-wsdllocation <location>\fP
51.445 +.br
51.446 +.di
51.447 +.nr n| \n(dn
51.448 +.nr n- \n(dl
51.449 +..
51.450 +.ec \
51.451 +.eo
51.452 +.am 81
51.453 +.br
51.454 +.di o+
51.455 +.35
51.456 +.ft \n(.f
51.457 +.ll \n(34u*1u/3u
51.458 +.if \n(.l<\n(81 .ll \n(81u
51.459 +.in 0
51.460 +\f2@WebServiceClient.wsdlLocation\fP
51.461 +.br
51.462 +.di
51.463 +.nr o| \n(dn
51.464 +.nr o- \n(dl
51.465 +..
51.466 +.ec \
51.467 +.eo
51.468 +.am 81
51.469 +.br
51.470 +.di p+
51.471 +.35
51.472 +.ft \n(.f
51.473 +.ll \n(34u*1u/3u
51.474 +.if \n(.l<\n(81 .ll \n(81u
51.475 +.in 0
51.476 +絎 JAX\-WS 篁罕若吾с潟緇c潟若障若吾с 2.0 сJAX\-WS 2.0 篁罕羣潟若障
51.477 +.br
51.478 +.di
51.479 +.nr p| \n(dn
51.480 +.nr p- \n(dl
51.481 +..
51.482 +.ec \
51.483 +.eo
51.484 +.am 81
51.485 +.br
51.486 +.di q+
51.487 +.35
51.488 +.ft \n(.f
51.489 +.ll \n(34u*1u/3u
51.490 +.if \n(.l<\n(81 .ll \n(81u
51.491 +.in 0
51.492 +wsimport 阪吟障
51.493 +.br
51.494 +.di
51.495 +.nr q| \n(dn
51.496 +.nr q- \n(dl
51.497 +..
51.498 +.ec \
51.499 +.35
51.500 +.nf
51.501 +.ll \n(34u
51.502 +.nr 80 0
51.503 +.nr 38 \w\f3激с\fP
51.504 +.if \n(80<\n(38 .nr 80 \n(38
51.505 +.nr 38 \w\f3\-d <directory> \fP
51.506 +.if \n(80<\n(38 .nr 80 \n(38
51.507 +.nr 38 \w\f3\-b <path> \fP
51.508 +.if \n(80<\n(38 .nr 80 \n(38
51.509 +.nr 38 \w\f3\-B <jaxbOption>\fP
51.510 +.if \n(80<\n(38 .nr 80 \n(38
51.511 +.nr 38 \w\f3\-catalog\fP
51.512 +.if \n(80<\n(38 .nr 80 \n(38
51.513 +.nr 38 \w\f3\-extension \fP
51.514 +.if \n(80<\n(38 .nr 80 \n(38
51.515 +.nr 38 \w\f3\-help \fP
51.516 +.if \n(80<\n(38 .nr 80 \n(38
51.517 +.nr 38 \w\f3\-keep \fP
51.518 +.if \n(80<\n(38 .nr 80 \n(38
51.519 +.nr 38 \w\f3\-p \fP
51.520 +.if \n(80<\n(38 .nr 80 \n(38
51.521 +.nr 38 \w\f3\-s <directory> \fP
51.522 +.if \n(80<\n(38 .nr 80 \n(38
51.523 +.nr 38 \w\f3\-verbose \fP
51.524 +.if \n(80<\n(38 .nr 80 \n(38
51.525 +.nr 38 \w\f3\-version \fP
51.526 +.if \n(80<\n(38 .nr 80 \n(38
51.527 +.nr 38 \w\f3\-target \fP
51.528 +.if \n(80<\n(38 .nr 80 \n(38
51.529 +.nr 38 \w\f3\-quiet \fP
51.530 +.if \n(80<\n(38 .nr 80 \n(38
51.531 +.80
51.532 +.rm 80
51.533 +.nr 38 \n(g-
51.534 +.if \n(80<\n(38 .nr 80 \n(38
51.535 +.nr 38 \n(n-
51.536 +.if \n(80<\n(38 .nr 80 \n(38
51.537 +.nr 81 0
51.538 +.nr 38 \w\f3茯\fP
51.539 +.if \n(81<\n(38 .nr 81 \n(38
51.540 +.81
51.541 +.rm 81
51.542 +.nr 38 \n(a-
51.543 +.if \n(81<\n(38 .nr 81 \n(38
51.544 +.nr 38 \n(b-
51.545 +.if \n(81<\n(38 .nr 81 \n(38
51.546 +.nr 38 \n(c-
51.547 +.if \n(81<\n(38 .nr 81 \n(38
51.548 +.nr 38 \n(d-
51.549 +.if \n(81<\n(38 .nr 81 \n(38
51.550 +.nr 38 \n(e-
51.551 +.if \n(81<\n(38 .nr 81 \n(38
51.552 +.nr 38 \n(f-
51.553 +.if \n(81<\n(38 .nr 81 \n(38
51.554 +.nr 38 \n(h-
51.555 +.if \n(81<\n(38 .nr 81 \n(38
51.556 +.nr 38 \n(i-
51.557 +.if \n(81<\n(38 .nr 81 \n(38
51.558 +.nr 38 \n(j-
51.559 +.if \n(81<\n(38 .nr 81 \n(38
51.560 +.nr 38 \n(k-
51.561 +.if \n(81<\n(38 .nr 81 \n(38
51.562 +.nr 38 \n(l-
51.563 +.if \n(81<\n(38 .nr 81 \n(38
51.564 +.nr 38 \n(m-
51.565 +.if \n(81<\n(38 .nr 81 \n(38
51.566 +.nr 38 \n(o-
51.567 +.if \n(81<\n(38 .nr 81 \n(38
51.568 +.nr 38 \n(p-
51.569 +.if \n(81<\n(38 .nr 81 \n(38
51.570 +.nr 38 \n(q-
51.571 +.if \n(81<\n(38 .nr 81 \n(38
51.572 +.35
51.573 +.nf
51.574 +.ll \n(34u
51.575 +.nr 38 1n
51.576 +.nr 79 0
51.577 +.nr 40 \n(79+(0*\n(38)
51.578 +.nr 80 +\n(40
51.579 +.nr 41 \n(80+(3*\n(38)
51.580 +.nr 81 +\n(41
51.581 +.nr TW \n(81
51.582 +.if t .if \n(TW>\n(.li .tm Table at line 164 file Input is too wide - \n(TW units
51.583 +.fc
51.584 +.nr #T 0-1
51.585 +.nr #a 0-1
51.586 +.eo
51.587 +.de T#
51.588 +.ds #d .d
51.589 +.if \(ts\n(.z\(ts\(ts .ds #d nl
51.590 +.mk ##
51.591 +.nr ## -1v
51.592 +.ls 1
51.593 +.ls
51.594 +..
51.595 +.ec
51.596 +.ta \n(80u \n(81u
51.597 +.nr 31 \n(.f
51.598 +.nr 35 1m
51.599 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
51.600 +.ne \n(a|u+\n(.Vu
51.601 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
51.602 +.ta \n(80u \n(81u
51.603 +.nr 31 \n(.f
51.604 +.nr 35 1m
51.605 +\&\h'|\n(40u'\f3\-d <directory> \fP\h'|\n(41u'
51.606 +.mk ##
51.607 +.nr 31 \n(##
51.608 +.sp |\n(##u-1v
51.609 +.nr 37 \n(41u
51.610 +.in +\n(37u
51.611 +.a+
51.612 +.in -\n(37u
51.613 +.mk 32
51.614 +.if \n(32>\n(31 .nr 31 \n(32
51.615 +.sp |\n(31u
51.616 +.ne \n(b|u+\n(.Vu
51.617 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
51.618 +.ta \n(80u \n(81u
51.619 +.nr 31 \n(.f
51.620 +.nr 35 1m
51.621 +\&\h'|\n(40u'\f3\-b <path> \fP\h'|\n(41u'
51.622 +.mk ##
51.623 +.nr 31 \n(##
51.624 +.sp |\n(##u-1v
51.625 +.nr 37 \n(41u
51.626 +.in +\n(37u
51.627 +.b+
51.628 +.in -\n(37u
51.629 +.mk 32
51.630 +.if \n(32>\n(31 .nr 31 \n(32
51.631 +.sp |\n(31u
51.632 +.ne \n(c|u+\n(.Vu
51.633 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
51.634 +.ta \n(80u \n(81u
51.635 +.nr 31 \n(.f
51.636 +.nr 35 1m
51.637 +\&\h'|\n(40u'\f3\-B <jaxbOption>\fP\h'|\n(41u'
51.638 +.mk ##
51.639 +.nr 31 \n(##
51.640 +.sp |\n(##u-1v
51.641 +.nr 37 \n(41u
51.642 +.in +\n(37u
51.643 +.c+
51.644 +.in -\n(37u
51.645 +.mk 32
51.646 +.if \n(32>\n(31 .nr 31 \n(32
51.647 +.sp |\n(31u
51.648 +.ne \n(d|u+\n(.Vu
51.649 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
51.650 +.ta \n(80u \n(81u
51.651 +.nr 31 \n(.f
51.652 +.nr 35 1m
51.653 +\&\h'|\n(40u'\f3\-catalog\fP\h'|\n(41u'
51.654 +.mk ##
51.655 +.nr 31 \n(##
51.656 +.sp |\n(##u-1v
51.657 +.nr 37 \n(41u
51.658 +.in +\n(37u
51.659 +.d+
51.660 +.in -\n(37u
51.661 +.mk 32
51.662 +.if \n(32>\n(31 .nr 31 \n(32
51.663 +.sp |\n(31u
51.664 +.ne \n(e|u+\n(.Vu
51.665 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
51.666 +.ta \n(80u \n(81u
51.667 +.nr 31 \n(.f
51.668 +.nr 35 1m
51.669 +\&\h'|\n(40u'\f3\-extension \fP\h'|\n(41u'
51.670 +.mk ##
51.671 +.nr 31 \n(##
51.672 +.sp |\n(##u-1v
51.673 +.nr 37 \n(41u
51.674 +.in +\n(37u
51.675 +.e+
51.676 +.in -\n(37u
51.677 +.mk 32
51.678 +.if \n(32>\n(31 .nr 31 \n(32
51.679 +.sp |\n(31u
51.680 +.ne \n(f|u+\n(.Vu
51.681 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
51.682 +.ta \n(80u \n(81u
51.683 +.nr 31 \n(.f
51.684 +.nr 35 1m
51.685 +\&\h'|\n(40u'\f3\-help \fP\h'|\n(41u'
51.686 +.mk ##
51.687 +.nr 31 \n(##
51.688 +.sp |\n(##u-1v
51.689 +.nr 37 \n(41u
51.690 +.in +\n(37u
51.691 +.f+
51.692 +.in -\n(37u
51.693 +.mk 32
51.694 +.if \n(32>\n(31 .nr 31 \n(32
51.695 +.sp |\n(31u
51.696 +.ne \n(g|u+\n(.Vu
51.697 +.ne \n(h|u+\n(.Vu
51.698 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
51.699 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
51.700 +.ta \n(80u \n(81u
51.701 +.nr 31 \n(.f
51.702 +.nr 35 1m
51.703 +\&\h'|\n(40u'\h'|\n(41u'
51.704 +.mk ##
51.705 +.nr 31 \n(##
51.706 +.sp |\n(##u-1v
51.707 +.nr 37 \n(40u
51.708 +.in +\n(37u
51.709 +.g+
51.710 +.in -\n(37u
51.711 +.mk 32
51.712 +.if \n(32>\n(31 .nr 31 \n(32
51.713 +.sp |\n(##u-1v
51.714 +.nr 37 \n(41u
51.715 +.in +\n(37u
51.716 +.h+
51.717 +.in -\n(37u
51.718 +.mk 32
51.719 +.if \n(32>\n(31 .nr 31 \n(32
51.720 +.sp |\n(31u
51.721 +.ne \n(i|u+\n(.Vu
51.722 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
51.723 +.ta \n(80u \n(81u
51.724 +.nr 31 \n(.f
51.725 +.nr 35 1m
51.726 +\&\h'|\n(40u'\f3\-keep \fP\h'|\n(41u'
51.727 +.mk ##
51.728 +.nr 31 \n(##
51.729 +.sp |\n(##u-1v
51.730 +.nr 37 \n(41u
51.731 +.in +\n(37u
51.732 +.i+
51.733 +.in -\n(37u
51.734 +.mk 32
51.735 +.if \n(32>\n(31 .nr 31 \n(32
51.736 +.sp |\n(31u
51.737 +.ne \n(j|u+\n(.Vu
51.738 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
51.739 +.ta \n(80u \n(81u
51.740 +.nr 31 \n(.f
51.741 +.nr 35 1m
51.742 +\&\h'|\n(40u'\f3\-p \fP\h'|\n(41u'
51.743 +.mk ##
51.744 +.nr 31 \n(##
51.745 +.sp |\n(##u-1v
51.746 +.nr 37 \n(41u
51.747 +.in +\n(37u
51.748 +.j+
51.749 +.in -\n(37u
51.750 +.mk 32
51.751 +.if \n(32>\n(31 .nr 31 \n(32
51.752 +.sp |\n(31u
51.753 +.ne \n(k|u+\n(.Vu
51.754 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
51.755 +.ta \n(80u \n(81u
51.756 +.nr 31 \n(.f
51.757 +.nr 35 1m
51.758 +\&\h'|\n(40u'\f3\-s <directory> \fP\h'|\n(41u'
51.759 +.mk ##
51.760 +.nr 31 \n(##
51.761 +.sp |\n(##u-1v
51.762 +.nr 37 \n(41u
51.763 +.in +\n(37u
51.764 +.k+
51.765 +.in -\n(37u
51.766 +.mk 32
51.767 +.if \n(32>\n(31 .nr 31 \n(32
51.768 +.sp |\n(31u
51.769 +.ne \n(l|u+\n(.Vu
51.770 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
51.771 +.ta \n(80u \n(81u
51.772 +.nr 31 \n(.f
51.773 +.nr 35 1m
51.774 +\&\h'|\n(40u'\f3\-verbose \fP\h'|\n(41u'
51.775 +.mk ##
51.776 +.nr 31 \n(##
51.777 +.sp |\n(##u-1v
51.778 +.nr 37 \n(41u
51.779 +.in +\n(37u
51.780 +.l+
51.781 +.in -\n(37u
51.782 +.mk 32
51.783 +.if \n(32>\n(31 .nr 31 \n(32
51.784 +.sp |\n(31u
51.785 +.ne \n(m|u+\n(.Vu
51.786 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
51.787 +.ta \n(80u \n(81u
51.788 +.nr 31 \n(.f
51.789 +.nr 35 1m
51.790 +\&\h'|\n(40u'\f3\-version \fP\h'|\n(41u'
51.791 +.mk ##
51.792 +.nr 31 \n(##
51.793 +.sp |\n(##u-1v
51.794 +.nr 37 \n(41u
51.795 +.in +\n(37u
51.796 +.m+
51.797 +.in -\n(37u
51.798 +.mk 32
51.799 +.if \n(32>\n(31 .nr 31 \n(32
51.800 +.sp |\n(31u
51.801 +.ne \n(n|u+\n(.Vu
51.802 +.ne \n(o|u+\n(.Vu
51.803 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
51.804 +.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
51.805 +.ta \n(80u \n(81u
51.806 +.nr 31 \n(.f
51.807 +.nr 35 1m
51.808 +\&\h'|\n(40u'\h'|\n(41u'
51.809 +.mk ##
51.810 +.nr 31 \n(##
51.811 +.sp |\n(##u-1v
51.812 +.nr 37 \n(40u
51.813 +.in +\n(37u
51.814 +.n+
51.815 +.in -\n(37u
51.816 +.mk 32
51.817 +.if \n(32>\n(31 .nr 31 \n(32
51.818 +.sp |\n(##u-1v
51.819 +.nr 37 \n(41u
51.820 +.in +\n(37u
51.821 +.o+
51.822 +.in -\n(37u
51.823 +.mk 32
51.824 +.if \n(32>\n(31 .nr 31 \n(32
51.825 +.sp |\n(31u
51.826 +.ne \n(p|u+\n(.Vu
51.827 +.if (\n(p|+\n(#^-1v)>\n(#- .nr #- +(\n(p|+\n(#^-\n(#--1v)
51.828 +.ta \n(80u \n(81u
51.829 +.nr 31 \n(.f
51.830 +.nr 35 1m
51.831 +\&\h'|\n(40u'\f3\-target \fP\h'|\n(41u'
51.832 +.mk ##
51.833 +.nr 31 \n(##
51.834 +.sp |\n(##u-1v
51.835 +.nr 37 \n(41u
51.836 +.in +\n(37u
51.837 +.p+
51.838 +.in -\n(37u
51.839 +.mk 32
51.840 +.if \n(32>\n(31 .nr 31 \n(32
51.841 +.sp |\n(31u
51.842 +.ne \n(q|u+\n(.Vu
51.843 +.if (\n(q|+\n(#^-1v)>\n(#- .nr #- +(\n(q|+\n(#^-\n(#--1v)
51.844 +.ta \n(80u \n(81u
51.845 +.nr 31 \n(.f
51.846 +.nr 35 1m
51.847 +\&\h'|\n(40u'\f3\-quiet \fP\h'|\n(41u'
51.848 +.mk ##
51.849 +.nr 31 \n(##
51.850 +.sp |\n(##u-1v
51.851 +.nr 37 \n(41u
51.852 +.in +\n(37u
51.853 +.q+
51.854 +.in -\n(37u
51.855 +.mk 32
51.856 +.if \n(32>\n(31 .nr 31 \n(32
51.857 +.sp |\n(31u
51.858 +.fc
51.859 +.nr T. 1
51.860 +.T# 1
51.861 +.35
51.862 +.rm a+
51.863 +.rm b+
51.864 +.rm c+
51.865 +.rm d+
51.866 +.rm e+
51.867 +.rm f+
51.868 +.rm g+
51.869 +.rm h+
51.870 +.rm i+
51.871 +.rm j+
51.872 +.rm k+
51.873 +.rm l+
51.874 +.rm m+
51.875 +.rm n+
51.876 +.rm o+
51.877 +.rm p+
51.878 +.rm q+
51.879 .TE
51.880 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-54
51.881 -
51.882 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-72
51.883 .LP
51.884 +\f2\-b\fP 激с潟篏帥c茲違 JAX\-WS JAXB ゃ潟c潟違<ゃ絎с障 <ゃ篏帥c宴若後 Bean 障障鴻帥ゃ冴純с JAX\-WS JAXB ゃ潟c潟違<ゃ荅括完
51.885 +.na
51.886 +\f2鴻帥ゃ冴ャ≪\fP @
51.887 +.fi
51.888 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlс
51.889 .LP
51.890 -\f2\-b\fP オプションを使って、複数の JAX-WS および JAXB バインディングファイルを指定できます。
51.891 -これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。
51.892 -JAX-WS および JAXB バインディングファイルの詳細については、カスタマイズマニュアルを参照してください。
51.893 -.br
51.894 -
51.895 -.LP
51.896 -.SS
51.897 -Ant タスク
51.898 -.LP
51.899 -.LP
51.900 -\f2wsimport\fP ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
51.901 -.br
51.902 -
51.903 -.LP
51.904 +.SH "箴"
51.905 .nf
51.906 \f3
51.907 .fl
51.908 - <wsimport
51.909 +\fP\f3wsimport \-p stockquote http://stockquote.xyz/quote?wsdl\fP
51.910 .fl
51.911 - wsdl="..."
51.912 -.fl
51.913 - destdir="directory for generated class files"
51.914 -.fl
51.915 - sourcedestdir="directory for generated source files"
51.916 -.fl
51.917 - keep="true|false"
51.918 -.fl
51.919 - extension="true|false"
51.920 -.fl
51.921 - verbose="true|false"
51.922 -.fl
51.923 - version="true|false"
51.924 -.fl
51.925 - wsdlLocation="..."
51.926 -.fl
51.927 - catalog="catalog file"
51.928 -.fl
51.929 - package="package name"
51.930 -.fl
51.931 - <binding dir="..." includes="..." />
51.932 -.fl
51.933 - </wsimport>
51.934 -.fl
51.935 -\fP
51.936 .fi
51.937 -
51.938 .LP
51.939 -.LP
51.940 -.TS
51.941 -center;
51.942 -cbp-1 cbp-1 cbp-1
51.943 -li l l
51.944 -li l li.
51.945 -属性 説明 コマンド行
51.946 -_
51.947 -wsdl WSDL file WSDL
51.948 -destdir 生成される出力クラスを格納する場所を指定します -d
51.949 -sourcedestdir T{
51.950 -生成されたソースファイルの格納場所を指定します。このオプションの指定時には keep もオンになります。
51.951 -T} -s
51.952 -keep T{
51.953 -生成されたファイルを保持します。sourcedestdir オプション指定時にオンになります
51.954 -T} -keep
51.955 -verbose T{
51.956 -コンパイラが実行している処理に関するメッセージを出力します
51.957 -T} -verbose
51.958 -binding T{
51.959 -外部の JAX-WS または JAXB バインディングファイルを指定します
51.960 -T} -b
51.961 -extension T{
51.962 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
51.963 -T} -extension
51.964 -wsdllocation T{
51.965 -このオプション経由 で 渡 さ れたWSDL の URI は、生 成 された SEIおよびサービスインタフェース上の@WebService.wsdlLocationお よ び@WebServiceClient.wsdlLocation注釈要素の値を設定するために使用されます。
51.966 -T} -wsdllocation
51.967 -catalog T{
51.968 -外部エンティティ参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。さらに、Ant xmlcatalog タイプを使ってエンティティを解決することもできます。wsimport_catalog サンプルを参照してください。
51.969 -T} -catalog
51.970 -package ターゲットパッケージを指定します -p
51.971 -.TE
51.972 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
51.973 -
51.974 -.LP
51.975 -.LP
51.976 -\f2binding\fP 属性は、
51.977 -.na
51.978 -\f2Path\-like Structures\fP
51.979 -.fi
51.980 -(http://ant.apache.org/manual/using.html#path) であり、それぞれ入れ子になった \f2<binding>\fP 要素を使って設定することもできます。このタスクを使用するには、次の \f2<taskdef>\fP 要素をプロジェクトに追加しておく必要があります。
51.981 -.LP
51.982 -.nf
51.983 -\f3
51.984 -.fl
51.985 - <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">
51.986 -.fl
51.987 - <classpath path="jaxws.classpath"/>
51.988 -.fl
51.989 - </taskdef>
51.990 -.fl
51.991 -\fP
51.992 -.fi
51.993 -
51.994 -.LP
51.995 -.LP
51.996 -ここで、\f2jaxws.classpath\fP は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された
51.997 -.na
51.998 -\f2Path\-like Structure\fP
51.999 -.fi
51.1000 -(http://ant.apache.org/manual/using.html#path) への参照です。
51.1001 -.LP
51.1002 -.SH "例"
51.1003 -.LP
51.1004 -.nf
51.1005 -\f3
51.1006 -.fl
51.1007 - <wsimport
51.1008 -.fl
51.1009 - destdir="${build.classes.home}"
51.1010 -.fl
51.1011 - debug="true"
51.1012 -.fl
51.1013 - wsdl="AddNumbers.wsdl"
51.1014 -.fl
51.1015 - binding="custom.xml"/>
51.1016 -.fl
51.1017 -\fP
51.1018 -.fi
51.1019 -
51.1020 -.LP
51.1021 -.LP
51.1022 -上の例では、\f2AddNumbers.wsdl\fP のクライアント側アーティファクトを生成し、\f2custom.xml\fP カスタマイズファイルに基づいて \f2${build.classes.home}\fP ディレクトリ内に \f2.class\fP ファイルを格納しています。使用されるクラスパスは \f2xyz.jar\fP であり、デバッグ情報がオンの状態でコンパイルが実行されます。
51.1023 -.LP
51.1024 -.nf
51.1025 -\f3
51.1026 -.fl
51.1027 - <wsimport
51.1028 -.fl
51.1029 - keep="true"
51.1030 -.fl
51.1031 - sourcedestdir="${source.dir}"
51.1032 -.fl
51.1033 - destdir="${build.classes.home}"
51.1034 -.fl
51.1035 - wsdl="AddNumbers.wsdl">
51.1036 -.fl
51.1037 - <binding dir="${basedir}/etc" includes="custom.xml"/>
51.1038 -.fl
51.1039 - </wsimport>
51.1040 -.fl
51.1041 -\fP
51.1042 -.fi
51.1043 -
51.1044 -.LP
51.1045 -.LP
51.1046 -上の例では、\f2AddNumbers.wsdl\fP のポータブルアーティファクトを生成し、\f2${source.dir}\fP ディレクトリ内に \f2.java\fP ファイルを格納し、\f2${build.classes.home}\fP ディレクトリ内に \f2.class\fP ファイルを格納しています。
51.1047 -.LP
51.1048 -.SH "注意"
51.1049 -.LP
51.1050 -.LP
51.1051 -変更または削除された wsimport の Ant 属性の概要
51.1052 -.LP
51.1053 -\f3base\fP が \f3destdir\fP で置き換えられました
51.1054 +Java ≪若c<\f2http://stockquote.xyz/quote?wsdl\fP ゃ潟若с≪若c<潟潟ゃ障
51.1055 .br
51.1056 -
51.1057 -.LP
51.1058 -.br
51.1059 -
51.1060 -.LP
51.1061 -\f3sourceBase\fP が \f3sourcedestdir\fP で置き換えられました
51.1062 -.br
51.1063 -
51.1064 -.LP
51.1065 -.br
51.1066 -
51.1067 -.LP
51.1068 -\f3wsdlFile\fP が \f3wsdl\fP で置き換えられました
51.1069 -.br
51.1070 -.br
51.1071 -\f3httpProxy\fP が削除されました。代わりに、Ant の setproxy タスクを使ってプロキシ構成を行ってください。
51.1072 -.br
51.1073 -.br
51.1074 -\f3version\fP が削除されました
51.1075 -.br
51.1076 -
51.1077 -.LP
51.1078 -
51.1079 -.LP
51.1080
52.1 --- a/src/linux/doc/man/ja/xjc.1 Tue May 12 15:21:55 2009 +0900
52.2 +++ b/src/linux/doc/man/ja/xjc.1 Thu May 14 00:17:25 2009 -0700
52.3 @@ -1,5 +1,3 @@
52.4 -.'" t
52.5 -."
52.6 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
52.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
52.8 ."
52.9 @@ -20,68 +18,43 @@
52.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
52.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
52.12 ." have any questions.
52.13 -."
52.14 -." `
52.15 -.TH xjc 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
52.16 -." Generated by html2roff
52.17 +."
52.18 +.TH xjc 1 "04 May 2009"
52.19 +." Generated from HTML by html2man (author: Eric Armstrong)
52.20
52.21 .LP
52.22 .ad c
52.23 -.SH 名前
52.24 -XML バインドのための Java(TM) アーキテクチャ
52.25 +.SH ""
52.26 +xjc \- XML ゃ潟 Java(TM) ≪若c
52.27 .br
52.28 -バインドコンパイラ (xjc) \f3仕様のバージョン:\fP 2.0
52.29 +ゃ潟c潟違潟潟ゃ
52.30 +.LP
52.31 +\f3篁罕若吾с:\fP 2.1
52.32 .br
52.33 -\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
52.34 -.br
52.35 -JAXB 2.0: リリースノート | XJC | XJCTask | SchemaGen | schemagenTask | サンプルアプリケーション | Changelog
52.36 -.br
52.37 -JAXB 1.0.x: リリースノート | Changelog
52.38 -.br
52.39 -JAXB RI 拡張: 実行時プロパティ | XJC カスタマイズ | プラグイン開発
52.40 -.br
52.41 -JAXB RI スキーマ言語: W3C XML スキーマ | RELAX NG | DTD
52.42 -.br
52.43 -JAXB コミュニティ:
52.44 -.na
52.45 -\f2Java.net ホームページ\fP @
52.46 -.fi
52.47 -http://jaxb.dev.java.net | Developer interest list | FAQ
52.48 -.br
52.49 -.ad l
52.50 +\f3<潟劫茖 (RI) 若吾с:\fP 2.1.3 .ad l
52.51
52.52 .LP
52.53 -.SS
52.54 -xjc の起動
52.55 +.SH "xjc 莎桁"
52.56 .LP
52.57 .LP
52.58 -バインディングコンパイラを起動するには、使用するプラットフォームに応じた \f2bin\fP ディレクトリ内の \f2xjc\fP シェルスクリプトを使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。xjc を Ant とともに使用するための手順を参照してください。
52.59 +ゃ潟c潟違潟潟ゃ莎桁篏睡若綽 \f2bin\fP c \f2xjc\fP 激с鴻篏睡障障ゃ潟c潟違潟潟ゃ絎茵 Ant 帥鴻障
52.60 +.na
52.61 +\f2xjc Ant 篏睡\fP @
52.62 +.fi
52.63 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlс
52.64 .LP
52.65 .RS 3
52.66
52.67 .LP
52.68 -\f3Solaris/Linux の場合\fP
52.69 .LP
52.70 -
52.71 -.LP
52.72 -.LP
52.73 - \f2% /path/to/jaxb/bin/xjc.sh \-help\fP
52.74 -.LP
52.75 -\f3WindowsNT/2000/XP の場合\fP
52.76 -.LP
52.77 -
52.78 -.LP
52.79 -.LP
52.80 - \f2> c:\\path\\to\\jaxb\\bin\\xjc.bat \-help\fP
52.81 +\f2% xjc \-help\fP
52.82 .LP
52.83 .RE
52.84 +\f3阪\fP
52.85 +.LP
52.86 .RS 3
52.87
52.88 .LP
52.89 -\f3出力\fP
52.90 -.LP
52.91 -
52.92 -.LP
52.93 .nf
52.94 \f3
52.95 .fl
52.96 @@ -95,7 +68,9 @@
52.97 .fl
52.98 Compatibility Rules and App E.2 from the JAXB Spec
52.99 .fl
52.100 - \-b <file> : specify external bindings files (each <file> must have its own \-b)
52.101 + \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
52.102 +.fl
52.103 + If a directory is given, **/*.xjb is searched
52.104 .fl
52.105 \-d <dir> : generated files will go into this directory
52.106 .fl
52.107 @@ -115,6 +90,10 @@
52.108 .fl
52.109 \-npa : suppress generation of package level annotations (**/package\-info.java)
52.110 .fl
52.111 + \-no\-header : suppress generation of a file header with timestamp
52.112 +.fl
52.113 + \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
52.114 +.fl
52.115 \-xmlschema : treat input as W3C XML Schema (default)
52.116 .fl
52.117 \-relaxng : treat input as RELAX NG (experimental,unsupported)
52.118 @@ -135,49 +114,23 @@
52.119 .fl
52.120 \fP
52.121 .fi
52.122 +.RE
52.123
52.124 .LP
52.125 -.RE
52.126 -.RS 3
52.127 -
52.128 -.LP
52.129 -\f3jaxb\-xjc.jar JAR ファイルの実行\fP
52.130 +.SH "激с"
52.131 .LP
52.132
52.133 .LP
52.134 -.LP
52.135 -ほかの方法がすべて失敗した場合でも、\f2jaxb\-xjc.jar\fP ファイルの実行は行えるはずです。
52.136 -.LP
52.137 .RS 3
52.138 -
52.139 -.LP
52.140 -.TP 3
52.141 -Solaris/Linux の場合:
52.142 -\f2% java \-jar $JAXB_HOME/lib/jaxb\-xjc.jar \-help\fP
52.143 -.TP 3
52.144 -Windows の場合:
52.145 -\f2> java \-jar %JAXB_HOME%\\lib\\jaxb\-xjc.jar \-help\fP
52.146 -.LP
52.147 -.RE
52.148 -.LP
52.149 -これは「xjc.sh」や「xjc.bat」を実行するのと同じです。また、この場合、JVM パラメータを設定できます。
52.150 -.LP
52.151 -.RE
52.152 -.SS
52.153 -コマンド行オプションの概要
52.154 -.LP
52.155 -
52.156 -.LP
52.157 .TP 3
52.158 \-nv
52.159 -デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
52.160 +сXJC ゃ潟c潟違潟潟ゃ純若鴻鴻若ウ絲罎荐若絎茵障激с潟篏睡ウ絲鴻若罎荐若≦鴻障ゃ潟c潟違潟潟ゃ罎荐若筝絎茵с障 ウ絲с罎荐若絎茵с
52.161 .TP 3
52.162 \-extension
52.163 -デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
52.164 +сXJC ゃ潟c潟違潟潟ゃJAXB 篁罕Compatibility腴ц荀ウ絲綣桁吟障篁 E.2 JAXB v1.0 у泣若筝c W3C XML 鴻若罘純絎臂障 翫c鴻ゃф鴻\-extension≪若с罘純篏睡с障障ウ絲≪若с篁罕絎臂ゃ潟c潟違鴻帥ゃ冴帥篏睡с障\-extension鴻ゃ絎違JAXB Vendor Extension 篏睡с障
52.165 .TP 3
52.166 \-b <file>
52.167 -処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに\f2「\-b」\fPスイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる
52.168 -1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。
52.169 +紊ゃ潟c潟違<ゃ 1 ゃ障茲井絎障(ゃ潟c潟違<ゃ\f2\-b\fP鴻ゃ絎綽荀障)紊ゃ潟c潟違<ゃ罕絽吾荵с茲違鴻若鴻帥ゃ冴障 1 ゃゃ潟c潟違<ゃ篏睡鴻帥ゃ冴茲違ゃ潟c潟違<ゃ蚊с障 罨<箴腓冴障
52.170 .RS 3
52.171
52.172 .LP
52.173 @@ -185,142 +138,151 @@
52.174 .br
52.175 \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
52.176 .RE
52.177 -また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
52.178 +障潟潟茵鴻若<ゃゃ潟c潟違<ゃ絎篁紙с
52.179 .TP 3
52.180 \-d <dir>
52.181 -デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
52.182 +сXJC ゃ潟c潟違潟潟ゃJava 潟潟潟鴻憜c障激с潟篏睡篁f水阪c絎с障阪c絖綽荀障 XJC ゃ潟c潟違潟潟ゃc篏障
52.183 .TP 3
52.184 \-p <pkg>
52.185 -このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
52.186 +潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻ゃ潟c潟違鴻帥ゃ冴篁罕ц鎘宴若後≪眼冴障
52.187 .TP 3
52.188 \-httpproxy <proxy>
52.189 -HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
52.190 +HTTP/HTTPS 激絎障綵√ [user[:password]@]proxyHost[:proxyPort] с緇ャ \f2\-host\fP \f2\-port\fP 筝篏篋с<潟劫茖с泣若障ィ絅障激с潟ф絎鴻若\f2top\fP 潟潟篏睡若吟若祉若吟若茵腓冴с綣違с羈祉ャc若蕭罨< \f2\-httpproxyfile\fP 篏睡
52.191 .TP 3
52.192 \-httpproxyfile <file>
52.193 -HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
52.194 +HTTP/HTTPS 激<ゃ腟宴ф絎障綵√筝荐с<ゃ絎鴻若祉若吟若茵腓冴с障
52.195 .TP 3
52.196 \-classpath <arg>
52.197 -\f2<jxb:javaType>\fP および \f2<xjc:superClass>\fP カスタマイズが使用するクライアントアプリケーションのクラスファイルの検索場所を指定します。
52.198 +\f2<jxb:javaType>\fP \f2<xjc:superClass>\fP 鴻帥ゃ冴篏睡ゃ≪潟≪宴若激с潟鴻<ゃ罎膣√贋絎障
52.199 .TP 3
52.200 \-catalog <file>
52.201 -外部エンティティー参照を解決するカタログファイルを指定します。
52.202 -TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。
52.203 -詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、
52.204 -カタログリゾルバのサンプルアプリケーションを調べてください。
52.205 +紊潟cc弱с茹f浦帥違<ゃ絎障TR9401XCatalog OASIS XML Catalog 綵√泣若障荅括完XML Entity and URI Resolversャ<潟с\f2帥違障\fP泣潟≪宴若激с潟茯帥鴻
52.206 .TP 3
52.207 \-readOnly
52.208 -デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
52.209 +сXJC ゃ潟c潟違潟潟ゃ Java 純若鴻<ゃ吾莨若帥篆茘激障激с潟篏睡XJC ゃ潟c潟違潟潟ゃ Java 純若鴻綣桁句茯水絨障
52.210 .TP 3
52.211 \-npa
52.212 -パッケージレベルの注釈を
52.213 -.B **/package-info.java
52.214 -に生成することを抑制します。
52.215 -このスイッチを使用して生成するコードでは、これらの注釈が
52.216 -ほかの生成済みクラスに内部化されます。
52.217 +宴若吾羈 **/package\-info.java 吟障鴻ゃ篏睡潟若с羈祉羝帥鴻障
52.218 +.TP 3
52.219 +\-no\-header
52.220 +紊絨<≪帥ゃ鴻帥潟<ゃ若潟<潟吟障激с潟篏睡潟若障
52.221 +.TP 3
52.222 +\-target 2.0
52.223 + JAXB 2.1 罘純箴絖潟若障潟若 JAXB 2.0 潟帥ゃ (JavaSE 6 ) у茵с障
52.224 .TP 3
52.225 \-xmlschema
52.226 -入力スキーマを W3C XML スキーマ (デフォルト) と見なします。
52.227 -このスイッチを指定しなくても、入力スキーマは
52.228 -W3C XML スキーマと見なされます。
52.229 +ュ鴻若 W3C XML 鴻若 () 荀障鴻ゃ絎ュ鴻若 W3C XML 鴻若荀障
52.230 .TP 3
52.231 \-relaxng
52.232 -入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
52.233 +ュ鴻若 RELAX NG 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
52.234 .TP 3
52.235 \-relaxng\-compact
52.236 -入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
52.237 +ュ鴻若 RELAX NG х軒罕障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
52.238 .TP 3
52.239 \-dtd
52.240 -入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
52.241 +ュ鴻若 XML DTD 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
52.242 .TP 3
52.243 \-wsdl
52.244 -入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
52.245 +ュ WSDL 宴鴻若潟潟ゃ障 (荅薑泣若)
52.246 .TP 3
52.247 \-quiet
52.248 -進捗や警告など、コンパイラの出力を抑制します。
52.249 +我宴茘潟潟ゃ阪吟障
52.250 .TP 3
52.251 \-verbose
52.252 -情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
52.253 +宴<祉若吾阪劫主榊鴻帥若鴻茵腓冴罐泣激障
52.254 .TP 3
52.255 \-help
52.256 -コンパイラスイッチの概要を表示します。
52.257 +潟潟ゃ鴻ゃ网荀茵腓冴障
52.258 .TP 3
52.259 \-version
52.260 -コンパイラのバージョン情報を表示します。
52.261 +潟潟ゃ若吾с恰宴茵腓冴障
52.262 .TP 3
52.263 <schema file/URL/dir>
52.264 -コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
52.265 +潟潟ゃ絲乗院 1 ゃ障茲違鴻若<ゃ絎障若吟若c絎翫xjc c莎井祉цゃc鴻鴻若<ゃ潟潟ゃ障
52.266 +.RE
52.267 .SS
52.268 -非推奨コマンド行オプションおよび削除されたコマンド行オプションの概要
52.269 +ィ絅潟潟茵激с潟喝ゃ潟潟茵激с潟网荀
52.270 .LP
52.271 +.RS 3
52.272
52.273 .LP
52.274 +.RS 3
52.275 .TP 3
52.276 \-host & \-port
52.277 -これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
52.278 +激с潟ィ絅\f3\-httpproxy\fP 激с潟х舟障激с潟筝篏篋с腆坂у膓泣若障ャ<潟荐莠絨ャ若鴻уゃ醇с障
52.279 .TP 3
52.280 \-use\-runtime
52.281 -JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
52.282 +JAXB 2.0 篁罕хЩ罎с潟帥ゃ荀鎘JAXB RI **/impl/runtime 宴若吾綽荀障鴻ゃ筝荀ゃ障
52.283 .TP 3
52.284 \-source
52.285 -\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。我々は、JAXB 2.0 の今後のリリースからこのスイッチを削除することにしました。1.0.x コードを生成する必要がある場合には、1.0.x コードベースのインストールを使用してください。
52.286 +\-source 篋с鴻ゃJAXB 2.0 Early Access уャ障鴻ゃJAXB 2.0 篁緇若鴻ゃ障1.0.x 潟若綽荀翫1.0.x 潟若若鴻ゃ潟鴻若篏睡
52.287 .TP 3
52.288 \-Xlocator & \-Xsync\-methods
52.289 -これらのスイッチは現時点では無効化されています。この機能は将来、個別のダウンロードとして提供される予定です。
52.290 +鴻ゃ憝鴻с≦劫障罘純絨ャャ潟若箴篋絎с
52.291 +.RE
52.292 +
52.293 .LP
52.294 +.RE
52.295 .SS
52.296 -コンパイラの制限
52.297 +潟潟ゃ狗
52.298 .LP
52.299 .LP
52.300 -通常は、関連するスキーマは、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
52.301 +絽吾∫c鴻鴻若ゃ潟c潟違潟潟ゃ鴻ゃ絎 1 ゃ篏潟潟ゃc絎с
52.302 .LP
52.303 .LP
52.304 -.B xjc
52.305 -を実行するときは、次に示す制限に注意してください。
52.306 -これらの制限のほとんどは、
52.307 -.B xjc
52.308 -を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
52.309 +xjc 絎茵罨<腓冴狗羈狗祉xjc 篏綺若喝冴茲違鴻若潟潟ゃ翫翠障
52.310 .LP
52.311 .RS 3
52.312 .TP 2
52.313 -*
52.314 -複数のスキーマを同時にコンパイルする場合は、
52.315 -ターゲットの Java パッケージ名に次の優先順位の規則が
52.316 -適用されることに注意してください。
52.317 +o
52.318 +茲違鴻若潟潟ゃ翫帥若蚊 Java 宴若後罨<篏荀羈
52.319 .RS 3
52.320 .TP 3
52.321 1.
52.322 -「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
52.323 +\f2\-p\fP潟潟茵激с潟c障
52.324 .TP 3
52.325 2.
52.326 -<\f2jaxb:package\fP> のカスタマイズ
52.327 +<\f2jaxb:package\fP> 鴻帥ゃ
52.328 .TP 3
52.329 3.
52.330 -\f2targetNamespace\fP が宣言されている場合は、仕様に定義されている \f2targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
52.331 +\f2targetNamespace\fP 絎h翫篁罕絎臂 \f2targetNamespace\fP \-> Java 宴若後≪眼冴障
52.332 .TP 3
52.333 4.
52.334 -\f2targetNamespace\fP が宣言されていない場合は、"generated" という名前のハードコードされたパッケージを使用します。
52.335 +\f2targetNamespace\fP 絎h翫"generated" 若潟若宴若吾篏睡障
52.336 .RE
52.337 .TP 2
52.338 -*
52.339 -名前空間ごとに複数の
52.340 -.B <jaxb:schemaBindings>
52.341 -を持つことは不正です。このため、1 つのターゲット名前空間内の
52.342 -2 つのスキーマを、異なる Java パッケージにコンパイルすることはできません。
52.343 +o
52.344 +腥咲茲違 <\f2jaxb:schemaBindings\fP> ゃ筝罩cс 1 ゃ帥若蚊腥咲 2 ゃ鴻若違 Java 宴若吾潟潟ゃс障
52.345 .TP 2
52.346 -*
52.347 -1 つの Java パッケージにコンパイルされるすべてのスキーマは、
52.348 -XJC バインディングコンパイラに同時に送信する必要があります。
52.349 -個別にコンパイルすることはできず、 予期したとおりに動作しません。
52.350 +o
52.351 +1 ゃ Java 宴若吾潟潟ゃ鴻鴻若XJC ゃ潟c潟違潟潟ゃ篆<綽荀障 ャ潟潟ゃс篋篏障
52.352 .TP 2
52.353 -*
52.354 -複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
52.355 +o
52.356 +茲違鴻若<ゃ障荀膣臀違若潟潟ゃ綽荀障
52.357 .RE
52.358
52.359 .LP
52.360 +.SH "∫i"
52.361 +.LP
52.362 +.RS 3
52.363 +.TP 2
52.364 +o
52.365 +潟潟茵с潟潟若帥絎茵 (XJC):[
52.366 +.na
52.367 +\f2潟潟茵巡擦\fP @
52.368 +.fi
52.369 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html
52.370 +.na
52.371 +\f2xjc Ant 篏睡\fP @
52.372 +.fi
52.373 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
52.374 +.TP 2
52.375 +o
52.376 +.na
52.377 +\f2XML ゃ潟 JavaTM ≪若c (JAXB)\fP @
52.378 +.fi
52.379 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
52.380 +.RE
52.381
52.382 .LP
52.383 -$Revision: 1.4 $
52.384 -.br
52.385 -$Date: 2005/10/27 18:53:02 $
52.386 -.LP
52.387
53.1 --- a/src/linux/doc/man/jar.1 Tue May 12 15:21:55 2009 +0900
53.2 +++ b/src/linux/doc/man/jar.1 Thu May 14 00:17:25 2009 -0700
53.3 @@ -1,6 +1,4 @@
53.4 -.'" t
53.5 -."
53.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
53.7 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
53.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
53.9 ."
53.10 ." This code is free software; you can redistribute it and/or modify it
53.11 @@ -21,15 +19,11 @@
53.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
53.13 ." have any questions.
53.14 ."
53.15 -." `
53.16 -.TH jar 1 "05 Aug 2006"
53.17 -." Generated by html2roff
53.18 -.\\" Created by: Susan Keohan 30\-Oct\-1996
53.19 -.\\" Updated by: Beth Stearns 18\-Nov\-1996
53.20 -.\\" Updated by: Marianne Mueller 11\-Dec\-1996
53.21 -.\\" Updated by: Douglas Kramer 01\-Jul\-2003
53.22 +.TH jar 1 "04 May 2009"
53.23 +." Generated from HTML by html2man (author: Eric Armstrong)
53.24 +
53.25 .LP
53.26 -.SH NAME
53.27 +.SH "Name"
53.28 jar\-The Java Archive Tool
53.29 .LP
53.30 \f3jar\fP combines multiple files into a single JAR archive file.
53.31 @@ -37,6 +31,7 @@
53.32 .LP
53.33
53.34 .LP
53.35 +.RS 3
53.36 .TP 3
53.37 Create jar file
53.38 \f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
53.39 @@ -52,6 +47,8 @@
53.40 .TP 3
53.41 Add index to jar file
53.42 \f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
53.43 +.RE
53.44 +
53.45 .LP
53.46 .LP
53.47 where:
53.48 @@ -59,21 +56,20 @@
53.49 .RS 3
53.50
53.51 .LP
53.52 +.RS 3
53.53 .TP 3
53.54 cuxtiv0Mmfe
53.55 Options that control the \f2jar\fP command.
53.56 .TP 3
53.57 - jarfile
53.58 +jarfile
53.59 Jar file to be created (\f2c\fP), updated (\f2u\fP), extracted (\f2x\fP), or have its table of contents viewed (\f2t\fP). The \f2\-f\fP option and filename \f2jarfile\fP are a pair \-\- if either is present, they must both appear. Note that omitting \f2f\fP and \f2jarfile\fP accepts a "jar file" from standard input (for x and t) or sends the "jar file" to standard output (for c and u).
53.60 .TP 3
53.61 -
53.62 inputfiles
53.63 Files or directories, separated by spaces, to be combined into \f2jarfile\fP (for c and u), or to be extracted (for x) or listed (for t) from \f2jarfile\fP. All directories are processed recursively. The files are compressed unless option \f20\fP (zero) is used.
53.64 .TP 3
53.65 - manifest
53.66 +manifest
53.67 Pre\-existing manifest file whose \f2name\fP\f2:\fP \f2value\fP pairs are to be included in MANIFEST.MF in the jar file. The \f2\-m\fP option and filename \f2manifest\fP are a pair \-\- if either is present, they must both appear. The letters \f3m\fP, \f3f\fP and \f3e\fP must appear in the same order that \f2manifest\fP, \f2jarfile\fP, \f2entrypoint\fP appear.
53.68 .TP 3
53.69 -
53.70 entrypoint
53.71 The name of the class that set as the application entry point for stand\-alone applications bundled into executable jar file. The \f2\-e\fP option and entrypoint are a pair \-\- if either is present, they must both appear. The letters \f3m\fP, \f3f\fP and \f3e\fP must appear in the same order that \f2manifest\fP, \f2jarfile\fP, \f2entrypoint\fP appear.
53.72 .TP 3
53.73 @@ -82,6 +78,8 @@
53.74 .TP 3
53.75 \-Joption
53.76 Option to be passed into the Java runtime environment. (There must be no space between \f2\-J\fP and \f2option\fP).
53.77 +.RE
53.78 +
53.79 .LP
53.80 .RE
53.81 .SH "DESCRIPTION"
53.82 @@ -92,11 +90,7 @@
53.83 .na
53.84 \f2ZLIB\fP @
53.85 .fi
53.86 -http://www.gzip.org/zlib/ compression format. However, \f3jar\fP was designed mainly package java applets or applications into a single archive. When the components of an applet or application (files, images and sounds) are combined into a single archive, they can be downloaded by a java agent (like a browser) in a single HTTP transaction, rather than requiring a new connection for each piece. This dramatically improves download times. \f3jar\fP also compresses files and so further improves download time. In addition, it allows individual entries in a file to be signed by the applet author so that their origin can be authenticated. The syntax for the jar tool is almost identical to the syntax for the \f2tar\fP command. A \f3jar\fP archive can be used as a
53.87 -.na
53.88 -\f2class path\fP @
53.89 -.fi
53.90 -http://ccc.sfbay/4291383/attachment/classpath.html entry, whether or not it is compressed.
53.91 +http://www.gzip.org/zlib/ compression format. However, \f3jar\fP was designed mainly package java applets or applications into a single archive. When the components of an applet or application (files, images and sounds) are combined into a single archive, they can be downloaded by a java agent (like a browser) in a single HTTP transaction, rather than requiring a new connection for each piece. This dramatically improves download times. \f3jar\fP also compresses files and so further improves download time. In addition, it allows individual entries in a file to be signed by the applet author so that their origin can be authenticated. The syntax for the jar tool is almost identical to the syntax for the \f2tar\fP command. A \f3jar\fP archive can be used as a class path entry, whether or not it is compressed.
53.92 .LP
53.93 Typical usage to combine files into a jar file is:
53.94 .LP
53.95 @@ -117,7 +111,7 @@
53.96 .na
53.97 \f2JAR file specification\fP @
53.98 .fi
53.99 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Manifest for details explaining how the jar tool stores meta\-information in the manifest file.
53.100 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest for details explaining how the jar tool stores meta\-information in the manifest file.
53.101 .LP
53.102 If a jar file should include \f2name\ :\ value\fP pairs contained in an existing manifest file, specify that file using the \f2\-m\fP option:
53.103 .LP
53.104 @@ -193,7 +187,7 @@
53.105 .na
53.106 \f2JarIndex\fP @
53.107 .fi
53.108 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Index, which allows application class loaders to load classes more efficiently from jar files. If an application or applet is bundled into multiple jar files,\ only the necessary jar files will be downloaded and opened to load classes. This performance optimization is enabled by running \f2jar\fP with the \f2\-i\fPoption. It will generate package location information for the specified main jar file and all the jar files it depends on, which need to be specified in the \f2Class\-Path\fP attribute of the main jar file's manifest.
53.109 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index, which allows application class loaders to load classes more efficiently from jar files. If an application or applet is bundled into multiple jar files,\ only the necessary jar files will be downloaded and opened to load classes. This performance optimization is enabled by running \f2jar\fP with the \f2\-i\fPoption. It will generate package location information for the specified main jar file and all the jar files it depends on, which need to be specified in the \f2Class\-Path\fP attribute of the main jar file's manifest.
53.110 .LP
53.111 .RS 3
53.112
53.113 @@ -241,6 +235,7 @@
53.114 .LP
53.115
53.116 .LP
53.117 +.RS 3
53.118 .TP 3
53.119 c
53.120 Creates a new archive file named \f2jarfile\fP (if \f2f\fP is specified) or to standard output (if \f2f\fP and \f2jarfile\fP are omitted). Add to it the files and directories specified by \f2inputfiles\fP.
53.121 @@ -326,6 +321,7 @@
53.122 \f2JAR Files\fP @
53.123 .fi
53.124 http://java.sun.com/docs/books/tutorial/jar/ trail in the Java Tutorial for examples of using the \f4\-m\fP option.
53.125 +.LP
53.126 .TP 3
53.127 e
53.128 Sets \f2entrypoint\fP as the application entry point for stand\-alone applications bundled into executable jar file. The use of this option creates or overrides the \f2Main\-Class\fP attribute value in the manifest file. This option can be used during creation of jar file or while updating the jar file. This option specifies the application entry point without editing or creating the manifest file.
53.129 @@ -434,11 +430,9 @@
53.130 .LP
53.131 .TP 3
53.132 \-Joption
53.133 -Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of the options described on the reference page for the
53.134 -.na
53.135 -\f2java application launcher\fP @
53.136 -.fi
53.137 -http://ccc.sfbay/4291383/attachment/java.html#options. For example, \f4\-J\-Xmx48M\fP sets the maximum memory to 48 megabytes. It is a common convention for \f2\-J\fP to pass options to the underlying runtime environment.
53.138 +Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f4\-J\-Xmx48M\fP sets the maximum memory to 48 megabytes. It is a common convention for \f2\-J\fP to pass options to the underlying runtime environment.
53.139 +.RE
53.140 +
53.141 .LP
53.142 .SH "COMMAND LINE ARGUMENT FILES"
53.143 .LP
53.144 @@ -446,7 +440,7 @@
53.145 .LP
53.146 To shorten or simplify the jar command line, you can specify one or more files that themselves contain arguments to the \f2jar\fP command (except \f2\-J\fP options). This enables you to create jar commands of any length, overcoming command line limits imposed by the operating system.
53.147 .LP
53.148 -An argument file can include options and filenames. The arguments within a file can be space–separated or newline\-separated. Filenames within an argument file are relative to the current directory, not relative to the location of the argument file. Wildcards (*) that might otherwise be expanded by the operating system shell are not expanded. Use of the \f2@\fP character to recursively interpret files is not supported. The \f2\-J\fP options are not supported because they are passed to the launcher, which does not support argument files.
53.149 +An argument file can include options and filenames. The arguments within a file can be space\-separated or newline\-separated. Filenames within an argument file are relative to the current directory, not relative to the location of the argument file. Wildcards (*) that might otherwise be expanded by the operating system shell are not expanded. Use of the \f2@\fP character to recursively interpret files is not supported. The \f2\-J\fP options are not supported because they are passed to the launcher, which does not support argument files.
53.150 .LP
53.151 .LP
53.152 When executing \f2jar\fP, pass in the path and name of each argument file with the \f2@\fP leading character. When \f2jar\fP encounters an argument beginning with the character \f2@\fP, it expands the contents of that file into the argument list.
53.153 @@ -676,21 +670,21 @@
53.154 .na
53.155 \f2The Jar Overview\fP @
53.156 .fi
53.157 -http://ccc.sfbay/guide/jar/jarGuide.html
53.158 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
53.159 .br
53.160
53.161 .LP
53.162 .na
53.163 \f2The Jar File Specification\fP @
53.164 .fi
53.165 -http://ccc.sfbay/guide/jar/jar.html
53.166 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
53.167 .br
53.168
53.169 .LP
53.170 .na
53.171 \f2The JarIndex Spec\fP @
53.172 .fi
53.173 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Index
53.174 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
53.175 .br
53.176
53.177 .LP
53.178 @@ -701,9 +695,6 @@
53.179 .br
53.180
53.181 .LP
53.182 -.na
53.183 -\f2pack200 Reference Page\fP @
53.184 -.fi
53.185 -http://ccc.sfbay/4291383/share/pack200.html
53.186 +pack200(1)
53.187 .LP
53.188
54.1 --- a/src/linux/doc/man/jarsigner.1 Tue May 12 15:21:55 2009 +0900
54.2 +++ b/src/linux/doc/man/jarsigner.1 Thu May 14 00:17:25 2009 -0700
54.3 @@ -1,6 +1,4 @@
54.4 -.'" t
54.5 -."
54.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
54.7 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
54.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
54.9 ."
54.10 ." This code is free software; you can redistribute it and/or modify it
54.11 @@ -21,12 +19,11 @@
54.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
54.13 ." have any questions.
54.14 ."
54.15 -." `
54.16 -.TH jarsigner 1 "07 Aug 2006"
54.17 -." Generated by html2man
54.18 +.TH jarsigner 1 "04 May 2009"
54.19 +." Generated from HTML by html2man (author: Eric Armstrong)
54.20
54.21 .LP
54.22 -.SH NAME
54.23 +.SH "Name"
54.24 jarsigner \- JAR Signing and Verification Tool
54.25 .LP
54.26 .RS 3
54.27 @@ -45,11 +42,14 @@
54.28 .fl
54.29 \fP\f3jarsigner\fP [ options ] jar\-file alias
54.30 .fl
54.31 -\f3jarsigner\fP \-verify [ options ] jar\-file
54.32 +\f3jarsigner\fP \-verify [ options ] jar\-file [alias...]
54.33 .fl
54.34 .fi
54.35
54.36 .LP
54.37 +.LP
54.38 +The jarsigner \-verify command can take zero or more keystore alias names after the jar filename. When specified, jarsigner will check that the certificate used to verify each signed entry in the jar file matches one of the keystore aliases. The aliases are defined in the keystore specified by \-keystore, or the default keystore.
54.39 +.LP
54.40 .SH "DESCRIPTION"
54.41 .LP
54.42
54.43 @@ -68,7 +68,7 @@
54.44
54.45 .LP
54.46 .LP
54.47 -The JAR feature enables the packaging of class files, images, sounds, and other digital data in a single file for faster and easier distribution. A tool named \f3jar\fP enables developers to produce JAR files. (Technically, any zip file can also be considered a JAR file, although when created by \f3jar\fP or processed by \f3jarsigner\fP, JAR files also contain a META\-INF/MANIFEST.MF file.)
54.48 +The JAR feature enables the packaging of class files, images, sounds, and other digital data in a single file for faster and easier distribution. A tool named jar(1) enables developers to produce JAR files. (Technically, any zip file can also be considered a JAR file, although when created by \f3jar\fP or processed by \f3jarsigner\fP, JAR files also contain a META\-INF/MANIFEST.MF file.)
54.49 .LP
54.50 .LP
54.51 A \f2digital signature\fP is a string of bits that is computed from some data (the data being "signed") and the private key of an entity (a person, company, etc.). Like a handwritten signature, a digital signature has many useful characteristics:
54.52 @@ -93,21 +93,969 @@
54.53 In order for an entity's signature to be generated for a file, the entity must first have a public/private key pair associated with it, and also one or more certificates authenticating its public key. A \f2certificate\fP is a digitally signed statement from one entity, saying that the public key of some other entity has a particular value.
54.54 .LP
54.55 .LP
54.56 -\f3jarsigner\fP uses key and certificate information from a \f2keystore\fP to generate digital signatures for JAR files. A keystore is a database of private keys and their associated X.509 certificate chains authenticating the corresponding public keys. The \f3keytool\fP utility is used to create and administer keystores.
54.57 +\f3jarsigner\fP uses key and certificate information from a \f2keystore\fP to generate digital signatures for JAR files. A keystore is a database of private keys and their associated X.509 certificate chains authenticating the corresponding public keys. The keytool(1) utility is used to create and administer keystores.
54.58 .LP
54.59 .LP
54.60 \f3jarsigner\fP uses an entity's private key to generate a signature. The signed JAR file contains, among other things, a copy of the certificate from the keystore for the public key corresponding to the private key used to sign the file. \f3jarsigner\fP can verify the digital signature of the signed JAR file using the certificate inside it (in its signature block file).
54.61 .LP
54.62 .LP
54.63 -Starting in J2SE 5.0, \f3jarsigner\fP can generate signatures that include a timestamp, thus enabling systems/deployer (including Java Plug\-in) to check whether the JAR file was signed while the signing certificate was still valid. In addition, APIs were added in J2SE 5.0 to allow applications to obtain the timestamp information.
54.64 +\f3jarsigner\fP can generate signatures that include a timestamp, thus enabling systems/deployer (including Java Plug\-in) to check whether the JAR file was signed while the signing certificate was still valid. In addition, APIs will allow applications to obtain the timestamp information.
54.65 .LP
54.66 .LP
54.67 -At this time, \f3jarsigner\fP can only sign JAR files created by the SDK \f3jar\fP tool or zip files. (JAR files are the same as zip files, except they also have a META\-INF/MANIFEST.MF file. Such a file will automatically be created when \f3jarsigner\fP signs a zip file.)
54.68 +At this time, \f3jarsigner\fP can only sign JAR files created by the SDK jar(1) tool or zip files. (JAR files are the same as zip files, except they also have a META\-INF/MANIFEST.MF file. Such a file will automatically be created when \f3jarsigner\fP signs a zip file.)
54.69 .LP
54.70 .LP
54.71 The default \f3jarsigner\fP behavior is to \f2sign\fP a JAR (or zip) file. Use the \f2\-verify\fP option to instead have it \f2verify\fP a signed JAR file.
54.72 .LP
54.73 .SS
54.74 +Keystore Aliases
54.75 +.LP
54.76 +.RS 3
54.77 +
54.78 +.LP
54.79 +.LP
54.80 +All keystore entities are accessed via unique \f2aliases\fP.
54.81 +.LP
54.82 +.LP
54.83 +When using \f3jarsigner\fP to sign a JAR file, you must specify the alias for the keystore entry containing the private key needed to generate the signature. For example, the following will sign the JAR file named "MyJARFile.jar", using the private key associated with the alias "duke" in the keystore named "mystore" in the "working" directory. Since no output file is specified, it overwrites MyJARFile.jar with the signed JAR file.
54.84 +.LP
54.85 +.nf
54.86 +\f3
54.87 +.fl
54.88 + jarsigner \-keystore /working/mystore \-storepass myspass
54.89 +.fl
54.90 + \-keypass dukekeypasswd MyJARFile.jar duke
54.91 +.fl
54.92 +\fP
54.93 +.fi
54.94 +
54.95 +.LP
54.96 +.LP
54.97 +Keystores are protected with a password, so the store password (in this case "myspass") must be specified. You will be prompted for it if you don't specify it on the command line. Similarly, private keys are protected in a keystore with a password, so the private key's password (in this case "dukekeypasswd") must be specified, and you will be prompted for it if you don't specify it on the command line and it isn't the same as the store password.
54.98 +.LP
54.99 +.RE
54.100 +.SS
54.101 +Keystore Location
54.102 +.LP
54.103 +.RS 3
54.104 +
54.105 +.LP
54.106 +.LP
54.107 +\f3jarsigner\fP has a \f2\-keystore\fP option for specifying the URL of the keystore to be used. The keystore is by default stored in a file named \f2.keystore\fP in the user's home directory, as determined by the \f2user.home\fP system property. On Solaris systems \f2user.home\fP defaults to the user's home directory.
54.108 +.LP
54.109 +.LP
54.110 +Note that the input stream from the \f2\-keystore\fP option is passed to the \f2KeyStore.load\fP method. If \f2NONE\fP is specified as the URL, then a null stream is passed to the \f2KeyStore.load\fP method. \f2NONE\fP should be specified if the \f2KeyStore\fP is not file\-based, for example, if it resides on a hardware token device.
54.111 +.LP
54.112 +.RE
54.113 +.SS
54.114 +Keystore Implementation
54.115 +.LP
54.116 +.RS 3
54.117 +
54.118 +.LP
54.119 +.LP
54.120 +The \f2KeyStore\fP class provided in the \f2java.security\fP package supplies well\-defined interfaces to access and modify the information in a keystore. It is possible for there to be multiple different concrete implementations, where each implementation is that for a particular \f2type\fP of keystore.
54.121 +.LP
54.122 +.LP
54.123 +Currently, there are two command\-line tools that make use of keystore implementations (\f3keytool\fP and \f3jarsigner\fP), and also a GUI\-based tool named \f3Policy Tool\fP. Since \f2KeyStore\fP is publicly available, Java 2 SDK users can write additional security applications that use it.
54.124 +.LP
54.125 +.LP
54.126 +There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
54.127 +.LP
54.128 +.LP
54.129 +Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a provider and supply a KeystoreSpi subclass implementation, as described in
54.130 +.na
54.131 +\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
54.132 +.fi
54.133 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html.
54.134 +.LP
54.135 +.LP
54.136 +Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
54.137 +.LP
54.138 +.LP
54.139 +\f3keytool\fP works on any file\-based keystore implementation. (It treats the keytore location that is passed to it at the command line as a filename and converts it to a FileInputStream, from which it loads the keystore information.) The \f3jarsigner\fP and \f3policytool\fP tools, on the other hand, can read a keystore from any location that can be specified using a URL.
54.140 +.LP
54.141 +.LP
54.142 +For \f3jarsigner\fP and \f3keytool\fP, you can specify a keystore type at the command line, via the \f2\-storetype\fP option. For \f3Policy Tool\fP, you can specify a keystore type via the "Change Keystore" command in the Edit menu.
54.143 +.LP
54.144 +.LP
54.145 +If you don't explicitly specify a keystore type, the tools choose a keystore implementation based simply on the value of the \f2keystore.type\fP property specified in the security properties file. The security properties file is called \f2java.security\fP, and it resides in the SDK security properties directory, \f2java.home\fP/lib/security, where \f2java.home\fP is the runtime environment's directory (the \f2jre\fP directory in the SDK or the top\-level directory of the Java 2 Runtime Environment).
54.146 +.LP
54.147 +.LP
54.148 +Each tool gets the \f2keystore.type\fP value and then examines all the currently\-installed providers until it finds one that implements keystores of that type. It then uses the keystore implementation from that provider.
54.149 +.LP
54.150 +.LP
54.151 +The \f2KeyStore\fP class defines a static method named \f2getDefaultType\fP that lets applications and applets retrieve the value of the \f2keystore.type\fP property. The following line of code creates an instance of the default keystore type (as specified in the \f2keystore.type\fP property):
54.152 +.LP
54.153 +.nf
54.154 +\f3
54.155 +.fl
54.156 + KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
54.157 +.fl
54.158 +\fP
54.159 +.fi
54.160 +
54.161 +.LP
54.162 +.LP
54.163 +The default keystore type is "jks" (the proprietary type of the keystore implementation provided by Sun). This is specified by the following line in the security properties file:
54.164 +.LP
54.165 +.nf
54.166 +\f3
54.167 +.fl
54.168 + keystore.type=jks
54.169 +.fl
54.170 +\fP
54.171 +.fi
54.172 +
54.173 +.LP
54.174 +.LP
54.175 +Note: Case doesn't matter in keystore type designations. For example, "JKS" would be considered the same as "jks".
54.176 +.LP
54.177 +.LP
54.178 +To have the tools utilize a keystore implementation other than the default, change that line to specify a different keystore type. For example, if you have a provider package that supplies a keystore implementation for a keystore type called "pkcs12", change the line to
54.179 +.LP
54.180 +.nf
54.181 +\f3
54.182 +.fl
54.183 + keystore.type=pkcs12
54.184 +.fl
54.185 +\fP
54.186 +.fi
54.187 +
54.188 +.LP
54.189 +.LP
54.190 +Note that if you us the PKCS#11 provider package, you should refer to the
54.191 +.na
54.192 +\f2KeyTool and JarSigner\fP @
54.193 +.fi
54.194 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner section of the Java PKCS#11 Reference Guide for details.
54.195 +.LP
54.196 +.RE
54.197 +.SS
54.198 +Supported Algorithms
54.199 +.LP
54.200 +.RS 3
54.201 +
54.202 +.LP
54.203 +.LP
54.204 +By default, \f3jarsigner\fP signs a JAR file using either
54.205 +.LP
54.206 +.RS 3
54.207 +.TP 2
54.208 +o
54.209 +DSA (Digital Signature Algorithm) with the SHA\-1 digest algorithm, or
54.210 +.TP 2
54.211 +o
54.212 +the RSA algorithm with the SHA\-1 digest algorithm.
54.213 +.RE
54.214 +
54.215 +.LP
54.216 +.LP
54.217 +That is, if the signer's public and private keys are DSA keys, \f3jarsigner\fP will sign the JAR file using the "SHA1withDSA" algorithm. If the signer's keys are RSA keys, \f3jarsigner\fP will attempt to sign the JAR file using the "SHA1withRSA" algorithm.
54.218 +.LP
54.219 +.LP
54.220 +These default signature algorithms can be overridden using the \f2\-sigalg\fP option.
54.221 +.LP
54.222 +.RE
54.223 +.SS
54.224 +The Signed JAR File
54.225 +.LP
54.226 +.RS 3
54.227 +
54.228 +.LP
54.229 +.LP
54.230 +When \f3jarsigner\fP is used to sign a JAR file, the output signed JAR file is exactly the same as the input JAR file, except that it has two additional files placed in the META\-INF directory:
54.231 +.LP
54.232 +.RS 3
54.233 +.TP 2
54.234 +o
54.235 +a signature file, with a .SF extension, and
54.236 +.TP 2
54.237 +o
54.238 +a signature block file, with a .DSA extension.
54.239 +.RE
54.240 +
54.241 +.LP
54.242 +.LP
54.243 +The base file names for these two files come from the value of the \f2\-sigFile\fP option. For example, if the option appears as
54.244 +.LP
54.245 +.nf
54.246 +\f3
54.247 +.fl
54.248 + \-sigFile MKSIGN
54.249 +.fl
54.250 +\fP
54.251 +.fi
54.252 +
54.253 +.LP
54.254 +.LP
54.255 +the files are named "MKSIGN.SF" and "MKSIGN.DSA".
54.256 +.LP
54.257 +.LP
54.258 +If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not allowed in a signature file name, each such character is converted to an underscore ("_") character in forming the file name. Legal characters include letters, digits, underscores, and hyphens.
54.259 +.LP
54.260 +\f3The Signature (.SF) File\fP
54.261 +.LP
54.262 +.RS 3
54.263 +
54.264 +.LP
54.265 +.LP
54.266 +A signature file (the .SF file) looks similar to the manifest file that is always included in a JAR file when \f3jarsigner\fP is used to sign the file. That is, for each source file included in the JAR file, the .SF file has three lines, just as in the manifest file, listing the following:
54.267 +.LP
54.268 +.RS 3
54.269 +.TP 2
54.270 +o
54.271 +the file name,
54.272 +.TP 2
54.273 +o
54.274 +the name of the digest algorithm used (SHA), and
54.275 +.TP 2
54.276 +o
54.277 +a SHA digest value.
54.278 +.RE
54.279 +
54.280 +.LP
54.281 +.LP
54.282 +In the manifest file, the SHA digest value for each source file is the digest (hash) of the binary data in the source file. In the .SF file, on the other hand, the digest value for a given source file is the hash of the three lines in the manifest file for the source file.
54.283 +.LP
54.284 +.LP
54.285 +The signature file also, by default, includes a header containing a hash of the whole manifest file. The presence of the header enables verification optimization, as described in JAR File Verification.
54.286 +.LP
54.287 +.RE
54.288 +\f3The Signature Block (.DSA) File\fP
54.289 +.LP
54.290 +.RS 3
54.291 +
54.292 +.LP
54.293 +.LP
54.294 +The .SF file is signed and the signature is placed in the .DSA file. The .DSA file also contains, encoded inside it, the certificate or certificate chain from the keystore which authenticates the public key corresponding to the private key used for signing.
54.295 +.LP
54.296 +.RE
54.297 +.RE
54.298 +.SS
54.299 +Signature Timestamp
54.300 +.LP
54.301 +.RS 3
54.302 +
54.303 +.LP
54.304 +.LP
54.305 +\f2jarsigner\fP tool can now generate and store a signature timestamp when signing a JAR file. In addition, \f2jarsigner\fP supports alternative signing mechanisms. This behavior is optional and is controlled by the user at the time of signing through these options:
54.306 +.LP
54.307 +.RS 3
54.308 +.TP 2
54.309 +o
54.310 +\f2\-tsa url\fP
54.311 +.TP 2
54.312 +o
54.313 +\f2\-tsacert alias\fP
54.314 +.TP 2
54.315 +o
54.316 +\f2\-altsigner class\fP
54.317 +.TP 2
54.318 +o
54.319 +\f2\-altsignerpath classpathlist\fP
54.320 +.RE
54.321 +
54.322 +.LP
54.323 +.LP
54.324 +Each of these options is detailed in the Options section below.
54.325 +.LP
54.326 +.RE
54.327 +.SS
54.328 +JAR File Verification
54.329 +.LP
54.330 +.RS 3
54.331 +
54.332 +.LP
54.333 +.LP
54.334 +A successful JAR file verification occurs if the signature(s) are valid, and none of the files that were in the JAR file when the signatures were generated have been changed since then. JAR file verification involves the following steps:
54.335 +.LP
54.336 +.RS 3
54.337 +.TP 3
54.338 +1.
54.339 +Verify the signature of the .SF file itself.
54.340 +.LP
54.341 +That is, the verification ensures that the signature stored in each signature block (.DSA) file was in fact generated using the private key corresponding to the public key whose certificate (or certificate chain) also appears in the .DSA file. It also ensures that the signature is a valid signature of the corresponding signature (.SF) file, and thus the .SF file has not been tampered with.
54.342 +.TP 3
54.343 +2.
54.344 +Verify the digest listed in each entry in the .SF file with each corresponding section in the manifest.
54.345 +.LP
54.346 +The .SF file by default includes a header containing a hash of the entire manifest file. When the header is present, then the verification can check to see whether or not the hash in the header indeed matches the hash of the manifest file. If that is the case, verification proceeds to the next step.
54.347 +.LP
54.348 +If that is not the case, a less optimized verification is required to ensure that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file (see The Signature (.SF) File).
54.349 +.LP
54.350 +One reason the hash of the manifest file that is stored in the .SF file header may not equal the hash of the current manifest file would be because one or more files were added to the JAR file (using the \f2jar\fP tool) after the signature (and thus the .SF file) was generated. When the \f2jar\fP tool is used to add files, the manifest file is changed (sections are added to it for the new files), but the .SF file is not. A verification is still considered successful if none of the files that were in the JAR file when the signature was generated have been changed since then, which is the case if the hashes in the non\-header sections of the .SF file equal the hashes of the corresponding sections in the manifest file.
54.351 +.TP 3
54.352 +3.
54.353 +Read each file in the JAR file that has an entry in the .SF file. While reading, compute the file's digest, and then compare the result with the digest for this file in the manifest section. The digests should be the same, or verification fails.
54.354 +.RE
54.355 +
54.356 +.LP
54.357 +.LP
54.358 +If any serious verification failures occur during the verification process, the process is stopped and a security exception is thrown. It is caught and displayed by \f3jarsigner\fP.
54.359 +.LP
54.360 +.RE
54.361 +.SS
54.362 +Multiple Signatures for a JAR File
54.363 +.LP
54.364 +.RS 3
54.365 +
54.366 +.LP
54.367 +.LP
54.368 +A JAR file can be signed by multiple people simply by running the \f3jarsigner\fP tool on the file multiple times, specifying the alias for a different person each time, as in:
54.369 +.LP
54.370 +.nf
54.371 +\f3
54.372 +.fl
54.373 + jarsigner myBundle.jar susan
54.374 +.fl
54.375 + jarsigner myBundle.jar kevin
54.376 +.fl
54.377 +\fP
54.378 +.fi
54.379 +
54.380 +.LP
54.381 +.LP
54.382 +When a JAR file is signed multiple times, there are multiple .SF and .DSA files in the resulting JAR file, one pair for each signature. Thus, in the example above, the output JAR file includes files with the following names:
54.383 +.LP
54.384 +.nf
54.385 +\f3
54.386 +.fl
54.387 + SUSAN.SF
54.388 +.fl
54.389 + SUSAN.DSA
54.390 +.fl
54.391 + KEVIN.SF
54.392 +.fl
54.393 + KEVIN.DSA
54.394 +.fl
54.395 +\fP
54.396 +.fi
54.397 +
54.398 +.LP
54.399 +.LP
54.400 +Note: It is also possible for a JAR file to have mixed signatures, some generated by the JDK 1.1 \f3javakey\fP tool and others by \f3jarsigner\fP. That is, \f3jarsigner\fP can be used to sign JAR files already previously signed using \f3javakey\fP.
54.401 +.LP
54.402 +.RE
54.403 +.SH "OPTIONS"
54.404 +.LP
54.405 +
54.406 +.LP
54.407 +.LP
54.408 +The various \f3jarsigner\fP options are listed and described below. Note:
54.409 +.LP
54.410 +.RS 3
54.411 +.TP 2
54.412 +o
54.413 +All option names are preceded by a minus sign (\-).
54.414 +.TP 2
54.415 +o
54.416 +The options may be provided in any order.
54.417 +.TP 2
54.418 +o
54.419 +Items in italics (option values) represent the actual values that must be supplied.
54.420 +.TP 2
54.421 +o
54.422 +The \f2\-keystore\fP, \f2\-storepass\fP, \f2\-keypass\fP, \f2\-sigfile\fP, \f2\-sigalg\fP, \f2\-digestalg\fP, and \f2\-signedjar\fP options are only relevant when signing a JAR file, not when verifying a signed JAR file. Similarly, an alias is only specified on the command line when signing a JAR file.
54.423 +.RE
54.424 +
54.425 +.LP
54.426 +.RS 3
54.427 +.TP 3
54.428 +\-keystore url
54.429 +Specifies the URL that tells the keystore location. This defaults to the file \f2.keystore\fP in the user's home directory, as determined by the "user.home" system property.
54.430 +.LP
54.431 +A keystore is required when signing, so you must explicitly specify one if the default keystore does not exist (or you want to use one other than the default).
54.432 +.LP
54.433 +A keystore is \f2not\fP required when verifying, but if one is specified, or the default exists, and the \f2\-verbose\fP option was also specified, additional information is output regarding whether or not any of the certificates used to verify the JAR file are contained in that keystore.
54.434 +.LP
54.435 +Note: the \f2\-keystore\fP argument can actually be a file name (and path) specification rather than a URL, in which case it will be treated the same as a "file:" URL. That is,
54.436 +.nf
54.437 +\f3
54.438 +.fl
54.439 + \-keystore \fP\f4filePathAndName\fP\f3
54.440 +.fl
54.441 +\fP
54.442 +.fi
54.443 +is treated as equivalent to
54.444 +.nf
54.445 +\f3
54.446 +.fl
54.447 + \-keystore file:\fP\f4filePathAndName\fP\f3
54.448 +.fl
54.449 +\fP
54.450 +.fi
54.451 +If the Sun PKCS#11 provider has been configured in the \f2java.security\fP security properties file (located in the JRE's \f2$JAVA_HOME/lib/security\fP directory), then keytool and jarsigner can operate on the PKCS#11 token by specifying these options:
54.452 +.RS 3
54.453 +.TP 2
54.454 +o
54.455 +\f2\-keystore NONE\fP
54.456 +.TP 2
54.457 +o
54.458 +\f2\-storetype PKCS11\fP
54.459 +.RE
54.460 +For example, this command lists the contents of the configured PKCS#11 token:
54.461 +.RS 3
54.462 +
54.463 +.LP
54.464 +.nf
54.465 +\f3
54.466 +.fl
54.467 + jarsigner \-keystore NONE \-storetype PKCS11 \-list
54.468 +.fl
54.469 +
54.470 +.fl
54.471 +\fP
54.472 +.fi
54.473 +.RE
54.474 +.TP 3
54.475 +\-storetype storetype
54.476 +Specifies the type of keystore to be instantiated. The default keystore type is the one that is specified as the value of the "keystore.type" property in the security properties file, which is returned by the static \f2getDefaultType\fP method in \f2java.security.KeyStore\fP.
54.477 +.LP
54.478 +The PIN for a PCKS#11 token can also be specified using the \f2\-storepass\fP option. If none has been specified, keytool and jarsigner will prompt for the token PIN. If the token has a protected authentication path (such as a dedicated PIN\-pad or a biometric reader), then the \f2\-protected\fP option must be specified and no password options can be specified.
54.479 +.TP 3
54.480 +\-storepass password
54.481 +Specifies the password which is required to access the keystore. This is only needed when signing (not verifying) a JAR file. In that case, if a \f2\-storepass\fP option is not provided at the command line, the user is prompted for the password.
54.482 +.LP
54.483 +Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system.
54.484 +.TP 3
54.485 +\-keypass password
54.486 +Specifies the password used to protect the private key of the keystore entry addressed by the alias specified on the command line. The password is required when using \f3jarsigner\fP to sign a JAR file. If no password is provided on the command line, and the required password is different from the store password, the user is prompted for it.
54.487 +.LP
54.488 +Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
54.489 +.TP 3
54.490 +\-sigfile file
54.491 +Specifies the base file name to be used for the generated .SF and .DSA files. For example, if \f2file\fP is "DUKESIGN", the generated .SF and .DSA files will be named "DUKESIGN.SF" and "DUKESIGN.DSA", and will be placed in the "META\-INF" directory of the signed JAR file.
54.492 +.LP
54.493 +The characters in \f2file\fP must come from the set "a\-zA\-Z0\-9_\-". That is, only letters, numbers, underscore, and hyphen characters are allowed. Note: All lowercase characters will be converted to uppercase for the .SF and .DSA file names.
54.494 +.LP
54.495 +If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not legal in a signature file name, each such character is converted to an underscore ("_") character in forming the file name.
54.496 +.TP 3
54.497 +\-sigalg algorithm
54.498 +.RS 3
54.499 +
54.500 +.LP
54.501 +Specifies the name of the signature algorithm to use to sign the JAR file.
54.502 +.LP
54.503 +See
54.504 +.na
54.505 +\f2Appendix A\fP @
54.506 +.fi
54.507 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA of the Java Cryptography Architecture for a list of standard signature algorithm names. This algorithm must be compatible with the private key used to sign the JAR file. If this option is not specified, SHA1withDSA or SHA1withRSA will be used depending on the type of private key. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
54.508 +.LP
54.509 +.RE
54.510 +.TP 3
54.511 +\-digestalg algorithm
54.512 +.RS 3
54.513 +Specifies the name of the message digest algorithm to use when digesting the entries of a jar file.
54.514 +.LP
54.515 +See
54.516 +.na
54.517 +\f2Appendix A\fP @
54.518 +.fi
54.519 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA of the Java Cryptography Architecture for a list of standard message digest algorithm names. If this option is not specified, SHA\-1 will be used. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
54.520 +.LP
54.521 +.RE
54.522 +.TP 3
54.523 +\-signedjar file
54.524 +Specifies the name to be used for the signed JAR file.
54.525 +.LP
54.526 +If no name is specified on the command line, the name used is the same as the input JAR file name (the name of the JAR file to be signed); in other words, that file is overwritten with the signed JAR file.
54.527 +.TP 3
54.528 +\-verify
54.529 +If this appears on the command line, the specified JAR file will be verified, not signed. If the verification is successful, "jar verified" will be displayed. If you try to verify an unsigned JAR file, or a JAR file signed with an unsupported algorithm (e.g., RSA when you don't have an RSA provider installed), the following is displayed: "jar is unsigned. (signatures missing or not parsable)"
54.530 +.LP
54.531 +It is possible to verify JAR files signed using either \f3jarsigner\fP or the JDK 1.1 \f3javakey\fP tool, or both.
54.532 +.LP
54.533 +For further information on verification, see JAR File Verification.
54.534 +.TP 3
54.535 +\-certs
54.536 +If this appears on the command line, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file. This information includes
54.537 +.RS 3
54.538 +.TP 2
54.539 +o
54.540 +the name of the type of certificate (stored in the .DSA file) that certifies the signer's public key
54.541 +.TP 2
54.542 +o
54.543 +if the certificate is an X.509 certificate (more specifically, an instance of \f2java.security.cert.X509Certificate\fP): the distinguished name of the signer
54.544 +.RE
54.545 +.LP
54.546 +The keystore is also examined. If no keystore value is specified on the command line, the default keystore file (if any) will be checked. If the public key certificate for a signer matches an entry in the keystore, then the following information will also be displayed:
54.547 +.RS 3
54.548 +.TP 2
54.549 +o
54.550 +in parentheses, the alias name for the keystore entry for that signer. If the signer actually comes from a JDK 1.1 identity database instead of from a keystore, the alias name will appear in brackets instead of parentheses.
54.551 +.RE
54.552 +.TP 3
54.553 +\-certchain file
54.554 +Specifies the certificate chain to be used, if the certificate chain associated with the private key of the keystore entry, addressed by the alias specified on the command line, is not complete. This may happen if the keystore is located on a hardware token where there is not enough capacity to hold a complete certificate chain. The file can be a sequence of X.509 certificates concatenated together, or a single PKCS#7 formatted data block, either in binary encoding format or in printable encoding format (also known as BASE64 encoding) as defined by the Internet RFC 1421 standard.
54.555 +.TP 3
54.556 +\-verbose
54.557 +If this appears on the command line, it indicates "verbose" mode, which causes \f3jarsigner\fP to output extra information as to the progress of the JAR signing or verification.
54.558 +.TP 3
54.559 +\-internalsf
54.560 +In the past, the .DSA (signature block) file generated when a JAR file was signed used to include a complete encoded copy of the .SF file (signature file) also generated. This behavior has been changed. To reduce the overall size of the output JAR file, the .DSA file by default doesn't contain a copy of the .SF file anymore. But if \f2\-internalsf\fP appears on the command line, the old behavior is utilized. \f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
54.561 +.TP 3
54.562 +\-sectionsonly
54.563 +If this appears on the command line, the .SF file (signature file) generated when a JAR file is signed does \f2not\fP include a header containing a hash of the whole manifest file. It just contains information and hashes related to each individual source file included in the JAR file, as described in The Signature (.SF) File .
54.564 +.LP
54.565 +By default, this header is added, as an optimization. When the header is present, then whenever the JAR file is verified, the verification can first check to see whether or not the hash in the header indeed matches the hash of the whole manifest file. If so, verification proceeds to the next step. If not, it is necessary to do a less optimized verification that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file.
54.566 +.LP
54.567 +For further information, see JAR File Verification.
54.568 +.LP
54.569 +\f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
54.570 +.TP 3
54.571 +\-protected
54.572 +Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
54.573 +.RE
54.574 +.RS 3
54.575 +.TP 3
54.576 +\-provider provider\-class\-name
54.577 +Used to specify the name of cryptographic service provider's master class file when the service provider is not listed in the security properties file, \f2java.security\fP.
54.578 +.LP
54.579 +Used in conjunction with the \f2\-providerArg\fP \f2ConfigFilePath\fP option, keytool and jarsigner will install the provider dynamically (where \f2ConfigFilePath\fP is the path to the token configuration file). Here's an example of a command to list a PKCS#11 keystore when the Sun PKCS#11 provider has not been configured in the security properties file.
54.580 +.RS 3
54.581 +
54.582 +.LP
54.583 +.nf
54.584 +\f3
54.585 +.fl
54.586 +jarsigner \-keystore NONE \-storetype PKCS11 \\
54.587 +.fl
54.588 + \-providerClass sun.security.pkcs11.SunPKCS11 \\
54.589 +.fl
54.590 + \-providerArg /foo/bar/token.config \\
54.591 +.fl
54.592 + \-list
54.593 +.fl
54.594 +\fP
54.595 +.fi
54.596 +.RE
54.597 +.TP 3
54.598 +\-providerName providerName
54.599 +If more than one provider has been configured in the \f2java.security\fP security properties file, you can use the \f2\-providerName\fP option to target a specific provider instance. The argument to this option is the name of the provider.
54.600 +.LP
54.601 +For the Sun PKCS#11 provider, \f2providerName\fP is of the form \f2SunPKCS11\-\fP\f2TokenName\fP, where \f2TokenName\fP is the name suffix that the provider instance has been configured with, as detailed in the
54.602 +.na
54.603 +\f2configuration attributes table\fP @
54.604 +.fi
54.605 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRS. For example, the following command lists the contents of the PKCS#11 keystore provider instance with name suffix \f2SmartCard\fP:
54.606 +.RS 3
54.607 +
54.608 +.LP
54.609 +.nf
54.610 +\f3
54.611 +.fl
54.612 +jarsigner \-keystore NONE \-storetype PKCS11 \\
54.613 +.fl
54.614 + \-providerName SunPKCS11\-SmartCard \\
54.615 +.fl
54.616 + \-list
54.617 +.fl
54.618 +\fP
54.619 +.fi
54.620 +.RE
54.621 +.TP 3
54.622 +\-Jjavaoption
54.623 +Passes through the specified \f2javaoption\fP string directly to the Java interpreter. (\f3jarsigner\fP is actually a "wrapper" around the interpreter.) This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
54.624 +.LP
54.625 +.TP 3
54.626 +\-tsa url
54.627 +If \f2"\-tsa http://example.tsa.url"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The URL, \f2http://example.tsa.url\fP, identifies the location of the Time Stamping Authority (TSA). It overrides any URL found via the \f2\-tsacert\fP option. The \f2\-tsa\fP option does not require the TSA's public key certificate to be present in the keystore.
54.628 +.LP
54.629 +To generate the timestamp, \f2jarsigner\fP communicates with the TSA using the Time\-Stamp Protocol (TSP) defined in
54.630 +.na
54.631 +\f2RFC 3161\fP @
54.632 +.fi
54.633 +http://www.ietf.org/rfc/rfc3161.txt. If successful, the timestamp token returned by the TSA is stored along with the signature in the signature block file.
54.634 +.LP
54.635 +.TP 3
54.636 +\-tsacert alias
54.637 +If \f2"\-tsacert alias"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The \f2alias\fP identifies the TSA's public key certificate in the keystore that is currently in effect. The entry's certificate is examined for a Subject Information Access extension that contains a URL identifying the location of the TSA.
54.638 +.LP
54.639 +The TSA's public key certificate must be present in the keystore when using \f2\-tsacert\fP.
54.640 +.LP
54.641 +.TP 3
54.642 +\-altsigner class
54.643 +Specifies that an alternative signing mechanism be used. The fully\-qualified class name identifies a class file that extends the \f2com.sun.jarsigner.ContentSigner abstract class\fP. The path to this class file is defined by the \f2\-altsignerpath\fP option. If the \f2\-altsigner\fP option is used, \f2jarsigner\fP uses the signing mechanism provided by the specified class. Otherwise, \f2jarsigner\fP uses its default signing mechanism.
54.644 +.LP
54.645 +For example, to use the signing mechanism provided by a class named \f2com.sun.sun.jarsigner.AuthSigner\fP, use the \f2jarsigner\fP option \f2"\-altsigner com.sun.jarsigner.AuthSigner"\fP
54.646 +.LP
54.647 +.TP 3
54.648 +\-altsignerpath classpathlist
54.649 +Specifies the path to the class file (the class file name is specified with the \f2\-altsigner\fP option described above) and any JAR files it depends on. If the class file is in a JAR file, then this specifies the path to that JAR file, as shown in the example below.
54.650 +.LP
54.651 +An absolute path or a path relative to the current directory may be specified. If \f2classpathlist\fP contains multiple paths or JAR files, they should be separated with a colon (\f2:\fP) on Solaris and a semi\-colon (\f2;\fP) on Windows. This option is not necessary if the class is already in the search path.
54.652 +.LP
54.653 +Example of specifying the path to a jar file that contains the class file:
54.654 +.RS 3
54.655 +
54.656 +.LP
54.657 +.LP
54.658 +\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
54.659 +.LP
54.660 +.RE
54.661 +.LP
54.662 +Note that the JAR file name is included.
54.663 +.LP
54.664 +Example of specifying the path to the jar file that contains the class file:
54.665 +.RS 3
54.666 +.LP
54.667 +\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
54.668 +.LP
54.669 +.RE
54.670 +.LP
54.671 +Note that the JAR file name is omitted.
54.672 +.TP 3
54.673 +\-strict
54.674 +During the signing or verifying process, some warning messages may be shown. If this option appears on the command line, the exit code of the tool will reflect the warning messages that are found. Read the "WARNINGS" section for details.
54.675 +.TP 3
54.676 +\-verbose:sub\-options
54.677 +For the verifying process, the \f2\-verbose\fP option takes sub\-options to determine how much information will be shown. If \f2\-certs\fP is also specified, the default mode (or sub\-option all) displays each entry as it is being processed and following that, the certificate information for each signer of the JAR file. If \f2\-certs\fP and the \f2\-verbose:grouped\fP sub\-option are specified, entries with the same signer info are grouped and displayed together along with their certificate information. If \f2\-certs\fP and the \f2\-verbose:summary\fP sub\-option are specified, then entries with the same signer info are grouped and displayed together along with their certificate information but details about each entry are summarized and displayed as "one entry (and more)". See the examples section for more information.
54.678 +.RE
54.679 +.SH "EXAMPLES"
54.680 +.LP
54.681 +
54.682 +.LP
54.683 +.SS
54.684 +Signing a JAR File
54.685 +.LP
54.686 +.RS 3
54.687 +
54.688 +.LP
54.689 +.LP
54.690 +Suppose you have a JAR file named "bundle.jar" and you'd like to sign it using the private key of the user whose keystore alias is "jane" in the keystore named "mystore" in the "working" directory. Suppose the keystore password is "myspass" and the password for \f2jane\fP's private key is "j638klm". You can use the following to sign the JAR file and name the signed JAR file "sbundle.jar":
54.691 +.LP
54.692 +.nf
54.693 +\f3
54.694 +.fl
54.695 + jarsigner \-keystore /working/mystore \-storepass myspass
54.696 +.fl
54.697 + \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
54.698 +.fl
54.699 +\fP
54.700 +.fi
54.701 +
54.702 +.LP
54.703 +.LP
54.704 +Note that there is no \f2\-sigfile\fP specified in the command above, so the generated .SF and .DSA files to be placed in the signed JAR file will have default names based on the alias name. That is, they will be named \f2JANE.SF\fP and \f2JANE.DSA\fP.
54.705 +.LP
54.706 +.LP
54.707 +If you want to be prompted for the store password and the private key password, you could shorten the above command to
54.708 +.LP
54.709 +.nf
54.710 +\f3
54.711 +.fl
54.712 + jarsigner \-keystore /working/mystore
54.713 +.fl
54.714 + \-signedjar sbundle.jar bundle.jar jane
54.715 +.fl
54.716 +\fP
54.717 +.fi
54.718 +
54.719 +.LP
54.720 +.LP
54.721 +If the keystore to be used is the default keystore (the one named ".keystore" in your home directory), you don't need to specify a keystore, as in:
54.722 +.LP
54.723 +.nf
54.724 +\f3
54.725 +.fl
54.726 + jarsigner \-signedjar sbundle.jar bundle.jar jane
54.727 +.fl
54.728 +\fP
54.729 +.fi
54.730 +
54.731 +.LP
54.732 +.LP
54.733 +Finally, if you want the signed JAR file to simply overwrite the input JAR file (\f2bundle.jar\fP), you don't need to specify a \f2\-signedjar\fP option:
54.734 +.LP
54.735 +.nf
54.736 +\f3
54.737 +.fl
54.738 + jarsigner bundle.jar jane
54.739 +.fl
54.740 +\fP
54.741 +.fi
54.742 +.RE
54.743 +
54.744 +.LP
54.745 +.SS
54.746 +Verifying a Signed JAR File
54.747 +.LP
54.748 +.RS 3
54.749 +
54.750 +.LP
54.751 +.LP
54.752 +To verify a signed JAR file, that is, to verify that the signature is valid and the JAR file has not been tampered with, use a command such as the following:
54.753 +.LP
54.754 +.nf
54.755 +\f3
54.756 +.fl
54.757 + jarsigner \-verify sbundle.jar
54.758 +.fl
54.759 +\fP
54.760 +.fi
54.761 +
54.762 +.LP
54.763 +.LP
54.764 +If the verification is successful,
54.765 +.LP
54.766 +.nf
54.767 +\f3
54.768 +.fl
54.769 + jar verified.
54.770 +.fl
54.771 +\fP
54.772 +.fi
54.773 +
54.774 +.LP
54.775 +.LP
54.776 +is displayed. Otherwise, an error message appears.
54.777 +.LP
54.778 +.LP
54.779 +You can get more information if you use the \f2\-verbose\fP option. A sample use of \f3jarsigner\fP with the \f2\-verbose\fP option is shown below, along with sample output:
54.780 +.LP
54.781 +.nf
54.782 +\f3
54.783 +.fl
54.784 + jarsigner \-verify \-verbose sbundle.jar
54.785 +.fl
54.786 +
54.787 +.fl
54.788 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.789 +.fl
54.790 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.791 +.fl
54.792 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.793 +.fl
54.794 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
54.795 +.fl
54.796 + smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
54.797 +.fl
54.798 +
54.799 +.fl
54.800 + s = signature was verified
54.801 +.fl
54.802 + m = entry is listed in manifest
54.803 +.fl
54.804 + k = at least one certificate was found in keystore
54.805 +.fl
54.806 +
54.807 +.fl
54.808 + jar verified.
54.809 +.fl
54.810 +\fP
54.811 +.fi
54.812 +
54.813 +.LP
54.814 +.SS
54.815 +Verification with Certificate Information
54.816 +.LP
54.817 +.LP
54.818 +If you specify the \f2\-certs\fP option when verifying, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file, including the certificate type, the signer distinguished name information (iff it's an X.509 certificate), and, in parentheses, the keystore alias for the signer if the public key certificate in the JAR file matches that in a keystore entry. For example,
54.819 +.LP
54.820 +.nf
54.821 +\f3
54.822 +.fl
54.823 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
54.824 +.fl
54.825 +
54.826 +.fl
54.827 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.828 +.fl
54.829 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.830 +.fl
54.831 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.832 +.fl
54.833 + 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
54.834 +.fl
54.835 + 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
54.836 +.fl
54.837 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
54.838 +.fl
54.839 +
54.840 +.fl
54.841 + X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
54.842 +.fl
54.843 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
54.844 +.fl
54.845 +
54.846 +.fl
54.847 + s = signature was verified
54.848 +.fl
54.849 + m = entry is listed in manifest
54.850 +.fl
54.851 + k = at least one certificate was found in keystore
54.852 +.fl
54.853 +
54.854 +.fl
54.855 + jar verified.
54.856 +.fl
54.857 +\fP
54.858 +.fi
54.859 +
54.860 +.LP
54.861 +.LP
54.862 +If the certificate for a signer is not an X.509 certificate, there is no distinguished name information. In that case, just the certificate type and the alias are shown. For example, if the certificate is a PGP certificate, and the alias is "bob", you'd get
54.863 +.LP
54.864 +.nf
54.865 +\f3
54.866 +.fl
54.867 + PGP, (bob)
54.868 +.fl
54.869 +\fP
54.870 +.fi
54.871 +
54.872 +.LP
54.873 +.SS
54.874 +Verification of a JAR File that Includes Identity Database Signers
54.875 +.LP
54.876 +.LP
54.877 +If a JAR file has been signed using the JDK 1.1 \f3javakey\fP tool, and thus the signer is an alias in an identity database, the verification output includes an "i" symbol. If the JAR file has been signed by both an alias in an identity database and an alias in a keystore, both "k" and "i" appear.
54.878 +.LP
54.879 +.LP
54.880 +When the \f2\-certs\fP option is used, any identity database aliases are shown in square brackets rather than the parentheses used for keystore aliases. For example:
54.881 +.LP
54.882 +.nf
54.883 +\f3
54.884 +.fl
54.885 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
54.886 +.fl
54.887 +
54.888 +.fl
54.889 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.890 +.fl
54.891 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.892 +.fl
54.893 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.894 +.fl
54.895 + 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
54.896 +.fl
54.897 + 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
54.898 +.fl
54.899 + smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
54.900 +.fl
54.901 +
54.902 +.fl
54.903 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
54.904 +.fl
54.905 + X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
54.906 +.fl
54.907 +
54.908 +.fl
54.909 + s = signature was verified
54.910 +.fl
54.911 + m = entry is listed in manifest
54.912 +.fl
54.913 + k = at least one certificate was found in keystore
54.914 +.fl
54.915 + i = at least one certificate was found in identity scope
54.916 +.fl
54.917 +
54.918 +.fl
54.919 + jar verified.
54.920 +.fl
54.921 +\fP
54.922 +.fi
54.923 +
54.924 +.LP
54.925 +.LP
54.926 +Note that the alias "duke" is in brackets to denote that it is an identity database alias, not a keystore alias.
54.927 +.LP
54.928 +.RE
54.929 +.SH "WARNINGS"
54.930 +.LP
54.931 +
54.932 +.LP
54.933 +During the signing/verifying process, jarsigner may display various warnings. These warning codes are defined as follows:
54.934 +.nf
54.935 +\f3
54.936 +.fl
54.937 + hasExpiringCert 2
54.938 +.fl
54.939 + This jar contains entries whose signer certificate will expire within six months
54.940 +.fl
54.941 +
54.942 +.fl
54.943 + hasExpiredCert 4
54.944 +.fl
54.945 + This jar contains entries whose signer certificate has expired.
54.946 +.fl
54.947 +
54.948 +.fl
54.949 + notYetValidCert 4
54.950 +.fl
54.951 + This jar contains entries whose signer certificate is not yet valid.
54.952 +.fl
54.953 +
54.954 +.fl
54.955 + chainNotValidated 4
54.956 +.fl
54.957 + This jar contains entries whose certificate chain cannot be correctly validated.
54.958 +.fl
54.959 +
54.960 +.fl
54.961 + badKeyUsage 8
54.962 +.fl
54.963 + This jar contains entries whose signer certificate's KeyUsage extension doesn't allow code signing.
54.964 +.fl
54.965 +
54.966 +.fl
54.967 + badExtendedKeyUsage 8
54.968 +.fl
54.969 + This jar contains entries whose signer certificate's ExtendedKeyUsage extension
54.970 +.fl
54.971 + doesn't allow code signing.
54.972 +.fl
54.973 +
54.974 +.fl
54.975 + badNetscapeCertType 8
54.976 +.fl
54.977 + This jar contains entries whose signer certificate's NetscapeCertType extension
54.978 +.fl
54.979 + doesn't allow code signing.
54.980 +.fl
54.981 +
54.982 +.fl
54.983 + hasUnsignedEntry 16
54.984 +.fl
54.985 + This jar contains unsigned entries which have not been integrity\-checked.
54.986 +.fl
54.987 +
54.988 +.fl
54.989 + notSignedByAlias 32
54.990 +.fl
54.991 + This jar contains signed entries which are not signed by the specified alias(es)
54.992 +.fl
54.993 +
54.994 +.fl
54.995 + aliasNotInStore 32
54.996 +.fl
54.997 + This jar contains signed entries that are not signed by alias in this keystore
54.998 +.fl
54.999 +
54.1000 +.fl
54.1001 +\fP
54.1002 +.fi
54.1003 +
54.1004 +.LP
54.1005 +.LP
54.1006 +When the \f2\-strict\fP option is provided, an OR\-value of warnings detected will be returned as the exit code of the tool. For example, if a certificate used to sign an entry is expired and has a keyUsage extension that does not allow it to sign a file, an exit code 12 (=4+8) will be returned.
54.1007 +.LP
54.1008 +.LP
54.1009 +\f3Note\fP: Exit codes are reused because only 0\-255 is legal for Unix. In any case, if the signing/verifying process fails, the exit code
54.1010 +.LP
54.1011 +.nf
54.1012 +\f3
54.1013 +.fl
54.1014 +failure 1
54.1015 +.fl
54.1016 +\fP
54.1017 +.fi
54.1018 +
54.1019 +.LP
54.1020 +will be returned.
54.1021 +.SS
54.1022 Compatibility with JDK 1.1
54.1023 .LP
54.1024 .RS 3
54.1025 @@ -443,7 +1391,7 @@
54.1026 .nr 44 \n(83+(3*\n(38)
54.1027 .nr 84 +\n(44
54.1028 .nr TW \n(84
54.1029 -.if t .if \n(TW>\n(.li .tm Table at line 161 file Input is too wide - \n(TW units
54.1030 +.if t .if \n(TW>\n(.li .tm Table at line 1129 file Input is too wide - \n(TW units
54.1031 .fc
54.1032 .nr #T 0-1
54.1033 .nr #a 0-1
54.1034 @@ -642,854 +1590,6 @@
54.1035 .RE
54.1036
54.1037 .LP
54.1038 -.SS
54.1039 -Keystore Aliases
54.1040 -.LP
54.1041 -.RS 3
54.1042 -
54.1043 -.LP
54.1044 -.LP
54.1045 -All keystore entities are accessed via unique \f2aliases\fP.
54.1046 -.LP
54.1047 -.LP
54.1048 -When using \f3jarsigner\fP to sign a JAR file, you must specify the alias for the keystore entry containing the private key needed to generate the signature. For example, the following will sign the JAR file named "MyJARFile.jar", using the private key associated with the alias "duke" in the keystore named "mystore" in the "working" directory. Since no output file is specified, it overwrites MyJARFile.jar with the signed JAR file.
54.1049 -.LP
54.1050 -.nf
54.1051 -\f3
54.1052 -.fl
54.1053 - jarsigner \-keystore /working/mystore \-storepass myspass
54.1054 -.fl
54.1055 - \-keypass dukekeypasswd MyJARFile.jar duke
54.1056 -.fl
54.1057 -\fP
54.1058 -.fi
54.1059 -
54.1060 -.LP
54.1061 -.LP
54.1062 -Keystores are protected with a password, so the store password (in this case "myspass") must be specified. You will be prompted for it if you don't specify it on the command line. Similarly, private keys are protected in a keystore with a password, so the private key's password (in this case "dukekeypasswd") must be specified, and you will be prompted for it if you don't specify it on the command line and it isn't the same as the store password.
54.1063 -.LP
54.1064 -.RE
54.1065 -.SS
54.1066 -Keystore Location
54.1067 -.LP
54.1068 -.RS 3
54.1069 -
54.1070 -.LP
54.1071 -.LP
54.1072 -\f3jarsigner\fP has a \f2\-keystore\fP option for specifying the URL of the keystore to be used. The keystore is by default stored in a file named \f2.keystore\fP in the user's home directory, as determined by the \f2user.home\fP system property. On Solaris systems \f2user.home\fP defaults to the user's home directory.
54.1073 -.LP
54.1074 -.LP
54.1075 -Note that the input stream from the \f2\-keystore\fP option is passed to the \f2KeyStore.load\fP method. If \f2NONE\fP is specified as the URL, then a null stream is passed to the \f2KeyStore.load\fP method. \f2NONE\fP should be specified if the \f2KeyStore\fP is not file\-based, for example, if it resides on a hardware token device.
54.1076 -.LP
54.1077 -.RE
54.1078 -.SS
54.1079 -Keystore Implementation
54.1080 -.LP
54.1081 -.RS 3
54.1082 -
54.1083 -.LP
54.1084 -.LP
54.1085 -The \f2KeyStore\fP class provided in the \f2java.security\fP package supplies well\-defined interfaces to access and modify the information in a keystore. It is possible for there to be multiple different concrete implementations, where each implementation is that for a particular \f2type\fP of keystore.
54.1086 -.LP
54.1087 -.LP
54.1088 -Currently, there are two command\-line tools that make use of keystore implementations (\f3keytool\fP and \f3jarsigner\fP), and also a GUI\-based tool named \f3Policy Tool\fP. Since \f2KeyStore\fP is publicly available, Java 2 SDK users can write additional security applications that use it.
54.1089 -.LP
54.1090 -.LP
54.1091 -There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
54.1092 -.LP
54.1093 -.LP
54.1094 -Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a provider and supply a KeystoreSpi subclass implementation, as described in
54.1095 -.na
54.1096 -\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
54.1097 -.fi
54.1098 -http://java.sun.com/javase/6/docs/technotes/guides/security/HowToImplAProvider.html.
54.1099 -.LP
54.1100 -.LP
54.1101 -Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
54.1102 -.LP
54.1103 -.LP
54.1104 -\f3keytool\fP works on any file\-based keystore implementation. (It treats the keytore location that is passed to it at the command line as a filename and converts it to a FileInputStream, from which it loads the keystore information.) The \f3jarsigner\fP and \f3policytool\fP tools, on the other hand, can read a keystore from any location that can be specified using a URL.
54.1105 -.LP
54.1106 -.LP
54.1107 -For \f3jarsigner\fP and \f3keytool\fP, you can specify a keystore type at the command line, via the \f2\-storetype\fP option. For \f3Policy Tool\fP, you can specify a keystore type via the "Change Keystore" command in the Edit menu.
54.1108 -.LP
54.1109 -.LP
54.1110 -If you don't explicitly specify a keystore type, the tools choose a keystore implementation based simply on the value of the \f2keystore.type\fP property specified in the security properties file. The security properties file is called \f2java.security\fP, and it resides in the SDK security properties directory, \f2java.home\fP/lib/security, where \f2java.home\fP is the runtime environment's directory (the \f2jre\fP directory in the SDK or the top\-level directory of the Java 2 Runtime Environment).
54.1111 -.LP
54.1112 -.LP
54.1113 -Each tool gets the \f2keystore.type\fP value and then examines all the currently\-installed providers until it finds one that implements keystores of that type. It then uses the keystore implementation from that provider.
54.1114 -.LP
54.1115 -.LP
54.1116 -The \f2KeyStore\fP class defines a static method named \f2getDefaultType\fP that lets applications and applets retrieve the value of the \f2keystore.type\fP property. The following line of code creates an instance of the default keystore type (as specified in the \f2keystore.type\fP property):
54.1117 -.LP
54.1118 -.nf
54.1119 -\f3
54.1120 -.fl
54.1121 - KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
54.1122 -.fl
54.1123 -\fP
54.1124 -.fi
54.1125 -
54.1126 -.LP
54.1127 -.LP
54.1128 -The default keystore type is "jks" (the proprietary type of the keystore implementation provided by Sun). This is specified by the following line in the security properties file:
54.1129 -.LP
54.1130 -.nf
54.1131 -\f3
54.1132 -.fl
54.1133 - keystore.type=jks
54.1134 -.fl
54.1135 -\fP
54.1136 -.fi
54.1137 -
54.1138 -.LP
54.1139 -.LP
54.1140 -Note: Case doesn't matter in keystore type designations. For example, "JKS" would be considered the same as "jks".
54.1141 -.LP
54.1142 -.LP
54.1143 -To have the tools utilize a keystore implementation other than the default, change that line to specify a different keystore type. For example, if you have a provider package that supplies a keystore implementation for a keystore type called "pkcs12", change the line to
54.1144 -.LP
54.1145 -.nf
54.1146 -\f3
54.1147 -.fl
54.1148 - keystore.type=pkcs12
54.1149 -.fl
54.1150 -\fP
54.1151 -.fi
54.1152 -
54.1153 -.LP
54.1154 -.LP
54.1155 -Note that if you us the PKCS#11 provider package, you should refer to the
54.1156 -.na
54.1157 -\f2KeyTool and JarSigner\fP @
54.1158 -.fi
54.1159 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#keytooljarsigner section of the Java PKCS#11 Reference Guide for details.
54.1160 -.LP
54.1161 -.RE
54.1162 -.RE
54.1163 -.SS
54.1164 -Supported Algorithms
54.1165 -.LP
54.1166 -.RS 3
54.1167 -
54.1168 -.LP
54.1169 -.LP
54.1170 -By default, \f3jarsigner\fP signs a JAR file using either
54.1171 -.LP
54.1172 -.RS 3
54.1173 -.TP 2
54.1174 -o
54.1175 -DSA (Digital Signature Algorithm) with the SHA\-1 digest algorithm, or
54.1176 -.TP 2
54.1177 -o
54.1178 -the RSA algorithm with the MD5 digest algorithm.
54.1179 -.RE
54.1180 -
54.1181 -.LP
54.1182 -.LP
54.1183 -That is, if the signer's public and private keys are DSA keys, \f3jarsigner\fP will sign the JAR file using the "SHA1withDSA" algorithm. If the signer's keys are RSA keys, \f3jarsigner\fP will attempt to sign the JAR file using the "MD5withRSA" algorithm.
54.1184 -.LP
54.1185 -.LP
54.1186 -These default signature algorithms can be overridden using the \f2\-sigalg\fP option.
54.1187 -.LP
54.1188 -.RE
54.1189 -.SS
54.1190 -The Signed JAR File
54.1191 -.LP
54.1192 -.RS 3
54.1193 -
54.1194 -.LP
54.1195 -.LP
54.1196 -When \f3jarsigner\fP is used to sign a JAR file, the output signed JAR file is exactly the same as the input JAR file, except that it has two additional files placed in the META\-INF directory:
54.1197 -.LP
54.1198 -.RS 3
54.1199 -.TP 2
54.1200 -o
54.1201 -a signature file, with a .SF extension, and
54.1202 -.TP 2
54.1203 -o
54.1204 -a signature block file, with a .DSA extension.
54.1205 -.RE
54.1206 -
54.1207 -.LP
54.1208 -.LP
54.1209 -The base file names for these two files come from the value of the \f2\-sigFile\fP option. For example, if the option appears as
54.1210 -.LP
54.1211 -.nf
54.1212 -\f3
54.1213 -.fl
54.1214 - \-sigFile MKSIGN
54.1215 -.fl
54.1216 -\fP
54.1217 -.fi
54.1218 -
54.1219 -.LP
54.1220 -.LP
54.1221 -the files are named "MKSIGN.SF" and "MKSIGN.DSA".
54.1222 -.LP
54.1223 -.LP
54.1224 -If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not allowed in a signature file name, each such character is converted to an underscore ("_") character in forming the file name. Legal characters include letters, digits, underscores, and hyphens.
54.1225 -.LP
54.1226 -\f3The Signature (.SF) File\fP
54.1227 -.LP
54.1228 -.RS 3
54.1229 -
54.1230 -.LP
54.1231 -.LP
54.1232 -A signature file (the .SF file) looks similar to the manifest file that is always included in a JAR file when \f3jarsigner\fP is used to sign the file. That is, for each source file included in the JAR file, the .SF file has three lines, just as in the manifest file, listing the following:
54.1233 -.LP
54.1234 -.RS 3
54.1235 -.TP 2
54.1236 -o
54.1237 -the file name,
54.1238 -.TP 2
54.1239 -o
54.1240 -the name of the digest algorithm used (SHA), and
54.1241 -.TP 2
54.1242 -o
54.1243 -a SHA digest value.
54.1244 -.RE
54.1245 -
54.1246 -.LP
54.1247 -.LP
54.1248 -In the manifest file, the SHA digest value for each source file is the digest (hash) of the binary data in the source file. In the .SF file, on the other hand, the digest value for a given source file is the hash of the three lines in the manifest file for the source file.
54.1249 -.LP
54.1250 -.LP
54.1251 -The signature file also, by default, includes a header containing a hash of the whole manifest file. The presence of the header enables verification optimization, as described in JAR File Verification.
54.1252 -.LP
54.1253 -.RE
54.1254 -\f3The Signature Block (.DSA) File\fP
54.1255 -.LP
54.1256 -.RS 3
54.1257 -
54.1258 -.LP
54.1259 -.LP
54.1260 -The .SF file is signed and the signature is placed in the .DSA file. The .DSA file also contains, encoded inside it, the certificate or certificate chain from the keystore which authenticates the public key corresponding to the private key used for signing.
54.1261 -.LP
54.1262 -.RE
54.1263 -.RE
54.1264 -.SS
54.1265 -Signature Timestamp
54.1266 -.LP
54.1267 -.RS 3
54.1268 -
54.1269 -.LP
54.1270 -.LP
54.1271 -As of the J2SE 5.0 release, the \f2jarsigner\fP tool can now generate and store a signature timestamp when signing a JAR file. In addition, \f2jarsigner\fP supports alternative signing mechanisms. This behavior is optional and is controlled by the user at the time of signing through these options:
54.1272 -.LP
54.1273 -.RS 3
54.1274 -.TP 2
54.1275 -o
54.1276 -\f2\-tsa url\fP
54.1277 -.TP 2
54.1278 -o
54.1279 -\f2\-tsacert alias\fP
54.1280 -.TP 2
54.1281 -o
54.1282 -\f2\-altsigner class\fP
54.1283 -.TP 2
54.1284 -o
54.1285 -\f2\-altsignerpath classpathlist\fP
54.1286 -.RE
54.1287 -
54.1288 -.LP
54.1289 -.LP
54.1290 -Each of these options is detailed in the Options section below.
54.1291 -.LP
54.1292 -.RE
54.1293 -.SS
54.1294 -JAR File Verification
54.1295 -.LP
54.1296 -.RS 3
54.1297 -
54.1298 -.LP
54.1299 -.LP
54.1300 -A successful JAR file verification occurs if the signature(s) are valid, and none of the files that were in the JAR file when the signatures were generated have been changed since then. JAR file verification involves the following steps:
54.1301 -.LP
54.1302 -.RS 3
54.1303 -.TP 3
54.1304 -1.
54.1305 -Verify the signature of the .SF file itself.
54.1306 -.LP
54.1307 -That is, the verification ensures that the signature stored in each signature block (.DSA) file was in fact generated using the private key corresponding to the public key whose certificate (or certificate chain) also appears in the .DSA file. It also ensures that the signature is a valid signature of the corresponding signature (.SF) file, and thus the .SF file has not been tampered with.
54.1308 -.TP 3
54.1309 -2.
54.1310 -Verify the digest listed in each entry in the .SF file with each corresponding section in the manifest.
54.1311 -.LP
54.1312 -The .SF file by default includes a header containing a hash of the entire manifest file. When the header is present, then the verification can check to see whether or not the hash in the header indeed matches the hash of the manifest file. If that is the case, verification proceeds to the next step.
54.1313 -.LP
54.1314 -If that is not the case, a less optimized verification is required to ensure that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file (see The Signature (.SF) File).
54.1315 -.LP
54.1316 -One reason the hash of the manifest file that is stored in the .SF file header may not equal the hash of the current manifest file would be because one or more files were added to the JAR file (using the \f2jar\fP tool) after the signature (and thus the .SF file) was generated. When the \f2jar\fP tool is used to add files, the manifest file is changed (sections are added to it for the new files), but the .SF file is not. A verification is still considered successful if none of the files that were in the JAR file when the signature was generated have been changed since then, which is the case if the hashes in the non\-header sections of the .SF file equal the hashes of the corresponding sections in the manifest file.
54.1317 -.TP 3
54.1318 -3.
54.1319 -Read each file in the JAR file that has an entry in the .SF file. While reading, compute the file's digest, and then compare the result with the digest for this file in the manifest section. The digests should be the same, or verification fails.
54.1320 -.RE
54.1321 -
54.1322 -.LP
54.1323 -.LP
54.1324 -If any serious verification failures occur during the verification process, the process is stopped and a security exception is thrown. It is caught and displayed by \f3jarsigner\fP.
54.1325 -.LP
54.1326 -.RE
54.1327 -.SS
54.1328 -Multiple Signatures for a JAR File
54.1329 -.LP
54.1330 -.RS 3
54.1331 -
54.1332 -.LP
54.1333 -.LP
54.1334 -A JAR file can be signed by multiple people simply by running the \f3jarsigner\fP tool on the file multiple times, specifying the alias for a different person each time, as in:
54.1335 -.LP
54.1336 -.nf
54.1337 -\f3
54.1338 -.fl
54.1339 - jarsigner myBundle.jar susan
54.1340 -.fl
54.1341 - jarsigner myBundle.jar kevin
54.1342 -.fl
54.1343 -\fP
54.1344 -.fi
54.1345 -
54.1346 -.LP
54.1347 -.LP
54.1348 -When a JAR file is signed multiple times, there are multiple .SF and .DSA files in the resulting JAR file, one pair for each signature. Thus, in the example above, the output JAR file includes files with the following names:
54.1349 -.LP
54.1350 -.nf
54.1351 -\f3
54.1352 -.fl
54.1353 - SUSAN.SF
54.1354 -.fl
54.1355 - SUSAN.DSA
54.1356 -.fl
54.1357 - KEVIN.SF
54.1358 -.fl
54.1359 - KEVIN.DSA
54.1360 -.fl
54.1361 -\fP
54.1362 -.fi
54.1363 -
54.1364 -.LP
54.1365 -.LP
54.1366 -Note: It is also possible for a JAR file to have mixed signatures, some generated by the JDK 1.1 \f3javakey\fP tool and others by \f3jarsigner\fP. That is, \f3jarsigner\fP can be used to sign JAR files already previously signed using \f3javakey\fP.
54.1367 -.LP
54.1368 -.RE
54.1369 -.SH "OPTIONS"
54.1370 -.LP
54.1371 -
54.1372 -.LP
54.1373 -.LP
54.1374 -The various \f3jarsigner\fP options are listed and described below. Note:
54.1375 -.LP
54.1376 -.RS 3
54.1377 -.TP 2
54.1378 -o
54.1379 -All option names are preceded by a minus sign (\-).
54.1380 -.TP 2
54.1381 -o
54.1382 -The options may be provided in any order.
54.1383 -.TP 2
54.1384 -o
54.1385 -Items in italics (option values) represent the actual values that must be supplied.
54.1386 -.TP 2
54.1387 -o
54.1388 -The \f2\-keystore\fP, \f2\-storepass\fP, \f2\-keypass\fP, \f2\-sigfile\fP, \f2\-sigalg\fP, \f2\-digestalg\fP, and \f2\-signedjar\fP options are only relevant when signing a JAR file, not when verifying a signed JAR file. Similarly, an alias is only specified on the command line when signing a JAR file.
54.1389 -.RE
54.1390 -
54.1391 -.LP
54.1392 -.RS 3
54.1393 -.TP 3
54.1394 -\-keystore url
54.1395 -Specifies the URL that tells the keystore location. This defaults to the file \f2.keystore\fP in the user's home directory, as determined by the "user.home" system property.
54.1396 -.LP
54.1397 -A keystore is required when signing, so you must explicitly specify one if the default keystore does not exist (or you want to use one other than the default).
54.1398 -.LP
54.1399 -A keystore is \f2not\fP required when verifying, but if one is specified, or the default exists, and the \f2\-verbose\fP option was also specified, additional information is output regarding whether or not any of the certificates used to verify the JAR file are contained in that keystore.
54.1400 -.LP
54.1401 -Note: the \f2\-keystore\fP argument can actually be a file name (and path) specification rather than a URL, in which case it will be treated the same as a "file:" URL. That is,
54.1402 -.nf
54.1403 -\f3
54.1404 -.fl
54.1405 - \-keystore \fP\f4filePathAndName\fP\f3
54.1406 -.fl
54.1407 -\fP
54.1408 -.fi
54.1409 -is treated as equivalent to
54.1410 -.nf
54.1411 -\f3
54.1412 -.fl
54.1413 - \-keystore file:\fP\f4filePathAndName\fP\f3
54.1414 -.fl
54.1415 -\fP
54.1416 -.fi
54.1417 -If the Sun PKCS#11 provider has been configured in the \f2java.security\fP security properties file (located in the JRE's \f2$JAVA_HOME/lib/security\fP directory), then keytool and jarsigner can operate on the PKCS#11 token by specifying these options:
54.1418 -.RS 3
54.1419 -.TP 2
54.1420 -o
54.1421 -\f2\-keystore NONE\fP
54.1422 -.TP 2
54.1423 -o
54.1424 -\f2\-storetype PKCS11\fP
54.1425 -.RE
54.1426 -For example, this command lists the contents of the configured PKCS#11 token:
54.1427 -.RS 3
54.1428 -
54.1429 -.LP
54.1430 -.nf
54.1431 -\f3
54.1432 -.fl
54.1433 - jarsigner \-keystore NONE \-storetype PKCS11 \-list
54.1434 -.fl
54.1435 -
54.1436 -.fl
54.1437 -\fP
54.1438 -.fi
54.1439 -.RE
54.1440 -.TP 3
54.1441 -\-storetype storetype
54.1442 -Specifies the type of keystore to be instantiated. The default keystore type is the one that is specified as the value of the "keystore.type" property in the security properties file, which is returned by the static \f2getDefaultType\fP method in \f2java.security.KeyStore\fP.
54.1443 -.LP
54.1444 -The PIN for a PCKS#11 token can also be specified using the \f2\-storepass\fP option. If none has been specified, keytool and jarsigner will prompt for the token PIN. If the token has a protected authentication path (such as a dedicated PIN\-pad or a biometric reader), then the \f2\-protected\fP option must be specified and no password options can be specified.
54.1445 -.TP 3
54.1446 -\-storepass password
54.1447 -Specifies the password which is required to access the keystore. This is only needed when signing (not verifying) a JAR file. In that case, if a \f2\-storepass\fP option is not provided at the command line, the user is prompted for the password.
54.1448 -.LP
54.1449 -Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
54.1450 -.TP 3
54.1451 -\-keypass password
54.1452 -Specifies the password used to protect the private key of the keystore entry addressed by the alias specified on the command line. The password is required when using \f3jarsigner\fP to sign a JAR file. If no password is provided on the command line, and the required password is different from the store password, the user is prompted for it.
54.1453 -.LP
54.1454 -Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
54.1455 -.TP 3
54.1456 -\-sigfile file
54.1457 -Specifies the base file name to be used for the generated .SF and .DSA files. For example, if \f2file\fP is "DUKESIGN", the generated .SF and .DSA files will be named "DUKESIGN.SF" and "DUKESIGN.DSA", and will be placed in the "META\-INF" directory of the signed JAR file.
54.1458 -.LP
54.1459 -The characters in \f2file\fP must come from the set "a\-zA\-Z0\-9_\-". That is, only letters, numbers, underscore, and hyphen characters are allowed. Note: All lowercase characters will be converted to uppercase for the .SF and .DSA file names.
54.1460 -.LP
54.1461 -If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not legal in a signature file name, each such character is converted to an underscore ("_") character in forming the file name.
54.1462 -.TP 3
54.1463 -\-sigalg algorithm
54.1464 -.RS 3
54.1465 -
54.1466 -.LP
54.1467 -Specifies the name of the signature algorithm to use to sign the JAR file.
54.1468 -.LP
54.1469 -See
54.1470 -.na
54.1471 -\f2Appendix A\fP @
54.1472 -.fi
54.1473 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa of the Java Cryptography Architecture for a list of standard signature algorithm names. This algorithm must be compatible with the private key used to sign the JAR file. If this option is not specified, SHA1withDSA or MD5withRSA will be used depending on the type of private key. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
54.1474 -.LP
54.1475 -.RE
54.1476 -.TP 3
54.1477 -\-digestalg algorithm
54.1478 -.RS 3
54.1479 -Specifies the name of the message digest algorithm to use when digesting the entries of a jar file.
54.1480 -.LP
54.1481 -See
54.1482 -.na
54.1483 -\f2Appendix A\fP @
54.1484 -.fi
54.1485 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa of the Java Cryptography Architecture for a list of standard message digest algorithm names. If this option is not specified, SHA\-1 will be used. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
54.1486 -.LP
54.1487 -.RE
54.1488 -.TP 3
54.1489 -\-signedjar file
54.1490 -Specifies the name to be used for the signed JAR file.
54.1491 -.LP
54.1492 -If no name is specified on the command line, the name used is the same as the input JAR file name (the name of the JAR file to be signed); in other words, that file is overwritten with the signed JAR file.
54.1493 -.TP 3
54.1494 -\-verify
54.1495 -If this appears on the command line, the specified JAR file will be verified, not signed. If the verification is successful, "jar verified" will be displayed. If you try to verify an unsigned JAR file, or a JAR file signed with an unsupported algorithm (e.g., RSA when you don't have an RSA provider installed), the following is displayed: "jar is unsigned. (signatures missing or not parsable)"
54.1496 -.LP
54.1497 -It is possible to verify JAR files signed using either \f3jarsigner\fP or the JDK 1.1 \f3javakey\fP tool, or both.
54.1498 -.LP
54.1499 -For further information on verification, see JAR File Verification.
54.1500 -.TP 3
54.1501 -\-certs
54.1502 -If this appears on the command line, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file. This information includes
54.1503 -.RS 3
54.1504 -.TP 2
54.1505 -o
54.1506 -the name of the type of certificate (stored in the .DSA file) that certifies the signer's public key
54.1507 -.TP 2
54.1508 -o
54.1509 -if the certificate is an X.509 certificate (more specifically, an instance of \f2java.security.cert.X509Certificate\fP): the distinguished name of the signer
54.1510 -.RE
54.1511 -.LP
54.1512 -The keystore is also examined. If no keystore value is specified on the command line, the default keystore file (if any) will be checked. If the public key certificate for a signer matches an entry in the keystore, then the following information will also be displayed:
54.1513 -.RS 3
54.1514 -.TP 2
54.1515 -o
54.1516 -in parentheses, the alias name for the keystore entry for that signer. If the signer actually comes from a JDK 1.1 identity database instead of from a keystore, the alias name will appear in brackets instead of parentheses.
54.1517 -.RE
54.1518 -.TP 3
54.1519 -\-verbose
54.1520 -If this appears on the command line, it indicates "verbose" mode, which causes \f3jarsigner\fP to output extra information as to the progress of the JAR signing or verification.
54.1521 -.TP 3
54.1522 -\-internalsf
54.1523 -In the past, the .DSA (signature block) file generated when a JAR file was signed used to include a complete encoded copy of the .SF file (signature file) also generated. This behavior has been changed. To reduce the overall size of the output JAR file, the .DSA file by default doesn't contain a copy of the .SF file anymore. But if \f2\-internalsf\fP appears on the command line, the old behavior is utilized. \f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
54.1524 -.TP 3
54.1525 -\-sectionsonly
54.1526 -If this appears on the command line, the .SF file (signature file) generated when a JAR file is signed does \f2not\fP include a header containing a hash of the whole manifest file. It just contains information and hashes related to each individual source file included in the JAR file, as described in The Signature (.SF) File .
54.1527 -.LP
54.1528 -By default, this header is added, as an optimization. When the header is present, then whenever the JAR file is verified, the verification can first check to see whether or not the hash in the header indeed matches the hash of the whole manifest file. If so, verification proceeds to the next step. If not, it is necessary to do a less optimized verification that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file.
54.1529 -.LP
54.1530 -For further information, see JAR File Verification.
54.1531 -.LP
54.1532 -\f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
54.1533 -.TP 3
54.1534 -\-protected
54.1535 -Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
54.1536 -.RE
54.1537 -.RS 3
54.1538 -.TP 3
54.1539 -\-provider provider\-class\-name
54.1540 -Used to specify the name of cryptographic service provider's master class file when the service provider is not listed in the security properties file, \f2java.security\fP.
54.1541 -.LP
54.1542 -Used in conjunction with the \f2\-providerArg\fP \f2ConfigFilePath\fP option, keytool and jarsigner will install the provider dynamically (where \f2ConfigFilePath\fP is the path to the token configuration file). Here's an example of a command to list a PKCS#11 keystore when the Sun PKCS#11 provider has not been configured in the security properties file.
54.1543 -.RS 3
54.1544 -
54.1545 -.LP
54.1546 -.nf
54.1547 -\f3
54.1548 -.fl
54.1549 -jarsigner \-keystore NONE \-storetype PKCS11 \\
54.1550 -.fl
54.1551 - \-providerClass sun.security.pkcs11.SunPKCS11 \\
54.1552 -.fl
54.1553 - \-providerArg /foo/bar/token.config \\
54.1554 -.fl
54.1555 - \-list
54.1556 -.fl
54.1557 -\fP
54.1558 -.fi
54.1559 -.RE
54.1560 -.TP 3
54.1561 -\-providerName providerName
54.1562 -If more than one provider has been configured in the \f2java.security\fP security properties file, you can use the \f2\-providerName\fP option to target a specific provider instance. The argument to this option is the name of the provider.
54.1563 -.LP
54.1564 -For the Sun PKCS#11 provider, \f2providerName\fP is of the form \f2SunPKCS11\-\fP\f2TokenName\fP, where \f2TokenName\fP is the name suffix that the provider instance has been configured with, as detailed in the
54.1565 -.na
54.1566 -\f2configuration attributes table\fP @
54.1567 -.fi
54.1568 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner#ATTRS. For example, the following command lists the contents of the PKCS#11 keystore provider instance with name suffix \f2SmartCard\fP:
54.1569 -.RS 3
54.1570 -
54.1571 -.LP
54.1572 -.nf
54.1573 -\f3
54.1574 -.fl
54.1575 -jarsigner \-keystore NONE \-storetype PKCS11 \\
54.1576 -.fl
54.1577 - \-providerName SunPKCS11\-SmartCard \\
54.1578 -.fl
54.1579 - \-list
54.1580 -.fl
54.1581 -\fP
54.1582 -.fi
54.1583 -.RE
54.1584 -.TP 3
54.1585 -\-Jjavaoption
54.1586 -Passes through the specified \f2javaoption\fP string directly to the Java interpreter. (\f3jarsigner\fP is actually a "wrapper" around the interpreter.) This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
54.1587 -.LP
54.1588 -.TP 3
54.1589 -\-tsa url
54.1590 -If \f2"\-tsa http://example.tsa.url"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The URL, \f2http://example.tsa.url\fP, identifies the location of the Time Stamping Authority (TSA). It overrides any URL found via the \f2\-tsacert\fP option. The \f2\-tsa\fP option does not require the TSA's public key certificate to be present in the keystore.
54.1591 -.LP
54.1592 -To generate the timestamp, \f2jarsigner\fP communicates with the TSA using the Time\-Stamp Protocol (TSP) defined in
54.1593 -.na
54.1594 -\f2RFC 3161\fP @
54.1595 -.fi
54.1596 -http://www.ietf.org/rfc/rfc3161.txt. If successful, the timestamp token returned by the TSA is stored along with the signature in the signature block file.
54.1597 -.LP
54.1598 -.TP 3
54.1599 -\-tsacert alias
54.1600 -If \f2"\-tsacert alias"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The \f2alias\fP identifies the TSA's public key certificate in the keystore that is currently in effect. The entry's certificate is examined for a Subject Information Access extension that contains a URL identifying the location of the TSA.
54.1601 -.LP
54.1602 -The TSA's public key certificate must be present in the keystore when using \f2\-tsacert\fP.
54.1603 -.LP
54.1604 -.TP 3
54.1605 -\-altsigner class
54.1606 -Specifies that an alternative signing mechanism be used. The fully\-qualified class name identifies a class file that extends the \f2com.sun.jarsigner.ContentSigner abstract class\fP. The path to this class file is defined by the \f2\-altsignerpath\fP option. If the \f2\-altsigner\fP option is used, \f2jarsigner\fP uses the signing mechanism provided by the specified class. Otherwise, \f2jarsigner\fP uses its default signing mechanism.
54.1607 -.LP
54.1608 -For example, to use the signing mechanism provided by a class named \f2com.sun.sun.jarsigner.AuthSigner\fP, use the \f2jarsigner\fP option \f2"\-altsigner com.sun.jarsigner.AuthSigner"\fP
54.1609 -.LP
54.1610 -.TP 3
54.1611 -\-altsignerpath classpathlist
54.1612 -Specifies the path to the class file (the class file name is specified with the \f2\-altsigner\fP option described above) and any JAR files it depends on. If the class file is in a JAR file, then this specifies the path to that JAR file, as shown in the example below.
54.1613 -.LP
54.1614 -An absolute path or a path relative to the current directory may be specified. If \f2classpathlist\fP contains multiple paths or JAR files, they should be separated with a colon (\f2:\fP) on Solaris and a semi\-colon (\f2;\fP) on Windows. This option is not necessary if the class is already in the search path.
54.1615 -.LP
54.1616 -Example of specifying the path to a jar file that contains the class file:
54.1617 -.RS 3
54.1618 -
54.1619 -.LP
54.1620 -.LP
54.1621 -\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
54.1622 -.LP
54.1623 -.RE
54.1624 -.LP
54.1625 -Note that the JAR file name is included.
54.1626 -.LP
54.1627 -Example of specifying the path to the jar file that contains the class file:
54.1628 -.RS 3
54.1629 -.LP
54.1630 -\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
54.1631 -.LP
54.1632 -.RE
54.1633 -.LP
54.1634 -Note that the JAR file name is omitted.
54.1635 -.RE
54.1636 -.SH "EXAMPLES"
54.1637 -.LP
54.1638 -
54.1639 -.LP
54.1640 -.SS
54.1641 -Signing a JAR File
54.1642 -.LP
54.1643 -.RS 3
54.1644 -
54.1645 -.LP
54.1646 -.LP
54.1647 -Suppose you have a JAR file named "bundle.jar" and you'd like to sign it using the private key of the user whose keystore alias is "jane" in the keystore named "mystore" in the "working" directory. Suppose the keystore password is "myspass" and the password for \f2jane\fP's private key is "j638klm". You can use the following to sign the JAR file and name the signed JAR file "sbundle.jar":
54.1648 -.LP
54.1649 -.nf
54.1650 -\f3
54.1651 -.fl
54.1652 - jarsigner \-keystore /working/mystore \-storepass myspass
54.1653 -.fl
54.1654 - \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
54.1655 -.fl
54.1656 -\fP
54.1657 -.fi
54.1658 -
54.1659 -.LP
54.1660 -.LP
54.1661 -Note that there is no \f2\-sigfile\fP specified in the command above, so the generated .SF and .DSA files to be placed in the signed JAR file will have default names based on the alias name. That is, they will be named \f2JANE.SF\fP and \f2JANE.DSA\fP.
54.1662 -.LP
54.1663 -.LP
54.1664 -If you want to be prompted for the store password and the private key password, you could shorten the above command to
54.1665 -.LP
54.1666 -.nf
54.1667 -\f3
54.1668 -.fl
54.1669 - jarsigner \-keystore /working/mystore
54.1670 -.fl
54.1671 - \-signedjar sbundle.jar bundle.jar jane
54.1672 -.fl
54.1673 -\fP
54.1674 -.fi
54.1675 -
54.1676 -.LP
54.1677 -.LP
54.1678 -If the keystore to be used is the default keystore (the one named ".keystore" in your home directory), you don't need to specify a keystore, as in:
54.1679 -.LP
54.1680 -.nf
54.1681 -\f3
54.1682 -.fl
54.1683 - jarsigner \-signedjar sbundle.jar bundle.jar jane
54.1684 -.fl
54.1685 -\fP
54.1686 -.fi
54.1687 -
54.1688 -.LP
54.1689 -.LP
54.1690 -Finally, if you want the signed JAR file to simply overwrite the input JAR file (\f2bundle.jar\fP), you don't need to specify a \f2\-signedjar\fP option:
54.1691 -.LP
54.1692 -.nf
54.1693 -\f3
54.1694 -.fl
54.1695 - jarsigner bundle.jar jane
54.1696 -.fl
54.1697 -\fP
54.1698 -.fi
54.1699 -.RE
54.1700 -
54.1701 -.LP
54.1702 -.SS
54.1703 -Verifying a Signed JAR File
54.1704 -.LP
54.1705 -.RS 3
54.1706 -
54.1707 -.LP
54.1708 -.LP
54.1709 -To verify a signed JAR file, that is, to verify that the signature is valid and the JAR file has not been tampered with, use a command such as the following:
54.1710 -.LP
54.1711 -.nf
54.1712 -\f3
54.1713 -.fl
54.1714 - jarsigner \-verify sbundle.jar
54.1715 -.fl
54.1716 -\fP
54.1717 -.fi
54.1718 -
54.1719 -.LP
54.1720 -.LP
54.1721 -If the verification is successful,
54.1722 -.LP
54.1723 -.nf
54.1724 -\f3
54.1725 -.fl
54.1726 - jar verified.
54.1727 -.fl
54.1728 -\fP
54.1729 -.fi
54.1730 -
54.1731 -.LP
54.1732 -.LP
54.1733 -is displayed. Otherwise, an error message appears.
54.1734 -.LP
54.1735 -.LP
54.1736 -You can get more information if you use the \f2\-verbose\fP option. A sample use of \f3jarsigner\fP with the \f2\-verbose\fP option is shown below, along with sample output:
54.1737 -.LP
54.1738 -.nf
54.1739 -\f3
54.1740 -.fl
54.1741 - jarsigner \-verify \-verbose sbundle.jar
54.1742 -.fl
54.1743 -
54.1744 -.fl
54.1745 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.1746 -.fl
54.1747 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.1748 -.fl
54.1749 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.1750 -.fl
54.1751 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
54.1752 -.fl
54.1753 - smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
54.1754 -.fl
54.1755 -
54.1756 -.fl
54.1757 - s = signature was verified
54.1758 -.fl
54.1759 - m = entry is listed in manifest
54.1760 -.fl
54.1761 - k = at least one certificate was found in keystore
54.1762 -.fl
54.1763 -
54.1764 -.fl
54.1765 - jar verified.
54.1766 -.fl
54.1767 -\fP
54.1768 -.fi
54.1769 -
54.1770 -.LP
54.1771 -.SS
54.1772 -Verification with Certificate Information
54.1773 -.LP
54.1774 -.LP
54.1775 -If you specify the \f2\-certs\fP option when verifying, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file, including the certificate type, the signer distinguished name information (iff it's an X.509 certificate), and, in parentheses, the keystore alias for the signer if the public key certificate in the JAR file matches that in a keystore entry. For example,
54.1776 -.LP
54.1777 -.nf
54.1778 -\f3
54.1779 -.fl
54.1780 - jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
54.1781 -.fl
54.1782 -
54.1783 -.fl
54.1784 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.1785 -.fl
54.1786 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.1787 -.fl
54.1788 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.1789 -.fl
54.1790 - 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
54.1791 -.fl
54.1792 - 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
54.1793 -.fl
54.1794 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
54.1795 -.fl
54.1796 -
54.1797 -.fl
54.1798 - X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
54.1799 -.fl
54.1800 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
54.1801 -.fl
54.1802 -
54.1803 -.fl
54.1804 - s = signature was verified
54.1805 -.fl
54.1806 - m = entry is listed in manifest
54.1807 -.fl
54.1808 - k = at least one certificate was found in keystore
54.1809 -.fl
54.1810 -
54.1811 -.fl
54.1812 - jar verified.
54.1813 -.fl
54.1814 -\fP
54.1815 -.fi
54.1816 -
54.1817 -.LP
54.1818 -.LP
54.1819 -If the certificate for a signer is not an X.509 certificate, there is no distinguished name information. In that case, just the certificate type and the alias are shown. For example, if the certificate is a PGP certificate, and the alias is "bob", you'd get
54.1820 -.LP
54.1821 -.nf
54.1822 -\f3
54.1823 -.fl
54.1824 - PGP, (bob)
54.1825 -.fl
54.1826 -\fP
54.1827 -.fi
54.1828 -
54.1829 -.LP
54.1830 -.SS
54.1831 -Verification of a JAR File that Includes Identity Database Signers
54.1832 -.LP
54.1833 -.LP
54.1834 -If a JAR file has been signed using the JDK 1.1 \f3javakey\fP tool, and thus the signer is an alias in an identity database, the verification output includes an "i" symbol. If the JAR file has been signed by both an alias in an identity database and an alias in a keystore, both "k" and "i" appear.
54.1835 -.LP
54.1836 -.LP
54.1837 -When the \f2\-certs\fP option is used, any identity database aliases are shown in square brackets rather than the parentheses used for keystore aliases. For example:
54.1838 -.LP
54.1839 -.nf
54.1840 -\f3
54.1841 -.fl
54.1842 - jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
54.1843 -.fl
54.1844 -
54.1845 -.fl
54.1846 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
54.1847 -.fl
54.1848 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
54.1849 -.fl
54.1850 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
54.1851 -.fl
54.1852 - 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
54.1853 -.fl
54.1854 - 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
54.1855 -.fl
54.1856 - smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
54.1857 -.fl
54.1858 -
54.1859 -.fl
54.1860 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
54.1861 -.fl
54.1862 - X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
54.1863 -.fl
54.1864 -
54.1865 -.fl
54.1866 - s = signature was verified
54.1867 -.fl
54.1868 - m = entry is listed in manifest
54.1869 -.fl
54.1870 - k = at least one certificate was found in keystore
54.1871 -.fl
54.1872 - i = at least one certificate was found in identity scope
54.1873 -.fl
54.1874 -
54.1875 -.fl
54.1876 - jar verified.
54.1877 -.fl
54.1878 -\fP
54.1879 -.fi
54.1880 -
54.1881 -.LP
54.1882 -.LP
54.1883 -Note that the alias "duke" is in brackets to denote that it is an identity database alias, not a keystore alias.
54.1884 -.LP
54.1885 -.RE
54.1886 .SH "SEE ALSO"
54.1887 .LP
54.1888
54.1889 @@ -1497,24 +1597,25 @@
54.1890 .RS 3
54.1891 .TP 2
54.1892 o
54.1893 -jar tool documentation
54.1894 +jar(1) tool documentation
54.1895 .TP 2
54.1896 o
54.1897 -keytool tool documentation
54.1898 +keytool(1) tool documentation
54.1899 .TP 2
54.1900 o
54.1901 the
54.1902 .na
54.1903 \f4Security\fP @
54.1904 .fi
54.1905 -http://java.sun.com/docs/books/tutorial/security1.2/index.html trail of the
54.1906 +http://java.sun.com/docs/books/tutorial/security/index.html trail of the
54.1907 .na
54.1908 \f4Java Tutorial\fP @
54.1909 .fi
54.1910 -http://java.sun.com/docs/books/tutorial/trailmap.html for examples of the use of the \f3jarsigner\fP tool
54.1911 +http://java.sun.com/docs/books/tutorial/index.html for examples of the use of the \f3jarsigner\fP tool
54.1912 .RE
54.1913
54.1914 .LP
54.1915
54.1916 .LP
54.1917 +.RE
54.1918
55.1 --- a/src/linux/doc/man/java.1 Tue May 12 15:21:55 2009 +0900
55.2 +++ b/src/linux/doc/man/java.1 Thu May 14 00:17:25 2009 -0700
55.3 @@ -1,5 +1,4 @@
55.4 -.'" t
55.5 -." ." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
55.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
55.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
55.8 ."
55.9 ." This code is free software; you can redistribute it and/or modify it
55.10 @@ -19,13 +18,12 @@
55.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
55.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
55.13 ." have any questions.
55.14 -."
55.15 -." `
55.16 -.TH java 1 "07 Aug 2006"
55.17 -." Generated by html2man
55.18 +."
55.19 +.TH java 1 "04 May 2009"
55.20 +." Generated from HTML by html2man (author: Eric Armstrong)
55.21
55.22 .LP
55.23 -.SH NAME
55.24 +.SH "Name"
55.25 java \- the Java application launcher
55.26 .LP
55.27 .SH "SYNOPSIS"
55.28 @@ -105,13 +103,21 @@
55.29 .LP
55.30 Select the Java HotSpot Client VM. A 64\-bit capable jdk currently ignores this option and instead uses the Java Hotspot Server VM.
55.31 .LP
55.32 -For default VM selection, see Server\-Class Machine Detection
55.33 +For default VM selection, see
55.34 +.na
55.35 +\f2Server\-Class Machine Detection\fP @
55.36 +.fi
55.37 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
55.38 .TP 3
55.39 \-server
55.40 .LP
55.41 Select the Java HotSpot Server VM. On a 64\-bit capable jdk only the Java Hotspot Server VM is supported so the \-server option is implicit.
55.42 .LP
55.43 -For default VM selection, see Server\-Class Machine Detection
55.44 +For default VM selection, see
55.45 +.na
55.46 +\f2Server\-Class Machine Detection\fP @
55.47 +.fi
55.48 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
55.49 .TP 3
55.50 \-agentlib:libname[=options]
55.51 Load native agent library \f2libname\fP, e.g.
55.52 @@ -122,10 +128,18 @@
55.53 .LP
55.54 \-agentlib:hprof=help
55.55 .LP
55.56 -For more information, see JVMTI Agent Command Line Options.
55.57 +For more information, see
55.58 +.na
55.59 +\f2JVMTI Agent Command Line Options\fP @
55.60 +.fi
55.61 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
55.62 .TP 3
55.63 \-agentpath:pathname[=options]
55.64 -Load a native agent library by full pathname. For more information, see JVMTI Agent Command Line Options.
55.65 +Load a native agent library by full pathname. For more information, see
55.66 +.na
55.67 +\f2JVMTI Agent Command Line Options\fP @
55.68 +.fi
55.69 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
55.70 .TP 3
55.71 \-classpath classpath
55.72 .TP 3
55.73 @@ -139,7 +153,11 @@
55.74 .br
55.75 For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
55.76 .LP
55.77 -For more information on class paths, see Setting the Class Path.
55.78 +For more information on class paths, see
55.79 +.na
55.80 +\f2Setting the Class Path\fP @
55.81 +.fi
55.82 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath.
55.83 .TP 3
55.84 \-Dproperty=value
55.85 Set a system property value.
55.86 @@ -201,7 +219,7 @@
55.87 .LP
55.88 .TP 3
55.89 \-jar
55.90 -Execute a program encapsulated in a JAR file. The first argument is the name of a JAR file instead of a startup class name. In order for this option to work, the manifest of the JAR file must contain a line of the form \f3Main\-Class: \fP\f4classname\fP. Here, \f2classname\fP identifies the class having the \f2public\ static\ void\ main(String[]\ args)\fP method that serves as your application's starting point. See the Jar tool reference page and the Jar trail of the
55.91 +Execute a program encapsulated in a JAR file. The first argument is the name of a JAR file instead of a startup class name. In order for this option to work, the manifest of the JAR file must contain a line of the form \f3Main\-Class: \fP\f4classname\fP. Here, \f2classname\fP identifies the class having the \f2public\ static\ void\ main(String[]\ args)\fP method that serves as your application's starting point. See the jar(1) and the Jar trail of the
55.92 .na
55.93 \f2Java Tutorial\fP @
55.94 .fi
55.95 @@ -209,10 +227,18 @@
55.96 .LP
55.97 When you use this option, the JAR file is the source of all user classes, and other user class path settings are ignored.
55.98 .LP
55.99 -Note that JAR files that can be run with the "java \-jar" option can have their execute permissions set so they can be run without using "java \-jar". Refer to Java Archive (JAR) Files.
55.100 +Note that JAR files that can be run with the "java \-jar" option can have their execute permissions set so they can be run without using "java \-jar". Refer to
55.101 +.na
55.102 +\f2Java Archive (JAR) Files\fP @
55.103 +.fi
55.104 +http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html.
55.105 .TP 3
55.106 \-javaagent:jarpath[=options]
55.107 -Load a Java programming language agent, see java.lang.instrument.
55.108 +Load a Java programming language agent, see
55.109 +.na
55.110 +\f2java.lang.instrument\fP @
55.111 +.fi
55.112 +http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html.
55.113 .TP 3
55.114 \-verbose
55.115 .TP 3
55.116 @@ -235,11 +261,11 @@
55.117 .nf
55.118 \f3
55.119 .fl
55.120 -\-version:"1.5.0_04 1.5*&1.5.1_02+"
55.121 +\-version:"1.6.0_13 1.6*&1.6.0_10+"
55.122 .fl
55.123 \fP
55.124 .fi
55.125 -The meaning of the above is that the class or jar file requires either version 1.5.0_02, or a version with 1.5 as a version\-id prefix and that is not less than 1.5.1_02. The exact syntax and definition of version strings may be found in Appendix A of the Java Network Launching Protocol & API Specification (JSR\-56).
55.126 +The meaning of the above is that the class or jar file requires either version 1.6.0_13, or a version with 1.6 as a version\-id prefix and that is not less than 1.6.0_10.. The exact syntax and definition of version strings may be found in Appendix A of the Java Network Launching Protocol & API Specification (JSR\-56).
55.127 .LP
55.128 For jar files, the usual preference is to specify version requirements in the jar file manifest rather than on the command line.
55.129 .LP
55.130 @@ -345,7 +371,7 @@
55.131 On Solaris 7 and Solaris 8 SPARC platforms, the upper limit for this value is approximately 4000m minus overhead amounts. On Solaris 2.6 and x86 platforms, the upper limit is approximately 2000m minus overhead amounts. On Linux platforms, the upper limit is approximately 2000m minus overhead amounts.
55.132 .TP 3
55.133 \-Xprof
55.134 -Profiles the running program, and sends profiling data to standard output. This option is provided as a utility that is useful in program development and is not intended to be be used in production systems.
55.135 +Profiles the running program, and sends profiling data to standard output. This option is provided as a utility that is useful in program development and is not intended to be used in production systems.
55.136 .LP
55.137 .TP 3
55.138 \-Xrs
55.139 @@ -393,19 +419,19 @@
55.140 .nf
55.141 \f3
55.142 .fl
55.143 -"1.5.0_03+"
55.144 +"1.6.0_10+"
55.145 .fl
55.146 \fP
55.147 .fi
55.148 .LP
55.149 -Would utilize any version greater than 1.5.0_03. This is useful for a case where an interface was introduced (or a bug fixed) in the release specified.
55.150 +Would utilize any version greater than 1.6.0_10. This is useful for a case where an interface was introduced (or a bug fixed) in the release specified.
55.151 .TP 3
55.152 3.
55.153 A version greater than an arbitrarily precise version\-id, bounded by the upper bound of that release family. For example:
55.154 .nf
55.155 \f3
55.156 .fl
55.157 -"1.5.0_03+&1.5*"
55.158 +"1.6.0_10+&1.6*"
55.159 .fl
55.160 \fP
55.161 .fi
55.162 @@ -415,11 +441,11 @@
55.163 .nf
55.164 \f3
55.165 .fl
55.166 -"1.4.2_05+&1.4* 1.5+"
55.167 +"1.6.0_10+&1.6* 1.7+"
55.168 .fl
55.169 \fP
55.170 .fi
55.171 -Similar to item 2. this is useful when a change was introduced in a release (1.5) but also made available in updates to previous releases.
55.172 +Similar to item 2. this is useful when a change was introduced in a release (1.7) but also made available in updates to previous releases.
55.173 .RE
55.174
55.175 .LP
55.176 @@ -430,22 +456,28 @@
55.177 .RS 3
55.178 .TP 2
55.179 o
55.180 -javac \- the Java programming language compiler
55.181 +javac(1)
55.182 .TP 2
55.183 o
55.184 -jdb \- Java Application Debugger
55.185 +jdb(1)
55.186 .TP 2
55.187 o
55.188 -javah \- C Header and Stub File Generator
55.189 +javah(1)
55.190 .TP 2
55.191 o
55.192 -jar \- JAR Archive Tool
55.193 +jar(1)
55.194 .TP 2
55.195 o
55.196 -The Java Extensions Framework
55.197 +.na
55.198 +\f2The Java Extensions Framework\fP @
55.199 +.fi
55.200 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
55.201 .TP 2
55.202 o
55.203 -Security Features.
55.204 +.na
55.205 +\f2Security Features\fP @
55.206 +.fi
55.207 +http://java.sun.com/javase/6/docs/technotes/guides/security/index.html.
55.208 .TP 2
55.209 o
55.210 .na
56.1 --- a/src/linux/doc/man/javac.1 Tue May 12 15:21:55 2009 +0900
56.2 +++ b/src/linux/doc/man/javac.1 Thu May 14 00:17:25 2009 -0700
56.3 @@ -1,5 +1,3 @@
56.4 -.'" t
56.5 -."
56.6 ." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
56.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
56.8 ."
56.9 @@ -20,13 +18,12 @@
56.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
56.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
56.12 ." have any questions.
56.13 -."
56.14 -." `
56.15 -.TH javac 1 "07 Aug 2006"
56.16 -." Generated by html2man
56.17 +."
56.18 +.TH javac 1 "04 May 2009"
56.19 +." Generated from HTML by html2man (author: Eric Armstrong)
56.20
56.21 .LP
56.22 -.SH NAME
56.23 +.SH "Name"
56.24 javac \- Java programming language compiler
56.25 .LP
56.26 .SH "SYNOPSIS"
56.27 @@ -36,7 +33,9 @@
56.28 .nf
56.29 \f3
56.30 .fl
56.31 -\fP\f3javac\fP [ options ] [ sourcefiles ] [ @argfiles ]
56.32 + \fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]
56.33 +.fl
56.34 +
56.35 .fl
56.36 .fi
56.37
56.38 @@ -55,6 +54,9 @@
56.39 sourcefiles
56.40 One or more source files to be compiled (such as MyClass.java).
56.41 .TP 3
56.42 +classes
56.43 +One or more classes to be processed for annotations (such as MyPackage.MyClass).
56.44 +.TP 3
56.45 @argfiles
56.46 One or more files that lists options and source files. The \f2\-J\fP options are not allowed in these files.
56.47 .RE
56.48 @@ -66,10 +68,10 @@
56.49
56.50 .LP
56.51 .LP
56.52 -The \f3javac\fP tool reads class and interface definitions, written in the Java programming language, and compiles them into bytecode class files.
56.53 +The \f3javac\fP tool reads class and interface definitions, written in the Java programming language, and compiles them into bytecode class files. It can also process annotations in Java source files and classes.
56.54 .LP
56.55 .LP
56.56 -There are two ways to pass source code filenames to \f3javac\fP:
56.57 +There are two ways to pass source code file names to \f3javac\fP:
56.58 .LP
56.59 .RS 3
56.60 .TP 2
56.61 @@ -93,46 +95,6 @@
56.62 .LP
56.63 By default, the compiler puts each class file in the same directory as its source file. You can specify a separate destination directory with \f3\-d\fP (see Options, below).
56.64 .LP
56.65 -.SH "SEARCHING FOR TYPES"
56.66 -.LP
56.67 -
56.68 -.LP
56.69 -.LP
56.70 -When compiling a source file, the compiler often needs information about a type whose definition did not appear in the source files given on the command line. The compiler needs type information for every class or interface used, extended, or implemented in the source file. This includes classes and interfaces not explicitly mentioned in the source file but which provide information through inheritance.
56.71 -.LP
56.72 -.LP
56.73 -For example, when you subclass \f3java.applet.Applet\fP, you are also using \f3Applet's\fP ancestor classes: \f3java.awt.Panel\fP, \f3java.awt.Container\fP, \f3java.awt.Component\fP, and \f3java.lang.Object\fP.
56.74 -.LP
56.75 -.LP
56.76 -When the compiler needs type information, it looks for a source file or class file which defines the type. The compiler searches for class files first in the bootstrap and extension classes, then in the user class path (which by default is the current directory). The user class path is defined by setting the \f3CLASSPATH\fP environment variable or by using the \f3\-classpath\fP command line option. (For details, see Setting the Class Path).
56.77 -.LP
56.78 -.LP
56.79 -If you set the \-sourcepath option, the compiler searches the indicated path for source files; otherwise the compiler searches the user class path for both class files and source files.
56.80 -.LP
56.81 -.LP
56.82 -You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
56.83 -.LP
56.84 -.LP
56.85 -A successful type search may produce a class file, a source file, or both. Here is how \f3javac\fP handles each situation:
56.86 -.LP
56.87 -.RS 3
56.88 -.TP 2
56.89 -o
56.90 -\f2Search produces a class file but no source file:\fP \f3javac\fP uses the class file.
56.91 -.TP 2
56.92 -o
56.93 -\f2Search produces a source file but no class file:\fP \f3javac\fP compiles the source file and uses the resulting class file.
56.94 -.TP 2
56.95 -o
56.96 -\f2Search produces both a source file and a class file:\fP \f3javac\fP determines whether the class file is out of date. If the class file is out of date, \f3javac\fP recompiles the source file and uses the updated class file. Otherwise, \f3javac\fP just uses the class file.
56.97 -.LP
56.98 -\f3javac\fP considers a class file out of date only if it is older than the source file.
56.99 -.RE
56.100 -
56.101 -.LP
56.102 -.LP
56.103 -\f3Note:\fP \ \f3javac\fP can silently compile source files not mentioned on the command line. Use the \f3\-verbose\fP option to trace automatic compilation.
56.104 -.LP
56.105 .SH "OPTIONS"
56.106 .LP
56.107
56.108 @@ -148,15 +110,24 @@
56.109 .LP
56.110 .RS 3
56.111 .TP 3
56.112 -\-classpath classpath
56.113 -Set the user class path, overriding the user class path in the \f3CLASSPATH\fP environment variable. If neither \f3CLASSPATH\fP or \f3\-classpath\fP is specified, the user class path consists of the current directory. See Setting the Class Path for more details.
56.114 +\-Akey[=value]
56.115 +Options to pass to annotation processors. These are not interpreted by javac directly, but are made available for use by individual processors. \f2key\fP should be one or more identifiers separated by ".".
56.116 +.TP 3
56.117 +\-cp path or \-classpath path
56.118 +Specify where to find user class files, and (optionally) annotation processors and source files. This classpath overrides the user class path in the \f3CLASSPATH\fP environment variable. If neither \f3CLASSPATH\fP, \f3\-cp\fP nor \f3\-classpath\fP is specified, the user class path consists of the current directory. See
56.119 +.na
56.120 +\f2Setting the Class Path\fP @
56.121 +.fi
56.122 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath for more details.
56.123 .LP
56.124 -If the \f3\-sourcepath\fP option is not specified, the user class path is searched for both source files and class files.
56.125 +If the \f3\-sourcepath\fP option is not specified, the user class path is also searched for source files.
56.126 .LP
56.127 -As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
56.128 +If the \f3\-processorpath\fP option is not specified, the classpath is also searched for annotation processors.
56.129 +.LP
56.130 +As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP.
56.131 .br
56.132 .br
56.133 -For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
56.134 +For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. \f3Note:\fP \ Depending of the configuration of your command line environment, you may have to quote the wild card character, for example, \f2javac \-cp "*.jar" MyClass.java\fP.
56.135 .TP 3
56.136 \-Djava.ext.dirs=directories
56.137 Override the location of installed extensions.
56.138 @@ -165,17 +136,17 @@
56.139 Override the location of endorsed standards path.
56.140 .TP 3
56.141 \-d directory
56.142 -Set the destination directory for class files. The destination directory must already exist; javac will not create the destination directory. If a class is part of a package, \f3javac\fP puts the class file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-d /home/myclasses\fP and the class is called \f2com.mypackage.MyClass\fP, then the class file is called \f2/home/myclasses/com/mypackage/MyClass.class\fP.
56.143 +Set the destination directory for class files. The directory must already exist; \f3javac\fP will not create it. If a class is part of a package, \f3javac\fP puts the class file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-d /home/myclasses\fP and the class is called \f2com.mypackage.MyClass\fP, then the class file is called \f2/home/myclasses/com/mypackage/MyClass.class\fP.
56.144 .LP
56.145 -If \f3\-d\fP is not specified, \f3javac\fP puts the class file in the same directory as the source file.
56.146 +If \f3\-d\fP is not specified, \f3javac\fP puts each class files in the same directory as the source file from which it was generated.
56.147 .LP
56.148 \f3Note:\fP \ The directory specified by \f3\-d\fP is not automatically added to your user class path.
56.149 .TP 3
56.150 \-deprecation
56.151 -Show a description of each use or override of a deprecated member or class. Without \f3\-deprecation\fP, \f3javac\fP shows the names of source files that use or override deprecated members or classes. \f3\-deprecation\fP is shorthand for \f3\-Xlint:deprecation\fP.
56.152 +Show a description of each use or override of a deprecated member or class. Without \f3\-deprecation\fP, \f3javac\fP shows a summary of the source files that use or override deprecated members or classes. \f3\-deprecation\fP is shorthand for \f3\-Xlint:deprecation\fP.
56.153 .TP 3
56.154 \-encoding encoding
56.155 -Set the source file encoding name, such as \f2EUC\-JP and UTF\-8.\fP. If \f3\-encoding\fP is not specified, the platform default converter is used.
56.156 +Set the source file encoding name, such as \f2EUC\-JP and UTF\-8\fP. If \f3\-encoding\fP is not specified, the platform default converter is used.
56.157 .TP 3
56.158 \-g
56.159 Generate all debugging information, including local variables. By default, only line number and source file information is generated.
56.160 @@ -200,9 +171,23 @@
56.161 \-help
56.162 Print a synopsis of standard options.
56.163 .TP 3
56.164 +\-implicit:{class,none}
56.165 +Controls the generation of class files for implicitly loaded source files. To automatically generate class files, use \f3\-implicit:class\fP. To suppress class file generation, use \f3\-implicit:none\fP. If this option is not specified, the default is to automatically generate class files. In this case, the compiler will issue a warning if any such class files are generated when also doing annotation processing. The warning will not be issued if this option is set explicitly. See Searching For Types.
56.166 +.TP 3
56.167 \-nowarn
56.168 Disable warning messages. This has the same meaning as \f3\-Xlint:none\fP.
56.169 -.LP
56.170 +.TP 3
56.171 +\-proc: {none,only}
56.172 +Controls whether annotation processing and/or compilation is done. \f3\-proc:none\fP means that compilation takes place without annotation processing. \f3\-proc:only\fP means that only annotation processing is done, without any subsequent compilation.
56.173 +.TP 3
56.174 +\-processor class1[,class2,class3...]
56.175 +Names of the annotation processors to run. This bypasses the default discovery process.
56.176 +.TP 3
56.177 +\-processorpath path
56.178 +Specify where to find annotation processors; if this option is not used, the classpath will be searched for processors.
56.179 +.TP 3
56.180 +\-s dir
56.181 +Specify the directory where to place generated source files. The directory must already exist; \f3javac\fP will not create it. If a class is part of a package, the compiler puts the source file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-s /home/mysrc\fP and the class is called \f2com.mypackage.MyClass\fP, then the source file will be placed in \f2/home/mysrc/com/mypackage/MyClass.java\fP.
56.182 .TP 3
56.183 \-source release
56.184 Specifies the version of source code accepted. The following values for \f2release\fP are allowed:
56.185 @@ -215,20 +200,34 @@
56.186 The compiler accepts code containing assertions, which were introduced in JDK 1.4.
56.187 .TP 3
56.188 1.5
56.189 -The compiler accepts code containing generics and other language features introduced in JDK 5. This is the default.
56.190 +The compiler accepts code containing generics and other language features introduced in JDK 5.
56.191 .TP 3
56.192 5
56.193 -Synonym for 1.5
56.194 +Synonym for 1.5.
56.195 +.TP 3
56.196 +1.6
56.197 +This is the default value. No language changes were introduced in Java SE 6. However, encoding errors in source files are now reported as errors, instead of warnings, as previously.
56.198 +.TP 3
56.199 +6
56.200 +Synonym for 1.6.
56.201 +.TP 3
56.202 +1.7
56.203 +The compiler accepts code with features introduced in JDK 7.
56.204 +.TP 3
56.205 +7
56.206 +Synonym for 1.7.
56.207 .RE
56.208 -\f3Note:\fP No language changes were introduced in JDK 6, so the values \f31.6\fP and \f36\fP are not valid.
56.209 .TP 3
56.210 \-sourcepath sourcepath
56.211 Specify the source code path to search for class or interface definitions. As with the user class path, source path entries are separated by colons (\f3:\fP) and can be directories, JAR archives, or ZIP archives. If packages are used, the local path name within the directory or archive must reflect the package name.
56.212 .LP
56.213 -\f3Note:\fP \ Classes found through the classpath are subject to automatic recompilation if their sources are found.
56.214 +\f3Note:\fP \ Classes found through the classpath may be subject to automatic recompilation if their sources are also found. See Searching For Types.
56.215 .TP 3
56.216 \-verbose
56.217 -Verbose output. This includes information about each class loaded and each source file compiled.
56.218 +Verbose output. This includes information about each class loaded and each source file compiled.
56.219 +.TP 3
56.220 +\-version
56.221 +Print version information.
56.222 .TP 3
56.223 \-X
56.224 Display information about non\-standard options and exit.
56.225 @@ -248,7 +247,7 @@
56.226 .RS 3
56.227 .TP 3
56.228 \-target version
56.229 -Generate class files that target a specified version of the VM. Class files will run on the specified target and on later versions, but not on earlier versions of the VM. Valid targets are \f31.1\fP \f31.2\fP \f31.3\fP \f31.4\fP \f31.5\fP (also \f35\fP) and \f31.6\fP (also \f36\fP).
56.230 +Generate class files that target a specified version of the VM. Class files will run on the specified target and on later versions, but not on earlier versions of the VM. Valid targets are \f31.1\fP \f31.2\fP \f31.3\fP \f31.4\fP \f31.5\fP (also \f35\fP) \f31.6\fP (also \f36\fP) and \f31.7\fP (also \f37\fP).
56.231 .LP
56.232 The default for \f3\-target\fP depends on the value of \f3\-source\fP:
56.233 .RS 3
56.234 @@ -257,7 +256,10 @@
56.235 If \-source is \f3not specified\fP, the value of \-target is \f31.6\fP
56.236 .TP 2
56.237 o
56.238 -If \-source is \f31.3\fP, the value of \-target is \f31.1\fP
56.239 +If \-source is \f31.2\fP, the value of \-target is \f31.4\fP
56.240 +.TP 2
56.241 +o
56.242 +If \-source is \f31.3\fP, the value of \-target is \f31.4\fP
56.243 .TP 2
56.244 o
56.245 For \f3all other values\fP of \-source, the value of \-target is the value of \f3\-source\fP.
56.246 @@ -295,8 +297,8 @@
56.247 \-Xlint:none
56.248 Disable all warnings not mandated by the Java Language Specification.
56.249 .TP 3
56.250 -\-Xlint:\-xxx
56.251 -Disable warning \f3xxx\fP, where \f3xxx\fP is one of the warning names supported for \f3\-Xlint:xxx\fP, below
56.252 +\-Xlint:\-name
56.253 +Disable warning \f2name\fP, where \f2name\fP is one of the warning names supported for \f3\-Xlint:\fP\f2name\fP, below.
56.254 .TP 3
56.255 \-Xlint:unchecked
56.256 Give more detail for unchecked conversion warnings that are mandated by the Java Language Specification.
56.257 @@ -311,7 +313,7 @@
56.258 Warn about \f2finally\fP clauses that cannot complete normally.
56.259 .TP 3
56.260 \-Xlint:fallthrough
56.261 -Check \f2switch\fP blocks for fall\-through cases and provide a warning message for any that are found. Fall\-through cases are cases in a \f2switch\fP block, other than the last case in the block, whose code does not include a \f2break\fP statement, allowing code execution to "fall through" from that case to the next case. For example, the code following the \f2case 1\fP label in this \f2switch\fP block does not contain a \f2break\fP statement:
56.262 +Check \f2switch\fP blocks for fall\-through cases and provide a warning message for any that are found. Fall\-through cases are cases in a \f2switch\fP block, other than the last case in the block, whose code does not include a \f2break\fP statement, allowing code execution to "fall through" from that case to the next case. For example, the code following the \f2case 1\fP label in this \f2switch\fP block does not end with a \f2break\fP statement:
56.263 .RS 3
56.264
56.265 .LP
56.266 @@ -332,12 +334,14 @@
56.267 .fl
56.268 }
56.269 .fl
56.270 +
56.271 +.fl
56.272 \fP
56.273 .fi
56.274 .RE
56.275 If the \f2\-Xlint:fallthrough\fP flag were used when compiling this code, the compiler would emit a warning about "possible fall\-through into case," along with the line number of the case in question.
56.276 .TP 3
56.277 -\-Xmaxerrors number
56.278 +\-Xmaxerrs number
56.279 Set the maximum number of errors to print.
56.280 .TP 3
56.281 \-Xmaxwarns number
56.282 @@ -345,6 +349,18 @@
56.283 .TP 3
56.284 \-Xstdout filename
56.285 Send compiler messages to the named file. By default, compiler messages go to \f2System.err\fP.
56.286 +.TP 3
56.287 +\-Xprefer:{newer,source}
56.288 +Specify which file to read when both a source file and class file are found for a type. (See Searching For Types). If \f2\-Xprefer:newer\fP is used, it reads the newer of the source or class file for a type (default). If the \f2\-Xprefer:source\fP option is used, it reads source file. Use \f2\-Xprefer:source\fP when you want to be sure that any annotation processors can access annotations declared with a retention policy of \f2SOURCE\fP.
56.289 +.TP 3
56.290 +\-Xprint
56.291 +Print out textual representation of specified types for debugging purposes; perform neither annotation processing nor compilation. The format of the output may change.
56.292 +.TP 3
56.293 +\-XprintProcessorInfo
56.294 +Print information about which annotations a processor is asked to process.
56.295 +.TP 3
56.296 +\-XprintRounds
56.297 +Print information about initial and subsequent annotation processing rounds.
56.298 .RE
56.299
56.300 .LP
56.301 @@ -390,7 +406,9 @@
56.302 .nf
56.303 \f3
56.304 .fl
56.305 - C:> \fP\f3javac @argfile\fP
56.306 + % \fP\f3javac @argfile\fP
56.307 +.fl
56.308 +
56.309 .fl
56.310 .fi
56.311
56.312 @@ -414,7 +432,9 @@
56.313 .fl
56.314 \-g
56.315 .fl
56.316 - \-sourcepath \\java\\pubs\\ws\\1.3\\src\\share\\classes
56.317 + \-sourcepath /java/pubs/ws/1.3/src/share/classes
56.318 +.fl
56.319 +
56.320 .fl
56.321 \fP
56.322 .fi
56.323 @@ -432,18 +452,22 @@
56.324 .fl
56.325 MyClass3.java
56.326 .fl
56.327 +
56.328 +.fl
56.329 \fP
56.330 .fi
56.331
56.332 .LP
56.333 .LP
56.334 -You would then run javac with:
56.335 +You would then run \f3javac\fP with:
56.336 .LP
56.337 .nf
56.338 \f3
56.339 .fl
56.340 % \fP\f3javac @options @classes\fP
56.341 .fl
56.342 +
56.343 +.fl
56.344 .fi
56.345
56.346 .LP
56.347 @@ -458,11 +482,119 @@
56.348 .fl
56.349 % \fP\f3javac @path1/options @path2/classes\fP
56.350 .fl
56.351 +
56.352 +.fl
56.353 .fi
56.354
56.355 .LP
56.356 +.SH "ANNOTATION PROCESSING"
56.357 +.LP
56.358 +
56.359 +.LP
56.360 +.LP
56.361 +\f3javac\fP provides direct support for annotation processing, superseding the need for the separate annotation processing tool, \f3apt\fP.
56.362 +.LP
56.363 +.LP
56.364 +The API for annotation processors is defined in the \f2javax.annotation.processing\fP and \f2javax.lang.model\fP packages and subpackages.
56.365 +.LP
56.366 +.SS
56.367 +Overview of annotation processing
56.368 +.LP
56.369 +.LP
56.370 +Unless annotation processing is disabled with the \f3\-proc:none\fP option, the compiler searches for any annotation processors that are available. The search path can be specified with the \f3\-processorpath\fP option; if it is not given, the user class path is used. Processors are located by means of service provider\-configuration files named
56.371 +.br
56.372 +\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
56.373 +.br
56.374 +on the search path. Such files should contain the names of any annotation processors to be used, listed one per line. Alternatively, processors can be specified explicitly, using the \f3\-processor\fP option.
56.375 +.LP
56.376 +.LP
56.377 +After scanning the source files and classes on the command line to determine what annotations are present, the compiler queries the processors to determine what annotations they process. When a match is found, the processor will be invoked. A processor may "claim" the annotations it processes, in which case no further attempt is made to find any processors for those annotations. Once all annotations have been claimed, the compiler does not look for additional processors.
56.378 +.LP
56.379 +.LP
56.380 +If any processors generate any new source files, another round of annotation processing will occur: any newly generated source files will be scanned, and the annotations processed as before. Any processors invoked on previous rounds will also be invoked on all subsequent rounds. This continues until no new source files are generated.
56.381 +.LP
56.382 +.LP
56.383 +After a round occurs where no new source files are generated, the annotation processors will be invoked one last time, to give them a chance to complete any work they may need to do. Finally, unless the \f3\-proc:only\fP option is used, the compiler will compile the original and all the generated source files.
56.384 +.LP
56.385 +.SS
56.386 +Implicitly loaded source files
56.387 +.LP
56.388 +.LP
56.389 +To compile a set of source files, the compiler may need to implicitly load additional source files. (See Searching For Types). Such files are currently not subject to annotation processing. By default, the compiler will give a warning if annotation processing has occurred and any implicitly loaded source files are compiled. See the \-implicit option for ways to suppress the warning.
56.390 +.LP
56.391 +.SH "SEARCHING FOR TYPES"
56.392 +.LP
56.393 +
56.394 +.LP
56.395 +.LP
56.396 +When compiling a source file, the compiler often needs information about a type whose definition did not appear in the source files given on the command line. The compiler needs type information for every class or interface used, extended, or implemented in the source file. This includes classes and interfaces not explicitly mentioned in the source file but which provide information through inheritance.
56.397 +.LP
56.398 +.LP
56.399 +For example, when you subclass \f3java.applet.Applet\fP, you are also using \f3Applet's\fP ancestor classes: \f3java.awt.Panel\fP, \f3java.awt.Container\fP, \f3java.awt.Component\fP, and \f3java.lang.Object\fP.
56.400 +.LP
56.401 +.LP
56.402 +When the compiler needs type information, it looks for a source file or class file which defines the type. The compiler searches for class files first in the bootstrap and extension classes, then in the user class path (which by default is the current directory). The user class path is defined by setting the \f3CLASSPATH\fP environment variable or by using the \f3\-classpath\fP command line option. (For details, see
56.403 +.na
56.404 +\f2Setting the Class Path\fP @
56.405 +.fi
56.406 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath).
56.407 +.LP
56.408 +.LP
56.409 +If you set the \-sourcepath option, the compiler searches the indicated path for source files; otherwise the compiler searches the user class path for both class files and source files.
56.410 +.LP
56.411 +.LP
56.412 +You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
56.413 +.LP
56.414 +.LP
56.415 +A successful type search may produce a class file, a source file, or both. If both are found, you can use the \-Xprefer option to instruct the compiler which to use. If \f3newer\fP is given, the compiler will use the newer of the two files. If \f3source\fP is given, it will use the source file. The default is \f3newer\fP.
56.416 +.LP
56.417 +.LP
56.418 +If a type search finds a source file for a required type, either by itself, or as a result of the setting for \f3\-Xprefer\fP, the compiler will read the source file to get the information it needs. In addition, it will by default compile the source file as well. You can use the \-implicit option to specify the behavior. If \f3none\fP is given, no class files will be generated for the source file. If \f3class\fP is given, class files will be generated for the source file.
56.419 +.LP
56.420 +.LP
56.421 +The compiler may not discover the need for some type information until after annotation processing is complete. If the type information is found in a source file and no \f3\-implicit\fP option is given, the compiler will give a warning that the file is being compiled without being subject to annotation processing. To disable the warning, either specify the file on the command line (so that it will be subject to annotation processing) or use the \f3\-implicit\fP option to specify whether or not class files should be generated for such source files.
56.422 +.LP
56.423 .SH "PROGRAMMATIC INTERFACE"
56.424 .LP
56.425 +
56.426 +.LP
56.427 +.LP
56.428 +\f3javac\fP supports the new Java Compiler API defined by the classes and interfaces in the \f2javax.tools\fP package.
56.429 +.LP
56.430 +.SS
56.431 +Example
56.432 +.LP
56.433 +.LP
56.434 +To perform a compilation using arguments as you would give on the command line, you can use the following:
56.435 +.LP
56.436 +.nf
56.437 +\f3
56.438 +.fl
56.439 +JavaCompiler javac = ToolProvider.getSystemJavaCompiler();
56.440 +.fl
56.441 +int rc = javac.run(null, null, null, args);
56.442 +.fl
56.443 +
56.444 +.fl
56.445 +\fP
56.446 +.fi
56.447 +
56.448 +.LP
56.449 +.LP
56.450 +This will write any diagnostics to the standard output stream, and return the exit code that \f3javac\fP would give when invoked from the command line.
56.451 +.LP
56.452 +.LP
56.453 +You can use other methods on the \f2javax.tools.JavaCompiler\fP interface to handle diagnostics, control where files are read from and written to, and so on.
56.454 +.LP
56.455 +.SS
56.456 +Old Interface
56.457 +.LP
56.458 +.RS 3
56.459 +
56.460 +.LP
56.461 +.LP
56.462 +\f3Note:\fP \ This API is retained for backwards compatibility only; all new code should use the Java Compiler API, described above.
56.463 +.LP
56.464 .LP
56.465 The \f2com.sun.tools.javac.Main\fP class provides two static methods to invoke the compiler from a program:
56.466 .LP
56.467 @@ -473,6 +605,8 @@
56.468 .fl
56.469 public static int compile(String[] args, PrintWriter out);
56.470 .fl
56.471 +
56.472 +.fl
56.473 \fP
56.474 .fi
56.475
56.476 @@ -484,11 +618,12 @@
56.477 The \f2out\fP parameter indicates where the compiler's diagnostic output is directed.
56.478 .LP
56.479 .LP
56.480 -The return value is equivalent to the exit value from javac.
56.481 +The return value is equivalent to the exit value from \f3javac\fP.
56.482 .LP
56.483 .LP
56.484 Note that all \f3other\fP classes and methods found in a package whose name starts with \f2com.sun.tools.javac\fP (informally known as sub\-packages of \f2com.sun.tools.javac\fP) are strictly internal and subject to change at any time.
56.485 .LP
56.486 +.RE
56.487 .SH "EXAMPLES"
56.488 .LP
56.489 .SS
56.490 @@ -548,6 +683,8 @@
56.491 .fl
56.492 Hello Everyone
56.493 .fl
56.494 +
56.495 +.fl
56.496 .fi
56.497 .RE
56.498
56.499 @@ -586,6 +723,8 @@
56.500 .fl
56.501
56.502 .fl
56.503 +
56.504 +.fl
56.505 .fi
56.506 .RE
56.507
56.508 @@ -612,6 +751,8 @@
56.509 .fl
56.510 % \f3javac greetings/Hi.java\fP
56.511 .fl
56.512 +
56.513 +.fl
56.514 .fi
56.515 .RE
56.516
56.517 @@ -627,6 +768,8 @@
56.518 .fl
56.519 % \fP\f3javac \-classpath /examples /examples/greetings/Hi.java\fP
56.520 .fl
56.521 +
56.522 +.fl
56.523 .fi
56.524 .RE
56.525
56.526 @@ -640,9 +783,11 @@
56.527 .nf
56.528 \f3
56.529 .fl
56.530 -% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
56.531 +% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
56.532 .fl
56.533 - /examples/greetings/Hi.java\fP
56.534 + /examples/greetings/Hi.java\fP
56.535 +.fl
56.536 +
56.537 .fl
56.538 .fi
56.539 .RE
56.540 @@ -659,6 +804,8 @@
56.541 .fl
56.542 % \fP\f3java \-classpath /examples:/lib/Banners.jar greetings.Hi\fP
56.543 .fl
56.544 +
56.545 +.fl
56.546 .fi
56.547 .RE
56.548
56.549 @@ -697,9 +844,9 @@
56.550 .fl
56.551 % \f3ls classes\fP
56.552 .fl
56.553 -% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
56.554 +% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
56.555 .fl
56.556 - src/farewells/GoodBye.java \-d classes\fP
56.557 + src/farewells/GoodBye.java \-d classes\fP
56.558 .fl
56.559 % \f3ls classes\fP
56.560 .fl
56.561 @@ -711,6 +858,8 @@
56.562 .fl
56.563
56.564 .fl
56.565 +
56.566 +.fl
56.567 .fi
56.568 .RE
56.569
56.570 @@ -726,7 +875,7 @@
56.571
56.572 .LP
56.573 .LP
56.574 -Here we use \f3javac\fP to compile code that will run on a 1.4 VM.
56.575 +Here we use \f3javac\fP to compile code that will run on a 1.7 VM.
56.576 .LP
56.577 .RS 3
56.578
56.579 @@ -734,19 +883,21 @@
56.580 .nf
56.581 \f3
56.582 .fl
56.583 -% \fP\f3javac \-target 1.4 \-bootclasspath jdk1.4.2/lib/classes.zip \\
56.584 +% \fP\f3javac \-target 1.7 \-bootclasspath jdk1.7.0/lib/rt.jar \\
56.585 .fl
56.586 - \-extdirs "" OldCode.java\fP
56.587 + \-extdirs "" OldCode.java\fP
56.588 +.fl
56.589 +
56.590 .fl
56.591 .fi
56.592 .RE
56.593
56.594 .LP
56.595 .LP
56.596 -The \f3\-target 1.4\fP option ensures that the generated class files will be compatible with 1.4 VMs. By default, \f3javac\fP compiles for JDK 6.
56.597 +The \f3\-target 1.7\fP option ensures that the generated class files will be compatible with 1.7 VMs. By default, \f3javac\fP compiles for JDK 6.
56.598 .LP
56.599 .LP
56.600 -The Java Platform JDK's \f3javac\fP would also by default compile against its own bootstrap classes, so we need to tell \f3javac\fP to compile against JDK 1.4 bootstrap classes instead. We do this with \f3\-bootclasspath\fP and \f3\-extdirs\fP. Failing to do this might allow compilation against a Java Platform API that would not be present on a 1.4 VM and would fail at runtime.
56.601 +The Java Platform JDK's \f3javac\fP would also by default compile against its own bootstrap classes, so we need to tell \f3javac\fP to compile against JDK 1.7 bootstrap classes instead. We do this with \f3\-bootclasspath\fP and \f3\-extdirs\fP. Failing to do this might allow compilation against a Java Platform API that would not be present on a 1.7 VM and would fail at runtime.
56.602 .LP
56.603 .RE
56.604 .SH "SEE ALSO"
56.605 @@ -756,22 +907,28 @@
56.606 .RS 3
56.607 .TP 2
56.608 o
56.609 -java \- the Java Application Launcher
56.610 +.na
56.611 +\f2The javac Guide\fP @
56.612 +.fi
56.613 +http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
56.614 .TP 2
56.615 o
56.616 -jdb \- Java Application Debugger
56.617 +java(1) \- the Java Application Launcher
56.618 .TP 2
56.619 o
56.620 -javah \- C Header and Stub File Generator
56.621 +jdb(1) \- Java Application Debugger
56.622 .TP 2
56.623 o
56.624 -javap \- Class File Disassembler
56.625 +javah(1) \- C Header and Stub File Generator
56.626 .TP 2
56.627 o
56.628 -javadoc \- API Documentation Generator
56.629 +javap(1) \- Class File Disassembler
56.630 .TP 2
56.631 o
56.632 -jar \- JAR Archive Tool
56.633 +javadoc(1) \- API Documentation Generator
56.634 +.TP 2
56.635 +o
56.636 +jar(1) \- JAR Archive Tool
56.637 .TP 2
56.638 o
56.639 .na
57.1 --- a/src/linux/doc/man/javadoc.1 Tue May 12 15:21:55 2009 +0900
57.2 +++ b/src/linux/doc/man/javadoc.1 Thu May 14 00:17:25 2009 -0700
57.3 @@ -1,6 +1,4 @@
57.4 -.'" t
57.5 -."
57.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
57.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
57.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
57.9 ."
57.10 ." This code is free software; you can redistribute it and/or modify it
57.11 @@ -21,10 +19,9 @@
57.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
57.13 ." have any questions.
57.14 ."
57.15 -." `
57.16 -.TH javadoc 1 "07 Aug 2006"
57.17 -." Generated by html2man
57.18 -.SH NAME
57.19 +.TH javadoc 1 "04 May 2009"
57.20 +." Generated from HTML by html2man (author: Eric Armstrong)
57.21 +.SH "Name"
57.22 javadoc \- The Java API Documentation Generator
57.23 .RS 3
57.24
57.25 @@ -153,7 +150,11 @@
57.26 In many cases, the Javadoc tool allows you to generate documentation for source files whose code is incomplete or erroneous. This is a benefit that enables you to generate documentation before all debugging and troubleshooting is done. For example, according to the \f2Java Language Specification\fP, a class that contains an abstract method should itself be declared abstract. The Javadoc tool does not check for this, and would proceed without a warning, whereas the javac compiler stops on this error. The Javadoc tool does do some primitive checking of doc comments. Use the DocCheck doclet to check the doc comments more thoroughly.
57.27 .LP
57.28 .LP
57.29 -When the Javadoc tool builds its internal structure for the documentation, it loads all referenced classes. Because of this, the Javadoc tool must be able to find all referenced classes, whether bootstrap classes, extensions, or user classes. For more about this, see How Classes Are Found. Generally speaking, classes you create must either be loaded as an extension or in the Javadoc tool's class path.
57.30 +When the Javadoc tool builds its internal structure for the documentation, it loads all referenced classes. Because of this, the Javadoc tool must be able to find all referenced classes, whether bootstrap classes, extensions, or user classes. For more about this, see
57.31 +.na
57.32 +\f2How Classes Are Found\fP @
57.33 +.fi
57.34 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html. Generally speaking, classes you create must either be loaded as an extension or in the Javadoc tool's class path.
57.35 .LP
57.36 .SS
57.37 Javadoc Doclets
57.38 @@ -164,7 +165,10 @@
57.39 .RS 3
57.40 .TP 2
57.41 o
57.42 -Javadoc Doclets
57.43 +.na
57.44 +\f2Javadoc Doclets\fP @
57.45 +.fi
57.46 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
57.47 .TP 2
57.48 o
57.49 The \f2\-doclet\fP command\-line option
57.50 @@ -180,7 +184,10 @@
57.51 .RS 3
57.52 .TP 2
57.53 o
57.54 -Javadoc Enhancements for details about improvements added in Javadoc.
57.55 +.na
57.56 +\f2Javadoc Enhancements\fP @
57.57 +.fi
57.58 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html for details about improvements added in Javadoc.
57.59 .TP 2
57.60 o
57.61 .na
57.62 @@ -198,7 +205,7 @@
57.63 .na
57.64 \f2Requirements for Writing API Specifications\fP @
57.65 .fi
57.66 -http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Standard requirements used when writing the Java 2 Platform Specification. It can be useful whether you are writing API specifications in source file documentation comments or in other formats. It covers requirements for packages, classes, interfaces, fields and methods to satisfy testable assertions.
57.67 +http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Standard requirements used when writing the Java SE Platform Specification. It can be useful whether you are writing API specifications in source file documentation comments or in other formats. It covers requirements for packages, classes, interfaces, fields and methods to satisfy testable assertions.
57.68 .TP 2
57.69 o
57.70 .na
57.71 @@ -284,7 +291,7 @@
57.72 .RS 3
57.73 .TP 2
57.74 o
57.75 -\f2package\-info.java\fP \- Can contain a package declaration, package annotations, package comments and Javadoc tags. This file is new in JDK 5.0, and is preferred over package.html.
57.76 +\f2package\-info.java\fP \- Can contain a package declaration, package annotations, package comments and Javadoc tags. This file is generally preferred over package.html.
57.77 .TP 2
57.78 o
57.79 \f2package.html\fP \- Can contain only package comments and Javadoc tags, no package annotations.
57.80 @@ -295,7 +302,7 @@
57.81 A package may have a single \f2package.html\fP file or a single \f2package\-info.java\fP file but not both. Place either file in the package directory in the source tree along with your \f2.java\fP files.
57.82 .LP
57.83 .LP
57.84 -\f4package\-info.java\fP This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
57.85 +\f4package\-info.java\fP \- This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
57.86 .LP
57.87 .LP
57.88 File: \f2java/applet/package\-info.java\fP
57.89 @@ -388,7 +395,7 @@
57.90 .nr 40 \n(79+(0*\n(38)
57.91 .nr 80 +\n(40
57.92 .nr TW \n(80
57.93 -.if t .if \n(TW>\n(.li .tm Table at line 326 file Input is too wide - \n(TW units
57.94 +.if t .if \n(TW>\n(.li .tm Table at line 353 file Input is too wide - \n(TW units
57.95 .fc
57.96 .nr #T 0-1
57.97 .nr #a 0-1
57.98 @@ -522,7 +529,7 @@
57.99 .nr 40 \n(79+(0*\n(38)
57.100 .nr 80 +\n(40
57.101 .nr TW \n(80
57.102 -.if t .if \n(TW>\n(.li .tm Table at line 379 file Input is too wide - \n(TW units
57.103 +.if t .if \n(TW>\n(.li .tm Table at line 406 file Input is too wide - \n(TW units
57.104 .fc
57.105 .nr #T 0-1
57.106 .nr #a 0-1
57.107 @@ -580,10 +587,18 @@
57.108 Processes any package tags that are present.
57.109 .TP 2
57.110 o
57.111 -Inserts the processed text at the bottom of the package summary page it generates, as shown in Package Summary.
57.112 +Inserts the processed text at the bottom of the package summary page it generates, as shown in
57.113 +.na
57.114 +\f2Package Summary\fP @
57.115 +.fi
57.116 +http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html.
57.117 .TP 2
57.118 o
57.119 -Copies the first sentence of the package comment to the top of the package summary page. It also adds the package name and this first sentence to the list of packages on the overview page, as shown in Overview Summary. The end\-of\-sentence is determined by the same rules used for the end of the first sentence of class and member main descriptions.
57.120 +Copies the first sentence of the package comment to the top of the package summary page. It also adds the package name and this first sentence to the list of packages on the overview page, as shown in
57.121 +.na
57.122 +\f2Overview Summary\fP @
57.123 +.fi
57.124 +http://java.sun.com/javase/6/docs/api/overview\-summary.html. The end\-of\-sentence is determined by the same rules used for the end of the first sentence of class and member main descriptions.
57.125 .RE
57.126
57.127 .LP
57.128 @@ -614,7 +629,11 @@
57.129 Processes any overview tags that are present.
57.130 .TP 2
57.131 o
57.132 -Inserts the processed text at the bottom of the overview page it generates, as shown in Overview Summary.
57.133 +Inserts the processed text at the bottom of the overview page it generates, as shown in
57.134 +.na
57.135 +\f2Overview Summary\fP @
57.136 +.fi
57.137 +http://java.sun.com/javase/6/docs/api/overview\-summary.html.
57.138 .TP 2
57.139 o
57.140 Copies the first sentence of the overview comment to the top of the overview summary page.
57.141 @@ -907,7 +926,7 @@
57.142
57.143 .LP
57.144 .SS
57.145 -a name="generatedapideclarations"/> Generated API Declarations
57.146 +Generated API Declarations
57.147 .LP
57.148 .LP
57.149 The Javadoc tool generates a declaration at the start of each class, interface, field, constructor, and method description for that API item. For example, the declaration for the \f2Boolean\fP class is:
57.150 @@ -1332,7 +1351,7 @@
57.151 .nr 41 \n(80+(3*\n(38)
57.152 .nr 81 +\n(41
57.153 .nr TW \n(81
57.154 -.if t .if \n(TW>\n(.li .tm Table at line 1084 file Input is too wide - \n(TW units
57.155 +.if t .if \n(TW>\n(.li .tm Table at line 1123 file Input is too wide - \n(TW units
57.156 .fc
57.157 .nr #T 0-1
57.158 .nr #a 0-1
57.159 @@ -1455,19 +1474,30 @@
57.160
57.161 .LP
57.162 .LP
57.163 -Note: Starting with JDK 5.0, you can deprecate a program element using the @Deprecated annotation.
57.164 +Note: You can deprecate a program element using the
57.165 +.na
57.166 +\f2@Deprecated annotation\fP @
57.167 +.fi
57.168 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html.
57.169 .LP
57.170 .RE
57.171 -.LP
57.172 -Adds a comment indicating that this API should no longer be used (even though it may continue to work). The Javadoc tool moves the \f2deprecated\-text\fP ahead of the main description, placing it in italics and preceding it with a bold warning: "Deprecated". This tag is valid in all doc comments: overview, package, class, interface, constructor, method and field.
57.173 -.LP
57.174 -The first sentence of \f2deprecated\-text\fP should at least tell the user when the API was deprecated and what to use as a replacement. The Javadoc tool copies just the first sentence to the summary section and index. Subsequent sentences can also explain why it has been deprecated. You should include a \f2{@link}\fP tag (for Javadoc 1.2 or later) that points to the replacement API:
57.175 +.RE
57.176 +.RS 3
57.177 +
57.178 +.LP
57.179 +.LP
57.180 +Adds a comment indicating that this API should no longer be used (even though it may continue to work). The Javadoc tool moves the \f2deprecated\-text\fP ahead of the main description, placing it in italics and preceding it with a bold warning: "Deprecated". This tag is valid in all doc comments: overview, package, class, interface, constructor, method and field.
57.181 +.LP
57.182 +.LP
57.183 +The first sentence of \f2deprecated\-text\fP should at least tell the user when the API was deprecated and what to use as a replacement. The Javadoc tool copies just the first sentence to the summary section and index. Subsequent sentences can also explain why it has been deprecated. You should include a \f2{@link}\fP tag (for Javadoc 1.2 or later) that points to the replacement API:
57.184 +.LP
57.185 .LP
57.186 For more details, see
57.187 .na
57.188 \f2writing @deprecated tags\fP @
57.189 .fi
57.190 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
57.191 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
57.192 +.LP
57.193 .RS 3
57.194 .TP 2
57.195 o
57.196 @@ -1481,15 +1511,28 @@
57.197 .fl
57.198 */
57.199 .fl
57.200 +
57.201 +.fl
57.202 \fP
57.203 .fi
57.204 .TP 2
57.205 o
57.206 For Javadoc 1.1, the standard format is to create a \f2@see\fP tag (which cannot be in\-line) for each \f2@deprecated\fP tag.
57.207 .RE
57.208 -.LP
57.209 -For more about deprecation, see The @deprecated tag.
57.210 -.LP
57.211 +
57.212 +.LP
57.213 +.LP
57.214 +For more about deprecation, see
57.215 +.na
57.216 +\f2The @deprecated tag\fP @
57.217 +.fi
57.218 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.html.
57.219 +.LP
57.220 +.LP
57.221 +
57.222 +.LP
57.223 +.RE
57.224 +.RS 3
57.225 .TP 3
57.226 {@code\ text}
57.227 Equivalent to \f2<code>{@literal}</code>\fP.
57.228 @@ -1500,16 +1543,22 @@
57.229 .fl
57.230 \fP\f4{@code A<B>C}\fP\f3
57.231 .fl
57.232 +
57.233 +.fl
57.234 \fP
57.235 .fi
57.236 +.LP
57.237 displays in the generated HTML page unchanged, as:
57.238 .nf
57.239 \f3
57.240 .fl
57.241 \fP\f4A<B>C\fP\f3
57.242 .fl
57.243 +
57.244 +.fl
57.245 \fP
57.246 .fi
57.247 +.LP
57.248 The noteworthy point is that the \f2<B>\fP is not interpreted as bold and is in code font.
57.249 .LP
57.250 If you want the same functionality without the code font, use \f2{@literal}\fP.
57.251 @@ -1528,9 +1577,12 @@
57.252 .fl
57.253 javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
57.254 .fl
57.255 +
57.256 +.fl
57.257 \fP
57.258 .fi
57.259 -NOTE \- When using \f2{@docRoot}\fP this way in a make file, some makefile programs require special escaping for the brace {} characters. For example, the Inprise MAKE version 5.2 running on Windows requires double braces: \f2{{@docRoot}}\fP. It also requires double (rather than single) quotes to enclose arguments to options such as \f2\-bottom\fP (with the quotes around the \f2href\fP argument omitted).
57.260 +.LP
57.261 +NOTE \- When using \f2{@docRoot}\fP this way in a make file, some makefile programs require special escaping for the brace {} characters. For example, the Inprise MAKE version 5.2 running on Windows requires double braces: \f2{{@docRoot}}\fP. It also requires double (rather than single) quotes to enclose arguments to options such as \f2\-bottom\fP (with the quotes around the \f2href\fP argument omitted).
57.262 .TP 3
57.263 2.
57.264 In a doc comment:
57.265 @@ -1543,31 +1595,42 @@
57.266 .fl
57.267 */
57.268 .fl
57.269 +
57.270 +.fl
57.271 \fP
57.272 .fi
57.273 .RE
57.274 +.LP
57.275 The reason this tag is needed is because the generated docs are in hierarchical directories, as deep as the number of subpackages. This expression:
57.276 .nf
57.277 \f3
57.278 .fl
57.279 <a href="{@docRoot}/copyright.html">
57.280 .fl
57.281 +
57.282 +.fl
57.283 \fP
57.284 .fi
57.285 +.LP
57.286 would resolve to:
57.287 .nf
57.288 \f3
57.289 .fl
57.290 <a href="../../copyright.html"> for java/lang/Object.java
57.291 .fl
57.292 +
57.293 +.fl
57.294 \fP
57.295 .fi
57.296 +.LP
57.297 and
57.298 .nf
57.299 \f3
57.300 .fl
57.301 <a href="../../../copyright.html"> for java/lang/ref/Reference.java
57.302 .fl
57.303 +
57.304 +.fl
57.305 \fP
57.306 .fi
57.307 .LP
57.308 @@ -1605,24 +1668,33 @@
57.309 .fl
57.310 Use the {@link #getComponentAt(int, int) getComponentAt} method.
57.311 .fl
57.312 +
57.313 +.fl
57.314 \fP
57.315 .fi
57.316 +.LP
57.317 From this, the standard doclet would generate the following HTML (assuming it refers to another class in the same package):
57.318 .nf
57.319 \f3
57.320 .fl
57.321 Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method.
57.322 .fl
57.323 +
57.324 +.fl
57.325 \fP
57.326 .fi
57.327 +.LP
57.328 Which appears on the web page as:
57.329 .nf
57.330 \f3
57.331 .fl
57.332 Use the getComponentAt method.
57.333 .fl
57.334 +
57.335 +.fl
57.336 \fP
57.337 .fi
57.338 +.LP
57.339 You can extend \f2{@link}\fP to link to classes not being documented by using the \f2\-link\fP option.
57.340 .LP
57.341 For more details, see
57.342 @@ -1639,14 +1711,20 @@
57.343 .fl
57.344 Refer to {@linkplain add() the overridden method}.
57.345 .fl
57.346 +
57.347 +.fl
57.348 \fP
57.349 .fi
57.350 +.LP
57.351 This would display as:
57.352 .RS 3
57.353 +
57.354 +.LP
57.355 .LP
57.356 Refer to the overridden method.
57.357 .LP
57.358 .RE
57.359 +.LP
57.360 .TP 3
57.361 {@literal\ text}
57.362 Displays \f2text\fP without interpreting the text as HTML markup or nested javadoc tags. This enables you to use regular angle brackets (\f2<\fP and \f2>\fP) instead of the HTML entities (\f2<\fP and \f2>\fP) in doc comments, such as in parameter types (\f2<Object>\fP), inequalities (\f23 < 4\fP), or arrows (\f2<\-\fP). For example, the doc comment text:
57.363 @@ -1655,11 +1733,16 @@
57.364 .fl
57.365 \fP\f4{@literal A<B>C}\fP\f3
57.366 .fl
57.367 +
57.368 +.fl
57.369 \fP
57.370 .fi
57.371 +.LP
57.372 displays unchanged in the generated HTML page in your browser, as:
57.373 .LP
57.374 -\f2\ \ \ \ \ \fPA<B>C The noteworthy point is that the \f2<B>\fP is not interpreted as bold (and it is not in code font).
57.375 +\f2\ \ \ \ \ \fPA<B>C
57.376 +.LP
57.377 +The noteworthy point is that the \f2<B>\fP is not interpreted as bold (and it is not in code font).
57.378 .LP
57.379 If you want the same functionality but with the text in code font, use \f2{@code}\fP.
57.380 .LP
57.381 @@ -1683,6 +1766,8 @@
57.382 .fl
57.383 }
57.384 .fl
57.385 +
57.386 +.fl
57.387 \fP
57.388 .fi
57.389 .LP
57.390 @@ -1706,8 +1791,11 @@
57.391 .fl
57.392 }
57.393 .fl
57.394 +
57.395 +.fl
57.396 \fP
57.397 .fi
57.398 +.LP
57.399 For more details, see
57.400 .na
57.401 \f2writing @param tags\fP @
57.402 @@ -1736,15 +1824,26 @@
57.403 .fl
57.404 @see "The Java Programming Language"
57.405 .fl
57.406 +
57.407 +.fl
57.408 \fP
57.409 .fi
57.410 -This generates text such as:
57.411 +.LP
57.412 +This generates text such as:
57.413 +.RE
57.414 +.RE
57.415 +.RS 3
57.416 +.RS 3
57.417 +.RS 3
57.418 +
57.419 +.LP
57.420 .RS 3
57.421 .RS 3
57.422 .TP 3
57.423 See Also:
57.424 "The Java Programming Language"
57.425 .RE
57.426 +.RE
57.427
57.428 .LP
57.429 .RE
57.430 @@ -1981,7 +2080,7 @@
57.431 .nr 40 \n(79+(0*\n(38)
57.432 .nr 80 +\n(40
57.433 .nr TW \n(80
57.434 -.if t .if \n(TW>\n(.li .tm Table at line 1547 file Input is too wide - \n(TW units
57.435 +.if t .if \n(TW>\n(.li .tm Table at line 1666 file Input is too wide - \n(TW units
57.436 .fc
57.437 .nr #T 0-1
57.438 .nr #a 0-1
57.439 @@ -2327,7 +2426,7 @@
57.440 .nr 42 \n(81+(3*\n(38)
57.441 .nr 82 +\n(42
57.442 .nr TW \n(82
57.443 -.if t .if \n(TW>\n(.li .tm Table at line 1623 file Input is too wide - \n(TW units
57.444 +.if t .if \n(TW>\n(.li .tm Table at line 1742 file Input is too wide - \n(TW units
57.445 .fc
57.446 .nr #T 0-1
57.447 .nr #a 0-1
57.448 @@ -2502,6 +2601,14 @@
57.449 .fi
57.450 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@see.
57.451 .RE
57.452 +.RE
57.453 +.RS 3
57.454 +
57.455 +.LP
57.456 +.LP
57.457 +
57.458 +.LP
57.459 +.RS 3
57.460 .TP 3
57.461 @serial\ field\-description | include | exclude
57.462 Used in the doc comment for a default serializable field.
57.463 @@ -2524,7 +2631,11 @@
57.464 .LP
57.465 The tag @serial at a class level overrides @serial at a package level.
57.466 .LP
57.467 -For more information about how to use these tags, along with an example, see "Documenting Serializable Fields and Data for a Class," Section 1.6 of the \f2Java Object Serialization Specification\fP. Also see the
57.468 +For more information about how to use these tags, along with an example, see "
57.469 +.na
57.470 +\f2Documenting Serializable Fields and Data for a Class\fP @
57.471 +.fi
57.472 +http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.html," Section 1.6 of the \f2Java Object Serialization Specification\fP. Also see the
57.473 .na
57.474 \f2Serialization FAQ\fP @
57.475 .fi
57.476 @@ -2552,8 +2663,11 @@
57.477 .fl
57.478 @since 1.5
57.479 .fl
57.480 +
57.481 +.fl
57.482 \fP
57.483 .fi
57.484 +.LP
57.485 For source code in the Java platform, this tag indicates the version of the Java platform API specification (not necessarily when it was added to the reference implementation). Multiple @since tags are allowed and are treated like multiple @author tags. You could use multiple tags if the prgram element is used by more than one API.
57.486 .LP
57.487 .TP 3
57.488 @@ -2584,8 +2698,11 @@
57.489 .fl
57.490 public static final String SCRIPT_START = "<script>"
57.491 .fl
57.492 +
57.493 +.fl
57.494 \fP
57.495 .fi
57.496 +.LP
57.497 When used with argument \f2package.class#field\fP in any doc comment, it displays the value of the specified constant:
57.498 .nf
57.499 \f3
57.500 @@ -2600,11 +2717,18 @@
57.501 .fl
57.502 }
57.503 .fl
57.504 +
57.505 +.fl
57.506 \fP
57.507 .fi
57.508 +.LP
57.509 The argument \f2package.class#field\fP takes a form identical to that of the @see argument, except that the member must be a static field.
57.510 .LP
57.511 -These values of these constants are also displayed on the Constant Field Values page.
57.512 +These values of these constants are also displayed on the
57.513 +.na
57.514 +\f2Constant Field Values\fP @
57.515 +.fi
57.516 +http://java.sun.com/javase/6/docs/api/constant\-values.html page.
57.517 .LP
57.518 .TP 3
57.519 @version\ version\-text
57.520 @@ -2618,6 +2742,9 @@
57.521 .fi
57.522 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@version.
57.523 .RE
57.524 +
57.525 +.LP
57.526 +.RE
57.527 .SS
57.528 Where Tags Can Be Used
57.529 .LP
57.530 @@ -2702,7 +2829,7 @@
57.531 .nr 40 \n(79+(0*\n(38)
57.532 .nr 80 +\n(40
57.533 .nr TW \n(80
57.534 -.if t .if \n(TW>\n(.li .tm Table at line 1816 file Input is too wide - \n(TW units
57.535 +.if t .if \n(TW>\n(.li .tm Table at line 1963 file Input is too wide - \n(TW units
57.536 .fc
57.537 .nr #T 0-1
57.538 .nr #a 0-1
57.539 @@ -2819,7 +2946,7 @@
57.540 .nr 40 \n(79+(0*\n(38)
57.541 .nr 80 +\n(40
57.542 .nr TW \n(80
57.543 -.if t .if \n(TW>\n(.li .tm Table at line 1848 file Input is too wide - \n(TW units
57.544 +.if t .if \n(TW>\n(.li .tm Table at line 1995 file Input is too wide - \n(TW units
57.545 .fc
57.546 .nr #T 0-1
57.547 .nr #a 0-1
57.548 @@ -2938,7 +3065,7 @@
57.549 .nr 40 \n(79+(0*\n(38)
57.550 .nr 80 +\n(40
57.551 .nr TW \n(80
57.552 -.if t .if \n(TW>\n(.li .tm Table at line 1882 file Input is too wide - \n(TW units
57.553 +.if t .if \n(TW>\n(.li .tm Table at line 2029 file Input is too wide - \n(TW units
57.554 .fc
57.555 .nr #T 0-1
57.556 .nr #a 0-1
57.557 @@ -3098,7 +3225,7 @@
57.558 .nr 40 \n(79+(0*\n(38)
57.559 .nr 80 +\n(40
57.560 .nr TW \n(80
57.561 -.if t .if \n(TW>\n(.li .tm Table at line 1957 file Input is too wide - \n(TW units
57.562 +.if t .if \n(TW>\n(.li .tm Table at line 2104 file Input is too wide - \n(TW units
57.563 .fc
57.564 .nr #T 0-1
57.565 .nr #a 0-1
57.566 @@ -3242,7 +3369,7 @@
57.567 .nr 40 \n(79+(0*\n(38)
57.568 .nr 80 +\n(40
57.569 .nr TW \n(80
57.570 -.if t .if \n(TW>\n(.li .tm Table at line 2016 file Input is too wide - \n(TW units
57.571 +.if t .if \n(TW>\n(.li .tm Table at line 2163 file Input is too wide - \n(TW units
57.572 .fc
57.573 .nr #T 0-1
57.574 .nr #a 0-1
57.575 @@ -3325,6 +3452,8 @@
57.576 .LP
57.577 .SH "OPTIONS"
57.578 .LP
57.579 +
57.580 +.LP
57.581 .LP
57.582 The javadoc tool uses doclets to determine its output. The Javadoc tool uses the default standard doclet unless a custom doclet is specified with the \-doclet option. The Javadoc tool provides a set of command\-line options that can be used with any doclet \-\- these options are described below under the sub\-heading Javadoc Options. The standard doclet provides an additional set of command\-line options that are described below under the sub\-heading Options Provided by the Standard Doclet. All option names are case\-insensitive, though their arguments can be case\-sensitive.
57.583 .LP
57.584 @@ -3545,7 +3674,7 @@
57.585 .nr 42 \n(81+(3*\n(38)
57.586 .nr 82 +\n(42
57.587 .nr TW \n(82
57.588 -.if t .if \n(TW>\n(.li .tm Table at line 2192 file Input is too wide - \n(TW units
57.589 +.if t .if \n(TW>\n(.li .tm Table at line 2341 file Input is too wide - \n(TW units
57.590 .fc
57.591 .nr #T 0-1
57.592 .nr #a 0-1
57.593 @@ -3657,11 +3786,11 @@
57.594 \fP
57.595 .fi
57.596 .LP
57.597 -For full, working examples of running a particular doclet, see
57.598 +For full, working examples of running a particular doclet, see the
57.599 .na
57.600 -\f2Running the MIF Doclet\fP @
57.601 +\f2MIF Doclet documentation\fP @
57.602 .fi
57.603 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
57.604 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
57.605 .LP
57.606 .TP 3
57.607 \-docletpath\ classpathlist
57.608 @@ -3683,11 +3812,11 @@
57.609 .fl
57.610 \fP
57.611 .fi
57.612 -For full, working examples of running a particular doclet, see
57.613 +For full, working examples of running a particular doclet, see the
57.614 .na
57.615 -\f2Running the MIF Doclet\fP @
57.616 +\f2MIF Doclet documentation\fP @
57.617 .fi
57.618 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
57.619 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
57.620 .LP
57.621 .TP 3
57.622 \-1.1
57.623 @@ -3808,7 +3937,7 @@
57.624 .nr 41 \n(80+(3*\n(38)
57.625 .nr 81 +\n(41
57.626 .nr TW \n(81
57.627 -.if t .if \n(TW>\n(.li .tm Table at line 2302 file Input is too wide - \n(TW units
57.628 +.if t .if \n(TW>\n(.li .tm Table at line 2451 file Input is too wide - \n(TW units
57.629 .fc
57.630 .nr #T 0-1
57.631 .nr #a 0-1
57.632 @@ -3915,7 +4044,11 @@
57.633 .LP
57.634 .TP 3
57.635 \-classpath\ classpathlist
57.636 -Specifies the paths where javadoc will look for referenced classes (\f2.class\fP files) \-\- these are the documented classes plus any classes referenced by those classes. The \f2classpathlist\fP can contain multiple paths by separating them with a colon (\f2:\fP). The Javadoc tool will search in all subdirectories of the specified paths. Follow the instructions in class path documentation for specifying \f2classpathlist\fP.
57.637 +Specifies the paths where javadoc will look for referenced classes (\f2.class\fP files) \-\- these are the documented classes plus any classes referenced by those classes. The \f2classpathlist\fP can contain multiple paths by separating them with a colon (\f2:\fP). The Javadoc tool will search in all subdirectories of the specified paths. Follow the instructions in
57.638 +.na
57.639 +\f2class path\fP @
57.640 +.fi
57.641 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general documentation for specifying \f2classpathlist\fP.
57.642 .LP
57.643 If \f2\-sourcepath\fP is omitted, the Javadoc tool uses \f2\-classpath\fP to find the source files as well as class files (for backward compatibility). Therefore, if you want to search for source and class files in separate paths, use both \f2\-sourcepath\fP and \f2\-classpath\fP.
57.644 .LP
57.645 @@ -3928,7 +4061,11 @@
57.646 .fi
57.647 As with other tools, if you do not specify \f2\-classpath\fP, the Javadoc tool uses the CLASSPATH environment variable, if it is set. If both are not set, the Javadoc tool searches for classes from the current directory.
57.648 .LP
57.649 -For an in\-depth description of how the Javadoc tool uses \f2\-classpath\fP to find user classes as it relates to extension classes and bootstrap classes, see How Classes Are Found.
57.650 +For an in\-depth description of how the Javadoc tool uses \f2\-classpath\fP to find user classes as it relates to extension classes and bootstrap classes, see
57.651 +.na
57.652 +\f2How Classes Are Found\fP @
57.653 +.fi
57.654 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html.
57.655 .LP
57.656 As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
57.657 .br
57.658 @@ -3963,7 +4100,11 @@
57.659 .LP
57.660 .TP 3
57.661 \-bootclasspath\ classpathlist
57.662 -Specifies the paths where the boot classes reside. These are nominally the Java platform classes. The bootclasspath is part of the search path the Javadoc tool will use to look up source and class files. See How Classes Are Found. for more details. Separate directories in \f2classpathlist\fP with colons (:).
57.663 +Specifies the paths where the boot classes reside. These are nominally the Java platform classes. The bootclasspath is part of the search path the Javadoc tool will use to look up source and class files. See
57.664 +.na
57.665 +\f2How Classes Are Found\fP @
57.666 +.fi
57.667 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles. for more details. Separate directories in \f2classpathlist\fP with colons (:).
57.668 .LP
57.669 .TP 3
57.670 \-extdirs\ dirlist
57.671 @@ -3979,7 +4120,11 @@
57.672 .LP
57.673 .TP 3
57.674 \-breakiterator\
57.675 -Uses the internationalized sentence boundary of \f2java.text.BreakIterator\fP to determine the end of the first sentence for English (all other locales already use \f2BreakIterator\fP), rather than an English language, locale\-specific algorithm. By \f2first sentence\fP, we mean the first sentence in the main description of a package, class or member. This sentence is copied to the package, class or member summary, and to the alphabetic index.
57.676 +Uses the internationalized sentence boundary of
57.677 +.na
57.678 +\f2java.text.BreakIterator\fP @
57.679 +.fi
57.680 +http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html to determine the end of the first sentence for English (all other locales already use \f2BreakIterator\fP), rather than an English language, locale\-specific algorithm. By \f2first sentence\fP, we mean the first sentence in the main description of a package, class or member. This sentence is copied to the package, class or member summary, and to the alphabetic index.
57.681 .LP
57.682 From JDK 1.2 forward, the BreakIterator class is already used to determine the end of sentence for all languages but English. Therefore, the \f2\-breakiterator\fP option has no effect except for English from 1.2 forward. English has its own default algorithm:
57.683 .RS 3
57.684 @@ -4057,7 +4202,7 @@
57.685 \-use
57.686 Includes one "Use" page for each documented class and package. The page describes what packages, classes, methods, constructors and fields use any API of the given class or package. Given class C, things that use class C would include subclasses of C, fields declared as C, methods that return C, and methods and constructors with parameters of type C.
57.687 .LP
57.688 -For example, let's look at what might appear on the "Use" page for String. The \f2getName()\fP method in the \f2java.awt.Font\fP class returns type \f2String\fP. Therefore, \f2getName()\fP uses \f2String\fP, and you will find that method on the "Use" page for \f2String\fP.
57.689 +For example, let us look at what might appear on the "Use" page for String. The \f2getName()\fP method in the \f2java.awt.Font\fP class returns type \f2String\fP. Therefore, \f2getName()\fP uses \f2String\fP, and you will find that method on the "Use" page for \f2String\fP.
57.690 .LP
57.691 Note that this documents only uses of the API, not the implementation. If a method uses \f2String\fP in its implementation but does not take a string as an argument or return a string, that is not considered a "use" of \f2String\fP.
57.692 .LP
57.693 @@ -4080,7 +4225,7 @@
57.694 .nf
57.695 \f3
57.696 .fl
57.697 - % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
57.698 + % \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
57.699 .fl
57.700 .fi
57.701 .TP 3
57.702 @@ -4089,7 +4234,7 @@
57.703 .nf
57.704 \f3
57.705 .fl
57.706 - % \fP\f3javadoc \-doctitle "Java<sup><font size=\\"\-2\\">TM</font></sup>" com.mypackage\fP
57.707 + % \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
57.708 .fl
57.709 .fi
57.710 .TP 3
57.711 @@ -4163,18 +4308,18 @@
57.712 when using an absolute URL to the external API document, if your shell \f2does not allow\fP a program to open a connection to that URL for reading. This can occur if you are behind a firewall and the document you want to link to is on the other side.
57.713 .RE
57.714 .LP
57.715 -\f3Example using absolute links to the external docs\fP \- Let's say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java 2 Platform packages at
57.716 +\f3Example using absolute links to the external docs\fP \- Let us say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java Platform packages at
57.717 .na
57.718 -\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
57.719 +\f2http://java.sun.com/javase/6/docs/api/\fP @
57.720 .fi
57.721 -http://java.sun.com/j2se/1.5.0/docs/api, The following command generates documentation for the package \f2com.mypackage\fP with links to the Java 2 Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other options, such as \f2\-sourcepath\fP and \f2\-d\fP, are not shown.)
57.722 +http://java.sun.com/javase/6/docs/api. The following command generates documentation for the package \f2com.mypackage\fP with links to the Java SE Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other options, such as \f2\-sourcepath\fP and \f2\-d\fP, are not shown.)
57.723 .nf
57.724 \f3
57.725 .fl
57.726 - % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
57.727 + % \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
57.728 .fl
57.729 .fi
57.730 -\f3Example using relative links to the external docs\fP \- Let's say you have two packages whose docs are generated in different runs of the Javadoc tool, and those docs are separated by a relative path. In this example, the packages are \f2com.apipackage\fP, an API, and \f2com.spipackage\fP, an SPI (Service Provide Interface). You want the documentation to reside in \f2docs/api/com/apipackage\fP and \f2docs/spi/com/spipackage\fP. Assuming the API package documentation is already generated, and that \f2docs\fP is the current directory, you would document the SPI package with links to the API documentation by running:
57.731 +\f3Example using relative links to the external docs\fP \- Let us say you have two packages whose docs are generated in different runs of the Javadoc tool, and those docs are separated by a relative path. In this example, the packages are \f2com.apipackage\fP, an API, and \f2com.spipackage\fP, an SPI (Service Provide Interface). You want the documentation to reside in \f2docs/api/com/apipackage\fP and \f2docs/spi/com/spipackage\fP. Assuming the API package documentation is already generated, and that \f2docs\fP is the current directory, you would document the SPI package with links to the API documentation by running:
57.732 .nf
57.733 \f3
57.734 .fl
57.735 @@ -4214,11 +4359,11 @@
57.736 .LP
57.737 \f3Package List\fP \- The \f2\-link\fP option requires that a file named \f2package\-list\fP, which is generated by the Javadoc tool, exist at the URL you specify with \f2\-link\fP. The \f2package\-list\fP file is a simple text file that lists the names of packages documented at that location. In the earlier example, the Javadoc tool looks for a file named \f2package\-list\fP at the given URL, reads in the package names and then links to those packages at that URL.
57.738 .LP
57.739 -For example, the package list for the Java 2 Platform 5.0 API is located at
57.740 +For example, the package list for the Java SE 6 API is located at
57.741 .na
57.742 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
57.743 +\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
57.744 .fi
57.745 -http://java.sun.com/j2se/1.5.0/docs/api/package\-list. and starts out as follows:
57.746 +http://java.sun.com/javase/6/docs/api/package\-list. and starts as follows:
57.747 .nf
57.748 \f3
57.749 .fl
57.750 @@ -4277,15 +4422,15 @@
57.751 .LP
57.752 You can specify multiple \f2\-linkoffline\fP options in a given javadoc run. (Prior to 1.2.2, it could be specified only once.)
57.753 .LP
57.754 -\f3Example using absolute links to the external docs\fP \- Let's say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java 2 Platform packages at \f2http://java.sun.com/j2se/1.5.0/docs/api\fP, but your shell does not have web access. You could open the \f2package\-list\fP file in a browser at
57.755 +\f3Example using absolute links to the external docs\fP \- Let us say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java SE Platform packages at \f2http://java.sun.com/javase/6/docs/api\fP, but your shell does not have web access. You could open the \f2package\-list\fP file in a browser at
57.756 .na
57.757 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
57.758 +\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
57.759 .fi
57.760 -http://java.sun.com/j2se/1.5.0/docs/api/package\-list, save it to a local directory, and point to this local copy with the second argument, \f2packagelistLoc\fP. In this example, the package list file has been saved to the current directory "\f2.\fP" . The following command generates documentation for the package \f2com.mypackage\fP with links to the Java 2 Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other necessary options, such as \f2\-sourcepath\fP, are not shown.)
57.761 +http://java.sun.com/javase/6/docs/api/package\-list, save it to a local directory, and point to this local copy with the second argument, \f2packagelistLoc\fP. In this example, the package list file has been saved to the current directory "\f2.\fP" . The following command generates documentation for the package \f2com.mypackage\fP with links to the Java SE Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other necessary options, such as \f2\-sourcepath\fP, are not shown.)
57.762 .nf
57.763 \f3
57.764 .fl
57.765 -% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
57.766 +% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
57.767 .fl
57.768 .fi
57.769 .LP
57.770 @@ -4303,7 +4448,7 @@
57.771 .LP
57.772 \f3Updating docs\fP \- Another use for \f2\-linkoffline\fP option is useful if your project has dozens or hundreds of packages, if you have already run javadoc on the entire tree, and now, in a separate run, you want to quickly make some small changes and re\-run javadoc on just a small portion of the source tree. This is somewhat of a hack in that it works properly only if your changes are only to doc comments and not to declarations. If you were to add, remove or change any declarations from the source code, then broken links could show up in the index, package tree, inherited member lists, use page, and other places.
57.773 .LP
57.774 -First, you create a new destination directory (call it \f2update\fP) for this new small run. Let's say the original destination directory was named \f2html\fP. In the simplest example, cd to the parent of \f2html\fP. Set the first argument of \f2\-linkoffline\fP to the current directory "." and set the second argument to the relative path to \f2html\fP, where it can find \f2package\-list\fP, and pass in only the package names of the packages you want to update:
57.775 +First, you create a new destination directory (call it \f2update\fP) for this new small run. Let us say the original destination directory was named \f2html\fP. In the simplest example, cd to the parent of \f2html\fP. Set the first argument of \f2\-linkoffline\fP to the current directory "." and set the second argument to the relative path to \f2html\fP, where it can find \f2package\-list\fP, and pass in only the package names of the packages you want to update:
57.776 .nf
57.777 \f3
57.778 .fl
57.779 @@ -4527,7 +4672,7 @@
57.780 .br
57.781 \f4f\fP (fields)
57.782 .LP
57.783 -\f3Examples of single tags\fP \- An example of a tag option for a tag that that can be used anywhere in the source code is:
57.784 +\f3Examples of single tags\fP \- An example of a tag option for a tag that can be used anywhere in the source code is:
57.785 .nf
57.786 \f3
57.787 .fl
57.788 @@ -4635,7 +4780,10 @@
57.789 .RS 3
57.790 .TP 2
57.791 o
57.792 -Taglet Overview
57.793 +.na
57.794 +\f2Taglet Overview\fP @
57.795 +.fi
57.796 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
57.797 .RE
57.798 .LP
57.799 Taglets are useful for block or inline tags. They can have any number of arguments and implement custom behavior, such as making text bold, formatting bullets, writing out the text to a file, or starting other processes.
57.800 @@ -4713,7 +4861,7 @@
57.801 .nf
57.802 \f3
57.803 .fl
57.804 - <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
57.805 + <!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
57.806 .fl
57.807 \fP
57.808 .fi
57.809 @@ -4724,6 +4872,8 @@
57.810 .RE
57.811 .SH "COMMAND LINE ARGUMENT FILES"
57.812 .LP
57.813 +
57.814 +.LP
57.815 .LP
57.816 To shorten or simplify the javadoc command line, you can specify one or more files that themselves contain arguments to the \f2javadoc\fP command (except \f2\-J\fP options). This enables you to create javadoc commands of any length on any operating system.
57.817 .LP
57.818 @@ -4771,19 +4921,19 @@
57.819 .fl
57.820 \-splitindex
57.821 .fl
57.822 - \-windowtitle 'Java 2 Platform v1.3 API Specification'
57.823 -.fl
57.824 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification'
57.825 -.fl
57.826 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
57.827 -.fl
57.828 - \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
57.829 + \-windowtitle 'Java(TM) SE 7 API Specification'
57.830 +.fl
57.831 + \-doctitle 'Java(TM) SE 7 API Specification'
57.832 +.fl
57.833 + \-header '<b>Java(TM); SE 7'
57.834 +.fl
57.835 + \-bottom 'Copyright 1993\-2009 Sun Microsystems, Inc. All Rights Reserved.'
57.836 .fl
57.837 \-group "Core Packages" "java.*"
57.838 .fl
57.839 - \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
57.840 -.fl
57.841 - \-sourcepath /java/pubs/ws/1.5/src/share/classes
57.842 + \-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
57.843 +.fl
57.844 + \-sourcepath /java/pubs/ws/1.7.0/src/share/classes
57.845 .fl
57.846 \fP
57.847 .fi
57.848 @@ -4873,25 +5023,38 @@
57.849 % \fP\f3javadoc @bottom @packages\fP
57.850 .fl
57.851 .fi
57.852 -.SH NAME
57.853 +
57.854 +.LP
57.855 +
57.856 +.LP
57.857 +.SH "Name"
57.858 Running
57.859 +.LP
57.860 .SH "RUNNING JAVADOC"
57.861 .LP
57.862 +
57.863 +.LP
57.864 .LP
57.865 \f3Version Numbers\fP \- The version number of javadoc can be determined using \f3javadoc \-J\-version\fP. The version number of the standard doclet appears in its output stream. It can be turned off with \f2\-quiet\fP.
57.866 .LP
57.867 .LP
57.868 -\f3Public programmatic interface\fP \- To invoke the Javadoc tool from within programs written in the Java language. This interface is in \f2com.sun.tools.javadoc.Main\fP (and javadoc is re\-entrant). For more details, see Standard Doclet.
57.869 -.LP
57.870 -.LP
57.871 -\f3Running Doclets\fP \- The instructions given below are for invoking the standard HTML doclet. To invoke a custom doclet, use the \-doclet and \-docletpath options. For full, working examples of running a particular doclet, see
57.872 +\f3Public programmatic interface\fP \- To invoke the Javadoc tool from within programs written in the Java language. This interface is in \f2com.sun.tools.javadoc.Main\fP (and javadoc is re\-entrant). For more details, see
57.873 .na
57.874 -\f2Running the MIF Doclet\fP @
57.875 +\f2Standard Doclet\fP @
57.876 .fi
57.877 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
57.878 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammatically.
57.879 +.LP
57.880 +.LP
57.881 +\f3Running Doclets\fP \- The instructions given below are for invoking the standard HTML doclet. To invoke a custom doclet, use the \-doclet and \-docletpath options. For full, working examples of running a particular doclet, see the
57.882 +.na
57.883 +\f2MIF Doclet documentation\fP @
57.884 +.fi
57.885 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
57.886 .LP
57.887 .SH "SIMPLE EXAMPLES"
57.888 .LP
57.889 +
57.890 +.LP
57.891 .LP
57.892 You can run javadoc on entire packages or individual source files. Each package name has a corresponding directory name. In the following examples, the source files are located at \f2/home/src/java/awt/*.java\fP. The destination directory is \f2/home/html\fP.
57.893 .LP
57.894 @@ -5014,8 +5177,10 @@
57.895 .LP
57.896 .SH "REAL WORLD EXAMPLE"
57.897 .LP
57.898 -.LP
57.899 -The Javadoc tool has many useful options, some of which are more commonly used than others. Here is effectively the command we use to run the Javadoc tool on the Java platform API. We use 180MB of memory to generate the documentation for the 1500 (approx.) public and protected classes in the Java 2 Platform, Standard Edition, v1.2.
57.900 +
57.901 +.LP
57.902 +.LP
57.903 +The Javadoc tool has many useful options, some of which are more commonly used than others. Here is effectively the command we use to run the Javadoc tool on the Java platform API. We use 180MB of memory to generate the documentation for the 1500 (approx.) public and protected classes in the Java SE Platform, Standard Edition, v1.2.
57.904 .LP
57.905 .LP
57.906 The same example is shown twice \-\- first as executed on the command line, then as executed from a makefile. It uses absolute paths in the option arguments, which enables the same \f2javadoc\fP command to be run from any directory.
57.907 @@ -5029,21 +5194,21 @@
57.908 .nf
57.909 \f3
57.910 .fl
57.911 -% javadoc \-sourcepath /java/jdk/src/share/classes \\
57.912 -.fl
57.913 - \-overview /java/jdk/src/share/classes/overview.html \\
57.914 -.fl
57.915 - \-d /java/jdk/build/api \\
57.916 -.fl
57.917 - \-use \\
57.918 -.fl
57.919 - \-splitIndex \\
57.920 -.fl
57.921 - \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
57.922 -.fl
57.923 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification' \\
57.924 -.fl
57.925 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
57.926 +% javadoc \-sourcepath /java/jdk/src/share/classes \\
57.927 +.fl
57.928 + \-overview /java/jdk/src/share/classes/overview.html \\
57.929 +.fl
57.930 + \-d /java/jdk/build/api \\
57.931 +.fl
57.932 + \-use \\
57.933 +.fl
57.934 + \-splitIndex \\
57.935 +.fl
57.936 + \-windowtitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
57.937 +.fl
57.938 + \-doctitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
57.939 +.fl
57.940 + \-header '<b>Java(TM) SE </b><br><font size="\-1">7</font>' \\
57.941 .fl
57.942 \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
57.943 .fl
57.944 @@ -5053,9 +5218,9 @@
57.945 .fl
57.946 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
57.947 .fl
57.948 - \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
57.949 -.fl
57.950 - \-group "Extension Packages" "javax.*" \\
57.951 + \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
57.952 +.fl
57.953 + \-group "Extension Packages" "javax.*" \\
57.954 .fl
57.955 \-J\-Xmx180m \\
57.956 .fl
57.957 @@ -5107,17 +5272,17 @@
57.958 .fl
57.959 java.lang java.lang.reflect \\ /* Sets packages to document */
57.960 .fl
57.961 - java.util java.io java.net \\
57.962 + java.util java.io java.net \\
57.963 .fl
57.964 java.applet
57.965 .fl
57.966
57.967 .fl
57.968 -WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
57.969 -.fl
57.970 -DOCTITLE = 'Java<sup><font size="\-2">TM</font></sup> 2 Platform v1.2 API Specification'
57.971 -.fl
57.972 -HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
57.973 +WINDOWTITLE = 'Java(TM) SE 7 API Specification'
57.974 +.fl
57.975 +DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
57.976 +.fl
57.977 +HEADER = '<b>Java(TM) SE 7</font>'
57.978 .fl
57.979 BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
57.980 .fl
57.981 @@ -5133,7 +5298,7 @@
57.982 .fl
57.983 GROUPEXT = '"Extension Packages" "javax.*"'
57.984 .fl
57.985 -SRCDIR = '/java/jdk/1.2/src/share/classes'
57.986 +SRCDIR = '/java/jdk/1.7.0/src/share/classes'
57.987 .fl
57.988 \fP
57.989 .fi
57.990 @@ -5160,6 +5325,8 @@
57.991 .LP
57.992 .SH "TROUBLESHOOTING"
57.993 .LP
57.994 +
57.995 +.LP
57.996 .SS
57.997 General Troubleshooting
57.998 .LP
57.999 @@ -5173,11 +5340,7 @@
57.1000 http://java.sun.com/j2se/javadoc/faq/index.html#B
57.1001 .TP 2
57.1002 o
57.1003 -\f3Bugs and Limitations\fP \- You can also see some bugs listed at
57.1004 -.na
57.1005 -\f2Important Bug Fixes and Changes\fP @
57.1006 -.fi
57.1007 -http://java.sun.com/j2se/1.5.0/fixedbugs/index.html.
57.1008 +\f3Bugs and Limitations\fP \- You can also see some bugs listed at Important Bug Fixes and Changes.
57.1009 .TP 2
57.1010 o
57.1011 \f3Version number\fP \- See version numbers.
57.1012 @@ -5202,6 +5365,8 @@
57.1013 .LP
57.1014 .SH "ENVIRONMENT"
57.1015 .LP
57.1016 +
57.1017 +.LP
57.1018 .RS 3
57.1019 .TP 3
57.1020 CLASSPATH
57.1021 @@ -5212,22 +5377,24 @@
57.1022 .LP
57.1023 .SH "SEE ALSO"
57.1024 .LP
57.1025 +
57.1026 +.LP
57.1027 .RS 3
57.1028 .TP 2
57.1029 o
57.1030 -javac
57.1031 +javac(1)
57.1032 .TP 2
57.1033 o
57.1034 -java
57.1035 +java(1)
57.1036 .TP 2
57.1037 o
57.1038 -jdb
57.1039 +jdb(1)
57.1040 .TP 2
57.1041 o
57.1042 -javah
57.1043 +javah(1)
57.1044 .TP 2
57.1045 o
57.1046 -javap
57.1047 +javap(1)
57.1048 .TP 2
57.1049 o
57.1050 .na
57.1051 @@ -5242,12 +5409,22 @@
57.1052 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
57.1053 .TP 2
57.1054 o
57.1055 -Setting the Class Path
57.1056 +.na
57.1057 +\f2Setting the Class Path\fP @
57.1058 +.fi
57.1059 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
57.1060 .TP 2
57.1061 o
57.1062 -How Javac and Javadoc Find Classes (tools.jar)
57.1063 +.na
57.1064 +\f2How Javac and Javadoc Find Classes\fP @
57.1065 +.fi
57.1066 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
57.1067 .RE
57.1068
57.1069 .LP
57.1070 -.LP
57.1071 -Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
57.1072 +
57.1073 +.LP
57.1074 +.LP
57.1075 +Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
57.1076 +.LP
57.1077 +
58.1 --- a/src/linux/doc/man/javah.1 Tue May 12 15:21:55 2009 +0900
58.2 +++ b/src/linux/doc/man/javah.1 Thu May 14 00:17:25 2009 -0700
58.3 @@ -1,6 +1,4 @@
58.4 -.'" t
58.5 -."
58.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
58.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
58.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
58.9 ."
58.10 ." This code is free software; you can redistribute it and/or modify it
58.11 @@ -20,20 +18,21 @@
58.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
58.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
58.14 ." have any questions.
58.15 -." .
58.16 -." `
58.17 -.TH javah 1 "05 Aug 2006"
58.18 -." Generated by html2roff
58.19 +."
58.20 +.TH javah 1 "04 May 2009"
58.21 +." Generated from HTML by html2man (author: Eric Armstrong)
58.22
58.23 .LP
58.24 -.SH NAME
58.25 +.SH "Name"
58.26 javah \- C Header and Stub File Generator
58.27 .LP
58.28 +.RS 3
58.29
58.30 .LP
58.31 .LP
58.32 \f3javah\fP produces C header files and C source files from a Java class. These files provide the connective glue that allow your Java and C code to interact.
58.33 .LP
58.34 +.RE
58.35 .SH "SYNOPSIS"
58.36 .LP
58.37
58.38 @@ -66,12 +65,13 @@
58.39 The new native method interface, Java Native Interface (JNI), does not require header information or stub files. \f3javah\fP can still be used to generate native method function proptotypes needed for JNI\-style native methods. \f3javah\fP produces JNI\-style output by default, and places the result in the .h file.
58.40 .LP
58.41 .LP
58.42 -\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like \f3jdb\fP.
58.43 +\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like jdb(1).
58.44 .LP
58.45 .SH "OPTIONS"
58.46 .LP
58.47
58.48 .LP
58.49 +.RS 3
58.50 .TP 3
58.51 \-o outputfile
58.52 Concatenates the resulting header or source files for all the classes listed on the command line into \f2outputfile\fP. Only one of \f3\-o\fP or \f3\-d\fP may be used.
58.53 @@ -115,7 +115,7 @@
58.54 As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
58.55 .br
58.56 .br
58.57 -For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
58.58 +For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
58.59 .TP 3
58.60 \-bootclasspath path
58.61 Specifies path from which to load bootstrap classes. By default, the bootstrap classes are the classes implementing the core Java 2 platform located in \f2jre/lib/rt.jar\fP and several other jar files.
58.62 @@ -127,12 +127,15 @@
58.63 Specifies that output files should always be written.
58.64 .TP 3
58.65 \-Joption
58.66 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
58.67 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
58.68 +.RE
58.69 +
58.70 .LP
58.71 .SH "ENVIRONMENT VARIABLES"
58.72 .LP
58.73
58.74 .LP
58.75 +.RS 3
58.76 .TP 3
58.77 CLASSPATH
58.78 Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example,
58.79 @@ -143,6 +146,7 @@
58.80 .fl
58.81 \fP
58.82 .fi
58.83 +.RE
58.84
58.85 .LP
58.86 .SH "SEE ALSO"
58.87 @@ -150,7 +154,7 @@
58.88
58.89 .LP
58.90 .LP
58.91 -javac, java, jdb, javap, javadoc
58.92 +javac(1), java(1), jdb(1), javap(1), javadoc(1)
58.93 .LP
58.94
58.95 .LP
59.1 --- a/src/linux/doc/man/javap.1 Tue May 12 15:21:55 2009 +0900
59.2 +++ b/src/linux/doc/man/javap.1 Thu May 14 00:17:25 2009 -0700
59.3 @@ -1,6 +1,4 @@
59.4 -.'" t
59.5 -."
59.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
59.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
59.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
59.9 ."
59.10 ." This code is free software; you can redistribute it and/or modify it
59.11 @@ -21,19 +19,20 @@
59.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
59.13 ." have any questions.
59.14 ."
59.15 -." `
59.16 -.TH javap 1 "05 Aug 2006"
59.17 -." Generated by html2roff
59.18 +.TH javap 1 "04 May 2009"
59.19 +." Generated from HTML by html2man (author: Eric Armstrong)
59.20
59.21 .LP
59.22 -.SH NAME
59.23 +.SH "Name"
59.24 javap \- The Java Class File Disassembler
59.25 .LP
59.26 +.RS 3
59.27
59.28 .LP
59.29 .LP
59.30 Disassembles class files.
59.31 .LP
59.32 +.RE
59.33 .SH "SYNOPSIS"
59.34 .LP
59.35
59.36 @@ -253,6 +252,7 @@
59.37 .LP
59.38
59.39 .LP
59.40 +.RS 3
59.41 .TP 3
59.42 \-help
59.43 Prints out help message for \f3javap\fP.
59.44 @@ -260,9 +260,6 @@
59.45 \-l
59.46 Prints out line and local variable tables.
59.47 .TP 3
59.48 -\-b
59.49 -Ensures backward compatibility with \f3javap\fP in JDK 1.1.
59.50 -.TP 3
59.51 \-public
59.52 Shows only public classes and members.
59.53 .TP 3
59.54 @@ -327,11 +324,14 @@
59.55 .TP 3
59.56 \-extdirs dirs
59.57 Overrides location at which installed extensions are searched for. The default location for extensions is the value of \f2java.ext.dirs\fP.
59.58 +.RE
59.59 +
59.60 .LP
59.61 .SH "ENVIRONMENT VARIABLES"
59.62 .LP
59.63
59.64 .LP
59.65 +.RS 3
59.66 .TP 3
59.67 CLASSPATH
59.68 Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example, For example:
59.69 @@ -346,6 +346,7 @@
59.70 \fP
59.71 .fi
59.72 .RE
59.73 +.RE
59.74
59.75 .LP
59.76 .SH "SEE ALSO"
59.77 @@ -353,7 +354,7 @@
59.78
59.79 .LP
59.80 .LP
59.81 -javac, java, jdb, javah, javadoc
59.82 +javac(1), java(1), jdb(1), javah(1), javadoc(1)
59.83 .LP
59.84
59.85 .LP
60.1 --- a/src/linux/doc/man/javaws.1 Tue May 12 15:21:55 2009 +0900
60.2 +++ b/src/linux/doc/man/javaws.1 Thu May 14 00:17:25 2009 -0700
60.3 @@ -1,5 +1,3 @@
60.4 -.'" t
60.5 -."
60.6 ." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
60.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
60.8 ."
60.9 @@ -20,15 +18,14 @@
60.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
60.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
60.12 ." have any questions.
60.13 -."
60.14 -." `
60.15 -.TH javaws 1 "05 Aug 2006"
60.16 -." Generated by html2roff
60.17 +."
60.18 +.TH javaws 1 "04 May 2009"
60.19 +." Generated from HTML by html2man (author: Eric Armstrong)
60.20
60.21 .LP
60.22
60.23 .LP
60.24 -.SH NAME
60.25 +.SH "Name"
60.26 \f2javaws\fP Command Line
60.27 .LP
60.28
60.29 @@ -39,104 +36,93 @@
60.30 .SS
60.31 NAME
60.32 .LP
60.33 +.RS 3
60.34
60.35 .LP
60.36 .LP
60.37 \f2javaws\fP \- Java Web Start launcher command
60.38 .LP
60.39 +.RE
60.40 .SS
60.41 SYNOPSIS
60.42 .LP
60.43 -
60.44 -.LP
60.45 -.LP
60.46 -\f2javaws [ options ] [ URL ]\fP
60.47 -.LP
60.48 -.SS
60.49 -PARAMETERS
60.50 -.LP
60.51 -
60.52 -.LP
60.53 -.LP
60.54 -\f2options\fP
60.55 -.LP
60.56 .RS 3
60.57
60.58 .LP
60.59 .LP
60.60 -Command\-line options. Options may be in any order. For a discussion of the various options, see OPTIONS below.
60.61 +\f2javaws [run\-options] <jnlp>\fP
60.62 +.LP
60.63 +.LP
60.64 +\f2javaws [control\-options]\fP
60.65 .LP
60.66 .RE
60.67 -.LP
60.68 -\f2URL\fP
60.69 +.SS
60.70 +PARAMETERS
60.71 .LP
60.72 .RS 3
60.73
60.74 .LP
60.75 .LP
60.76 -Uniform Resource Locator (\f2URL\fP) of the JNLP (Java Net\-work Launching Protocol) file.
60.77 +\f2[run\-options]\fP
60.78 .LP
60.79 +.RS 3
60.80 +
60.81 +.LP
60.82 +.LP
60.83 +Command\-line run\-options. run\-options may be in any order. For a discussion of the various run\-options, see RUN\-OPTIONS below.
60.84 +.LP
60.85 +.RE
60.86 +.LP
60.87 +\f2<jnlp>\fP
60.88 +.LP
60.89 +.RS 3
60.90 +
60.91 +.LP
60.92 +.LP
60.93 +This can be either the path of, or the Uniform Resource Locater (URL) of the JNLP (Java Network Launching Protocol) file.
60.94 +.LP
60.95 +.RE
60.96 +.LP
60.97 +\f2[control\-options]\fP
60.98 +.LP
60.99 +.RS 3
60.100 +
60.101 +.LP
60.102 +.LP
60.103 +Command\-line control\-options. control\-options may be in any order. For a discussion of the various control\-options, see CONTROL\-OPTIONS below.
60.104 +.LP
60.105 +.RE
60.106 .RE
60.107 .SS
60.108 DESCRIPTION
60.109 .LP
60.110 +.RS 3
60.111
60.112 .LP
60.113 .LP
60.114 The \f2javaws\fP command launches Java Web Start, which is the reference implementation of the Java Network Launching Protocol (JNLP). Java Web Start launches Java applications/applets hosted on a network.
60.115 .LP
60.116 .LP
60.117 -Without any options \f2javaws\fP will launch the Java JNLP Application Manager, from which users can launch applications/applet or configure Java Web Start.
60.118 +If a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
60.119 .LP
60.120 .LP
60.121 -If a \f2URL\fP for a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
60.122 +The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release.
60.123 .LP
60.124 +.RE
60.125 .SS
60.126 -OPTIONS
60.127 +RUN\-OPTIONS
60.128 .LP
60.129 +.RS 3
60.130
60.131 .LP
60.132 .LP
60.133 -The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release. All \f2\-X\fP options are non\-standard and subject to change.
60.134 -.LP
60.135 -.LP
60.136 \f2\-offline\fP
60.137 .LP
60.138 .RS 3
60.139
60.140 .LP
60.141 .LP
60.142 -Runs Java Web Start in offline mode.
60.143 -.LP
60.144 -.RE
60.145 -.LP
60.146 -\f2\-uninstall <URL>\fP
60.147 -.LP
60.148 -.RS 3
60.149 -
60.150 -.LP
60.151 -.LP
60.152 -Removes a specific application/applet from the user's cache, as indicated by the URL for the JNLP file. If \f2<URL>\fP is not specified, the entire cache is removed. Java Web Start will exit after the command is completed.
60.153 -.LP
60.154 -.RE
60.155 -.LP
60.156 -\f2\-updateVersions\fP
60.157 -.LP
60.158 -.RS 3
60.159 -
60.160 -.LP
60.161 -.LP
60.162 -Updates the Java Web Start configuration file based on the current machine's settings. Java Web Start will exit after the command is completed.
60.163 -.LP
60.164 -.RE
60.165 -.LP
60.166 -\f2\-Xclearcache\fP
60.167 -.LP
60.168 -.RS 3
60.169 -
60.170 -.LP
60.171 -.LP
60.172 -Clears the user's cache. Java Web Start will exit after the command is completed.
60.173 +run Java Web Start in offline mode.
60.174 .LP
60.175 .RE
60.176 .LP
60.177 @@ -146,67 +132,7 @@
60.178
60.179 .LP
60.180 .LP
60.181 -Disables the display of the initial splash screen.
60.182 -.LP
60.183 -.RE
60.184 -.LP
60.185 -\f2\-import\fP
60.186 -.LP
60.187 -.RS 3
60.188 -
60.189 -.LP
60.190 -.LP
60.191 -Imports the application specified by URL into the user's cache but does not run it.
60.192 -.LP
60.193 -.RE
60.194 -.LP
60.195 -\f2\-silent\fP
60.196 -.LP
60.197 -.RS 3
60.198 -
60.199 -.LP
60.200 -.LP
60.201 -When used with the \f2\-import\fP option, imports in silent mode; i.e., there will be no UI pop up. The process exit code will be either 0 if successful or 1 if not.
60.202 -.LP
60.203 -.RE
60.204 -.LP
60.205 -\f2\-codebase <url>\fP
60.206 -.LP
60.207 -.RS 3
60.208 -
60.209 -.LP
60.210 -.LP
60.211 -Replaces the codebase with \f2<url>\fP in the jnlp file specified when importing the resources. \f2<url>\fP must be a valid \f2URL\fP.
60.212 -.LP
60.213 -.RE
60.214 -.LP
60.215 -\f2\-system\fP
60.216 -.LP
60.217 -.RS 3
60.218 -
60.219 -.LP
60.220 -.LP
60.221 -Uses the system cache instead of the user cache.
60.222 -.LP
60.223 -.RE
60.224 -.LP
60.225 -\f2\-shortcut\fP
60.226 -.LP
60.227 -.RS 3
60.228 -
60.229 -.LP
60.230 -.LP
60.231 -Allows the creation of shortcuts during silent import.
60.232 -.LP
60.233 -.RE
60.234 -.LP
60.235 -\f2\-association\fP
60.236 -.LP
60.237 -.RS 3
60.238 -
60.239 -.LP
60.240 -.LP
60.241 -Allows the creation of associations during silent import.
60.242 +disable the display of the initial splash screen.
60.243 .LP
60.244 .RE
60.245 .LP
60.246 @@ -236,17 +162,64 @@
60.247
60.248 .LP
60.249 .LP
60.250 -Runs in online mode (default behavior).
60.251 +run in online mode (default behavior).
60.252 .LP
60.253 .RE
60.254 .LP
60.255 +\f2\-wait\fP
60.256 +.LP
60.257 +.RS 3
60.258 +
60.259 +.LP
60.260 +.LP
60.261 +If specified, the \f2javaws\fP process will not exit until the application exits.
60.262 +.LP
60.263 +.RE
60.264 +.LP
60.265 +\f2\-verbose\fP
60.266 +.LP
60.267 +.RS 3
60.268 +
60.269 +.LP
60.270 +.LP
60.271 +display additional output.
60.272 +.LP
60.273 +.RE
60.274 +.LP
60.275 +\f2\-J<option>\fP
60.276 +.LP
60.277 +.RS 3
60.278 +
60.279 +.LP
60.280 +.LP
60.281 +supply options to the vm.
60.282 +.LP
60.283 +.RE
60.284 +.LP
60.285 +\f2\-system\fP
60.286 +.LP
60.287 +.RS 3
60.288 +
60.289 +.LP
60.290 +.LP
60.291 +run the application from the system cache only.
60.292 +.LP
60.293 +.RE
60.294 +.RE
60.295 +.SS
60.296 +CONTROL\-OPTIONS
60.297 +.LP
60.298 +.RS 3
60.299 +
60.300 +.LP
60.301 +.LP
60.302 \f2\-viewer\fP
60.303 .LP
60.304 .RS 3
60.305
60.306 .LP
60.307 .LP
60.308 -Runs the Java Application Cache Viewer (default if no URL is specified).
60.309 +show the Cache Viewer in the java control panel
60.310 .LP
60.311 .RE
60.312 .LP
60.313 @@ -256,7 +229,7 @@
60.314
60.315 .LP
60.316 .LP
60.317 -Clears the specified deployment property.
60.318 +clear the specified deployment property.
60.319 .LP
60.320 .RE
60.321 .LP
60.322 @@ -266,25 +239,96 @@
60.323
60.324 .LP
60.325 .LP
60.326 -Sets the specified deployment property to the specified value.
60.327 +set the specified deployment property to the specified value.
60.328 .LP
60.329 .RE
60.330 .LP
60.331 -\f2\-wait\fP
60.332 +\f2\-uninstall\fP
60.333 .LP
60.334 .RS 3
60.335
60.336 .LP
60.337 .LP
60.338 -If specified, the \f2javaws\fP process will not exit until the application exits.
60.339 +remove all applications from the cache.
60.340 .LP
60.341 .RE
60.342 .LP
60.343 -\
60.344 +\f2\-uninstall <jnlp>\fP
60.345 .LP
60.346 +.RS 3
60.347 +
60.348 +.LP
60.349 +.LP
60.350 +remove the application from the cache.
60.351 +.LP
60.352 +.RE
60.353 +.LP
60.354 +\f2\-import [import\-options] <jnlp>\fP
60.355 +.LP
60.356 +.RS 3
60.357 +
60.358 +.LP
60.359 +.LP
60.360 +import the application to the cache.
60.361 +.LP
60.362 +.RE
60.363 +\f3IMPORT\-OPTIONS\fP
60.364 +.LP
60.365 +.LP
60.366 +\f2\-silent\fP
60.367 +.LP
60.368 +.RS 3
60.369 +
60.370 +.LP
60.371 +.LP
60.372 +import silently (with no user interface).
60.373 +.LP
60.374 +.RE
60.375 +.LP
60.376 +\f2\-system\fP
60.377 +.LP
60.378 +.RS 3
60.379 +
60.380 +.LP
60.381 +.LP
60.382 +import application to the system cache.
60.383 +.LP
60.384 +.RE
60.385 +.LP
60.386 +\f2\-codebase <url>\fP
60.387 +.LP
60.388 +.RS 3
60.389 +
60.390 +.LP
60.391 +.LP
60.392 +retrieve resources from the given codebase.
60.393 +.LP
60.394 +.RE
60.395 +.LP
60.396 +\f2\-shortcut\fP
60.397 +.LP
60.398 +.RS 3
60.399 +
60.400 +.LP
60.401 +.LP
60.402 +install shortcuts as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
60.403 +.LP
60.404 +.RE
60.405 +.LP
60.406 +\f2\-association\fP
60.407 +.LP
60.408 +.RS 3
60.409 +
60.410 +.LP
60.411 +.LP
60.412 +install associations as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
60.413 +.LP
60.414 +.RE
60.415 +.RE
60.416 .SS
60.417 FILES
60.418 .LP
60.419 +.RS 3
60.420
60.421 .LP
60.422 .LP
60.423 @@ -294,15 +338,17 @@
60.424 .fi
60.425 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
60.426 .LP
60.427 +.RE
60.428 .SS
60.429 MORE INFORMATION
60.430 .LP
60.431 +.RS 3
60.432
60.433 .LP
60.434 .LP
60.435 For more information about Java Web Start, see
60.436 .na
60.437 -\f2Java Web Start version 1.5.0\fP @
60.438 +\f2Java Web Start\fP @
60.439 .fi
60.440 http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
60.441 .LP
60.442 @@ -313,4 +359,7 @@
60.443 \
60.444 .LP
60.445 .RE
60.446 +.RE
60.447 +
60.448 +.LP
60.449
61.1 --- a/src/linux/doc/man/jconsole.1 Tue May 12 15:21:55 2009 +0900
61.2 +++ b/src/linux/doc/man/jconsole.1 Thu May 14 00:17:25 2009 -0700
61.3 @@ -1,6 +1,4 @@
61.4 -.'" t
61.5 -."
61.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
61.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
61.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
61.9 ."
61.10 ." This code is free software; you can redistribute it and/or modify it
61.11 @@ -20,13 +18,12 @@
61.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
61.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
61.14 ." have any questions.
61.15 -."
61.16 -." `
61.17 -.TH jconsole 1 "07 Aug 2006"
61.18 -." Generated by html2man
61.19 +."
61.20 +.TH jconsole 1 "04 May 2009"
61.21 +." Generated from HTML by html2man (author: Eric Armstrong)
61.22
61.23 .LP
61.24 -.SH NAME
61.25 +.SH "Name"
61.26 jconsole \- Java Monitoring and Management Console
61.27 .LP
61.28 .SH "SYNOPSIS"
61.29 @@ -55,11 +52,23 @@
61.30 .TP 3
61.31 connection = pid | host:port | jmxUrl
61.32 .RS 3
61.33 -\f2pid\fP\ \ \ Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See JMX Monitoring and Management for details.
61.34 +\f2pid\fP\ \ \ Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See
61.35 +.na
61.36 +\f2JMX Monitoring and Management\fP @
61.37 +.fi
61.38 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
61.39 .br
61.40 -\f2host\fP:\f2port\fP\ \ Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See JMX Monitoring and Management for details.
61.41 +\f2host\fP:\f2port\fP\ \ Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See
61.42 +.na
61.43 +\f2JMX Monitoring and Management\fP @
61.44 +.fi
61.45 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
61.46 .br
61.47 -\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in JMXServiceURL.
61.48 +\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in
61.49 +.na
61.50 +\f2JMXServiceURL\fP @
61.51 +.fi
61.52 +http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html.
61.53 .RE
61.54 .RE
61.55
61.56 @@ -97,7 +106,11 @@
61.57 \fP
61.58 .fi
61.59 .LP
61.60 -containing one line for each plugin specifying the fully qualified class name of the class implementing the com.sun.tools.jconsole.JConsolePlugin class.
61.61 +containing one line for each plugin specifying the fully qualified class name of the class implementing the
61.62 +.na
61.63 +\f2com.sun.tools.jconsole.JConsolePlugin\fP @
61.64 +.fi
61.65 +http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
61.66 .TP 3
61.67 \-version\
61.68 Output version information and exit.
61.69 @@ -115,10 +128,16 @@
61.70 .RS 3
61.71 .TP 2
61.72 o
61.73 -Using JConsole
61.74 +.na
61.75 +\f2Using JConsole\fP @
61.76 +.fi
61.77 +http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
61.78 .TP 2
61.79 o
61.80 -Monitoring and Management for Java Platform
61.81 +.na
61.82 +\f2Monitoring and Management for Java Platform\fP @
61.83 +.fi
61.84 +http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
61.85 .RE
61.86
61.87 .LP
62.1 --- a/src/linux/doc/man/jdb.1 Tue May 12 15:21:55 2009 +0900
62.2 +++ b/src/linux/doc/man/jdb.1 Thu May 14 00:17:25 2009 -0700
62.3 @@ -1,6 +1,4 @@
62.4 -.'" t
62.5 -."
62.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
62.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
62.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
62.9 ."
62.10 ." This code is free software; you can redistribute it and/or modify it
62.11 @@ -20,20 +18,21 @@
62.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
62.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
62.14 ." have any questions.
62.15 -."
62.16 -." `
62.17 -.TH jdb 1 "05 Aug 2006"
62.18 -." Generated by html2roff
62.19 +."
62.20 +.TH jdb 1 "04 May 2009"
62.21 +." Generated from HTML by html2man (author: Eric Armstrong)
62.22
62.23 .LP
62.24 -.SH NAME
62.25 +.SH "Name"
62.26 jdb \- The Java Debugger
62.27 .LP
62.28 +.RS 3
62.29
62.30 .LP
62.31 .LP
62.32 \f3jdb\fP helps you find and fix bugs in Java language programs.
62.33 .LP
62.34 +.RE
62.35 .SH "SYNOPSIS"
62.36 .LP
62.37
62.38 @@ -49,6 +48,7 @@
62.39 .RS 3
62.40
62.41 .LP
62.42 +.RS 3
62.43 .TP 3
62.44 options
62.45 Command\-line options, as specified below.
62.46 @@ -58,6 +58,8 @@
62.47 .TP 3
62.48 arguments
62.49 Arguments passed to the \f2main()\fP method of \f2class\fP.
62.50 +.RE
62.51 +
62.52 .LP
62.53 .RE
62.54 .SH "DESCRIPTION"
62.55 @@ -74,6 +76,7 @@
62.56 .SS
62.57 Starting a jdb Session
62.58 .LP
62.59 +.RS 3
62.60
62.61 .LP
62.62 .LP
62.63 @@ -135,11 +138,11 @@
62.64 .na
62.65 \f2documentation\fP @
62.66 .fi
62.67 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see
62.68 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see the
62.69 .na
62.70 \f21.4.2 documentation\fP @
62.71 .fi
62.72 -http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
62.73 +http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.html
62.74 .LP
62.75 .SS
62.76 Basic jdb Commands
62.77 @@ -150,6 +153,7 @@
62.78 .RS 3
62.79
62.80 .LP
62.81 +.RS 3
62.82 .TP 3
62.83 help, or ?
62.84 The most important \f3jdb\fP command, \f2help\fP displays the list of recognized commands with a brief description.
62.85 @@ -163,24 +167,24 @@
62.86 print
62.87 Displays Java objects and primitive values. For variables or fields of primitive types, the actual value is printed. For objects, a short description is printed. See the \f2dump\fP command below for getting more information about an object.
62.88 .LP
62.89 -\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac\fP\f2 \fP\f2\-g\fP option.
62.90 +\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP option.
62.91 .LP
62.92 \f2print\fP supports many simple Java expressions including those with method invocations, for example:
62.93 .RS 3
62.94 .TP 2
62.95 -*
62.96 +o
62.97 \f2print MyClass.myStaticField\fP
62.98 .TP 2
62.99 -*
62.100 +o
62.101 \f2print myObj.myInstanceField\fP
62.102 .TP 2
62.103 -*
62.104 +o
62.105 \f2print i + j + k\fP \f2(i, j, k are primities and either fields or local variables)\fP
62.106 .TP 2
62.107 -*
62.108 +o
62.109 \f2print myObj.myMethod()\fP \f2(if myMethod returns a non\-null)\fP
62.110 .TP 2
62.111 -*
62.112 +o
62.113 \f2print new java.lang.String("Hello").length()\fP
62.114 .RE
62.115 .TP 3
62.116 @@ -211,11 +215,14 @@
62.117 \f2where\fP with no arguments dumps the stack of the current thread. \f2where all\fP dumps the stack of all threads in the current thread group. \f2where\fP \f2threadindex\fP dumps the stack of the specified thread.
62.118 .LP
62.119 If the current thread is suspended (either through an event such as a breakpoint or through the \f2suspend\fP command), local variables and fields can be displayed with the \f2print\fP and \f2dump\fP commands. The \f2up\fP and \f2down\fP commands select which stack frame is current.
62.120 +.RE
62.121 +
62.122 .LP
62.123 .RE
62.124 .SS
62.125 Breakpoints
62.126 .LP
62.127 +.RS 3
62.128
62.129 .LP
62.130 .LP
62.131 @@ -223,16 +230,16 @@
62.132 .LP
62.133 .RS 3
62.134 .TP 2
62.135 -*
62.136 +o
62.137 \f2stop at MyClass:22\fP \f2(sets a breakpoint at the first instruction for line 22 of the source file containing MyClass)\fP
62.138 .TP 2
62.139 -*
62.140 +o
62.141 \f2stop in java.lang.String.length\fP \f2(sets a breakpoint at the beginnig of the method \fP\f2java.lang.String.length\fP)
62.142 .TP 2
62.143 -*
62.144 +o
62.145 \f2stop in MyClass.<init>\fP \f2(<init> identifies the MyClass constructor)\fP
62.146 .TP 2
62.147 -*
62.148 +o
62.149 \f2stop in MyClass.<clinit>\fP \f2(<clinit> identifies the static initialization code for MyClass)\fP
62.150 .RE
62.151
62.152 @@ -243,17 +250,21 @@
62.153 .LP
62.154 The \f2clear\fP command removes breakpoints using a syntax as in "\f2clear\ MyClass:45\fP". Using the \f2clear\fP or command with no argument displays a list of all breakpoints currently set. The \f2cont\fP command continues execution.
62.155 .LP
62.156 +.RE
62.157 .SS
62.158 Stepping
62.159 .LP
62.160 +.RS 3
62.161
62.162 .LP
62.163 .LP
62.164 The \f2step\fP commands advances execution to the next line whether it is in the current stack frame or a called method. The \f2next\fP command advances execution to the next line in the current stack frame.
62.165 .LP
62.166 +.RE
62.167 .SS
62.168 Exceptions
62.169 .LP
62.170 +.RS 3
62.171
62.172 .LP
62.173 .LP
62.174 @@ -268,6 +279,8 @@
62.175 .LP
62.176 \f2NOTE: The \fP\f2ignore\fP command does not cause the debugged VM to ignore specific exceptions, only the debugger.
62.177 .LP
62.178 +.RE
62.179 +.RE
62.180 .SH "Command Line Options"
62.181 .LP
62.182
62.183 @@ -278,6 +291,7 @@
62.184 .LP
62.185 The following additional options are accepted by \f3jdb\fP:
62.186 .LP
62.187 +.RS 3
62.188 .TP 3
62.189 \-help
62.190 Displays a help message.
62.191 @@ -300,8 +314,7 @@
62.192 \-listconnectors
62.193 List the connectors available in this VM
62.194 .TP 3
62.195 -\-connect
62.196 -<connector\-name>:<name1>=<value1>,...
62.197 +\-connect <connector\-name>:<name1>=<value1>,...
62.198 Connects to target VM using named connector with listed argument values.
62.199 .TP 3
62.200 \-dbgtrace [flags]
62.201 @@ -315,6 +328,8 @@
62.202 .TP 3
62.203 \-Joption
62.204 Pass \f2option\fP to the Java virtual machine used to run jdb. (Options for the application Java virtual machine are passed to the \f3run\fP command.) For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
62.205 +.RE
62.206 +
62.207 .LP
62.208 .LP
62.209 Other options are supported for alternate mechanisms for connecting the debugger and the VM it is to debug. The Java Platform Debugger Architecture has additional
62.210 @@ -326,6 +341,7 @@
62.211 .SS
62.212 Options Forwarded to Debuggee Process
62.213 .LP
62.214 +.RS 3
62.215 .TP 3
62.216 \-v \-verbose[:class|gc|jni]
62.217 Turns on verbose mode.
62.218 @@ -333,19 +349,20 @@
62.219 \-D<name>=<value>
62.220 Sets a system property.
62.221 .TP 3
62.222 -\-classpath <directories separated by
62.223 -":">
62.224 +\-classpath <directories separated by ":">
62.225 Lists directories in which to look for classes.
62.226 .TP 3
62.227 \-X<option>
62.228 Non\-standard target VM option
62.229 +.RE
62.230 +
62.231 .LP
62.232 .SH "SEE ALSO"
62.233 .LP
62.234
62.235 .LP
62.236 .LP
62.237 -javac, java, javah, javap, javadoc.
62.238 +javac(1), java(1), javah(1), javap(1), javadoc(1).
62.239 .LP
62.240
62.241 .LP
63.1 --- a/src/linux/doc/man/jhat.1 Tue May 12 15:21:55 2009 +0900
63.2 +++ b/src/linux/doc/man/jhat.1 Thu May 14 00:17:25 2009 -0700
63.3 @@ -1,5 +1,3 @@
63.4 -.'" t
63.5 -."
63.6 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
63.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
63.8 ."
63.9 @@ -21,12 +19,11 @@
63.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
63.11 ." have any questions.
63.12 ."
63.13 -." `
63.14 -.TH jhat 1 "05 Aug 2006"
63.15 -." Generated by html2roff
63.16 +.TH jhat 1 "04 May 2009"
63.17 +." Generated from HTML by html2man (author: Eric Armstrong)
63.18
63.19 .LP
63.20 -.SH NAME
63.21 +.SH "Name"
63.22 jhat \- Java Heap Analysis Tool
63.23 .LP
63.24 .SH "SYNOPSIS"
63.25 @@ -47,16 +44,15 @@
63.26 .LP
63.27
63.28 .LP
63.29 +.RS 3
63.30 .TP 3
63.31 options
63.32 Options, if used, should follow immediately after the command name.
63.33 +.br
63.34 .TP 3
63.35 heap\-dump\-file
63.36 Java binary heap dump file to be browsed. For a dump file that contains multiple heap dumps, you may specify which dump in the file by appending "#<number> to the file name, i.e. "foo.hprof#3".
63.37 -.LP
63.38 -.SH "DESCRIPTION"
63.39 -.LP
63.40 -
63.41 +.SH "DESCRIPTION"
63.42 .LP
63.43 .LP
63.44 The \f3jhat\fP command parses a java heap dump file and launches a webserver. jhat enables you to browse heap dumps using your favorite webbrowser. jhat supports pre\-designed queries (such as 'show all instances of a known class "Foo"') as well as \f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) \- a SQL\-like query language to query heap dumps. Help on OQL is available from the OQL help page shown by jhat. With the default port, OQL help is available at http://localhost:7000/oqlhelp/
63.45 @@ -66,20 +62,20 @@
63.46 .LP
63.47 .RS 3
63.48 .TP 2
63.49 -*
63.50 -Use jmap \-dump option to obtain a heap dump at runtime;
63.51 +o
63.52 +Use jmap(1) \-dump option to obtain a heap dump at runtime;
63.53 .TP 2
63.54 -*
63.55 -Use jconsole option to obtain a heap dump via
63.56 +o
63.57 +Use jconsole(1) option to obtain a heap dump via
63.58 .na
63.59 \f2HotSpotDiagnosticMXBean\fP @
63.60 .fi
63.61 -http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html at runtime;
63.62 +http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html at runtime;
63.63 .TP 2
63.64 -*
63.65 +o
63.66 Heap dump will be generated when OutOfMemoryError is thrown by specifying \-XX:+HeapDumpOnOutOfMemoryError VM option;
63.67 .TP 2
63.68 -*
63.69 +o
63.70 Use
63.71 .na
63.72 \f2hprof\fP @
63.73 @@ -91,10 +87,8 @@
63.74 .LP
63.75 \f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
63.76 .LP
63.77 -.SH "OPTIONS"
63.78 -.LP
63.79 -
63.80 -.LP
63.81 +.SH "OPTIONS"
63.82 +.RS 3
63.83 .TP 3
63.84 \-stack false/true
63.85 Turn off tracking object allocation call stack. Note that if allocation site information is not available in the heap dump, you have to set this flag to false. Default is true.
63.86 @@ -125,25 +119,23 @@
63.87 .TP 3
63.88 \-J<flag>\
63.89 Pass <flag> to the Java virtual machine on which jhat is run. For example, \-J\-Xmx512m to use a maximum heap size of 512MB.
63.90 +.RE
63.91 +
63.92 .LP
63.93 -.SH "SEE ALSO"
63.94 -.LP
63.95 +.SH "SEE ALSO"
63.96 .RS 3
63.97 .TP 2
63.98 -*
63.99 -jmap \- Java Memory Map
63.100 +o
63.101 +jmap(1)
63.102 .TP 2
63.103 -*
63.104 -jconsole \- Java Monitoring and Management Console
63.105 +o
63.106 +jconsole(1)
63.107 .TP 2
63.108 -*
63.109 +o
63.110 .na
63.111 \f2hprof \- Heap and CPU profiling tool\fP @
63.112 .fi
63.113 http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
63.114 .RE
63.115 -
63.116 -.LP
63.117 -
63.118 -.LP
63.119 +.RE
63.120
64.1 --- a/src/linux/doc/man/jinfo.1 Tue May 12 15:21:55 2009 +0900
64.2 +++ b/src/linux/doc/man/jinfo.1 Thu May 14 00:17:25 2009 -0700
64.3 @@ -1,6 +1,4 @@
64.4 -.'" t
64.5 -."
64.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
64.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
64.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
64.9 ."
64.10 ." This code is free software; you can redistribute it and/or modify it
64.11 @@ -21,12 +19,11 @@
64.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
64.13 ." have any questions.
64.14 ."
64.15 -." `
64.16 -.TH jinfo 1 "05 Aug 2006"
64.17 -." Generated by html2roff
64.18 +.TH jinfo 1 "04 May 2009"
64.19 +." Generated from HTML by html2man (author: Eric Armstrong)
64.20
64.21 .LP
64.22 -.SH NAME
64.23 +.SH "Name"
64.24 jinfo \- Configuration Info
64.25 .LP
64.26 .SH "SYNOPSIS"
64.27 @@ -49,24 +46,37 @@
64.28 .LP
64.29
64.30 .LP
64.31 +.RS 3
64.32 .TP 3
64.33 option
64.34 Options are mutually exclusive. Option, if used, should follow immediately after the command name.
64.35 +.RS 3
64.36 .TP 3
64.37 pid
64.38 -process id for which the configuration info is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
64.39 +process id for which the configuration info is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
64.40 +.RE
64.41 +.RS 3
64.42 .TP 3
64.43 executable
64.44 -Java executable from which the core dump was produced.
64.45 +Java executable from which the core dump was produced.
64.46 +.RE
64.47 +.RS 3
64.48 .TP 3
64.49 core
64.50 -core file for which the configuration info is to be printed.
64.51 +core file for which the configuration info is to be printed.
64.52 +.RE
64.53 +.RS 3
64.54 .TP 3
64.55 remote\-hostname\-or\-IP
64.56 -remote debug server's (see jsadebugd) hostname or IP address.
64.57 +remote debug server's (see jsadebugd(1)) hostname or IP address.
64.58 +.RE
64.59 +.RS 3
64.60 .TP 3
64.61 server\-id
64.62 -optional unique id, if multiple debug servers are running on the same remote host.
64.63 +optional unique id, if multiple debug servers are running on the same remote host.
64.64 +.RE
64.65 +.RE
64.66 +
64.67 .LP
64.68 .SH "DESCRIPTION"
64.69 .LP
64.70 @@ -83,12 +93,16 @@
64.71 jinfo \-J\-d64 \-sysprops pid
64.72 .RE
64.73 .LP
64.74 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. On Windows, jinfo only supports the \-flag option of a running process.\fP
64.75 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' need to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
64.76 +.LP
64.77 +.LP
64.78 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
64.79 .LP
64.80 .SH "OPTIONS"
64.81 .LP
64.82
64.83 .LP
64.84 +.RS 3
64.85 .TP 3
64.86 <no option>
64.87 prints both command line flags as well as System properties name, value pairs.
64.88 @@ -119,16 +133,18 @@
64.89 .TP 3
64.90 \-help
64.91 prints a help message
64.92 +.RE
64.93 +
64.94 .LP
64.95 .SH "SEE ALSO"
64.96 .LP
64.97 .RS 3
64.98 .TP 2
64.99 -*
64.100 -jps
64.101 +o
64.102 +jps(1)
64.103 .TP 2
64.104 -*
64.105 -jsadebugd
64.106 +o
64.107 +jsadebugd(1)
64.108 .RE
64.109
64.110 .LP
65.1 --- a/src/linux/doc/man/jmap.1 Tue May 12 15:21:55 2009 +0900
65.2 +++ b/src/linux/doc/man/jmap.1 Thu May 14 00:17:25 2009 -0700
65.3 @@ -1,6 +1,4 @@
65.4 -.'" t
65.5 -."
65.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
65.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
65.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
65.9 ."
65.10 ." This code is free software; you can redistribute it and/or modify it
65.11 @@ -21,12 +19,11 @@
65.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
65.13 ." have any questions.
65.14 ."
65.15 -." `
65.16 -.TH jmap 1 "05 Aug 2006"
65.17 -." Generated by html2roff
65.18 +.TH jmap 1 "04 May 2009"
65.19 +." Generated from HTML by html2man (author: Eric Armstrong)
65.20
65.21 .LP
65.22 -.SH NAME
65.23 +.SH "Name"
65.24 jmap \- Memory Map
65.25 .LP
65.26 .SH "SYNOPSIS"
65.27 @@ -49,25 +46,31 @@
65.28 .LP
65.29
65.30 .LP
65.31 +.RS 3
65.32 .TP 3
65.33 option
65.34 Options are mutually exclusive. Option, if used, should follow immediately after the command name.
65.35 .TP 3
65.36 pid
65.37 -process id for which the memory map is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
65.38 +process id for which the memory map is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
65.39 +.br
65.40 .TP 3
65.41 executable
65.42 Java executable from which the core dump was produced.
65.43 +.br
65.44 .TP 3
65.45 core
65.46 core file for which the memory map is to be printed.
65.47 +.br
65.48 .TP 3
65.49 remote\-hostname\-or\-IP
65.50 -remote debug server's (see jsadebugd) hostname or IP address.
65.51 +remote debug server's (see jsadebugd(1)) hostname or IP address.
65.52 +.br
65.53 .TP 3
65.54 server\-id
65.55 optional unique id, if multiple debug servers are running on the same remote host.
65.56 .br
65.57 +.RE
65.58
65.59 .LP
65.60 .SH "DESCRIPTION"
65.61 @@ -90,76 +93,78 @@
65.62 .RE
65.63
65.64 .LP
65.65 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK.\fP
65.66 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
65.67 +.LP
65.68 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
65.69 +.LP
65.70 .br
65.71
65.72 .LP
65.73 -The only forms of jmap available on the Windows platform are
65.74 -.RS 3
65.75 -
65.76 -.LP
65.77 -jmap \-dump:<\f2dump\-options\fP> pid
65.78 -.RE
65.79 -and
65.80 -.RS 3
65.81 -
65.82 -.LP
65.83 -jmap \-histo[:live] pid
65.84 -.RE
65.85 .SH "OPTIONS"
65.86 .LP
65.87
65.88 .LP
65.89 +.RS 3
65.90 .TP 3
65.91 -<no
65.92 -option>
65.93 -When no option is used jmap prints shared object mappings. For each shared object loaded in the target VM, start address, the size of the mapping, and the full path of the shared object file are printed. This is similar to the Solaris \f3pmap\fP utility.
65.94 +<no option>
65.95 +When no option is used \f3jmap\fP prints shared object mappings. For each shared object loaded in the target VM, start address, the size of the mapping, and the full path of the shared object file are printed. This is similar to the Solaris \f3pmap\fP utility.
65.96 +.br
65.97 .TP 3
65.98 \-dump:[live,]format=b,file=<filename>
65.99 -Dumps the Java heap in hprof binary format to filename. The \f2live\fP suboption is optional. If specified, only the live objects in the heap are dumped. To browse the heap dump, you can use jhat (Java Heap Analysis Tool) to read the generated file.
65.100 +Dumps the Java heap in hprof binary format to filename. The \f2live\fP suboption is optional. If specified, only the live objects in the heap are dumped. To browse the heap dump, you can use jhat(1) (Java Heap Analysis Tool) to read the generated file.
65.101 +.br
65.102 .TP 3
65.103 \-finalizerinfo
65.104 Prints information on objects awaiting finalization.
65.105 +.br
65.106 .TP 3
65.107 \-heap
65.108 Prints a heap summary. GC algorithm used, heap configuration and generation wise heap usage are printed.
65.109 +.br
65.110 .TP 3
65.111 \-histo[:live]
65.112 Prints a histogram of the heap. For each Java class, number of objects, memory size in bytes, and fully qualified class names are printed. VM internal class names are printed with '*' prefix. If the \f2live\fP suboption is specified, only live objects are counted.
65.113 +.br
65.114 .TP 3
65.115 \-permstat
65.116 Prints class loader wise statistics of permanent generation of Java heap. For each class loader, its name, liveness, address, parent class loader, and the number and size of classes it has loaded are printed. In addition, the number and size of interned Strings are printed.
65.117 +.br
65.118 .TP 3
65.119 \-F
65.120 Force. Use with jmap \-dump or jmap \-histo option if the pid does not respond. The \f2live\fP suboption is not supported in this mode.
65.121 +.br
65.122 .TP 3
65.123 \-h
65.124 Prints a help message.
65.125 .br
65.126 +.br
65.127 .TP 3
65.128 \-help
65.129 Prints a help message.
65.130 .br
65.131 +.br
65.132 .TP 3
65.133 \-J<flag>
65.134 Passes <flag> to the Java virtual machine on which jmap is run.
65.135 +.br
65.136 +.RE
65.137
65.138 .LP
65.139 .SH "SEE ALSO"
65.140 .LP
65.141 .RS 3
65.142 .TP 2
65.143 -*
65.144 -pmap (1)
65.145 +o
65.146 +pmap(1)
65.147 .TP 2
65.148 -*
65.149 -jhat
65.150 +o
65.151 +jhat(1)
65.152 .TP 2
65.153 -*
65.154 -jps
65.155 +o
65.156 +jps(1)
65.157 .TP 2
65.158 -*
65.159 -jsadebugd
65.160 +o
65.161 +jsadebugd(1)
65.162 .RE
65.163
65.164 .LP
66.1 --- a/src/linux/doc/man/jps.1 Tue May 12 15:21:55 2009 +0900
66.2 +++ b/src/linux/doc/man/jps.1 Thu May 14 00:17:25 2009 -0700
66.3 @@ -1,6 +1,4 @@
66.4 -.'" t
66.5 -."
66.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
66.7 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
66.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
66.9 ."
66.10 ." This code is free software; you can redistribute it and/or modify it
66.11 @@ -21,12 +19,11 @@
66.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
66.13 ." have any questions.
66.14 ."
66.15 -." `
66.16 -.TH jps 1 "06 Aug 2006"
66.17 -." Generated by html2man
66.18 +.TH jps 1 "04 May 2009"
66.19 +." Generated from HTML by html2man (author: Eric Armstrong)
66.20
66.21 .LP
66.22 -.SH NAME
66.23 +.SH "Name"
66.24 jps \- Java Virtual Machine Process Status Tool
66.25 .LP
66.26 .SH "SYNOPSIS"
66.27 @@ -47,12 +44,15 @@
66.28 .LP
66.29
66.30 .LP
66.31 +.RS 3
66.32 .TP 3
66.33 options
66.34 Command\-line options.
66.35 .TP 3
66.36 hostid
66.37 The host identifier of the host for which the process report should be generated. The \f2hostid\fP may include optional components that indicate the communications protocol, port number, and other implementation specific data.
66.38 +.RE
66.39 +
66.40 .LP
66.41 .SH "DESCRIPTION"
66.42 .LP
66.43 @@ -83,6 +83,7 @@
66.44 .LP
66.45 The \f3jps\fP command supports a number of options that modify the output of the command. These options are subject to change or removal in the future.
66.46 .LP
66.47 +.RS 3
66.48 .TP 3
66.49 \-q
66.50 Suppress the output of the class name, JAR file name, and arguments passed to the \f2main\fP method, producing only a list of local VM identifiers.
66.51 @@ -101,6 +102,8 @@
66.52 .TP 3
66.53 \-Joption
66.54 Pass \f2option\fP to the \f3java\fP launcher called by \f3jps\fP. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying VM executing applications written in Java.
66.55 +.RE
66.56 +
66.57 .LP
66.58 .SS
66.59 HOST IDENTIFIER
66.60 @@ -122,6 +125,7 @@
66.61 .fi
66.62
66.63 .LP
66.64 +.RS 3
66.65 .TP 3
66.66 protocol
66.67 The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific, optimized, local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
66.68 @@ -133,7 +137,9 @@
66.69 The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
66.70 .TP 3
66.71 servername
66.72 -The treatment of this parameter depends on the implementation. For the optimized, local protocol, this field is ignored. For the \f3rmi\fP protocol, this parameter is a string representing the name of the RMI remote object on the remote host. See the \f3\-n\fP option for the \f3jstatd\fP command.
66.73 +The treatment of this parameter depends on the implementation. For the optimized, local protocol, this field is ignored. For the \f3rmi\fP protocol, this parameter is a string representing the name of the RMI remote object on the remote host. See the \f3\-n\fP option for the jstatd(1) command.
66.74 +.RE
66.75 +
66.76 .LP
66.77 .RE
66.78 .SH "OUTPUT FORMAT"
66.79 @@ -207,7 +213,7 @@
66.80 .br
66.81
66.82 .fl
66.83 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
66.84 +3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
66.85 .br
66.86
66.87 .fl
66.88 @@ -231,7 +237,7 @@
66.89 .br
66.90
66.91 .fl
66.92 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
66.93 +3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
66.94 .br
66.95
66.96 .fl
66.97 @@ -245,16 +251,16 @@
66.98 .RS 3
66.99 .TP 2
66.100 o
66.101 -java \- the Java Application Launcher
66.102 +java(1) \- the Java Application Launcher
66.103 .TP 2
66.104 o
66.105 -jstat \- the Java virtual machine Statistics Monitoring Tool
66.106 +jstat(1) \- the Java virtual machine Statistics Monitoring Tool
66.107 .TP 2
66.108 o
66.109 -jstatd \- the jstat daemon
66.110 +jstatd(1) \- the jstat daemon
66.111 .TP 2
66.112 o
66.113 -rmiregistry \- the Java Remote Object Registry
66.114 +rmiregistry(1) \- the Java Remote Object Registry
66.115 .RE
66.116
66.117 .LP
67.1 --- a/src/linux/doc/man/jrunscript.1 Tue May 12 15:21:55 2009 +0900
67.2 +++ b/src/linux/doc/man/jrunscript.1 Thu May 14 00:17:25 2009 -0700
67.3 @@ -1,5 +1,3 @@
67.4 -.'" t
67.5 -."
67.6 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
67.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
67.8 ."
67.9 @@ -20,13 +18,12 @@
67.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
67.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
67.12 ." have any questions.
67.13 -."
67.14 -." `
67.15 -.TH jrunscript 1 "06 Aug 2006"
67.16 -." Generated by html2man
67.17 +."
67.18 +.TH jrunscript 1 "04 May 2009"
67.19 +." Generated from HTML by html2man (author: Eric Armstrong)
67.20
67.21 .LP
67.22 -.SH NAME
67.23 +.SH "Name"
67.24 jrunscript \- command line script shell
67.25 .LP
67.26 .SH "SYNOPSIS"
67.27 @@ -45,12 +42,15 @@
67.28 .LP
67.29
67.30 .LP
67.31 +.RS 3
67.32 .TP 3
67.33 options
67.34 Options, if used, should follow immediately after the command name.
67.35 .TP 3
67.36 arguments
67.37 Arguments, if used, should follow immediately after options or command name.
67.38 +.RE
67.39 +
67.40 .LP
67.41 .SH "DESCRIPTION"
67.42 .LP
67.43 @@ -66,6 +66,7 @@
67.44 .LP
67.45
67.46 .LP
67.47 +.RS 3
67.48 .TP 3
67.49 \-classpath path
67.50 Specify where to find the user's .class files that are accessed by the script.
67.51 @@ -102,6 +103,8 @@
67.52 .TP 3
67.53 \-q\
67.54 List all script engines available and exit.
67.55 +.RE
67.56 +
67.57 .LP
67.58 .SH "ARGUMENTS"
67.59 .LP
68.1 --- a/src/linux/doc/man/jsadebugd.1 Tue May 12 15:21:55 2009 +0900
68.2 +++ b/src/linux/doc/man/jsadebugd.1 Thu May 14 00:17:25 2009 -0700
68.3 @@ -1,6 +1,4 @@
68.4 -.'" t
68.5 -."
68.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
68.7 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
68.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
68.9 ."
68.10 ." This code is free software; you can redistribute it and/or modify it
68.11 @@ -21,12 +19,11 @@
68.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
68.13 ." have any questions.
68.14 ."
68.15 -." `
68.16 -.TH jsadebugd 1 "05 Aug 2006"
68.17 -." Generated by html2roff
68.18 +.TH jsadebugd 1 "04 May 2009"
68.19 +." Generated from HTML by html2man (author: Eric Armstrong)
68.20
68.21 .LP
68.22 -.SH NAME
68.23 +.SH "Name"
68.24 jsadebugd \- Serviceability Agent Debug Daemon
68.25 .LP
68.26 .SH "SYNOPSIS"
68.27 @@ -47,30 +44,49 @@
68.28 .LP
68.29
68.30 .LP
68.31 +.RS 3
68.32 .TP 3
68.33 pid
68.34 -process id of the process to which the debug server should attach. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used. At most one instance of the debug server may be attached to a single process.
68.35 +process id of the process to which the debug server should attach. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used. At most one instance of the debug server may be attached to a single process.
68.36 +.RE
68.37 +
68.38 .LP
68.39 +.RS 3
68.40 .TP 3
68.41 executable
68.42 +.RE
68.43 +
68.44 .LP
68.45 +.RS 3
68.46 .TP 3
68.47 Java executable from which the core dump was produced
68.48 +.RE
68.49 +
68.50 .LP
68.51 +.RS 3
68.52 .TP 3
68.53 core
68.54 Core file to which the debug server should attach.
68.55 +.RE
68.56 +
68.57 .LP
68.58 +.RS 3
68.59 .TP 3
68.60 server\-id
68.61 Optional unique id, needed if multiple debug servers are started on the same machine. This ID must be used by remote clients to identify the particular debug server to attach. Within a single machine, this ID must be unique.
68.62 +.RE
68.63 +
68.64 .LP
68.65 .SH "DESCRIPTION"
68.66 .LP
68.67
68.68 .LP
68.69 .LP
68.70 -\f3jsadebugd\fP attaches to a Java process or core file and acts as a debug server. Remote clients such as jstack, jmap, and jinfo can attach to the server using Java Remote Method Invocation (RMI). Before starting \f2jsadebugd\fP, rmiregistry must be started with:
68.71 +\f3jsadebugd\fP attaches to a Java process or core file and acts as a debug server. Remote clients such as jstack(1), jmap(1), and jinfo(1) can attach to the server using Java Remote Method Invocation (RMI). Before starting \f2jsadebugd\fP,
68.72 +.na
68.73 +\f2rmiregistry\fP @
68.74 +.fi
68.75 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi must be started with:
68.76 .LP
68.77 .RS 3
68.78
68.79 @@ -89,26 +105,32 @@
68.80 where \f2$JAVA_HOME\fP is the JDK installation directory. If rmiregistry was not started, jsadebugd will start an rmiregistry in a standard (1099) port internally. Debug server may be stopped by sending SIGINT (pressing Ctrl\-C) to it.
68.81 .LP
68.82 .LP
68.83 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. jsadebugd is not currently available on Windows platforms.\fP
68.84 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
68.85 +.LP
68.86 +.LP
68.87 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
68.88 .LP
68.89 .SH "SEE ALSO"
68.90 .LP
68.91 .RS 3
68.92 .TP 2
68.93 -*
68.94 -jinfo
68.95 +o
68.96 +jinfo(1)
68.97 .TP 2
68.98 -*
68.99 -jmap
68.100 +o
68.101 +jmap(1)
68.102 .TP 2
68.103 -*
68.104 -jps
68.105 +o
68.106 +jps(1)
68.107 .TP 2
68.108 -*
68.109 -jstack
68.110 +o
68.111 +jstack(1)
68.112 .TP 2
68.113 -*
68.114 -rmiregistry
68.115 +o
68.116 +.na
68.117 +\f2rmiregistry\fP @
68.118 +.fi
68.119 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
68.120 .RE
68.121
68.122 .LP
69.1 --- a/src/linux/doc/man/jstack.1 Tue May 12 15:21:55 2009 +0900
69.2 +++ b/src/linux/doc/man/jstack.1 Thu May 14 00:17:25 2009 -0700
69.3 @@ -1,6 +1,4 @@
69.4 -.'" t
69.5 -."
69.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
69.7 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
69.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
69.9 ."
69.10 ." This code is free software; you can redistribute it and/or modify it
69.11 @@ -21,12 +19,11 @@
69.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
69.13 ." have any questions.
69.14 ."
69.15 -." `
69.16 -.TH jstack 1 "07 Aug 2006"
69.17 -." Generated by html2man
69.18 +.TH jstack 1 "04 May 2009"
69.19 +." Generated from HTML by html2man (author: Eric Armstrong)
69.20
69.21 .LP
69.22 -.SH NAME
69.23 +.SH "Name"
69.24 jstack \- Stack Trace
69.25 .br
69.26
69.27 @@ -57,7 +54,7 @@
69.28 .RS 3
69.29 .TP 3
69.30 pid
69.31 -process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
69.32 +process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
69.33 .RE
69.34
69.35 .LP
69.36 @@ -72,7 +69,7 @@
69.37 .br
69.38 .TP 3
69.39 remote\-hostname\-or\-IP
69.40 -remote debug server's (see jsadebugd) hostname or IP address.
69.41 +remote debug server's (see jsadebugd(1)) hostname or IP address.
69.42 .br
69.43 .TP 3
69.44 server\-id
69.45 @@ -103,15 +100,10 @@
69.46
69.47 .LP
69.48 .LP
69.49 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. The only form of jstack that is available on Windows platforms is\fP
69.50 +\f3NOTE\fP \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \f2PATH\fP environment variable should contain the location of \f2jvm.dll\fP used by the target process or the location from which the Crash Dump file was produced.
69.51 .LP
69.52 -.nf
69.53 -\f3
69.54 -.fl
69.55 -\fP\f3 jstack pid \fP
69.56 -.fl
69.57 -.fi
69.58 -
69.59 +.LP
69.60 +For example, \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
69.61 .LP
69.62 .SH "OPTIONS"
69.63 .LP
69.64 @@ -120,7 +112,14 @@
69.65 .RS 3
69.66 .TP 3
69.67 \-F
69.68 -Forces a stack dump when 'jstack pid' does not respond.
69.69 +Force a stack dump when 'jstack [\-l] pid' does not respond.
69.70 +.TP 3
69.71 +\-l
69.72 +Long listing. Prints additional information about locks such as list of owned java.util.concurrent
69.73 +.na
69.74 +\f2ownable synchronizers\fP @
69.75 +.fi
69.76 +http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html.
69.77 .TP 3
69.78 \-m
69.79 prints mixed mode (both Java and native C/C++ frames) stack trace.
69.80 @@ -147,10 +146,10 @@
69.81 c++filt(1)
69.82 .TP 2
69.83 o
69.84 -jps
69.85 +jps(1)
69.86 .TP 2
69.87 o
69.88 -jsadebugd
69.89 +jsadebugd(1)
69.90 .RE
69.91
69.92 .LP
70.1 --- a/src/linux/doc/man/jstat.1 Tue May 12 15:21:55 2009 +0900
70.2 +++ b/src/linux/doc/man/jstat.1 Thu May 14 00:17:25 2009 -0700
70.3 @@ -1,6 +1,4 @@
70.4 -.'" t
70.5 -."
70.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
70.7 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
70.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
70.9 ."
70.10 ." This code is free software; you can redistribute it and/or modify it
70.11 @@ -21,25 +19,38 @@
70.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
70.13 ." have any questions.
70.14 ."
70.15 -." `
70.16 -.TH jstat 1 "06 Aug 2006"
70.17 -." Generated by html2man
70.18 -.SH NAME
70.19 +.TH jstat 1 "04 May 2009"
70.20 +." Generated from HTML by html2man (author: Eric Armstrong)
70.21 +
70.22 +.LP
70.23 +.SH "Name"
70.24 jstat \- Java Virtual Machine Statistics Monitoring Tool
70.25 +.LP
70.26 .SH "SYNOPSIS"
70.27 +.LP
70.28 +
70.29 +.LP
70.30 .nf
70.31 -\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP\f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
70.32 +\f3
70.33 +.fl
70.34 +\fP\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP \f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
70.35 .fl
70.36 .fi
70.37 +
70.38 +.LP
70.39 .SH "PARAMETERS"
70.40 +.LP
70.41 +
70.42 +.LP
70.43 +.RS 3
70.44 .TP 3
70.45 -generalOption
70.46 -A single general command\-line option (\-help, \-options, or \-version)
70.47 +generalOption
70.48 +A single general command\-line option (\-help, \-options, or \-version)
70.49 .TP 3
70.50 -outputOptions
70.51 -One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
70.52 +outputOptions
70.53 +One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
70.54 .TP 3
70.55 -vmid
70.56 +vmid
70.57 Virtual machine identifier, a string indicating the target Java virtual machine (JVM). The general syntax is
70.58 .nf
70.59 \f3
70.60 @@ -47,82 +58,124 @@
70.61 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
70.62 .fl
70.63 .fi
70.64 -The syntax of the vmid string largely corresponds to the syntax of a URI. The \f2vmid\fP can vary from a simple integer representing a local JVM to a more complex construction specifying a communications protocol, port number, and other implementation\-specific values. See Virtual Machine Identifier for details.
70.65 +The syntax of the vmid string largely corresponds to the syntax of a URI. The \f2vmid\fP can vary from a simple integer representing a local JVM to a more complex construction specifying a communications protocol, port number, and other implementation\-specific values. See Virtual Machine Identifier for details.
70.66 .TP 3
70.67 -interval[s|ms]
70.68 -Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds.\ Must be a positive integer.\ If specified, \f3jstat\fP will produce its output at each interval.
70.69 +interval[s|ms]
70.70 +Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds.\ Must be a positive integer.\ If specified, \f3jstat\fP will produce its output at each interval.
70.71 .TP 3
70.72 -count
70.73 -Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated.\ Must be a positive integer.
70.74 +count
70.75 +Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated.\ Must be a positive integer.
70.76 +.RE
70.77 +
70.78 +.LP
70.79 .SH "DESCRIPTION"
70.80 .LP
70.81 +
70.82 +.LP
70.83 +.LP
70.84 The \f3jstat\fP tool displays performance statistics for an instrumented HotSpot Java virtual machine (JVM). The target JVM is identified by its virtual machine identifier, or \f2vmid\fP option described below.
70.85 .LP
70.86 +.LP
70.87 \f3NOTE\fP: This utility is unsupported and may not be available in future versions of the JDK. It is not currently available on Windows 98 and Windows ME. platforms.
70.88 .br
70.89 +
70.90 +.LP
70.91 .SS
70.92 VIRTUAL MACHINE IDENTIFIER
70.93 .LP
70.94 +.RS 3
70.95 +
70.96 +.LP
70.97 +.LP
70.98 The syntax of the \f2vmid\fP string largely corresponds to the syntax of a URI:
70.99 +.LP
70.100 .nf
70.101 \f3
70.102 .fl
70.103 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP][:\f2port\fP][/\f2servername\fP]
70.104 .fl
70.105 .fi
70.106 +
70.107 +.LP
70.108 +.RS 3
70.109 .TP 3
70.110 -protocol
70.111 -The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific optimized local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
70.112 +protocol
70.113 +The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific optimized local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
70.114 .TP 3
70.115 -lvmid
70.116 -The local virtual machine identifier for the target JVM. The \f2lvmid\fP is a platform\-specific value that uniquely identifies a JVM on a system. The \f2lvmid\fP is the only required component of a virtual machine identifier. The \f2lvmid\fP is typically, but not necessarily, the operating system's process identifier for the target JVM process. You can use the \f3jps\fP command to determine the \f2lvmid\fP. Also, you can determine \f2lvmid\fP on Unix platforms with the \f3ps\fP command, and on Windows with the Windows Task Manager.
70.117 +lvmid
70.118 +The local virtual machine identifier for the target JVM. The \f2lvmid\fP is a platform\-specific value that uniquely identifies a JVM on a system. The \f2lvmid\fP is the only required component of a virtual machine identifier. The \f2lvmid\fP is typically, but not necessarily, the operating system's process identifier for the target JVM process. You can use the jps(1) command to determine the \f2lvmid\fP. Also, you can determine \f2lvmid\fP on Unix platforms with the \f3ps\fP command, and on Windows with the Windows Task Manager.
70.119 .TP 3
70.120 -hostname
70.121 -A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
70.122 +hostname
70.123 +A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
70.124 .TP 3
70.125 -port
70.126 -The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol, the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
70.127 +port
70.128 +The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol, the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
70.129 .TP 3
70.130 -servername
70.131 -The treatment of this parameter depends on implementation. For the optimized local protocol, this field is ignored. For the \f3rmi\fP protocol, it represents the name of the RMI remote object on the remote host.
70.132 +servername
70.133 +The treatment of this parameter depends on implementation. For the optimized local protocol, this field is ignored. For the \f3rmi\fP protocol, it represents the name of the RMI remote object on the remote host.
70.134 +.RE
70.135 +
70.136 +.LP
70.137 +.RE
70.138 .SH "OPTIONS"
70.139 .LP
70.140 +
70.141 +.LP
70.142 +.LP
70.143 The \f3jstat\fP command supports two types of options, general options and output options. General options cause \f3jstat\fP to display simple usage and version information. Output options determine the content and format of the statistical output.
70.144 .br
70.145 +
70.146 +.LP
70.147 .LP
70.148 \f3NOTE\fP: All options, and their functionality are subject to change or removal in future releases.
70.149 +.LP
70.150 .SS
70.151 -GENERAL
70.152 -OPTIONS
70.153 +GENERAL OPTIONS
70.154 +.LP
70.155 .LP
70.156 If you specify one of the general options, you cannot specify any other option or parameter.
70.157 +.LP
70.158 +.RS 3
70.159 .TP 3
70.160 -\-help
70.161 -Display help message.
70.162 +\-help
70.163 +Display help message.
70.164 .TP 3
70.165 -\-version
70.166 -Display version information.
70.167 +\-version
70.168 +Display version information.
70.169 .TP 3
70.170 -\-options
70.171 -Display list of statistics options. See the Output Options section below.
70.172 +\-options
70.173 +Display list of statistics options. See the Output Options section below.
70.174 +.RE
70.175 +
70.176 +.LP
70.177 .SS
70.178 -OUTPUT
70.179 -OPTIONS
70.180 +OUTPUT OPTIONS
70.181 +.LP
70.182 +.RS 3
70.183 +
70.184 +.LP
70.185 .LP
70.186 If you do not specify a general option, then you can specify output options. Output options determine the content and format of \f3jstat\fP's output, and consist of a single \f2statOption\fP, plus any of the other output options (\-h, \-t, and \-J).\ The \f2statOption\fP must come first.
70.187 .LP
70.188 +.LP
70.189 Output is formatted as a table, with columns are separated by spaces. A header row with titles describes the columns.\ Use the \f3\-h\fP option to set the frequency at which the header is displayed.\ Column header names are generally consistent between the different options. In general, if two options provide a column with the same name, then the data source for the two columns are the same.
70.190 .LP
70.191 +.LP
70.192 Use the \f3\-t\fP option to display a time stamp column, labeled \f2Timestamp\fP as the first column of output. The \f2Timestamp\fP column contains the elapsed time, in seconds, since startup of the target JVM. The resolution of the time stamp is dependent on various factors and is subject to variation due to delayed thread scheduling on heavily loaded systems.
70.193 .LP
70.194 +.LP
70.195 Use the \f2interval\fP and \f2count\fP parameters to determine how frequently and how many times, respectively, \f3jstat\fP displays its output.
70.196 .LP
70.197 +.LP
70.198 \f3NOTE\fP: You are advised not to write scripts to parse \f3jstat's\fP output since the format may change in future releases. If you choose to write scripts that parse \f3jstat\fP output, expect to modify them for future releases of this tool.
70.199 +.LP
70.200 +.RS 3
70.201 .TP 3
70.202 -\-statOption
70.203 +\-statOption
70.204 Determines the statistics information that \f3jstat\fP displays. The following table lists the available options.\ Use the \f3\-options\fP general option to display the list of options for a particular platform installation.
70.205 .br
70.206 .br
70.207 +.LP
70.208 .TS
70.209 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.210 .de 35
70.211 @@ -405,7 +458,7 @@
70.212 .nr 41 \n(80+(3*\n(38)
70.213 .nr 81 +\n(41
70.214 .nr TW \n(81
70.215 -.if t .if \n(TW>\n(.li .tm Table at line 158 file Input is too wide - \n(TW units
70.216 +.if t .if \n(TW>\n(.li .tm Table at line 231 file Input is too wide - \n(TW units
70.217 .fc
70.218 .nr #T 0-1
70.219 .nr #a 0-1
70.220 @@ -634,39 +687,33 @@
70.221 .TE
70.222 .if \n-(b.=0 .nr c. \n(.c-\n(d.-52
70.223 .TP 3
70.224 -\-hn
70.225 -Display a column header every \f2n\fP samples (output rows), where \f2n\fP is a positive integer. Default value is 0, which displays the column header above the first row of data.
70.226 +\-h n
70.227 +Display a column header every \f2n\fP samples (output rows), where \f2n\fP is a positive integer. Default value is 0, which displays the column header above the first row of data.
70.228 .TP 3
70.229 -\-tn
70.230 -Display a timestamp column as the first column of output. The timestamp is the the time since the start time of the target JVM.
70.231 +\-t n
70.232 +Display a timestamp column as the first column of output. The timestamp is the time since the start time of the target JVM.
70.233 .TP 3
70.234 -\-JjavaOption
70.235 -Pass \f2javaOption\fP to the \f3java\fP application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. For a complete list of options, see the following documents:
70.236 -.RS 3
70.237 -.TP 2
70.238 -*
70.239 -.na
70.240 -\f2java \- the Java application launcher (Solaris)\fP @
70.241 -.fi
70.242 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html
70.243 -.TP 2
70.244 -*
70.245 -.na
70.246 -\f2java \- the Java application launcher (Linux)\fP @
70.247 -.fi
70.248 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html
70.249 -.TP 2
70.250 -*
70.251 -java \- the Java application launcher (Windows)
70.252 +\-JjavaOption
70.253 +Pass \f2javaOption\fP to the \f3java\fP application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. For a complete list of options, see java(1)
70.254 +.RE
70.255 +
70.256 +.LP
70.257 .RE
70.258 .SS
70.259 -STATOPTIONS AND
70.260 -OUTPUT
70.261 +STATOPTIONS AND OUTPUT
70.262 +.LP
70.263 +.RS 3
70.264 +
70.265 +.LP
70.266 .LP
70.267 The following tables summarize the columns that \f3jstat\fP outputs for each \f2statOption\fP.
70.268 .br
70.269 +
70.270 +.LP
70.271 .SS
70.272 \-class Option
70.273 +.LP
70.274 +.LP
70.275 .TS
70.276 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.277 .de 35
70.278 @@ -779,7 +826,7 @@
70.279 .nr 41 \n(80+(3*\n(38)
70.280 .nr 81 +\n(41
70.281 .nr TW \n(81
70.282 -.if t .if \n(TW>\n(.li .tm Table at line 214 file Input is too wide - \n(TW units
70.283 +.if t .if \n(TW>\n(.li .tm Table at line 281 file Input is too wide - \n(TW units
70.284 .fc
70.285 .nr #T 0-1
70.286 .nr #a 0-1
70.287 @@ -866,9 +913,12 @@
70.288 .rm c+
70.289 .TE
70.290 .if \n-(b.=0 .nr c. \n(.c-\n(d.-21
70.291 +
70.292 +.LP
70.293 .SS
70.294 -\-compiler
70.295 -Option
70.296 +\-compiler Option
70.297 +.LP
70.298 +.LP
70.299 .TS
70.300 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.301 .de 35
70.302 @@ -1033,7 +1083,7 @@
70.303 .nr 41 \n(80+(3*\n(38)
70.304 .nr 81 +\n(41
70.305 .nr TW \n(81
70.306 -.if t .if \n(TW>\n(.li .tm Table at line 247 file Input is too wide - \n(TW units
70.307 +.if t .if \n(TW>\n(.li .tm Table at line 317 file Input is too wide - \n(TW units
70.308 .fc
70.309 .nr #T 0-1
70.310 .nr #a 0-1
70.311 @@ -1163,8 +1213,12 @@
70.312 .rm f+
70.313 .TE
70.314 .if \n-(b.=0 .nr c. \n(.c-\n(d.-29
70.315 +
70.316 +.LP
70.317 .SS
70.318 \-gc Option
70.319 +.LP
70.320 +.LP
70.321 .TS
70.322 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.323 .de 35
70.324 @@ -1493,7 +1547,7 @@
70.325 .nr 41 \n(80+(3*\n(38)
70.326 .nr 81 +\n(41
70.327 .nr TW \n(81
70.328 -.if t .if \n(TW>\n(.li .tm Table at line 313 file Input is too wide - \n(TW units
70.329 +.if t .if \n(TW>\n(.li .tm Table at line 387 file Input is too wide - \n(TW units
70.330 .fc
70.331 .nr #T 0-1
70.332 .nr #a 0-1
70.333 @@ -1763,8 +1817,12 @@
70.334 .rm n+
70.335 .TE
70.336 .if \n-(b.=0 .nr c. \n(.c-\n(d.-63
70.337 +
70.338 +.LP
70.339 .SS
70.340 \-gccapacity Option
70.341 +.LP
70.342 +.LP
70.343 .TS
70.344 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.345 .de 35
70.346 @@ -2113,7 +2171,7 @@
70.347 .nr 41 \n(80+(3*\n(38)
70.348 .nr 81 +\n(41
70.349 .nr TW \n(81
70.350 -.if t .if \n(TW>\n(.li .tm Table at line 383 file Input is too wide - \n(TW units
70.351 +.if t .if \n(TW>\n(.li .tm Table at line 461 file Input is too wide - \n(TW units
70.352 .fc
70.353 .nr #T 0-1
70.354 .nr #a 0-1
70.355 @@ -2400,11 +2458,15 @@
70.356 .rm o+
70.357 .TE
70.358 .if \n-(b.=0 .nr c. \n(.c-\n(d.-67
70.359 +
70.360 +.LP
70.361 .SS
70.362 -\-gccause
70.363 -Option
70.364 +\-gccause Option
70.365 +.LP
70.366 .LP
70.367 This option displays the same summary of garbage collection statistics as the \f3\-gcutil\fP option, but includes the causes of the last garbage collection event and (if applicable) the current garbage collection event. In addition to the columns listed for \f3\-gcutil\fP, this option adds the following columns:
70.368 +.LP
70.369 +.LP
70.370 .TS
70.371 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.372 .de 35
70.373 @@ -2489,7 +2551,7 @@
70.374 .nr 41 \n(80+(3*\n(38)
70.375 .nr 81 +\n(41
70.376 .nr TW \n(81
70.377 -.if t .if \n(TW>\n(.li .tm Table at line 402 file Input is too wide - \n(TW units
70.378 +.if t .if \n(TW>\n(.li .tm Table at line 484 file Input is too wide - \n(TW units
70.379 .fc
70.380 .nr #T 0-1
70.381 .nr #a 0-1
70.382 @@ -2551,8 +2613,12 @@
70.383 .rm b+
70.384 .TE
70.385 .if \n-(b.=0 .nr c. \n(.c-\n(d.-13
70.386 +
70.387 +.LP
70.388 .SS
70.389 \-gcnew Option
70.390 +.LP
70.391 +.LP
70.392 .TS
70.393 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.394 .de 35
70.395 @@ -2801,7 +2867,7 @@
70.396 .nr 41 \n(80+(3*\n(38)
70.397 .nr 81 +\n(41
70.398 .nr TW \n(81
70.399 -.if t .if \n(TW>\n(.li .tm Table at line 452 file Input is too wide - \n(TW units
70.400 +.if t .if \n(TW>\n(.li .tm Table at line 538 file Input is too wide - \n(TW units
70.401 .fc
70.402 .nr #T 0-1
70.403 .nr #a 0-1
70.404 @@ -3003,8 +3069,12 @@
70.405 .rm j+
70.406 .TE
70.407 .if \n-(b.=0 .nr c. \n(.c-\n(d.-47
70.408 +
70.409 +.LP
70.410 .SS
70.411 \-gcnewcapacity Option
70.412 +.LP
70.413 +.LP
70.414 .TS
70.415 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.416 .de 35
70.417 @@ -3252,7 +3322,7 @@
70.418 .nr 41 \n(80+(3*\n(38)
70.419 .nr 81 +\n(41
70.420 .nr TW \n(81
70.421 -.if t .if \n(TW>\n(.li .tm Table at line 504 file Input is too wide - \n(TW units
70.422 +.if t .if \n(TW>\n(.li .tm Table at line 594 file Input is too wide - \n(TW units
70.423 .fc
70.424 .nr #T 0-1
70.425 .nr #a 0-1
70.426 @@ -3454,8 +3524,12 @@
70.427 .rm j+
70.428 .TE
70.429 .if \n-(b.=0 .nr c. \n(.c-\n(d.-49
70.430 +
70.431 +.LP
70.432 .SS
70.433 \-gcold Option
70.434 +.LP
70.435 +.LP
70.436 .TS
70.437 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.438 .de 35
70.439 @@ -3644,7 +3718,7 @@
70.440 .nr 41 \n(80+(3*\n(38)
70.441 .nr 81 +\n(41
70.442 .nr TW \n(81
70.443 -.if t .if \n(TW>\n(.li .tm Table at line 542 file Input is too wide - \n(TW units
70.444 +.if t .if \n(TW>\n(.li .tm Table at line 636 file Input is too wide - \n(TW units
70.445 .fc
70.446 .nr #T 0-1
70.447 .nr #a 0-1
70.448 @@ -3795,8 +3869,12 @@
70.449 .rm g+
70.450 .TE
70.451 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
70.452 +
70.453 +.LP
70.454 .SS
70.455 \-gcoldcapacity Option
70.456 +.LP
70.457 +.LP
70.458 .TS
70.459 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.460 .de 35
70.461 @@ -3985,7 +4063,7 @@
70.462 .nr 41 \n(80+(3*\n(38)
70.463 .nr 81 +\n(41
70.464 .nr TW \n(81
70.465 -.if t .if \n(TW>\n(.li .tm Table at line 580 file Input is too wide - \n(TW units
70.466 +.if t .if \n(TW>\n(.li .tm Table at line 678 file Input is too wide - \n(TW units
70.467 .fc
70.468 .nr #T 0-1
70.469 .nr #a 0-1
70.470 @@ -4136,8 +4214,12 @@
70.471 .rm g+
70.472 .TE
70.473 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
70.474 +
70.475 +.LP
70.476 .SS
70.477 \-gcpermcapacity Option
70.478 +.LP
70.479 +.LP
70.480 .TS
70.481 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.482 .de 35
70.483 @@ -4326,7 +4408,7 @@
70.484 .nr 41 \n(80+(3*\n(38)
70.485 .nr 81 +\n(41
70.486 .nr TW \n(81
70.487 -.if t .if \n(TW>\n(.li .tm Table at line 618 file Input is too wide - \n(TW units
70.488 +.if t .if \n(TW>\n(.li .tm Table at line 720 file Input is too wide - \n(TW units
70.489 .fc
70.490 .nr #T 0-1
70.491 .nr #a 0-1
70.492 @@ -4477,9 +4559,12 @@
70.493 .rm g+
70.494 .TE
70.495 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
70.496 +
70.497 +.LP
70.498 .SS
70.499 -\-gcutil
70.500 -Option
70.501 +\-gcutil Option
70.502 +.LP
70.503 +.LP
70.504 .TS
70.505 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.506 .de 35
70.507 @@ -4708,7 +4793,7 @@
70.508 .nr 41 \n(80+(3*\n(38)
70.509 .nr 81 +\n(41
70.510 .nr TW \n(81
70.511 -.if t .if \n(TW>\n(.li .tm Table at line 665 file Input is too wide - \n(TW units
70.512 +.if t .if \n(TW>\n(.li .tm Table at line 770 file Input is too wide - \n(TW units
70.513 .fc
70.514 .nr #T 0-1
70.515 .nr #a 0-1
70.516 @@ -4893,8 +4978,12 @@
70.517 .rm i+
70.518 .TE
70.519 .if \n-(b.=0 .nr c. \n(.c-\n(d.-43
70.520 +
70.521 +.LP
70.522 .SS
70.523 \-printcompilation Option
70.524 +.LP
70.525 +.LP
70.526 .TS
70.527 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
70.528 .de 35
70.529 @@ -5003,7 +5092,7 @@
70.530 .nr 41 \n(80+(3*\n(38)
70.531 .nr 81 +\n(41
70.532 .nr TW \n(81
70.533 -.if t .if \n(TW>\n(.li .tm Table at line 687 file Input is too wide - \n(TW units
70.534 +.if t .if \n(TW>\n(.li .tm Table at line 796 file Input is too wide - \n(TW units
70.535 .fc
70.536 .nr #T 0-1
70.537 .nr #a 0-1
70.538 @@ -5086,16 +5175,26 @@
70.539 .rm c+
70.540 .TE
70.541 .if \n-(b.=0 .nr c. \n(.c-\n(d.-19
70.542 +
70.543 +.LP
70.544 .SS
70.545 +
70.546 +.LP
70.547 .SH ""
70.548 .LP
70.549 +.LP
70.550 This section presents some examples of monitoring a local JVM with a \f2lvmid\fP of 21891.
70.551 +.LP
70.552 .SS
70.553 Using the gcutil option
70.554 .LP
70.555 +.LP
70.556 This example attaches to \f2lvmid\fP 21891 and takes 7 samples at 250 millisecond intervals and displays the output as specified by the \f3\-gcutil\fP option.
70.557 +.LP
70.558 .nf
70.559 -\f3jstat \-gcutil 21891 250 7\fP
70.560 +\f3
70.561 +.fl
70.562 +\fP\f3jstat \-gcutil 21891 250 7\fP
70.563 .br
70.564
70.565 .fl
70.566 @@ -5129,16 +5228,24 @@
70.567 .fl
70.568 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
70.569 .br
70.570 +
70.571 +.fl
70.572 .fi
70.573 +
70.574 +.LP
70.575 .LP
70.576 The output of this example shows that a young generation collection occurred between the 3rd and 4th sample. The collection took 0.001 seconds and promoted objects from the eden space (E) to the old space (O), resulting in an increase of old space utilization from 9.49% to 9.51%. Before the collection, the survivor space was 12.44% utilized, but after this collection it is only 7.74% utilized.
70.577 +.LP
70.578 .SS
70.579 -Repeating the column header
70.580 -string
70.581 +Repeating the column header string
70.582 +.LP
70.583 .LP
70.584 This example attaches to \f2lvmid\fP 21891 and takes samples at 250 millisecond intervals and displays the output as specified by \f3\-gcutil\fP option. In addition, it uses the \f3\-h3\fP option to output the column header after every 3 lines of data.
70.585 +.LP
70.586 .nf
70.587 -\f3jstat \-gcnew \-h3 21891 250\fP
70.588 +\f3
70.589 +.fl
70.590 +\fP\f3jstat \-gcnew \-h3 21891 250\fP
70.591 .br
70.592
70.593 .fl
70.594 @@ -5180,18 +5287,27 @@
70.595 .fl
70.596 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
70.597 .br
70.598 +
70.599 +.fl
70.600 .fi
70.601 +
70.602 +.LP
70.603 .LP
70.604 In addition to showing the repeating header string, this example shows that between the 2nd and 3rd samples, a young GC occurred. Its duration was 0.001 seconds. The collection found enough live data that the survivor space 0 utilization (S0U) would would have exceeded the desired survivor Size (DSS). As a result, objects were promoted to the old generation (not visible in this output), and the tenuring threshold (TT) was lowered from 31 to 2.
70.605 .LP
70.606 +.LP
70.607 Another collection occurs between the 5th and 6th samples. This collection found very few survivors and returned the tenuring threshold to 31.
70.608 +.LP
70.609 .SS
70.610 -Including a
70.611 -time stamp for each sample
70.612 +Including a time stamp for each sample
70.613 +.LP
70.614 .LP
70.615 This example attaches to \f2lvmid\fP 21891 and takes 3 samples at 250 millisecond intervals. The \f3\-t\fP option is used to generate a time stamp for each sample in the first column.
70.616 +.LP
70.617 .nf
70.618 -\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
70.619 +\f3
70.620 +.fl
70.621 +\fP\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
70.622 .br
70.623
70.624 .fl
70.625 @@ -5209,37 +5325,56 @@
70.626 .fl
70.627 150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
70.628 .br
70.629 +
70.630 +.fl
70.631 .fi
70.632 +
70.633 +.LP
70.634 .LP
70.635 The \f2Timestamp\fP column reports the elapsed time in seconds since the start of the target JVM. In addition, the \f3\-gcoldcapacity\fP output shows the old generation capacity (OGC) and the old space capacity (OC) increasing as the heap expands to meet allocation and/or promotion demands. The old generation capacity (OGC) has grown to from 11696 KB to 13820 KB after the 81st Full GC (FGC). The maximum capacity of the generation (and space) is 60544 KB (OGCMX), so it still has room to expand.
70.636 +.LP
70.637 .SS
70.638 -Monitor
70.639 -instrumentation for a remote JVM
70.640 +Monitor instrumentation for a remote JVM
70.641 +.LP
70.642 .LP
70.643 This example attaches to \f2lvmid\fP 40496 on the system named \f2remote.domain\fP using the \f3\-gcutil\fP option, with samples taken every second indefinitely.
70.644 +.LP
70.645 .nf
70.646 -\f3jstat \-gcutil 40496@remote.domain 1000\fP
70.647 +\f3
70.648 +.fl
70.649 +\fP\f3jstat \-gcutil 40496@remote.domain 1000\fP
70.650 .br
70.651
70.652 .fl
70.653 ... \f2output omitted\fP
70.654 .br
70.655 +
70.656 +.fl
70.657 .fi
70.658 +
70.659 +.LP
70.660 .LP
70.661 The \f2lvmid\fP is combined with the name of the remote host to construct a \f2vmid\fP of \f240496@remote.domain\fP. This \f2vmid\fP results in the use of the \f3rmi\fP protocol to communicate to the default \f3jstatd\fP server on the remote host. The \f3jstatd\fP server is located using the \f3rmiregistry\fP on \f2remote.domain\fP that is bound to the default \f3rmiregistry\fP port (port 1099).
70.662 +.LP
70.663 +.RE
70.664 .SH "SEE ALSO"
70.665 +.LP
70.666 .RS 3
70.667 .TP 2
70.668 -*
70.669 -java \- the Java Application Launcher
70.670 +o
70.671 +java(1) \- the Java Application Launcher
70.672 .TP 2
70.673 -*
70.674 -jps \- the Java Process Status Application
70.675 +o
70.676 +jps(1) \- the Java Process Status Application
70.677 .TP 2
70.678 -*
70.679 -jstatd \- the jvmstat daemon
70.680 +o
70.681 +jstatd(1) \- the jvmstat daemon
70.682 .TP 2
70.683 -*
70.684 -rmiregistry \- the Java Remote Object Registry
70.685 +o
70.686 +rmiregistry(1) \- the Java Remote Object Registry
70.687 .RE
70.688 +
70.689 +.LP
70.690 +
70.691 +.LP
70.692
71.1 --- a/src/linux/doc/man/jstatd.1 Tue May 12 15:21:55 2009 +0900
71.2 +++ b/src/linux/doc/man/jstatd.1 Thu May 14 00:17:25 2009 -0700
71.3 @@ -1,6 +1,4 @@
71.4 -.'" t
71.5 -."
71.6 -." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
71.7 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
71.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
71.9 ."
71.10 ." This code is free software; you can redistribute it and/or modify it
71.11 @@ -20,13 +18,12 @@
71.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
71.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
71.14 ." have any questions.
71.15 -."
71.16 -." `
71.17 -.TH jstatd 1 "05 Aug 2006"
71.18 -." Generated by html2roff
71.19 +."
71.20 +.TH jstatd 1 "04 May 2009"
71.21 +." Generated from HTML by html2man (author: Eric Armstrong)
71.22
71.23 .LP
71.24 -.SH NAME
71.25 +.SH "Name"
71.26 jstatd \- Virtual Machine jstat Daemon
71.27 .LP
71.28 .SH "SYNOPSIS"
71.29 @@ -48,9 +45,12 @@
71.30 .LP
71.31
71.32 .LP
71.33 +.RS 3
71.34 .TP 3
71.35 options
71.36 Command\-line options. The options may be in any order. If there are redundant or contradictory options, the last option specified will take precedence.
71.37 +.RE
71.38 +
71.39 .LP
71.40 .SH "DESCRIPTION"
71.41 .LP
71.42 @@ -72,6 +72,7 @@
71.43 .LP
71.44 The \f3jstatd\fP command supports the following options:
71.45 .LP
71.46 +.RS 3
71.47 .TP 3
71.48 \-nr
71.49 Do not attempt to create an internal RMI registry within the \f2jstatd\fP process when an existing RMI registry is not found.
71.50 @@ -80,10 +81,12 @@
71.51 Port number where the RMI registry is expected to be found, or, if not found, created if \f2\-nr\fP is not specified.
71.52 .TP 3
71.53 \-n\ rminame
71.54 -Name to which the remote RMI object is bound in the RMI registry. The default name is \f2JStatRemoteHost\fP. If multiple \f3jstatd\fP servers are started on the same host, the name of the exported RMI object for each server can be made unique by by specifying this option. However, doing so will require that the unique server name be included in the monitoring client's \f2hostid\fP and \f2vmid\fP strings.
71.55 +Name to which the remote RMI object is bound in the RMI registry. The default name is \f2JStatRemoteHost\fP. If multiple \f3jstatd\fP servers are started on the same host, the name of the exported RMI object for each server can be made unique by specifying this option. However, doing so will require that the unique server name be included in the monitoring client's \f2hostid\fP and \f2vmid\fP strings.
71.56 .TP 3
71.57 \-Joption
71.58 Pass \f2option\fP to the \f3java\fP launcher called by \f3javac\fP. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying VM executing applications written in Java.
71.59 +.RE
71.60 +
71.61 .LP
71.62 .SH "SECURITY"
71.63 .LP
71.64 @@ -141,8 +144,7 @@
71.65 .LP
71.66 For sites with more restrictive security practices, it is possible to use a custom policy file to limit access to specific trusted hosts or networks, though such techniques are subject to IP addreess spoofing attacks. If your security concerns cannot be addressed with a customized policy file, then the safest action is to not run the \f3jstatd\fP server and use the \f3jstat\fP and \f3jps\fP tools locally.
71.67 .LP
71.68 -.SH "REMOTE
71.69 -INTERFACE"
71.70 +.SH "REMOTE INTERFACE"
71.71 .LP
71.72
71.73 .LP
71.74 @@ -157,8 +159,7 @@
71.75 Here are some examples of starting \f3jstatd\fP. Note that the \f3jstatd\fP scripts automatically start the server in the background.
71.76 .LP
71.77 .SS
71.78 -Using Internal RMI
71.79 -Registry
71.80 +Using Internal RMI Registry
71.81 .LP
71.82 .LP
71.83 This example demonstrates starting \f3jstatd\fP with an internal RMI registry. This example assumes that no other server is bound to the default RMI Registry port (port 1099).
71.84 @@ -173,8 +174,7 @@
71.85
71.86 .LP
71.87 .SS
71.88 -Using
71.89 -External RMI Registry
71.90 +Using External RMI Registry
71.91 .LP
71.92 .LP
71.93 This example demonstrates starting \f3jstatd\fP with a external RMI registry.
71.94 @@ -219,8 +219,7 @@
71.95
71.96 .LP
71.97 .SS
71.98 -Inhibiting creation of an in\-process RMI
71.99 -registry
71.100 +Inhibiting creation of an in\-process RMI registry
71.101 .LP
71.102 .LP
71.103 This example demonstrates starting \f3jstatd\fP such that it will not create a RMI registry if one is not found. This example assumes an RMI registry is already running. If it is not, an appropriate error message is emitted.
71.104 @@ -235,8 +234,7 @@
71.105
71.106 .LP
71.107 .SS
71.108 -Enabling RMI
71.109 -logging capabilities.
71.110 +Enabling RMI logging capabilities.
71.111 .LP
71.112 .LP
71.113 This example demonstrates starting \f3jstatd\fP with RMI logging capabilities enabled. This technique is useful as a troubleshooting aid or for monitoring server activities.
71.114 @@ -254,17 +252,20 @@
71.115 .LP
71.116 .RS 3
71.117 .TP 2
71.118 -*
71.119 -java \- the Java Application Launcher
71.120 +o
71.121 +java(1) \- the Java Application Launcher
71.122 .TP 2
71.123 -*
71.124 -jps \- the Java Process Status Application
71.125 +o
71.126 +jps(1) \- the Java Process Status Application
71.127 .TP 2
71.128 -*
71.129 -jstat \- the Java Virtual Machine Statistics Monitoring Tool
71.130 +o
71.131 +jstat(1) \- the Java Virtual Machine Statistics Monitoring Tool
71.132 .TP 2
71.133 -*
71.134 -rmiregistry \- the Java Remote Object Registry
71.135 +o
71.136 +.na
71.137 +\f2rmiregistry\fP @
71.138 +.fi
71.139 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- the Java Remote Object Registry
71.140 .RE
71.141
71.142 .LP
72.1 --- a/src/linux/doc/man/keytool.1 Tue May 12 15:21:55 2009 +0900
72.2 +++ b/src/linux/doc/man/keytool.1 Thu May 14 00:17:25 2009 -0700
72.3 @@ -1,6 +1,4 @@
72.4 -.'" t
72.5 -."
72.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
72.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
72.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
72.9 ."
72.10 ." This code is free software; you can redistribute it and/or modify it
72.11 @@ -20,13 +18,12 @@
72.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
72.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
72.14 ." have any questions.
72.15 -."
72.16 -." `
72.17 -.TH keytool 1 "07 Aug 2006"
72.18 -." Generated by html2man
72.19 +."
72.20 +.TH keytool 1 "04 May 2009"
72.21 +." Generated from HTML by html2man (author: Eric Armstrong)
72.22
72.23 .LP
72.24 -.SH NAME
72.25 +.SH "Name"
72.26 keytool \- Key and Certificate Management Tool
72.27 .LP
72.28 .RS 3
72.29 @@ -165,17 +162,19 @@
72.30 .fl
72.31
72.32 .fl
72.33 -\-keystore \fP\f4the file named \fP\f4.keystore\fP\f3 in the user's home directory\fP\f3
72.34 +\-keystore the file named \fP\f4.keystore\fP\f3 in the user's home directory
72.35 .fl
72.36
72.37 .fl
72.38 -\-storetype \fP\f4the value of the "keystore.type" property in the security properties file,
72.39 +\-storetype the value of the "keystore.type" property in the security properties file,
72.40 .fl
72.41 - which is returned by the static \fP\f4getDefaultType\fP\f3 method in \fP\f4java.security.KeyStore\fP\f3
72.42 + which is returned by the static \fP\f4getDefaultType\fP\f3 method in
72.43 +.fl
72.44 + \fP\f4java.security.KeyStore\fP\f3
72.45 .fl
72.46
72.47 .fl
72.48 -\-file \fP\f4stdin if reading, stdout if writing\fP\f3
72.49 +\-file stdin if reading, stdout if writing
72.50 .fl
72.51
72.52 .fl
72.53 @@ -187,7 +186,7 @@
72.54 .fi
72.55
72.56 .LP
72.57 -In generating a public/private key pair, the signature algorithm (\f2\-sigalg\fP option) is derived from the algorithm of the underlying private key: If the underlying private key is of type "DSA", the \f2\-sigalg\fP option defaults to "SHA1withDSA", and if the underlying private key is of type "RSA", \f2\-sigalg\fP defaults to "MD5withRSA". Please consult the
72.58 +In generating a public/private key pair, the signature algorithm (\f2\-sigalg\fP option) is derived from the algorithm of the underlying private key: If the underlying private key is of type "DSA", the \f2\-sigalg\fP option defaults to "SHA1withDSA", and if the underlying private key is of type "RSA", \f2\-sigalg\fP defaults to "SHA1withRSA". Please consult the
72.59 .na
72.60 \f2Java Cryptography Architecture API Specification & Reference\fP @
72.61 .fi
72.62 @@ -199,7 +198,7 @@
72.63 .RS 3
72.64
72.65 .LP
72.66 -The \f2\-v\fP option can appear for all commands except \f2\-help\fP. If it appears, it signifies "verbose" mode; more information will be output.
72.67 +The \f2\-v\fP option can appear for all commands except \f2\-help\fP. If it appears, it signifies "verbose" mode; more information will be provided in the output.
72.68 .LP
72.69 There is also a \f2\-J\fP\f2javaoption\fP option that may appear for any command. If it appears, the specified \f2javaoption\fP string is passed through directly to the Java interpreter. This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
72.70 .LP
72.71 @@ -236,9 +235,437 @@
72.72 .TP 3
72.73 \-protected
72.74 Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
72.75 -.RE
72.76 +.LP
72.77 +Note: Since there are two keystores involved in \f2\-importkeystore\fP command, two options, namely, \f2\-srcprotected\fP and \f2\-destprotected\fP are provided for the source keystore and the destination keystore respectively.
72.78 +.TP 3
72.79 +\-ext {name{:critical}{=value}}
72.80 +Denotes an X.509 certificate extension. The option can be used in \f2\-genkeypair\fP and \f2\-gencert\fP to embed extensions into the certificate generated, or in \f2\-certreq\fP to show what extensions are requested in the certificate request. The option can appear multiple times. name can be a supported extension name (see below) or an arbitrary OID number. value, if provided, denotes the parameter for the extension; if omitted, denotes the default value (if defined) of the extension or the extension requires no parameter. The \f2":critical"\fP modifier, if provided, means the extension's isCritical attribute is true; otherwise, false.
72.81 +.RS 3
72.82
72.83 .LP
72.84 +.LP
72.85 +Currently keytool supports these named extensions (case\-insensitive):
72.86 +.LP
72.87 +.LP
72.88 +.TS
72.89 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
72.90 +.de 35
72.91 +.ps \n(.s
72.92 +.vs \n(.vu
72.93 +.in \n(.iu
72.94 +.if \n(.u .fi
72.95 +.if \n(.j .ad
72.96 +.if \n(.j=0 .na
72.97 +..
72.98 +.nf
72.99 +.nr #~ 0
72.100 +.if n .nr #~ 0.6n
72.101 +.ds #d .d
72.102 +.if \(ts\n(.z\(ts\(ts .ds #d nl
72.103 +.fc
72.104 +.nr 33 \n(.s
72.105 +.rm 80 81
72.106 +.nr 34 \n(.lu
72.107 +.eo
72.108 +.am 81
72.109 +.br
72.110 +.di a+
72.111 +.35
72.112 +.ft \n(.f
72.113 +.ll \n(34u*1u/3u
72.114 +.if \n(.l<\n(81 .ll \n(81u
72.115 +.in 0
72.116 +The full form: "ca:{true|false}[,pathlen:<len>]"; or, <len>, a shorthand for "ca:true,pathlen:<len>"; or omitted, means "ca:true"
72.117 +.br
72.118 +.di
72.119 +.nr a| \n(dn
72.120 +.nr a- \n(dl
72.121 +..
72.122 +.ec \
72.123 +.eo
72.124 +.am 81
72.125 +.br
72.126 +.di b+
72.127 +.35
72.128 +.ft \n(.f
72.129 +.ll \n(34u*1u/3u
72.130 +.if \n(.l<\n(81 .ll \n(81u
72.131 +.in 0
72.132 +usage(,usage)*, usage can be one of digitalSignature, nonRepudiation (contentCommitment), keyEncipherment, dataEncipherment, keyAgreement, keyCertSign, cRLSign, encipherOnly, decipherOnly. Usage can be abbreviated with the first few letters (say, dig for digitalSignature) or in camel\-case style (say, dS for digitalSignature, cRLS for cRLSign), as long as no ambiguity is found. Usage is case\-insensitive.
72.133 +.br
72.134 +.di
72.135 +.nr b| \n(dn
72.136 +.nr b- \n(dl
72.137 +..
72.138 +.ec \
72.139 +.eo
72.140 +.am 81
72.141 +.br
72.142 +.di c+
72.143 +.35
72.144 +.ft \n(.f
72.145 +.ll \n(34u*1u/3u
72.146 +.if \n(.l<\n(81 .ll \n(81u
72.147 +.in 0
72.148 +usage(,usage)*, usage can be one of anyExtendedKeyUsage, serverAuth, clientAuth, codeSigning, emailProtection, timeStamping, OCSPSigning, or any OID string. Named usage can be abbreviated with the first few letters or in camel\-case style, as long as no ambiguity is found. Usage is case\-insensitive.
72.149 +.br
72.150 +.di
72.151 +.nr c| \n(dn
72.152 +.nr c- \n(dl
72.153 +..
72.154 +.ec \
72.155 +.eo
72.156 +.am 80
72.157 +.br
72.158 +.di d+
72.159 +.35
72.160 +.ft \n(.f
72.161 +.ll \n(34u*1u/3u
72.162 +.if \n(.l<\n(80 .ll \n(80u
72.163 +.in 0
72.164 +SAN or SubjectAlternativeName
72.165 +.br
72.166 +.di
72.167 +.nr d| \n(dn
72.168 +.nr d- \n(dl
72.169 +..
72.170 +.ec \
72.171 +.eo
72.172 +.am 81
72.173 +.br
72.174 +.di e+
72.175 +.35
72.176 +.ft \n(.f
72.177 +.ll \n(34u*1u/3u
72.178 +.if \n(.l<\n(81 .ll \n(81u
72.179 +.in 0
72.180 +type:value(,type:value)*, type can be EMAIL, URI, DNS, IP, or OID, value is the string format value for the type.
72.181 +.br
72.182 +.di
72.183 +.nr e| \n(dn
72.184 +.nr e- \n(dl
72.185 +..
72.186 +.ec \
72.187 +.eo
72.188 +.am 80
72.189 +.br
72.190 +.di f+
72.191 +.35
72.192 +.ft \n(.f
72.193 +.ll \n(34u*1u/3u
72.194 +.if \n(.l<\n(80 .ll \n(80u
72.195 +.in 0
72.196 +IAN or IssuerAlternativeName
72.197 +.br
72.198 +.di
72.199 +.nr f| \n(dn
72.200 +.nr f- \n(dl
72.201 +..
72.202 +.ec \
72.203 +.eo
72.204 +.am 81
72.205 +.br
72.206 +.di g+
72.207 +.35
72.208 +.ft \n(.f
72.209 +.ll \n(34u*1u/3u
72.210 +.if \n(.l<\n(81 .ll \n(81u
72.211 +.in 0
72.212 +same as SubjectAlternativeName
72.213 +.br
72.214 +.di
72.215 +.nr g| \n(dn
72.216 +.nr g- \n(dl
72.217 +..
72.218 +.ec \
72.219 +.eo
72.220 +.am 81
72.221 +.br
72.222 +.di h+
72.223 +.35
72.224 +.ft \n(.f
72.225 +.ll \n(34u*1u/3u
72.226 +.if \n(.l<\n(81 .ll \n(81u
72.227 +.in 0
72.228 +method:location\-type:location\-value (,method:location\-type:location\-value)*, method can be "timeStamping", "caRepository" or any OID. location\-type and location\-value can be any type:value supported by the SubjectAlternativeName extension.
72.229 +.br
72.230 +.di
72.231 +.nr h| \n(dn
72.232 +.nr h- \n(dl
72.233 +..
72.234 +.ec \
72.235 +.eo
72.236 +.am 80
72.237 +.br
72.238 +.di i+
72.239 +.35
72.240 +.ft \n(.f
72.241 +.ll \n(34u*1u/3u
72.242 +.if \n(.l<\n(80 .ll \n(80u
72.243 +.in 0
72.244 +AIA or AuthorityInfoAccess
72.245 +.br
72.246 +.di
72.247 +.nr i| \n(dn
72.248 +.nr i- \n(dl
72.249 +..
72.250 +.ec \
72.251 +.eo
72.252 +.am 81
72.253 +.br
72.254 +.di j+
72.255 +.35
72.256 +.ft \n(.f
72.257 +.ll \n(34u*1u/3u
72.258 +.if \n(.l<\n(81 .ll \n(81u
72.259 +.in 0
72.260 +same as SubjectInfoAccess. method can be "ocsp","caIssuers" or any OID.
72.261 +.br
72.262 +.di
72.263 +.nr j| \n(dn
72.264 +.nr j- \n(dl
72.265 +..
72.266 +.ec \
72.267 +.35
72.268 +.nf
72.269 +.ll \n(34u
72.270 +.nr 80 0
72.271 +.nr 38 \w\f3Name\fP
72.272 +.if \n(80<\n(38 .nr 80 \n(38
72.273 +.nr 38 \wBC or BasicConstraints
72.274 +.if \n(80<\n(38 .nr 80 \n(38
72.275 +.nr 38 \wKU or KeyUsage
72.276 +.if \n(80<\n(38 .nr 80 \n(38
72.277 +.nr 38 \wEKU or ExtendedkeyUsage
72.278 +.if \n(80<\n(38 .nr 80 \n(38
72.279 +.nr 38 \wSIA or SubjectInfoAccess
72.280 +.if \n(80<\n(38 .nr 80 \n(38
72.281 +.80
72.282 +.rm 80
72.283 +.nr 38 \n(d-
72.284 +.if \n(80<\n(38 .nr 80 \n(38
72.285 +.nr 38 \n(f-
72.286 +.if \n(80<\n(38 .nr 80 \n(38
72.287 +.nr 38 \n(i-
72.288 +.if \n(80<\n(38 .nr 80 \n(38
72.289 +.nr 81 0
72.290 +.nr 38 \w\f3Value\fP
72.291 +.if \n(81<\n(38 .nr 81 \n(38
72.292 +.81
72.293 +.rm 81
72.294 +.nr 38 \n(a-
72.295 +.if \n(81<\n(38 .nr 81 \n(38
72.296 +.nr 38 \n(b-
72.297 +.if \n(81<\n(38 .nr 81 \n(38
72.298 +.nr 38 \n(c-
72.299 +.if \n(81<\n(38 .nr 81 \n(38
72.300 +.nr 38 \n(e-
72.301 +.if \n(81<\n(38 .nr 81 \n(38
72.302 +.nr 38 \n(g-
72.303 +.if \n(81<\n(38 .nr 81 \n(38
72.304 +.nr 38 \n(h-
72.305 +.if \n(81<\n(38 .nr 81 \n(38
72.306 +.nr 38 \n(j-
72.307 +.if \n(81<\n(38 .nr 81 \n(38
72.308 +.35
72.309 +.nf
72.310 +.ll \n(34u
72.311 +.nr 38 1n
72.312 +.nr 79 0
72.313 +.nr 40 \n(79+(0*\n(38)
72.314 +.nr 80 +\n(40
72.315 +.nr 41 \n(80+(3*\n(38)
72.316 +.nr 81 +\n(41
72.317 +.nr TW \n(81
72.318 +.if t .if \n(TW>\n(.li .tm Table at line 288 file Input is too wide - \n(TW units
72.319 +.fc
72.320 +.nr #T 0-1
72.321 +.nr #a 0-1
72.322 +.eo
72.323 +.de T#
72.324 +.ds #d .d
72.325 +.if \(ts\n(.z\(ts\(ts .ds #d nl
72.326 +.mk ##
72.327 +.nr ## -1v
72.328 +.ls 1
72.329 +.ls
72.330 +..
72.331 +.ec
72.332 +.ta \n(80u \n(81u
72.333 +.nr 31 \n(.f
72.334 +.nr 35 1m
72.335 +\&\h'|\n(40u'\f3Name\fP\h'|\n(41u'\f3Value\fP
72.336 +.ne \n(a|u+\n(.Vu
72.337 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
72.338 +.ta \n(80u \n(81u
72.339 +.nr 31 \n(.f
72.340 +.nr 35 1m
72.341 +\&\h'|\n(40u'BC or BasicConstraints\h'|\n(41u'
72.342 +.mk ##
72.343 +.nr 31 \n(##
72.344 +.sp |\n(##u-1v
72.345 +.nr 37 \n(41u
72.346 +.in +\n(37u
72.347 +.a+
72.348 +.in -\n(37u
72.349 +.mk 32
72.350 +.if \n(32>\n(31 .nr 31 \n(32
72.351 +.sp |\n(31u
72.352 +.ne \n(b|u+\n(.Vu
72.353 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
72.354 +.ta \n(80u \n(81u
72.355 +.nr 31 \n(.f
72.356 +.nr 35 1m
72.357 +\&\h'|\n(40u'KU or KeyUsage\h'|\n(41u'
72.358 +.mk ##
72.359 +.nr 31 \n(##
72.360 +.sp |\n(##u-1v
72.361 +.nr 37 \n(41u
72.362 +.in +\n(37u
72.363 +.b+
72.364 +.in -\n(37u
72.365 +.mk 32
72.366 +.if \n(32>\n(31 .nr 31 \n(32
72.367 +.sp |\n(31u
72.368 +.ne \n(c|u+\n(.Vu
72.369 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
72.370 +.ta \n(80u \n(81u
72.371 +.nr 31 \n(.f
72.372 +.nr 35 1m
72.373 +\&\h'|\n(40u'EKU or ExtendedkeyUsage\h'|\n(41u'
72.374 +.mk ##
72.375 +.nr 31 \n(##
72.376 +.sp |\n(##u-1v
72.377 +.nr 37 \n(41u
72.378 +.in +\n(37u
72.379 +.c+
72.380 +.in -\n(37u
72.381 +.mk 32
72.382 +.if \n(32>\n(31 .nr 31 \n(32
72.383 +.sp |\n(31u
72.384 +.ne \n(d|u+\n(.Vu
72.385 +.ne \n(e|u+\n(.Vu
72.386 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
72.387 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
72.388 +.ta \n(80u \n(81u
72.389 +.nr 31 \n(.f
72.390 +.nr 35 1m
72.391 +\&\h'|\n(40u'\h'|\n(41u'
72.392 +.mk ##
72.393 +.nr 31 \n(##
72.394 +.sp |\n(##u-1v
72.395 +.nr 37 \n(40u
72.396 +.in +\n(37u
72.397 +.d+
72.398 +.in -\n(37u
72.399 +.mk 32
72.400 +.if \n(32>\n(31 .nr 31 \n(32
72.401 +.sp |\n(##u-1v
72.402 +.nr 37 \n(41u
72.403 +.in +\n(37u
72.404 +.e+
72.405 +.in -\n(37u
72.406 +.mk 32
72.407 +.if \n(32>\n(31 .nr 31 \n(32
72.408 +.sp |\n(31u
72.409 +.ne \n(f|u+\n(.Vu
72.410 +.ne \n(g|u+\n(.Vu
72.411 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
72.412 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
72.413 +.ta \n(80u \n(81u
72.414 +.nr 31 \n(.f
72.415 +.nr 35 1m
72.416 +\&\h'|\n(40u'\h'|\n(41u'
72.417 +.mk ##
72.418 +.nr 31 \n(##
72.419 +.sp |\n(##u-1v
72.420 +.nr 37 \n(40u
72.421 +.in +\n(37u
72.422 +.f+
72.423 +.in -\n(37u
72.424 +.mk 32
72.425 +.if \n(32>\n(31 .nr 31 \n(32
72.426 +.sp |\n(##u-1v
72.427 +.nr 37 \n(41u
72.428 +.in +\n(37u
72.429 +.g+
72.430 +.in -\n(37u
72.431 +.mk 32
72.432 +.if \n(32>\n(31 .nr 31 \n(32
72.433 +.sp |\n(31u
72.434 +.ne \n(h|u+\n(.Vu
72.435 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
72.436 +.ta \n(80u \n(81u
72.437 +.nr 31 \n(.f
72.438 +.nr 35 1m
72.439 +\&\h'|\n(40u'SIA or SubjectInfoAccess\h'|\n(41u'
72.440 +.mk ##
72.441 +.nr 31 \n(##
72.442 +.sp |\n(##u-1v
72.443 +.nr 37 \n(41u
72.444 +.in +\n(37u
72.445 +.h+
72.446 +.in -\n(37u
72.447 +.mk 32
72.448 +.if \n(32>\n(31 .nr 31 \n(32
72.449 +.sp |\n(31u
72.450 +.ne \n(i|u+\n(.Vu
72.451 +.ne \n(j|u+\n(.Vu
72.452 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
72.453 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
72.454 +.ta \n(80u \n(81u
72.455 +.nr 31 \n(.f
72.456 +.nr 35 1m
72.457 +\&\h'|\n(40u'\h'|\n(41u'
72.458 +.mk ##
72.459 +.nr 31 \n(##
72.460 +.sp |\n(##u-1v
72.461 +.nr 37 \n(40u
72.462 +.in +\n(37u
72.463 +.i+
72.464 +.in -\n(37u
72.465 +.mk 32
72.466 +.if \n(32>\n(31 .nr 31 \n(32
72.467 +.sp |\n(##u-1v
72.468 +.nr 37 \n(41u
72.469 +.in +\n(37u
72.470 +.j+
72.471 +.in -\n(37u
72.472 +.mk 32
72.473 +.if \n(32>\n(31 .nr 31 \n(32
72.474 +.sp |\n(31u
72.475 +.fc
72.476 +.nr T. 1
72.477 +.T# 1
72.478 +.35
72.479 +.rm a+
72.480 +.rm b+
72.481 +.rm c+
72.482 +.rm d+
72.483 +.rm e+
72.484 +.rm f+
72.485 +.rm g+
72.486 +.rm h+
72.487 +.rm i+
72.488 +.rm j+
72.489 +.TE
72.490 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-38
72.491 +
72.492 +.LP
72.493 +.LP
72.494 +For name as OID, value is the HEX dumped DER encoding of the extnValue for the extension excluding the OCTET STRING type and length bytes. Any extra character other than standard HEX numbers (0\-9, a\-f, A\-F) are ignored in the HEX string. Therefore, both \f2"01:02:03:04"\fP and \f2"01020304"\fP are accepted as identical values. If there's no value, the extension has an empty value field then.
72.495 +.LP
72.496 +.LP
72.497 +A special name \f2"honored"\fP, used in \-gencert only, denotes how the extensions included in the certificate request should be honored. The value for this name is a comma\-seperated list of \f2"all"\fP (all requested extensions are honored), \f2"name{:[critical|non\-critical]}"\fP (the named extension is honored, but using a different isCritical attribute) and \f2"\-name"\fP (used with all, denotes an exception). Requested extensions are not honored by default.
72.498 +.LP
72.499 +.LP
72.500 +If, besides the \-ext honored option, another named or OID \-ext option is provided, this extension will be added to those already honored. However, if this name (or OID) also appears in the honored value, its value and criticality overrides the one in the request.
72.501 +.LP
72.502 +.LP
72.503 +The subjectKeyIdentifier extension is always created. For non self\-signed certificates, the authorityKeyIdentifier is always created.
72.504 +.LP
72.505 +.RE
72.506 +.RE
72.507 .RE
72.508 .SH "COMMANDS"
72.509 .LP
72.510 @@ -252,7 +679,15 @@
72.511 .LP
72.512 .RS 3
72.513 .TP 3
72.514 -\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
72.515 +\-gencert {\-infile infile} {\-outfile outfile} {\-ext ext}* {\-rfc} {\-alias alias} {\-sigalg sigalg} {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] [\-keypass keypass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
72.516 +.LP
72.517 +Generates a certificate as a response to a certificate request file (which can be created by the \f2keytool \-certreq\fP command). The command reads the request from infile (if omitted, from the standard input), signs it using alias's private key, and output the X.509 certificate into outfile (if omitted, to the standard output). If \f2\-rfc\fP is specified, output format is BASE64\-encoded PEM; otherwise, a binary DER is created.
72.518 +.LP
72.519 +\f2sigalg\fP specifies the algorithm that should be used to sign the certificate. valDays tells the number of days for which the certificate should be considered valid.
72.520 +.LP
72.521 +\f2ext\fP shows what X.509 extensions will be embedded in the certificate. Read Common Options for the grammar of \f2\-ext\fP.
72.522 +.TP 3
72.523 +\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
72.524 .LP
72.525 Generates a key pair (a public key and associated private key). Wraps the public key into an X.509 v3 self\-signed certificate, which is stored as a single\-element certificate chain. This certificate chain and the private key are stored in a new keystore entry identified by \f2alias\fP.
72.526 .LP
72.527 @@ -262,9 +697,60 @@
72.528 .LP
72.529 \f2keypass\fP is a password used to protect the private key of the generated key pair. If no password is provided, the user is prompted for it. If you press RETURN at the prompt, the key password is set to the same password as that used for the keystore. \f2keypass\fP must be at least 6 characters long.
72.530 .LP
72.531 -\f2valDays\fP tells the number of days for which the certificate should be considered valid.
72.532 +\f2startdate\fP specifies the issue time of the certificate, also known as the "Not Before" value of the X.509 certificate's Validity field.
72.533 +.RS 3
72.534 +
72.535 .LP
72.536 -This command was named \f2\-genkey\fP in previous releases. This old name is still supported in this release and will be supported in future releases, but for clarify the new name, \f2\-genkeypair\fP, is preferred going forward.
72.537 +.LP
72.538 +The option value can be set in one of these two forms:
72.539 +.LP
72.540 +.RS 3
72.541 +.TP 3
72.542 +1.
72.543 +.LP
72.544 +([+\-]\f2nnn\fP[ymdHMS])+
72.545 +.TP 3
72.546 +2.
72.547 +.LP
72.548 +[yyyy/mm/dd] [HH:MM:SS]
72.549 +.RE
72.550 +
72.551 +.LP
72.552 +.LP
72.553 +With the first form, the issue time is shifted by the specified value from the current time. The value is a concatenation of a sequence of sub values. Inside each sub value, the plus sign ("+") means shifting forward, and the minus sign ("\-") means shifting backward. The time to be shifted is \f2nnn\fP units of years, months, days, hours, minutes, or seconds (denoted by a single character of "y", "m", "d", "H", "M", or "S" respectively). The exact value of the issue time is calculated using the \f2java.util.GregorianCalendar.add(int field, int amount)\fP method on each sub value, from left to right. For example, by specifying \f2"\-startdate \-1y+1m\-1d"\fP, the issue time will be:
72.554 +.LP
72.555 +.RS 3
72.556 +
72.557 +.LP
72.558 +.nf
72.559 +\f3
72.560 +.fl
72.561 + Calendar c = new GregorianCalendar();
72.562 +.fl
72.563 + c.add(Calendar.YEAR, \-1);
72.564 +.fl
72.565 + c.add(Calendar.MONTH, 1);
72.566 +.fl
72.567 + c.add(Calendar.DATE, \-1);
72.568 +.fl
72.569 + return c.getTime()
72.570 +.fl
72.571 +\fP
72.572 +.fi
72.573 +.RE
72.574 +
72.575 +.LP
72.576 +.LP
72.577 +With the second form, the user sets the exact issue time in two parts, year/month/day and hour:minute:second (using the local timezone). The user may provide only one part, which means the other part is the same as the current date (or time). User must provide the exact number of digits as shown in the format definition (padding with 0 if shorter). When both the date and time are provided, there is one (and only one) space character between the two parts. The hour should always be provided in 24 hour format.
72.578 +.LP
72.579 +.LP
72.580 +When the option is not provided, the start date is the current time. The option can be provided at most once.
72.581 +.LP
72.582 +.RE
72.583 +.LP
72.584 +\f2valDays\fP specifies the number of days (starting at the date specified by \f2\-startdate\fP, or the current date if \f2\-startdate\fP is not specified) for which the certificate should be considered valid.
72.585 +.LP
72.586 +This command was named \f2\-genkey\fP in previous releases. This old name is still supported in this release and will be supported in future releases, but for clarity the new name, \f2\-genkeypair\fP, is preferred going forward.
72.587 .TP 3
72.588 \-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
72.589 .LP
72.590 @@ -274,7 +760,7 @@
72.591 .TP 3
72.592 \-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
72.593 .LP
72.594 -Reads the certificate or certificate chain (where the latter is supplied in a PKCS#7 formatted reply) from the file \f2cert_file\fP, and stores it in the keystore entry identified by \f2alias\fP. If no file is given, the certificate or PKCS#7 reply is read from stdin.
72.595 +Reads the certificate or certificate chain (where the latter is supplied in a PKCS#7 formatted reply or a sequence of X.509 certificates) from the file \f2cert_file\fP, and stores it in the keystore entry identified by \f2alias\fP. If no file is given, the certificate or certificate chain is read from stdin.
72.596 .LP
72.597 \f3keytool\fP can import X.509 v1, v2, and v3 certificates, and PKCS#7 formatted certificate chains consisting of certificates of that type. The data to be imported must be provided either in binary encoding format, or in printable encoding format (also known as Base64 encoding) as defined by the Internet RFC 1421 standard. In the latter case, the encoding must be bounded at the beginning by a string that starts with "\-\-\-\-\-BEGIN", and bounded at the end by a string that starts with "\-\-\-\-\-END".
72.598 .LP
72.599 @@ -299,8 +785,6 @@
72.600 .RE
72.601 \f3Importing a New Trusted Certificate\fP
72.602 .RS 3
72.603 -
72.604 -.LP
72.605 .LP
72.606 Before adding the certificate to the keystore, \f3keytool\fP tries to verify it by attempting to construct a chain of trust from that certificate to a self\-signed certificate (belonging to a root CA), using trusted certificates that are already available in the keystore.
72.607 .LP
72.608 @@ -325,7 +809,7 @@
72.609 \f3If the reply is a single X.509 certificate\fP, \f3keytool\fP attempts to establish a trust chain, starting at the certificate reply and ending at a self\-signed certificate (belonging to a root CA). The certificate reply and the hierarchy of certificates used to authenticate the certificate reply form the new certificate chain of \f2alias\fP. If a trust chain cannot be established, the certificate reply is not imported. In this case, \f3keytool\fP does not print out the certificate and prompt the user to verify it, because it is very hard (if not impossible) for a user to determine the authenticity of the certificate reply.
72.610 .TP 2
72.611 o
72.612 -\f3If the reply is a PKCS#7 formatted certificate chain\fP, the chain is first ordered (with the user certificate first and the self\-signed root CA certificate last), before \f3keytool\fP attempts to match the root CA certificate provided in the reply with any of the trusted certificates in the keystore or the "cacerts" keystore file (if the \f2\-trustcacerts\fP option was specified). If no match can be found, the information of the root CA certificate is printed out, and the user is prompted to verify it, e.g., by comparing the displayed certificate fingerprints with the fingerprints obtained from some other (trusted) source of information, which might be the root CA itself. The user then has the option of aborting the import operation. If the \f2\-noprompt\fP option is given, however, there will be no interaction with the user.
72.613 +\f3If the reply is a PKCS#7 formatted certificate chain or a sequence of X.509 certificates\fP, the chain is ordered with the user certificate first followed by zero or more CA certificates. If the chain ends with a self\-signed root CA certificate and \f2\-trustcacerts\fP option was specified, \f3keytool\fP will attempt to match it with any of the trusted certificates in the keystore or the "cacerts" keystore file. If the chain does not end with a self\-signed root CA certificate and the \f2\-trustcacerts\fP option was specified, \f3keytool\fP will try to find one from the trusted certificates in the keystore or the "cacerts" keystore file and add it to the end of the chain. If the certificate is not found and \f2\-noprompt\fP option is not specified, the information of the last certificate in the chain is printed out, and the user is prompted to verify it.
72.614 .RE
72.615
72.616 .LP
72.617 @@ -347,6 +831,10 @@
72.618 If the destination alias already exists in the destination keystore, the user is prompted to either overwrite the entry, or to create a new entry under a different alias name.
72.619 .LP
72.620 Note that if \f2\-noprompt\fP is provided, the user will not be prompted for a new destination alias. Existing entries will automatically be overwritten with the destination alias name. Finally, entries that can not be imported are automatically skipped and a warning is output.
72.621 +.TP 3
72.622 +\-printcertreq {\-file file}
72.623 +.LP
72.624 +Prints the content of a PKCS #10 format certificate request, which can be generated by the keytool \-certreq command. The command reads the request from file; if omitted, from the standard input.
72.625 .RE
72.626 .RE
72.627 .SS
72.628 @@ -398,16 +886,20 @@
72.629 .LP
72.630 Prints (to stdout) the contents of the keystore entry identified by \f2alias\fP. If no alias is specified, the contents of the entire keystore are printed.
72.631 .LP
72.632 -This command by default prints the MD5 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, with additional information such as the owner, issuer, serial number, and any extensions. If the \f2\-rfc\fP option is specified, certificate contents are printed using the printable encoding format, as defined by the Internet RFC 1421 standard
72.633 +This command by default prints the SHA1 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, with additional information such as the owner, issuer, serial number, and any extensions. If the \f2\-rfc\fP option is specified, certificate contents are printed using the printable encoding format, as defined by the Internet RFC 1421 standard
72.634 .LP
72.635 You cannot specify both \f2\-v\fP and \f2\-rfc\fP.
72.636 .TP 3
72.637 -\-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
72.638 +\-printcert {\-file cert_file | \-sslserver host[:port]} {\-rfc} {\-v} {\-Jjavaoption}
72.639 .LP
72.640 .LP
72.641 -Internet RFC 1421 standard.
72.642 +If \f2\-rfc\fP is specified, keytool prints the certificate in PEM mode as defined by the Internet RFC 1421 standard.
72.643 .LP
72.644 -Note: This option can be used independently of a keystore.
72.645 +If the certificate is read from a file or stdin, it may be either binary encoded or in printable encoding format, as defined by the Internet RFC 1421 standard
72.646 +.LP
72.647 +If the SSL server is behind a firewall, \f2\-J\-Dhttps.proxyHost=proxyhost\fP and \f2\-J\-Dhttps.proxyPort=proxyport\fP can be specified on the command line for proxy tunneling. See the JSSE Reference Guide for more information.
72.648 +.LP
72.649 +\f3Note\fP: This option can be used independently of a keystore.
72.650 .RE
72.651
72.652 .LP
72.653 @@ -606,11 +1098,7 @@
72.654 .RS 3
72.655
72.656 .LP
72.657 -Suppose you have used the
72.658 -.na
72.659 -\f2jarsigner\fP @
72.660 -.fi
72.661 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html tool to sign a Java ARchive (JAR) file. Clients that want to use the file will want to authenticate your signature.
72.662 +Suppose you have used the jarsigner(1) tool to sign a Java ARchive (JAR) file. Clients that want to use the file will want to authenticate your signature.
72.663 .LP
72.664 One way they can do this is by first importing your public key certificate into their keystore as a "trusted" entry. You can export the certificate and supply it to your clients. As an example, you can copy your certificate to a file named \f2MJ.cer\fP via the following, assuming the entry is aliased by "mykey":
72.665 .LP
72.666 @@ -677,6 +1165,45 @@
72.667 .RE
72.668
72.669 .LP
72.670 +.SS
72.671 +Generating Certificates for a typical SSL Server
72.672 +.LP
72.673 +.RS 3
72.674 +
72.675 +.LP
72.676 +.LP
72.677 +Keytool commands to generate keypairs and certificates for three entities, namely, Root CA (root), Intermadiate CA (ca), and SSL server (server) are as follows:
72.678 +.LP
72.679 +.nf
72.680 +\f3
72.681 +.fl
72.682 +keytool \-keystore root.jks \-genkeypair \-alias root \-ext bc:c
72.683 +.fl
72.684 +keytool \-keystore ca.jks \-alias ca
72.685 +.fl
72.686 +keytool \-keystore server.jks \-alias server
72.687 +.fl
72.688 +
72.689 +.fl
72.690 +keytool \-keystore root.jks \-alias root \-exportcert > root.pem
72.691 +.fl
72.692 +
72.693 +.fl
72.694 +keytool \-keystore ca.jks \-certreq \-alias ca | keytool \-keystore root.jks \-gencert \-alias root \-ext BC=0 > ca.pem
72.695 +.fl
72.696 +keytool \-keystore ca.jks \-importcert \-alias ca \-file ca.pem
72.697 +.fl
72.698 +
72.699 +.fl
72.700 +keytool \-keystore server.jks \-certreq \-alias server | keytool \-keystore ca.jks \-gencert \-alias ca \-ext ku:c=dig,kE >server.pem
72.701 +.fl
72.702 +cat root.pem ca.pem server.pem | keytool \-keystore server.jks \-importcert \-alias server
72.703 +.fl
72.704 +\fP
72.705 +.fi
72.706 +.RE
72.707 +
72.708 +.LP
72.709 .SH "TERMINOLOGY and WARNINGS"
72.710 .LP
72.711
72.712 @@ -759,7 +1286,11 @@
72.713 There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
72.714 .LP
72.715 .LP
72.716 -Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a "provider" and supply a KeystoreSpi subclass implementation, as described in How to Implement a Provider for the Java Cryptography Architecture.
72.717 +Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a "provider" and supply a KeystoreSpi subclass implementation, as described in
72.718 +.na
72.719 +\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
72.720 +.fi
72.721 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html.
72.722 .LP
72.723 .LP
72.724 Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private/secret keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
72.725 @@ -1132,13 +1663,6 @@
72.726 OU=CyberTrust, O=Baltimore, C=IE
72.727 .TP 2
72.728 *
72.729 -\f3Alias\fP: gtecybertrustca
72.730 -.br
72.731 -\f3Owner DN\fP: CN=GTE CyberTrust Root,
72.732 -.br
72.733 -O=GTE Corporation, C=US
72.734 -.TP 2
72.735 -*
72.736 \f3Alias\fP: gtecybertrust5ca
72.737 .br
72.738 \f3Owner DN\fP: CN=GTE CyberTrust Root 5,
72.739 @@ -1370,7 +1894,7 @@
72.740 The \f2\-exportcert\fP command by default outputs a certificate in binary encoding, but will instead output a certificate in the printable encoding format, if the \f2\-rfc\fP option is specified.
72.741 .LP
72.742 .LP
72.743 -The \f2\-list\fP command by default prints the MD5 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, while if the \f2\-rfc\fP option is specified, the certificate is output in the printable encoding format.
72.744 +The \f2\-list\fP command by default prints the SHA1 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, while if the \f2\-rfc\fP option is specified, the certificate is output in the printable encoding format.
72.745 .LP
72.746 .LP
72.747 In its printable encoding format, the encoded certificate is bounded at the beginning by
72.748 @@ -1577,18 +2101,15 @@
72.749 .RS 3
72.750 .TP 2
72.751 o
72.752 -.na
72.753 -\f2jar\fP @
72.754 -.fi
72.755 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jar.html tool documentation
72.756 +.LP
72.757 +jar(1) tool documentation
72.758 .TP 2
72.759 o
72.760 -.na
72.761 -\f2jarsigner\fP @
72.762 -.fi
72.763 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html tool documentation
72.764 +.LP
72.765 +jarsigner(1) tool documentation
72.766 .TP 2
72.767 o
72.768 +.LP
72.769 the
72.770 .na
72.771 \f4Security\fP @
72.772 @@ -1597,7 +2118,7 @@
72.773 .na
72.774 \f4Java Tutorial\fP @
72.775 .fi
72.776 -http://java.sun.com/docs/books/tutorial/trailmap.html for examples of the use of \f3keytool\fP
72.777 +http://java.sun.com/docs/books/tutorial for examples of the use of \f3keytool\fP
72.778 .RE
72.779
72.780 .LP
73.1 --- a/src/linux/doc/man/native2ascii.1 Tue May 12 15:21:55 2009 +0900
73.2 +++ b/src/linux/doc/man/native2ascii.1 Thu May 14 00:17:25 2009 -0700
73.3 @@ -1,6 +1,4 @@
73.4 -.'" t
73.5 -."
73.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
73.7 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
73.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
73.9 ."
73.10 ." This code is free software; you can redistribute it and/or modify it
73.11 @@ -21,19 +19,20 @@
73.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
73.13 ." have any questions.
73.14 ."
73.15 -." `
73.16 -.TH native2ascii 1 "05 Aug 2006"
73.17 -." Generated by html2roff
73.18 -.\\" Created by: Doug Kramer, 19\-Aug\-1996
73.19 +.TH native2ascii 1 "04 May 2009"
73.20 +." Generated from HTML by html2man (author: Eric Armstrong)
73.21 +
73.22 .LP
73.23 -.SH NAME
73.24 +.SH "Name"
73.25 native2ascii \- Native\-to\-ASCII Converter
73.26 .LP
73.27 +.RS 3
73.28
73.29 .LP
73.30 .LP
73.31 Converts a file with native\-encoded characters (characters which are non\-Latin 1 and non\-Unicode) to one with Unicode\-encoded characters.
73.32 .LP
73.33 +.RE
73.34 .SH "SYNOPSIS"
73.35 .LP
73.36
73.37 @@ -60,6 +59,7 @@
73.38 .LP
73.39
73.40 .LP
73.41 +.RS 3
73.42 .TP 3
73.43 \-reverse
73.44 Perform the reverse operation: convert a file with Latin\-1 and/or Unicode encoded characters to one with native\-encoded characters.
73.45 @@ -74,7 +74,9 @@
73.46 http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.html document.
73.47 .TP 3
73.48 \-Joption
73.49 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
73.50 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
73.51 +.RE
73.52 +
73.53 .LP
73.54
73.55 .LP
74.1 --- a/src/linux/doc/man/orbd.1 Tue May 12 15:21:55 2009 +0900
74.2 +++ b/src/linux/doc/man/orbd.1 Thu May 14 00:17:25 2009 -0700
74.3 @@ -1,5 +1,3 @@
74.4 -.'" t
74.5 -."
74.6 ." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
74.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
74.8 ."
74.9 @@ -20,13 +18,12 @@
74.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
74.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
74.12 ." have any questions.
74.13 -."
74.14 -." `
74.15 -.TH orbd 1 "07 Aug 2006"
74.16 -." Generated by html2man
74.17 +."
74.18 +.TH orbd 1 "04 May 2009"
74.19 +." Generated from HTML by html2man (author: Eric Armstrong)
74.20
74.21 .LP
74.22 -.SH NAME
74.23 +.SH "Name"
74.24 orbd \- The Object Request Broker Daemon
74.25 .LP
74.26 .RS 3
74.27 @@ -36,7 +33,11 @@
74.28 \f3orbd\fP is used to enable clients to transparently locate and invoke persistent objects on servers in the CORBA environment.
74.29 .LP
74.30 .LP
74.31 -\f3See also:\fP \f2Naming Service\fP
74.32 +\f3See also:\fP
74.33 +.na
74.34 +\f2Naming Service\fP @
74.35 +.fi
74.36 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
74.37 .LP
74.38 .RE
74.39 .SH "SYNOPSIS"
74.40 @@ -70,10 +71,14 @@
74.41
74.42 .LP
74.43 .LP
74.44 -To access ORBD's Server Manager, the server must be started using \f2servertool\fP, which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. For more information on the Server Manager, see the section in this document titled \f2Server Manager\fP.
74.45 +To access ORBD's Server Manager, the server must be started using servertool(1), which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. For more information on the Server Manager, see the section in this document titled \f2Server Manager\fP.
74.46 .LP
74.47 .LP
74.48 -When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to \f2Naming Service\fP.
74.49 +When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to
74.50 +.na
74.51 +\f2Naming Service\fP @
74.52 +.fi
74.53 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
74.54 .LP
74.55 .SH "OPTIONS"
74.56 .LP
74.57 @@ -124,7 +129,7 @@
74.58 .RS 3
74.59 .TP 3
74.60 \-Joption
74.61 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
74.62 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
74.63 .TP 3
74.64
74.65 .RE
74.66 @@ -133,7 +138,15 @@
74.67 .SH "Starting and Stopping the Naming Service"
74.68 .LP
74.69 .LP
74.70 -A Naming Service is a CORBA service that allows CORBA objects to be named by means of binding a name to an object reference. The name binding may be stored in the naming service, and a client may supply the name to obtain the desired object reference.
74.71 +A Naming Service is a CORBA service that allows
74.72 +.na
74.73 +\f2CORBA objects\fP @
74.74 +.fi
74.75 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object to be named by means of binding a name to an object reference. The
74.76 +.na
74.77 +\f2name binding\fP @
74.78 +.fi
74.79 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding may be stored in the naming service, and a client may supply the name to obtain the desired object reference.
74.80 .LP
74.81 .LP
74.82 Prior to running a client or a server, you will start ORBD. ORBD includes a persistent Naming Service and a transient Naming Service, both of which are an implementation of the COS Naming Service.
74.83 @@ -208,18 +221,26 @@
74.84 To stop the naming service, use the relevant operating system command, such as \f2pkill orbd\fP on Solaris, or \f2Ctrl+C\fP in the DOS window in which \f2orbd\fP is running. Note that names registered with the naming service may disappear when the service is terminated if the naming service is transient. The Java IDL naming service will run until it is explicitly stopped.
74.85 .LP
74.86 .LP
74.87 -For more information on the Naming Service included with ORBD, see \f2Naming Service\fP.
74.88 +For more information on the Naming Service included with ORBD, see
74.89 +.na
74.90 +\f2Naming Service\fP @
74.91 +.fi
74.92 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
74.93 .LP
74.94 .SH "Server Manager"
74.95 .LP
74.96 .LP
74.97 -To access ORBD's Server Manager and run a persistent server, the server must be started using \f2servertool\fP, which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. When a server is started using \f2servertool\fP, it must be started on the same host and port on which \f2orbd\fP is executing. If the server is run on a different port, the information stored in the database for local contexts will be invalid and the service will not work properly.
74.98 +To access ORBD's Server Manager and run a persistent server, the server must be started using servertool(1), which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. When a server is started using \f2servertool\fP, it must be started on the same host and port on which \f2orbd\fP is executing. If the server is run on a different port, the information stored in the database for local contexts will be invalid and the service will not work properly.
74.99 .LP
74.100 .SS
74.101 Server Manager: an Example
74.102 .LP
74.103 .LP
74.104 -Using the sample tutorial for our demonstration, you would run the \f2idlj\fP compiler and \f2javac\fP compiler as shown in the tutorial. To run the Server Manager, follow these steps for running the application:
74.105 +Using the
74.106 +.na
74.107 +\f2sample tutorial\fP @
74.108 +.fi
74.109 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html for our demonstration, you would run the \f2idlj\fP compiler and \f2javac\fP compiler as shown in the tutorial. To run the Server Manager, follow these steps for running the application:
74.110 .LP
74.111 .LP
74.112 Start \f2orbd\fP.
74.113 @@ -339,11 +360,14 @@
74.114 .RS 3
74.115 .TP 2
74.116 o
74.117 -Naming Service
74.118 +.na
74.119 +\f2Naming Service\fP @
74.120 +.fi
74.121 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
74.122 .br
74.123 .TP 2
74.124 o
74.125 -servertool
74.126 +servertool(1)
74.127 .RE
74.128
74.129 .LP
75.1 --- a/src/linux/doc/man/pack200.1 Tue May 12 15:21:55 2009 +0900
75.2 +++ b/src/linux/doc/man/pack200.1 Thu May 14 00:17:25 2009 -0700
75.3 @@ -1,5 +1,3 @@
75.4 -.'" t
75.5 -."
75.6 ." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
75.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
75.8 ."
75.9 @@ -20,13 +18,12 @@
75.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
75.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
75.12 ." have any questions.
75.13 -."
75.14 -." `
75.15 -.TH pack200 1 "05 Aug 2006"
75.16 -." Generated by html2roff
75.17 +."
75.18 +.TH pack200 1 "04 May 2009"
75.19 +." Generated from HTML by html2man (author: Eric Armstrong)
75.20
75.21 .LP
75.22 -.SH NAME
75.23 +.SH "Name"
75.24 pack200 \- JAR Packing tool
75.25 .LP
75.26 .SH "SYNOPSIS"
75.27 @@ -42,6 +39,7 @@
75.28 .RS 3
75.29
75.30 .LP
75.31 +.RS 3
75.32 .TP 3
75.33 options
75.34 Command\-line options.
75.35 @@ -51,6 +49,8 @@
75.36 .TP 3
75.37 JAR\-file
75.38 Name of the input file.
75.39 +.RE
75.40 +
75.41 .LP
75.42 .RE
75.43 .SH "DESCRIPTION"
75.44 @@ -66,11 +66,13 @@
75.45 .SS
75.46 Typical usage:
75.47 .LP
75.48 +.RS 3
75.49
75.50 .LP
75.51 .LP
75.52 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
75.53 .LP
75.54 +.RE
75.55 .LP
75.56 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
75.57 .LP
75.58 @@ -178,15 +180,21 @@
75.59 .LP
75.60 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
75.61 .LP
75.62 +.RS 3
75.63 .TP 3
75.64 true
75.65 .TP 3
75.66 false
75.67 In either case, the packer will set the deflation hint accordingly in the output archive, and will not transmit the individual deflation hints of archive elements.
75.68 +.RE
75.69 +
75.70 .LP
75.71 +.RS 3
75.72 .TP 3
75.73 keep
75.74 Preserve deflation hints observed in the input JAR. (This is the default.)
75.75 +.RE
75.76 +
75.77 .LP
75.78 .RE
75.79 .LP
75.80 @@ -198,12 +206,15 @@
75.81 .LP
75.82 The possible values are:
75.83 .LP
75.84 +.RS 3
75.85 .TP 3
75.86 latest
75.87 The packer will attempt to determine the latest modification time, among all the available entries in the original archive, or the latest modification time of all the available entries in that segment. This single value will be transmitted as part of the segment and applied to all the entries in each segment. This can marginally decrease the transmitted size of the archive at the expense of setting all installed files to a single date.
75.88 .TP 3
75.89 keep
75.90 Preserves modification times observed in the input JAR. (This is the default.)
75.91 +.RE
75.92 +
75.93 .LP
75.94 .RE
75.95 .LP
75.96 @@ -225,6 +236,7 @@
75.97 .LP
75.98 Overrides the default behavior; i.e., the classfile containing the unknown attribute will be passed through with the specified action. The possible values for actions are:
75.99 .LP
75.100 +.RS 3
75.101 .TP 3
75.102 error
75.103 The \f2pack200\fP operation as a whole will fail with a suitable explanation.
75.104 @@ -234,16 +246,18 @@
75.105 .TP 3
75.106 pass
75.107 Upon encountering this attribute, the entire class will be transmitted as though it is a resource.
75.108 +.RE
75.109 +
75.110 .LP
75.111 .RE
75.112 .LP
75.113 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
75.114 .br
75.115 - \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
75.116 +\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
75.117 .br
75.118 - \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
75.119 +\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
75.120 .br
75.121 - \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
75.122 +\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
75.123 .LP
75.124 .RS 3
75.125
75.126 @@ -251,6 +265,7 @@
75.127 .LP
75.128 With the above four options, the attribute layout can be specified for a class entity, such as Class attribute, Field attribute, Method attribute, and Code attribute. The attribute\-name is the name of the attribute for which the layout or action is being defined. The possible values for action are:
75.129 .LP
75.130 +.RS 3
75.131 .TP 3
75.132 some\-layout\-string
75.133 The layout language is defined in the JSR 200 specification.
75.134 @@ -262,6 +277,8 @@
75.135 .TP 3
75.136 strip
75.137 Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures.
75.138 +.RE
75.139 +
75.140 .LP
75.141 .LP
75.142 Example: \f2\-\-class\-attribute=CompilationID=pass\fP will cause the class file containing this attribute to be passed through without further action by the packer.
75.143 @@ -369,29 +386,29 @@
75.144 .LP
75.145 .RS 3
75.146 .TP 2
75.147 -*
75.148 -unpack200 \- JAR Unpacking Tool
75.149 +o
75.150 +unpack200(1)
75.151 .TP 2
75.152 -*
75.153 -\f2unpack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
75.154 +o
75.155 +.na
75.156 +\f2Java SE Documentation\fP @
75.157 +.fi
75.158 +http://java.sun.com/javase/6/docs/index.html
75.159 .TP 2
75.160 -*
75.161 -Java SE Documentation
75.162 -.TP 2
75.163 -*
75.164 +o
75.165 .na
75.166 \f2Java Deployment Guide \- Pack200\fP @
75.167 .fi
75.168 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
75.169 .TP 2
75.170 -*
75.171 -\f2jar\fP \- Java Archive Tool
75.172 +o
75.173 +jar(1) \- Java Archive Tool
75.174 .TP 2
75.175 -*
75.176 -.na
75.177 -\f2jarsigner\fP \- JAR Signer tool @
75.178 -.fi
75.179 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
75.180 +o
75.181 +jarsigner(1) \- JAR Signer tool
75.182 +.TP 2
75.183 +o
75.184 +\f2attributes(5)\fP man page
75.185 .RE
75.186
75.187 .LP
75.188 @@ -403,6 +420,8 @@
75.189 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
75.190 .LP
75.191 .LP
75.192 -The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
75.193 +The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
75.194 +.LP
75.195 +
75.196 .LP
75.197
76.1 --- a/src/linux/doc/man/policytool.1 Tue May 12 15:21:55 2009 +0900
76.2 +++ b/src/linux/doc/man/policytool.1 Thu May 14 00:17:25 2009 -0700
76.3 @@ -1,6 +1,4 @@
76.4 -.'" t
76.5 -."
76.6 -." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
76.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
76.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
76.9 ."
76.10 ." This code is free software; you can redistribute it and/or modify it
76.11 @@ -21,12 +19,11 @@
76.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
76.13 ." have any questions.
76.14 ."
76.15 -." `
76.16 -.TH policytool 1 "07 Aug 2006"
76.17 -." Generated by html2man
76.18 +.TH policytool 1 "04 May 2009"
76.19 +." Generated from HTML by html2man (author: Eric Armstrong)
76.20
76.21 .LP
76.22 -.SH NAME
76.23 +.SH "Name"
76.24 policytool \- PolicyTool Administration GUI Utility
76.25 .LP
76.26 \f3policytool\fP reads and writes a plain text policy file based on user input via the utility GUI.
76.27 @@ -55,20 +52,14 @@
76.28 filename
76.29 The file name
76.30 .RE
76.31 -.RE
76.32 -
76.33 -.LP
76.34 -.SH "DESCRIPTION"
76.35 -.LP
76.36 +.SH "DESCRIPTION"
76.37 .LP
76.38 \f3policytool\fP is a GUI that allows users to create and manage policy files. For details, see
76.39 .na
76.40 \f2the Policytool Users Guide\fP @
76.41 .fi
76.42 -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
76.43 -.LP
76.44 -.SH "OPTIONS"
76.45 -.LP
76.46 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
76.47 +.SH "OPTIONS"
76.48 .RS 3
76.49 .TP 3
76.50 file
76.51 @@ -95,6 +86,9 @@
76.52 http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
76.53 .br
76.54 .RE
76.55 +.RE
76.56 +
76.57 +.LP
76.58
76.59 .LP
76.60
77.1 --- a/src/linux/doc/man/rmic.1 Tue May 12 15:21:55 2009 +0900
77.2 +++ b/src/linux/doc/man/rmic.1 Thu May 14 00:17:25 2009 -0700
77.3 @@ -1,6 +1,4 @@
77.4 -.'" t
77.5 -."
77.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
77.7 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
77.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
77.9 ."
77.10 ." This code is free software; you can redistribute it and/or modify it
77.11 @@ -21,19 +19,20 @@
77.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
77.13 ." have any questions.
77.14 ."
77.15 -." `
77.16 -.TH rmic 1 "05 Aug 2006"
77.17 -." Generated by html2roff
77.18 +.TH rmic 1 "04 May 2009"
77.19 +." Generated from HTML by html2man (author: Eric Armstrong)
77.20
77.21 .LP
77.22 -.SH NAME
77.23 +.SH "Name"
77.24 rmic \- The Java RMI Compiler
77.25 .LP
77.26 +.RS 3
77.27
77.28 .LP
77.29 .LP
77.30 \f3rmic\fP generates stub, skeleton, and tie classes for remote objects using either the JRMP or IIOP protocols. Also generates OMG IDL.
77.31 .LP
77.32 +.RE
77.33 .SH "SYNOPSIS"
77.34 .LP
77.35
77.36 @@ -85,6 +84,7 @@
77.37 .LP
77.38
77.39 .LP
77.40 +.RS 3
77.41 .TP 3
77.42 \-bootclasspath path
77.43 Overrides location of bootstrap class files
77.44 @@ -137,6 +137,7 @@
77.45 .TP 3
77.46 \-g
77.47 Enables generation of all debugging information, including local variables. By default, only line number information is generated.
77.48 +.LP
77.49 .TP 3
77.50 \-idl
77.51 Causes \f2rmic\fP to generate OMG IDL for the classes specified and any classes referenced. IDL provides a purely declarative, programming language\-independent way of specifying an object's API. The IDL is used as a specification for methods and data that can be written in and invoked from any language that provides CORBA bindings. This includes Java and C++ among others. See the
77.52 @@ -146,6 +147,7 @@
77.53 http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) document for a complete description.
77.54 .LP
77.55 When the \f2\-idl\fP option is used, other options also include:
77.56 +.RS 3
77.57 .TP 3
77.58 \-always or \-alwaysgenerate
77.59 Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
77.60 @@ -153,13 +155,12 @@
77.61 \-factory
77.62 Uses factory keyword in generated IDL.
77.63 .TP 3
77.64 -\-idlModule\ fromJavaPackage[.class]\
77.65 -toIDLModule
77.66 +\-idlModule\ fromJavaPackage[.class]\ toIDLModule
77.67 Specifies IDLEntity package mapping. For example:\ \f2\-idlModule foo.bar my::real::idlmod\fP.
77.68 .TP 3
77.69 -\-idlFile\ fromJavaPackage[.class]\
77.70 -toIDLFile
77.71 -Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
77.72 +\-idlFile\ fromJavaPackage[.class]\ toIDLFile
77.73 +Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
77.74 +.RE
77.75 .LP
77.76 .TP 3
77.77 \-iiop
77.78 @@ -185,6 +186,7 @@
77.79 .RE
77.80 .LP
77.81 When the \f2\-iiop\fP option is used, other options also include:
77.82 +.RS 3
77.83 .TP 3
77.84 \-always or \-alwaysgenerate
77.85 Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
77.86 @@ -202,7 +204,8 @@
77.87 .na
77.88 \f2Portable Object Adapter\fP @
77.89 .fi
77.90 -http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
77.91 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
77.92 +.RE
77.93 .TP 3
77.94 \-J
77.95 Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
77.96 @@ -212,23 +215,29 @@
77.97 .TP 3
77.98 \-nowarn
77.99 Turns off warnings. If used the compiler does not print out any warnings.
77.100 +.LP
77.101 .TP 3
77.102 \-vcompat
77.103 Generates stub and skeleton classes compatible with both the 1.1 and 1.2 JRMP stub protocol versions. (This option was the default in releases prior to 5.0.) The generated stub classes will use the 1.1 stub protocol version when loaded in a JDK 1.1 virtual machine and will use the 1.2 stub protocol version when loaded into a 1.2 (or later) virtual machine. The generated skeleton classes will support both 1.1 and 1.2 stub protocol versions. The generated classes are relatively large in order to support both modes of operation.
77.104 .TP 3
77.105 \-verbose
77.106 Causes the compiler and linker to print out messages about what classes are being compiled and what class files are being loaded.
77.107 +.LP
77.108 .TP 3
77.109 \-v1.1
77.110 Generates stub and skeleton classes for the 1.1 JRMP stub protocol version only. Note that this option is only useful for generating stub classes that are serialization\-compatible with pre\-existing, statically\-deployed stub classes that were generated by the \f3rmic\fP tool from JDK 1.1 and that cannot be upgraded (and dynamic class loading is not being used).
77.111 +.LP
77.112 .TP 3
77.113 \-v1.2
77.114 (default) Generates stub classes for the 1.2 JRMP stub protocol version only. No skeleton classes are generated with this option because skeleton classes are not used with the 1.2 stub protocol version. The generated stub classes will not work if they are loaded into a JDK 1.1 virtual machine.
77.115 +.RE
77.116 +
77.117 .LP
77.118 .SH "ENVIRONMENT VARIABLES"
77.119 .LP
77.120
77.121 .LP
77.122 +.RS 3
77.123 .TP 3
77.124 CLASSPATH
77.125 Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example,
77.126 @@ -243,6 +252,7 @@
77.127 \fP
77.128 .fi
77.129 .RE
77.130 +.RE
77.131
77.132 .LP
77.133 .SH "SEE ALSO"
77.134 @@ -250,7 +260,11 @@
77.135
77.136 .LP
77.137 .LP
77.138 -java, javac, CLASSPATH
77.139 +java(1), javac(1),
77.140 +.na
77.141 +\f2CLASSPATH\fP @
77.142 +.fi
77.143 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
77.144 .LP
77.145
77.146 .LP
78.1 --- a/src/linux/doc/man/rmid.1 Tue May 12 15:21:55 2009 +0900
78.2 +++ b/src/linux/doc/man/rmid.1 Thu May 14 00:17:25 2009 -0700
78.3 @@ -1,6 +1,4 @@
78.4 -.'" t
78.5 -."
78.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
78.7 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
78.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
78.9 ."
78.10 ." This code is free software; you can redistribute it and/or modify it
78.11 @@ -20,21 +18,21 @@
78.12 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
78.13 ." CA 95054 USA or visit www.sun.com if you need additional information or
78.14 ." have any questions.
78.15 -."
78.16 -." `
78.17 -.TH rmid 1 "05 Aug 2006"
78.18 -." Generated by html2roff
78.19 -.\\" Changed by: Ann Wollrath \- JavaSoft East, 2\-Mar\-2000
78.20 -.\\" Changed by: Jen McGinn \- Jini Technology Software, 6\-Mar\-2000
78.21 +."
78.22 +.TH rmid 1 "04 May 2009"
78.23 +." Generated from HTML by html2man (author: Eric Armstrong)
78.24 +
78.25 .LP
78.26 -.SH NAME
78.27 +.SH "Name"
78.28 rmid \- The Java RMI Activation System Daemon
78.29 .LP
78.30 +.RS 3
78.31
78.32 .LP
78.33 .LP
78.34 \f3rmid\fP starts the activation system daemon that allows objects to be registered and activated in a virtual machine (VM).
78.35 .LP
78.36 +.RE
78.37 .SH "SYNOPSIS"
78.38 .LP
78.39
78.40 @@ -57,7 +55,7 @@
78.41 .na
78.42 \f2Java RMI Specification\fP @
78.43 .fi
78.44 -http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html and
78.45 +http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html and
78.46 .na
78.47 \f2Activation tutorials\fP @
78.48 .fi
78.49 @@ -83,10 +81,10 @@
78.50 .LP
78.51 .RS 3
78.52 .TP 2
78.53 -*
78.54 +o
78.55 starts the Activator and an internal registry on the default port, 1098, and
78.56 .TP 2
78.57 -*
78.58 +o
78.59 binds an \f2ActivationSystem\fP to the name \f2java.rmi.activation.ActivationSystem\fP in this internal registry.
78.60 .RE
78.61
78.62 @@ -107,8 +105,7 @@
78.63 starts the activation system daemon and a registry on the registry's default port, 1099.
78.64 .LP
78.65 .SS
78.66 -Starting rmid from
78.67 -inetd/xinetd
78.68 +Starting rmid from inetd/xinetd
78.69 .LP
78.70 .LP
78.71 An alternative to starting \f2rmid\fP from the command line is to configure \f2inetd\fP (Solaris) or \f2xinetd\fP (Linux) to start \f2rmid\fP on demand.
78.72 @@ -121,13 +118,13 @@
78.73 .LP
78.74 .RS 3
78.75 .TP 2
78.76 -*
78.77 +o
78.78 Output printed to \f2System.err\fP is redirected to a file. This file is located in the directory specified by the \f2java.io.tmpdir\fP system property (typically \f2/var/tmp\fP or \f2/tmp\fP) with the prefix \f2"rmid\-err"\fP and the suffix \f2"tmp"\fP.
78.79 .TP 2
78.80 -*
78.81 +o
78.82 The \f2\-port\fP option is disallowed. If this option is specified, \f2rmid\fP will exit with an error message.
78.83 .TP 2
78.84 -*
78.85 +o
78.86 The \f2\-log\fP option is required. If this option is not specified, \f2rmid\fP will exit with an error message.
78.87 .RE
78.88
78.89 @@ -139,6 +136,7 @@
78.90 .LP
78.91
78.92 .LP
78.93 +.RS 3
78.94 .TP 3
78.95 \-C<someCommandLineOption>
78.96 Specifies an option that is passed as a command\-line argument to each child process (activation group) of \f2rmid\fP when that process is created. For example, you could pass a property to each virtual machine spawned by the activation system daemon:
78.97 @@ -170,13 +168,12 @@
78.98 \fP
78.99 .fi
78.100 .TP 3
78.101 -
78.102 \-J\-Dsun.rmi.activation.execPolicy=<policy>
78.103 Specifies the policy that \f2rmid\fP employs to check commands and command\-line options used to launch the VM in which an activation group runs. Please note that this option exists only in Sun's implementation of the Java RMI activation daemon. If this property is not specified on the command line, the result is the same as if \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP were specified. The possible values of \f2<policy>\fP can be \f2default\fP, \f2<policyClassName>\fP, or \f2none\fP:
78.104 .LP
78.105 .RS 3
78.106 .TP 2
78.107 -*
78.108 +o
78.109 \f3default (or if this property is \fP\f4unspecified\fP\f3)\fP
78.110 .LP
78.111 The default \f2execPolicy\fP allows \f2rmid\fP to execute commands with specific command\-line options only if \f2rmid\fP has been granted permission to execute those commands and options in the security policy file that \f2rmid\fP uses. Only the default activation group implementation can be used with the \f2default\fP execution policy.
78.112 @@ -192,7 +189,8 @@
78.113 .LP
78.114 The permission \f2com.sun.rmi.rmid.ExecPermission\fP is used to grant \f2rmid\fP permission to execute a command, specified in the group descriptor's \f2CommandEnvironment\fP to launch an activation group. The permission \f2com.sun.rmi.rmid.ExecOptionPermission\fP is used to allow \f2rmid\fP to use command\-line options, specified as properties overrides in the group descriptor or as options in the \f2CommandEnvironment\fP, when launching the activation group.
78.115 .LP
78.116 -When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources).
78.117 +When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources).
78.118 +.RS 3
78.119 .TP 3
78.120 ExecPermission
78.121 The \f2ExecPermission\fP class represents permission for \f2rmid\fP to execute a specific \f2command\fP to launch an activation group.
78.122 @@ -212,8 +210,7 @@
78.123 .LP
78.124 For example: "*" or "\-Dfoo.*" or "\-Da.b.c=*" is valid, "*foo" or "\-Da*b" or "ab*" is not.
78.125 .TP 3
78.126 -Policy file for
78.127 -rmid
78.128 +Policy file for rmid
78.129 When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources). It is safe to grant these permissions universally because only \f2rmid\fP checks these permissions.
78.130 .LP
78.131 An example policy file that grants various execute permissions to \f2rmid\fP is:
78.132 @@ -224,13 +221,7 @@
78.133 .fl
78.134 permission com.sun.rmi.rmid.ExecPermission
78.135 .fl
78.136 - "/files/apps/java/jdk1.2.2/solaris/bin/java";
78.137 -.fl
78.138 -
78.139 -.fl
78.140 - permission com.sun.rmi.rmid.ExecPermission
78.141 -.fl
78.142 - "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
78.143 + "/files/apps/java/jdk1.7.0/solaris/bin/java";
78.144 .fl
78.145
78.146 .fl
78.147 @@ -260,9 +251,9 @@
78.148 .fl
78.149 \fP
78.150 .fi
78.151 -The first two permissions granted allow \f2rmid\fP to execute the 1.2.2 version of the \f2java\fP and \f2java_g\fP commands, specified by their explicit path names. Note that by default, the version of the \f2java\fP command found in \f2java.home\fP is used (the same one that \f2rmid\fP uses), and does not need to be specified in the policy file. The third permission allows \f2rmid\fP to execute any command in the directory \f2/files/apps/rmidcmds\fP.
78.152 +The first permission granted allow \f2rmid\fP to execute the 1.7.0 version of the \f2java\fP command, specified by its explicit path name. Note that by default, the version of the \f2java\fP command found in \f2java.home\fP is used (the same one that \f2rmid\fP uses), and does not need to be specified in the policy file. The second permission allows \f2rmid\fP to execute any command in the directory \f2/files/apps/rmidcmds\fP.
78.153 .LP
78.154 -The fourth permission granted, an \f2ExecOptionPermission\fP, allows \f2rmid\fP to launch an activation group that defines the security policy file to be \f2/files/policies/group.policy\fP. The next permission allows the \f2java.security.debug\fP property to be used by an activation group. The last permission allows any property in the \f2sun.rmi\fP property name hierarchy to be used by activation groups.
78.155 +The third permission granted, an \f2ExecOptionPermission\fP, allows \f2rmid\fP to launch an activation group that defines the security policy file to be \f2/files/policies/group.policy\fP. The next permission allows the \f2java.security.debug\fP property to be used by an activation group. The last permission allows any property in the \f2sun.rmi\fP property name hierarchy to be used by activation groups.
78.156 .LP
78.157 To start \f2rmid\fP with a policy file, the \f2java.security.policy\fP property needs to be specified on \f2rmid\fP's command line, for example:
78.158 .RS 3
78.159 @@ -272,10 +263,12 @@
78.160 \f2rmid \-J\-Djava.security.policy=rmid.policy\fP
78.161 .LP
78.162 .RE
78.163 +.RE
78.164 .TP 2
78.165 -*
78.166 +o
78.167 +.LP
78.168 .TP 2
78.169 -*
78.170 +o
78.171 \f4<policyClassName>\fP
78.172 .LP
78.173 If the default behavior is not flexible enough, an administrator can provide, when starting \f2rmid\fP, the name of a class whose \f2checkExecCommand\fP method is executed in order to check commands to be executed by rmid.
78.174 @@ -295,14 +288,16 @@
78.175 Before launching an activation group, \f2rmid\fP calls the policy's \f2checkExecCommand\fP method, passing it the activation group descriptor and an array containing the complete command to launch the activation group. If the \f2checkExecCommand\fP throws a \f2SecurityException\fP, \f2rmid\fP will not launch the activation group and an \f2ActivationException\fP will be thrown to the caller attempting to activate the object.
78.176 .LP
78.177 .TP 2
78.178 -*
78.179 +o
78.180 \f3none\fP
78.181 .LP
78.182 If the \f2sun.rmi.activation.execPolicy\fP property value is "none", then \f2rmid\fP will not perform any validation of commands to launch activation groups.
78.183 .RE
78.184 +.LP
78.185 .TP 3
78.186 \-log dir
78.187 Specifies the name of the directory the activation system daemon uses to write its database and associated information. The log directory defaults to creating a directory, \f2log\fP, in the directory in which the \f2rmid\fP command was executed.
78.188 +.LP
78.189 .TP 3
78.190 \-port port
78.191 Specifies the port \f2rmid\fP's registry uses. The activation system daemon binds the \f2ActivationSystem\fP, with the name \f2java.rmi.activation.ActivationSystem\fP, in this registry. Thus, the \f2ActivationSystem\fP on the local machine can be obtained using the following \f2Naming.lookup\fP method call:
78.192 @@ -322,11 +317,13 @@
78.193 .fi
78.194 .TP 3
78.195 \-stop
78.196 -Stops the current invocation of \f2rmid\fP, for a port specified by the \f2\-port\fP option. If no port is specified, it will stop the \f2rmid\fP running on port 1098.
78.197 +Stops the current invocation of \f2rmid\fP, for a port specified by the \f2\-port\fP option. If no port is specified, it will stop the \f2rmid\fP running on port 1098.
78.198 +.RE
78.199 .SH "ENVIRONMENT VARIABLES"
78.200 .LP
78.201
78.202 .LP
78.203 +.RS 3
78.204 .TP 3
78.205 CLASSPATH
78.206 Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example:
78.207 @@ -337,6 +334,7 @@
78.208 .fl
78.209 \fP
78.210 .fi
78.211 +.RE
78.212
78.213 .LP
78.214 .SH "SEE ALSO"
78.215 @@ -344,7 +342,11 @@
78.216
78.217 .LP
78.218 .LP
78.219 -rmic, CLASSPATH, java
78.220 +rmic(1),
78.221 +.na
78.222 +\f2CLASSPATH\fP @
78.223 +.fi
78.224 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath, java(1)
78.225 .LP
78.226
78.227 .LP
79.1 --- a/src/linux/doc/man/rmiregistry.1 Tue May 12 15:21:55 2009 +0900
79.2 +++ b/src/linux/doc/man/rmiregistry.1 Thu May 14 00:17:25 2009 -0700
79.3 @@ -1,6 +1,4 @@
79.4 -.'" t
79.5 -."
79.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
79.7 +." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
79.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
79.9 ."
79.10 ." This code is free software; you can redistribute it and/or modify it
79.11 @@ -21,19 +19,20 @@
79.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
79.13 ." have any questions.
79.14 ."
79.15 -." `
79.16 -.TH rmiregistry 1 "05 Aug 2006"
79.17 -." Generated by html2roff
79.18 +.TH rmiregistry 1 "04 May 2009"
79.19 +." Generated from HTML by html2man (author: Eric Armstrong)
79.20
79.21 .LP
79.22 -.SH NAME
79.23 +.SH "Name"
79.24 rmiregistry \- The Java Remote Object Registry
79.25 .LP
79.26 +.RS 3
79.27
79.28 .LP
79.29 .LP
79.30 The \f3rmiregistry\fP command starts a remote object registry on the specified port on the current host.
79.31 .LP
79.32 +.RE
79.33 .SH "SYNOPSIS"
79.34 .LP
79.35
79.36 @@ -73,24 +72,27 @@
79.37 .LP
79.38
79.39 .LP
79.40 +.RS 3
79.41 .TP 3
79.42 \-J
79.43 Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
79.44 +.RE
79.45 +
79.46 .LP
79.47 .SH "SEE ALSO"
79.48 .LP
79.49
79.50 .LP
79.51 .LP
79.52 -java,
79.53 +java(1),
79.54 .na
79.55 \f2java.rmi.registry.LocateRegistry\fP @
79.56 .fi
79.57 -http://java.sun.com/javase/6/docs/api/java/rmi/registry/locateregistry.html and
79.58 +http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html and
79.59 .na
79.60 \f2java.rmi.Naming\fP @
79.61 .fi
79.62 -http://java.sun.com/javase/6/docs/api/java/rmi/naming.html
79.63 +http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
79.64 .LP
79.65
79.66 .LP
80.1 --- a/src/linux/doc/man/schemagen.1 Tue May 12 15:21:55 2009 +0900
80.2 +++ b/src/linux/doc/man/schemagen.1 Thu May 14 00:17:25 2009 -0700
80.3 @@ -1,5 +1,3 @@
80.4 -.'" t
80.5 -."
80.6 ." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
80.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
80.8 ."
80.9 @@ -20,20 +18,18 @@
80.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
80.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
80.12 ." have any questions.
80.13 -."
80.14 -." `
80.15 -.TH schemagen 1 "07 Aug 2006"
80.16 -." Generated by html2man
80.17 +."
80.18 +.TH schemagen 1 "04 May 2009"
80.19 +." Generated from HTML by html2man (author: Eric Armstrong)
80.20
80.21 .LP
80.22 -.ad c
80.23 -.SH NAME
80.24 -schemagen \- Java(TM) Architecture for XML Binding Schema Generator \f3Specification Version:\fP 2.0
80.25 +.SH "Name"
80.26 +schemagen \- Java(TM) Architecture for XML Binding Schema Generator
80.27 +.LP
80.28 +.LP
80.29 +\f3Specification Version:\fP 2.1
80.30 .br
80.31 -\f3Reference Implementation (RI) Version:\fP 2.0 ea3
80.32 -.br
80.33 -.ad l
80.34 -
80.35 +\f3Implementation Version:\fP 2.1.3
80.36 .LP
80.37 .SS
80.38 Launching schemagen
80.39 @@ -45,36 +41,21 @@
80.40 The current schema generator can process either Java source files or class files.
80.41 .LP
80.42 .LP
80.43 -We also provide an Ant task to run the schema generator \- see the instructions for using schemagen with Ant.
80.44 +We also provide an Ant task to run the schema generator \- see the instructions for
80.45 +.na
80.46 +\f2using schemagen with Ant\fP @
80.47 +.fi
80.48 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
80.49 .LP
80.50 .RS 3
80.51
80.52 .LP
80.53 -\f3For Solaris/Linux\fP
80.54 -.LP
80.55 .nf
80.56 \f3
80.57 .fl
80.58 - % path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
80.59 +% schemagen.sh Foo.java Bar.java ...
80.60 .fl
80.61 - Note: Writing schema1.xsd
80.62 -.fl
80.63 -
80.64 -.fl
80.65 -\fP
80.66 -.fi
80.67 -
80.68 -.LP
80.69 -\f3For WindowsNT/2000/XP\fP
80.70 -.LP
80.71 -.nf
80.72 -\f3
80.73 -.fl
80.74 - > path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
80.75 -.fl
80.76 - Note: Writing schema1.xsd
80.77 -.fl
80.78 -
80.79 +Note: Writing schema1.xsd
80.80 .fl
80.81 \fP
80.82 .fi
80.83 @@ -109,8 +90,6 @@
80.84 .fl
80.85 \-help : Display this usage message
80.86 .fl
80.87 -
80.88 -.fl
80.89 \fP
80.90 .fi
80.91 .RE
80.92 @@ -121,145 +100,35 @@
80.93 Generated Resource Files
80.94 .LP
80.95 .LP
80.96 -The current schema generator simply creates a schema file for each namespace referenced in your Java classes. There is no way to control the name of the generated schema files at this time. For that purpose, use the schema generator ant task.
80.97 +The current schema generator simply creates a schema file for each namespace referenced in your Java classes. There is no way to control the name of the generated schema files at this time. For that purpose, use
80.98 +.na
80.99 +\f2the schema generator ant task\fP @
80.100 +.fi
80.101 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
80.102 .LP
80.103 .SH "See Also"
80.104 .LP
80.105 .RS 3
80.106 .TP 2
80.107 o
80.108 -JAXB 2.0:
80.109 -.RS 3
80.110 -.TP 2
80.111 -*
80.112 +Running the schema generator (schemagen): [
80.113 .na
80.114 -\f2Release Notes\fP @
80.115 +\f2command\-line instructions\fP @
80.116 .fi
80.117 -http://java.sun.com/webservices/docs/2.0/jaxb/ReleaseNotes.html
80.118 -.TP 2
80.119 -*
80.120 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html,
80.121 .na
80.122 -\f2XJC\fP @
80.123 +\f2using the SchemaGen Ant task\fP @
80.124 .fi
80.125 -http://java.sun.com/webservices/docs/2.0/jaxb/xjc.html
80.126 -.TP 2
80.127 -*
80.128 -.na
80.129 -\f2XJCTask\fP @
80.130 -.fi
80.131 -http://java.sun.com/webservices/docs/2.0/jaxb/xjcTask.html
80.132 -.TP 2
80.133 -*
80.134 -.na
80.135 -\f2SchemaGen\fP @
80.136 -.fi
80.137 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagen.html
80.138 -.TP 2
80.139 -*
80.140 -.na
80.141 -\f2schemagenTask\fP @
80.142 -.fi
80.143 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagenTask.html
80.144 -.TP 2
80.145 -*
80.146 -.na
80.147 -\f2Sample Apps\fP @
80.148 -.fi
80.149 -http://java.sun.com/webservices/docs/2.0/jaxb/samples.html
80.150 -.TP 2
80.151 -*
80.152 -.na
80.153 -\f2Changelog\fP @
80.154 -.fi
80.155 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog2.html
80.156 -.RE
80.157 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
80.158 .TP 2
80.159 o
80.160 -JAXB 1.0.x:
80.161 -.RS 3
80.162 -.TP 2
80.163 -*
80.164 .na
80.165 -\f2Release Notes\fP @
80.166 +\f2Java Architecture for XML Binding (JAXB)\fP @
80.167 .fi
80.168 -http://java.sun.com/webservices/docs/2.0/jaxb/jaxb\-1_0.html
80.169 -.TP 2
80.170 -*
80.171 -.na
80.172 -\f2Changelog\fP @
80.173 -.fi
80.174 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog.html
80.175 -.RE
80.176 -.TP 2
80.177 -o
80.178 -JAXB RI Extensions:
80.179 -.RS 3
80.180 -.TP 2
80.181 -*
80.182 -.na
80.183 -\f2Runtime Properties\fP @
80.184 -.fi
80.185 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorProperties.html
80.186 -.TP 2
80.187 -*
80.188 -.na
80.189 -\f2XJC Customizations\fP @
80.190 -.fi
80.191 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorCustomizations.html
80.192 -.TP 2
80.193 -*
80.194 -.na
80.195 -\f2Develop Plugins\fP @
80.196 -.fi
80.197 -http://java.sun.com/webservices/docs/2.0/jaxb/developPlugins.html
80.198 -.RE
80.199 -.TP 2
80.200 -o
80.201 -JAXB RI Schema Languages:
80.202 -.RS 3
80.203 -.TP 2
80.204 -*
80.205 -.na
80.206 -\f2W3C XML Schema\fP @
80.207 -.fi
80.208 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#xschema
80.209 -.TP 2
80.210 -*
80.211 -.na
80.212 -\f2RELAX NG\fP @
80.213 -.fi
80.214 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#relaxng
80.215 -.TP 2
80.216 -*
80.217 -.na
80.218 -\f2DTD\fP @
80.219 -.fi
80.220 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#dtd
80.221 -.RE
80.222 -.TP 2
80.223 -o
80.224 -JAXB Community:
80.225 -.RS 3
80.226 -.TP 2
80.227 -*
80.228 -.na
80.229 -\f2Java.net Homepage\fP @
80.230 -.fi
80.231 -http://jaxb.dev.java.net
80.232 -.TP 2
80.233 -*
80.234 -.na
80.235 -\f2Developer interest list\fP @
80.236 -.fi
80.237 -https://jaxb.dev.java.net/servlets/ProjectMailingListList
80.238 -.TP 2
80.239 -*
80.240 -.na
80.241 -\f2FAQ\fP @
80.242 -.fi
80.243 -https://jaxb.dev.java.net/faq/index.html
80.244 -.RE
80.245 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
80.246 .RE
80.247
80.248 .LP
80.249 +
80.250 +.LP
80.251
81.1 --- a/src/linux/doc/man/serialver.1 Tue May 12 15:21:55 2009 +0900
81.2 +++ b/src/linux/doc/man/serialver.1 Thu May 14 00:17:25 2009 -0700
81.3 @@ -1,6 +1,4 @@
81.4 -.'" t
81.5 -."
81.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
81.7 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
81.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
81.9 ."
81.10 ." This code is free software; you can redistribute it and/or modify it
81.11 @@ -21,19 +19,20 @@
81.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
81.13 ." have any questions.
81.14 ."
81.15 -." `
81.16 -.TH serialver 1 "05 Aug 2006"
81.17 -." Generated by html2roff
81.18 +.TH serialver 1 "04 May 2009"
81.19 +." Generated from HTML by html2man (author: Eric Armstrong)
81.20
81.21 .LP
81.22 -.SH NAME
81.23 +.SH "Name"
81.24 serialver \- The Serial Version Command
81.25 .LP
81.26 +.RS 3
81.27
81.28 .LP
81.29 .LP
81.30 The \f3serialver\fP command returns the \f2serialVersionUID\fP.
81.31 .LP
81.32 +.RE
81.33 .SH "SYNOPSIS"
81.34 .LP
81.35
81.36 @@ -49,12 +48,15 @@
81.37 .RS 3
81.38
81.39 .LP
81.40 +.RS 3
81.41 .TP 3
81.42 options
81.43 Command\-line options, as specified in this document.
81.44 .TP 3
81.45 classnames
81.46 One or more class names
81.47 +.RE
81.48 +
81.49 .LP
81.50 .RE
81.51 .SH "DESCRIPTION"
81.52 @@ -68,17 +70,22 @@
81.53 .LP
81.54
81.55 .LP
81.56 +.RS 3
81.57 .TP 3
81.58 -\-classpath <directories and zip/jar files separated
81.59 -by :>
81.60 +\-classpath <directories and zip/jar files separated by :>
81.61 Set search path for application classes and resources.
81.62 +.RE
81.63 +
81.64 .LP
81.65 +.RS 3
81.66 .TP 3
81.67 \-show
81.68 Displays a simple user interface. Enter the full class name and press either the Enter key or the Show button to display the serialVersionUID.
81.69 .TP 3
81.70 \-Joption
81.71 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
81.72 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
81.73 +.RE
81.74 +
81.75 .LP
81.76 .SH "NOTES"
81.77 .LP
81.78 @@ -112,7 +119,7 @@
81.79 .na
81.80 \f2java.io.ObjectStreamClass\fP @
81.81 .fi
81.82 -http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
81.83 +http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
81.84 .LP
81.85
81.86 .LP
82.1 --- a/src/linux/doc/man/servertool.1 Tue May 12 15:21:55 2009 +0900
82.2 +++ b/src/linux/doc/man/servertool.1 Thu May 14 00:17:25 2009 -0700
82.3 @@ -1,5 +1,3 @@
82.4 -.'" t
82.5 -."
82.6 ." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
82.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
82.8 ."
82.9 @@ -21,17 +19,18 @@
82.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
82.11 ." have any questions.
82.12 ."
82.13 -." `
82.14 -.TH servertool 1 "05 Aug 2006"
82.15 -." Generated by html2roff
82.16 +.TH servertool 1 "04 May 2009"
82.17 +." Generated from HTML by html2man (author: Eric Armstrong)
82.18
82.19 .LP
82.20 -.SH NAME
82.21 +.SH "Name"
82.22 servertool \- The Java(TM) IDL Server Tool
82.23 .LP
82.24 +.RS 3
82.25
82.26 .LP
82.27 -\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
82.28 +\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
82.29 +.RE
82.30 .SH "SYNOPSIS"
82.31 .LP
82.32
82.33 @@ -65,37 +64,29 @@
82.34 .LP
82.35
82.36 .LP
82.37 +.RS 3
82.38 .TP 3
82.39 \-ORBInitialHost nameserverhost
82.40 Specifies the host machine on which the name server is running and listening for incoming requests. The \f2nameserverhost\fP defaults to \f2localhost\fP if this option is not specified. If \f2orbd\fP and \f2servertool\fP are running on different machines, you must specify the name or IP address of the host on which \f2orbd\fP is running.
82.41 .TP 3
82.42 \-Joption
82.43 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
82.44 -.na
82.45 -\f2java a pplication launcher\fP @
82.46 -.fi
82.47 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
82.48 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
82.49 +.RE
82.50 +
82.51 .LP
82.52 .SH "COMMANDS"
82.53 .LP
82.54
82.55 .LP
82.56 +.RS 3
82.57 .TP 3
82.58 -register \-server\ <server\ class\ name>
82.59 -\ \-classpath\ <classpath\ to\ server>
82.60 -[\ \-applicationName\ <application\ name>
82.61 -\-args\ <args\ to\ server>
82.62 -\-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM>
82.63 -\ ]
82.64 +register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
82.65 Register a new persistent server with the Object Request Broker Daemon (ORBD). If the server is not already registered, it is registered and activated. This command causes an install method to be invoked in the main class of the server identified by the \f2\-server\fP option. The install method must be \f2public static void install(org.omg.CORBA.ORB)\fP. The install method is optional and enables the developer to provide their own server installation behavior (for example, creating database schema).
82.66 .TP 3
82.67 -unregister
82.68 -\-serverid\ <server\ id\ >\ |
82.69 -\-applicationName\ <application\ name>
82.70 +unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
82.71 Unregister a server from the ORBD by using either its server id or its application name. This command causes an uninstall method to be invoked in the main class of the server identified by the \f2\-server\fP option. The uninstall method must be \f2public static void uninstall(org.omg.CORBA.ORB)\fP. The uninstall method is optional and enables the developer to provide their own server uninstall behavior (for example, undoing the behavior of the install method).
82.72 .TP 3
82.73 -getserverid
82.74 -\-applicationName\ <application\ name>
82.75 +getserverid \-applicationName\ <application\ name>
82.76 Return the server id that corresponds with an application.
82.77 .TP 3
82.78 list
82.79 @@ -107,27 +98,19 @@
82.80 listactive
82.81 List information about all persistent servers that have been launched by the ORBD and are currently running.
82.82 .TP 3
82.83 -locate \-serverid\ <server\ id\ >\ |
82.84 -\-applicationName\ <application\ name>
82.85 -[\-endpointType\ <endpointType>\ ]
82.86 +locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
82.87 Locate the endpoints (ports) of a specific type for all ORBs created by a registered server. If a server is not already running, it is activated. If an endpoint type is not specified, then the plain/non\-protected endpoint associated with each ORB in a server is returned.
82.88 .TP 3
82.89 -locateperorb
82.90 -\-serverid\ <server\ id\ >\ |
82.91 -\-applicationName\ <application\ name>
82.92 -[\-orbid\ <ORB\ name>\ ]
82.93 +locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
82.94 Locate all the endpoints (ports) registered by a specific ORB of registered server. If a server is not already running, then it is activated. If an \f2orbid\fP is not specified, the default value of "" is assigned to the \f2orbid\fP. If any ORBs are created with an \f2orbid\fP of empty string, all ports registered by it are returned.
82.95 .TP 3
82.96 -orblist \-serverid\ <server\ id\ >\ |
82.97 -\-applicationName\ <application\ name>
82.98 +orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
82.99 Lists the ORBId of the ORBs defined on a server. An ORBId is the string name for the ORB created by the server. If the server is not already running, it is activated.
82.100 .TP 3
82.101 -shutdown \-serverid\ <server\ id\ >\ |
82.102 -\-applicationName\ <application\ name>
82.103 +shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
82.104 Shutdown an active server that is registered with ORBD. During execution of this command, the \f2shutdown()\fP method defined in the class specified by either the \f2\-serverid\fP or \f2\-applicationName\fP parameter is also invoked to shutdown the server process appropriately.
82.105 .TP 3
82.106 -startup \-serverid\ <server\ id\ >\ |
82.107 -\-applicationName\ <application\ name>
82.108 +startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
82.109 Startup or activate a server that is registered with ORBD. If the server is not running, this command launches the server. If the server is already running, an error message is returned to the user.
82.110 .TP 3
82.111 help
82.112 @@ -135,11 +118,13 @@
82.113 .TP 3
82.114 quit
82.115 Exit the server tool.
82.116 +.RE
82.117 +
82.118 .LP
82.119 .SH "SEE ALSO"
82.120 .LP
82.121
82.122 .LP
82.123 -orbd
82.124 +orbd(1)
82.125 .LP
82.126
83.1 --- a/src/linux/doc/man/tnameserv.1 Tue May 12 15:21:55 2009 +0900
83.2 +++ b/src/linux/doc/man/tnameserv.1 Thu May 14 00:17:25 2009 -0700
83.3 @@ -1,6 +1,4 @@
83.4 -.'" t
83.5 -."
83.6 -." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
83.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
83.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
83.9 ."
83.10 ." This code is free software; you can redistribute it and/or modify it
83.11 @@ -21,18 +19,17 @@
83.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
83.13 ." have any questions.
83.14 ."
83.15 -." `
83.16 -.TH tnameserv 1 "06 Aug 2006"
83.17 -." Generated by html2man
83.18 +.TH tnameserv 1 "04 May 2009"
83.19 +." Generated from HTML by html2man (author: Eric Armstrong)
83.20
83.21 .LP
83.22 -.SH NAME
83.23 +.SH "Name"
83.24 Java IDL: Transient Naming Service \- \f2tnameserv\fP
83.25 .LP
83.26
83.27 .LP
83.28 .LP
83.29 -This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its man page or the
83.30 +This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its orbd(1) or the
83.31 .na
83.32 \f2Java IDL Naming Service Included with ORBD\fP @
83.33 .fi
83.34 @@ -178,13 +175,12 @@
83.35 .RS 3
83.36
83.37 .LP
83.38 +.RS 3
83.39 .TP 3
83.40 \-Joption
83.41 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
83.42 -.na
83.43 -\f2java application launcher\fP @
83.44 -.fi
83.45 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
83.46 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
83.47 +.RE
83.48 +
83.49 .LP
83.50 .RE
83.51 .SH "Stopping the Java\ IDL Transient Naming Service"
83.52 @@ -206,15 +202,15 @@
83.53 .fl
83.54 \fP\f4Naming Context\fP\f3
83.55 .fl
83.56 - / \\
83.57 + / \\
83.58 .fl
83.59 - / \\
83.60 + / \\
83.61 .fl
83.62 plans \fP\f4Personal\fP\f3
83.63 .fl
83.64 - / \\
83.65 + / \\
83.66 .fl
83.67 - / \\
83.68 + / \\
83.69 .fl
83.70 calendar schedule\fP
83.71 .fl
84.1 --- a/src/linux/doc/man/unpack200.1 Tue May 12 15:21:55 2009 +0900
84.2 +++ b/src/linux/doc/man/unpack200.1 Thu May 14 00:17:25 2009 -0700
84.3 @@ -1,5 +1,3 @@
84.4 -.'" t
84.5 -."
84.6 ." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
84.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
84.8 ."
84.9 @@ -20,13 +18,12 @@
84.10 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
84.11 ." CA 95054 USA or visit www.sun.com if you need additional information or
84.12 ." have any questions.
84.13 -."
84.14 -." `
84.15 -.TH unpack200 1 "05 Aug 2006"
84.16 -." Generated by html2roff
84.17 +."
84.18 +.TH unpack200 1 "04 May 2009"
84.19 +." Generated from HTML by html2man (author: Eric Armstrong)
84.20
84.21 .LP
84.22 -.SH NAME
84.23 +.SH "Name"
84.24 unpack200 \- JAR Unpacking tool
84.25 .LP
84.26 .SH "SYNOPSIS"
84.27 @@ -42,12 +39,15 @@
84.28 .RS 3
84.29
84.30 .LP
84.31 +.RS 3
84.32 .TP 3
84.33 input\-file
84.34 Name of the input file, which can be a pack200 gzip file or a pack200 file. The input could also be JAR file produced by pack200(1) with an effort of 0. In this case the contents of the input file will be copied to the output JAR file with the Pack200 marker.
84.35 .TP 3
84.36 JAR\-file
84.37 Name of the output JAR file.
84.38 +.RE
84.39 +
84.40 .LP
84.41 .RE
84.42 .SH "DESCRIPTION"
84.43 @@ -72,6 +72,7 @@
84.44 .SS
84.45 Standard Options
84.46 .LP
84.47 +.RS 3
84.48
84.49 .LP
84.50 .LP
84.51 @@ -84,9 +85,11 @@
84.52 Sets the deflation to be \f2true\fP, \f2false\fP, or \f2keep\fP on all entries within a JAR file. The default mode is \f2keep\fP. If \f2true\fP or \f2false\fP, overrides the default behavior and sets the deflation mode on all entries within the output JAR file.
84.53 .LP
84.54 .RE
84.55 +.RE
84.56 .SS
84.57 Non\-Standard Options
84.58 .LP
84.59 +.RS 3
84.60
84.61 .LP
84.62 .LP
84.63 @@ -129,6 +132,7 @@
84.64 Specifies a log file to output messages.
84.65 .LP
84.66 .RE
84.67 +.RE
84.68 .SH "EXIT STATUS"
84.69 .LP
84.70
84.71 @@ -150,29 +154,29 @@
84.72 .LP
84.73 .RS 3
84.74 .TP 2
84.75 -*
84.76 -pack200 \- JAR Packing Tool
84.77 +o
84.78 +pack200(1)
84.79 .TP 2
84.80 -*
84.81 -\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
84.82 +o
84.83 +.na
84.84 +\f2Java SE Documentation\fP @
84.85 +.fi
84.86 +http://java.sun.com/javase/6/docs/index.html
84.87 .TP 2
84.88 -*
84.89 -Java SE Documentation
84.90 -.TP 2
84.91 -*
84.92 +o
84.93 .na
84.94 \f2Java Deployment Guide \- Pack200\fP @
84.95 .fi
84.96 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
84.97 .TP 2
84.98 -*
84.99 -\f2jar\fP \- Java Archive Tool
84.100 +o
84.101 +jar(1) \- Java Archive Tool
84.102 .TP 2
84.103 -*
84.104 -.na
84.105 -\f2jarsigner\fP \- JAR Signer tool @
84.106 -.fi
84.107 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
84.108 +o
84.109 +jarsigner(1) \- JAR Signer tool
84.110 +.TP 2
84.111 +o
84.112 +\f2attributes(5)\fP man page
84.113 .RE
84.114
84.115 .LP
84.116 @@ -184,6 +188,8 @@
84.117 This command should not be confused with \f2unpack(1)\fP. They are distinctly separate products.
84.118 .LP
84.119 .LP
84.120 -The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
84.121 +The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
84.122 +.LP
84.123 +
84.124 .LP
84.125
85.1 --- a/src/linux/doc/man/wsgen.1 Tue May 12 15:21:55 2009 +0900
85.2 +++ b/src/linux/doc/man/wsgen.1 Thu May 14 00:17:25 2009 -0700
85.3 @@ -1,6 +1,4 @@
85.4 -.'" t
85.5 -."
85.6 -." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
85.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
85.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
85.9 ."
85.10 ." This code is free software; you can redistribute it and/or modify it
85.11 @@ -21,44 +19,70 @@
85.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
85.13 ." have any questions.
85.14 ."
85.15 -." `
85.16 -.TH wsgen 1 "07 Aug 2006"
85.17 -." Generated by html2man
85.18 -
85.19 -.LP
85.20 -.SH NAME
85.21 -wsgen \- JAX\-WS 2.0 Beta
85.22 -.LP
85.23 +.TH wsgen 1 "04 May 2009"
85.24 +." Generated from HTML by html2man (author: Eric Armstrong)
85.25 +.SH "Name"
85.26 +wsgen \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
85.27 .RS 3
85.28
85.29 .LP
85.30 .LP
85.31 -The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation.
85.32 +\f3Specification Version:\fP 2.1
85.33 +.br
85.34 +\f3Implementation Version:\fP 2.1.1
85.35 +.LP
85.36 +.LP
85.37 +The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation
85.38 .LP
85.39 .RE
85.40 -.SH "SYNOPSIS"
85.41 +.SH "Overview"
85.42 .LP
85.43 +The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint class and generates all the required artifacts for web service deployment, and invocation. JAXWS 2.1.1 RI also provides a wsgen ant task, see
85.44 +.na
85.45 +\f2Wsgen ant task\fP @
85.46 +.fi
85.47 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.html for details.
85.48 +.LP
85.49 +.SH "Launching wsgen"
85.50 +.RS 3
85.51 +.TP 2
85.52 +o
85.53 +\f3Solaris/Linux\fP
85.54 +.RS 3
85.55 +.TP 2
85.56 +*
85.57 +\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
85.58 +.TP 2
85.59 +*
85.60 +\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
85.61 +.RE
85.62 +.TP 2
85.63 +o
85.64 +\f3Windows\fP
85.65 +.RS 3
85.66 +.TP 2
85.67 +*
85.68 +\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
85.69 +.TP 2
85.70 +*
85.71 +\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
85.72 +.RE
85.73 +.RE
85.74
85.75 .LP
85.76 +.SH "Syntax"
85.77 .nf
85.78 \f3
85.79 .fl
85.80 -wsgen [options] <SEI>
85.81 +wsgen [options] <SEI>\fP
85.82 +.br
85.83 +\f3
85.84 .fl
85.85 \fP
85.86 .fi
85.87 -
85.88 -.LP
85.89 -.SH "OPTIONS"
85.90 -.LP
85.91 .LP
85.92 The following table lists the \f2wsgen\fP options.
85.93 .br
85.94 -
85.95 -.LP
85.96 -.LP
85.97 -Table 1\-1 wsgen Options
85.98 -.LP
85.99 .LP
85.100 .TS
85.101 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
85.102 @@ -208,16 +232,15 @@
85.103 ..
85.104 .ec \
85.105 .eo
85.106 -.am 80
85.107 +.am 81
85.108 .br
85.109 .di i+
85.110 .35
85.111 .ft \n(.f
85.112 .ll \n(34u*1u/3u
85.113 -.if \n(.l<\n(80 .ll \n(80u
85.114 +.if \n(.l<\n(81 .ll \n(81u
85.115 .in 0
85.116 -\f2\-wsdl[:protocol]\fP
85.117 -.br
85.118 +By default \f2wsgen\fP does not generate a WSDL file. This flag is optional and will cause \f2wsgen\fP to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy. The \f2protocol\fP is optional and is used to specify what protocol should be used in the \f2wsdl:binding\fP. Valid protocols include: \f2soap1.1\fP and \f2Xsoap1.2\fP. The default is \f2soap1.1\fP. \f2Xsoap1.2\fP is not standard and can only be used in conjunction with the \f2\-extension\fP option.
85.119 .br
85.120 .di
85.121 .nr i| \n(dn
85.122 @@ -233,8 +256,7 @@
85.123 .ll \n(34u*1u/3u
85.124 .if \n(.l<\n(81 .ll \n(81u
85.125 .in 0
85.126 -By default \f2wsgen\fP does not generate a WSDL file.\ This flag is optional and will cause \f2wsgen\fP to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy.\ The \f2protocol\fP is optional and is used to specify what protocol should be used in the \f2wsdl:binding\fP. Valid protocols include:\ \f2soap1.1\fP and \f2Xsoap1.2\fP.\ The default is \f2soap1.1\fP.\ \f2Xsoap1.2\fP is not standard and can only be used in conjunction with the \f2\-extension\fP option.
85.127 -.br
85.128 +Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:service\fP name to be generated in the WSDL. Example, \f2\-servicename "{http://mynamespace/}MyService"\fP
85.129 .br
85.130 .di
85.131 .nr j| \n(dn
85.132 @@ -250,64 +272,48 @@
85.133 .ll \n(34u*1u/3u
85.134 .if \n(.l<\n(81 .ll \n(81u
85.135 .in 0
85.136 -Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:service\fP name to be generated in the WSDL. Example, \f2\-servicename "{http://mynamespace/}MyService"\fP
85.137 +Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:port\fP name to be generated in the WSDL. Example, \f2\-portname "{http://mynamespace/}MyPort"\fP
85.138 +.br
85.139 .br
85.140 .di
85.141 .nr k| \n(dn
85.142 .nr k- \n(dl
85.143 ..
85.144 .ec \
85.145 -.eo
85.146 -.am 81
85.147 -.br
85.148 -.di l+
85.149 -.35
85.150 -.ft \n(.f
85.151 -.ll \n(34u*1u/3u
85.152 -.if \n(.l<\n(81 .ll \n(81u
85.153 -.in 0
85.154 -Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:port\fP name to be generated in the WSDL. Example, \f2\-portname "{http://mynamespace/}MyPort"\fP
85.155 -.br
85.156 -.br
85.157 -.di
85.158 -.nr l| \n(dn
85.159 -.nr l- \n(dl
85.160 -..
85.161 -.ec \
85.162 .35
85.163 .nf
85.164 .ll \n(34u
85.165 .nr 80 0
85.166 .nr 38 \w\f3Option\fP
85.167 .if \n(80<\n(38 .nr 80 \n(38
85.168 -.nr 38 \w\f2\-classpath <path>\fP
85.169 +.nr 38 \w\f4\-classpath <path>\fP
85.170 .if \n(80<\n(38 .nr 80 \n(38
85.171 -.nr 38 \w\f2\-cp <path>\fP
85.172 +.nr 38 \w\f4\-cp <path>\fP
85.173 .if \n(80<\n(38 .nr 80 \n(38
85.174 -.nr 38 \w\f2\-d <directory>\fP
85.175 +.nr 38 \w\f4\-d <directory>\fP
85.176 .if \n(80<\n(38 .nr 80 \n(38
85.177 -.nr 38 \w\f2\-extension\fP
85.178 +.nr 38 \w\f4\-extension\fP
85.179 .if \n(80<\n(38 .nr 80 \n(38
85.180 -.nr 38 \w\f2\-help\fP
85.181 +.nr 38 \w\f4\-help\fP
85.182 .if \n(80<\n(38 .nr 80 \n(38
85.183 -.nr 38 \w\f2\-keep\fP
85.184 +.nr 38 \w\f4\-keep\fP
85.185 .if \n(80<\n(38 .nr 80 \n(38
85.186 -.nr 38 \w\f2\-r <directory>\fP
85.187 +.nr 38 \w\f4\-r <directory>\fP
85.188 .if \n(80<\n(38 .nr 80 \n(38
85.189 -.nr 38 \w\f2\-s <directory>\fP
85.190 +.nr 38 \w\f4\-s <directory>\fP
85.191 .if \n(80<\n(38 .nr 80 \n(38
85.192 -.nr 38 \w\f2\-verbose\fP
85.193 +.nr 38 \w\f4\-verbose\fP
85.194 .if \n(80<\n(38 .nr 80 \n(38
85.195 -.nr 38 \w\f2\-version\fP
85.196 +.nr 38 \w\f4\-version\fP
85.197 .if \n(80<\n(38 .nr 80 \n(38
85.198 -.nr 38 \w\f2\-servicename <name>\fP
85.199 +.nr 38 \w\f4\-wsdl[:protocol]\fP
85.200 .if \n(80<\n(38 .nr 80 \n(38
85.201 -.nr 38 \w\f2\-portname <name>\fP
85.202 +.nr 38 \w\f4\-servicename <name>\fP
85.203 +.if \n(80<\n(38 .nr 80 \n(38
85.204 +.nr 38 \w\f4\-portname <name>\fP
85.205 .if \n(80<\n(38 .nr 80 \n(38
85.206 .80
85.207 .rm 80
85.208 -.nr 38 \n(i-
85.209 -.if \n(80<\n(38 .nr 80 \n(38
85.210 .nr 81 0
85.211 .nr 38 \w\f3Description\fP
85.212 .if \n(81<\n(38 .nr 81 \n(38
85.213 @@ -333,12 +339,12 @@
85.214 .if \n(81<\n(38 .nr 81 \n(38
85.215 .nr 38 \n(h-
85.216 .if \n(81<\n(38 .nr 81 \n(38
85.217 +.nr 38 \n(i-
85.218 +.if \n(81<\n(38 .nr 81 \n(38
85.219 .nr 38 \n(j-
85.220 .if \n(81<\n(38 .nr 81 \n(38
85.221 .nr 38 \n(k-
85.222 .if \n(81<\n(38 .nr 81 \n(38
85.223 -.nr 38 \n(l-
85.224 -.if \n(81<\n(38 .nr 81 \n(38
85.225 .35
85.226 .nf
85.227 .ll \n(34u
85.228 @@ -349,7 +355,7 @@
85.229 .nr 41 \n(80+(3*\n(38)
85.230 .nr 81 +\n(41
85.231 .nr TW \n(81
85.232 -.if t .if \n(TW>\n(.li .tm Table at line 100 file Input is too wide - \n(TW units
85.233 +.if t .if \n(TW>\n(.li .tm Table at line 140 file Input is too wide - \n(TW units
85.234 .fc
85.235 .nr #T 0-1
85.236 .nr #a 0-1
85.237 @@ -372,7 +378,7 @@
85.238 .ta \n(80u \n(81u
85.239 .nr 31 \n(.f
85.240 .nr 35 1m
85.241 -\&\h'|\n(40u'\f2\-classpath <path>\fP\h'|\n(41u'
85.242 +\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
85.243 .mk ##
85.244 .nr 31 \n(##
85.245 .sp |\n(##u-1v
85.246 @@ -388,7 +394,7 @@
85.247 .ta \n(80u \n(81u
85.248 .nr 31 \n(.f
85.249 .nr 35 1m
85.250 -\&\h'|\n(40u'\f2\-cp <path>\fP\h'|\n(41u'
85.251 +\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
85.252 .mk ##
85.253 .nr 31 \n(##
85.254 .sp |\n(##u-1v
85.255 @@ -404,7 +410,7 @@
85.256 .ta \n(80u \n(81u
85.257 .nr 31 \n(.f
85.258 .nr 35 1m
85.259 -\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
85.260 +\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
85.261 .mk ##
85.262 .nr 31 \n(##
85.263 .sp |\n(##u-1v
85.264 @@ -420,7 +426,7 @@
85.265 .ta \n(80u \n(81u
85.266 .nr 31 \n(.f
85.267 .nr 35 1m
85.268 -\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
85.269 +\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
85.270 .mk ##
85.271 .nr 31 \n(##
85.272 .sp |\n(##u-1v
85.273 @@ -434,17 +440,17 @@
85.274 .ta \n(80u \n(81u
85.275 .nr 31 \n(.f
85.276 .nr 35 1m
85.277 -\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
85.278 +\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'Display help
85.279 .ta \n(80u \n(81u
85.280 .nr 31 \n(.f
85.281 .nr 35 1m
85.282 -\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
85.283 +\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'Keep generated files
85.284 .ne \n(e|u+\n(.Vu
85.285 .if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
85.286 .ta \n(80u \n(81u
85.287 .nr 31 \n(.f
85.288 .nr 35 1m
85.289 -\&\h'|\n(40u'\f2\-r <directory>\fP\h'|\n(41u'
85.290 +\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
85.291 .mk ##
85.292 .nr 31 \n(##
85.293 .sp |\n(##u-1v
85.294 @@ -460,7 +466,7 @@
85.295 .ta \n(80u \n(81u
85.296 .nr 31 \n(.f
85.297 .nr 35 1m
85.298 -\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
85.299 +\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
85.300 .mk ##
85.301 .nr 31 \n(##
85.302 .sp |\n(##u-1v
85.303 @@ -476,7 +482,7 @@
85.304 .ta \n(80u \n(81u
85.305 .nr 31 \n(.f
85.306 .nr 35 1m
85.307 -\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
85.308 +\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
85.309 .mk ##
85.310 .nr 31 \n(##
85.311 .sp |\n(##u-1v
85.312 @@ -492,7 +498,7 @@
85.313 .ta \n(80u \n(81u
85.314 .nr 31 \n(.f
85.315 .nr 35 1m
85.316 -\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
85.317 +\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
85.318 .mk ##
85.319 .nr 31 \n(##
85.320 .sp |\n(##u-1v
85.321 @@ -504,22 +510,29 @@
85.322 .if \n(32>\n(31 .nr 31 \n(32
85.323 .sp |\n(31u
85.324 .ne \n(i|u+\n(.Vu
85.325 -.ne \n(j|u+\n(.Vu
85.326 .if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
85.327 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
85.328 .ta \n(80u \n(81u
85.329 .nr 31 \n(.f
85.330 .nr 35 1m
85.331 -\&\h'|\n(40u'\h'|\n(41u'
85.332 +\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
85.333 .mk ##
85.334 .nr 31 \n(##
85.335 .sp |\n(##u-1v
85.336 -.nr 37 \n(40u
85.337 +.nr 37 \n(41u
85.338 .in +\n(37u
85.339 .i+
85.340 .in -\n(37u
85.341 .mk 32
85.342 .if \n(32>\n(31 .nr 31 \n(32
85.343 +.sp |\n(31u
85.344 +.ne \n(j|u+\n(.Vu
85.345 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
85.346 +.ta \n(80u \n(81u
85.347 +.nr 31 \n(.f
85.348 +.nr 35 1m
85.349 +\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
85.350 +.mk ##
85.351 +.nr 31 \n(##
85.352 .sp |\n(##u-1v
85.353 .nr 37 \n(41u
85.354 .in +\n(37u
85.355 @@ -533,7 +546,7 @@
85.356 .ta \n(80u \n(81u
85.357 .nr 31 \n(.f
85.358 .nr 35 1m
85.359 -\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
85.360 +\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
85.361 .mk ##
85.362 .nr 31 \n(##
85.363 .sp |\n(##u-1v
85.364 @@ -544,22 +557,6 @@
85.365 .mk 32
85.366 .if \n(32>\n(31 .nr 31 \n(32
85.367 .sp |\n(31u
85.368 -.ne \n(l|u+\n(.Vu
85.369 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
85.370 -.ta \n(80u \n(81u
85.371 -.nr 31 \n(.f
85.372 -.nr 35 1m
85.373 -\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
85.374 -.mk ##
85.375 -.nr 31 \n(##
85.376 -.sp |\n(##u-1v
85.377 -.nr 37 \n(41u
85.378 -.in +\n(37u
85.379 -.l+
85.380 -.in -\n(37u
85.381 -.mk 32
85.382 -.if \n(32>\n(31 .nr 31 \n(32
85.383 -.sp |\n(31u
85.384 .fc
85.385 .nr T. 1
85.386 .T# 1
85.387 @@ -575,688 +572,34 @@
85.388 .rm i+
85.389 .rm j+
85.390 .rm k+
85.391 -.rm l+
85.392 .TE
85.393 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
85.394 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-53
85.395
85.396 .LP
85.397 -.SS
85.398 -Ant task
85.399 -.LP
85.400 -.LP
85.401 -An Ant task for the \f2wsgen\fP tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
85.402 -.LP
85.403 +.SH "Example"
85.404 .nf
85.405 \f3
85.406 .fl
85.407 -
85.408 +\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
85.409 .fl
85.410 - <wsgen
85.411 -.fl
85.412 - sei="..."
85.413 -.fl
85.414 - destdir="directory for generated class files"
85.415 -.fl
85.416 - classpath="classpath" | cp="classpath"
85.417 -.fl
85.418 - resourcedestdir="directory for generated resource files such as WSDLs"
85.419 -.fl
85.420 - sourcedestdir="directory for generated source files"
85.421 -.fl
85.422 - keep="true|false"
85.423 -.fl
85.424 - verbose="true|false"
85.425 -.fl
85.426 - genwsdl="true|false"
85.427 -.fl
85.428 - protocol="soap1.1|Xsoap1.2"
85.429 -.fl
85.430 - servicename="..."
85.431 -.fl
85.432 - portname="...">
85.433 -.fl
85.434 - extension="true|false"
85.435 -.fl
85.436 - <classpath refid="..."/>
85.437 -.fl
85.438 - </wsgen>
85.439 -.fl
85.440 -\fP
85.441 .fi
85.442 -
85.443 .LP
85.444 -.LP
85.445 -.TS
85.446 -.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
85.447 -.de 35
85.448 -.ps \n(.s
85.449 -.vs \n(.vu
85.450 -.in \n(.iu
85.451 -.if \n(.u .fi
85.452 -.if \n(.j .ad
85.453 -.if \n(.j=0 .na
85.454 -..
85.455 -.nf
85.456 -.nr #~ 0
85.457 -.if n .nr #~ 0.6n
85.458 -.ds #d .d
85.459 -.if \(ts\n(.z\(ts\(ts .ds #d nl
85.460 -.fc
85.461 -.nr 33 \n(.s
85.462 -.rm 80 81 82
85.463 -.nr 34 \n(.lu
85.464 -.eo
85.465 -.am 81
85.466 -.br
85.467 -.di a+
85.468 -.35
85.469 -.ft \n(.f
85.470 -.ll \n(34u*1u/4u
85.471 -.if \n(.l<\n(81 .ll \n(81u
85.472 -.in 0
85.473 -Name of the service endpoint implementation class
85.474 -.br
85.475 -.di
85.476 -.nr a| \n(dn
85.477 -.nr a- \n(dl
85.478 -..
85.479 -.ec \
85.480 -.eo
85.481 -.am 81
85.482 -.br
85.483 -.di b+
85.484 -.35
85.485 -.ft \n(.f
85.486 -.ll \n(34u*1u/4u
85.487 -.if \n(.l<\n(81 .ll \n(81u
85.488 -.in 0
85.489 -Specify where to place output generated classes
85.490 -.br
85.491 -.di
85.492 -.nr b| \n(dn
85.493 -.nr b- \n(dl
85.494 -..
85.495 -.ec \
85.496 -.eo
85.497 -.am 81
85.498 -.br
85.499 -.di c+
85.500 -.35
85.501 -.ft \n(.f
85.502 -.ll \n(34u*1u/4u
85.503 -.if \n(.l<\n(81 .ll \n(81u
85.504 -.in 0
85.505 -Specify where to find input class files
85.506 -.br
85.507 -.di
85.508 -.nr c| \n(dn
85.509 -.nr c- \n(dl
85.510 -..
85.511 -.ec \
85.512 -.eo
85.513 -.am 81
85.514 -.br
85.515 -.di d+
85.516 -.35
85.517 -.ft \n(.f
85.518 -.ll \n(34u*1u/4u
85.519 -.if \n(.l<\n(81 .ll \n(81u
85.520 -.in 0
85.521 -Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
85.522 -.br
85.523 -.di
85.524 -.nr d| \n(dn
85.525 -.nr d- \n(dl
85.526 -..
85.527 -.ec \
85.528 -.eo
85.529 -.am 81
85.530 -.br
85.531 -.di e+
85.532 -.35
85.533 -.ft \n(.f
85.534 -.ll \n(34u*1u/4u
85.535 -.if \n(.l<\n(81 .ll \n(81u
85.536 -.in 0
85.537 -Specify where to place generated source files
85.538 -.br
85.539 -.di
85.540 -.nr e| \n(dn
85.541 -.nr e- \n(dl
85.542 -..
85.543 -.ec \
85.544 -.eo
85.545 -.am 81
85.546 -.br
85.547 -.di f+
85.548 -.35
85.549 -.ft \n(.f
85.550 -.ll \n(34u*1u/4u
85.551 -.if \n(.l<\n(81 .ll \n(81u
85.552 -.in 0
85.553 -Output messages about what the compiler is doing
85.554 -.br
85.555 -.di
85.556 -.nr f| \n(dn
85.557 -.nr f- \n(dl
85.558 -..
85.559 -.ec \
85.560 -.eo
85.561 -.am 81
85.562 -.br
85.563 -.di g+
85.564 -.35
85.565 -.ft \n(.f
85.566 -.ll \n(34u*1u/4u
85.567 -.if \n(.l<\n(81 .ll \n(81u
85.568 -.in 0
85.569 -Specify that a WSDL file should be generated
85.570 -.br
85.571 -.di
85.572 -.nr g| \n(dn
85.573 -.nr g- \n(dl
85.574 -..
85.575 -.ec \
85.576 -.eo
85.577 -.am 81
85.578 -.br
85.579 -.di h+
85.580 -.35
85.581 -.ft \n(.f
85.582 -.ll \n(34u*1u/4u
85.583 -.if \n(.l<\n(81 .ll \n(81u
85.584 -.in 0
85.585 -Used in conjunction with \f2genwsdl\fP to specify the protocol to use in the \f2wsdl:binding\fP.\ Value values are \f2"soap1.1"\fP or \f2"Xsoap1.2"\fP, default is \f2"soap1.1".\fP\f2"Xsoap1.2"\fP is not standard and can only be used in conjunction with the \-extensions option
85.586 -.br
85.587 -.br
85.588 -.di
85.589 -.nr h| \n(dn
85.590 -.nr h- \n(dl
85.591 -..
85.592 -.ec \
85.593 -.eo
85.594 -.am 82
85.595 -.br
85.596 -.di i+
85.597 -.35
85.598 -.ft \n(.f
85.599 -.ll \n(34u*1u/4u
85.600 -.if \n(.l<\n(82 .ll \n(82u
85.601 -.in 0
85.602 -\f2\-wsdl:soap11\fP
85.603 -.br
85.604 -.br
85.605 -.di
85.606 -.nr i| \n(dn
85.607 -.nr i- \n(dl
85.608 -..
85.609 -.ec \
85.610 -.eo
85.611 -.am 81
85.612 -.br
85.613 -.di j+
85.614 -.35
85.615 -.ft \n(.f
85.616 -.ll \n(34u*1u/4u
85.617 -.if \n(.l<\n(81 .ll \n(81u
85.618 -.in 0
85.619 -Used in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:service\fP name for the generated WSDL.Example, \f2servicename="{http://mynamespace/}MyService"\fP
85.620 -.br
85.621 -.br
85.622 -.di
85.623 -.nr j| \n(dn
85.624 -.nr j- \n(dl
85.625 -..
85.626 -.ec \
85.627 -.eo
85.628 -.am 81
85.629 -.br
85.630 -.di k+
85.631 -.35
85.632 -.ft \n(.f
85.633 -.ll \n(34u*1u/4u
85.634 -.if \n(.l<\n(81 .ll \n(81u
85.635 -.in 0
85.636 -Used in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:portmame\fP name for the generated WSDL. Example, \f2portname="{http://mynamespace/}MyPort"\fP
85.637 -.br
85.638 -.br
85.639 -.di
85.640 -.nr k| \n(dn
85.641 -.nr k- \n(dl
85.642 -..
85.643 -.ec \
85.644 -.eo
85.645 -.am 81
85.646 -.br
85.647 -.di l+
85.648 -.35
85.649 -.ft \n(.f
85.650 -.ll \n(34u*1u/4u
85.651 -.if \n(.l<\n(81 .ll \n(81u
85.652 -.in 0
85.653 -allow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
85.654 -.br
85.655 -.di
85.656 -.nr l| \n(dn
85.657 -.nr l- \n(dl
85.658 -..
85.659 -.ec \
85.660 -.35
85.661 -.nf
85.662 -.ll \n(34u
85.663 -.nr 80 0
85.664 -.nr 38 \w\f3Attribute\fP
85.665 -.if \n(80<\n(38 .nr 80 \n(38
85.666 -.nr 38 \w\f2sei\fP
85.667 -.if \n(80<\n(38 .nr 80 \n(38
85.668 -.nr 38 \w\f2destdir\fP
85.669 -.if \n(80<\n(38 .nr 80 \n(38
85.670 -.nr 38 \w\f2classpath\fP
85.671 -.if \n(80<\n(38 .nr 80 \n(38
85.672 -.nr 38 \w\f2cp\fP
85.673 -.if \n(80<\n(38 .nr 80 \n(38
85.674 -.nr 38 \w\f2resourcedestdir\fP
85.675 -.if \n(80<\n(38 .nr 80 \n(38
85.676 -.nr 38 \w\f2sourcedestdir\fP
85.677 -.if \n(80<\n(38 .nr 80 \n(38
85.678 -.nr 38 \w\f2keep\fP
85.679 -.if \n(80<\n(38 .nr 80 \n(38
85.680 -.nr 38 \w\f2verbose\fP
85.681 -.if \n(80<\n(38 .nr 80 \n(38
85.682 -.nr 38 \w\f2genwsdl\fP
85.683 -.if \n(80<\n(38 .nr 80 \n(38
85.684 -.nr 38 \w\f2protocol\fP
85.685 -.if \n(80<\n(38 .nr 80 \n(38
85.686 -.nr 38 \w\f2servicename\fP
85.687 -.if \n(80<\n(38 .nr 80 \n(38
85.688 -.nr 38 \w\f2portname\fP
85.689 -.if \n(80<\n(38 .nr 80 \n(38
85.690 -.nr 38 \w\f2extension\fP
85.691 -.if \n(80<\n(38 .nr 80 \n(38
85.692 -.80
85.693 -.rm 80
85.694 -.nr 81 0
85.695 -.nr 38 \w\f3Description\fP
85.696 -.if \n(81<\n(38 .nr 81 \n(38
85.697 -.nr 38 \wSame as \f2\-classpath\fP
85.698 -.if \n(81<\n(38 .nr 81 \n(38
85.699 -.nr 38 \wKeep generated files
85.700 -.if \n(81<\n(38 .nr 81 \n(38
85.701 -.81
85.702 -.rm 81
85.703 -.nr 38 \n(a-
85.704 -.if \n(81<\n(38 .nr 81 \n(38
85.705 -.nr 38 \n(b-
85.706 -.if \n(81<\n(38 .nr 81 \n(38
85.707 -.nr 38 \n(c-
85.708 -.if \n(81<\n(38 .nr 81 \n(38
85.709 -.nr 38 \n(d-
85.710 -.if \n(81<\n(38 .nr 81 \n(38
85.711 -.nr 38 \n(e-
85.712 -.if \n(81<\n(38 .nr 81 \n(38
85.713 -.nr 38 \n(f-
85.714 -.if \n(81<\n(38 .nr 81 \n(38
85.715 -.nr 38 \n(g-
85.716 -.if \n(81<\n(38 .nr 81 \n(38
85.717 -.nr 38 \n(h-
85.718 -.if \n(81<\n(38 .nr 81 \n(38
85.719 -.nr 38 \n(j-
85.720 -.if \n(81<\n(38 .nr 81 \n(38
85.721 -.nr 38 \n(k-
85.722 -.if \n(81<\n(38 .nr 81 \n(38
85.723 -.nr 38 \n(l-
85.724 -.if \n(81<\n(38 .nr 81 \n(38
85.725 -.nr 82 0
85.726 -.nr 38 \w\f3Command line\fP
85.727 -.if \n(82<\n(38 .nr 82 \n(38
85.728 -.nr 38 \wSEI
85.729 -.if \n(82<\n(38 .nr 82 \n(38
85.730 -.nr 38 \w\f2\-d\fP
85.731 -.if \n(82<\n(38 .nr 82 \n(38
85.732 -.nr 38 \w\f2\-classpath\fP
85.733 -.if \n(82<\n(38 .nr 82 \n(38
85.734 -.nr 38 \w\f2\-cp\fP
85.735 -.if \n(82<\n(38 .nr 82 \n(38
85.736 -.nr 38 \w\f2\-r\fP
85.737 -.if \n(82<\n(38 .nr 82 \n(38
85.738 -.nr 38 \w\f2\-s\fP
85.739 -.if \n(82<\n(38 .nr 82 \n(38
85.740 -.nr 38 \w\f2\-keep\fP
85.741 -.if \n(82<\n(38 .nr 82 \n(38
85.742 -.nr 38 \w\f2\-verbose\fP
85.743 -.if \n(82<\n(38 .nr 82 \n(38
85.744 -.nr 38 \w\f2\-wsdl\fP
85.745 -.if \n(82<\n(38 .nr 82 \n(38
85.746 -.nr 38 \w\f2\-servicename\fP
85.747 -.if \n(82<\n(38 .nr 82 \n(38
85.748 -.nr 38 \w\f2\-servicename\fP
85.749 -.if \n(82<\n(38 .nr 82 \n(38
85.750 -.nr 38 \w\f2\-extension\fP
85.751 -.if \n(82<\n(38 .nr 82 \n(38
85.752 -.82
85.753 -.rm 82
85.754 -.nr 38 \n(i-
85.755 -.if \n(82<\n(38 .nr 82 \n(38
85.756 -.35
85.757 -.nf
85.758 -.ll \n(34u
85.759 -.nr 38 1n
85.760 -.nr 79 0
85.761 -.nr 40 \n(79+(0*\n(38)
85.762 -.nr 80 +\n(40
85.763 -.nr 41 \n(80+(3*\n(38)
85.764 -.nr 81 +\n(41
85.765 -.nr 42 \n(81+(3*\n(38)
85.766 -.nr 82 +\n(42
85.767 -.nr TW \n(82
85.768 -.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
85.769 -.fc
85.770 -.nr #T 0-1
85.771 -.nr #a 0-1
85.772 -.eo
85.773 -.de T#
85.774 -.ds #d .d
85.775 -.if \(ts\n(.z\(ts\(ts .ds #d nl
85.776 -.mk ##
85.777 -.nr ## -1v
85.778 -.ls 1
85.779 -.ls
85.780 -..
85.781 -.ec
85.782 -.ta \n(80u \n(81u \n(82u
85.783 -.nr 31 \n(.f
85.784 -.nr 35 1m
85.785 -\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
85.786 -.ne \n(a|u+\n(.Vu
85.787 -.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
85.788 -.ta \n(80u \n(81u \n(82u
85.789 -.nr 31 \n(.f
85.790 -.nr 35 1m
85.791 -\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
85.792 -.mk ##
85.793 -.nr 31 \n(##
85.794 -.sp |\n(##u-1v
85.795 -.nr 37 \n(41u
85.796 -.in +\n(37u
85.797 -.a+
85.798 -.in -\n(37u
85.799 -.mk 32
85.800 -.if \n(32>\n(31 .nr 31 \n(32
85.801 -.sp |\n(31u
85.802 -.ne \n(b|u+\n(.Vu
85.803 -.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
85.804 -.ta \n(80u \n(81u \n(82u
85.805 -.nr 31 \n(.f
85.806 -.nr 35 1m
85.807 -\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
85.808 -.mk ##
85.809 -.nr 31 \n(##
85.810 -.sp |\n(##u-1v
85.811 -.nr 37 \n(41u
85.812 -.in +\n(37u
85.813 -.b+
85.814 -.in -\n(37u
85.815 -.mk 32
85.816 -.if \n(32>\n(31 .nr 31 \n(32
85.817 -.sp |\n(31u
85.818 -.ne \n(c|u+\n(.Vu
85.819 -.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
85.820 -.ta \n(80u \n(81u \n(82u
85.821 -.nr 31 \n(.f
85.822 -.nr 35 1m
85.823 -\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
85.824 -.mk ##
85.825 -.nr 31 \n(##
85.826 -.sp |\n(##u-1v
85.827 -.nr 37 \n(41u
85.828 -.in +\n(37u
85.829 -.c+
85.830 -.in -\n(37u
85.831 -.mk 32
85.832 -.if \n(32>\n(31 .nr 31 \n(32
85.833 -.sp |\n(31u
85.834 -.ta \n(80u \n(81u \n(82u
85.835 -.nr 31 \n(.f
85.836 -.nr 35 1m
85.837 -\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
85.838 -.ne \n(d|u+\n(.Vu
85.839 -.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
85.840 -.ta \n(80u \n(81u \n(82u
85.841 -.nr 31 \n(.f
85.842 -.nr 35 1m
85.843 -\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
85.844 -.mk ##
85.845 -.nr 31 \n(##
85.846 -.sp |\n(##u-1v
85.847 -.nr 37 \n(41u
85.848 -.in +\n(37u
85.849 -.d+
85.850 -.in -\n(37u
85.851 -.mk 32
85.852 -.if \n(32>\n(31 .nr 31 \n(32
85.853 -.sp |\n(31u
85.854 -.ne \n(e|u+\n(.Vu
85.855 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
85.856 -.ta \n(80u \n(81u \n(82u
85.857 -.nr 31 \n(.f
85.858 -.nr 35 1m
85.859 -\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
85.860 -.mk ##
85.861 -.nr 31 \n(##
85.862 -.sp |\n(##u-1v
85.863 -.nr 37 \n(41u
85.864 -.in +\n(37u
85.865 -.e+
85.866 -.in -\n(37u
85.867 -.mk 32
85.868 -.if \n(32>\n(31 .nr 31 \n(32
85.869 -.sp |\n(31u
85.870 -.ta \n(80u \n(81u \n(82u
85.871 -.nr 31 \n(.f
85.872 -.nr 35 1m
85.873 -\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
85.874 -.ne \n(f|u+\n(.Vu
85.875 -.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
85.876 -.ta \n(80u \n(81u \n(82u
85.877 -.nr 31 \n(.f
85.878 -.nr 35 1m
85.879 -\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
85.880 -.mk ##
85.881 -.nr 31 \n(##
85.882 -.sp |\n(##u-1v
85.883 -.nr 37 \n(41u
85.884 -.in +\n(37u
85.885 -.f+
85.886 -.in -\n(37u
85.887 -.mk 32
85.888 -.if \n(32>\n(31 .nr 31 \n(32
85.889 -.sp |\n(31u
85.890 -.ta \n(80u \n(81u \n(82u
85.891 -.nr 31 \n(.f
85.892 -.nr 35 1m
85.893 -\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
85.894 -.br
85.895 -.ne \n(g|u+\n(.Vu
85.896 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
85.897 -.ta \n(80u \n(81u \n(82u
85.898 -.nr 31 \n(.f
85.899 -.nr 35 1m
85.900 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
85.901 -.mk ##
85.902 -.nr 31 \n(##
85.903 -.sp |\n(##u-1v
85.904 -.nr 37 \n(41u
85.905 -.in +\n(37u
85.906 -.g+
85.907 -.in -\n(37u
85.908 -.mk 32
85.909 -.if \n(32>\n(31 .nr 31 \n(32
85.910 -.sp |\n(31u
85.911 -.ta \n(80u \n(81u \n(82u
85.912 -.nr 31 \n(.f
85.913 -.nr 35 1m
85.914 -\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
85.915 -.br
85.916 -.ne \n(h|u+\n(.Vu
85.917 -.ne \n(i|u+\n(.Vu
85.918 -.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
85.919 -.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
85.920 -.ta \n(80u \n(81u \n(82u
85.921 -.nr 31 \n(.f
85.922 -.nr 35 1m
85.923 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
85.924 -.mk ##
85.925 -.nr 31 \n(##
85.926 -.sp |\n(##u-1v
85.927 -.nr 37 \n(41u
85.928 -.in +\n(37u
85.929 -.h+
85.930 -.in -\n(37u
85.931 -.mk 32
85.932 -.if \n(32>\n(31 .nr 31 \n(32
85.933 -.sp |\n(##u-1v
85.934 -.nr 37 \n(42u
85.935 -.in +\n(37u
85.936 -.i+
85.937 -.in -\n(37u
85.938 -.mk 32
85.939 -.if \n(32>\n(31 .nr 31 \n(32
85.940 -.sp |\n(31u
85.941 -.ta \n(80u \n(81u \n(82u
85.942 -.nr 31 \n(.f
85.943 -.nr 35 1m
85.944 -\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
85.945 -.br
85.946 -.ne \n(j|u+\n(.Vu
85.947 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
85.948 -.ta \n(80u \n(81u \n(82u
85.949 -.nr 31 \n(.f
85.950 -.nr 35 1m
85.951 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
85.952 -.mk ##
85.953 -.nr 31 \n(##
85.954 -.sp |\n(##u-1v
85.955 -.nr 37 \n(41u
85.956 -.in +\n(37u
85.957 -.j+
85.958 -.in -\n(37u
85.959 -.mk 32
85.960 -.if \n(32>\n(31 .nr 31 \n(32
85.961 -.sp |\n(31u
85.962 -.ta \n(80u \n(81u \n(82u
85.963 -.nr 31 \n(.f
85.964 -.nr 35 1m
85.965 -\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
85.966 -.br
85.967 -.ne \n(k|u+\n(.Vu
85.968 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
85.969 -.ta \n(80u \n(81u \n(82u
85.970 -.nr 31 \n(.f
85.971 -.nr 35 1m
85.972 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
85.973 -.mk ##
85.974 -.nr 31 \n(##
85.975 -.sp |\n(##u-1v
85.976 -.nr 37 \n(41u
85.977 -.in +\n(37u
85.978 -.k+
85.979 -.in -\n(37u
85.980 -.mk 32
85.981 -.if \n(32>\n(31 .nr 31 \n(32
85.982 -.sp |\n(31u
85.983 -.ta \n(80u \n(81u \n(82u
85.984 -.nr 31 \n(.f
85.985 -.nr 35 1m
85.986 -\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
85.987 -.br
85.988 -.ne \n(l|u+\n(.Vu
85.989 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
85.990 -.ta \n(80u \n(81u \n(82u
85.991 -.nr 31 \n(.f
85.992 -.nr 35 1m
85.993 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
85.994 -.mk ##
85.995 -.nr 31 \n(##
85.996 -.sp |\n(##u-1v
85.997 -.nr 37 \n(41u
85.998 -.in +\n(37u
85.999 -.l+
85.1000 -.in -\n(37u
85.1001 -.mk 32
85.1002 -.if \n(32>\n(31 .nr 31 \n(32
85.1003 -.sp |\n(31u
85.1004 -.fc
85.1005 -.nr T. 1
85.1006 -.T# 1
85.1007 -.35
85.1008 -.rm a+
85.1009 -.rm b+
85.1010 -.rm c+
85.1011 -.rm d+
85.1012 -.rm e+
85.1013 -.rm f+
85.1014 -.rm g+
85.1015 -.rm h+
85.1016 -.rm i+
85.1017 -.rm j+
85.1018 -.rm k+
85.1019 -.rm l+
85.1020 -.TE
85.1021 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
85.1022 -
85.1023 -.LP
85.1024 -.LP
85.1025 -The \f2classpath\fP attribute is a
85.1026 -.na
85.1027 -\f2path\-like structure\fP @
85.1028 -.fi
85.1029 -http://ant.apache.org/manual/using.html#path and can also be set via nested \f2<classpath>\fP elements. Before this task can be used, a \f2<taskdef>\fP element needs to be added to the project as given below:
85.1030 -.LP
85.1031 +This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside \f3stock\fPdirectory.
85.1032 .nf
85.1033 \f3
85.1034 .fl
85.1035 - <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">\fP
85.1036 -.br
85.1037 -\f3
85.1038 +\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
85.1039 .fl
85.1040 - <classpath path="jaxws.classpath"/>\fP
85.1041 -.br
85.1042 -\f3
85.1043 -.fl
85.1044 - </taskdef>
85.1045 -.fl
85.1046 -\fP
85.1047 .fi
85.1048 -
85.1049 .LP
85.1050 -.LP
85.1051 -where \f2jaxws.classpath\fP is a reference to a
85.1052 -.na
85.1053 -\f2path\-like structure\fP @
85.1054 -.fi
85.1055 -http://ant.apache.org/manual/using.html#path, defined elsewhere in the build environment, and contains the list of classes required by the JAX\-WS tools.
85.1056 -.LP
85.1057 -.SH "Example"
85.1058 -.LP
85.1059 -
85.1060 -.LP
85.1061 +This will generate a SOAP 1.1 WSDL and schema for your Java class stock.StockService annotated with @WebService annotation.
85.1062 .nf
85.1063 \f3
85.1064 .fl
85.1065 -<wsgen
85.1066 +\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
85.1067 .fl
85.1068 - resourcedestdir="${wsdl.dir}"
85.1069 -.fl
85.1070 - sei="fromjava.server.AddNumbersImpl">
85.1071 -.fl
85.1072 - <classpath refid="compile.classpath"/>
85.1073 -.fl
85.1074 -</wsgen>
85.1075 -.fl
85.1076 -\fP
85.1077 .fi
85.1078 -
85.1079 .LP
85.1080 -
85.1081 +Will generate a SOAP 1.2 WSDL.
85.1082 .LP
85.1083 -
85.1084 +Note that you do not have to generate WSDL at the development time as JAXWS runtime will automatically generate a WSDL for you when you deploy your service.
86.1 --- a/src/linux/doc/man/wsimport.1 Tue May 12 15:21:55 2009 +0900
86.2 +++ b/src/linux/doc/man/wsimport.1 Thu May 14 00:17:25 2009 -0700
86.3 @@ -1,6 +1,4 @@
86.4 -.'" t
86.5 -."
86.6 -." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
86.7 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
86.8 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
86.9 ."
86.10 ." This code is free software; you can redistribute it and/or modify it
86.11 @@ -21,32 +19,18 @@
86.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
86.13 ." have any questions.
86.14 ."
86.15 -." `
86.16 -.TH wsimport 1 "07 Aug 2006"
86.17 -." Generated by html2man
86.18 -
86.19 +.TH wsimport 1 "04 May 2009"
86.20 +." Generated from HTML by html2man (author: Eric Armstrong)
86.21 +.SH "Name"
86.22 +wsimport \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
86.23 .LP
86.24 -.SH NAME
86.25 -wsimport \- JAX\-WS 2.0 Beta
86.26 -.LP
86.27 -.SH "SYNOPSIS"
86.28 -.LP
86.29 -
86.30 -.LP
86.31 -.nf
86.32 -\f3
86.33 -.fl
86.34 -wsimport [options] <wsdl>
86.35 -.fl
86.36 -\fP
86.37 -.fi
86.38 -
86.39 -.LP
86.40 -.SH "DESCRIPTION"
86.41 -.LP
86.42 +\f3Specification Version:\fP 2.1
86.43 +.br
86.44 +\f3Implementation Version:\fP 2.1.1
86.45 +.br
86.46 +.SH "Overview"
86.47 .LP
86.48 The \f2wsimport\fP tool generates JAX\-WS portable artifacts, such as:
86.49 -.LP
86.50 .RS 3
86.51 .TP 2
86.52 o
86.53 @@ -64,28 +48,46 @@
86.54 o
86.55 JAXB generated value types (mapped java classes from schema types)
86.56 .RE
86.57 -
86.58 .LP
86.59 -.LP
86.60 -These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed.
86.61 +These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed. also provides wsimport ant task, see
86.62 +.na
86.63 +\f2Wsimport ant task\fP @
86.64 +.fi
86.65 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.html.
86.66 .br
86.67
86.68 .LP
86.69 -.LP
86.70 -wsimport tool can be launched using the command line script wsimport.sh (Unix) or wsimport.bat(windows). There is also and ant task to import and compile the wsdl, see the details below.
86.71 -.br
86.72 +.SH "Launching wsimport"
86.73 +.RS 3
86.74 +.TP 2
86.75 +o
86.76 +\f3Solaris/Linux\fP
86.77 +.RS 3
86.78 +.TP 2
86.79 +*
86.80 +\f2/bin/wsimport.sh \-help\fP
86.81 +.RE
86.82 +.TP 2
86.83 +o
86.84 +\f3Windows\fP
86.85 +.RS 3
86.86 +.TP 2
86.87 +*
86.88 +\f2\\bin\\wsimport.bat \-help\fP
86.89 +.RE
86.90 +.RE
86.91
86.92 .LP
86.93 -.SH "OPTIONS"
86.94 -.LP
86.95 +.SH "Syntax"
86.96 +.nf
86.97 +\f3
86.98 +.fl
86.99 +wsimport [options] <wsdl>
86.100 +.fl
86.101 +\fP
86.102 +.fi
86.103 .LP
86.104 The following table lists the \f2wsimport\fP options.
86.105 -.br
86.106 -
86.107 -.LP
86.108 -.LP
86.109 -Table 1\-1 wsimport Options
86.110 -.LP
86.111 .LP
86.112 .TS
86.113 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
86.114 @@ -147,7 +149,7 @@
86.115 .ll \n(34u*1u/3u
86.116 .if \n(.l<\n(81 .ll \n(81u
86.117 .in 0
86.118 -Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the XML Entity and URI Resolvers document or see \f3wsimport_catalog\fP sample.
86.119 +Pass this option to JAXB schema compiler
86.120 .br
86.121 .di
86.122 .nr c| \n(dn
86.123 @@ -163,7 +165,11 @@
86.124 .ll \n(34u*1u/3u
86.125 .if \n(.l<\n(81 .ll \n(81u
86.126 .in 0
86.127 -allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
86.128 +Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the documentation of
86.129 +.na
86.130 +\f2catalog\fP @
86.131 +.fi
86.132 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.html and see \f3catalog\fP sample.
86.133 .br
86.134 .di
86.135 .nr d| \n(dn
86.136 @@ -171,15 +177,15 @@
86.137 ..
86.138 .ec \
86.139 .eo
86.140 -.am 80
86.141 +.am 81
86.142 .br
86.143 .di e+
86.144 .35
86.145 .ft \n(.f
86.146 .ll \n(34u*1u/3u
86.147 -.if \n(.l<\n(80 .ll \n(80u
86.148 +.if \n(.l<\n(81 .ll \n(81u
86.149 .in 0
86.150 -\f2\-httpproxy:<host>:<port>\fP
86.151 +Allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
86.152 .br
86.153 .di
86.154 .nr e| \n(dn
86.155 @@ -187,15 +193,15 @@
86.156 ..
86.157 .ec \
86.158 .eo
86.159 -.am 81
86.160 +.am 80
86.161 .br
86.162 .di f+
86.163 .35
86.164 .ft \n(.f
86.165 .ll \n(34u*1u/3u
86.166 -.if \n(.l<\n(81 .ll \n(81u
86.167 +.if \n(.l<\n(80 .ll \n(80u
86.168 .in 0
86.169 -Specify an HTTP proxy server (port defaults to 8080)
86.170 +\f3\-httpproxy:<host>:<port> \fP
86.171 .br
86.172 .di
86.173 .nr f| \n(dn
86.174 @@ -211,7 +217,7 @@
86.175 .ll \n(34u*1u/3u
86.176 .if \n(.l<\n(81 .ll \n(81u
86.177 .in 0
86.178 -Specifying a target package via this command\-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification
86.179 +Specify an HTTP proxy server (port defaults to 8080)
86.180 .br
86.181 .di
86.182 .nr g| \n(dn
86.183 @@ -227,7 +233,7 @@
86.184 .ll \n(34u*1u/3u
86.185 .if \n(.l<\n(81 .ll \n(81u
86.186 .in 0
86.187 -Specify where to place generated source files
86.188 +Specifying a target package via this command\-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification
86.189 .br
86.190 .di
86.191 .nr h| \n(dn
86.192 @@ -243,7 +249,7 @@
86.193 .ll \n(34u*1u/3u
86.194 .if \n(.l<\n(81 .ll \n(81u
86.195 .in 0
86.196 -Output messages about what the compiler is doing
86.197 +Specify where to place generated source files
86.198 .br
86.199 .di
86.200 .nr i| \n(dn
86.201 @@ -259,7 +265,7 @@
86.202 .ll \n(34u*1u/3u
86.203 .if \n(.l<\n(81 .ll \n(81u
86.204 .in 0
86.205 -Print version information
86.206 +Output messages about what the compiler is doing
86.207 .br
86.208 .di
86.209 .nr j| \n(dn
86.210 @@ -267,16 +273,15 @@
86.211 ..
86.212 .ec \
86.213 .eo
86.214 -.am 80
86.215 +.am 81
86.216 .br
86.217 .di k+
86.218 .35
86.219 .ft \n(.f
86.220 .ll \n(34u*1u/3u
86.221 -.if \n(.l<\n(80 .ll \n(80u
86.222 +.if \n(.l<\n(81 .ll \n(81u
86.223 .in 0
86.224 -\f2\-wsdllocation <location>\fP
86.225 -.br
86.226 +Print version information
86.227 .br
86.228 .di
86.229 .nr k| \n(dn
86.230 @@ -284,53 +289,90 @@
86.231 ..
86.232 .ec \
86.233 .eo
86.234 -.am 81
86.235 +.am 80
86.236 .br
86.237 .di l+
86.238 .35
86.239 .ft \n(.f
86.240 .ll \n(34u*1u/3u
86.241 -.if \n(.l<\n(81 .ll \n(81u
86.242 +.if \n(.l<\n(80 .ll \n(80u
86.243 .in 0
86.244 -\f2@WebService.wsdlLocation\fP and \f2@WebServiceClient.wsdlLocation\fP value
86.245 -.br
86.246 +\f3\-wsdllocation <location>\fP
86.247 .br
86.248 .di
86.249 .nr l| \n(dn
86.250 .nr l- \n(dl
86.251 ..
86.252 .ec \
86.253 +.eo
86.254 +.am 81
86.255 +.br
86.256 +.di m+
86.257 +.35
86.258 +.ft \n(.f
86.259 +.ll \n(34u*1u/3u
86.260 +.if \n(.l<\n(81 .ll \n(81u
86.261 +.in 0
86.262 +\f2@WebServiceClient.wsdlLocation\fP value
86.263 +.br
86.264 +.di
86.265 +.nr m| \n(dn
86.266 +.nr m- \n(dl
86.267 +..
86.268 +.ec \
86.269 +.eo
86.270 +.am 81
86.271 +.br
86.272 +.di n+
86.273 +.35
86.274 +.ft \n(.f
86.275 +.ll \n(34u*1u/3u
86.276 +.if \n(.l<\n(81 .ll \n(81u
86.277 +.in 0
86.278 +Generate code as per the given JAX\-WS specification version. version 2.0 will generate compliant code for JAX\-WS 2.0 spec.
86.279 +.br
86.280 +.di
86.281 +.nr n| \n(dn
86.282 +.nr n- \n(dl
86.283 +..
86.284 +.ec \
86.285 .35
86.286 .nf
86.287 .ll \n(34u
86.288 .nr 80 0
86.289 .nr 38 \w\f3Option\fP
86.290 .if \n(80<\n(38 .nr 80 \n(38
86.291 -.nr 38 \w\f2\-d <directory>\fP
86.292 +.nr 38 \w\f3\-d <directory> \fP
86.293 .if \n(80<\n(38 .nr 80 \n(38
86.294 -.nr 38 \w\f2\-b <path>\fP
86.295 +.nr 38 \w\f3\-b <path> \fP
86.296 .if \n(80<\n(38 .nr 80 \n(38
86.297 -.nr 38 \w\-catalog
86.298 +.nr 38 \w\f3\-B <jaxbOption>\fP
86.299 .if \n(80<\n(38 .nr 80 \n(38
86.300 -.nr 38 \w\f2\-extension\fP
86.301 +.nr 38 \w\f3\-catalog\fP
86.302 .if \n(80<\n(38 .nr 80 \n(38
86.303 -.nr 38 \w\f2\-help\fP
86.304 +.nr 38 \w\f3\-extension \fP
86.305 .if \n(80<\n(38 .nr 80 \n(38
86.306 -.nr 38 \w\f2\-keep\fP
86.307 +.nr 38 \w\f3\-help \fP
86.308 .if \n(80<\n(38 .nr 80 \n(38
86.309 -.nr 38 \w\f2\-p\fP
86.310 +.nr 38 \w\f3\-keep \fP
86.311 .if \n(80<\n(38 .nr 80 \n(38
86.312 -.nr 38 \w\f2\-s <directory>\fP
86.313 +.nr 38 \w\f3\-p \fP
86.314 .if \n(80<\n(38 .nr 80 \n(38
86.315 -.nr 38 \w\f2\-verbose\fP
86.316 +.nr 38 \w\f3\-s <directory> \fP
86.317 .if \n(80<\n(38 .nr 80 \n(38
86.318 -.nr 38 \w\f2\-version\fP
86.319 +.nr 38 \w\f3\-verbose \fP
86.320 +.if \n(80<\n(38 .nr 80 \n(38
86.321 +.nr 38 \w\f3\-version \fP
86.322 +.if \n(80<\n(38 .nr 80 \n(38
86.323 +.nr 38 \w\f3\-target \fP
86.324 +.if \n(80<\n(38 .nr 80 \n(38
86.325 +.nr 38 \w\f3\-quiet \fP
86.326 .if \n(80<\n(38 .nr 80 \n(38
86.327 .80
86.328 .rm 80
86.329 -.nr 38 \n(e-
86.330 +.nr 38 \n(f-
86.331 .if \n(80<\n(38 .nr 80 \n(38
86.332 -.nr 38 \n(k-
86.333 +.nr 38 \n(l-
86.334 .if \n(80<\n(38 .nr 80 \n(38
86.335 .nr 81 0
86.336 .nr 38 \w\f3Description\fP
86.337 @@ -339,6 +381,8 @@
86.338 .if \n(81<\n(38 .nr 81 \n(38
86.339 .nr 38 \wKeep generated files
86.340 .if \n(81<\n(38 .nr 81 \n(38
86.341 +.nr 38 \wSuppress wsimport output
86.342 +.if \n(81<\n(38 .nr 81 \n(38
86.343 .81
86.344 .rm 81
86.345 .nr 38 \n(a-
86.346 @@ -349,7 +393,7 @@
86.347 .if \n(81<\n(38 .nr 81 \n(38
86.348 .nr 38 \n(d-
86.349 .if \n(81<\n(38 .nr 81 \n(38
86.350 -.nr 38 \n(f-
86.351 +.nr 38 \n(e-
86.352 .if \n(81<\n(38 .nr 81 \n(38
86.353 .nr 38 \n(g-
86.354 .if \n(81<\n(38 .nr 81 \n(38
86.355 @@ -359,7 +403,11 @@
86.356 .if \n(81<\n(38 .nr 81 \n(38
86.357 .nr 38 \n(j-
86.358 .if \n(81<\n(38 .nr 81 \n(38
86.359 -.nr 38 \n(l-
86.360 +.nr 38 \n(k-
86.361 +.if \n(81<\n(38 .nr 81 \n(38
86.362 +.nr 38 \n(m-
86.363 +.if \n(81<\n(38 .nr 81 \n(38
86.364 +.nr 38 \n(n-
86.365 .if \n(81<\n(38 .nr 81 \n(38
86.366 .35
86.367 .nf
86.368 @@ -371,7 +419,7 @@
86.369 .nr 41 \n(80+(3*\n(38)
86.370 .nr 81 +\n(41
86.371 .nr TW \n(81
86.372 -.if t .if \n(TW>\n(.li .tm Table at line 124 file Input is too wide - \n(TW units
86.373 +.if t .if \n(TW>\n(.li .tm Table at line 158 file Input is too wide - \n(TW units
86.374 .fc
86.375 .nr #T 0-1
86.376 .nr #a 0-1
86.377 @@ -394,7 +442,7 @@
86.378 .ta \n(80u \n(81u
86.379 .nr 31 \n(.f
86.380 .nr 35 1m
86.381 -\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
86.382 +\&\h'|\n(40u'\f3\-d <directory> \fP\h'|\n(41u'
86.383 .mk ##
86.384 .nr 31 \n(##
86.385 .sp |\n(##u-1v
86.386 @@ -410,7 +458,7 @@
86.387 .ta \n(80u \n(81u
86.388 .nr 31 \n(.f
86.389 .nr 35 1m
86.390 -\&\h'|\n(40u'\f2\-b <path>\fP\h'|\n(41u'
86.391 +\&\h'|\n(40u'\f3\-b <path> \fP\h'|\n(41u'
86.392 .mk ##
86.393 .nr 31 \n(##
86.394 .sp |\n(##u-1v
86.395 @@ -426,7 +474,7 @@
86.396 .ta \n(80u \n(81u
86.397 .nr 31 \n(.f
86.398 .nr 35 1m
86.399 -\&\h'|\n(40u'\-catalog\h'|\n(41u'
86.400 +\&\h'|\n(40u'\f3\-B <jaxbOption>\fP\h'|\n(41u'
86.401 .mk ##
86.402 .nr 31 \n(##
86.403 .sp |\n(##u-1v
86.404 @@ -442,7 +490,7 @@
86.405 .ta \n(80u \n(81u
86.406 .nr 31 \n(.f
86.407 .nr 35 1m
86.408 -\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
86.409 +\&\h'|\n(40u'\f3\-catalog\fP\h'|\n(41u'
86.410 .mk ##
86.411 .nr 31 \n(##
86.412 .sp |\n(##u-1v
86.413 @@ -453,14 +501,30 @@
86.414 .mk 32
86.415 .if \n(32>\n(31 .nr 31 \n(32
86.416 .sp |\n(31u
86.417 +.ne \n(e|u+\n(.Vu
86.418 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
86.419 .ta \n(80u \n(81u
86.420 .nr 31 \n(.f
86.421 .nr 35 1m
86.422 -\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
86.423 -.ne \n(e|u+\n(.Vu
86.424 +\&\h'|\n(40u'\f3\-extension \fP\h'|\n(41u'
86.425 +.mk ##
86.426 +.nr 31 \n(##
86.427 +.sp |\n(##u-1v
86.428 +.nr 37 \n(41u
86.429 +.in +\n(37u
86.430 +.e+
86.431 +.in -\n(37u
86.432 +.mk 32
86.433 +.if \n(32>\n(31 .nr 31 \n(32
86.434 +.sp |\n(31u
86.435 +.ta \n(80u \n(81u
86.436 +.nr 31 \n(.f
86.437 +.nr 35 1m
86.438 +\&\h'|\n(40u'\f3\-help \fP\h'|\n(41u'Display help
86.439 .ne \n(f|u+\n(.Vu
86.440 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
86.441 +.ne \n(g|u+\n(.Vu
86.442 .if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
86.443 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
86.444 .ta \n(80u \n(81u
86.445 .nr 31 \n(.f
86.446 .nr 35 1m
86.447 @@ -470,30 +534,10 @@
86.448 .sp |\n(##u-1v
86.449 .nr 37 \n(40u
86.450 .in +\n(37u
86.451 -.e+
86.452 -.in -\n(37u
86.453 -.mk 32
86.454 -.if \n(32>\n(31 .nr 31 \n(32
86.455 -.sp |\n(##u-1v
86.456 -.nr 37 \n(41u
86.457 -.in +\n(37u
86.458 .f+
86.459 .in -\n(37u
86.460 .mk 32
86.461 .if \n(32>\n(31 .nr 31 \n(32
86.462 -.sp |\n(31u
86.463 -.ta \n(80u \n(81u
86.464 -.nr 31 \n(.f
86.465 -.nr 35 1m
86.466 -\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
86.467 -.ne \n(g|u+\n(.Vu
86.468 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
86.469 -.ta \n(80u \n(81u
86.470 -.nr 31 \n(.f
86.471 -.nr 35 1m
86.472 -\&\h'|\n(40u'\f2\-p\fP\h'|\n(41u'
86.473 -.mk ##
86.474 -.nr 31 \n(##
86.475 .sp |\n(##u-1v
86.476 .nr 37 \n(41u
86.477 .in +\n(37u
86.478 @@ -502,12 +546,16 @@
86.479 .mk 32
86.480 .if \n(32>\n(31 .nr 31 \n(32
86.481 .sp |\n(31u
86.482 +.ta \n(80u \n(81u
86.483 +.nr 31 \n(.f
86.484 +.nr 35 1m
86.485 +\&\h'|\n(40u'\f3\-keep \fP\h'|\n(41u'Keep generated files
86.486 .ne \n(h|u+\n(.Vu
86.487 .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
86.488 .ta \n(80u \n(81u
86.489 .nr 31 \n(.f
86.490 .nr 35 1m
86.491 -\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
86.492 +\&\h'|\n(40u'\f3\-p \fP\h'|\n(41u'
86.493 .mk ##
86.494 .nr 31 \n(##
86.495 .sp |\n(##u-1v
86.496 @@ -523,7 +571,7 @@
86.497 .ta \n(80u \n(81u
86.498 .nr 31 \n(.f
86.499 .nr 35 1m
86.500 -\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
86.501 +\&\h'|\n(40u'\f3\-s <directory> \fP\h'|\n(41u'
86.502 .mk ##
86.503 .nr 31 \n(##
86.504 .sp |\n(##u-1v
86.505 @@ -539,7 +587,7 @@
86.506 .ta \n(80u \n(81u
86.507 .nr 31 \n(.f
86.508 .nr 35 1m
86.509 -\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
86.510 +\&\h'|\n(40u'\f3\-verbose \fP\h'|\n(41u'
86.511 .mk ##
86.512 .nr 31 \n(##
86.513 .sp |\n(##u-1v
86.514 @@ -551,9 +599,25 @@
86.515 .if \n(32>\n(31 .nr 31 \n(32
86.516 .sp |\n(31u
86.517 .ne \n(k|u+\n(.Vu
86.518 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
86.519 +.ta \n(80u \n(81u
86.520 +.nr 31 \n(.f
86.521 +.nr 35 1m
86.522 +\&\h'|\n(40u'\f3\-version \fP\h'|\n(41u'
86.523 +.mk ##
86.524 +.nr 31 \n(##
86.525 +.sp |\n(##u-1v
86.526 +.nr 37 \n(41u
86.527 +.in +\n(37u
86.528 +.k+
86.529 +.in -\n(37u
86.530 +.mk 32
86.531 +.if \n(32>\n(31 .nr 31 \n(32
86.532 +.sp |\n(31u
86.533 .ne \n(l|u+\n(.Vu
86.534 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
86.535 +.ne \n(m|u+\n(.Vu
86.536 .if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
86.537 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
86.538 .ta \n(80u \n(81u
86.539 .nr 31 \n(.f
86.540 .nr 35 1m
86.541 @@ -563,690 +627,38 @@
86.542 .sp |\n(##u-1v
86.543 .nr 37 \n(40u
86.544 .in +\n(37u
86.545 -.k+
86.546 +.l+
86.547 .in -\n(37u
86.548 .mk 32
86.549 .if \n(32>\n(31 .nr 31 \n(32
86.550 .sp |\n(##u-1v
86.551 .nr 37 \n(41u
86.552 .in +\n(37u
86.553 -.l+
86.554 +.m+
86.555 .in -\n(37u
86.556 .mk 32
86.557 .if \n(32>\n(31 .nr 31 \n(32
86.558 .sp |\n(31u
86.559 -.fc
86.560 -.nr T. 1
86.561 -.T# 1
86.562 -.35
86.563 -.rm a+
86.564 -.rm b+
86.565 -.rm c+
86.566 -.rm d+
86.567 -.rm e+
86.568 -.rm f+
86.569 -.rm g+
86.570 -.rm h+
86.571 -.rm i+
86.572 -.rm j+
86.573 -.rm k+
86.574 -.rm l+
86.575 -.TE
86.576 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-54
86.577 -
86.578 -.LP
86.579 -.LP
86.580 -Multiple JAX\-WS and JAXB binding files can be specified using \f2\-b\fP option and they can be used to customize various things like package names, bean names, etc. More information on JAX\-WS and JAXB binding files can be found in the customization documentation.
86.581 -.br
86.582 -
86.583 -.LP
86.584 -.SS
86.585 -Ant task
86.586 -.LP
86.587 -.LP
86.588 -An Ant task for the \f2wsimport\fP tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
86.589 -.br
86.590 -
86.591 -.LP
86.592 -.nf
86.593 -\f3
86.594 -.fl
86.595 - <wsimport \fP
86.596 -.br
86.597 -\f3
86.598 -.fl
86.599 - wsdl="..." \fP
86.600 -.br
86.601 -\f3
86.602 -.fl
86.603 - destdir="directory for generated class files"\fP
86.604 -.br
86.605 -\f3
86.606 -.fl
86.607 - sourcedestdir="directory for generated source files"\fP
86.608 -.br
86.609 -\f3
86.610 -.fl
86.611 - keep="true|false"\fP
86.612 -.br
86.613 -\f3
86.614 -.fl
86.615 - extension="true|false"\fP
86.616 -.br
86.617 -\f3
86.618 -.fl
86.619 - verbose="true|false"\fP
86.620 -.br
86.621 -\f3
86.622 -.fl
86.623 - version="true|false"\fP
86.624 -.br
86.625 -\f3
86.626 -.fl
86.627 - wsdlLocation="..."\fP
86.628 -.br
86.629 -\f3
86.630 -.fl
86.631 - catalog="catalog file"\fP
86.632 -.br
86.633 -\f3
86.634 -.fl
86.635 - package="package name"\fP
86.636 -.br
86.637 -\f3
86.638 -.fl
86.639 - <binding dir="..." includes="..." />\fP
86.640 -.br
86.641 -\f3
86.642 -.fl
86.643 - </wsimport>
86.644 -.fl
86.645 -\fP
86.646 -.fi
86.647 -
86.648 -.LP
86.649 -.LP
86.650 -.TS
86.651 -.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
86.652 -.de 35
86.653 -.ps \n(.s
86.654 -.vs \n(.vu
86.655 -.in \n(.iu
86.656 -.if \n(.u .fi
86.657 -.if \n(.j .ad
86.658 -.if \n(.j=0 .na
86.659 -..
86.660 -.nf
86.661 -.nr #~ 0
86.662 -.if n .nr #~ 0.6n
86.663 -.ds #d .d
86.664 -.if \(ts\n(.z\(ts\(ts .ds #d nl
86.665 -.fc
86.666 -.nr 33 \n(.s
86.667 -.rm 80 81 82
86.668 -.nr 34 \n(.lu
86.669 -.eo
86.670 -.am 81
86.671 -.br
86.672 -.di a+
86.673 -.35
86.674 -.ft \n(.f
86.675 -.ll \n(34u*1u/4u
86.676 -.if \n(.l<\n(81 .ll \n(81u
86.677 -.in 0
86.678 -Specify where to place output generated classes
86.679 -.br
86.680 -.di
86.681 -.nr a| \n(dn
86.682 -.nr a- \n(dl
86.683 -..
86.684 -.ec \
86.685 -.eo
86.686 -.am 81
86.687 -.br
86.688 -.di b+
86.689 -.35
86.690 -.ft \n(.f
86.691 -.ll \n(34u*1u/4u
86.692 -.if \n(.l<\n(81 .ll \n(81u
86.693 -.in 0
86.694 -Specify where to place generated source files, keep is turned on with this option
86.695 -.br
86.696 -.di
86.697 -.nr b| \n(dn
86.698 -.nr b- \n(dl
86.699 -..
86.700 -.ec \
86.701 -.eo
86.702 -.am 81
86.703 -.br
86.704 -.di c+
86.705 -.35
86.706 -.ft \n(.f
86.707 -.ll \n(34u*1u/4u
86.708 -.if \n(.l<\n(81 .ll \n(81u
86.709 -.in 0
86.710 -Keep generated files, tunred on with sourcedestdir option
86.711 -.br
86.712 -.di
86.713 -.nr c| \n(dn
86.714 -.nr c- \n(dl
86.715 -..
86.716 -.ec \
86.717 -.eo
86.718 -.am 81
86.719 -.br
86.720 -.di d+
86.721 -.35
86.722 -.ft \n(.f
86.723 -.ll \n(34u*1u/4u
86.724 -.if \n(.l<\n(81 .ll \n(81u
86.725 -.in 0
86.726 -Output messages about what the compiler is doing
86.727 -.br
86.728 -.di
86.729 -.nr d| \n(dn
86.730 -.nr d- \n(dl
86.731 -..
86.732 -.ec \
86.733 -.eo
86.734 -.am 81
86.735 -.br
86.736 -.di e+
86.737 -.35
86.738 -.ft \n(.f
86.739 -.ll \n(34u*1u/4u
86.740 -.if \n(.l<\n(81 .ll \n(81u
86.741 -.in 0
86.742 -Specify external JAX\-WS or JAXB binding files
86.743 -.br
86.744 -.di
86.745 -.nr e| \n(dn
86.746 -.nr e- \n(dl
86.747 -..
86.748 -.ec \
86.749 -.eo
86.750 -.am 81
86.751 -.br
86.752 -.di f+
86.753 -.35
86.754 -.ft \n(.f
86.755 -.ll \n(34u*1u/4u
86.756 -.if \n(.l<\n(81 .ll \n(81u
86.757 -.in 0
86.758 -allow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
86.759 -.br
86.760 -.di
86.761 -.nr f| \n(dn
86.762 -.nr f- \n(dl
86.763 -..
86.764 -.ec \
86.765 -.eo
86.766 -.am 80
86.767 -.br
86.768 -.di g+
86.769 -.35
86.770 -.ft \n(.f
86.771 -.ll \n(34u*1u/4u
86.772 -.if \n(.l<\n(80 .ll \n(80u
86.773 -.in 0
86.774 -\f2wsdllocation\fP
86.775 -.br
86.776 -.br
86.777 -.di
86.778 -.nr g| \n(dn
86.779 -.nr g- \n(dl
86.780 -..
86.781 -.ec \
86.782 -.eo
86.783 -.am 81
86.784 -.br
86.785 -.di h+
86.786 -.35
86.787 -.ft \n(.f
86.788 -.ll \n(34u*1u/4u
86.789 -.if \n(.l<\n(81 .ll \n(81u
86.790 -.in 0
86.791 -The wsdl URI passed thru this option will be used to set the value of \f2@WebService.wsdlLocation\fP and \f2@WebServiceClient.wsdlLocation\fP annotation elements on the generated SEI and Service interface
86.792 -.br
86.793 -.br
86.794 -.di
86.795 -.nr h| \n(dn
86.796 -.nr h- \n(dl
86.797 -..
86.798 -.ec \
86.799 -.eo
86.800 -.am 82
86.801 -.br
86.802 -.di i+
86.803 -.35
86.804 -.ft \n(.f
86.805 -.ll \n(34u*1u/4u
86.806 -.if \n(.l<\n(82 .ll \n(82u
86.807 -.in 0
86.808 -\f2\-wsdllocation\fP
86.809 -.br
86.810 -.br
86.811 -.di
86.812 -.nr i| \n(dn
86.813 -.nr i- \n(dl
86.814 -..
86.815 -.ec \
86.816 -.eo
86.817 -.am 80
86.818 -.br
86.819 -.di j+
86.820 -.35
86.821 -.ft \n(.f
86.822 -.ll \n(34u*1u/4u
86.823 -.if \n(.l<\n(80 .ll \n(80u
86.824 -.in 0
86.825 -\f2catalog\fP
86.826 -.br
86.827 -.br
86.828 -.di
86.829 -.nr j| \n(dn
86.830 -.nr j- \n(dl
86.831 -..
86.832 -.ec \
86.833 -.eo
86.834 -.am 81
86.835 -.br
86.836 -.di k+
86.837 -.35
86.838 -.ft \n(.f
86.839 -.ll \n(34u*1u/4u
86.840 -.if \n(.l<\n(81 .ll \n(81u
86.841 -.in 0
86.842 -Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Additionally, ant xmlcatalog type can be used to resolve entities, see wsimport_catalog sample.
86.843 -.br
86.844 -.di
86.845 -.nr k| \n(dn
86.846 -.nr k- \n(dl
86.847 -..
86.848 -.ec \
86.849 -.eo
86.850 -.am 82
86.851 -.br
86.852 -.di l+
86.853 -.35
86.854 -.ft \n(.f
86.855 -.ll \n(34u*1u/4u
86.856 -.if \n(.l<\n(82 .ll \n(82u
86.857 -.in 0
86.858 -\f2\-catalog\fP
86.859 -.br
86.860 -.br
86.861 -.di
86.862 -.nr l| \n(dn
86.863 -.nr l- \n(dl
86.864 -..
86.865 -.ec \
86.866 -.eo
86.867 -.am 80
86.868 -.br
86.869 -.di m+
86.870 -.35
86.871 -.ft \n(.f
86.872 -.ll \n(34u*1u/4u
86.873 -.if \n(.l<\n(80 .ll \n(80u
86.874 -.in 0
86.875 -\f2package\fP
86.876 -.br
86.877 -.br
86.878 -.di
86.879 -.nr m| \n(dn
86.880 -.nr m- \n(dl
86.881 -..
86.882 -.ec \
86.883 -.eo
86.884 -.am 81
86.885 -.br
86.886 -.di n+
86.887 -.35
86.888 -.ft \n(.f
86.889 -.ll \n(34u*1u/4u
86.890 -.if \n(.l<\n(81 .ll \n(81u
86.891 -.in 0
86.892 -Specifies the target package
86.893 -.br
86.894 -.di
86.895 -.nr n| \n(dn
86.896 -.nr n- \n(dl
86.897 -..
86.898 -.ec \
86.899 -.eo
86.900 -.am 82
86.901 -.br
86.902 -.di o+
86.903 -.35
86.904 -.ft \n(.f
86.905 -.ll \n(34u*1u/4u
86.906 -.if \n(.l<\n(82 .ll \n(82u
86.907 -.in 0
86.908 -\f2\-p\fP
86.909 -.br
86.910 -.br
86.911 -.di
86.912 -.nr o| \n(dn
86.913 -.nr o- \n(dl
86.914 -..
86.915 -.ec \
86.916 -.35
86.917 -.nf
86.918 -.ll \n(34u
86.919 -.nr 80 0
86.920 -.nr 38 \w\f3Attribute\fP
86.921 -.if \n(80<\n(38 .nr 80 \n(38
86.922 -.nr 38 \w\f2wsdl\fP
86.923 -.if \n(80<\n(38 .nr 80 \n(38
86.924 -.nr 38 \w\f2destdir\fP
86.925 -.if \n(80<\n(38 .nr 80 \n(38
86.926 -.nr 38 \wsourcedestdir
86.927 -.if \n(80<\n(38 .nr 80 \n(38
86.928 -.nr 38 \w\f2keep\fP
86.929 -.if \n(80<\n(38 .nr 80 \n(38
86.930 -.nr 38 \w\f2verbose\fP
86.931 -.if \n(80<\n(38 .nr 80 \n(38
86.932 -.nr 38 \w\f2binding\fP
86.933 -.if \n(80<\n(38 .nr 80 \n(38
86.934 -.nr 38 \w\f2extension\fP
86.935 -.if \n(80<\n(38 .nr 80 \n(38
86.936 -.80
86.937 -.rm 80
86.938 -.nr 38 \n(g-
86.939 -.if \n(80<\n(38 .nr 80 \n(38
86.940 -.nr 38 \n(j-
86.941 -.if \n(80<\n(38 .nr 80 \n(38
86.942 -.nr 38 \n(m-
86.943 -.if \n(80<\n(38 .nr 80 \n(38
86.944 -.nr 81 0
86.945 -.nr 38 \w\f3Description\fP
86.946 -.if \n(81<\n(38 .nr 81 \n(38
86.947 -.nr 38 \wWSDL file
86.948 -.if \n(81<\n(38 .nr 81 \n(38
86.949 -.81
86.950 -.rm 81
86.951 -.nr 38 \n(a-
86.952 -.if \n(81<\n(38 .nr 81 \n(38
86.953 -.nr 38 \n(b-
86.954 -.if \n(81<\n(38 .nr 81 \n(38
86.955 -.nr 38 \n(c-
86.956 -.if \n(81<\n(38 .nr 81 \n(38
86.957 -.nr 38 \n(d-
86.958 -.if \n(81<\n(38 .nr 81 \n(38
86.959 -.nr 38 \n(e-
86.960 -.if \n(81<\n(38 .nr 81 \n(38
86.961 -.nr 38 \n(f-
86.962 -.if \n(81<\n(38 .nr 81 \n(38
86.963 -.nr 38 \n(h-
86.964 -.if \n(81<\n(38 .nr 81 \n(38
86.965 -.nr 38 \n(k-
86.966 -.if \n(81<\n(38 .nr 81 \n(38
86.967 -.nr 38 \n(n-
86.968 -.if \n(81<\n(38 .nr 81 \n(38
86.969 -.nr 82 0
86.970 -.nr 38 \w\f3Command line\fP
86.971 -.if \n(82<\n(38 .nr 82 \n(38
86.972 -.nr 38 \wWSDL
86.973 -.if \n(82<\n(38 .nr 82 \n(38
86.974 -.nr 38 \w\f2\-d\fP
86.975 -.if \n(82<\n(38 .nr 82 \n(38
86.976 -.nr 38 \w\f2\-s\fP
86.977 -.if \n(82<\n(38 .nr 82 \n(38
86.978 -.nr 38 \w\f2\-keep\fP
86.979 -.if \n(82<\n(38 .nr 82 \n(38
86.980 -.nr 38 \w\f2\-verbose\fP
86.981 -.if \n(82<\n(38 .nr 82 \n(38
86.982 -.nr 38 \w\f2\-b\fP
86.983 -.if \n(82<\n(38 .nr 82 \n(38
86.984 -.nr 38 \w\f2\-extension\fP
86.985 -.if \n(82<\n(38 .nr 82 \n(38
86.986 -.82
86.987 -.rm 82
86.988 -.nr 38 \n(i-
86.989 -.if \n(82<\n(38 .nr 82 \n(38
86.990 -.nr 38 \n(l-
86.991 -.if \n(82<\n(38 .nr 82 \n(38
86.992 -.nr 38 \n(o-
86.993 -.if \n(82<\n(38 .nr 82 \n(38
86.994 -.35
86.995 -.nf
86.996 -.ll \n(34u
86.997 -.nr 38 1n
86.998 -.nr 79 0
86.999 -.nr 40 \n(79+(0*\n(38)
86.1000 -.nr 80 +\n(40
86.1001 -.nr 41 \n(80+(3*\n(38)
86.1002 -.nr 81 +\n(41
86.1003 -.nr 42 \n(81+(3*\n(38)
86.1004 -.nr 82 +\n(42
86.1005 -.nr TW \n(82
86.1006 -.if t .if \n(TW>\n(.li .tm Table at line 261 file Input is too wide - \n(TW units
86.1007 -.fc
86.1008 -.nr #T 0-1
86.1009 -.nr #a 0-1
86.1010 -.eo
86.1011 -.de T#
86.1012 -.ds #d .d
86.1013 -.if \(ts\n(.z\(ts\(ts .ds #d nl
86.1014 -.mk ##
86.1015 -.nr ## -1v
86.1016 -.ls 1
86.1017 -.ls
86.1018 -..
86.1019 -.ec
86.1020 -.ta \n(80u \n(81u \n(82u
86.1021 +.ne \n(n|u+\n(.Vu
86.1022 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
86.1023 +.ta \n(80u \n(81u
86.1024 .nr 31 \n(.f
86.1025 .nr 35 1m
86.1026 -\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
86.1027 -.ta \n(80u \n(81u \n(82u
86.1028 -.nr 31 \n(.f
86.1029 -.nr 35 1m
86.1030 -\&\h'|\n(40u'\f2wsdl\fP\h'|\n(41u'WSDL file\h'|\n(42u'WSDL
86.1031 -.ne \n(a|u+\n(.Vu
86.1032 -.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
86.1033 -.ta \n(80u \n(81u \n(82u
86.1034 -.nr 31 \n(.f
86.1035 -.nr 35 1m
86.1036 -\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
86.1037 +\&\h'|\n(40u'\f3\-target \fP\h'|\n(41u'
86.1038 .mk ##
86.1039 .nr 31 \n(##
86.1040 .sp |\n(##u-1v
86.1041 .nr 37 \n(41u
86.1042 .in +\n(37u
86.1043 -.a+
86.1044 -.in -\n(37u
86.1045 -.mk 32
86.1046 -.if \n(32>\n(31 .nr 31 \n(32
86.1047 -.sp |\n(31u
86.1048 -.ne \n(b|u+\n(.Vu
86.1049 -.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
86.1050 -.ta \n(80u \n(81u \n(82u
86.1051 -.nr 31 \n(.f
86.1052 -.nr 35 1m
86.1053 -\&\h'|\n(40u'sourcedestdir\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
86.1054 -.mk ##
86.1055 -.nr 31 \n(##
86.1056 -.sp |\n(##u-1v
86.1057 -.nr 37 \n(41u
86.1058 -.in +\n(37u
86.1059 -.b+
86.1060 -.in -\n(37u
86.1061 -.mk 32
86.1062 -.if \n(32>\n(31 .nr 31 \n(32
86.1063 -.sp |\n(31u
86.1064 -.ne \n(c|u+\n(.Vu
86.1065 -.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
86.1066 -.ta \n(80u \n(81u \n(82u
86.1067 -.nr 31 \n(.f
86.1068 -.nr 35 1m
86.1069 -\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'\h'|\n(42u'\f2\-keep\fP
86.1070 -.mk ##
86.1071 -.nr 31 \n(##
86.1072 -.sp |\n(##u-1v
86.1073 -.nr 37 \n(41u
86.1074 -.in +\n(37u
86.1075 -.c+
86.1076 -.in -\n(37u
86.1077 -.mk 32
86.1078 -.if \n(32>\n(31 .nr 31 \n(32
86.1079 -.sp |\n(31u
86.1080 -.ne \n(d|u+\n(.Vu
86.1081 -.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
86.1082 -.ta \n(80u \n(81u \n(82u
86.1083 -.nr 31 \n(.f
86.1084 -.nr 35 1m
86.1085 -\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
86.1086 -.mk ##
86.1087 -.nr 31 \n(##
86.1088 -.sp |\n(##u-1v
86.1089 -.nr 37 \n(41u
86.1090 -.in +\n(37u
86.1091 -.d+
86.1092 -.in -\n(37u
86.1093 -.mk 32
86.1094 -.if \n(32>\n(31 .nr 31 \n(32
86.1095 -.sp |\n(31u
86.1096 -.ne \n(e|u+\n(.Vu
86.1097 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
86.1098 -.ta \n(80u \n(81u \n(82u
86.1099 -.nr 31 \n(.f
86.1100 -.nr 35 1m
86.1101 -\&\h'|\n(40u'\f2binding\fP\h'|\n(41u'\h'|\n(42u'\f2\-b\fP
86.1102 -.mk ##
86.1103 -.nr 31 \n(##
86.1104 -.sp |\n(##u-1v
86.1105 -.nr 37 \n(41u
86.1106 -.in +\n(37u
86.1107 -.e+
86.1108 -.in -\n(37u
86.1109 -.mk 32
86.1110 -.if \n(32>\n(31 .nr 31 \n(32
86.1111 -.sp |\n(31u
86.1112 -.ta \n(80u \n(81u \n(82u
86.1113 -.nr 31 \n(.f
86.1114 -.nr 35 1m
86.1115 -\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
86.1116 -.br
86.1117 -.ne \n(f|u+\n(.Vu
86.1118 -.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
86.1119 -.ta \n(80u \n(81u \n(82u
86.1120 -.nr 31 \n(.f
86.1121 -.nr 35 1m
86.1122 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
86.1123 -.mk ##
86.1124 -.nr 31 \n(##
86.1125 -.sp |\n(##u-1v
86.1126 -.nr 37 \n(41u
86.1127 -.in +\n(37u
86.1128 -.f+
86.1129 -.in -\n(37u
86.1130 -.mk 32
86.1131 -.if \n(32>\n(31 .nr 31 \n(32
86.1132 -.sp |\n(31u
86.1133 -.ne \n(g|u+\n(.Vu
86.1134 -.ne \n(h|u+\n(.Vu
86.1135 -.ne \n(i|u+\n(.Vu
86.1136 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
86.1137 -.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
86.1138 -.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
86.1139 -.ta \n(80u \n(81u \n(82u
86.1140 -.nr 31 \n(.f
86.1141 -.nr 35 1m
86.1142 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
86.1143 -.mk ##
86.1144 -.nr 31 \n(##
86.1145 -.sp |\n(##u-1v
86.1146 -.nr 37 \n(40u
86.1147 -.in +\n(37u
86.1148 -.g+
86.1149 -.in -\n(37u
86.1150 -.mk 32
86.1151 -.if \n(32>\n(31 .nr 31 \n(32
86.1152 -.sp |\n(##u-1v
86.1153 -.nr 37 \n(41u
86.1154 -.in +\n(37u
86.1155 -.h+
86.1156 -.in -\n(37u
86.1157 -.mk 32
86.1158 -.if \n(32>\n(31 .nr 31 \n(32
86.1159 -.sp |\n(##u-1v
86.1160 -.nr 37 \n(42u
86.1161 -.in +\n(37u
86.1162 -.i+
86.1163 -.in -\n(37u
86.1164 -.mk 32
86.1165 -.if \n(32>\n(31 .nr 31 \n(32
86.1166 -.sp |\n(31u
86.1167 -.ne \n(j|u+\n(.Vu
86.1168 -.ne \n(k|u+\n(.Vu
86.1169 -.ne \n(l|u+\n(.Vu
86.1170 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
86.1171 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
86.1172 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
86.1173 -.ta \n(80u \n(81u \n(82u
86.1174 -.nr 31 \n(.f
86.1175 -.nr 35 1m
86.1176 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
86.1177 -.mk ##
86.1178 -.nr 31 \n(##
86.1179 -.sp |\n(##u-1v
86.1180 -.nr 37 \n(40u
86.1181 -.in +\n(37u
86.1182 -.j+
86.1183 -.in -\n(37u
86.1184 -.mk 32
86.1185 -.if \n(32>\n(31 .nr 31 \n(32
86.1186 -.sp |\n(##u-1v
86.1187 -.nr 37 \n(41u
86.1188 -.in +\n(37u
86.1189 -.k+
86.1190 -.in -\n(37u
86.1191 -.mk 32
86.1192 -.if \n(32>\n(31 .nr 31 \n(32
86.1193 -.sp |\n(##u-1v
86.1194 -.nr 37 \n(42u
86.1195 -.in +\n(37u
86.1196 -.l+
86.1197 -.in -\n(37u
86.1198 -.mk 32
86.1199 -.if \n(32>\n(31 .nr 31 \n(32
86.1200 -.sp |\n(31u
86.1201 -.ne \n(m|u+\n(.Vu
86.1202 -.ne \n(n|u+\n(.Vu
86.1203 -.ne \n(o|u+\n(.Vu
86.1204 -.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
86.1205 -.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
86.1206 -.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
86.1207 -.ta \n(80u \n(81u \n(82u
86.1208 -.nr 31 \n(.f
86.1209 -.nr 35 1m
86.1210 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
86.1211 -.mk ##
86.1212 -.nr 31 \n(##
86.1213 -.sp |\n(##u-1v
86.1214 -.nr 37 \n(40u
86.1215 -.in +\n(37u
86.1216 -.m+
86.1217 -.in -\n(37u
86.1218 -.mk 32
86.1219 -.if \n(32>\n(31 .nr 31 \n(32
86.1220 -.sp |\n(##u-1v
86.1221 -.nr 37 \n(41u
86.1222 -.in +\n(37u
86.1223 .n+
86.1224 .in -\n(37u
86.1225 .mk 32
86.1226 .if \n(32>\n(31 .nr 31 \n(32
86.1227 -.sp |\n(##u-1v
86.1228 -.nr 37 \n(42u
86.1229 -.in +\n(37u
86.1230 -.o+
86.1231 -.in -\n(37u
86.1232 -.mk 32
86.1233 -.if \n(32>\n(31 .nr 31 \n(32
86.1234 .sp |\n(31u
86.1235 +.ta \n(80u \n(81u
86.1236 +.nr 31 \n(.f
86.1237 +.nr 35 1m
86.1238 +\&\h'|\n(40u'\f3\-quiet \fP\h'|\n(41u'Suppress wsimport output
86.1239 .fc
86.1240 .nr T. 1
86.1241 .T# 1
86.1242 @@ -1265,137 +677,23 @@
86.1243 .rm l+
86.1244 .rm m+
86.1245 .rm n+
86.1246 -.rm o+
86.1247 .TE
86.1248 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
86.1249 -
86.1250 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-66
86.1251 .LP
86.1252 +Multiple JAX\-WS and JAXB binding files can be specified using \f2\-b\fP option and they can be used to customize various things like package names, bean names, etc. More information on JAX\-WS and JAXB binding files can be found in the
86.1253 +.na
86.1254 +\f2customization documentation\fP @
86.1255 +.fi
86.1256 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.html.
86.1257 .LP
86.1258 -The \f2binding\fP attributes is like a
86.1259 -.na
86.1260 -\f2path\-like structure\fP @
86.1261 -.fi
86.1262 -http://ant.apache.org/manual/using.html#path and can also be set via nested \f2<binding>\fP elements, respectively. Before this task can be used, a \f2<taskdef>\fP element needs to be added to the project as given below:
86.1263 -.LP
86.1264 +.SH "Example"
86.1265 .nf
86.1266 \f3
86.1267 .fl
86.1268 - <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">\fP
86.1269 +\fP\f3wsimport \-p stockquote http://stockquote.xyz/quote?wsdl\fP
86.1270 +.fl
86.1271 +.fi
86.1272 +.LP
86.1273 +This will generate the Java artifacts and compile them by importing the \f2http://stockquote.xyz/quote?wsdl\fP.
86.1274 .br
86.1275 -\f3
86.1276 -.fl
86.1277 - <classpath path="jaxws.classpath"/>\fP
86.1278 -.br
86.1279 -\f3
86.1280 -.fl
86.1281 - </taskdef>
86.1282 -.fl
86.1283 -\fP
86.1284 -.fi
86.1285 -
86.1286 -.LP
86.1287 -.LP
86.1288 -where \f2jaxws.classpath\fP is a reference to a
86.1289 -.na
86.1290 -\f2path\-like structure\fP @
86.1291 -.fi
86.1292 -http://ant.apache.org/manual/using.html#path, defined elsewhere in the build environment, and contains the list of classes required by the JAX\-WS tools.
86.1293 -.LP
86.1294 -.SH "Examples"
86.1295 -.LP
86.1296 -.nf
86.1297 -\f3
86.1298 -.fl
86.1299 - <wsimport\fP
86.1300 -.br
86.1301 -\f3
86.1302 -.fl
86.1303 - \fP\f4destdir\fP\f3="${build.classes.home}"\fP
86.1304 -.br
86.1305 -\f3
86.1306 -.fl
86.1307 - debug="true"\fP
86.1308 -.br
86.1309 -\f3
86.1310 -.fl
86.1311 - wsdl="AddNumbers.wsdl"\fP
86.1312 -.br
86.1313 -\f3
86.1314 -.fl
86.1315 - binding="custom.xml"/>
86.1316 -.fl
86.1317 -\fP
86.1318 -.fi
86.1319 -
86.1320 -.LP
86.1321 -.LP
86.1322 -The above example generates client\-side artifacts for \f2AddNumbers.wsdl\fP, stores \f2.class\fP files in the \f2${build.classes.home}\fP directory using the \f2custom.xml\fP customization file. The classpath used is \f2xyz.jar\fP and compiles with debug information on.
86.1323 -.LP
86.1324 -.nf
86.1325 -\f3
86.1326 -.fl
86.1327 - <wsimport\fP
86.1328 -.br
86.1329 -\f3
86.1330 -.fl
86.1331 - keep="true"\fP
86.1332 -.br
86.1333 -\f3
86.1334 -.fl
86.1335 - sourcedestdir="${source.dir}"\fP
86.1336 -.br
86.1337 -\f3
86.1338 -.fl
86.1339 - \fP\f4destdir\fP\f3="${build.classes.home}"\fP
86.1340 -.br
86.1341 -\f3
86.1342 -.fl
86.1343 - wsdl="AddNumbers.wsdl">\fP
86.1344 -.br
86.1345 -\f3
86.1346 -.fl
86.1347 - <binding dir="${basedir}/etc" includes="custom.xml"/>\fP
86.1348 -.br
86.1349 -\f3
86.1350 -.fl
86.1351 - </wsimport>
86.1352 -.fl
86.1353 -\fP
86.1354 -.fi
86.1355 -
86.1356 -.LP
86.1357 -.LP
86.1358 -The above example generates portable artifacts for \f2AddNumbers.wsdl\fP, stores \f2.java\fP files in the \f2${source.dir}\fP directory, stores \f2.class\fP files in the \f2${build.classes.home}\fP directory.
86.1359 -.LP
86.1360 -.SH "Notes"
86.1361 -.LP
86.1362 -.LP
86.1363 -Summary of Changed and Removed wsimport ant attributes:
86.1364 -.LP
86.1365 -\f3base\fP replaced by \f3destdir\fP
86.1366 -.br
86.1367 -
86.1368 -.LP
86.1369 -.br
86.1370 -
86.1371 -.LP
86.1372 -\f3sourceBase\fP is replaced by \f3sourcedestdir\fP
86.1373 -.br
86.1374 -
86.1375 -.LP
86.1376 -.br
86.1377 -
86.1378 -.LP
86.1379 -\f3wsdlFile\fP is replaced by \f3wsdl\fP
86.1380 -.br
86.1381 -.br
86.1382 -\f3httpProxy\fP is removed. Use ant's setproxy task instead for proxy configuration.
86.1383 -.br
86.1384 -.br
86.1385 -\f3version\fP is removed
86.1386 -.br
86.1387 -
86.1388 -.LP
86.1389 -
86.1390 -.LP
86.1391
87.1 --- a/src/linux/doc/man/xjc.1 Tue May 12 15:21:55 2009 +0900
87.2 +++ b/src/linux/doc/man/xjc.1 Thu May 14 00:17:25 2009 -0700
87.3 @@ -1,5 +1,3 @@
87.4 -.'" t
87.5 -."
87.6 ." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
87.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
87.8 ."
87.9 @@ -21,52 +19,37 @@
87.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
87.11 ." have any questions.
87.12 ."
87.13 -." `
87.14 -.TH xjc 1 "07 Aug 2006"
87.15 -." Generated by html2man
87.16 +.TH xjc 1 "04 May 2009"
87.17 +." Generated from HTML by html2man (author: Eric Armstrong)
87.18
87.19 .LP
87.20 .ad c
87.21 -.SH NAME
87.22 +.SH "Name"
87.23 xjc \- Java(TM) Architecture for XML Binding
87.24 .br
87.25 -Binding Compiler \f3Specification Version:\fP 2.0
87.26 +Binding Compiler
87.27 +.LP
87.28 +\f3Specification Version:\fP 2.1
87.29 .br
87.30 -\f3Reference Implementation (RI) Version:\fP 2.0 ea3
87.31 -.br
87.32 -.ad l
87.33 +\f3Reference Implementation (RI) Version:\fP 2.1.3 .ad l
87.34
87.35 .LP
87.36 .SH "Launching xjc"
87.37 .LP
87.38 .LP
87.39 -The binding compiler can be launched using the appropriate \f2xjc\fP shell script in the \f2bin\fP directory for your platform. We also provide an Ant task to run the binding complier \- see the instructions for using xjc with Ant.
87.40 +The binding compiler can be launched using the appropriate \f2xjc\fP shell script in the \f2bin\fP directory for your platform. We also provide an Ant task to run the binding complier \- see the instructions for
87.41 +.na
87.42 +\f2using the XJC Ant task\fP @
87.43 +.fi
87.44 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html.
87.45 .LP
87.46 .RS 3
87.47
87.48 .LP
87.49 -\f3For Solaris/Linux\fP
87.50 .LP
87.51 -.RS 3
87.52 -
87.53 -.LP
87.54 -.LP
87.55 -\f2% /path/to/jaxb/bin/xjc.sh \-help\fP
87.56 +\f2% xjc \-help\fP
87.57 .LP
87.58 .RE
87.59 -\f3For WindowsNT/2000/XP\fP
87.60 -.LP
87.61 -.RS 3
87.62 -
87.63 -.LP
87.64 -.LP
87.65 -\f2> c:\\path\\to\\jaxb\\bin\\xjc.bat \-help\fP
87.66 -.LP
87.67 -.RE
87.68 -.RE
87.69 -.RS 3
87.70 -
87.71 -.LP
87.72 \f3Output\fP
87.73 .LP
87.74 .RS 3
87.75 @@ -85,7 +68,9 @@
87.76 .fl
87.77 Compatibility Rules and App E.2 from the JAXB Spec
87.78 .fl
87.79 - \-b <file> : specify external bindings files (each <file> must have its own \-b)
87.80 + \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
87.81 +.fl
87.82 + If a directory is given, **/*.xjb is searched
87.83 .fl
87.84 \-d <dir> : generated files will go into this directory
87.85 .fl
87.86 @@ -105,6 +90,10 @@
87.87 .fl
87.88 \-npa : suppress generation of package level annotations (**/package\-info.java)
87.89 .fl
87.90 + \-no\-header : suppress generation of a file header with timestamp
87.91 +.fl
87.92 + \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
87.93 +.fl
87.94 \-xmlschema : treat input as W3C XML Schema (default)
87.95 .fl
87.96 \-relaxng : treat input as RELAX NG (experimental,unsupported)
87.97 @@ -128,37 +117,6 @@
87.98 .RE
87.99
87.100 .LP
87.101 -.RE
87.102 -.RS 3
87.103 -
87.104 -.LP
87.105 -\f3Execute the jaxb\-xjc.jar JAR File\fP
87.106 -.LP
87.107 -.RS 3
87.108 -
87.109 -.LP
87.110 -.LP
87.111 -If all else fails, you should be able to execute the \f2jaxb\-xjc.jar\fP file:
87.112 -.LP
87.113 -.RS 3
87.114 -
87.115 -.LP
87.116 -.RS 3
87.117 -.TP 3
87.118 -For Solaris/Linux:
87.119 -\f2% java \-jar $JAXB_HOME/lib/jaxb\-xjc.jar \-help\fP
87.120 -.TP 3
87.121 -For Windows:
87.122 -\f2> java \-jar %JAXB_HOME%\\lib\\jaxb\-xjc.jar \-help\fP
87.123 -.RE
87.124 -
87.125 -.LP
87.126 -.RE
87.127 -.LP
87.128 -This is equivalent of running "xjc.sh" or "xjc.bat", and it allows you to set the JVM parameters.
87.129 -.LP
87.130 -.RE
87.131 -.RE
87.132 .SH "OPTIONS"
87.133 .LP
87.134
87.135 @@ -169,10 +127,10 @@
87.136 By default, the XJC binding compiler performs strict validation of the source schema before processing it. Use this option to disable strict schema validation. This does not mean that the binding compiler will not perform any validation, it simply means that it will perform less\-strict validation.
87.137 .TP 3
87.138 \-extension
87.139 -By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions.
87.140 +By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions
87.141 .TP 3
87.142 \-b <file>
87.143 -Specify one or more external binding files to process. (Each binding file must have it's own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files:
87.144 +Specify one or more external binding files to process. (Each binding file must have its own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files:
87.145 .RS 3
87.146
87.147 .LP
87.148 @@ -206,8 +164,14 @@
87.149 \-npa
87.150 Supress the generation of package level annotations into **/package\-info.java. Using this switch causes the generated code to internalize those annotations into the other generated classes.
87.151 .TP 3
87.152 +\-no\-header
87.153 +Supress the generation of a file header comment that includes some note and timestamp. Using this makes the generated code more diff\-friendly.
87.154 +.TP 3
87.155 +\-target 2.0
87.156 +Avoid generating code that relies on any JAXB 2.1 features. This will allow the generated code to run with JAXB 2.0 runtime (such as JavaSE 6.)
87.157 +.TP 3
87.158 \-xmlschema
87.159 -treat input schemas as W3C XML Schema (default). If you do not specify this switch, your input schemas will be treated as W3C XML Schema.
87.160 +Treat input schemas as W3C XML Schema (default). If you do not specify this switch, your input schemas will be treated as W3C XML Schema.
87.161 .TP 3
87.162 \-relaxng
87.163 Treat input schemas as RELAX NG (experimental, unsupported). Support for RELAX NG schemas is provided as a JAXB Vendor Extension.
87.164 @@ -222,10 +186,10 @@
87.165 Treat input as WSDL and compile schemas inside it (experimental,unsupported).
87.166 .TP 3
87.167 \-quiet
87.168 -Suppress compiler output, such as progress information and warnings..
87.169 +Suppress compiler output, such as progress information and warnings.
87.170 .TP 3
87.171 \-verbose
87.172 -Be extra verbose, such as printing informational messages or displaying stack traces upon some errors..
87.173 +Be extra verbose, such as printing informational messages or displaying stack traces upon some errors.
87.174 .TP 3
87.175 \-help
87.176 Display a brief summary of the compiler switches.
87.177 @@ -303,138 +267,24 @@
87.178 .RS 3
87.179 .TP 2
87.180 o
87.181 -JAXB 2.0:
87.182 -.RS 3
87.183 -.TP 2
87.184 -*
87.185 +Running the binding compiler (XJC): [
87.186 .na
87.187 -\f2Release Notes\fP @
87.188 +\f2command\-line instructions\fP @
87.189 .fi
87.190 -http://java.sun.com/webservices/docs/2.0/jaxb/ReleaseNotes.html
87.191 -.TP 2
87.192 -*
87.193 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html,
87.194 .na
87.195 -\f2XJC\fP @
87.196 +\f2using the XJC Ant task\fP @
87.197 .fi
87.198 -http://java.sun.com/webservices/docs/2.0/jaxb/xjc.html
87.199 -.TP 2
87.200 -*
87.201 -.na
87.202 -\f2XJCTask\fP @
87.203 -.fi
87.204 -http://java.sun.com/webservices/docs/2.0/jaxb/xjcTask.html
87.205 -.TP 2
87.206 -*
87.207 -.na
87.208 -\f2SchemaGen\fP @
87.209 -.fi
87.210 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagen.html
87.211 -.TP 2
87.212 -*
87.213 -.na
87.214 -\f2schemagenTask\fP @
87.215 -.fi
87.216 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagenTask.html
87.217 -.TP 2
87.218 -*
87.219 -.na
87.220 -\f2Sample Apps\fP @
87.221 -.fi
87.222 -http://java.sun.com/webservices/docs/2.0/jaxb/samples.html
87.223 -.TP 2
87.224 -*
87.225 -.na
87.226 -\f2Changelog\fP @
87.227 -.fi
87.228 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog2.html
87.229 -.RE
87.230 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
87.231 .TP 2
87.232 o
87.233 -JAXB 1.0.x:
87.234 -.RS 3
87.235 -.TP 2
87.236 -*
87.237 .na
87.238 -\f2Release Notes\fP @
87.239 +\f2Java Architecture for XML Binding (JAXB)\fP @
87.240 .fi
87.241 -http://java.sun.com/webservices/docs/2.0/jaxb/jaxb\-1_0.html
87.242 -.TP 2
87.243 -*
87.244 -.na
87.245 -\f2Changelog\fP @
87.246 -.fi
87.247 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog.html
87.248 -.RE
87.249 -.TP 2
87.250 -o
87.251 -JAXB RI Extensions:
87.252 -.RS 3
87.253 -.TP 2
87.254 -*
87.255 -.na
87.256 -\f2Runtime Properties\fP @
87.257 -.fi
87.258 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorProperties.html
87.259 -.TP 2
87.260 -*
87.261 -.na
87.262 -\f2XJC Customizations\fP @
87.263 -.fi
87.264 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorCustomizations.html
87.265 -.TP 2
87.266 -*
87.267 -.na
87.268 -\f2Develop Plugins\fP @
87.269 -.fi
87.270 -http://java.sun.com/webservices/docs/2.0/jaxb/developPlugins.html
87.271 -.RE
87.272 -.TP 2
87.273 -o
87.274 -JAXB RI Schema Languages:
87.275 -.RS 3
87.276 -.TP 2
87.277 -*
87.278 -.na
87.279 -\f2W3C XML Schema\fP @
87.280 -.fi
87.281 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#xschema
87.282 -.TP 2
87.283 -*
87.284 -.na
87.285 -\f2RELAX NG\fP @
87.286 -.fi
87.287 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#relaxng
87.288 -.TP 2
87.289 -*
87.290 -.na
87.291 -\f2DTD\fP @
87.292 -.fi
87.293 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#dtd
87.294 -.RE
87.295 -.TP 2
87.296 -o
87.297 -JAXB Community:
87.298 -.RS 3
87.299 -.TP 2
87.300 -*
87.301 -.na
87.302 -\f2Java.net Homepage\fP @
87.303 -.fi
87.304 -http://jaxb.dev.java.net
87.305 -.TP 2
87.306 -*
87.307 -.na
87.308 -\f2Developer interest list\fP @
87.309 -.fi
87.310 -https://jaxb.dev.java.net/servlets/ProjectMailingListList
87.311 -.TP 2
87.312 -*
87.313 -.na
87.314 -\f2FAQ\fP @
87.315 -.fi
87.316 -https://jaxb.dev.java.net/faq/index.html
87.317 -.RE
87.318 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
87.319 .RE
87.320
87.321 .LP
87.322 +
87.323 +.LP
87.324
88.1 --- a/src/share/classes/java/awt/GraphicsDevice.java Tue May 12 15:21:55 2009 +0900
88.2 +++ b/src/share/classes/java/awt/GraphicsDevice.java Thu May 14 00:17:25 2009 -0700
88.3 @@ -282,7 +282,7 @@
88.4 w.setOpacity(1.0f);
88.5 }
88.6 Color bgColor = w.getBackground();
88.7 - if (bgColor.getAlpha() < 255) {
88.8 + if ((bgColor != null) && (bgColor.getAlpha() < 255)) {
88.9 bgColor = new Color(bgColor.getRed(), bgColor.getGreen(),
88.10 bgColor.getBlue(), 255);
88.11 w.setBackground(bgColor);
89.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
89.2 +++ b/src/share/classes/java/dyn/CallSite.java Thu May 14 00:17:25 2009 -0700
89.3 @@ -0,0 +1,224 @@
89.4 +/*
89.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
89.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
89.7 + *
89.8 + * This code is free software; you can redistribute it and/or modify it
89.9 + * under the terms of the GNU General Public License version 2 only, as
89.10 + * published by the Free Software Foundation. Sun designates this
89.11 + * particular file as subject to the "Classpath" exception as provided
89.12 + * by Sun in the LICENSE file that accompanied this code.
89.13 + *
89.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
89.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
89.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
89.17 + * version 2 for more details (a copy is included in the LICENSE file that
89.18 + * accompanied this code).
89.19 + *
89.20 + * You should have received a copy of the GNU General Public License version
89.21 + * 2 along with this work; if not, write to the Free Software Foundation,
89.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
89.23 + *
89.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
89.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
89.26 + * have any questions.
89.27 + */
89.28 +
89.29 +package java.dyn;
89.30 +
89.31 +import sun.dyn.util.BytecodeName;
89.32 +
89.33 +/**
89.34 + * An {@code invokedynamic} call site, as reified by the
89.35 + * containing class's bootstrap method.
89.36 + * Every call site object corresponds to a distinct instance
89.37 + * of the <code>invokedynamic</code> instruction, and vice versa.
89.38 + * Every call site has one state variable, called the {@code target}.
89.39 + * It is typed as a {@link MethodHandle}. This state is never null, and
89.40 + * it is the responsibility of the bootstrap method to produce call sites
89.41 + * which have been pre-linked to an initial target method.
89.42 + * <p>
89.43 + * (Note: The bootstrap method may elect to produce call sites of a
89.44 + * language-specific subclass of {@code CallSite}. In such a case,
89.45 + * the subclass may claim responsibility for initializing its target to
89.46 + * a non-null value, by overriding {@link #initialTarget}.)
89.47 + * <p>
89.48 + * An {@code invokedynamic} instruction which has not yet been executed
89.49 + * is said to be <em>unlinked</em>. When an unlinked call site is executed,
89.50 + * the containing class's bootstrap method is called to manufacture a call site,
89.51 + * for the instruction. If the bootstrap method does not assign a non-null
89.52 + * value to the new call site's target variable, the method {@link #initialTarget}
89.53 + * is called to produce the new call site's first target method.
89.54 + * <p>
89.55 + * @see Linkage#registerBootstrapMethod(java.lang.Class, java.dyn.MethodHandle)
89.56 + * @author John Rose, JSR 292 EG
89.57 + */
89.58 +public class CallSite {
89.59 + // Fields used only by the JVM. Do not use or change.
89.60 + private Object vmmethod;
89.61 + int callerMID, callerBCI; // supplied by the JVM
89.62 +
89.63 + MethodHandle target;
89.64 + final Object caller; // usually a class
89.65 + final String name;
89.66 + final MethodType type;
89.67 +
89.68 + /**
89.69 + * Make a call site given the parameters from a call to the bootstrap method.
89.70 + * The resulting call site is in an unlinked state, which means that before
89.71 + * it is returned from a bootstrap method call it must be provided with
89.72 + * a target method via a call to {@link CallSite#setTarget}.
89.73 + * @param caller the class in which the relevant {@code invokedynamic} instruction occurs
89.74 + * @param name the name specified by the {@code invokedynamic} instruction
89.75 + * @param type the method handle type derived from descriptor of the {@code invokedynamic} instruction
89.76 + */
89.77 + public CallSite(Object caller, String name, MethodType type) {
89.78 + this.caller = caller;
89.79 + this.name = name;
89.80 + this.type = type;
89.81 + }
89.82 +
89.83 + private static void privateInitializeCallSite(CallSite site, int callerMID, int callerBCI) {
89.84 + site.callerMID = callerMID;
89.85 + site.callerBCI = callerBCI;
89.86 + if (site.target == null)
89.87 + site.setTarget(site.initialTarget());
89.88 + }
89.89 +
89.90 + /**
89.91 + * Just after a call site is created by a bootstrap method handle,
89.92 + * if the target has not been initialized by the factory method itself,
89.93 + * the method {@code initialTarget} is called to produce an initial
89.94 + * non-null target. (Live call sites must never have null targets.)
89.95 + * <p>
89.96 + * If the bootstrap method itself does not initialize the call site,
89.97 + * this method must be overridden, because it just raises an
89.98 + * {@code InvokeDynamicBootstrapError}, which in turn causes the
89.99 + * linkage of the {@code invokedynamic} instruction to terminate
89.100 + * abnormally.
89.101 + */
89.102 + protected MethodHandle initialTarget() {
89.103 + throw new InvokeDynamicBootstrapError("target must be initialized before call site is linked: "+this);
89.104 + }
89.105 +
89.106 + /**
89.107 + * Report the current linkage state of the call site. (This is mutable.)
89.108 + * The value maybe null only if the call site is currently unlinked.
89.109 + * When a linked call site is invoked, the target method is used directly.
89.110 + * When an unlinked call site is invoked, its bootstrap method receives
89.111 + * the call, as if via {@link Linkage#bootstrapInvokeDynamic}.
89.112 + * <p>
89.113 + * The interactions of {@code getTarget} with memory are the same
89.114 + * as of a read from an ordinary variable, such as an array element or a
89.115 + * non-volatile, non-final field.
89.116 + * <p>
89.117 + * In particular, the current thread may choose to reuse the result
89.118 + * of a previous read of the target from memory, and may fail to see
89.119 + * a recent update to the target by another thread.
89.120 + * @return the current linkage state of the call site
89.121 + * @see #setTarget
89.122 + */
89.123 + public MethodHandle getTarget() {
89.124 + return target;
89.125 + }
89.126 +
89.127 + /**
89.128 + * Link or relink the call site, by setting its target method.
89.129 + * <p>
89.130 + * The interactions of {@code setTarget} with memory are the same
89.131 + * as of a write to an ordinary variable, such as an array element or a
89.132 + * non-volatile, non-final field.
89.133 + * <p>
89.134 + * In particular, unrelated threads may fail to see the updated target
89.135 + * until they perform a read from memory.
89.136 + * Stronger guarantees can be created by putting appropriate operations
89.137 + * into the bootstrap method and/or the target methods used
89.138 + * at any given call site.
89.139 + * @param target the new target, or null if it is to be unlinked
89.140 + * @throws NullPointerException if the proposed new target is null
89.141 + * @throws WrongMethodTypeException if the proposed new target
89.142 + * has a method type that differs from the call site's {@link #type()}
89.143 + */
89.144 + public void setTarget(MethodHandle target) {
89.145 + checkTarget(target);
89.146 + this.target = target;
89.147 + }
89.148 +
89.149 + protected void checkTarget(MethodHandle target) {
89.150 + target.type(); // provoke NPE
89.151 + if (!canSetTarget(target))
89.152 + throw new WrongMethodTypeException(String.valueOf(target));
89.153 + }
89.154 +
89.155 + protected boolean canSetTarget(MethodHandle target) {
89.156 + return (target != null && target.type() == type());
89.157 + }
89.158 +
89.159 + /**
89.160 + * Report the class containing the call site.
89.161 + * This is an immutable property of the call site, set from the first argument to the constructor.
89.162 + * @return class containing the call site
89.163 + */
89.164 + public Class<?> callerClass() {
89.165 + return (Class) caller;
89.166 + }
89.167 +
89.168 + /**
89.169 + * Report the method name specified in the {@code invokedynamic} instruction.
89.170 + * This is an immutable property of the call site, set from the second argument to the constructor.
89.171 + * <p>
89.172 + * Note that the name is a JVM bytecode name, and as such can be any
89.173 + * non-empty string, as long as it does not contain certain "dangerous"
89.174 + * characters such as slash {@code '/'} and dot {@code '.'}.
89.175 + * See the Java Virtual Machine specification for more details.
89.176 + * <p>
89.177 + * Application such as a language runtimes may need to encode
89.178 + * arbitrary program element names and other configuration information
89.179 + * into the name. A standard convention for doing this is
89.180 + * <a href="http://blogs.sun.com/jrose/entry/symbolic_freedom_in_the_vm">specified here</a>.
89.181 + * @return method name specified by the call site
89.182 + */
89.183 + public String name() {
89.184 + return name;
89.185 + }
89.186 +
89.187 + /**
89.188 + * Report the method name specified in the {@code invokedynamic} instruction,
89.189 + * as a series of components, individually demangled according to
89.190 + * the standard convention
89.191 + * <a href="http://blogs.sun.com/jrose/entry/symbolic_freedom_in_the_vm">specified here</a>.
89.192 + * <p>
89.193 + * Non-empty runs of characters between dangerous characters are demangled.
89.194 + * Each component is either a completely arbitrary demangled string,
89.195 + * or else a character constant for a punctuation character, typically ':'.
89.196 + * (In principle, the character can be any dangerous character that the
89.197 + * JVM lets through in a method name, such as '$' or ']'.
89.198 + * Runtime implementors are encouraged to use colon ':' for building
89.199 + * structured names.)
89.200 + * <p>
89.201 + * In the common case where the name contains no dangerous characters,
89.202 + * the result is an array whose only element array is the demangled
89.203 + * name at the call site. Such a demangled name can be any sequence
89.204 + * of any number of any unicode characters.
89.205 + * @return method name components specified by the call site
89.206 + */
89.207 + public Object[] nameComponents() {
89.208 + return BytecodeName.parseBytecodeName(name);
89.209 + }
89.210 +
89.211 + /**
89.212 + * Report the resolved result and parameter types of this call site,
89.213 + * which are derived from its bytecode-level invocation descriptor.
89.214 + * The types are packaged into a {@link MethodType}.
89.215 + * Any linked target of this call site must be exactly this method type.
89.216 + * This is an immutable property of the call site, set from the third argument to the constructor.
89.217 + * @return method type specified by the call site
89.218 + */
89.219 + public MethodType type() {
89.220 + return type;
89.221 + }
89.222 +
89.223 + @Override
89.224 + public String toString() {
89.225 + return "CallSite#"+hashCode()+"["+name+type+" => "+target+"]";
89.226 + }
89.227 +}
90.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
90.2 +++ b/src/share/classes/java/dyn/InvokeDynamic.java Thu May 14 00:17:25 2009 -0700
90.3 @@ -0,0 +1,54 @@
90.4 +/*
90.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
90.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
90.7 + *
90.8 + * This code is free software; you can redistribute it and/or modify it
90.9 + * under the terms of the GNU General Public License version 2 only, as
90.10 + * published by the Free Software Foundation. Sun designates this
90.11 + * particular file as subject to the "Classpath" exception as provided
90.12 + * by Sun in the LICENSE file that accompanied this code.
90.13 + *
90.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
90.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
90.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
90.17 + * version 2 for more details (a copy is included in the LICENSE file that
90.18 + * accompanied this code).
90.19 + *
90.20 + * You should have received a copy of the GNU General Public License version
90.21 + * 2 along with this work; if not, write to the Free Software Foundation,
90.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
90.23 + *
90.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
90.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
90.26 + * have any questions.
90.27 + */
90.28 +
90.29 +package java.dyn;
90.30 +
90.31 +/**
90.32 + * Syntactic marker to request javac to emit an {@code invokedynamic} instruction.
90.33 + * An {@code invokedynamic} instruction is a 5-byte bytecoded instruction
90.34 + * which begins with an opcode byte of value 186 ({@code 0xBA}),
90.35 + * and is followed by a two-byte index of a {@code NameAndType} constant
90.36 + * pool entry, then by two zero bytes. The constant pool reference gives
90.37 + * the method name and argument and return types of the call site; there
90.38 + * is no other information provided at the call site.
90.39 + * <p>
90.40 + * The {@code invokedynamic} instruction is incomplete without a target method.
90.41 + * The target method is a property of the reified call site object
90.42 + * (of type {@link CallSite}) which is in a one-to-one association with each
90.43 + * corresponding {@code invokedynamic} instruction. The call site object
90.44 + * is initially produced by a <em>bootstrap method</em> associated with
90.45 + * the call site, via the various overloadings of {@link Linkage#registerBootstrapMethod}.
90.46 + * <p>
90.47 + * The type {@code InvokeDynamic} has no particular meaning as a
90.48 + * class or interface supertype, or an object type; it can never be instantiated.
90.49 + * Logically, it denotes a source of all dynamically typed methods.
90.50 + * It may be viewed as a pure syntactic marker (an importable one) of static calls.
90.51 + * @author John Rose, JSR 292 EG
90.52 + */
90.53 +public final class InvokeDynamic {
90.54 + private InvokeDynamic() { throw new InternalError(); } // do not instantiate
90.55 +
90.56 + // no statically defined static methods
90.57 +}
91.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
91.2 +++ b/src/share/classes/java/dyn/InvokeDynamicBootstrapError.java Thu May 14 00:17:25 2009 -0700
91.3 @@ -0,0 +1,55 @@
91.4 +/*
91.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
91.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
91.7 + *
91.8 + * This code is free software; you can redistribute it and/or modify it
91.9 + * under the terms of the GNU General Public License version 2 only, as
91.10 + * published by the Free Software Foundation. Sun designates this
91.11 + * particular file as subject to the "Classpath" exception as provided
91.12 + * by Sun in the LICENSE file that accompanied this code.
91.13 + *
91.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
91.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
91.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
91.17 + * version 2 for more details (a copy is included in the LICENSE file that
91.18 + * accompanied this code).
91.19 + *
91.20 + * You should have received a copy of the GNU General Public License version
91.21 + * 2 along with this work; if not, write to the Free Software Foundation,
91.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
91.23 + *
91.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
91.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
91.26 + * have any questions.
91.27 + */
91.28 +
91.29 +package java.dyn;
91.30 +
91.31 +/**
91.32 + * Thrown to indicate that an {@code invokedynamic} instruction has
91.33 + * failed to find its bootstrap method, or the bootstrap method has
91.34 + * failed to provide a call site with a non-null target.
91.35 + * <p>
91.36 + * The boostrap method must have been declared during a class's initialization
91.37 + * by a call to {@link Linkage#registerBootstrapMethod}.
91.38 + *
91.39 + * @author John Rose, JSR 292 EG
91.40 + */
91.41 +public class InvokeDynamicBootstrapError extends LinkageError {
91.42 + /**
91.43 + * Constructs a {@code InvokeDynamicBootstrapError} with no detail message.
91.44 + */
91.45 + public InvokeDynamicBootstrapError() {
91.46 + super();
91.47 + }
91.48 +
91.49 + /**
91.50 + * Constructs a {@code InvokeDynamicBootstrapError} with the specified
91.51 + * detail message.
91.52 + *
91.53 + * @param s the detail message.
91.54 + */
91.55 + public InvokeDynamicBootstrapError(String s) {
91.56 + super(s);
91.57 + }
91.58 +}
92.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
92.2 +++ b/src/share/classes/java/dyn/JavaMethodHandle.java Thu May 14 00:17:25 2009 -0700
92.3 @@ -0,0 +1,83 @@
92.4 +/*
92.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
92.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
92.7 + *
92.8 + * This code is free software; you can redistribute it and/or modify it
92.9 + * under the terms of the GNU General Public License version 2 only, as
92.10 + * published by the Free Software Foundation. Sun designates this
92.11 + * particular file as subject to the "Classpath" exception as provided
92.12 + * by Sun in the LICENSE file that accompanied this code.
92.13 + *
92.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
92.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
92.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
92.17 + * version 2 for more details (a copy is included in the LICENSE file that
92.18 + * accompanied this code).
92.19 + *
92.20 + * You should have received a copy of the GNU General Public License version
92.21 + * 2 along with this work; if not, write to the Free Software Foundation,
92.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
92.23 + *
92.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
92.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
92.26 + * have any questions.
92.27 + */
92.28 +
92.29 +package java.dyn;
92.30 +
92.31 +/**
92.32 + * A Java method handle extends the basic method handle type with additional
92.33 + * programmer defined methods and fields.
92.34 + * Its behavior as a method handle is determined at instance creation time,
92.35 + * by providing the new instance with an "entry point" method handle
92.36 + * to handle calls. This entry point must accept a leading argument
92.37 + * whose type is the Java method handle itself or a supertype, and the
92.38 + * entry point is always called with the Java method handle itself as
92.39 + * the first argument. This is similar to ordinary virtual methods, which also
92.40 + * accept the receiver object {@code this} as an implicit leading argument.
92.41 + * The {@code MethodType} of the Java method handle is the same as that
92.42 + * of the entry point method handle, with the leading parameter type
92.43 + * omitted.
92.44 + * <p>
92.45 + * Here is an example of usage:
92.46 + * <p><blockquote><pre>
92.47 + * class Greeter extends JavaMethodHandle {
92.48 + * public void run() { System.out.println("hello, "+greetee); }
92.49 + * private final String greetee;
92.50 + * Greeter(String greetee) {
92.51 + * super(RUN);
92.52 + * this.greetee = greetee;
92.53 + * }
92.54 + * // the entry point function is computed once:
92.55 + * private static final MethodHandle RUN
92.56 + * = MethodHandles.findVirtual(MyMethodHandle.class, "run",
92.57 + * MethodType.make(void.class));
92.58 + * }
92.59 + * Greeter greeter = new Greeter("world");
92.60 + * greeter.run(); // prints "hello, world"
92.61 + * MethodHandle mh = greeter;
92.62 + * mh.invoke(); // also prints "hello, world"
92.63 + * </pre></blockquote>
92.64 + * <p>
92.65 + * In this example, the method {@code run} provides the entry point.
92.66 + * The entry point need not be a constant value; it may be independently
92.67 + * computed in each call to the constructor. The entry point does not
92.68 + * even need to be a method on the Java method handle class, though
92.69 + * that is the typical case.
92.70 + * @see MethodHandle
92.71 + * @author John Rose, JSR 292 EG
92.72 + */
92.73 +public abstract class JavaMethodHandle
92.74 + // Note: This is an implementation inheritance hack, and will be removed
92.75 + // with a JVM change which moves the required hidden behavior onto this class.
92.76 + extends sun.dyn.BoundMethodHandle
92.77 +{
92.78 + /**
92.79 + * When creating a, pass in {@code entryPoint}, any method handle which
92.80 + * can take the current object
92.81 + * @param entryPoint
92.82 + */
92.83 + protected JavaMethodHandle(MethodHandle entryPoint) {
92.84 + super(entryPoint, 0);
92.85 + }
92.86 +}
93.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
93.2 +++ b/src/share/classes/java/dyn/Linkage.java Thu May 14 00:17:25 2009 -0700
93.3 @@ -0,0 +1,209 @@
93.4 +/*
93.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
93.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
93.7 + *
93.8 + * This code is free software; you can redistribute it and/or modify it
93.9 + * under the terms of the GNU General Public License version 2 only, as
93.10 + * published by the Free Software Foundation. Sun designates this
93.11 + * particular file as subject to the "Classpath" exception as provided
93.12 + * by Sun in the LICENSE file that accompanied this code.
93.13 + *
93.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
93.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
93.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
93.17 + * version 2 for more details (a copy is included in the LICENSE file that
93.18 + * accompanied this code).
93.19 + *
93.20 + * You should have received a copy of the GNU General Public License version
93.21 + * 2 along with this work; if not, write to the Free Software Foundation,
93.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
93.23 + *
93.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
93.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
93.26 + * have any questions.
93.27 + */
93.28 +
93.29 +package java.dyn;
93.30 +
93.31 +import java.util.WeakHashMap;
93.32 +import sun.reflect.Reflection;
93.33 +import static sun.dyn.util.VerifyAccess.checkBootstrapPrivilege;
93.34 +
93.35 +/**
93.36 + * Static methods which control the linkage of invokedynamic call sites.
93.37 + * @author John Rose, JSR 292 EG
93.38 + */
93.39 +public class Linkage {
93.40 + private Linkage() {} // do not instantiate
93.41 +
93.42 + /**
93.43 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.44 + * Register a <em>bootstrap method</em> to use when linking a given caller class.
93.45 + * It must be a method handle of a type equivalent to {@link CallSite#CallSite}.
93.46 + * In other words, it must act as a factory method which accepts the arguments
93.47 + * to {@code CallSite}'s constructor (a class, a string, and a method type),
93.48 + * and returns a {@code CallSite} object (possibly of a subclass of {@code CallSite}).
93.49 + * <p>
93.50 + * The registration will fail with an {@code IllegalStateException} if any of the following conditions hold:
93.51 + * <ul>
93.52 + * <li>The caller of this method is in a different package than the {@code callerClass},
93.53 + * and there is a security manager, and its {@code checkPermission} call throws
93.54 + * when passed {@link LinkagePermission}("registerBootstrapMethod",callerClass).
93.55 + * <li>The given class already has a bootstrap method from a previous
93.56 + * call to this method.
93.57 + * <li>The given class is already fully initialized.
93.58 + * <li>The given class is in the process of initialization, in another thread.
93.59 + * </ul>
93.60 + * Because of these rules, a class may install its own bootstrap method in
93.61 + * a static initializer.
93.62 + */
93.63 + public static
93.64 + void registerBootstrapMethod(Class callerClass, MethodHandle mh) {
93.65 + Class callc = Reflection.getCallerClass(2);
93.66 + checkBootstrapPrivilege(callc, callerClass, "registerBootstrapMethod");
93.67 + checkBSM(mh);
93.68 + synchronized (bootstrapMethods) {
93.69 + if (bootstrapMethods.containsKey(callerClass))
93.70 + throw new IllegalStateException("bootstrap method already declared in "+callerClass);
93.71 + bootstrapMethods.put(callerClass, mh);
93.72 + }
93.73 + }
93.74 +
93.75 + static void checkBSM(MethodHandle mh) {
93.76 + if (mh == null) throw new IllegalArgumentException("null bootstrap method");
93.77 + if (mh.type() == OLD_BOOTSTRAP_METHOD_TYPE) // FIXME: delete at EDR/PFD
93.78 + throw new WrongMethodTypeException("bootstrap method must be a CallSite factory");
93.79 + if (mh.type() != BOOTSTRAP_METHOD_TYPE)
93.80 + throw new WrongMethodTypeException(mh.toString());
93.81 + }
93.82 +
93.83 + /**
93.84 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.85 + * Simplified version of registerBootstrapMethod for self-registration,
93.86 + * to be called from a static initializer.
93.87 + * Finds a static method of the required type in the
93.88 + * given class, and installs it on the caller.
93.89 + * @throws IllegalArgumentException if there is no such method
93.90 + */
93.91 + public static
93.92 + void registerBootstrapMethod(Class<?> runtime, String name) {
93.93 + Class callc = Reflection.getCallerClass(2);
93.94 + MethodHandle bootstrapMethod =
93.95 + MethodHandles.findStaticFrom(callc, runtime, name, BOOTSTRAP_METHOD_TYPE);
93.96 + // FIXME: exception processing wrong here
93.97 + checkBSM(bootstrapMethod);
93.98 + Linkage.registerBootstrapMethod(callc, bootstrapMethod);
93.99 + }
93.100 +
93.101 + /**
93.102 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.103 + * Simplified version of registerBootstrapMethod for self-registration,
93.104 + * to be called from a static initializer.
93.105 + * Finds a static method of the required type in the
93.106 + * caller's class, and installs it on the caller.
93.107 + * @throws IllegalArgumentException if there is no such method
93.108 + */
93.109 + public static
93.110 + void registerBootstrapMethod(String name) {
93.111 + Class callc = Reflection.getCallerClass(2);
93.112 + MethodHandle bootstrapMethod =
93.113 + MethodHandles.findStaticFrom(callc, callc, name, BOOTSTRAP_METHOD_TYPE);
93.114 + // FIXME: exception processing wrong here
93.115 + checkBSM(bootstrapMethod);
93.116 + Linkage.registerBootstrapMethod(callc, bootstrapMethod);
93.117 + }
93.118 +
93.119 + /**
93.120 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.121 + * Report the bootstrap method registered for a given class.
93.122 + * Returns null if the class has never yet registered a bootstrap method,
93.123 + * or if the class has explicitly registered a null bootstrap method.
93.124 + * Only callers privileged to set the bootstrap method may inquire
93.125 + * about it, because a bootstrap method is potentially a back-door entry
93.126 + * point into its class.
93.127 + */
93.128 + public static
93.129 + MethodHandle getBootstrapMethod(Class callerClass) {
93.130 + Class callc = Reflection.getCallerClass(2);
93.131 + checkBootstrapPrivilege(callc, callerClass, "registerBootstrapMethod");
93.132 + synchronized (bootstrapMethods) {
93.133 + return bootstrapMethods.get(callerClass);
93.134 + }
93.135 + }
93.136 +
93.137 + /**
93.138 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.139 + * The type of any bootstrap method is a three-argument method
93.140 + * {@code (Class, String, MethodType)} returning a {@code CallSite}.
93.141 + */
93.142 + public static final MethodType BOOTSTRAP_METHOD_TYPE
93.143 + = MethodType.make(CallSite.class,
93.144 + Class.class, String.class, MethodType.class);
93.145 +
93.146 + private static final MethodType OLD_BOOTSTRAP_METHOD_TYPE
93.147 + = MethodType.make(Object.class,
93.148 + CallSite.class, Object[].class);
93.149 +
93.150 + private static final WeakHashMap<Class, MethodHandle> bootstrapMethods =
93.151 + new WeakHashMap<Class, MethodHandle>();
93.152 +
93.153 + /**
93.154 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.155 + * Invalidate all <code>invokedynamic</code> call sites everywhere.
93.156 + * <p>
93.157 + * When this method returns, every <code>invokedynamic</code> instruction
93.158 + * will invoke its bootstrap method on next call.
93.159 + * <p>
93.160 + * It is unspecified whether call sites already known to the Java
93.161 + * code will continue to be associated with <code>invokedynamic</code>
93.162 + * instructions. If any call site is still so associated, its
93.163 + * {@link CallSite#getTarget()} method is guaranteed to return null
93.164 + * the invalidation operation completes.
93.165 + * <p>
93.166 + * Invalidation operations are likely to be slow. Use them sparingly.
93.167 + */
93.168 + public static
93.169 + Object invalidateAll() {
93.170 + SecurityManager security = System.getSecurityManager();
93.171 + if (security != null) {
93.172 + security.checkPermission(new LinkagePermission("invalidateAll"));
93.173 + }
93.174 + throw new UnsupportedOperationException("NYI");
93.175 + }
93.176 +
93.177 + /**
93.178 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
93.179 + * Invalidate all <code>invokedynamic</code> call sites associated
93.180 + * with the given class.
93.181 + * (These are exactly those sites which report the given class
93.182 + * via the {@link CallSite#callerClass()} method.)
93.183 + * <p>
93.184 + * When this method returns, every matching <code>invokedynamic</code>
93.185 + * instruction will invoke its bootstrap method on next call.
93.186 + * <p>
93.187 + * For additional semantics of call site invalidation,
93.188 + * see {@link #invalidateAll()}.
93.189 + */
93.190 + public static
93.191 + Object invalidateCallerClass(Class<?> callerClass) {
93.192 + SecurityManager security = System.getSecurityManager();
93.193 + if (security != null) {
93.194 + security.checkPermission(new LinkagePermission("invalidateAll", callerClass));
93.195 + }
93.196 + throw new UnsupportedOperationException("NYI");
93.197 + }
93.198 +
93.199 + private static Object doNotBootstrap(CallSite site, Object... arguments) {
93.200 + throw new UnsupportedOperationException("call site must not have null target: "+site);
93.201 + }
93.202 +
93.203 + private static final MethodHandle DO_NOT_BOOTSTRAP =
93.204 + MethodHandles.Lookup.IMPL_LOOKUP.findStatic(Linkage.class, "doNotBootstrap",
93.205 + OLD_BOOTSTRAP_METHOD_TYPE);
93.206 +
93.207 + // Up-call from the JVM. Obsolete. FIXME: Delete from VM then from here.
93.208 + static
93.209 + MethodHandle findBootstrapMethod(Class callerClass, Class searchBootstrapClass) {
93.210 + return DO_NOT_BOOTSTRAP;
93.211 + }
93.212 +}
94.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
94.2 +++ b/src/share/classes/java/dyn/LinkagePermission.java Thu May 14 00:17:25 2009 -0700
94.3 @@ -0,0 +1,111 @@
94.4 +/*
94.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
94.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
94.7 + *
94.8 + * This code is free software; you can redistribute it and/or modify it
94.9 + * under the terms of the GNU General Public License version 2 only, as
94.10 + * published by the Free Software Foundation. Sun designates this
94.11 + * particular file as subject to the "Classpath" exception as provided
94.12 + * by Sun in the LICENSE file that accompanied this code.
94.13 + *
94.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
94.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
94.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
94.17 + * version 2 for more details (a copy is included in the LICENSE file that
94.18 + * accompanied this code).
94.19 + *
94.20 + * You should have received a copy of the GNU General Public License version
94.21 + * 2 along with this work; if not, write to the Free Software Foundation,
94.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
94.23 + *
94.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
94.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
94.26 + * have any questions.
94.27 + */
94.28 +
94.29 +package java.dyn;
94.30 +
94.31 +import java.security.*;
94.32 +import java.util.Enumeration;
94.33 +import java.util.Hashtable;
94.34 +import java.util.StringTokenizer;
94.35 +
94.36 +/**
94.37 + * This class is for runtime permissions. A RuntimePermission
94.38 + * contains a name (also referred to as a "target name") but
94.39 + * no actions list; you either have the named permission
94.40 + * or you don't.
94.41 + *
94.42 + * <P>
94.43 + * The target name is the name of the runtime permission (see below). The
94.44 + * naming convention follows the hierarchical property naming convention.
94.45 + * Also, an asterisk
94.46 + * may appear at the end of the name, following a ".", or by itself, to
94.47 + * signify a wildcard match. For example: "loadLibrary.*" or "*" is valid,
94.48 + * "*loadLibrary" or "a*b" is not valid.
94.49 + * <P>
94.50 + * The following table lists all the possible RuntimePermission target names,
94.51 + * and for each provides a description of what the permission allows
94.52 + * and a discussion of the risks of granting code the permission.
94.53 + * <P>
94.54 + *
94.55 + * <table border=1 cellpadding=5 summary="permission target name,
94.56 + * what the target allows,and associated risks">
94.57 + * <tr>
94.58 + * <th>Permission Target Name</th>
94.59 + * <th>What the Permission Allows</th>
94.60 + * <th>Risks of Allowing this Permission</th>
94.61 + * </tr>
94.62 + *
94.63 + * <tr>
94.64 + * <td>registerBootstrapMethod.{class name}</td>
94.65 + * <td>Specifying a bootstrap method for invokedynamic, within a class of the given name</td>
94.66 + * <td>An attacker could attempt to attach a bootstrap method to a class which
94.67 + * has just been loaded, thus gaining control of its invokedynamic calls.</td>
94.68 + * </tr>
94.69 + *
94.70 + * <tr>
94.71 + * <td>invalidateAll</td>
94.72 + * <td>Force the relinking of invokedynamic call sites everywhere.</td>
94.73 + * <td>This could allow an attacker to slow down the system, or perhaps surface timing bugs in a dynamic language implementations, by forcing redundant relinking operations.</td>
94.74 + * </tr>
94.75 + *
94.76 + *
94.77 + * <tr>
94.78 + * <td>invalidateCallerClass.{class name}</td>
94.79 + * <td>Force the relinking of invokedynamic call sites in the given class.</td>
94.80 + * <td>See {@code invalidateAll}.</td>
94.81 + * </tr>
94.82 + * </table>
94.83 + *
94.84 + * @see java.security.BasicPermission
94.85 + * @see java.lang.SecurityManager
94.86 + *
94.87 + * @author John Rose, JSR 292 EG
94.88 + */
94.89 +
94.90 +public final class LinkagePermission extends BasicPermission {
94.91 + /**
94.92 + * Create a new LinkagePermission with the given name.
94.93 + * The name is the symbolic name of the LinkagePermission, such as
94.94 + * "registerBootstrapMethod", "invalidateClass.*", etc. An asterisk
94.95 + * may appear at the end of the name, following a ".", or by itself, to
94.96 + * signify a wildcard match.
94.97 + *
94.98 + * @param name the name of the LinkagePermission
94.99 + */
94.100 + public LinkagePermission(String name) {
94.101 + super(name);
94.102 + }
94.103 +
94.104 + /**
94.105 + * Create a new LinkagePermission with the given name on the given class.
94.106 + * Equivalent to {@code LinkagePermission(name+"."+clazz.getName())}.
94.107 + *
94.108 + * @param name the name of the LinkagePermission
94.109 + * @param clazz the class affected by the permission
94.110 + */
94.111 + public LinkagePermission(String name, Class<?> clazz) {
94.112 + super(name + "." + clazz.getName());
94.113 + }
94.114 +}
95.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
95.2 +++ b/src/share/classes/java/dyn/MethodHandle.java Thu May 14 00:17:25 2009 -0700
95.3 @@ -0,0 +1,135 @@
95.4 +/*
95.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
95.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
95.7 + *
95.8 + * This code is free software; you can redistribute it and/or modify it
95.9 + * under the terms of the GNU General Public License version 2 only, as
95.10 + * published by the Free Software Foundation. Sun designates this
95.11 + * particular file as subject to the "Classpath" exception as provided
95.12 + * by Sun in the LICENSE file that accompanied this code.
95.13 + *
95.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
95.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
95.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
95.17 + * version 2 for more details (a copy is included in the LICENSE file that
95.18 + * accompanied this code).
95.19 + *
95.20 + * You should have received a copy of the GNU General Public License version
95.21 + * 2 along with this work; if not, write to the Free Software Foundation,
95.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
95.23 + *
95.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
95.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
95.26 + * have any questions.
95.27 + */
95.28 +
95.29 +package java.dyn;
95.30 +
95.31 +//import sun.dyn.*;
95.32 +
95.33 +import sun.dyn.Access;
95.34 +import sun.dyn.MethodHandleImpl;
95.35 +
95.36 +/**
95.37 + * A method handle is a typed reference to the entry point of a method.
95.38 + * <p>
95.39 + * Method handles are strongly typed according to signature.
95.40 + * They are not distinguished by method name or enclosing class.
95.41 + * A method handle must be invoked under a signature which exactly matches
95.42 + * the method handle's own type.
95.43 + * <p>
95.44 + * Every method handle confesses its type via the <code>type</code> accessor.
95.45 + * The structure of this type is a series of classes, one of which is
95.46 + * the return type of the method (or <code>void.class</code> if none).
95.47 + * <p>
95.48 + * Every method handle appears as an object containing a method named
95.49 + * <code>invoke</code>, whose signature exactly matches
95.50 + * the method handle's type.
95.51 + * A normal Java method call (using the <code>invokevirtual</code> instruction)
95.52 + * can invoke this method from Java source code (if language support is present).
95.53 + * <p>
95.54 + * Every call to a method handle specifies an intended method type,
95.55 + * which must exactly match the type of the method handle.
95.56 + * (The type is specified in the <code>invokevirtual</code> instruction,
95.57 + * via a {@code CONSTANT_NameAndType} constant pool entry.)
95.58 + * The call looks within the receiver object for a method
95.59 + * named <code>invoke</code> of the intended method type.
95.60 + * The call fails with a {@link WrongMethodTypeException}
95.61 + * if the method does not exist, even if there is an <code>invoke</code>
95.62 + * method of a closely similar signature.
95.63 + * <p>
95.64 + * A method handle is an unrestricted capability to call a method.
95.65 + * A method handle can be formed on a non-public method by a class
95.66 + * that has access to that method; the resulting handle can be used
95.67 + * in any place by any caller who receives a reference to it. Thus, access
95.68 + * checking is performed when the method handle is created, not
95.69 + * (as in reflection) every time it is called. Handles to non-public
95.70 + * methods, or in non-public classes, should generally be kept secret.
95.71 + * They should not be passed to untrusted code.
95.72 + * <p>
95.73 + * Bytecode in an extended JVM can directly call a method handle's
95.74 + * <code>invoke</code> from an <code>invokevirtual</code> instruction.
95.75 + * The receiver class type must be <code>MethodHandle</code> and the method name
95.76 + * must be <code>invoke</code>. The signature of the invocation
95.77 + * (after resolving symbolic type names) must exactly match the method type
95.78 + * of the target method.
95.79 + * <p>
95.80 + * Bytecode in an extended JVM can directly obtain a method handle
95.81 + * for any accessible method from a <code>ldc</code> instruction
95.82 + * which refers to a <code>CONSTANT_Methodref</code> or
95.83 + * <code>CONSTANT_InterfaceMethodref</code> constant pool entry.
95.84 + * <p>
95.85 + * All JVMs can also use a reflective API called <code>MethodHandles</code>
95.86 + * for creating and calling method handles.
95.87 + * <p>
95.88 + * A method reference may refer either to a static or non-static method.
95.89 + * In the non-static case, the method handle type includes an explicit
95.90 + * receiver argument, prepended before any other arguments.
95.91 + * In the method handle's type, the initial receiver argument is typed
95.92 + * according to the class under which the method was initially requested.
95.93 + * (E.g., if a non-static method handle is obtained via <code>ldc</code>,
95.94 + * the type of the receiver is the class named in the constant pool entry.)
95.95 + * <p>
95.96 + * When a method handle to a virtual method is invoked, the method is
95.97 + * always looked up in the receiver (that is, the first argument).
95.98 + * <p>
95.99 + * A non-virtual method handles to a specific virtual method implementation
95.100 + * can also be created. These do not perform virtual lookup based on
95.101 + * receiver type. Such a method handle simulates the effect of
95.102 + * an <code>invokespecial</code> instruction to the same method.
95.103 + *
95.104 + * @see MethodType
95.105 + * @see MethodHandles
95.106 + * @author John Rose, JSR 292 EG
95.107 + */
95.108 +public abstract class MethodHandle
95.109 + // Note: This is an implementation inheritance hack, and will be removed
95.110 + // with a JVM change which moves the required hidden state onto this class.
95.111 + extends MethodHandleImpl
95.112 +{
95.113 + // interface MethodHandle<T extends MethodType<R,A...>>
95.114 + // { T type(); <R,A...> public R invoke(A...); }
95.115 +
95.116 + final private MethodType type;
95.117 +
95.118 + /**
95.119 + * Report the type of this method handle.
95.120 + * Every invocation of this method handle must exactly match this type.
95.121 + * @return the method handle type
95.122 + */
95.123 + public MethodType type() {
95.124 + return type;
95.125 + }
95.126 +
95.127 + /**
95.128 + * The constructor for MethodHandle may only be called by privileged code.
95.129 + * Subclasses may be in other packages, but must possess
95.130 + * a token which they obtained from MH with a security check.
95.131 + * @param token non-null object which proves access permission
95.132 + * @param type type (permanently assigned) of the new method handle
95.133 + */
95.134 + protected MethodHandle(Access token, MethodType type) {
95.135 + super(token);
95.136 + this.type = type;
95.137 + }
95.138 +}
96.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
96.2 +++ b/src/share/classes/java/dyn/MethodHandles.java Thu May 14 00:17:25 2009 -0700
96.3 @@ -0,0 +1,1104 @@
96.4 +/*
96.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
96.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
96.7 + *
96.8 + * This code is free software; you can redistribute it and/or modify it
96.9 + * under the terms of the GNU General Public License version 2 only, as
96.10 + * published by the Free Software Foundation. Sun designates this
96.11 + * particular file as subject to the "Classpath" exception as provided
96.12 + * by Sun in the LICENSE file that accompanied this code.
96.13 + *
96.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
96.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
96.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
96.17 + * version 2 for more details (a copy is included in the LICENSE file that
96.18 + * accompanied this code).
96.19 + *
96.20 + * You should have received a copy of the GNU General Public License version
96.21 + * 2 along with this work; if not, write to the Free Software Foundation,
96.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
96.23 + *
96.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
96.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
96.26 + * have any questions.
96.27 + */
96.28 +
96.29 +package java.dyn;
96.30 +
96.31 +import java.lang.reflect.Constructor;
96.32 +import sun.dyn.Access;
96.33 +import sun.dyn.MemberName;
96.34 +import sun.dyn.MethodHandleImpl;
96.35 +import sun.dyn.util.VerifyAccess;
96.36 +import sun.dyn.util.Wrapper;
96.37 +import java.lang.reflect.Field;
96.38 +import java.lang.reflect.Method;
96.39 +import java.lang.reflect.Modifier;
96.40 +import java.util.ArrayList;
96.41 +import java.util.Arrays;
96.42 +import sun.dyn.Invokers;
96.43 +import sun.dyn.MethodTypeImpl;
96.44 +import sun.reflect.Reflection;
96.45 +import static sun.dyn.MemberName.newIllegalArgumentException;
96.46 +import static sun.dyn.MemberName.newNoAccessException;
96.47 +
96.48 +/**
96.49 + * Fundamental operations and utilities for MethodHandle.
96.50 + * <p>
96.51 + * <em>API Note:</em> The matching of method types in this API cannot
96.52 + * be completely checked by Java's generic type system for three reasons:
96.53 + * <ol>
96.54 + * <li>Method types range over all possible arities,
96.55 + * from no arguments to an arbitrary number of arguments.
96.56 + * Generics are not variadic, and so cannot represent this.</li>
96.57 + * <li>Method types can specify arguments of primitive types,
96.58 + * which Java generic types cannot range over.</li>
96.59 + * <li>Method types can optionally specify varargs (ellipsis).</li>
96.60 + * </ol>
96.61 + * @author John Rose, JSR 292 EG
96.62 + */
96.63 +public class MethodHandles {
96.64 +
96.65 + private MethodHandles() { } // do not instantiate
96.66 +
96.67 + private static final Access IMPL_TOKEN = Access.getToken();
96.68 + private static final MemberName.Factory IMPL_NAMES = MemberName.getFactory(IMPL_TOKEN);
96.69 + static { MethodHandleImpl.initStatics(); }
96.70 + // See IMPL_LOOKUP below.
96.71 +
96.72 + //// Method handle creation from ordinary methods.
96.73 +
96.74 + public static Lookup lookup() {
96.75 + return new Lookup();
96.76 + }
96.77 +
96.78 + /**
96.79 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.80 + * A factory object for creating method handles, when the creation
96.81 + * requires access checking. Method handles do not perform
96.82 + * access checks when they are called; this is a major difference
96.83 + * from reflective {@link Method}, which performs access checking
96.84 + * against every caller, on every call. Method handle access
96.85 + * restrictions are enforced when a method handle is created.
96.86 + * The caller class against which those restrictions are enforced
96.87 + * is known as the "lookup class". {@link Lookup} embodies an
96.88 + * authenticated lookup class, and can be used to create any number
96.89 + * of access-checked method handles, all checked against a single
96.90 + * lookup class.
96.91 + * <p>
96.92 + * A class which needs to create method handles will call
96.93 + * {@code MethodHandles.lookup()} to create a factory for itself.
96.94 + * It may then use this factory to create method handles on
96.95 + * all of its methods, including private ones.
96.96 + * It may also delegate the lookup (e.g., to a metaobject protocol)
96.97 + * by passing the {@code Lookup} object to other code.
96.98 + * If this other code creates method handles, they will be access
96.99 + * checked against the original lookup class, and not with any higher
96.100 + * privileges.
96.101 + * <p>
96.102 + * Note that access checks only apply to named and reflected methods.
96.103 + * Other method handle creation methods, such as {@link #convertArguments},
96.104 + * do not require any access checks, and can be done independently
96.105 + * of any lookup class.
96.106 + * <p>
96.107 + * <em>A note about error conditions:<em> A lookup can fail, because
96.108 + * the containing class is not accessible to the lookup class, or
96.109 + * because the desired class member is missing, or because the
96.110 + * desired class member is not accessible to the lookup class.
96.111 + * It can also fail if a security manager is installed and refuses
96.112 + * access. In any of these cases, an exception will be
96.113 + * thrown from the attempted lookup.
96.114 + * In general, the conditions under which a method handle may be
96.115 + * created for a method {@code M} are exactly as restrictive as the conditions
96.116 + * under which the lookup class could have compiled a call to {@code M}.
96.117 + * At least some of these error conditions are likely to be
96.118 + * represented by checked exceptions in the final version of this API.
96.119 + */
96.120 + public static final
96.121 + class Lookup {
96.122 + private final Class<?> lookupClass;
96.123 +
96.124 + /** Which class is performing the lookup? It is this class against
96.125 + * which checks are performed for visibility and access permissions.
96.126 + * <p>
96.127 + * This value is null if and only if this lookup is {@link #PUBLIC_LOOKUP}.
96.128 + */
96.129 + public Class<?> lookupClass() {
96.130 + return lookupClass;
96.131 + }
96.132 +
96.133 + /** Embody the current class (the lookupClass) as a lookup class
96.134 + * for method handle creation.
96.135 + * Must be called by from a method in this package,
96.136 + * which in turn is called by a method not in this package.
96.137 + * Also, don't make it private, lest javac interpose
96.138 + * an access$N method.
96.139 + */
96.140 + Lookup() {
96.141 + Class caller = getCallerClassAtEntryPoint();
96.142 + // make sure we haven't accidentally picked up this class:
96.143 + checkUnprivilegedlookupClass(caller);
96.144 + this.lookupClass = caller;
96.145 + }
96.146 +
96.147 + private Lookup(Class<?> lookupClass) {
96.148 + this.lookupClass = lookupClass;
96.149 + }
96.150 +
96.151 + private static final Class<?> PUBLIC_ONLY = sun.dyn.empty.Empty.class;
96.152 +
96.153 + /** Version of lookup which is trusted minimally.
96.154 + * It can only be used to create method handles to
96.155 + * publicly accessible members.
96.156 + */
96.157 + public static final Lookup PUBLIC_LOOKUP = new Lookup(PUBLIC_ONLY);
96.158 +
96.159 + /** Package-private version of lookup which is trusted. */
96.160 + static final Lookup IMPL_LOOKUP = new Lookup(null);
96.161 + static { MethodHandleImpl.initLookup(IMPL_TOKEN, IMPL_LOOKUP); }
96.162 +
96.163 + private static void checkUnprivilegedlookupClass(Class<?> lookupClass) {
96.164 + String name = lookupClass.getName();
96.165 + if (name.startsWith("java.dyn.") || name.startsWith("sun.dyn."))
96.166 + throw newIllegalArgumentException("illegal lookupClass: "+lookupClass);
96.167 + }
96.168 +
96.169 + @Override
96.170 + public String toString() {
96.171 + if (lookupClass == PUBLIC_ONLY)
96.172 + return "public";
96.173 + if (lookupClass == null)
96.174 + return "privileged";
96.175 + return lookupClass.getName();
96.176 + }
96.177 +
96.178 + // call this from an entry point method in Lookup with extraFrames=0.
96.179 + private static Class<?> getCallerClassAtEntryPoint() {
96.180 + final int CALLER_DEPTH = 4;
96.181 + // 0: Reflection.getCC, 1: getCallerClassAtEntryPoint,
96.182 + // 2: Lookup.<init>, 3: MethodHandles.*, 4: caller
96.183 + // Note: This should be the only use of getCallerClass in this file.
96.184 + return Reflection.getCallerClass(CALLER_DEPTH);
96.185 + }
96.186 +
96.187 + /**
96.188 + * Produce a method handle for a static method.
96.189 + * The type of the method handle will be that of the method.
96.190 + * The method and all its argument types must be accessible to the lookup class.
96.191 + * If the method's class has not yet been initialized, that is done
96.192 + * immediately, before the method handle is returned.
96.193 + * @param defc the class from which the method is accessed
96.194 + * @param name the name of the method
96.195 + * @param type the type of the method
96.196 + * @return the desired method handle
96.197 + * @exception SecurityException <em>TBD</em>
96.198 + * @exception NoAccessException if the method does not exist or access checking fails
96.199 + */
96.200 + public
96.201 + MethodHandle findStatic(Class<?> defc, String name, MethodType type) throws NoAccessException {
96.202 + MemberName method = IMPL_NAMES.resolveOrFail(new MemberName(defc, name, type, Modifier.STATIC), true, lookupClass);
96.203 + checkStatic(true, method, lookupClass);
96.204 + //throw NoSuchMethodException
96.205 + return MethodHandleImpl.findMethod(IMPL_TOKEN, method, false, lookupClass);
96.206 + }
96.207 +
96.208 + /**
96.209 + * Produce a method handle for a virtual method.
96.210 + * The type of the method handle will be that of the method,
96.211 + * with the receiver type ({@code defc}) prepended.
96.212 + * The method and all its argument types must be accessible to the lookup class.
96.213 + * <p>
96.214 + * (<em>BUG NOTE:</em> The type {@code Object} may be prepended instead
96.215 + * of the receiver type, if the receiver type is not on the boot class path.
96.216 + * This is due to a temporary JVM limitation, in which MethodHandle
96.217 + * claims to be unable to access such classes. To work around this
96.218 + * bug, use {@code convertArguments} to normalize the type of the leading
96.219 + * argument to a type on the boot class path, such as {@code Object}.)
96.220 + * <p>
96.221 + * When called, the handle will treat the first argument as a receiver
96.222 + * and dispatch on the receiver's type to determine which method
96.223 + * implementation to enter.
96.224 + * (The dispatching action is identical with that performed by an
96.225 + * {@code invokevirtual} or {@code invokeinterface} instruction.)
96.226 + * @param defc the class or interface from which the method is accessed
96.227 + * @param name the name of the method
96.228 + * @param type the type of the method, with the receiver argument omitted
96.229 + * @return the desired method handle
96.230 + * @exception SecurityException <em>TBD</em>
96.231 + * @exception NoAccessException if the method does not exist or access checking fails
96.232 + */
96.233 + public MethodHandle findVirtual(Class<?> defc, String name, MethodType type) throws NoAccessException {
96.234 + MemberName method = IMPL_NAMES.resolveOrFail(new MemberName(defc, name, type), true, lookupClass);
96.235 + checkStatic(false, method, lookupClass);
96.236 + return MethodHandleImpl.findMethod(IMPL_TOKEN, method, true, lookupClass);
96.237 + }
96.238 +
96.239 + /**
96.240 + * Produce an early-bound method handle for a virtual method,
96.241 + * as if called from an {@code invokespecial}
96.242 + * instruction from {@code caller}.
96.243 + * The type of the method handle will be that of the method,
96.244 + * with a suitably restricted receiver type (such as {@code caller}) prepended.
96.245 + * The method and all its argument types must be accessible
96.246 + * to the caller.
96.247 + * <p>
96.248 + * When called, the handle will treat the first argument as a receiver,
96.249 + * but will not dispatch on the receiver's type.
96.250 + * (This direct invocation action is identical with that performed by an
96.251 + * {@code invokespecial} instruction.)
96.252 + * <p>
96.253 + * If the explicitly specified caller class is not identical with the
96.254 + * lookup class, a security check TBD is performed.
96.255 + * @param defc the class or interface from which the method is accessed
96.256 + * @param name the name of the method, or "<init>" for a constructor
96.257 + * @param type the type of the method, with the receiver argument omitted
96.258 + * @param specialCaller the proposed calling class to perform the {@code invokespecial}
96.259 + * @return the desired method handle
96.260 + * @exception SecurityException <em>TBD</em>
96.261 + * @exception NoAccessException if the method does not exist or access checking fails
96.262 + */
96.263 + public MethodHandle findSpecial(Class<?> defc, String name, MethodType type,
96.264 + Class<?> specialCaller) throws NoAccessException {
96.265 + checkSpecialCaller(specialCaller, lookupClass);
96.266 + MemberName method = IMPL_NAMES.resolveOrFail(new MemberName(defc, name, type), false, specialCaller);
96.267 + checkStatic(false, method, lookupClass);
96.268 + if (name.equals("<init>")) {
96.269 + throw newNoAccessException("cannot directly invoke a constructor", method, null);
96.270 + } else if (defc.isInterface() || !defc.isAssignableFrom(specialCaller)) {
96.271 + throw newNoAccessException("method must be in a superclass of lookup class", method, lookupClass);
96.272 + }
96.273 + return MethodHandleImpl.findMethod(IMPL_TOKEN, method, false, specialCaller);
96.274 + }
96.275 +
96.276 + /**
96.277 + * Produce an early-bound method handle for a non-static method.
96.278 + * The receiver must have a supertype {@code defc} in which a method
96.279 + * of the given name and type is accessible to the lookup class.
96.280 + * The method and all its argument types must be accessible to the lookup class.
96.281 + * The type of the method handle will be that of the method.
96.282 + * The given receiver will be bound into the method handle.
96.283 + * <p>
96.284 + * Equivalent to the following expression:
96.285 + * <code>
96.286 + * {@link #insertArgument}({@link #findVirtual}(defc, name, type), receiver)
96.287 + * </code>
96.288 + * @param receiver the object from which the method is accessed
96.289 + * @param name the name of the method
96.290 + * @param type the type of the method, with the receiver argument omitted
96.291 + * @return the desired method handle
96.292 + * @exception SecurityException <em>TBD</em>
96.293 + * @exception NoAccessException if the method does not exist or access checking fails
96.294 + */
96.295 + public MethodHandle bind(Object receiver, String name, MethodType type) throws NoAccessException {
96.296 + Class<? extends Object> rcvc = receiver.getClass(); // may get NPE
96.297 + MemberName reference = new MemberName(rcvc, name, type);
96.298 + MemberName method = IMPL_NAMES.resolveOrFail(reference, true, lookupClass);
96.299 + checkStatic(false, method, lookupClass);
96.300 + MethodHandle dmh = MethodHandleImpl.findMethod(IMPL_TOKEN, method, true, lookupClass);
96.301 + MethodHandle bmh = MethodHandleImpl.bindReceiver(IMPL_TOKEN, dmh, receiver);
96.302 + if (bmh == null)
96.303 + throw newNoAccessException(method, lookupClass);
96.304 + return bmh;
96.305 + }
96.306 +
96.307 + /**
96.308 + * Make a direct method handle to <i>m</i>, if the lookup class has permission.
96.309 + * If <i>m</i> is non-static, the receiver argument is treated as an initial argument.
96.310 + * If <i>m</i> is virtual, overriding is respected on every call.
96.311 + * Unlike the Core Reflection API, exceptions are <em>not</em> wrapped.
96.312 + * The type of the method handle will be that of the method,
96.313 + * with the receiver type prepended (but only if it is non-static).
96.314 + * If the method's {@code accessible} flag is not set,
96.315 + * access checking is performed immediately on behalf of the lookup class.
96.316 + * If <i>m</i> is not public, do not share the resulting handle with untrusted parties.
96.317 + * @param m the reflected method
96.318 + * @return a method handle which can invoke the reflected method
96.319 + * @exception NoAccessException if access checking fails
96.320 + */
96.321 + public MethodHandle unreflect(Method m) throws NoAccessException {
96.322 + return unreflectImpl(new MemberName(m), m.isAccessible(), true, lookupClass);
96.323 + }
96.324 +
96.325 + /**
96.326 + * Produce a method handle for a reflected method.
96.327 + * It will bypass checks for overriding methods on the receiver,
96.328 + * as if by the {@code invokespecial} instruction.
96.329 + * The type of the method handle will be that of the method,
96.330 + * with the receiver type prepended.
96.331 + * If the method's {@code accessible} flag is not set,
96.332 + * access checking is performed immediately on behalf of the lookup class,
96.333 + * as if {@code invokespecial} instruction were being linked.
96.334 + * @param m the reflected method
96.335 + * @return a method handle which can invoke the reflected method
96.336 + * @exception NoAccessException if access checking fails
96.337 + */
96.338 + public MethodHandle unreflectSpecial(Method m, Class<?> specialCaller) throws NoAccessException {
96.339 + checkSpecialCaller(specialCaller, lookupClass);
96.340 + MemberName mname = new MemberName(m);
96.341 + checkStatic(false, mname, lookupClass);
96.342 + return unreflectImpl(mname, m.isAccessible(), false, specialCaller);
96.343 + }
96.344 +
96.345 + /**
96.346 + * Produce a method handle for a reflected constructor.
96.347 + * The type of the method handle will be that of the constructor.
96.348 + * The method handle will perform a {@code newInstance} operation,
96.349 + * creating a new instance of the constructor's class on the
96.350 + * arguments passed to the method handle.
96.351 + * <p>
96.352 + * If the constructor's {@code accessible} flag is not set,
96.353 + * access checking is performed immediately on behalf of the lookup class,
96.354 + * as if {@code invokespecial} instruction were being linked.
96.355 + * @param ctor the reflected constructor
96.356 + * @return a method handle which can invoke the reflected constructor
96.357 + * @exception NoAccessException if access checking fails
96.358 + */
96.359 + public MethodHandle unreflectConstructor(Constructor ctor) throws NoAccessException {
96.360 + MemberName m = new MemberName(ctor);
96.361 + return unreflectImpl(m, ctor.isAccessible(), false, lookupClass);
96.362 + }
96.363 +
96.364 + /**
96.365 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.366 + * Produce a method handle giving read access to a reflected field.
96.367 + * The type of the method handle will have a return type of the field's
96.368 + * value type. Its sole argument will be the field's containing class
96.369 + * (but only if it is non-static).
96.370 + * If the method's {@code accessible} flag is not set,
96.371 + * access checking is performed immediately on behalf of the lookup class.
96.372 + * @param f the reflected field
96.373 + * @return a method handle which can load values from the reflected field
96.374 + * @exception NoAccessException if access checking fails
96.375 + */
96.376 + public MethodHandle unreflectGetter(Field f) throws NoAccessException {
96.377 + return MethodHandleImpl.accessField(IMPL_TOKEN, new MemberName(f), false, lookupClass);
96.378 + }
96.379 +
96.380 + /**
96.381 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.382 + * Produce a method handle giving write access to a reflected field.
96.383 + * The type of the method handle will have a void return type.
96.384 + * Its last argument will be the field's value type.
96.385 + * Its other argument will be the field's containing class
96.386 + * (but only if it is non-static).
96.387 + * If the method's {@code accessible} flag is not set,
96.388 + * access checking is performed immediately on behalf of the lookup class.
96.389 + * @param f the reflected field
96.390 + * @return a method handle which can store values into the reflected field
96.391 + * @exception NoAccessException if access checking fails
96.392 + */
96.393 + public MethodHandle unreflectSetter(Field f) throws NoAccessException {
96.394 + return MethodHandleImpl.accessField(IMPL_TOKEN, new MemberName(f), true, lookupClass);
96.395 + }
96.396 +
96.397 + }
96.398 +
96.399 + static /*must not be public*/
96.400 + MethodHandle findStaticFrom(Class<?> lookupClass,
96.401 + Class<?> defc, String name, MethodType type) throws NoAccessException {
96.402 + MemberName method = IMPL_NAMES.resolveOrFail(new MemberName(defc, name, type, Modifier.STATIC), true, lookupClass);
96.403 + checkStatic(true, method, lookupClass);
96.404 + return MethodHandleImpl.findMethod(IMPL_TOKEN, method, false, lookupClass);
96.405 + }
96.406 +
96.407 + static void checkStatic(boolean wantStatic, MemberName m, Class<?> lookupClass) {
96.408 + if (wantStatic != m.isStatic()) {
96.409 + String message = wantStatic ? "expected a static method" : "expected a non-static method";
96.410 + throw newNoAccessException(message, m, lookupClass);
96.411 + }
96.412 + }
96.413 +
96.414 + static void checkSpecialCaller(Class<?> specialCaller, Class<?> lookupClass) {
96.415 + if (lookupClass == Lookup.IMPL_LOOKUP.lookupClass())
96.416 + return; // privileged action
96.417 + if (lookupClass == null || // public-only access
96.418 + !VerifyAccess.isSamePackageMember(specialCaller, lookupClass))
96.419 + throw newNoAccessException("no private access", new MemberName(specialCaller), lookupClass);
96.420 + }
96.421 +
96.422 + // Helper for creating handles on reflected methods and constructors.
96.423 + static MethodHandle unreflectImpl(MemberName m, boolean isAccessible,
96.424 + boolean doDispatch, Class<?> lookupClass) {
96.425 + MethodType mtype = m.getInvocationType();
96.426 + Class<?> defc = m.getDeclaringClass();
96.427 + int mods = m.getModifiers();
96.428 + if (m.isStatic()) {
96.429 + if (!isAccessible &&
96.430 + VerifyAccess.isAccessible(defc, mods, false, lookupClass) == null)
96.431 + throw newNoAccessException(m, lookupClass);
96.432 + } else {
96.433 + Class<?> constraint;
96.434 + if (isAccessible) {
96.435 + // abbreviated access check for "unlocked" method
96.436 + constraint = doDispatch ? defc : lookupClass;
96.437 + } else {
96.438 + constraint = VerifyAccess.isAccessible(defc, mods, doDispatch, lookupClass);
96.439 + }
96.440 + if (constraint != defc && !constraint.isAssignableFrom(defc)) {
96.441 + if (!defc.isAssignableFrom(constraint))
96.442 + throw newNoAccessException("receiver must be in caller class", m, lookupClass);
96.443 + mtype = mtype.changeParameterType(0, constraint);
96.444 + }
96.445 + }
96.446 + return MethodHandleImpl.findMethod(IMPL_TOKEN, m, doDispatch, lookupClass);
96.447 + }
96.448 +
96.449 + /**
96.450 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.451 + * Produce a method handle giving read access to elements of an array.
96.452 + * The type of the method handle will have a return type of the array's
96.453 + * element type. Its first argument will be the array type,
96.454 + * and the second will be {@code int}.
96.455 + * @param arrayClass an array type
96.456 + * @return a method handle which can load values from the given array type
96.457 + * @throws IllegalArgumentException if arrayClass is not an array type
96.458 + */
96.459 + public static
96.460 + MethodHandle arrayElementGetter(Class<?> arrayClass) throws IllegalArgumentException {
96.461 + return MethodHandleImpl.accessArrayElement(IMPL_TOKEN, arrayClass, false);
96.462 + }
96.463 +
96.464 + /**
96.465 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.466 + * Produce a method handle giving write access to elements of an array.
96.467 + * The type of the method handle will have a void return type.
96.468 + * Its last argument will be the array's element type.
96.469 + * The first and second arguments will be the array type and int.
96.470 + * @return a method handle which can store values into the array type
96.471 + * @throws IllegalArgumentException if arrayClass is not an array type
96.472 + */
96.473 + public static
96.474 + MethodHandle arrayElementSetter(Class<?> arrayClass) throws IllegalArgumentException {
96.475 + return MethodHandleImpl.accessArrayElement(IMPL_TOKEN, arrayClass, true);
96.476 + }
96.477 +
96.478 +
96.479 + /// method handle invocation (reflective style)
96.480 +
96.481 + /**
96.482 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.483 + * Call the {@code invoke} method of a given method handle,
96.484 + * with arguments that exactly match the parameter types of the method handle.
96.485 + * The length of the arguments array must equal the parameter count
96.486 + * of the target's type.
96.487 + * The arguments array is spread into separate arguments, and
96.488 + * basic reference and unboxing conversions are applied.
96.489 + * <p>
96.490 + * In order to match the type of the target, the following argument
96.491 + * conversions are applied as necessary:
96.492 + * <ul>
96.493 + * <li>reference casting
96.494 + * <li>unboxing
96.495 + * </ul>
96.496 + * The following conversions are not applied:
96.497 + * <ul>
96.498 + * <li>primitive conversions (e.g., {@code byte} to {@code int}
96.499 + * <li>varargs conversions other than the initial spread
96.500 + * <li>any application-specific conversions (e.g., string to number)
96.501 + * </ul>
96.502 + * The result returned by the call is boxed if it is a primitive,
96.503 + * or forced to null if the return type is void.
96.504 + * <p>
96.505 + * This call is a convenience method for the following code:
96.506 + * <pre>
96.507 + * MethodHandle invoker = MethodHandles.genericInvoker(target.type(), 0, true);
96.508 + * Object result = invoker.invoke(arguments);
96.509 + * </pre>
96.510 + * @param target the method handle to invoke
96.511 + * @param arguments the arguments to pass to the target
96.512 + * @return the result returned by the target
96.513 + */
96.514 + public static
96.515 + Object invoke(MethodHandle target, Object... arguments) {
96.516 + int argc = arguments == null ? 0 : arguments.length;
96.517 + MethodType type = target.type();
96.518 + if (argc <= 4) {
96.519 + MethodHandle invoker = invokers(type).genericInvoker();
96.520 + switch (argc) {
96.521 + case 0: return invoker.<Object>invoke(target);
96.522 + case 1: return invoker.<Object>invoke(target,
96.523 + arguments[0]);
96.524 + case 2: return invoker.<Object>invoke(target,
96.525 + arguments[0], arguments[1]);
96.526 + case 3: return invoker.<Object>invoke(target,
96.527 + arguments[0], arguments[1], arguments[2]);
96.528 + case 4: return invoker.<Object>invoke(target,
96.529 + arguments[0], arguments[1], arguments[2], arguments[3]);
96.530 + }
96.531 + }
96.532 + MethodHandle invoker = invokers(type).varargsInvoker();
96.533 + return invoker.<Object>invoke(target, arguments);
96.534 + }
96.535 +
96.536 + public static
96.537 + Object invoke_0(MethodHandle target) {
96.538 + MethodHandle invoker = invokers(target.type()).genericInvoker();
96.539 + return invoker.<Object>invoke(target);
96.540 + }
96.541 + public static
96.542 + Object invoke_1(MethodHandle target, Object a0) {
96.543 + MethodHandle invoker = invokers(target.type()).genericInvoker();
96.544 + return invoker.<Object>invoke(target, a0);
96.545 + }
96.546 + public static
96.547 + Object invoke_2(MethodHandle target, Object a0, Object a1) {
96.548 + MethodHandle invoker = invokers(target.type()).genericInvoker();
96.549 + return invoker.<Object>invoke(target, a0, a1);
96.550 + }
96.551 + public static
96.552 + Object invoke_3(MethodHandle target, Object a0, Object a1, Object a2) {
96.553 + MethodHandle invoker = invokers(target.type()).genericInvoker();
96.554 + return invoker.<Object>invoke(target, a0, a1, a2);
96.555 + }
96.556 + public static
96.557 + Object invoke_4(MethodHandle target, Object a0, Object a1, Object a2, Object a3) {
96.558 + MethodHandle invoker = invokers(target.type()).genericInvoker();
96.559 + return invoker.<Object>invoke(target, a0, a1, a2, a3);
96.560 + }
96.561 +
96.562 + /**
96.563 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.564 + * Give a method handle which will invoke any method handle of the
96.565 + * given type on a standard set of {@code Object} type arguments.
96.566 + * The the resulting invoker will be a method handle with the following
96.567 + * arguments:
96.568 + * <ul>
96.569 + * <li>a single {@code MethodHandle} target
96.570 + * <li>zero or more {@code Object} values
96.571 + * <li>an optional {@code Object[]} array containing more arguments
96.572 + * </ul>
96.573 + * The invoker will spread the varargs array (if present), apply
96.574 + * reference casts as necessary, and unbox primitive arguments.
96.575 + * The return value of the invoker will be an {@code Object} reference,
96.576 + * boxing a primitive value if the original type returns a primitive,
96.577 + * and always null if the original type returns void.
96.578 + * <p>
96.579 + * This is a convenience method equivalent to the following code:
96.580 + * <pre>
96.581 + * MethodHandle invoker = exactInvoker(type);
96.582 + * MethodType genericType = MethodType.makeGeneric(objectArgCount, varargs);
96.583 + * genericType = genericType.insertParameterType(0, MethodHandle.class);
96.584 + * if (!varargs)
96.585 + * return convertArguments(invoker, genericType);
96.586 + * else
96.587 + * return spreadArguments(invoker, genericType);
96.588 + * </pre>
96.589 + * @param type the desired target type
96.590 + * @param objectArgCount number of fixed (non-varargs) {@code Object} arguments
96.591 + * @param varargs if true, the invoker will accept a final {@code Object[]} argument
96.592 + * @return a method handle suitable for invoking any method handle of the given type
96.593 + */
96.594 + static public
96.595 + MethodHandle genericInvoker(MethodType type, int objectArgCount, boolean varargs) {
96.596 + return invokers(type).genericInvoker();
96.597 + }
96.598 +
96.599 + /**
96.600 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.601 + * Give a method handle which will take a invoke any method handle of the
96.602 + * given type. The resulting invoker will have a type which is
96.603 + * exactly equal to the desired type, except that it will accept
96.604 + * an additional leading argument of type {@code MethodHandle}.
96.605 + * <p>
96.606 + * This is a convenience method equivalent to the following code:
96.607 + * <pre>
96.608 + * MethodHandles.lookup().findVirtual(MethodHandle.class, "invoke", type);
96.609 + * </pre>
96.610 + * @param type the desired target type
96.611 + * @return a method handle suitable for invoking any method handle of the given type
96.612 + */
96.613 + static public
96.614 + MethodHandle exactInvoker(MethodType type) {
96.615 + return invokers(type).exactInvoker();
96.616 + }
96.617 +
96.618 + static private Invokers invokers(MethodType type) {
96.619 + return MethodTypeImpl.invokers(IMPL_TOKEN, type);
96.620 + }
96.621 +
96.622 + /**
96.623 + * <em>WORK IN PROGRESS:</em>
96.624 + * Perform value checking, exactly as if for an adapted method handle.
96.625 + * It is assumed that the given value is either null, of type T0,
96.626 + * or (if T0 is primitive) of the wrapper type corresponding to T0.
96.627 + * The following checks and conversions are made:
96.628 + * <ul>
96.629 + * <li>If T0 and T1 are references, then a cast to T1 is applied.
96.630 + * (The types do not need to be related in any particular way.)
96.631 + * <li>If T0 and T1 are primitives, then a widening or narrowing
96.632 + * conversion is applied, if one exists.
96.633 + * <li>If T0 is a primitive and T1 a reference, and
96.634 + * T0 has a wrapper type TW, a boxing conversion to TW is applied,
96.635 + * possibly followed by a reference conversion.
96.636 + * T1 must be TW or a supertype.
96.637 + * <li>If T0 is a reference and T1 a primitive, and
96.638 + * T1 has a wrapper type TW, an unboxing conversion is applied,
96.639 + * possibly preceded by a reference conversion.
96.640 + * T0 must be TW or a supertype.
96.641 + * <li>If T1 is void, the return value is discarded
96.642 + * <li>If T0 is void and T1 a reference, a null value is introduced.
96.643 + * <li>If T0 is void and T1 a primitive, a zero value is introduced.
96.644 + * </ul>
96.645 + * If the value is discarded, null will be returned.
96.646 + * @param valueType
96.647 + * @param value
96.648 + * @return the value, converted if necessary
96.649 + * @throws java.lang.ClassCastException if a cast fails
96.650 + */
96.651 + static
96.652 + <T0, T1> T1 checkValue(Class<T0> t0, Class<T1> t1, Object value)
96.653 + throws ClassCastException
96.654 + {
96.655 + if (t0 == t1) {
96.656 + // no conversion needed; just reassert the same type
96.657 + if (t0.isPrimitive())
96.658 + return Wrapper.asPrimitiveType(t1).cast(value);
96.659 + else
96.660 + return Wrapper.OBJECT.cast(value, t1);
96.661 + }
96.662 + boolean prim0 = t0.isPrimitive(), prim1 = t1.isPrimitive();
96.663 + if (!prim0) {
96.664 + // check contract with caller
96.665 + Wrapper.OBJECT.cast(value, t0);
96.666 + if (!prim1) {
96.667 + return Wrapper.OBJECT.cast(value, t1);
96.668 + }
96.669 + // convert reference to primitive by unboxing
96.670 + Wrapper w1 = Wrapper.forPrimitiveType(t1);
96.671 + return w1.cast(value, t1);
96.672 + }
96.673 + // check contract with caller:
96.674 + Wrapper.asWrapperType(t0).cast(value);
96.675 + Wrapper w1 = Wrapper.forPrimitiveType(t1);
96.676 + return w1.cast(value, t1);
96.677 + }
96.678 +
96.679 + static
96.680 + Object checkValue(Class<?> T1, Object value)
96.681 + throws ClassCastException
96.682 + {
96.683 + Class<?> T0;
96.684 + if (value == null)
96.685 + T0 = Object.class;
96.686 + else
96.687 + T0 = value.getClass();
96.688 + return checkValue(T0, T1, value);
96.689 + }
96.690 +
96.691 + /// method handle modification (creation from other method handles)
96.692 +
96.693 + /**
96.694 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.695 + * Produce a method handle which adapts the type of the
96.696 + * given method handle to a new type, by pairwise argument conversion,
96.697 + * and/or varargs conversion.
96.698 + * The original type and new type must have the same number of
96.699 + * arguments, or else one or both them the must be varargs types.
96.700 + * The resulting method handle is guaranteed to confess a type
96.701 + * which is equal to the desired new type, with any varargs property erased.
96.702 + * <p>
96.703 + * If the original type and new type are equal, returns target.
96.704 + * <p>
96.705 + * The following conversions are applied as needed both to
96.706 + * arguments and return types. Let T0 and T1 be the differing
96.707 + * new and old parameter types (or old and new return types)
96.708 + * for corresponding values passed by the new and old method types.
96.709 + * <p>
96.710 + * If an ordinary (non-varargs) parameter of the new type is
96.711 + * to be boxed in a varargs parameter of the old type of type T1[],
96.712 + * then T1 is the element type of the varargs array.
96.713 + * Otherwise, if a varargs parameter of the new type of type T0[]
96.714 + * is to be spread into one or more outgoing old type parameters,
96.715 + * then T0 is the element type of the
96.716 + * If the new type is varargs and the old type is not, the varargs
96.717 + * argument will be checked and must be a non-null array of exactly
96.718 + * the right length. If there are no parameters in the old type
96.719 + * corresponding to the new varargs parameter, the varargs argument
96.720 + * is also allowed to be null.
96.721 + * <p>
96.722 + * Given those types T0, T1, one of the following conversions is applied
96.723 + * if possible:
96.724 + * <ul>
96.725 + * <li>If T0 and T1 are references, then a cast to T2 is applied,
96.726 + * where T2 is Object if T1 is an interface, else T1.
96.727 + * (The types do not need to be related in any particular way.
96.728 + * The treatment of interfaces follows the usage of the bytecode verifier.)
96.729 + * <li>If T0 and T1 are primitives, then a Java casting
96.730 + * conversion (JLS 5.5) is applied, if one exists.
96.731 + * <li>If T0 and T1 are primitives and one is boolean,
96.732 + * the boolean is treated as a one-bit unsigned integer.
96.733 + * (This treatment follows the usage of the bytecode verifier.)
96.734 + * A conversion from another primitive type behaves as if
96.735 + * it first converts to byte, and then masks all but the low bit.
96.736 + * <li>If T0 is a primitive and T1 a reference, a boxing
96.737 + * conversion is applied if one exists, possibly followed by
96.738 + * an reference conversion to a superclass.
96.739 + * T1 must be a wrapper class or a supertype of one.
96.740 + * If T1 is a wrapper class, T0 is converted if necessary
96.741 + * to T1's primitive type by one of the preceding conversions.
96.742 + * Otherwise, T0 is boxed, and its wrapper converted to T1.
96.743 + * <li>If T0 is a reference and T1 a primitive, an unboxing
96.744 + * conversion is applied if one exists, possibly preceded by
96.745 + * a reference conversion to a wrapper class.
96.746 + * T0 must be a wrapper class or a supertype of one.
96.747 + * If T0 is a wrapper class, its primitive value is converted
96.748 + * if necessary to T1 by one of the preceding conversions.
96.749 + * Otherwise, T0 is converted directly to the wrapper type for T1,
96.750 + * which is then unboxed.
96.751 + * <li>If T1 is void, any returned value is discarded
96.752 + * <li>If T0 is void and T1 a reference, a null value is introduced.
96.753 + * <li>If T0 is void and T1 a primitive, a zero value is introduced.
96.754 + * </ul>
96.755 + * @param target the method handle to invoke after arguments are retyped
96.756 + * @param newType the expected type of the new method handle
96.757 + * @return a method handle which delegates to {@code target} after performing
96.758 + * any necessary argument conversions, and arranges for any
96.759 + * necessary return value conversions
96.760 + * @throws WrongMethodTypeException if the conversion cannot be made
96.761 + */
96.762 + public static
96.763 + MethodHandle convertArguments(MethodHandle target, MethodType newType) {
96.764 + MethodType oldType = target.type();
96.765 + if (oldType.equals(newType))
96.766 + return target;
96.767 + MethodHandle res = MethodHandleImpl.convertArguments(IMPL_TOKEN, target,
96.768 + newType, oldType, null);
96.769 + if (res == null)
96.770 + throw newIllegalArgumentException("cannot convert to "+newType+": "+target);
96.771 + return res;
96.772 + }
96.773 +
96.774 + /**
96.775 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.776 + * Produce a method handle which adapts the calling sequence of the
96.777 + * given method handle to a new type, by reordering the arguments.
96.778 + * The resulting method handle is guaranteed to confess a type
96.779 + * which is equal to the desired new type.
96.780 + * <p>
96.781 + * The given array controls the reordering.
96.782 + * Call {@code #I} the number of incoming parameters (the value
96.783 + * {@code newType.parameterCount()}, and call {@code #O} the number
96.784 + * of outgoing parameters (the value {@code target.type().parameterCount()}).
96.785 + * Then the length of the reordering array must be {@code #O},
96.786 + * and each element must be a non-negative number less than {@code #I}.
96.787 + * For every {@code N} less than {@code #O}, the {@code N}-th
96.788 + * outgoing argument will be taken from the {@code I}-th incoming
96.789 + * argument, where {@code I} is {@code reorder[N]}.
96.790 + * <p>
96.791 + * The reordering array need not specify an actual permutation.
96.792 + * An incoming argument will be duplicated if its index appears
96.793 + * more than once in the array, and an incoming argument will be dropped
96.794 + * if its index does not appear in the array.
96.795 + * <p>
96.796 + * Pairwise conversions are applied as needed to arguments and return
96.797 + * values, as with {@link #convertArguments}.
96.798 + * @param target the method handle to invoke after arguments are reordered
96.799 + * @param newType the expected type of the new method handle
96.800 + * @param reorder a string which controls the reordering
96.801 + * @return a method handle which delegates to {@code target} after performing
96.802 + * any necessary argument motion and conversions, and arranges for any
96.803 + * necessary return value conversions
96.804 + */
96.805 + public static
96.806 + MethodHandle permuteArguments(MethodHandle target, MethodType newType, int[] reorder) {
96.807 + MethodType oldType = target.type();
96.808 + checkReorder(reorder, newType, oldType);
96.809 + return MethodHandleImpl.convertArguments(IMPL_TOKEN, target,
96.810 + newType, oldType,
96.811 + reorder);
96.812 + }
96.813 +
96.814 + private static void checkReorder(int[] reorder, MethodType newType, MethodType oldType) {
96.815 + if (reorder.length == oldType.parameterCount()) {
96.816 + int limit = newType.parameterCount();
96.817 + boolean bad = false;
96.818 + for (int i : reorder) {
96.819 + if (i < 0 || i >= limit) {
96.820 + bad = true; break;
96.821 + }
96.822 + }
96.823 + if (!bad) return;
96.824 + }
96.825 + throw newIllegalArgumentException("bad reorder array");
96.826 + }
96.827 +
96.828 + /**
96.829 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.830 + * Produce a method handle which adapts the type of the
96.831 + * given method handle to a new type, by spreading the final argument.
96.832 + * The resulting method handle is guaranteed to confess a type
96.833 + * which is equal to the desired new type.
96.834 + * <p>
96.835 + * The final parameter type of the new type must be an array type T[].
96.836 + * This is the type of what is called the <i>spread</i> argument.
96.837 + * All other arguments of the new type are called <i>ordinary</i> arguments.
96.838 + * <p>
96.839 + * The ordinary arguments of the new type are pairwise converted
96.840 + * to the initial parameter types of the old type, according to the
96.841 + * rules in {@link #convertArguments}.
96.842 + * Any additional arguments in the old type
96.843 + * are converted from the array element type T,
96.844 + * again according to the rules in {@link #convertArguments}.
96.845 + * The return value is converted according likewise.
96.846 + * <p>
96.847 + * The call verifies that the spread argument is in fact an array
96.848 + * of exactly the type length, i.e., the excess number of
96.849 + * arguments in the old type over the ordinary arguments in the new type.
96.850 + * If there are no excess arguments, the spread argument is also
96.851 + * allowed to be null.
96.852 + * @param target the method handle to invoke after the argument is prepended
96.853 + * @param newType the expected type of the new method handle
96.854 + * @return a new method handle which spreads its final argument,
96.855 + * before calling the original method handle
96.856 + */
96.857 + public static
96.858 + MethodHandle spreadArguments(MethodHandle target, MethodType newType) {
96.859 + MethodType oldType = target.type();
96.860 + int inargs = newType.parameterCount();
96.861 + int outargs = oldType.parameterCount();
96.862 + int spreadPos = inargs - 1;
96.863 + int numSpread = (outargs - spreadPos);
96.864 + MethodHandle res = null;
96.865 + if (spreadPos >= 0 && numSpread >= 0) {
96.866 + res = MethodHandleImpl.spreadArguments(IMPL_TOKEN, target, newType, spreadPos);
96.867 + }
96.868 + if (res == null) {
96.869 + throw newIllegalArgumentException("cannot spread "+newType+" to " +oldType);
96.870 + }
96.871 + return res;
96.872 + }
96.873 +
96.874 + /**
96.875 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.876 + * Produce a method handle which adapts the type of the
96.877 + * given method handle to a new type, by collecting a series of
96.878 + * trailing arguments into an array.
96.879 + * The resulting method handle is guaranteed to confess a type
96.880 + * which is equal to the desired new type.
96.881 + * <p>
96.882 + * This method is inverse to {@link #spreadArguments}.
96.883 + * The final parameter type of the old type must be an array type T[],
96.884 + * which is the type of what is called the <i>spread</i> argument.
96.885 + * The trailing arguments of the new type which correspond to
96.886 + * the spread argument are all converted to type T and collected
96.887 + * into an array before the original method is called.
96.888 + * <p>
96.889 + * ISSUE: Unify this with combineArguments. CollectArguments
96.890 + * is combineArguments with (a) new Object[]{...} as a combiner,
96.891 + * and (b) the combined arguments dropped, in favor of the combined result.
96.892 + * @param target the method handle to invoke after the argument is prepended
96.893 + * @param newType the expected type of the new method handle
96.894 + * @return a new method handle which collects some trailings argument
96.895 + * into an array, before calling the original method handle
96.896 + */
96.897 + public static
96.898 + MethodHandle collectArguments(MethodHandle target, MethodType newType) {
96.899 + MethodType oldType = target.type();
96.900 + int inargs = newType.parameterCount();
96.901 + int outargs = oldType.parameterCount();
96.902 + int collectPos = outargs - 1;
96.903 + int numCollect = (inargs - collectPos);
96.904 + if (collectPos < 0 || numCollect < 0)
96.905 + throw newIllegalArgumentException("wrong number of arguments");
96.906 + return MethodHandleImpl.collectArguments(IMPL_TOKEN, target, newType, collectPos);
96.907 + }
96.908 +
96.909 + /**
96.910 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.911 + * Produce a method handle which calls the original method handle,
96.912 + * after inserting the given argument at the given position.
96.913 + * The type of the new method handle will drop the corresponding argument
96.914 + * type from the original handle's type.
96.915 + * <p>
96.916 + * The given argument object must match the dropped argument type.
96.917 + * If the dropped argument type is a primitive, the argument object
96.918 + * must be a wrapper, and is unboxed to produce the primitive.
96.919 + * <p>
96.920 + * The <i>pos</i> may range between zero and <i>N</i> (inclusively),
96.921 + * where <i>N</i> is the number of argument types in <i>target</i>,
96.922 + * meaning to insert the new argument as the first or last (respectively),
96.923 + * or somewhere in between.
96.924 + * @param target the method handle to invoke after the argument is inserted
96.925 + * @param pos where to insert the argument (zero for the first)
96.926 + * @param value the argument to insert
96.927 + * @return a new method handle which inserts an additional argument,
96.928 + * before calling the original method handle
96.929 + */
96.930 + public static
96.931 + MethodHandle insertArgument(MethodHandle target, int pos, Object value) {
96.932 + MethodType oldType = target.type();
96.933 + ArrayList<Class<?>> ptypes =
96.934 + new ArrayList<Class<?>>(oldType.parameterList());
96.935 + int outargs = oldType.parameterCount();
96.936 + int inargs = outargs - 1;
96.937 + if (pos < 0 || pos >= outargs)
96.938 + throw newIllegalArgumentException("no argument type to append");
96.939 + Class<?> valueType = ptypes.remove(pos);
96.940 + value = checkValue(valueType, value);
96.941 + if (pos == 0 && !valueType.isPrimitive()) {
96.942 + // At least for now, make bound method handles a special case.
96.943 + // This lets us get by with minimal JVM support, at the expense
96.944 + // of generating signature-specific adapters as Java bytecodes.
96.945 + MethodHandle bmh = MethodHandleImpl.bindReceiver(IMPL_TOKEN, target, value);
96.946 + if (bmh != null) return bmh;
96.947 + // else fall through to general adapter machinery
96.948 + }
96.949 + return MethodHandleImpl.bindArgument(IMPL_TOKEN, target, pos, value);
96.950 + }
96.951 +
96.952 + /**
96.953 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.954 + * Produce a method handle which calls the original method handle,
96.955 + * after dropping the given argument(s) at the given position.
96.956 + * The type of the new method handle will insert the given argument
96.957 + * type(s), at that position, into the original handle's type.
96.958 + * <p>
96.959 + * The <i>pos</i> may range between zero and <i>N-1</i>,
96.960 + * where <i>N</i> is the number of argument types in <i>target</i>,
96.961 + * meaning to drop the first or last argument (respectively),
96.962 + * or an argument somewhere in between.
96.963 + * @param target the method handle to invoke after the argument is dropped
96.964 + * @param valueTypes the type(s) of the argument to drop
96.965 + * @param pos which argument to drop (zero for the first)
96.966 + * @return a new method handle which drops an argument of the given type,
96.967 + * before calling the original method handle
96.968 + */
96.969 + public static
96.970 + MethodHandle dropArguments(MethodHandle target, int pos, Class<?>... valueTypes) {
96.971 + if (valueTypes.length == 0) return target;
96.972 + MethodType oldType = target.type();
96.973 + int outargs = oldType.parameterCount();
96.974 + int inargs = outargs + valueTypes.length;
96.975 + if (pos < 0 || pos >= inargs)
96.976 + throw newIllegalArgumentException("no argument type to remove");
96.977 + ArrayList<Class<?>> ptypes =
96.978 + new ArrayList<Class<?>>(oldType.parameterList());
96.979 + ptypes.addAll(pos, Arrays.asList(valueTypes));
96.980 + MethodType newType = MethodType.make(oldType.returnType(), ptypes);
96.981 + return MethodHandleImpl.dropArguments(IMPL_TOKEN, target, newType, pos);
96.982 + }
96.983 +
96.984 + /**
96.985 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.986 + * Make a method handle which adapts a target method handle,
96.987 + * by guarding it with a test, a boolean-valued method handle.
96.988 + * If the guard fails, a fallback handle is called instead.
96.989 + * All three method handles must have the same corresponding
96.990 + * argument and return types, except that the return type
96.991 + * of the test must be boolean.
96.992 + * <p> Here is pseudocode for the resulting adapter:
96.993 + * <blockquote><pre>
96.994 + * signature T(A...);
96.995 + * boolean test(A...);
96.996 + * T target(A...);
96.997 + * T fallback(A...);
96.998 + * T adapter(A... a) {
96.999 + * if (test(a...))
96.1000 + * return target(a...);
96.1001 + * else
96.1002 + * return fallback(a...);
96.1003 + * }
96.1004 + * </pre></blockquote>
96.1005 + * @param test method handle used for test, must return boolean
96.1006 + * @param target method handle to call if test passes
96.1007 + * @param fallback method handle to call if test fails
96.1008 + * @return method handle which incorporates the specified if/then/else logic
96.1009 + * @throws IllegalArgumentException if {@code test} does not return boolean,
96.1010 + * or if all three method types do not match (with the return
96.1011 + * type of {@code test} changed to match that of {@code target}).
96.1012 + */
96.1013 + public static
96.1014 + MethodHandle guardWithTest(MethodHandle test,
96.1015 + MethodHandle target,
96.1016 + MethodHandle fallback) {
96.1017 + if (target.type() != fallback.type())
96.1018 + throw newIllegalArgumentException("target and fallback types do not match");
96.1019 + if (target.type().changeReturnType(boolean.class) != test.type())
96.1020 + throw newIllegalArgumentException("target and test types do not match");
96.1021 + /* {
96.1022 + MethodHandle invoke = findVirtual(MethodHandle.class, "invoke", target.type());
96.1023 + static MethodHandle choose(boolean z, MethodHandle t, MethodHandle f) {
96.1024 + return z ? t : f;
96.1025 + }
96.1026 + static MethodHandle compose(MethodHandle f, MethodHandle g) {
96.1027 + Class<?> initargs = g.type().parameterArray();
96.1028 + f = dropArguments(f, 1, initargs); // ignore 2nd copy of args
96.1029 + return combineArguments(f, g);
96.1030 + }
96.1031 + // choose = \z.(z ? target : fallback)
96.1032 + MethodHandle choose = findVirtual(MethodHandles.class, "choose",
96.1033 + MethodType.make(boolean.class, MethodHandle.class, MethodHandle.class));
96.1034 + choose = appendArgument(choose, target);
96.1035 + choose = appendArgument(choose, fallback);
96.1036 + MethodHandle dispatch = compose(choose, test);
96.1037 + // dispatch = \(a...).(test(a...) ? target : fallback)
96.1038 + return combineArguments(invoke, dispatch, 0);
96.1039 + // return \(a...).((test(a...) ? target : fallback).invoke(a...))
96.1040 + } */
96.1041 + return MethodHandleImpl.makeGuardWithTest(IMPL_TOKEN, test, target, fallback);
96.1042 + }
96.1043 +
96.1044 + /**
96.1045 + * <em>PROVISIONAL API, WORK IN PROGRESS:</em>
96.1046 + * Adapt a target method handle {@code target} by first processing
96.1047 + * its arguments, and then calling the target.
96.1048 + * The initial processing is performed by a second method handle, the {@code combiner}.
96.1049 + * After this, control passes to the {@code target}, with the same arguments.
96.1050 + * <p>
96.1051 + * The return value of the {@code combiner} is inserted into the argument list
96.1052 + * for the {@code target} at the indicated position {@code pos}, if it is non-negative.
96.1053 + * Except for this inserted argument (if any), the argument types of
96.1054 + * the target {@code target} and the {@code combiner} must be identical.
96.1055 + * <p>
96.1056 + * (Note that {@link #dropArguments} can be used to remove any arguments
96.1057 + * that either the {@code combiner} or {@code target} does not wish to receive.)
96.1058 + * <p>
96.1059 + * The combiner handle must have the same argument types as the
96.1060 + * target handle, but must return {@link MethodHandle} instead of
96.1061 + * the ultimate return type. The returned method handle, in turn,
96.1062 + * is required to have exactly the given final method type.
96.1063 + * <p> Here is pseudocode for the resulting adapter:
96.1064 + * <blockquote><pre>
96.1065 + * signature V(A[pos]..., B...);
96.1066 + * signature T(A[pos]..., V, B...);
96.1067 + * T target(A... a, V v, B... b);
96.1068 + * V combiner(A..., B...);
96.1069 + * T adapter(A... a, B... b) {
96.1070 + * V v = combiner(a..., b...);
96.1071 + * return target(a..., v, b...);
96.1072 + * }
96.1073 + * </pre></blockquote>
96.1074 + * @param target the method handle to invoke after arguments are combined
96.1075 + * @param pos where the return value of {@code combiner} is to
96.1076 + * be inserted as an argument to {@code target}
96.1077 + * @param combiner method handle to call initially on the incoming arguments
96.1078 + * @return method handle which incorporates the specified dispatch logic
96.1079 + * @throws IllegalArgumentException if {@code combiner} does not itself
96.1080 + * return either void or the {@code pos}-th argument of {@code target},
96.1081 + * or does not have the same argument types as {@code target}
96.1082 + * (minus the inserted argument)
96.1083 + */
96.1084 + public static
96.1085 + MethodHandle combineArguments(MethodHandle target, int pos, MethodHandle combiner) {
96.1086 + MethodType mhType = target.type();
96.1087 + Class<?> combineType = combiner.type().returnType();
96.1088 + MethodType incomingArgs;
96.1089 + if (pos < 0) {
96.1090 + // No inserted argument; target & combiner must have same argument types.
96.1091 + incomingArgs = mhType;
96.1092 + if (!incomingArgs.changeReturnType(combineType).equals(combiner.type()))
96.1093 + throw newIllegalArgumentException("target and combiner types do not match");
96.1094 + } else {
96.1095 + // Inserted argument.
96.1096 + if (pos >= mhType.parameterCount()
96.1097 + || mhType.parameterType(pos) != combineType)
96.1098 + throw newIllegalArgumentException("inserted combiner argument does not match target");
96.1099 + incomingArgs = mhType.dropParameterType(pos);
96.1100 + }
96.1101 + if (!incomingArgs.changeReturnType(combineType).equals(combiner.type())) {
96.1102 + throw newIllegalArgumentException("target and combiner types do not match");
96.1103 + }
96.1104 + return MethodHandleImpl.combineArguments(IMPL_TOKEN, target, combiner, pos);
96.1105 + }
96.1106 +
96.1107 +}
97.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
97.2 +++ b/src/share/classes/java/dyn/MethodType.java Thu May 14 00:17:25 2009 -0700
97.3 @@ -0,0 +1,575 @@
97.4 +/*
97.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
97.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
97.7 + *
97.8 + * This code is free software; you can redistribute it and/or modify it
97.9 + * under the terms of the GNU General Public License version 2 only, as
97.10 + * published by the Free Software Foundation. Sun designates this
97.11 + * particular file as subject to the "Classpath" exception as provided
97.12 + * by Sun in the LICENSE file that accompanied this code.
97.13 + *
97.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
97.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
97.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
97.17 + * version 2 for more details (a copy is included in the LICENSE file that
97.18 + * accompanied this code).
97.19 + *
97.20 + * You should have received a copy of the GNU General Public License version
97.21 + * 2 along with this work; if not, write to the Free Software Foundation,
97.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
97.23 + *
97.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
97.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
97.26 + * have any questions.
97.27 + */
97.28 +
97.29 +package java.dyn;
97.30 +
97.31 +import java.util.Arrays;
97.32 +import java.util.Collections;
97.33 +import java.util.HashMap;
97.34 +import java.util.List;
97.35 +import sun.dyn.Access;
97.36 +import sun.dyn.Invokers;
97.37 +import sun.dyn.MethodTypeImpl;
97.38 +import sun.dyn.util.BytecodeSignature;
97.39 +import static sun.dyn.MemberName.newIllegalArgumentException;
97.40 +
97.41 +/**
97.42 + * Run-time token used to match call sites with method handles.
97.43 + * The structure is a return type accompanied by any number of parameter types.
97.44 + * The types (primitive, void, and reference) are represented by Class objects.
97.45 + * All instances of <code>MethodType</code> are immutable.
97.46 + * Two instances are completely interchangeable if they compare equal.
97.47 + * Equality depends exactly on the return and parameter types.
97.48 + * <p>
97.49 + * This type can be created only by factory methods, which manage interning.
97.50 + *
97.51 + * @author John Rose, JSR 292 EG
97.52 + */
97.53 +public final
97.54 +class MethodType {
97.55 + private final Class<?> rtype;
97.56 + private final Class<?>[] ptypes;
97.57 + private MethodTypeForm form; // erased form, plus cached data about primitives
97.58 + private MethodType wrapAlt; // alternative wrapped/unwrapped version
97.59 + private Invokers invokers; // cache of handy higher-order adapters
97.60 +
97.61 + private static final Access IMPL_TOKEN = Access.getToken();
97.62 +
97.63 + // share a cache with a friend in this package
97.64 + Invokers getInvokers() { return invokers; }
97.65 + void setInvokers(Invokers inv) { invokers = inv; }
97.66 +
97.67 + static {
97.68 + // This hack allows the implementation package special access to
97.69 + // the internals of MethodType. In particular, the Form has all sorts
97.70 + // of cached information useful to the implementation code.
97.71 + MethodTypeImpl.setMethodTypeFriend(IMPL_TOKEN, new MethodTypeImpl.MethodTypeFriend() {
97.72 + public Class<?>[] ptypes(MethodType mt) { return mt.ptypes; }
97.73 + public MethodTypeImpl form(MethodType mt) { return mt.form; }
97.74 + public void setForm(MethodType mt, MethodTypeImpl form) {
97.75 + assert(mt.form == null);
97.76 + mt.form = (MethodTypeForm) form;
97.77 + }
97.78 + public MethodType makeImpl(Class<?> rtype, Class<?>[] ptypes, boolean trusted) {
97.79 + return MethodType.makeImpl(rtype, ptypes, trusted);
97.80 + }
97.81 + public MethodTypeImpl newMethodTypeForm(MethodType mt) {
97.82 + return new MethodTypeForm(mt);
97.83 + }
97.84 + public Invokers getInvokers(MethodType mt) { return mt.invokers; }
97.85 + public void setInvokers(MethodType mt, Invokers inv) { mt.invokers = inv; }
97.86 + });
97.87 + }
97.88 +
97.89 + private MethodType(Class<?> rtype, Class<?>[] ptypes) {
97.90 + checkRtype(rtype);
97.91 + checkPtypes(ptypes);
97.92 + this.rtype = rtype;
97.93 + this.ptypes = ptypes;
97.94 + }
97.95 +
97.96 + private void checkRtype(Class<?> rtype) {
97.97 + rtype.equals(rtype); // null check
97.98 + }
97.99 + private void checkPtypes(Class<?>[] ptypes) {
97.100 + for (Class<?> ptype : ptypes) {
97.101 + ptype.equals(ptype); // null check
97.102 + if (ptype == void.class)
97.103 + throw newIllegalArgumentException("void parameter: "+this);
97.104 + }
97.105 + }
97.106 +
97.107 + static final HashMap<MethodType,MethodType> internTable
97.108 + = new HashMap<MethodType, MethodType>();
97.109 +
97.110 + static final Class<?>[] NO_PTYPES = {};
97.111 +
97.112 + /** Find or create an instance of the given method type.
97.113 + * @param rtype the return type
97.114 + * @param ptypes the parameter types
97.115 + * @return the interned method type with the given parts
97.116 + * @throws NullPointerException if rtype or any ptype is null
97.117 + * @throws IllegalArgumentException if any of the ptypes is void
97.118 + */
97.119 + public static
97.120 + MethodType make(Class<?> rtype, Class<?>[] ptypes) {
97.121 + return makeImpl(rtype, ptypes, false);
97.122 + }
97.123 +
97.124 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}. */
97.125 + public static
97.126 + MethodType make(Class<?> rtype, List<? extends Class<?>> ptypes) {
97.127 + return makeImpl(rtype, ptypes.toArray(NO_PTYPES), true);
97.128 + }
97.129 +
97.130 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.131 + * The leading parameter type is prepended to the remaining array.
97.132 + */
97.133 + public static
97.134 + MethodType make(Class<?> rtype, Class<?> ptype0, Class<?>... ptypes) {
97.135 + Class<?>[] ptypes1 = new Class<?>[1+ptypes.length];
97.136 + ptypes1[0] = ptype0;
97.137 + System.arraycopy(ptypes, 0, ptypes1, 1, ptypes.length);
97.138 + return makeImpl(rtype, ptypes1, true);
97.139 + }
97.140 +
97.141 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.142 + * The resulting method has no parameter types.
97.143 + */
97.144 + public static
97.145 + MethodType make(Class<?> rtype) {
97.146 + return makeImpl(rtype, NO_PTYPES, true);
97.147 + }
97.148 +
97.149 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.150 + * The resulting method has the single given parameter type.
97.151 + */
97.152 + public static
97.153 + MethodType make(Class<?> rtype, Class<?> ptype0) {
97.154 + return makeImpl(rtype, new Class<?>[]{ ptype0 }, true);
97.155 + }
97.156 +
97.157 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.158 + * The resulting method has the same parameter types as {@code ptypes},
97.159 + * and the specified return type.
97.160 + */
97.161 + public static
97.162 + MethodType make(Class<?> rtype, MethodType ptypes) {
97.163 + return makeImpl(rtype, ptypes.ptypes, true);
97.164 + }
97.165 +
97.166 + /**
97.167 + * Sole factory method to find or create an interned method type.
97.168 + * @param rtype desired return type
97.169 + * @param ptypes desired parameter types
97.170 + * @param trusted whether the ptypes can be used without cloning
97.171 + * @return the unique method type of the desired structure
97.172 + */
97.173 + private static
97.174 + MethodType makeImpl(Class<?> rtype, Class<?>[] ptypes, boolean trusted) {
97.175 + if (ptypes == null || ptypes.length == 0) {
97.176 + ptypes = NO_PTYPES; trusted = true;
97.177 + }
97.178 + MethodType mt1 = new MethodType(rtype, ptypes);
97.179 + MethodType mt0;
97.180 + synchronized (internTable) {
97.181 + mt0 = internTable.get(mt1);
97.182 + if (mt0 != null)
97.183 + return mt0;
97.184 + }
97.185 + if (!trusted)
97.186 + // defensively copy the array passed in by the user
97.187 + mt1 = new MethodType(rtype, ptypes.clone());
97.188 + // promote the object to the Real Thing, and reprobe
97.189 + MethodTypeImpl.initForm(IMPL_TOKEN, mt1);
97.190 + synchronized (internTable) {
97.191 + mt0 = internTable.get(mt1);
97.192 + if (mt0 != null)
97.193 + return mt0;
97.194 + internTable.put(mt1, mt1);
97.195 + }
97.196 + return mt1;
97.197 + }
97.198 +
97.199 + // Entry point from JVM. TODO: Change the name & signature.
97.200 + private static MethodType makeImpl(Class<?> rtype, Class<?>[] ptypes,
97.201 + boolean ignore1, boolean ignore2) {
97.202 + return makeImpl(rtype, ptypes, true);
97.203 + }
97.204 +
97.205 + private static final MethodType[] objectOnlyTypes = new MethodType[20];
97.206 +
97.207 + /**
97.208 + * Convenience method for {@link #make(java.lang.Class, java.lang.Class[], boolean)}.
97.209 + * All parameters and the return type will be Object, except the final varargs parameter if any.
97.210 + * @param objectArgCount number of parameters (excluding the varargs parameter if any)
97.211 + * @param varargs whether there will be a varargs parameter, of type Object[]
97.212 + * @return a totally generic method type, given only its count of parameters and varargs
97.213 + * @see #makeGeneric(int)
97.214 + */
97.215 + public static
97.216 + MethodType makeGeneric(int objectArgCount, boolean varargs) {
97.217 + MethodType mt;
97.218 + int ivarargs = (!varargs ? 0 : 1);
97.219 + int ootIndex = objectArgCount*2 + ivarargs;
97.220 + if (ootIndex < objectOnlyTypes.length) {
97.221 + mt = objectOnlyTypes[ootIndex];
97.222 + if (mt != null) return mt;
97.223 + }
97.224 + Class<?>[] ptypes = new Class<?>[objectArgCount + ivarargs];
97.225 + Arrays.fill(ptypes, Object.class);
97.226 + if (ivarargs != 0) ptypes[objectArgCount] = Object[].class;
97.227 + mt = makeImpl(Object.class, ptypes, true);
97.228 + if (ootIndex < objectOnlyTypes.length) {
97.229 + objectOnlyTypes[ootIndex] = mt; // cache it here also!
97.230 + }
97.231 + return mt;
97.232 + }
97.233 +
97.234 + /**
97.235 + * All parameters and the return type will be Object.
97.236 + * @param objectArgCount number of parameters
97.237 + * @return a totally generic method type, given only its count of parameters
97.238 + * @see #makeGeneric(int, boolean)
97.239 + */
97.240 + public static
97.241 + MethodType makeGeneric(int objectArgCount) {
97.242 + return makeGeneric(objectArgCount, false);
97.243 + }
97.244 +
97.245 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[], boolean)}.
97.246 + * @param num the index (zero-based) of the parameter type to change
97.247 + * @param nptype a new parameter type to replace the old one with
97.248 + * @return the same type, except with the selected parameter changed
97.249 + */
97.250 + public MethodType changeParameterType(int num, Class<?> nptype) {
97.251 + if (parameterType(num) == nptype) return this;
97.252 + Class<?>[] nptypes = ptypes.clone();
97.253 + nptypes[num] = nptype;
97.254 + return makeImpl(rtype, nptypes, true);
97.255 + }
97.256 +
97.257 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[], boolean)}.
97.258 + * @param num the position (zero-based) of the inserted parameter type
97.259 + * @param nptype a new parameter type to insert into the parameter list
97.260 + * @return the same type, except with the selected parameter inserted
97.261 + */
97.262 + public MethodType insertParameterType(int num, Class<?> nptype) {
97.263 + int len = ptypes.length;
97.264 + Class<?>[] nptypes = Arrays.copyOfRange(ptypes, 0, len+1);
97.265 + System.arraycopy(nptypes, num, nptypes, num+1, len-num);
97.266 + nptypes[num] = nptype;
97.267 + return makeImpl(rtype, nptypes, true);
97.268 + }
97.269 +
97.270 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[], boolean)}.
97.271 + * @param num the index (zero-based) of the parameter type to remove
97.272 + * @return the same type, except with the selected parameter removed
97.273 + */
97.274 + public MethodType dropParameterType(int num) {
97.275 + int len = ptypes.length;
97.276 + Class<?>[] nptypes;
97.277 + if (num == 0) {
97.278 + nptypes = Arrays.copyOfRange(ptypes, 1, len);
97.279 + } else {
97.280 + nptypes = Arrays.copyOfRange(ptypes, 0, len-1);
97.281 + System.arraycopy(ptypes, num+1, nptypes, num, (len-1)-num);
97.282 + }
97.283 + return makeImpl(rtype, nptypes, true);
97.284 + }
97.285 +
97.286 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[], boolean)}.
97.287 + * @param nrtype a return parameter type to replace the old one with
97.288 + * @return the same type, except with the return type change
97.289 + */
97.290 + public MethodType changeReturnType(Class<?> nrtype) {
97.291 + if (returnType() == nrtype) return this;
97.292 + return makeImpl(nrtype, ptypes, true);
97.293 + }
97.294 +
97.295 + /** Convenience method.
97.296 + * Report if this type contains a primitive argument or return value.
97.297 + * @return true if any of the types are primitives
97.298 + */
97.299 + public boolean hasPrimitives() {
97.300 + return form.hasPrimitives();
97.301 + }
97.302 +
97.303 + /** Convenience method.
97.304 + * Report if this type contains a wrapper argument or return value.
97.305 + * Wrappers are types which box primitive values, such as {@link Integer}.
97.306 + * @return true if any of the types are wrappers
97.307 + */
97.308 + public boolean hasWrappers() {
97.309 + return unwrap() != this;
97.310 + }
97.311 +
97.312 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.313 + * Erase all reference types to Object.
97.314 + * @return a version of the original type with all reference types replaced
97.315 + */
97.316 + public MethodType erase() {
97.317 + return form.erasedType();
97.318 + }
97.319 +
97.320 + /** Convenience method for {@link #makeGeneric(int)}.
97.321 + * Convert all types, both reference and primitive, to Object.
97.322 + * @return a version of the original type with all types replaced
97.323 + */
97.324 + public MethodType generic() {
97.325 + return makeGeneric(parameterCount());
97.326 + }
97.327 +
97.328 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.329 + * Convert all primitive types to their corresponding wrapper types.
97.330 + * A {@code void} return type is changed to the type {@code java.lang.Void}.
97.331 + * @return a version of the original type with all primitive types replaced
97.332 + */
97.333 + public MethodType wrap() {
97.334 + return hasPrimitives() ? wrapWithPrims(this) : this;
97.335 + }
97.336 +
97.337 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.338 + * Convert all wrapper types to their corresponding primitive types.
97.339 + * A return type of {@code java.lang.Void} is changed to {@code void}.
97.340 + * @return a version of the original type with all wrapper types replaced
97.341 + */
97.342 + public MethodType unwrap() {
97.343 + MethodType noprims = !hasPrimitives() ? this : wrapWithPrims(this);
97.344 + return unwrapWithNoPrims(noprims);
97.345 + }
97.346 +
97.347 + private static MethodType wrapWithPrims(MethodType pt) {
97.348 + assert(pt.hasPrimitives());
97.349 + MethodType wt = pt.wrapAlt;
97.350 + if (wt == null) {
97.351 + // fill in lazily
97.352 + wt = MethodTypeImpl.canonicalize(pt, MethodTypeImpl.WRAP, MethodTypeImpl.WRAP);
97.353 + assert(wt != null);
97.354 + pt.wrapAlt = wt;
97.355 + }
97.356 + return wt;
97.357 + }
97.358 +
97.359 + private static MethodType unwrapWithNoPrims(MethodType wt) {
97.360 + assert(!wt.hasPrimitives());
97.361 + MethodType uwt = wt.wrapAlt;
97.362 + if (uwt == null) {
97.363 + // fill in lazily
97.364 + uwt = MethodTypeImpl.canonicalize(wt, MethodTypeImpl.UNWRAP, MethodTypeImpl.UNWRAP);
97.365 + if (uwt == null)
97.366 + uwt = wt; // type has no wrappers or prims at all
97.367 + wt.wrapAlt = uwt;
97.368 + }
97.369 + return uwt;
97.370 + }
97.371 +
97.372 + /** @param num the index (zero-based) of the desired parameter type
97.373 + * @return the selected parameter type
97.374 + */
97.375 + public Class<?> parameterType(int num) {
97.376 + return ptypes[num];
97.377 + }
97.378 + /** @return the number of parameter types */
97.379 + public int parameterCount() {
97.380 + return ptypes.length;
97.381 + }
97.382 + /** @return the return type */
97.383 + public Class<?> returnType() {
97.384 + return rtype;
97.385 + }
97.386 +
97.387 + /**
97.388 + * Convenience method to present the arguments as a list.
97.389 + * @return the parameter types (as an immutable list)
97.390 + */
97.391 + public List<Class<?>> parameterList() {
97.392 + return Collections.unmodifiableList(Arrays.asList(ptypes));
97.393 + }
97.394 +
97.395 + /**
97.396 + * Convenience method to present the arguments as an array.
97.397 + * @return the parameter types (as a fresh copy if necessary)
97.398 + */
97.399 + public Class<?>[] parameterArray() {
97.400 + return ptypes.clone();
97.401 + }
97.402 +
97.403 + /**
97.404 + * Compares the specified object with this type for equality.
97.405 + * That is, it returns <tt>true</tt> if and only if the specified object
97.406 + * is also a method type with exactly the same parameters and return type.
97.407 + * @param x object to compare
97.408 + * @see Object#equals(Object)
97.409 + */
97.410 + @Override
97.411 + public boolean equals(Object x) {
97.412 + return this == x || x instanceof MethodType && equals((MethodType)x);
97.413 + }
97.414 +
97.415 + private boolean equals(MethodType that) {
97.416 + return this.rtype == that.rtype
97.417 + && Arrays.equals(this.ptypes, that.ptypes);
97.418 + }
97.419 +
97.420 + /**
97.421 + * Returns the hash code value for this method type.
97.422 + * It is defined to be the same as the hashcode of a List
97.423 + * whose elements are the return type followed by the
97.424 + * parameter types.
97.425 + * @return the hash code value for this method type
97.426 + * @see Object#hashCode()
97.427 + * @see #equals(Object)
97.428 + * @see List#hashCode()
97.429 + */
97.430 + @Override
97.431 + public int hashCode() {
97.432 + int hashCode = 31 + rtype.hashCode();
97.433 + for (Class<?> ptype : ptypes)
97.434 + hashCode = 31*hashCode + ptype.hashCode();
97.435 + return hashCode;
97.436 + }
97.437 +
97.438 + /**
97.439 + * The string representation of a method type is a
97.440 + * parenthesis enclosed, comma separated list of type names,
97.441 + * followed immediately by the return type.
97.442 + * <p>
97.443 + * If a type name is array, it the base type followed
97.444 + * by [], rather than the Class.getName of the array type.
97.445 + */
97.446 + @Override
97.447 + public String toString() {
97.448 + StringBuilder sb = new StringBuilder();
97.449 + sb.append("(");
97.450 + for (int i = 0; i < ptypes.length; i++) {
97.451 + if (i > 0) sb.append(",");
97.452 + putName(sb, ptypes[i]);
97.453 + }
97.454 + sb.append(")");
97.455 + putName(sb, rtype);
97.456 + return sb.toString();
97.457 + }
97.458 +
97.459 + static void putName(StringBuilder sb, Class<?> cls) {
97.460 + int brackets = 0;
97.461 + while (cls.isArray()) {
97.462 + cls = cls.getComponentType();
97.463 + brackets++;
97.464 + }
97.465 + String n = cls.getName();
97.466 + /*
97.467 + if (n.startsWith("java.lang.")) {
97.468 + String nb = n.substring("java.lang.".length());
97.469 + if (nb.indexOf('.') < 0) n = nb;
97.470 + } else if (n.indexOf('.') < 0) {
97.471 + n = "."+n; // anonymous package
97.472 + }
97.473 + */
97.474 + sb.append(n);
97.475 + while (brackets > 0) {
97.476 + sb.append("[]");
97.477 + brackets--;
97.478 + }
97.479 + }
97.480 +
97.481 + /// Queries which have to do with the bytecode architecture
97.482 +
97.483 + /** The number of JVM stack slots required to invoke a method
97.484 + * of this type. Note that (for historic reasons) the JVM requires
97.485 + * a second stack slot to pass long and double arguments.
97.486 + * So this method returns {@link #parameterCount()} plus the
97.487 + * number of long and double parameters (if any).
97.488 + * <p>
97.489 + * This method is included for the benfit of applications that must
97.490 + * generate bytecodes that process method handles and invokedynamic.
97.491 + * @return the number of JVM stack slots for this type's parameters
97.492 + */
97.493 + public int parameterSlotCount() {
97.494 + return form.parameterSlotCount();
97.495 + }
97.496 +
97.497 + /** Number of JVM stack slots which carry all parameters after
97.498 + * the given position, which must be in the range of 0 to
97.499 + * {@code parameterCount} inclusive. Successive parameters are
97.500 + * more shallowly stacked, and parameters are indexed in the bytecodes
97.501 + * according to their trailing edge. Thus, to obtain the depth
97.502 + * in the outgoing call stack of parameter {@code N}, obtain
97.503 + * the {@code parameterSlotDepth} of its trailing edge
97.504 + * at position {@code N+1}.
97.505 + * <p>
97.506 + * Parameters of type {@code long} and {@code double} occupy
97.507 + * two stack slots (for historical reasons) and all others occupy one.
97.508 + * Therefore, the number returned is the number of arguments
97.509 + * <em>including</em> and <em>after</em> the given parameter,
97.510 + * <em>plus</em> the number of long or double arguments
97.511 + * at or after after the argument for the given parameter.
97.512 + * <p>
97.513 + * This method is included for the benfit of applications that must
97.514 + * generate bytecodes that process method handles and invokedynamic.
97.515 + * @param num an index (zero-based, inclusive) within the parameter types
97.516 + * @return the index of the (shallowest) JVM stack slot transmitting the
97.517 + * given parameter
97.518 + */
97.519 + public int parameterSlotDepth(int num) {
97.520 + if (num < 0 || num > ptypes.length)
97.521 + parameterType(num); // force a range check
97.522 + return form.parameterToArgSlot(num-1);
97.523 + }
97.524 +
97.525 + /** The number of JVM stack slots required to receive a return value
97.526 + * from a method of this type.
97.527 + * If the {@link #returnType() return type} is void, it will be zero,
97.528 + * else if the return type is long or double, it will be two, else one.
97.529 + * <p>
97.530 + * This method is included for the benfit of applications that must
97.531 + * generate bytecodes that process method handles and invokedynamic.
97.532 + * @return the number of JVM stack slots (0, 1, or 2) for this type's return value
97.533 + */
97.534 + public int returnSlotCount() {
97.535 + return form.returnSlotCount();
97.536 + }
97.537 +
97.538 + /** Convenience method for {@link #make(java.lang.Class, java.lang.Class[])}.
97.539 + * Find or create an instance (interned) of the given method type.
97.540 + * Any class or interface name embedded in the signature string
97.541 + * will be resolved by calling {@link ClassLoader#loadClass(java.lang.String)}
97.542 + * on the given loader (or if it is null, on the system class loader).
97.543 + * <p>
97.544 + * Note that it is possible to build method types which cannot be
97.545 + * constructed by this method, because their component types are
97.546 + * not all reachable from a common class loader.
97.547 + * <p>
97.548 + * This method is included for the benfit of applications that must
97.549 + * generate bytecodes that process method handles and invokedynamic.
97.550 + * @param bytecodeSignature a bytecode-level signature string "(T...)T"
97.551 + * @param loader the class loader in which to look up the types
97.552 + * @return a method type matching the bytecode-level signature
97.553 + * @throws IllegalArgumentException if the string is not well-formed
97.554 + * @throws TypeNotPresentException if a named type cannot be found
97.555 + */
97.556 + public static MethodType fromBytecodeString(String bytecodeSignature, ClassLoader loader)
97.557 + throws IllegalArgumentException, TypeNotPresentException
97.558 + {
97.559 + List<Class<?>> types = BytecodeSignature.parseMethod(bytecodeSignature, loader);
97.560 + Class<?> rtype = types.remove(types.size() - 1);
97.561 + Class<?>[] ptypes = types.toArray(NO_PTYPES);
97.562 + return makeImpl(rtype, ptypes, true);
97.563 + }
97.564 +
97.565 + /**
97.566 + * Create a bytecode signature representation of the type.
97.567 + * Note that this is not a strict inverse of
97.568 + * <p>
97.569 + * This method is included for the benfit of applications that must
97.570 + * generate bytecodes that process method handles and invokedynamic.
97.571 + * {@link #fromBytecodeString(java.lang.String, java.lang.ClassLoader)},
97.572 + * because the latter requires a suitable class loader argument.
97.573 + * @return the bytecode signature representation
97.574 + */
97.575 + public String toBytecodeString() {
97.576 + return BytecodeSignature.unparse(this);
97.577 + }
97.578 +}
98.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
98.2 +++ b/src/share/classes/java/dyn/MethodTypeForm.java Thu May 14 00:17:25 2009 -0700
98.3 @@ -0,0 +1,39 @@
98.4 +/*
98.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
98.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
98.7 + *
98.8 + * This code is free software; you can redistribute it and/or modify it
98.9 + * under the terms of the GNU General Public License version 2 only, as
98.10 + * published by the Free Software Foundation. Sun designates this
98.11 + * particular file as subject to the "Classpath" exception as provided
98.12 + * by Sun in the LICENSE file that accompanied this code.
98.13 + *
98.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
98.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
98.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
98.17 + * version 2 for more details (a copy is included in the LICENSE file that
98.18 + * accompanied this code).
98.19 + *
98.20 + * You should have received a copy of the GNU General Public License version
98.21 + * 2 along with this work; if not, write to the Free Software Foundation,
98.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
98.23 + *
98.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
98.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
98.26 + * have any questions.
98.27 + */
98.28 +
98.29 +package java.dyn;
98.30 +
98.31 +/**
98.32 + * TO DO: Temporary shim; remove after refactoring effects are complete in JVM.
98.33 + * @author John Rose
98.34 + */
98.35 +import sun.dyn.MethodTypeImpl;
98.36 +
98.37 +class MethodTypeForm extends MethodTypeImpl {
98.38 +
98.39 + MethodTypeForm(MethodType erasedType) {
98.40 + super(erasedType);
98.41 + }
98.42 +}
99.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
99.2 +++ b/src/share/classes/java/dyn/NoAccessException.java Thu May 14 00:17:25 2009 -0700
99.3 @@ -0,0 +1,75 @@
99.4 +/*
99.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
99.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
99.7 + *
99.8 + * This code is free software; you can redistribute it and/or modify it
99.9 + * under the terms of the GNU General Public License version 2 only, as
99.10 + * published by the Free Software Foundation. Sun designates this
99.11 + * particular file as subject to the "Classpath" exception as provided
99.12 + * by Sun in the LICENSE file that accompanied this code.
99.13 + *
99.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
99.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
99.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
99.17 + * version 2 for more details (a copy is included in the LICENSE file that
99.18 + * accompanied this code).
99.19 + *
99.20 + * You should have received a copy of the GNU General Public License version
99.21 + * 2 along with this work; if not, write to the Free Software Foundation,
99.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
99.23 + *
99.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
99.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
99.26 + * have any questions.
99.27 + */
99.28 +
99.29 +package java.dyn;
99.30 +
99.31 +/**
99.32 + * Thrown to indicate that a caller has attempted to create a method handle
99.33 + * which calls a method to which the caller does not have access.
99.34 + * This unchecked exception is analogous to {@link IllegalAccessException},
99.35 + * which is a checked exception thrown when reflective invocation fails
99.36 + * because of an access check. With method handles, this same access
99.37 + * checking is performed on behalf of the method handle creator,
99.38 + * at the time of creation.
99.39 + * @author John Rose, JSR 292 EG
99.40 + */
99.41 +public class NoAccessException extends RuntimeException {
99.42 + /**
99.43 + * Constructs a {@code NoAccessException} with no detail message.
99.44 + */
99.45 + public NoAccessException() {
99.46 + super();
99.47 + }
99.48 +
99.49 + /**
99.50 + * Constructs a {@code NoAccessException} with the specified
99.51 + * detail message.
99.52 + *
99.53 + * @param s the detail message
99.54 + */
99.55 + public NoAccessException(String s) {
99.56 + super(s);
99.57 + }
99.58 +
99.59 + /**
99.60 + * Constructs a {@code NoAccessException} with the specified cause.
99.61 + *
99.62 + * @param cause the underlying cause of the exception
99.63 + */
99.64 + public NoAccessException(Throwable cause) {
99.65 + super(cause);
99.66 + }
99.67 +
99.68 + /**
99.69 + * Constructs a {@code NoAccessException} with the specified
99.70 + * detail message and cause.
99.71 + *
99.72 + * @param s the detail message
99.73 + * @param cause the underlying cause of the exception
99.74 + */
99.75 + public NoAccessException(String s, Throwable cause) {
99.76 + super(s, cause);
99.77 + }
99.78 +}
100.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
100.2 +++ b/src/share/classes/java/dyn/WrongMethodTypeException.java Thu May 14 00:17:25 2009 -0700
100.3 @@ -0,0 +1,59 @@
100.4 +/*
100.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
100.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
100.7 + *
100.8 + * This code is free software; you can redistribute it and/or modify it
100.9 + * under the terms of the GNU General Public License version 2 only, as
100.10 + * published by the Free Software Foundation. Sun designates this
100.11 + * particular file as subject to the "Classpath" exception as provided
100.12 + * by Sun in the LICENSE file that accompanied this code.
100.13 + *
100.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
100.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
100.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
100.17 + * version 2 for more details (a copy is included in the LICENSE file that
100.18 + * accompanied this code).
100.19 + *
100.20 + * You should have received a copy of the GNU General Public License version
100.21 + * 2 along with this work; if not, write to the Free Software Foundation,
100.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
100.23 + *
100.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
100.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
100.26 + * have any questions.
100.27 + */
100.28 +
100.29 +package java.dyn;
100.30 +
100.31 +/**
100.32 + * Thrown to indicate that code has attempted to call a method handle
100.33 + * via the wrong method type. As with the bytecode representation of
100.34 + * normal Java method calls, method handle calls are strongly typed
100.35 + * to a specific signature associated with a call site.
100.36 + * <p>
100.37 + * This exception may also be thrown when two method handles are
100.38 + * composed, and the system detects that their types cannot be
100.39 + * matched up correctly. This amounts to an early evaluation
100.40 + * of the type mismatch, at method handle construction time,
100.41 + * instead of when the mismatched method handle is called.
100.42 + *
100.43 + * @author John Rose, JSR 292 EG
100.44 + */
100.45 +public class WrongMethodTypeException extends RuntimeException {
100.46 + /**
100.47 + * Constructs a {@code WrongMethodTypeException} with no detail message.
100.48 + */
100.49 + public WrongMethodTypeException() {
100.50 + super();
100.51 + }
100.52 +
100.53 + /**
100.54 + * Constructs a {@code WrongMethodTypeException} with the specified
100.55 + * detail message.
100.56 + *
100.57 + * @param s the detail message.
100.58 + */
100.59 + public WrongMethodTypeException(String s) {
100.60 + super(s);
100.61 + }
100.62 +}
101.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
101.2 +++ b/src/share/classes/java/dyn/package-info.java Thu May 14 00:17:25 2009 -0700
101.3 @@ -0,0 +1,32 @@
101.4 +/*
101.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
101.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
101.7 + *
101.8 + * This code is free software; you can redistribute it and/or modify it
101.9 + * under the terms of the GNU General Public License version 2 only, as
101.10 + * published by the Free Software Foundation. Sun designates this
101.11 + * particular file as subject to the "Classpath" exception as provided
101.12 + * by Sun in the LICENSE file that accompanied this code.
101.13 + *
101.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
101.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
101.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
101.17 + * version 2 for more details (a copy is included in the LICENSE file that
101.18 + * accompanied this code).
101.19 + *
101.20 + * You should have received a copy of the GNU General Public License version
101.21 + * 2 along with this work; if not, write to the Free Software Foundation,
101.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
101.23 + *
101.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
101.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
101.26 + * have any questions.
101.27 + */
101.28 +
101.29 +/**
101.30 + * This package contains dynamic language support provided directly by
101.31 + * the Java core class libraries and virtual machine.
101.32 + * @author John Rose, JSR 292 EG
101.33 + */
101.34 +
101.35 +package java.dyn;
102.1 --- a/src/share/classes/java/io/Console.java Tue May 12 15:21:55 2009 +0900
102.2 +++ b/src/share/classes/java/io/Console.java Thu May 14 00:17:25 2009 -0700
102.3 @@ -503,20 +503,25 @@
102.4
102.5 // Set up JavaIOAccess in SharedSecrets
102.6 static {
102.7 -
102.8 - // Add a shutdown hook to restore console's echo state should
102.9 - // it be necessary.
102.10 - sun.misc.SharedSecrets.getJavaLangAccess()
102.11 - .registerShutdownHook(0 /* shutdown hook invocation order */,
102.12 - new Runnable() {
102.13 - public void run() {
102.14 - try {
102.15 - if (echoOff) {
102.16 - echo(true);
102.17 - }
102.18 - } catch (IOException x) { }
102.19 - }
102.20 - });
102.21 + try {
102.22 + // Add a shutdown hook to restore console's echo state should
102.23 + // it be necessary.
102.24 + sun.misc.SharedSecrets.getJavaLangAccess()
102.25 + .registerShutdownHook(0 /* shutdown hook invocation order */,
102.26 + false /* only register if shutdown is not in progress */,
102.27 + new Runnable() {
102.28 + public void run() {
102.29 + try {
102.30 + if (echoOff) {
102.31 + echo(true);
102.32 + }
102.33 + } catch (IOException x) { }
102.34 + }
102.35 + });
102.36 + } catch (IllegalStateException e) {
102.37 + // shutdown is already in progress and console is first used
102.38 + // by a shutdown hook
102.39 + }
102.40
102.41 sun.misc.SharedSecrets.setJavaIOAccess(new sun.misc.JavaIOAccess() {
102.42 public Console console() {
103.1 --- a/src/share/classes/java/io/DeleteOnExitHook.java Tue May 12 15:21:55 2009 +0900
103.2 +++ b/src/share/classes/java/io/DeleteOnExitHook.java Thu May 14 00:17:25 2009 -0700
103.3 @@ -34,23 +34,31 @@
103.4 */
103.5
103.6 class DeleteOnExitHook {
103.7 + private static LinkedHashSet<String> files = new LinkedHashSet<String>();
103.8 static {
103.9 - sun.misc.SharedSecrets.getJavaLangAccess()
103.10 - .registerShutdownHook(2 /* Shutdown hook invocation order */,
103.11 - new Runnable() {
103.12 - public void run() {
103.13 - runHooks();
103.14 - }
103.15 - });
103.16 + // DeleteOnExitHook must be the last shutdown hook to be invoked.
103.17 + // Application shutdown hooks may add the first file to the
103.18 + // delete on exit list and cause the DeleteOnExitHook to be
103.19 + // registered during shutdown in progress. So set the
103.20 + // registerShutdownInProgress parameter to true.
103.21 + sun.misc.SharedSecrets.getJavaLangAccess()
103.22 + .registerShutdownHook(2 /* Shutdown hook invocation order */,
103.23 + true /* register even if shutdown in progress */,
103.24 + new Runnable() {
103.25 + public void run() {
103.26 + runHooks();
103.27 + }
103.28 + }
103.29 + );
103.30 }
103.31
103.32 - private static LinkedHashSet<String> files = new LinkedHashSet<String>();
103.33 -
103.34 private DeleteOnExitHook() {}
103.35
103.36 static synchronized void add(String file) {
103.37 - if(files == null)
103.38 + if(files == null) {
103.39 + // DeleteOnExitHook is running. Too late to add a file
103.40 throw new IllegalStateException("Shutdown in progress");
103.41 + }
103.42
103.43 files.add(file);
103.44 }
104.1 --- a/src/share/classes/java/lang/ApplicationShutdownHooks.java Tue May 12 15:21:55 2009 +0900
104.2 +++ b/src/share/classes/java/lang/ApplicationShutdownHooks.java Thu May 14 00:17:25 2009 -0700
104.3 @@ -35,17 +35,26 @@
104.4 */
104.5
104.6 class ApplicationShutdownHooks {
104.7 + /* The set of registered hooks */
104.8 + private static IdentityHashMap<Thread, Thread> hooks;
104.9 static {
104.10 - Shutdown.add(1 /* shutdown hook invocation order */,
104.11 - new Runnable() {
104.12 - public void run() {
104.13 - runHooks();
104.14 + try {
104.15 + Shutdown.add(1 /* shutdown hook invocation order */,
104.16 + false /* not registered if shutdown in progress */,
104.17 + new Runnable() {
104.18 + public void run() {
104.19 + runHooks();
104.20 + }
104.21 }
104.22 - });
104.23 + );
104.24 + hooks = new IdentityHashMap<Thread, Thread>();
104.25 + } catch (IllegalStateException e) {
104.26 + // application shutdown hooks cannot be added if
104.27 + // shutdown is in progress.
104.28 + hooks = null;
104.29 + }
104.30 }
104.31
104.32 - /* The set of registered hooks */
104.33 - private static IdentityHashMap<Thread, Thread> hooks = new IdentityHashMap<Thread, Thread>();
104.34
104.35 private ApplicationShutdownHooks() {}
104.36
105.1 --- a/src/share/classes/java/lang/Shutdown.java Tue May 12 15:21:55 2009 +0900
105.2 +++ b/src/share/classes/java/lang/Shutdown.java Thu May 14 00:17:25 2009 -0700
105.3 @@ -53,6 +53,9 @@
105.4 private static final int MAX_SYSTEM_HOOKS = 10;
105.5 private static final Runnable[] hooks = new Runnable[MAX_SYSTEM_HOOKS];
105.6
105.7 + // the index of the currently running shutdown hook to the hooks array
105.8 + private static int currentRunningHook = 0;
105.9 +
105.10 /* The preceding static fields are protected by this lock */
105.11 private static class Lock { };
105.12 private static Object lock = new Lock();
105.13 @@ -68,17 +71,39 @@
105.14 }
105.15
105.16
105.17 - /* Add a new shutdown hook. Checks the shutdown state and the hook itself,
105.18 + /**
105.19 + * Add a new shutdown hook. Checks the shutdown state and the hook itself,
105.20 * but does not do any security checks.
105.21 + *
105.22 + * The registerShutdownInProgress parameter should be false except
105.23 + * registering the DeleteOnExitHook since the first file may
105.24 + * be added to the delete on exit list by the application shutdown
105.25 + * hooks.
105.26 + *
105.27 + * @params slot the slot in the shutdown hook array, whose element
105.28 + * will be invoked in order during shutdown
105.29 + * @params registerShutdownInProgress true to allow the hook
105.30 + * to be registered even if the shutdown is in progress.
105.31 + * @params hook the hook to be registered
105.32 + *
105.33 + * @throw IllegalStateException
105.34 + * if registerShutdownInProgress is false and shutdown is in progress; or
105.35 + * if registerShutdownInProgress is true and the shutdown process
105.36 + * already passes the given slot
105.37 */
105.38 - static void add(int slot, Runnable hook) {
105.39 + static void add(int slot, boolean registerShutdownInProgress, Runnable hook) {
105.40 synchronized (lock) {
105.41 - if (state > RUNNING)
105.42 - throw new IllegalStateException("Shutdown in progress");
105.43 -
105.44 if (hooks[slot] != null)
105.45 throw new InternalError("Shutdown hook at slot " + slot + " already registered");
105.46
105.47 + if (!registerShutdownInProgress) {
105.48 + if (state > RUNNING)
105.49 + throw new IllegalStateException("Shutdown in progress");
105.50 + } else {
105.51 + if (state > HOOKS || (state == HOOKS && slot <= currentRunningHook))
105.52 + throw new IllegalStateException("Shutdown in progress");
105.53 + }
105.54 +
105.55 hooks[slot] = hook;
105.56 }
105.57 }
105.58 @@ -86,11 +111,15 @@
105.59 /* Run all registered shutdown hooks
105.60 */
105.61 private static void runHooks() {
105.62 - /* We needn't bother acquiring the lock just to read the hooks field,
105.63 - * since the hooks can't be modified once shutdown is in progress
105.64 - */
105.65 - for (Runnable hook : hooks) {
105.66 + for (int i=0; i < MAX_SYSTEM_HOOKS; i++) {
105.67 try {
105.68 + Runnable hook;
105.69 + synchronized (lock) {
105.70 + // acquire the lock to make sure the hook registered during
105.71 + // shutdown is visible here.
105.72 + currentRunningHook = i;
105.73 + hook = hooks[i];
105.74 + }
105.75 if (hook != null) hook.run();
105.76 } catch(Throwable t) {
105.77 if (t instanceof ThreadDeath) {
106.1 --- a/src/share/classes/java/lang/System.java Tue May 12 15:21:55 2009 +0900
106.2 +++ b/src/share/classes/java/lang/System.java Thu May 14 00:17:25 2009 -0700
106.3 @@ -1171,8 +1171,8 @@
106.4 public void blockedOn(Thread t, Interruptible b) {
106.5 t.blockedOn(b);
106.6 }
106.7 - public void registerShutdownHook(int slot, Runnable r) {
106.8 - Shutdown.add(slot, r);
106.9 + public void registerShutdownHook(int slot, boolean registerShutdownInProgress, Runnable hook) {
106.10 + Shutdown.add(slot, registerShutdownInProgress, hook);
106.11 }
106.12 });
106.13 }
107.1 --- a/src/share/classes/java/util/zip/ZipFile.java Tue May 12 15:21:55 2009 +0900
107.2 +++ b/src/share/classes/java/util/zip/ZipFile.java Thu May 14 00:17:25 2009 -0700
107.3 @@ -154,7 +154,7 @@
107.4 * @param file the ZIP file to be opened for reading
107.5 * @param mode the mode in which the file is to be opened
107.6 * @param charset
107.7 - * the {@link java.nio.charset.Charset {@code charset}} to
107.8 + * the {@linkplain java.nio.charset.Charset charset} to
107.9 * be used to decode the ZIP entry name and comment that are not
107.10 * encoded by using UTF-8 encoding (indicated by entry's general
107.11 * purpose flag).
107.12 @@ -206,7 +206,7 @@
107.13 *
107.14 * @param name the name of the zip file
107.15 * @param charset
107.16 - * the {@link java.nio.charset.Charset {@code charset}} to
107.17 + * the {@linkplain java.nio.charset.Charset charset} to
107.18 * be used to decode the ZIP entry name and comment that are not
107.19 * encoded by using UTF-8 encoding (indicated by entry's general
107.20 * purpose flag).
107.21 @@ -230,7 +230,7 @@
107.22 * Opens a ZIP file for reading given the specified File object.
107.23 * @param file the ZIP file to be opened for reading
107.24 * @param charset
107.25 - * The {@link java.nio.charset.Charset {@code charset}} to be
107.26 + * The {@linkplain java.nio.charset.Charset charset} to be
107.27 * used to decode the ZIP entry name and comment (ignored if
107.28 * the <a href="package-summary.html#lang_encoding"> language
107.29 * encoding bit</a> of the ZIP entry's general purpose bit
108.1 --- a/src/share/classes/java/util/zip/ZipInputStream.java Tue May 12 15:21:55 2009 +0900
108.2 +++ b/src/share/classes/java/util/zip/ZipInputStream.java Thu May 14 00:17:25 2009 -0700
108.3 @@ -84,7 +84,7 @@
108.4 * @param in the actual input stream
108.5 *
108.6 * @param charset
108.7 - * The {@link java.nio.charset.Charset {@code charset}} to be
108.8 + * The {@linkplain java.nio.charset.Charset charset} to be
108.9 * used to decode the ZIP entry name (ignored if the
108.10 * <a href="package-summary.html#lang_encoding"> language
108.11 * encoding bit</a> of the ZIP entry's general purpose bit
109.1 --- a/src/share/classes/java/util/zip/ZipOutputStream.java Tue May 12 15:21:55 2009 +0900
109.2 +++ b/src/share/classes/java/util/zip/ZipOutputStream.java Thu May 14 00:17:25 2009 -0700
109.3 @@ -108,7 +108,7 @@
109.4 *
109.5 * @param out the actual output stream
109.6 *
109.7 - * @param charset the {@link java.nio.charset.Charset </code>charset<code>}
109.8 + * @param charset the {@linkplain java.nio.charset.Charset charset}
109.9 * to be used to encode the entry names and comments
109.10 *
109.11 * @since 1.7
110.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
110.2 +++ b/src/share/classes/sun/dyn/Access.java Thu May 14 00:17:25 2009 -0700
110.3 @@ -0,0 +1,109 @@
110.4 +/*
110.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
110.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
110.7 + *
110.8 + * This code is free software; you can redistribute it and/or modify it
110.9 + * under the terms of the GNU General Public License version 2 only, as
110.10 + * published by the Free Software Foundation. Sun designates this
110.11 + * particular file as subject to the "Classpath" exception as provided
110.12 + * by Sun in the LICENSE file that accompanied this code.
110.13 + *
110.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
110.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
110.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
110.17 + * version 2 for more details (a copy is included in the LICENSE file that
110.18 + * accompanied this code).
110.19 + *
110.20 + * You should have received a copy of the GNU General Public License version
110.21 + * 2 along with this work; if not, write to the Free Software Foundation,
110.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
110.23 + *
110.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
110.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
110.26 + * have any questions.
110.27 + */
110.28 +
110.29 +package sun.dyn;
110.30 +
110.31 +import sun.reflect.Reflection;
110.32 +
110.33 +/**
110.34 + * Access control to this package.
110.35 + * Classes in other packages can attempt to acquire the access token,
110.36 + * but will fail if they are not recognized as friends.
110.37 + * Certain methods in this package, although public, require a non-null
110.38 + * access token in order to proceed; they act like package-private methods.
110.39 + * @author jrose
110.40 + */
110.41 +
110.42 +public class Access {
110.43 +
110.44 + private Access() { }
110.45 +
110.46 + /**
110.47 + * The heart of this pattern: The list of classes which are
110.48 + * permitted to acquire the access token, and become honorary
110.49 + * members of this package.
110.50 + */
110.51 + private static final String[] FRIENDS = {
110.52 + "java.dyn.", "sun.dyn."
110.53 + };
110.54 +
110.55 + /**
110.56 + * The following object is NOT public. That's the point of the pattern.
110.57 + * It is package-private, so that any member of this package
110.58 + * can acquire the access token, and give it away to trusted friends.
110.59 + */
110.60 + static final Access TOKEN = new Access();
110.61 +
110.62 + /**
110.63 + * @return Access.TOKEN, if the caller is a friend of this package
110.64 + */
110.65 + public static Access getToken() {
110.66 + Class<?> callc = Reflection.getCallerClass(2);
110.67 + if (isFriend(callc))
110.68 + return TOKEN;
110.69 + else
110.70 + throw new IllegalAccessError("bad caller: " + callc);
110.71 + }
110.72 +
110.73 + /** Is the given name the name of a class which could be our friend? */
110.74 + public static boolean isFriendName(String name) {
110.75 + for (String friend : FRIENDS) {
110.76 + if (name.startsWith(friend))
110.77 + return true;
110.78 + }
110.79 + return false;
110.80 + }
110.81 +
110.82 + /** Is the given class a friend? True if {@link #isFriendName},
110.83 + * and the given class also shares a class loader with us.
110.84 + */
110.85 + public static boolean isFriend(Class<?> c) {
110.86 + return isFriendName(c.getName()) && c.getClassLoader() == CLASS_LOADER;
110.87 + }
110.88 +
110.89 + private static final ClassLoader CLASS_LOADER = Access.class.getClassLoader();
110.90 +
110.91 + /**
110.92 + * Throw an IllegalAccessError if the caller does not possess
110.93 + * the Access.TOKEN.
110.94 + * @param must be Access.TOKEN
110.95 + */
110.96 + public static void check(Access token) {
110.97 + if (token == null)
110.98 + fail();
110.99 + // else it must be the unique Access.TOKEN
110.100 + assert(token == Access.TOKEN);
110.101 + }
110.102 + private static void fail() {
110.103 + final int CALLER_DEPTH = 3;
110.104 + // 0: Reflection.getCC, 1: this.fail, 2: Access.*, 3: caller
110.105 + Class<?> callc = Reflection.getCallerClass(CALLER_DEPTH);
110.106 + throw new IllegalAccessError("bad caller: " + callc);
110.107 + }
110.108 +
110.109 + static {
110.110 + //sun.reflect.Reflection.registerMethodsToFilter(MH.class, "getToken");
110.111 + }
110.112 +}
111.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
111.2 +++ b/src/share/classes/sun/dyn/AdapterMethodHandle.java Thu May 14 00:17:25 2009 -0700
111.3 @@ -0,0 +1,728 @@
111.4 +/*
111.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
111.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
111.7 + *
111.8 + * This code is free software; you can redistribute it and/or modify it
111.9 + * under the terms of the GNU General Public License version 2 only, as
111.10 + * published by the Free Software Foundation. Sun designates this
111.11 + * particular file as subject to the "Classpath" exception as provided
111.12 + * by Sun in the LICENSE file that accompanied this code.
111.13 + *
111.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
111.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
111.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
111.17 + * version 2 for more details (a copy is included in the LICENSE file that
111.18 + * accompanied this code).
111.19 + *
111.20 + * You should have received a copy of the GNU General Public License version
111.21 + * 2 along with this work; if not, write to the Free Software Foundation,
111.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
111.23 + *
111.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
111.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
111.26 + * have any questions.
111.27 + */
111.28 +
111.29 +package sun.dyn;
111.30 +
111.31 +import sun.dyn.util.VerifyType;
111.32 +import sun.dyn.util.Wrapper;
111.33 +import java.dyn.*;
111.34 +import java.util.Arrays;
111.35 +import static sun.dyn.MethodHandleNatives.Constants.*;
111.36 +import static sun.dyn.MethodHandleImpl.newIllegalArgumentException;
111.37 +
111.38 +/**
111.39 + * This method handle performs simple conversion or checking of a single argument.
111.40 + * @author jrose
111.41 + */
111.42 +public class AdapterMethodHandle extends BoundMethodHandle {
111.43 +
111.44 + //MethodHandle vmtarget; // next AMH or BMH in chain or final DMH
111.45 + //Object argument; // parameter to the conversion if needed
111.46 + //int vmargslot; // which argument slot is affected
111.47 + private final int conversion; // the type of conversion: RETYPE_ONLY, etc.
111.48 +
111.49 + // Constructors in this class *must* be package scoped or private.
111.50 + private AdapterMethodHandle(MethodHandle target, MethodType newType,
111.51 + long conv, Object convArg) {
111.52 + super(newType, convArg, newType.parameterSlotDepth(1+convArgPos(conv)));
111.53 + this.conversion = convCode(conv);
111.54 + if (MethodHandleNatives.JVM_SUPPORT) {
111.55 + // JVM might update VM-specific bits of conversion (ignore)
111.56 + MethodHandleNatives.init(this, target, convArgPos(conv));
111.57 + }
111.58 + }
111.59 + private AdapterMethodHandle(MethodHandle target, MethodType newType,
111.60 + long conv) {
111.61 + this(target, newType, conv, null);
111.62 + }
111.63 +
111.64 + private static final Access IMPL_TOKEN = Access.getToken();
111.65 +
111.66 + // TO DO: When adapting another MH with a null conversion, clone
111.67 + // the target and change its type, instead of adding another layer.
111.68 +
111.69 + /** Can a JVM-level adapter directly implement the proposed
111.70 + * argument conversions, as if by MethodHandles.convertArguments?
111.71 + */
111.72 + public static boolean canPairwiseConvert(MethodType newType, MethodType oldType) {
111.73 + // same number of args, of course
111.74 + int len = newType.parameterCount();
111.75 + if (len != oldType.parameterCount())
111.76 + return false;
111.77 +
111.78 + // Check return type. (Not much can be done with it.)
111.79 + Class<?> exp = newType.returnType();
111.80 + Class<?> ret = oldType.returnType();
111.81 + if (!VerifyType.isNullConversion(ret, exp))
111.82 + return false;
111.83 +
111.84 + // Check args pairwise.
111.85 + for (int i = 0; i < len; i++) {
111.86 + Class<?> src = newType.parameterType(i); // source type
111.87 + Class<?> dst = oldType.parameterType(i); // destination type
111.88 + if (!canConvertArgument(src, dst))
111.89 + return false;
111.90 + }
111.91 +
111.92 + return true;
111.93 + }
111.94 +
111.95 + /** Can a JVM-level adapter directly implement the proposed
111.96 + * argument conversion, as if by MethodHandles.convertArguments?
111.97 + */
111.98 + public static boolean canConvertArgument(Class<?> src, Class<?> dst) {
111.99 + // ? Retool this logic to use RETYPE_ONLY, CHECK_CAST, etc., as opcodes,
111.100 + // so we don't need to repeat so much decision making.
111.101 + if (VerifyType.isNullConversion(src, dst)) {
111.102 + return true;
111.103 + } else if (src.isPrimitive()) {
111.104 + if (dst.isPrimitive())
111.105 + return canPrimCast(src, dst);
111.106 + else
111.107 + return canBoxArgument(src, dst);
111.108 + } else {
111.109 + if (dst.isPrimitive())
111.110 + return canUnboxArgument(src, dst);
111.111 + else
111.112 + return true; // any two refs can be interconverted
111.113 + }
111.114 + }
111.115 +
111.116 + /**
111.117 + * Create a JVM-level adapter method handle to conform the given method
111.118 + * handle to the similar newType, using only pairwise argument conversions.
111.119 + * For each argument, convert incoming argument to the exact type needed.
111.120 + * Only null conversions are allowed on the return value (until
111.121 + * the JVM supports ricochet adapters).
111.122 + * The argument conversions allowed are casting, unboxing,
111.123 + * integral widening or narrowing, and floating point widening or narrowing.
111.124 + * @param token access check
111.125 + * @param newType required call type
111.126 + * @param target original method handle
111.127 + * @return an adapter to the original handle with the desired new type,
111.128 + * or the original target if the types are already identical
111.129 + * or null if the adaptation cannot be made
111.130 + */
111.131 + public static MethodHandle makePairwiseConvert(Access token,
111.132 + MethodType newType, MethodHandle target) {
111.133 + Access.check(token);
111.134 + MethodType oldType = target.type();
111.135 + if (newType == oldType) return target;
111.136 +
111.137 + if (!canPairwiseConvert(newType, oldType))
111.138 + return null;
111.139 + // (after this point, it is an assertion error to fail to convert)
111.140 +
111.141 + // Find last non-trivial conversion (if any).
111.142 + int lastConv = newType.parameterCount()-1;
111.143 + while (lastConv >= 0) {
111.144 + Class<?> src = newType.parameterType(lastConv); // source type
111.145 + Class<?> dst = oldType.parameterType(lastConv); // destination type
111.146 + if (VerifyType.isNullConversion(src, dst)) {
111.147 + --lastConv;
111.148 + } else {
111.149 + break;
111.150 + }
111.151 + }
111.152 + // Now build a chain of one or more adapters.
111.153 + MethodHandle adapter = target;
111.154 + MethodType midType = oldType.changeReturnType(newType.returnType());
111.155 + for (int i = 0; i <= lastConv; i++) {
111.156 + Class<?> src = newType.parameterType(i); // source type
111.157 + Class<?> dst = midType.parameterType(i); // destination type
111.158 + if (VerifyType.isNullConversion(src, dst)) {
111.159 + // do nothing: difference is trivial
111.160 + continue;
111.161 + }
111.162 + // Work the current type backward toward the desired caller type:
111.163 + if (i != lastConv) {
111.164 + midType = midType.changeParameterType(i, src);
111.165 + } else {
111.166 + // When doing the last (or only) real conversion,
111.167 + // force all remaining null conversions to happen also.
111.168 + assert(VerifyType.isNullConversion(newType, midType.changeParameterType(i, src)));
111.169 + midType = newType;
111.170 + }
111.171 +
111.172 + // Tricky case analysis follows.
111.173 + // It parallels canConvertArgument() above.
111.174 + if (src.isPrimitive()) {
111.175 + if (dst.isPrimitive()) {
111.176 + adapter = makePrimCast(token, midType, adapter, i, dst);
111.177 + } else {
111.178 + adapter = makeBoxArgument(token, midType, adapter, i, dst);
111.179 + }
111.180 + } else {
111.181 + if (dst.isPrimitive()) {
111.182 + // Caller has boxed a primitive. Unbox it for the target.
111.183 + // The box type must correspond exactly to the primitive type.
111.184 + // This is simpler than the powerful set of widening
111.185 + // conversions supported by reflect.Method.invoke.
111.186 + // Those conversions require a big nest of if/then/else logic,
111.187 + // which we prefer to make a user responsibility.
111.188 + adapter = makeUnboxArgument(token, midType, adapter, i, dst);
111.189 + } else {
111.190 + // Simple reference conversion.
111.191 + // Note: Do not check for a class hierarchy relation
111.192 + // between src and dst. In all cases a 'null' argument
111.193 + // will pass the cast conversion.
111.194 + adapter = makeCheckCast(token, midType, adapter, i, dst);
111.195 + }
111.196 + }
111.197 + assert(adapter != null);
111.198 + assert(adapter.type() == midType);
111.199 + }
111.200 + if (adapter.type() != newType) {
111.201 + // Only trivial conversions remain.
111.202 + adapter = makeRetypeOnly(IMPL_TOKEN, newType, adapter);
111.203 + assert(adapter != null);
111.204 + // Actually, that's because there were no non-trivial ones:
111.205 + assert(lastConv == -1);
111.206 + }
111.207 + assert(adapter.type() == newType);
111.208 + return adapter;
111.209 + }
111.210 +
111.211 + /**
111.212 + * Create a JVM-level adapter method handle to permute the arguments
111.213 + * of the given method.
111.214 + * @param token access check
111.215 + * @param newType required call type
111.216 + * @param target original method handle
111.217 + * @param argumentMap for each target argument, position of its source in newType
111.218 + * @return an adapter to the original handle with the desired new type,
111.219 + * or the original target if the types are already identical
111.220 + * and the permutation is null
111.221 + * @throws IllegalArgumentException if the adaptation cannot be made
111.222 + * directly by a JVM-level adapter, without help from Java code
111.223 + */
111.224 + public static MethodHandle makePermutation(Access token,
111.225 + MethodType newType, MethodHandle target,
111.226 + int[] argumentMap) {
111.227 + MethodType oldType = target.type();
111.228 + boolean nullPermutation = true;
111.229 + for (int i = 0; i < argumentMap.length; i++) {
111.230 + int pos = argumentMap[i];
111.231 + if (pos != i)
111.232 + nullPermutation = false;
111.233 + if (pos < 0 || pos >= newType.parameterCount()) {
111.234 + argumentMap = new int[0]; break;
111.235 + }
111.236 + }
111.237 + if (argumentMap.length != oldType.parameterCount())
111.238 + throw newIllegalArgumentException("bad permutation: "+Arrays.toString(argumentMap));
111.239 + if (nullPermutation) {
111.240 + MethodHandle res = makePairwiseConvert(token, newType, target);
111.241 + // well, that was easy
111.242 + if (res == null)
111.243 + throw newIllegalArgumentException("cannot convert pairwise: "+newType);
111.244 + return res;
111.245 + }
111.246 +
111.247 + // Check return type. (Not much can be done with it.)
111.248 + Class<?> exp = newType.returnType();
111.249 + Class<?> ret = oldType.returnType();
111.250 + if (!VerifyType.isNullConversion(ret, exp))
111.251 + throw newIllegalArgumentException("bad return conversion for "+newType);
111.252 +
111.253 + // See if the argument types match up.
111.254 + for (int i = 0; i < argumentMap.length; i++) {
111.255 + int j = argumentMap[i];
111.256 + Class<?> src = newType.parameterType(j);
111.257 + Class<?> dst = oldType.parameterType(i);
111.258 + if (!VerifyType.isNullConversion(src, dst))
111.259 + throw newIllegalArgumentException("bad argument #"+j+" conversion for "+newType);
111.260 + }
111.261 +
111.262 + // Now figure out a nice mix of SWAP, ROT, DUP, and DROP adapters.
111.263 + // A workable greedy algorithm is as follows:
111.264 + // Drop unused outgoing arguments (right to left: shallowest first).
111.265 + // Duplicate doubly-used outgoing arguments (left to right: deepest first).
111.266 + // Then the remaining problem is a true argument permutation.
111.267 + // Marshal the outgoing arguments as required from left to right.
111.268 + // That is, find the deepest outgoing stack position that does not yet
111.269 + // have the correct argument value, and correct at least that position
111.270 + // by swapping or rotating in the misplaced value (from a shallower place).
111.271 + // If the misplaced value is followed by one or more consecutive values
111.272 + // (also misplaced) issue a rotation which brings as many as possible
111.273 + // into position. Otherwise make progress with either a swap or a
111.274 + // rotation. Prefer the swap as cheaper, but do not use it if it
111.275 + // breaks a slot pair. Prefer the rotation over the swap if it would
111.276 + // preserve more consecutive values shallower than the target position.
111.277 + // When more than one rotation will work (because the required value
111.278 + // is already adjacent to the target position), then use a rotation
111.279 + // which moves the old value in the target position adjacent to
111.280 + // one of its consecutive values. Also, prefer shorter rotation
111.281 + // spans, since they use fewer memory cycles for shuffling.
111.282 +
111.283 + throw new UnsupportedOperationException("NYI");
111.284 + }
111.285 +
111.286 + private static byte basicType(Class<?> type) {
111.287 + if (type == null) return T_VOID;
111.288 + switch (Wrapper.forBasicType(type)) {
111.289 + case BOOLEAN: return T_BOOLEAN;
111.290 + case CHAR: return T_CHAR;
111.291 + case FLOAT: return T_FLOAT;
111.292 + case DOUBLE: return T_DOUBLE;
111.293 + case BYTE: return T_BYTE;
111.294 + case SHORT: return T_SHORT;
111.295 + case INT: return T_INT;
111.296 + case LONG: return T_LONG;
111.297 + case OBJECT: return T_OBJECT;
111.298 + case VOID: return T_VOID;
111.299 + }
111.300 + return 99; // T_ILLEGAL or some such
111.301 + }
111.302 +
111.303 + /** Number of stack slots for the given type.
111.304 + * Two for T_DOUBLE and T_FLOAT, one for the rest.
111.305 + */
111.306 + private static int type2size(int type) {
111.307 + assert(type >= T_BOOLEAN && type <= T_OBJECT);
111.308 + return (type == T_FLOAT || type == T_DOUBLE) ? 2 : 1;
111.309 + }
111.310 +
111.311 + /** Construct an adapter conversion descriptor for a single-argument conversion. */
111.312 + private static long makeConv(int convOp, int argnum, int src, int dest) {
111.313 + assert(src == (src & 0xF));
111.314 + assert(dest == (dest & 0xF));
111.315 + assert(convOp >= OP_CHECK_CAST && convOp <= OP_PRIM_TO_REF);
111.316 + long stackMove = type2size(dest) - type2size(src);
111.317 + return ((long) argnum << 32 |
111.318 + (long) convOp << CONV_OP_SHIFT |
111.319 + (int) src << CONV_SRC_TYPE_SHIFT |
111.320 + (int) dest << CONV_DEST_TYPE_SHIFT |
111.321 + stackMove << CONV_STACK_MOVE_SHIFT
111.322 + );
111.323 + }
111.324 + private static long makeConv(int convOp, int argnum, int stackMove) {
111.325 + assert(convOp >= OP_SWAP_ARGS && convOp <= OP_SPREAD_ARGS);
111.326 + byte src = 0, dest = 0;
111.327 + if (convOp >= OP_COLLECT_ARGS && convOp <= OP_SPREAD_ARGS)
111.328 + src = dest = T_OBJECT;
111.329 + return ((long) argnum << 32 |
111.330 + (long) convOp << CONV_OP_SHIFT |
111.331 + (int) src << CONV_SRC_TYPE_SHIFT |
111.332 + (int) dest << CONV_DEST_TYPE_SHIFT |
111.333 + stackMove << CONV_STACK_MOVE_SHIFT
111.334 + );
111.335 + }
111.336 + private static long makeConv(int convOp) {
111.337 + assert(convOp == OP_RETYPE_ONLY);
111.338 + return (long) convOp << CONV_OP_SHIFT; // stackMove, src, dst, argnum all zero
111.339 + }
111.340 + private static int convCode(long conv) {
111.341 + return (int)conv;
111.342 + }
111.343 + private static int convArgPos(long conv) {
111.344 + return (int)(conv >>> 32);
111.345 + }
111.346 + private static boolean convOpSupported(int convOp) {
111.347 + assert(convOp >= 0 && convOp <= CONV_OP_LIMIT);
111.348 + return ((1<<convOp) & CONV_OP_IMPLEMENTED_MASK) != 0;
111.349 + }
111.350 +
111.351 + /** One of OP_RETYPE_ONLY, etc. */
111.352 + int conversionOp() { return (conversion & CONV_OP_MASK) >> CONV_OP_SHIFT; }
111.353 +
111.354 + @Override
111.355 + public String toString() {
111.356 + return addTypeString(this, "Adapted[" + basicToString(nonAdapter((MethodHandle)vmtarget)) + "]");
111.357 + }
111.358 +
111.359 + private static MethodHandle nonAdapter(MethodHandle mh) {
111.360 + return (MethodHandle)
111.361 + MethodHandleNatives.getTarget(mh, ETF_DIRECT_HANDLE);
111.362 + }
111.363 +
111.364 + /* Return one plus the position of the first non-trivial difference
111.365 + * between the given types. This is not a symmetric operation;
111.366 + * we are considering adapting the targetType to adapterType.
111.367 + * Trivial differences are those which could be ignored by the JVM
111.368 + * without subverting the verifier. Otherwise, adaptable differences
111.369 + * are ones for which we could create an adapter to make the type change.
111.370 + * Return zero if there are no differences (other than trivial ones).
111.371 + * Return 1+N if N is the only adaptable argument difference.
111.372 + * Return the -2-N where N is the first of several adaptable
111.373 + * argument differences.
111.374 + * Return -1 if there there are differences which are not adaptable.
111.375 + */
111.376 + private static int diffTypes(MethodType adapterType,
111.377 + MethodType targetType,
111.378 + boolean raw) {
111.379 + int diff;
111.380 + diff = diffReturnTypes(adapterType, targetType, raw);
111.381 + if (diff != 0) return diff;
111.382 + int nargs = adapterType.parameterCount();
111.383 + if (nargs != targetType.parameterCount())
111.384 + return -1;
111.385 + diff = diffParamTypes(adapterType, 0, targetType, 0, nargs, raw);
111.386 + //System.out.println("diff "+adapterType);
111.387 + //System.out.println(" "+diff+" "+targetType);
111.388 + return diff;
111.389 + }
111.390 + private static int diffReturnTypes(MethodType adapterType,
111.391 + MethodType targetType,
111.392 + boolean raw) {
111.393 + Class<?> src = targetType.returnType();
111.394 + Class<?> dst = adapterType.returnType();
111.395 + if ((!raw
111.396 + ? VerifyType.canPassUnchecked(src, dst)
111.397 + : VerifyType.canPassRaw(src, dst)
111.398 + ) > 0)
111.399 + return 0; // no significant difference
111.400 + if (raw && !src.isPrimitive() && !dst.isPrimitive())
111.401 + return 0; // can force a reference return (very carefully!)
111.402 + //if (false) return 1; // never adaptable!
111.403 + return -1; // some significant difference
111.404 + }
111.405 + private static int diffParamTypes(MethodType adapterType, int tstart,
111.406 + MethodType targetType, int astart,
111.407 + int nargs, boolean raw) {
111.408 + assert(nargs >= 0);
111.409 + int res = 0;
111.410 + for (int i = 0; i < nargs; i++) {
111.411 + Class<?> src = adapterType.parameterType(tstart+i);
111.412 + Class<?> dest = targetType.parameterType(astart+i);
111.413 + if ((!raw
111.414 + ? VerifyType.canPassUnchecked(src, dest)
111.415 + : VerifyType.canPassRaw(src, dest)
111.416 + ) <= 0) {
111.417 + // found a difference; is it the only one so far?
111.418 + if (res != 0)
111.419 + return -1-res; // return -2-i for prev. i
111.420 + res = 1+i;
111.421 + }
111.422 + }
111.423 + return res;
111.424 + }
111.425 +
111.426 + /** Can a retyping adapter (alone) validly convert the target to newType? */
111.427 + public static boolean canRetypeOnly(MethodType newType, MethodType targetType) {
111.428 + return canRetypeOnly(newType, targetType, false);
111.429 + }
111.430 + /** Can a retyping adapter (alone) convert the target to newType?
111.431 + * It is allowed to widen subword types and void to int, to make bitwise
111.432 + * conversions between float/int and double/long, and to perform unchecked
111.433 + * reference conversions on return. This last feature requires that the
111.434 + * caller be trusted, and perform explicit cast conversions on return values.
111.435 + */
111.436 + static boolean canRawRetypeOnly(MethodType newType, MethodType targetType) {
111.437 + return canRetypeOnly(newType, targetType, true);
111.438 + }
111.439 + static boolean canRetypeOnly(MethodType newType, MethodType targetType, boolean raw) {
111.440 + if (!convOpSupported(OP_RETYPE_ONLY)) return false;
111.441 + int diff = diffTypes(newType, targetType, raw);
111.442 + // %%% This assert is too strong. Factor diff into VerifyType and reconcile.
111.443 + assert((diff == 0) == VerifyType.isNullConversion(newType, targetType));
111.444 + return diff == 0;
111.445 + }
111.446 +
111.447 + /** Factory method: Performs no conversions; simply retypes the adapter.
111.448 + * Allows unchecked argument conversions pairwise, if they are safe.
111.449 + * Returns null if not possible.
111.450 + */
111.451 + public static MethodHandle makeRetypeOnly(Access token,
111.452 + MethodType newType, MethodHandle target) {
111.453 + return makeRetypeOnly(token, newType, target, false);
111.454 + }
111.455 + public static MethodHandle makeRawRetypeOnly(Access token,
111.456 + MethodType newType, MethodHandle target) {
111.457 + return makeRetypeOnly(token, newType, target, true);
111.458 + }
111.459 + static MethodHandle makeRetypeOnly(Access token,
111.460 + MethodType newType, MethodHandle target, boolean raw) {
111.461 + Access.check(token);
111.462 + if (!canRetypeOnly(newType, target.type(), raw))
111.463 + return null;
111.464 + // TO DO: clone the target guy, whatever he is, with new type.
111.465 + return new AdapterMethodHandle(target, newType, makeConv(OP_RETYPE_ONLY));
111.466 + }
111.467 +
111.468 + /** Can a checkcast adapter validly convert the target to newType?
111.469 + * The JVM supports all kind of reference casts, even silly ones.
111.470 + */
111.471 + public static boolean canCheckCast(MethodType newType, MethodType targetType,
111.472 + int arg, Class<?> castType) {
111.473 + if (!convOpSupported(OP_CHECK_CAST)) return false;
111.474 + Class<?> src = newType.parameterType(arg);
111.475 + Class<?> dst = targetType.parameterType(arg);
111.476 + if (!canCheckCast(src, castType)
111.477 + || !VerifyType.isNullConversion(castType, dst))
111.478 + return false;
111.479 + int diff = diffTypes(newType, targetType, false);
111.480 + return (diff == arg+1); // arg is sole non-trivial diff
111.481 + }
111.482 + /** Can an primitive conversion adapter validly convert src to dst? */
111.483 + public static boolean canCheckCast(Class<?> src, Class<?> dst) {
111.484 + return (!src.isPrimitive() && !dst.isPrimitive());
111.485 + }
111.486 +
111.487 + /** Factory method: Forces a cast at the given argument.
111.488 + * The castType is the target of the cast, and can be any type
111.489 + * with a null conversion to the corresponding target parameter.
111.490 + * Return null if this cannot be done.
111.491 + */
111.492 + public static MethodHandle makeCheckCast(Access token,
111.493 + MethodType newType, MethodHandle target,
111.494 + int arg, Class<?> castType) {
111.495 + Access.check(token);
111.496 + if (!canCheckCast(newType, target.type(), arg, castType))
111.497 + return null;
111.498 + long conv = makeConv(OP_CHECK_CAST, arg, 0);
111.499 + return new AdapterMethodHandle(target, newType, conv, castType);
111.500 + }
111.501 +
111.502 + /** Can an primitive conversion adapter validly convert the target to newType?
111.503 + * The JVM currently supports all conversions except those between
111.504 + * floating and integral types.
111.505 + */
111.506 + public static boolean canPrimCast(MethodType newType, MethodType targetType,
111.507 + int arg, Class<?> convType) {
111.508 + if (!convOpSupported(OP_PRIM_TO_PRIM)) return false;
111.509 + Class<?> src = newType.parameterType(arg);
111.510 + Class<?> dst = targetType.parameterType(arg);
111.511 + if (!canPrimCast(src, convType)
111.512 + || !VerifyType.isNullConversion(convType, dst))
111.513 + return false;
111.514 + int diff = diffTypes(newType, targetType, false);
111.515 + return (diff == arg+1); // arg is sole non-trivial diff
111.516 + }
111.517 + /** Can an primitive conversion adapter validly convert src to dst? */
111.518 + public static boolean canPrimCast(Class<?> src, Class<?> dst) {
111.519 + if (src == dst || !src.isPrimitive() || !dst.isPrimitive()) {
111.520 + return false;
111.521 + } else if (Wrapper.forPrimitiveType(dst).isFloating()) {
111.522 + // both must be floating types
111.523 + return Wrapper.forPrimitiveType(src).isFloating();
111.524 + } else {
111.525 + // both are integral, and all combinations work fine
111.526 + assert(Wrapper.forPrimitiveType(src).isIntegral() &&
111.527 + Wrapper.forPrimitiveType(dst).isIntegral());
111.528 + return true;
111.529 + }
111.530 + }
111.531 +
111.532 + /** Factory method: Truncate the given argument with zero or sign extension,
111.533 + * and/or convert between single and doubleword versions of integer or float.
111.534 + * The convType is the target of the conversion, and can be any type
111.535 + * with a null conversion to the corresponding target parameter.
111.536 + * Return null if this cannot be done.
111.537 + */
111.538 + public static MethodHandle makePrimCast(Access token,
111.539 + MethodType newType, MethodHandle target,
111.540 + int arg, Class<?> convType) {
111.541 + Access.check(token);
111.542 + MethodType oldType = target.type();
111.543 + Class<?> src = newType.parameterType(arg);
111.544 + Class<?> dst = oldType.parameterType(arg);
111.545 + if (!canPrimCast(newType, oldType, arg, convType))
111.546 + return null;
111.547 + long conv = makeConv(OP_PRIM_TO_PRIM, arg, basicType(src), basicType(convType));
111.548 + return new AdapterMethodHandle(target, newType, conv);
111.549 + }
111.550 +
111.551 + /** Can an unboxing conversion validly convert src to dst?
111.552 + * The JVM currently supports all kinds of casting and unboxing.
111.553 + * The convType is the unboxed type; it can be either a primitive or wrapper.
111.554 + */
111.555 + public static boolean canUnboxArgument(MethodType newType, MethodType targetType,
111.556 + int arg, Class<?> convType) {
111.557 + if (!convOpSupported(OP_REF_TO_PRIM)) return false;
111.558 + Class<?> src = newType.parameterType(arg);
111.559 + Class<?> dst = targetType.parameterType(arg);
111.560 + Class<?> boxType = Wrapper.asWrapperType(convType);
111.561 + convType = Wrapper.asPrimitiveType(convType);
111.562 + if (!canCheckCast(src, boxType)
111.563 + || boxType == convType
111.564 + || !VerifyType.isNullConversion(convType, dst))
111.565 + return false;
111.566 + int diff = diffTypes(newType, targetType, false);
111.567 + return (diff == arg+1); // arg is sole non-trivial diff
111.568 + }
111.569 + /** Can an primitive unboxing adapter validly convert src to dst? */
111.570 + public static boolean canUnboxArgument(Class<?> src, Class<?> dst) {
111.571 + return (!src.isPrimitive() && Wrapper.asPrimitiveType(dst).isPrimitive());
111.572 + }
111.573 +
111.574 + /** Factory method: Unbox the given argument.
111.575 + * Return null if this cannot be done.
111.576 + */
111.577 + public static MethodHandle makeUnboxArgument(Access token,
111.578 + MethodType newType, MethodHandle target,
111.579 + int arg, Class<?> convType) {
111.580 + MethodType oldType = target.type();
111.581 + Class<?> src = newType.parameterType(arg);
111.582 + Class<?> dst = oldType.parameterType(arg);
111.583 + Class<?> boxType = Wrapper.asWrapperType(convType);
111.584 + Class<?> primType = Wrapper.asPrimitiveType(convType);
111.585 + if (!canUnboxArgument(newType, oldType, arg, convType))
111.586 + return null;
111.587 + MethodType castDone = newType;
111.588 + if (!VerifyType.isNullConversion(src, boxType))
111.589 + castDone = newType.changeParameterType(arg, boxType);
111.590 + long conv = makeConv(OP_REF_TO_PRIM, arg, T_OBJECT, basicType(primType));
111.591 + MethodHandle adapter = new AdapterMethodHandle(target, castDone, conv, boxType);
111.592 + if (castDone == newType)
111.593 + return adapter;
111.594 + return makeCheckCast(token, newType, adapter, arg, boxType);
111.595 + }
111.596 +
111.597 + /** Can an primitive boxing adapter validly convert src to dst? */
111.598 + public static boolean canBoxArgument(Class<?> src, Class<?> dst) {
111.599 + if (!convOpSupported(OP_PRIM_TO_REF)) return false;
111.600 + throw new UnsupportedOperationException("NYI");
111.601 + }
111.602 +
111.603 + /** Factory method: Unbox the given argument.
111.604 + * Return null if this cannot be done.
111.605 + */
111.606 + public static MethodHandle makeBoxArgument(Access token,
111.607 + MethodType newType, MethodHandle target,
111.608 + int arg, Class<?> convType) {
111.609 + // this is difficult to do in the JVM because it must GC
111.610 + return null;
111.611 + }
111.612 +
111.613 + // TO DO: makeSwapArguments, makeRotateArguments, makeDuplicateArguments
111.614 +
111.615 + /** Can an adapter simply drop arguments to convert the target to newType? */
111.616 + public static boolean canDropArguments(MethodType newType, MethodType targetType,
111.617 + int dropArgPos, int dropArgCount) {
111.618 + if (dropArgCount == 0)
111.619 + return canRetypeOnly(newType, targetType);
111.620 + if (!convOpSupported(OP_DROP_ARGS)) return false;
111.621 + if (diffReturnTypes(newType, targetType, false) != 0)
111.622 + return false;
111.623 + int nptypes = newType.parameterCount();
111.624 + // parameter types must be the same up to the drop point
111.625 + if (dropArgPos != 0 && diffParamTypes(newType, 0, targetType, 0, dropArgPos, false) != 0)
111.626 + return false;
111.627 + int afterPos = dropArgPos + dropArgCount;
111.628 + int afterCount = nptypes - afterPos;
111.629 + if (dropArgPos < 0 || dropArgPos >= nptypes ||
111.630 + dropArgCount < 1 || afterPos > nptypes ||
111.631 + targetType.parameterCount() != nptypes - dropArgCount)
111.632 + return false;
111.633 + // parameter types after the drop point must also be the same
111.634 + if (afterCount != 0 && diffParamTypes(newType, afterPos, targetType, dropArgPos, afterCount, false) != 0)
111.635 + return false;
111.636 + return true;
111.637 + }
111.638 +
111.639 + /** Factory method: Drop selected arguments.
111.640 + * Allow unchecked retyping of remaining arguments, pairwise.
111.641 + * Return null if this is not possible.
111.642 + */
111.643 + public static MethodHandle makeDropArguments(Access token,
111.644 + MethodType newType, MethodHandle target,
111.645 + int dropArgPos, int dropArgCount) {
111.646 + Access.check(token);
111.647 + if (dropArgCount == 0)
111.648 + return makeRetypeOnly(IMPL_TOKEN, newType, target);
111.649 + MethodType mt = target.type();
111.650 + int argCount = mt.parameterCount();
111.651 + if (!canDropArguments(newType, mt, dropArgPos, dropArgCount))
111.652 + return null;
111.653 + int dropSlotCount, dropSlotPos;
111.654 + if (dropArgCount >= argCount) {
111.655 + assert(dropArgPos == argCount-1);
111.656 + dropSlotPos = 0;
111.657 + dropSlotCount = mt.parameterSlotCount();
111.658 + } else {
111.659 + // arglist: [0: keep... | dpos: drop... | dpos+dcount: keep... ]
111.660 + int lastDroppedArg = dropArgPos + dropArgCount - 1;
111.661 + int lastKeptArg = dropArgPos - 1; // might be -1, which is OK
111.662 + dropSlotPos = mt.parameterSlotDepth(1+lastDroppedArg);
111.663 + int lastKeptSlot = mt.parameterSlotDepth(1+lastKeptArg);
111.664 + dropSlotCount = lastKeptSlot - dropSlotPos;
111.665 + assert(dropSlotCount >= dropArgCount);
111.666 + }
111.667 + long conv = makeConv(OP_DROP_ARGS, dropArgPos, +dropSlotCount);
111.668 + return new AdapterMethodHandle(target, newType, dropSlotCount, conv);
111.669 + }
111.670 +
111.671 + /** Can an adapter spread an argument to convert the target to newType? */
111.672 + public static boolean canSpreadArguments(MethodType newType, MethodType targetType,
111.673 + Class<?> spreadArgType, int spreadArgPos, int spreadArgCount) {
111.674 + if (!convOpSupported(OP_SPREAD_ARGS)) return false;
111.675 + if (diffReturnTypes(newType, targetType, false) != 0)
111.676 + return false;
111.677 + int nptypes = newType.parameterCount();
111.678 + // parameter types must be the same up to the spread point
111.679 + if (spreadArgPos != 0 && diffParamTypes(newType, 0, targetType, 0, spreadArgPos, false) != 0)
111.680 + return false;
111.681 + int afterPos = spreadArgPos + spreadArgCount;
111.682 + int afterCount = nptypes - afterPos;
111.683 + if (spreadArgPos < 0 || spreadArgPos >= nptypes ||
111.684 + spreadArgCount < 0 ||
111.685 + targetType.parameterCount() != nptypes - 1 + spreadArgCount)
111.686 + return false;
111.687 + // parameter types after the spread point must also be the same
111.688 + if (afterCount != 0 && diffParamTypes(newType, spreadArgPos+1, targetType, afterPos, afterCount, false) != 0)
111.689 + return false;
111.690 + // match the array element type to the spread arg types
111.691 + Class<?> rawSpreadArgType = newType.parameterType(spreadArgPos);
111.692 + if (rawSpreadArgType != spreadArgType && !canCheckCast(rawSpreadArgType, spreadArgType))
111.693 + return false;
111.694 + for (int i = 0; i < spreadArgCount; i++) {
111.695 + Class<?> src = VerifyType.spreadArgElementType(spreadArgType, i);
111.696 + Class<?> dst = targetType.parameterType(spreadArgPos + i);
111.697 + if (src == null || !VerifyType.isNullConversion(src, dst))
111.698 + return false;
111.699 + }
111.700 + return true;
111.701 + }
111.702 +
111.703 + /** Factory method: Spread selected argument. */
111.704 + public static MethodHandle makeSpreadArguments(Access token,
111.705 + MethodType newType, MethodHandle target,
111.706 + Class<?> spreadArgType, int spreadArgPos, int spreadArgCount) {
111.707 + Access.check(token);
111.708 + MethodType mt = target.type();
111.709 + int argCount = mt.parameterCount();
111.710 + if (!canSpreadArguments(newType, mt, spreadArgType, spreadArgPos, spreadArgCount))
111.711 + return null;
111.712 + int spreadSlotCount, spreadSlotPos;
111.713 + if (spreadArgCount >= argCount) {
111.714 + assert(spreadArgPos == argCount-1);
111.715 + spreadSlotPos = 0;
111.716 + spreadSlotCount = mt.parameterSlotCount();
111.717 + } else {
111.718 + // arglist: [0: keep... | dpos: spread... | dpos+dcount: keep... ]
111.719 + int lastSpreadArg = spreadArgPos + spreadArgCount - 1;
111.720 + int lastKeptArg = spreadArgPos - 1; // might be -1, which is OK
111.721 + spreadSlotPos = mt.parameterSlotDepth(1+lastSpreadArg);
111.722 + int lastKeptSlot = mt.parameterSlotDepth(1+lastKeptArg);
111.723 + spreadSlotCount = lastKeptSlot - spreadSlotPos;
111.724 + assert(spreadSlotCount >= spreadArgCount);
111.725 + }
111.726 + long conv = makeConv(OP_SPREAD_ARGS, spreadArgPos, spreadSlotCount);
111.727 + return new AdapterMethodHandle(target, newType, conv, spreadArgType);
111.728 + }
111.729 +
111.730 + // TO DO: makeCollectArguments, makeFlyby, makeRicochet
111.731 +}
112.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
112.2 +++ b/src/share/classes/sun/dyn/BoundMethodHandle.java Thu May 14 00:17:25 2009 -0700
112.3 @@ -0,0 +1,180 @@
112.4 +/*
112.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
112.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
112.7 + *
112.8 + * This code is free software; you can redistribute it and/or modify it
112.9 + * under the terms of the GNU General Public License version 2 only, as
112.10 + * published by the Free Software Foundation. Sun designates this
112.11 + * particular file as subject to the "Classpath" exception as provided
112.12 + * by Sun in the LICENSE file that accompanied this code.
112.13 + *
112.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
112.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
112.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
112.17 + * version 2 for more details (a copy is included in the LICENSE file that
112.18 + * accompanied this code).
112.19 + *
112.20 + * You should have received a copy of the GNU General Public License version
112.21 + * 2 along with this work; if not, write to the Free Software Foundation,
112.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
112.23 + *
112.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
112.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
112.26 + * have any questions.
112.27 + */
112.28 +
112.29 +package sun.dyn;
112.30 +
112.31 +import sun.dyn.util.VerifyType;
112.32 +import sun.dyn.util.Wrapper;
112.33 +import java.dyn.*;
112.34 +
112.35 +/**
112.36 + * The flavor of method handle which emulates an invoke instruction
112.37 + * on a predetermined argument. The JVM dispatches to the correct method
112.38 + * when the handle is created, not when it is invoked.
112.39 + * @author jrose
112.40 + */
112.41 +public class BoundMethodHandle extends MethodHandle {
112.42 + //MethodHandle vmtarget; // next BMH or final DMH or methodOop
112.43 + private final Object argument; // argument to insert
112.44 + private final int vmargslot; // position at which it is inserted
112.45 +
112.46 + // Constructors in this class *must* be package scoped or private.
112.47 +
112.48 + /** Bind a direct MH to its receiver (or first ref. argument).
112.49 + * The JVM will pre-dispatch the MH if it is not already static.
112.50 + */
112.51 + BoundMethodHandle(DirectMethodHandle mh, Object argument) {
112.52 + super(Access.TOKEN, mh.type().dropParameterType(0));
112.53 + // check the type now, once for all:
112.54 + this.argument = checkReferenceArgument(argument, mh, 0);
112.55 + this.vmargslot = this.type().parameterSlotCount();
112.56 + if (MethodHandleNatives.JVM_SUPPORT) {
112.57 + this.vmtarget = null; // maybe updated by JVM
112.58 + MethodHandleNatives.init(this, mh, 0);
112.59 + } else {
112.60 + this.vmtarget = mh;
112.61 + }
112.62 + }
112.63 +
112.64 + private static final int REF_ARG = 0, PRIM_ARG = 1, SELF_ARG = 2;
112.65 +
112.66 + /** Insert an argument into an arbitrary method handle.
112.67 + * If argnum is zero, inserts the first argument, etc.
112.68 + * The argument type must be a reference.
112.69 + */
112.70 + BoundMethodHandle(MethodHandle mh, Object argument, int argnum) {
112.71 + this(mh, argument, argnum, mh.type().parameterType(argnum).isPrimitive() ? PRIM_ARG : REF_ARG);
112.72 + }
112.73 +
112.74 + /** Insert an argument into an arbitrary method handle.
112.75 + * If argnum is zero, inserts the first argument, etc.
112.76 + */
112.77 + BoundMethodHandle(MethodHandle mh, Object argument, int argnum, int whichArg) {
112.78 + super(Access.TOKEN, mh.type().dropParameterType(argnum));
112.79 + if (whichArg == PRIM_ARG)
112.80 + this.argument = bindPrimitiveArgument(argument, mh, argnum);
112.81 + else {
112.82 + if (whichArg == SELF_ARG) argument = this;
112.83 + this.argument = checkReferenceArgument(argument, mh, argnum);
112.84 + }
112.85 + this.vmargslot = this.type().parameterSlotDepth(argnum);
112.86 + if (MethodHandleNatives.JVM_SUPPORT) {
112.87 + this.vmtarget = null; // maybe updated by JVM
112.88 + MethodHandleNatives.init(this, mh, argnum);
112.89 + } else {
112.90 + this.vmtarget = mh;
112.91 + }
112.92 + }
112.93 +
112.94 + /** For the AdapterMethodHandle subclass.
112.95 + */
112.96 + BoundMethodHandle(MethodType type, Object argument, int vmargslot) {
112.97 + super(Access.TOKEN, type);
112.98 + this.argument = argument;
112.99 + this.vmargslot = vmargslot;
112.100 + assert(this.getClass() == AdapterMethodHandle.class);
112.101 + }
112.102 +
112.103 + /** Initialize the current object as a method handle, binding it
112.104 + * as the {@code argnum}th argument of the method handle {@code entryPoint}.
112.105 + * The invocation type of the resulting method handle will be the
112.106 + * same as {@code entryPoint}, except that the {@code argnum}th argument
112.107 + * type will be dropped.
112.108 + */
112.109 + public BoundMethodHandle(MethodHandle entryPoint, int argnum) {
112.110 + this(entryPoint, null, argnum, SELF_ARG);
112.111 +
112.112 + // Note: If the conversion fails, perhaps because of a bad entryPoint,
112.113 + // the MethodHandle.type field will not be filled in, and therefore
112.114 + // no MH.invoke call will ever succeed. The caller may retain a pointer
112.115 + // to the broken method handle, but no harm can be done with it.
112.116 + }
112.117 +
112.118 + /** Initialize the current object as a method handle, binding it
112.119 + * as the first argument of the method handle {@code entryPoint}.
112.120 + * The invocation type of the resulting method handle will be the
112.121 + * same as {@code entryPoint}, except that the first argument
112.122 + * type will be dropped.
112.123 + */
112.124 + public BoundMethodHandle(MethodHandle entryPoint) {
112.125 + this(entryPoint, null, 0, SELF_ARG);
112.126 + }
112.127 +
112.128 + /** Make sure the given {@code argument} can be used as {@code argnum}-th
112.129 + * parameter of the given method handle {@code mh}, which must be a reference.
112.130 + * <p>
112.131 + * If this fails, throw a suitable {@code WrongMethodTypeException},
112.132 + * which will prevent the creation of an illegally typed bound
112.133 + * method handle.
112.134 + */
112.135 + final static Object checkReferenceArgument(Object argument, MethodHandle mh, int argnum) {
112.136 + Class<?> ptype = mh.type().parameterType(argnum);
112.137 + if (ptype.isPrimitive()) {
112.138 + // fail
112.139 + } else if (argument == null) {
112.140 + return null;
112.141 + } else if (VerifyType.isNullReferenceConversion(argument.getClass(), ptype)) {
112.142 + return argument;
112.143 + }
112.144 + throw badBoundArgumentException(argument, mh, argnum);
112.145 + }
112.146 +
112.147 + /** Make sure the given {@code argument} can be used as {@code argnum}-th
112.148 + * parameter of the given method handle {@code mh}, which must be a primitive.
112.149 + * <p>
112.150 + * If this fails, throw a suitable {@code WrongMethodTypeException},
112.151 + * which will prevent the creation of an illegally typed bound
112.152 + * method handle.
112.153 + */
112.154 + final static Object bindPrimitiveArgument(Object argument, MethodHandle mh, int argnum) {
112.155 + Class<?> ptype = mh.type().parameterType(argnum);
112.156 + Wrapper wrap = Wrapper.forPrimitiveType(ptype);
112.157 + Object zero = wrap.zero();
112.158 + if (zero == null) {
112.159 + // fail
112.160 + } else if (argument == null) {
112.161 + if (ptype != int.class && wrap.isSubwordOrInt())
112.162 + return Integer.valueOf(0);
112.163 + else
112.164 + return zero;
112.165 + } else if (VerifyType.isNullReferenceConversion(argument.getClass(), zero.getClass())) {
112.166 + if (ptype != int.class && wrap.isSubwordOrInt())
112.167 + return Wrapper.INT.wrap(argument);
112.168 + else
112.169 + return argument;
112.170 + }
112.171 + throw badBoundArgumentException(argument, mh, argnum);
112.172 + }
112.173 +
112.174 + final static RuntimeException badBoundArgumentException(Object argument, MethodHandle mh, int argnum) {
112.175 + String atype = (argument == null) ? "null" : argument.getClass().toString();
112.176 + return new WrongMethodTypeException("cannot bind "+atype+" argument to parameter #"+argnum+" of "+mh.type());
112.177 + }
112.178 +
112.179 + @Override
112.180 + public String toString() {
112.181 + return "Bound[" + super.toString() + "]";
112.182 + }
112.183 +}
113.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
113.2 +++ b/src/share/classes/sun/dyn/CallSiteImpl.java Thu May 14 00:17:25 2009 -0700
113.3 @@ -0,0 +1,70 @@
113.4 +/*
113.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
113.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
113.7 + *
113.8 + * This code is free software; you can redistribute it and/or modify it
113.9 + * under the terms of the GNU General Public License version 2 only, as
113.10 + * published by the Free Software Foundation. Sun designates this
113.11 + * particular file as subject to the "Classpath" exception as provided
113.12 + * by Sun in the LICENSE file that accompanied this code.
113.13 + *
113.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
113.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
113.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
113.17 + * version 2 for more details (a copy is included in the LICENSE file that
113.18 + * accompanied this code).
113.19 + *
113.20 + * You should have received a copy of the GNU General Public License version
113.21 + * 2 along with this work; if not, write to the Free Software Foundation,
113.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
113.23 + *
113.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
113.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
113.26 + * have any questions.
113.27 + */
113.28 +
113.29 +package sun.dyn;
113.30 +
113.31 +import java.dyn.*;
113.32 +
113.33 +/**
113.34 + * The CallSite privately created by the JVM at every invokedynamic instruction.
113.35 + * @author jrose
113.36 + */
113.37 +class CallSiteImpl extends CallSite {
113.38 + // Fields used only by the JVM. Do not use or change.
113.39 + private Object vmmethod;
113.40 +
113.41 + // Values supplied by the JVM:
113.42 + int callerMID, callerBCI;
113.43 +
113.44 + private CallSiteImpl(Class<?> caller, String name, MethodType type) {
113.45 + super(caller, name, type);
113.46 + }
113.47 +
113.48 + @Override
113.49 + public void setTarget(MethodHandle mh) {
113.50 + checkTarget(mh);
113.51 + if (MethodHandleNatives.JVM_SUPPORT)
113.52 + MethodHandleNatives.linkCallSite(this, (MethodHandle) mh);
113.53 + else
113.54 + super.setTarget(mh);
113.55 + }
113.56 +
113.57 + private static final MethodHandle PRIVATE_INITIALIZE_CALL_SITE =
113.58 + MethodHandleImpl.IMPL_LOOKUP.findStatic(CallSite.class, "privateInitializeCallSite",
113.59 + MethodType.make(void.class, CallSite.class, int.class, int.class));
113.60 +
113.61 + // this is the up-call from the JVM:
113.62 + static CallSite makeSite(Class<?> caller, String name, MethodType type,
113.63 + int callerMID, int callerBCI) {
113.64 + MethodHandle bsm = Linkage.getBootstrapMethod(caller);
113.65 + if (bsm == null)
113.66 + throw new InvokeDynamicBootstrapError("class has no bootstrap method: "+caller);
113.67 + CallSite site = bsm.<CallSite>invoke(caller, name, type);
113.68 + if (site == null)
113.69 + throw new InvokeDynamicBootstrapError("class bootstrap method failed to create a call site: "+caller);
113.70 + PRIVATE_INITIALIZE_CALL_SITE.<void>invoke(site, callerMID, callerBCI);
113.71 + return site;
113.72 + }
113.73 +}
114.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
114.2 +++ b/src/share/classes/sun/dyn/DirectMethodHandle.java Thu May 14 00:17:25 2009 -0700
114.3 @@ -0,0 +1,54 @@
114.4 +/*
114.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
114.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
114.7 + *
114.8 + * This code is free software; you can redistribute it and/or modify it
114.9 + * under the terms of the GNU General Public License version 2 only, as
114.10 + * published by the Free Software Foundation. Sun designates this
114.11 + * particular file as subject to the "Classpath" exception as provided
114.12 + * by Sun in the LICENSE file that accompanied this code.
114.13 + *
114.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
114.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
114.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
114.17 + * version 2 for more details (a copy is included in the LICENSE file that
114.18 + * accompanied this code).
114.19 + *
114.20 + * You should have received a copy of the GNU General Public License version
114.21 + * 2 along with this work; if not, write to the Free Software Foundation,
114.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
114.23 + *
114.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
114.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
114.26 + * have any questions.
114.27 + */
114.28 +
114.29 +package sun.dyn;
114.30 +
114.31 +import java.dyn.*;
114.32 +import static sun.dyn.MethodHandleNatives.Constants.*;
114.33 +
114.34 +/**
114.35 + * The flavor of method handle which emulates invokespecial or invokestatic.
114.36 + * @author jrose
114.37 + */
114.38 +class DirectMethodHandle extends MethodHandle {
114.39 + //inherited oop vmtarget; // methodOop or virtual class/interface oop
114.40 + private final int vmindex; // method index within class or interface
114.41 + { vmindex = VM_INDEX_UNINITIALIZED; } // JVM may change this
114.42 +
114.43 + // Constructors in this class *must* be package scoped or private.
114.44 + DirectMethodHandle(MethodType mtype, MemberName m, boolean doDispatch, Class<?> lookupClass) {
114.45 + super(Access.TOKEN, mtype);
114.46 +
114.47 + assert(m.isMethod() || !doDispatch && m.isConstructor());
114.48 + if (!m.isResolved())
114.49 + throw new InternalError();
114.50 +
114.51 + MethodHandleNatives.init(this, (Object) m, doDispatch, lookupClass);
114.52 + }
114.53 +
114.54 + boolean isValid() {
114.55 + return (vmindex != VM_INDEX_UNINITIALIZED);
114.56 + }
114.57 +}
115.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
115.2 +++ b/src/share/classes/sun/dyn/FilterGeneric.java Thu May 14 00:17:25 2009 -0700
115.3 @@ -0,0 +1,338 @@
115.4 +/*
115.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
115.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
115.7 + *
115.8 + * This code is free software; you can redistribute it and/or modify it
115.9 + * under the terms of the GNU General Public License version 2 only, as
115.10 + * published by the Free Software Foundation. Sun designates this
115.11 + * particular file as subject to the "Classpath" exception as provided
115.12 + * by Sun in the LICENSE file that accompanied this code.
115.13 + *
115.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
115.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
115.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
115.17 + * version 2 for more details (a copy is included in the LICENSE file that
115.18 + * accompanied this code).
115.19 + *
115.20 + * You should have received a copy of the GNU General Public License version
115.21 + * 2 along with this work; if not, write to the Free Software Foundation,
115.22 + * Inc., 51 Franklin Sf, tifth Floor, Boston, MA 02110-1301 USA.
115.23 + *
115.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
115.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
115.26 + * have any questions.
115.27 + */
115.28 +
115.29 +package sun.dyn;
115.30 +
115.31 +import java.dyn.JavaMethodHandle;
115.32 +import java.dyn.MethodHandle;
115.33 +import java.dyn.MethodType;
115.34 +import java.dyn.NoAccessException;
115.35 +import java.lang.reflect.Constructor;
115.36 +import java.lang.reflect.InvocationTargetException;
115.37 +
115.38 +/**
115.39 + * "Flyby adapters" which apply arbitrary conversions to arguments
115.40 + * on the way to a ultimate target.
115.41 + * For simplicity, these are all generically typed.
115.42 + * @author jrose
115.43 + */
115.44 +class FilterGeneric {
115.45 + // type for the outgoing call (will be generic)
115.46 + private final MethodType targetType;
115.47 + // position of (first) argument to participate in filtering
115.48 + private final short argumentPosition;
115.49 + // number of arguments to participate in filtering
115.50 + private final short argumentCount;
115.51 + // how the result interacts with the filtered arguments: Prepend, Append, Replace, Discard
115.52 + private final char replaceMode;
115.53 + // prototype adapter (clone and customize for each new target & conversion!)
115.54 + private final Adapter adapter;
115.55 + // entry point for adapter (Adapter mh, a...) => ...
115.56 + private final MethodHandle entryPoint;
115.57 + // more of them (loosely cached)
115.58 + private FilterGeneric variations;
115.59 +
115.60 + /** Compute and cache information common to all unboxing adapters
115.61 + * that can call out to targets of the erasure-family of the given erased type.
115.62 + */
115.63 + // TO DO: Make this private.
115.64 + FilterGeneric(MethodType targetType, short argumentPosition, short argumentCount, char replaceMode) {
115.65 + if (argumentCount == 0) {
115.66 + if (replaceMode == 'P' || replaceMode == 'A') replaceMode = 'R';
115.67 + if (replaceMode == 'I') argumentPosition = 0;
115.68 + }
115.69 + this.targetType = targetType;
115.70 + this.argumentPosition = argumentPosition;
115.71 + this.argumentCount = argumentCount;
115.72 + this.replaceMode = replaceMode;
115.73 + validate(targetType, argumentPosition, argumentCount, replaceMode);
115.74 + Adapter ad = findAdapter(targetType, argumentPosition, argumentCount, replaceMode, filterType());
115.75 + if (ad == null)
115.76 + ad = buildAdapterFromBytecodes(targetType, argumentPosition, argumentCount, replaceMode, filterType());
115.77 + this.adapter = ad;
115.78 + this.entryPoint = ad.prototypeEntryPoint();
115.79 + }
115.80 +
115.81 + Adapter makeInstance(MethodHandle filter, MethodHandle target) {
115.82 + return adapter.makeInstance(entryPoint, filter, target);
115.83 + }
115.84 +
115.85 + /** Build an adapter of the given generic type, which invokes typedTarget
115.86 + * on the incoming arguments, after unboxing as necessary.
115.87 + * The return value is boxed if necessary.
115.88 + * @param genericType the required type of the result
115.89 + * @param typedTarget the target
115.90 + * @return an adapter method handle
115.91 + */
115.92 + public static MethodHandle make(MethodHandle target, int pos, MethodHandle filter) {
115.93 + return FilterGeneric.of(target.type(), (short)pos, (short)1, 'R').makeInstance(filter, target);
115.94 + }
115.95 +
115.96 + /** Return the adapter information for this type's erasure. */
115.97 + static FilterGeneric of(MethodType type, short ap, short ac, char mode) {
115.98 + if (type.generic() != type)
115.99 + throw new IllegalArgumentException("must be generic: "+type);
115.100 + validate(type, ap, ac, mode);
115.101 + MethodTypeImpl form = MethodTypeImpl.of(type);
115.102 + FilterGeneric filterGen = form.filterGeneric;
115.103 + if (filterGen == null)
115.104 + form.filterGeneric = filterGen = new FilterGeneric(type, (short)0, (short)1, 'R');
115.105 + return find(filterGen, ap, ac, mode);
115.106 + }
115.107 +
115.108 + static FilterGeneric find(FilterGeneric gen, short ap, short ac, char mode) {
115.109 + for (;;) {
115.110 + if (gen.argumentPosition == ap &&
115.111 + gen.argumentCount == ac &&
115.112 + gen.replaceMode == mode) {
115.113 + return gen;
115.114 + }
115.115 + FilterGeneric gen2 = gen.variations;
115.116 + if (gen2 == null) break;
115.117 + gen = gen2;
115.118 + }
115.119 + FilterGeneric gen2 = new FilterGeneric(gen.targetType, ap, ac, mode);
115.120 + gen.variations = gen2; // OK if this smashes another cached chain
115.121 + return gen2;
115.122 + }
115.123 +
115.124 + private static void validate(MethodType type, short ap, short ac, char mode) {
115.125 + int endpos = ap + ac;
115.126 + switch (mode) {
115.127 + case 'P': case 'A': case 'R': case 'D':
115.128 + if (ap >= 0 && ac >= 0 &&
115.129 + endpos >= 0 && endpos <= type.parameterCount())
115.130 + return;
115.131 + default:
115.132 + throw new InternalError("configuration "+patternName(ap, ac, mode));
115.133 + }
115.134 + }
115.135 +
115.136 + public String toString() {
115.137 + return "FilterGeneric/"+patternName()+targetType;
115.138 + }
115.139 +
115.140 + String patternName() {
115.141 + return patternName(argumentPosition, argumentCount, replaceMode);
115.142 + }
115.143 +
115.144 + static String patternName(short ap, short ac, char mode) {
115.145 + return ""+mode+ap+(ac>1?"_"+ac:"");
115.146 + }
115.147 +
115.148 + Class<?> filterType() {
115.149 + return Object.class; // result of filter operation; an uninteresting type
115.150 + }
115.151 +
115.152 + static MethodType targetType(MethodType entryType, short ap, short ac, char mode,
115.153 + Class<?> arg) {
115.154 + MethodType type = entryType;
115.155 + int pos = ap;
115.156 + switch (mode) {
115.157 + case 'A':
115.158 + pos += ac;
115.159 + case 'P':
115.160 + type = type.insertParameterType(pos, arg);
115.161 + break;
115.162 + case 'I':
115.163 + for (int i = 1; i < ac; i++)
115.164 + type = type.dropParameterType(pos);
115.165 + assert(type.parameterType(pos) == arg);
115.166 + break;
115.167 + case 'D':
115.168 + break;
115.169 + }
115.170 + return type;
115.171 + }
115.172 +
115.173 + static MethodType entryType(MethodType targetType, short ap, short ac, char mode,
115.174 + Class<?> arg) {
115.175 + MethodType type = targetType;
115.176 + int pos = ap;
115.177 + switch (mode) {
115.178 + case 'A':
115.179 + pos += ac;
115.180 + case 'P':
115.181 + type = type.dropParameterType(pos);
115.182 + break;
115.183 + case 'I':
115.184 + for (int i = 1; i < ac; i++)
115.185 + type = type.insertParameterType(pos, arg);
115.186 + assert(type.parameterType(pos) == arg);
115.187 + break;
115.188 + case 'D':
115.189 + break;
115.190 + }
115.191 + return type;
115.192 + }
115.193 +
115.194 + /* Create an adapter that handles spreading calls for the given type. */
115.195 + static Adapter findAdapter(MethodType targetType, short ap, short ac, char mode, Class<?> arg) {
115.196 + MethodType entryType = entryType(targetType, ap, ac, mode, arg);
115.197 + int argc = targetType.parameterCount();
115.198 + String pname = patternName(ap, ac, mode);
115.199 + String cname0 = "F"+argc;
115.200 + String cname1 = "F"+argc+mode;
115.201 + String cname2 = "F"+argc+pname;
115.202 + String[] cnames = { cname0, cname1, cname1+"X", cname2 };
115.203 + String iname = "invoke_"+pname;
115.204 + // e.g., F5R; invoke_R3
115.205 + for (String cname : cnames) {
115.206 + Class<? extends Adapter> acls = Adapter.findSubClass(cname);
115.207 + if (acls == null) continue;
115.208 + // see if it has the required invoke method
115.209 + MethodHandle entryPoint = null;
115.210 + try {
115.211 + entryPoint = MethodHandleImpl.IMPL_LOOKUP.findSpecial(acls, iname, entryType, acls);
115.212 + } catch (NoAccessException ex) {
115.213 + }
115.214 + if (entryPoint == null) continue;
115.215 + Constructor<? extends Adapter> ctor = null;
115.216 + try {
115.217 + ctor = acls.getDeclaredConstructor(MethodHandle.class);
115.218 + } catch (NoSuchMethodException ex) {
115.219 + } catch (SecurityException ex) {
115.220 + }
115.221 + if (ctor == null) continue;
115.222 + try {
115.223 + // Produce an instance configured as a prototype.
115.224 + return ctor.newInstance(entryPoint);
115.225 + } catch (IllegalArgumentException ex) {
115.226 + } catch (InvocationTargetException ex) {
115.227 + } catch (InstantiationException ex) {
115.228 + } catch (IllegalAccessException ex) {
115.229 + }
115.230 + }
115.231 + return null;
115.232 + }
115.233 +
115.234 + static Adapter buildAdapterFromBytecodes(MethodType targetType, short ap, short ac, char mode, Class<?> arg) {
115.235 + throw new UnsupportedOperationException("NYI");
115.236 + }
115.237 +
115.238 + /**
115.239 + * This adapter takes some untyped arguments, and returns an untyped result.
115.240 + * Internally, it applies the invoker to the target, which causes the
115.241 + * objects to be unboxed; the result is a raw type in L/I/J/F/D.
115.242 + * This result is passed to convert, which is responsible for
115.243 + * converting the raw result into a boxed object.
115.244 + * The invoker is kept separate from the target because it can be
115.245 + * generated once per type erasure family, and reused across adapters.
115.246 + */
115.247 + static abstract class Adapter extends JavaMethodHandle {
115.248 + protected final MethodHandle filter;
115.249 + protected final MethodHandle target;
115.250 +
115.251 + protected boolean isPrototype() { return target == null; }
115.252 + protected Adapter(MethodHandle entryPoint) {
115.253 + this(entryPoint, entryPoint, null);
115.254 + assert(isPrototype());
115.255 + }
115.256 + protected MethodHandle prototypeEntryPoint() {
115.257 + if (!isPrototype()) throw new InternalError();
115.258 + return filter;
115.259 + }
115.260 +
115.261 + protected Adapter(MethodHandle entryPoint,
115.262 + MethodHandle filter, MethodHandle target) {
115.263 + super(entryPoint);
115.264 + this.filter = filter;
115.265 + this.target = target;
115.266 + }
115.267 +
115.268 + /** Make a copy of self, with new fields. */
115.269 + protected abstract Adapter makeInstance(MethodHandle entryPoint,
115.270 + MethodHandle filter, MethodHandle target);
115.271 + // { return new ThisType(entryPoint, filter, target); }
115.272 +
115.273 + static private final String CLASS_PREFIX; // "sun.dyn.FilterGeneric$"
115.274 + static {
115.275 + String aname = Adapter.class.getName();
115.276 + String sname = Adapter.class.getSimpleName();
115.277 + if (!aname.endsWith(sname)) throw new InternalError();
115.278 + CLASS_PREFIX = aname.substring(0, aname.length() - sname.length());
115.279 + }
115.280 + /** Find a sibing class of Adapter. */
115.281 + static Class<? extends Adapter> findSubClass(String name) {
115.282 + String cname = Adapter.CLASS_PREFIX + name;
115.283 + try {
115.284 + return Class.forName(cname).asSubclass(Adapter.class);
115.285 + } catch (ClassNotFoundException ex) {
115.286 + return null;
115.287 + } catch (ClassCastException ex) {
115.288 + return null;
115.289 + }
115.290 + }
115.291 + }
115.292 +
115.293 + //* generated classes follow this pattern:
115.294 + static class F1RX extends Adapter {
115.295 + protected F1RX(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
115.296 + protected F1RX(MethodHandle e, MethodHandle f, MethodHandle t)
115.297 + { super(e, f, t); }
115.298 + protected F1RX makeInstance(MethodHandle e, MethodHandle f, MethodHandle t)
115.299 + { return new F1RX(e, f, t); }
115.300 + protected Object filter(Object a0) { return filter.<Object>invoke(a0); }
115.301 + protected Object target(Object a0) { return target.<Object>invoke(a0); }
115.302 + protected Object invoke_R0(Object a0) { return target(filter(a0)); }
115.303 + }
115.304 + static class F2RX extends Adapter {
115.305 + protected F2RX(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
115.306 + protected F2RX(MethodHandle e, MethodHandle f, MethodHandle t)
115.307 + { super(e, f, t); }
115.308 + protected F2RX makeInstance(MethodHandle e, MethodHandle f, MethodHandle t)
115.309 + { return new F2RX(e, f, t); }
115.310 + protected Object filter(Object a0) { return filter.<Object>invoke(a0); }
115.311 + protected Object target(Object a0, Object a1) { return target.<Object>invoke(a0, a1); }
115.312 + protected Object invoke_R0(Object a0, Object a1) { return target(filter(a0), a1); }
115.313 + protected Object invoke_R1(Object a0, Object a1) { return target(a0, filter(a1)); }
115.314 + }
115.315 + static class F3RX extends Adapter {
115.316 + protected F3RX(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
115.317 + protected F3RX(MethodHandle e, MethodHandle f, MethodHandle t)
115.318 + { super(e, f, t); }
115.319 + protected F3RX makeInstance(MethodHandle e, MethodHandle f, MethodHandle t)
115.320 + { return new F3RX(e, f, t); }
115.321 + protected Object filter(Object a0) { return filter.<Object>invoke(a0); }
115.322 + protected Object target(Object a0, Object a1, Object a2) { return target.<Object>invoke(a0, a1, a2); }
115.323 + protected Object invoke_R0(Object a0, Object a1, Object a2) { return target(filter(a0), a1, a2); }
115.324 + protected Object invoke_R1(Object a0, Object a1, Object a2) { return target(a0, filter(a1), a2); }
115.325 + protected Object invoke_R2(Object a0, Object a1, Object a2) { return target(a0, a1, filter(a2)); }
115.326 + }
115.327 + static class F4RX extends Adapter {
115.328 + protected F4RX(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
115.329 + protected F4RX(MethodHandle e, MethodHandle f, MethodHandle t)
115.330 + { super(e, f, t); }
115.331 + protected F4RX makeInstance(MethodHandle e, MethodHandle f, MethodHandle t)
115.332 + { return new F4RX(e, f, t); }
115.333 + protected Object filter(Object a0) { return filter.<Object>invoke(a0); }
115.334 + protected Object target(Object a0, Object a1, Object a2, Object a3) { return target.<Object>invoke(a0, a1, a2, a3); }
115.335 + protected Object invoke_R0(Object a0, Object a1, Object a2, Object a3) { return target(filter(a0), a1, a2, a3); }
115.336 + protected Object invoke_R1(Object a0, Object a1, Object a2, Object a3) { return target(a0, filter(a1), a2, a3); }
115.337 + protected Object invoke_R2(Object a0, Object a1, Object a2, Object a3) { return target(a0, a1, filter(a2), a3); }
115.338 + protected Object invoke_R3(Object a0, Object a1, Object a2, Object a3) { return target(a0, a1, a2, filter(a3)); }
115.339 + }
115.340 + // */
115.341 +}
116.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
116.2 +++ b/src/share/classes/sun/dyn/FilterOneArgument.java Thu May 14 00:17:25 2009 -0700
116.3 @@ -0,0 +1,73 @@
116.4 +/*
116.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
116.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
116.7 + *
116.8 + * This code is free software; you can redistribute it and/or modify it
116.9 + * under the terms of the GNU General Public License version 2 only, as
116.10 + * published by the Free Software Foundation. Sun designates this
116.11 + * particular file as subject to the "Classpath" exception as provided
116.12 + * by Sun in the LICENSE file that accompanied this code.
116.13 + *
116.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
116.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
116.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
116.17 + * version 2 for more details (a copy is included in the LICENSE file that
116.18 + * accompanied this code).
116.19 + *
116.20 + * You should have received a copy of the GNU General Public License version
116.21 + * 2 along with this work; if not, write to the Free Software Foundation,
116.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
116.23 + *
116.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
116.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
116.26 + * have any questions.
116.27 + */
116.28 +
116.29 +package sun.dyn;
116.30 +
116.31 +import java.dyn.JavaMethodHandle;
116.32 +import java.dyn.MethodHandle;
116.33 +import java.dyn.MethodHandles;
116.34 +import java.dyn.MethodType;
116.35 +
116.36 +/**
116.37 + * Unary function composition, useful for many small plumbing jobs.
116.38 + * The invoke method takes a single reference argument, and returns a reference
116.39 + * Internally, it first calls the {@code filter} method on the argument,
116.40 + * Making up the difference between the raw method type and the
116.41 + * final method type is the responsibility of a JVM-level adapter.
116.42 + * @author jrose
116.43 + */
116.44 +public class FilterOneArgument extends JavaMethodHandle {
116.45 + protected final MethodHandle filter; // Object -> Object
116.46 + protected final MethodHandle target; // Object -> Object
116.47 +
116.48 + protected Object entryPoint(Object argument) {
116.49 + Object filteredArgument = filter.<Object>invoke(argument);
116.50 + return target.<Object>invoke(filteredArgument);
116.51 + }
116.52 +
116.53 + private static final MethodHandle entryPoint =
116.54 + MethodHandleImpl.IMPL_LOOKUP.findVirtual(FilterOneArgument.class, "entryPoint", MethodType.makeGeneric(1));
116.55 +
116.56 + protected FilterOneArgument(MethodHandle filter, MethodHandle target) {
116.57 + super(entryPoint);
116.58 + this.filter = filter;
116.59 + this.target = target;
116.60 + }
116.61 +
116.62 + public static MethodHandle make(MethodHandle filter, MethodHandle target) {
116.63 + if (filter == null) return target;
116.64 + if (target == null) return filter;
116.65 + return new FilterOneArgument(filter, target);
116.66 + }
116.67 +
116.68 + public String toString() {
116.69 + return filter + "|>" + target;
116.70 + }
116.71 +
116.72 +// MethodHandle make(MethodHandle filter1, MethodHandle filter2, MethodHandle target) {
116.73 +// MethodHandle filter = make(filter1, filter2);
116.74 +// return make(filter, target);
116.75 +// }
116.76 +}
117.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
117.2 +++ b/src/share/classes/sun/dyn/FromGeneric.java Thu May 14 00:17:25 2009 -0700
117.3 @@ -0,0 +1,627 @@
117.4 +/*
117.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
117.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
117.7 + *
117.8 + * This code is free software; you can redistribute it and/or modify it
117.9 + * under the terms of the GNU General Public License version 2 only, as
117.10 + * published by the Free Software Foundation. Sun designates this
117.11 + * particular file as subject to the "Classpath" exception as provided
117.12 + * by Sun in the LICENSE file that accompanied this code.
117.13 + *
117.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
117.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
117.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
117.17 + * version 2 for more details (a copy is included in the LICENSE file that
117.18 + * accompanied this code).
117.19 + *
117.20 + * You should have received a copy of the GNU General Public License version
117.21 + * 2 along with this work; if not, write to the Free Software Foundation,
117.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
117.23 + *
117.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
117.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
117.26 + * have any questions.
117.27 + */
117.28 +
117.29 +package sun.dyn;
117.30 +
117.31 +import java.dyn.JavaMethodHandle;
117.32 +import java.dyn.MethodHandle;
117.33 +import java.dyn.MethodHandles;
117.34 +import java.dyn.MethodType;
117.35 +import java.dyn.NoAccessException;
117.36 +import java.lang.reflect.Constructor;
117.37 +import java.lang.reflect.InvocationTargetException;
117.38 +import sun.dyn.util.ValueConversions;
117.39 +import sun.dyn.util.Wrapper;
117.40 +
117.41 +/**
117.42 + * Adapters which mediate between incoming calls which are not generic
117.43 + * and outgoing calls which are. Any call can be represented generically
117.44 + * boxing up its arguments, and (on return) unboxing the return value.
117.45 + * <p>
117.46 + * A call is "generic" (in MethodHandle terms) if its MethodType features
117.47 + * only Object arguments. A non-generic call therefore features
117.48 + * primitives and/or reference types other than Object.
117.49 + * An adapter has types for its incoming and outgoing calls.
117.50 + * The incoming call type is simply determined by the adapter's type
117.51 + * (the MethodType it presents to callers). The outgoing call type
117.52 + * is determined by the adapter's target (a MethodHandle that the adapter
117.53 + * either binds internally or else takes as a leading argument).
117.54 + * (To stretch the term, adapter-like method handles may have multiple
117.55 + * targets or be polymorphic across multiple call types.)
117.56 + * <p>
117.57 + * This adapter can sometimes be more directly implemented
117.58 + * by the JVM's built-in OP_SPREAD_ARGS adapter.
117.59 + * @author jrose
117.60 + */
117.61 +class FromGeneric {
117.62 + // type for the outgoing call (may have primitives, etc.)
117.63 + private final MethodType targetType;
117.64 + // type of the outgoing call internal to the adapter
117.65 + private final MethodType internalType;
117.66 + // prototype adapter (clone and customize for each new target!)
117.67 + private final Adapter adapter;
117.68 + // entry point for adapter (Adapter mh, a...) => ...
117.69 + private final MethodHandle entryPoint;
117.70 + // unboxing invoker of type (MH, Object**N) => raw return value
117.71 + // it makes up the difference of internalType => targetType
117.72 + private final MethodHandle unboxingInvoker;
117.73 + // conversion which boxes a the target's raw return value
117.74 + private final MethodHandle returnConversion;
117.75 +
117.76 + /** Compute and cache information common to all unboxing adapters
117.77 + * that can call out to targets of the erasure-family of the given erased type.
117.78 + */
117.79 + private FromGeneric(MethodType targetType) {
117.80 + this.targetType = targetType;
117.81 + MethodType internalType0;
117.82 + // the target invoker will generally need casts on reference arguments
117.83 + Adapter ad = findAdapter(internalType0 = targetType.erase());
117.84 + if (ad != null) {
117.85 + // Immediate hit to exactly the adapter we want,
117.86 + // with no monkeying around with primitive types.
117.87 + this.internalType = internalType0;
117.88 + this.adapter = ad;
117.89 + this.entryPoint = ad.prototypeEntryPoint();
117.90 + this.returnConversion = computeReturnConversion(targetType, internalType0);
117.91 + this.unboxingInvoker = computeUnboxingInvoker(targetType, internalType0);
117.92 + return;
117.93 + }
117.94 +
117.95 + // outgoing primitive arguments will be wrapped; unwrap them
117.96 + MethodType primsAsObj = MethodTypeImpl.of(targetType).primArgsAsBoxes();
117.97 + MethodType objArgsRawRet = MethodTypeImpl.of(primsAsObj).primsAsInts();
117.98 + if (objArgsRawRet != targetType)
117.99 + ad = findAdapter(internalType0 = objArgsRawRet);
117.100 + if (ad == null) {
117.101 + ad = buildAdapterFromBytecodes(internalType0 = targetType);
117.102 + }
117.103 + this.internalType = internalType0;
117.104 + this.adapter = ad;
117.105 + MethodType tepType = targetType.insertParameterType(0, adapter.getClass());
117.106 + this.entryPoint = ad.prototypeEntryPoint();
117.107 + this.returnConversion = computeReturnConversion(targetType, internalType0);
117.108 + this.unboxingInvoker = computeUnboxingInvoker(targetType, internalType0);
117.109 + }
117.110 +
117.111 + /**
117.112 + * The typed target will be called according to targetType.
117.113 + * The adapter code will in fact see the raw result from internalType,
117.114 + * and must box it into an object. Produce a converter for this.
117.115 + */
117.116 + private static MethodHandle computeReturnConversion(
117.117 + MethodType targetType, MethodType internalType) {
117.118 + Class<?> tret = targetType.returnType();
117.119 + Class<?> iret = internalType.returnType();
117.120 + Wrapper wrap = Wrapper.forBasicType(tret);
117.121 + if (!iret.isPrimitive()) {
117.122 + assert(iret == Object.class);
117.123 + return ValueConversions.identity();
117.124 + } else if (wrap.primitiveType() == iret) {
117.125 + return ValueConversions.box(wrap, false);
117.126 + } else {
117.127 + assert(tret == double.class ? iret == long.class : iret == int.class);
117.128 + return ValueConversions.boxRaw(wrap, false);
117.129 + }
117.130 + }
117.131 +
117.132 + /**
117.133 + * The typed target will need an exact invocation point; provide it here.
117.134 + * The adapter will possibly need to make a slightly different call,
117.135 + * so adapt the invoker. This way, the logic for making up the
117.136 + * difference between what the adapter can call and what the target
117.137 + * needs can be cached once per type.
117.138 + */
117.139 + private static MethodHandle computeUnboxingInvoker(
117.140 + MethodType targetType, MethodType internalType) {
117.141 + // All the adapters we have here have reference-untyped internal calls.
117.142 + assert(internalType == internalType.erase());
117.143 + MethodHandle invoker = MethodHandles.exactInvoker(targetType);
117.144 + // cast all narrow reference types, unbox all primitive arguments:
117.145 + MethodType fixArgsType = internalType.changeReturnType(targetType.returnType());
117.146 + MethodHandle fixArgs = AdapterMethodHandle.convertArguments(Access.TOKEN,
117.147 + invoker, Invokers.invokerType(fixArgsType),
117.148 + invoker.type(), null);
117.149 + if (fixArgs == null)
117.150 + throw new InternalError("bad fixArgs");
117.151 + // reinterpret the calling sequence as raw:
117.152 + MethodHandle retyper = AdapterMethodHandle.makeRawRetypeOnly(Access.TOKEN,
117.153 + Invokers.invokerType(internalType), fixArgs);
117.154 + if (retyper == null)
117.155 + throw new InternalError("bad retyper");
117.156 + return retyper;
117.157 + }
117.158 +
117.159 + Adapter makeInstance(MethodHandle typedTarget) {
117.160 + MethodType type = typedTarget.type();
117.161 + if (type == targetType) {
117.162 + return adapter.makeInstance(entryPoint, unboxingInvoker, returnConversion, typedTarget);
117.163 + }
117.164 + // my erased-type is not exactly the same as the desired type
117.165 + assert(type.erase() == targetType); // else we are busted
117.166 + MethodHandle invoker = computeUnboxingInvoker(type, internalType);
117.167 + return adapter.makeInstance(entryPoint, invoker, returnConversion, typedTarget);
117.168 + }
117.169 +
117.170 + /** Build an adapter of the given generic type, which invokes typedTarget
117.171 + * on the incoming arguments, after unboxing as necessary.
117.172 + * The return value is boxed if necessary.
117.173 + * @param genericType the required type of the result
117.174 + * @param typedTarget the target
117.175 + * @return an adapter method handle
117.176 + */
117.177 + public static MethodHandle make(MethodHandle typedTarget) {
117.178 + MethodType type = typedTarget.type();
117.179 + if (type == type.generic()) return typedTarget;
117.180 + return FromGeneric.of(type).makeInstance(typedTarget);
117.181 + }
117.182 +
117.183 + /** Return the adapter information for this type's erasure. */
117.184 + static FromGeneric of(MethodType type) {
117.185 + MethodTypeImpl form = MethodTypeImpl.of(type);
117.186 + FromGeneric fromGen = form.fromGeneric;
117.187 + if (fromGen == null)
117.188 + form.fromGeneric = fromGen = new FromGeneric(form.erasedType());
117.189 + return fromGen;
117.190 + }
117.191 +
117.192 + public String toString() {
117.193 + return "FromGeneric"+targetType;
117.194 + }
117.195 +
117.196 + /* Create an adapter that handles spreading calls for the given type. */
117.197 + static Adapter findAdapter(MethodType internalType) {
117.198 + MethodType entryType = internalType.generic();
117.199 + MethodTypeImpl form = MethodTypeImpl.of(internalType);
117.200 + Class<?> rtype = internalType.returnType();
117.201 + int argc = form.parameterCount();
117.202 + int lac = form.longPrimitiveParameterCount();
117.203 + int iac = form.primitiveParameterCount() - lac;
117.204 + String intsAndLongs = (iac > 0 ? "I"+iac : "")+(lac > 0 ? "J"+lac : "");
117.205 + String rawReturn = String.valueOf(Wrapper.forPrimitiveType(rtype).basicTypeChar());
117.206 + String cname0 = rawReturn + argc;
117.207 + String cname1 = "A" + argc;
117.208 + String[] cnames = { cname0+intsAndLongs, cname0, cname1+intsAndLongs, cname1 };
117.209 + String iname = "invoke_"+cname0+intsAndLongs;
117.210 + // e.g., D5I2, D5, L5I2, L5; invoke_D5
117.211 + for (String cname : cnames) {
117.212 + Class<? extends Adapter> acls = Adapter.findSubClass(cname);
117.213 + if (acls == null) continue;
117.214 + // see if it has the required invoke method
117.215 + MethodHandle entryPoint = null;
117.216 + try {
117.217 + entryPoint = MethodHandleImpl.IMPL_LOOKUP.findSpecial(acls, iname, entryType, acls);
117.218 + } catch (NoAccessException ex) {
117.219 + }
117.220 + if (entryPoint == null) continue;
117.221 + Constructor<? extends Adapter> ctor = null;
117.222 + try {
117.223 + ctor = acls.getDeclaredConstructor(MethodHandle.class);
117.224 + } catch (NoSuchMethodException ex) {
117.225 + } catch (SecurityException ex) {
117.226 + }
117.227 + if (ctor == null) continue;
117.228 + try {
117.229 + // Produce an instance configured as a prototype.
117.230 + return ctor.newInstance(entryPoint);
117.231 + } catch (IllegalArgumentException ex) {
117.232 + } catch (InvocationTargetException ex) {
117.233 + } catch (InstantiationException ex) {
117.234 + } catch (IllegalAccessException ex) {
117.235 + }
117.236 + }
117.237 + return null;
117.238 + }
117.239 +
117.240 + static Adapter buildAdapterFromBytecodes(MethodType internalType) {
117.241 + throw new UnsupportedOperationException("NYI");
117.242 + }
117.243 +
117.244 + /**
117.245 + * This adapter takes some untyped arguments, and returns an untyped result.
117.246 + * Internally, it applies the invoker to the target, which causes the
117.247 + * objects to be unboxed; the result is a raw type in L/I/J/F/D.
117.248 + * This result is passed to convert, which is responsible for
117.249 + * converting the raw result into a boxed object.
117.250 + * The invoker is kept separate from the target because it can be
117.251 + * generated once per type erasure family, and reused across adapters.
117.252 + */
117.253 + static abstract class Adapter extends JavaMethodHandle {
117.254 + /*
117.255 + * class X<<R,int N>> extends Adapter {
117.256 + * (MH, Object**N)=>raw(R) invoker;
117.257 + * (any**N)=>R target;
117.258 + * raw(R)=>Object convert;
117.259 + * Object invoke(Object**N a) = convert(invoker(target, a...))
117.260 + * }
117.261 + */
117.262 + protected final MethodHandle invoker; // (MH, Object**N) => raw(R)
117.263 + protected final MethodHandle convert; // raw(R) => Object
117.264 + protected final MethodHandle target; // (any**N) => R
117.265 +
117.266 + protected boolean isPrototype() { return target == null; }
117.267 + protected Adapter(MethodHandle entryPoint) {
117.268 + this(entryPoint, null, entryPoint, null);
117.269 + assert(isPrototype());
117.270 + }
117.271 + protected MethodHandle prototypeEntryPoint() {
117.272 + if (!isPrototype()) throw new InternalError();
117.273 + return convert;
117.274 + }
117.275 +
117.276 + protected Adapter(MethodHandle entryPoint,
117.277 + MethodHandle invoker, MethodHandle convert, MethodHandle target) {
117.278 + super(entryPoint);
117.279 + this.invoker = invoker;
117.280 + this.convert = convert;
117.281 + this.target = target;
117.282 + }
117.283 +
117.284 + /** Make a copy of self, with new fields. */
117.285 + protected abstract Adapter makeInstance(MethodHandle entryPoint,
117.286 + MethodHandle invoker, MethodHandle convert, MethodHandle target);
117.287 + // { return new ThisType(entryPoint, convert, target); }
117.288 +
117.289 + /// Conversions on the value returned from the target.
117.290 + protected Object convert_L(Object result) { return convert.<Object>invoke(result); }
117.291 + protected Object convert_I(int result) { return convert.<Object>invoke(result); }
117.292 + protected Object convert_J(long result) { return convert.<Object>invoke(result); }
117.293 + protected Object convert_F(float result) { return convert.<Object>invoke(result); }
117.294 + protected Object convert_D(double result) { return convert.<Object>invoke(result); }
117.295 +
117.296 + static private final String CLASS_PREFIX; // "sun.dyn.FromGeneric$"
117.297 + static {
117.298 + String aname = Adapter.class.getName();
117.299 + String sname = Adapter.class.getSimpleName();
117.300 + if (!aname.endsWith(sname)) throw new InternalError();
117.301 + CLASS_PREFIX = aname.substring(0, aname.length() - sname.length());
117.302 + }
117.303 + /** Find a sibing class of Adapter. */
117.304 + static Class<? extends Adapter> findSubClass(String name) {
117.305 + String cname = Adapter.CLASS_PREFIX + name;
117.306 + try {
117.307 + return Class.forName(cname).asSubclass(Adapter.class);
117.308 + } catch (ClassNotFoundException ex) {
117.309 + return null;
117.310 + } catch (ClassCastException ex) {
117.311 + return null;
117.312 + }
117.313 + }
117.314 + }
117.315 +
117.316 + /* generated classes follow this pattern:
117.317 + static class xA2 extends Adapter {
117.318 + protected xA2(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.319 + protected xA2(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.320 + { super(e, i, c, t); }
117.321 + protected xA2 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.322 + { return new xA2(e, i, c, t); }
117.323 + protected Object invoke_L2(Object a0, Object a1) { return convert_L(invoker.<Object>invoke(target, a0, a1)); }
117.324 + protected Object invoke_I2(Object a0, Object a1) { return convert_I(invoker.<int >invoke(target, a0, a1)); }
117.325 + protected Object invoke_J2(Object a0, Object a1) { return convert_J(invoker.<long >invoke(target, a0, a1)); }
117.326 + protected Object invoke_F2(Object a0, Object a1) { return convert_F(invoker.<float >invoke(target, a0, a1)); }
117.327 + protected Object invoke_D2(Object a0, Object a1) { return convert_D(invoker.<double>invoke(target, a0, a1)); }
117.328 + }
117.329 + // */
117.330 +
117.331 +/*
117.332 +: SHELL; n=FromGeneric; cp -p $n.java $n.java-; sed < $n.java- > $n.java+ -e '/{{*{{/,/}}*}}/w /tmp/genclasses.java' -e '/}}*}}/q'; (cd /tmp; javac -d . genclasses.java; java -cp . genclasses) >> $n.java+; echo '}' >> $n.java+; mv $n.java+ $n.java; mv $n.java- $n.java~
117.333 +//{{{
117.334 +import java.util.*;
117.335 +class genclasses {
117.336 + static String[] TYPES = { "Object", "int ", "long ", "float ", "double" };
117.337 + static String[] TCHARS = { "L", "I", "J", "F", "D", "A" };
117.338 + static String[][] TEMPLATES = { {
117.339 + "@for@ arity=0..10 rcat<=4 nrefs<=99 nints=0 nlongs=0",
117.340 + " //@each-cat@",
117.341 + " static class @cat@ extends Adapter {",
117.342 + " protected @cat@(MethodHandle entryPoint) { super(entryPoint); } // to build prototype",
117.343 + " protected @cat@(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)",
117.344 + " { super(e, i, c, t); }",
117.345 + " protected @cat@ makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)",
117.346 + " { return new @cat@(e, i, c, t); }",
117.347 + " //@each-R@",
117.348 + " protected Object invoke_@catN@(@Tvav@) { return convert_@Rc@(invoker.<@R@>invoke(target@av@)); }",
117.349 + " //@end-R@",
117.350 + " }",
117.351 + } };
117.352 + static final String NEWLINE_INDENT = "\n ";
117.353 + enum VAR {
117.354 + cat, catN, R, Rc, av, Tvav, Ovav;
117.355 + public final String pattern = "@"+toString().replace('_','.')+"@";
117.356 + public String binding;
117.357 + static void makeBindings(boolean topLevel, int rcat, int nrefs, int nints, int nlongs) {
117.358 + int nargs = nrefs + nints + nlongs;
117.359 + if (topLevel)
117.360 + VAR.cat.binding = catstr(ALL_RETURN_TYPES ? TYPES.length : rcat, nrefs, nints, nlongs);
117.361 + VAR.catN.binding = catstr(rcat, nrefs, nints, nlongs);
117.362 + VAR.R.binding = TYPES[rcat];
117.363 + VAR.Rc.binding = TCHARS[rcat];
117.364 + String[] Tv = new String[nargs];
117.365 + String[] av = new String[nargs];
117.366 + String[] Tvav = new String[nargs];
117.367 + String[] Ovav = new String[nargs];
117.368 + for (int i = 0; i < nargs; i++) {
117.369 + int tcat = (i < nrefs) ? 0 : (i < nrefs + nints) ? 1 : 2;
117.370 + Tv[i] = TYPES[tcat];
117.371 + av[i] = arg(i);
117.372 + Tvav[i] = param(Tv[i], av[i]);
117.373 + Ovav[i] = param("Object", av[i]);
117.374 + }
117.375 + VAR.av.binding = comma(", ", av);
117.376 + VAR.Tvav.binding = comma(Tvav);
117.377 + VAR.Ovav.binding = comma(Ovav);
117.378 + }
117.379 + static String arg(int i) { return "a"+i; }
117.380 + static String param(String t, String a) { return t+" "+a; }
117.381 + static String comma(String[] v) { return comma("", v); }
117.382 + static String comma(String sep, String[] v) {
117.383 + if (v.length == 0) return "";
117.384 + String res = sep+v[0];
117.385 + for (int i = 1; i < v.length; i++) res += ", "+v[i];
117.386 + return res;
117.387 + }
117.388 + static String transform(String string) {
117.389 + for (VAR var : values())
117.390 + string = string.replaceAll(var.pattern, var.binding);
117.391 + return string;
117.392 + }
117.393 + }
117.394 + static String[] stringsIn(String[] strings, int beg, int end) {
117.395 + return Arrays.copyOfRange(strings, beg, Math.min(end, strings.length));
117.396 + }
117.397 + static String[] stringsBefore(String[] strings, int pos) {
117.398 + return stringsIn(strings, 0, pos);
117.399 + }
117.400 + static String[] stringsAfter(String[] strings, int pos) {
117.401 + return stringsIn(strings, pos, strings.length);
117.402 + }
117.403 + static int indexAfter(String[] strings, int pos, String tag) {
117.404 + return Math.min(indexBefore(strings, pos, tag) + 1, strings.length);
117.405 + }
117.406 + static int indexBefore(String[] strings, int pos, String tag) {
117.407 + for (int i = pos, end = strings.length; ; i++) {
117.408 + if (i == end || strings[i].endsWith(tag)) return i;
117.409 + }
117.410 + }
117.411 + static int MIN_ARITY, MAX_ARITY, MAX_RCAT, MAX_REFS, MAX_INTS, MAX_LONGS;
117.412 + static boolean ALL_ARG_TYPES, ALL_RETURN_TYPES;
117.413 + static HashSet<String> done = new HashSet<String>();
117.414 + public static void main(String... av) {
117.415 + for (String[] template : TEMPLATES) {
117.416 + int forLinesLimit = indexBefore(template, 0, "@each-cat@");
117.417 + String[] forLines = stringsBefore(template, forLinesLimit);
117.418 + template = stringsAfter(template, forLinesLimit);
117.419 + for (String forLine : forLines)
117.420 + expandTemplate(forLine, template);
117.421 + }
117.422 + }
117.423 + static void expandTemplate(String forLine, String[] template) {
117.424 + String[] params = forLine.split("[^0-9]+");
117.425 + if (params[0].length() == 0) params = stringsAfter(params, 1);
117.426 + System.out.println("//params="+Arrays.asList(params));
117.427 + int pcur = 0;
117.428 + MIN_ARITY = Integer.valueOf(params[pcur++]);
117.429 + MAX_ARITY = Integer.valueOf(params[pcur++]);
117.430 + MAX_RCAT = Integer.valueOf(params[pcur++]);
117.431 + MAX_REFS = Integer.valueOf(params[pcur++]);
117.432 + MAX_INTS = Integer.valueOf(params[pcur++]);
117.433 + MAX_LONGS = Integer.valueOf(params[pcur++]);
117.434 + if (pcur != params.length) throw new RuntimeException("bad extra param: "+forLine);
117.435 + if (MAX_RCAT >= TYPES.length) MAX_RCAT = TYPES.length - 1;
117.436 + ALL_ARG_TYPES = (indexBefore(template, 0, "@each-Tv@") < template.length);
117.437 + ALL_RETURN_TYPES = (indexBefore(template, 0, "@each-R@") < template.length);
117.438 + for (int nargs = MIN_ARITY; nargs <= MAX_ARITY; nargs++) {
117.439 + for (int rcat = 0; rcat <= MAX_RCAT; rcat++) {
117.440 + expandTemplate(template, true, rcat, nargs, 0, 0);
117.441 + if (ALL_ARG_TYPES) break;
117.442 + expandTemplateForPrims(template, true, rcat, nargs, 1, 1);
117.443 + if (ALL_RETURN_TYPES) break;
117.444 + }
117.445 + }
117.446 + }
117.447 + static String catstr(int rcat, int nrefs, int nints, int nlongs) {
117.448 + int nargs = nrefs + nints + nlongs;
117.449 + String cat = TCHARS[rcat] + nargs;
117.450 + if (!ALL_ARG_TYPES) cat += (nints==0?"":"I"+nints)+(nlongs==0?"":"J"+nlongs);
117.451 + return cat;
117.452 + }
117.453 + static void expandTemplateForPrims(String[] template, boolean topLevel, int rcat, int nargs, int minints, int minlongs) {
117.454 + for (int isLong = 0; isLong <= 1; isLong++) {
117.455 + for (int nprims = 1; nprims <= nargs; nprims++) {
117.456 + int nrefs = nargs - nprims;
117.457 + int nints = ((1-isLong) * nprims);
117.458 + int nlongs = (isLong * nprims);
117.459 + expandTemplate(template, topLevel, rcat, nrefs, nints, nlongs);
117.460 + }
117.461 + }
117.462 + }
117.463 + static void expandTemplate(String[] template, boolean topLevel,
117.464 + int rcat, int nrefs, int nints, int nlongs) {
117.465 + int nargs = nrefs + nints + nlongs;
117.466 + if (nrefs > MAX_REFS || nints > MAX_INTS || nlongs > MAX_LONGS) return;
117.467 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
117.468 + if (topLevel && !done.add(VAR.cat.binding)) {
117.469 + System.out.println(" //repeat "+VAR.cat.binding);
117.470 + return;
117.471 + }
117.472 + for (int i = 0; i < template.length; i++) {
117.473 + String line = template[i];
117.474 + if (line.endsWith("@each-cat@")) {
117.475 + // ignore
117.476 + } else if (line.endsWith("@each-R@")) {
117.477 + int blockEnd = indexAfter(template, i, "@end-R@");
117.478 + String[] block = stringsIn(template, i+1, blockEnd-1);
117.479 + for (int rcat1 = rcat; rcat1 <= MAX_RCAT; rcat1++)
117.480 + expandTemplate(block, false, rcat1, nrefs, nints, nlongs);
117.481 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
117.482 + i = blockEnd-1; continue;
117.483 + } else if (line.endsWith("@each-Tv@")) {
117.484 + int blockEnd = indexAfter(template, i, "@end-Tv@");
117.485 + String[] block = stringsIn(template, i+1, blockEnd-1);
117.486 + expandTemplate(block, false, rcat, nrefs, nints, nlongs);
117.487 + expandTemplateForPrims(block, false, rcat, nargs, nints+1, nlongs+1);
117.488 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
117.489 + i = blockEnd-1; continue;
117.490 + } else {
117.491 + System.out.println(VAR.transform(line));
117.492 + }
117.493 + }
117.494 + }
117.495 +}
117.496 +//}}} */
117.497 +//params=[0, 10, 4, 99, 0, 0]
117.498 + static class A0 extends Adapter {
117.499 + protected A0(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.500 + protected A0(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.501 + { super(e, i, c, t); }
117.502 + protected A0 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.503 + { return new A0(e, i, c, t); }
117.504 + protected Object invoke_L0() { return convert_L(invoker.<Object>invoke(target)); }
117.505 + protected Object invoke_I0() { return convert_I(invoker.<int >invoke(target)); }
117.506 + protected Object invoke_J0() { return convert_J(invoker.<long >invoke(target)); }
117.507 + protected Object invoke_F0() { return convert_F(invoker.<float >invoke(target)); }
117.508 + protected Object invoke_D0() { return convert_D(invoker.<double>invoke(target)); }
117.509 + }
117.510 + static class A1 extends Adapter {
117.511 + protected A1(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.512 + protected A1(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.513 + { super(e, i, c, t); }
117.514 + protected A1 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.515 + { return new A1(e, i, c, t); }
117.516 + protected Object invoke_L1(Object a0) { return convert_L(invoker.<Object>invoke(target, a0)); }
117.517 + protected Object invoke_I1(Object a0) { return convert_I(invoker.<int >invoke(target, a0)); }
117.518 + protected Object invoke_J1(Object a0) { return convert_J(invoker.<long >invoke(target, a0)); }
117.519 + protected Object invoke_F1(Object a0) { return convert_F(invoker.<float >invoke(target, a0)); }
117.520 + protected Object invoke_D1(Object a0) { return convert_D(invoker.<double>invoke(target, a0)); }
117.521 + }
117.522 + static class A2 extends Adapter {
117.523 + protected A2(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.524 + protected A2(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.525 + { super(e, i, c, t); }
117.526 + protected A2 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.527 + { return new A2(e, i, c, t); }
117.528 + protected Object invoke_L2(Object a0, Object a1) { return convert_L(invoker.<Object>invoke(target, a0, a1)); }
117.529 + protected Object invoke_I2(Object a0, Object a1) { return convert_I(invoker.<int >invoke(target, a0, a1)); }
117.530 + protected Object invoke_J2(Object a0, Object a1) { return convert_J(invoker.<long >invoke(target, a0, a1)); }
117.531 + protected Object invoke_F2(Object a0, Object a1) { return convert_F(invoker.<float >invoke(target, a0, a1)); }
117.532 + protected Object invoke_D2(Object a0, Object a1) { return convert_D(invoker.<double>invoke(target, a0, a1)); }
117.533 + }
117.534 + static class A3 extends Adapter {
117.535 + protected A3(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.536 + protected A3(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.537 + { super(e, i, c, t); }
117.538 + protected A3 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.539 + { return new A3(e, i, c, t); }
117.540 + protected Object invoke_L3(Object a0, Object a1, Object a2) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2)); }
117.541 + protected Object invoke_I3(Object a0, Object a1, Object a2) { return convert_I(invoker.<int >invoke(target, a0, a1, a2)); }
117.542 + protected Object invoke_J3(Object a0, Object a1, Object a2) { return convert_J(invoker.<long >invoke(target, a0, a1, a2)); }
117.543 + protected Object invoke_F3(Object a0, Object a1, Object a2) { return convert_F(invoker.<float >invoke(target, a0, a1, a2)); }
117.544 + protected Object invoke_D3(Object a0, Object a1, Object a2) { return convert_D(invoker.<double>invoke(target, a0, a1, a2)); }
117.545 + }
117.546 + static class A4 extends Adapter {
117.547 + protected A4(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.548 + protected A4(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.549 + { super(e, i, c, t); }
117.550 + protected A4 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.551 + { return new A4(e, i, c, t); }
117.552 + protected Object invoke_L4(Object a0, Object a1, Object a2, Object a3) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3)); }
117.553 + protected Object invoke_I4(Object a0, Object a1, Object a2, Object a3) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3)); }
117.554 + protected Object invoke_J4(Object a0, Object a1, Object a2, Object a3) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3)); }
117.555 + protected Object invoke_F4(Object a0, Object a1, Object a2, Object a3) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3)); }
117.556 + protected Object invoke_D4(Object a0, Object a1, Object a2, Object a3) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3)); }
117.557 + }
117.558 + static class A5 extends Adapter {
117.559 + protected A5(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.560 + protected A5(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.561 + { super(e, i, c, t); }
117.562 + protected A5 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.563 + { return new A5(e, i, c, t); }
117.564 + protected Object invoke_L5(Object a0, Object a1, Object a2, Object a3, Object a4) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4)); }
117.565 + protected Object invoke_I5(Object a0, Object a1, Object a2, Object a3, Object a4) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4)); }
117.566 + protected Object invoke_J5(Object a0, Object a1, Object a2, Object a3, Object a4) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4)); }
117.567 + protected Object invoke_F5(Object a0, Object a1, Object a2, Object a3, Object a4) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4)); }
117.568 + protected Object invoke_D5(Object a0, Object a1, Object a2, Object a3, Object a4) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4)); }
117.569 + }
117.570 + static class A6 extends Adapter {
117.571 + protected A6(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.572 + protected A6(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.573 + { super(e, i, c, t); }
117.574 + protected A6 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.575 + { return new A6(e, i, c, t); }
117.576 + protected Object invoke_L6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5)); }
117.577 + protected Object invoke_I6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4, a5)); }
117.578 + protected Object invoke_J6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4, a5)); }
117.579 + protected Object invoke_F6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4, a5)); }
117.580 + protected Object invoke_D6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4, a5)); }
117.581 + }
117.582 + static class A7 extends Adapter {
117.583 + protected A7(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.584 + protected A7(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.585 + { super(e, i, c, t); }
117.586 + protected A7 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.587 + { return new A7(e, i, c, t); }
117.588 + protected Object invoke_L7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6)); }
117.589 + protected Object invoke_I7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4, a5, a6)); }
117.590 + protected Object invoke_J7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4, a5, a6)); }
117.591 + protected Object invoke_F7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4, a5, a6)); }
117.592 + protected Object invoke_D7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4, a5, a6)); }
117.593 + }
117.594 + static class A8 extends Adapter {
117.595 + protected A8(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.596 + protected A8(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.597 + { super(e, i, c, t); }
117.598 + protected A8 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.599 + { return new A8(e, i, c, t); }
117.600 + protected Object invoke_L8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7)); }
117.601 + protected Object invoke_I8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7)); }
117.602 + protected Object invoke_J8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7)); }
117.603 + protected Object invoke_F8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7)); }
117.604 + protected Object invoke_D8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7)); }
117.605 + }
117.606 + static class A9 extends Adapter {
117.607 + protected A9(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.608 + protected A9(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.609 + { super(e, i, c, t); }
117.610 + protected A9 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.611 + { return new A9(e, i, c, t); }
117.612 + protected Object invoke_L9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
117.613 + protected Object invoke_I9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
117.614 + protected Object invoke_J9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
117.615 + protected Object invoke_F9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
117.616 + protected Object invoke_D9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
117.617 + }
117.618 + static class A10 extends Adapter {
117.619 + protected A10(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
117.620 + protected A10(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.621 + { super(e, i, c, t); }
117.622 + protected A10 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t)
117.623 + { return new A10(e, i, c, t); }
117.624 + protected Object invoke_L10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return convert_L(invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
117.625 + protected Object invoke_I10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return convert_I(invoker.<int >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
117.626 + protected Object invoke_J10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return convert_J(invoker.<long >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
117.627 + protected Object invoke_F10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return convert_F(invoker.<float >invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
117.628 + protected Object invoke_D10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return convert_D(invoker.<double>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
117.629 + }
117.630 +}
118.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
118.2 +++ b/src/share/classes/sun/dyn/Invokers.java Thu May 14 00:17:25 2009 -0700
118.3 @@ -0,0 +1,86 @@
118.4 +/*
118.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
118.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
118.7 + *
118.8 + * This code is free software; you can redistribute it and/or modify it
118.9 + * under the terms of the GNU General Public License version 2 only, as
118.10 + * published by the Free Software Foundation. Sun designates this
118.11 + * particular file as subject to the "Classpath" exception as provided
118.12 + * by Sun in the LICENSE file that accompanied this code.
118.13 + *
118.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
118.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
118.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
118.17 + * version 2 for more details (a copy is included in the LICENSE file that
118.18 + * accompanied this code).
118.19 + *
118.20 + * You should have received a copy of the GNU General Public License version
118.21 + * 2 along with this work; if not, write to the Free Software Foundation,
118.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
118.23 + *
118.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
118.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
118.26 + * have any questions.
118.27 + */
118.28 +
118.29 +package sun.dyn;
118.30 +
118.31 +import java.dyn.MethodHandle;
118.32 +import java.dyn.MethodHandles;
118.33 +import java.dyn.MethodType;
118.34 +
118.35 +
118.36 +/**
118.37 + * Construction and caching of often-used invokers.
118.38 + * @author jrose
118.39 + */
118.40 +public class Invokers {
118.41 + // exact type (sans leading taget MH) for the outgoing call
118.42 + private final MethodType targetType;
118.43 +
118.44 + // exact invoker for the outgoing call
118.45 + private /*lazy*/ MethodHandle exactInvoker;
118.46 +
118.47 + // generic (untyped) invoker for the outgoing call
118.48 + private /*lazy*/ MethodHandle genericInvoker;
118.49 +
118.50 + /** Compute and cache information common to all collecting adapters
118.51 + * that implement members of the erasure-family of the given erased type.
118.52 + */
118.53 + public Invokers(Access token, MethodType targetType) {
118.54 + Access.check(token);
118.55 + this.targetType = targetType;
118.56 + }
118.57 +
118.58 + public static MethodType invokerType(MethodType targetType) {
118.59 + return targetType.insertParameterType(0, MethodHandle.class);
118.60 + }
118.61 +
118.62 + public MethodHandle exactInvoker() {
118.63 + MethodHandle invoker = exactInvoker;
118.64 + if (invoker != null) return invoker;
118.65 + invoker = MethodHandleImpl.IMPL_LOOKUP.findVirtual(MethodHandle.class, "invoke", targetType);
118.66 + if (invoker == null) throw new InternalError("JVM cannot find invoker for "+targetType);
118.67 + assert(invokerType(targetType) == invoker.type());
118.68 + exactInvoker = invoker;
118.69 + return invoker;
118.70 + }
118.71 +
118.72 + public MethodHandle genericInvoker() {
118.73 + MethodHandle invoker1 = exactInvoker();
118.74 + MethodHandle invoker = genericInvoker;
118.75 + if (invoker != null) return invoker;
118.76 + MethodType genericType = targetType.generic();
118.77 + invoker = MethodHandles.convertArguments(invoker1, invokerType(genericType));
118.78 + genericInvoker = invoker;
118.79 + return invoker;
118.80 + }
118.81 +
118.82 + public MethodHandle varargsInvoker() {
118.83 + throw new UnsupportedOperationException("NYI");
118.84 + }
118.85 +
118.86 + public String toString() {
118.87 + return "Invokers"+targetType;
118.88 + }
118.89 +}
119.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
119.2 +++ b/src/share/classes/sun/dyn/MemberName.java Thu May 14 00:17:25 2009 -0700
119.3 @@ -0,0 +1,551 @@
119.4 +/*
119.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
119.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
119.7 + *
119.8 + * This code is free software; you can redistribute it and/or modify it
119.9 + * under the terms of the GNU General Public License version 2 only, as
119.10 + * published by the Free Software Foundation. Sun designates this
119.11 + * particular file as subject to the "Classpath" exception as provided
119.12 + * by Sun in the LICENSE file that accompanied this code.
119.13 + *
119.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
119.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
119.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
119.17 + * version 2 for more details (a copy is included in the LICENSE file that
119.18 + * accompanied this code).
119.19 + *
119.20 + * You should have received a copy of the GNU General Public License version
119.21 + * 2 along with this work; if not, write to the Free Software Foundation,
119.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
119.23 + *
119.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
119.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
119.26 + * have any questions.
119.27 + */
119.28 +
119.29 +package sun.dyn;
119.30 +
119.31 +import sun.dyn.util.BytecodeSignature;
119.32 +import java.dyn.*;
119.33 +import java.lang.reflect.Constructor;
119.34 +import java.lang.reflect.Field;
119.35 +import java.lang.reflect.Method;
119.36 +import java.lang.reflect.Member;
119.37 +import java.lang.reflect.Modifier;
119.38 +import java.util.ArrayList;
119.39 +import java.util.Collections;
119.40 +import java.util.Iterator;
119.41 +import java.util.List;
119.42 +import static sun.dyn.MethodHandleNatives.Constants.*;
119.43 +
119.44 +/**
119.45 + * Compact information which fully characterizes a method or field reference.
119.46 + * When resolved, it includes a direct pointer to JVM metadata.
119.47 + * This representation is stateless and only decriptive.
119.48 + * It provides no private information and no capability to use the member.
119.49 + * <p>
119.50 + * By contrast, a java.lang.reflect.Method contains fuller information
119.51 + * about the internals of a method (except its bytecodes) and also
119.52 + * allows invocation. A MemberName is much lighter than a reflect.Method,
119.53 + * since it contains about 7 fields to Method's 16 (plus its sub-arrays),
119.54 + * and those seven fields omit much of the information in Method.
119.55 + * @author jrose
119.56 + */
119.57 +public final class MemberName implements Member, Cloneable {
119.58 + private Class<?> clazz; // class in which the method is defined
119.59 + private String name; // may be null if not yet materialized
119.60 + private Object type; // may be null if not yet materialized
119.61 + private int flags; // modifier bits; see reflect.Modifier
119.62 +
119.63 + private Object vmtarget; // VM-specific target value
119.64 + private int vmindex; // method index within class or interface
119.65 +
119.66 + { vmindex = VM_INDEX_UNINITIALIZED; }
119.67 +
119.68 + public Class<?> getDeclaringClass() {
119.69 + if (clazz == null && isResolved()) {
119.70 + expandFromVM();
119.71 + }
119.72 + return clazz;
119.73 + }
119.74 +
119.75 + public ClassLoader getClassLoader() {
119.76 + return clazz.getClassLoader();
119.77 + }
119.78 +
119.79 + public String getName() {
119.80 + if (name == null) {
119.81 + expandFromVM();
119.82 + if (name == null) return null;
119.83 + }
119.84 + return name;
119.85 + }
119.86 +
119.87 + public MethodType getMethodType() {
119.88 + if (type == null) {
119.89 + expandFromVM();
119.90 + if (type == null) return null;
119.91 + }
119.92 + if (!isInvocable())
119.93 + throw newIllegalArgumentException("not invocable, no method type");
119.94 + if (type instanceof MethodType) {
119.95 + return (MethodType) type;
119.96 + }
119.97 + if (type instanceof String) {
119.98 + String sig = (String) type;
119.99 + MethodType res = MethodType.fromBytecodeString(sig, getClassLoader());
119.100 + this.type = res;
119.101 + return res;
119.102 + }
119.103 + if (type instanceof Object[]) {
119.104 + Object[] typeInfo = (Object[]) type;
119.105 + Class<?>[] ptypes = (Class<?>[]) typeInfo[1];
119.106 + Class<?> rtype = (Class<?>) typeInfo[0];
119.107 + MethodType res = MethodType.make(rtype, ptypes);
119.108 + this.type = res;
119.109 + return res;
119.110 + }
119.111 + throw new InternalError("bad method type "+type);
119.112 + }
119.113 +
119.114 + public MethodType getInvocationType() {
119.115 + MethodType itype = getMethodType();
119.116 + if (!isStatic())
119.117 + itype = itype.insertParameterType(0, clazz);
119.118 + return itype;
119.119 + }
119.120 +
119.121 + public Class<?>[] getParameterTypes() {
119.122 + return getMethodType().parameterArray();
119.123 + }
119.124 +
119.125 + public Class<?> getReturnType() {
119.126 + return getMethodType().returnType();
119.127 + }
119.128 +
119.129 + public Class<?> getFieldType() {
119.130 + if (type == null) {
119.131 + expandFromVM();
119.132 + if (type == null) return null;
119.133 + }
119.134 + if (isInvocable())
119.135 + throw newIllegalArgumentException("not a field or nested class, no simple type");
119.136 + if (type instanceof Class<?>) {
119.137 + return (Class<?>) type;
119.138 + }
119.139 + if (type instanceof String) {
119.140 + String sig = (String) type;
119.141 + MethodType mtype = MethodType.fromBytecodeString("()"+sig, getClassLoader());
119.142 + Class<?> res = mtype.returnType();
119.143 + this.type = res;
119.144 + return res;
119.145 + }
119.146 + throw new InternalError("bad field type "+type);
119.147 + }
119.148 +
119.149 + public Object getType() {
119.150 + return (isInvocable() ? getMethodType() : getFieldType());
119.151 + }
119.152 +
119.153 + public String getSignature() {
119.154 + if (type == null) {
119.155 + expandFromVM();
119.156 + if (type == null) return null;
119.157 + }
119.158 + if (type instanceof String)
119.159 + return (String) type;
119.160 + if (isInvocable())
119.161 + return BytecodeSignature.unparse(getMethodType());
119.162 + else
119.163 + return BytecodeSignature.unparse(getFieldType());
119.164 + }
119.165 +
119.166 + public int getModifiers() {
119.167 + return (flags & RECOGNIZED_MODIFIERS);
119.168 + }
119.169 +
119.170 + private void setFlags(int flags) {
119.171 + this.flags = flags;
119.172 + assert(testAnyFlags(ALL_KINDS));
119.173 + }
119.174 +
119.175 + private boolean testFlags(int mask, int value) {
119.176 + return (flags & mask) == value;
119.177 + }
119.178 + private boolean testAllFlags(int mask) {
119.179 + return testFlags(mask, mask);
119.180 + }
119.181 + private boolean testAnyFlags(int mask) {
119.182 + return !testFlags(mask, 0);
119.183 + }
119.184 +
119.185 + public boolean isStatic() {
119.186 + return Modifier.isStatic(flags);
119.187 + }
119.188 + public boolean isPublic() {
119.189 + return Modifier.isPublic(flags);
119.190 + }
119.191 + public boolean isPrivate() {
119.192 + return Modifier.isPrivate(flags);
119.193 + }
119.194 + public boolean isProtected() {
119.195 + return Modifier.isProtected(flags);
119.196 + }
119.197 + public boolean isFinal() {
119.198 + return Modifier.isFinal(flags);
119.199 + }
119.200 + public boolean isAbstract() {
119.201 + return Modifier.isAbstract(flags);
119.202 + }
119.203 + // let the rest (native, volatile, transient, etc.) be tested via Modifier.isFoo
119.204 +
119.205 + // unofficial modifier flags, used by HotSpot:
119.206 + static final int BRIDGE = 0x00000040;
119.207 + static final int VARARGS = 0x00000080;
119.208 + static final int SYNTHETIC = 0x00001000;
119.209 + static final int ANNOTATION= 0x00002000;
119.210 + static final int ENUM = 0x00004000;
119.211 + public boolean isBridge() {
119.212 + return testAllFlags(IS_METHOD | BRIDGE);
119.213 + }
119.214 + public boolean isVarargs() {
119.215 + return testAllFlags(VARARGS) && isInvocable();
119.216 + }
119.217 + public boolean isSynthetic() {
119.218 + return testAllFlags(SYNTHETIC);
119.219 + }
119.220 +
119.221 + static final String CONSTRUCTOR_NAME = "<init>"; // the ever-popular
119.222 +
119.223 + // modifiers exported by the JVM:
119.224 + static final int RECOGNIZED_MODIFIERS = 0xFFFF;
119.225 +
119.226 + // private flags, not part of RECOGNIZED_MODIFIERS:
119.227 + static final int
119.228 + IS_METHOD = MN_IS_METHOD, // method (not constructor)
119.229 + IS_CONSTRUCTOR = MN_IS_CONSTRUCTOR, // constructor
119.230 + IS_FIELD = MN_IS_FIELD, // field
119.231 + IS_TYPE = MN_IS_TYPE; // nested type
119.232 + static final int // for MethodHandleNatives.getMembers
119.233 + SEARCH_SUPERCLASSES = MN_SEARCH_SUPERCLASSES,
119.234 + SEARCH_INTERFACES = MN_SEARCH_INTERFACES;
119.235 +
119.236 + static final int ALL_ACCESS = Modifier.PUBLIC | Modifier.PRIVATE | Modifier.PROTECTED;
119.237 + static final int ALL_KINDS = IS_METHOD | IS_CONSTRUCTOR | IS_FIELD | IS_TYPE;
119.238 + static final int IS_INVOCABLE = IS_METHOD | IS_CONSTRUCTOR;
119.239 + static final int IS_FIELD_OR_METHOD = IS_METHOD | IS_FIELD;
119.240 + static final int SEARCH_ALL_SUPERS = SEARCH_SUPERCLASSES | SEARCH_INTERFACES;
119.241 +
119.242 + public boolean isInvocable() {
119.243 + return testAnyFlags(IS_INVOCABLE);
119.244 + }
119.245 + public boolean isFieldOrMethod() {
119.246 + return testAnyFlags(IS_FIELD_OR_METHOD);
119.247 + }
119.248 + public boolean isMethod() {
119.249 + return testAllFlags(IS_METHOD);
119.250 + }
119.251 + public boolean isConstructor() {
119.252 + return testAllFlags(IS_CONSTRUCTOR);
119.253 + }
119.254 + public boolean isField() {
119.255 + return testAllFlags(IS_FIELD);
119.256 + }
119.257 + public boolean isType() {
119.258 + return testAllFlags(IS_TYPE);
119.259 + }
119.260 + public boolean isPackage() {
119.261 + return !testAnyFlags(ALL_ACCESS);
119.262 + }
119.263 +
119.264 + /** Initialize a query. It is not resolved. */
119.265 + private void init(Class<?> defClass, String name, Object type, int flags) {
119.266 + // defining class is allowed to be null (for a naked name/type pair)
119.267 + name.toString(); // null check
119.268 + type.equals(type); // null check
119.269 + // fill in fields:
119.270 + this.clazz = defClass;
119.271 + this.name = name;
119.272 + this.type = type;
119.273 + setFlags(flags);
119.274 + assert(!isResolved());
119.275 + }
119.276 +
119.277 + private void expandFromVM() {
119.278 + if (!isResolved()) return;
119.279 + if (type instanceof Object[])
119.280 + type = null; // don't saddle JVM w/ typeInfo
119.281 + MethodHandleNatives.expand(this);
119.282 + }
119.283 +
119.284 + // Capturing information from the Core Reflection API:
119.285 + private static int flagsMods(int flags, int mods) {
119.286 + assert((flags & RECOGNIZED_MODIFIERS) == 0);
119.287 + assert((mods & ~RECOGNIZED_MODIFIERS) == 0);
119.288 + return flags | mods;
119.289 + }
119.290 + public MemberName(Method m) {
119.291 + Object[] typeInfo = { m.getReturnType(), m.getParameterTypes() };
119.292 + init(m.getDeclaringClass(), m.getName(), typeInfo, flagsMods(IS_METHOD, m.getModifiers()));
119.293 + // fill in vmtarget, vmindex while we have m in hand:
119.294 + MethodHandleNatives.init(this, m);
119.295 + assert(isResolved());
119.296 + }
119.297 + public MemberName(Constructor ctor) {
119.298 + Object[] typeInfo = { void.class, ctor.getParameterTypes() };
119.299 + init(ctor.getDeclaringClass(), CONSTRUCTOR_NAME, typeInfo, flagsMods(IS_CONSTRUCTOR, ctor.getModifiers()));
119.300 + // fill in vmtarget, vmindex while we have ctor in hand:
119.301 + MethodHandleNatives.init(this, ctor);
119.302 + assert(isResolved());
119.303 + }
119.304 + public MemberName(Field fld) {
119.305 + init(fld.getDeclaringClass(), fld.getName(), fld.getType(), flagsMods(IS_FIELD, fld.getModifiers()));
119.306 + // fill in vmtarget, vmindex while we have fld in hand:
119.307 + MethodHandleNatives.init(this, fld);
119.308 + assert(isResolved());
119.309 + }
119.310 + public MemberName(Class<?> type) {
119.311 + init(type.getDeclaringClass(), type.getSimpleName(), type, flagsMods(IS_TYPE, type.getModifiers()));
119.312 + vmindex = 0; // isResolved
119.313 + assert(isResolved());
119.314 + }
119.315 +
119.316 + // bare-bones constructor; the JVM will fill it in
119.317 + MemberName() { }
119.318 +
119.319 + // locally useful cloner
119.320 + @Override protected MemberName clone() {
119.321 + try {
119.322 + return (MemberName) super.clone();
119.323 + } catch (CloneNotSupportedException ex) {
119.324 + throw new InternalError();
119.325 + }
119.326 + }
119.327 +
119.328 + // %%% define equals/hashcode?
119.329 +
119.330 + // Construction from symbolic parts, for queries:
119.331 + public MemberName(Class<?> defClass, String name, Class<?> type, int modifiers) {
119.332 + init(defClass, name, type, IS_FIELD | (modifiers & RECOGNIZED_MODIFIERS));
119.333 + }
119.334 + public MemberName(Class<?> defClass, String name, Class<?> type) {
119.335 + this(defClass, name, type, 0);
119.336 + }
119.337 + public MemberName(Class<?> defClass, String name, MethodType type, int modifiers) {
119.338 + int flagBit = (name.equals(CONSTRUCTOR_NAME) ? IS_CONSTRUCTOR : IS_METHOD);
119.339 + init(defClass, name, type, flagBit | (modifiers & RECOGNIZED_MODIFIERS));
119.340 + }
119.341 + public MemberName(Class<?> defClass, String name, MethodType type) {
119.342 + this(defClass, name, type, 0);
119.343 + }
119.344 +
119.345 + boolean isResolved() {
119.346 + return (vmindex != VM_INDEX_UNINITIALIZED);
119.347 + }
119.348 +
119.349 + public boolean hasReceiverTypeDispatch() {
119.350 + return (isMethod() && getVMIndex(Access.TOKEN) >= 0);
119.351 + }
119.352 +
119.353 + @Override
119.354 + public String toString() {
119.355 + if (isType())
119.356 + return type.toString(); // class java.lang.String
119.357 + // else it is a field, method, or constructor
119.358 + StringBuilder buf = new StringBuilder();
119.359 + if (getDeclaringClass() != null) {
119.360 + buf.append(getName(clazz));
119.361 + buf.append('.');
119.362 + }
119.363 + buf.append(getName());
119.364 + if (!isInvocable()) buf.append('/');
119.365 + buf.append(getName(getType()));
119.366 + /*
119.367 + buf.append('/');
119.368 + // key: Public, private, pRotected, sTatic, Final, sYnchronized,
119.369 + // transient/Varargs, native, (interface), abstract, sTrict, sYnthetic,
119.370 + // (annotation), Enum, (unused)
119.371 + final String FIELD_MOD_CHARS = "PprTF?vt????Y?E?";
119.372 + final String METHOD_MOD_CHARS = "PprTFybVn?atY???";
119.373 + String modChars = (isInvocable() ? METHOD_MOD_CHARS : FIELD_MOD_CHARS);
119.374 + for (int i = 0; i < modChars.length(); i++) {
119.375 + if ((flags & (1 << i)) != 0) {
119.376 + char mc = modChars.charAt(i);
119.377 + if (mc != '.')
119.378 + buf.append(mc);
119.379 + }
119.380 + }
119.381 + */
119.382 + return buf.toString();
119.383 + }
119.384 + private static String getName(Object obj) {
119.385 + if (obj instanceof Class<?>)
119.386 + return ((Class<?>)obj).getName();
119.387 + return obj.toString();
119.388 + }
119.389 +
119.390 + // Queries to the JVM:
119.391 + public int getVMIndex(Access token) {
119.392 + Access.check(token);
119.393 + if (!isResolved())
119.394 + throw newIllegalStateException("not resolved");
119.395 + return vmindex;
119.396 + }
119.397 +// public Object getVMTarget(Access token) {
119.398 +// Access.check(token);
119.399 +// if (!isResolved())
119.400 +// throw newIllegalStateException("not resolved");
119.401 +// return vmtarget;
119.402 +// }
119.403 + private RuntimeException newIllegalStateException(String message) {
119.404 + return new IllegalStateException(message+": "+this);
119.405 + }
119.406 +
119.407 + // handy shared exception makers (they simplify the common case code)
119.408 + public static RuntimeException newIllegalArgumentException(String message) {
119.409 + return new IllegalArgumentException(message);
119.410 + }
119.411 + public static NoAccessException newNoAccessException(MemberName name, Class<?> lookupClass) {
119.412 + return newNoAccessException("cannot access", name, lookupClass);
119.413 + }
119.414 + public static NoAccessException newNoAccessException(String message,
119.415 + MemberName name, Class<?> lookupClass) {
119.416 + message += ": " + name;
119.417 + if (lookupClass != null) message += ", from " + lookupClass.getName();
119.418 + return new NoAccessException(message);
119.419 + }
119.420 +
119.421 + /** Actually making a query requires an access check. */
119.422 + public static Factory getFactory(Access token) {
119.423 + Access.check(token);
119.424 + return Factory.INSTANCE;
119.425 + }
119.426 + public static Factory getFactory() {
119.427 + return getFactory(Access.getToken());
119.428 + }
119.429 + public static class Factory {
119.430 + private Factory() { } // singleton pattern
119.431 + static Factory INSTANCE = new Factory();
119.432 +
119.433 + private static int ALLOWED_FLAGS = SEARCH_ALL_SUPERS | ALL_KINDS;
119.434 +
119.435 + /// Queries
119.436 + List<MemberName> getMembers(Class<?> defc,
119.437 + String matchName, Object matchType,
119.438 + int matchFlags, Class<?> lookupClass) {
119.439 + matchFlags &= ALLOWED_FLAGS;
119.440 + String matchSig = null;
119.441 + if (matchType != null) {
119.442 + matchSig = BytecodeSignature.unparse(matchType);
119.443 + if (matchSig.startsWith("("))
119.444 + matchFlags &= ~(ALL_KINDS & ~IS_INVOCABLE);
119.445 + else
119.446 + matchFlags &= ~(ALL_KINDS & ~IS_FIELD);
119.447 + }
119.448 + final int BUF_MAX = 0x2000;
119.449 + int len1 = matchName == null ? 10 : matchType == null ? 4 : 1;
119.450 + MemberName[] buf = newMemberBuffer(len1);
119.451 + int totalCount = 0;
119.452 + ArrayList<MemberName[]> bufs = null;
119.453 + for (;;) {
119.454 + int bufCount = MethodHandleNatives.getMembers(defc,
119.455 + matchName, matchSig, matchFlags,
119.456 + lookupClass,
119.457 + totalCount, buf);
119.458 + if (bufCount <= buf.length) {
119.459 + if (bufCount >= 0)
119.460 + totalCount += bufCount;
119.461 + break;
119.462 + }
119.463 + // JVM returned tp us with an intentional overflow!
119.464 + totalCount += buf.length;
119.465 + int excess = bufCount - buf.length;
119.466 + if (bufs == null) bufs = new ArrayList<MemberName[]>(1);
119.467 + bufs.add(buf);
119.468 + int len2 = buf.length;
119.469 + len2 = Math.max(len2, excess);
119.470 + len2 = Math.max(len2, totalCount / 4);
119.471 + buf = newMemberBuffer(Math.min(BUF_MAX, len2));
119.472 + }
119.473 + ArrayList<MemberName> result = new ArrayList<MemberName>(totalCount);
119.474 + if (bufs != null) {
119.475 + for (MemberName[] buf0 : bufs) {
119.476 + Collections.addAll(result, buf0);
119.477 + }
119.478 + }
119.479 + Collections.addAll(result, buf);
119.480 + // Signature matching is not the same as type matching, since
119.481 + // one signature might correspond to several types.
119.482 + // So if matchType is a Class or MethodType, refilter the results.
119.483 + if (matchType != null && matchType != matchSig) {
119.484 + for (Iterator<MemberName> it = result.iterator(); it.hasNext();) {
119.485 + MemberName m = it.next();
119.486 + if (!matchType.equals(m.getType()))
119.487 + it.remove();
119.488 + }
119.489 + }
119.490 + return result;
119.491 + }
119.492 + boolean resolveInPlace(MemberName m, boolean searchSupers, Class<?> lookupClass) {
119.493 + MethodHandleNatives.resolve(m, lookupClass);
119.494 + if (m.isResolved()) return true;
119.495 + int matchFlags = m.flags | (searchSupers ? SEARCH_ALL_SUPERS : 0);
119.496 + String matchSig = m.getSignature();
119.497 + MemberName[] buf = { m };
119.498 + int n = MethodHandleNatives.getMembers(m.getDeclaringClass(),
119.499 + m.getName(), matchSig, matchFlags, lookupClass, 0, buf);
119.500 + if (n != 1) return false;
119.501 + return m.isResolved();
119.502 + }
119.503 + public MemberName resolveOrNull(MemberName m, boolean searchSupers, Class<?> lookupClass) {
119.504 + MemberName result = m.clone();
119.505 + if (resolveInPlace(result, searchSupers, lookupClass))
119.506 + return result;
119.507 + return null;
119.508 + }
119.509 + public MemberName resolveOrFail(MemberName m, boolean searchSupers, Class<?> lookupClass) {
119.510 + MemberName result = resolveOrNull(m, searchSupers, lookupClass);
119.511 + if (result != null)
119.512 + return result;
119.513 + throw newNoAccessException(m, lookupClass);
119.514 + }
119.515 + public List<MemberName> getMethods(Class<?> defc, boolean searchSupers,
119.516 + Class<?> lookupClass) {
119.517 + return getMethods(defc, searchSupers, null, null, lookupClass);
119.518 + }
119.519 + public List<MemberName> getMethods(Class<?> defc, boolean searchSupers,
119.520 + String name, MethodType type, Class<?> lookupClass) {
119.521 + int matchFlags = IS_METHOD | (searchSupers ? SEARCH_ALL_SUPERS : 0);
119.522 + return getMembers(defc, name, type, matchFlags, lookupClass);
119.523 + }
119.524 + public List<MemberName> getConstructors(Class<?> defc, Class<?> lookupClass) {
119.525 + return getMembers(defc, null, null, IS_CONSTRUCTOR, lookupClass);
119.526 + }
119.527 + public List<MemberName> getFields(Class<?> defc, boolean searchSupers,
119.528 + Class<?> lookupClass) {
119.529 + return getFields(defc, searchSupers, null, null, lookupClass);
119.530 + }
119.531 + public List<MemberName> getFields(Class<?> defc, boolean searchSupers,
119.532 + String name, Class<?> type, Class<?> lookupClass) {
119.533 + int matchFlags = IS_FIELD | (searchSupers ? SEARCH_ALL_SUPERS : 0);
119.534 + return getMembers(defc, name, type, matchFlags, lookupClass);
119.535 + }
119.536 + public List<MemberName> getNestedTypes(Class<?> defc, boolean searchSupers,
119.537 + Class<?> lookupClass) {
119.538 + int matchFlags = IS_TYPE | (searchSupers ? SEARCH_ALL_SUPERS : 0);
119.539 + return getMembers(defc, null, null, matchFlags, lookupClass);
119.540 + }
119.541 + private static MemberName[] newMemberBuffer(int length) {
119.542 + MemberName[] buf = new MemberName[length];
119.543 + // fill the buffer with dummy structs for the JVM to fill in
119.544 + for (int i = 0; i < length; i++)
119.545 + buf[i] = new MemberName();
119.546 + return buf;
119.547 + }
119.548 + }
119.549 +
119.550 +// static {
119.551 +// System.out.println("Hello world! My methods are:");
119.552 +// System.out.println(Factory.INSTANCE.getMethods(MemberName.class, true, null));
119.553 +// }
119.554 +}
120.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
120.2 +++ b/src/share/classes/sun/dyn/MethodHandleImpl.java Thu May 14 00:17:25 2009 -0700
120.3 @@ -0,0 +1,373 @@
120.4 +/*
120.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
120.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
120.7 + *
120.8 + * This code is free software; you can redistribute it and/or modify it
120.9 + * under the terms of the GNU General Public License version 2 only, as
120.10 + * published by the Free Software Foundation. Sun designates this
120.11 + * particular file as subject to the "Classpath" exception as provided
120.12 + * by Sun in the LICENSE file that accompanied this code.
120.13 + *
120.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
120.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
120.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
120.17 + * version 2 for more details (a copy is included in the LICENSE file that
120.18 + * accompanied this code).
120.19 + *
120.20 + * You should have received a copy of the GNU General Public License version
120.21 + * 2 along with this work; if not, write to the Free Software Foundation,
120.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
120.23 + *
120.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
120.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
120.26 + * have any questions.
120.27 + */
120.28 +
120.29 +package sun.dyn;
120.30 +
120.31 +import java.dyn.MethodHandle;
120.32 +import java.dyn.MethodHandles;
120.33 +import java.dyn.MethodHandles.Lookup;
120.34 +import java.dyn.MethodType;
120.35 +import sun.dyn.util.VerifyType;
120.36 +import java.dyn.NoAccessException;
120.37 +import static sun.dyn.MemberName.newIllegalArgumentException;
120.38 +import static sun.dyn.MemberName.newNoAccessException;
120.39 +
120.40 +/**
120.41 + * Base class for method handles, containing JVM-specific fields and logic.
120.42 + * TO DO: It should not be a base class.
120.43 + * @author jrose
120.44 + */
120.45 +public abstract class MethodHandleImpl {
120.46 +
120.47 + // Fields which really belong in MethodHandle:
120.48 + private byte vmentry; // adapter stub or method entry point
120.49 + //private int vmslots; // optionally, hoist type.form.vmslots
120.50 + protected Object vmtarget; // VM-specific, class-specific target value
120.51 + //MethodType type; // defined in MethodHandle
120.52 +
120.53 + // TO DO: vmtarget should be invisible to Java, since the JVM puts internal
120.54 + // managed pointers into it. Making it visible exposes it to debuggers,
120.55 + // which can cause errors when they treat the pointer as an Object.
120.56 +
120.57 + // These two dummy fields are present to force 'I' and 'J' signatures
120.58 + // into this class's constant pool, so they can be transferred
120.59 + // to vmentry when this class is loaded.
120.60 + static final int INT_FIELD = 0;
120.61 + static final long LONG_FIELD = 0;
120.62 +
120.63 + // type is defined in java.dyn.MethodHandle, which is platform-independent
120.64 +
120.65 + // vmentry (a void* field) is used *only* by by the JVM.
120.66 + // The JVM adjusts its type to int or long depending on system wordsize.
120.67 + // Since it is statically typed as neither int nor long, it is impossible
120.68 + // to use this field from Java bytecode. (Please don't try to, either.)
120.69 +
120.70 + // The vmentry is an assembly-language stub which is jumped to
120.71 + // immediately after the method type is verified.
120.72 + // For a direct MH, this stub loads the vmtarget's entry point
120.73 + // and jumps to it.
120.74 +
120.75 + /**
120.76 + * VM-based method handles must have a security token.
120.77 + * This security token can only be obtained by trusted code.
120.78 + * Do not create method handles directly; use factory methods.
120.79 + */
120.80 + public MethodHandleImpl(Access token) {
120.81 + Access.check(token);
120.82 + }
120.83 +
120.84 + /** Initialize the method type form to participate in JVM calls.
120.85 + * This is done once for each erased type.
120.86 + */
120.87 + public static void init(Access token, MethodType self) {
120.88 + Access.check(token);
120.89 + if (MethodHandleNatives.JVM_SUPPORT)
120.90 + MethodHandleNatives.init(self);
120.91 + }
120.92 +
120.93 + /// Factory methods to create method handles:
120.94 +
120.95 + private static final MemberName.Factory LOOKUP = MemberName.Factory.INSTANCE;
120.96 +
120.97 + static private Lookup IMPL_LOOKUP_INIT;
120.98 +
120.99 + public static void initLookup(Access token, Lookup lookup) {
120.100 + Access.check(token);
120.101 + if (IMPL_LOOKUP_INIT != null || lookup.lookupClass() != null)
120.102 + throw new InternalError();
120.103 + IMPL_LOOKUP_INIT = lookup;
120.104 + }
120.105 +
120.106 + public static Lookup getLookup(Access token) {
120.107 + Access.check(token);
120.108 + return IMPL_LOOKUP;
120.109 + }
120.110 +
120.111 + static {
120.112 + // Force initialization:
120.113 + Lookup.PUBLIC_LOOKUP.lookupClass();
120.114 + if (IMPL_LOOKUP_INIT == null)
120.115 + throw new InternalError();
120.116 + }
120.117 +
120.118 + public static void initStatics() {
120.119 + // Trigger preceding sequence.
120.120 + }
120.121 +
120.122 + /** Shared secret with MethodHandles.Lookup, a copy of Lookup.IMPL_LOOKUP. */
120.123 + static final Lookup IMPL_LOOKUP = IMPL_LOOKUP_INIT;
120.124 +
120.125 +
120.126 + /** Look up a given method.
120.127 + * Callable only from java.dyn and related packages.
120.128 + * <p>
120.129 + * The resulting method handle type will be of the given type,
120.130 + * with a receiver type {@code rcvc} prepended if the member is not static.
120.131 + * <p>
120.132 + * Access checks are made as of the given lookup class.
120.133 + * In particular, if the method is protected and {@code defc} is in a
120.134 + * different package from the lookup class, then {@code rcvc} must be
120.135 + * the lookup class or a subclass.
120.136 + * @param token Proof that the lookup class has access to this package.
120.137 + * @param member Resolved method or constructor to call.
120.138 + * @param name Name of the desired method.
120.139 + * @param rcvc Receiver type of desired non-static method (else null)
120.140 + * @param doDispatch whether the method handle will test the receiver type
120.141 + * @param lookupClass access-check relative to this class
120.142 + * @return a direct handle to the matching method
120.143 + * @throws NoAccessException if the given method cannot be accessed by the lookup class
120.144 + */
120.145 + public static
120.146 + MethodHandle findMethod(Access token, MemberName method,
120.147 + boolean doDispatch, Class<?> lookupClass) {
120.148 + Access.check(token); // only trusted calls
120.149 + MethodType mtype = method.getMethodType();
120.150 + MethodType rtype = mtype;
120.151 + if (method.isStatic()) {
120.152 + doDispatch = false;
120.153 + } else {
120.154 + // adjust the advertised receiver type to be exactly the one requested
120.155 + // (in the case of invokespecial, this will be the calling class)
120.156 + Class<?> recvType = method.getDeclaringClass();
120.157 + mtype = mtype.insertParameterType(0, recvType);
120.158 + if (method.isConstructor())
120.159 + doDispatch = true;
120.160 + // FIXME: JVM has trouble building MH.invoke sites for
120.161 + // classes off the boot class path
120.162 + rtype = mtype;
120.163 + if (recvType.getClassLoader() != null)
120.164 + rtype = rtype.changeParameterType(0, Object.class);
120.165 + }
120.166 + DirectMethodHandle mh = new DirectMethodHandle(mtype, method, doDispatch, lookupClass);
120.167 + if (!mh.isValid())
120.168 + throw newNoAccessException(method, lookupClass);
120.169 + MethodHandle rmh = AdapterMethodHandle.makePairwiseConvert(token, rtype, mh);
120.170 + if (rmh == null) throw new InternalError();
120.171 + return rmh;
120.172 + }
120.173 +
120.174 + public static
120.175 + MethodHandle accessField(Access token,
120.176 + MemberName member, boolean isSetter,
120.177 + Class<?> lookupClass) {
120.178 + Access.check(token);
120.179 + // FIXME: Use sun.misc.Unsafe to dig up the dirt on the field.
120.180 + throw new UnsupportedOperationException("Not yet implemented");
120.181 + }
120.182 +
120.183 + public static
120.184 + MethodHandle accessArrayElement(Access token,
120.185 + Class<?> arrayClass, boolean isSetter) {
120.186 + Access.check(token);
120.187 + if (!arrayClass.isArray())
120.188 + throw newIllegalArgumentException("not an array: "+arrayClass);
120.189 + // FIXME: Use sun.misc.Unsafe to dig up the dirt on the array.
120.190 + throw new UnsupportedOperationException("Not yet implemented");
120.191 + }
120.192 +
120.193 + /** Bind a predetermined first argument to the given direct method handle.
120.194 + * Callable only from MethodHandles.
120.195 + * @param token Proof that the caller has access to this package.
120.196 + * @param target Any direct method handle.
120.197 + * @param receiver Receiver (or first static method argument) to pre-bind.
120.198 + * @return a BoundMethodHandle for the given DirectMethodHandle, or null if it does not exist
120.199 + */
120.200 + public static
120.201 + MethodHandle bindReceiver(Access token,
120.202 + MethodHandle target, Object receiver) {
120.203 + Access.check(token);
120.204 + if (target instanceof AdapterMethodHandle) {
120.205 + Object info = MethodHandleNatives.getTargetInfo(target);
120.206 + if (info instanceof DirectMethodHandle) {
120.207 + DirectMethodHandle dmh = (DirectMethodHandle) info;
120.208 + if (receiver == null ||
120.209 + dmh.type().parameterType(0).isAssignableFrom(receiver.getClass()))
120.210 + target = dmh;
120.211 + }
120.212 + }
120.213 + if (target instanceof DirectMethodHandle)
120.214 + return new BoundMethodHandle((DirectMethodHandle)target, receiver, 0);
120.215 + return null; // let caller try something else
120.216 + }
120.217 +
120.218 + /** Bind a predetermined argument to the given arbitrary method handle.
120.219 + * Callable only from MethodHandles.
120.220 + * @param token Proof that the caller has access to this package.
120.221 + * @param target Any method handle.
120.222 + * @param receiver Argument (which can be a boxed primitive) to pre-bind.
120.223 + * @return a suitable BoundMethodHandle
120.224 + */
120.225 + public static
120.226 + MethodHandle bindArgument(Access token,
120.227 + MethodHandle target, int argnum, Object receiver) {
120.228 + Access.check(token);
120.229 + throw new UnsupportedOperationException("NYI");
120.230 + }
120.231 +
120.232 + public static MethodHandle convertArguments(Access token,
120.233 + MethodHandle target,
120.234 + MethodType newType,
120.235 + MethodType oldType,
120.236 + int[] permutationOrNull) {
120.237 + Access.check(token);
120.238 + MethodHandle res = AdapterMethodHandle.makePairwiseConvert(token, newType, target);
120.239 + if (res != null)
120.240 + return res;
120.241 + int argc = oldType.parameterCount();
120.242 + // The JVM can't do it directly, so fill in the gap with a Java adapter.
120.243 + // TO DO: figure out what to put here from case-by-case experience
120.244 + // Use a heavier method: Convert all the arguments to Object,
120.245 + // then back to the desired types. We might have to use Java-based
120.246 + // method handles to do this.
120.247 + MethodType objType = MethodType.makeGeneric(argc);
120.248 + MethodHandle objTarget = AdapterMethodHandle.makePairwiseConvert(token, objType, target);
120.249 + if (objTarget == null)
120.250 + objTarget = FromGeneric.make(target);
120.251 + res = AdapterMethodHandle.makePairwiseConvert(token, newType, objTarget);
120.252 + if (res != null)
120.253 + return res;
120.254 + return ToGeneric.make(newType, objTarget);
120.255 + }
120.256 +
120.257 + public static MethodHandle spreadArguments(Access token,
120.258 + MethodHandle target,
120.259 + MethodType newType,
120.260 + int spreadArg) {
120.261 + Access.check(token);
120.262 + // TO DO: maybe allow the restarg to be Object and implicitly cast to Object[]
120.263 + MethodType oldType = target.type();
120.264 + // spread the last argument of newType to oldType
120.265 + int spreadCount = oldType.parameterCount() - spreadArg;
120.266 + Class<Object[]> spreadArgType = Object[].class;
120.267 + MethodHandle res = AdapterMethodHandle.makeSpreadArguments(token, newType, target, spreadArgType, spreadArg, spreadCount);
120.268 + if (res != null)
120.269 + return res;
120.270 + // try an intermediate adapter
120.271 + Class<?> spreadType = null;
120.272 + if (spreadArg < 0 || spreadArg >= newType.parameterCount()
120.273 + || !VerifyType.isSpreadArgType(spreadType = newType.parameterType(spreadArg)))
120.274 + throw newIllegalArgumentException("no restarg in "+newType);
120.275 + Class<?>[] ptypes = oldType.parameterArray();
120.276 + for (int i = 0; i < spreadCount; i++)
120.277 + ptypes[spreadArg + i] = VerifyType.spreadArgElementType(spreadType, i);
120.278 + MethodType midType = MethodType.make(newType.returnType(), ptypes);
120.279 + // after spreading, some arguments may need further conversion
120.280 + target = convertArguments(token, target, midType, oldType, null);
120.281 + if (target == null)
120.282 + throw new UnsupportedOperationException("NYI: convert "+midType+" =calls=> "+oldType);
120.283 + res = AdapterMethodHandle.makeSpreadArguments(token, newType, target, spreadArgType, spreadArg, spreadCount);
120.284 + return res;
120.285 + }
120.286 +
120.287 + public static MethodHandle collectArguments(Access token,
120.288 + MethodHandle target,
120.289 + MethodType newType,
120.290 + int collectArg) {
120.291 + if (collectArg > 0)
120.292 + throw new UnsupportedOperationException("NYI");
120.293 + throw new UnsupportedOperationException("NYI");
120.294 + }
120.295 + public static
120.296 + MethodHandle dropArguments(Access token, MethodHandle target,
120.297 + MethodType newType, int argnum) {
120.298 + Access.check(token);
120.299 + throw new UnsupportedOperationException("NYI");
120.300 + }
120.301 +
120.302 + public static
120.303 + MethodHandle makeGuardWithTest(Access token,
120.304 + final MethodHandle test,
120.305 + final MethodHandle target,
120.306 + final MethodHandle fallback) {
120.307 + Access.check(token);
120.308 + // %%% This is just a sketch. It needs to be de-boxed.
120.309 + // Adjust the handles to accept varargs lists.
120.310 + MethodType type = target.type();
120.311 + Class<?> rtype = type.returnType();
120.312 + if (type.parameterCount() != 1 || type.parameterType(0).isPrimitive()) {
120.313 + MethodType vatestType = MethodType.make(boolean.class, Object[].class);
120.314 + MethodType vatargetType = MethodType.make(rtype, Object[].class);
120.315 + MethodHandle vaguard = makeGuardWithTest(token,
120.316 + MethodHandles.spreadArguments(test, vatestType),
120.317 + MethodHandles.spreadArguments(target, vatargetType),
120.318 + MethodHandles.spreadArguments(fallback, vatargetType));
120.319 + return MethodHandles.collectArguments(vaguard, type);
120.320 + }
120.321 + if (rtype.isPrimitive()) {
120.322 + MethodType boxtype = type.changeReturnType(Object.class);
120.323 + MethodHandle boxguard = makeGuardWithTest(token,
120.324 + test,
120.325 + MethodHandles.convertArguments(target, boxtype),
120.326 + MethodHandles.convertArguments(fallback, boxtype));
120.327 + return MethodHandles.convertArguments(boxguard, type);
120.328 + }
120.329 + // Got here? Reduced calling sequence to Object(Object).
120.330 + class Guarder {
120.331 + Object invoke(Object x) {
120.332 + // If javac supports MethodHandle.invoke directly:
120.333 + //z = vatest.invoke<boolean>(arguments);
120.334 + // If javac does not support direct MH.invoke calls:
120.335 + boolean z = (Boolean) MethodHandles.invoke_1(test, x);
120.336 + MethodHandle mh = (z ? target : fallback);
120.337 + return MethodHandles.invoke_1(mh, x);
120.338 + }
120.339 + MethodHandle handle() {
120.340 + MethodType invokeType = MethodType.makeGeneric(0, true);
120.341 + MethodHandle vh = IMPL_LOOKUP.bind(this, "invoke", invokeType);
120.342 + return MethodHandles.collectArguments(vh, target.type());
120.343 + }
120.344 + }
120.345 + return new Guarder().handle();
120.346 + }
120.347 +
120.348 + public static
120.349 + MethodHandle combineArguments(Access token, MethodHandle target, MethodHandle checker, int pos) {
120.350 + Access.check(token);
120.351 + throw new UnsupportedOperationException("Not yet implemented");
120.352 + }
120.353 +
120.354 + protected static String basicToString(MethodHandle target) {
120.355 + MemberName name = null;
120.356 + if (target != null)
120.357 + name = MethodHandleNatives.getMethodName(target);
120.358 + if (name == null)
120.359 + return "<unknown>";
120.360 + return name.getName();
120.361 + }
120.362 +
120.363 + protected static String addTypeString(MethodHandle target, String name) {
120.364 + if (target == null) return name;
120.365 + return name+target.type();
120.366 + }
120.367 + static RuntimeException newIllegalArgumentException(String string) {
120.368 + return new IllegalArgumentException(string);
120.369 + }
120.370 +
120.371 + @Override
120.372 + public String toString() {
120.373 + MethodHandle self = (MethodHandle) this;
120.374 + return addTypeString(self, basicToString(self));
120.375 + }
120.376 +}
121.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
121.2 +++ b/src/share/classes/sun/dyn/MethodHandleNatives.java Thu May 14 00:17:25 2009 -0700
121.3 @@ -0,0 +1,263 @@
121.4 +/*
121.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
121.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
121.7 + *
121.8 + * This code is free software; you can redistribute it and/or modify it
121.9 + * under the terms of the GNU General Public License version 2 only, as
121.10 + * published by the Free Software Foundation. Sun designates this
121.11 + * particular file as subject to the "Classpath" exception as provided
121.12 + * by Sun in the LICENSE file that accompanied this code.
121.13 + *
121.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
121.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
121.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
121.17 + * version 2 for more details (a copy is included in the LICENSE file that
121.18 + * accompanied this code).
121.19 + *
121.20 + * You should have received a copy of the GNU General Public License version
121.21 + * 2 along with this work; if not, write to the Free Software Foundation,
121.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
121.23 + *
121.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
121.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
121.26 + * have any questions.
121.27 + */
121.28 +
121.29 +package sun.dyn;
121.30 +
121.31 +import java.dyn.MethodHandle;
121.32 +import java.dyn.MethodType;
121.33 +import java.lang.reflect.AccessibleObject;
121.34 +import java.lang.reflect.Field;
121.35 +import static sun.dyn.MethodHandleNatives.Constants.*;
121.36 +
121.37 +/**
121.38 + * The JVM interface for the method handles package is all here.
121.39 + * @author jrose
121.40 + */
121.41 +class MethodHandleNatives {
121.42 +
121.43 + private MethodHandleNatives() { } // static only
121.44 +
121.45 + /// MethodName support
121.46 +
121.47 + static native void init(MemberName self, Object ref);
121.48 + static native void expand(MemberName self);
121.49 + static native void resolve(MemberName self, Class<?> caller);
121.50 + static native int getMembers(Class<?> defc, String matchName, String matchSig,
121.51 + int matchFlags, Class<?> caller, int skip, MemberName[] results);
121.52 +
121.53 + /// MethodHandle support
121.54 +
121.55 + /** Initialize the method handle to adapt the call. */
121.56 + static native void init(AdapterMethodHandle self, MethodHandle target, int argnum);
121.57 + /** Initialize the method handle to call the correct method, directly. */
121.58 + static native void init(BoundMethodHandle self, Object target, int argnum);
121.59 + /** Initialize the method handle to call as if by an invoke* instruction. */
121.60 + static native void init(DirectMethodHandle self, Object ref, boolean doDispatch, Class<?> caller);
121.61 +
121.62 + /** Initialize a method type, once per form. */
121.63 + static native void init(MethodType self);
121.64 +
121.65 + /** Tell the JVM that we need to change the target of an invokedynamic. */
121.66 + static native void linkCallSite(CallSiteImpl site, MethodHandle target);
121.67 +
121.68 + /** Fetch the vmtarget field.
121.69 + * It will be sanitized as necessary to avoid exposing non-Java references.
121.70 + * This routine is for debugging and reflection.
121.71 + */
121.72 + static native Object getTarget(MethodHandle self, int format);
121.73 +
121.74 + /** Fetch the name of the handled method, if available.
121.75 + * This routine is for debugging and reflection.
121.76 + */
121.77 + static MemberName getMethodName(MethodHandle self) {
121.78 + if (!JVM_SUPPORT) return null;
121.79 + return (MemberName) getTarget(self, ETF_METHOD_NAME);
121.80 + }
121.81 +
121.82 + /** Fetch the reflective version of the handled method, if available.
121.83 + */
121.84 + static AccessibleObject getTargetMethod(MethodHandle self) {
121.85 + if (!JVM_SUPPORT) return null;
121.86 + return (AccessibleObject) getTarget(self, ETF_REFLECT_METHOD);
121.87 + }
121.88 +
121.89 + /** Fetch the target of this method handle.
121.90 + * If it directly targets a method, return a tuple of method info.
121.91 + * The info is of the form new Object[]{defclass, name, sig, refclass}.
121.92 + * If it is chained to another method handle, return that handle.
121.93 + */
121.94 + static Object getTargetInfo(MethodHandle self) {
121.95 + if (!JVM_SUPPORT) return null;
121.96 + return getTarget(self, ETF_HANDLE_OR_METHOD_NAME);
121.97 + }
121.98 +
121.99 + static Object[] makeTarget(Class<?> defc, String name, String sig, int mods, Class<?> refc) {
121.100 + return new Object[] { defc, name, sig, mods, refc };
121.101 + }
121.102 +
121.103 + /** Fetch MH-related JVM parameter.
121.104 + * which=0 retrieves MethodHandlePushLimit
121.105 + * which=1 retrieves stack slot push size (in address units)
121.106 + */
121.107 + static native int getConstant(int which);
121.108 +
121.109 + /** True iff this HotSpot JVM has built-in support for method handles.
121.110 + * If false, some test cases might run, but functionality will be missing.
121.111 + */
121.112 + public static final boolean JVM_SUPPORT;
121.113 +
121.114 + /** Java copy of MethodHandlePushLimit in range 2..255. */
121.115 + static final int JVM_PUSH_LIMIT;
121.116 + /** JVM stack motion (in words) after one slot is pushed, usually -1.
121.117 + */
121.118 + static final int JVM_STACK_MOVE_UNIT;
121.119 +
121.120 + private static native void registerNatives();
121.121 + static {
121.122 + boolean JVM_SUPPORT_;
121.123 + int JVM_PUSH_LIMIT_;
121.124 + int JVM_STACK_MOVE_UNIT_;
121.125 + try {
121.126 + registerNatives();
121.127 + JVM_SUPPORT_ = true;
121.128 + JVM_PUSH_LIMIT_ = getConstant(Constants.GC_JVM_PUSH_LIMIT);
121.129 + JVM_STACK_MOVE_UNIT_ = getConstant(Constants.GC_JVM_STACK_MOVE_LIMIT);
121.130 + //sun.reflect.Reflection.registerMethodsToFilter(MethodHandleImpl.class, "init");
121.131 + } catch (UnsatisfiedLinkError ee) {
121.132 + // ignore; if we use init() methods later we'll see linkage errors
121.133 + JVM_SUPPORT_ = false;
121.134 + JVM_PUSH_LIMIT_ = 3; // arbitrary
121.135 + JVM_STACK_MOVE_UNIT_ = -1; // arbitrary
121.136 + //System.out.println("Warning: Running with JVM_SUPPORT=false");
121.137 + //System.out.println(ee);
121.138 + JVM_SUPPORT = JVM_SUPPORT_;
121.139 + JVM_PUSH_LIMIT = JVM_PUSH_LIMIT_;
121.140 + JVM_STACK_MOVE_UNIT = JVM_STACK_MOVE_UNIT_;
121.141 + throw ee; // just die; hopeless to try to run with an older JVM
121.142 + }
121.143 + JVM_SUPPORT = JVM_SUPPORT_;
121.144 + JVM_PUSH_LIMIT = JVM_PUSH_LIMIT_;
121.145 + JVM_STACK_MOVE_UNIT = JVM_STACK_MOVE_UNIT_;
121.146 + }
121.147 +
121.148 + // All compile-time constants go here.
121.149 + // There is an opportunity to check them against the JVM's idea of them.
121.150 + static class Constants {
121.151 + Constants() { } // static only
121.152 + // MethodHandleImpl
121.153 + static final int // for getConstant
121.154 + GC_JVM_PUSH_LIMIT = 0,
121.155 + GC_JVM_STACK_MOVE_LIMIT = 1;
121.156 + static final int
121.157 + ETF_HANDLE_OR_METHOD_NAME = 0, // all available data (immediate MH or method)
121.158 + ETF_DIRECT_HANDLE = 1, // ultimate method handle (will be a DMH, may be self)
121.159 + ETF_METHOD_NAME = 2, // ultimate method as MemberName
121.160 + ETF_REFLECT_METHOD = 3; // ultimate method as java.lang.reflect object (sans refClass)
121.161 +
121.162 + // MemberName
121.163 + // The JVM uses values of -2 and above for vtable indexes.
121.164 + // Field values are simple positive offsets.
121.165 + // Ref: src/share/vm/oops/methodOop.hpp
121.166 + // This value is negative enough to avoid such numbers,
121.167 + // but not too negative.
121.168 + static final int
121.169 + MN_IS_METHOD = 0x00010000, // method (not constructor)
121.170 + MN_IS_CONSTRUCTOR = 0x00020000, // constructor
121.171 + MN_IS_FIELD = 0x00040000, // field
121.172 + MN_IS_TYPE = 0x00080000, // nested type
121.173 + MN_SEARCH_SUPERCLASSES = 0x00100000, // for MHN.getMembers
121.174 + MN_SEARCH_INTERFACES = 0x00200000, // for MHN.getMembers
121.175 + VM_INDEX_UNINITIALIZED = -99;
121.176 +
121.177 + // AdapterMethodHandle
121.178 + /** Conversions recognized by the JVM.
121.179 + * They must align with the constants in sun.dyn_AdapterMethodHandle,
121.180 + * in the JVM file hotspot/src/share/vm/classfile/javaClasses.hpp.
121.181 + */
121.182 + static final int
121.183 + OP_RETYPE_ONLY = 0x0, // no argument changes; straight retype
121.184 + OP_CHECK_CAST = 0x1, // ref-to-ref conversion; requires a Class argument
121.185 + OP_PRIM_TO_PRIM = 0x2, // converts from one primitive to another
121.186 + OP_REF_TO_PRIM = 0x3, // unboxes a wrapper to produce a primitive
121.187 + OP_PRIM_TO_REF = 0x4, // boxes a primitive into a wrapper (NYI)
121.188 + OP_SWAP_ARGS = 0x5, // swap arguments (vminfo is 2nd arg)
121.189 + OP_ROT_ARGS = 0x6, // rotate arguments (vminfo is displaced arg)
121.190 + OP_DUP_ARGS = 0x7, // duplicates one or more arguments (at TOS)
121.191 + OP_DROP_ARGS = 0x8, // remove one or more argument slots
121.192 + OP_COLLECT_ARGS = 0x9, // combine one or more arguments into a varargs (NYI)
121.193 + OP_SPREAD_ARGS = 0xA, // expand in place a varargs array (of known size)
121.194 + OP_FLYBY = 0xB, // operate first on reified argument list (NYI)
121.195 + OP_RICOCHET = 0xC, // run an adapter chain on the return value (NYI)
121.196 + CONV_OP_LIMIT = 0xD; // limit of CONV_OP enumeration
121.197 + /** Shift and mask values for decoding the AMH.conversion field.
121.198 + * These numbers are shared with the JVM for creating AMHs.
121.199 + */
121.200 + static final int
121.201 + CONV_OP_MASK = 0xF00, // this nybble contains the conversion op field
121.202 + CONV_VMINFO_MASK = 0x0FF, // LSB is reserved for JVM use
121.203 + CONV_VMINFO_SHIFT = 0, // position of bits in CONV_VMINFO_MASK
121.204 + CONV_OP_SHIFT = 8, // position of bits in CONV_OP_MASK
121.205 + CONV_DEST_TYPE_SHIFT = 12, // byte 2 has the adapter BasicType (if needed)
121.206 + CONV_SRC_TYPE_SHIFT = 16, // byte 2 has the source BasicType (if needed)
121.207 + CONV_STACK_MOVE_SHIFT = 20, // high 12 bits give signed SP change
121.208 + CONV_STACK_MOVE_MASK = (1 << (32 - CONV_STACK_MOVE_SHIFT)) - 1;
121.209 +
121.210 + /** Which conv-ops are implemented by the JVM? */
121.211 + static final int CONV_OP_IMPLEMENTED_MASK =
121.212 + // TODO: The following expression should be replaced by
121.213 + // a JVM query.
121.214 + ((1<<OP_RETYPE_ONLY)
121.215 + |(1<<OP_CHECK_CAST)
121.216 + |(1<<OP_PRIM_TO_PRIM)
121.217 + |(1<<OP_REF_TO_PRIM)
121.218 + |(1<<OP_SWAP_ARGS)
121.219 + |(1<<OP_ROT_ARGS)
121.220 + |(1<<OP_DUP_ARGS)
121.221 + |(1<<OP_DROP_ARGS)
121.222 + );
121.223 +
121.224 + /**
121.225 + * Basic types as encoded in the JVM. These code values are not
121.226 + * intended for use outside this class. They are used as part of
121.227 + * a private interface between the JVM and this class.
121.228 + */
121.229 + static final int
121.230 + T_BOOLEAN = 4,
121.231 + T_CHAR = 5,
121.232 + T_FLOAT = 6,
121.233 + T_DOUBLE = 7,
121.234 + T_BYTE = 8,
121.235 + T_SHORT = 9,
121.236 + T_INT = 10,
121.237 + T_LONG = 11,
121.238 + T_OBJECT = 12,
121.239 + //T_ARRAY = 13
121.240 + T_VOID = 14;
121.241 + //T_ADDRESS = 15
121.242 + }
121.243 +
121.244 + private static native int getNamedCon(int which, Object[] name);
121.245 + static boolean verifyConstants() {
121.246 + Object[] box = { null };
121.247 + for (int i = 0; ; i++) {
121.248 + box[0] = null;
121.249 + int vmval = getNamedCon(i, box);
121.250 + if (box[0] == null) break;
121.251 + String name = (String) box[0];
121.252 + try {
121.253 + Field con = Constants.class.getDeclaredField(name);
121.254 + int jval = con.getInt(null);
121.255 + if (jval != vmval)
121.256 + throw new InternalError(name+": JVM has "+vmval+" while Java has "+jval);
121.257 + } catch (Exception ex) {
121.258 + throw new InternalError(name+": access failed, got "+ex);
121.259 + }
121.260 + }
121.261 + return true;
121.262 + }
121.263 + static {
121.264 + if (JVM_SUPPORT) verifyConstants();
121.265 + }
121.266 +}
122.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
122.2 +++ b/src/share/classes/sun/dyn/MethodTypeImpl.java Thu May 14 00:17:25 2009 -0700
122.3 @@ -0,0 +1,502 @@
122.4 +/*
122.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
122.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
122.7 + *
122.8 + * This code is free software; you can redistribute it and/or modify it
122.9 + * under the terms of the GNU General Public License version 2 only, as
122.10 + * published by the Free Software Foundation. Sun designates this
122.11 + * particular file as subject to the "Classpath" exception as provided
122.12 + * by Sun in the LICENSE file that accompanied this code.
122.13 + *
122.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
122.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
122.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
122.17 + * version 2 for more details (a copy is included in the LICENSE file that
122.18 + * accompanied this code).
122.19 + *
122.20 + * You should have received a copy of the GNU General Public License version
122.21 + * 2 along with this work; if not, write to the Free Software Foundation,
122.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
122.23 + *
122.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
122.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
122.26 + * have any questions.
122.27 + */
122.28 +
122.29 +package sun.dyn;
122.30 +
122.31 +import java.dyn.*;
122.32 +import sun.dyn.util.Wrapper;
122.33 +
122.34 +/**
122.35 + * Shared information for a group of method types, which differ
122.36 + * only by reference types, and therefore share a common erasure
122.37 + * and wrapping.
122.38 + * <p>
122.39 + * For an empirical discussion of the structure of method types,
122.40 + * see <a href="http://groups.google.com/group/jvm-languages/browse_thread/thread/ac9308ae74da9b7e/">
122.41 + * the thread "Avoiding Boxing" on jvm-languages</a>.
122.42 + * There are approximately 2000 distinct erased method types in the JDK.
122.43 + * There are a little over 10 times that number of unerased types.
122.44 + * No more than half of these are likely to be loaded at once.
122.45 + * @author John Rose
122.46 + */
122.47 +public class MethodTypeImpl {
122.48 + final int[] argToSlotTable, slotToArgTable;
122.49 + final long argCounts; // packed slot & value counts
122.50 + final long primCounts; // packed prim & double counts
122.51 + final int vmslots; // total number of parameter slots
122.52 + final MethodType erasedType; // the canonical erasure
122.53 + /*lazy*/ MethodType primsAsBoxes; // replace prims by wrappers
122.54 + /*lazy*/ MethodType primArgsAsBoxes; // wrap args only; make raw return
122.55 + /*lazy*/ MethodType primsAsInts; // replace prims by int/long
122.56 + /*lazy*/ MethodType primsAsLongs; // replace prims by long
122.57 + /*lazy*/ MethodType primsAtEnd; // reorder primitives to the end
122.58 +
122.59 + // Cached adapter information:
122.60 + /*lazy*/ ToGeneric toGeneric; // convert cs. with prims to w/o
122.61 + /*lazy*/ FromGeneric fromGeneric; // convert cs. w/o prims to with
122.62 + /*lazy*/ FilterGeneric filterGeneric; // convert argument(s) on the fly
122.63 + ///*lazy*/ Invokers invokers; // cache of handy higher-order adapters
122.64 +
122.65 + public MethodType erasedType() {
122.66 + return erasedType;
122.67 + }
122.68 +
122.69 + public static MethodTypeImpl of(MethodType type) {
122.70 + return METHOD_TYPE_FRIEND.form(type);
122.71 + }
122.72 +
122.73 + /** Access methods for the internals of MethodType, supplied to
122.74 + * MethodTypeForm as a trusted agent.
122.75 + */
122.76 + static public interface MethodTypeFriend {
122.77 + Class<?>[] ptypes(MethodType mt);
122.78 + MethodTypeImpl form(MethodType mt);
122.79 + void setForm(MethodType mt, MethodTypeImpl form);
122.80 + MethodType makeImpl(Class<?> rtype, Class<?>[] ptypes, boolean trusted);
122.81 + MethodTypeImpl newMethodTypeForm(MethodType mt);
122.82 + Invokers getInvokers(MethodType mt);
122.83 + void setInvokers(MethodType mt, Invokers inv);
122.84 + }
122.85 + public static void setMethodTypeFriend(Access token, MethodTypeFriend am) {
122.86 + Access.check(token);
122.87 + if (METHOD_TYPE_FRIEND != null)
122.88 + throw new InternalError(); // just once
122.89 + METHOD_TYPE_FRIEND = am;
122.90 + }
122.91 + static private MethodTypeFriend METHOD_TYPE_FRIEND;
122.92 +
122.93 + protected MethodTypeImpl(MethodType erasedType) {
122.94 + this.erasedType = erasedType;
122.95 +
122.96 + Class<?>[] ptypes = METHOD_TYPE_FRIEND.ptypes(erasedType);
122.97 + int ptypeCount = ptypes.length;
122.98 + int pslotCount = ptypeCount; // temp. estimate
122.99 + int rtypeCount = 1; // temp. estimate
122.100 + int rslotCount = 1; // temp. estimate
122.101 +
122.102 + int[] argToSlotTab = null, slotToArgTab = null;
122.103 +
122.104 + // Walk the argument types, looking for primitives.
122.105 + int pac = 0, lac = 0, prc = 0, lrc = 0;
122.106 + Class<?> epts[] = ptypes;
122.107 + for (int i = 0; i < epts.length; i++) {
122.108 + Class<?> pt = epts[i];
122.109 + if (pt != Object.class) {
122.110 + assert(pt.isPrimitive());
122.111 + ++pac;
122.112 + if (hasTwoArgSlots(pt)) ++lac;
122.113 + }
122.114 + }
122.115 + pslotCount += lac; // #slots = #args + #longs
122.116 + Class<?> rt = erasedType.returnType();
122.117 + if (rt != Object.class) {
122.118 + ++prc; // even void.class counts as a prim here
122.119 + if (hasTwoArgSlots(rt)) ++lrc;
122.120 + // adjust #slots, #args
122.121 + if (rt == void.class)
122.122 + rtypeCount = rslotCount = 0;
122.123 + else
122.124 + rslotCount += lrc;
122.125 + }
122.126 + if (lac != 0) {
122.127 + int slot = ptypeCount + lac;
122.128 + slotToArgTab = new int[slot+1];
122.129 + argToSlotTab = new int[1+ptypeCount];
122.130 + argToSlotTab[0] = slot; // argument "-1" is past end of slots
122.131 + for (int i = 0; i < epts.length; i++) {
122.132 + Class<?> pt = epts[i];
122.133 + if (hasTwoArgSlots(pt)) --slot;
122.134 + --slot;
122.135 + slotToArgTab[slot] = i+1; // "+1" see argSlotToParameter note
122.136 + argToSlotTab[1+i] = slot;
122.137 + }
122.138 + assert(slot == 0); // filled the table
122.139 + }
122.140 + this.primCounts = pack(lrc, prc, lac, pac);
122.141 + this.argCounts = pack(rslotCount, rtypeCount, pslotCount, ptypeCount);
122.142 + if (slotToArgTab == null) {
122.143 + int slot = ptypeCount; // first arg is deepest in stack
122.144 + slotToArgTab = new int[slot+1];
122.145 + argToSlotTab = new int[1+ptypeCount];
122.146 + argToSlotTab[0] = slot; // argument "-1" is past end of slots
122.147 + for (int i = 0; i < ptypeCount; i++) {
122.148 + --slot;
122.149 + slotToArgTab[slot] = i+1; // "+1" see argSlotToParameter note
122.150 + argToSlotTab[1+i] = slot;
122.151 + }
122.152 + }
122.153 + this.argToSlotTable = argToSlotTab;
122.154 + this.slotToArgTable = slotToArgTab;
122.155 +
122.156 + if (pslotCount >= 256) throw new IllegalArgumentException("too many arguments");
122.157 +
122.158 + // send a few bits down to the JVM:
122.159 + this.vmslots = parameterSlotCount();
122.160 +
122.161 + // short circuit some no-op canonicalizations:
122.162 + if (!hasPrimitives()) {
122.163 + primsAsBoxes = erasedType;
122.164 + primArgsAsBoxes = erasedType;
122.165 + primsAsInts = erasedType;
122.166 + primsAsLongs = erasedType;
122.167 + primsAtEnd = erasedType;
122.168 + }
122.169 + }
122.170 +
122.171 + /** Turn all primitive types to corresponding wrapper types.
122.172 + */
122.173 + public MethodType primsAsBoxes() {
122.174 + MethodType ct = primsAsBoxes;
122.175 + if (ct != null) return ct;
122.176 + MethodType t = erasedType;
122.177 + ct = canonicalize(erasedType, WRAP, WRAP);
122.178 + if (ct == null) ct = t; // no prims to box
122.179 + return primsAsBoxes = ct;
122.180 + }
122.181 +
122.182 + /** Turn all primitive argument types to corresponding wrapper types.
122.183 + * Subword and void return types are promoted to int.
122.184 + */
122.185 + public MethodType primArgsAsBoxes() {
122.186 + MethodType ct = primArgsAsBoxes;
122.187 + if (ct != null) return ct;
122.188 + MethodType t = erasedType;
122.189 + ct = canonicalize(erasedType, RAW_RETURN, WRAP);
122.190 + if (ct == null) ct = t; // no prims to box
122.191 + return primArgsAsBoxes = ct;
122.192 + }
122.193 +
122.194 + /** Turn all primitive types to either int or long.
122.195 + * Floating point return types are not changed, because
122.196 + * they may require special calling sequences.
122.197 + * A void return value is turned to int.
122.198 + */
122.199 + public MethodType primsAsInts() {
122.200 + MethodType ct = primsAsInts;
122.201 + if (ct != null) return ct;
122.202 + MethodType t = erasedType;
122.203 + ct = canonicalize(t, RAW_RETURN, INTS);
122.204 + if (ct == null) ct = t; // no prims to int-ify
122.205 + return primsAsInts = ct;
122.206 + }
122.207 +
122.208 + /** Turn all primitive types to either int or long.
122.209 + * Floating point return types are not changed, because
122.210 + * they may require special calling sequences.
122.211 + * A void return value is turned to int.
122.212 + */
122.213 + public MethodType primsAsLongs() {
122.214 + MethodType ct = primsAsLongs;
122.215 + if (ct != null) return ct;
122.216 + MethodType t = erasedType;
122.217 + ct = canonicalize(t, RAW_RETURN, LONGS);
122.218 + if (ct == null) ct = t; // no prims to int-ify
122.219 + return primsAsLongs = ct;
122.220 + }
122.221 +
122.222 + /** Stably sort parameters into 3 buckets: ref, int, long. */
122.223 + public MethodType primsAtEnd() {
122.224 + MethodType ct = primsAtEnd;
122.225 + if (ct != null) return ct;
122.226 + MethodType t = erasedType;
122.227 +
122.228 + int pac = primitiveParameterCount();
122.229 + if (pac == 0)
122.230 + return primsAtEnd = t;
122.231 +
122.232 + int argc = parameterCount();
122.233 + int lac = longPrimitiveParameterCount();
122.234 + if (pac == argc && (lac == 0 || lac == argc))
122.235 + return primsAtEnd = t;
122.236 +
122.237 + // known to have a mix of 2 or 3 of ref, int, long
122.238 + return primsAtEnd = reorderParameters(t, primsAtEndOrder(t), null);
122.239 +
122.240 + }
122.241 +
122.242 + /** Compute a new ordering of parameters so that all references
122.243 + * are before all ints or longs, and all ints are before all longs.
122.244 + * For this ordering, doubles count as longs, and all other primitive
122.245 + * values count as ints.
122.246 + * As a special case, if the parameters are already in the specified
122.247 + * order, this method returns a null reference, rather than an array
122.248 + * specifying a null permutation.
122.249 + * <p>
122.250 + * For example, the type {@code (int,boolean,int,Object,String)void}
122.251 + * produces the order {@code {3,4,0,1,2}}, the type
122.252 + * {@code (long,int,String)void} produces {@code {2,1,2}}, and
122.253 + * the type {@code (Object,int)Object} produces {@code null}.
122.254 + */
122.255 + public static int[] primsAtEndOrder(MethodType mt) {
122.256 + MethodTypeImpl form = METHOD_TYPE_FRIEND.form(mt);
122.257 + if (form.primsAtEnd == form.erasedType)
122.258 + // quick check shows no reordering is necessary
122.259 + return null;
122.260 +
122.261 + int argc = form.parameterCount();
122.262 + int[] paramOrder = new int[argc];
122.263 +
122.264 + // 3-way bucket sort:
122.265 + int pac = form.primitiveParameterCount();
122.266 + int lac = form.longPrimitiveParameterCount();
122.267 + int rfill = 0, ifill = argc - pac, lfill = argc - lac;
122.268 +
122.269 + Class<?>[] ptypes = METHOD_TYPE_FRIEND.ptypes(mt);
122.270 + boolean changed = false;
122.271 + for (int i = 0; i < ptypes.length; i++) {
122.272 + Class<?> pt = ptypes[i];
122.273 + int ord;
122.274 + if (!pt.isPrimitive()) ord = rfill++;
122.275 + else if (!hasTwoArgSlots(pt)) ord = ifill++;
122.276 + else ord = lfill++;
122.277 + if (ord != i) changed = true;
122.278 + paramOrder[i] = ord;
122.279 + }
122.280 + assert(rfill == argc - pac && ifill == argc - lac && lfill == argc);
122.281 + if (!changed) {
122.282 + form.primsAtEnd = form.erasedType;
122.283 + return null;
122.284 + }
122.285 + return paramOrder;
122.286 + }
122.287 +
122.288 + /** Put the existing parameters of mt into a new order, given by newParamOrder.
122.289 + * The third argument is logically appended to mt.parameterArray,
122.290 + * so that elements of newParamOrder can index either pre-existing or
122.291 + * new parameter types.
122.292 + */
122.293 + public static MethodType reorderParameters(MethodType mt, int[] newParamOrder, Class<?>[] moreParams) {
122.294 + if (newParamOrder == null) return mt; // no-op reordering
122.295 + Class<?>[] ptypes = METHOD_TYPE_FRIEND.ptypes(mt);
122.296 + Class<?>[] ntypes = new Class<?>[newParamOrder.length];
122.297 + int ordMax = ptypes.length + (moreParams == null ? 0 : moreParams.length);
122.298 + boolean changed = (ntypes.length != ptypes.length);
122.299 + for (int i = 0; i < newParamOrder.length; i++) {
122.300 + int ord = newParamOrder[i];
122.301 + if (ord != i) changed = true;
122.302 + Class<?> nt;
122.303 + if (ord < ptypes.length) nt = ptypes[ord];
122.304 + else if (ord == ordMax) nt = mt.returnType();
122.305 + else nt = moreParams[ord - ptypes.length];
122.306 + ntypes[i] = nt;
122.307 + }
122.308 + if (!changed) return mt;
122.309 + return METHOD_TYPE_FRIEND.makeImpl(mt.returnType(), ntypes, true);
122.310 + }
122.311 +
122.312 + private static boolean hasTwoArgSlots(Class<?> type) {
122.313 + return type == long.class || type == double.class;
122.314 + }
122.315 +
122.316 + private static long pack(int a, int b, int c, int d) {
122.317 + assert(((a|b|c|d) & ~0xFFFF) == 0);
122.318 + long hw = ((a << 16) | b), lw = ((c << 16) | d);
122.319 + return (hw << 32) | lw;
122.320 + }
122.321 + private static char unpack(long packed, int word) { // word==0 => return a, ==3 => return d
122.322 + assert(word <= 3);
122.323 + return (char)(packed >> ((3-word) * 16));
122.324 + }
122.325 +
122.326 + public int parameterCount() { // # outgoing values
122.327 + return unpack(argCounts, 3);
122.328 + }
122.329 + public int parameterSlotCount() { // # outgoing interpreter slots
122.330 + return unpack(argCounts, 2);
122.331 + }
122.332 + public int returnCount() { // = 0 (V), or 1
122.333 + return unpack(argCounts, 1);
122.334 + }
122.335 + public int returnSlotCount() { // = 0 (V), 2 (J/D), or 1
122.336 + return unpack(argCounts, 0);
122.337 + }
122.338 + public int primitiveParameterCount() {
122.339 + return unpack(primCounts, 3);
122.340 + }
122.341 + public int longPrimitiveParameterCount() {
122.342 + return unpack(primCounts, 2);
122.343 + }
122.344 + public int primitiveReturnCount() { // = 0 (obj), or 1
122.345 + return unpack(primCounts, 1);
122.346 + }
122.347 + public int longPrimitiveReturnCount() { // = 1 (J/D), or 0
122.348 + return unpack(primCounts, 0);
122.349 + }
122.350 + public boolean hasPrimitives() {
122.351 + return primCounts != 0;
122.352 + }
122.353 +// public boolean hasNonVoidPrimitives() {
122.354 +// if (primCounts == 0) return false;
122.355 +// if (primitiveParameterCount() != 0) return true;
122.356 +// return (primitiveReturnCount() != 0 && returnCount() != 0);
122.357 +// }
122.358 + public boolean hasLongPrimitives() {
122.359 + return (longPrimitiveParameterCount() | longPrimitiveReturnCount()) != 0;
122.360 + }
122.361 + public int parameterToArgSlot(int i) {
122.362 + return argToSlotTable[1+i];
122.363 + }
122.364 + public int argSlotToParameter(int argSlot) {
122.365 + // Note: Empty slots are represented by zero in this table.
122.366 + // Valid arguments slots contain incremented entries, so as to be non-zero.
122.367 + // We return -1 the caller to mean an empty slot.
122.368 + return slotToArgTable[argSlot] - 1;
122.369 + }
122.370 +
122.371 + public static void initForm(Access token, MethodType mt) {
122.372 + Access.check(token);
122.373 + MethodTypeImpl form = findForm(mt);
122.374 + METHOD_TYPE_FRIEND.setForm(mt, form);
122.375 + if (form.erasedType == mt) {
122.376 + // This is a principal (erased) type; show it to the JVM.
122.377 + MethodHandleImpl.init(token, mt);
122.378 + }
122.379 + }
122.380 +
122.381 + static MethodTypeImpl findForm(MethodType mt) {
122.382 + MethodType erased = canonicalize(mt, ERASE, ERASE);
122.383 + if (erased == null) {
122.384 + // It is already erased. Make a new MethodTypeForm.
122.385 + return METHOD_TYPE_FRIEND.newMethodTypeForm(mt);
122.386 + } else {
122.387 + // Share the MethodTypeForm with the erased version.
122.388 + return METHOD_TYPE_FRIEND.form(erased);
122.389 + }
122.390 + }
122.391 +
122.392 + /** Codes for {@link #canonicalize(java.lang.Class, int).
122.393 + * ERASE means change every reference to {@code Object}.
122.394 + * WRAP means convert primitives (including {@code void} to their
122.395 + * corresponding wrapper types. UNWRAP means the reverse of WRAP.
122.396 + * INTS means convert all non-void primitive types to int or long,
122.397 + * according to size. LONGS means convert all non-void primitives
122.398 + * to long, regardless of size. RAW_RETURN means convert a type
122.399 + * (assumed to be a return type) to int if it is smaller than an int,
122.400 + * or if it is void.
122.401 + */
122.402 + public static final int NO_CHANGE = 0, ERASE = 1, WRAP = 2, UNWRAP = 3, INTS = 4, LONGS = 5, RAW_RETURN = 6;
122.403 +
122.404 + /** Canonicalize the types in the given method type.
122.405 + * If any types change, intern the new type, and return it.
122.406 + * Otherwise return null.
122.407 + */
122.408 + public static MethodType canonicalize(MethodType mt, int howRet, int howArgs) {
122.409 + Class<?>[] ptypes = METHOD_TYPE_FRIEND.ptypes(mt);
122.410 + Class<?>[] ptc = MethodTypeImpl.canonicalizes(ptypes, howArgs);
122.411 + Class<?> rtype = mt.returnType();
122.412 + Class<?> rtc = MethodTypeImpl.canonicalize(rtype, howRet);
122.413 + if (ptc == null && rtc == null) {
122.414 + // It is already canonical.
122.415 + return null;
122.416 + }
122.417 + // Find the erased version of the method type:
122.418 + if (rtc == null) rtc = rtype;
122.419 + if (ptc == null) ptc = ptypes;
122.420 + return METHOD_TYPE_FRIEND.makeImpl(rtc, ptc, true);
122.421 + }
122.422 +
122.423 + /** Canonicalize the given return or param type.
122.424 + * Return null if the type is already canonicalized.
122.425 + */
122.426 + static Class<?> canonicalize(Class<?> t, int how) {
122.427 + Class<?> ct;
122.428 + if (t == Object.class) {
122.429 + // no change, ever
122.430 + } else if (!t.isPrimitive()) {
122.431 + switch (how) {
122.432 + case UNWRAP:
122.433 + ct = Wrapper.asPrimitiveType(t);
122.434 + if (ct != t) return ct;
122.435 + break;
122.436 + case RAW_RETURN:
122.437 + case ERASE:
122.438 + return Object.class;
122.439 + }
122.440 + } else if (t == void.class) {
122.441 + // no change, usually
122.442 + switch (how) {
122.443 + case RAW_RETURN:
122.444 + return int.class;
122.445 + case WRAP:
122.446 + return Void.class;
122.447 + }
122.448 + } else {
122.449 + // non-void primitive
122.450 + switch (how) {
122.451 + case WRAP:
122.452 + return Wrapper.asWrapperType(t);
122.453 + case INTS:
122.454 + if (t == int.class || t == long.class)
122.455 + return null; // no change
122.456 + if (t == double.class)
122.457 + return long.class;
122.458 + return int.class;
122.459 + case LONGS:
122.460 + if (t == long.class)
122.461 + return null; // no change
122.462 + return long.class;
122.463 + case RAW_RETURN:
122.464 + if (t == int.class || t == long.class ||
122.465 + t == float.class || t == double.class)
122.466 + return null; // no change
122.467 + // everything else returns as an int
122.468 + return int.class;
122.469 + }
122.470 + }
122.471 + // no change; return null to signify
122.472 + return null;
122.473 + }
122.474 +
122.475 + /** Canonicalize each param type in the given array.
122.476 + * Return null if all types are already canonicalized.
122.477 + */
122.478 + static Class<?>[] canonicalizes(Class<?>[] ts, int how) {
122.479 + Class<?>[] cs = null;
122.480 + for (int imax = ts.length, i = 0; i < imax; i++) {
122.481 + Class<?> c = canonicalize(ts[i], how);
122.482 + if (c != null) {
122.483 + if (cs == null)
122.484 + cs = ts.clone();
122.485 + cs[i] = c;
122.486 + }
122.487 + }
122.488 + return cs;
122.489 + }
122.490 +
122.491 + public static Invokers invokers(Access token, MethodType type) {
122.492 + Access.check(token);
122.493 + Invokers inv = METHOD_TYPE_FRIEND.getInvokers(type);
122.494 + if (inv != null) return inv;
122.495 + inv = new Invokers(token, type);
122.496 + METHOD_TYPE_FRIEND.setInvokers(type, inv);
122.497 + return inv;
122.498 + }
122.499 +
122.500 + @Override
122.501 + public String toString() {
122.502 + return "Form"+erasedType;
122.503 + }
122.504 +
122.505 +}
123.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
123.2 +++ b/src/share/classes/sun/dyn/ToGeneric.java Thu May 14 00:17:25 2009 -0700
123.3 @@ -0,0 +1,1018 @@
123.4 +/*
123.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
123.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
123.7 + *
123.8 + * This code is free software; you can redistribute it and/or modify it
123.9 + * under the terms of the GNU General Public License version 2 only, as
123.10 + * published by the Free Software Foundation. Sun designates this
123.11 + * particular file as subject to the "Classpath" exception as provided
123.12 + * by Sun in the LICENSE file that accompanied this code.
123.13 + *
123.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
123.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
123.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
123.17 + * version 2 for more details (a copy is included in the LICENSE file that
123.18 + * accompanied this code).
123.19 + *
123.20 + * You should have received a copy of the GNU General Public License version
123.21 + * 2 along with this work; if not, write to the Free Software Foundation,
123.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
123.23 + *
123.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
123.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
123.26 + * have any questions.
123.27 + */
123.28 +
123.29 +package sun.dyn;
123.30 +
123.31 +import java.dyn.JavaMethodHandle;
123.32 +import java.dyn.MethodHandle;
123.33 +import java.dyn.MethodHandles;
123.34 +import java.dyn.MethodType;
123.35 +import java.dyn.NoAccessException;
123.36 +import java.lang.reflect.Constructor;
123.37 +import java.lang.reflect.InvocationTargetException;
123.38 +import sun.dyn.util.ValueConversions;
123.39 +import sun.dyn.util.Wrapper;
123.40 +
123.41 +/**
123.42 + * Adapters which mediate between incoming calls which are not generic
123.43 + * and outgoing calls which are. Any call can be represented generically
123.44 + * boxing up its arguments, and (on return) unboxing the return value.
123.45 + * <p>
123.46 + * A call is "generic" (in MethodHandle terms) if its MethodType features
123.47 + * only Object arguments. A non-generic call therefore features
123.48 + * primitives and/or reference types other than Object.
123.49 + * An adapter has types for its incoming and outgoing calls.
123.50 + * The incoming call type is simply determined by the adapter's type
123.51 + * (the MethodType it presents to callers). The outgoing call type
123.52 + * is determined by the adapter's target (a MethodHandle that the adapter
123.53 + * either binds internally or else takes as a leading argument).
123.54 + * (To stretch the term, adapter-like method handles may have multiple
123.55 + * targets or be polymorphic across multiple call types.)
123.56 + * @author jrose
123.57 + */
123.58 +class ToGeneric {
123.59 + // type for the incoming call (may be erased)
123.60 + private final MethodType entryType;
123.61 + // incoming type with primitives moved to the end and turned to int/long
123.62 + private final MethodType rawEntryType;
123.63 + // adapter for the erased type
123.64 + private final Adapter adapter;
123.65 + // entry point for adapter (Adapter mh, a...) => ...
123.66 + private final MethodHandle entryPoint;
123.67 + // permutation of arguments for primsAtEndType
123.68 + private final int[] primsAtEndOrder;
123.69 + // optional final argument list conversions (at least, invokes the target)
123.70 + private final MethodHandle invoker;
123.71 + // conversion which unboxes a primitive return value
123.72 + private final MethodHandle returnConversion;
123.73 +
123.74 + /** Compute and cache information common to all collecting adapters
123.75 + * that implement members of the erasure-family of the given erased type.
123.76 + */
123.77 + private ToGeneric(MethodType entryType) {
123.78 + assert(entryType.erase() == entryType); // for now
123.79 + // incoming call will first "forget" all reference types except Object
123.80 + this.entryType = entryType;
123.81 + MethodHandle invoker0 = MethodHandles.exactInvoker(entryType.generic());
123.82 + MethodType rawEntryTypeInit;
123.83 + Adapter ad = findAdapter(rawEntryTypeInit = entryType);
123.84 + if (ad != null) {
123.85 + // Immediate hit to exactly the adapter we want,
123.86 + // with no monkeying around with primitive types.
123.87 + this.returnConversion = computeReturnConversion(entryType, rawEntryTypeInit, false);
123.88 + this.rawEntryType = rawEntryTypeInit;
123.89 + this.adapter = ad;
123.90 + this.entryPoint = ad.prototypeEntryPoint();
123.91 + this.primsAtEndOrder = null;
123.92 + this.invoker = invoker0;
123.93 + return;
123.94 + }
123.95 +
123.96 + // next, it will reorder primitives after references
123.97 + MethodType primsAtEnd = MethodTypeImpl.of(entryType).primsAtEnd();
123.98 + // at the same time, it will "forget" all primitive types except int/long
123.99 + this.primsAtEndOrder = MethodTypeImpl.primsAtEndOrder(entryType);
123.100 + if (primsAtEndOrder != null) {
123.101 + // reordering is required; build on top of a simpler ToGeneric
123.102 + ToGeneric va2 = ToGeneric.of(primsAtEnd);
123.103 + this.adapter = va2.adapter;
123.104 + this.entryPoint = MethodHandleImpl.convertArguments(Access.TOKEN,
123.105 + va2.entryPoint, primsAtEnd, entryType, primsAtEndOrder);
123.106 + // example: for entryType of (int,Object,Object), the reordered
123.107 + // type is (Object,Object,int) and the order is {1,2,0},
123.108 + // and putPAE is (mh,int0,obj1,obj2) => mh.invoke(obj1,obj2,int0)
123.109 + if (true) throw new UnsupportedOperationException("NYI");
123.110 + return;
123.111 + }
123.112 +
123.113 + // after any needed argument reordering, it will reinterpret
123.114 + // primitive arguments according to their "raw" types int/long
123.115 + MethodType intsAtEnd = MethodTypeImpl.of(primsAtEnd).primsAsInts();
123.116 + ad = findAdapter(rawEntryTypeInit = intsAtEnd);
123.117 + if (ad == null) {
123.118 + // Perhaps the adapter is available only for longs.
123.119 + // If so, we can use it, but there will have to be a little
123.120 + // more stack motion on each call.
123.121 + MethodType longsAtEnd = MethodTypeImpl.of(primsAtEnd).primsAsLongs();
123.122 + ad = findAdapter(rawEntryTypeInit = longsAtEnd);
123.123 + if (ad == null) {
123.124 + // If there is no statically compiled adapter,
123.125 + // build one by means of dynamic bytecode generation.
123.126 + ad = buildAdapterFromBytecodes(rawEntryTypeInit = intsAtEnd);
123.127 + }
123.128 + }
123.129 + MethodHandle rawEntryPoint = ad.prototypeEntryPoint();
123.130 + MethodType tepType = entryType.insertParameterType(0, ad.getClass());
123.131 + this.entryPoint =
123.132 + AdapterMethodHandle.makeRawRetypeOnly(Access.TOKEN, tepType, rawEntryPoint);
123.133 + if (this.entryPoint == null)
123.134 + throw new UnsupportedOperationException("cannot retype to "+entryType
123.135 + +" from "+rawEntryPoint.type().dropParameterType(0));
123.136 + this.returnConversion = computeReturnConversion(entryType, rawEntryTypeInit, false);
123.137 + this.rawEntryType = rawEntryTypeInit;
123.138 + this.adapter = ad;
123.139 + this.invoker = makeRawArgumentFilter(invoker0,
123.140 + rawEntryPoint.type().dropParameterType(0), entryType);
123.141 + }
123.142 +
123.143 + /** A generic argument list will be created by a call of type 'raw'.
123.144 + * The values need to be reboxed for to match 'cooked'.
123.145 + * Do this on the fly.
123.146 + */
123.147 + // TO DO: Use a generic argument converter in a different file
123.148 + static MethodHandle makeRawArgumentFilter(MethodHandle invoker,
123.149 + MethodType raw, MethodType cooked) {
123.150 + MethodHandle filteredInvoker = null;
123.151 + for (int i = 0, nargs = raw.parameterCount(); i < nargs; i++) {
123.152 + Class<?> src = raw.parameterType(i);
123.153 + Class<?> dst = cooked.parameterType(i);
123.154 + if (src == dst) continue;
123.155 + assert(src.isPrimitive() && dst.isPrimitive());
123.156 + if (filteredInvoker == null) {
123.157 + filteredInvoker =
123.158 + AdapterMethodHandle.makeCheckCast(Access.TOKEN,
123.159 + invoker.type().generic(), invoker, 0, MethodHandle.class);
123.160 + if (filteredInvoker == null) throw new UnsupportedOperationException("NYI");
123.161 + }
123.162 + MethodHandle reboxer = ValueConversions.rebox(dst, false);
123.163 + FilterGeneric gen = new FilterGeneric(filteredInvoker.type(), (short)(1+i), (short)1, 'R');
123.164 + filteredInvoker = gen.makeInstance(reboxer, filteredInvoker);
123.165 + }
123.166 + if (filteredInvoker == null) return invoker;
123.167 + return AdapterMethodHandle.makeRetypeOnly(Access.TOKEN, invoker.type(), filteredInvoker);
123.168 + }
123.169 +
123.170 + /**
123.171 + * Caller will be expecting a result from a call to {@code type},
123.172 + * while the internal adapter entry point is rawEntryType.
123.173 + * Also, the internal target method will be returning a boxed value,
123.174 + * as an untyped object.
123.175 + * <p>
123.176 + * Produce a value converter which will be typed to convert from
123.177 + * {@code Object} to the return value of {@code rawEntryType}, and will
123.178 + * in fact ensure that the value is compatible with the return type of
123.179 + * {@code type}.
123.180 + */
123.181 + private static MethodHandle computeReturnConversion(
123.182 + MethodType type, MethodType rawEntryType, boolean mustCast) {
123.183 + Class<?> tret = type.returnType();
123.184 + Class<?> rret = rawEntryType.returnType();
123.185 + if (mustCast || !tret.isPrimitive()) {
123.186 + assert(!tret.isPrimitive());
123.187 + assert(!rret.isPrimitive());
123.188 + if (rret == Object.class && !mustCast)
123.189 + return null;
123.190 + return ValueConversions.cast(tret, false);
123.191 + } else if (tret == rret) {
123.192 + return ValueConversions.unbox(tret, false);
123.193 + } else {
123.194 + assert(rret.isPrimitive());
123.195 + assert(tret == double.class ? rret == long.class : rret == int.class);
123.196 + return ValueConversions.unboxRaw(tret, false);
123.197 + }
123.198 + }
123.199 +
123.200 + Adapter makeInstance(MethodType type, MethodHandle genericTarget) {
123.201 + genericTarget.getClass(); // check for NPE
123.202 + MethodHandle convert = returnConversion;
123.203 + if (primsAtEndOrder != null)
123.204 + // reorder arguments passed to genericTarget, if primsAtEndOrder
123.205 + throw new UnsupportedOperationException("NYI");
123.206 + if (type == entryType) {
123.207 + if (convert == null) convert = ValueConversions.identity();
123.208 + return adapter.makeInstance(entryPoint, invoker, convert, genericTarget);
123.209 + }
123.210 + // my erased-type is not exactly the same as the desired type
123.211 + assert(type.erase() == entryType); // else we are busted
123.212 + if (convert == null)
123.213 + convert = computeReturnConversion(type, rawEntryType, true);
123.214 + // retype erased reference arguments (the cast makes it safe to do this)
123.215 + MethodType tepType = type.insertParameterType(0, adapter.getClass());
123.216 + MethodHandle typedEntryPoint =
123.217 + AdapterMethodHandle.makeRawRetypeOnly(Access.TOKEN, tepType, entryPoint);
123.218 + return adapter.makeInstance(typedEntryPoint, invoker, convert, genericTarget);
123.219 + }
123.220 +
123.221 + /** Build an adapter of the given type, which invokes genericTarget
123.222 + * on the incoming arguments, after boxing as necessary.
123.223 + * The return value is unboxed if necessary.
123.224 + * @param type the required type of the
123.225 + * @param genericTarget the target, which must accept and return only Object values
123.226 + * @return an adapter method handle
123.227 + */
123.228 + public static MethodHandle make(MethodType type, MethodHandle genericTarget) {
123.229 + MethodType gtype = genericTarget.type();
123.230 + if (type.generic() != gtype)
123.231 + throw new IllegalArgumentException();
123.232 + if (type == gtype) return genericTarget;
123.233 + return ToGeneric.of(type).makeInstance(type, genericTarget);
123.234 + }
123.235 +
123.236 + /** Return the adapter information for this type's erasure. */
123.237 + static ToGeneric of(MethodType type) {
123.238 + MethodTypeImpl form = MethodTypeImpl.of(type);
123.239 + ToGeneric toGen = form.toGeneric;
123.240 + if (toGen == null)
123.241 + form.toGeneric = toGen = new ToGeneric(form.erasedType());
123.242 + return toGen;
123.243 + }
123.244 +
123.245 + public String toString() {
123.246 + return "ToGeneric"+entryType
123.247 + +(primsAtEndOrder!=null?"[reorder]":"");
123.248 + }
123.249 +
123.250 + /* Create an adapter for the given incoming call type. */
123.251 + static Adapter findAdapter(MethodType entryPointType) {
123.252 + MethodTypeImpl form = MethodTypeImpl.of(entryPointType);
123.253 + Class<?> rtype = entryPointType.returnType();
123.254 + int argc = form.parameterCount();
123.255 + int lac = form.longPrimitiveParameterCount();
123.256 + int iac = form.primitiveParameterCount() - lac;
123.257 + String intsAndLongs = (iac > 0 ? "I"+iac : "")+(lac > 0 ? "J"+lac : "");
123.258 + String rawReturn = String.valueOf(Wrapper.forPrimitiveType(rtype).basicTypeChar());
123.259 + String iname0 = "invoke_"+rawReturn;
123.260 + String iname1 = "invoke";
123.261 + String[] inames = { iname0, iname1 };
123.262 + String cname0 = rawReturn + argc;
123.263 + String cname1 = "A" + argc;
123.264 + String[] cnames = { cname1, cname1+intsAndLongs, cname0, cname0+intsAndLongs };
123.265 + // e.g., D5I2, D5, L5I2, L5
123.266 + for (String cname : cnames) {
123.267 + Class<? extends Adapter> acls = Adapter.findSubClass(cname);
123.268 + if (acls == null) continue;
123.269 + // see if it has the required invoke method
123.270 + for (String iname : inames) {
123.271 + MethodHandle entryPoint = null;
123.272 + try {
123.273 + entryPoint = MethodHandleImpl.IMPL_LOOKUP.
123.274 + findSpecial(acls, iname, entryPointType, acls);
123.275 + } catch (NoAccessException ex) {
123.276 + }
123.277 + if (entryPoint == null) continue;
123.278 + Constructor<? extends Adapter> ctor = null;
123.279 + try {
123.280 + // Prototype builder:
123.281 + ctor = acls.getDeclaredConstructor(MethodHandle.class);
123.282 + } catch (NoSuchMethodException ex) {
123.283 + } catch (SecurityException ex) {
123.284 + }
123.285 + if (ctor == null) continue;
123.286 + try {
123.287 + return ctor.newInstance(entryPoint);
123.288 + } catch (IllegalArgumentException ex) {
123.289 + } catch (InvocationTargetException ex) {
123.290 + } catch (InstantiationException ex) {
123.291 + } catch (IllegalAccessException ex) {
123.292 + }
123.293 + }
123.294 + }
123.295 + return null;
123.296 + }
123.297 +
123.298 + static Adapter buildAdapterFromBytecodes(MethodType entryPointType) {
123.299 + throw new UnsupportedOperationException("NYI");
123.300 + }
123.301 +
123.302 + /**
123.303 + * The invoke method takes some particular but unconstrained spread
123.304 + * of raw argument types, and returns a raw return type (in L/I/J/F/D).
123.305 + * Internally, it converts the incoming arguments uniformly into objects.
123.306 + * This series of objects is then passed to the {@code target} method,
123.307 + * which returns a result object. This result is finally converted,
123.308 + * via another method handle {@code convert}, which is responsible for
123.309 + * converting the object result into the raw return value.
123.310 + */
123.311 + static abstract class Adapter extends JavaMethodHandle {
123.312 + /*
123.313 + * class X<<R,A...>> extends Adapter {
123.314 + * Object...=>Object target;
123.315 + * Object=>R convert;
123.316 + * R invoke(A... a...) = convert(invoker(target, a...)))
123.317 + * }
123.318 + */
123.319 + protected final MethodHandle invoker; // (MH, Object...) -> Object
123.320 + protected final MethodHandle target; // Object... -> Object
123.321 + protected final MethodHandle convert; // Object -> R
123.322 +
123.323 + protected boolean isPrototype() { return target == null; }
123.324 + /* Prototype constructor. */
123.325 + protected Adapter(MethodHandle entryPoint) {
123.326 + super(entryPoint);
123.327 + this.invoker = null;
123.328 + this.convert = entryPoint;
123.329 + this.target = null;
123.330 + assert(isPrototype());
123.331 + }
123.332 + protected MethodHandle prototypeEntryPoint() {
123.333 + if (!isPrototype()) throw new InternalError();
123.334 + return convert;
123.335 + }
123.336 +
123.337 + protected Adapter(MethodHandle entryPoint, MethodHandle invoker, MethodHandle convert, MethodHandle target) {
123.338 + super(entryPoint);
123.339 + this.invoker = invoker;
123.340 + this.convert = convert;
123.341 + this.target = target;
123.342 + }
123.343 +
123.344 + /** Make a copy of self, with new fields. */
123.345 + protected abstract Adapter makeInstance(MethodHandle entryPoint,
123.346 + MethodHandle invoker, MethodHandle convert, MethodHandle target);
123.347 + // { return new ThisType(entryPoint, convert, target); }
123.348 +
123.349 + // Code to run when the arguments (<= 4) have all been boxed.
123.350 + protected Object target() { return invoker.<Object>invoke(target); }
123.351 + protected Object target(Object a0) { return invoker.<Object>invoke(target, a0); }
123.352 + protected Object target(Object a0, Object a1)
123.353 + { return invoker.<Object>invoke(target, a0, a1); }
123.354 + protected Object target(Object a0, Object a1, Object a2)
123.355 + { return invoker.<Object>invoke(target, a0, a1, a2); }
123.356 + protected Object target(Object a0, Object a1, Object a2, Object a3)
123.357 + { return invoker.<Object>invoke(target, a0, a1, a2, a3); }
123.358 + /*
123.359 + protected Object target_0(Object... av) { return invoker.<Object>invoke(target, av); }
123.360 + protected Object target_1(Object a0, Object... av)
123.361 + { return invoker.<Object>invoke(target, a0, (Object)av); }
123.362 + protected Object target_2(Object a0, Object a1, Object... av)
123.363 + { return invoker.<Object>invoke(target, a0, a1, (Object)av); }
123.364 + protected Object target_3(Object a0, Object a1, Object a2, Object... av)
123.365 + { return invoker.<Object>invoke(target, a0, a1, a2, (Object)av); }
123.366 + protected Object target_4(Object a0, Object a1, Object a2, Object a3, Object... av)
123.367 + { return invoker.<Object>invoke(target, a0, a1, a2, a3, (Object)av); }
123.368 + // */
123.369 + // (For more than 4 arguments, generate the code in the adapter itself.)
123.370 +
123.371 + // Code to run when the generic target has finished and produced a value.
123.372 + protected Object return_L(Object res) { return convert.<Object>invoke(res); }
123.373 + protected int return_I(Object res) { return convert.<int >invoke(res); }
123.374 + protected long return_J(Object res) { return convert.<long >invoke(res); }
123.375 + protected float return_F(Object res) { return convert.<float >invoke(res); }
123.376 + protected double return_D(Object res) { return convert.<double>invoke(res); }
123.377 +
123.378 + static private final String CLASS_PREFIX; // "sun.dyn.ToGeneric$"
123.379 + static {
123.380 + String aname = Adapter.class.getName();
123.381 + String sname = Adapter.class.getSimpleName();
123.382 + if (!aname.endsWith(sname)) throw new InternalError();
123.383 + CLASS_PREFIX = aname.substring(0, aname.length() - sname.length());
123.384 + }
123.385 + /** Find a sibing class of Adapter. */
123.386 + static Class<? extends Adapter> findSubClass(String name) {
123.387 + String cname = Adapter.CLASS_PREFIX + name;
123.388 + try {
123.389 + return Class.forName(cname).asSubclass(Adapter.class);
123.390 + } catch (ClassNotFoundException ex) {
123.391 + return null;
123.392 + } catch (ClassCastException ex) {
123.393 + return null;
123.394 + }
123.395 + }
123.396 + }
123.397 +
123.398 + /* generated classes follow this pattern:
123.399 + static class A1 extends Adapter {
123.400 + protected A1(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.401 + protected A1(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.402 + protected A1 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A1(e, i, c, t); }
123.403 + protected Object target(Object a0) { return invoker.<Object>invoke(target, a0); }
123.404 + protected Object targetA1(Object a0) { return target(a0); }
123.405 + protected Object targetA1(int a0) { return target(a0); }
123.406 + protected Object targetA1(long a0) { return target(a0); }
123.407 + protected Object invoke_L(Object a0) { return return_L(targetA1(a0)); }
123.408 + protected int invoke_I(Object a0) { return return_I(targetA1(a0)); }
123.409 + protected long invoke_J(Object a0) { return return_J(targetA1(a0)); }
123.410 + protected float invoke_F(Object a0) { return return_F(targetA1(a0)); }
123.411 + protected double invoke_D(Object a0) { return return_D(targetA1(a0)); }
123.412 + protected Object invoke_L(int a0) { return return_L(targetA1(a0)); }
123.413 + protected int invoke_I(int a0) { return return_I(targetA1(a0)); }
123.414 + protected long invoke_J(int a0) { return return_J(targetA1(a0)); }
123.415 + protected float invoke_F(int a0) { return return_F(targetA1(a0)); }
123.416 + protected double invoke_D(int a0) { return return_D(targetA1(a0)); }
123.417 + protected Object invoke_L(long a0) { return return_L(targetA1(a0)); }
123.418 + protected int invoke_I(long a0) { return return_I(targetA1(a0)); }
123.419 + protected long invoke_J(long a0) { return return_J(targetA1(a0)); }
123.420 + protected float invoke_F(long a0) { return return_F(targetA1(a0)); }
123.421 + protected double invoke_D(long a0) { return return_D(targetA1(a0)); }
123.422 + }
123.423 + // */
123.424 +
123.425 +/*
123.426 +: SHELL; n=ToGeneric; cp -p $n.java $n.java-; sed < $n.java- > $n.java+ -e '/{{*{{/,/}}*}}/w /tmp/genclasses.java' -e '/}}*}}/q'; (cd /tmp; javac -d . genclasses.java; java -cp . genclasses) >> $n.java+; echo '}' >> $n.java+; mv $n.java+ $n.java; mv $n.java- $n.java~
123.427 +//{{{
123.428 +import java.util.*;
123.429 +class genclasses {
123.430 + static String[] TYPES = { "Object", "int ", "long ", "float ", "double" };
123.431 + static String[] TCHARS = { "L", "I", "J", "F", "D", "A" };
123.432 + static String[][] TEMPLATES = { {
123.433 + "@for@ arity=0..3 rcat<=4 nrefs<=99 nints<=99 nlongs<=99",
123.434 + "@for@ arity=4..5 rcat<=2 nrefs<=99 nints<=99 nlongs<=99",
123.435 + "@for@ arity=6..10 rcat<=2 nrefs<=99 nints=0 nlongs<=99",
123.436 + " //@each-cat@",
123.437 + " static class @cat@ extends Adapter {",
123.438 + " protected @cat@(MethodHandle entryPoint) { super(entryPoint); } // to build prototype",
123.439 + " protected @cat@(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }",
123.440 + " protected @cat@ makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new @cat@(e, i, c, t); }",
123.441 + " protected Object target(@Ovav@) { return invoker.<Object>invoke(target, @av@); }",
123.442 + " //@each-Tv@",
123.443 + " protected Object target@cat@(@Tvav@) { return target(@av@); }",
123.444 + " //@end-Tv@",
123.445 + " //@each-Tv@",
123.446 + " //@each-R@",
123.447 + " protected @R@ invoke_@Rc@(@Tvav@) { return return_@Rc@(target@cat@(@av@)); }",
123.448 + " //@end-R@",
123.449 + " //@end-Tv@",
123.450 + " }",
123.451 + } };
123.452 + enum VAR {
123.453 + cat, R, Rc, Tv, av, Tvav, Ovav;
123.454 + public final String pattern = "@"+toString().replace('_','.')+"@";
123.455 + public String binding;
123.456 + static void makeBindings(boolean topLevel, int rcat, int nrefs, int nints, int nlongs) {
123.457 + int nargs = nrefs + nints + nlongs;
123.458 + if (topLevel)
123.459 + VAR.cat.binding = catstr(ALL_RETURN_TYPES ? TYPES.length : rcat, nrefs, nints, nlongs);
123.460 + VAR.R.binding = TYPES[rcat];
123.461 + VAR.Rc.binding = TCHARS[rcat];
123.462 + String[] Tv = new String[nargs];
123.463 + String[] av = new String[nargs];
123.464 + String[] Tvav = new String[nargs];
123.465 + String[] Ovav = new String[nargs];
123.466 + for (int i = 0; i < nargs; i++) {
123.467 + int tcat = (i < nrefs) ? 0 : (i < nrefs + nints) ? 1 : 2;
123.468 + Tv[i] = TYPES[tcat];
123.469 + av[i] = arg(i);
123.470 + Tvav[i] = param(Tv[i], av[i]);
123.471 + Ovav[i] = param("Object", av[i]);
123.472 + }
123.473 + VAR.Tv.binding = comma(Tv);
123.474 + VAR.av.binding = comma(av);
123.475 + VAR.Tvav.binding = comma(Tvav);
123.476 + VAR.Ovav.binding = comma(Ovav);
123.477 + }
123.478 + static String arg(int i) { return "a"+i; }
123.479 + static String param(String t, String a) { return t+" "+a; }
123.480 + static String comma(String[] v) { return comma(v, ""); }
123.481 + static String comma(String sep, String[] v) {
123.482 + if (v.length == 0) return "";
123.483 + String res = sep+v[0];
123.484 + for (int i = 1; i < v.length; i++) res += ", "+v[i];
123.485 + return res;
123.486 + }
123.487 + static String transform(String string) {
123.488 + for (VAR var : values())
123.489 + string = string.replaceAll(var.pattern, var.binding);
123.490 + return string;
123.491 + }
123.492 + }
123.493 + static String[] stringsIn(String[] strings, int beg, int end) {
123.494 + return Arrays.copyOfRange(strings, beg, Math.min(end, strings.length));
123.495 + }
123.496 + static String[] stringsBefore(String[] strings, int pos) {
123.497 + return stringsIn(strings, 0, pos);
123.498 + }
123.499 + static String[] stringsAfter(String[] strings, int pos) {
123.500 + return stringsIn(strings, pos, strings.length);
123.501 + }
123.502 + static int indexAfter(String[] strings, int pos, String tag) {
123.503 + return Math.min(indexBefore(strings, pos, tag) + 1, strings.length);
123.504 + }
123.505 + static int indexBefore(String[] strings, int pos, String tag) {
123.506 + for (int i = pos, end = strings.length; ; i++) {
123.507 + if (i == end || strings[i].endsWith(tag)) return i;
123.508 + }
123.509 + }
123.510 + static int MIN_ARITY, MAX_ARITY, MAX_RCAT, MAX_REFS, MAX_INTS, MAX_LONGS;
123.511 + static boolean ALL_ARG_TYPES, ALL_RETURN_TYPES;
123.512 + static HashSet<String> done = new HashSet<String>();
123.513 + public static void main(String... av) {
123.514 + for (String[] template : TEMPLATES) {
123.515 + int forLinesLimit = indexBefore(template, 0, "@each-cat@");
123.516 + String[] forLines = stringsBefore(template, forLinesLimit);
123.517 + template = stringsAfter(template, forLinesLimit);
123.518 + for (String forLine : forLines)
123.519 + expandTemplate(forLine, template);
123.520 + }
123.521 + }
123.522 + static void expandTemplate(String forLine, String[] template) {
123.523 + String[] params = forLine.split("[^0-9]+");
123.524 + if (params[0].length() == 0) params = stringsAfter(params, 1);
123.525 + System.out.println("//params="+Arrays.asList(params));
123.526 + int pcur = 0;
123.527 + MIN_ARITY = Integer.valueOf(params[pcur++]);
123.528 + MAX_ARITY = Integer.valueOf(params[pcur++]);
123.529 + MAX_RCAT = Integer.valueOf(params[pcur++]);
123.530 + MAX_REFS = Integer.valueOf(params[pcur++]);
123.531 + MAX_INTS = Integer.valueOf(params[pcur++]);
123.532 + MAX_LONGS = Integer.valueOf(params[pcur++]);
123.533 + if (pcur != params.length) throw new RuntimeException("bad extra param: "+forLine);
123.534 + if (MAX_RCAT >= TYPES.length) MAX_RCAT = TYPES.length - 1;
123.535 + ALL_ARG_TYPES = (indexBefore(template, 0, "@each-Tv@") < template.length);
123.536 + ALL_RETURN_TYPES = (indexBefore(template, 0, "@each-R@") < template.length);
123.537 + for (int nargs = MIN_ARITY; nargs <= MAX_ARITY; nargs++) {
123.538 + for (int rcat = 0; rcat <= MAX_RCAT; rcat++) {
123.539 + expandTemplate(template, true, rcat, nargs, 0, 0);
123.540 + if (ALL_ARG_TYPES) break;
123.541 + expandTemplateForPrims(template, true, rcat, nargs, 1, 1);
123.542 + if (ALL_RETURN_TYPES) break;
123.543 + }
123.544 + }
123.545 + }
123.546 + static String catstr(int rcat, int nrefs, int nints, int nlongs) {
123.547 + int nargs = nrefs + nints + nlongs;
123.548 + String cat = TCHARS[rcat] + nargs;
123.549 + if (!ALL_ARG_TYPES) cat += (nints==0?"":"I"+nints)+(nlongs==0?"":"J"+nlongs);
123.550 + return cat;
123.551 + }
123.552 + static void expandTemplateForPrims(String[] template, boolean topLevel, int rcat, int nargs, int minints, int minlongs) {
123.553 + for (int isLong = 0; isLong <= 1; isLong++) {
123.554 + for (int nprims = 1; nprims <= nargs; nprims++) {
123.555 + int nrefs = nargs - nprims;
123.556 + int nints = ((1-isLong) * nprims);
123.557 + int nlongs = (isLong * nprims);
123.558 + expandTemplate(template, topLevel, rcat, nrefs, nints, nlongs);
123.559 + }
123.560 + }
123.561 + }
123.562 + static void expandTemplate(String[] template, boolean topLevel,
123.563 + int rcat, int nrefs, int nints, int nlongs) {
123.564 + int nargs = nrefs + nints + nlongs;
123.565 + if (nrefs > MAX_REFS || nints > MAX_INTS || nlongs > MAX_LONGS) return;
123.566 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
123.567 + if (topLevel && !done.add(VAR.cat.binding)) {
123.568 + System.out.println(" //repeat "+VAR.cat.binding);
123.569 + return;
123.570 + }
123.571 + for (int i = 0; i < template.length; i++) {
123.572 + String line = template[i];
123.573 + if (line.endsWith("@each-cat@")) {
123.574 + // ignore
123.575 + } else if (line.endsWith("@each-R@")) {
123.576 + int blockEnd = indexAfter(template, i, "@end-R@");
123.577 + String[] block = stringsIn(template, i+1, blockEnd-1);
123.578 + for (int rcat1 = rcat; rcat1 <= MAX_RCAT; rcat1++)
123.579 + expandTemplate(block, false, rcat1, nrefs, nints, nlongs);
123.580 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
123.581 + i = blockEnd-1; continue;
123.582 + } else if (line.endsWith("@each-Tv@")) {
123.583 + int blockEnd = indexAfter(template, i, "@end-Tv@");
123.584 + String[] block = stringsIn(template, i+1, blockEnd-1);
123.585 + expandTemplate(block, false, rcat, nrefs, nints, nlongs);
123.586 + expandTemplateForPrims(block, false, rcat, nargs, nints+1, nlongs+1);
123.587 + VAR.makeBindings(topLevel, rcat, nrefs, nints, nlongs);
123.588 + i = blockEnd-1; continue;
123.589 + } else {
123.590 + System.out.println(VAR.transform(line));
123.591 + }
123.592 + }
123.593 + }
123.594 +}
123.595 +//}}} */
123.596 +//params=[0, 3, 4, 99, 99, 99]
123.597 + static class A0 extends Adapter {
123.598 + protected A0(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.599 + protected A0(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.600 + protected A0 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A0(e, i, c, t); }
123.601 + protected Object target() { return invoker.<Object>invoke(target); }
123.602 + protected Object targetA0() { return target(); }
123.603 + protected Object invoke_L() { return return_L(targetA0()); }
123.604 + protected int invoke_I() { return return_I(targetA0()); }
123.605 + protected long invoke_J() { return return_J(targetA0()); }
123.606 + protected float invoke_F() { return return_F(targetA0()); }
123.607 + protected double invoke_D() { return return_D(targetA0()); }
123.608 + }
123.609 + static class A1 extends Adapter {
123.610 + protected A1(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.611 + protected A1(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.612 + protected A1 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A1(e, i, c, t); }
123.613 + protected Object target(Object a0) { return invoker.<Object>invoke(target, a0); }
123.614 + protected Object targetA1(Object a0) { return target(a0); }
123.615 + protected Object targetA1(int a0) { return target(a0); }
123.616 + protected Object targetA1(long a0) { return target(a0); }
123.617 + protected Object invoke_L(Object a0) { return return_L(targetA1(a0)); }
123.618 + protected int invoke_I(Object a0) { return return_I(targetA1(a0)); }
123.619 + protected long invoke_J(Object a0) { return return_J(targetA1(a0)); }
123.620 + protected float invoke_F(Object a0) { return return_F(targetA1(a0)); }
123.621 + protected double invoke_D(Object a0) { return return_D(targetA1(a0)); }
123.622 + protected Object invoke_L(int a0) { return return_L(targetA1(a0)); }
123.623 + protected int invoke_I(int a0) { return return_I(targetA1(a0)); }
123.624 + protected long invoke_J(int a0) { return return_J(targetA1(a0)); }
123.625 + protected float invoke_F(int a0) { return return_F(targetA1(a0)); }
123.626 + protected double invoke_D(int a0) { return return_D(targetA1(a0)); }
123.627 + protected Object invoke_L(long a0) { return return_L(targetA1(a0)); }
123.628 + protected int invoke_I(long a0) { return return_I(targetA1(a0)); }
123.629 + protected long invoke_J(long a0) { return return_J(targetA1(a0)); }
123.630 + protected float invoke_F(long a0) { return return_F(targetA1(a0)); }
123.631 + protected double invoke_D(long a0) { return return_D(targetA1(a0)); }
123.632 + }
123.633 + static class A2 extends Adapter {
123.634 + protected A2(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.635 + protected A2(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.636 + protected A2 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A2(e, i, c, t); }
123.637 + protected Object target(Object a0, Object a1) { return invoker.<Object>invoke(target, a0, a1); }
123.638 + protected Object targetA2(Object a0, Object a1) { return target(a0, a1); }
123.639 + protected Object targetA2(Object a0, int a1) { return target(a0, a1); }
123.640 + protected Object targetA2(int a0, int a1) { return target(a0, a1); }
123.641 + protected Object targetA2(Object a0, long a1) { return target(a0, a1); }
123.642 + protected Object targetA2(long a0, long a1) { return target(a0, a1); }
123.643 + protected Object invoke_L(Object a0, Object a1) { return return_L(targetA2(a0, a1)); }
123.644 + protected int invoke_I(Object a0, Object a1) { return return_I(targetA2(a0, a1)); }
123.645 + protected long invoke_J(Object a0, Object a1) { return return_J(targetA2(a0, a1)); }
123.646 + protected float invoke_F(Object a0, Object a1) { return return_F(targetA2(a0, a1)); }
123.647 + protected double invoke_D(Object a0, Object a1) { return return_D(targetA2(a0, a1)); }
123.648 + protected Object invoke_L(Object a0, int a1) { return return_L(targetA2(a0, a1)); }
123.649 + protected int invoke_I(Object a0, int a1) { return return_I(targetA2(a0, a1)); }
123.650 + protected long invoke_J(Object a0, int a1) { return return_J(targetA2(a0, a1)); }
123.651 + protected float invoke_F(Object a0, int a1) { return return_F(targetA2(a0, a1)); }
123.652 + protected double invoke_D(Object a0, int a1) { return return_D(targetA2(a0, a1)); }
123.653 + protected Object invoke_L(int a0, int a1) { return return_L(targetA2(a0, a1)); }
123.654 + protected int invoke_I(int a0, int a1) { return return_I(targetA2(a0, a1)); }
123.655 + protected long invoke_J(int a0, int a1) { return return_J(targetA2(a0, a1)); }
123.656 + protected float invoke_F(int a0, int a1) { return return_F(targetA2(a0, a1)); }
123.657 + protected double invoke_D(int a0, int a1) { return return_D(targetA2(a0, a1)); }
123.658 + protected Object invoke_L(Object a0, long a1) { return return_L(targetA2(a0, a1)); }
123.659 + protected int invoke_I(Object a0, long a1) { return return_I(targetA2(a0, a1)); }
123.660 + protected long invoke_J(Object a0, long a1) { return return_J(targetA2(a0, a1)); }
123.661 + protected float invoke_F(Object a0, long a1) { return return_F(targetA2(a0, a1)); }
123.662 + protected double invoke_D(Object a0, long a1) { return return_D(targetA2(a0, a1)); }
123.663 + protected Object invoke_L(long a0, long a1) { return return_L(targetA2(a0, a1)); }
123.664 + protected int invoke_I(long a0, long a1) { return return_I(targetA2(a0, a1)); }
123.665 + protected long invoke_J(long a0, long a1) { return return_J(targetA2(a0, a1)); }
123.666 + protected float invoke_F(long a0, long a1) { return return_F(targetA2(a0, a1)); }
123.667 + protected double invoke_D(long a0, long a1) { return return_D(targetA2(a0, a1)); }
123.668 + }
123.669 + static class A3 extends Adapter {
123.670 + protected A3(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.671 + protected A3(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.672 + protected A3 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A3(e, i, c, t); }
123.673 + protected Object target(Object a0, Object a1, Object a2) { return invoker.<Object>invoke(target, a0, a1, a2); }
123.674 + protected Object targetA3(Object a0, Object a1, Object a2) { return target(a0, a1, a2); }
123.675 + protected Object targetA3(Object a0, Object a1, int a2) { return target(a0, a1, a2); }
123.676 + protected Object targetA3(Object a0, int a1, int a2) { return target(a0, a1, a2); }
123.677 + protected Object targetA3(int a0, int a1, int a2) { return target(a0, a1, a2); }
123.678 + protected Object targetA3(Object a0, Object a1, long a2) { return target(a0, a1, a2); }
123.679 + protected Object targetA3(Object a0, long a1, long a2) { return target(a0, a1, a2); }
123.680 + protected Object targetA3(long a0, long a1, long a2) { return target(a0, a1, a2); }
123.681 + protected Object invoke_L(Object a0, Object a1, Object a2) { return return_L(targetA3(a0, a1, a2)); }
123.682 + protected int invoke_I(Object a0, Object a1, Object a2) { return return_I(targetA3(a0, a1, a2)); }
123.683 + protected long invoke_J(Object a0, Object a1, Object a2) { return return_J(targetA3(a0, a1, a2)); }
123.684 + protected float invoke_F(Object a0, Object a1, Object a2) { return return_F(targetA3(a0, a1, a2)); }
123.685 + protected double invoke_D(Object a0, Object a1, Object a2) { return return_D(targetA3(a0, a1, a2)); }
123.686 + protected Object invoke_L(Object a0, Object a1, int a2) { return return_L(targetA3(a0, a1, a2)); }
123.687 + protected int invoke_I(Object a0, Object a1, int a2) { return return_I(targetA3(a0, a1, a2)); }
123.688 + protected long invoke_J(Object a0, Object a1, int a2) { return return_J(targetA3(a0, a1, a2)); }
123.689 + protected float invoke_F(Object a0, Object a1, int a2) { return return_F(targetA3(a0, a1, a2)); }
123.690 + protected double invoke_D(Object a0, Object a1, int a2) { return return_D(targetA3(a0, a1, a2)); }
123.691 + protected Object invoke_L(Object a0, int a1, int a2) { return return_L(targetA3(a0, a1, a2)); }
123.692 + protected int invoke_I(Object a0, int a1, int a2) { return return_I(targetA3(a0, a1, a2)); }
123.693 + protected long invoke_J(Object a0, int a1, int a2) { return return_J(targetA3(a0, a1, a2)); }
123.694 + protected float invoke_F(Object a0, int a1, int a2) { return return_F(targetA3(a0, a1, a2)); }
123.695 + protected double invoke_D(Object a0, int a1, int a2) { return return_D(targetA3(a0, a1, a2)); }
123.696 + protected Object invoke_L(int a0, int a1, int a2) { return return_L(targetA3(a0, a1, a2)); }
123.697 + protected int invoke_I(int a0, int a1, int a2) { return return_I(targetA3(a0, a1, a2)); }
123.698 + protected long invoke_J(int a0, int a1, int a2) { return return_J(targetA3(a0, a1, a2)); }
123.699 + protected float invoke_F(int a0, int a1, int a2) { return return_F(targetA3(a0, a1, a2)); }
123.700 + protected double invoke_D(int a0, int a1, int a2) { return return_D(targetA3(a0, a1, a2)); }
123.701 + protected Object invoke_L(Object a0, Object a1, long a2) { return return_L(targetA3(a0, a1, a2)); }
123.702 + protected int invoke_I(Object a0, Object a1, long a2) { return return_I(targetA3(a0, a1, a2)); }
123.703 + protected long invoke_J(Object a0, Object a1, long a2) { return return_J(targetA3(a0, a1, a2)); }
123.704 + protected float invoke_F(Object a0, Object a1, long a2) { return return_F(targetA3(a0, a1, a2)); }
123.705 + protected double invoke_D(Object a0, Object a1, long a2) { return return_D(targetA3(a0, a1, a2)); }
123.706 + protected Object invoke_L(Object a0, long a1, long a2) { return return_L(targetA3(a0, a1, a2)); }
123.707 + protected int invoke_I(Object a0, long a1, long a2) { return return_I(targetA3(a0, a1, a2)); }
123.708 + protected long invoke_J(Object a0, long a1, long a2) { return return_J(targetA3(a0, a1, a2)); }
123.709 + protected float invoke_F(Object a0, long a1, long a2) { return return_F(targetA3(a0, a1, a2)); }
123.710 + protected double invoke_D(Object a0, long a1, long a2) { return return_D(targetA3(a0, a1, a2)); }
123.711 + protected Object invoke_L(long a0, long a1, long a2) { return return_L(targetA3(a0, a1, a2)); }
123.712 + protected int invoke_I(long a0, long a1, long a2) { return return_I(targetA3(a0, a1, a2)); }
123.713 + protected long invoke_J(long a0, long a1, long a2) { return return_J(targetA3(a0, a1, a2)); }
123.714 + protected float invoke_F(long a0, long a1, long a2) { return return_F(targetA3(a0, a1, a2)); }
123.715 + protected double invoke_D(long a0, long a1, long a2) { return return_D(targetA3(a0, a1, a2)); }
123.716 + }
123.717 +//params=[4, 5, 2, 99, 99, 99]
123.718 + static class A4 extends Adapter {
123.719 + protected A4(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.720 + protected A4(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.721 + protected A4 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A4(e, i, c, t); }
123.722 + protected Object target(Object a0, Object a1, Object a2, Object a3) { return invoker.<Object>invoke(target, a0, a1, a2, a3); }
123.723 + protected Object targetA4(Object a0, Object a1, Object a2, Object a3) { return target(a0, a1, a2, a3); }
123.724 + protected Object targetA4(Object a0, Object a1, Object a2, int a3) { return target(a0, a1, a2, a3); }
123.725 + protected Object targetA4(Object a0, Object a1, int a2, int a3) { return target(a0, a1, a2, a3); }
123.726 + protected Object targetA4(Object a0, int a1, int a2, int a3) { return target(a0, a1, a2, a3); }
123.727 + protected Object targetA4(int a0, int a1, int a2, int a3) { return target(a0, a1, a2, a3); }
123.728 + protected Object targetA4(Object a0, Object a1, Object a2, long a3) { return target(a0, a1, a2, a3); }
123.729 + protected Object targetA4(Object a0, Object a1, long a2, long a3) { return target(a0, a1, a2, a3); }
123.730 + protected Object targetA4(Object a0, long a1, long a2, long a3) { return target(a0, a1, a2, a3); }
123.731 + protected Object targetA4(long a0, long a1, long a2, long a3) { return target(a0, a1, a2, a3); }
123.732 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.733 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.734 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.735 + protected Object invoke_L(Object a0, Object a1, Object a2, int a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.736 + protected int invoke_I(Object a0, Object a1, Object a2, int a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.737 + protected long invoke_J(Object a0, Object a1, Object a2, int a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.738 + protected Object invoke_L(Object a0, Object a1, int a2, int a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.739 + protected int invoke_I(Object a0, Object a1, int a2, int a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.740 + protected long invoke_J(Object a0, Object a1, int a2, int a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.741 + protected Object invoke_L(Object a0, int a1, int a2, int a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.742 + protected int invoke_I(Object a0, int a1, int a2, int a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.743 + protected long invoke_J(Object a0, int a1, int a2, int a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.744 + protected Object invoke_L(int a0, int a1, int a2, int a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.745 + protected int invoke_I(int a0, int a1, int a2, int a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.746 + protected long invoke_J(int a0, int a1, int a2, int a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.747 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.748 + protected int invoke_I(Object a0, Object a1, Object a2, long a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.749 + protected long invoke_J(Object a0, Object a1, Object a2, long a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.750 + protected Object invoke_L(Object a0, Object a1, long a2, long a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.751 + protected int invoke_I(Object a0, Object a1, long a2, long a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.752 + protected long invoke_J(Object a0, Object a1, long a2, long a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.753 + protected Object invoke_L(Object a0, long a1, long a2, long a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.754 + protected int invoke_I(Object a0, long a1, long a2, long a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.755 + protected long invoke_J(Object a0, long a1, long a2, long a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.756 + protected Object invoke_L(long a0, long a1, long a2, long a3) { return return_L(targetA4(a0, a1, a2, a3)); }
123.757 + protected int invoke_I(long a0, long a1, long a2, long a3) { return return_I(targetA4(a0, a1, a2, a3)); }
123.758 + protected long invoke_J(long a0, long a1, long a2, long a3) { return return_J(targetA4(a0, a1, a2, a3)); }
123.759 + }
123.760 + static class A5 extends Adapter {
123.761 + protected A5(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.762 + protected A5(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.763 + protected A5 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A5(e, i, c, t); }
123.764 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4); }
123.765 + protected Object targetA5(Object a0, Object a1, Object a2, Object a3, Object a4) { return target(a0, a1, a2, a3, a4); }
123.766 + protected Object targetA5(Object a0, Object a1, Object a2, Object a3, int a4) { return target(a0, a1, a2, a3, a4); }
123.767 + protected Object targetA5(Object a0, Object a1, Object a2, int a3, int a4) { return target(a0, a1, a2, a3, a4); }
123.768 + protected Object targetA5(Object a0, Object a1, int a2, int a3, int a4) { return target(a0, a1, a2, a3, a4); }
123.769 + protected Object targetA5(Object a0, int a1, int a2, int a3, int a4) { return target(a0, a1, a2, a3, a4); }
123.770 + protected Object targetA5(int a0, int a1, int a2, int a3, int a4) { return target(a0, a1, a2, a3, a4); }
123.771 + protected Object targetA5(Object a0, Object a1, Object a2, Object a3, long a4) { return target(a0, a1, a2, a3, a4); }
123.772 + protected Object targetA5(Object a0, Object a1, Object a2, long a3, long a4) { return target(a0, a1, a2, a3, a4); }
123.773 + protected Object targetA5(Object a0, Object a1, long a2, long a3, long a4) { return target(a0, a1, a2, a3, a4); }
123.774 + protected Object targetA5(Object a0, long a1, long a2, long a3, long a4) { return target(a0, a1, a2, a3, a4); }
123.775 + protected Object targetA5(long a0, long a1, long a2, long a3, long a4) { return target(a0, a1, a2, a3, a4); }
123.776 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.777 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.778 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.779 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, int a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.780 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, int a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.781 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, int a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.782 + protected Object invoke_L(Object a0, Object a1, Object a2, int a3, int a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.783 + protected int invoke_I(Object a0, Object a1, Object a2, int a3, int a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.784 + protected long invoke_J(Object a0, Object a1, Object a2, int a3, int a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.785 + protected Object invoke_L(Object a0, Object a1, int a2, int a3, int a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.786 + protected int invoke_I(Object a0, Object a1, int a2, int a3, int a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.787 + protected long invoke_J(Object a0, Object a1, int a2, int a3, int a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.788 + protected Object invoke_L(Object a0, int a1, int a2, int a3, int a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.789 + protected int invoke_I(Object a0, int a1, int a2, int a3, int a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.790 + protected long invoke_J(Object a0, int a1, int a2, int a3, int a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.791 + protected Object invoke_L(int a0, int a1, int a2, int a3, int a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.792 + protected int invoke_I(int a0, int a1, int a2, int a3, int a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.793 + protected long invoke_J(int a0, int a1, int a2, int a3, int a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.794 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.795 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.796 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.797 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.798 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.799 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.800 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.801 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.802 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.803 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.804 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.805 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.806 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4) { return return_L(targetA5(a0, a1, a2, a3, a4)); }
123.807 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4) { return return_I(targetA5(a0, a1, a2, a3, a4)); }
123.808 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4) { return return_J(targetA5(a0, a1, a2, a3, a4)); }
123.809 + }
123.810 +//params=[6, 10, 2, 99, 0, 99]
123.811 + static class A6 extends Adapter {
123.812 + protected A6(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.813 + protected A6(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.814 + protected A6 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A6(e, i, c, t); }
123.815 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5); }
123.816 + protected Object targetA6(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return target(a0, a1, a2, a3, a4, a5); }
123.817 + protected Object targetA6(Object a0, Object a1, Object a2, Object a3, Object a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.818 + protected Object targetA6(Object a0, Object a1, Object a2, Object a3, long a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.819 + protected Object targetA6(Object a0, Object a1, Object a2, long a3, long a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.820 + protected Object targetA6(Object a0, Object a1, long a2, long a3, long a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.821 + protected Object targetA6(Object a0, long a1, long a2, long a3, long a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.822 + protected Object targetA6(long a0, long a1, long a2, long a3, long a4, long a5) { return target(a0, a1, a2, a3, a4, a5); }
123.823 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.824 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.825 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.826 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.827 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.828 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.829 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.830 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.831 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.832 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.833 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.834 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.835 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.836 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.837 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.838 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.839 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.840 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.841 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4, long a5) { return return_L(targetA6(a0, a1, a2, a3, a4, a5)); }
123.842 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4, long a5) { return return_I(targetA6(a0, a1, a2, a3, a4, a5)); }
123.843 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4, long a5) { return return_J(targetA6(a0, a1, a2, a3, a4, a5)); }
123.844 + }
123.845 + static class A7 extends Adapter {
123.846 + protected A7(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.847 + protected A7(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.848 + protected A7 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A7(e, i, c, t); }
123.849 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6); }
123.850 + protected Object targetA7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.851 + protected Object targetA7(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.852 + protected Object targetA7(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.853 + protected Object targetA7(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.854 + protected Object targetA7(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.855 + protected Object targetA7(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.856 + protected Object targetA7(Object a0, long a1, long a2, long a3, long a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.857 + protected Object targetA7(long a0, long a1, long a2, long a3, long a4, long a5, long a6) { return target(a0, a1, a2, a3, a4, a5, a6); }
123.858 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.859 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.860 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.861 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.862 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.863 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.864 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.865 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.866 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.867 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.868 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.869 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.870 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.871 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.872 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.873 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.874 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.875 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.876 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.877 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.878 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.879 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_L(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.880 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_I(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.881 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4, long a5, long a6) { return return_J(targetA7(a0, a1, a2, a3, a4, a5, a6)); }
123.882 + }
123.883 + static class A8 extends Adapter {
123.884 + protected A8(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.885 + protected A8(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.886 + protected A8 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A8(e, i, c, t); }
123.887 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7); }
123.888 + protected Object targetA8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.889 + protected Object targetA8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.890 + protected Object targetA8(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.891 + protected Object targetA8(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.892 + protected Object targetA8(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.893 + protected Object targetA8(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.894 + protected Object targetA8(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.895 + protected Object targetA8(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.896 + protected Object targetA8(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return target(a0, a1, a2, a3, a4, a5, a6, a7); }
123.897 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.898 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.899 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.900 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.901 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.902 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.903 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.904 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.905 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.906 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.907 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.908 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.909 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.910 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.911 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.912 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.913 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.914 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.915 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.916 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.917 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.918 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.919 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.920 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.921 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_L(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.922 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_I(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.923 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7) { return return_J(targetA8(a0, a1, a2, a3, a4, a5, a6, a7)); }
123.924 + }
123.925 + static class A9 extends Adapter {
123.926 + protected A9(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.927 + protected A9(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.928 + protected A9 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A9(e, i, c, t); }
123.929 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.930 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.931 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.932 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.933 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.934 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.935 + protected Object targetA9(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.936 + protected Object targetA9(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.937 + protected Object targetA9(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.938 + protected Object targetA9(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.939 + protected Object targetA9(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8); }
123.940 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.941 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.942 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.943 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.944 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.945 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.946 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.947 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.948 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.949 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.950 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.951 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.952 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.953 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.954 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.955 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.956 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.957 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.958 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.959 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.960 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.961 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.962 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.963 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.964 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.965 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.966 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.967 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_L(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.968 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_I(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.969 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8) { return return_J(targetA9(a0, a1, a2, a3, a4, a5, a6, a7, a8)); }
123.970 + }
123.971 + static class A10 extends Adapter {
123.972 + protected A10(MethodHandle entryPoint) { super(entryPoint); } // to build prototype
123.973 + protected A10(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { super(e, i, c, t); }
123.974 + protected A10 makeInstance(MethodHandle e, MethodHandle i, MethodHandle c, MethodHandle t) { return new A10(e, i, c, t); }
123.975 + protected Object target(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return invoker.<Object>invoke(target, a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.976 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.977 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.978 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.979 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.980 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.981 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.982 + protected Object targetA10(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.983 + protected Object targetA10(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.984 + protected Object targetA10(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.985 + protected Object targetA10(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.986 + protected Object targetA10(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return target(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9); }
123.987 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.988 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.989 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, Object a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.990 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.991 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.992 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, Object a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.993 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.994 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.995 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, Object a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.996 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.997 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.998 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, Object a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.999 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1000 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1001 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, Object a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1002 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1003 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1004 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, Object a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1005 + protected Object invoke_L(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1006 + protected int invoke_I(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1007 + protected long invoke_J(Object a0, Object a1, Object a2, Object a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1008 + protected Object invoke_L(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1009 + protected int invoke_I(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1010 + protected long invoke_J(Object a0, Object a1, Object a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1011 + protected Object invoke_L(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1012 + protected int invoke_I(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1013 + protected long invoke_J(Object a0, Object a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1014 + protected Object invoke_L(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1015 + protected int invoke_I(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1016 + protected long invoke_J(Object a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1017 + protected Object invoke_L(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_L(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1018 + protected int invoke_I(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_I(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1019 + protected long invoke_J(long a0, long a1, long a2, long a3, long a4, long a5, long a6, long a7, long a8, long a9) { return return_J(targetA10(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9)); }
123.1020 + }
123.1021 +}
124.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
124.2 +++ b/src/share/classes/sun/dyn/anon/AnonymousClassLoader.java Thu May 14 00:17:25 2009 -0700
124.3 @@ -0,0 +1,297 @@
124.4 +/*
124.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
124.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
124.7 + *
124.8 + * This code is free software; you can redistribute it and/or modify it
124.9 + * under the terms of the GNU General Public License version 2 only, as
124.10 + * published by the Free Software Foundation. Sun designates this
124.11 + * particular file as subject to the "Classpath" exception as provided
124.12 + * by Sun in the LICENSE file that accompanied this code.
124.13 + *
124.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
124.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
124.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
124.17 + * version 2 for more details (a copy is included in the LICENSE file that
124.18 + * accompanied this code).
124.19 + *
124.20 + * You should have received a copy of the GNU General Public License version
124.21 + * 2 along with this work; if not, write to the Free Software Foundation,
124.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
124.23 + *
124.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
124.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
124.26 + * have any questions.
124.27 + */
124.28 +
124.29 +package sun.dyn.anon;
124.30 +
124.31 +import java.io.IOException;
124.32 +import java.io.InputStream;
124.33 +import java.lang.reflect.InvocationTargetException;
124.34 +import java.lang.reflect.Method;
124.35 +
124.36 +/**
124.37 + * Anonymous class loader. Will load any valid classfile, producing
124.38 + * a {@link Class} metaobject, without installing that class in the
124.39 + * system dictionary. Therefore, {@link Class#forName(String)} will never
124.40 + * produce a reference to an anonymous class.
124.41 + * <p>
124.42 + * The access permissions of the anonymous class are borrowed from
124.43 + * a <em>host class</em>. The new class behaves as if it were an
124.44 + * inner class of the host class. It can access the host's private
124.45 + * members, if the creator of the class loader has permission to
124.46 + * do so (or to create accessible reflective objects).
124.47 + * <p>
124.48 + * When the anonymous class is loaded, elements of its constant pool
124.49 + * can be patched to new values. This provides a hook to pre-resolve
124.50 + * named classes in the constant pool to other classes, including
124.51 + * anonymous ones. Also, string constants can be pre-resolved to
124.52 + * any reference. (The verifier treats non-string, non-class reference
124.53 + * constants as plain objects.)
124.54 + * <p>
124.55 + * Why include the patching function? It makes some use cases much easier.
124.56 + * Second, the constant pool needed some internal patching anyway,
124.57 + * to anonymize the loaded class itself. Finally, if you are going
124.58 + * to use this seriously, you'll want to build anonymous classes
124.59 + * on top of pre-existing anonymous classes, and that requires patching.
124.60 + *
124.61 + * <p>%%% TO-DO:
124.62 + * <ul>
124.63 + * <li>needs better documentation</li>
124.64 + * <li>needs more security work (for safe delegation)</li>
124.65 + * <li>needs a clearer story about error processing</li>
124.66 + * <li>patch member references also (use ';' as delimiter char)</li>
124.67 + * <li>patch method references to (conforming) method handles</li>
124.68 + * </ul>
124.69 + *
124.70 + * @author jrose
124.71 + * @author Remi Forax
124.72 + * @see <a href="http://blogs.sun.com/jrose/entry/anonymous_classes_in_the_vm">
124.73 + * http://blogs.sun.com/jrose/entry/anonymous_classes_in_the_vm</a>
124.74 + */
124.75 +
124.76 +public class AnonymousClassLoader {
124.77 + final Class<?> hostClass;
124.78 +
124.79 + // Note: Do not refactor the calls to checkHostClass unless you
124.80 + // also adjust this constant:
124.81 + private static int CHC_CALLERS = 3;
124.82 +
124.83 + public AnonymousClassLoader() {
124.84 + this.hostClass = checkHostClass(null);
124.85 + }
124.86 + public AnonymousClassLoader(Class<?> hostClass) {
124.87 + this.hostClass = checkHostClass(hostClass);
124.88 + }
124.89 +
124.90 + private static Class<?> getTopLevelClass(Class<?> clazz) {
124.91 + for(Class<?> outer = clazz.getDeclaringClass(); outer != null;
124.92 + outer = outer.getDeclaringClass()) {
124.93 + clazz = outer;
124.94 + }
124.95 + return clazz;
124.96 + }
124.97 +
124.98 + private static Class<?> checkHostClass(Class<?> hostClass) {
124.99 + // called only from the constructor
124.100 + // does a context-sensitive check on caller class
124.101 + // CC[0..3] = {Reflection, this.checkHostClass, this.<init>, caller}
124.102 + Class<?> caller = sun.reflect.Reflection.getCallerClass(CHC_CALLERS);
124.103 +
124.104 + if (caller == null) {
124.105 + // called from the JVM directly
124.106 + if (hostClass == null)
124.107 + return AnonymousClassLoader.class; // anything central will do
124.108 + return hostClass;
124.109 + }
124.110 +
124.111 + if (hostClass == null)
124.112 + hostClass = caller; // default value is caller itself
124.113 +
124.114 + // anonymous class will access hostClass on behalf of caller
124.115 + Class<?> callee = hostClass;
124.116 +
124.117 + if (caller == callee)
124.118 + // caller can always nominate itself to grant caller's own access rights
124.119 + return hostClass;
124.120 +
124.121 + // normalize caller and callee to their top-level classes:
124.122 + caller = getTopLevelClass(caller);
124.123 + callee = getTopLevelClass(callee);
124.124 + if (caller == callee)
124.125 + return caller;
124.126 +
124.127 + ClassLoader callerCL = caller.getClassLoader();
124.128 + if (callerCL == null) {
124.129 + // caller is trusted code, so accept the proposed hostClass
124.130 + return hostClass;
124.131 + }
124.132 +
124.133 + // %%% should do something with doPrivileged, because trusted
124.134 + // code should have a way to execute on behalf of
124.135 + // partially-trusted clients
124.136 +
124.137 + // Does the caller have the right to access the private
124.138 + // members of the callee? If not, raise an error.
124.139 + final int ACC_PRIVATE = 2;
124.140 + try {
124.141 + sun.reflect.Reflection.ensureMemberAccess(caller, callee, null, ACC_PRIVATE);
124.142 + } catch (IllegalAccessException ee) {
124.143 + throw new IllegalArgumentException(ee);
124.144 + }
124.145 +
124.146 + return hostClass;
124.147 + }
124.148 +
124.149 + public Class<?> loadClass(byte[] classFile) {
124.150 + if (defineAnonymousClass == null) {
124.151 + // no JVM support; try to fake an approximation
124.152 + try {
124.153 + return fakeLoadClass(new ConstantPoolParser(classFile).createPatch());
124.154 + } catch (InvalidConstantPoolFormatException ee) {
124.155 + throw new IllegalArgumentException(ee);
124.156 + }
124.157 + }
124.158 + return loadClass(classFile, null);
124.159 + }
124.160 +
124.161 + public Class<?> loadClass(ConstantPoolPatch classPatch) {
124.162 + if (defineAnonymousClass == null) {
124.163 + // no JVM support; try to fake an approximation
124.164 + return fakeLoadClass(classPatch);
124.165 + }
124.166 + Object[] patches = classPatch.patchArray;
124.167 + // Convert class names (this late in the game)
124.168 + // to use slash '/' instead of dot '.'.
124.169 + // Java likes dots, but the JVM likes slashes.
124.170 + for (int i = 0; i < patches.length; i++) {
124.171 + Object value = patches[i];
124.172 + if (value != null) {
124.173 + byte tag = classPatch.getTag(i);
124.174 + switch (tag) {
124.175 + case ConstantPoolVisitor.CONSTANT_Class:
124.176 + if (value instanceof String) {
124.177 + if (patches == classPatch.patchArray)
124.178 + patches = patches.clone();
124.179 + patches[i] = ((String)value).replace('.', '/');
124.180 + }
124.181 + break;
124.182 + case ConstantPoolVisitor.CONSTANT_Fieldref:
124.183 + case ConstantPoolVisitor.CONSTANT_Methodref:
124.184 + case ConstantPoolVisitor.CONSTANT_InterfaceMethodref:
124.185 + case ConstantPoolVisitor.CONSTANT_NameAndType:
124.186 + // When/if the JVM supports these patches,
124.187 + // we'll probably need to reformat them also.
124.188 + // Meanwhile, let the class loader create the error.
124.189 + break;
124.190 + }
124.191 + }
124.192 + }
124.193 + return loadClass(classPatch.outer.classFile, classPatch.patchArray);
124.194 + }
124.195 +
124.196 + private Class<?> loadClass(byte[] classFile, Object[] patchArray) {
124.197 + try {
124.198 + return (Class<?>)
124.199 + defineAnonymousClass.invoke(unsafe,
124.200 + hostClass, classFile, patchArray);
124.201 + } catch (Exception ex) {
124.202 + throwReflectedException(ex);
124.203 + throw new RuntimeException("error loading into "+hostClass, ex);
124.204 + }
124.205 + }
124.206 +
124.207 + private static void throwReflectedException(Exception ex) {
124.208 + if (ex instanceof InvocationTargetException) {
124.209 + Throwable tex = ((InvocationTargetException)ex).getTargetException();
124.210 + if (tex instanceof Error)
124.211 + throw (Error) tex;
124.212 + ex = (Exception) tex;
124.213 + }
124.214 + if (ex instanceof RuntimeException) {
124.215 + throw (RuntimeException) ex;
124.216 + }
124.217 + }
124.218 +
124.219 + private Class<?> fakeLoadClass(ConstantPoolPatch classPatch) {
124.220 + // Implementation:
124.221 + // 1. Make up a new name nobody has used yet.
124.222 + // 2. Inspect the tail-header of the class to find the this_class index.
124.223 + // 3. Patch the CONSTANT_Class for this_class to the new name.
124.224 + // 4. Add other CP entries required by (e.g.) string patches.
124.225 + // 5. Flatten Class constants down to their names, making sure that
124.226 + // the host class loader can pick them up again accurately.
124.227 + // 6. Generate the edited class file bytes.
124.228 + //
124.229 + // Potential limitations:
124.230 + // * The class won't be truly anonymous, and may interfere with others.
124.231 + // * Flattened class constants might not work, because of loader issues.
124.232 + // * Pseudo-string constants will not flatten down to real strings.
124.233 + // * Method handles will (of course) fail to flatten to linkage strings.
124.234 + if (true) throw new UnsupportedOperationException("NYI");
124.235 + Object[] cpArray;
124.236 + try {
124.237 + cpArray = classPatch.getOriginalCP();
124.238 + } catch (InvalidConstantPoolFormatException ex) {
124.239 + throw new RuntimeException(ex);
124.240 + }
124.241 + int thisClassIndex = classPatch.getParser().getThisClassIndex();
124.242 + String thisClassName = (String) cpArray[thisClassIndex];
124.243 + synchronized (AnonymousClassLoader.class) {
124.244 + thisClassName = thisClassName+"\\|"+(++fakeNameCounter);
124.245 + }
124.246 + classPatch.putUTF8(thisClassIndex, thisClassName);
124.247 + byte[] classFile = null;
124.248 + return unsafe.defineClass(null, classFile, 0, classFile.length,
124.249 + hostClass.getClassLoader(),
124.250 + hostClass.getProtectionDomain());
124.251 + }
124.252 + private static int fakeNameCounter = 99999;
124.253 +
124.254 + // ignore two warnings on this line:
124.255 + static sun.misc.Unsafe unsafe = sun.misc.Unsafe.getUnsafe();
124.256 + // preceding line requires that this class be on the boot class path
124.257 +
124.258 + static private final Method defineAnonymousClass;
124.259 + static {
124.260 + Method dac = null;
124.261 + Class<? extends sun.misc.Unsafe> unsafeClass = unsafe.getClass();
124.262 + try {
124.263 + dac = unsafeClass.getMethod("defineAnonymousClass",
124.264 + Class.class,
124.265 + byte[].class,
124.266 + Object[].class);
124.267 + } catch (Exception ee) {
124.268 + dac = null;
124.269 + }
124.270 + defineAnonymousClass = dac;
124.271 + }
124.272 +
124.273 + private static void noJVMSupport() {
124.274 + throw new UnsupportedOperationException("no JVM support for anonymous classes");
124.275 + }
124.276 +
124.277 +
124.278 + private static native Class<?> loadClassInternal(Class<?> hostClass,
124.279 + byte[] classFile,
124.280 + Object[] patchArray);
124.281 +
124.282 + public static byte[] readClassFile(Class<?> templateClass) throws IOException {
124.283 + String templateName = templateClass.getName();
124.284 + int lastDot = templateName.lastIndexOf('.');
124.285 + java.net.URL url = templateClass.getResource(templateName.substring(lastDot+1)+".class");
124.286 + java.net.URLConnection connection = url.openConnection();
124.287 + int contentLength = connection.getContentLength();
124.288 + if (contentLength < 0)
124.289 + throw new IOException("invalid content length "+contentLength);
124.290 +
124.291 + byte[] classFile = new byte[contentLength];
124.292 + InputStream tcs = connection.getInputStream();
124.293 + for (int fill = 0, nr; fill < classFile.length; fill += nr) {
124.294 + nr = tcs.read(classFile, fill, classFile.length - fill);
124.295 + if (nr < 0)
124.296 + throw new IOException("premature end of file");
124.297 + }
124.298 + return classFile;
124.299 + }
124.300 +}
125.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
125.2 +++ b/src/share/classes/sun/dyn/anon/ConstantPoolParser.java Thu May 14 00:17:25 2009 -0700
125.3 @@ -0,0 +1,368 @@
125.4 +/*
125.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
125.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
125.7 + *
125.8 + * This code is free software; you can redistribute it and/or modify it
125.9 + * under the terms of the GNU General Public License version 2 only, as
125.10 + * published by the Free Software Foundation. Sun designates this
125.11 + * particular file as subject to the "Classpath" exception as provided
125.12 + * by Sun in the LICENSE file that accompanied this code.
125.13 + *
125.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
125.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
125.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
125.17 + * version 2 for more details (a copy is included in the LICENSE file that
125.18 + * accompanied this code).
125.19 + *
125.20 + * You should have received a copy of the GNU General Public License version
125.21 + * 2 along with this work; if not, write to the Free Software Foundation,
125.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
125.23 + *
125.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
125.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
125.26 + * have any questions.
125.27 + */
125.28 +
125.29 +package sun.dyn.anon;
125.30 +
125.31 +import java.io.IOException;
125.32 +import java.io.OutputStream;
125.33 +import java.nio.BufferUnderflowException;
125.34 +import java.nio.ByteBuffer;
125.35 +
125.36 +import static sun.dyn.anon.ConstantPoolVisitor.*;
125.37 +
125.38 +/** A constant pool parser.
125.39 + */
125.40 +public class ConstantPoolParser {
125.41 + final byte[] classFile;
125.42 + final byte[] tags;
125.43 + final char[] firstHeader; // maghi, maglo, minor, major, cplen
125.44 +
125.45 + // these are filled in on first parse:
125.46 + int endOffset;
125.47 + char[] secondHeader; // flags, this_class, super_class, intlen
125.48 +
125.49 + // used to decode UTF8 array
125.50 + private char[] charArray = new char[80];
125.51 +
125.52 + /** Creates a constant pool parser.
125.53 + * @param classFile an array of bytes containing a class.
125.54 + * @throws InvalidConstantPoolFormatException if the header of the class has errors.
125.55 + */
125.56 + public ConstantPoolParser(byte[] classFile) throws InvalidConstantPoolFormatException {
125.57 + this.classFile = classFile;
125.58 + this.firstHeader = parseHeader(classFile);
125.59 + this.tags = new byte[firstHeader[4]];
125.60 + }
125.61 +
125.62 + /** Create a constant pool parser by loading the bytecodes of the
125.63 + * class taken as argument.
125.64 + *
125.65 + * @param templateClass the class to parse.
125.66 + *
125.67 + * @throws IOException raised if an I/O occurs when loading
125.68 + * the bytecode of the template class.
125.69 + * @throws InvalidConstantPoolFormatException if the header of the class has errors.
125.70 + *
125.71 + * @see #ConstantPoolParser(byte[])
125.72 + * @see AnonymousClassLoader#readClassFile(Class)
125.73 + */
125.74 + public ConstantPoolParser(Class<?> templateClass) throws IOException, InvalidConstantPoolFormatException {
125.75 + this(AnonymousClassLoader.readClassFile(templateClass));
125.76 + }
125.77 +
125.78 + /** Creates an empty patch to patch the class file
125.79 + * used by the current parser.
125.80 + * @return a new class patch.
125.81 + */
125.82 + public ConstantPoolPatch createPatch() {
125.83 + return new ConstantPoolPatch(this);
125.84 + }
125.85 +
125.86 + /** Report the tag of the indicated CP entry.
125.87 + * @param index
125.88 + * @return one of {@link ConstantPoolVisitor#CONSTANT_Utf8}, etc.
125.89 + */
125.90 + public byte getTag(int index) {
125.91 + getEndOffset(); // trigger an exception if we haven't parsed yet
125.92 + return tags[index];
125.93 + }
125.94 +
125.95 + /** Report the length of the constant pool. */
125.96 + public int getLength() {
125.97 + return firstHeader[4];
125.98 + }
125.99 +
125.100 + /** Report the offset, within the class file, of the start of the constant pool. */
125.101 + public int getStartOffset() {
125.102 + return firstHeader.length * 2;
125.103 + }
125.104 +
125.105 + /** Report the offset, within the class file, of the end of the constant pool. */
125.106 + public int getEndOffset() {
125.107 + if (endOffset == 0)
125.108 + throw new IllegalStateException("class file has not yet been parsed");
125.109 + return endOffset;
125.110 + }
125.111 +
125.112 + /** Report the CP index of this class's own name. */
125.113 + public int getThisClassIndex() {
125.114 + getEndOffset(); // provoke exception if not yet parsed
125.115 + return secondHeader[1];
125.116 + }
125.117 +
125.118 + /** Report the total size of the class file. */
125.119 + public int getTailLength() {
125.120 + return classFile.length - getEndOffset();
125.121 + }
125.122 +
125.123 + /** Write the head (header plus constant pool)
125.124 + * of the class file to the indicated stream.
125.125 + */
125.126 + public void writeHead(OutputStream out) throws IOException {
125.127 + out.write(classFile, 0, getEndOffset());
125.128 + }
125.129 +
125.130 + /** Write the head (header plus constant pool)
125.131 + * of the class file to the indicated stream,
125.132 + * incorporating the non-null entries of the given array
125.133 + * as patches.
125.134 + */
125.135 + void writePatchedHead(OutputStream out, Object[] patchArray) {
125.136 + // this will be useful to partially emulate the class loader on old JVMs
125.137 + throw new UnsupportedOperationException("Not yet implemented");
125.138 + }
125.139 +
125.140 + /** Write the tail (everything after the constant pool)
125.141 + * of the class file to the indicated stream.
125.142 + */
125.143 + public void writeTail(OutputStream out) throws IOException {
125.144 + out.write(classFile, getEndOffset(), getTailLength());
125.145 + }
125.146 +
125.147 + private static char[] parseHeader(byte[] classFile) throws InvalidConstantPoolFormatException {
125.148 + char[] result = new char[5];
125.149 + ByteBuffer buffer = ByteBuffer.wrap(classFile);
125.150 + for (int i = 0; i < result.length; i++)
125.151 + result[i] = (char) getUnsignedShort(buffer);
125.152 + int magic = result[0] << 16 | result[1] << 0;
125.153 + if (magic != 0xCAFEBABE)
125.154 + throw new InvalidConstantPoolFormatException("invalid magic number "+magic);
125.155 + // skip major, minor version
125.156 + int len = result[4];
125.157 + if (len < 1)
125.158 + throw new InvalidConstantPoolFormatException("constant pool length < 1");
125.159 + return result;
125.160 + }
125.161 +
125.162 + /** Parse the constant pool of the class
125.163 + * calling a method visit* each time a constant pool entry is parsed.
125.164 + *
125.165 + * The order of the calls to visit* is not guaranteed to be the same
125.166 + * than the order of the constant pool entry in the bytecode array.
125.167 + *
125.168 + * @param visitor
125.169 + * @throws InvalidConstantPoolFormatException
125.170 + */
125.171 + public void parse(ConstantPoolVisitor visitor) throws InvalidConstantPoolFormatException {
125.172 + ByteBuffer buffer = ByteBuffer.wrap(classFile);
125.173 + buffer.position(getStartOffset()); //skip header
125.174 +
125.175 + Object[] values = new Object[getLength()];
125.176 + try {
125.177 + parseConstantPool(buffer, values, visitor);
125.178 + } catch(BufferUnderflowException e) {
125.179 + throw new InvalidConstantPoolFormatException(e);
125.180 + }
125.181 + if (endOffset == 0) {
125.182 + endOffset = buffer.position();
125.183 + secondHeader = new char[4];
125.184 + for (int i = 0; i < secondHeader.length; i++) {
125.185 + secondHeader[i] = (char) getUnsignedShort(buffer);
125.186 + }
125.187 + }
125.188 + resolveConstantPool(values, visitor);
125.189 + }
125.190 +
125.191 + private char[] getCharArray(int utfLength) {
125.192 + if (utfLength <= charArray.length)
125.193 + return charArray;
125.194 + return charArray = new char[utfLength];
125.195 + }
125.196 +
125.197 + private void parseConstantPool(ByteBuffer buffer, Object[] values, ConstantPoolVisitor visitor) throws InvalidConstantPoolFormatException {
125.198 + for (int i = 1; i < tags.length; ) {
125.199 + byte tag = (byte) getUnsignedByte(buffer);
125.200 + assert(tags[i] == 0 || tags[i] == tag);
125.201 + tags[i] = tag;
125.202 + switch (tag) {
125.203 + case CONSTANT_Utf8:
125.204 + int utfLen = getUnsignedShort(buffer);
125.205 + String value = getUTF8(buffer, utfLen, getCharArray(utfLen));
125.206 + visitor.visitUTF8(i, CONSTANT_Utf8, value);
125.207 + tags[i] = tag;
125.208 + values[i++] = value;
125.209 + break;
125.210 + case CONSTANT_Integer:
125.211 + visitor.visitConstantValue(i, tag, buffer.getInt());
125.212 + i++;
125.213 + break;
125.214 + case CONSTANT_Float:
125.215 + visitor.visitConstantValue(i, tag, buffer.getFloat());
125.216 + i++;
125.217 + break;
125.218 + case CONSTANT_Long:
125.219 + visitor.visitConstantValue(i, tag, buffer.getLong());
125.220 + i+=2;
125.221 + break;
125.222 + case CONSTANT_Double:
125.223 + visitor.visitConstantValue(i, tag, buffer.getDouble());
125.224 + i+=2;
125.225 + break;
125.226 +
125.227 + case CONSTANT_Class: // fall through:
125.228 + case CONSTANT_String:
125.229 + tags[i] = tag;
125.230 + values[i++] = new int[] { getUnsignedShort(buffer) };
125.231 + break;
125.232 +
125.233 + case CONSTANT_Fieldref: // fall through:
125.234 + case CONSTANT_Methodref: // fall through:
125.235 + case CONSTANT_InterfaceMethodref: // fall through:
125.236 + case CONSTANT_NameAndType:
125.237 + tags[i] = tag;
125.238 + values[i++] = new int[] { getUnsignedShort(buffer), getUnsignedShort(buffer) };
125.239 + break;
125.240 + default:
125.241 + throw new AssertionError("invalid constant "+tag);
125.242 + }
125.243 + }
125.244 + }
125.245 +
125.246 + private void resolveConstantPool(Object[] values, ConstantPoolVisitor visitor) {
125.247 + // clean out the int[] values, which are temporary
125.248 + for (int beg = 1, end = values.length-1, beg2, end2;
125.249 + beg <= end;
125.250 + beg = beg2, end = end2) {
125.251 + beg2 = end; end2 = beg-1;
125.252 + //System.out.println("CP resolve pass: "+beg+".."+end);
125.253 + for (int i = beg; i <= end; i++) {
125.254 + Object value = values[i];
125.255 + if (!(value instanceof int[]))
125.256 + continue;
125.257 + int[] array = (int[]) value;
125.258 + byte tag = tags[i];
125.259 + switch (tag) {
125.260 + case CONSTANT_String:
125.261 + String stringBody = (String) values[array[0]];
125.262 + visitor.visitConstantString(i, tag, stringBody, array[0]);
125.263 + values[i] = null;
125.264 + break;
125.265 + case CONSTANT_Class: {
125.266 + String className = (String) values[array[0]];
125.267 + // use the external form favored by Class.forName:
125.268 + className = className.replace('/', '.');
125.269 + visitor.visitConstantString(i, tag, className, array[0]);
125.270 + values[i] = className;
125.271 + break;
125.272 + }
125.273 + case CONSTANT_NameAndType: {
125.274 + String memberName = (String) values[array[0]];
125.275 + String signature = (String) values[array[1]];
125.276 + visitor.visitDescriptor(i, tag, memberName, signature,
125.277 + array[0], array[1]);
125.278 + values[i] = new String[] {memberName, signature};
125.279 + break;
125.280 + }
125.281 + case CONSTANT_Fieldref: // fall through:
125.282 + case CONSTANT_Methodref: // fall through:
125.283 + case CONSTANT_InterfaceMethodref: {
125.284 + Object className = values[array[0]];
125.285 + Object nameAndType = values[array[1]];
125.286 + if (!(className instanceof String) ||
125.287 + !(nameAndType instanceof String[])) {
125.288 + // one more pass is needed
125.289 + if (beg2 > i) beg2 = i;
125.290 + if (end2 < i) end2 = i;
125.291 + continue;
125.292 + }
125.293 + String[] nameAndTypeArray = (String[]) nameAndType;
125.294 + visitor.visitMemberRef(i, tag,
125.295 + (String)className,
125.296 + nameAndTypeArray[0],
125.297 + nameAndTypeArray[1],
125.298 + array[0], array[1]);
125.299 + values[i] = null;
125.300 + }
125.301 + break;
125.302 + default:
125.303 + continue;
125.304 + }
125.305 + }
125.306 + }
125.307 + }
125.308 +
125.309 + private static int getUnsignedByte(ByteBuffer buffer) {
125.310 + return buffer.get() & 0xFF;
125.311 + }
125.312 +
125.313 + private static int getUnsignedShort(ByteBuffer buffer) {
125.314 + int b1 = getUnsignedByte(buffer);
125.315 + int b2 = getUnsignedByte(buffer);
125.316 + return (b1 << 8) + (b2 << 0);
125.317 + }
125.318 +
125.319 + private static String getUTF8(ByteBuffer buffer, int utfLen, char[] charArray) throws InvalidConstantPoolFormatException {
125.320 + int utfLimit = buffer.position() + utfLen;
125.321 + int index = 0;
125.322 + while (buffer.position() < utfLimit) {
125.323 + int c = buffer.get() & 0xff;
125.324 + if (c > 127) {
125.325 + buffer.position(buffer.position() - 1);
125.326 + return getUTF8Extended(buffer, utfLimit, charArray, index);
125.327 + }
125.328 + charArray[index++] = (char)c;
125.329 + }
125.330 + return new String(charArray, 0, index);
125.331 + }
125.332 +
125.333 + private static String getUTF8Extended(ByteBuffer buffer, int utfLimit, char[] charArray, int index) throws InvalidConstantPoolFormatException {
125.334 + int c, c2, c3;
125.335 + while (buffer.position() < utfLimit) {
125.336 + c = buffer.get() & 0xff;
125.337 + switch (c >> 4) {
125.338 + case 0: case 1: case 2: case 3: case 4: case 5: case 6: case 7:
125.339 + /* 0xxxxxxx*/
125.340 + charArray[index++] = (char)c;
125.341 + break;
125.342 + case 12: case 13:
125.343 + /* 110x xxxx 10xx xxxx*/
125.344 + c2 = buffer.get();
125.345 + if ((c2 & 0xC0) != 0x80)
125.346 + throw new InvalidConstantPoolFormatException(
125.347 + "malformed input around byte " + buffer.position());
125.348 + charArray[index++] = (char)(((c & 0x1F) << 6) |
125.349 + (c2 & 0x3F));
125.350 + break;
125.351 + case 14:
125.352 + /* 1110 xxxx 10xx xxxx 10xx xxxx */
125.353 + c2 = buffer.get();
125.354 + c3 = buffer.get();
125.355 + if (((c2 & 0xC0) != 0x80) || ((c3 & 0xC0) != 0x80))
125.356 + throw new InvalidConstantPoolFormatException(
125.357 + "malformed input around byte " + (buffer.position()));
125.358 + charArray[index++] = (char)(((c & 0x0F) << 12) |
125.359 + ((c2 & 0x3F) << 6) |
125.360 + ((c3 & 0x3F) << 0));
125.361 + break;
125.362 + default:
125.363 + /* 10xx xxxx, 1111 xxxx */
125.364 + throw new InvalidConstantPoolFormatException(
125.365 + "malformed input around byte " + buffer.position());
125.366 + }
125.367 + }
125.368 + // The number of chars produced may be less than utflen
125.369 + return new String(charArray, 0, index);
125.370 + }
125.371 +}
126.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
126.2 +++ b/src/share/classes/sun/dyn/anon/ConstantPoolPatch.java Thu May 14 00:17:25 2009 -0700
126.3 @@ -0,0 +1,503 @@
126.4 +/*
126.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
126.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
126.7 + *
126.8 + * This code is free software; you can redistribute it and/or modify it
126.9 + * under the terms of the GNU General Public License version 2 only, as
126.10 + * published by the Free Software Foundation. Sun designates this
126.11 + * particular file as subject to the "Classpath" exception as provided
126.12 + * by Sun in the LICENSE file that accompanied this code.
126.13 + *
126.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
126.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
126.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
126.17 + * version 2 for more details (a copy is included in the LICENSE file that
126.18 + * accompanied this code).
126.19 + *
126.20 + * You should have received a copy of the GNU General Public License version
126.21 + * 2 along with this work; if not, write to the Free Software Foundation,
126.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
126.23 + *
126.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
126.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
126.26 + * have any questions.
126.27 + */
126.28 +
126.29 +package sun.dyn.anon;
126.30 +
126.31 +import java.io.IOException;
126.32 +import java.io.OutputStream;
126.33 +import java.util.Arrays;
126.34 +import java.util.HashSet;
126.35 +import java.util.IdentityHashMap;
126.36 +import java.util.Map;
126.37 +
126.38 +import static sun.dyn.anon.ConstantPoolVisitor.*;
126.39 +
126.40 +/** A class and its patched constant pool.
126.41 + *
126.42 + * This class allow to modify (patch) a constant pool
126.43 + * by changing the value of its entry.
126.44 + * Entry are referenced using index that can be get
126.45 + * by parsing the constant pool using
126.46 + * {@link ConstantPoolParser#parse(ConstantPoolVisitor)}.
126.47 + *
126.48 + * @see ConstantPoolVisitor
126.49 + * @see ConstantPoolParser#createPatch()
126.50 + */
126.51 +public class ConstantPoolPatch {
126.52 + final ConstantPoolParser outer;
126.53 + final Object[] patchArray;
126.54 +
126.55 + ConstantPoolPatch(ConstantPoolParser outer) {
126.56 + this.outer = outer;
126.57 + this.patchArray = new Object[outer.getLength()];
126.58 + }
126.59 +
126.60 + /** Create a {@link ConstantPoolParser} and
126.61 + * a {@link ConstantPoolPatch} in one step.
126.62 + * Equivalent to {@code new ConstantPoolParser(classFile).createPatch()}.
126.63 + *
126.64 + * @param classFile an array of bytes containing a class.
126.65 + * @see #ConstantPoolParser(Class)
126.66 + */
126.67 + public ConstantPoolPatch(byte[] classFile) throws InvalidConstantPoolFormatException {
126.68 + this(new ConstantPoolParser(classFile));
126.69 + }
126.70 +
126.71 + /** Create a {@link ConstantPoolParser} and
126.72 + * a {@link ConstantPoolPatch} in one step.
126.73 + * Equivalent to {@code new ConstantPoolParser(templateClass).createPatch()}.
126.74 + *
126.75 + * @param templateClass the class to parse.
126.76 + * @see #ConstantPoolParser(Class)
126.77 + */
126.78 + public ConstantPoolPatch(Class<?> templateClass) throws IOException, InvalidConstantPoolFormatException {
126.79 + this(new ConstantPoolParser(templateClass));
126.80 + }
126.81 +
126.82 +
126.83 + /** Creates a patch from an existing patch.
126.84 + * All changes are copied from that patch.
126.85 + * @param patch a patch
126.86 + *
126.87 + * @see ConstantPoolParser#createPatch()
126.88 + */
126.89 + public ConstantPoolPatch(ConstantPoolPatch patch) {
126.90 + outer = patch.outer;
126.91 + patchArray = patch.patchArray.clone();
126.92 + }
126.93 +
126.94 + /** Which parser built this patch? */
126.95 + public ConstantPoolParser getParser() {
126.96 + return outer;
126.97 + }
126.98 +
126.99 + /** Report the tag at the given index in the constant pool. */
126.100 + public byte getTag(int index) {
126.101 + return outer.getTag(index);
126.102 + }
126.103 +
126.104 + /** Report the current patch at the given index of the constant pool.
126.105 + * Null means no patch will be made.
126.106 + * To observe the unpatched entry at the given index, use
126.107 + * {@link #getParser()}{@code .}@link ConstantPoolParser#parse(ConstantPoolVisitor)}
126.108 + */
126.109 + public Object getPatch(int index) {
126.110 + Object value = patchArray[index];
126.111 + if (value == null) return null;
126.112 + switch (getTag(index)) {
126.113 + case CONSTANT_Fieldref:
126.114 + case CONSTANT_Methodref:
126.115 + case CONSTANT_InterfaceMethodref:
126.116 + if (value instanceof String)
126.117 + value = stripSemis(2, (String) value);
126.118 + break;
126.119 + case CONSTANT_NameAndType:
126.120 + if (value instanceof String)
126.121 + value = stripSemis(1, (String) value);
126.122 + break;
126.123 + }
126.124 + return value;
126.125 + }
126.126 +
126.127 + /** Clear all patches. */
126.128 + public void clear() {
126.129 + Arrays.fill(patchArray, null);
126.130 + }
126.131 +
126.132 + /** Clear one patch. */
126.133 + public void clear(int index) {
126.134 + patchArray[index] = null;
126.135 + }
126.136 +
126.137 + /** Produce the patches as an array. */
126.138 + public Object[] getPatches() {
126.139 + return patchArray.clone();
126.140 + }
126.141 +
126.142 + /** Produce the original constant pool as an array. */
126.143 + public Object[] getOriginalCP() throws InvalidConstantPoolFormatException {
126.144 + return getOriginalCP(0, patchArray.length, -1);
126.145 + }
126.146 +
126.147 + /** Walk the constant pool, applying patches using the given map.
126.148 + *
126.149 + * @param utf8Map Utf8 strings to modify, if encountered
126.150 + * @param classMap Classes (or their names) to modify, if encountered
126.151 + * @param valueMap Constant values to modify, if encountered
126.152 + * @param deleteUsedEntries if true, delete map entries that are used
126.153 + */
126.154 + public void putPatches(final Map<String,String> utf8Map,
126.155 + final Map<String,Object> classMap,
126.156 + final Map<Object,Object> valueMap,
126.157 + boolean deleteUsedEntries) throws InvalidConstantPoolFormatException {
126.158 + final HashSet<String> usedUtf8Keys;
126.159 + final HashSet<String> usedClassKeys;
126.160 + final HashSet<Object> usedValueKeys;
126.161 + if (deleteUsedEntries) {
126.162 + usedUtf8Keys = (utf8Map == null) ? null : new HashSet<String>();
126.163 + usedClassKeys = (classMap == null) ? null : new HashSet<String>();
126.164 + usedValueKeys = (valueMap == null) ? null : new HashSet<Object>();
126.165 + } else {
126.166 + usedUtf8Keys = null;
126.167 + usedClassKeys = null;
126.168 + usedValueKeys = null;
126.169 + }
126.170 +
126.171 + outer.parse(new ConstantPoolVisitor() {
126.172 +
126.173 + @Override
126.174 + public void visitUTF8(int index, byte tag, String utf8) {
126.175 + putUTF8(index, utf8Map.get(utf8));
126.176 + if (usedUtf8Keys != null) usedUtf8Keys.add(utf8);
126.177 + }
126.178 +
126.179 + @Override
126.180 + public void visitConstantValue(int index, byte tag, Object value) {
126.181 + putConstantValue(index, tag, valueMap.get(value));
126.182 + if (usedValueKeys != null) usedValueKeys.add(value);
126.183 + }
126.184 +
126.185 + @Override
126.186 + public void visitConstantString(int index, byte tag, String name, int nameIndex) {
126.187 + if (tag == CONSTANT_Class) {
126.188 + putConstantValue(index, tag, classMap.get(name));
126.189 + if (usedClassKeys != null) usedClassKeys.add(name);
126.190 + } else {
126.191 + assert(tag == CONSTANT_String);
126.192 + visitConstantValue(index, tag, name);
126.193 + }
126.194 + }
126.195 + });
126.196 + if (usedUtf8Keys != null) utf8Map.keySet().removeAll(usedUtf8Keys);
126.197 + if (usedClassKeys != null) classMap.keySet().removeAll(usedClassKeys);
126.198 + if (usedValueKeys != null) valueMap.keySet().removeAll(usedValueKeys);
126.199 + }
126.200 +
126.201 + Object[] getOriginalCP(final int startIndex,
126.202 + final int endIndex,
126.203 + final int tagMask) throws InvalidConstantPoolFormatException {
126.204 + final Object[] cpArray = new Object[endIndex - startIndex];
126.205 + outer.parse(new ConstantPoolVisitor() {
126.206 +
126.207 + void show(int index, byte tag, Object value) {
126.208 + if (index < startIndex || index >= endIndex) return;
126.209 + if (((1 << tag) & tagMask) == 0) return;
126.210 + cpArray[index - startIndex] = value;
126.211 + }
126.212 +
126.213 + @Override
126.214 + public void visitUTF8(int index, byte tag, String utf8) {
126.215 + show(index, tag, utf8);
126.216 + }
126.217 +
126.218 + @Override
126.219 + public void visitConstantValue(int index, byte tag, Object value) {
126.220 + assert(tag != CONSTANT_String);
126.221 + show(index, tag, value);
126.222 + }
126.223 +
126.224 + @Override
126.225 + public void visitConstantString(int index, byte tag,
126.226 + String value, int j) {
126.227 + show(index, tag, value);
126.228 + }
126.229 +
126.230 + @Override
126.231 + public void visitMemberRef(int index, byte tag,
126.232 + String className, String memberName,
126.233 + String signature,
126.234 + int j, int k) {
126.235 + show(index, tag, new String[]{ className, memberName, signature });
126.236 + }
126.237 +
126.238 + @Override
126.239 + public void visitDescriptor(int index, byte tag,
126.240 + String memberName, String signature,
126.241 + int j, int k) {
126.242 + show(index, tag, new String[]{ memberName, signature });
126.243 + }
126.244 + });
126.245 + return cpArray;
126.246 + }
126.247 +
126.248 + /** Write the head (header plus constant pool)
126.249 + * of the patched class file to the indicated stream.
126.250 + */
126.251 + void writeHead(OutputStream out) throws IOException {
126.252 + outer.writePatchedHead(out, patchArray);
126.253 + }
126.254 +
126.255 + /** Write the tail (everything after the constant pool)
126.256 + * of the patched class file to the indicated stream.
126.257 + */
126.258 + void writeTail(OutputStream out) throws IOException {
126.259 + outer.writeTail(out);
126.260 + }
126.261 +
126.262 + private void checkConstantTag(byte tag, Object value) {
126.263 + if (value == null)
126.264 + throw new IllegalArgumentException(
126.265 + "invalid null constant value");
126.266 + if (classForTag(tag) != value.getClass())
126.267 + throw new IllegalArgumentException(
126.268 + "invalid constant value"
126.269 + + (tag == CONSTANT_None ? ""
126.270 + : " for tag "+tagName(tag))
126.271 + + " of class "+value.getClass());
126.272 + }
126.273 +
126.274 + private void checkTag(int index, byte putTag) {
126.275 + byte tag = outer.tags[index];
126.276 + if (tag != putTag)
126.277 + throw new IllegalArgumentException(
126.278 + "invalid put operation"
126.279 + + " for " + tagName(putTag)
126.280 + + " at index " + index + " found " + tagName(tag));
126.281 + }
126.282 +
126.283 + private void checkTagMask(int index, int tagBitMask) {
126.284 + byte tag = outer.tags[index];
126.285 + int tagBit = ((tag & 0x1F) == tag) ? (1 << tag) : 0;
126.286 + if ((tagBit & tagBitMask) == 0)
126.287 + throw new IllegalArgumentException(
126.288 + "invalid put operation"
126.289 + + " at index " + index + " found " + tagName(tag));
126.290 + }
126.291 +
126.292 + private static void checkMemberName(String memberName) {
126.293 + if (memberName.indexOf(';') >= 0)
126.294 + throw new IllegalArgumentException("memberName " + memberName + " contains a ';'");
126.295 + }
126.296 +
126.297 + /** Set the entry of the constant pool indexed by index to
126.298 + * a new string.
126.299 + *
126.300 + * @param index an index to a constant pool entry containing a
126.301 + * {@link ConstantPoolVisitor#CONSTANT_Utf8} value.
126.302 + * @param utf8 a string
126.303 + *
126.304 + * @see ConstantPoolVisitor#visitUTF8(int, byte, String)
126.305 + */
126.306 + public void putUTF8(int index, String utf8) {
126.307 + if (utf8 == null) { clear(index); return; }
126.308 + checkTag(index, CONSTANT_Utf8);
126.309 + patchArray[index] = utf8;
126.310 + }
126.311 +
126.312 + /** Set the entry of the constant pool indexed by index to
126.313 + * a new value, depending on its dynamic type.
126.314 + *
126.315 + * @param index an index to a constant pool entry containing a
126.316 + * one of the following structures:
126.317 + * {@link ConstantPoolVisitor#CONSTANT_Integer},
126.318 + * {@link ConstantPoolVisitor#CONSTANT_Float},
126.319 + * {@link ConstantPoolVisitor#CONSTANT_Long},
126.320 + * {@link ConstantPoolVisitor#CONSTANT_Double},
126.321 + * {@link ConstantPoolVisitor#CONSTANT_String}, or
126.322 + * {@link ConstantPoolVisitor#CONSTANT_Class}
126.323 + * @param value a boxed int, float, long or double; or a string or class object
126.324 + * @throws IllegalArgumentException if the type of the constant does not
126.325 + * match the constant pool entry type,
126.326 + * as reported by {@link #getTag(int)}
126.327 + *
126.328 + * @see #putConstantValue(int, byte, Object)
126.329 + * @see ConstantPoolVisitor#visitConstantValue(int, byte, Object)
126.330 + * @see ConstantPoolVisitor#visitConstantString(int, byte, String, int)
126.331 + */
126.332 + public void putConstantValue(int index, Object value) {
126.333 + if (value == null) { clear(index); return; }
126.334 + byte tag = tagForConstant(value.getClass());
126.335 + checkConstantTag(tag, value);
126.336 + checkTag(index, tag);
126.337 + patchArray[index] = value;
126.338 + }
126.339 +
126.340 + /** Set the entry of the constant pool indexed by index to
126.341 + * a new value.
126.342 + *
126.343 + * @param index an index to a constant pool entry matching the given tag
126.344 + * @param tag one of the following values:
126.345 + * {@link ConstantPoolVisitor#CONSTANT_Integer},
126.346 + * {@link ConstantPoolVisitor#CONSTANT_Float},
126.347 + * {@link ConstantPoolVisitor#CONSTANT_Long},
126.348 + * {@link ConstantPoolVisitor#CONSTANT_Double},
126.349 + * {@link ConstantPoolVisitor#CONSTANT_String}, or
126.350 + * {@link ConstantPoolVisitor#CONSTANT_Class}
126.351 + * @param value a boxed number, string, or class object
126.352 + * @throws IllegalArgumentException if the type of the constant does not
126.353 + * match the constant pool entry type, or if a class name contains
126.354 + * '/' or ';'
126.355 + *
126.356 + * @see #putConstantValue(int, Object)
126.357 + * @see ConstantPoolVisitor#visitConstantValue(int, byte, Object)
126.358 + * @see ConstantPoolVisitor#visitConstantString(int, byte, String, int)
126.359 + */
126.360 + public void putConstantValue(int index, byte tag, Object value) {
126.361 + if (value == null) { clear(index); return; }
126.362 + checkTag(index, tag);
126.363 + if (tag == CONSTANT_Class && value instanceof String) {
126.364 + checkClassName((String) value);
126.365 + } else if (tag == CONSTANT_String) {
126.366 + // the JVM accepts any object as a patch for a string
126.367 + } else {
126.368 + // make sure the incoming value is the right type
126.369 + checkConstantTag(tag, value);
126.370 + }
126.371 + checkTag(index, tag);
126.372 + patchArray[index] = value;
126.373 + }
126.374 +
126.375 + /** Set the entry of the constant pool indexed by index to
126.376 + * a new {@link ConstantPoolVisitor#CONSTANT_NameAndType} value.
126.377 + *
126.378 + * @param index an index to a constant pool entry containing a
126.379 + * {@link ConstantPoolVisitor#CONSTANT_NameAndType} value.
126.380 + * @param memberName a memberName
126.381 + * @param signature a signature
126.382 + * @throws IllegalArgumentException if memberName contains the character ';'
126.383 + *
126.384 + * @see ConstantPoolVisitor#visitDescriptor(int, byte, String, String, int, int)
126.385 + */
126.386 + public void putDescriptor(int index, String memberName, String signature) {
126.387 + checkTag(index, CONSTANT_NameAndType);
126.388 + checkMemberName(memberName);
126.389 + patchArray[index] = addSemis(memberName, signature);
126.390 + }
126.391 +
126.392 + /** Set the entry of the constant pool indexed by index to
126.393 + * a new {@link ConstantPoolVisitor#CONSTANT_Fieldref},
126.394 + * {@link ConstantPoolVisitor#CONSTANT_Methodref}, or
126.395 + * {@link ConstantPoolVisitor#CONSTANT_InterfaceMethodref} value.
126.396 + *
126.397 + * @param index an index to a constant pool entry containing a member reference
126.398 + * @param className a class name
126.399 + * @param memberName a field or method name
126.400 + * @param signature a field or method signature
126.401 + * @throws IllegalArgumentException if memberName contains the character ';'
126.402 + * or signature is not a correct signature
126.403 + *
126.404 + * @see ConstantPoolVisitor#visitMemberRef(int, byte, String, String, String, int, int)
126.405 + */
126.406 + public void putMemberRef(int index, byte tag,
126.407 + String className, String memberName, String signature) {
126.408 + checkTagMask(tag, CONSTANT_MemberRef_MASK);
126.409 + checkTag(index, tag);
126.410 + checkClassName(className);
126.411 + checkMemberName(memberName);
126.412 + if (signature.startsWith("(") == (tag == CONSTANT_Fieldref))
126.413 + throw new IllegalArgumentException("bad signature: "+signature);
126.414 + patchArray[index] = addSemis(className, memberName, signature);
126.415 + }
126.416 +
126.417 + static private final int CONSTANT_MemberRef_MASK =
126.418 + CONSTANT_Fieldref
126.419 + | CONSTANT_Methodref
126.420 + | CONSTANT_InterfaceMethodref;
126.421 +
126.422 + private static final Map<Class<?>, Byte> CONSTANT_VALUE_CLASS_TAG
126.423 + = new IdentityHashMap<Class<?>, Byte>();
126.424 + private static final Class[] CONSTANT_VALUE_CLASS = new Class[16];
126.425 + static {
126.426 + Object[][] values = {
126.427 + {Integer.class, CONSTANT_Integer},
126.428 + {Long.class, CONSTANT_Long},
126.429 + {Float.class, CONSTANT_Float},
126.430 + {Double.class, CONSTANT_Double},
126.431 + {String.class, CONSTANT_String},
126.432 + {Class.class, CONSTANT_Class}
126.433 + };
126.434 + for (Object[] value : values) {
126.435 + Class<?> cls = (Class<?>)value[0];
126.436 + Byte tag = (Byte) value[1];
126.437 + CONSTANT_VALUE_CLASS_TAG.put(cls, tag);
126.438 + CONSTANT_VALUE_CLASS[(byte)tag] = cls;
126.439 + }
126.440 + }
126.441 +
126.442 + static Class<?> classForTag(byte tag) {
126.443 + if ((tag & 0xFF) >= CONSTANT_VALUE_CLASS.length)
126.444 + return null;
126.445 + return CONSTANT_VALUE_CLASS[tag];
126.446 + }
126.447 +
126.448 + static byte tagForConstant(Class<?> cls) {
126.449 + Byte tag = CONSTANT_VALUE_CLASS_TAG.get(cls);
126.450 + return (tag == null) ? CONSTANT_None : (byte)tag;
126.451 + }
126.452 +
126.453 + private static void checkClassName(String className) {
126.454 + if (className.indexOf('/') >= 0 || className.indexOf(';') >= 0)
126.455 + throw new IllegalArgumentException("invalid class name " + className);
126.456 + }
126.457 +
126.458 + static String addSemis(String name, String... names) {
126.459 + StringBuilder buf = new StringBuilder(name.length() * 5);
126.460 + buf.append(name);
126.461 + for (String name2 : names) {
126.462 + buf.append(';').append(name2);
126.463 + }
126.464 + String res = buf.toString();
126.465 + assert(stripSemis(names.length, res)[0].equals(name));
126.466 + assert(stripSemis(names.length, res)[1].equals(names[0]));
126.467 + assert(names.length == 1 ||
126.468 + stripSemis(names.length, res)[2].equals(names[1]));
126.469 + return res;
126.470 + }
126.471 +
126.472 + static String[] stripSemis(int count, String string) {
126.473 + String[] res = new String[count+1];
126.474 + int pos = 0;
126.475 + for (int i = 0; i < count; i++) {
126.476 + int pos2 = string.indexOf(';', pos);
126.477 + if (pos2 < 0) pos2 = string.length(); // yuck
126.478 + res[i] = string.substring(pos, pos2);
126.479 + pos = pos2;
126.480 + }
126.481 + res[count] = string.substring(pos);
126.482 + return res;
126.483 + }
126.484 +
126.485 + public String toString() {
126.486 + StringBuilder buf = new StringBuilder(this.getClass().getName());
126.487 + buf.append("{");
126.488 + Object[] origCP = null;
126.489 + for (int i = 0; i < patchArray.length; i++) {
126.490 + if (patchArray[i] == null) continue;
126.491 + if (origCP != null) {
126.492 + buf.append(", ");
126.493 + } else {
126.494 + try {
126.495 + origCP = getOriginalCP();
126.496 + } catch (InvalidConstantPoolFormatException ee) {
126.497 + origCP = new Object[0];
126.498 + }
126.499 + }
126.500 + Object orig = (i < origCP.length) ? origCP[i] : "?";
126.501 + buf.append(orig).append("=").append(patchArray[i]);
126.502 + }
126.503 + buf.append("}");
126.504 + return buf.toString();
126.505 + }
126.506 +}
127.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
127.2 +++ b/src/share/classes/sun/dyn/anon/ConstantPoolVisitor.java Thu May 14 00:17:25 2009 -0700
127.3 @@ -0,0 +1,192 @@
127.4 +/*
127.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
127.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
127.7 + *
127.8 + * This code is free software; you can redistribute it and/or modify it
127.9 + * under the terms of the GNU General Public License version 2 only, as
127.10 + * published by the Free Software Foundation. Sun designates this
127.11 + * particular file as subject to the "Classpath" exception as provided
127.12 + * by Sun in the LICENSE file that accompanied this code.
127.13 + *
127.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
127.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
127.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
127.17 + * version 2 for more details (a copy is included in the LICENSE file that
127.18 + * accompanied this code).
127.19 + *
127.20 + * You should have received a copy of the GNU General Public License version
127.21 + * 2 along with this work; if not, write to the Free Software Foundation,
127.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
127.23 + *
127.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
127.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
127.26 + * have any questions.
127.27 + */
127.28 +
127.29 +package sun.dyn.anon;
127.30 +
127.31 +/**
127.32 + * A visitor called by {@link ConstantPoolParser#parse(ConstantPoolVisitor)}
127.33 + * when a constant pool entry is parsed.
127.34 + * <p>
127.35 + * A visit* method is called when a constant pool entry is parsed.
127.36 + * The first argument is always the constant pool index.
127.37 + * The second argument is always the constant pool tag,
127.38 + * even for methods like {@link #visitUTF8(int, byte, String)} which only apply to one tag.
127.39 + * String arguments refer to Utf8 or NameAndType entries declared elsewhere,
127.40 + * and are always accompanied by the indexes of those entries.
127.41 + * <p>
127.42 + * The order of the calls to the visit* methods is not necessarily related
127.43 + * to the order of the entries in the constant pool.
127.44 + * If one entry has a reference to another entry, the latter (lower-level)
127.45 + * entry will be visited first.
127.46 + * <p>
127.47 + * The following table shows the relation between constant pool entry
127.48 + * types and the corresponding visit* methods:
127.49 + *
127.50 + * <table border=1 cellpadding=5 summary="constant pool visitor methods">
127.51 + * <tr><th>Tag(s)</th><th>Method</th></tr>
127.52 + * <tr>
127.53 + * <td>{@link #CONSTANT_Utf8}</td>
127.54 + * <td>{@link #visitUTF8(int, byte, String)}</td>
127.55 + * </tr><tr>
127.56 + * <td>{@link #CONSTANT_Integer}, {@link #CONSTANT_Float},
127.57 + * {@link #CONSTANT_Long}, {@link #CONSTANT_Double}</td>
127.58 + * <td>{@link #visitConstantValue(int, byte, Object)}</td>
127.59 + * </tr><tr>
127.60 + * <td>{@link #CONSTANT_String}, {@link #CONSTANT_Class}</td>
127.61 + * <td>{@link #visitConstantString(int, byte, String, int)}</td>
127.62 + * </tr><tr>
127.63 + * <td>{@link #CONSTANT_NameAndType}</td>
127.64 + * <td>{@link #visitDescriptor(int, byte, String, String, int, int)}</td>
127.65 + * </tr><tr>
127.66 + * <td>{@link #CONSTANT_Fieldref},
127.67 + * {@link #CONSTANT_Methodref},
127.68 + * {@link #CONSTANT_InterfaceMethodref}</td>
127.69 + * <td>{@link #visitMemberRef(int, byte, String, String, String, int, int)}</td>
127.70 + * </tr>
127.71 + * </table>
127.72 + *
127.73 + * @see ConstantPoolPatch
127.74 + * @author Remi Forax
127.75 + * @author jrose
127.76 + */
127.77 +public class ConstantPoolVisitor {
127.78 + /** Called each time an UTF8 constant pool entry is found.
127.79 + * @param index the constant pool index
127.80 + * @param tag always {@link #CONSTANT_Utf8}
127.81 + * @param utf8 string encoded in modified UTF-8 format passed as a {@code String}
127.82 + *
127.83 + * @see ConstantPoolPatch#putUTF8(int, String)
127.84 + */
127.85 + public void visitUTF8(int index, byte tag, String utf8) {
127.86 + // do nothing
127.87 + }
127.88 +
127.89 + /** Called for each constant pool entry that encodes an integer,
127.90 + * a float, a long, or a double.
127.91 + * Constant strings and classes are not managed by this method but
127.92 + * by {@link #visitConstantString(int, byte, String, int)}.
127.93 + *
127.94 + * @param index the constant pool index
127.95 + * @param tag one of {@link #CONSTANT_Integer},
127.96 + * {@link #CONSTANT_Float},
127.97 + * {@link #CONSTANT_Long},
127.98 + * or {@link #CONSTANT_Double}
127.99 + * @param value encoded value
127.100 + *
127.101 + * @see ConstantPoolPatch#putConstantValue(int, Object)
127.102 + */
127.103 + public void visitConstantValue(int index, byte tag, Object value) {
127.104 + // do nothing
127.105 + }
127.106 +
127.107 + /** Called for each constant pool entry that encodes a string or a class.
127.108 + * @param index the constant pool index
127.109 + * @param tag one of {@link #CONSTANT_String},
127.110 + * {@link #CONSTANT_Class},
127.111 + * @param name string body or class name (using dot separator)
127.112 + * @param nameIndex the index of the Utf8 string for the name
127.113 + *
127.114 + * @see ConstantPoolPatch#putConstantValue(int, byte, Object)
127.115 + */
127.116 + public void visitConstantString(int index, byte tag,
127.117 + String name, int nameIndex) {
127.118 + // do nothing
127.119 + }
127.120 +
127.121 + /** Called for each constant pool entry that encodes a name and type.
127.122 + * @param index the constant pool index
127.123 + * @param tag always {@link #CONSTANT_NameAndType}
127.124 + * @param memberName a field or method name
127.125 + * @param signature the member signature
127.126 + * @param memberNameIndex index of the Utf8 string for the member name
127.127 + * @param signatureIndex index of the Utf8 string for the signature
127.128 + *
127.129 + * @see ConstantPoolPatch#putDescriptor(int, String, String)
127.130 + */
127.131 + public void visitDescriptor(int index, byte tag,
127.132 + String memberName, String signature,
127.133 + int memberNameIndex, int signatureIndex) {
127.134 + // do nothing
127.135 + }
127.136 +
127.137 + /** Called for each constant pool entry that encodes a field or method.
127.138 + * @param index the constant pool index
127.139 + * @param tag one of {@link #CONSTANT_Fieldref},
127.140 + * or {@link #CONSTANT_Methodref},
127.141 + * or {@link #CONSTANT_InterfaceMethodref}
127.142 + * @param className the class name (using dot separator)
127.143 + * @param memberName name of the field or method
127.144 + * @param signature the field or method signature
127.145 + * @param classNameIndex index of the Utf8 string for the class name
127.146 + * @param descriptorIndex index of the NameAndType descriptor constant
127.147 + *
127.148 + * @see ConstantPoolPatch#putMemberRef(int, byte, String, String, String)
127.149 + */
127.150 + public void visitMemberRef(int index, byte tag,
127.151 + String className, String memberName, String signature,
127.152 + int classNameIndex, int descriptorIndex) {
127.153 + // do nothing
127.154 + }
127.155 +
127.156 + public static final byte
127.157 + CONSTANT_None = 0,
127.158 + CONSTANT_Utf8 = 1,
127.159 + //CONSTANT_Unicode = 2, /* unused */
127.160 + CONSTANT_Integer = 3,
127.161 + CONSTANT_Float = 4,
127.162 + CONSTANT_Long = 5,
127.163 + CONSTANT_Double = 6,
127.164 + CONSTANT_Class = 7,
127.165 + CONSTANT_String = 8,
127.166 + CONSTANT_Fieldref = 9,
127.167 + CONSTANT_Methodref = 10,
127.168 + CONSTANT_InterfaceMethodref = 11,
127.169 + CONSTANT_NameAndType = 12;
127.170 +
127.171 + private static String[] TAG_NAMES = {
127.172 + "Empty",
127.173 + "Utf8",
127.174 + null, //"Unicode",
127.175 + "Integer",
127.176 + "Float",
127.177 + "Long",
127.178 + "Double",
127.179 + "Class",
127.180 + "String",
127.181 + "Fieldref",
127.182 + "Methodref",
127.183 + "InterfaceMethodref",
127.184 + "NameAndType"
127.185 + };
127.186 +
127.187 + public static String tagName(byte tag) {
127.188 + String name = null;
127.189 + if ((tag & 0xFF) < TAG_NAMES.length)
127.190 + name = TAG_NAMES[tag];
127.191 + if (name == null)
127.192 + name = "Unknown#"+(tag&0xFF);
127.193 + return name;
127.194 + }
127.195 +}
128.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
128.2 +++ b/src/share/classes/sun/dyn/anon/InvalidConstantPoolFormatException.java Thu May 14 00:17:25 2009 -0700
128.3 @@ -0,0 +1,45 @@
128.4 +/*
128.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
128.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
128.7 + *
128.8 + * This code is free software; you can redistribute it and/or modify it
128.9 + * under the terms of the GNU General Public License version 2 only, as
128.10 + * published by the Free Software Foundation. Sun designates this
128.11 + * particular file as subject to the "Classpath" exception as provided
128.12 + * by Sun in the LICENSE file that accompanied this code.
128.13 + *
128.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
128.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
128.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
128.17 + * version 2 for more details (a copy is included in the LICENSE file that
128.18 + * accompanied this code).
128.19 + *
128.20 + * You should have received a copy of the GNU General Public License version
128.21 + * 2 along with this work; if not, write to the Free Software Foundation,
128.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
128.23 + *
128.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
128.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
128.26 + * have any questions.
128.27 + */
128.28 +
128.29 +package sun.dyn.anon;
128.30 +
128.31 +/** Exception used when there is an error in the constant pool
128.32 + * format.
128.33 + */
128.34 +public class InvalidConstantPoolFormatException extends Exception {
128.35 + private static final long serialVersionUID=-6103888330523770949L;
128.36 +
128.37 + public InvalidConstantPoolFormatException(String message,Throwable cause) {
128.38 + super(message,cause);
128.39 + }
128.40 +
128.41 + public InvalidConstantPoolFormatException(String message) {
128.42 + super(message);
128.43 + }
128.44 +
128.45 + public InvalidConstantPoolFormatException(Throwable cause) {
128.46 + super(cause);
128.47 + }
128.48 +}
129.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
129.2 +++ b/src/share/classes/sun/dyn/empty/Empty.java Thu May 14 00:17:25 2009 -0700
129.3 @@ -0,0 +1,36 @@
129.4 +/*
129.5 + * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
129.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
129.7 + *
129.8 + * This code is free software; you can redistribute it and/or modify it
129.9 + * under the terms of the GNU General Public License version 2 only, as
129.10 + * published by the Free Software Foundation. Sun designates this
129.11 + * particular file as subject to the "Classpath" exception as provided
129.12 + * by Sun in the LICENSE file that accompanied this code.
129.13 + *
129.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
129.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
129.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
129.17 + * version 2 for more details (a copy is included in the LICENSE file that
129.18 + * accompanied this code).
129.19 + *
129.20 + * You should have received a copy of the GNU General Public License version
129.21 + * 2 along with this work; if not, write to the Free Software Foundation,
129.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
129.23 + *
129.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
129.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
129.26 + * have any questions.
129.27 + */
129.28 +
129.29 +package sun.dyn.empty;
129.30 +
129.31 +/**
129.32 + * An empty class in an empty package.
129.33 + * Used as a proxy for unprivileged code, since making access checks
129.34 + * against it will only succeed against public methods in public types.
129.35 + * @author jrose
129.36 + */
129.37 +public class Empty {
129.38 + private Empty() { throw new InternalError(); }
129.39 +}
130.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
130.2 +++ b/src/share/classes/sun/dyn/package-info.java Thu May 14 00:17:25 2009 -0700
130.3 @@ -0,0 +1,35 @@
130.4 +/*
130.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
130.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
130.7 + *
130.8 + * This code is free software; you can redistribute it and/or modify it
130.9 + * under the terms of the GNU General Public License version 2 only, as
130.10 + * published by the Free Software Foundation. Sun designates this
130.11 + * particular file as subject to the "Classpath" exception as provided
130.12 + * by Sun in the LICENSE file that accompanied this code.
130.13 + *
130.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
130.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
130.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
130.17 + * version 2 for more details (a copy is included in the LICENSE file that
130.18 + * accompanied this code).
130.19 + *
130.20 + * You should have received a copy of the GNU General Public License version
130.21 + * 2 along with this work; if not, write to the Free Software Foundation,
130.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
130.23 + *
130.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
130.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
130.26 + * have any questions.
130.27 + */
130.28 +
130.29 +/**
130.30 + * Implementation details for JSR 292 RI, package java.dyn.
130.31 + * This particular version is specific to Hotspot.
130.32 + * There is also a backport version of this sub-package which uses reflection,
130.33 + * and can therefore run (slowly) on older versions of Java.
130.34 + * Other JVM vendors may create their own versions of this sub-package.
130.35 + * @author jrose
130.36 + */
130.37 +
130.38 +package sun.dyn;
131.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
131.2 +++ b/src/share/classes/sun/dyn/util/BytecodeName.java Thu May 14 00:17:25 2009 -0700
131.3 @@ -0,0 +1,711 @@
131.4 +/*
131.5 + * Copyright 2007-2009 Sun Microsystems, Inc. All Rights Reserved.
131.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
131.7 + *
131.8 + * This code is free software; you can redistribute it and/or modify it
131.9 + * under the terms of the GNU General Public License version 2 only, as
131.10 + * published by the Free Software Foundation. Sun designates this
131.11 + * particular file as subject to the "Classpath" exception as provided
131.12 + * by Sun in the LICENSE file that accompanied this code.
131.13 + *
131.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
131.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
131.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
131.17 + * version 2 for more details (a copy is included in the LICENSE file that
131.18 + * accompanied this code).
131.19 + *
131.20 + * You should have received a copy of the GNU General Public License version
131.21 + * 2 along with this work; if not, write to the Free Software Foundation,
131.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
131.23 + *
131.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
131.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
131.26 + * have any questions.
131.27 + */
131.28 +
131.29 +package sun.dyn.util;
131.30 +
131.31 +/**
131.32 + * Utility routines for dealing with bytecode-level names.
131.33 + * Includes universal mangling rules for the JVM.
131.34 + *
131.35 + * <h3>Avoiding Dangerous Characters </h3>
131.36 + *
131.37 + * <p>
131.38 + * The JVM defines a very small set of characters which are illegal
131.39 + * in name spellings. We will slightly extend and regularize this set
131.40 + * into a group of <cite>dangerous characters</cite>.
131.41 + * These characters will then be replaced, in mangled names, by escape sequences.
131.42 + * In addition, accidental escape sequences must be further escaped.
131.43 + * Finally, a special prefix will be applied if and only if
131.44 + * the mangling would otherwise fail to begin with the escape character.
131.45 + * This happens to cover the corner case of the null string,
131.46 + * and also clearly marks symbols which need demangling.
131.47 + * </p>
131.48 + * <p>
131.49 + * Dangerous characters are the union of all characters forbidden
131.50 + * or otherwise restricted by the JVM specification,
131.51 + * plus their mates, if they are brackets
131.52 + * (<code><big><b>[</b></big></code> and <code><big><b>]</b></big></code>,
131.53 + * <code><big><b><</b></big></code> and <code><big><b>></b></big></code>),
131.54 + * plus, arbitrarily, the colon character <code><big><b>:</b></big></code>.
131.55 + * There is no distinction between type, method, and field names.
131.56 + * This makes it easier to convert between mangled names of different
131.57 + * types, since they do not need to be decoded (demangled).
131.58 + * </p>
131.59 + * <p>
131.60 + * The escape character is backslash <code><big><b>\</b></big></code>
131.61 + * (also known as reverse solidus).
131.62 + * This character is, until now, unheard of in bytecode names,
131.63 + * but traditional in the proposed role.
131.64 + *
131.65 + * </p>
131.66 + * <h3> Replacement Characters </h3>
131.67 + *
131.68 + *
131.69 + * <p>
131.70 + * Every escape sequence is two characters
131.71 + * (in fact, two UTF8 bytes) beginning with
131.72 + * the escape character and followed by a
131.73 + * <cite>replacement character</cite>.
131.74 + * (Since the replacement character is never a backslash,
131.75 + * iterated manglings do not double in size.)
131.76 + * </p>
131.77 + * <p>
131.78 + * Each dangerous character has some rough visual similarity
131.79 + * to its corresponding replacement character.
131.80 + * This makes mangled symbols easier to recognize by sight.
131.81 + * </p>
131.82 + * <p>
131.83 + * The dangerous characters are
131.84 + * <code><big><b>/</b></big></code> (forward slash, used to delimit package components),
131.85 + * <code><big><b>.</b></big></code> (dot, also a package delimiter),
131.86 + * <code><big><b>;</b></big></code> (semicolon, used in signatures),
131.87 + * <code><big><b>$</b></big></code> (dollar, used in inner classes and synthetic members),
131.88 + * <code><big><b><</b></big></code> (left angle),
131.89 + * <code><big><b>></b></big></code> (right angle),
131.90 + * <code><big><b>[</b></big></code> (left square bracket, used in array types),
131.91 + * <code><big><b>]</b></big></code> (right square bracket, reserved in this scheme for language use),
131.92 + * and <code><big><b>:</b></big></code> (colon, reserved in this scheme for language use).
131.93 + * Their replacements are, respectively,
131.94 + * <code><big><b>|</b></big></code> (vertical bar),
131.95 + * <code><big><b>,</b></big></code> (comma),
131.96 + * <code><big><b>?</b></big></code> (question mark),
131.97 + * <code><big><b>%</b></big></code> (percent),
131.98 + * <code><big><b>^</b></big></code> (caret),
131.99 + * <code><big><b>_</b></big></code> (underscore), and
131.100 + * <code><big><b>{</b></big></code> (left curly bracket),
131.101 + * <code><big><b>}</b></big></code> (right curly bracket),
131.102 + * <code><big><b>!</b></big></code> (exclamation mark).
131.103 + * In addition, the replacement character for the escape character itself is
131.104 + * <code><big><b>-</b></big></code> (hyphen),
131.105 + * and the replacement character for the null prefix is
131.106 + * <code><big><b>=</b></big></code> (equal sign).
131.107 + * </p>
131.108 + * <p>
131.109 + * An escape character <code><big><b>\</b></big></code>
131.110 + * followed by any of these replacement characters
131.111 + * is an escape sequence, and there are no other escape sequences.
131.112 + * An equal sign is only part of an escape sequence
131.113 + * if it is the second character in the whole string, following a backslash.
131.114 + * Two consecutive backslashes do <em>not</em> form an escape sequence.
131.115 + * </p>
131.116 + * <p>
131.117 + * Each escape sequence replaces a so-called <cite>original character</cite>
131.118 + * which is either one of the dangerous characters or the escape character.
131.119 + * A null prefix replaces an initial null string, not a character.
131.120 + * </p>
131.121 + * <p>
131.122 + * All this implies that escape sequences cannot overlap and may be
131.123 + * determined all at once for a whole string. Note that a spelling
131.124 + * string can contain <cite>accidental escapes</cite>, apparent escape
131.125 + * sequences which must not be interpreted as manglings.
131.126 + * These are disabled by replacing their leading backslash with an
131.127 + * escape sequence (<code><big><b>\-</b></big></code>). To mangle a string, three logical steps
131.128 + * are required, though they may be carried out in one pass:
131.129 + * </p>
131.130 + * <ol>
131.131 + * <li>In each accidental escape, replace the backslash with an escape sequence
131.132 + * (<code><big><b>\-</b></big></code>).</li>
131.133 + * <li>Replace each dangerous character with an escape sequence
131.134 + * (<code><big><b>\|</b></big></code> for <code><big><b>/</b></big></code>, etc.).</li>
131.135 + * <li>If the first two steps introduced any change, <em>and</em>
131.136 + * if the string does not already begin with a backslash, prepend a null prefix (<code><big><b>\=</b></big></code>).</li>
131.137 + * </ol>
131.138 + *
131.139 + * To demangle a mangled string that begins with an escape,
131.140 + * remove any null prefix, and then replace (in parallel)
131.141 + * each escape sequence by its original character.
131.142 + * <p>Spelling strings which contain accidental
131.143 + * escapes <em>must</em> have them replaced, even if those
131.144 + * strings do not contain dangerous characters.
131.145 + * This restriction means that mangling a string always
131.146 + * requires a scan of the string for escapes.
131.147 + * But then, a scan would be required anyway,
131.148 + * to check for dangerous characters.
131.149 + *
131.150 + * </p>
131.151 + * <h3> Nice Properties </h3>
131.152 + *
131.153 + * <p>
131.154 + * If a bytecode name does not contain any escape sequence,
131.155 + * demangling is a no-op: The string demangles to itself.
131.156 + * Such a string is called <cite>self-mangling</cite>.
131.157 + * Almost all strings are self-mangling.
131.158 + * In practice, to demangle almost any name “found in nature”,
131.159 + * simply verify that it does not begin with a backslash.
131.160 + * </p>
131.161 + * <p>
131.162 + * Mangling is a one-to-one function, while demangling
131.163 + * is a many-to-one function.
131.164 + * A mangled string is defined as <cite>validly mangled</cite> if
131.165 + * it is in fact the unique mangling of its spelling string.
131.166 + * Three examples of invalidly mangled strings are <code><big><b>\=foo</b></big></code>,
131.167 + * <code><big><b>\-bar</b></big></code>, and <code><big><b>baz\!</b></big></code>, which demangle to <code><big><b>foo</b></big></code>, <code><big><b>\bar</b></big></code>, and
131.168 + * <code><big><b>baz\!</b></big></code>, but then remangle to <code><big><b>foo</b></big></code>, <code><big><b>\bar</b></big></code>, and <code><big><b>\=baz\-!</b></big></code>.
131.169 + * If a language back-end or runtime is using mangled names,
131.170 + * it should never present an invalidly mangled bytecode
131.171 + * name to the JVM. If the runtime encounters one,
131.172 + * it should also report an error, since such an occurrence
131.173 + * probably indicates a bug in name encoding which
131.174 + * will lead to errors in linkage.
131.175 + * However, this note does not propose that the JVM verifier
131.176 + * detect invalidly mangled names.
131.177 + * </p>
131.178 + * <p>
131.179 + * As a result of these rules, it is a simple matter to
131.180 + * compute validly mangled substrings and concatenations
131.181 + * of validly mangled strings, and (with a little care)
131.182 + * these correspond to corresponding operations on their
131.183 + * spelling strings.
131.184 + * </p>
131.185 + * <ul>
131.186 + * <li>Any prefix of a validly mangled string is also validly mangled,
131.187 + * although a null prefix may need to be removed.</li>
131.188 + * <li>Any suffix of a validly mangled string is also validly mangled,
131.189 + * although a null prefix may need to be added.</li>
131.190 + * <li>Two validly mangled strings, when concatenated,
131.191 + * are also validly mangled, although any null prefix
131.192 + * must be removed from the second string,
131.193 + * and a trailing backslash on the first string may need escaping,
131.194 + * if it would participate in an accidental escape when followed
131.195 + * by the first character of the second string.</li>
131.196 + * </ul>
131.197 + * <p>If languages that include non-Java symbol spellings use this
131.198 + * mangling convention, they will enjoy the following advantages:
131.199 + * </p>
131.200 + * <ul>
131.201 + * <li>They can interoperate via symbols they share in common.</li>
131.202 + * <li>Low-level tools, such as backtrace printers, will have readable displays.</li>
131.203 + * <li>Future JVM and language extensions can safely use the dangerous characters
131.204 + * for structuring symbols, but will never interfere with valid spellings.</li>
131.205 + * <li>Runtimes and compilers can use standard libraries for mangling and demangling.</li>
131.206 + * <li>Occasional transliterations and name composition will be simple and regular,
131.207 + * for classes, methods, and fields.</li>
131.208 + * <li>Bytecode names will continue to be compact.
131.209 + * When mangled, spellings will at most double in length, either in
131.210 + * UTF8 or UTF16 format, and most will not change at all.</li>
131.211 + * </ul>
131.212 + *
131.213 + *
131.214 + * <h3> Suggestions for Human Readable Presentations </h3>
131.215 + *
131.216 + *
131.217 + * <p>
131.218 + * For human readable displays of symbols,
131.219 + * it will be better to present a string-like quoted
131.220 + * representation of the spelling, because JVM users
131.221 + * are generally familiar with such tokens.
131.222 + * We suggest using single or double quotes before and after
131.223 + * mangled symbols which are not valid Java identifiers,
131.224 + * with quotes, backslashes, and non-printing characters
131.225 + * escaped as if for literals in the Java language.
131.226 + * </p>
131.227 + * <p>
131.228 + * For example, an HTML-like spelling
131.229 + * <code><big><b><pre></b></big></code> mangles to
131.230 + * <code><big><b>\^pre\_</b></big></code> and could
131.231 + * display more cleanly as
131.232 + * <code><big><b>'<pre>'</b></big></code>,
131.233 + * with the quotes included.
131.234 + * Such string-like conventions are <em>not</em> suitable
131.235 + * for mangled bytecode names, in part because
131.236 + * dangerous characters must be eliminated, rather
131.237 + * than just quoted. Otherwise internally structured
131.238 + * strings like package prefixes and method signatures
131.239 + * could not be reliably parsed.
131.240 + * </p>
131.241 + * <p>
131.242 + * In such human-readable displays, invalidly mangled
131.243 + * names should <em>not</em> be demangled and quoted,
131.244 + * for this would be misleading. Likewise, JVM symbols
131.245 + * which contain dangerous characters (like dots in field
131.246 + * names or brackets in method names) should not be
131.247 + * simply quoted. The bytecode names
131.248 + * <code><big><b>\=phase\,1</b></big></code> and
131.249 + * <code><big><b>phase.1</b></big></code> are distinct,
131.250 + * and in demangled displays they should be presented as
131.251 + * <code><big><b>'phase.1'</b></big></code> and something like
131.252 + * <code><big><b>'phase'.1</b></big></code>, respectively.
131.253 + * </p>
131.254 + *
131.255 + * @author John Rose
131.256 + * @version 1.2, 02/06/2008
131.257 + * @see http://blogs.sun.com/jrose/entry/symbolic_freedom_in_the_vm
131.258 + */
131.259 +public class BytecodeName {
131.260 + private BytecodeName() { } // static only class
131.261 +
131.262 + /** Given a source name, produce the corresponding bytecode name.
131.263 + * The source name should not be qualified, because any syntactic
131.264 + * markers (dots, slashes, dollar signs, colons, etc.) will be mangled.
131.265 + * @param s the source name
131.266 + * @return a valid bytecode name which represents the source name
131.267 + */
131.268 + public static String toBytecodeName(String s) {
131.269 + String bn = mangle(s);
131.270 + assert((Object)bn == s || looksMangled(bn)) : bn;
131.271 + assert(s.equals(toSourceName(bn))) : s;
131.272 + return bn;
131.273 + }
131.274 +
131.275 + /** Given an unqualified bytecode name, produce the corresponding source name.
131.276 + * The bytecode name must not contain dangerous characters.
131.277 + * In particular, it must not be qualified or segmented by colon {@code ':'}.
131.278 + * @param s the bytecode name
131.279 + * @return the source name, which may possibly have unsafe characters
131.280 + * @throws IllegalArgumentException if the bytecode name is not {@link #isSafeBytecodeName safe}
131.281 + * @see #isSafeBytecodeName(java.lang.String)
131.282 + */
131.283 + public static String toSourceName(String s) {
131.284 + checkSafeBytecodeName(s);
131.285 + String sn = s;
131.286 + if (looksMangled(s)) {
131.287 + sn = demangle(s);
131.288 + assert(s.equals(mangle(sn))) : s+" => "+sn+" => "+mangle(sn);
131.289 + }
131.290 + return sn;
131.291 + }
131.292 +
131.293 + /**
131.294 + * Given a bytecode name from a classfile, separate it into
131.295 + * components delimited by dangerous characters.
131.296 + * Each resulting array element will be either a dangerous character,
131.297 + * or else a safe bytecode name.
131.298 + * (The safe name might possibly be mangled to hide further dangerous characters.)
131.299 + * For example, the qualified class name {@code java/lang/String}
131.300 + * will be parsed into the array {@code {"java", '/', "lang", '/', "String"}}.
131.301 + * The name {@code <init>} will be parsed into { '<', "init", '>'}}
131.302 + * The name {@code foo/bar$:baz} will be parsed into
131.303 + * {@code {"foo", '/', "bar", '$', ':', "baz"}}.
131.304 + */
131.305 + public static Object[] parseBytecodeName(String s) {
131.306 + int slen = s.length();
131.307 + Object[] res = null;
131.308 + for (int pass = 0; pass <= 1; pass++) {
131.309 + int fillp = 0;
131.310 + int lasti = 0;
131.311 + for (int i = 0; i <= slen; i++) {
131.312 + int whichDC = -1;
131.313 + if (i < slen) {
131.314 + whichDC = DANGEROUS_CHARS.indexOf(s.charAt(i));
131.315 + if (whichDC < DANGEROUS_CHAR_FIRST_INDEX) continue;
131.316 + }
131.317 + // got to end of string or next dangerous char
131.318 + if (lasti < i) {
131.319 + // normal component
131.320 + if (pass != 0)
131.321 + res[fillp] = s.substring(lasti, i);
131.322 + fillp++;
131.323 + lasti = i+1;
131.324 + }
131.325 + if (whichDC >= DANGEROUS_CHAR_FIRST_INDEX) {
131.326 + if (pass != 0)
131.327 + res[fillp] = DANGEROUS_CHARS_CA[whichDC];
131.328 + fillp++;
131.329 + }
131.330 + }
131.331 + if (pass != 0) break;
131.332 + // between passes, build the result array
131.333 + res = new String[fillp];
131.334 + if (fillp <= 1) {
131.335 + if (fillp != 0) res[0] = s;
131.336 + break;
131.337 + }
131.338 + }
131.339 + return res;
131.340 + }
131.341 +
131.342 + /**
131.343 + * Given a series of components, create a bytecode name for a classfile.
131.344 + * This is the inverse of {@link #parseBytecodeName(java.lang.String)}.
131.345 + * Each component must either be an interned one-character string of
131.346 + * a dangerous character, or else a safe bytecode name.
131.347 + * @param components a series of name components
131.348 + * @return the concatenation of all components
131.349 + * @throws IllegalArgumentException if any component contains an unsafe
131.350 + * character, and is not an interned one-character string
131.351 + * @throws NullPointerException if any component is null
131.352 + */
131.353 + public static String unparseBytecodeName(Object[] components) {
131.354 + for (Object c : components) {
131.355 + if (c instanceof String)
131.356 + checkSafeBytecodeName((String) c); // may fail
131.357 + }
131.358 + return appendAll(components);
131.359 + }
131.360 + private static String appendAll(Object[] components) {
131.361 + if (components.length <= 1) {
131.362 + if (components.length == 1) {
131.363 + return String.valueOf(components[0]);
131.364 + }
131.365 + return "";
131.366 + }
131.367 + int slen = 0;
131.368 + for (Object c : components) {
131.369 + if (c instanceof String)
131.370 + slen += String.valueOf(c).length();
131.371 + else
131.372 + slen += 1;
131.373 + }
131.374 + StringBuilder sb = new StringBuilder(slen);
131.375 + for (Object c : components) {
131.376 + sb.append(c);
131.377 + }
131.378 + return sb.toString();
131.379 + }
131.380 +
131.381 + /**
131.382 + * Given a bytecode name, produce the corresponding display name.
131.383 + * This is the source name, plus quotes if needed.
131.384 + * If the bytecode name contains dangerous characters,
131.385 + * assume that they are being used as punctuation,
131.386 + * and pass them through unchanged.
131.387 + * @param s the original bytecode name (which may be qualified)
131.388 + * @return a human-readable presentation
131.389 + */
131.390 + public static String toDisplayName(String s) {
131.391 + Object[] components = parseBytecodeName(s);
131.392 + for (int i = 0; i < components.length; i++) {
131.393 + if (!(components[i] instanceof String))
131.394 + continue;
131.395 + String c = (String) components[i];
131.396 + // pretty up the name by demangling it
131.397 + String sn = toSourceName(c);
131.398 + if ((Object)sn != c || !isJavaIdent(sn)) {
131.399 + components[i] = quoteDisplay(sn);
131.400 + }
131.401 + }
131.402 + return appendAll(components);
131.403 + }
131.404 + private static boolean isJavaIdent(String s) {
131.405 + int slen = s.length();
131.406 + if (slen == 0) return false;
131.407 + if (!Character.isUnicodeIdentifierStart(s.charAt(0)))
131.408 + return false;
131.409 + for (int i = 1; i < slen; i++) {
131.410 + if (!Character.isUnicodeIdentifierPart(s.charAt(0)))
131.411 + return false;
131.412 + }
131.413 + return true;
131.414 + }
131.415 + private static String quoteDisplay(String s) {
131.416 + // TO DO: Replace wierd characters in s by C-style escapes.
131.417 + return "'"+s.replaceAll("['\\\\]", "\\\\$0")+"'";
131.418 + }
131.419 +
131.420 + private static void checkSafeBytecodeName(String s)
131.421 + throws IllegalArgumentException {
131.422 + if (!isSafeBytecodeName(s)) {
131.423 + throw new IllegalArgumentException(s);
131.424 + }
131.425 + }
131.426 +
131.427 + /**
131.428 + * Report whether a simple name is safe as a bytecode name.
131.429 + * Such names are acceptable in class files as class, method, and field names.
131.430 + * Additionally, they are free of "dangerous" characters, even if those
131.431 + * characters are legal in some (or all) names in class files.
131.432 + * @param s the proposed bytecode name
131.433 + * @return true if the name is non-empty and all of its characters are safe
131.434 + */
131.435 + public static boolean isSafeBytecodeName(String s) {
131.436 + if (s.length() == 0) return false;
131.437 + // check occurrences of each DANGEROUS char
131.438 + for (char xc : DANGEROUS_CHARS_A) {
131.439 + if (xc == ESCAPE_C) continue; // not really that dangerous
131.440 + if (s.indexOf(xc) >= 0) return false;
131.441 + }
131.442 + return true;
131.443 + }
131.444 +
131.445 + /**
131.446 + * Report whether a character is safe in a bytecode name.
131.447 + * This is true of any unicode character except the following
131.448 + * <em>dangerous characters</em>: {@code ".;:$[]<>/"}.
131.449 + * @param s the proposed character
131.450 + * @return true if the character is safe to use in classfiles
131.451 + */
131.452 + public static boolean isSafeBytecodeChar(char c) {
131.453 + return DANGEROUS_CHARS.indexOf(c) < DANGEROUS_CHAR_FIRST_INDEX;
131.454 + }
131.455 +
131.456 + private static boolean looksMangled(String s) {
131.457 + return s.charAt(0) == ESCAPE_C;
131.458 + }
131.459 +
131.460 + private static String mangle(String s) {
131.461 + if (s.length() == 0)
131.462 + return NULL_ESCAPE;
131.463 +
131.464 + // build this lazily, when we first need an escape:
131.465 + StringBuilder sb = null;
131.466 +
131.467 + for (int i = 0, slen = s.length(); i < slen; i++) {
131.468 + char c = s.charAt(i);
131.469 +
131.470 + boolean needEscape = false;
131.471 + if (c == ESCAPE_C) {
131.472 + if (i+1 < slen) {
131.473 + char c1 = s.charAt(i+1);
131.474 + if ((i == 0 && c1 == NULL_ESCAPE_C)
131.475 + || c1 != originalOfReplacement(c1)) {
131.476 + // an accidental escape
131.477 + needEscape = true;
131.478 + }
131.479 + }
131.480 + } else {
131.481 + needEscape = isDangerous(c);
131.482 + }
131.483 +
131.484 + if (!needEscape) {
131.485 + if (sb != null) sb.append(c);
131.486 + continue;
131.487 + }
131.488 +
131.489 + // build sb if this is the first escape
131.490 + if (sb == null) {
131.491 + sb = new StringBuilder(s.length()+10);
131.492 + // mangled names must begin with a backslash:
131.493 + if (s.charAt(0) != ESCAPE_C && i > 0)
131.494 + sb.append(NULL_ESCAPE);
131.495 + // append the string so far, which is unremarkable:
131.496 + sb.append(s.substring(0, i));
131.497 + }
131.498 +
131.499 + // rewrite \ to \-, / to \|, etc.
131.500 + sb.append(ESCAPE_C);
131.501 + sb.append(replacementOf(c));
131.502 + }
131.503 +
131.504 + if (sb != null) return sb.toString();
131.505 +
131.506 + return s;
131.507 + }
131.508 +
131.509 + private static String demangle(String s) {
131.510 + // build this lazily, when we first meet an escape:
131.511 + StringBuilder sb = null;
131.512 +
131.513 + int stringStart = 0;
131.514 + if (s.startsWith(NULL_ESCAPE))
131.515 + stringStart = 2;
131.516 +
131.517 + for (int i = stringStart, slen = s.length(); i < slen; i++) {
131.518 + char c = s.charAt(i);
131.519 +
131.520 + if (c == ESCAPE_C && i+1 < slen) {
131.521 + // might be an escape sequence
131.522 + char rc = s.charAt(i+1);
131.523 + char oc = originalOfReplacement(rc);
131.524 + if (oc != rc) {
131.525 + // build sb if this is the first escape
131.526 + if (sb == null) {
131.527 + sb = new StringBuilder(s.length());
131.528 + // append the string so far, which is unremarkable:
131.529 + sb.append(s.substring(stringStart, i));
131.530 + }
131.531 + ++i; // skip both characters
131.532 + c = oc;
131.533 + }
131.534 + }
131.535 +
131.536 + if (sb != null)
131.537 + sb.append(c);
131.538 + }
131.539 +
131.540 + if (sb != null) return sb.toString();
131.541 +
131.542 + return s.substring(stringStart);
131.543 + }
131.544 +
131.545 + static char ESCAPE_C = '\\';
131.546 + // empty escape sequence to avoid a null name or illegal prefix
131.547 + static char NULL_ESCAPE_C = '=';
131.548 + static String NULL_ESCAPE = ESCAPE_C+""+NULL_ESCAPE_C;
131.549 +
131.550 + static final String DANGEROUS_CHARS = "\\/.;:$[]<>"; // \\ must be first
131.551 + static final String REPLACEMENT_CHARS = "-|,?!%{}^_";
131.552 + static final int DANGEROUS_CHAR_FIRST_INDEX = 1; // index after \\
131.553 + static char[] DANGEROUS_CHARS_A = DANGEROUS_CHARS.toCharArray();
131.554 + static char[] REPLACEMENT_CHARS_A = REPLACEMENT_CHARS.toCharArray();
131.555 + static final Character[] DANGEROUS_CHARS_CA;
131.556 + static {
131.557 + Character[] dcca = new Character[DANGEROUS_CHARS.length()];
131.558 + for (int i = 0; i < dcca.length; i++)
131.559 + dcca[i] = Character.valueOf(DANGEROUS_CHARS.charAt(i));
131.560 + DANGEROUS_CHARS_CA = dcca;
131.561 + }
131.562 +
131.563 + static final long[] SPECIAL_BITMAP = new long[2]; // 128 bits
131.564 + static {
131.565 + String SPECIAL = DANGEROUS_CHARS + REPLACEMENT_CHARS;
131.566 + //System.out.println("SPECIAL = "+SPECIAL);
131.567 + for (char c : SPECIAL.toCharArray()) {
131.568 + SPECIAL_BITMAP[c >>> 6] |= 1L << c;
131.569 + }
131.570 + }
131.571 + static boolean isSpecial(char c) {
131.572 + if ((c >>> 6) < SPECIAL_BITMAP.length)
131.573 + return ((SPECIAL_BITMAP[c >>> 6] >> c) & 1) != 0;
131.574 + else
131.575 + return false;
131.576 + }
131.577 + static char replacementOf(char c) {
131.578 + if (!isSpecial(c)) return c;
131.579 + int i = DANGEROUS_CHARS.indexOf(c);
131.580 + if (i < 0) return c;
131.581 + return REPLACEMENT_CHARS.charAt(i);
131.582 + }
131.583 + static char originalOfReplacement(char c) {
131.584 + if (!isSpecial(c)) return c;
131.585 + int i = REPLACEMENT_CHARS.indexOf(c);
131.586 + if (i < 0) return c;
131.587 + return DANGEROUS_CHARS.charAt(i);
131.588 + }
131.589 + static boolean isDangerous(char c) {
131.590 + if (!isSpecial(c)) return false;
131.591 + return (DANGEROUS_CHARS.indexOf(c) >= DANGEROUS_CHAR_FIRST_INDEX);
131.592 + }
131.593 + static int indexOfDangerousChar(String s, int from) {
131.594 + for (int i = from, slen = s.length(); i < slen; i++) {
131.595 + if (isDangerous(s.charAt(i)))
131.596 + return i;
131.597 + }
131.598 + return -1;
131.599 + }
131.600 + static int lastIndexOfDangerousChar(String s, int from) {
131.601 + for (int i = Math.min(from, s.length()-1); i >= 0; i--) {
131.602 + if (isDangerous(s.charAt(i)))
131.603 + return i;
131.604 + }
131.605 + return -1;
131.606 + }
131.607 +
131.608 + // test driver
131.609 + static void main(String[] av) {
131.610 + // If verbose is enabled, quietly check everything.
131.611 + // Otherwise, print the output for the user to check.
131.612 + boolean verbose = false;
131.613 +
131.614 + int maxlen = 0;
131.615 +
131.616 + while (av.length > 0 && av[0].startsWith("-")) {
131.617 + String flag = av[0].intern();
131.618 + av = java.util.Arrays.copyOfRange(av, 1, av.length); // Java 1.6 or later
131.619 + if (flag == "-" || flag == "--") break;
131.620 + else if (flag == "-q")
131.621 + verbose = false;
131.622 + else if (flag == "-v")
131.623 + verbose = true;
131.624 + else if (flag.startsWith("-l"))
131.625 + maxlen = Integer.valueOf(flag.substring(2));
131.626 + else
131.627 + throw new Error("Illegal flag argument: "+flag);
131.628 + }
131.629 +
131.630 + if (maxlen == 0)
131.631 + maxlen = (verbose ? 2 : 4);
131.632 + if (verbose) System.out.println("Note: maxlen = "+maxlen);
131.633 +
131.634 + switch (av.length) {
131.635 + case 0: av = new String[] {
131.636 + DANGEROUS_CHARS.substring(0) +
131.637 + REPLACEMENT_CHARS.substring(0, 1) +
131.638 + NULL_ESCAPE + "x"
131.639 + }; // and fall through:
131.640 + case 1:
131.641 + char[] cv = av[0].toCharArray();
131.642 + av = new String[cv.length];
131.643 + int avp = 0;
131.644 + for (char c : cv) {
131.645 + String s = String.valueOf(c);
131.646 + if (c == 'x') s = "foo"; // tradition...
131.647 + av[avp++] = s;
131.648 + }
131.649 + }
131.650 + if (verbose)
131.651 + System.out.println("Note: Verbose output mode enabled. Use '-q' to suppress.");
131.652 + Tester t = new Tester();
131.653 + t.maxlen = maxlen;
131.654 + t.verbose = verbose;
131.655 + t.tokens = av;
131.656 + t.test("", 0);
131.657 + }
131.658 +
131.659 + static class Tester {
131.660 + boolean verbose;
131.661 + int maxlen;
131.662 + java.util.Map<String,String> map = new java.util.HashMap<String,String>();
131.663 + String[] tokens;
131.664 +
131.665 + void test(String stringSoFar, int tokensSoFar) {
131.666 + test(stringSoFar);
131.667 + if (tokensSoFar <= maxlen) {
131.668 + for (String token : tokens) {
131.669 + if (token.length() == 0) continue; // skip empty tokens
131.670 + if (stringSoFar.indexOf(token) != stringSoFar.lastIndexOf(token))
131.671 + continue; // there are already two occs. of this token
131.672 + if (token.charAt(0) == ESCAPE_C && token.length() == 1 && maxlen < 4)
131.673 + test(stringSoFar+token, tokensSoFar); // want lots of \'s
131.674 + else if (tokensSoFar < maxlen)
131.675 + test(stringSoFar+token, tokensSoFar+1);
131.676 + }
131.677 + }
131.678 + }
131.679 +
131.680 + void test(String s) {
131.681 + // for small batches, do not test the null string
131.682 + if (s.length() == 0 && maxlen >=1 && maxlen <= 2) return;
131.683 + String bn = testSourceName(s);
131.684 + if (bn == null) return;
131.685 + if (bn == s) {
131.686 + //if (verbose) System.out.println(s+" == id");
131.687 + } else {
131.688 + if (verbose) System.out.println(s+" => "+bn+" "+toDisplayName(bn));
131.689 + String bnbn = testSourceName(bn);
131.690 + if (bnbn == null) return;
131.691 + if (verbose) System.out.println(bn+" => "+bnbn+" "+toDisplayName(bnbn));
131.692 + /*
131.693 + String bn3 = testSourceName(bnbn);
131.694 + if (bn3 == null) return;
131.695 + if (verbose) System.out.println(bnbn+" => "+bn3);
131.696 + */
131.697 + }
131.698 + }
131.699 +
131.700 + String testSourceName(String s) {
131.701 + if (map.containsKey(s)) return null;
131.702 + String bn = toBytecodeName(s);
131.703 + map.put(s, bn);
131.704 + String sn = toSourceName(bn);
131.705 + if (!sn.equals(s)) {
131.706 + String bad = (s+" => "+bn+" != "+sn);
131.707 + if (!verbose) throw new Error("Bad mangling: "+bad);
131.708 + System.out.println("*** "+bad);
131.709 + return null;
131.710 + }
131.711 + return bn;
131.712 + }
131.713 + }
131.714 +}
132.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
132.2 +++ b/src/share/classes/sun/dyn/util/BytecodeSignature.java Thu May 14 00:17:25 2009 -0700
132.3 @@ -0,0 +1,137 @@
132.4 +/*
132.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
132.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
132.7 + *
132.8 + * This code is free software; you can redistribute it and/or modify it
132.9 + * under the terms of the GNU General Public License version 2 only, as
132.10 + * published by the Free Software Foundation. Sun designates this
132.11 + * particular file as subject to the "Classpath" exception as provided
132.12 + * by Sun in the LICENSE file that accompanied this code.
132.13 + *
132.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
132.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
132.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
132.17 + * version 2 for more details (a copy is included in the LICENSE file that
132.18 + * accompanied this code).
132.19 + *
132.20 + * You should have received a copy of the GNU General Public License version
132.21 + * 2 along with this work; if not, write to the Free Software Foundation,
132.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
132.23 + *
132.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
132.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
132.26 + * have any questions.
132.27 + */
132.28 +
132.29 +package sun.dyn.util;
132.30 +
132.31 +import java.dyn.MethodType;
132.32 +import java.util.ArrayList;
132.33 +import java.util.List;
132.34 +
132.35 +/**
132.36 + * Utility routines for dealing with bytecode-level signatures.
132.37 + * @author jrose
132.38 + */
132.39 +public class BytecodeSignature {
132.40 +
132.41 + private BytecodeSignature() { } // cannot instantiate
132.42 +
132.43 + public static List<Class<?>> parseMethod(String bytecodeSignature, ClassLoader loader) {
132.44 + return parseMethod(bytecodeSignature, 0, bytecodeSignature.length(), loader);
132.45 + }
132.46 +
132.47 + static List<Class<?>> parseMethod(String bytecodeSignature,
132.48 + int start, int end, ClassLoader loader) {
132.49 + if (loader == null)
132.50 + loader = ClassLoader.getSystemClassLoader();
132.51 + String str = bytecodeSignature;
132.52 + int[] i = {start};
132.53 + ArrayList<Class<?>> ptypes = new ArrayList<Class<?>>();
132.54 + if (i[0] < end && str.charAt(i[0]) == '(') {
132.55 + ++i[0]; // skip '('
132.56 + while (i[0] < end && str.charAt(i[0]) != ')') {
132.57 + Class<?> pt = parseSig(str, i, end, loader);
132.58 + if (pt == null || pt == void.class)
132.59 + parseError(str, "bad argument type");
132.60 + ptypes.add(pt);
132.61 + }
132.62 + ++i[0]; // skip ')'
132.63 + } else {
132.64 + parseError(str, "not a method type");
132.65 + }
132.66 + Class<?> rtype = parseSig(str, i, end, loader);
132.67 + if (rtype == null || i[0] != end)
132.68 + parseError(str, "bad return type");
132.69 + ptypes.add(rtype);
132.70 + return ptypes;
132.71 + }
132.72 +
132.73 + static private void parseError(String str, String msg) {
132.74 + throw new IllegalArgumentException("bad signature: "+str+": "+msg);
132.75 + }
132.76 +
132.77 + static private Class<?> parseSig(String str, int[] i, int end, ClassLoader loader) {
132.78 + if (i[0] == end) return null;
132.79 + char c = str.charAt(i[0]++);
132.80 + if (c == 'L') {
132.81 + int begc = i[0], endc = str.indexOf(';', begc);
132.82 + if (endc < 0) return null;
132.83 + i[0] = endc+1;
132.84 + String name = str.substring(begc, endc).replace('/', '.');
132.85 + try {
132.86 + return loader.loadClass(name);
132.87 + } catch (ClassNotFoundException ex) {
132.88 + throw new TypeNotPresentException(name, ex);
132.89 + }
132.90 + } else if (c == '[') {
132.91 + Class<?> t = parseSig(str, i, end, loader);
132.92 + if (t != null)
132.93 + t = java.lang.reflect.Array.newInstance(t, 0).getClass();
132.94 + return t;
132.95 + } else {
132.96 + return Wrapper.forBasicType(c).primitiveType();
132.97 + }
132.98 + }
132.99 +
132.100 + public static String unparse(Class<?> type) {
132.101 + StringBuilder sb = new StringBuilder();
132.102 + unparseSig(type, sb);
132.103 + return sb.toString();
132.104 + }
132.105 +
132.106 + public static String unparse(MethodType type) {
132.107 + return unparseMethod(type.returnType(), type.parameterList());
132.108 + }
132.109 +
132.110 + public static String unparse(Object type) {
132.111 + if (type instanceof Class<?>)
132.112 + return unparse((Class<?>) type);
132.113 + if (type instanceof MethodType)
132.114 + return unparse((MethodType) type);
132.115 + return (String) type;
132.116 + }
132.117 +
132.118 + public static String unparseMethod(Class<?> rtype, List<Class<?>> ptypes) {
132.119 + StringBuilder sb = new StringBuilder();
132.120 + sb.append('(');
132.121 + for (Class<?> pt : ptypes)
132.122 + unparseSig(pt, sb);
132.123 + sb.append(')');
132.124 + unparseSig(rtype, sb);
132.125 + return sb.toString();
132.126 + }
132.127 +
132.128 + static private void unparseSig(Class<?> t, StringBuilder sb) {
132.129 + char c = Wrapper.forBasicType(t).basicTypeChar();
132.130 + if (c != 'L') {
132.131 + sb.append(c);
132.132 + } else {
132.133 + boolean lsemi = (!t.isArray());
132.134 + if (lsemi) sb.append('L');
132.135 + sb.append(t.getName().replace('.', '/'));
132.136 + if (lsemi) sb.append(';');
132.137 + }
132.138 + }
132.139 +
132.140 +}
133.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
133.2 +++ b/src/share/classes/sun/dyn/util/ValueConversions.java Thu May 14 00:17:25 2009 -0700
133.3 @@ -0,0 +1,563 @@
133.4 +/*
133.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
133.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
133.7 + *
133.8 + * This code is free software; you can redistribute it and/or modify it
133.9 + * under the terms of the GNU General Public License version 2 only, as
133.10 + * published by the Free Software Foundation. Sun designates this
133.11 + * particular file as subject to the "Classpath" exception as provided
133.12 + * by Sun in the LICENSE file that accompanied this code.
133.13 + *
133.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
133.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
133.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
133.17 + * version 2 for more details (a copy is included in the LICENSE file that
133.18 + * accompanied this code).
133.19 + *
133.20 + * You should have received a copy of the GNU General Public License version
133.21 + * 2 along with this work; if not, write to the Free Software Foundation,
133.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
133.23 + *
133.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
133.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
133.26 + * have any questions.
133.27 + */
133.28 +
133.29 +package sun.dyn.util;
133.30 +
133.31 +import java.dyn.*;
133.32 +import java.dyn.MethodHandles.Lookup;
133.33 +import java.util.EnumMap;
133.34 +import sun.dyn.Access;
133.35 +import sun.dyn.AdapterMethodHandle;
133.36 +import sun.dyn.MethodHandleImpl;
133.37 +
133.38 +public class ValueConversions {
133.39 + private static final Access IMPL_TOKEN = Access.getToken();
133.40 + private static final Lookup IMPL_LOOKUP = MethodHandleImpl.getLookup(IMPL_TOKEN);
133.41 +
133.42 + private static EnumMap<Wrapper, MethodHandle>[] newWrapperCaches(int n) {
133.43 + EnumMap<Wrapper, MethodHandle>[] caches
133.44 + = (EnumMap<Wrapper, MethodHandle>[]) new EnumMap[n]; // unchecked warning expected here
133.45 + for (int i = 0; i < n; i++)
133.46 + caches[i] = new EnumMap<Wrapper, MethodHandle>(Wrapper.class);
133.47 + return caches;
133.48 + }
133.49 +
133.50 + /// Converting references to values.
133.51 +
133.52 + static int unboxInteger(Object x) {
133.53 + if (x == null) return 0; // never NPE
133.54 + return ((Integer) x).intValue();
133.55 + }
133.56 +
133.57 + static byte unboxByte(Object x) {
133.58 + if (x == null) return 0; // never NPE
133.59 + return ((Byte) x).byteValue();
133.60 + }
133.61 +
133.62 + static short unboxShort(Object x) {
133.63 + if (x == null) return 0; // never NPE
133.64 + return ((Short) x).shortValue();
133.65 + }
133.66 +
133.67 + static boolean unboxBoolean(Object x) {
133.68 + if (x == null) return false; // never NPE
133.69 + return ((Boolean) x).booleanValue();
133.70 + }
133.71 +
133.72 + static char unboxCharacter(Object x) {
133.73 + if (x == null) return 0; // never NPE
133.74 + return ((Character) x).charValue();
133.75 + }
133.76 +
133.77 + static long unboxLong(Object x) {
133.78 + if (x == null) return 0; // never NPE
133.79 + return ((Long) x).longValue();
133.80 + }
133.81 +
133.82 + static float unboxFloat(Object x) {
133.83 + if (x == null) return 0; // never NPE
133.84 + return ((Float) x).floatValue();
133.85 + }
133.86 +
133.87 + static double unboxDouble(Object x) {
133.88 + if (x == null) return 0; // never NPE
133.89 + return ((Double) x).doubleValue();
133.90 + }
133.91 +
133.92 + /// Converting references to "raw" values.
133.93 + /// A raw primitive value is always an int or long.
133.94 +
133.95 + static int unboxByteRaw(Object x) {
133.96 + return unboxByte(x);
133.97 + }
133.98 +
133.99 + static int unboxShortRaw(Object x) {
133.100 + return unboxShort(x);
133.101 + }
133.102 +
133.103 + static int unboxBooleanRaw(Object x) {
133.104 + return unboxBoolean(x) ? 1 : 0;
133.105 + }
133.106 +
133.107 + static int unboxCharacterRaw(Object x) {
133.108 + return unboxCharacter(x);
133.109 + }
133.110 +
133.111 + static int unboxFloatRaw(Object x) {
133.112 + return Float.floatToIntBits(unboxFloat(x));
133.113 + }
133.114 +
133.115 + static long unboxDoubleRaw(Object x) {
133.116 + return Double.doubleToRawLongBits(unboxDouble(x));
133.117 + }
133.118 +
133.119 + private static MethodType unboxType(Wrapper wrap, boolean raw) {
133.120 + return MethodType.make(rawWrapper(wrap, raw).primitiveType(), wrap.wrapperType());
133.121 + }
133.122 +
133.123 + private static final EnumMap<Wrapper, MethodHandle>[]
133.124 + UNBOX_CONVERSIONS = newWrapperCaches(4);
133.125 +
133.126 + private static MethodHandle unbox(Wrapper wrap, boolean exact, boolean raw) {
133.127 + EnumMap<Wrapper, MethodHandle> cache = UNBOX_CONVERSIONS[(exact?1:0)+(raw?2:0)];
133.128 + MethodHandle mh = cache.get(wrap);
133.129 + if (mh != null) {
133.130 + return mh;
133.131 + }
133.132 + // slow path
133.133 + switch (wrap) {
133.134 + case OBJECT:
133.135 + mh = IDENTITY; break;
133.136 + case VOID:
133.137 + mh = raw ? ALWAYS_ZERO : IGNORE; break;
133.138 + case INT: case LONG:
133.139 + // these guys don't need separate raw channels
133.140 + if (raw) mh = unbox(wrap, exact, false);
133.141 + break;
133.142 + }
133.143 + if (mh != null) {
133.144 + cache.put(wrap, mh);
133.145 + return mh;
133.146 + }
133.147 + // look up the method
133.148 + String name = "unbox" + wrap.simpleName() + (raw ? "Raw" : "");
133.149 + MethodType type = unboxType(wrap, raw);
133.150 + if (!exact)
133.151 + // actually, type is wrong; the Java method takes Object
133.152 + mh = IMPL_LOOKUP.findStatic(ValueConversions.class, name, type.erase());
133.153 + else
133.154 + mh = retype(type, unbox(wrap, !exact, raw));
133.155 + if (mh != null) {
133.156 + cache.put(wrap, mh);
133.157 + return mh;
133.158 + }
133.159 + throw new IllegalArgumentException("cannot find unbox adapter for " + wrap + (raw ? " (raw)" : ""));
133.160 + }
133.161 +
133.162 + public static MethodHandle unbox(Wrapper type, boolean exact) {
133.163 + return unbox(type, exact, false);
133.164 + }
133.165 +
133.166 + public static MethodHandle unboxRaw(Wrapper type, boolean exact) {
133.167 + return unbox(type, exact, true);
133.168 + }
133.169 +
133.170 + public static MethodHandle unbox(Class<?> type, boolean exact) {
133.171 + return unbox(Wrapper.forPrimitiveType(type), exact, false);
133.172 + }
133.173 +
133.174 + public static MethodHandle unboxRaw(Class<?> type, boolean exact) {
133.175 + return unbox(Wrapper.forPrimitiveType(type), exact, true);
133.176 + }
133.177 +
133.178 + /// Converting primitives to references
133.179 +
133.180 + static Integer boxInteger(int x) {
133.181 + return x;
133.182 + }
133.183 +
133.184 + static Byte boxByte(byte x) {
133.185 + return x;
133.186 + }
133.187 +
133.188 + static Short boxShort(short x) {
133.189 + return x;
133.190 + }
133.191 +
133.192 + static Boolean boxBoolean(boolean x) {
133.193 + return x;
133.194 + }
133.195 +
133.196 + static Character boxCharacter(char x) {
133.197 + return x;
133.198 + }
133.199 +
133.200 + static Long boxLong(long x) {
133.201 + return x;
133.202 + }
133.203 +
133.204 + static Float boxFloat(float x) {
133.205 + return x;
133.206 + }
133.207 +
133.208 + static Double boxDouble(double x) {
133.209 + return x;
133.210 + }
133.211 +
133.212 + /// Converting raw primitives to references
133.213 +
133.214 + static Byte boxByteRaw(int x) {
133.215 + return boxByte((byte)x);
133.216 + }
133.217 +
133.218 + static Short boxShortRaw(int x) {
133.219 + return boxShort((short)x);
133.220 + }
133.221 +
133.222 + static Boolean boxBooleanRaw(int x) {
133.223 + return boxBoolean(x != 0);
133.224 + }
133.225 +
133.226 + static Character boxCharacterRaw(int x) {
133.227 + return boxCharacter((char)x);
133.228 + }
133.229 +
133.230 + static Float boxFloatRaw(int x) {
133.231 + return boxFloat(Float.intBitsToFloat(x));
133.232 + }
133.233 +
133.234 + static Double boxDoubleRaw(long x) {
133.235 + return boxDouble(Double.longBitsToDouble(x));
133.236 + }
133.237 +
133.238 + // a raw void value is (arbitrarily) a garbage int
133.239 + static Void boxVoidRaw(int x) {
133.240 + return null;
133.241 + }
133.242 +
133.243 + private static MethodType boxType(Wrapper wrap, boolean raw) {
133.244 + // be exact, since return casts are hard to compose
133.245 + Class<?> boxType = wrap.wrapperType();
133.246 + return MethodType.make(boxType, rawWrapper(wrap, raw).primitiveType());
133.247 + }
133.248 +
133.249 + private static Wrapper rawWrapper(Wrapper wrap, boolean raw) {
133.250 + if (raw) return wrap.isDoubleWord() ? Wrapper.LONG : Wrapper.INT;
133.251 + return wrap;
133.252 + }
133.253 +
133.254 + private static final EnumMap<Wrapper, MethodHandle>[]
133.255 + BOX_CONVERSIONS = newWrapperCaches(4);
133.256 +
133.257 + private static MethodHandle box(Wrapper wrap, boolean exact, boolean raw) {
133.258 + EnumMap<Wrapper, MethodHandle> cache = BOX_CONVERSIONS[(exact?1:0)+(raw?2:0)];
133.259 + MethodHandle mh = cache.get(wrap);
133.260 + if (mh != null) {
133.261 + return mh;
133.262 + }
133.263 + // slow path
133.264 + switch (wrap) {
133.265 + case OBJECT:
133.266 + mh = IDENTITY; break;
133.267 + case VOID:
133.268 + if (!raw) mh = ZERO_OBJECT;
133.269 + break;
133.270 + case INT: case LONG:
133.271 + // these guys don't need separate raw channels
133.272 + if (raw) mh = box(wrap, exact, false);
133.273 + break;
133.274 + }
133.275 + if (mh != null) {
133.276 + cache.put(wrap, mh);
133.277 + return mh;
133.278 + }
133.279 + // look up the method
133.280 + String name = "box" + wrap.simpleName() + (raw ? "Raw" : "");
133.281 + MethodType type = boxType(wrap, raw);
133.282 + if (exact)
133.283 + mh = IMPL_LOOKUP.findStatic(ValueConversions.class, name, type);
133.284 + else
133.285 + mh = retype(type.erase(), box(wrap, !exact, raw));
133.286 + if (mh != null) {
133.287 + cache.put(wrap, mh);
133.288 + return mh;
133.289 + }
133.290 + throw new IllegalArgumentException("cannot find box adapter for " + wrap + (raw ? " (raw)" : ""));
133.291 + }
133.292 +
133.293 + public static MethodHandle box(Class<?> type, boolean exact) {
133.294 + return box(Wrapper.forPrimitiveType(type), exact, false);
133.295 + }
133.296 +
133.297 + public static MethodHandle boxRaw(Class<?> type, boolean exact) {
133.298 + return box(Wrapper.forPrimitiveType(type), exact, true);
133.299 + }
133.300 +
133.301 + public static MethodHandle box(Wrapper type, boolean exact) {
133.302 + return box(type, exact, false);
133.303 + }
133.304 +
133.305 + public static MethodHandle boxRaw(Wrapper type, boolean exact) {
133.306 + return box(type, exact, true);
133.307 + }
133.308 +
133.309 + /// Kludges for when raw values get accidentally boxed.
133.310 +
133.311 + static Byte reboxRawByte(Object x) {
133.312 + if (x instanceof Byte) return (Byte) x;
133.313 + return boxByteRaw(unboxInteger(x));
133.314 + }
133.315 +
133.316 + static Short reboxRawShort(Object x) {
133.317 + if (x instanceof Short) return (Short) x;
133.318 + return boxShortRaw(unboxInteger(x));
133.319 + }
133.320 +
133.321 + static Boolean reboxRawBoolean(Object x) {
133.322 + if (x instanceof Boolean) return (Boolean) x;
133.323 + return boxBooleanRaw(unboxInteger(x));
133.324 + }
133.325 +
133.326 + static Character reboxRawCharacter(Object x) {
133.327 + if (x instanceof Character) return (Character) x;
133.328 + return boxCharacterRaw(unboxInteger(x));
133.329 + }
133.330 +
133.331 + static Float reboxRawFloat(Object x) {
133.332 + if (x instanceof Float) return (Float) x;
133.333 + return boxFloatRaw(unboxInteger(x));
133.334 + }
133.335 +
133.336 + static Double reboxRawDouble(Object x) {
133.337 + if (x instanceof Double) return (Double) x;
133.338 + return boxDoubleRaw(unboxLong(x));
133.339 + }
133.340 +
133.341 + private static MethodType reboxType(Wrapper wrap) {
133.342 + Class<?> boxType = wrap.wrapperType();
133.343 + return MethodType.make(boxType, Object.class);
133.344 + }
133.345 +
133.346 + private static final EnumMap<Wrapper, MethodHandle>[]
133.347 + REBOX_CONVERSIONS = newWrapperCaches(2);
133.348 +
133.349 + public static MethodHandle rebox(Wrapper wrap, boolean exact) {
133.350 + EnumMap<Wrapper, MethodHandle> cache = REBOX_CONVERSIONS[exact?1:0];
133.351 + MethodHandle mh = cache.get(wrap);
133.352 + if (mh != null) {
133.353 + return mh;
133.354 + }
133.355 + // slow path
133.356 + switch (wrap) {
133.357 + case OBJECT:
133.358 + mh = IDENTITY; break;
133.359 + case VOID:
133.360 + throw new IllegalArgumentException("cannot rebox a void");
133.361 + case INT: case LONG:
133.362 + mh = cast(wrap.wrapperType(), exact);
133.363 + break;
133.364 + }
133.365 + if (mh != null) {
133.366 + cache.put(wrap, mh);
133.367 + return mh;
133.368 + }
133.369 + // look up the method
133.370 + String name = "reboxRaw" + wrap.simpleName();
133.371 + MethodType type = reboxType(wrap);
133.372 + if (exact)
133.373 + mh = IMPL_LOOKUP.findStatic(ValueConversions.class, name, type);
133.374 + else
133.375 + mh = retype(IDENTITY.type(), rebox(wrap, !exact));
133.376 + if (mh != null) {
133.377 + cache.put(wrap, mh);
133.378 + return mh;
133.379 + }
133.380 + throw new IllegalArgumentException("cannot find rebox adapter for " + wrap);
133.381 + }
133.382 +
133.383 + public static MethodHandle rebox(Class<?> type, boolean exact) {
133.384 + return rebox(Wrapper.forPrimitiveType(type), exact);
133.385 + }
133.386 +
133.387 + /// Width-changing conversions between int and long.
133.388 +
133.389 + static long widenInt(int x) {
133.390 + return x;
133.391 + }
133.392 +
133.393 + static int narrowLong(long x) {
133.394 + return (int) x;
133.395 + }
133.396 +
133.397 + /// Constant functions
133.398 +
133.399 + static void ignore(Object x) {
133.400 + // no value to return; this is an unbox of null
133.401 + return;
133.402 + }
133.403 +
133.404 + static void empty() {
133.405 + return;
133.406 + }
133.407 +
133.408 + static Object zeroObject() {
133.409 + return null;
133.410 + }
133.411 +
133.412 + static int zeroInteger() {
133.413 + return 0;
133.414 + }
133.415 +
133.416 + static long zeroLong() {
133.417 + return 0;
133.418 + }
133.419 +
133.420 + static float zeroFloat() {
133.421 + return 0;
133.422 + }
133.423 +
133.424 + static double zeroDouble() {
133.425 + return 0;
133.426 + }
133.427 +
133.428 + private static final EnumMap<Wrapper, MethodHandle>[]
133.429 + ZERO_CONSTANT_FUNCTIONS = newWrapperCaches(1);
133.430 +
133.431 + public static MethodHandle zeroConstantFunction(Wrapper wrap) {
133.432 + EnumMap<Wrapper, MethodHandle> cache = ZERO_CONSTANT_FUNCTIONS[0];
133.433 + MethodHandle mh = cache.get(wrap);
133.434 + if (mh != null) {
133.435 + return mh;
133.436 + }
133.437 + // slow path
133.438 + MethodType type = MethodType.make(wrap.primitiveType());
133.439 + switch (wrap) {
133.440 + case VOID:
133.441 + mh = EMPTY;
133.442 + break;
133.443 + case INT: case LONG: case FLOAT: case DOUBLE:
133.444 + mh = IMPL_LOOKUP.findStatic(ValueConversions.class, "zero"+wrap.simpleName(), type);
133.445 + break;
133.446 + }
133.447 + if (mh != null) {
133.448 + cache.put(wrap, mh);
133.449 + return mh;
133.450 + }
133.451 +
133.452 + // use the raw method
133.453 + Wrapper rawWrap = wrap.rawPrimitive();
133.454 + if (rawWrap != wrap) {
133.455 + mh = retype(type, zeroConstantFunction(rawWrap));
133.456 + }
133.457 + if (mh != null) {
133.458 + cache.put(wrap, mh);
133.459 + return mh;
133.460 + }
133.461 + throw new IllegalArgumentException("cannot find zero constant for " + wrap);
133.462 + }
133.463 +
133.464 + /// Converting references to references.
133.465 +
133.466 + /**
133.467 + * Value-killing function.
133.468 + * @param x an arbitrary reference value
133.469 + * @return a null
133.470 + */
133.471 + static Object alwaysNull(Object x) {
133.472 + return null;
133.473 + }
133.474 +
133.475 + /**
133.476 + * Value-killing function.
133.477 + * @param x an arbitrary reference value
133.478 + * @return a zero
133.479 + */
133.480 + static int alwaysZero(Object x) {
133.481 + return 0;
133.482 + }
133.483 +
133.484 + /**
133.485 + * Identity function.
133.486 + * @param x an arbitrary reference value
133.487 + * @return the same value x
133.488 + */
133.489 + static <T> T identity(T x) {
133.490 + return x;
133.491 + }
133.492 +
133.493 + /**
133.494 + * Identity function, with reference cast.
133.495 + * @param t an arbitrary reference type
133.496 + * @param x an arbitrary reference value
133.497 + * @return the same value x
133.498 + */
133.499 + static <T,U> T castReference(Class<? extends T> t, U x) {
133.500 + return t.cast(x);
133.501 + }
133.502 +
133.503 + private static final MethodHandle IDENTITY, CAST_REFERENCE, ALWAYS_NULL, ALWAYS_ZERO, ZERO_OBJECT, IGNORE, EMPTY;
133.504 + static {
133.505 + try {
133.506 + MethodType idType = MethodType.makeGeneric(1);
133.507 + MethodType castType = idType.insertParameterType(0, Class.class);
133.508 + MethodType alwaysZeroType = idType.changeReturnType(int.class);
133.509 + MethodType ignoreType = idType.changeReturnType(void.class);
133.510 + MethodType zeroObjectType = MethodType.makeGeneric(0);
133.511 + IDENTITY = IMPL_LOOKUP.findStatic(ValueConversions.class, "identity", idType);
133.512 + //CAST_REFERENCE = IMPL_LOOKUP.findVirtual(Class.class, "cast", idType);
133.513 + CAST_REFERENCE = IMPL_LOOKUP.findStatic(ValueConversions.class, "castReference", castType);
133.514 + ALWAYS_NULL = IMPL_LOOKUP.findStatic(ValueConversions.class, "alwaysNull", idType);
133.515 + ALWAYS_ZERO = IMPL_LOOKUP.findStatic(ValueConversions.class, "alwaysZero", alwaysZeroType);
133.516 + ZERO_OBJECT = IMPL_LOOKUP.findStatic(ValueConversions.class, "zeroObject", zeroObjectType);
133.517 + IGNORE = IMPL_LOOKUP.findStatic(ValueConversions.class, "ignore", ignoreType);
133.518 + EMPTY = IMPL_LOOKUP.findStatic(ValueConversions.class, "empty", ignoreType.dropParameterType(0));
133.519 + } catch (RuntimeException ex) {
133.520 + throw ex;
133.521 + }
133.522 + }
133.523 +
133.524 + private static final EnumMap<Wrapper, MethodHandle> WRAPPER_CASTS
133.525 + = new EnumMap<Wrapper, MethodHandle>(Wrapper.class);
133.526 +
133.527 + private static final EnumMap<Wrapper, MethodHandle> EXACT_WRAPPER_CASTS
133.528 + = new EnumMap<Wrapper, MethodHandle>(Wrapper.class);
133.529 +
133.530 + /** Return a method that casts its sole argument (an Object) to the given type
133.531 + * and returns it as the given type (if exact is true), or as plain Object (if erase is true).
133.532 + */
133.533 + public static MethodHandle cast(Class<?> type, boolean exact) {
133.534 + if (type.isPrimitive()) throw new IllegalArgumentException("cannot cast primitive type "+type);
133.535 + MethodHandle mh = null;
133.536 + Wrapper wrap = null;
133.537 + EnumMap<Wrapper, MethodHandle> cache = null;
133.538 + if (Wrapper.isWrapperType(type)) {
133.539 + wrap = Wrapper.forWrapperType(type);
133.540 + cache = (exact ? EXACT_WRAPPER_CASTS : WRAPPER_CASTS);
133.541 + mh = cache.get(wrap);
133.542 + if (mh != null) return mh;
133.543 + }
133.544 + if (VerifyType.isNullReferenceConversion(Object.class, type))
133.545 + mh = IDENTITY;
133.546 + else if (VerifyType.isNullType(type))
133.547 + mh = ALWAYS_NULL;
133.548 + else
133.549 + mh = MethodHandles.insertArgument(CAST_REFERENCE, 0, type);
133.550 + if (exact) {
133.551 + MethodType xmt = MethodType.make(type, Object.class);
133.552 + mh = AdapterMethodHandle.makeRawRetypeOnly(IMPL_TOKEN, xmt, mh);
133.553 + }
133.554 + if (cache != null)
133.555 + cache.put(wrap, mh);
133.556 + return mh;
133.557 + }
133.558 +
133.559 + public static MethodHandle identity() {
133.560 + return IDENTITY;
133.561 + }
133.562 +
133.563 + private static MethodHandle retype(MethodType type, MethodHandle mh) {
133.564 + return AdapterMethodHandle.makeRetypeOnly(IMPL_TOKEN, type, mh);
133.565 + }
133.566 +}
134.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
134.2 +++ b/src/share/classes/sun/dyn/util/VerifyAccess.java Thu May 14 00:17:25 2009 -0700
134.3 @@ -0,0 +1,169 @@
134.4 +/*
134.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
134.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
134.7 + *
134.8 + * This code is free software; you can redistribute it and/or modify it
134.9 + * under the terms of the GNU General Public License version 2 only, as
134.10 + * published by the Free Software Foundation. Sun designates this
134.11 + * particular file as subject to the "Classpath" exception as provided
134.12 + * by Sun in the LICENSE file that accompanied this code.
134.13 + *
134.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
134.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
134.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
134.17 + * version 2 for more details (a copy is included in the LICENSE file that
134.18 + * accompanied this code).
134.19 + *
134.20 + * You should have received a copy of the GNU General Public License version
134.21 + * 2 along with this work; if not, write to the Free Software Foundation,
134.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
134.23 + *
134.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
134.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
134.26 + * have any questions.
134.27 + */
134.28 +
134.29 +package sun.dyn.util;
134.30 +
134.31 +import java.dyn.LinkagePermission;
134.32 +import java.lang.reflect.Modifier;
134.33 +import sun.dyn.Access;
134.34 +
134.35 +/**
134.36 + * This class centralizes information about the JVM's linkage access control.
134.37 + * @author jrose
134.38 + */
134.39 +public class VerifyAccess {
134.40 +
134.41 + private VerifyAccess() { } // cannot instantiate
134.42 +
134.43 + /**
134.44 + * Evaluate the JVM linkage rules for access to the given method on behalf of caller.
134.45 + * Return non-null if and only if the given accessing class has at least partial
134.46 + * privileges to invoke the given method. The return value {@code Object.class}
134.47 + * denotes unlimited privileges.
134.48 + * <p>
134.49 + * Some circumstances require an additional check on the
134.50 + * leading parameter (the receiver) of the method, if it is non-static.
134.51 + * In the case of {@code invokespecial} ({@code doDispatch} is false),
134.52 + * the leading parameter must be the accessing class or a subclass.
134.53 + * In the case of a call to a {@code protected} method outside the same
134.54 + * package, the same constraint applies.
134.55 + * @param m the proposed callee
134.56 + * @param doDispatch if false, a non-static m will be invoked as if by {@code invokespecial}
134.57 + * @param lookupClass the class for which the access check is being made
134.58 + * @return null if the method is not accessible, else a receiver type constraint, else {@code Object.class}
134.59 + */
134.60 + public static Class<?> isAccessible(Class<?> defc, int mods,
134.61 + boolean doDispatch, Class<?> lookupClass) {
134.62 + if (!isAccessible(defc, lookupClass))
134.63 + return null;
134.64 + Class<?> constraint = Object.class;
134.65 + if (!doDispatch && !Modifier.isStatic(mods)) {
134.66 + constraint = lookupClass;
134.67 + }
134.68 + if (Modifier.isPublic(mods))
134.69 + return constraint;
134.70 + if (Modifier.isPrivate(mods))
134.71 + return isSamePackageMember(defc, lookupClass) ? constraint : null;
134.72 + if (isSamePackage(defc, lookupClass))
134.73 + return constraint;
134.74 + if (Modifier.isProtected(mods) && defc.isAssignableFrom(lookupClass))
134.75 + return constraint;
134.76 + // else it is private or package scoped, and not close enough
134.77 + return null;
134.78 + }
134.79 +
134.80 + /**
134.81 + * Evaluate the JVM linkage rules for access to the given class on behalf of caller.
134.82 + */
134.83 + public static boolean isAccessible(Class<?> refc, Class<?> lookupClass) {
134.84 + int mods = refc.getModifiers();
134.85 + if (Modifier.isPublic(mods))
134.86 + return true;
134.87 + if (isSamePackage(lookupClass, refc))
134.88 + return true;
134.89 + return false;
134.90 + }
134.91 +
134.92 + /**
134.93 + * Test if two classes have the same class loader and package qualifier.
134.94 + * @param class1
134.95 + * @param class2
134.96 + * @return whether they are in the same package
134.97 + */
134.98 + public static boolean isSamePackage(Class<?> class1, Class<?> class2) {
134.99 + if (class1 == class2)
134.100 + return true;
134.101 + if (!loadersAreRelated(class1.getClassLoader(), class2.getClassLoader()))
134.102 + return false;
134.103 + String name1 = class1.getName(), name2 = class2.getName();
134.104 + int dot = name1.lastIndexOf('.');
134.105 + if (dot != name2.lastIndexOf('.'))
134.106 + return false;
134.107 + for (int i = 0; i < dot; i++) {
134.108 + if (name1.charAt(i) != name2.charAt(i))
134.109 + return false;
134.110 + }
134.111 + return true;
134.112 + }
134.113 +
134.114 + /**
134.115 + * Test if two classes are defined as part of the same package member (top-level class).
134.116 + * If this is true, they can share private access with each other.
134.117 + * @param class1
134.118 + * @param class2
134.119 + * @return whether they are identical or nested together
134.120 + */
134.121 + public static boolean isSamePackageMember(Class<?> class1, Class<?> class2) {
134.122 + if (class1 == class2)
134.123 + return true;
134.124 + if (!isSamePackage(class1, class2))
134.125 + return false;
134.126 + if (getOutermostEnclosingClass(class1) != getOutermostEnclosingClass(class2))
134.127 + return false;
134.128 + return true;
134.129 + }
134.130 +
134.131 + private static Class<?> getOutermostEnclosingClass(Class<?> c) {
134.132 + Class<?> pkgmem = c;
134.133 + for (Class<?> enc = c; (enc = enc.getEnclosingClass()) != null; )
134.134 + pkgmem = enc;
134.135 + return pkgmem;
134.136 + }
134.137 +
134.138 + private static boolean loadersAreRelated(ClassLoader loader1, ClassLoader loader2) {
134.139 + if (loader1 == loader2 || loader1 == null || loader2 == null) {
134.140 + return true;
134.141 + }
134.142 + for (ClassLoader scan1 = loader1;
134.143 + scan1 != null; scan1 = scan1.getParent()) {
134.144 + if (scan1 == loader2) return true;
134.145 + }
134.146 + for (ClassLoader scan2 = loader2;
134.147 + scan2 != null; scan2 = scan2.getParent()) {
134.148 + if (scan2 == loader1) return true;
134.149 + }
134.150 + return false;
134.151 + }
134.152 +
134.153 + /**
134.154 + * Ensure the requesting class have privileges to perform invokedynamic
134.155 + * linkage operations on subjectClass. True if requestingClass is
134.156 + * Access.class (meaning the request originates from the JVM) or if the
134.157 + * classes are in the same package and have consistent class loaders.
134.158 + * (The subject class loader must be identical with or be a child of
134.159 + * the requesting class loader.)
134.160 + * @param requestingClass
134.161 + * @param subjectClass
134.162 + */
134.163 + public static void checkBootstrapPrivilege(Class requestingClass, Class subjectClass,
134.164 + String permissionName) {
134.165 + if (requestingClass == null) return;
134.166 + if (requestingClass == subjectClass) return;
134.167 + SecurityManager security = System.getSecurityManager();
134.168 + if (security == null) return; // open season
134.169 + if (isSamePackage(requestingClass, subjectClass)) return;
134.170 + security.checkPermission(new LinkagePermission(permissionName, requestingClass));
134.171 + }
134.172 +}
135.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
135.2 +++ b/src/share/classes/sun/dyn/util/VerifyType.java Thu May 14 00:17:25 2009 -0700
135.3 @@ -0,0 +1,219 @@
135.4 +/*
135.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
135.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
135.7 + *
135.8 + * This code is free software; you can redistribute it and/or modify it
135.9 + * under the terms of the GNU General Public License version 2 only, as
135.10 + * published by the Free Software Foundation. Sun designates this
135.11 + * particular file as subject to the "Classpath" exception as provided
135.12 + * by Sun in the LICENSE file that accompanied this code.
135.13 + *
135.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
135.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
135.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
135.17 + * version 2 for more details (a copy is included in the LICENSE file that
135.18 + * accompanied this code).
135.19 + *
135.20 + * You should have received a copy of the GNU General Public License version
135.21 + * 2 along with this work; if not, write to the Free Software Foundation,
135.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
135.23 + *
135.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
135.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
135.26 + * have any questions.
135.27 + */
135.28 +
135.29 +package sun.dyn.util;
135.30 +
135.31 +import java.dyn.MethodType;
135.32 +
135.33 +/**
135.34 + * This class centralizes information about the JVM verifier
135.35 + * and its requirements about type correctness.
135.36 + * @author jrose
135.37 + */
135.38 +public class VerifyType {
135.39 +
135.40 + private VerifyType() { } // cannot instantiate
135.41 +
135.42 + /**
135.43 + * True if a value can be stacked as the source type and unstacked as the
135.44 + * destination type, without violating the JVM's type consistency.
135.45 + *
135.46 + * @param call the type of a stacked value
135.47 + * @param recv the type by which we'd like to treat it
135.48 + * @return whether the retyping can be done without motion or reformatting
135.49 + */
135.50 + public static boolean isNullConversion(Class<?> src, Class<?> dst) {
135.51 + if (src == dst) return true;
135.52 + // Verifier allows any interface to be treated as Object:
135.53 + if (dst.isInterface()) dst = Object.class;
135.54 + if (src.isInterface()) src = Object.class;
135.55 + if (src == dst) return true; // check again
135.56 + if (dst == void.class) return true; // drop any return value
135.57 + if (isNullType(src)) return !dst.isPrimitive();
135.58 + if (!src.isPrimitive()) return dst.isAssignableFrom(src);
135.59 + // Verifier allows an int to carry byte, short, char, or even boolean:
135.60 + if (dst == int.class) return Wrapper.forPrimitiveType(src).isSubwordOrInt();
135.61 + return false;
135.62 + }
135.63 +
135.64 + /**
135.65 + * Specialization of isNullConversion to reference types.
135.66 +
135.67 + * @param call the type of a stacked value
135.68 + * @param recv the reference type by which we'd like to treat it
135.69 + * @return whether the retyping can be done without a cast
135.70 + */
135.71 + public static boolean isNullReferenceConversion(Class<?> src, Class<?> dst) {
135.72 + assert(!dst.isPrimitive());
135.73 + if (dst.isInterface()) return true; // verifier allows this
135.74 + if (isNullType(src)) return true;
135.75 + return dst.isAssignableFrom(src);
135.76 + }
135.77 +
135.78 + /**
135.79 + * Is the given type either java.lang.Void or java.lang.Null?
135.80 + * These types serve as markers for bare nulls and therefore
135.81 + * may be promoted to any type. This is secure, since
135.82 + */
135.83 + public static boolean isNullType(Class<?> type) {
135.84 + if (type == null) return false;
135.85 + return type == NULL_CLASS_1 || type == NULL_CLASS_2;
135.86 + }
135.87 + private static final Class<?> NULL_CLASS_1, NULL_CLASS_2;
135.88 + static {
135.89 + Class<?> nullClass1 = null, nullClass2 = null;
135.90 + try {
135.91 + nullClass1 = Class.forName("java.lang.Null");
135.92 + } catch (ClassNotFoundException ex) {
135.93 + // OK, we'll cope
135.94 + }
135.95 + NULL_CLASS_1 = nullClass1;
135.96 +
135.97 + // This one may also be used as a null type.
135.98 + // TO DO: Decide if we really want to legitimize it here.
135.99 + // Probably we do, unless java.lang.Null really makes it into Java 7
135.100 + nullClass2 = Void.class;
135.101 + NULL_CLASS_2 = nullClass2;
135.102 + }
135.103 +
135.104 + /**
135.105 + * True if a method handle can receive a call under a slightly different
135.106 + * method type, without moving or reformatting any stack elements.
135.107 + *
135.108 + * @param call the type of call being made
135.109 + * @param recv the type of the method handle receiving the call
135.110 + * @return whether the retyping can be done without motion or reformatting
135.111 + */
135.112 + public static boolean isNullConversion(MethodType call, MethodType recv) {
135.113 + if (call == recv) return true;
135.114 + int len = call.parameterCount();
135.115 + if (len != recv.parameterCount()) return false;
135.116 + for (int i = 0; i < len; i++)
135.117 + if (!isNullConversion(call.parameterType(i), recv.parameterType(i)))
135.118 + return false;
135.119 + return isNullConversion(recv.returnType(), call.returnType());
135.120 + }
135.121 +
135.122 + //TO DO: isRawConversion
135.123 +
135.124 + /**
135.125 + * Determine if the JVM verifier allows a value of type call to be
135.126 + * passed to a formal parameter (or return variable) of type recv.
135.127 + * Returns 1 if the verifier allows the types to match without conversion.
135.128 + * Returns -1 if the types can be made to match by a JVM-supported adapter.
135.129 + * Cases supported are:
135.130 + * <ul><li>checkcast
135.131 + * </li><li>conversion between any two integral types (but not floats)
135.132 + * </li><li>unboxing from a wrapper to its corresponding primitive type
135.133 + * </li><li>conversion in either direction between float and double
135.134 + * </li></ul>
135.135 + * (Autoboxing is not supported here; it must be done via Java code.)
135.136 + * Returns 0 otherwise.
135.137 + */
135.138 + public static int canPassUnchecked(Class<?> src, Class<?> dst) {
135.139 + if (src == dst)
135.140 + return 1;
135.141 +
135.142 + if (dst.isPrimitive()) {
135.143 + if (dst == void.class)
135.144 + // Return anything to a caller expecting void.
135.145 + // This is a property of the implementation, which links
135.146 + // return values via a register rather than via a stack push.
135.147 + // This makes it possible to ignore cleanly.
135.148 + return 1;
135.149 + if (src == void.class)
135.150 + return 0; // void-to-something?
135.151 + if (!src.isPrimitive())
135.152 + // Cannot pass a reference to any primitive type (exc. void).
135.153 + return 0;
135.154 + Wrapper sw = Wrapper.forPrimitiveType(src);
135.155 + Wrapper dw = Wrapper.forPrimitiveType(dst);
135.156 + if (sw.isSubwordOrInt() && dw.isSubwordOrInt()) {
135.157 + if (sw.bitWidth() >= dw.bitWidth())
135.158 + return -1; // truncation may be required
135.159 + if (!dw.isSigned() && sw.isSigned())
135.160 + return -1; // sign elimination may be required
135.161 + }
135.162 + if (src == float.class || dst == float.class) {
135.163 + if (src == double.class || dst == double.class)
135.164 + return -1; // floating conversion may be required
135.165 + else
135.166 + return 0; // other primitive conversions NYI
135.167 + } else {
135.168 + // all fixed-point conversions are supported
135.169 + return 0;
135.170 + }
135.171 + } else if (src.isPrimitive()) {
135.172 + // Cannot pass a primitive to any reference type.
135.173 + // (Maybe allow null.class?)
135.174 + return 0;
135.175 + }
135.176 +
135.177 + // Handle reference types in the rest of the block:
135.178 +
135.179 + // The verifier treats interfaces exactly like Object.
135.180 + if (isNullReferenceConversion(src, dst))
135.181 + // pass any reference to object or an arb. interface
135.182 + return 1;
135.183 + // else it's a definite "maybe" (cast is required)
135.184 + return -1;
135.185 + }
135.186 +
135.187 + public static int canPassRaw(Class<?> src, Class<?> dst) {
135.188 + if (dst.isPrimitive()) {
135.189 + if (dst == void.class)
135.190 + // As above, return anything to a caller expecting void.
135.191 + return 1;
135.192 + if (src == void.class)
135.193 + // Special permission for raw conversions: allow a void
135.194 + // to be captured as a garbage int.
135.195 + // Caller promises that the actual value will be disregarded.
135.196 + return dst == int.class ? 1 : 0;
135.197 + if (!src.isPrimitive())
135.198 + return 0;
135.199 + Wrapper sw = Wrapper.forPrimitiveType(src);
135.200 + Wrapper dw = Wrapper.forPrimitiveType(dst);
135.201 + if (sw.stackSlots() == dw.stackSlots())
135.202 + return 1; // can do a reinterpret-cast on a stacked primitive
135.203 + if (sw.isSubwordOrInt() && dw == Wrapper.VOID)
135.204 + return 1; // can drop an outgoing int value
135.205 + return 0;
135.206 + } else if (src.isPrimitive()) {
135.207 + return 0;
135.208 + }
135.209 +
135.210 + // Both references.
135.211 + if (isNullReferenceConversion(src, dst))
135.212 + return 1;
135.213 + return -1;
135.214 + }
135.215 +
135.216 + public static boolean isSpreadArgType(Class<?> spreadArg) {
135.217 + return spreadArg.isArray();
135.218 + }
135.219 + public static Class<?> spreadArgElementType(Class<?> spreadArg, int i) {
135.220 + return spreadArg.getComponentType();
135.221 + }
135.222 +}
136.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
136.2 +++ b/src/share/classes/sun/dyn/util/Wrapper.java Thu May 14 00:17:25 2009 -0700
136.3 @@ -0,0 +1,467 @@
136.4 +/*
136.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
136.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
136.7 + *
136.8 + * This code is free software; you can redistribute it and/or modify it
136.9 + * under the terms of the GNU General Public License version 2 only, as
136.10 + * published by the Free Software Foundation. Sun designates this
136.11 + * particular file as subject to the "Classpath" exception as provided
136.12 + * by Sun in the LICENSE file that accompanied this code.
136.13 + *
136.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
136.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
136.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
136.17 + * version 2 for more details (a copy is included in the LICENSE file that
136.18 + * accompanied this code).
136.19 + *
136.20 + * You should have received a copy of the GNU General Public License version
136.21 + * 2 along with this work; if not, write to the Free Software Foundation,
136.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
136.23 + *
136.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
136.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
136.26 + * have any questions.
136.27 + */
136.28 +
136.29 +package sun.dyn.util;
136.30 +
136.31 +public enum Wrapper {
136.32 + INT(Integer.class, int.class, 'I', (Integer)(int)0, Format.signed(32)),
136.33 + LONG(Long.class, long.class, 'J', (Long)(long)0, Format.signed(64)),
136.34 + BYTE(Byte.class, byte.class, 'B', (Byte)(byte)0, Format.signed(8)),
136.35 + SHORT(Short.class, short.class, 'S', (Short)(short)0, Format.signed(16)),
136.36 + CHAR(Character.class, char.class, 'C', (Character)(char)0, Format.unsigned(16)),
136.37 + BOOLEAN(Boolean.class, boolean.class, 'Z', (Boolean)false, Format.unsigned(1)),
136.38 + FLOAT(Float.class, float.class, 'F', (Float)(float)0, Format.floating(32)),
136.39 + DOUBLE(Double.class, double.class, 'D', (Double)(double)0, Format.floating(64)),
136.40 + VOID(Void.class, void.class, 'V', null, Format.other(0)),
136.41 + //NULL(Null.class, null.class, 'N', null, Format.other(1)),
136.42 + OBJECT(Object.class, Object.class, 'L', null, Format.other(1)),
136.43 + ;
136.44 +
136.45 + private final Class<?> wrapperType;
136.46 + private final Class<?> primitiveType;
136.47 + private final char basicTypeChar;
136.48 + private final Object zero;
136.49 + private final int format;
136.50 + private final String simpleName;
136.51 +
136.52 + private Wrapper(Class<?> wtype, Class<?> ptype, char tchar, Object zero, int format) {
136.53 + this.wrapperType = wtype;
136.54 + this.primitiveType = ptype;
136.55 + this.basicTypeChar = tchar;
136.56 + this.zero = zero;
136.57 + this.format = format;
136.58 + this.simpleName = wtype.getSimpleName();
136.59 + }
136.60 +
136.61 + private static abstract class Format {
136.62 + static final int SLOT_SHIFT = 0, SIZE_SHIFT = 2, KIND_SHIFT = 12;
136.63 + static final int
136.64 + SIGNED = (-1) << KIND_SHIFT,
136.65 + UNSIGNED = 0 << KIND_SHIFT,
136.66 + FLOATING = 1 << KIND_SHIFT;
136.67 + static final int
136.68 + SLOT_MASK = ((1<<(SIZE_SHIFT-SLOT_SHIFT))-1),
136.69 + SIZE_MASK = ((1<<(KIND_SHIFT-SIZE_SHIFT))-1);
136.70 + static int format(int kind, int size, int slots) {
136.71 + assert(((kind >> KIND_SHIFT) << KIND_SHIFT) == kind);
136.72 + assert((size & (size-1)) == 0); // power of two
136.73 + assert((kind == SIGNED) ? (size > 0) :
136.74 + (kind == UNSIGNED) ? (size > 0) :
136.75 + (kind == FLOATING) ? (size == 32 || size == 64) :
136.76 + false);
136.77 + assert((slots == 2) ? (size == 64) :
136.78 + (slots == 1) ? (size <= 32) :
136.79 + false);
136.80 + return kind | (size << SIZE_SHIFT) | (slots << SLOT_SHIFT);
136.81 + }
136.82 + static int
136.83 + INT = SIGNED | (32 << SIZE_SHIFT) | (1 << SLOT_SHIFT),
136.84 + BOOLEAN = UNSIGNED | (1 << SIZE_SHIFT) | (1 << SLOT_SHIFT),
136.85 + FLOAT = FLOATING | (32 << SIZE_SHIFT) | (1 << SLOT_SHIFT),
136.86 + VOID = UNSIGNED | (0 << SIZE_SHIFT) | (0 << SLOT_SHIFT),
136.87 + NUM_MASK = (-1) << SIZE_SHIFT;
136.88 + static int signed(int size) { return format(SIGNED, size, (size > 32 ? 2 : 1)); }
136.89 + static int unsigned(int size) { return format(UNSIGNED, size, (size > 32 ? 2 : 1)); }
136.90 + static int floating(int size) { return format(FLOATING, size, (size > 32 ? 2 : 1)); }
136.91 + static int other(int slots) { return slots << SLOT_SHIFT; }
136.92 + }
136.93 +
136.94 + /// format queries:
136.95 +
136.96 + /** How many bits are in the wrapped value? Returns 0 for OBJECT or VOID. */
136.97 + public int bitWidth() { return (format >> Format.SIZE_SHIFT) & Format.SIZE_MASK; }
136.98 + /** How many JVM stack slots occupied by the wrapped value? Returns 0 for VOID. */
136.99 + public int stackSlots() { return (format >> Format.SLOT_SHIFT) & Format.SLOT_MASK; }
136.100 + /** Does the wrapped value occupy a single JVM stack slot? */
136.101 + public boolean isSingleWord() { return (format & (1 << Format.SLOT_SHIFT)) != 0; }
136.102 + /** Does the wrapped value occupy two JVM stack slots? */
136.103 + public boolean isDoubleWord() { return (format & (2 << Format.SLOT_SHIFT)) != 0; }
136.104 + /** Is the wrapped type numeric (not void or object)? */
136.105 + public boolean isNumeric() { return (format & Format.NUM_MASK) != 0; }
136.106 + /** Is the wrapped type a primitive other than float, double, or void? */
136.107 + public boolean isIntegral() { return isNumeric() && format < Format.FLOAT; }
136.108 + /** Is the wrapped type one of int, boolean, byte, char, or short? */
136.109 + public boolean isSubwordOrInt() { return isIntegral() && isSingleWord(); }
136.110 + /* Is the wrapped value a signed integral type (one of byte, short, int, or long)? */
136.111 + public boolean isSigned() { return format < Format.VOID; }
136.112 + /* Is the wrapped value an unsigned integral type (one of boolean or char)? */
136.113 + public boolean isUnsigned() { return format >= Format.BOOLEAN && format < Format.FLOAT; }
136.114 + /** Is the wrapped type either float or double? */
136.115 + public boolean isFloating() { return format >= Format.FLOAT; }
136.116 +
136.117 + /** Produce a zero value for the given wrapper type.
136.118 + * This will be a numeric zero for a number or character,
136.119 + * false for a boolean, and null for a reference or void.
136.120 + * The common thread is that this is what is contained
136.121 + * in a default-initialized variable of the given primitive
136.122 + * type. (For void, it is what a reflective method returns
136.123 + * instead of no value at all.)
136.124 + */
136.125 + public Object zero() { return zero; }
136.126 +
136.127 + /** Produce a zero value for the given wrapper type T.
136.128 + * The optinoal argument must a type compatible with this wrapper.
136.129 + * Equivalent to {@code this.cast(this.zero(), type)}.
136.130 + */
136.131 + public <T> T zero(Class<T> type) { return cast(zero, type); }
136.132 +
136.133 +// /** Produce a wrapper for the given wrapper or primitive type. */
136.134 +// public static Wrapper valueOf(Class<?> type) {
136.135 +// if (isPrimitiveType(type))
136.136 +// return forPrimitiveType(type);
136.137 +// else
136.138 +// return forWrapperType(type);
136.139 +// }
136.140 +
136.141 + /** Return the wrapper that wraps values of the given type.
136.142 + * The type may be {@code Object}, meaning the {@code OBJECT} wrapper.
136.143 + * Otherwise, the type must be a primitive.
136.144 + * @throws IllegalArgumentException for unexpected types
136.145 + */
136.146 + public static Wrapper forPrimitiveType(Class<?> type) {
136.147 + Wrapper w = FROM_PRIM[hashPrim(type)];
136.148 + if (w != null && w.primitiveType == type) {
136.149 + return w;
136.150 + }
136.151 + if (type.isPrimitive())
136.152 + throw new InternalError(); // redo hash function
136.153 + throw newIllegalArgumentException("not primitive: "+type);
136.154 + }
136.155 +
136.156 + /** Return the wrapper that wraps values into the given wrapper type.
136.157 + * If it is {@code Object} or an interface, return {@code OBJECT}.
136.158 + * Otherwise, it must be a wrapper type.
136.159 + * The type must not be a primitive type.
136.160 + * @throws IllegalArgumentException for unexpected types
136.161 + */
136.162 + public static Wrapper forWrapperType(Class<?> type) {
136.163 + Wrapper w = findWrapperType(type);
136.164 + if (w != null) return w;
136.165 + for (Wrapper x : values())
136.166 + if (w.wrapperType == type)
136.167 + throw new InternalError(); // redo hash function
136.168 + throw newIllegalArgumentException("not wrapper: "+type);
136.169 + }
136.170 +
136.171 + static Wrapper findWrapperType(Class<?> type) {
136.172 + Wrapper w = FROM_WRAP[hashWrap(type)];
136.173 + if (w != null && w.wrapperType == type) {
136.174 + return w;
136.175 + }
136.176 + if (type.isInterface())
136.177 + return OBJECT;
136.178 + return null;
136.179 + }
136.180 +
136.181 + /** Return the wrapper that corresponds to the given bytecode
136.182 + * signature character. Return {@code OBJECT} for the character 'L'.
136.183 + * @throws IllegalArgumentException for any non-signature character or {@code '['}.
136.184 + */
136.185 + public static Wrapper forBasicType(char type) {
136.186 + Wrapper w = FROM_CHAR[hashChar(type)];
136.187 + if (w != null && w.basicTypeChar == type) {
136.188 + return w;
136.189 + }
136.190 + for (Wrapper x : values())
136.191 + if (w.basicTypeChar == type)
136.192 + throw new InternalError(); // redo hash function
136.193 + throw newIllegalArgumentException("not basic type char: "+type);
136.194 + }
136.195 +
136.196 + /** Return the wrapper for the given type, if it is
136.197 + * a primitive type, else return {@code OBJECT}.
136.198 + */
136.199 + public static Wrapper forBasicType(Class<?> type) {
136.200 + if (type.isPrimitive())
136.201 + return forPrimitiveType(type);
136.202 + return OBJECT; // any reference, including wrappers or arrays
136.203 + }
136.204 +
136.205 + // Note on perfect hashes:
136.206 + // for signature chars c, do (c + (c >> 1)) % 16
136.207 + // for primitive type names n, do (n[0] + n[2]) % 16
136.208 + // The type name hash works for both primitive and wrapper names.
136.209 + // You can add "java/lang/Object" to the primitive names.
136.210 + // But you add the wrapper name Object, use (n[2] + (3*n[1])) % 16.
136.211 + private static final Wrapper[] FROM_PRIM = new Wrapper[16];
136.212 + private static final Wrapper[] FROM_WRAP = new Wrapper[16];
136.213 + private static final Wrapper[] FROM_CHAR = new Wrapper[16];
136.214 + private static int hashPrim(Class<?> x) {
136.215 + String xn = x.getName();
136.216 + if (xn.length() < 3) return 0;
136.217 + return (xn.charAt(0) + xn.charAt(2)) % 16;
136.218 + }
136.219 + private static int hashWrap(Class<?> x) {
136.220 + String xn = x.getName();
136.221 + final int offset = 10; assert(offset == "java.lang.".length());
136.222 + if (xn.length() < offset+3) return 0;
136.223 + return (3*xn.charAt(offset+1) + xn.charAt(offset+2)) % 16;
136.224 + }
136.225 + private static int hashChar(char x) {
136.226 + return (x + (x >> 1)) % 16;
136.227 + }
136.228 + static {
136.229 + for (Wrapper w : values()) {
136.230 + int pi = hashPrim(w.primitiveType);
136.231 + int wi = hashWrap(w.wrapperType);
136.232 + int ci = hashChar(w.basicTypeChar);
136.233 + assert(FROM_PRIM[pi] == null);
136.234 + assert(FROM_WRAP[wi] == null);
136.235 + assert(FROM_CHAR[ci] == null);
136.236 + FROM_PRIM[pi] = w;
136.237 + FROM_WRAP[wi] = w;
136.238 + FROM_CHAR[ci] = w;
136.239 + }
136.240 + //assert(jdk.sun.dyn.util.WrapperTest.test(false));
136.241 + }
136.242 +
136.243 + /** What is the primitive type wrapped by this wrapper? */
136.244 + public Class<?> primitiveType() { return primitiveType; }
136.245 +
136.246 + /** What is the wrapper type for this wrapper? */
136.247 + public Class<?> wrapperType() { return wrapperType; }
136.248 +
136.249 + /** What is the wrapper type for this wrapper?
136.250 + * The example type must be the wrapper type,
136.251 + * or the corresponding primitive type.
136.252 + * The resulting class type has the same type parameter.
136.253 + */
136.254 + public <T> Class<T> wrapperType(Class<T> exampleType) {
136.255 + if (exampleType == wrapperType) {
136.256 + return exampleType;
136.257 + } else if (exampleType == primitiveType ||
136.258 + wrapperType == Object.class ||
136.259 + exampleType.isInterface()) {
136.260 + return forceType(wrapperType, exampleType);
136.261 + }
136.262 + throw new ClassCastException(exampleType + " not <:" + wrapperType);
136.263 + }
136.264 +
136.265 + /** If {@code type} is a primitive type, return the corresponding
136.266 + * wrapper type, else return {@code type} unchanged.
136.267 + */
136.268 + public static <T> Class<T> asWrapperType(Class<T> type) {
136.269 + if (type.isPrimitive()) {
136.270 + return forPrimitiveType(type).wrapperType(type);
136.271 + }
136.272 + return type;
136.273 + }
136.274 +
136.275 + /** If {@code type} is a wrapper type, return the corresponding
136.276 + * primitive type, else return {@code type} unchanged.
136.277 + */
136.278 + public static <T> Class<T> asPrimitiveType(Class<T> type) {
136.279 + Wrapper w = findWrapperType(type);
136.280 + if (w != null) {
136.281 + return forceType(w.primitiveType(), type);
136.282 + }
136.283 + return type;
136.284 + }
136.285 +
136.286 + /** Query: Is the given type a wrapper, such as {@code Integer} or {@code Void}? */
136.287 + public static boolean isWrapperType(Class<?> type) {
136.288 + return findWrapperType(type) != null;
136.289 + }
136.290 +
136.291 + /** Query: Is the given type a primitive, such as {@code int} or {@code void}? */
136.292 + public static boolean isPrimitiveType(Class<?> type) {
136.293 + return type.isPrimitive();
136.294 + }
136.295 +
136.296 + /** What is the bytecode signature character for this wrapper's
136.297 + * primitive type?
136.298 + */
136.299 + public char basicTypeChar() { return basicTypeChar; }
136.300 +
136.301 + /** What is the simple name of the wrapper type?
136.302 + */
136.303 + public String simpleName() { return simpleName; }
136.304 +
136.305 +// /** Wrap a value in the given type, which may be either a primitive or wrapper type.
136.306 +// * Performs standard primitive conversions, including truncation and float conversions.
136.307 +// */
136.308 +// public static <T> T wrap(Object x, Class<T> type) {
136.309 +// return Wrapper.valueOf(type).cast(x, type);
136.310 +// }
136.311 +
136.312 + /** Cast a wrapped value to the given type, which may be either a primitive or wrapper type.
136.313 + * Performs standard primitive conversions, including truncation and float conversions.
136.314 + * The given type must be compatible with this wrapper. That is, it must either
136.315 + * be the wrapper type (or a subtype, in the case of {@code OBJECT} or else
136.316 + * it must be the wrapper's primitive type.
136.317 + * @throws ClassCastException if the given type is not compatible with this wrapper
136.318 + */
136.319 + public <T> T cast(Object x, Class<T> type) {
136.320 + Class<T> wtype = wrapperType(type);
136.321 + if (wtype.isInstance(x))
136.322 + return wtype.cast(x);
136.323 + return wtype.cast(wrap(x));
136.324 + }
136.325 +
136.326 + /** Cast a reference type to another reference type.
136.327 + * If the target type is an interface, perform no runtime check.
136.328 + * (This loophole is safe, and is allowed by the JVM verifier.)
136.329 + * If the target type is a primitive, change it to a wrapper.
136.330 + */
136.331 + static <T> Class<T> forceType(Class<?> type, Class<T> exampleType) {
136.332 + assert(type == exampleType ||
136.333 + type == asWrapperType(exampleType) ||
136.334 + type == Object.class && exampleType.isInterface());
136.335 + Class<T> result = (Class<T>) type; // unchecked warning is expected here
136.336 + return result;
136.337 + }
136.338 +
136.339 + /** Wrap a value in this wrapper's type.
136.340 + * Performs standard primitive conversions, including truncation and float conversions.
136.341 + * Performs returns the unchanged reference for {@code OBJECT}.
136.342 + * Returns null for {@code VOID}.
136.343 + * Returns a zero value for a null input.
136.344 + * @throws ClassCastException if this wrapper is numeric and the operand
136.345 + * is not a number, character, boolean, or null
136.346 + */
136.347 + public Object wrap(Object x) {
136.348 + // do non-numeric wrappers first
136.349 + switch (basicTypeChar) {
136.350 + case 'L': return x;
136.351 + case 'V': return null;
136.352 + }
136.353 + Number xn = numberValue(x);
136.354 + switch (basicTypeChar) {
136.355 + case 'I': return Integer.valueOf(xn.intValue());
136.356 + case 'J': return Long.valueOf(xn.longValue());
136.357 + case 'F': return Float.valueOf(xn.floatValue());
136.358 + case 'D': return Double.valueOf(xn.doubleValue());
136.359 + case 'S': return Short.valueOf((short) xn.intValue());
136.360 + case 'B': return Byte.valueOf((byte) xn.intValue());
136.361 + case 'C': return Character.valueOf((char) xn.intValue());
136.362 + case 'Z': return Boolean.valueOf(boolValue(xn.longValue()));
136.363 + }
136.364 + throw new InternalError("bad wrapper");
136.365 + }
136.366 +
136.367 + /** Wrap a value (an int or smaller value) in this wrapper's type.
136.368 + * Performs standard primitive conversions, including truncation and float conversions.
136.369 + * Produces an {@code Integer} for {@code OBJECT}, although the exact type
136.370 + * of the operand is not known.
136.371 + * Returns null for {@code VOID}.
136.372 + */
136.373 + public Object wrap(int x) {
136.374 + if (basicTypeChar == 'L') return (Integer)x;
136.375 + switch (basicTypeChar) {
136.376 + case 'L': throw newIllegalArgumentException("cannot wrap to object type");
136.377 + case 'V': return null;
136.378 + case 'I': return Integer.valueOf((int)x);
136.379 + case 'J': return Long.valueOf(x);
136.380 + case 'F': return Float.valueOf(x);
136.381 + case 'D': return Double.valueOf(x);
136.382 + case 'S': return Short.valueOf((short) x);
136.383 + case 'B': return Byte.valueOf((byte) x);
136.384 + case 'C': return Character.valueOf((char) x);
136.385 + case 'Z': return Boolean.valueOf(boolValue(x));
136.386 + }
136.387 + throw new InternalError("bad wrapper");
136.388 + }
136.389 +
136.390 + /** Wrap a value (a long or smaller value) in this wrapper's type.
136.391 + * Does not perform floating point conversion.
136.392 + * Produces a {@code Long} for {@code OBJECT}, although the exact type
136.393 + * of the operand is not known.
136.394 + * Returns null for {@code VOID}.
136.395 + */
136.396 + public Object wrapRaw(long x) {
136.397 + switch (basicTypeChar) {
136.398 + case 'F': return Float.valueOf(Float.intBitsToFloat((int)x));
136.399 + case 'D': return Double.valueOf(Double.longBitsToDouble(x));
136.400 + case 'L': // same as 'J':
136.401 + case 'J': return (Long) x;
136.402 + }
136.403 + // Other wrapping operations are just the same, given that the
136.404 + // operand is already promoted to an int.
136.405 + return wrap((int)x);
136.406 + }
136.407 +
136.408 + /** Produce bitwise value which encodes the given wrapped value.
136.409 + * Does not perform floating point conversion.
136.410 + * Returns zero for {@code VOID}.
136.411 + */
136.412 + public long unwrapRaw(Object x) {
136.413 + switch (basicTypeChar) {
136.414 + case 'F': return Float.floatToRawIntBits((Float) x);
136.415 + case 'D': return Double.doubleToRawLongBits((Double) x);
136.416 +
136.417 + case 'L': throw newIllegalArgumentException("cannot unwrap from sobject type");
136.418 + case 'V': return 0;
136.419 + case 'I': return (int)(Integer) x;
136.420 + case 'J': return (long)(Long) x;
136.421 + case 'S': return (short)(Short) x;
136.422 + case 'B': return (byte)(Byte) x;
136.423 + case 'C': return (char)(Character) x;
136.424 + case 'Z': return (boolean)(Boolean) x ? 1 : 0;
136.425 + }
136.426 + throw new InternalError("bad wrapper");
136.427 + }
136.428 +
136.429 + /** Report what primitive type holds this guy's raw value. */
136.430 + public Class<?> rawPrimitiveType() {
136.431 + return rawPrimitive().primitiveType();
136.432 + }
136.433 +
136.434 + /** Report, as a wrapper, what primitive type holds this guy's raw value.
136.435 + * Returns self for INT, LONG, OBJECT; returns LONG for DOUBLE,
136.436 + * else returns INT.
136.437 + */
136.438 + public Wrapper rawPrimitive() {
136.439 + switch (basicTypeChar) {
136.440 + case 'S': case 'B':
136.441 + case 'C': case 'Z':
136.442 + case 'V':
136.443 + case 'F':
136.444 + return INT;
136.445 + case 'D':
136.446 + return LONG;
136.447 + }
136.448 + return this;
136.449 + }
136.450 +
136.451 + private static Number numberValue(Object x) {
136.452 + if (x instanceof Number) return (Number)x;
136.453 + if (x instanceof Character) return (int)(Character)x;
136.454 + if (x instanceof Boolean) return (Boolean)x ? 1 : 0;
136.455 + // Remaining allowed case of void: Must be a null reference.
136.456 + return (Number)x;
136.457 + }
136.458 +
136.459 + private static boolean boolValue(long bits) {
136.460 + //bits &= 1; // simple 31-bit zero extension
136.461 + return (bits != 0);
136.462 + }
136.463 +
136.464 + private static RuntimeException newIllegalArgumentException(String message, Object x) {
136.465 + return newIllegalArgumentException(message + x);
136.466 + }
136.467 + private static RuntimeException newIllegalArgumentException(String message) {
136.468 + return new IllegalArgumentException(message);
136.469 + }
136.470 +}
137.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
137.2 +++ b/src/share/classes/sun/dyn/util/package-info.java Thu May 14 00:17:25 2009 -0700
137.3 @@ -0,0 +1,31 @@
137.4 +/*
137.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
137.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
137.7 + *
137.8 + * This code is free software; you can redistribute it and/or modify it
137.9 + * under the terms of the GNU General Public License version 2 only, as
137.10 + * published by the Free Software Foundation. Sun designates this
137.11 + * particular file as subject to the "Classpath" exception as provided
137.12 + * by Sun in the LICENSE file that accompanied this code.
137.13 + *
137.14 + * This code is distributed in the hope that it will be useful, but WITHOUT
137.15 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
137.16 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
137.17 + * version 2 for more details (a copy is included in the LICENSE file that
137.18 + * accompanied this code).
137.19 + *
137.20 + * You should have received a copy of the GNU General Public License version
137.21 + * 2 along with this work; if not, write to the Free Software Foundation,
137.22 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
137.23 + *
137.24 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
137.25 + * CA 95054 USA or visit www.sun.com if you need additional information or
137.26 + * have any questions.
137.27 + */
137.28 +
137.29 +/**
137.30 + * Extra support for using JSR 292 RI, package java.dyn.
137.31 + * @author jrose
137.32 + */
137.33 +
137.34 +package sun.dyn.util;
138.1 --- a/src/share/classes/sun/font/TrueTypeFont.java Tue May 12 15:21:55 2009 +0900
138.2 +++ b/src/share/classes/sun/font/TrueTypeFont.java Thu May 14 00:17:25 2009 -0700
138.3 @@ -552,17 +552,6 @@
138.4 ByteBuffer os2_Table = getTableBuffer(os_2Tag);
138.5 setStyle(os2_Table);
138.6 setCJKSupport(os2_Table);
138.7 -
138.8 - ByteBuffer head_Table = getTableBuffer(headTag);
138.9 - int upem = -1;
138.10 - if (head_Table != null && head_Table.capacity() >= 18) {
138.11 - ShortBuffer sb = head_Table.asShortBuffer();
138.12 - upem = sb.get(9) & 0xffff;
138.13 - }
138.14 - setStrikethroughMetrics(os2_Table, upem);
138.15 -
138.16 - ByteBuffer post_Table = getTableBuffer(postTag);
138.17 - setUnderlineMetrics(post_Table, upem);
138.18 }
138.19
138.20 /* The array index corresponds to a bit offset in the TrueType
138.21 @@ -1020,8 +1009,26 @@
138.22 }
138.23
138.24 public void getStyleMetrics(float pointSize, float[] metrics, int offset) {
138.25 +
138.26 + if (ulSize == 0f && ulPos == 0f) {
138.27 +
138.28 + ByteBuffer head_Table = getTableBuffer(headTag);
138.29 + int upem = -1;
138.30 + if (head_Table != null && head_Table.capacity() >= 18) {
138.31 + ShortBuffer sb = head_Table.asShortBuffer();
138.32 + upem = sb.get(9) & 0xffff;
138.33 + }
138.34 +
138.35 + ByteBuffer os2_Table = getTableBuffer(os_2Tag);
138.36 + setStrikethroughMetrics(os2_Table, upem);
138.37 +
138.38 + ByteBuffer post_Table = getTableBuffer(postTag);
138.39 + setUnderlineMetrics(post_Table, upem);
138.40 + }
138.41 +
138.42 metrics[offset] = stPos * pointSize;
138.43 metrics[offset+1] = stSize * pointSize;
138.44 +
138.45 metrics[offset+2] = ulPos * pointSize;
138.46 metrics[offset+3] = ulSize * pointSize;
138.47 }
139.1 --- a/src/share/classes/sun/java2d/pipe/RenderBuffer.java Tue May 12 15:21:55 2009 +0900
139.2 +++ b/src/share/classes/sun/java2d/pipe/RenderBuffer.java Thu May 14 00:17:25 2009 -0700
139.3 @@ -63,7 +63,7 @@
139.4 * (This value can be adjusted if the cost of JNI downcalls is reduced
139.5 * in a future release.)
139.6 */
139.7 - private static final int COPY_FROM_ARRAY_THRESHOLD = 28;
139.8 + private static final int COPY_FROM_ARRAY_THRESHOLD = 6;
139.9
139.10 protected final Unsafe unsafe;
139.11 protected final long baseAddress;
139.12 @@ -93,20 +93,6 @@
139.13 }
139.14
139.15 /**
139.16 - * Copies length bytes from the Java-level srcArray to the native
139.17 - * memory located at dstAddr. Note that this method performs no bounds
139.18 - * checking. Verification that the copy will not result in memory
139.19 - * corruption should be done by the caller prior to invocation.
139.20 - *
139.21 - * @param srcArray the source array
139.22 - * @param srcPos the starting position of the source array (in bytes)
139.23 - * @param dstAddr pointer to the destination block of native memory
139.24 - * @param length the number of bytes to copy from source to destination
139.25 - */
139.26 - private static native void copyFromArray(Object srcArray, long srcPos,
139.27 - long dstAddr, long length);
139.28 -
139.29 - /**
139.30 * The behavior (and names) of the following methods are nearly
139.31 * identical to their counterparts in the various NIO Buffer classes.
139.32 */
139.33 @@ -147,9 +133,9 @@
139.34
139.35 public RenderBuffer put(byte[] x, int offset, int length) {
139.36 if (length > COPY_FROM_ARRAY_THRESHOLD) {
139.37 - long offsetInBytes = offset * SIZEOF_BYTE;
139.38 + long offsetInBytes = offset * SIZEOF_BYTE + Unsafe.ARRAY_BYTE_BASE_OFFSET;
139.39 long lengthInBytes = length * SIZEOF_BYTE;
139.40 - copyFromArray(x, offsetInBytes, curAddress, lengthInBytes);
139.41 + unsafe.copyMemory(x, offsetInBytes, null, curAddress, lengthInBytes);
139.42 position(position() + lengthInBytes);
139.43 } else {
139.44 int end = offset + length;
139.45 @@ -178,9 +164,9 @@
139.46 public RenderBuffer put(short[] x, int offset, int length) {
139.47 // assert (position() % SIZEOF_SHORT == 0);
139.48 if (length > COPY_FROM_ARRAY_THRESHOLD) {
139.49 - long offsetInBytes = offset * SIZEOF_SHORT;
139.50 + long offsetInBytes = offset * SIZEOF_SHORT + Unsafe.ARRAY_SHORT_BASE_OFFSET;
139.51 long lengthInBytes = length * SIZEOF_SHORT;
139.52 - copyFromArray(x, offsetInBytes, curAddress, lengthInBytes);
139.53 + unsafe.copyMemory(x, offsetInBytes, null, curAddress, lengthInBytes);
139.54 position(position() + lengthInBytes);
139.55 } else {
139.56 int end = offset + length;
139.57 @@ -215,9 +201,9 @@
139.58 public RenderBuffer put(int[] x, int offset, int length) {
139.59 // assert (position() % SIZEOF_INT == 0);
139.60 if (length > COPY_FROM_ARRAY_THRESHOLD) {
139.61 - long offsetInBytes = offset * SIZEOF_INT;
139.62 + long offsetInBytes = offset * SIZEOF_INT + Unsafe.ARRAY_INT_BASE_OFFSET;
139.63 long lengthInBytes = length * SIZEOF_INT;
139.64 - copyFromArray(x, offsetInBytes, curAddress, lengthInBytes);
139.65 + unsafe.copyMemory(x, offsetInBytes, null, curAddress, lengthInBytes);
139.66 position(position() + lengthInBytes);
139.67 } else {
139.68 int end = offset + length;
139.69 @@ -246,9 +232,9 @@
139.70 public RenderBuffer put(float[] x, int offset, int length) {
139.71 // assert (position() % SIZEOF_FLOAT == 0);
139.72 if (length > COPY_FROM_ARRAY_THRESHOLD) {
139.73 - long offsetInBytes = offset * SIZEOF_FLOAT;
139.74 + long offsetInBytes = offset * SIZEOF_FLOAT + Unsafe.ARRAY_FLOAT_BASE_OFFSET;
139.75 long lengthInBytes = length * SIZEOF_FLOAT;
139.76 - copyFromArray(x, offsetInBytes, curAddress, lengthInBytes);
139.77 + unsafe.copyMemory(x, offsetInBytes, null, curAddress, lengthInBytes);
139.78 position(position() + lengthInBytes);
139.79 } else {
139.80 int end = offset + length;
139.81 @@ -277,9 +263,9 @@
139.82 public RenderBuffer put(long[] x, int offset, int length) {
139.83 // assert (position() % SIZEOF_LONG == 0);
139.84 if (length > COPY_FROM_ARRAY_THRESHOLD) {
139.85 - long offsetInBytes = offset * SIZEOF_LONG;
139.86 + long offsetInBytes = offset * SIZEOF_LONG + Unsafe.ARRAY_LONG_BASE_OFFSET;
139.87 long lengthInBytes = length * SIZEOF_LONG;
139.88 - copyFromArray(x, offsetInBytes, curAddress, lengthInBytes);
139.89 + unsafe.copyMemory(x, offsetInBytes, null, curAddress, lengthInBytes);
139.90 position(position() + lengthInBytes);
139.91 } else {
139.92 int end = offset + length;
140.1 --- a/src/share/classes/sun/java2d/pipe/RenderingEngine.java Tue May 12 15:21:55 2009 +0900
140.2 +++ b/src/share/classes/sun/java2d/pipe/RenderingEngine.java Thu May 14 00:17:25 2009 -0700
140.3 @@ -95,6 +95,11 @@
140.4 * <pre>
140.5 * java -Dsun.java2d.renderer=<classname>
140.6 * </pre>
140.7 + *
140.8 + * If no specific {@code RenderingEngine} is specified on the command
140.9 + * or Ductus renderer is specified, it will attempt loading the
140.10 + * sun.dc.DuctusRenderingEngine class using Class.forName as a fastpath;
140.11 + * if not found, use the ServiceLoader.
140.12 * If no specific {@code RenderingEngine} is specified on the command
140.13 * line then the last one returned by enumerating all subclasses of
140.14 * {@code RenderingEngine} known to the ServiceLoader is used.
140.15 @@ -115,9 +120,21 @@
140.16 reImpl = (RenderingEngine)
140.17 AccessController.doPrivileged(new PrivilegedAction() {
140.18 public Object run() {
140.19 + final String ductusREClass = "sun.dc.DuctusRenderingEngine";
140.20 String reClass =
140.21 - System.getProperty("sun.java2d.renderer",
140.22 - "sun.dc.DuctusRenderingEngine");
140.23 + System.getProperty("sun.java2d.renderer", ductusREClass);
140.24 + if (reClass.equals(ductusREClass)) {
140.25 + try {
140.26 + Class cls = Class.forName(ductusREClass);
140.27 + return cls.newInstance();
140.28 + } catch (ClassNotFoundException x) {
140.29 + // not found
140.30 + } catch (IllegalAccessException x) {
140.31 + // should not reach here
140.32 + } catch (InstantiationException x) {
140.33 + // should not reach here
140.34 + }
140.35 + }
140.36
140.37 ServiceLoader<RenderingEngine> reLoader =
140.38 ServiceLoader.loadInstalled(RenderingEngine.class);
141.1 --- a/src/share/classes/sun/java2d/pisces/Stroker.java Tue May 12 15:21:55 2009 +0900
141.2 +++ b/src/share/classes/sun/java2d/pisces/Stroker.java Thu May 14 00:17:25 2009 -0700
141.3 @@ -181,7 +181,7 @@
141.4 Transform4 transform) {
141.5 this.lineWidth = lineWidth;
141.6 this.lineWidth2 = lineWidth >> 1;
141.7 - this.scaledLineWidth2 = (long)transform.m00*lineWidth2;
141.8 + this.scaledLineWidth2 = ((long)transform.m00*lineWidth2) >> 16;
141.9 this.capStyle = capStyle;
141.10 this.joinStyle = joinStyle;
141.11 this.miterLimit = miterLimit;
141.12 @@ -243,8 +243,8 @@
141.13 if (ilen == 0) {
141.14 dx = dy = 0;
141.15 } else {
141.16 - dx = (int)( (ly*scaledLineWidth2)/ilen >> 16);
141.17 - dy = (int)(-(lx*scaledLineWidth2)/ilen >> 16);
141.18 + dx = (int)( (ly*scaledLineWidth2)/ilen);
141.19 + dy = (int)(-(lx*scaledLineWidth2)/ilen);
141.20 }
141.21 } else {
141.22 double dlx = x1 - x0;
142.1 --- a/src/share/classes/sun/misc/JavaLangAccess.java Tue May 12 15:21:55 2009 +0900
142.2 +++ b/src/share/classes/sun/misc/JavaLangAccess.java Thu May 14 00:17:25 2009 -0700
142.3 @@ -55,6 +55,22 @@
142.4 /** Set thread's blocker field. */
142.5 void blockedOn(Thread t, Interruptible b);
142.6
142.7 - /** register shutdown hook */
142.8 - void registerShutdownHook(int slot, Runnable r);
142.9 + /**
142.10 + * Registers a shutdown hook.
142.11 + *
142.12 + * It is expected that this method with registerShutdownInProgress=true
142.13 + * is only used to register DeleteOnExitHook since the first file
142.14 + * may be added to the delete on exit list by the application shutdown
142.15 + * hooks.
142.16 + *
142.17 + * @params slot the slot in the shutdown hook array, whose element
142.18 + * will be invoked in order during shutdown
142.19 + * @params registerShutdownInProgress true to allow the hook
142.20 + * to be registered even if the shutdown is in progress.
142.21 + * @params hook the hook to be registered
142.22 + *
142.23 + * @throw IllegalStateException if shutdown is in progress and
142.24 + * the slot is not valid to register.
142.25 + */
142.26 + void registerShutdownHook(int slot, boolean registerShutdownInProgress, Runnable hook);
142.27 }
143.1 --- a/src/share/classes/sun/misc/Unsafe.java Tue May 12 15:21:55 2009 +0900
143.2 +++ b/src/share/classes/sun/misc/Unsafe.java Thu May 14 00:17:25 2009 -0700
143.3 @@ -1,5 +1,5 @@
143.4 /*
143.5 - * Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
143.6 + * Copyright 2000-2009 Sun Microsystems, Inc. All Rights Reserved.
143.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
143.8 *
143.9 * This code is free software; you can redistribute it and/or modify it
143.10 @@ -811,6 +811,25 @@
143.11
143.12 public native Class defineClass(String name, byte[] b, int off, int len);
143.13
143.14 + /**
143.15 + * Define a class but do not make it known to the class loader or system dictionary.
143.16 + * <p>
143.17 + * For each CP entry, the corresponding CP patch must either be null or have
143.18 + * the a format that matches its tag:
143.19 + * <ul>
143.20 + * <li>Integer, Long, Float, Double: the corresponding wrapper object type from java.lang
143.21 + * <li>Utf8: a string (must have suitable syntax if used as signature or name)
143.22 + * <li>Class: any java.lang.Class object
143.23 + * <li>String: any object (not just a java.lang.String)
143.24 + * <li>InterfaceMethodRef: (NYI) a method handle to invoke on that call site's arguments
143.25 + * </ul>
143.26 + * @params hostClass context for linkage, access control, protection domain, and class loader
143.27 + * @params data bytes of a class file
143.28 + * @params cpPatches where non-null entries exist, they replace corresponding CP entries in data
143.29 + */
143.30 + public native Class defineAnonymousClass(Class hostClass, byte[] data, Object[] cpPatches);
143.31 +
143.32 +
143.33 /** Allocate an instance but do not run any constructor.
143.34 Initializes the class if it has not yet been. */
143.35 public native Object allocateInstance(Class cls)
144.1 --- a/src/share/javavm/export/classfile_constants.h Tue May 12 15:21:55 2009 +0900
144.2 +++ b/src/share/javavm/export/classfile_constants.h Thu May 14 00:17:25 2009 -0700
144.3 @@ -1,5 +1,5 @@
144.4 /*
144.5 - * Copyright 2004-2005 Sun Microsystems, Inc. All Rights Reserved.
144.6 + * Copyright 2004-2009 Sun Microsystems, Inc. All Rights Reserved.
144.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
144.8 *
144.9 * This code is free software; you can redistribute it and/or modify it
144.10 @@ -306,7 +306,7 @@
144.11 JVM_OPC_invokespecial = 183,
144.12 JVM_OPC_invokestatic = 184,
144.13 JVM_OPC_invokeinterface = 185,
144.14 - JVM_OPC_xxxunusedxxx = 186,
144.15 + JVM_OPC_invokedynamic = 186,
144.16 JVM_OPC_new = 187,
144.17 JVM_OPC_newarray = 188,
144.18 JVM_OPC_anewarray = 189,
144.19 @@ -515,7 +515,7 @@
144.20 3, /* invokespecial */ \
144.21 3, /* invokestatic */ \
144.22 5, /* invokeinterface */ \
144.23 - 0, /* xxxunusedxxx */ \
144.24 + 5, /* invokedynamic */ \
144.25 3, /* new */ \
144.26 2, /* newarray */ \
144.27 3, /* anewarray */ \
145.1 --- a/src/share/native/common/check_code.c Tue May 12 15:21:55 2009 +0900
145.2 +++ b/src/share/native/common/check_code.c Thu May 14 00:17:25 2009 -0700
145.3 @@ -1,5 +1,5 @@
145.4 /*
145.5 - * Copyright 1994-2008 Sun Microsystems, Inc. All Rights Reserved.
145.6 + * Copyright 1994-2009 Sun Microsystems, Inc. All Rights Reserved.
145.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
145.8 *
145.9 * This code is free software; you can redistribute it and/or modify it
145.10 @@ -1223,16 +1223,20 @@
145.11 case JVM_OPC_invokevirtual:
145.12 case JVM_OPC_invokespecial:
145.13 case JVM_OPC_invokestatic:
145.14 + case JVM_OPC_invokedynamic:
145.15 case JVM_OPC_invokeinterface: {
145.16 /* Make sure the constant pool item is the right type. */
145.17 int key = (code[offset + 1] << 8) + code[offset + 2];
145.18 const char *methodname;
145.19 jclass cb = context->class;
145.20 fullinfo_type clazz_info;
145.21 - int is_constructor, is_internal;
145.22 + int is_constructor, is_internal, is_invokedynamic;
145.23 int kind = (opcode == JVM_OPC_invokeinterface
145.24 ? 1 << JVM_CONSTANT_InterfaceMethodref
145.25 + : opcode == JVM_OPC_invokedynamic
145.26 + ? 1 << JVM_CONSTANT_NameAndType
145.27 : 1 << JVM_CONSTANT_Methodref);
145.28 + is_invokedynamic = opcode == JVM_OPC_invokedynamic;
145.29 /* Make sure the constant pool item is the right type. */
145.30 verify_constant_pool_type(context, key, kind);
145.31 methodname = JVM_GetCPMethodNameUTF(env, cb, key);
145.32 @@ -1241,8 +1245,11 @@
145.33 is_internal = methodname[0] == '<';
145.34 pop_and_free(context);
145.35
145.36 - clazz_info = cp_index_to_class_fullinfo(context, key,
145.37 - JVM_CONSTANT_Methodref);
145.38 + if (is_invokedynamic)
145.39 + clazz_info = context->object_info; // anything will do
145.40 + else
145.41 + clazz_info = cp_index_to_class_fullinfo(context, key,
145.42 + JVM_CONSTANT_Methodref);
145.43 this_idata->operand.i = key;
145.44 this_idata->operand2.fi = clazz_info;
145.45 if (is_constructor) {
145.46 @@ -1304,6 +1311,11 @@
145.47 "Fourth operand byte of invokeinterface must be zero");
145.48 }
145.49 pop_and_free(context);
145.50 + } else if (opcode == JVM_OPC_invokedynamic) {
145.51 + if (code[offset + 3] != 0 || code[offset + 4] != 0) {
145.52 + CCerror(context,
145.53 + "Third and fourth operand bytes of invokedynamic must be zero");
145.54 + }
145.55 } else if (opcode == JVM_OPC_invokevirtual
145.56 || opcode == JVM_OPC_invokespecial)
145.57 set_protected(context, inumber, key, opcode);
145.58 @@ -1990,6 +2002,7 @@
145.59
145.60 case JVM_OPC_invokevirtual: case JVM_OPC_invokespecial:
145.61 case JVM_OPC_invokeinit: /* invokespecial call to <init> */
145.62 + case JVM_OPC_invokedynamic:
145.63 case JVM_OPC_invokestatic: case JVM_OPC_invokeinterface: {
145.64 /* The top stuff on the stack depends on the method signature */
145.65 int operand = this_idata->operand.i;
145.66 @@ -2005,7 +2018,8 @@
145.67 print_formatted_methodname(context, operand);
145.68 }
145.69 #endif
145.70 - if (opcode != JVM_OPC_invokestatic)
145.71 + if (opcode != JVM_OPC_invokestatic &&
145.72 + opcode != JVM_OPC_invokedynamic)
145.73 /* First, push the object */
145.74 *ip++ = (opcode == JVM_OPC_invokeinit ? '@' : 'A');
145.75 for (p = signature + 1; *p != JVM_SIGNATURE_ENDFUNC; ) {
145.76 @@ -2290,6 +2304,7 @@
145.77
145.78 case JVM_OPC_invokevirtual: case JVM_OPC_invokespecial:
145.79 case JVM_OPC_invokeinit:
145.80 + case JVM_OPC_invokedynamic:
145.81 case JVM_OPC_invokeinterface: case JVM_OPC_invokestatic: {
145.82 int operand = this_idata->operand.i;
145.83 const char *signature =
145.84 @@ -2299,7 +2314,8 @@
145.85 int item;
145.86 const char *p;
145.87 check_and_push(context, signature, VM_STRING_UTF);
145.88 - if (opcode == JVM_OPC_invokestatic) {
145.89 + if (opcode == JVM_OPC_invokestatic ||
145.90 + opcode == JVM_OPC_invokedynamic) {
145.91 item = 0;
145.92 } else if (opcode == JVM_OPC_invokeinit) {
145.93 fullinfo_type init_type = this_idata->operand2.fi;
145.94 @@ -2680,6 +2696,7 @@
145.95
145.96 case JVM_OPC_invokevirtual: case JVM_OPC_invokespecial:
145.97 case JVM_OPC_invokeinit:
145.98 + case JVM_OPC_invokedynamic:
145.99 case JVM_OPC_invokestatic: case JVM_OPC_invokeinterface: {
145.100 /* Look to signature to determine correct result. */
145.101 int operand = this_idata->operand.i;
146.1 --- a/src/share/native/common/opcodes.in_out Tue May 12 15:21:55 2009 +0900
146.2 +++ b/src/share/native/common/opcodes.in_out Thu May 14 00:17:25 2009 -0700
146.3 @@ -1,5 +1,5 @@
146.4 /*
146.5 - * Copyright 1998 Sun Microsystems, Inc. All Rights Reserved.
146.6 + * Copyright 1998-2009 Sun Microsystems, Inc. All Rights Reserved.
146.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
146.8 *
146.9 * This code is free software; you can redistribute it and/or modify it
146.10 @@ -210,7 +210,7 @@
146.11 {"?", "?"}, /* invokespecial */
146.12 {"?", "?"}, /* invokestatic */
146.13 {"?", "?"}, /* invokeinterface */
146.14 - {"?", "?"}, /* xxxunusedxxx */
146.15 + {"?", "?"}, /* invokedynamic */
146.16 {"", "A"}, /* new */
146.17 {"I", "A"}, /* newarray */
146.18 {"I", "A"}, /* anewarray */
147.1 --- a/src/share/native/sun/java2d/pipe/RenderBuffer.c Tue May 12 15:21:55 2009 +0900
147.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000
147.3 @@ -1,71 +0,0 @@
147.4 -/*
147.5 - * Copyright 2005 Sun Microsystems, Inc. All Rights Reserved.
147.6 - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
147.7 - *
147.8 - * This code is free software; you can redistribute it and/or modify it
147.9 - * under the terms of the GNU General Public License version 2 only, as
147.10 - * published by the Free Software Foundation. Sun designates this
147.11 - * particular file as subject to the "Classpath" exception as provided
147.12 - * by Sun in the LICENSE file that accompanied this code.
147.13 - *
147.14 - * This code is distributed in the hope that it will be useful, but WITHOUT
147.15 - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
147.16 - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
147.17 - * version 2 for more details (a copy is included in the LICENSE file that
147.18 - * accompanied this code).
147.19 - *
147.20 - * You should have received a copy of the GNU General Public License version
147.21 - * 2 along with this work; if not, write to the Free Software Foundation,
147.22 - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
147.23 - *
147.24 - * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
147.25 - * CA 95054 USA or visit www.sun.com if you need additional information or
147.26 - * have any questions.
147.27 - */
147.28 -
147.29 -#include "jni.h"
147.30 -#include "jni_util.h"
147.31 -#include "jlong.h"
147.32 -#include <string.h>
147.33 -
147.34 -#include "sun_java2d_pipe_RenderBuffer.h"
147.35 -
147.36 -/**
147.37 - * Note: The code in this file is nearly identical to that in
147.38 - * java/nio/Bits.c...
147.39 - */
147.40 -
147.41 -#define MBYTE 1048576
147.42 -
147.43 -JNIEXPORT void JNICALL
147.44 -Java_sun_java2d_pipe_RenderBuffer_copyFromArray
147.45 - (JNIEnv *env, jclass rb,
147.46 - jobject srcArray, jlong srcPos, jlong dstAddr, jlong length)
147.47 -{
147.48 - jbyte *bytes;
147.49 - size_t size;
147.50 -
147.51 - while (length > 0) {
147.52 - /*
147.53 - * Copy no more than one megabyte at a time, to allow for GC.
147.54 - * (Probably not an issue for STR, since our buffer size is likely
147.55 - * much smaller than a megabyte, but just in case...)
147.56 - */
147.57 - size = (size_t)(length > MBYTE ? MBYTE : length);
147.58 -
147.59 - bytes = (*env)->GetPrimitiveArrayCritical(env, srcArray, NULL);
147.60 - if (bytes == NULL) {
147.61 - JNU_ThrowInternalError(env, "Unable to get array");
147.62 - return;
147.63 - }
147.64 -
147.65 - memcpy(jlong_to_ptr(dstAddr), bytes + srcPos, size);
147.66 -
147.67 - (*env)->ReleasePrimitiveArrayCritical(env, srcArray,
147.68 - bytes, JNI_ABORT);
147.69 -
147.70 - length -= size;
147.71 - dstAddr += size;
147.72 - srcPos += size;
147.73 - }
147.74 -}
148.1 --- a/src/solaris/classes/sun/java2d/x11/X11SurfaceData.java Tue May 12 15:21:55 2009 +0900
148.2 +++ b/src/solaris/classes/sun/java2d/x11/X11SurfaceData.java Thu May 14 00:17:25 2009 -0700
148.3 @@ -530,6 +530,7 @@
148.4 sType = transparent ? X11SurfaceData.IntBgrX11_BM : X11SurfaceData.IntBgrX11;
148.5 }
148.6 } else {
148.7 +
148.8 throw new sun.java2d.InvalidPipeException("Unsupported bit " +
148.9 "depth/cm combo: " +
148.10 cm.getPixelSize() +
149.1 --- a/src/solaris/doc/sun/man/man1/appletviewer.1 Tue May 12 15:21:55 2009 +0900
149.2 +++ b/src/solaris/doc/sun/man/man1/appletviewer.1 Thu May 14 00:17:25 2009 -0700
149.3 @@ -1,5 +1,4 @@
149.4 -.'" t
149.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
149.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
149.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
149.8 ."
149.9 ." This code is free software; you can redistribute it and/or modify it
149.10 @@ -19,19 +18,21 @@
149.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
149.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
149.13 ." have any questions.
149.14 -." `
149.15 -.TH appletviewer 1 "05 Aug 2006"
149.16 -." Generated by html2roff
149.17 +."
149.18 +.TH appletviewer 1 "04 May 2009"
149.19 +." Generated from HTML by html2man (author: Eric Armstrong)
149.20
149.21 .LP
149.22 -.SH NAME
149.23 +.SH "Name"
149.24 appletviewer \- The Java Applet Viewer
149.25 .LP
149.26 +.RS 3
149.27
149.28 .LP
149.29 .LP
149.30 The \f3appletviewer\fP command allows you to run applets outside of a web browser.
149.31 .LP
149.32 +.RE
149.33 .SH "SYNOPSIS"
149.34 .LP
149.35
149.36 @@ -57,15 +58,18 @@
149.37 .LP
149.38
149.39 .LP
149.40 +.RS 3
149.41 .TP 3
149.42 \-debug
149.43 -Starts the applet viewer in the Java debugger, \f3jdb\fP, thus allowing you to debug the applets in the document.
149.44 +Starts the applet viewer in the Java debugger, jdb(1), thus allowing you to debug the applets in the document.
149.45 .TP 3
149.46 \-encoding \ \ encoding name
149.47 Specify the input HTML file encoding name.
149.48 .TP 3
149.49 \-Jjavaoption
149.50 Passes through the string \f2javaoption\fP as a single argument to the Java interpreter which runs the appletviewer. The argument should not contain spaces. Multiple argument words must all begin with the prefix \f3\-J\fP, which is stripped. This is useful for adjusting the compiler's execution environment or memory usage.
149.51 +.RE
149.52 +
149.53 .LP
149.54 .LP
149.55
150.1 --- a/src/solaris/doc/sun/man/man1/apt.1 Tue May 12 15:21:55 2009 +0900
150.2 +++ b/src/solaris/doc/sun/man/man1/apt.1 Thu May 14 00:17:25 2009 -0700
150.3 @@ -1,5 +1,4 @@
150.4 -.'" t
150.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
150.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
150.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
150.8 ."
150.9 ." This code is free software; you can redistribute it and/or modify it
150.10 @@ -19,9 +18,9 @@
150.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
150.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
150.13 ." have any questions.
150.14 -." `
150.15 -.TH apt 1 "05 Aug 2006"
150.16 -." Generated by html2roff
150.17 +."
150.18 +.TH apt 1 "04 May 2009"
150.19 +." Generated from HTML by html2man (author: Eric Armstrong)
150.20
150.21 .LP
150.22 .SH "NAME"
150.23 @@ -39,12 +38,15 @@
150.24 .LP
150.25 Options may be in any order. For a discussion of parameters which apply to a specific option, see OPTIONS below.
150.26 .LP
150.27 +.RS 3
150.28 .TP 3
150.29 sourcefiles
150.30 Zero or more source files to be processed.
150.31 .TP 3
150.32 @files
150.33 One or more files that list source files or other options
150.34 +.RE
150.35 +
150.36 .LP
150.37 .SH "DESCRIPTION"
150.38 .LP
150.39 @@ -58,19 +60,19 @@
150.40 .fi
150.41 http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
150.42 .LP
150.43 +.RS 3
150.44 .TP 3
150.45 Note:
150.46 -\f2The functionality of \fP\f2apt\fP has been subsumed by the annotation\-processing infrastructure that is now part of the \f2javac\fP tool [
150.47 -.na
150.48 -\f2Solaris and Linux\fP @
150.49 -.fi
150.50 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [Windows] and standardized for use by all Java compilers. This new infrastructure relies on the language model and annotation\-processing APIs that are now part of the Java Platform. It is recommended that new annotation processor development be based on the new APIs and the \f2javac\fP tool.
150.51 +\f2The functionality of \fP\f2apt\fP has been subsumed by the annotation\-processing infrastructure that is now part of the \f2javac(1)\fP tool and standardized for use by all Java compilers. This new infrastructure relies on the language model and annotation\-processing APIs that are now part of the Java Platform. It is recommended that new annotation processor development be based on the new APIs and the \f2javac\fP tool.
150.52 +.RE
150.53 +
150.54 .LP
150.55 .SH "OPTIONS"
150.56 .LP
150.57 .SS
150.58 apt specific options
150.59 .LP
150.60 +.RS 3
150.61 .TP 3
150.62 \-s dir
150.63 Specify the directory root under which processor\-generated source files will be placed; files are placed in subdirectories based on package namespace.
150.64 @@ -89,17 +91,21 @@
150.65 .TP 3
150.66 \-factory classname
150.67 Name of annotation processor factory to use; bypasses default discovery process
150.68 +.RE
150.69 +
150.70 .LP
150.71 .SS
150.72 Options shared with javac
150.73 .LP
150.74 +.RS 3
150.75 .TP 3
150.76 \-d dir
150.77 Specify where to place processor and javac generated class files
150.78 .TP 3
150.79 -\-cp path or \-classpath
150.80 -path
150.81 +\-cp path or \-classpath path
150.82 Specify where to find user class files and annotation processor factories. If \f2\-factorypath\fP is given, the classpath is not searched for factories.
150.83 +.RE
150.84 +
150.85 .LP
150.86 .LP
150.87 Consult the javac(1) man page for information on \f2javac\fP options.
150.88 @@ -113,24 +119,11 @@
150.89 .LP
150.90 .RS 3
150.91 .TP 2
150.92 -*
150.93 -javac: [
150.94 -.na
150.95 -\f2Solaris and Linux\fP @
150.96 -.fi
150.97 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [Windows]
150.98 -.TP 2
150.99 -*
150.100 -java: [
150.101 -.na
150.102 -\f2Solaris\fP @
150.103 -.fi
150.104 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
150.105 -.na
150.106 -\f2Linux\fP @
150.107 -.fi
150.108 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] [Windows]
150.109 +o
150.110 +javac(1), java(1)
150.111 .RE
150.112
150.113 .LP
150.114 +
150.115 +.LP
150.116
151.1 --- a/src/solaris/doc/sun/man/man1/extcheck.1 Tue May 12 15:21:55 2009 +0900
151.2 +++ b/src/solaris/doc/sun/man/man1/extcheck.1 Thu May 14 00:17:25 2009 -0700
151.3 @@ -1,5 +1,4 @@
151.4 -.'" t
151.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
151.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
151.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
151.8 ."
151.9 ." This code is free software; you can redistribute it and/or modify it
151.10 @@ -19,19 +18,21 @@
151.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
151.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
151.13 ." have any questions.
151.14 -." `
151.15 -.TH extcheck 1 "05 Aug 2006"
151.16 -." Generated by html2roff
151.17 +."
151.18 +.TH extcheck 1 "04 May 2009"
151.19 +." Generated from HTML by html2man (author: Eric Armstrong)
151.20
151.21 .LP
151.22 -.SH NAME
151.23 +.SH "Name"
151.24 extcheck \- A utility to detect jar conflicts
151.25 .LP
151.26 +.RS 3
151.27
151.28 .LP
151.29 .LP
151.30 \f3extcheck\fP detects version conflicts between a target jar file and currently installed extension jar files.
151.31 .LP
151.32 +.RE
151.33 .SH "SYNOPSIS"
151.34 .LP
151.35
151.36 @@ -65,19 +66,22 @@
151.37 .LP
151.38
151.39 .LP
151.40 +.RS 3
151.41 .TP 3
151.42 \-verbose
151.43 Lists Jar files in the extension directory as they are checked. Additionally, manifest attributes of the target jar file and any conflicting jar files are also reported.
151.44 .TP 3
151.45 \-Joption
151.46 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
151.47 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
151.48 +.RE
151.49 +
151.50 .LP
151.51 .SH "SEE ALSO"
151.52 .LP
151.53
151.54 .LP
151.55 .LP
151.56 -jar
151.57 +jar(1)
151.58 .LP
151.59
151.60 .LP
152.1 --- a/src/solaris/doc/sun/man/man1/idlj.1 Tue May 12 15:21:55 2009 +0900
152.2 +++ b/src/solaris/doc/sun/man/man1/idlj.1 Thu May 14 00:17:25 2009 -0700
152.3 @@ -1,5 +1,4 @@
152.4 -.'" t
152.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
152.6 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
152.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
152.8 ."
152.9 ." This code is free software; you can redistribute it and/or modify it
152.10 @@ -19,12 +18,12 @@
152.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
152.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
152.13 ." have any questions.
152.14 -." `
152.15 -.TH idlj 1 "07 Aug 2006"
152.16 -." Generated by html2man
152.17 +."
152.18 +.TH idlj 1 "04 May 2009"
152.19 +." Generated from HTML by html2man (author: Eric Armstrong)
152.20
152.21 .LP
152.22 -.SH NAME
152.23 +.SH "Name"
152.24 idlj \- The IDL\-to\-Java Compiler
152.25 .LP
152.26 .RS 3
152.27 @@ -52,7 +51,11 @@
152.28 .LP
152.29
152.30 .LP
152.31 -The IDL\-to\-Java Compiler generates the Java bindings for a given IDL file.\ For binding details, see the OMG IDL to Java Language Language Mapping Specification. Some previous releases of the IDL\-to\-Java compiler were named \f2idltojava\fP.
152.32 +The IDL\-to\-Java Compiler generates the Java bindings for a given IDL file.\ For binding details, see the
152.33 +.na
152.34 +\f2OMG IDL to Java Language Language Mapping Specification\fP @
152.35 +.fi
152.36 +http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html. Some previous releases of the IDL\-to\-Java compiler were named \f2idltojava\fP.
152.37 .SS
152.38 Emitting Client and Server Bindings
152.39 .LP
152.40 @@ -76,10 +79,18 @@
152.41 The default server\-side model is the \f2Portable Servant Inheritance Model\fP. Given an interface \f2My\fP defined in \f2My.idl\fP, the file \f2MyPOA.java\fP is generated. You must provide the implementation for \f2My\fP and it must inherit from \f2MyPOA\fP.
152.42 .LP
152.43 .LP
152.44 -\f2MyPOA.java\fP is a stream\-based skeleton that extends \f2org.omg.PortableServer.Servant\fP and implements the \f2InvokeHandler\fP interface and the operations interface associated with the IDL interface the skeleton implements.
152.45 +\f2MyPOA.java\fP is a stream\-based skeleton that extends
152.46 +.na
152.47 +\f2org.omg.PortableServer.Servant\fP @
152.48 +.fi
152.49 +http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html and implements the \f2InvokeHandler\fP interface and the operations interface associated with the IDL interface the skeleton implements.
152.50 .LP
152.51 .LP
152.52 -The \f2PortableServer\fP module for the Portable Object Adapter (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior.
152.53 +The \f2PortableServer\fP module for the
152.54 +.na
152.55 +\f2Portable Object Adapter (POA)\fP @
152.56 +.fi
152.57 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior.
152.58 .LP
152.59 .LP
152.60 Another option for the Inheritance Model is to use the \f2\-oldImplBase\fP flag in order to generate server\-side bindings that are compatible with versions of the Java programming language prior to J2SE 1.4. Note that using the \f2\-oldImplBase\fP flag is non\-standard: these APIs are being deprecated. You would use this flag ONLY for compatibility with existing servers written in J2SE 1.3. In that case, you would need to modify an existing MAKEFILE to add the \f2\-oldImplBase\fP flag to the \f2idlj\fP compiler, otherwise POA\-based server\-side mappings will be generated. To generate server\-side bindings that are backwards compatible:
152.61 @@ -201,7 +212,11 @@
152.62 .LP
152.63 Since this form of include can become irritatingly long, another means of indicating to the compiler where to search for included files is provided. This technique is similar to the idea of an environment variable. Create a file named \f2idl.config\fP in a directory that is listed in your CLASSPATH. Inside of \f2idl.config\fP, provide a line with the following form: \f2includes=/includes;/moreIncludes\fP
152.64 .LP
152.65 -The compiler will find this file and read in the includes list. Note that in this example the separator character between the two directories is a semicolon (;). This separator character is platform dependent. On the Windows platform, use a semicolon, on the Unix platform, use a colon, etc. For more information on \f2includes\fP, read the CLASSPATH\ (Solaris) or CLASSPATH\ (Windows) documentation.
152.66 +The compiler will find this file and read in the includes list. Note that in this example the separator character between the two directories is a semicolon (;). This separator character is platform dependent. On the Windows platform, use a semicolon, on the Unix platform, use a colon, etc. For more information on \f2includes\fP, see the
152.67 +.na
152.68 +\f2Setting the Classpath\fP @
152.69 +.fi
152.70 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general.
152.71 .RE
152.72 .SS
152.73 Emitting Bindings for Include Files
153.1 --- a/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Tue May 12 15:21:55 2009 +0900
153.2 +++ b/src/solaris/doc/sun/man/man1/ja/appletviewer.1 Thu May 14 00:17:25 2009 -0700
153.3 @@ -1,5 +1,4 @@
153.4 -.'" t
153.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
153.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
153.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
153.8 ."
153.9 ." This code is free software; you can redistribute it and/or modify it
153.10 @@ -19,54 +18,58 @@
153.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
153.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
153.13 ." have any questions.
153.14 -." `
153.15 -.TH appletviewer 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
153.16 -." Generated by html2roff
153.17 +."
153.18 +.TH appletviewer 1 "04 May 2009"
153.19 +." Generated from HTML by html2man (author: Eric Armstrong)
153.20
153.21 .LP
153.22 -.SH 名前
153.23 -appletviewer \- Java アプレットビューア
153.24 +.SH ""
153.25 +appletviewer \- Java ≪ャ若
153.26 +.LP
153.27 +.RS 3
153.28 +
153.29 +.LP
153.30 +.LP
153.31 +\f3appletviewer\fP 潟潟 Web 吟紊с≪絎茵障
153.32 +.LP
153.33 +.RE
153.34 +.SH "綵√"
153.35 .LP
153.36
153.37 .LP
153.38 .LP
153.39 -\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
153.40 +\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
153.41 .LP
153.42 -.SH "形式"
153.43 +.SH "茯"
153.44 .LP
153.45
153.46 .LP
153.47 .LP
153.48 -\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
153.49 +\f3appletviewer\fP 潟潟 \f2urls\fP 絎ャ<潟純若鴻・膓ャ<潟с≪c潟ц;腓冴障羈: \f2urls\fP cсャ<潟\f2OBJECT\fP\f2EMBED\fP障 \f2APPLET\fP 帥違с≪с翫\f3appletviewer\fP 篏茵障\f3appletviewer\fP с泣若 HTML 帥違荅括完ゃ
153.50 +.na
153.51 +\f2≪ャ若≪帥違\fP @
153.52 +.fi
153.53 +http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlс
153.54 .LP
153.55 -.SH "機能説明"
153.56 +.LP
153.57 +\f3羈:\fP \f3appletviewer\fP RFC2396 ц鎘鴻宴若罘罕緇c膃垸 URL 綽荀障泣若膃垸 URL с<ゃゃRFC2396 絎号х垸茹iゃ鏆荀障
153.58 +.LP
153.59 +.SH "激с"
153.60 .LP
153.61
153.62 .LP
153.63 -.LP
153.64 -\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注:\f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
153.65 -.fi
153.66 -http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.html
153.67 -の
153.68 -.na
153.69 -「\f2AppletViewer Tags\fP」を参照してください。
153.70 -.LP
153.71 -.LP
153.72 -\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
153.73 -.LP
153.74 -.SH "オプション"
153.75 -.LP
153.76 -
153.77 -.LP
153.78 +.RS 3
153.79 .TP 3
153.80 \-debug
153.81 -Java デバッガ \f3jdb\fP でアプレットビューアを開始します。 これにより、ドキュメント中のアプレットをデバッグすることができます。
153.82 +Java jdb(1) с≪ャ若≪紮障 ャ<潟筝≪違с障
153.83 .TP 3
153.84 \-encoding \ \ encoding name
153.85 -入力 HTML ファイルのエンコーディング名を指定します。
153.86 +ュ HTML <ゃ潟潟若c潟医絎障
153.87 .TP 3
153.88 \-Jjavaoption
153.89 -文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数に空白文字を含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリの利用に有効です。
153.90 +絖 \f2javaoption\fP appletviewer 絎茵 Java ゃ潟帥帥 1 ゃ綣違羝<障綣違鴻若鴻障茲違綣違綣違鴻・莨 \f3\-J\fP у阪綽荀障潟潟ゃ絎茵医障<≪若鴻с
153.91 +.RE
153.92 +
153.93 .LP
153.94 .LP
153.95
154.1 --- a/src/solaris/doc/sun/man/man1/ja/apt.1 Tue May 12 15:21:55 2009 +0900
154.2 +++ b/src/solaris/doc/sun/man/man1/ja/apt.1 Thu May 14 00:17:25 2009 -0700
154.3 @@ -1,176 +1,126 @@
154.4 -'\" t
154.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
154.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
154.7 -.\"
154.8 -.\" This code is free software; you can redistribute it and/or modify it
154.9 -.\" under the terms of the GNU General Public License version 2 only, as
154.10 -.\" published by the Free Software Foundation.
154.11 -.\"
154.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
154.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
154.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
154.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
154.16 -.\" accompanied this code).
154.17 -.\"
154.18 -.\" You should have received a copy of the GNU General Public License version
154.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
154.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
154.21 -.\"
154.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
154.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
154.24 -.\" have any questions.
154.25 -.\" `
154.26 -.TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
154.27 -.SH "名前"
154.28 -apt \- 注釈処理ツール
154.29 -.\"
154.30 -.SH "形式"
154.31 -.B apt
154.32 -.BI [\-classpath " classpath"]
154.33 -.BI [\-sourcepath " sourcepath"]
154.34 -.BI [\-d " directory"]
154.35 -.BI [\-s " directory"]
154.36 -.BI [\-factorypath " path"]
154.37 -.BI [\-factory " class"]
154.38 -.B [\-print]
154.39 -.B [\-nocompile]
154.40 -.B [\-Akey[=val] ...]
154.41 -.BI [javac option]
154.42 -.BI sourcefiles
154.43 -.BI [@files]
154.44 -.SH "パラメータ"
154.45 -オプションは任意の順序で使用できます。特定のオプションに適用される
154.46 -パラメータについては、後述の「オプション」を参照してください。
154.47 -.if t .TP 20
154.48 -.if n .TP 15
154.49 -.I sourcefiles
154.50 -処理される 0 個以上のソースファイル。
154.51 -.if t .TP 20
154.52 -.if n .TP 15
154.53 -.I @files
154.54 -ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。
154.55 -.SH "機能説明"
154.56 -注釈処理ツール
154.57 -.B apt
154.58 -には、プログラム注釈を処理するための一連の
154.59 -新しいリフレクション API とインフラストラクチャサポートが含まれています。
154.60 -.B apt
154.61 -のリフレクション API では、プログラム構造のビューが、
154.62 -ビルド時のソースベースの読み取り専用として用意されています。
154.63 -これらのリフレクション API は、総称型の追加後に、
154.64 -Java(TM) プログラミング言語の型システムを
154.65 -わかりやすくモデル化できるように設計されました。
154.66 -はじめに、
154.67 -.B apt
154.68 -は注釈プロセッサを実行します。この注釈プロセッサでは、
154.69 -新規のソースコードおよびその他のファイルを生成します。
154.70 -次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、
154.71 -開発を容易にします。ツールと対話するためのリフレクション API と
154.72 -その他の API は、
154.73 -.B com.sun.mirror
154.74 -のサブパッケージです。
154.75 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
154.76 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
154.77 +."
154.78 +." This code is free software; you can redistribute it and/or modify it
154.79 +." under the terms of the GNU General Public License version 2 only, as
154.80 +." published by the Free Software Foundation.
154.81 +."
154.82 +." This code is distributed in the hope that it will be useful, but WITHOUT
154.83 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
154.84 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
154.85 +." version 2 for more details (a copy is included in the LICENSE file that
154.86 +." accompanied this code).
154.87 +."
154.88 +." You should have received a copy of the GNU General Public License version
154.89 +." 2 along with this work; if not, write to the Free Software Foundation,
154.90 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
154.91 +."
154.92 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
154.93 +." CA 95054 USA or visit www.sun.com if you need additional information or
154.94 +." have any questions.
154.95 +."
154.96 +.TH apt 1 "04 May 2009"
154.97 +." Generated from HTML by html2man (author: Eric Armstrong)
154.98 +
154.99 .LP
154.100 -.B apt
154.101 -によるツールの操作方法と開発手順についての詳細は、
154.102 -http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
154.103 -の「Getting Started with apt」を参照してください。
154.104 +.SH "NAME"
154.105 .LP
154.106 +.LP
154.107 +\f2apt\fP \- 羈若
154.108 +.LP
154.109 +.SH "綵√"
154.110 +.LP
154.111 +.LP
154.112 +\f2apt [\-classpath \fP\f2classpath\fP] [\-sourcepath \f2sourcepath\fP] [\-d \f2directory\fP] [\-s \f2directory\fP] [\-factorypath \f2path\fP] [\-factory \f2class\fP] [\-print] [\-nocompile] [\-A\f2key\fP[\f2=val\fP] ...][\f2javac option\fP] sourcefiles [@files]
154.113 +.LP
154.114 +.SH "<若"
154.115 +.LP
154.116 +.LP
154.117 +激с潟筝с劫激с潟<若帥ゃ筝荐激с潟с
154.118 +.LP
154.119 +.RS 3
154.120 .TP 3
154.121 -注:
154.122 -\f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [
154.123 +sourcefiles
154.124 +若1 ゃ障茲違絲乗院純若鴻<ゃ
154.125 +.TP 3
154.126 +@files
154.127 +純若鴻<ゃ障篁激с潟筝荀ц;腓冴 1 ゃ障茲違<ゃ
154.128 +.RE
154.129 +
154.130 +.LP
154.131 +.SH "茯"
154.132 +.LP
154.133 +.LP
154.134 +羈若 \f2apt\fP 違 API 泣若ゃ潟鴻c若罕違羈障\f2apt\fP API 罕膀純若鴻若鴻с違罕≪茯水絨ャ若箴障 API 膩霡違菴遵緇Java(TM) 違潟域茯激鴻罩c≪荐荐障\f2apt\fP 違純若鴻潟若篁<ゃ篏羈祉泣絎茵障罨<\f2apt\fP 純若鴻<ゃ純若鴻<ゃ筝≧鴻潟潟ゃ冴罐純障若ゃ潟帥с若鴻篏睡 API API \f2com.sun.mirror\fP 泣宴若吾с
154.135 +.LP
154.136 +.LP
154.137 +若罘純≪荅括完\f2apt\fP 篏睡堺号ゃ
154.138 .na
154.139 -\f2Solaris と Linux\fP の場合:
154.140 +\f4\fP\f4apt\fP\f3 ラ\fP @
154.141 .fi
154.142 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [
154.143 -.na
154.144 -\f2Windows\fP の場合:
154.145 -.fi
154.146 -http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。
154.147 +http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlс
154.148 .LP
154.149 -.SH "オプション"
154.150 -.SS apt 固有のオプション
154.151 -.if t .TP 20
154.152 -.if n .TP 15
154.153 -.BI \-s " dir"
154.154 -プロセッサが生成するソースファイルが配置されるディレクトリルートを
154.155 -指定します。ファイルはパッケージのネームスペースに従って、
154.156 -サブディレクトリに配置されます。
154.157 -.if t .TP 20
154.158 -.if n .TP 15
154.159 -.BI \-nocompile
154.160 -ソースファイルをクラスファイルにコンパイルしません。
154.161 -.if t .TP 20
154.162 -.if n .TP 15
154.163 -.BI \-print
154.164 -指定した型のテキスト表現を出力します。
154.165 -注釈処理やコンパイルは実行しません。
154.166 -.if t .TP 20
154.167 -.if n .TP 15
154.168 -.BI \-A[key[=val]]
154.169 -注釈プロセッサに渡されるオプション。
154.170 -.B apt
154.171 -は、これらのオプションを直接解釈しませんが、個別のプロセッサ
154.172 -によって使用可能になります。
154.173 -.if t .TP 20
154.174 -.if n .TP 15
154.175 -.BI \-factorypath " path"
154.176 -注釈プロセッサファクトリを検索する場所を指定します。
154.177 -このオプションを使用する場合、ファクトリの検索に
154.178 -クラスパスは使用されません。
154.179 -.if t .TP 20
154.180 -.if n .TP 15
154.181 -.BI \-factory " classname"
154.182 -使用する注釈プロセッサファクトリの名前。
154.183 -デフォルトの検出処理はバイパスされます。
154.184 -.SS javac と共有されるオプション
154.185 -.if t .TP 20
154.186 -.if n .TP 15
154.187 -.BI \-d " dir"
154.188 -プロセッサおよび
154.189 -.B javac
154.190 -が生成したクラスファイルを配置する場所を指定します。
154.191 -.if t .TP 20
154.192 -.if n .TP 15
154.193 -.BI \-cp " path " \fLまたは\fP \fL\-classpath " path"
154.194 -ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を
154.195 -指定します。
154.196 -.B \-factorypath
154.197 -を指定した場合、ファクトリの検索にクラスパスは使用されません。
154.198 +.RS 3
154.199 +.TP 3
154.200 +羈:
154.201 +\f2apt\fP 罘純\f2javac(1)\fP 若筝c羈ゃ潟鴻c若腟粋昭障鴻 Java 潟潟ゃт戎с罔羣障違ゃ潟鴻c若荐茯≪ Java 若筝c羈 API 箴絖障羈祉泣冴違 API \f2javac\fP 若冴ャ茵с障
154.202 +.RE
154.203 +
154.204 .LP
154.205 -javac のオプションについては、
154.206 -.BR javac(1)
154.207 -のマニュアルページを参照してください。
154.208 -.SH 注意事項
154.209 +.SH "激с"
154.210 .LP
154.211 -\f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。
154.212 +.SS
154.213 +apt 堺激с
154.214 .LP
154.215 -.SH "関連項目"
154.216 +.RS 3
154.217 +.TP 3
154.218 +\-s dir
154.219 +祉泣純若鴻<ゃ臀c若絎障 <ゃ宴若吾腥咲冴ャ泣c臀障
154.220 +.TP 3
154.221 +\-nocompile
154.222 +純若鴻<ゃ鴻<ゃ潟潟ゃ障
154.223 +.TP 3
154.224 +\-print
154.225 +絎帥ゃ鴻茵憗阪障 羈障潟潟ゃ茵障
154.226 +.TP 3
154.227 +\-A[key[=val]]
154.228 +羈祉泣御検激с潟с 激с潟\f2apt\fP 贋・茹iс祉泣c篏睡с紊障
154.229 +.TP 3
154.230 +\-factorypath path
154.231 +羈祉泣<罎膣≪贋絎障 激с潟篏睡翫鴻鴻<罎膣≪障
154.232 +.TP 3
154.233 +\-factory classname
154.234 +篏睡羈祉泣<с 罎冴祉鴻ャ障
154.235 +.RE
154.236 +
154.237 +.LP
154.238 +.SS
154.239 +javac 援激с
154.240 +.LP
154.241 +.RS 3
154.242 +.TP 3
154.243 +\-d dir
154.244 +祉泣 javac 鴻<ゃ臀贋絎障
154.245 +.TP 3
154.246 +\-cp path or \-classpath path
154.247 +若吟若鴻<ゃ羈祉泣<罎膣≪贋絎障\f2\-factorypath\fP 絎翫鴻鴻<罎膣≪障
154.248 +.RE
154.249 +
154.250 +.LP
154.251 +.LP
154.252 +\f2javac\fP 激с潟荅括完ゃjavac(1) ャ≪若吾с
154.253 +.LP
154.254 +.SH "羈"
154.255 +.LP
154.256 +.LP
154.257 +\f2apt\fP 罘純\f2javac\fP 箴罔羣羈ゃ潟鴻c若腟粋昭障障篁緇 JDK 若鴻с\f2apt\fP 渇∫c API 泣若筝罩≪醇с障
154.258 +.LP
154.259 +.SH "∫i"
154.260 .LP
154.261 .RS 3
154.262 .TP 2
154.263 -*
154.264 -javac: [
154.265 -.na
154.266 -\f2Solaris と Linux\fP の場合:
154.267 -.fi
154.268 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html]
154.269 -[ \f2Windows\fP の場合:
154.270 -.fi
154.271 -http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html]
154.272 -.TP 2
154.273 -*
154.274 -java: [
154.275 -.na
154.276 -\f2Solaris\fP の場合:
154.277 -.fi
154.278 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
154.279 -.na
154.280 -\f2Linux\fP の場合:
154.281 -.fi
154.282 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html]
154.283 -[ \f2Windows\fP の場合:
154.284 -.fi
154.285 -http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html]
154.286 +o
154.287 +javac(1), java(1)
154.288 .RE
154.289
154.290 .LP
155.1 --- a/src/solaris/doc/sun/man/man1/ja/extcheck.1 Tue May 12 15:21:55 2009 +0900
155.2 +++ b/src/solaris/doc/sun/man/man1/ja/extcheck.1 Thu May 14 00:17:25 2009 -0700
155.3 @@ -1,107 +1,88 @@
155.4 -'\" t
155.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
155.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
155.7 -.\"
155.8 -.\" This code is free software; you can redistribute it and/or modify it
155.9 -.\" under the terms of the GNU General Public License version 2 only, as
155.10 -.\" published by the Free Software Foundation.
155.11 -.\"
155.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
155.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
155.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
155.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
155.16 -.\" accompanied this code).
155.17 -.\"
155.18 -.\" You should have received a copy of the GNU General Public License version
155.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
155.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
155.21 -.\"
155.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
155.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
155.24 -.\" have any questions.
155.25 -.\" `
155.26 -'\"macro stdmacro
155.27 -.TH extcheck 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
155.28 -.SH "名前"
155.29 -extcheck \- jar の競合検出ユーティリティ
155.30 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
155.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
155.32 +."
155.33 +." This code is free software; you can redistribute it and/or modify it
155.34 +." under the terms of the GNU General Public License version 2 only, as
155.35 +." published by the Free Software Foundation.
155.36 +."
155.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
155.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
155.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
155.40 +." version 2 for more details (a copy is included in the LICENSE file that
155.41 +." accompanied this code).
155.42 +."
155.43 +." You should have received a copy of the GNU General Public License version
155.44 +." 2 along with this work; if not, write to the Free Software Foundation,
155.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
155.46 +."
155.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
155.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
155.49 +." have any questions.
155.50 +."
155.51 +.TH extcheck 1 "04 May 2009"
155.52 +." Generated from HTML by html2man (author: Eric Armstrong)
155.53 +
155.54 +.LP
155.55 +.SH ""
155.56 +extcheck \- jar 腴九罎冴若cc
155.57 +.LP
155.58 +.RS 3
155.59 +
155.60 +.LP
155.61 +.LP
155.62 +\f3extcheck\fP 帥若蚊 jar <ゃ憜ゃ潟鴻若≦宍罘純 jar <ゃ若吾с潟腴九罎冴障
155.63 +.LP
155.64 +.RE
155.65 +.SH "綵√"
155.66 .LP
155.67
155.68 .LP
155.69 +.nf
155.70 +\f3
155.71 +.fl
155.72 +extcheck [ \-verbose ] targetfile.jar
155.73 +.fl
155.74 +\fP
155.75 +.fi
155.76 +
155.77 .LP
155.78 -\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
155.79 +.SH "茯"
155.80 .LP
155.81 -.SH "形式"
155.82 -.B extcheck
155.83 -[
155.84 -.B \-verbose
155.85 -]
155.86 -.B targetfile.jar
155.87 -.SH "機能説明"
155.88 -.IX "jar conflict detection utility" "" "jar conflict detection utility \(em \fLextcheck\fP"
155.89 -.IX "extcheck" "" "\fLextcheck\fP \(em jar conflict detection utility"
155.90 -.B extcheck
155.91 -ユーティリティは、指定された
155.92 -.B jar
155.93 -ファイルのタイトルおよびバージョンが Java(TM) SDK
155.94 -ソフトウェアにインストールされている拡張機能と競合していないかを
155.95 -検査します。
155.96 -拡張機能をインストールする前に、このユーティリティを使って、
155.97 -バージョンが同じか、
155.98 -より新しい拡張機能がすでにインストールされていないかどうかを調べる
155.99 -ことができます。
155.100 +
155.101 .LP
155.102 -.B extcheck
155.103 -ユーティリティは、
155.104 -.I targetfile.jar
155.105 -ファイルのマニフェスト内のヘッダ
155.106 -.I Specification-title
155.107 -および
155.108 -.I Specification-version
155.109 -を、拡張機能ディレクトリ内に現在インストールされているすべての jar
155.110 -ファイル内の対応するヘッダと比較します。
155.111 -デフォルトでは、拡張機能ディレクトリは、
155.112 -.I jre/lib/ext
155.113 -です。
155.114 -.B extcheck
155.115 -ユーティリティは、
155.116 -.I java.lang.Package.isCompatibleWith
155.117 -メソッドと同様の方法でバージョン番号を比較します。
155.118 .LP
155.119 -競合が検出されない場合、リターンコードは
155.120 -.I 0 です。
155.121 +\f3extcheck\fP 若cc若絎 Jar <ゃ帥ゃ潟若吾с潟 Java(TM) 2 SDK ゃ潟鴻若≦宍罘純腴九с障≦宍罘純ゃ潟鴻若若cc若篏帥c若吾с潟違≦宍罘純сゃ潟鴻若茯帥鴻с障
155.122 .LP
155.123 -拡張機能ディレクトリ内の
155.124 -.B jar
155.125 -ファイルのマニフェストに、同一の
155.126 -.I Specification-title、
155.127 -および同一またはより新しい
155.128 -.I Specification-version
155.129 -番号がある場合、ゼロでないエラー
155.130 -コードが返されます。
155.131 -.I targetfile.jar
155.132 -のマニフェストに
155.133 -.I Specification-title
155.134 -または
155.135 -.I Specification-version
155.136 -属性がない場合も、ゼロでないエラーコードが返されます。
155.137 -.SH "オプション"
155.138 -以下のオプションが指定できます。
155.139 -.TP 15
155.140 -.B -verbose
155.141 -拡張機能ディレクトリ内の
155.142 -.B jar
155.143 -ファイルを、検査時に一覧表示します。また、ターゲット
155.144 -.B jar
155.145 -ファイルのマニフェストの属性、および競合する
155.146 -.B jar
155.147 -ファイルについても報告します。
155.148 -.TP 15
155.149 -.BI \-J "option"
155.150 -.I option
155.151 -を Java 仮想マシンに渡します。ここで、
155.152 -.I option
155.153 -は、Java アプリケーション起動プログラム java(1) のマニュアルページで
155.154 -説明されているオプションの 1 つです。たとえば、-J-Xms48m
155.155 -は、起動時に使用するメモリを 48M バイトに設定します。
155.156 -.SH "関連項目"
155.157 -.BR jar (1)
155.158 +.LP
155.159 +\f3extcheck\fP 若cc若\f2targetfile.jar\fP <ゃс鴻 \f2Specification\-title\fP \f2Specification\-version\fP ≦宍罘純c憜ゃ潟鴻若鴻 Jar <ゃ絲上若罸莠障с≦宍罘純c\f2jre/lib/ext\fP с\f3extcheck\fP 若cc若\f2java.lang.Package.isCompatibleWith\fP <純罕号с若吾с括垩罸莠障
155.160 +.LP
155.161 +.LP
155.162 +腴九罎冴翫帥若潟潟若 \f20\fP с
155.163 +.LP
155.164 +.LP
155.165 +≦宍罘純c jar <ゃс鴻筝 \f2Specification\-title\fP喝筝障違 \f2Specification\-version\fP 垩翫若с若潟若菴障\f2targetfile.jar\fP с鴻 \f2Specification\-title\fP 障 \f2Specification\-version\fP 絮с翫若с若潟若菴障
155.166 +.LP
155.167 +.SH "激с"
155.168 +.LP
155.169 +
155.170 +.LP
155.171 +.RS 3
155.172 +.TP 3
155.173 +\-verbose
155.174 +≦宍罘純c Jar <ゃс筝荀ц;腓冴障障帥若蚊 jar <ゃс鴻絮с括九 jar <ゃゃ怨障
155.175 +.TP 3
155.176 +\-Joption
155.177 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
155.178 +.RE
155.179 +
155.180 +.LP
155.181 +.SH "∫i"
155.182 +.LP
155.183 +
155.184 +.LP
155.185 +.LP
155.186 +jar(1)
155.187 +.LP
155.188 +
155.189 +.LP
155.190 +
156.1 --- a/src/solaris/doc/sun/man/man1/ja/idlj.1 Tue May 12 15:21:55 2009 +0900
156.2 +++ b/src/solaris/doc/sun/man/man1/ja/idlj.1 Thu May 14 00:17:25 2009 -0700
156.3 @@ -1,200 +1,112 @@
156.4 -'\" t
156.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
156.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
156.7 -.\"
156.8 -.\" This code is free software; you can redistribute it and/or modify it
156.9 -.\" under the terms of the GNU General Public License version 2 only, as
156.10 -.\" published by the Free Software Foundation.
156.11 -.\"
156.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
156.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
156.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
156.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
156.16 -.\" accompanied this code).
156.17 -.\"
156.18 -.\" You should have received a copy of the GNU General Public License version
156.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
156.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
156.21 -.\"
156.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
156.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
156.24 -.\" have any questions.
156.25 -.\" `
156.26 -.TH idlj 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
156.27 -.SH "名前"
156.28 -idlj - IDL-to-Java コンパイラ
156.29 -.LP
156.30 -.B idlj
156.31 -は、指定された IDL ファイルから Java バインディングを生成します。
156.32 -.SH "形式"
156.33 -.B idlj
156.34 -[
156.35 -.IB options
156.36 -]
156.37 -.B idl-file
156.38 -.LP
156.39 -.BR idl-file
156.40 -には、Interface Definition Language (IDL) 定義が格納されている
156.41 -ファイルの名前を指定します。
156.42 -.BR Options
156.43 -は任意の順序で指定できますが、
156.44 -.BR idl-file
156.45 -よりも前に指定する必要があります。
156.46 -.SH "機能説明"
156.47 -IDL-to-Java コンパイラは、指定された IDL ファイルに対して Java
156.48 -バインディングを生成します。
156.49 -バインディングの詳細は、「\f2OMG IDL to Java Language Language Mapping Specification\fP」
156.50 -.fi
156.51 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html)
156.52 -を参照してください。
156.53 -IDL-to-Java コンパイラの旧リリースのなかには、
156.54 -.BR idltojava という名前が付けられていたものがあります。
156.55 -.SH "クライアントバインディングとサーババインディングの発行"
156.56 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
156.57 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
156.58 +."
156.59 +." This code is free software; you can redistribute it and/or modify it
156.60 +." under the terms of the GNU General Public License version 2 only, as
156.61 +." published by the Free Software Foundation.
156.62 +."
156.63 +." This code is distributed in the hope that it will be useful, but WITHOUT
156.64 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
156.65 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
156.66 +." version 2 for more details (a copy is included in the LICENSE file that
156.67 +." accompanied this code).
156.68 +."
156.69 +." You should have received a copy of the GNU General Public License version
156.70 +." 2 along with this work; if not, write to the Free Software Foundation,
156.71 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
156.72 +."
156.73 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
156.74 +." CA 95054 USA or visit www.sun.com if you need additional information or
156.75 +." have any questions.
156.76 +."
156.77 +.TH idlj 1 "04 May 2009"
156.78 +." Generated from HTML by html2man (author: Eric Armstrong)
156.79
156.80 .LP
156.81 -.BR My.idl
156.82 -という名前の IDL ファイルに対して Java バインディングを生成
156.83 -するには、次のように指定します。
156.84 +.SH ""
156.85 +idlj \- IDL\-to\-Java 潟潟ゃ
156.86 .LP
156.87 -.RS
156.88 -.ft 3
156.89 +.RS 3
156.90 +
156.91 +.LP
156.92 +\f3idlj\fP 絎 IDL <ゃ Java ゃ潟c潟違障
156.93 +.RE
156.94 +.SH "綵√"
156.95 +.LP
156.96 +
156.97 +.LP
156.98 .nf
156.99 -idlj My.idl
156.100 +\f3
156.101 +.fl
156.102 +idlj [ \fP\f3options\fP\f3 ] \fP\f4idl\-file\fP\f3
156.103 +.fl
156.104 +\fP
156.105 .fi
156.106 -.ft 1
156.107 -.RE
156.108 +
156.109 .LP
156.110 -クライアント側のバインディングを生成する上記のコマンドは、
156.111 -次のようにも指定できます。
156.112 .LP
156.113 -.RS
156.114 -.ft 3
156.115 -.nf
156.116 -idlj -fclient My.idl
156.117 +\f2idl\-file\fP ゃ潟帥с若劫臂荐茯 (IDL) 絎臂ャc<ゃс\f2options\fP 篁紙с\f2idl\-file\fP 絎違障
156.118 +.LP
156.119 +.SH "茯"
156.120 +.LP
156.121 +
156.122 +.LP
156.123 +IDL\-to\-Java 潟潟ゃ絎 IDL <ゃゃ Java ゃ潟c潟違障 ゃ潟c潟違荅括完
156.124 +.na
156.125 +\f2OMG IDL to Java Language Mapping Specification\fP @
156.126 .fi
156.127 -.ft 1
156.128 -.RE
156.129 +http://java.sun.com/javase/6/docs/technotes/guides/idl/mapping/jidlMapping.html сIDL\-to\-Java 潟潟ゃ篁ュ若鴻筝\f2idltojava\fP c障
156.130 +.SS
156.131 +ゃ≪潟ゃ潟c潟違潟泣若若ゃ潟c潟違肴
156.132 .LP
156.133 -クライアント側のバインディングには、サーバ側のスケルトンは
156.134 -取り込まれていません。インタフェースに対してサーバ側のバインディング
156.135 -を生成するには、次のように指定します。
156.136 +.RS 3
156.137 +
156.138 .LP
156.139 -.RS
156.140 -.ft 3
156.141 -.nf
156.142 -idlj -fserver My.idl
156.143 +My.idl IDL <ゃ絲障 Java ゃ潟c潟違罨<潟潟絎茵障 \f2idlj My.idl\fP
156.144 +.LP
156.145 +ゃ≪潟眼ゃ潟c潟違障 潟潟罨<潟潟膈箴<с \f2idlj \fP\f4\-fclient\fP\f2 My.idl\fP
156.146 +.LP
156.147 +ゃ≪潟眼ゃ潟c潟違泣若弱眼鴻宴潟腟粋昭障障ゃ潟帥с若鴻絲障泣若弱眼ゃ潟c潟違罨<潟潟絎茵障 \f2idlj \fP\f4\-fserver\fP\f2 My.idl\fP
156.148 +.LP
156.149 +泣若弱眼ゃ潟c潟違ゃ≪潟眼ゃ潟c潟違鴻宴潟腟粋昭障障 鴻 \f2POA\fP (膓帥≪) 鴻сゃ≪潟眼泣若弱眼筝≧鴻ゃ潟c潟違翫罨<潟潟 (膈箴) < 1 ゃ篏睡障 \f2idlj \fP\f4\-fclient \-fserver\fP\f2 My.idl\fP
156.150 +.br
156.151 +\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
156.152 +.LP
156.153 +.LP
156.154 +泣若弱眼≪2 ゃ≪純с膓帥≪Tie 紮茘蚊≪с
156.155 +.LP
156.156 +.LP
156.157 +泣若弱眼≪腱紙純泣若潟膓帥≪с\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2MyPOA.java\fP <ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyPOA\fP 膓帥綽荀障
156.158 +.LP
156.159 +.LP
156.160 +\f2MyPOA.java\fP
156.161 +.na
156.162 +\f2org.omg.PortableServer.Servant\fP @
156.163 .fi
156.164 -.ft 1
156.165 -.RE
156.166 +http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html ≦宍鴻若若鴻鴻宴潟с鴻宴潟絎茖 IDL ゃ潟帥с若鴻∫d \f2InvokeHandler\fP ゃ潟帥с若鴻若激с潟ゃ潟帥с若鴻絎茖障
156.167 .LP
156.168 -サーバ側のバインディングには、クライアント側のバインディングのほか
156.169 -にスケルトンが取り込まれています。これらはすべて、POA (継承モデル)
156.170 -クラスです。クライアント側とサーバ側の両方のバインディングを生成する
156.171 -には、以下の等価コマンドのどちらか一方を使用してください。
156.172 -.LP
156.173 -.RS
156.174 -.ft 3
156.175 -.nf
156.176 -idlj -fclient -fserver My.idl
156.177 -.br
156.178 -idlj -fall My.idl
156.179 -.fi
156.180 -.ft 1
156.181 -.RE
156.182 -.LP
156.183 -サーバ側モデルとしては、継承モデルと Tie 委譲モデルの 2 種類を
156.184 -利用できます。
156.185 -.LP
156.186 -デフォルトのサーバ側モデルは、ポータブルサーバント継承モデルです。
156.187 -.BR My.idl
156.188 -でインタフェース My が定義されていると、ファイル
156.189 -.BR MyPOA.java が生成されます。ユーザは、
156.190 -.BR My に対してその実装を提供する必要があります。この実装は、
156.191 -.BR MyPOA から継承しなければなりません。
156.192 -.LP
156.193 -.BR MyPOA.java は、
156.194 -.na
156.195 -\f2org.omg.PortableServer.Servant\fP
156.196 -.fi
156.197 -(http://java.sun.com/javase/6/docs/api/org/omg/PortableServer/Servant.html)
156.198 -を拡張するストリームベースのスケルトンであり、このスケルトンが実装する
156.199 -IDL インタフェースに関連した
156.200 -.BR InvokeHandler
156.201 -インタフェースとオペレーションインタフェースを実装します。
156.202 .LP
156.203 .na
156.204 -\f2Portable Object Adapter (POA)\fP
156.205 +\f2Portable Object Adapter (POA)\fP @
156.206 .fi
156.207 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html) の
156.208 -.BR PortableServer
156.209 -モジュールは、ネイティブ Servant 型を定義します。Java プログラミング言語では、
156.210 -.BR Servant
156.211 -型は、Java
156.212 -.BR org.omg.PortableServer.Servant
156.213 -クラスにマップされます。
156.214 -これはすべての
156.215 -.BR POA
156.216 -サーバント実装の基底クラスとして機能し、アプリケーション開発者が呼び出せる
156.217 -多数のメソッドを提供します。また、POA 自体が呼び出したり、サーバント動作を
156.218 -制御するためにユーザが上書きしたりできるメソッドも提供します。
156.219 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html \f2PortableServer\fP ≪吾ャ若ゃc \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違<純箴障 <純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫c泣若潟篏九勝若吟若若若ゃ障
156.220 .LP
156.221 -継承モデルには、J2SE 1.4 より前のバージョンの Java プログラミング言語
156.222 -と互換性のあるサーバ側バインディングを生成するために
156.223 -.BR -oldImplBase
156.224 -フラグを使用するというオプションもあります。
156.225 -\f2\-oldImplBase\fP フラグの使用は非標準であることに注意してください。これらの API はまもなく非推奨となります。このフラグを使用するのは、J2SE 1.3 で記述された既存のサーバとの互換性を確保する必要がある場合だけにしてください。その場合、既存の MAKEFILE を変更し、\f2\-oldImplBase\fP フラグを \f2idlj\fP コンパイラに追加する必要があります。そうしないと、POA ベースのサーバ側マッピングが生成されてしまいます。
156.226 -下位互換を維持したサーバ側
156.227 -バインディングを生成するには、次のように指定します。
156.228 .LP
156.229 -.RS
156.230 -.ft 3
156.231 -.nf
156.232 -idlj -fclient -fserver -oldImplBase My.idl
156.233 +膓帥≪ 1 ゃ激с潟\f2\-oldImplBase\fP 違篏睡J2SE 1.4 若吾с潟 Java 違潟域茯篋с泣若弱眼ゃ潟c潟違с\f2\-oldImplBase\fP 違篏睡罔羣羈с障 API ィ絅障違篏睡J2SE 1.3 ц菴違√泣若若篋с篆ゅ翫с翫√ MAKEFILE 紊眼 \f2idlj\fP 潟潟ゃ \f2\-oldImplBase\fP 違菴遵綽荀障 違菴遵翫POA 若鴻泣若弱眼潟違障筝篏篋с泣若弱眼ゃ潟c潟違罨<潟潟篏睡障
156.234 +.LP
156.235 +\f2idlj \fP\f4\-fclient \-fserver\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
156.236 .br
156.237 -idlj -fall -oldImplBase My.idl
156.238 -.fi
156.239 -.ft 1
156.240 -.RE
156.241 +\f2idlj \fP\f4\-fall\fP\f2 \fP\f4\-oldImplBase\fP\f2 My.idl\fP
156.242 .LP
156.243 -.BR My.idl
156.244 -内でインタフェース My が定義されていると、ファイル
156.245 -.I _MyImpleBase.java
156.246 -が生成されます。ユーザは、
156.247 -.BR My
156.248 -に対してその実装を提供する必要があります。この実証は、
156.249 -.I _MyImplBase
156.250 - から継承しなければなりません。
156.251 +\f2My.idl\fP \f2My\fP ゃ潟帥с若鴻絎臂翫\f2_MyImplBase.java\fP <ゃ障\f2My\fP 絲障絎茖箴絎茖 \f2_MyImplBase\fP 膓帥違障
156.252 .LP
156.253 -もう一方のサーバ側モデルは、Tie モデルと呼ばれます。これは、
156.254 -委譲モデルです。Tie モデルは Tie とスケルトンを同時には生成
156.255 -できないため、これらは別々に生成する必要があります。次のコ
156.256 -マンドは、Tie モデルに対してバインディングを生成します。
156.257 + 1 ゃ泣若弱眼≪Tie ≪若違с泣若弱眼≪紮茘蚊≪сTie 鴻宴潟сャ違障罨<潟潟cTie ≪ゃ潟c潟違障
156.258 .LP
156.259 -.RS
156.260 -.ft 3
156.261 -.nf
156.262 -idlj -fall My.idl
156.263 +\f2idlj \fP\f4\-fall\fP\f2 My.idl\fP
156.264 .br
156.265 -idlj -fallTIE My.idl
156.266 -.fi
156.267 -.ft 1
156.268 -.RE
156.269 +\f2idlj \fP\f4\-fallTIE\fP\f2 My.idl\fP
156.270 .LP
156.271 -インタフェース
156.272 -.BR My
156.273 -の場合、2 つめのコマンドは
156.274 -.BR MyPOATie.java
156.275 - を生成します。
156.276 -.BR MyPOATie
156.277 -のコンストラクタは、delegate を受け取ります。
156.278 -この例ではデフォルトの POA モデルを使用しているので、コンストラクタは \f2poa\fP も必要とします。
156.279 -ユーザは、delegate
156.280 -に対して実装を提供する必要があります。ただし、インタフェース
156.281 -.BR MyOperations
156.282 -を継承すればよく、ほかのクラスから継承する必要はありません。
156.283 -しかし、この実装を ORB と共に使用するには、
156.284 -.BR MyPOATie
156.285 -内に実装をラップする必要があります。例を示します。
156.286 +\f2My\fP ゃ潟帥с若鴻翫筝荐 2 潟潟\f2MyPOATie.java\fP 障\f2MyPOATie\fP 潟潟鴻帥\f2delegate\fP 障箴с POA ≪篏睡潟潟鴻帥 \f2poa\fP 綽荀с\f2delegate\fP 絲障絎茖箴違障絎茖 \f2MyOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2MyPOATie\fP у茖違障違罨<障
156.287 .nf
156.288 \f3
156.289 .fl
156.290 @@ -202,7 +114,7 @@
156.291 .fl
156.292
156.293 .fl
156.294 - // rootpoa への参照を取得し、POAManager を有効にします
156.295 + // Get reference to rootpoa & activate the POAManager
156.296 .fl
156.297 POA rootpoa = (POA)orb.resolve_initial_references("RootPOA");
156.298 .fl
156.299 @@ -210,7 +122,7 @@
156.300 .fl
156.301
156.302 .fl
156.303 - // サーバントを作成し、それを ORB に登録します
156.304 + // create servant and register it with the ORB
156.305 .fl
156.306 MyServant myDelegate = new MyServant();
156.307 .fl
156.308 @@ -218,13 +130,13 @@
156.309 .fl
156.310
156.311 .fl
156.312 - // Tie を作成します。サーバントが delegate になります。
156.313 + // create a tie, with servant being the delegate.
156.314 .fl
156.315 MyPOATie tie = new MyPOATie(myDelegate, rootpoa);
156.316 .fl
156.317
156.318 .fl
156.319 - // Tie の objectRef を取得します
156.320 + // obtain the objectRef for the tie
156.321 .fl
156.322 My ref = tie._this(orb);
156.323 .fl
156.324 @@ -232,45 +144,16 @@
156.325 .fi
156.326
156.327 .LP
156.328 -実装をほかの実装から継承しなければならない場合は、標準の継承モデル
156.329 -の代わりに Tie モデルを使用することもできます。Java は任意の数の
156.330 -インタフェース継承を認めていますが、クラスの継承に使用できる
156.331 -スロットは 1 つだけです。継承モデルを使用すると、このスロットが占
156.332 -有されます。Tie モデルを使用すると、スロットをユーザ自身の使用の
156.333 -ために解放できます。ただし、一定レベルの間接参照を引き起こすと
156.334 -いう欠点があります。つまり、メソッドを呼び出すと、余分なメソッド呼
156.335 -び出しが 1 つ発生します。
156.336 +篁絎茖膓帥違翫罔羣膓帥≪с Tie ≪篏睡障Java 翫ゃ潟帥с若鴻膓帥違狗障鴻膓帥篏睡с鴻 1 ゃс膓帥≪篏睡翫鴻障Tie ≪篏睡翫鴻篏睡若吟若т戎с障・с 1 ゅャ罨鴻障ゃ障<純若喝冴篏<純若喝冴榊障
156.337 .LP
156.338 -1.4 よりも前の J2SE バージョンで IDL-to-Java 言語
156.339 -マッピングのバージョンと互換性があるサーバ側の Tie モデルバインディングを生成
156.340 -するには、次のように指定します。
156.341 +IDL 若吾с潟 J2SE 1.4 若吾с潟 Java 荐茯吾潟違篋с泣若弱眼 Tie ≪ゃ潟c潟違罨<潟潟篏睡障
156.342 .LP
156.343 -.RS
156.344 -.ft 3
156.345 -.nf
156.346 -idlj -oldImplBase -fall My.idl
156.347 +\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fall\fP\f2 My.idl\fP
156.348 .br
156.349 -idlj -oldImplBase -fallTIE My.idl
156.350 -.fi
156.351 -.ft 1
156.352 -.RE
156.353 +\f2idlj \fP\f4\-oldImplBase\fP\f2 \fP\f4\-fallTIE\fP\f2 My.idl\fP
156.354 .LP
156.355 -インタフェース
156.356 -.BR My
156.357 -の場合、このコマンドは
156.358 -.I My_Tie.java
156.359 -を生成します。
156.360 -.I My_Tie
156.361 -のコンストラクタは、
156.362 -.BR impl
156.363 -を受け取ります。ユーザは、
156.364 -.BR impl
156.365 -に対して実装を提供する必要があります。ただし、インタフェース
156.366 -.BR HelloOperations
156.367 -を継承すればよく、ほかのクラスから継承する必要はありません。
156.368 -しかし、この実装を ORB と共に使用するには、
156.369 -.BR My_Tie
156.370 - 内に実装をラップする必要があります。例を示します。
156.371 +.LP
156.372 +\f2My\fP ゃ潟帥с若鴻翫 \f2My_Tie.java\fP 障\f2My_Tie\fP 潟潟鴻帥\f2impl\fP 障\f2impl\fP 絲障絎茖箴違障絎茖 \f2HelloOperations\fP ゃ潟帥с若鴻膓帥綽荀с篁鴻膓帥綽荀障絎茖 ORB 筝膩篏睡\f2My_Tie\fP у茖違障違罨<障
156.373 .LP
156.374 .nf
156.375 \f3
156.376 @@ -279,7 +162,7 @@
156.377 .fl
156.378
156.379 .fl
156.380 - // サーバントを作成し、それを ORB に登録します
156.381 + // create servant and register it with the ORB
156.382 .fl
156.383 MyServant myDelegate = new MyServant();
156.384 .fl
156.385 @@ -287,13 +170,13 @@
156.386 .fl
156.387
156.388 .fl
156.389 - // Tie を作成します。サーバントが delegate になります。
156.390 + // create a tie, with servant being the delegate.
156.391 .fl
156.392 MyPOATie tie = new MyPOATie(myDelegate);
156.393 .fl
156.394
156.395 .fl
156.396 - // Tie の objectRef を取得します
156.397 + // obtain the objectRef for the tie
156.398 .fl
156.399 My ref = tie._this(orb);
156.400 .fl
156.401 @@ -301,451 +184,235 @@
156.402 .fi
156.403
156.404 .LP
156.405 -.SH "発行されたファイルの代替場所の指定"
156.406 -.br
156.407 -発行されたファイルを現在のディレクトリ以外のディレクトリに保存したい場合は、
156.408 -次のようにコンパイラを呼び出してください。
156.409 +.RE
156.410 +.SS
156.411 +肴<ゃ篁f推臀絎
156.412 .LP
156.413 -.RS
156.414 -.ft 3
156.415 -.nf
156.416 -idlj -td /altdir My.idl
156.417 -.fi
156.418 -.ft 1
156.419 -.RE
156.420 -.LP
156.421 -インタフェース
156.422 -.BR My
156.423 -の場合、バインディングは
156.424 -.BR ./My.java
156.425 - ではなく
156.426 -.BR /altdir/My.java
156.427 -などに対して発行されます。
156.428 -.SH "インクルードファイルの代替場所の指定"
156.429 -.BR My.idl
156.430 -にほかの idl ファイル、
156.431 -.BR MyOther.idl
156.432 -が取り込まれている場合、コンパイラは
156.433 -.BR MyOther.idl
156.434 -がローカルディレクトリに存在すると見なします。たとえば、
156.435 -.BR MyOther.idl
156.436 -が
156.437 -.BR /includes
156.438 -に存在する場合は、次のコマンドでコンパイラを呼び出します。
156.439 -.LP
156.440 -.RS
156.441 -.ft 3
156.442 -.nf
156.443 -idlj -i /includes My.idl
156.444 -.fi
156.445 -.ft 1
156.446 -.RE
156.447 -.LP
156.448 -.BR たとえば、My.idl が
156.449 -.BR /moreIncludes
156.450 -に存在する
156.451 -.BR Another.idl
156.452 -も取り込んでいる場合は、次のコマンドでコンパイラを呼び出します。
156.453 -.LP
156.454 -.RS
156.455 -.ft 3
156.456 -.nf
156.457 -idlj -i /includes -i /moreIncludes My.idl
156.458 -.fi
156.459 -.ft 1
156.460 -.RE
156.461 -.LP
156.462 -この形式でファイルを取り込むと、コマンドが非常に長くなることがあります。
156.463 -このため、インクルードファイルの検索場所をコンパイラに知らせる方法が
156.464 -別に用意されています。この方法は、環境変数の概念に似ています。まず、
156.465 -CLASSPATH にリストされているディレクトリ内に、
156.466 -.BR idl.config
156.467 -という名前のファイルを作成します。そして、
156.468 -.BR idl.config
156.469 -内に次の形式の行を 1 つ作成します。
156.470 -.LP
156.471 -.RS
156.472 -.ft 3
156.473 -.nf
156.474 -includes=/includes;/moreIncludes
156.475 -.fi
156.476 -.ft 1
156.477 -.RE
156.478 -.LP
156.479 -コンパイラはこのファイルを見つけ、インクルードリストに読み込みます。
156.480 -この例では 2 つのディレクトリ間の区切り文字はセミコロン (;) であること
156.481 -に注意してください。
156.482 -この区切り文字はプラットフォームによって異なります。Windows プラットフォームではセミコロンを使用し、UNIX プラットフォームではコロンを使用する、などのようになります。
156.483 -インクルードの詳
156.484 -細は、
156.485 -.na
156.486 -\f2CLASSPATH\ のドキュメント (Solaris:
156.487 -.fi
156.488 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/classpath.html)
156.489 -(Windows:
156.490 -.fi
156.491 -http://java.sun.com/javase/6/docs/technotes/tools/windows/classpath.html)
156.492 -を参照してください。
156.493 -.SH "インクルードファイルに対するバインディングの発行"
156.494 -デフォルトでは、コマンド行 idl ファイルに定義されているインタフェース、
156.495 -構造体などに対してのみ、Java バインディングが生成されます。インクルード
156.496 -ファイルに定義されているタイプの Java バインディングは生成されません。
156.497 -例として、次の 2 つの idl ファイルを考えてみましょう。
156.498 -.TP
156.499 -.B My.idl
156.500 -.LP
156.501 -.RS
156.502 -#include <MyOther.idl>
156.503 -.br
156.504 -interface My
156.505 -.br
156.506 -{
156.507 -.br
156.508 -};
156.509 -.RE
156.510 -.TP
156.511 -.B MyOther.idl
156.512 -.LP
156.513 -.RS
156.514 -interface MyOther
156.515 -.br
156.516 -{
156.517 -.br
156.518 -};
156.519 -.RE
156.520 -.LP
156.521 -次のコマンドは、
156.522 -.BR My
156.523 -に対する Java バインディングしか生成しません。
156.524 -.LP
156.525 -.RS
156.526 -.ft 3
156.527 -.nf
156.528 -idlj My.idl
156.529 -.fi
156.530 -.ft 1
156.531 -.RE
156.532 -.LP
156.533 -.BR My.idl
156.534 -内に定義されているすべてのタイプ、および
156.535 -.BR My.idl
156.536 -に取り込まれているファイル (この例では
156.537 -.BR MyOther.idl
156.538 -) 内に定義されているすべてのタイプを生成するには、
156.539 -次のコマンドを使用してください。
156.540 -.LP
156.541 -.RS
156.542 -.ft 3
156.543 -.nf
156.544 -idlj -emitAll My.idl
156.545 -.fi
156.546 -.ft 1
156.547 -.RE
156.548 -.LP
156.549 -このデフォルトの規則については、次の点に注意する必要があります。
156.550 -グローバルスコープに出現する
156.551 -.BR #include
156.552 -文は、記述どおりに処理されます。これらの
156.553 -.BR #include
156.554 -文は、インポート文と見なすことができます。一部の囲みスコープ内に
156.555 -出現する #include 文は、通常の
156.556 -.BR #include
156.557 -文として扱われます。つまり、インクルードファイル内のコードは
156.558 -オリジナルファイル内に出現しているかのように扱われ、これに
156.559 -対して Java バインディングが発行されます。例を示します。
156.560 -.TP
156.561 -.B My.idl
156.562 -.LP
156.563 -.RS
156.564 -#include <MyOther.idl>
156.565 -.br
156.566 -interface My
156.567 -.br
156.568 -{
156.569 -.br
156.570 - #include <Embedded.idl>
156.571 -.br
156.572 -};
156.573 -.RE
156.574 -.TP
156.575 -.B MyOther.idl
156.576 -.LP
156.577 -.RS
156.578 -interface MyOther
156.579 -.br
156.580 -{
156.581 -.br
156.582 -};
156.583 -.RE
156.584 -.TP
156.585 -.B Embedded.idl
156.586 -.LP
156.587 -.RS
156.588 -enum E {one, two, three};
156.589 -.RE
156.590 -.LP
156.591 -次のコマンドを実行すると、
156.592 -.LP
156.593 -.RS
156.594 -.ft 3
156.595 -.nf
156.596 -idlj My.idl
156.597 -.fi
156.598 -.ft 1
156.599 -.RE
156.600 -.LP
156.601 -以下の Java ファイルのリストが生成されます。
156.602 -.LP
156.603 -.B ./MyHolder.java\fP
156.604 -.br
156.605 -.B ./MyHelper.java\fP
156.606 -.br
156.607 -.B ./_MyStub.java\fP
156.608 -.br
156.609 -.B ./MyPackage\fP
156.610 -.br
156.611 -.B ./MyPackage/EHolder.java\fP
156.612 -.br
156.613 -.B ./MyPackage/EHelper.java\fP
156.614 -.br
156.615 -.B ./MyPackage/E.java\fP
156.616 -.br
156.617 -.B ./My.java\fP
156.618 -.LP
156.619 -.BR MyOther.java
156.620 -は生成されないことに注意してください。これは、インポートに類似した
156.621 -.BR #include
156.622 -で定義されているためです。しかし、通常の
156.623 -.BR #include
156.624 -に定義された
156.625 -.BR E.java
156.626 -は生成されます。
156.627 -.BR Embedded.idl
156.628 -はインタフェース My のスコープ内に取り込まれているため、
156.629 -.BR My
156.630 -のスコープ内 (つまり
156.631 -.BR MyPackage
156.632 -) に生成されます。
156.633 -.LP
156.634 -上記の例で
156.635 -.BI -emitAll
156.636 -フラグが使用されていた場合は、すべてのインクルードファイル内に
156.637 -定義されているすべてのタイプが発行されます。
156.638 -.SH "パッケージ接頭辞の挿入"
156.639 -あなたが次の IDL ファイルを作成した ABC という名の企業に勤務していると
156.640 -仮定してください。
156.641 -.TP
156.642 -.B Widgets. idl
156.643 -module Widgets
156.644 -.br
156.645 -{
156.646 -.br
156.647 - interface W1 {...};
156.648 -.br
156.649 - interface W2 {...};
156.650 -.br
156.651 -};
156.652 -.LP
156.653 -このファイルに対して IDL-to-Java コンパイラを実行すると、パッケージ
156.654 -Widgets 内の W1 と W2 に対して Java バインディングが生成されます。
156.655 -しかし、業界規約では、企業のパッケージは
156.656 -.BR com.<company name>
156.657 -という名前のパッケージ内に配置しなければならないと規定されています。
156.658 -そのため、この
156.659 -.BR Widgets
156.660 -パッケージのままでは不十分です。規定に従うには、
156.661 -.BR com.abc.Widgets
156.662 -でなければなりません。
156.663 -.BR Widgets
156.664 -モジュールにこのパッケージ接頭辞を配置するには、次のコマンドを
156.665 -実行してください。
156.666 -.LP
156.667 -.RS
156.668 -.ft 3
156.669 -.nf
156.670 -idlj -pkgPrefix Widgets com.abc Widgets.idl
156.671 -.fi
156.672 -.ft 1
156.673 -.RE
156.674 -.LP
156.675 -.BR Widgets.idl
156.676 -を取り込んでいる IDL ファイルが存在する場合は、そのコマンド内にも
156.677 -.BI \-pkgPrefix
156.678 -フラグを指定する必要があります。このフラグを指定しないと、IDL ファイルは
156.679 -.BR com.abc.Widgets
156.680 -パッケージではなく
156.681 -.BR Widgets
156.682 -パッケージを検索します。
156.683 -.LP
156.684 -接頭辞を必要とするこれらのパッケージが多数存在する場合は、前述した
156.685 -.BR idl.config
156.686 -ファイルに配置する方が簡単でしょう。各パッケージ接頭辞行は、次の書式で記述します。
156.687 -.LP
156.688 -.RS
156.689 -.ft 3
156.690 -.nf
156.691 -PkgPrefix.<type>=<prefix>
156.692 -.fi
156.693 -.ft 1
156.694 -.RE
156.695 -.LP
156.696 -この書式に従うと、上記例の行は次のようになります。
156.697 -.LP
156.698 -.RS
156.699 -.ft 3
156.700 -.nf
156.701 -PkgPrefix.Widgets=com.abc
156.702 -.fi
156.703 -.ft 1
156.704 -.RE
156.705 -.LP
156.706 -このオプションを使用しても、リポジトリ ID には影響を与えません。
156.707 -.SH "コンパイル前のシンボルの定義"
156.708 -バインディング内にデバッグコードを取り込む場合などに IDL ファイル内
156.709 -にコンパイル用のシンボルが定義されていないときは、それらのシンボル
156.710 -を定義する必要があることがあります。次のコマンド
156.711 -.LP
156.712 -.RS
156.713 -.ft 3
156.714 -.nf
156.715 -idlj -d MYDEF My.idl
156.716 -.fi
156.717 -.ft 1
156.718 -.RE
156.719 -.LP
156.720 -は、My.idl 内に
156.721 -.BR #define
156.722 -.BR MYDEF
156.723 -という行を含めるのと同じです。
156.724 -.SH "既存のバインディングの保持"
156.725 -Java バインディングファイルが既に存在する場合は、
156.726 -.BI \-keep
156.727 -フラグを使用してコンパイラによる上書きを防止できます。デフォルトでは、
156.728 -既に存在するかどうかにかかわらずすべてのファイルが生成されます。
156.729 -ファイルをカスタマイズ (カスタマイズはその内容がよほど適切でない限り推奨
156.730 -されません) してある場合は、
156.731 -.BI \-keep
156.732 -オプションが非常に役立ちます。次のコマンド
156.733 -.LP
156.734 -.RS
156.735 -.ft 3
156.736 -.nf
156.737 -idlj -keep My.idl
156.738 -.fi
156.739 -.ft 1
156.740 -.RE
156.741 -.LP
156.742 -は、まだ存在していないすべてのクライアント側バインディングを発行します。
156.743 -.SH "コンパイルの進捗の表示"
156.744 -IDL-to-Java コンパイラは、その実行段階でステータスメッセージを
156.745 -生成します。この生成を詳細 (verbose) モードにするには、
156.746 -.BR -v
156.747 -オプションを使用してください。
156.748 -.LP
156.749 -.RS
156.750 -.ft 3
156.751 -.nf
156.752 -idlj -v My.idl
156.753 -.fi
156.754 -.ft 1
156.755 -.RE
156.756 -.LP
156.757 -デフォルトでは、コンパイラは詳細モードで動作しません。
156.758 -.SH "バージョン情報の表示"
156.759 -IDL-to-Java コンパイラのビルドバージョンを表示するには、コマンド行で
156.760 -.BI \-version
156.761 -オプションを指定してください。
156.762 -.LP
156.763 -.RS
156.764 -.ft 3
156.765 -.nf
156.766 -idlj -version
156.767 -.fi
156.768 -.ft 1
156.769 -.RE
156.770 -.LP
156.771 -コンパイラが生成したバインディング内に、バージョン情報も表示されます。
156.772 -コマンド行に指定されるその他のオプションは無視されます。
156.773 -.SH "オプション"
156.774 -.TP
156.775 -.BI \-d " symbol"
156.776 -これは、IDL ファイルに次の行を指定するのと同じです。
156.777 -.LP
156.778 -.RS
156.779 -.ft 3
156.780 -.nf
156.781 -#define symbol
156.782 -.fi
156.783 -.ft 1
156.784 -.RE
156.785 -.TP
156.786 -.BI \-emitAll
156.787 -.BR #include
156.788 -ファイル内に指定されているものも含め、すべてのタイプを発行します。
156.789 -.TP
156.790 -.BI \-fside
156.791 -発行するバインディングを定義します。
156.792 -.BI side
156.793 -には、
156.794 -.BR client
156.795 -、
156.796 -.BR server
156.797 -、
156.798 -.BR serverTIE
156.799 -、
156.800 -.BR all
156.801 -、
156.802 -.BR allTIE
156.803 -のうちいずれか 1 つを指定します。
156.804 -.BR -fserverTIE
156.805 -と
156.806 -.BR -fallTIE
156.807 -オプションを指定すると、委譲モデルスケルトンが発行されます。
156.808 -フラグを指定しない場合は、
156.809 -.BR -fclient
156.810 -と見なされます。
156.811 -.TP
156.812 -.BI \-i " include-path"
156.813 -デフォルトでは、現在のディレクトリでインクルードファイルが
156.814 -検索されます。このオプションを使用すると、ほかのディレクトリを
156.815 -追加できます。
156.816 -.TP
156.817 -.BI \-keep
156.818 -生成されるファイルが既に存在する場合、既存ファイルを上書きしません。
156.819 -デフォルトでは、既存ファイルが上書きされます。
156.820 -.TP
156.821 -.BI \-noWarn
156.822 -警告メッセージを表示しないようにします。
156.823 -.TP
156.824 -.BI \-oldImplBase
156.825 -1.4 より前の JDK ORB と互換性のあるスケルトンを生成します。
156.826 -デフォルトでは、POA 継承モデルのサーバ側バインディングが生成されます。
156.827 -このオプションは、
156.828 -.BR ImplBase
156.829 -継承モデルクラスであるサーバ側バインディングを生成することによって、
156.830 -旧バージョンの Java プログラミング言語との下位互換性を提供します。
156.831 -.TP
156.832 -.BI \-pkgPrefix " type prefix"
156.833 -ファイルスコープで
156.834 -.BI type
156.835 -が検出された場合、そのタイプに対して生成されるすべてのファイルについて、
156.836 -生成される Java パッケージ名に
156.837 -.BI prefix
156.838 -という接頭辞を付けます。
156.839 -.BI type
156.840 -は、トップレベルモジュールの単純名か、モジュールの外部で定義された
156.841 -IDL タイプの単純名です。
156.842 -.TP
156.843 -.BI \-pkgTranslate " type package"
156.844 -特定の識別子内でモジュール名 \f2type\fP が見つかった場合、生成された Java パッケージ内のすべてのファイルに対して、その識別子内のモジュール名を \f2package\fP で置き換えます。
156.845 -.BR pkgPrefix
156.846 -変更が初めに行われることに注意してください。
156.847 -.BI type
156.848 -はトップレベルモジュールの単純名か、モジュールの外部で定義された IDL タイプの
156.849 -単純名のいずれかであり、パッケージのフルネームと正確に一致する必要があります。
156.850 +.RS 3
156.851
156.852 .LP
156.853 -特定の識別子に一致する変換が 2 つ以上見つかった場合、もっとも長い一致が選択されます。たとえば、引数を次のように指定したとします。
156.854 +肴<ゃ潟c篁ュc臀罨<潟潟с潟潟ゃ若喝冴障
156.855 +.RS 3
156.856 +
156.857 +.LP
156.858 +\f2idlj \fP\f4\-td /altdir\fP\f2 My.idl\fP
156.859 +.RE
156.860 +\f2My\fP ゃ潟帥с若鴻翫ゃ潟c潟違\f2./My.java\fP с\f2/altdir/My.java\fP 肴障
156.861 +.RE
156.862 +.SS
156.863 +ゃ潟若<ゃ篁f推臀絎
156.864 +.LP
156.865 +.RS 3
156.866 +
156.867 +.LP
156.868 +\f2My.idl\fP 1 ゃ IDL <ゃ \f2MyOther.idl\fP ゃ潟若翫潟潟ゃ若c \f2MyOther.idl\fP 喝障<ゃ \f2/includes\fP 翫罨<潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes\fP\f2 My.idl\fP
156.869 +.LP
156.870 +障 \f2My.idl\fP \f2/moreIncludes\fP \f2Another.idl\fP ゃ潟若с違罨<潟潟с潟潟ゃ若喝冴障 \f2idlj \fP\f4\-i /includes \-i /moreIncludes\fP\f2 My.idl\fP
156.871 +.LP
156.872 +綵√сゃ潟若絎潟潟激茲障 сゃ潟若<ゃ罎膣≪贋潟潟ゃ腓冴ャ号障号医紊違鴻篌若障CLASSPATH 鴻c \f2idl.config\fP <ゃ篏障 \f2idl.config\fP 筝罨<綵√茵ャ障 \f2includes=/includes;/moreIncludes\fP
156.873 +.LP
156.874 +潟潟ゃ<ゃ罎膣≪ゃ潟若鴻茯粋昭帥障箴сc阪絖祉潟 (;) c障阪絖若c違障違Windows 若с祉潟潟сUnix 若с潟潟с \f2ゃ潟若\fP荅括完ゃ
156.875 +.na
156.876 +\f2CLASSPATH 荐絎\fP @
156.877 +.fi
156.878 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general с
156.879 +.RE
156.880 +.SS
156.881 +ゃ潟若<ゃ絲障ゃ潟c潟違肴
156.882 +.LP
156.883 +.RS 3
156.884 +
156.885 +.LP
156.886 +с潟潟茵絎 IDL <ゃу臂ゃ潟帥с若鴻罕篏ゃ帥Java ゃ潟c潟違障ゃ潟若<ゃу臂ゃJava ゃ潟c潟違障違罨< 2 ゃ IDL <ゃゃ帥障 \f4My.idl\fP
156.887 +.LP
156.888 +\f2#include <MyOther.idl>\fP
156.889 +.br
156.890 +\f2interface My\fP
156.891 +.br
156.892 +\f2{\fP
156.893 +.br
156.894 +\f2};\fP
156.895 +.br
156.896 +\f4MyOther.idl\fP
156.897 +.LP
156.898 +\f2interface MyOther\fP
156.899 +.br
156.900 +\f2{\fP
156.901 +.br
156.902 +\f2};\fP\
156.903 +.LP
156.904 +罨<潟潟с\f2My\fP 絲障 Java ゃ潟c潟違障 \f2idlj My.idl\fP
156.905 +.LP
156.906 +\f2My.idl\fP у臂\f2My.idl\fP ゃ潟若<ゃ (箴с \f2MyOther.idl\fP) у臂鴻ゃ Java ゃ潟c潟違罨<潟潟篏睡障 \f2idlj \fP\f4\-emitAll\fP\f2 My.idl\fP
156.907 +.LP
156.908 +荀≪羈違障違若鴻潟若絎 \f2#include\fP 菴違障 \f2#include\fP ゃ潟若荀с障絲障篁絎臂蚊障鴻潟若絎 \f2#include\fP 綵潟с \f2#include\fP 障 ゃ障ゃ潟若<ゃ潟若<ゃ障丈絎絲障 Java ゃ潟c潟違肴障罨<箴腓冴障 \f4My.idl\fP
156.909 +.LP
156.910 +\f2#include <MyOther.idl>\fP
156.911 +.br
156.912 +\f2interface My\fP
156.913 +.br
156.914 +\f2{\fP
156.915 +.br
156.916 +\f2\ #include <Embedded.idl>\fP
156.917 +.br
156.918 +\f2};\ \fP \f4MyOther.idl\fP
156.919 +.LP
156.920 +\f2interface MyOther\fP
156.921 +.br
156.922 +\f2{\fP
156.923 +.br
156.924 +\f2};\ \fP \f4Embedded.idl\fP
156.925 +.LP
156.926 +\f2enum E {one, two, three};\fP\
156.927 +.LP
156.928 +罨<潟潟絎茵 \f2idlj My.idl\fP
156.929 +.LP
156.930 +罨<筝c Java <ゃ障 \f2./MyHolder.java\fP
156.931 +.br
156.932 +\f2./MyHelper.java\fP
156.933 +.br
156.934 +\f2./_MyStub.java\fP
156.935 +.br
156.936 +\f2./MyPackage\fP
156.937 +.br
156.938 +\f2./MyPackage/EHolder.java\fP
156.939 +.br
156.940 +\f2./MyPackage/EHelper.java\fP
156.941 +.br
156.942 +\f2./MyPackage/E.java\fP
156.943 +.br
156.944 +\f2./My.java\fP
156.945 +.LP
156.946 +ゃ潟若荀 \f2#include\fP 絎臂\f2MyOther.java\fP 障綵潟с \f2#include\fP у臂\f2E.java\fP 障\f2Embedded.idl\fP \f2My\fP ゃ潟帥с若鴻鴻潟若ゃ潟若\f2My\fP 鴻潟若 (ゃ障\f2MyPackage\fP ) 障
156.947 +.LP
156.948 +筝荐箴 \f2\-emitAll\fP 違篏睡違ゃ潟若鴻<ゃ鴻肴障
156.949 +.LP
156.950 +.RE
156.951 +.SS
156.952 +宴若吾・莨水
156.953 +.LP
156.954 +.RS 3
156.955 +
156.956 +.LP
156.957 +ABC 篌腓障篏罐罨< IDL <ゃ罕膀障
156.958 +.br
156.959 +\f4Widgets.idl\fP
156.960 +.LP
156.961 +\f2module Widgets\fP
156.962 +.br
156.963 +\f2{\fP
156.964 +.br
156.965 +\f2\ interface W1 {...};\fP
156.966 +.br
156.967 +\f2\ interface W2 {...};\fP
156.968 +.br
156.969 +\f2};\fP\
156.970 +.LP
156.971 +<ゃ絲障 IDL\-to\-Java 潟潟ゃ絎茵\f2W1\fP \f2W2\fP 絲障 Java ゃ潟c潟違 \f2Widgets\fP 宴若後障罐d篌腓障宴若吾\f2com.<篌腓上>\fP 宴若後臀c障\f2Widgets\fP 宴若吾с筝сd緇宴若吾 \f2com.abc.Widgets\fP 綽荀障宴若御・莨 \f2Widgets\fP ≪吾ャ若篁罨<潟潟絎茵障 \f2idlj \fP\f4\-pkgPrefix Widgets com.abc\fP\f2 Widgets.idl\fP
156.972 +.LP
156.973 +\f2Widgets.idl\fP ゃ潟若 IDL <ゃ翫潟潟 \f2\-pkgPrefix\fP 違綽荀с違絎 IDL <ゃ\f2com.abc.Widgets\fP 宴若吾с\f2Widgets\fP 宴若吾罎膣≪障
156.974 +.LP
156.975 +・莨綽荀宴若吾ゃ翫菴違 \f2idl.config\fP <ゃф・莨絎膂≦с宴若吾・莨絎茵罨<綵√ц菴違障
156.976 +.LP
156.977 +\f2PkgPrefix.<type>=<prefix>\fP
156.978 +.LP
156.979 +c筝荐箴翫罨<荐菴違障 \f2PkgPrefix.Widgets=com.abc\fP
156.980 +.LP
156.981 +.LP
156.982 +激с潟篏睡吾 ID 綵演帥障
156.983 +.LP
156.984 +.RE
156.985 +.SS
156.986 +潟潟ゃ激潟絎臂
156.987 +.LP
156.988 +.RS 3
156.989 +
156.990 +.LP
156.991 +潟潟ゃ激潟 IDL <ゃу臂翫激潟絎臂綽荀障 違ゃ潟c潟医違潟若腟水ャ篏睡障罨<潟潟 \f2idlj \fP\f4\-d\fP\f2 MYDEF My.idl\fP
156.992 +.LP
156.993 +\f2My.idl\fP \f2#define MYDEF\fP 茵絎翫膈箴<с
156.994 +.RE
156.995 +.SS
156.996 +√ゃ潟c潟違篆
156.997 +.LP
156.998 +.RS 3
156.999 +
156.1000 +.LP
156.1001 +Java ゃ潟c潟違<ゃс絖翫\f2\-keep\fP 違絎潟潟ゃ筝吾帥с障сс絖鴻<ゃ障<ゃ鴻帥ゃ冴翫 (絎鴻罩g∈с篁ュ鴻帥ゃ冴帥)\f2\-keep\fP 激с潟с罨<潟潟 \f2idlj \fP\f4\-keep\fP\f2 My.idl\fP
156.1002 +.LP
156.1003 +ゃ≪潟眼ゃ潟c潟違с障絖鴻肴障
156.1004 +.RE
156.1005 +.SS
156.1006 +潟潟ゃ我倶茵腓
156.1007 +.LP
156.1008 +.RS 3
156.1009 +
156.1010 +.LP
156.1011 +IDL\-to\-Java 潟潟ゃ絎茵罧級х倶<祉若吾障激≪若 (<祉若吾紊≪若) \f2\-v\fP 激с潟篏睡障 \f2idlj \fP\f4\-v\fP\f2 My.idl\fP
156.1012 +.LP
156.1013 +с潟潟ゃ激≪若с絎茵障
156.1014 +.RE
156.1015 +.SS
156.1016 +若吾с恰宴茵腓
156.1017 +.LP
156.1018 +.RS 3
156.1019 +
156.1020 +.LP
156.1021 +.LP
156.1022 +IDL\-to\-Java 潟潟ゃ若吾с潟茵腓冴潟潟茵 \f2\-version\fP 激с潟絎障
156.1023 +.LP
156.1024 +.LP
156.1025 +\f2idlj \-version\fP
156.1026 +.LP
156.1027 +.LP
156.1028 +若吾с恰宴潟潟ゃcゃ潟c潟医吾莨若障障激с潟潟潟茵絎篁ュ激с潟絎鴻∴障
156.1029 +.LP
156.1030 +.RE
156.1031 +.SH "激с"
156.1032 +.LP
156.1033 +
156.1034 +.LP
156.1035 +.RS 3
156.1036 +.TP 3
156.1037 +\-d symbol
156.1038 +激с潟IDL <ゃ罨<茵菴遵翫膈箴<с
156.1039 +.RS 3
156.1040 +
156.1041 +.LP
156.1042 +.nf
156.1043 +\f3
156.1044 +.fl
156.1045 +#define \fP\f4symbol\fP\f3
156.1046 +.fl
156.1047 +\fP
156.1048 +.fi
156.1049 +.RE
156.1050 +.TP 3
156.1051 +\-emitAll
156.1052 +\f2#include\fP <ゃу臂鴻肴障
156.1053 +.TP 3
156.1054 +\-fside
156.1055 +肴ゃ潟c潟違絎臂障 \f2side\fP \f2client\fP\f2server\fP\f2serverTIE\fP\f2all\fP\f2allTIE\fP <с\f2\-fserverTIE\fP 障 \f2\-fallTIE\fP 激с潟絎紮茘蚊≪鴻宴潟肴障違絎c翫\f2\-fclient\fP 絎荀障
156.1056 +.TP 3
156.1057 +\-i include\-path
156.1058 +сゃ潟若<ゃ潟c罎膣≪障激с潟絎祉c菴遵с障
156.1059 +.TP 3
156.1060 +\-keep
156.1061 +<ゃс絖翫<ゃ筝吾障с筝吾障
156.1062 +.TP 3
156.1063 +\-noWarn
156.1064 +茘<祉若吾茵腓冴障
156.1065 +.TP 3
156.1066 +\-oldImplBase
156.1067 +v1.4 JDK ORB 篋с鴻宴潟障сPOA 膓帥≪泣若弱眼ゃ潟c潟違障激с潟絎\f2ImplBase\fP 膓帥≪鴻с泣若弱眼ゃ潟c潟違сゃ若吾с潟 Java 違潟域茯筝篏篋с緇障
156.1068 +.TP 3
156.1069 +\-pkgPrefix type prefix
156.1070 +\f2type\fP <ゃ鴻潟若ф冴翫絲障鴻<ゃゃ Java 宴若後 \f2prefix\fP ・莨篁障\f2type\fP ≪吾ャ若膣≪吾ャ若紊眼у臂 IDL 膣<с
156.1071 +.TP 3
156.1072 +\-pkgTranslate type package
156.1073 +茘ュ筝≪吾ャ若 \f2type\fP 罎冴 Java 宴若後鴻<ゃゃ茘ュ筝 \f2package\fP х舟障 \f2pkgPrefix\fP 紊眼障\f2type\fP ≪吾ャ若障鴻≪吾ャ若紊у臂 IDL 膣с 絎宴若後罩g∈筝眼違障
156.1074 +.LP
156.1075 +1 ゃ茘ュ筝ц違紊翫c激吾違障違罨<綣違絎翫
156.1076 .nf
156.1077 \f3
156.1078 .fl
156.1079 @@ -754,7 +421,7 @@
156.1080 \fP
156.1081 .fi
156.1082 .LP
156.1083 -このとき、次の変換が実行されます。
156.1084 +罨<紊絎純障
156.1085 .nf
156.1086 \f3
156.1087 .fl
156.1088 @@ -769,102 +436,74 @@
156.1089 \fP
156.1090 .fi
156.1091 .LP
156.1092 -次のパッケージ名は変換できません。
156.1093 +罨<宴若後紊с障
156.1094 .RS 3
156.1095 .TP 2
156.1096 -*
156.1097 +o
156.1098 \f2org\fP
156.1099 .TP 2
156.1100 -*
156.1101 -\f2org.omg\fP または \f2org.omg\fP のサブパッケージ
156.1102 +o
156.1103 +\f2org.omg\fP障 \f2org.omg\fP 泣宴若
156.1104 .RE
156.1105 .LP
156.1106 -これらのパッケージの変換を試みると、コンパイル不可能なコードが生成されます。
156.1107 -これらのパッケージを
156.1108 -.BR \-pkgTranslate
156.1109 -の後の最初の引数として使用すると、エラーとして扱われます。
156.1110 +宴若後紊篋с潟若障 \f2\-pkgTranslate\fP 綣違宴若吾篏睡若宴障
156.1111 +.TP 3
156.1112 +\-skeletonName xxx%yyy
156.1113 +\f2xxx%yyy\fP 鴻宴潟篁帥若潟篏睡障罨<с
156.1114 +.RS 3
156.1115 +.TP 2
156.1116 +o
156.1117 +\f2POA\fP 阪鴻翫%POA(\f2\-fserver\fP 障 \f2\-fall\fP)
156.1118 +.TP 2
156.1119 +o
156.1120 +\f2oldImplBase\fP 鴻翫_%ImplBase(\f2\-oldImplBase\fP (\f2\-fserver\fP 障 \f2\-fall\fP))
156.1121 .RE
156.1122 -.TP
156.1123 -.BI \-skeletonName " xxx%yyy"
156.1124 -.BI xxx%yyy
156.1125 -をスケルトンの名前付けのパターンとして使用します。デフォルトは次のとおりです。
156.1126 +.TP 3
156.1127 +\-td dir
156.1128 +阪c潟cс\f2dir\fP 篏睡障
156.1129 +.TP 3
156.1130 +\-tieName xxx%yyy
156.1131 +帥若潟緇c Tie 篁障罨<с
156.1132 +.RS 3
156.1133 +.TP 2
156.1134 +o
156.1135 +\f2POA\fP Tie 阪鴻翫%POATie(\f2\-fserverTie\fP 障 \f2\-fallTie\fP)
156.1136 +.TP 2
156.1137 +o
156.1138 +\f2oldImplBase\fP Tie 鴻翫%_Tie(\f2\-oldImplBase\fP (\f2\-fserverTie\fP 障 \f2\-fallTie\fP))
156.1139 +.RE
156.1140 +.TP 3
156.1141 +\-verbose
156.1142 +激≪若障
156.1143 +.TP 3
156.1144 +\-version
156.1145 +若吾с恰宴茵腓冴腟篋障
156.1146 +.RE
156.1147 +
156.1148 .LP
156.1149 -.RS
156.1150 -.TP 2
156.1151 -\(bu POA 基底クラス
156.1152 -(
156.1153 -.BR \-fserver
156.1154 -または
156.1155 -.BR \-fall
156.1156 -) の場合、%POA
156.1157 -.TP 2
156.1158 -\(bu
156.1159 -.BR \-oldImplBase
156.1160 -クラス (
156.1161 -.BR \-oldImplBase
156.1162 -および、
156.1163 -.BR \-fserver
156.1164 -または
156.1165 -.BR \-fall
156.1166 -) の場合、_%ImplBase
156.1167 -.RE
156.1168 -.TP
156.1169 -.BI \-td " dir"
156.1170 -出力ディレクトリとして、現在のディレクトリではなく
156.1171 -.BI dir
156.1172 -を使用します。
156.1173 -.TP
156.1174 -.BI \-tieName " xxx%yyy"
156.1175 -パターンに応じて Tie に名前を付けます。デフォルトは次のとおりです。
156.1176 -.LP
156.1177 -.RS
156.1178 -.TP 2
156.1179 -\(bu POA Tie 基底クラス (
156.1180 -.BR \-fserverTie
156.1181 -または
156.1182 -.BR \-fallTie
156.1183 -) の場合、%POATie
156.1184 -.TP 2
156.1185 -\(bu
156.1186 -.BR oldImplBase Tie
156.1187 -クラス (
156.1188 -.BR \-oldImplBase
156.1189 -および、
156.1190 -.BR \-fserverTie
156.1191 -または
156.1192 -.BR \-fallTie
156.1193 -のいずれか) の場合、%_Tie
156.1194 -.RE
156.1195 -.TP
156.1196 -.BI \-nowarn, \-verbose
156.1197 -詳細モードにします。
156.1198 -.TP
156.1199 -.BI \-version
156.1200 -バージョン情報を表示して終了します。
156.1201 -.LP
156.1202 -オプションの詳細は、「機能説明」の節を参照してください。
156.1203 -.SH "制限事項"
156.1204 -.LP
156.1205 -.TP 2
156.1206 -\(bu グローバルスコープ内でエスケープされた識別子は、
156.1207 -IDL プリミティブ型 (
156.1208 -.BR Object
156.1209 -または
156.1210 -.BR ValueBase
156.1211 -) と同じスペルであってはなりません。これは、シンボルテーブルがこれらの
156.1212 -識別子を使用してすでにロードされているためです。これらを定義し直すと、
156.1213 -それらの本来の定義を上書きすることになります (この制限は永続的に
156.1214 -適用される見込み)。
156.1215 -.TP 2
156.1216 -\(bu IDL の fixed 型はサポートされていません。
156.1217 -.SH "既知の問題"
156.1218 +激с潟荅括完ゃ茯祉激с潟с
156.1219 +.SH "句"
156.1220 .LP
156.1221
156.1222 .LP
156.1223 .RS 3
156.1224 .TP 2
156.1225 -*
156.1226 -グローバル識別子のインポートは生成されません。エクスポートされていないローカル実装を呼び出すと例外が発生しますが、その原因はおそらく \f2ServerDelegate\fP DSI コード内の \f2NullPointerException\fP です。
156.1227 +o
156.1228 +違若鴻潟若鴻宴若茘ュIDL c \f2Object\fP 障 \f2ValueBase\fP 膓眼сc障茘ュゃ激潟若篋若茘ュ絎臂荐怨絎臂筝吾障障箙句с
156.1229 +.TP 2
156.1230 +o
156.1231 +\f2fixed\fP IDL 泣若障
156.1232 +.RE
156.1233 +
156.1234 +.LP
156.1235 +.SH "∝ャ馹"
156.1236 +.LP
156.1237 +
156.1238 +.LP
156.1239 +.RS 3
156.1240 +.TP 2
156.1241 +o
156.1242 +違若茘ュゃゃ潟若障篋若 impl 若喝冴箴紊障 \f2ServerDelegate\fP DSI 潟若 \f2NullPointerException\fP с
156.1243 .RE
156.1244
156.1245 .LP
157.1 --- a/src/solaris/doc/sun/man/man1/ja/jar.1 Tue May 12 15:21:55 2009 +0900
157.2 +++ b/src/solaris/doc/sun/man/man1/ja/jar.1 Thu May 14 00:17:25 2009 -0700
157.3 @@ -1,232 +1,141 @@
157.4 -'\" t
157.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
157.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
157.7 -.\"
157.8 -.\" This code is free software; you can redistribute it and/or modify it
157.9 -.\" under the terms of the GNU General Public License version 2 only, as
157.10 -.\" published by the Free Software Foundation.
157.11 -.\"
157.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
157.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
157.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
157.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
157.16 -.\" accompanied this code).
157.17 -.\"
157.18 -.\" You should have received a copy of the GNU General Public License version
157.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
157.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
157.21 -.\"
157.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
157.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
157.24 -.\" have any questions.
157.25 -.\" `
157.26 -.TH jar 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
157.27 -.SH "名前"
157.28 -jar \- Java アーカイブツール
157.29 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
157.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
157.31 +."
157.32 +." This code is free software; you can redistribute it and/or modify it
157.33 +." under the terms of the GNU General Public License version 2 only, as
157.34 +." published by the Free Software Foundation.
157.35 +."
157.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
157.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
157.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
157.39 +." version 2 for more details (a copy is included in the LICENSE file that
157.40 +." accompanied this code).
157.41 +."
157.42 +." You should have received a copy of the GNU General Public License version
157.43 +." 2 along with this work; if not, write to the Free Software Foundation,
157.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
157.45 +."
157.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
157.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
157.48 +." have any questions.
157.49 +."
157.50 +.TH jar 1 "04 May 2009"
157.51 +." Generated from HTML by html2man (author: Eric Armstrong)
157.52 +
157.53 .LP
157.54 -\f3jar\fP は複数のファイルを 1 つの Java Archive (JAR) ファイルに結合します。
157.55 -.\"
157.56 -.\" This document was created by saving an HTML file as text
157.57 -.\" from the JavaSoft web site:
157.58 -.\"
157.59 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
157.60 -.\"
157.61 -.\" and adding appropriate troff macros. Because the JavaSoft web site
157.62 -.\" man pages can change without notice, it may be helpful to diff
157.63 -.\" files to identify changes other than new functionality.
157.64 -.\"
157.65 -.SH "形式"
157.66 +.SH ""
157.67 +jar \- Java ARchive 若
157.68 +.LP
157.69 +\f3jar\fP 茲違<ゃ 1 ゃ JAR ≪若ゃ<ゃ腟障
157.70 +.RS 3
157.71 +.TP 2
157.72 +o
157.73 +綵√
157.74 +.TP 2
157.75 +o
157.76 +茯
157.77 +.TP 2
157.78 +o
157.79 +激с
157.80 +.TP 2
157.81 +o
157.82 +潟潟茵綣違<ゃ
157.83 +.TP 2
157.84 +o
157.85 +箴
157.86 +.TP 2
157.87 +o
157.88 +∫i
157.89 +.RE
157.90 +
157.91 +.LP
157.92 +.SH "綵√"
157.93 .LP
157.94
157.95 .LP
157.96 +.RS 3
157.97 .TP 3
157.98 -jar ファイルの作成
157.99 +JAR <ゃ篏
157.100 \f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
157.101 .TP 3
157.102 -jar ファイルの更新
157.103 +JAR <ゃ贋
157.104 \f4jar u\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
157.105 .TP 3
157.106 -jar ファイルの抽出
157.107 +JAR <ゃ遵
157.108 \f4jar x\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
157.109 .TP 3
157.110 -jar ファイルの内容の一覧を作成
157.111 +JAR <ゃ絎鴻茵綵√筝荀ц;腓
157.112 \f4jar t\fP\f2[vf] [\fP\f2jarfile\fP\f2] [\fP\f2inputfiles\fP\f2] [\-J\fP\f2option\fP\f2]\fP
157.113 .TP 3
157.114 -jar ファイルにインデックスを追加
157.115 +JAR <ゃ吾ゃ潟鴻菴遵
157.116 \f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
157.117 +.RE
157.118 +
157.119 .LP
157.120 .LP
157.121 -パラメータ
157.122 +茯
157.123 .LP
157.124 .RS 3
157.125
157.126 .LP
157.127 +.RS 3
157.128 .TP 3
157.129 cuxtiv0Mmfe
157.130 -.I jar
157.131 -コマンドを制御するオプション。
157.132 +\f2jar\fP 潟潟九勝激с
157.133 .TP 3
157.134 - jarfile
157.135 -作成 (c)、更新 (u)、抽出 (x)、または閲覧される内容の一覧を作成 (t) する
157.136 -jar ファイルです。
157.137 -.I \-f
157.138 -オプションとファイル名
157.139 -.I jarfile
157.140 -は対になっています。
157.141 -使用する場合は、両方を一緒に使用します。
157.142 -.I f
157.143 -および
157.144 -.I jarfile
157.145 -を省略すると、標準入力から「jar ファイル」が
157.146 -使用されたり (x および t の場合)、標準出力にこの「jar ファイル」が
157.147 -送信されたりします (c および u の場合)。
157.148 +jarfile
157.149 +篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)障絎鴻筝荀ц;腓 (\f2t\fP) 絲乗院 JAR <ゃ\f2f\fP 激с潟<ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュJAR <ゃ緇 (x t 翫)罔羣阪吾JAR <ゃ篆<障(c u 翫)
157.150 .TP 3
157.151 -
157.152 inputfiles
157.153 -.I jar ファイル
157.154 -に結合 (c および u の場合)、または
157.155 -.I jar ファイル
157.156 -から抽出 (x の場合) または一覧表示 (t の場合) されるファイル
157.157 -またはディレクトリ。空白文字で区切ります。
157.158 -すべてのディレクトリは再帰的に処理されます。
157.159 -オプション 0 (ゼロ) が使用されない場合は、ファイルが圧縮されます。
157.160 +\f2jarfile\fP 腟 (c u 翫)\f2jarfile\fP 遵 (x 翫) 障筝荀ц;腓 (t 翫) 腥榊純у阪<ゃ障c鴻c絽亥障<ゃ激с \f2O\fP (若) 篏睡х軒障
157.161 .TP 3
157.162 - manifest
157.163 -jar ファイルの MANIFEST.MF に含めようとする名前:値ペアが含まれている
157.164 -既存の manifest ファイルです。
157.165 -.I \-m
157.166 -オプションと
157.167 -.I manifest
157.168 -のファイル名は対になっています。
157.169 -使用する場合は、両方を一緒に使用します。
157.170 -文字
157.171 -.B m
157.172 -、
157.173 -.B f
157.174 -、および
157.175 -.B e
157.176 -の出現順序は、
157.177 -.I manifest
157.178 -、
157.179 -.I jarfile
157.180 -、および
157.181 -.I entrypoint
157.182 -の出現順序と一致する必要があります。
157.183 +manifest
157.184 +\f2name\fP\f2:\fP\f2value\fP ≪JAR <ゃ MANIFEST.MF 障√с鴻<ゃ\f2\-m\fP 激с潟<ゃ \f2manifest\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
157.185 .TP 3
157.186 -
157.187 entrypoint
157.188 -実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして設定するクラスの名前。
157.189 -.I \-e
157.190 -オプションと entrypoint は対になっています。どちらかを指定する場合は両方とも指定する必要があります。文字
157.191 -.I m
157.192 -、
157.193 -.I f
157.194 -、
157.195 -.I e
157.196 -の出現順序は
157.197 -.I manifest
157.198 -、
157.199 -.I jarfile
157.200 -、
157.201 -.I entrypoint
157.202 -の出現順序と一致する必要があります。
157.203 +絎茵 JAR <ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟荐絎鴻\f2\-e\fP 激с潟 entrypoint 絲障c障 <絎翫筝≧鴻絎綽荀障\f3m\fP\f3f\fP \f3e\fP 榊憥綺\f2manifest\fP\f2jarfile\fP\f2entrypoint\fP 榊憥綺筝眼綽荀障
157.204 .TP 3
157.205 \-C\ dir
157.206 -後続の入力ファイル引数の処理中、
157.207 -ディレクトリを
157.208 -.I dir
157.209 -に一時的に変更します。
157.210 -複数の
157.211 -.I \-C " dir"
157.212 -入力ファイルのセットを使用できます。
157.213 +膓 \f2inputfiles\fP 綣違c \f2dir\fP 娯紊眼障\f2\-C\ \fP\f2dir\fP \f2inputfiles\fP 祉茲遺戎с障
157.214 .TP 3
157.215 \-Joption
157.216 -Java Runtime Environment に渡されるオプション
157.217 -(
157.218 -.I \-J
157.219 -と
157.220 -.I option
157.221 -の間には空白文字を入れないでください)。
157.222 -.SH "機能説明"
157.223 -.IX "Java archive tool" "" "Java archive tool \(em \fLjar\fP"
157.224 -.IX "jar" "" "\fLjar\fP \(em Java archive tool"
157.225 -.B jar
157.226 -ツールは
157.227 -Java
157.228 -アプリケーションの
157.229 -1
157.230 -つで、複数個のファイルを
157.231 -1
157.232 -個の
157.233 -JAR
157.234 -アーカイブファイルに統合します。また、
157.235 -jar は汎用的なアーカイブ作成用
157.236 -および圧縮用のツールでもあり、圧縮は
157.237 -.SM ZIP
157.238 -または
157.239 -.I ZLIB
157.240 +Java 絎茵医御検激с潟\f2\-J\fP \f2option\fP 腥榊純ャс
157.241 +.RE
157.242 +
157.243 +.LP
157.244 +.RE
157.245 +.SH "茯"
157.246 +.LP
157.247 +
157.248 +.LP
157.249 +\f3jar\fP 若茲違<ゃ 1 ゃ JAR ≪若ゃ<ゃ腟障 \f3jar\fP ZIP
157.250 +.na
157.251 +\f2ZLIB\fP @
157.252 .fi
157.253 - (http://www.gzip.org/zlib/)
157.254 -形式で行います。
157.255 -ただし
157.256 -.B jar
157.257 -ツールの主な目的は、いくつかの
157.258 -Java
157.259 -アプレットやアプリケーションを
157.260 -1
157.261 -個のアーカイブに統合することです。
157.262 -アプレットやアプリケーションのコンポーネント、たとえば
157.263 -クラスファイル、イメージ、サウンドなどを単一のアーカイブに
157.264 -まとめると、ブラウザのような
157.265 -Java
157.266 -エージェントにダウンロードするときに、一度の
157.267 -HTTP
157.268 -トランザクションで済みます。コンポーネントごとに
157.269 -新たに接続する必要がありません。
157.270 -これによりダウンロード時間が大幅に短縮できます。
157.271 -また
157.272 -.B jar
157.273 -はファイルの圧縮も行うので、ダウンロードがより高速になります。
157.274 -さらに、ファイル中の個々のエントリに対してアプレットの作成者が
157.275 -署名できるので、作成元を明確化できます。
157.276 -.B jar
157.277 -ツールの構文は、
157.278 -.I tar
157.279 -コマンドの構文とほぼ同一です。
157.280 -.B jar
157.281 -アーカイブは、圧縮されているかどうかにかかわらず、
157.282 -クラスパス
157.283 +http://www.gzip.org/zlib/ х軒綵√若鴻羆≪若ゃ喝х軒若с \f3jar\fP 若筝祉ゃ Java ≪≪宴若激с潟 1 ≪若ゃ腟怨с≪≪宴若激с潟潟潟若潟 (<ゃゃ<若吾潟泣潟) 1 ゃ≪若ゃ腟Java 若吾с潟 (吟) 潟潟若潟 1 HTTP 潟吟激с潟с潟若с潟潟若潟違・膓綽荀障c潟若違紊у羝障 障\f3jar\fP <ゃх軒с潟若障障<ゃ潟≪篏臀峨吾莨若с絽茯荐若純障jar 若罕\f2tar\fP 潟潟罕祉弱с\f3JAR\fP ≪若ゃх軒鴻鴻潟篏睡с障
157.284 +.LP
157.285 +茲違<ゃ JAR <ゃ悟筝篏睡羈罨<с
157.286 +.LP
157.287 +.RS 3
157.288 +
157.289 +.LP
157.290 +.nf
157.291 +\f3
157.292 +.fl
157.293 +% jar cf myFile.jar *.class
157.294 +.fl
157.295 +\fP
157.296 .fi
157.297 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/classpath.html)
157.298 -エントリとして使用できます。
157.299 +.RE
157.300 +
157.301 .LP
157.302 -複数のファイルを jar ファイルに統合する標準的な使い方は次のとおりです。
157.303 +箴с憜c (.class) <ゃ鴻\f2myFile.jar\fP <ゃ主障jar 若\f2META\-INF/MANIFEST.MF\fP с鴻<ゃ潟障絽吾JAR <ゃ潟障с鴻<ゃ≪若ゃ≪<炊宴絎h若帥 \f2name\ :\ value\fP ≪主障jar 若с鴻<ゃ<炊宴主号荅括完ゃ
157.304 +.na
157.305 +\f2JAR file specification\fP @
157.306 +.fi
157.307 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifestс
157.308 .LP
157.309 -.RS
157.310 -.ft 3
157.311 -.nf
157.312 -% jar cf myFile.jar *.class
157.313 -.fi
157.314 -.ft 1
157.315 -.RE
157.316 -.LP
157.317 -この例では、現在のディレクトリ中のすべてのクラスファイルが
157.318 -.I myFile.jar
157.319 -という名前のファイルに置かれます。
157.320 -jar ツールは自動的に、
157.321 -.I META\-INF/MANIFEST.MF
157.322 -という名前のマニフェストファイルエントリを生成します。これは常に、JAR ファイルの最初のエントリになります。マニフェストファイルは、アーカイブに関するメタ情報を宣言し、そのデータを
157.323 -.I name : value
157.324 -ペアとして格納します。jar ツールがマニフェストファイル内にメタ情報を格納する方法の詳細については、
157.325 -.fi
157.326 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest
157.327 -の
157.328 -.na
157.329 -「JAR file specification」を参照してください。
157.330 -.LP
157.331 -既存のマニフェストファイル内に格納された
157.332 -.I name : value
157.333 -ペアを JAR ファイルに含める必要がある場合には、そのファイルを次のように \f2\-m\fP オプションを使って指定します。
157.334 +√с鴻<ゃ主 \f2name\ :\ value\fP ≪ JAR <ゃ綽荀翫<ゃ罨< \f2\-m\fP 激с潟篏帥c絎障
157.335 .LP
157.336 .RS 3
157.337
157.338 @@ -241,295 +150,206 @@
157.339 .RE
157.340
157.341 .LP
157.342 -既存のマニフェストファイルは改行文字で終わっている必要があります。\ マニフェストファイルが改行文字で終わっていない場合、\f3jar\fP はその最後の行を解析しません。
157.343 +√с鴻<ゃ壕絖хc綽荀障 с鴻<ゃ壕絖хc翫\f3jar\fP 緇茵茹f障
157.344 .br
157.345
157.346 .LP
157.347 .br
157.348
157.349 .LP
157.350 -\f3注:\ \fP コマンド行に
157.351 -.I cmf
157.352 -ではなく
157.353 -.I cfm
157.354 -が指定された jar コマンド (m と \-f オプションの順番を逆にする) の場合、\f3jar\fP コマンド行にまず jar アーカイブの名前を指定し、続いてマニフェストファイルの名前を指定する必要があります。次に例を示します。
157.355 +\f3羈:\ \fP潟潟茵 \f2cmf\fP с \f2cfm\fP 絎 jar 潟潟 (m \-f 激с潟) 翫\f3jar\fP 潟潟茵障 JAR ≪若ゃ絎膓с鴻<ゃ絎綽荀障 罨<箴腓冴障
157.356 +.RS 3
157.357 +
157.358 .LP
157.359 -.RS 5
157.360 -.B % jar cfm myFile.jar myManifestFile *.class
157.361 +.nf
157.362 +\f3
157.363 +.fl
157.364 +% jar cfm myFile.jar myManifestFile *.class
157.365 +.fl
157.366 +\fP
157.367 +.fi
157.368 +.RE
157.369 +
157.370 +.LP
157.371 +с鴻RFC822 ASCII 綵√ц鎘鴻綵√сс鴻<ゃ絎鴻膂≦茵腓冴括隈с障
157.372 +.LP
157.373 +JAR <ゃ<ゃ遵冴翫\f2x\fP 篏睡障
157.374 +.LP
157.375 +.RS 3
157.376 +
157.377 +.LP
157.378 +.nf
157.379 +\f3
157.380 +.fl
157.381 +% jar xf myFile.jar
157.382 +.fl
157.383 +\fP
157.384 +.fi
157.385 +.RE
157.386 +
157.387 +.LP
157.388 +.LP
157.389 +jar <ゃャ<ゃ遵冴翫<ゃ絎障
157.390 +.LP
157.391 +.RS 3
157.392 +
157.393 +.LP
157.394 +.nf
157.395 +\f3
157.396 +.fl
157.397 +% jar xf myFile.jar foo bar
157.398 +.fl
157.399 +\fP
157.400 +.fi
157.401 +.RE
157.402 +
157.403 +.LP
157.404 +.LP
157.405 +Java 2 SDK 若吾с 1.3 篁ラ\f2jar\fP 若cc若
157.406 +.na
157.407 +\f2JarIndex\fP @
157.408 +.fi
157.409 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex 泣若障 JarIndex 篏睡≪宴若激с潟鴻若若 JAR <ゃ鴻若合筝障≪宴若激с潟障≪茲違 JAR <ゃ潟翫鴻若綽荀 JAR <ゃ篁ュ潟若潟若潟茵障若潟鴻違 \f2\-i\fP 激с潟絎 \f2jar\fP 絎茵鴻障激с潟篏帥絎 JAR <ゃ潟<ゃ<ゃ潟<ゃ箴絖鴻 JAR <ゃゃ宴若娯臀宴障 <ゃ潟<ゃ箴絖 JAR <ゃJAR <ゃ潟<ゃс鴻 \f2Class\-Path\fP 絮с絎鏆荀障
157.410 +.LP
157.411 +.RS 3
157.412 +
157.413 +.LP
157.414 +.nf
157.415 +\f3
157.416 +.fl
157.417 +% jar i main.jar
157.418 +.fl
157.419 +\fP
157.420 +.fi
157.421 +.RE
157.422 +
157.423 +.LP
157.424 +.LP
157.425 +箴с\f2INDEX.LIST\fP <ゃ \f2main.jar\fP \f2META\-INF\fP c水ャ障
157.426 +.br
157.427 +.br
157.428 +<ゃ主宴篏睡≪宴若激с潟鴻若若合鴻若障 ゃ潟鴻<ゃ篏臀宴主号荅括完 \f2JarIndex\fP 篁罕с
157.429 +.br
157.430 +.br
157.431 +c潟若障 \f2dir1\fP <ゃх軒罔羣阪阪膓罔羣ュ \f2dir2\fP 遵冴障 (筝≧鴻 \f2jar\fP 潟潟 \f2\-f\fP 激с潟) 罨<箴腓冴障
157.432 +.LP
157.433 +.RS 3
157.434 +
157.435 +.LP
157.436 +.nf
157.437 +\f3
157.438 +.fl
157.439 +% (cd dir1; jar c .) | (cd dir2; jar x)
157.440 +.fl
157.441 +\fP
157.442 +.fi
157.443 +.RE
157.444 +
157.445 +.LP
157.446 +.LP
157.447 +\f2jar\fP 篏帥c JAR <ゃ JAR <ゃс鴻篏潟潟泣潟腆肴箴с障
157.448 +.na
157.449 +\f2Java Tutorial\fP @
157.450 +.fi
157.451 +http://java.sun.com/docs/books/tutorial/jar JAR 潟若鴻с
157.452 +.LP
157.453 +.SH "激с"
157.454 +.LP
157.455 +
157.456 +.LP
157.457 +.RS 3
157.458 +.TP 3
157.459 +c
157.460 +\f2jarfile\fP ф違≪若ゃ<ゃ篏 (\f2f\fP 絎翫)罔羣阪т障 (\f2f\fP \f2jarfile\fP ャ翫)\f2inputfiles\fP ф絎<ゃc≪若ゃ菴遵障
157.461 +.TP 3
157.462 +u
157.463 +\f2inputfiles\fP ф絎<ゃc菴遵√<ゃ \f2jarfile\fP 贋違障 (\f2f\fP 絎翫) 箴腓冴障
157.464 +.RS 3
157.465 +
157.466 +.LP
157.467 +.nf
157.468 +\f3
157.469 +.fl
157.470 +jar uf foo.jar foo.class
157.471 +.fl
157.472 +\fP
157.473 +.fi
157.474 +.RE
157.475 +筝潟潟<ゃ \f2foo.class\fP √ JAR <ゃ \f2foo.jar\fP 菴遵障罨<箴腓冴\f2\-u\fP 激с潟с鴻潟贋違с障
157.476 +.RS 3
157.477 +
157.478 +.LP
157.479 +.nf
157.480 +\f3
157.481 +.fl
157.482 +jar umf manifest foo.jar
157.483 +.fl
157.484 +\fP
157.485 +.fi
157.486 +.RE
157.487 +\f2foo.jar\fP с鴻с鴻 \f2name:value\fP ≪ф贋違障
157.488 +.TP 3
157.489 +x
157.490 +\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)<ゃc遵冴障\f2inputfiles\fP 絎翫絎<ゃc遵冴障絎違鴻<ゃc遵冴障遵冴<ゃユ≪若ゃц┃絎с
157.491 +.TP 3
157.492 +t
157.493 +\f2jarfile\fP (\f2f\fP 絎翫)障罔羣ュ (\f2f\fP \f2jarfile\fP ャ翫)絎鴻茵綵√т荀ц;腓冴障\f2inputfiles\fP 絎翫絎<ゃc筝荀ц;腓冴障絎違鴻<ゃc筝荀ц;腓冴障
157.494 +.TP 3
157.495 +i
157.496 +絎 \f2jarfile\fP 箴絖 JAR <ゃゃゃ潟号宴障箴腓冴障
157.497 +.RS 3
157.498 +
157.499 +.LP
157.500 +.nf
157.501 +\f3
157.502 +.fl
157.503 +jar i foo.jar
157.504 +.fl
157.505 +\fP
157.506 +.fi
157.507 .RE
157.508 .LP
157.509 -manifest は RFC822
157.510 -.SM ASCII
157.511 -形式に基づいたテキスト形式を使用するため、manifest ファイルの内容は
157.512 -簡単に表示および処理できます。
157.513 +筝潟潟\f2foo.jar\fP \f2INDEX.LIST\fP <ゃ障 <ゃ\f2foo.jar\fP \f2foo.jar\fP \f2Class\-Path\fP 絮с絎鴻 JAR <ゃャc宴若吾篏臀宴吾莨若障障 ゃ潟鴻箴с
157.514 +.TP 3
157.515 +f
157.516 +篏 (\f2c\fP)贋 (\f2u\fP)遵 (\f2x\fP)ゃ潟壕申 (\f2i\fP)障茵腓 (\f2t\fP) 絲乗院<ゃ \f2jarfile\fP 絎障\f2f\fP 激с潟<ゃ \f2jarfile\fP ≪障 ゃ障鴻荐菴違違筝鴻荐菴違綽荀障\f2f\fP \f2jarfile\fP ャ罔羣ュ JAR <ゃ篏睡 (x t 翫)罔羣阪 jar <ゃ 篆<障 (c u 翫)
157.517 +.TP 3
157.518 +v
157.519 +荅括完阪罔羣阪障т腓冴障
157.520 +.TP 3
157.521 +0
157.522 +(若) ZIP х軒篏睡篆絖障
157.523 +.TP 3
157.524 +M
157.525 +с鴻<ゃ潟篏障 (c u 翫) 障с鴻<ゃ潟絖翫ゃ障 (u 翫)
157.526 +.TP 3
157.527 +m
157.528 +\f2META\-INF/MANIFEST.MF\fP <ゃф絎с鴻<ゃ \f2manifest\fP \f2name :value\fP 絮с≪腟粋昭帥障су \f2jar\fP \f2name\ :\ value\fP ≪菴遵障у翫\f2jar\fP ゃ贋違障
157.529 .LP
157.530 -jar ファイルからファイルを抽出する場合は、
157.531 -.I x
157.532 -を使用します。次に例を示します。
157.533 +潟潟茵с\f3m\fP \f3f\fP 絖\f2manifest\fP \f2jarfile\fP ュ綺綺ц菴違綽荀障違罨<篏帥障
157.534 +.RS 3
157.535 +
157.536 .LP
157.537 -.RS 5
157.538 -% jar xf myFile.jar
157.539 +.nf
157.540 +\f3
157.541 +.fl
157.542 +jar cmf myManifestFile myFile.jar *.class
157.543 +.fl
157.544 +\fP
157.545 +.fi
157.546 .RE
157.547 +с鴻障с鴻劫ャ \f2name\ :\ value\fP 絮с≪菴遵с障違潟惹宴若吾с恰宴宴若吾激若潟違障 JAR 潟≪宴若激с潟絎茵絮с菴遵с障\f4\-m\fP 激с潟篏睡箴ゃJava Tutorial
157.548 +.na
157.549 +\f2JAR Files\fP @
157.550 +.fi
157.551 +http://java.sun.com/docs/books/tutorial/jar/潟若鴻с
157.552 .LP
157.553 -jar ファイルから個別のファイルを抽出する場合は、
157.554 -そのファイル名を指定します。
157.555 -.LP
157.556 -.RS 5
157.557 -% jar xf myFile.jar foo bar
157.558 -.RE
157.559 -.LP
157.560 -JDK のバージョン 1.3 から、jar ユーティリティで
157.561 -.fi
157.562 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
157.563 -の「
157.564 -.I JarIndex
157.565 -」をサポートするようになりました。
157.566 -これにより、
157.567 -アプリケーションのクラスローダは、jar ファイルから
157.568 -クラスをより高速に読み込めるようになりました。
157.569 -アプリケーションまたはアプレットが複数の jar ファイルに
157.570 -バンドルされている場合、必要な jar ファイルだけがダウン
157.571 -ロードされて開かれ、クラスが読み込まれます。
157.572 -このパフォーマンスの最適化は、
157.573 -.I jar
157.574 -を
157.575 -.I \-i
157.576 -オプションを使用して実行すると有効になります。
157.577 -指定した
157.578 -メインの jar ファイルおよびそのファイルが依存している
157.579 -すべての jar ファイルのパッケージ位置情報が生成されます。
157.580 -これらの情報は、メイン jar ファイルの manifest の
157.581 -.I Class-Path
157.582 -属性で
157.583 -指定する必要があります。
157.584 -.LP
157.585 -.RS 5
157.586 -% jar i main.jar
157.587 -.RE
157.588 -.LP
157.589 -この例では、
157.590 -.I INDEX.LIST
157.591 -ファイルが
157.592 -.I main.jar
157.593 -の
157.594 -.I META-INF ディレクトリに追加されます。
157.595 -アプリケーションのクラスローダでは、このファイルに格納された情報を
157.596 -使用して、クラスのロードを高速化します。
157.597 -インデックスファイルに位置情報を格納する方法の詳細は、
157.598 -「JarIndex 仕様」を参照してください。
157.599 -.br
157.600 -.br
157.601 -ディレクトリをコピーするには、まず
157.602 -.I dir1
157.603 -内のファイルを圧縮して標準出力に出力し、続いて標準入力から
157.604 -.I dir2
157.605 -に抽出します (両方の
157.606 -.I jar
157.607 -コマンドから
157.608 -.I \-f
157.609 -オプションを省く)。次に例を示します。
157.610 -.LP
157.611 -.RS 5
157.612 -% (cd dir1; jar c .) | (cd dir2; jar x)
157.613 -.RE
157.614 -.LP
157.615 -.I jar
157.616 -を使って JAR ファイルや JAR ファイルマニフェストを操作するコマンドサンプルを確認するには、「例」を参照してください。また、
157.617 -.fi
157.618 -http://java.sun.com/docs/books/tutorial/jar
157.619 -の
157.620 -.na
157.621 -「Java Tutorial」の JAR コースも参照してください。
157.622 -.SH "オプション"
157.623 -.if t .TP 10
157.624 -.if n .TP 5
157.625 -.B c
157.626 -新規のアーカイブファイルを
157.627 -.I jarfile
157.628 -という名前 (
157.629 -.I f
157.630 -を指定した場合)、または標準出力上に (
157.631 -.I f
157.632 -と
157.633 -.I jarfile
157.634 -を省略した場合) 作成します。
157.635 -アーカイブには入力ファイルで指定したファイルおよびディレクトリが追加されます。
157.636 -.if t .TP 10
157.637 -.if n .TP 5
157.638 -.B u
157.639 -既存の
157.640 -.I jarfile
157.641 -(
157.642 -.I f
157.643 -を指定した場合) を更新します。
157.644 -このとき、この
157.645 -.I jarfile
157.646 -には入力ファイルで指定されたファイルおよびディレクトリが追加されます。以下に例を示します。
157.647 -.LP
157.648 -.RS 5
157.649 -% jar uf foo.jar foo.class
157.650 -.RE
157.651 -.LP
157.652 -この例では、ファイル
157.653 -.I foo.class
157.654 -が既存の jar ファイル
157.655 -.I foo.jar
157.656 -に追加されます。
157.657 -.I u
157.658 -オプションでは、マニフェストのエントリを更新することもできます。以下に例を示します。
157.659 -.LP
157.660 -.RS 5
157.661 -% jar umf manifest foo.jar
157.662 -.RE
157.663 -.LP
157.664 -.I foo.jar
157.665 -マニフェストをマニフェスト内の名前:値ペアで更新します。
157.666 -.if t .TP 10
157.667 -.if n .TP 5
157.668 -.B x
157.669 -ファイルおよびディレクトリを
157.670 -.I jarfile
157.671 -(
157.672 -.I f
157.673 -を指定した場合)、
157.674 -または標準入力 (
157.675 -.I f
157.676 -と
157.677 -.I jarfile
157.678 -を省略した場合) から抽出します。
157.679 -入力ファイルを指定した場合、その入力ファイルで指定されたファイルおよびディレクトリだけが
157.680 -抽出されます。指定しない場合は、すべてのファイルおよびディレクトリが抽出されます。
157.681 -抽出されたファイルの日時は、アーカイブ内で設定されたものです。
157.682 -.if t .TP 10
157.683 -.if n .TP 5
157.684 -.B t
157.685 -.I jarfile
157.686 -(
157.687 -.I f
157.688 -を指定した場合)、または標準入力 (
157.689 -.I f
157.690 -と
157.691 -.I jarfile
157.692 -を省略した場合) から内容をリストします。入力ファイルを指定した場合、
157.693 -その入力ファイルで指定されたファイルおよびディレクトリだけが
157.694 -リストされます。指定しない場合は、すべてのファイルおよびディレクトリがリストされます。
157.695 -.if t .TP 10
157.696 -.if n .TP 5
157.697 -.B i
157.698 -指定された
157.699 -.I jarfile
157.700 -および関連づけられている jar ファイルの
157.701 -インデックス情報を生成します。次に例を示します。
157.702 -.LP
157.703 -.RS 5
157.704 -% jar i foo.jar
157.705 -.RE
157.706 -.LP
157.707 -.I foo.jar
157.708 -に
157.709 -.I INDEX.LIST
157.710 -ファイルが生成されます。
157.711 -このファイルには、
157.712 -.I foo.jar
157.713 -の各パッケージおよび
157.714 -.I foo.jar
157.715 -の
157.716 -.I Class-Path
157.717 -属性に指定されているすべての jar ファイルの
157.718 -位置情報が書き込まれています。
157.719 -インデックスの例を参照してください。
157.720 -.if t .TP 10
157.721 -.if n .TP 5
157.722 -.B f
157.723 -作成 (c)、更新 (u)、抽出 (x)、インデックス作成(i)、
157.724 -または表示 (t) する
157.725 -.I jarfile
157.726 -を指定します。
157.727 -.I \-f
157.728 -オプションと
157.729 -.I jarfile
157.730 -のファイル名は対になっています。
157.731 -使用する場合は、両方を一緒に使用します。
157.732 -.I f
157.733 -と
157.734 -.I jarfile
157.735 -を省略すると、標準入力から jar ファイル名が
157.736 -使用されたり (x および t の場合)、標準出力に jar ファイルが
157.737 -送信されたりします (c および u の場合)。
157.738 -.if t .TP 10
157.739 -.if n .TP 5
157.740 -.B v
157.741 -標準出力に詳細な出力を生成します。次に例を示します。
157.742 -.if t .TP 10
157.743 -.if n .TP 5
157.744 -.B 0
157.745 -ゼロ。ZIP 圧縮を使用せずに格納します。
157.746 -.if t .TP 10
157.747 -.if n .TP 5
157.748 -.B M
157.749 -manifest ファイルエントリを作成しません (c および u の場合)。または
157.750 -すでに存在する manifest ファイルエントリを削除します (u の場合)。
157.751 -.if t .TP 10
157.752 -.if n .TP 5
157.753 -.B m
157.754 -指定したマニフェストファイル
157.755 -.I manifest
157.756 -から
157.757 -名前:値属性をファイル
157.758 -.I META-INF/MANIFEST.MF
157.759 -に取り込みます。
157.760 -すでに同じ名前で存在しない限り、
157.761 -.I jar
157.762 -はその名前:値ペアを追加します。同じ名前で存在する場合は、
157.763 -jar
157.764 -はその値を更新します。
157.765 -.LP
157.766 -コマンド行では、文字
157.767 -.B m
157.768 -と
157.769 -.B f
157.770 -は、
157.771 -.I manifest
157.772 -と
157.773 -.I jarfile
157.774 -が出現するのと
157.775 -同じ順序で使用します。次に例を示します。
157.776 -.LP
157.777 -.RS 5
157.778 -% jar cmf myManifestFile myFile.jar *.class
157.779 -.RE
157.780 -.LP
157.781 -manifest ファイルには、デフォルトのマニフェストに含まれていない、
157.782 -専用の名前:値属性ペアを追加できます。
157.783 -たとえば、
157.784 -ベンダー情報、バージョン情報、パッケージシーリング、
157.785 -または JAR にバンドルされたアプリケーションを実行するための属性を
157.786 -追加できます。
157.787 -.B -m
157.788 -オプションの使用例については、「Java Tutorial」
157.789 -.fi
157.790 -http://java.sun.com/docs/books/tutorial/jar/
157.791 -にある
157.792 -.na
157.793 -「
157.794 -.I JAR Files
157.795 -」コースを参照してください。
157.796 .TP 3
157.797 e
157.798 -実行可能 JAR ファイル内にバンドルされたスタンドアロンアプリケーションのアプリケーションエントリポイントとして、
157.799 -.I entrypoint
157.800 -を設定します。このオプションを使用すると、マニフェストファイル内の
157.801 -.I Main\-Class
157.802 -属性値が作成または上書きされます。このオプションは、JAR ファイルの作成中または更新中に使用できます。このオプションを使えば、マニフェストファイルを編集または作成することなしに、アプリケーションのエントリポイントを指定できます。
157.803 +絎茵 JAR <ゃ潟鴻帥潟≪潟≪宴若激с潟≪宴若激с潟潟ゃ潟\f2entrypoint\fP 荐絎障激с潟篏睡с鴻<ゃ \f2Main\-Class\fP 絮уゃ篏障筝吾障 激с潟JAR <ゃ篏筝障贋遺賢篏睡с障 激с潟篏帥違с鴻<ゃ膩障篏≪宴若激с潟潟ゃ潟絎с障
157.804 .br
157.805 .br
157.806 -たとえば、次のコマンドは
157.807 -.I Main.jar
157.808 -を作成しますが、その際、マニフェストファイル内の
157.809 -.I Main\-Class
157.810 -属性値は
157.811 -.I Main
157.812 -に設定されます。
157.813 +違罨<潟潟 \f2Main.jar\fP 篏障с鴻<ゃ \f2Main\-Class\fP 絮уゃ \f2Main\fP 荐絎障
157.814 .RS 3
157.815
157.816 .LP
157.817 @@ -542,7 +362,7 @@
157.818 .fi
157.819 .RE
157.820 .LP
157.821 -次のコマンドを実行すると java ランタイムから直接このアプリケーションを起動できます。
157.822 +罨<潟潟絎茵 java 潟帥ゃ贋・≪宴若激с潟莎桁с障
157.823 .RS 3
157.824
157.825 .LP
157.826 @@ -554,11 +374,7 @@
157.827 \fP
157.828 .fi
157.829 .RE
157.830 -エントリポイントのクラス名が特定のパッケージ内に存在している場合、エントリポイントの区切り文字としてドット (「.」) またはスラッシュ (「/」) を使用できます。たとえば、
157.831 -.I Main.class
157.832 -が
157.833 -.I foo
157.834 -という名前のパッケージ内に存在している場合、次のようにしてエントリポイントを指定できます。
157.835 +潟ゃ潟劫劫宴若後絖翫潟ゃ潟阪絖 (.) 障鴻激 (/) 篏睡с障違\f2Main.class\fP \f2foo\fP 宴若後絖翫罨<潟ゃ潟絎с障
157.836 .RS 3
157.837
157.838 .LP
157.839 @@ -570,7 +386,7 @@
157.840 \fP
157.841 .fi
157.842 .RE
157.843 -または
157.844 +障
157.845 .RS 3
157.846
157.847 .LP
157.848 @@ -582,36 +398,14 @@
157.849 \fP
157.850 .fi
157.851 .RE
157.852 -\f3注:\ \fP
157.853 -.I \-m
157.854 -オプションと
157.855 -.I \-e
157.856 -オプションの両方を同時に指定する場合、指定されたマニフェストにも
157.857 -.I Main\-Class
157.858 -属性が含まれていると、
157.859 -.I Main.class
157.860 -の指定があいまいになってエラーが発生し、JAR の作成または更新処理が異常終了します。
157.861 -.if t .TP 10
157.862 -.if n .TP 5
157.863 -.B \-C \ dir
157.864 -.B jar
157.865 -コマンドの実行中に一時的にディレクトリを変更します (
157.866 -.I cd " dir"
157.867 -)。
157.868 -このとき、後続の入力ファイル引数が処理されます。
157.869 -この動作は、UNIX の
157.870 -.I tar
157.871 -ユーティリティの
157.872 -.I \-C
157.873 -オプションと
157.874 -同様の動作になります。
157.875 -たとえば、次のコマンドは、
157.876 -.I classes
157.877 -ディレクトリに移動し、そのディレクトリから
157.878 -.I bar.classes
157.879 -を
157.880 -.I foo.jar
157.881 -に追加します。
157.882 +\f3羈:\ \fP \f2\-m\fP 激с潟 \f2\-e\fP 激с潟筝≧鴻絎翫絎с鴻 \f2Main\-Class\fP 絮с障\f2Main.class\fP 絎障c若榊JAR 篏障贋医医幻腟篋障
157.883 +.LP
157.884 +.TP 3
157.885 +\-C \ dir
157.886 +\f2jar\fP 潟潟絎茵筝緇膓 \f2inputfiles\fP 綣違筝c紊眼障 (\f2cd\fP\ \f2dir\fP)UNIX \f2tar\fP 若cc若 \f2\-C\fP 激с潟罘純蕁篌若障
157.887 +.br
157.888 +.br
157.889 +違罨<潟潟\f2classes\fP c腱糸c \f2bar.class\fP \f2foo.jar\fP 菴遵障
157.890 .RS 3
157.891
157.892 .LP
157.893 @@ -623,20 +417,7 @@
157.894 \fP
157.895 .fi
157.896 .RE
157.897 -次のコマンドでは、
157.898 -.I classes
157.899 -ディレクトリに移動し、
157.900 -.I classes
157.901 -ディレクトリ内のすべてのファイルを
157.902 -.I foo.jar
157.903 -に追加します (jar ファイルには classes ディレクトリを作成しません)。
157.904 -次に元のディレクトリに戻ってから、
157.905 -.I bin
157.906 -ディレクトリに移動し、
157.907 -.I xyz.class
157.908 -を
157.909 -.I foo.jar
157.910 -に追加します。
157.911 +罨<潟潟с\f2classes\fP c腱糸\f2classes\fP c鴻<ゃ \f2foo.jar\fP 菴遵障 (jar <ゃ classes c篏障) 罨<c祉c\f2bin\fP c腱糸\f2xyz.class\fP \f2foo.jar\fP 菴遵障
157.912 .RS 3
157.913
157.914 .LP
157.915 @@ -648,276 +429,294 @@
157.916 \fP
157.917 .fi
157.918 .RE
157.919 -.I classes
157.920 -にファイル
157.921 -.I bar1
157.922 -および
157.923 -.I bar2
157.924 -がある場合、
157.925 -.I jar tf foo.jar
157.926 -を実行すると、jar ファイルの内容が次のように表示されます。
157.927 +\f2classes\fP \f2bar1\fP \f2bar2\fP 篆翫\f2jar tf foo.jar\fP 篏睡JAR <ゃ罨<荀膣障
157.928 +.RS 3
157.929 +
157.930 .LP
157.931 -.if t .RS 15
157.932 -.if n .RS 8
157.933 -.ft 3
157.934 .nf
157.935 -META-INF/
157.936 -META-INF/MANIFEST.MF
157.937 +\f3
157.938 +.fl
157.939 +META\-INF/
157.940 +.fl
157.941 +META\-INF/MANIFEST.MF
157.942 +.fl
157.943 bar1
157.944 +.fl
157.945 bar2
157.946 +.fl
157.947 xyz.class
157.948 +.fl
157.949 +\fP
157.950 .fi
157.951 -.ft 1
157.952 -.RE
157.953 -.if t .TP 10
157.954 -.if n .TP 5
157.955 -.B \-Joption
157.956 -.I option
157.957 -を Java Runtime Environment に渡します。
157.958 -ここで、
157.959 -.I option
157.960 -は、Java アプリケーション起動プログラムのマニュアルページ
157.961 -.fi
157.962 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html#options)
157.963 -で説明されているオプションの 1 つです。
157.964 -たとえば
157.965 -.B \-J-Xms48m
157.966 -は、最大メモリを 48M バイトに設定します。
157.967 -.I \-J
157.968 -が基本にする仮想マシンにオプションを渡すことは、共通の規約です。
157.969 -.SH "コマンド行引数ファイル"
157.970 -.B jar
157.971 -コマンド行を短くまたは簡単にするために、
157.972 -.I jar
157.973 -コマンドの引数 (
157.974 -.I \-J
157.975 -オプションを除く) を含むファイルを 1 つ以上指定できます。
157.976 -これにより、任意の長さの
157.977 -.B jar
157.978 -コマンドを作成でき、
157.979 -オペレーティングシステムによるコマンド行の制限を
157.980 -回避できます。
157.981 -.LP
157.982 -引数ファイルには、オプションとファイル名を含めることができます。
157.983 -引数ファイル内の引数は空白文字区切りまたは改行区切りにします。
157.984 -引数ファイル内のファイル名は、引数ファイルの位置に対してではなく、
157.985 -現在のディレクトリに対して相対的に指定します。
157.986 -通常はオペレーティングシステムシェルによって展開されるワイルドカード (*) は
157.987 -展開されません。ファイルを再帰的に解釈するための @ 文字は使用できません。
157.988 -.I \-J
157.989 -オプションは、起動プログラムに渡されるため、サポートされていません。
157.990 -起動プログラムでは引数ファイルを使用できないためです。
157.991 -.LP
157.992 -.I jar
157.993 -の実行時、各引数ファイルのパスおよび名前の先頭に @ 文字を付けて渡します。
157.994 -.I jar
157.995 -で先頭に文字 @ の付いた引数が出現するたびに、
157.996 -そのファイルの内容が引数リストに展開されます。
157.997 -.br
157.998 -.br
157.999 -次の例では、
157.1000 -.I find
157.1001 -コマンドから出力されたファイル名を
157.1002 -.I classes.list
157.1003 -内に格納しています。
157.1004 -.LP
157.1005 -.RS 5
157.1006 -% find . -name '*.class' -print > classes.list
157.1007 .RE
157.1008 .LP
157.1009 -その後、引数ファイル構文を使って
157.1010 -.I jar
157.1011 -にリストを渡すと、
157.1012 -.I Classes.list
157.1013 -で
157.1014 -.I jar
157.1015 -コマンドを実行できます。
157.1016 +.TP 3
157.1017 +\-Joption
157.1018 +Java 絎茵医 \f2option\fP 羝<障 \f2option\fP Java ≪宴若激с活儀若<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f4\-J\-Xmx48M\fP 絎紊с<≪若 48M ゃ荐絎障\f2\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
157.1019 +.RE
157.1020 +
157.1021 .LP
157.1022 -.RS 5
157.1023 -% jar cf my.jar @classes.list
157.1024 -.RE
157.1025 +.SH "潟潟茵綣違<ゃ"
157.1026 .LP
157.1027 -引数ファイルはパスを指定できますが、相対パスが記述された引数ファイル内の
157.1028 -すべてのファイル名は、渡されたパスに対して相対的ではなく、
157.1029 -現在の作業ディレクトリに相対的となります。次に例を示します。
157.1030 +
157.1031 .LP
157.1032 -.RS 5
157.1033 -% jar @path1/classes.list
157.1034 -.RE
157.1035 -.SH "使用例"
157.1036 -あるディレクトリ中のファイルをすべてアーカイブに追加する例を示します
157.1037 -(アーカイブがすでに存在する場合は、内容が上書きされます)。
157.1038 -詳細を列挙すると (
157.1039 -.I \-v
157.1040 -オプションを使用)、
157.1041 -サイズや最終更新日など、
157.1042 -アーカイブ内のファイルに関して詳しい情報が得られます。
157.1043 -.RS
157.1044 +jar 潟潟茵膂≧\f2jar\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝<ゃ絎с障篁紙激 jar 潟潟篏с若c潟違激鴻潟潟茵狗茹f障障
157.1045 +.LP
157.1046 +綣違<ゃ激с潟<ゃс障<ゃ綣違鴻若鴻障壕у阪障綣違<ゃ<ゃ憜c荀後障鴻障 綣違<ゃ篏臀荀後障鴻с障ゃ若 (*) 絽吾違若c潟違激鴻激сc絖茹i障翫茹i障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
157.1047 +.LP
157.1048 +.LP
157.1049 +\f2jar\fP 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障\f2jar\fP \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
157.1050 +.br
157.1051 +.br
157.1052 +罨<箴с\f2find\fP 潟潟阪<ゃ \f2classes.list\fP 主障
157.1053 +.LP
157.1054 +.RS 3
157.1055 +
157.1056 +.LP
157.1057 +.nf
157.1058 \f3
157.1059 -.nf
157.1060 -% ls
157.1061 -1.au Animator.class monkey.jpg
157.1062 -2.au Wave.class spacemusic.au
157.1063 -3.au at_work.gif
157.1064 -.LP
157.1065 -% jar cvf bundle.jar *
157.1066 -added manifest
157.1067 -adding: 1.au(in = 2324) (out= 67)(deflated 97%)
157.1068 -adding: 2.au(in = 6970) (out= 90)(deflated 98%)
157.1069 -adding: 3.au(in = 11616) (out= 108)(deflated 99%)
157.1070 -adding: Animator.class(in = 2266) (out= 66)(deflated 97%)
157.1071 -adding: Wave.class(in = 3778) (out= 81)(deflated 97%)
157.1072 -adding: at_work.gif(in = 6621) (out= 89)(deflated 98%)
157.1073 -adding: monkey.jpg(in = 7667) (out= 91)(deflated 98%)
157.1074 -adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)
157.1075 -\f1
157.1076 +.fl
157.1077 +% find \fP\f3.\fP \-name '*.class' \-print > classes.list
157.1078 +.fl
157.1079 .fi
157.1080 .RE
157.1081 -イメージ、オーディオファイル、およびクラス用のサブディレクトリが
157.1082 -すでに存在する場合、単一の
157.1083 -.B jar
157.1084 -ファイルに結合できます。
157.1085 -.RS
157.1086 +
157.1087 +.LP
157.1088 +.LP
157.1089 +緇綣違<ゃ罕篏帥c \f2jar\fP 鴻羝<\f2Classes.list\fP \f2jar\fP 潟潟絎茵с障
157.1090 +.LP
157.1091 +.RS 3
157.1092 +
157.1093 +.LP
157.1094 +.nf
157.1095 \f3
157.1096 +.fl
157.1097 +% jar cf my.jar @classes.list
157.1098 +.fl
157.1099 +\fP
157.1100 +.fi
157.1101 +.RE
157.1102 +
157.1103 +.LP
157.1104 +綣違<ゃ鴻絎с障後障鴻荐菴違綣違<ゃ鴻<ゃ羝<鴻絲障後丞с憜篏罐c後丞障 罨<箴腓冴障
157.1105 +.RS 3
157.1106 +
157.1107 +.LP
157.1108 .nf
157.1109 -% ls -F
157.1110 +\f3
157.1111 +.fl
157.1112 +% jar @path1/classes.list
157.1113 +.fl
157.1114 +\fP
157.1115 +.fi
157.1116 +.RE
157.1117 +
157.1118 +.LP
157.1119 +.LP
157.1120 +
157.1121 +.LP
157.1122 +.SH "箴"
157.1123 +.LP
157.1124 +
157.1125 +.LP
157.1126 +劫c鴻<ゃ≪若ゃ菴遵 (≪若ゃс絖翫絎鴻筝吾) 罨<障\f2\-v\fP 激с潟篏睡宴荅括完絎泣ゃ冴違贋井ャ≪若ゃ<ゃゃ荅括完宴茵腓冴障
157.1127 +.RS 3
157.1128 +
157.1129 +.LP
157.1130 +.nf
157.1131 +\f3
157.1132 +.fl
157.1133 +% ls
157.1134 +.fl
157.1135 +1.au Animator.class monkey.jpg
157.1136 +.fl
157.1137 +2.au Wave.class spacemusic.au
157.1138 +.fl
157.1139 +3.au at_work.gif
157.1140 +.fl
157.1141 +
157.1142 +.fl
157.1143 +% jar cvf bundle.jar *
157.1144 +.fl
157.1145 +added manifest
157.1146 +.fl
157.1147 +adding: 1.au(in = 2324) (out= 67)(deflated 97%)
157.1148 +.fl
157.1149 +adding: 2.au(in = 6970) (out= 90)(deflated 98%)
157.1150 +.fl
157.1151 +adding: 3.au(in = 11616) (out= 108)(deflated 99%)
157.1152 +.fl
157.1153 +adding: Animator.class(in = 2266) (out= 66)(deflated 97%)
157.1154 +.fl
157.1155 +adding: Wave.class(in = 3778) (out= 81)(deflated 97%)
157.1156 +.fl
157.1157 +adding: at_work.gif(in = 6621) (out= 89)(deflated 98%)
157.1158 +.fl
157.1159 +adding: monkey.jpg(in = 7667) (out= 91)(deflated 98%)
157.1160 +.fl
157.1161 +adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)
157.1162 +.fl
157.1163 +\fP
157.1164 +.fi
157.1165 +.RE
157.1166 +
157.1167 +.LP
157.1168 +с糸若c<ゃ潟合泣c翫筝 JAR <ゃ腟с障
157.1169 +.RS 3
157.1170 +
157.1171 +.LP
157.1172 +.nf
157.1173 +\f3
157.1174 +.fl
157.1175 +% ls \-F
157.1176 +.fl
157.1177 audio/ classes/ images/
157.1178 +.fl
157.1179
157.1180 +.fl
157.1181 % jar cvf bundle.jar audio classes images
157.1182 +.fl
157.1183 added manifest
157.1184 +.fl
157.1185 adding: audio/(in = 0) (out= 0)(stored 0%)
157.1186 +.fl
157.1187 adding: audio/1.au(in = 2324) (out= 67)(deflated 97%)
157.1188 +.fl
157.1189 adding: audio/2.au(in = 6970) (out= 90)(deflated 98%)
157.1190 +.fl
157.1191 adding: audio/3.au(in = 11616) (out= 108)(deflated 99%)
157.1192 +.fl
157.1193 adding: audio/spacemusic.au(in = 3079) (out= 73)(deflated 97%)
157.1194 +.fl
157.1195 adding: classes/(in = 0) (out= 0)(stored 0%)
157.1196 +.fl
157.1197 adding: classes/Animator.class(in = 2266) (out= 66)(deflated 97%)
157.1198 +.fl
157.1199 adding: classes/Wave.class(in = 3778) (out= 81)(deflated 97%)
157.1200 +.fl
157.1201 adding: images/(in = 0) (out= 0)(stored 0%)
157.1202 +.fl
157.1203 adding: images/monkey.jpg(in = 7667) (out= 91)(deflated 98%)
157.1204 +.fl
157.1205 adding: images/at_work.gif(in = 6621) (out= 89)(deflated 98%)
157.1206 +.fl
157.1207
157.1208 -% ls -F
157.1209 +.fl
157.1210 +% ls \-F
157.1211 +.fl
157.1212 audio/ bundle.jar classes/ images/
157.1213 +.fl
157.1214 +\fP
157.1215 .fi
157.1216 -\f1
157.1217 .RE
157.1218 -次の例では、
157.1219 -.I t
157.1220 -オプションを指定して、jar ファイル中のエントリ名を表示します。
157.1221 -.RS
157.1222 +
157.1223 +.LP
157.1224 +JAR <ゃ潟茵腓冴\f2t\fP激с潟篏睡障
157.1225 +.RS 3
157.1226 +
157.1227 +.LP
157.1228 +.nf
157.1229 \f3
157.1230 -.nf
157.1231 +.fl
157.1232 % jar tf bundle.jar
157.1233 -META-INF/
157.1234 -META-INF/MANIFEST.MF
157.1235 +.fl
157.1236 +META\-INF/
157.1237 +.fl
157.1238 +META\-INF/MANIFEST.MF
157.1239 +.fl
157.1240 audio/1.au
157.1241 +.fl
157.1242 audio/2.au
157.1243 +.fl
157.1244 audio/3.au
157.1245 +.fl
157.1246 audio/spacemusic.au
157.1247 +.fl
157.1248 classes/Animator.class
157.1249 +.fl
157.1250 classes/Wave.class
157.1251 +.fl
157.1252 images/monkey.jpg
157.1253 +.fl
157.1254 images/at_work.gif
157.1255 +.fl
157.1256 +\fP
157.1257 .fi
157.1258 -\f1
157.1259 .RE
157.1260 -クラスの読み込みを高速化するために jar ファイルにインデックスファイルを
157.1261 -追加する場合は、
157.1262 -.I i
157.1263 -オプションを使用してください。
157.1264 +
157.1265 +.LP
157.1266 +.LP
157.1267 +鴻若蕭ゃ潟鴻<ゃ JAR <ゃ菴遵\f2i\fP激с潟篏睡障
157.1268 .br
157.1269 .br
157.1270 -例:
157.1271 +箴:
157.1272 .br
157.1273
157.1274 .LP
157.1275 .RS 3
157.1276
157.1277 .LP
157.1278 -たとえば株取引アプリケーションの内部依存しているクラスを
157.1279 -.I main.jar
157.1280 -、
157.1281 -.I buy.jar
157.1282 -、
157.1283 -および
157.1284 -.I sell.jar
157.1285 -という 3 つの jar ファイル
157.1286 -に分割したとします。
157.1287 -.I main.jar
157.1288 -のマニフェストの
157.1289 -.I Class-Path
157.1290 -属性に次のように指定した場合、
157.1291 +違綣≪宴若激с括娯箴絖鴻\f2main.jar\fP\f2buy.jar\fP \f2sell.jar\fP 3 ゃ JAR <ゃ蚊障
157.1292 +.br
157.1293 +
157.1294 .LP
157.1295 -.RS 5
157.1296 -Class-Path: buy.jar sell.jar
157.1297 +.br
157.1298 +
157.1299 +.LP
157.1300 +\f2main.jar\fP с鴻 \f2Class\-path\fP 絮с罨<絎翫
157.1301 +.nf
157.1302 +\f3
157.1303 +.fl
157.1304 +Class\-Path: buy.jar sell.jar
157.1305 +.fl
157.1306 +\fP
157.1307 +.fi
157.1308 +
157.1309 +.LP
157.1310 +\f2\-i\fP 激с潟篏睡違≪宴若激с潟鴻 茯粋昭帥蕭с障
157.1311 +.nf
157.1312 +\f3
157.1313 +.fl
157.1314 +% jar i main.jar
157.1315 +.fl
157.1316 +\fP
157.1317 +.fi
157.1318 +
157.1319 +.LP
157.1320 +\f2INDEX.LIST\fP <ゃ \f2META\-INF\fP c水ャ障腟≪宴若激с潟鴻若若c鴻障 純若鴻罎膣≪茵 jar <ゃ潟若障
157.1321 .RE
157.1322 -.LP
157.1323 -.I -i
157.1324 -オプションを使用すれば、アプリケーションのクラスの
157.1325 -読み込みを高速化できます。
157.1326 -.LP
157.1327 -.RS 5
157.1328 -% jar i main.jar
157.1329 -.RE
157.1330 -.LP
157.1331 -.I INDEX.LIST
157.1332 -ファイルが
157.1333 -.I META-INF
157.1334 -ディレクトリに追加されます。
157.1335 -この結果、アプリケーションのクラスローダによってクラスまたは
157.1336 -リソースの検索が行われるときに、適切な jar ファイルがダウンロードされます。
157.1337 -.SH "関連項目"
157.1338 +.SH "∫i"
157.1339 .LP
157.1340
157.1341 .LP
157.1342 +.na
157.1343 +\f2JAR <ゃ网荀\fP @
157.1344 .fi
157.1345 http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
157.1346 -の
157.1347 -.na
157.1348 -「
157.1349 -.I The Jar Overview
157.1350 -」
157.1351 .br
157.1352
157.1353 .LP
157.1354 +.na
157.1355 +\f2JAR <ゃ篁罕\fP @
157.1356 .fi
157.1357 http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
157.1358 -の
157.1359 -.na
157.1360 -「
157.1361 -.I The Jar File Specification
157.1362 -」
157.1363 .br
157.1364
157.1365 .LP
157.1366 +.na
157.1367 +\f2Jar ゃ潟鴻\fP @
157.1368 .fi
157.1369 -http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
157.1370 -の
157.1371 -.na
157.1372 -「
157.1373 -.I The JarIndex Spec
157.1374 -」
157.1375 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JARIndex
157.1376 .br
157.1377
157.1378 .LP
157.1379 +.na
157.1380 +\f2Jar ャ若≪\fP @
157.1381 .fi
157.1382 -http://java.sun.com/docs/books/tutorial/jar
157.1383 -の
157.1384 -.na
157.1385 -「
157.1386 -.I Jar Tutorial
157.1387 -」
157.1388 -(Java ソフトウェアの Web サイト内)
157.1389 +http://java.sun.com/docs/books/tutorial/jar (Java Software Web 泣ゃ)
157.1390 .br
157.1391
157.1392 .LP
157.1393 -.fi
157.1394 -http://java.sun.com/javase/6/docs/technotes/tools/share/pack200.html
157.1395 -の
157.1396 -.na
157.1397 -「
157.1398 -.I pack200 Reference Page
157.1399 -」
157.1400 +pack200(1)
157.1401 .LP
157.1402
158.1 --- a/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Tue May 12 15:21:55 2009 +0900
158.2 +++ b/src/solaris/doc/sun/man/man1/ja/jarsigner.1 Thu May 14 00:17:25 2009 -0700
158.3 @@ -1,429 +1,827 @@
158.4 -'\" t
158.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
158.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
158.7 -.\"
158.8 -.\" This code is free software; you can redistribute it and/or modify it
158.9 -.\" under the terms of the GNU General Public License version 2 only, as
158.10 -.\" published by the Free Software Foundation.
158.11 -.\"
158.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
158.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
158.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
158.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
158.16 -.\" accompanied this code).
158.17 -.\"
158.18 -.\" You should have received a copy of the GNU General Public License version
158.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
158.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
158.21 -.\"
158.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
158.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
158.24 -.\" have any questions.
158.25 -.\" `
158.26 -.TH jarsigner 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
158.27 -.SH "名前"
158.28 -jarsigner \- JAR 署名および検証ツール
158.29 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
158.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
158.31 +."
158.32 +." This code is free software; you can redistribute it and/or modify it
158.33 +." under the terms of the GNU General Public License version 2 only, as
158.34 +." published by the Free Software Foundation.
158.35 +."
158.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
158.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
158.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
158.39 +." version 2 for more details (a copy is included in the LICENSE file that
158.40 +." accompanied this code).
158.41 +."
158.42 +." You should have received a copy of the GNU General Public License version
158.43 +." 2 along with this work; if not, write to the Free Software Foundation,
158.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
158.45 +."
158.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
158.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
158.48 +." have any questions.
158.49 +."
158.50 +.TH jarsigner 1 "04 May 2009"
158.51 +." Generated from HTML by html2man (author: Eric Armstrong)
158.52 +
158.53 +.LP
158.54 +.SH ""
158.55 +jarsigner \- JAR 臀峨恰荐若若
158.56 .LP
158.57 .RS 3
158.58
158.59 .LP
158.60 .LP
158.61 -Java ARchive (JAR) ファイルの署名を生成し、署名付き JAR ファイルの署名を検証します。
158.62 +Java ARchive (JAR) <ゃ臀峨臀峨篁 JAR <ゃ臀峨罎荐若障
158.63 .LP
158.64 .RE
158.65 -.SH "形式"
158.66 -.B jarsigner
158.67 -[
158.68 -.BI options
158.69 -]
158.70 -jar-file alias
158.71 -.br
158.72 -.B jarsigner
158.73 -.BI \-verify
158.74 -[
158.75 -.BI options
158.76 -]
158.77 -jar-file
158.78 -.SH "説明"
158.79 -.IX "JAR signing and verification tool " "" "JAR signing and verification tool \(em \fLjarsigner\fP"
158.80 -.IX "jarsigner" "" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.81 -.B jarsigner
158.82 -ツールは、次の 2 つの目的で使用します。
158.83 -.TP 5
158.84 -1.
158.85 -Java ARchive (JAR) ファイルに署名を付ける
158.86 -.TP 5
158.87 -2.
158.88 -署名付き JAR ファイルの署名と完全性を検証する
158.89 +.SH "綵√"
158.90 .LP
158.91 -JAR 機能を使うと、クラスファイル、イメージ、サウンド、およびその他のデジタルデータ
158.92 -を単一のファイルにパッケージ化できるので、ファイルを迅速かつ容易に配布できます。
158.93 -開発者は、
158.94 -.B jar
158.95 -という名前のツールを使って JAR ファイルを作成できます。技術的な観点から言えば、
158.96 -すべての ZIP ファイルも JAR ファイルとみなすことができます。
158.97 -.LP
158.98 -「デジタル署名」は、なんらかのデータ (「署名」の対象となるデータ) と、エンティティ
158.99 -(人、会社など) の非公開鍵とに基づいて計算されるビット列です。手書きの署名同様、
158.100 -デジタル署名には多くの利点があります。
158.101 -.TP 2
158.102 -\(bu
158.103 -署名の生成に使われた非公開鍵と対になる公開鍵を使って計算を行うことで、
158.104 -デジタル署名が本物かどうかを検証できる
158.105 -.TP 2
158.106 -\(bu
158.107 -非公開鍵が他人に知られない限り、デジタル署名の偽造は不可能である
158.108 -.TP 2
158.109 -\(bu
158.110 -デジタル署名は、その署名が付いたデータだけを対象とするものであり、ほかのデータの
158.111 -署名として機能することはない
158.112 -.TP 2
158.113 -\(bu
158.114 -署名付きのデータは変更できない。データが変更された場合は、その署名によってデータ
158.115 -が本物ではないことが検証される
158.116 -.LP
158.117 -ファイルに対してエンティティの署名を生成するには、まず、そのエンティティが公開鍵と
158.118 -非公開鍵のペアを持つ必要があります。また、公開鍵を認証する 1 つ以上の証明書も
158.119 -必要です。「証明書」とは、あるエンティティからのデジタル署名付きの文書のことです。
158.120 -証明書には、ほかのあるエンティティの公開鍵が特別な値を持っていることが書かれて
158.121 -います。
158.122 -.LP
158.123 -.B jarsigner
158.124 -は、「キーストア」に含まれる鍵と証明書情報を使って、JAR ファイルのデジタル署名を
158.125 -生成します。キーストアは、非公開鍵と、非公開鍵に関連付けられた X.509 証明連鎖が
158.126 -収められたデータベースです。証明連鎖は、非公開鍵に対応する公開鍵を認証します。
158.127 -キーストアの作成と管理には、
158.128 -.B keytool
158.129 -ユーティリティを使います。
158.130 -.LP
158.131 -.B jarsigner
158.132 -は、エンティティの非公開鍵を使って署名を生成します。署名付き JAR ファイルには、
158.133 -キーストアからの証明書のコピーが含まれています。これは、JAR ファイルの署名に使わ
158.134 -れた非公開鍵に対応する公開鍵の証明書のコピーです。
158.135 -.B jarsigner
158.136 -は、署名付き JAR ファイルのデジタル署名を、ファイル内 (の署名ブロックファイル) に含
158.137 -まれている証明書を使って検証することができます。
158.138 -.LP
158.139 -J2SE 5.0 以降の \f3jarsigner\fP は、タイムスタンプを含む署名を生成できるようになりました。このため、システム/デプロイヤ (Java Plug\-in など) は、署名付きの証明書がまだ有効である期間中に JAR ファイルの署名が行われたかどうかを確認できます。さらに、そのタイムスタンプ情報をアプリケーションが取得するための API が、J2SE 5.0 で追加されました。
158.140 -.LP
158.141 -現時点では、
158.142 -.B jarsigner
158.143 -で署名できるのは、JDK の
158.144 -.B jar
158.145 -ツールで作成された JAR ファイル、または ZIP ファイルだけです。JAR ファイルは ZIP ファイルと同じですが、JAR ファイルには
158.146 -.B META-INF/MANIFEST.MF
158.147 -ファイルが含まれている点が異なります。
158.148 -.B META-INF/MANIFEST.MF
158.149 -ファイルは、
158.150 -.B jarsigner
158.151 -が ZIP ファイルに署名を付けるときに自動的に作成されます。
158.152 -.LP
158.153 -デフォルトでは、
158.154 -.B jarsigner
158.155 -は JAR ファイルに「署名」を付けます。
158.156 -署名付き JAR ファイルを「検証」する場合は、
158.157 -.I -verify
158.158 -オプションを指定します。
158.159 -.SS
158.160 -JDK 1.1 との互換性
158.161 -.LP
158.162 -.IX "jarsigner" "Compatibility with JDK 1.1" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.163 -.B keytool
158.164 -ツールと
158.165 -.B jarsigner
158.166 -ツールは、JDK 1.1 で提供されていた
158.167 -.B javakey
158.168 -ツールを完全に置き換えるものです。これらの新しいツールは
158.169 -.B javakey
158.170 -よりも多くの機能を備えており、キーストアと非公開鍵をパスワードで保護する機能や、
158.171 -署名の生成だけでなく署名を検証する機能を持っています。
158.172 -.LP
158.173 -新しいキーストアアーキテクチャは、
158.174 -.B javakey
158.175 -が作成して管理していたアイデンティティデータベースに代わるものです。キーストア形式と、JDK 1.1 の
158.176 -.B javakey
158.177 -が使っていたデータベース形式との間には下位互換性はありません。ただし、次のような
158.178 -ことは可能です。
158.179 -.TP 2
158.180 -\(bu
158.181 -.B keytool
158.182 -の
158.183 -.I -identitydb
158.184 -コマンドを使うと、アイデンティティデータベースの情報をキーストアにインポートできます。
158.185 -.TP 2
158.186 -\(bu
158.187
158.188 -.B jarsigner
158.189 -は、以前に
158.190 -.B javakey
158.191 -を使って署名された JAR ファイルに署名を付けることができます。
158.192 -.TP 2
158.193 -\(bu
158.194 -.B jarsigner
158.195 -は、
158.196 -.B javakey
158.197 -を使って署名された JAR ファイルを検証できます。したがって、
158.198 -.B jarsigner
158.199 -は、JDK 1.2 のキーストアではなく JDK 1.1 のアイデンティティデータベースからの署名者別
158.200 -名を認識し、これらを対象に処理を行うことができます。
158.201 -.LP
158.202 -次の表は、JDK 1.1.x で署名された JAR ファイルが、Java 2 プラットフォームでどのように扱われるかを
158.203 -示しています。
158.204 .LP
158.205 .nf
158.206 -.ft 3
158.207 - 1.1 データ
158.208 - 1.1 データ ベースから ポリシー
158.209 -JAR ベース内の 1.2 キース ファイル
158.210 -ファイル アイデン トアにイン がアイデン 与えられる
158.211 -のタイプ ティティ ポートされ ティティ/ 特権
158.212 - る信頼でき 別名に特権
158.213 - るアイデン を与える
158.214 - ティティ(4)
158.215 +\f3
158.216 +.fl
158.217 +\fP\f3jarsigner\fP [ options ] jar\-file alias
158.218 +.fl
158.219 +\f3jarsigner\fP \-verify [ options ] jar\-file
158.220 +.fl
158.221 +.fi
158.222
158.223 -署名付き すべてのコードに
158.224 -JAR x x x 与えられる
158.225 - デフォルトの
158.226 - 特権
158.227 -
158.228 -署名のない すべてのコードに
158.229 -JAR x x x 与えられる
158.230 - デフォルトの
158.231 - 特権
158.232 +.LP
158.233 +.SH "茯"
158.234 +.LP
158.235
158.236 -署名付き すべてのコードに
158.237 -JAR x ○ x 与えられる
158.238 - デフォルトの
158.239 - 特権
158.240 +.LP
158.241 +.LP
158.242 +\f3jarsigner\fP 若罨< 2 ゃт戎障
158.243 +.LP
158.244 +.RS 3
158.245 +.TP 3
158.246 +1.
158.247 +Java ARchive (JAR) <ゃ臀峨篁
158.248 +.TP 3
158.249 +2.
158.250 +臀峨篁 JAR <ゃ臀峨翫с罎荐若
158.251 +.RE
158.252
158.253 -署名付き すべてのコードに
158.254 -JAR ○/信頼で x x 与えられる
158.255 - きない デフォルトの
158.256 - 特権 (3)
158.257 +.LP
158.258 +.LP
158.259 +JAR 罘純篏帥鴻<ゃゃ<若吾泣潟潟篁吾帥若帥筝<ゃ宴若後сс<ゃ菴ゅ号絽с障肴jar(1) 若篏帥c JAR <ゃ篏с障茵荀括鴻荐違鴻 ZIP <ゃ JAR <ゃ帥с障 \f3jar\fP c篏 JAR <ゃ障 \f3jarsigner\fP c JAR <ゃMETA\-INF/MANIFEST.MF <ゃ障障
158.260 +.LP
158.261 +.LP
158.262 +吾帥臀峨若 (臀峨絲乗院若) 潟cc (篋冴篌腓障) 泣冴ャ荐膊с吾臀峨罕吾帥臀峨紊鴻障
158.263 +.LP
158.264 +.RS 3
158.265 +.TP 2
158.266 +o
158.267 +臀峨篏帥泣絲障泣篏帥c荐膊茵с吾帥臀峨罎荐若с
158.268 +.TP 2
158.269 +o
158.270 +泣篁篋冴ャ吾帥臀峨初筝純с
158.271 +.TP 2
158.272 +o
158.273 +吾帥臀峨臀峨篁若帥絲乗院с祉若帥臀峨罘純
158.274 +.TP 2
158.275 +o
158.276 +臀峨篁若帥紊眼с 若帥紊眼翫臀峨c若帥с罎荐若
158.277 +.RE
158.278
158.279 -署名付き すべてのコードに
158.280 -JAR ○/信頼で x ○ 与えられる
158.281 - きない デフォルトの
158.282 - 特権 (1,3)
158.283 -
158.284 -署名付き すべてのコードに
158.285 -JAR x ○ ○ 与えられる
158.286 - デフォルトの
158.287 - 特権とポリシー
158.288 - ファイル内
158.289 - で与えられる
158.290 - 特権
158.291 -
158.292 -署名付き すべてのコードに
158.293 -JAR ○/信頼 ○ ○ 与えられる
158.294 - できる デフォルトの
158.295 - 特権とポリシー
158.296 - ファイル内
158.297 - で与えられる
158.298 - 特権 (2)
158.299 -
158.300 -署名付き すべての
158.301 -JAR ○/信頼 x x 特権
158.302 - できる
158.303 -署名付き すべての
158.304 -JAR ○/信頼 ○ x 特権 (1)
158.305 - できる
158.306 -署名付き すべての
158.307 -JAR ○/信頼 x ○ 特権 (1)
158.308 - できる
158.309 -.fi
158.310 -.ft 1
158.311 .LP
158.312 -注:
158.313 -.TP 5
158.314 -1.
158.315 -ポリシーファイル内にアイデンティティ/別名についての言及がある場合、
158.316 -それをキーストアにインポートして、ポリシーファイルの設定が与えられた
158.317 -特権に反映されるようにする必要があります。
158.318 -.TP 5
158.319 -2.
158.320 -ポリシーファイル/キーストアの組み合わせは、アイデンティティデータベース
158.321 -内の信頼できるアイデンティティよりも優先されます。
158.322 -.TP 5
158.323 -3.
158.324 -Java 2 プラットフォームでは、信頼できないアイデンティティは無視されます。
158.325 -.TP 5
158.326 -4.
158.327 -JDK キーストアにインポートできるのは、信頼できるアイデンティティだけです。
158.328 -.SS
158.329 -キーストアの別名
158.330 .LP
158.331 -.IX "jarsigner" "Keystore Aliases" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.332 +<ゃ絲障潟cc若臀峨障潟cc若潟cc若∫c泣泣≪ゅ荀障 障泣茯荐若 1 ゃ障茲違荐惹吾綽荀с荐惹吾潟cc若肴吾帥臀峨篁吾сャ潟cc若泣劫ゃс荐惹障
158.333 .LP
158.334 -キーストアのすべてのエントリは、一意の「別名」を介してアクセスされます。
158.335 .LP
158.336 -.B jarsigner
158.337 -を使って JAR ファイルに署名を付けるときは、署名の生成に必要な非公開鍵を
158.338 -含むキーストアエントリの別名を指定する必要があります。たとえば、次の例は、
158.339 -working ディレクトリの
158.340 -.B mystore
158.341 -という名前のキーストアに含まれる別名
158.342 -.B duke
158.343 -に関連付けられた非公開鍵を使って、
158.344 -.BR MyJARFile.jar
158.345 -という名前の JAR ファイルに署名を付けます。出力ファイルは指定されていない
158.346 -ので、
158.347 -.BR MyJARFile.jar
158.348 -は署名付きの JAR ファイルによって上書きされます。
158.349 +\f3jarsigner\fP 若鴻≪障泣荐惹御宴篏帥cJAR <ゃ吾帥臀峨障若鴻≪泣泣∫d X.509 荐惹吾с若潟若帥若鴻с若鴻≪篏膊∞keytool(1) 若cc若篏帥障
158.350 .LP
158.351 -.ft 3
158.352 -.nf
158.353 -jarsigner -keystore /working/mystore -storepass
158.354 - myspass -keypass dukekeypasswd MyJARFile.jar duke
158.355 -.fi
158.356 -.ft 1
158.357 .LP
158.358 -キーストアはパスワードで保護されているので、ストアのパスワード (上の例では
158.359 -.BR myspass
158.360 -) を指定する必要があります。コマンド行でストアのパスワードを指定しなかった場合は、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているので、非公開鍵のパスワード (上の例では
158.361 -.BR dukekeypasswd
158.362 -) を指定する必要があります。コマンド行で非公開鍵のパスワードを指定しておらず、非公開鍵のパスワートがストアのパスワードと違っている場合は、非公開鍵のパスワードの入力を求められます。
158.363 +\f3jarsigner\fP 潟cc若泣篏帥c臀峨障臀峨篁 JAR <ゃ<ゃ臀峨篏睡泣絲上泣篆絖若鴻≪c荐惹吾潟若障障 \f3jarsigner\fP 臀峨篁 JAR <ゃ吾帥臀峨<ゃ (臀峨<ゃ) 障荐惹吾篏帥c罎荐若с障
158.364 +.LP
158.365 +.LP
158.366 +5.0 篁ラс\f3jarsigner\fP 帥ゃ鴻帥潟臀峨с激鴻ゃ (Java Plug\-in ) JAR <ゃ臀峨荐惹吾号筝臀峨сс障5.0 ц申 API 篏睡≪宴若激с潟帥ゃ鴻帥潟宴緇с障
158.367 +.LP
158.368 +.LP
158.369 +憝鴻с\f3jarsigner\fP х讐сJDK jar(1) 若т JAR <ゃ障 ZIP <ゃсJAR <ゃ ZIP <ゃсJAR <ゃ META\-INF/MANIFEST.MF <ゃ障鴻違障META\-INF/MANIFEST.MF <ゃ\f3jarsigner\fP ZIP <ゃ臀峨篁篏障
158.370 +.LP
158.371 +.LP
158.372 +с\f3jarsigner\fP JAR (障 ZIP) <ゃ臀峨篁障臀峨篁 JAR <ゃ罎荐若翫\f2\-verify\fP 激с潟絎障
158.373 .LP
158.374 .SS
158.375 -キーストアの場所
158.376 +JDK 1.1 篋
158.377 .LP
158.378 -.IX "jarsigner" "Keystore Location" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.379 +.RS 3
158.380 +
158.381 .LP
158.382 -.B jarsigner
158.383 -には、使用するキーストアの名前と場所を指定する
158.384 -.I -keystore
158.385 -オプションがあります。キーストアは、デフォルトではユーザのホームディレクトリの
158.386 -.I .keystore
158.387 -という名前のファイルに格納されます。ユーザのホームディレクトリは、
158.388 -.I user.home
158.389 -システムプロパティによって決まります。
158.390 .LP
158.391 -.I \-keystore
158.392 -オプションからの入力ストリームは
158.393 -.I KeyStore.load
158.394 -メソッドに渡されます。
158.395 -URL として NONE が指定された場合は、NULL ストリームが
158.396 -.I KeyStore.load
158.397 -メソッドに渡されます。キーストアがハードウェアトークンデバイス上にあるなど、
158.398 -ファイルベースでない場合は、
158.399 -.I NONE
158.400 -を指定してください。
158.401 +\f3keytool\fP 若 \f3jarsigner\fP 若JDK 1.1 ф箴 \f3javakey\fP 若絎臀с違若 \f3javakey\fP 紊罘純若鴻≪泣鴻若т茘激罘純臀峨臀峨罎荐若罘純c障
158.402 +.LP
158.403 +.LP
158.404 +違若鴻≪≪若c若\f3javakey\fP 篏膊∞≪ゃ潟cc若若帥若鴻篁cс若鴻√就綣JDK 1.1 \f3javakey\fP 篏帥c若帥若劫就綣筝篏篋с障罨<純с
158.405 +.LP
158.406 +.RS 3
158.407 +.TP 2
158.408 +o
158.409 +\f3keytool\fP \f2\-identitydb\fP 潟潟篏帥≪ゃ潟cc若若帥若鴻宴若鴻≪ゃ潟若с障
158.410 +.TP 2
158.411 +o
158.412 +\f3jarsigner\fP 篁ュ \f3javakey\fP 篏帥c臀峨 JAR <ゃ臀峨篁с障
158.413 +.TP 2
158.414 +o
158.415 +\f3jarsigner\fP \f3javakey\fP篏帥c臀峨 JAR <ゃ罎荐若с障cjarsigner Java 2 SDK 若鴻≪с JDK 1.1 ≪ゃ潟cc若若帥若鴻臀峨ュ茯茘絲乗院茵с障
158.416 +.RE
158.417 +
158.418 +.LP
158.419 +.LP
158.420 +罨<茵JDK 1.1.x х讐 JAR <ゃJava 2 若с宴腓冴障
158.421 +.LP
158.422 +.LP
158.423 +.TS
158.424 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
158.425 +.de 35
158.426 +.ps \n(.s
158.427 +.vs \n(.vu
158.428 +.in \n(.iu
158.429 +.if \n(.u .fi
158.430 +.if \n(.j .ad
158.431 +.if \n(.j=0 .na
158.432 +..
158.433 +.nf
158.434 +.nr #~ 0
158.435 +.if n .nr #~ 0.6n
158.436 +.ds #d .d
158.437 +.if \(ts\n(.z\(ts\(ts .ds #d nl
158.438 +.fc
158.439 +.nr 33 \n(.s
158.440 +.rm 80 81 82 83 84
158.441 +.nr 34 \n(.lu
158.442 +.eo
158.443 +.am 80
158.444 +.br
158.445 +.di a+
158.446 +.35
158.447 +.ft \n(.f
158.448 +.ll \n(34u*1u/6u
158.449 +.if \n(.l<\n(80 .ll \n(80u
158.450 +.in 0
158.451 +\f3JAR <ゃ帥ゃ\fP
158.452 +.br
158.453 +.di
158.454 +.nr a| \n(dn
158.455 +.nr a- \n(dl
158.456 +..
158.457 +.ec \
158.458 +.eo
158.459 +.am 81
158.460 +.br
158.461 +.di b+
158.462 +.35
158.463 +.ft \n(.f
158.464 +.ll \n(34u*1u/6u
158.465 +.if \n(.l<\n(81 .ll \n(81u
158.466 +.in 0
158.467 +\f31.1 若帥若劫≪ゃ潟cc\fP
158.468 +.br
158.469 +.di
158.470 +.nr b| \n(dn
158.471 +.nr b- \n(dl
158.472 +..
158.473 +.ec \
158.474 +.eo
158.475 +.am 82
158.476 +.br
158.477 +.di c+
158.478 +.35
158.479 +.ft \n(.f
158.480 +.ll \n(34u*1u/6u
158.481 +.if \n(.l<\n(82 .ll \n(82u
158.482 +.in 0
158.483 +\f31.1 若帥若鴻 Java 2 Platform 若鴻≪ゃ潟若篆♂若с≪ゃ潟cc (4)\fP
158.484 +.br
158.485 +.di
158.486 +.nr c| \n(dn
158.487 +.nr c- \n(dl
158.488 +..
158.489 +.ec \
158.490 +.eo
158.491 +.am 83
158.492 +.br
158.493 +.di d+
158.494 +.35
158.495 +.ft \n(.f
158.496 +.ll \n(34u*1u/6u
158.497 +.if \n(.l<\n(83 .ll \n(83u
158.498 +.in 0
158.499 +\f3激若<ゃ≪ゃ潟cc/ュ号┤筝\fP
158.500 +.br
158.501 +.di
158.502 +.nr d| \n(dn
158.503 +.nr d- \n(dl
158.504 +..
158.505 +.ec \
158.506 +.eo
158.507 +.am 84
158.508 +.br
158.509 +.di e+
158.510 +.35
158.511 +.ft \n(.f
158.512 +.ll \n(34u*1u/6u
158.513 +.if \n(.l<\n(84 .ll \n(84u
158.514 +.in 0
158.515 +鴻潟若筝号┤
158.516 +.br
158.517 +.di
158.518 +.nr e| \n(dn
158.519 +.nr e- \n(dl
158.520 +..
158.521 +.ec \
158.522 +.eo
158.523 +.am 84
158.524 +.br
158.525 +.di f+
158.526 +.35
158.527 +.ft \n(.f
158.528 +.ll \n(34u*1u/6u
158.529 +.if \n(.l<\n(84 .ll \n(84u
158.530 +.in 0
158.531 +鴻潟若筝号┤
158.532 +.br
158.533 +.di
158.534 +.nr f| \n(dn
158.535 +.nr f- \n(dl
158.536 +..
158.537 +.ec \
158.538 +.eo
158.539 +.am 84
158.540 +.br
158.541 +.di g+
158.542 +.35
158.543 +.ft \n(.f
158.544 +.ll \n(34u*1u/6u
158.545 +.if \n(.l<\n(84 .ll \n(84u
158.546 +.in 0
158.547 +鴻潟若筝号┤
158.548 +.br
158.549 +.di
158.550 +.nr g| \n(dn
158.551 +.nr g- \n(dl
158.552 +..
158.553 +.ec \
158.554 +.eo
158.555 +.am 81
158.556 +.br
158.557 +.di h+
158.558 +.35
158.559 +.ft \n(.f
158.560 +.ll \n(34u*1u/6u
158.561 +.if \n(.l<\n(81 .ll \n(81u
158.562 +.in 0
158.563 +/篆♂若с
158.564 +.br
158.565 +.di
158.566 +.nr h| \n(dn
158.567 +.nr h- \n(dl
158.568 +..
158.569 +.ec \
158.570 +.eo
158.571 +.am 84
158.572 +.br
158.573 +.di i+
158.574 +.35
158.575 +.ft \n(.f
158.576 +.ll \n(34u*1u/6u
158.577 +.if \n(.l<\n(84 .ll \n(84u
158.578 +.in 0
158.579 +鴻潟若筝号┤ (3)
158.580 +.br
158.581 +.di
158.582 +.nr i| \n(dn
158.583 +.nr i- \n(dl
158.584 +..
158.585 +.ec \
158.586 +.eo
158.587 +.am 81
158.588 +.br
158.589 +.di j+
158.590 +.35
158.591 +.ft \n(.f
158.592 +.ll \n(34u*1u/6u
158.593 +.if \n(.l<\n(81 .ll \n(81u
158.594 +.in 0
158.595 +/篆♂若с
158.596 +.br
158.597 +.di
158.598 +.nr j| \n(dn
158.599 +.nr j- \n(dl
158.600 +..
158.601 +.ec \
158.602 +.eo
158.603 +.am 84
158.604 +.br
158.605 +.di k+
158.606 +.35
158.607 +.ft \n(.f
158.608 +.ll \n(34u*1u/6u
158.609 +.if \n(.l<\n(84 .ll \n(84u
158.610 +.in 0
158.611 +鴻潟若筝号┤ (1,3)
158.612 +.br
158.613 +.di
158.614 +.nr k| \n(dn
158.615 +.nr k- \n(dl
158.616 +..
158.617 +.ec \
158.618 +.eo
158.619 +.am 84
158.620 +.br
158.621 +.di l+
158.622 +.35
158.623 +.ft \n(.f
158.624 +.ll \n(34u*1u/6u
158.625 +.if \n(.l<\n(84 .ll \n(84u
158.626 +.in 0
158.627 +鴻潟若筝号┤激若<ゃт号┤
158.628 +.br
158.629 +.di
158.630 +.nr l| \n(dn
158.631 +.nr l- \n(dl
158.632 +..
158.633 +.ec \
158.634 +.eo
158.635 +.am 84
158.636 +.br
158.637 +.di m+
158.638 +.35
158.639 +.ft \n(.f
158.640 +.ll \n(34u*1u/6u
158.641 +.if \n(.l<\n(84 .ll \n(84u
158.642 +.in 0
158.643 +鴻潟若筝号┤激若<ゃт号┤ (2)
158.644 +.br
158.645 +.di
158.646 +.nr m| \n(dn
158.647 +.nr m- \n(dl
158.648 +..
158.649 +.ec \
158.650 +.35
158.651 +.nf
158.652 +.ll \n(34u
158.653 +.nr 80 0
158.654 +.nr 38 \w臀峨篁 JAR
158.655 +.if \n(80<\n(38 .nr 80 \n(38
158.656 +.nr 38 \w臀峨 JAR
158.657 +.if \n(80<\n(38 .nr 80 \n(38
158.658 +.nr 38 \w臀峨篁 JAR
158.659 +.if \n(80<\n(38 .nr 80 \n(38
158.660 +.nr 38 \w臀峨篁 JAR
158.661 +.if \n(80<\n(38 .nr 80 \n(38
158.662 +.nr 38 \w臀峨篁 JAR
158.663 +.if \n(80<\n(38 .nr 80 \n(38
158.664 +.nr 38 \w臀峨篁 JAR
158.665 +.if \n(80<\n(38 .nr 80 \n(38
158.666 +.nr 38 \w臀峨篁 JAR
158.667 +.if \n(80<\n(38 .nr 80 \n(38
158.668 +.nr 38 \w臀峨篁 JAR
158.669 +.if \n(80<\n(38 .nr 80 \n(38
158.670 +.nr 38 \w臀峨篁 JAR
158.671 +.if \n(80<\n(38 .nr 80 \n(38
158.672 +.nr 38 \w臀峨篁 JAR
158.673 +.if \n(80<\n(38 .nr 80 \n(38
158.674 +.80
158.675 +.rm 80
158.676 +.nr 38 \n(a-
158.677 +.if \n(80<\n(38 .nr 80 \n(38
158.678 +.nr 81 0
158.679 +.nr 38 \w
158.680 +.if \n(81<\n(38 .nr 81 \n(38
158.681 +.nr 38 \w
158.682 +.if \n(81<\n(38 .nr 81 \n(38
158.683 +.nr 38 \w
158.684 +.if \n(81<\n(38 .nr 81 \n(38
158.685 +.nr 38 \w
158.686 +.if \n(81<\n(38 .nr 81 \n(38
158.687 +.nr 38 \w/篆♂若с
158.688 +.if \n(81<\n(38 .nr 81 \n(38
158.689 +.nr 38 \w/篆♂若с
158.690 +.if \n(81<\n(38 .nr 81 \n(38
158.691 +.nr 38 \w/篆♂若с
158.692 +.if \n(81<\n(38 .nr 81 \n(38
158.693 +.nr 38 \w/篆♂若с
158.694 +.if \n(81<\n(38 .nr 81 \n(38
158.695 +.81
158.696 +.rm 81
158.697 +.nr 38 \n(b-
158.698 +.if \n(81<\n(38 .nr 81 \n(38
158.699 +.nr 38 \n(h-
158.700 +.if \n(81<\n(38 .nr 81 \n(38
158.701 +.nr 38 \n(j-
158.702 +.if \n(81<\n(38 .nr 81 \n(38
158.703 +.nr 82 0
158.704 +.nr 38 \w
158.705 +.if \n(82<\n(38 .nr 82 \n(38
158.706 +.nr 38 \w
158.707 +.if \n(82<\n(38 .nr 82 \n(38
158.708 +.nr 38 \w
158.709 +.if \n(82<\n(38 .nr 82 \n(38
158.710 +.nr 38 \w
158.711 +.if \n(82<\n(38 .nr 82 \n(38
158.712 +.nr 38 \w
158.713 +.if \n(82<\n(38 .nr 82 \n(38
158.714 +.nr 38 \w
158.715 +.if \n(82<\n(38 .nr 82 \n(38
158.716 +.nr 38 \w
158.717 +.if \n(82<\n(38 .nr 82 \n(38
158.718 +.nr 38 \w
158.719 +.if \n(82<\n(38 .nr 82 \n(38
158.720 +.nr 38 \w
158.721 +.if \n(82<\n(38 .nr 82 \n(38
158.722 +.nr 38 \w
158.723 +.if \n(82<\n(38 .nr 82 \n(38
158.724 +.82
158.725 +.rm 82
158.726 +.nr 38 \n(c-
158.727 +.if \n(82<\n(38 .nr 82 \n(38
158.728 +.nr 83 0
158.729 +.nr 38 \w
158.730 +.if \n(83<\n(38 .nr 83 \n(38
158.731 +.nr 38 \w
158.732 +.if \n(83<\n(38 .nr 83 \n(38
158.733 +.nr 38 \w
158.734 +.if \n(83<\n(38 .nr 83 \n(38
158.735 +.nr 38 \w
158.736 +.if \n(83<\n(38 .nr 83 \n(38
158.737 +.nr 38 \w
158.738 +.if \n(83<\n(38 .nr 83 \n(38
158.739 +.nr 38 \w
158.740 +.if \n(83<\n(38 .nr 83 \n(38
158.741 +.nr 38 \w
158.742 +.if \n(83<\n(38 .nr 83 \n(38
158.743 +.nr 38 \w
158.744 +.if \n(83<\n(38 .nr 83 \n(38
158.745 +.nr 38 \w
158.746 +.if \n(83<\n(38 .nr 83 \n(38
158.747 +.nr 38 \w
158.748 +.if \n(83<\n(38 .nr 83 \n(38
158.749 +.83
158.750 +.rm 83
158.751 +.nr 38 \n(d-
158.752 +.if \n(83<\n(38 .nr 83 \n(38
158.753 +.nr 84 0
158.754 +.nr 38 \w\f3筝号┤\fP
158.755 +.if \n(84<\n(38 .nr 84 \n(38
158.756 +.nr 38 \w鴻号┤
158.757 +.if \n(84<\n(38 .nr 84 \n(38
158.758 +.nr 38 \w鴻号┤ (1)
158.759 +.if \n(84<\n(38 .nr 84 \n(38
158.760 +.nr 38 \w鴻号┤ (1)
158.761 +.if \n(84<\n(38 .nr 84 \n(38
158.762 +.84
158.763 +.rm 84
158.764 +.nr 38 \n(e-
158.765 +.if \n(84<\n(38 .nr 84 \n(38
158.766 +.nr 38 \n(f-
158.767 +.if \n(84<\n(38 .nr 84 \n(38
158.768 +.nr 38 \n(g-
158.769 +.if \n(84<\n(38 .nr 84 \n(38
158.770 +.nr 38 \n(i-
158.771 +.if \n(84<\n(38 .nr 84 \n(38
158.772 +.nr 38 \n(k-
158.773 +.if \n(84<\n(38 .nr 84 \n(38
158.774 +.nr 38 \n(l-
158.775 +.if \n(84<\n(38 .nr 84 \n(38
158.776 +.nr 38 \n(m-
158.777 +.if \n(84<\n(38 .nr 84 \n(38
158.778 +.35
158.779 +.nf
158.780 +.ll \n(34u
158.781 +.nr 38 1n
158.782 +.nr 79 0
158.783 +.nr 40 \n(79+(0*\n(38)
158.784 +.nr 80 +\n(40
158.785 +.nr 41 \n(80+(3*\n(38)
158.786 +.nr 81 +\n(41
158.787 +.nr 42 \n(81+(3*\n(38)
158.788 +.nr 82 +\n(42
158.789 +.nr 43 \n(82+(3*\n(38)
158.790 +.nr 83 +\n(43
158.791 +.nr 44 \n(83+(3*\n(38)
158.792 +.nr 84 +\n(44
158.793 +.nr TW \n(84
158.794 +.if t .if \n(TW>\n(.li .tm Table at line 186 file Input is too wide - \n(TW units
158.795 +.fc
158.796 +.nr #T 0-1
158.797 +.nr #a 0-1
158.798 +.eo
158.799 +.de T#
158.800 +.ds #d .d
158.801 +.if \(ts\n(.z\(ts\(ts .ds #d nl
158.802 +.mk ##
158.803 +.nr ## -1v
158.804 +.ls 1
158.805 +.ls
158.806 +..
158.807 +.ec
158.808 +.ne \n(a|u+\n(.Vu
158.809 +.ne \n(b|u+\n(.Vu
158.810 +.ne \n(c|u+\n(.Vu
158.811 +.ne \n(d|u+\n(.Vu
158.812 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
158.813 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
158.814 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
158.815 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
158.816 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.817 +.nr 31 \n(.f
158.818 +.nr 35 1m
158.819 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'\f3筝号┤\fP
158.820 +.mk ##
158.821 +.nr 31 \n(##
158.822 +.sp |\n(##u-1v
158.823 +.nr 37 \n(40u
158.824 +.in +\n(37u
158.825 +.a+
158.826 +.in -\n(37u
158.827 +.mk 32
158.828 +.if \n(32>\n(31 .nr 31 \n(32
158.829 +.sp |\n(##u-1v
158.830 +.nr 37 \n(41u
158.831 +.in +\n(37u
158.832 +.b+
158.833 +.in -\n(37u
158.834 +.mk 32
158.835 +.if \n(32>\n(31 .nr 31 \n(32
158.836 +.sp |\n(##u-1v
158.837 +.nr 37 \n(42u
158.838 +.in +\n(37u
158.839 +.c+
158.840 +.in -\n(37u
158.841 +.mk 32
158.842 +.if \n(32>\n(31 .nr 31 \n(32
158.843 +.sp |\n(##u-1v
158.844 +.nr 37 \n(43u
158.845 +.in +\n(37u
158.846 +.d+
158.847 +.in -\n(37u
158.848 +.mk 32
158.849 +.if \n(32>\n(31 .nr 31 \n(32
158.850 +.sp |\n(31u
158.851 +.ne \n(e|u+\n(.Vu
158.852 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
158.853 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.854 +.nr 31 \n(.f
158.855 +.nr 35 1m
158.856 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.857 +.mk ##
158.858 +.nr 31 \n(##
158.859 +.sp |\n(##u-1v
158.860 +.nr 37 \n(44u
158.861 +.in +\n(37u
158.862 +.e+
158.863 +.in -\n(37u
158.864 +.mk 32
158.865 +.if \n(32>\n(31 .nr 31 \n(32
158.866 +.sp |\n(31u
158.867 +.ne \n(f|u+\n(.Vu
158.868 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
158.869 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.870 +.nr 31 \n(.f
158.871 +.nr 35 1m
158.872 +\&\h'|\n(40u'臀峨 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.873 +.mk ##
158.874 +.nr 31 \n(##
158.875 +.sp |\n(##u-1v
158.876 +.nr 37 \n(44u
158.877 +.in +\n(37u
158.878 +.f+
158.879 +.in -\n(37u
158.880 +.mk 32
158.881 +.if \n(32>\n(31 .nr 31 \n(32
158.882 +.sp |\n(31u
158.883 +.ne \n(g|u+\n(.Vu
158.884 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
158.885 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.886 +.nr 31 \n(.f
158.887 +.nr 35 1m
158.888 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.889 +.mk ##
158.890 +.nr 31 \n(##
158.891 +.sp |\n(##u-1v
158.892 +.nr 37 \n(44u
158.893 +.in +\n(37u
158.894 +.g+
158.895 +.in -\n(37u
158.896 +.mk 32
158.897 +.if \n(32>\n(31 .nr 31 \n(32
158.898 +.sp |\n(31u
158.899 +.ne \n(h|u+\n(.Vu
158.900 +.ne \n(i|u+\n(.Vu
158.901 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
158.902 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
158.903 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.904 +.nr 31 \n(.f
158.905 +.nr 35 1m
158.906 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.907 +.mk ##
158.908 +.nr 31 \n(##
158.909 +.sp |\n(##u-1v
158.910 +.nr 37 \n(41u
158.911 +.in +\n(37u
158.912 +.h+
158.913 +.in -\n(37u
158.914 +.mk 32
158.915 +.if \n(32>\n(31 .nr 31 \n(32
158.916 +.sp |\n(##u-1v
158.917 +.nr 37 \n(44u
158.918 +.in +\n(37u
158.919 +.i+
158.920 +.in -\n(37u
158.921 +.mk 32
158.922 +.if \n(32>\n(31 .nr 31 \n(32
158.923 +.sp |\n(31u
158.924 +.ne \n(j|u+\n(.Vu
158.925 +.ne \n(k|u+\n(.Vu
158.926 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
158.927 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
158.928 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.929 +.nr 31 \n(.f
158.930 +.nr 35 1m
158.931 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.932 +.mk ##
158.933 +.nr 31 \n(##
158.934 +.sp |\n(##u-1v
158.935 +.nr 37 \n(41u
158.936 +.in +\n(37u
158.937 +.j+
158.938 +.in -\n(37u
158.939 +.mk 32
158.940 +.if \n(32>\n(31 .nr 31 \n(32
158.941 +.sp |\n(##u-1v
158.942 +.nr 37 \n(44u
158.943 +.in +\n(37u
158.944 +.k+
158.945 +.in -\n(37u
158.946 +.mk 32
158.947 +.if \n(32>\n(31 .nr 31 \n(32
158.948 +.sp |\n(31u
158.949 +.ne \n(l|u+\n(.Vu
158.950 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
158.951 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.952 +.nr 31 \n(.f
158.953 +.nr 35 1m
158.954 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.955 +.mk ##
158.956 +.nr 31 \n(##
158.957 +.sp |\n(##u-1v
158.958 +.nr 37 \n(44u
158.959 +.in +\n(37u
158.960 +.l+
158.961 +.in -\n(37u
158.962 +.mk 32
158.963 +.if \n(32>\n(31 .nr 31 \n(32
158.964 +.sp |\n(31u
158.965 +.ne \n(m|u+\n(.Vu
158.966 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
158.967 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.968 +.nr 31 \n(.f
158.969 +.nr 35 1m
158.970 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'
158.971 +.mk ##
158.972 +.nr 31 \n(##
158.973 +.sp |\n(##u-1v
158.974 +.nr 37 \n(44u
158.975 +.in +\n(37u
158.976 +.m+
158.977 +.in -\n(37u
158.978 +.mk 32
158.979 +.if \n(32>\n(31 .nr 31 \n(32
158.980 +.sp |\n(31u
158.981 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.982 +.nr 31 \n(.f
158.983 +.nr 35 1m
158.984 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤
158.985 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.986 +.nr 31 \n(.f
158.987 +.nr 35 1m
158.988 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
158.989 +.ta \n(80u \n(81u \n(82u \n(83u \n(84u
158.990 +.nr 31 \n(.f
158.991 +.nr 35 1m
158.992 +\&\h'|\n(40u'臀峨篁 JAR\h'|\n(41u'/篆♂若с\h'|\n(42u'\h'|\n(43u'\h'|\n(44u'鴻号┤ (1)
158.993 +.fc
158.994 +.nr T. 1
158.995 +.T# 1
158.996 +.35
158.997 +.rm a+
158.998 +.rm b+
158.999 +.rm c+
158.1000 +.rm d+
158.1001 +.rm e+
158.1002 +.rm f+
158.1003 +.rm g+
158.1004 +.rm h+
158.1005 +.rm i+
158.1006 +.rm j+
158.1007 +.rm k+
158.1008 +.rm l+
158.1009 +.rm m+
158.1010 +.TE
158.1011 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-50
158.1012 +
158.1013 +.LP
158.1014 +.LP
158.1015 +羈 \-
158.1016 +.LP
158.1017 +.RS 3
158.1018 +.TP 3
158.1019 +1.
158.1020 +激若<ゃ≪ゃ潟cc/ュゃ荐翫若鴻≪ゃ潟若激若<ゃ荐絎筝号┤綽荀障
158.1021 +.TP 3
158.1022 +2.
158.1023 +激若<ゃ/若鴻≪腟水≪ゃ潟cc若若帥若劫篆♂若с≪ゃ潟cc若障
158.1024 +.TP 3
158.1025 +3.
158.1026 +Java 2 若с篆♂若с≪ゃ潟cc若∴障
158.1027 +.TP 3
158.1028 +4.
158.1029 +Java 2 SDK 若鴻≪ゃ潟若с篆♂若с≪ゃ潟cc若с
158.1030 +.RE
158.1031 +
158.1032 +.LP
158.1033 .SS
158.1034 -キーストアの実装
158.1035 +若鴻≪ュ
158.1036 .LP
158.1037 -.IX "jarsigner" "Keystore Implementation" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.1038 +.RS 3
158.1039 +
158.1040 .LP
158.1041 -.I java.security
158.1042 -パッケージ内にある
158.1043 -.I KeyStore
158.1044 -クラス
158.1045 -では、キーストア内の情報にアクセスし、変更できるように
158.1046 -適切に定義されたインタフェースが提供されています。
158.1047 -このクラスは複数のさまざまな固定実装が可能で、
158.1048 -それぞれの実装は、特定の種類のキーストア用の固定実装です。
158.1049 .LP
158.1050 -現在、キーストアの実装を使用するものとして、keytool と
158.1051 -.BR jarsigner
158.1052 -の 2 つのコマンド行ツールと、
158.1053 -.BR policytool
158.1054 -という名前の 1 つの GUI ベースのツールがあります。
158.1055 -.I KeyStore
158.1056 -クラスは public として使用可能なので、JDK ユーザは
158.1057 -.B KeyStore
158.1058 -を使ってほかのセキュリティアプリケーションも作成できます。
158.1059 +若鴻≪鴻潟筝ュ篁≪祉鴻障
158.1060 .LP
158.1061 -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、
158.1062 -JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアを
158.1063 -ファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワード
158.1064 -によって保護され、キーストア全体の完全性も (非公開鍵とは別の) パスワードに
158.1065 -よって保護されます。
158.1066 .LP
158.1067 +\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁臀峨綽荀泣若鴻≪潟ュ絎綽荀障違罨<箴working c mystore 若鴻≪障ュ duke ∫d泣篏帥cMyJARFile.jar JAR <ゃ臀峨篁障阪<ゃ絎сMyJARFile.jar 臀峨篁 JAR <ゃc筝吾障
158.1068 +.LP
158.1069 +.nf
158.1070 +\f3
158.1071 +.fl
158.1072 + jarsigner \-keystore /working/mystore \-storepass myspass
158.1073 +.fl
158.1074 + \-keypass dukekeypasswd MyJARFile.jar duke
158.1075 +.fl
158.1076 +\fP
158.1077 +.fi
158.1078
158.1079 -キーストアの実装は、プロバイダベースです。具体的には、
158.1080 -.I KeyStore
158.1081 -クラスが提供するアプリケーションインタフェースは、Service Provider Interface (SPI)
158.1082 -という形で実装されています。つまり、対応する
158.1083 -.I KeystoreSpi
158.1084 -抽象クラス (これも
158.1085 -.I java.security
158.1086 -パッケージに含まれている) があり、このクラスが Service Provider Interface の
158.1087 -メソッドを定義しています。これらのメソッドは、「プロバイダ」が実装しなければなりま
158.1088 -せん。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービス
158.1089 -のサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合の
158.1090 -ことです。したがって、キーストアの実装を提供するには、「Java 暗号化アーキテク
158.1091 -チャ用プロバイダの実装方法」(http://java.sun.com/javase/6/docs/technotes/guides/security/HowToImplAProvider.html) のページで説明しているように、クライアントがプロバイダを実装し、
158.1092 -.I KeystoreSpi
158.1093 -サブクラスの実装を提供する必要があります。
158.1094 .LP
158.1095 -アプリケーションでは、
158.1096 -.I KeyStore
158.1097 -クラスが提供する
158.1098 -.B getInstance
158.1099 -ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの
158.1100 -実装を選択できます。キーストアのタイプは、キーストア情報の格納形式とデータ形式、
158.1101 -およびキーストア内の非公開鍵とキーストア自体の完全性を保護するために使われる
158.1102 -アルゴリズムを定義します。異なるタイプのキーストアの実装には、互いに互換性は
158.1103 -ありません。keytool、jarsigner、および policytool の各ツールは、
158.1104 -.B KeyStore
158.1105 -が提供する共通のアプリケーションインタフェースだけを使っているので、任意の
158.1106 -タイプのキーストアで使用できます。
158.1107 .LP
158.1108 -.B keytool
158.1109 -は、ファイルベースのキーストア実装に対して機能します。
158.1110 -.B keytool
158.1111 -は、コマンド行で渡されたキーストアの位置をファイル名として扱い、
158.1112 -.BR FileInputStream
158.1113 -に変換して、そこからキーストア情報をロードします。一方、
158.1114 -.B jarsigner
158.1115 -ツールおよび
158.1116 -.B policytool
158.1117 -ツールは、URL を使って指定することが可能な任意の位置にあるキーストアを
158.1118 -読み取ることができます。
158.1119 +若鴻≪鴻若т茘激с鴻≪鴻若 (筝箴с mypass) 絎綽荀障潟潟茵с鴻≪鴻若絎鴻若ュ羆障罕泣若鴻√с鴻若c篆茘激泣鴻若 (筝箴с dukekeypasswd) 絎綽荀障 潟潟茵ч泣鴻若絎障絎鴻若篆絖鴻若c翫泣鴻若ュ羆障
158.1120 .LP
158.1121 -.B jarsigner
158.1122 -と
158.1123 -.BR keytool
158.1124 -の場合、
158.1125 -.I -storetype
158.1126 -オプションを使ってコマンド行でキーストアのタイプを指定できます。
158.1127 -.BR policytool
158.1128 -の場合は、[Edit] メニューの [Change Keystore] コマンドを使ってキーストアの
158.1129 -タイプを指定できます。
158.1130 +.RE
158.1131 +.SS
158.1132 +若鴻≪贋
158.1133 .LP
158.1134 -キーストアのタイプを明示的に指定しない場合、
158.1135 -.B keytool
158.1136 -、
158.1137 -.B jarsigner
158.1138 -、および
158.1139 -.B policytool
158.1140 -の各ツールは、セキュリティプロパティファイル内で指定
158.1141 -された
158.1142 -.I keystore.type
158.1143 -プロパティの値に基づいてキーストアの実装を選択します。セキュリティプロパティファ
158.1144 -イルは、
158.1145 -.I java.security
158.1146 -という名前でセキュリティプロパティディレクトリ
158.1147 -.I java.home/lib/security
158.1148 -に置かれています。
158.1149 -.I java.home
158.1150 -は、JDK の実行環境ディレクトリです。(SDK 内の jre ディレクトリ
158.1151 -または Java Runtime Environment のトップレベルのディレクトリ)。
158.1152 +.RS 3
158.1153 +
158.1154 .LP
158.1155 -各ツールは、
158.1156 -.I keystore.type
158.1157 -の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが
158.1158 -見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的の
158.1159 -プロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
158.1160 .LP
158.1161 -.I KeyStore
158.1162 -クラスでは
158.1163 -.I getDefaultType
158.1164 -という名前の static メソッドが定義されており、アプリケーションとアプレットはこの
158.1165 -メソッドを使うことで
158.1166 -.I keystore.type
158.1167 -プロパティの値を取得できます。次のコードは、デフォルトのキーストアタイプ (
158.1168 -.I keystore.type
158.1169 -プロパティで指定されたタイプ) のインスタンスを生成します。
158.1170 +\f3jarsigner\fP 篏睡若鴻≪ URL 絎 \f2\-keystore\fP 激с潟障若鴻≪с若吟若若c \f2.keystore\fP <ゃ主障 若吟若若c\f2user.home\fP 激鴻c若c羆冴障障Solaris 激鴻翫\f2user.home\fP с若吟若若cc障
158.1171 +.LP
158.1172 +.LP
158.1173 +\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP <純羝<障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP <純羝<障\f2NONE\fP \f2KeyStore\fP <ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
158.1174 +.LP
158.1175 +.RE
158.1176 +.SS
158.1177 +若鴻≪絎茖
158.1178 +.LP
158.1179 +.RS 3
158.1180 +
158.1181 +.LP
158.1182 +.LP
158.1183 +\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
158.1184 +.LP
158.1185 +.LP
158.1186 +憜若鴻≪絎茖篏睡\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若障\f2KeyStore\fP public 篏睡純сJava 2 SDK 若吟若 KeyStore 篏帥c祉祉ャc若≪宴若激с潟篏с障
158.1187 +.LP
158.1188 +.LP
158.1189 +若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪<ゃ絎茖障絎茖с泣ャ鴻若c篆茘激若鴻√篏翫с (泣ャ) 鴻若c篆茘激障
158.1190 +.LP
158.1191 +.LP
158.1192 +若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface <純絎臂障 <純ゃ絎茖違障сゃJava Security API c≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сc若鴻≪絎茖箴
158.1193 +.na
158.1194 +\f2Java 垸≪若c主ゃ絎茖号\fP @
158.1195 +.fi
158.1196 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
158.1197 +.LP
158.1198 +.LP
158.1199 +≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance <<純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
158.1200 +.LP
158.1201 +.LP
158.1202 +\f3keytool\fP 篁紙<ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝<若鴻≪贋<ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
158.1203 +.LP
158.1204 +.LP
158.1205 +\f3jarsigner\fP \f3keytool\fP 翫\f2\-storetype\fP 激с潟篏帥c潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP 翫[Edit] <ャ若 [Change Keystore] 潟潟篏帥c若鴻≪帥ゃ絎с障
158.1206 +.LP
158.1207 +.LP
158.1208 +若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャc若c若<ゃф絎 \f2keystore.type\fP c若ゃ冴ャ若鴻≪絎茖御障祉ャc若c若<ゃ\f2java.security\fP SDK 祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
158.1209 +.LP
158.1210 +.LP
158.1211 +若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
158.1212 +.LP
158.1213 +.LP
158.1214 +\f2KeyStore\fP 鴻с \f2getDefaultType\fP static <純絎臂≪宴若激с潟≪<純篏帥 \f2keystore.type\fP c若ゃ緇с障罨<潟若若鴻≪帥ゃ (\f2keystore.type\fP c若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
158.1215 .LP
158.1216 .nf
158.1217 \f3
158.1218 @@ -435,144 +833,150 @@
158.1219
158.1220 .LP
158.1221 .LP
158.1222 -デフォルトのキーストアタイプは jks (Sun が提供する独自のタイプのキーストアの
158.1223 -実装) です。これは、セキュリティプロパティファイル内の次の行によって指定されて
158.1224 -います。
158.1225 +若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャc若c若<ゃ罨<茵c絎障
158.1226 .LP
158.1227 -.RS 5
158.1228 -.B keystore.type=jks
158.1229 +.nf
158.1230 +\f3
158.1231 +.fl
158.1232 + keystore.type=jks
158.1233 +.fl
158.1234 +\fP
158.1235 +.fi
158.1236 +
158.1237 +.LP
158.1238 +.LP
158.1239 +羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
158.1240 +.LP
158.1241 +.LP
158.1242 +若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨<紊眼障
158.1243 +.LP
158.1244 +.nf
158.1245 +\f3
158.1246 +.fl
158.1247 + keystore.type=pkcs12
158.1248 +.fl
158.1249 +\fP
158.1250 +.fi
158.1251 +
158.1252 +.LP
158.1253 +.LP
158.1254 +PKCS#11 ゃ宴若吾篏睡翫荅括完ゃJava PKCS#11 Reference Guide
158.1255 +.na
158.1256 +\f2KeyTool and JarSigner\fP @
158.1257 +.fi
158.1258 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner膀с
158.1259 +.LP
158.1260 .RE
158.1261 +.RE
158.1262 +.SS
158.1263 +泣若≪眼冴
158.1264 .LP
158.1265 -注: キーストアタイプの指定では、大文字と小文字は区別されません。たとえば、「JKS」と「jks」は同じものとみなされます。
158.1266 +.RS 3
158.1267 +
158.1268 .LP
158.1269 -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して
158.1270 -別のキーストアのタイプを指定します。
158.1271 -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供している
158.1272 -プロバイダパッケージを使用するには、上の行を次のように変更します。
158.1273 .LP
158.1274 -.B keystore.type=pkcs12
158.1275 +с\f3jarsigner\fP 罨<<≪眼冴篏帥c JAR <ゃ臀峨障
158.1276 .LP
158.1277 -PKCS#11 プロバイダパッケージを使用する場合、その詳細については、「Java PKCS#11 Reference Guide」(
158.1278 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#keytooljarsigner)
158.1279 -にある
158.1280 -「\f2KeyTool and JarSigner\fP」節を参照してください。
158.1281 +.RS 3
158.1282 +.TP 2
158.1283 +o
158.1284 +SHA\-1 ゃ吾с鴻≪眼冴篏帥c DSA (吾帥臀峨≪眼冴)
158.1285 +.TP 2
158.1286 +o
158.1287 +MD5 ゃ吾с鴻≪眼冴篏帥c RSA ≪眼冴
158.1288 +.RE
158.1289 +
158.1290 .LP
158.1291 +.LP
158.1292 +隙臀峨泣泣 DSA 泣с翫\f3jarsigner\fP SHA1withDSA ≪眼冴篏帥c JAR <ゃ臀峨篁障臀峨泣 RSA 泣с翫\f3jarsigner\fP MD5withRSA ≪眼冴篏帥c JAR <ゃ臀峨篁障
158.1293 +.LP
158.1294 +.LP
158.1295 +臀峨≪眼冴\f2\-sigalg\fP 激с潟篏帥c若若ゃс障
158.1296 +.LP
158.1297 +.RE
158.1298 .SS
158.1299 -サポートされるアルゴリズム
158.1300 +臀峨篁 JAR <ゃ
158.1301 .LP
158.1302 -.IX "jarsigner" "Supported Algorithms and Key Sizes" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.1303 +.RS 3
158.1304 +
158.1305 .LP
158.1306 -デフォルトでは、
158.1307 -.B jarsigner
158.1308 -は次のどちらかのアルゴリズムを使って JAR ファイルに署名します。
158.1309 +.LP
158.1310 +\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁翫阪臀峨篁 JAR <ゃュ JAR <ゃс罨< 2 ゃ菴遵<ゃ META\-INF c臀鴻違障
158.1311 +.LP
158.1312 +.RS 3
158.1313 .TP 2
158.1314 -\(bu
158.1315 -SHA-1 ダイジェストアルゴリズムを使った DSA (デジタル署名アルゴリズム)
158.1316 +o
158.1317 +.SF ≦宍絖篁臀峨<ゃ
158.1318 .TP 2
158.1319 -\(bu
158.1320 -MD5 ダイジェストアルゴリズムを使った RSA アルゴリズム
158.1321 +o
158.1322 +.DSA ≦宍絖篁臀峨<ゃ
158.1323 +.RE
158.1324 +
158.1325 .LP
158.1326 -具体的には、署名者の公開鍵と非公開鍵が DSA 鍵である場合、
158.1327 -.B jarsigner
158.1328 -は「SHA1withDSA」アルゴリズムを使って JAR ファイルに署名を付けようとします。署名者の
158.1329 -鍵が RSA 鍵である場合、
158.1330 -.B jarsigner
158.1331 -は「MD5withRSA」アルゴリズムを使って JAR ファイルに署名を付けます。
158.1332 .LP
158.1333 -これらのデフォルトの署名アルゴリズムは、\f2\-sigalg\fP オプションを使ってオーバーライドできます。
158.1334 + 2 ゃ<ゃ若鴻<ゃ\f2\-sigFile\fP 激с潟ゃ篏障違罨<激с潟絎障
158.1335 .LP
158.1336 +.nf
158.1337 +\f3
158.1338 +.fl
158.1339 + \-sigFile MKSIGN
158.1340 +.fl
158.1341 +\fP
158.1342 +.fi
158.1343 +
158.1344 +.LP
158.1345 +.LP
158.1346 +翫<ゃ MKSIGN.SF MKSIGN.DSA 障
158.1347 +.LP
158.1348 +.LP
158.1349 +潟潟茵 \f2\-sigfile\fP 激с潟絎c翫.SF <ゃ .DSA <ゃ若鴻<ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨<ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀<ゃ篏障篏睡с絖≪<医筝膩 (_)ゃ潟с
158.1350 +.LP
158.1351 +\f3臀峨 (.SF) <ゃ\fP
158.1352 +.LP
158.1353 +.RS 3
158.1354 +
158.1355 +.LP
158.1356 +.LP
158.1357 +臀峨<ゃ (.SF <ゃ) \f3jarsigner\fP х讐篁 JAR <ゃ絽吾障с鴻<ゃ篌若障ゃ障с鴻<ゃ罕.SF <ゃJAR <ゃ障純若鴻<ゃ罨< 3 ゃ茵障
158.1358 +.LP
158.1359 +.RS 3
158.1360 +.TP 2
158.1361 +o
158.1362 +<ゃ
158.1363 +.TP 2
158.1364 +o
158.1365 +篏帥ゃ吾с鴻≪眼冴 (SHA)
158.1366 +.TP 2
158.1367 +o
158.1368 +SHA ゃ吾с鴻
158.1369 +.RE
158.1370 +
158.1371 +.LP
158.1372 +.LP
158.1373 +с鴻<ゃсSHA ゃ吾с鴻ゃ純若鴻<ゃゃ若帥ゃ吾с鴻 (激) с筝鴻.SF <ゃс純若鴻<ゃゃ吾с鴻ゃс鴻<ゃ筝荅峨純若鴻<ゃ絲上 3 茵激ャс
158.1374 +.LP
158.1375 +.LP
158.1376 +臀峨<ゃсс鴻<ゃ篏激ャ障障緇菴違JAR <ゃ罎荐若ц若絖c罎荐若純c障
158.1377 +.LP
158.1378 +.RE
158.1379 +\f3臀峨 (.DSA) <ゃ\fP
158.1380 +.LP
158.1381 +.RS 3
158.1382 +
158.1383 +.LP
158.1384 +.LP
158.1385 +.SF <ゃ臀峨篁臀峨 .DSA <ゃ臀障.DSA <ゃ若鴻≪荐惹吾障荐惹吾с若潟膃垸綵≪у障障 荐惹吾障荐惹吾с若潟臀峨篏帥泣絲上泣茯荐若障
158.1386 +.LP
158.1387 +.RE
158.1388 +.RE
158.1389 .SS
158.1390 -署名付き JAR ファイル
158.1391 +臀峨帥ゃ鴻帥潟
158.1392 .LP
158.1393 -.IX "jarsigner" "The Signed JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.1394 +.RS 3
158.1395 +
158.1396 .LP
158.1397 -.B jarsigner
158.1398 -を使って JAR ファイルに署名を付けた場合、出力される署名付き JAR ファイルは
158.1399 -入力 JAR ファイルと同じですが、次の 2 つの追加ファイルが
158.1400 -.B META-INF
158.1401 -ディレクトリに置かれる点が異なります。
158.1402 -.TP 2
158.1403 -\(bu
158.1404 -.B .SF
158.1405 -拡張子の付いた署名ファイル
158.1406 -.TP 2
158.1407 -\(bu
158.1408 -.B .DSA
158.1409 -拡張子の付いた署名ブロックファイル
158.1410 .LP
158.1411 -これら 2 つのファイルのベースファイル名は、
158.1412 -.I -sigFile
158.1413 -オプションの値から作成されます。たとえば、次のようにオプションを指定したとします。
158.1414 -.LP
158.1415 -.B -sigFile MKSIGN
158.1416 -.LP
158.1417 -この場合、ファイル名はそれぞれ
158.1418 -.B MKSIGN.SF
158.1419 -と
158.1420 -.BR MKSIGN.DSA
158.1421 -になります。
158.1422 -.LP
158.1423 -コマンド行に
158.1424 -.I -sigfile
158.1425 -オプションの指定がない場合、
158.1426 -.B .SF
158.1427 -ファイルと
158.1428 -.B .DSA
158.1429 -ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字を
158.1430 -すべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名が
158.1431 -そのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれ
158.1432 -ている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
158.1433 -使用できる文字は、アルファベット、数字、下線 (_)、ハイフンです。
158.1434 -.LP
158.1435 -署名 (\f3.SF\f1) ファイル
158.1436 -.LP
158.1437 -署名ファイル (
158.1438 -.B .SF
158.1439 -ファイル) は、
158.1440 -.B jar
158.1441 -ツールで生成された JAR ファイルに常に含まれるマニフェストファイルと似ています。つまり、マニフェストファイル同様、
158.1442 -.B .SF
158.1443 -ファイルには、JAR ファイルに含まれているソースファイルごとに、次の 3 つの行があります。
158.1444 -.TP 2
158.1445 -\(bu
158.1446 -ファイル名
158.1447 -.TP 2
158.1448 -\(bu
158.1449 -使われているダイジェストアルゴリズム (SHA) の名前
158.1450 -.TP 2
158.1451 -\(bu
158.1452 -SHA ダイジェストの値
158.1453 -.LP
158.1454 -マニフェストファイルでは、SHA ダイジェストの値は、ソースファイルのバイナリデータ
158.1455 -のダイジェスト (ハッシュ) です。一方、
158.1456 -.B .SF
158.1457 -ファイルでは、ソースファイルのダイジェストの値は、マニフェストファイル中の該当する
158.1458 -ソースファイルに対応する 3 行のハッシュです。
158.1459 -.LP
158.1460 -署名ファイルには、デフォルトでマニフェストファイル全体のハッシュも含まれています。
158.1461 -後述の「JAR ファイルの検証」で説明するように、このヘッダの存在によって検証の
158.1462 -最適化が可能になっています。
158.1463 -.LP
158.1464 -署名ブロック (\f3.DSA\f1) ファイル
158.1465 -.LP
158.1466 -.B .SF
158.1467 -ファイルには署名が付けられ、署名は
158.1468 -.B .DSA
158.1469 -ファイルに置かれます。
158.1470 -.B .DSA
158.1471 -ファイルには、キーストアからの証明書または証明連鎖も符号化された形で含まれて
158.1472 -います。証明書または証明連鎖は、署名に使われた非公開鍵に対応する公開鍵を
158.1473 -認証します。
158.1474 -.LP
158.1475 -.SS
158.1476 -署名タイムスタンプ
158.1477 -.LP
158.1478 -.LP
158.1479 -J2SE 5.0 リリースの
158.1480 -.I jarsigner
158.1481 -ツールは、JAR ファイルの署名時に署名タイムスタンプを生成および格納できるようになりました。さらに、
158.1482 -.I jarsigner
158.1483 -は代替の署名機構もサポートします。この動作は省略可能で、署名時に次の各オプションによって制御されます。
158.1484 +J2SE 5.0 若鴻 \f2jarsigner\fP 若JAR <ゃ臀峨臀峨帥ゃ鴻帥潟恰主с障\f2jarsigner\fP 篁f睡讐罘罕泣若障篏ュ純с臀峨罨<激с潟c九勝障
158.1485 .LP
158.1486 .RS 3
158.1487 .TP 2
158.1488 @@ -591,204 +995,143 @@
158.1489
158.1490 .LP
158.1491 .LP
158.1492 -これらの各オプションの詳細については、後述の「オプション」節を参照してください。
158.1493 +激с潟荅括完ゃ緇菴違激с潟膀с
158.1494 .LP
158.1495 +.RE
158.1496 .SS
158.1497 -JAR ファイルの検証
158.1498 +JAR <ゃ罎荐
158.1499 .LP
158.1500 -.IX "jarsigner" "JAR File Verification" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.1501 +.RS 3
158.1502 +
158.1503 .LP
158.1504 -JAR ファイルの検証が成功するのは、署名が有効であり、かつ署名の生成以後に
158.1505 -JAR ファイル内のどのファイルも変更されていない場合です。JAR ファイルの検証は、次の手順で行われます。
158.1506 -.TP 5
158.1507 -1.
158.1508 -.B .SF
158.1509 -ファイルそれ自体の署名を検証します。
158.1510 -.RS
158.1511 .LP
158.1512 -この手順では、各署名ブロック (
158.1513 -.B .DSA
158.1514 -) ファイルに格納されている署名が、実際に、公開鍵に対応する非公開鍵を使って
158.1515 -生成されたものであることを確認します。
158.1516 -.B .DSA
158.1517 -ファイルには、公開鍵の証明書も含まれています。また、この手順
158.1518 -では、目的の署名が、対応する署名 (
158.1519 -.B .SF
158.1520 -) ファイル内の有効な署名であるかどうかを調べ、
158.1521 -.B .SF
158.1522 -ファイルが改変されていないことも確認します。
158.1523 -.RE
158.1524 -.TP 5
158.1525 -2.
158.1526 -.B .SF
158.1527 -ファイル内の各エントリのダイジェストをマニフェスト内の対応する各セクションと突き
158.1528 -合わせて検証します。
158.1529 -.RS
158.1530 -.LP
158.1531 -.B .SF
158.1532 -ファイルには、マニフェストファイル全体のハッシュが格納されたヘッダがデフォルトで
158.1533 -含まれています。このヘッダが存在する場合は、ヘッダ内のハッシュが実際にマニフェ
158.1534 -ストファイルのハッシュと一致するかどうかを検証することができます。ハッシュが一致す
158.1535 -る場合は、次の手順に進みます。
158.1536 -.LP
158.1537 -ハッシュが一致しない場合は、効率的には劣る方法を使って検証を行います。具体的
158.1538 -には、
158.1539 -.B .SF
158.1540 -ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の
158.1541 -対応するセクションのハッシュと一致するかどうかを確認します (「署名 (\f3.SF\f1)
158.1542 -ファイル」を参照)。
158.1543 -.LP
158.1544 -.B .SF
158.1545 -ファイルのヘッダに格納されたマニフェストファイルのハッシュと、実際のマニフェスト
158.1546 -ファイルのハッシュとが一致しない場合は、署名 (および
158.1547 -.B .SF
158.1548 -ファイル) の生成後に、ファイルに 1 つ以上のファイルが追加 (
158.1549 -.I jar
158.1550 -ツールを使用) された可能性があります。
158.1551 -.I jar
158.1552 -ツールを使ってファイルを追加した場合、マニフェストファイルは変更されますが
158.1553 -(新しいファイル用のセクションが追加される)、
158.1554 -.B .SF
158.1555 -ファイルは変更されません。この場合、
158.1556 -.B .SF
158.1557 -ファイルのヘッダ以外のセクションに格納されたハッシュが、マニフェストファイル内の
158.1558 -対応するセクションのハッシュと一致するときは、署名の生成時に JAR ファイル内に
158.1559 -存在していたファイルのうち、どのファイルも変更されていないことになり、検証は成功
158.1560 -したものとして扱われます。
158.1561 -.RE
158.1562 -.TP 5
158.1563 -3.
158.1564 -JAR ファイル内のファイルのうち、
158.1565 -.B .SF
158.1566 -ファイル内にエントリを持つ各ファイルを読み込みます。読み込み中にファイルの
158.1567 -ダイジェストを計算し、結果をマニフェストセクション内の該当するファイルの
158.1568 -ダイジェストと比較します。2 つのダイジェストは同じでなければならず、そうでない
158.1569 -場合は検証が失敗します。
158.1570 -.LP
158.1571 -検証プロセスの途中でなんらかの重大な検証エラーが発生した場合、検証プロセス
158.1572 -は中止され、セキュリティ例外がスローされます。スローされたセキュリティ例外は、
158.1573 -.BR jarsigner
158.1574 -がキャッチして表示します。
158.1575 -.LP
158.1576 -.SS
158.1577 -1 つの JAR ファイルを対象とする複数の署名
158.1578 -.LP
158.1579 -.IX "jarsigner" "Multiple Signatures for a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.1580 -.LP
158.1581 -1 つの JAR ファイルに対して
158.1582 -.B jarsigner
158.1583 -ツールを複数回実行し、実行のたびに、異なるユーザの別名を指定すれば、JAR
158.1584 -ファイルに複数のユーザの署名を付けることができます。たとえば、次のようにします。
158.1585 -.LP
158.1586 -.ft 3
158.1587 -.nf
158.1588 -jarsigner myBundle.jar susan
158.1589 -jarsigner myBundle.jar kevin
158.1590 -.fi
158.1591 -.ft 1
158.1592 -.LP
158.1593 -JAR ファイルが複数回署名されている場合、その JAR ファイルには
158.1594 -.B .SF
158.1595 -ファイルと
158.1596 -.B .DSA
158.1597 -ファイルの対が複数含まれることになります。
158.1598 -.B .SF
158.1599 -ファイルと
158.1600 -.B .DSA
158.1601 -ファイルの対は、1 回の署名に対して 1 つ作成されます。したがって、上の例で出力
158.1602 -される JAR ファイルには、次の名前を持つファイルが含まれます。
158.1603 -.LP
158.1604 -.ft 3
158.1605 -.nf
158.1606 -SUSAN.SF
158.1607 -SUSAN.DSA
158.1608 -KEVIN.SF
158.1609 -KEVIN.DSA
158.1610 -.fi
158.1611 -.ft 1
158.1612 -.LP
158.1613 -注: JDK 1.1 の
158.1614 -.B javakey
158.1615 -ツールで生成した署名と、
158.1616 -.B jarsigner
158.1617 -で生成した署名というように、
158.1618 -1 つの JAR ファイルに署名を混在させることができます。
158.1619 -つまり
158.1620 -.B javakey
158.1621 -ですでに以前署名した JAR ファイルに署名するために、
158.1622 -.B jarsigner
158.1623 -を使用できます。
158.1624 -.SH "オプション"
158.1625 -.LP
158.1626 -以下では、
158.1627 -.B jarsigner
158.1628 -のオプションについて説明します。オプションを指定するときは、次の点に注意
158.1629 -してください。
158.1630 -.TP 2
158.1631 -\(bu
158.1632 -どのオプション名にも先頭にマイナス記号 (-) が付く
158.1633 -.TP 2
158.1634 -\(bu
158.1635 -オプションは任意の順序で指定できる
158.1636 -.TP 2
158.1637 -\(bu
158.1638 -イタリック体の項目の実際の値 (オプションの値) は、ユーザが指定する必要がある
158.1639 -.TP 2
158.1640 -\(bu
158.1641 -.I -keystore、
158.1642 -.I -storepass、
158.1643 -.I -keypass、
158.1644 -.I -sigfile、
158.1645 -.I -sigalg、
158.1646 -.I -digestalg、
158.1647 -および
158.1648 -.I -signedjar
158.1649 -の各オプションを使用できるのは、JAR ファイルに署名を付ける場合だけである。
158.1650 -これらのオプションは、JAR ファイルを検証する場合には使用できない。同様に、
158.1651 -別名をコマンド行で指定するのは、JAR ファイルに署名を付ける場合だけである
158.1652 +JAR <ゃ罎荐若臀峨鴻сょ讐篁ュ JAR <ゃ<ゃ紊眼翫сJAR <ゃ罎荐若罨<ц障
158.1653 .LP
158.1654 .RS 3
158.1655 .TP 3
158.1656 -.B -keystore url
158.1657 -キーストアの場所を示す URL を指定します。デフォルトは、ユーザのホームディレクト
158.1658 -リ内のファイル
158.1659 -.I .keystore
158.1660 -です。ユーザのホームディレクトリは、
158.1661 -.I user.home
158.1662 -システムプロパティによって決まります。
158.1663 +1.
158.1664 +.SF <ゃ篏臀峨罎荐若障
158.1665 .LP
158.1666 -署名するときはキーストアが必要です。このため、デフォルトのキーストアが存在
158.1667 -しない場合、あるいはデフォルト以外のほかのキーストアを使用する場合は、
158.1668 -キーストアを明示的に指定する必要があります。
158.1669 +с臀峨 (.DSA) <ゃ主臀峨絎泣絲上泣篏帥cс腆肴障 .DSA <ゃ泣荐惹 (障荐惹吾с若) 障障障с臀峨絲上臀峨 (.SF) <ゃ鴻臀峨с茯帥鴻.SF <ゃ劫腆肴障
158.1670 +.TP 3
158.1671 +2.
158.1672 +.SF <ゃ潟ゃ吾с鴻с鴻絲上祉激с潟腦罎荐若障
158.1673 .LP
158.1674 -検証するときはキーストアは必要ありません。ただし、キーストアが指定されているか、
158.1675 -あるいはデフォルトのキーストアが存在していて、さらに
158.1676 -.I -verbose
158.1677 -オプションも指定されている場合は、JAR ファイルの検証に使われる証明書が
158.1678 -キーストアに存在するかどうかについての追加情報が出力されます。
158.1679 +.SF <ゃс鴻<ゃ篏激ャ主若у障障若絖翫弱激ャ絎с鴻<ゃ激ャ筝眼罎荐若с障激ャ筝眼翫罨<蚊帥障
158.1680 .LP
158.1681 -注:
158.1682 -.I -keystore
158.1683 -の引数には、URL の代わりにファイル名 (とパス) を指定できます。ファイル名
158.1684 -(とパス) を指定した場合は、「file:」URL として扱われます。たとえば、次のように
158.1685 -指定できます。
158.1686 +激ャ筝眼翫合c号篏帥c罎荐若茵障 隙.SF <ゃ純若鴻<ゃ宴祉激с潟激ャс鴻<ゃ絲上祉激с潟激ャ筝眼腆肴障 (臀峨 (.SF) <ゃ)
158.1687 .LP
158.1688 -.B -keystore filePathAndName
158.1689 +.SF <ゃ若主с鴻<ゃ激ャ絎с鴻<ゃ激ャ筝眼翫臀峨 ( .SF <ゃ) 緇JAR <ゃ 1 や札筝<ゃ菴遵 (\f2jar\fP 若篏睡) 醇с障\f2jar\fP 若篏帥c<ゃ菴遵翫с鴻<ゃ紊眼障 (違<ゃ祉激с潟菴遵).SF <ゃ紊眼障翫.SF <ゃ寂札紊祉激с潟主激ャс鴻<ゃ絲上祉激с潟激ャ筝眼臀峨 JAR <ゃ絖<ゃ<<ゃ紊眼罎荐若宴障
158.1690 +.TP 3
158.1691 +3.
158.1692 +JAR <ゃ<ゃ<.SF <ゃ潟ゅ<ゃ茯粋昭帥障茯粋昭推賢<ゃゃ吾с鴻荐膊腟с鴻祉激с喝荅峨<ゃゃ吾с鴻罸莠障2 ゃゃ吾с鴻с違с翫罎荐若紊掩障
158.1693 +.RE
158.1694 +
158.1695 .LP
158.1696 -これは、次の指定と同じものとして扱われます。
158.1697 .LP
158.1698 -.B -keystore file:filePathAndName
158.1699 +罎荐若祉鴻筝с紊с罎荐若若榊翫罎荐若祉鴻筝罩≪祉ャc寂紊鴻若障鴻若祉ャc寂紊\f3jarsigner\fP c茵腓冴障
158.1700 .LP
158.1701 +.RE
158.1702 +.SS
158.1703 +1 ゃ JAR <ゃ絲乗院茲違臀峨
158.1704 +.LP
158.1705 +.RS 3
158.1706 +
158.1707 +.LP
158.1708 +.LP
158.1709 +1 ゃ JAR <ゃ絲障 \f3jarsigner\fP 若茲医絎茵絎茵潟違若吟若ュ絎違JAR <ゃ茲違若吟若臀峨篁с障
158.1710 +.LP
158.1711 +.nf
158.1712 +\f3
158.1713 +.fl
158.1714 + jarsigner myBundle.jar susan
158.1715 +.fl
158.1716 + jarsigner myBundle.jar kevin
158.1717 +.fl
158.1718 \fP
158.1719 .fi
158.1720 -JRE の \f2$JAVA_HOME/lib/security\fP ディレクトリに格納された \f2java.security\fP セキュリティプロパティファイル内で Sun PKCS#11 プロバイダが設定されている場合、keytool と jarsigner は PKCS#11 トークンに基づいて動作できます。次のオプションを指定します。
158.1721 +
158.1722 +.LP
158.1723 +.LP
158.1724 +JAR <ゃ茲医臀峨翫 JAR <ゃ .SF <ゃ .DSA <ゃ絲障茲医障障 .SF <ゃ .DSA <ゃ絲障1 臀峨絲障 1 や障c筝箴у阪 JAR <ゃ罨<ゃ<ゃ障障
158.1725 +.LP
158.1726 +.nf
158.1727 +\f3
158.1728 +.fl
158.1729 + SUSAN.SF
158.1730 +.fl
158.1731 + SUSAN.DSA
158.1732 +.fl
158.1733 + KEVIN.SF
158.1734 +.fl
158.1735 + KEVIN.DSA
158.1736 +.fl
158.1737 +\fP
158.1738 +.fi
158.1739 +
158.1740 +.LP
158.1741 +.LP
158.1742 +羈:JAR <ゃсJDK 1.1 \f3javakey\fP 若х臀峨 \f3jarsigner\fP х臀峨羞桁с障ゃ障с \f3javakey\fP 篏帥c臀峨篁 JAR <ゃ\f3jarsigner\fP 篏帥c臀峨篁с障
158.1743 +.LP
158.1744 +.RE
158.1745 +.SH "激с"
158.1746 +.LP
158.1747 +
158.1748 +.LP
158.1749 +.LP
158.1750 +篁ヤс\f3jarsigner\fP 激с潟ゃ茯障羈:
158.1751 +.LP
158.1752 .RS 3
158.1753 .TP 2
158.1754 -o \f2\-keystore NONE\fP
158.1755 +o
158.1756 +激с喝ゃ壕 (\-) 篁
158.1757 .TP 2
158.1758 -o \f2\-storetype PKCS11\fP
158.1759 +o
158.1760 +激с潟篁紙綺ф絎с
158.1761 +.TP 2
158.1762 +o
158.1763 +ゃ帥篏絎 (激с潟) 若吟若絎綽荀
158.1764 +.TP 2
158.1765 +o
158.1766 +\f2\-keystore\fP\f2\-storepass\fP\f2\-keypass\fP\f2\-sigfile\fP\f2\-sigalg\fP\f2\-digestalg\fP \f2\-signedjar\fP 激с潟篏睡сJAR <ゃ臀峨篁翫с 激с潟JAR <ゃ罎荐若翫篏睡с罕ュ潟潟茵ф絎JAR <ゃ臀峨篁翫с
158.1767 .RE
158.1768 -たとえば、次のコマンドは、設定された PKCS#11 トークンの内容を一覧表示します。
158.1769 +
158.1770 +.LP
158.1771 +.RS 3
158.1772 +.TP 3
158.1773 +\-keystore url
158.1774 +若鴻≪贋腓冴 URL 絎障若吟若若c<ゃ \f2.keystore\fP с 若吟若若cuser.home 激鴻c若c羆冴障障
158.1775 +.LP
158.1776 +臀峨若鴻≪綽荀с 若鴻≪絖翫篁ュ祉若鴻≪篏睡翫若鴻≪腓榊絎綽荀障
158.1777 +.LP
158.1778 +罎荐若若鴻≪綽荀障 若鴻≪絎若鴻≪絖 \f2\-verbose\fP 激с潟絎翫JAR <ゃ罎荐若篏帥荐惹吾若鴻≪絖ゃ菴遵宴阪障
158.1779 +.LP
158.1780 +羈:\f2\-keystore\fP 綣違URL 篁c<ゃ () 絎с障 <ゃ () 絎翫file:URL 宴障違罨<絎с障
158.1781 +.nf
158.1782 +\f3
158.1783 +.fl
158.1784 + \-keystore \fP\f4filePathAndName\fP\f3
158.1785 +.fl
158.1786 +\fP
158.1787 +.fi
158.1788 +罨<絎宴障
158.1789 +.nf
158.1790 +\f3
158.1791 +.fl
158.1792 + \-keystore file:\fP\f4filePathAndName\fP\f3
158.1793 +.fl
158.1794 +\fP
158.1795 +.fi
158.1796 +JRE \f2$JAVA_HOME/lib/security\fP c主 \f2java.security\fP 祉ャc若c若<ゃ Sun PKCS#11 ゃ荐絎翫keytool jarsigner PKCS#11 若潟冴ャ篏с障 罨<激с潟絎障
158.1797 +.RS 3
158.1798 +.TP 2
158.1799 +o
158.1800 +\f2\-keystore NONE\fP
158.1801 +.TP 2
158.1802 +o
158.1803 +\f2\-storetype PKCS11\fP
158.1804 +.RE
158.1805 +違罨<潟潟荐絎 PKCS#11 若潟絎鴻筝荀ц;腓冴障
158.1806 .RS 3
158.1807
158.1808 .LP
158.1809 @@ -803,228 +1146,119 @@
158.1810 .fi
158.1811 .RE
158.1812 .TP 3
158.1813 -.B -storetype storetype
158.1814 -インスタンスを生成するキーストアのタイプを指定します。デフォルトのキーストアの
158.1815 -タイプは、セキュリティプロパティファイルで keystore.type プロパティの値として
158.1816 -指定されたタイプで、
158.1817 -.I java.security.KeyStore
158.1818 -の static
158.1819 -.I getDefaultType
158.1820 -メソッドによって返されます。
158.1821 +\-storetype storetype
158.1822 +ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障若鴻≪帥ゃ祉ャc若c若<ゃ keystore.type c若ゃф絎帥ゃс ゃ\f2java.security.KeyStore\fP static \f2getDefaultType\fP <純у緇с障
158.1823 .LP
158.1824 -\f2\-storepass\fP オプションを使って PCKS#11 トークンの PIN を指定することも
158.1825 -できます。何も指定しなかった場合、keytool と jarsigner はユーザにトークン PIN の
158.1826 -入力を求めます。トークンの認証パスが、専用の PIN パッドやバイオメトリックリーダの
158.1827 -ような保護されたパスである場合、\f2\-protected\fP オプションを指定する必要があります。
158.1828 -この場合、パスワードオプションは指定できません。
158.1829 -.TP
158.1830 -.B -storepass password
158.1831 -キーストアにアクセスするのに必要なパスワードを指定します。このオプションが必要
158.1832 -なのは、JAR ファイルに署名を付けるときだけです (JAR ファイルを検証するときは
158.1833 -不要)。署名を付けるときに、コマンド行で
158.1834 -.I -storepass
158.1835 -オプションを指定しなかった場合は、パスワードの入力を求められます。
158.1836 -.RS
158.1837 +\f2\-storepass\fP 激с潟篏帥c PCKS#11 若潟 PIN 絎с障篏絎c翫keytool jarsigner 若吟若若 PIN ュ羆障若潟篆茘激茯荐若 (絨 PIN 篏茯水罘) 翫\f2\-protected\fP 激с潟絎綽荀障鴻若激с潟絎綽荀障
158.1838 +.TP 3
158.1839 +\-storepass password
158.1840 +若鴻≪≪祉鴻綽荀鴻若絎障激с潟綽荀JAR <ゃ臀峨篁с (JAR <ゃ罎荐若筝荀)臀峨篁潟潟茵 \f2\-storepass\fP 激с潟絎c翫鴻若ュ羆障
158.1841 .LP
158.1842 -注: テストを目的とする場合、または安全が保障されたシステムで実行する場合
158.1843 -以外は、コマンド行やスクリプトでパスワードを指定しないでください。また、
158.1844 -password プロンプトでパスワードを入力すると、入力したパスワードがエコーされ、
158.1845 -そのまま画面に表示されます。このため、周囲にほかのユーザがいる場合は、
158.1846 -パスワードを見られないように注意してください。
158.1847 -.RE
158.1848 -.TP
158.1849 -.B -keypass password
158.1850 -コマンド行で指定された別名に対応するキーストアエントリの非公開鍵を保護するの
158.1851 -に使うパスワードを指定します。
158.1852 -.B jarsigner
158.1853 -を使って JAR ファイルに署名を付けるときは、パスワードが必要です。コマンド行で
158.1854 -パスワードが指定されておらず、必要なパスワードがストアのパスワードと異なる
158.1855 -場合は、パスワードの入力を求められます。
158.1856 -.RS
158.1857 +羈:鴻翫障祉ャc寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
158.1858 +.TP 3
158.1859 +\-keypass password
158.1860 +潟潟茵ф絎ュ絲上若鴻≪潟泣篆茘激篏帥鴻若絎障\f3jarsigner\fP 篏帥c JAR <ゃ臀峨篁鴻若綽荀с潟潟茵с鴻若絎綽荀鴻若鴻≪鴻若違翫鴻若ュ羆障
158.1861 .LP
158.1862 -注: テストを目的とする場合、または安全であることがわかっているシステムで
158.1863 -実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
158.1864 -また、password プロンプトでパスワードを入力すると、入力したパスワードがエコー
158.1865 -され、そのまま画面に表示されます。このため、周囲にほかのユーザがいる場合は、
158.1866 -パスワードを見られないように注意してください。
158.1867 -.RE
158.1868 -.TP
158.1869 -.B -sigfile file
158.1870 -SF ファイルと .DSA ファイルの生成に使うベースファイル名を指定します。
158.1871 -たとえば、file に DUKESIGN を指定すると、生成される .SF ファイルと
158.1872 -.DSA ファイルの名前は、それぞれ DUKESIGN.SF と DUKESIGN.DSA になります。
158.1873 -これらのファイルは、署名付き JAR ファイルの META-INF ディレクトリに置かれます。
158.1874 -.RS
158.1875 +羈:鴻翫障祉ャc寂茘激激鴻篏睡翫篁ュ潟潟茵鴻с鴻若絎с障password 潟с鴻若ュュ鴻若潟若障丞脂≪茵腓冴障 蚊祉若吟若翫鴻若荀羈
158.1876 +.TP 3
158.1877 +\-sigfile file
158.1878 +.SF <ゃ .DSA <ゃ篏帥若鴻<ゃ絎障違\f2file\fP DUKESIGN 絎 .SF <ゃ .DSA <ゃ DUKESIGN.SF DUKESIGN.DSA 障 <ゃ臀峨篁 JAR <ゃ META\-INF c臀障
158.1879 .LP
158.1880 -.I file
158.1881 -に使用できる文字は「a-zA-Z0-9_-」です。つまり、文字、数字、下線、
158.1882 -およびハイフンだけを使用できます。注:
158.1883 -.B .SF
158.1884 -および
158.1885 -.B .DSA
158.1886 -のファイル名では、小文字はすべて大文字に変換されます。
158.1887 +\f2file\fP 篏睡с絖a\-zA\-Z0\-9_\-сゃ障絖医筝膩潟ゃ潟篏睡с障羈:.SF .DSA <ゃс絨絖鴻紊ф絖紊障
158.1888 .LP
158.1889 -コマンド行で
158.1890 -.I -sigfile
158.1891 -オプションを指定しなかった場合、
158.1892 -.B .SF
158.1893 -ファイルと
158.1894 -.B .DSA
158.1895 -ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字を
158.1896 -すべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名が
158.1897 -そのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている
158.1898 -場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
158.1899 +潟潟茵 \f2\-sigfile\fP 激с潟絎c翫.SF <ゃ .DSA <ゃ若鴻<ゃ潟潟茵ф絎ュ 8 絖鴻紊ф絖紊障ュ 8 絖羣翫ュ障鞘戎障ュ筝臀峨<ゃ篏睡с絖障翫荅峨絖筝膩 (_) 臀<ゃ篏障
158.1900 .TP 3
158.1901 -\-sigalg algorithm
158.1902 +\-sigalg algorithm
158.1903 .RS 3
158.1904
158.1905 .LP
158.1906 -JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。
158.1907 +JAR <ゃ臀峨篏睡臀峨≪眼冴絎障
158.1908 .LP
158.1909 -標準署名アルゴリズム名の一覧については、「Java Cryptography Architecture」(
158.1910 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa)
158.1911 -にある
158.1912 -「
158.1913 -.I Appendix A
158.1914 -」を参照してください。このアルゴリズムは、JAR ファイルの署名に使用する秘密鍵と互換性のあるものでなければなりません。このオプションを指定しなかった場合、秘密鍵のタイプに応じて SHA1withDSA、MD5withRSA のいずれかが使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザがそのようなプロバイダを
158.1915 -.I \-providerClass
158.1916 -オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
158.1917 +罔羣臀峨≪眼冴筝荀сゃJava Cryptography Architecture
158.1918 +.na
158.1919 +\f2Appendix A \fP @
158.1920 +.fi
158.1921 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс≪眼冴JAR <ゃ臀峨篏睡腱絲泣篋сс違障激с潟絎c翫腱絲泣帥ゃ綽 SHA1withDSAMD5withRSA 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥c絎綽荀障 с翫潟潟絎茵紊掩障
158.1922 .LP
158.1923 .RE
158.1924 .TP 3
158.1925 -\-digestalg algorithm
158.1926 +\-digestalg algorithm
158.1927 .RS 3
158.1928 -JAR ファイルのエントリをダイジェストする際に使用するメッセージダイジェストアルゴリズムの名前を指定します。
158.1929 +JAR <ゃ潟ゃ吾с鴻篏睡<祉若吾ゃ吾с鴻≪眼冴絎障
158.1930 .LP
158.1931 -標準メッセージダイジェストアルゴリズム名の一覧については、「Java Cryptography Architecture」(http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa)の
158.1932 -「
158.1933 -.I Appendix A
158.1934 -」を参照してください。このオプションを指定しなかった場合、SHA\-1 が使用されます。指定されたアルゴリズムの実装を提供するプロバイダが静的にインストールされているか、あるいはユーザがそのようなプロバイダを
158.1935 -.I \-providerClass
158.1936 -オプションを使って指定する必要があります。そうでない場合、コマンドの実行が失敗します。
158.1937 +罔羣<祉若吾ゃ吾с鴻≪眼冴筝荀сゃJava Cryptography Architecture
158.1938 +.na
158.1939 +\f2Appendix A \fP @
158.1940 +.fi
158.1941 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс激с潟絎c翫SHA\-1 篏睡障絎≪眼冴絎茖箴ゃゃ潟鴻若若吟若ゃ \f2\-providerClass\fP 激с潟篏帥c絎綽荀障 с翫潟潟絎茵紊掩障
158.1942 +.LP
158.1943 .RE
158.1944 -.TP
158.1945 -.B -signedjar file
158.1946 -署名付き JAR ファイルの名前を指定します。
158.1947 -.RS
158.1948 +.TP 3
158.1949 +\-signedjar file
158.1950 +臀峨篁 JAR <ゃ絎障
158.1951 .LP
158.1952 -コマンド行で名前を指定しなかった場合は、入力 JAR ファイル (署名の対象となる
158.1953 -JAR ファイル) の名前と同じ名前が使われます。この場合、入力 JAR ファイルは署名
158.1954 -付き JAR ファイルによって上書きされます。
158.1955 +潟潟茵у絎c翫ュ JAR <ゃ (臀峨絲乗院 JAR <ゃ) 篏帥障 翫ュ JAR <ゃ臀峨篁 JAR <ゃc筝吾障
158.1956 +.TP 3
158.1957 +\-verify
158.1958 +潟潟茵с激с潟絎翫絎 JAR <ゃ罎荐若障JAR <ゃ吾臀峨茵障 罎荐若jar 罎荐若障 <祉若吾茵腓冴障臀峨 JAR <ゃ障泣若≪眼冴 (RSA ゃゃ潟鴻若腟篋翫 RSA ) 篏帥c臀峨 JAR <ゃ罎荐若jar 臀峨障(臀峨荀ゃ罕茹fс障)<祉若吾茵腓冴障
158.1959 +.LP
158.1960 +臀峨篁 JAR <ゃ\f3jarsigner\fP 障 JDK 1.1 \f3javakey\fP 若筝≧鴻篏帥c罎荐若с障
158.1961 +.LP
158.1962 +罎荐若ゃ荅括完JAR <ゃ罎荐若с
158.1963 +.TP 3
158.1964 +\-certs
158.1965 +潟潟茵с\f2\-verify\fP \f2\-verbose\fP 激с潟激с潟絎翫JAR <ゃ臀峨荐惹御宴阪障荐惹御宴罨<障障
158.1966 +.RS 3
158.1967 +.TP 2
158.1968 +o
158.1969 +臀峨泣荐惹 (.DSA <ゃ主) 荐惹吾腮蕁
158.1970 +.TP 2
158.1971 +o
158.1972 +荐惹吾 X.509 荐惹 (ゃ障\f2java.security.cert.X509Certificate\fP ゃ潟鴻帥潟) с翫臀峨茘ュ
158.1973 .RE
158.1974 -.TP
158.1975 -.B -verify
158.1976 -コマンド行でこのオプションが指定されている場合は、指定された JAR ファイルが
158.1977 -検証されます。JAR ファイルへの署名は行われません。検証が成功すると、
158.1978 -「jar verified」というメッセージが表示されます。署名されていない JAR ファイル、
158.1979 -またはサポートされていないアルゴリズム (RSA プロバイダがインストールされていない
158.1980 -場合の RSA など) を使って署名された JAR ファイルを検証しようとすると、
158.1981 -「jar is unsigned. (signatures missing or not parsable)」というメッセージが表示されます。
158.1982 -.RS
158.1983 .LP
158.1984 -署名付き JAR ファイルは、
158.1985 -.B jarsigner
158.1986 -または JDK 1.1 の
158.1987 -.B javakey
158.1988 -ツール、あるいはその両方を使って検証できます。
158.1989 +若鴻≪腆肴茵障潟潟茵с若鴻≪ゃ絎翫若鴻≪<ゃ違罎祉障臀峨泣荐惹吾若鴻√潟筝眼翫罨<宴茵腓冴障
158.1990 +.RS 3
158.1991 +.TP 2
158.1992 +o
158.1993 +臀峨荅峨若鴻≪潟ュ ュ綣су蚊障障若鴻≪с JDK 1.1 ≪ゃ潟cc若若帥若鴻掩ャ臀峨翫綣сс鎀ф綣су蚊障障
158.1994 +.RE
158.1995 +.TP 3
158.1996 +\-verbose
158.1997 +潟潟茵с激с潟絎翫\f3jarsigner\fP 激≪若у篏JAR 臀峨障罎荐若画倶≪菴遵宴阪障
158.1998 +.TP 3
158.1999 +\-internalsf
158.2000 +篁ュJAR <ゃ臀峨 .DSA (臀峨) <ゃ筝 .SF <ゃ (臀峨<ゃ) 絎潟若膃垸綵≪у障障篏紊眼障篏紊眼憜с阪 JAR <ゃ篏泣ゃ冴絨с .SF <ゃ .DSA <ゃ障c障潟潟茵 \f2\-internalsf\fP 激с潟絎篁ュ篏障\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
158.2001 +.TP 3
158.2002 +\-sectionsonly
158.2003 +潟潟茵с激с潟絎翫JAR <ゃ臀峨 .SF <ゃ (臀峨<ゃ) с鴻<ゃ篏激ャ若菴遵障翫.SF <ゃ障JAR <ゃ純若鴻<ゃ≪宴潟激ャс 荅括完臀峨 (.SF) <ゃс
158.2004 .LP
158.2005 -検証についての詳細は、「JAR ファイルの検証」を参照してください。
158.2006 +с茵с鴻<ゃ篏激ャ若菴遵障若絖翫JAR <ゃ罎荐惹障弱激ャс鴻<ゃ篏激ャ絎筝眼腆肴障激ャ筝眼翫罎荐若罨<蚊帥障激ャ筝眼翫合c号篏帥c罎荐若茵障 隙.SF <ゃ純若鴻<ゃ宴祉激с潟激ャс鴻<ゃ絲上祉激с潟激ャ筝眼腆肴障
158.2007 +.LP
158.2008 +荅括完JAR <ゃ罎荐若с
158.2009 +.LP
158.2010 +\f3激с潟鴻茵翫箴水с篁ュ篏睡с 激с潟篏睡茵障\fP
158.2011 +.TP 3
158.2012 +\-protected
158.2013 +\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
158.2014 .RE
158.2015 -.TP
158.2016 -.B -certs
158.2017 -コマンド行で、
158.2018 -.I -verify
158.2019 -および
158.2020 -.I -verbose
158.2021 -オプションとともにこのオプションが指定されている場合は、JAR ファイルの各署名者
158.2022 -の証明書情報も出力されます。証明書情報には次のものが含まれます。
158.2023 -.RS
158.2024 -.TP 2
158.2025 -\(bu
158.2026 -署名者の公開鍵を証明する (
158.2027 -.B .DSA
158.2028 -ファイルに格納された) 証明書の種類の名前
158.2029 -.TP 2
158.2030 -\(bu
158.2031 -証明書が X.509 証明書 (具体的には
158.2032 -.I java.security.cert.X509Certificate
158.2033 -のインスタンス) である場合は、署名者の識別名
158.2034 +.RS 3
158.2035 +.TP 3
158.2036 +\-provider provider\-class\-name
158.2037 +泣若鴻ゃ祉ャc若c若<ゃ (\f2java.security\fP) 鴻ャc垸泣若鴻ゃ鴻帥若鴻<ゃ絎障
158.2038 .LP
158.2039 -キーストアの確認も行われます。コマンド行でキーストアの値が指定されていない
158.2040 -場合、デフォルトのキーストアファイルがあれば、それが確認されます。署名者の
158.2041 -公開鍵の証明書がキーストア内のエントリと一致した場合は、次の情報も表示
158.2042 -されます。
158.2043 -.TP 2
158.2044 -\(bu
158.2045 -署名者に該当するキーストアエントリの別名。この別名は括弧で囲まれます。
158.2046 -ただし、キーストアではなく JDK 1.1 のアイデンティティデータベースに由来する
158.2047 -署名者の場合は、括弧ではなく角括弧で囲まれます。
158.2048 -.RE
158.2049 -.TP
158.2050 -.B -verbose
158.2051 -コマンド行でこのオプションが指定されている場合、
158.2052 -.B jarsigner
158.2053 -は「冗長」モードで動作し、JAR の署名または検証の進行状況に関する追加情報を出
158.2054 -力します。
158.2055 -.TP
158.2056 -.B -internalsf
158.2057 -以前は、JAR ファイルの署名時に生成された
158.2058 -.B .DSA
158.2059 -(署名ブロック) ファイルの中に、生成された
158.2060 -.B .SF
158.2061 -ファイル (署名ファイル) の完全なコピーが符号化された形で含まれていました。この
158.2062 -動作は変更になり、現在では、出力 JAR ファイル全体のサイズを小さくするために、
158.2063 -デフォルトでは
158.2064 -.B .SF
158.2065 -ファイルが
158.2066 -.B .DSA
158.2067 -ファイルに含まれないようになっています。ただし、コマンド行で
158.2068 -.B -internalsf
158.2069 -オプションを指定すると、以前と同じように動作します。このオプションは、テストを行う
158.2070 -場合には便利ですが、それ以外には使用しないでください。このオプションを使用する
158.2071 -と、有益な最適化が行われなくなります。
158.2072 -.TP
158.2073 -.B -sectionsonly
158.2074 -コマンド行でこのオプションが指定されている場合、JAR ファイルの署名時に生成される
158.2075 -.B .SF
158.2076 -ファイル (署名ファイル) には、マニフェストファイル全体のハッシュを含むヘッダは追加されません。この場合、.SF ファイルに含まれるのは、JAR ファイル内の各ソースファイルに関する情報およびハッシュだけです。詳細は、「署名 (\f3.SF\f1) ファイル」を参照してください。
158.2077 -.RS
158.2078 -.LP
158.2079 -デフォルトでは、最適化を行うために、マニフェストファイル全体のハッシュを含むヘッダ
158.2080 -が追加されます。ヘッダが存在する場合は、JAR ファイルの検証時に、まずヘッダ内
158.2081 -のハッシュが、マニフェストファイル全体のハッシュと実際に一致するかどうかが確認
158.2082 -されます。ハッシュが一致する場合、検証は次の手順に進みます。ハッシュが一致
158.2083 -しない場合は、効率的には劣る方法を使って検証を行います。具体的には、
158.2084 -.B .SF
158.2085 -ファイル内の各ソースファイル情報セクションのハッシュが、マニフェストファイル内の
158.2086 -対応するセクションのハッシュと一致するかどうかを確認します。
158.2087 -.LP
158.2088 -詳細は、「JAR ファイルの検証」を参照してください。
158.2089 -.LP
158.2090 -このオプションは、テストを行う場合には便利ですが、それ以外には使用しないで
158.2091 -ください。このオプションを使用すると、有益な最適化が行われなくなります。
158.2092 -.TP
158.2093 -.B -protected
158.2094 -\f2true\fP、\f2false\fP のいずれか。専用 PIN リーダなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
158.2095 -.RE
158.2096 -.TP
158.2097 -.B \-provider provider_class_name
158.2098 -サービスプロバイダがセキュリティプロパティファイル (\f2java.security\fP) のリストに
158.2099 -入っていないときに、暗号化サービスプロバイダのマスタークラスファイルの
158.2100 -名前を指定します。
158.2101 -.LP
158.2102 -\f2\-providerArg\fP \f2ConfigFilePath\fP オプションと組み合わせて使用します。keytool と jarsigner はプロバイダを動的にインストールします (ここで、\f2ConfigFilePath\fP はトークン設定ファイルへのパスです)。セキュリティプロパティファイル内で Sun PKCS#11 プロバイダが設定されていない場合に PKCS#11 キーストアを一覧表示するコマンドの例を次に示します。
158.2103 +\f2\-providerArg\fP \f2ConfigFilePath\fP 激с潟腟水篏睡障 keytool jarsigner ゃゃ潟鴻若障 (с\f2ConfigFilePath\fP 若活┃絎<ゃ吾鴻с)祉ャc若c若<ゃ Sun PKCS#11 ゃ荐絎翫 PKCS#11 若鴻≪筝荀ц;腓冴潟潟箴罨<腓冴障
158.2104 .RS 3
158.2105
158.2106 .LP
158.2107 .nf
158.2108 \f3
158.2109 .fl
158.2110 -jarsigner \-keystore NONE \-storetype PKCS11 \\
158.2111 +jarsigner \-keystore NONE \-storetype PKCS11 \\
158.2112 .fl
158.2113 - \-providerClass sun.security.pkcs11.SunPKCS11 \\
158.2114 + \-providerClass sun.security.pkcs11.SunPKCS11 \\
158.2115 .fl
158.2116 - \-providerArg /foo/bar/token.config \\
158.2117 + \-providerArg /foo/bar/token.config \\
158.2118 .fl
158.2119 \-list
158.2120 .fl
158.2121 @@ -1032,81 +1266,62 @@
158.2122 .fi
158.2123 .RE
158.2124 .TP 3
158.2125 -.B \-providerName providerName
158.2126 -\f2java.security\fP セキュリティプロパティファイル内で 2 つ以上のプロバイダが設定されている場合、\f2\-providerName\fP オプションを使って特定のプロバイダインスタンスを選択できます。このオプションの引数は、プロバイダの名前になります。
158.2127 +\-providerName providerName
158.2128 +\f2java.security\fP 祉ャc若c若<ゃ 2 や札筝ゃ荐絎翫\f2\-providerName\fP 激с潟篏帥c劫ゃゃ潟鴻帥潟鴻御с障激с潟綣違ゃс
158.2129 .LP
158.2130 -Sun PKCS#11 プロバイダの場合、\f2providerName\fP は \f2SunPKCS11\-\fP\f2TokenName\fP の形式になります。ここで、\f2TokenName\fP は、プロバイダインスタンスの設定時に使用した名前のサフィックスです。詳細については、
158.2131 +Sun PKCS#11 ゃ翫\f2providerName\fP \f2SunPKCS11\-\fP\f2TokenName\fP 綵√障 с\f2TokenName\fPゃゃ潟鴻帥潟鴻罕・絨乗с 荅括完
158.2132 +.na
158.2133 +\f2罕絮с茵\fP @
158.2134 .fi
158.2135 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner#ATTRS
158.2136 -の
158.2137 -.na
158.2138 -「\f2configuration attributes table\fP」を参照してください。たとえば、次のコマンドは、名前サフィックス \f2SmartCard\fP を持つ PKCS#11 キーストアプロバイダインスタンスの内容を一覧表示します。
158.2139 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRSс違篁ヤ潟潟с・絨乗 \f2SmartCard\fP PKCS#11 若鴻≪ゃゃ潟鴻帥潟鴻絎鴻鴻障
158.2140 .RS 3
158.2141
158.2142 .LP
158.2143 .nf
158.2144 \f3
158.2145 .fl
158.2146 -jarsigner \-keystore NONE \-storetype PKCS11 \\
158.2147 +jarsigner \-keystore NONE \-storetype PKCS11 \\
158.2148 .fl
158.2149 - \-providerName SunPKCS11\-SmartCard \\
158.2150 + \-providerName SunPKCS11\-SmartCard \\
158.2151 .fl
158.2152 \-list
158.2153 .fl
158.2154 \fP
158.2155 .fi
158.2156 .RE
158.2157 -.TP
158.2158 -.B \-Jjavaoption
158.2159 -指定した
158.2160 -.I javaoption
158.2161 -文字列を直接実行時システムに渡します。
158.2162 -\f3jarsigner\f1 は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリ使用を調整する場合に便利です。指定できるフラグを一覧表示するには、コマンド行で
158.2163 -.I java -h
158.2164 -または
158.2165 -.I java -X
158.2166 -と入力してください。
158.2167 +.TP 3
158.2168 +\-Jjavaoption
158.2169 +絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋・羝<障(\f3jarsigner\fP 絎 Java ゃ潟帥帥絲障若с激с潟腥榊純с障激с潟絎茵医障<≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц;腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
158.2170 .LP
158.2171 .TP 3
158.2172 \-tsa url
158.2173 -JAR ファイル署名時にコマンド行に\f2「-tsa http://example.tsa.url」\fPと入力した場合、署名のタイムスタンプが生成されます。\f2http://example.tsa.url\fP という URL が、TSA (Time Stamping Authority) の場所を特定します。これは、\f2\-tsacert\fP オプション経由で見つかったどの URL よりも優先されます。\f2\-tsa\fP オプションを使用する場合、TSA の公開鍵証明書がキーストア内に存在している必要はありません。
158.2174 +JAR <ゃ臀峨潟潟茵\f2\-tsa http://example.tsa.url\fP茵腓冴翫臀峨帥ゃ鴻帥潟障URL \f2http://example.tsa.url\fP TSA (Time Stamping Authority) 贋劫障\f2\-tsacert\fP 激с潟ф冴 URL 若若ゃ障\f2\-tsa\fP 激с潟сTSA 笈┝吾若鴻≪臀綽荀障
158.2175 .LP
158.2176 -タイムスタンプを生成するために、\f2jarsigner\fP は、
158.2177 +帥ゃ鴻帥潟\f2jarsigner\fP
158.2178 +.na
158.2179 +\f2RFC 3161\fP @
158.2180 .fi
158.2181 -http://www.ietf.org/rfc/rfc3161.txt
158.2182 -の
158.2183 -.na
158.2184 -「\f2RFC 3161\fP」で規定された TSP (Time\-Stamp Protocol) を使って TSA と通信します。成功すると、TSA から返されたタイムスタンプトークンが、署名とともに署名ブロックファイル内に格納されます。
158.2185 +http://www.ietf.org/rfc/rfc3161.txt у臂 TSP (Time\-Stamp Protocol) 篏睡 TSA 篆<障TSA 菴帥ゃ鴻帥潟若潟臀峨<ゃ臀峨篆絖障
158.2186 .LP
158.2187 .TP 3
158.2188 \-tsacert alias
158.2189 -JAR ファイル署名時にコマンド行に\f2「-tsacert alias」\fPと表示された場合、署名のタイムスタンプが生成されます。\f2alias\fP は、キーストア内で現在有効になっている TSA の公開鍵証明書を特定します。そのエントリの証明書内で、TSA の場所を特定する URL を含む Subject Information Access 拡張が検索されます。
158.2190 +JAR <ゃ臀峨潟潟茵\f2\-tsacert alias\fP茵腓冴翫臀峨帥ゃ鴻帥潟障\f2alias\fP 若鴻√憜鴻 TSA 笈┝吾劫障潟荐惹吾сTSA 贋劫 URL Subject Information Access ≦宍罘純腆肴障
158.2191 .LP
158.2192 -\f2\-tsacert\fP を使用する場合、TSA の公開鍵証明書がキーストア内に存在している必要があります。
158.2193 +TSA 笈┝吾\f2\-tsacert\fP 篏帥c翫若鴻≪臀綽荀障
158.2194 .LP
158.2195 .TP 3
158.2196 \-altsigner class
158.2197 -使用する代替署名機構を指定します。この完全修飾クラス名は、
158.2198 -.I com.sun.jarsigner.ContentSigner
158.2199 -抽象クラスを拡張するクラスファイルを特定します。このクラスファイルへのパスは、
158.2200 -.I \-altsignerpath
158.2201 -オプションを使って定義します。
158.2202 -.I \-altsigner
158.2203 -オプションが指定された場合、
158.2204 -.I jarsigner
158.2205 -はその指定されたクラスが提供する署名機構を使用します。それ以外の場合、
158.2206 -.I jarsigner
158.2207 -はデフォルトの署名機構を使用します。
158.2208 +篁f睡讐罘罕篏睡絎障絎篆蕋障劫\f2com.sun.jarsigner.ContentSigner\fP abstract 鴻≦宍鴻<ゃ劫障鴻<ゃ吾鴻\f2\-altsignerpath\fP 激с潟c絎臂障\f2\-altsigner\fP 激с潟篏睡翫\f2jarsigner\fP 絎鴻箴臀峨罘罕篏睡障障\f2jarsigner\fP 臀峨罘罕篏睡障
158.2209 .LP
158.2210 -たとえば、\f2com.sun.sun.jarsigner.AuthSigner\fP という名前のクラスが提供する署名機構を使用するには、\f2jarsigner\fP オプション\f2「-altsigner com.sun.jarsigner.AuthSigner」\fPを使用します。
158.2211 +違\f2com.sun.sun.jarsigner.AuthSigner\fP 鴻箴臀峨罘罕篏睡\f2jarsigner\fP 激с潟\f2\-altsigner com.sun.jarsigner.AuthSigner\fP篏睡障
158.2212 .LP
158.2213 .TP 3
158.2214 \-altsignerpath classpathlist
158.2215 -クラスファイル (このクラスファイル名は前述の \f2\-altsigner\fP オプションを使って指定) へのパスと、そのクラスが依存するすべての JAR ファイルへのパスを指定します。そのクラスファイルが JAR ファイル内に存在している場合には、次の例で示すように、その JAR ファイルへのパスを指定します。
158.2216 +鴻<ゃ (鴻<ゃ筝荐 \f2\-altsigner\fP 激с潟ф絎) 潟箴絖 JAR <ゃ吾鴻絎障鴻<ゃ JAR <ゃ翫篁ヤ箴 JAR <ゃ吾鴻絎障
158.2217 .LP
158.2218 -絶対パス、現在のディレクトリに対する相対パスのいずれかを指定できます。複数のパスまたは JAR ファイルを \f2classpathlist\fP に含める場合には、Solaris 上ではコロン (\f2:\fP)、Windows 上ではセミコロン (\f2;\fP) をそれぞれ使ってエントリを区切ってください。このクラスがすでに検索パスに含まれている場合、このオプションを指定する必要はありません。
158.2219 +腟九障鴻障憜c後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR <ゃс障 翫鴻障 JAR <ゃSolaris 翫潟 (\f2:\fP)Windows 翫祉潟 (\f2;\fP) у阪障鴻с罎膣≪劫翫激с潟筝荀с
158.2220 .LP
158.2221 -クラスファイルを含む JAR ファイルへのパスを指定する例:
158.2222 +鴻<ゃJAR <ゃ吾鴻絎箴腓冴障
158.2223 .RS 3
158.2224
158.2225 .LP
158.2226 @@ -1115,239 +1330,289 @@
158.2227 .LP
158.2228 .RE
158.2229 .LP
158.2230 -JAR ファイル名が含まれている点に注意してください。
158.2231 +JAR <ゃ障羈
158.2232 .LP
158.2233 -クラスファイルを含む JAR ファイルへのパスを指定する例:
158.2234 +鴻<ゃ JAR <ゃ吾鴻絎箴腓冴障
158.2235 .RS 3
158.2236 .LP
158.2237 \f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
158.2238 .LP
158.2239 .RE
158.2240 .LP
158.2241 -JAR ファイル名が含まれていない点に注意してください。
158.2242 +JAR <ゃ障
158.2243 .RE
158.2244 +.SH "箴"
158.2245 .LP
158.2246 -.SH "例"
158.2247 +
158.2248 .LP
158.2249 .SS
158.2250 -JAR ファイルの署名
158.2251 +JAR <ゃ臀峨
158.2252 .LP
158.2253 -.IX "jarsigner" "Signing a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.2254 +.RS 3
158.2255 +
158.2256 .LP
158.2257 -.B bundle.jar
158.2258 -という名前の JAR ファイルがあり、このファイルに、キーストアの別名が jane であるユーザの非公開鍵を使って、署名を付けるとします。キーストアは、mystore という名前で working ディレクトリにあり、キーストアのパスワードは mypass、
158.2259 -.I jane
158.2260 -の非公開鍵のパスワードは j638klm とします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
158.2261 .LP
158.2262 -.ft 3
158.2263 +bundle.jar JAR <ゃ障 <ゃ若鴻≪ュ jane с若吟若泣篏帥c臀峨篁障若鴻≪mystore сC ゃ working c若鴻≪鴻若 mypass\f2jane\fP 泣鴻若 j638klm 障翫罨<潟潟絎茵JAR <ゃ臀峨篁 sbundle.jar 臀峨篁 JAR <ゃ篏с障
158.2264 +.LP
158.2265 .nf
158.2266 -jarsigner \-keystore "/working/mystore" \-storepass myspass
158.2267 - -keypass j638klm -signedjar sbundle.jar bundle.jar jane
158.2268 +\f3
158.2269 +.fl
158.2270 + jarsigner \-keystore /working/mystore \-storepass myspass
158.2271 +.fl
158.2272 + \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
158.2273 +.fl
158.2274 +\fP
158.2275 .fi
158.2276 -.ft 1
158.2277 +
158.2278 .LP
158.2279 -上のコマンドでは
158.2280 -.I \-sigfile
158.2281 -オプションが指定されていないので、署名付き JAR ファイルに格納される
158.2282 -.B .SF
158.2283 -ファイルと
158.2284 -.B .DSA
158.2285 -ファイルの名前は、別名に基づくデフォルトの名前になり、それぞれ
158.2286 -.I JANE.SF
158.2287 -と
158.2288 -.I JANE.DSA
158.2289 -になります。
158.2290 .LP
158.2291 -ストアのパスワードと非公開鍵のパスワードをあとで入力する場合は、
158.2292 -上のコマンドを短縮して次のように入力できます。
158.2293 +筝潟潟с \f2\-sigfile\fP 激с潟絎臀峨篁 JAR <ゃ主 .SF <ゃ .DSA <ゃュゃ障ゃ障\f2JANE.SF\fP \f2JANE.DSA\fP 障
158.2294 .LP
158.2295 -.ft 3
158.2296 +.LP
158.2297 +鴻≪鴻若泣鴻若уュ翫筝潟潟膰罨<ュс障
158.2298 +.LP
158.2299 .nf
158.2300 -jarsigner \-keystore /working/mystore
158.2301 - -signedjar sbundle.jar bundle.jar jane
158.2302 +\f3
158.2303 +.fl
158.2304 + jarsigner \-keystore /working/mystore
158.2305 +.fl
158.2306 + \-signedjar sbundle.jar bundle.jar jane
158.2307 +.fl
158.2308 +\fP
158.2309 .fi
158.2310 -.ft 1
158.2311 +
158.2312 .LP
158.2313 -デフォルトのキーストア (ホームディレクトリ内の
158.2314 -.B .keystore
158.2315 -という名前のキーストア) を使用する場合は、次に示すように、キーストアの指定を
158.2316 -省略できます。
158.2317 .LP
158.2318 -.ft 3
158.2319 +若鴻 (若c .keystore 若鴻) 篏睡翫罨<腓冴若鴻≪絎ャс障
158.2320 +.LP
158.2321 .nf
158.2322 -jarsigner \-signedjar sbundle.jar bundle.jar jane
158.2323 +\f3
158.2324 +.fl
158.2325 + jarsigner \-signedjar sbundle.jar bundle.jar jane
158.2326 +.fl
158.2327 +\fP
158.2328 .fi
158.2329 -.ft 1
158.2330 +
158.2331 .LP
158.2332 -また、署名付き JAR ファイルで入力 JAR ファイル (
158.2333 -.I bundle.jar
158.2334 -) を上書きする場合は、
158.2335 -.I -signedjar
158.2336 -オプションの指定も省略できます。
158.2337 .LP
158.2338 -.ft 3
158.2339 +障臀峨篁 JAR <ゃуュ JAR <ゃ (\f2bundle.jar\fP) 筝吾翫\f2\-signedjar\fP 激с潟絎ャс障
158.2340 +.LP
158.2341 .nf
158.2342 -jarsigner bundle.jar jane
158.2343 +\f3
158.2344 +.fl
158.2345 + jarsigner bundle.jar jane
158.2346 +.fl
158.2347 +\fP
158.2348 .fi
158.2349 -.ft 1
158.2350 +.RE
158.2351 +
158.2352 .LP
158.2353 .SS
158.2354 -署名付き JAR ファイルの検証
158.2355 +臀峨篁 JAR <ゃ罎荐
158.2356 .LP
158.2357 -.IX "jarsigner" "Verifying a Signed JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.2358 +.RS 3
158.2359 +
158.2360 .LP
158.2361 -次に示すのは、署名付き JAR ファイルを検証し、署名が有効で JAR ファイルが
158.2362 -改変されていないことを確認するためのコマンド例です。
158.2363 .LP
158.2364 -.ft 3
158.2365 +罨<腓冴臀峨篁 JAR <ゃ罎荐若臀峨鴻 JAR <ゃ劫腆肴潟潟箴с
158.2366 +.LP
158.2367 .nf
158.2368 -jarsigner \-verify sbundle.jar
158.2369 +\f3
158.2370 +.fl
158.2371 + jarsigner \-verify sbundle.jar
158.2372 +.fl
158.2373 +\fP
158.2374 .fi
158.2375 -.ft 1
158.2376 +
158.2377 .LP
158.2378 -検証が成功すると、次のようなメッセージが表示されます。
158.2379 .LP
158.2380 -.ft 3
158.2381 +罎荐若罨<<祉若吾茵腓冴障
158.2382 +.LP
158.2383 .nf
158.2384 -jar verified.
158.2385 +\f3
158.2386 +.fl
158.2387 + jar 罎荐若障
158.2388 +.fl
158.2389 +\fP
158.2390 .fi
158.2391 -.ft 1
158.2392 +
158.2393 .LP
158.2394 -検証が成功しなかった場合は、エラーメッセージが表示されます。
158.2395 .LP
158.2396 -.I -verbose
158.2397 -オプションを使うと、より多くの情報が表示されます。次に示すのは、
158.2398 -.I -verbose
158.2399 -オプションを指定した
158.2400 -.B jarsigner
158.2401 -の実行例とその出力結果です。
158.2402 +<祉若吾茵腓冴障罎荐若c翫若<祉若吾茵腓冴障
158.2403 .LP
158.2404 -.ft 3
158.2405 +.LP
158.2406 +\f2\-verbose\fP 激с潟篏帥紊宴茵腓冴障罨<腓冴\f2\-verbose\fP 激с潟絎 \f3jarsigner\fP 絎茵箴阪腟с
158.2407 +.LP
158.2408 .nf
158.2409 -jarsigner -verify -verbose sbundle.jar
158.2410 +\f3
158.2411 +.fl
158.2412 + jarsigner \-verify \-verbose sbundle.jar
158.2413 +.fl
158.2414
158.2415 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
158.2416 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
158.2417 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
158.2418 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
158.2419 - smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
158.2420 +.fl
158.2421 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
158.2422 +.fl
158.2423 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
158.2424 +.fl
158.2425 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
158.2426 +.fl
158.2427 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
158.2428 +.fl
158.2429 + smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
158.2430 +.fl
158.2431
158.2432 - s = signature was verified
158.2433 - m = entry is listed in manifest
158.2434 - k = at least one certificate was found in keystore
158.2435 +.fl
158.2436 + s = 臀峨罎荐若障
158.2437 +.fl
158.2438 + m = 潟с鴻鴻障
158.2439 +.fl
158.2440 + k = 1 や札筝荐惹吾若鴻≪ф冴障
158.2441 +.fl
158.2442
158.2443 - jar verified.
158.2444 +.fl
158.2445 + jar 罎荐若障
158.2446 +.fl
158.2447 +\fP
158.2448 .fi
158.2449 -.ft 1
158.2450 +
158.2451 .LP
158.2452 .SS
158.2453 -証明書情報を使った検証
158.2454 +荐惹御宴篏帥c罎荐
158.2455 .LP
158.2456 -.IX "jarsigner" "Verification with Certificate Information" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.2457 +.LP
158.2458 +罎荐惹\f2\-verify\fP \f2\-verbose\fP 激с潟 \f2\-certs\fP 激с潟絎翫JAR <ゃ臀峨荐惹御宴阪障 荐惹吾帥ゃ臀峨茘ュ (X.509 荐惹吾翫) JAR <ゃ泣荐惹吾若鴻≪潟泣荐惹吾筝眼翫綣су蚊障臀峨若鴻√ュ障障罨<箴腓冴障
158.2459 +.LP
158.2460 +.nf
158.2461 +\f3
158.2462 +.fl
158.2463 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
158.2464 +.fl
158.2465
158.2466 -検証時に、
158.2467 -.I -verify
158.2468 -と
158.2469 -.I -verbose
158.2470 -オプションに加えて
158.2471 -.I -certs
158.2472 -オプションを指定した場合は、JAR ファイル内の各署名者の証明書情報も出力されま
158.2473 -す。これには、証明書のタイプ、署名者の識別名情報 (X.509 証明書の場合)、および、
158.2474 -JAR ファイルの公開鍵の証明書がキーストアエントリの公開鍵の証明書と一致する場合
158.2475 -には、括弧で囲まれた署名者のキーストア別名が含まれます。たとえば、次のように
158.2476 -出力されます。
158.2477 +.fl
158.2478 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
158.2479 +.fl
158.2480 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
158.2481 +.fl
158.2482 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
158.2483 +.fl
158.2484 + 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
158.2485 +.fl
158.2486 + 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
158.2487 +.fl
158.2488 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
158.2489 +.fl
158.2490 +
158.2491 +.fl
158.2492 + X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
158.2493 +.fl
158.2494 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
158.2495 +.fl
158.2496 +
158.2497 +.fl
158.2498 + s = 臀峨罎荐若障
158.2499 +.fl
158.2500 + m = 潟с鴻鴻障
158.2501 +.fl
158.2502 + k = 1 や札筝荐惹吾若鴻≪ф冴障
158.2503 +.fl
158.2504 +
158.2505 +.fl
158.2506 + jar 罎荐若障
158.2507 +.fl
158.2508 +\fP
158.2509 +.fi
158.2510 +
158.2511 .LP
158.2512 -.ft 3
158.2513 +.LP
158.2514 +臀峨荐惹吾 X.509 荐惹吾с翫茘ュ宴茵腓冴障翫荐惹吾帥ゃュ茵腓冴障違荐惹吾 PGP 荐惹吾сュ bob 翫罨<茵腓冴障
158.2515 +.LP
158.2516 .nf
158.2517 - jarsigner -keystore /working/mystore -verify -verbose -certs myTest.jar
158.2518 +\f3
158.2519 +.fl
158.2520 + PGP, (bob)
158.2521 +.fl
158.2522 +\fP
158.2523 +.fi
158.2524
158.2525 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
158.2526 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
158.2527 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
158.2528 - 208 Fri Sep 26 16:23:30 PDT 1997 META-INF/JAVATEST.SF
158.2529 - 1087 Fri Sep 26 16:23:30 PDT 1997 META-INF/JAVATEST.DSA
158.2530 -smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
158.2531 -
158.2532 - X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
158.2533 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
158.2534 -
158.2535 - s = signature was verified
158.2536 - m = entry is listed in manifest
158.2537 - k = at least one certificate was found in keystore
158.2538 -
158.2539 -jar verified.
158.2540 -.fi
158.2541 -.ft 1
158.2542 -.LP
158.2543 -署名者の証明書が X.509 証明書でない場合は、識別名情報は表示されず、証明書の
158.2544 -タイプと別名だけが表示されます。たとえば、証明書が PGP 証明書で、別名が bob の
158.2545 -場合は、次のように表示されます。
158.2546 -.LP
158.2547 -.ft 3
158.2548 -.nf
158.2549 -PGP, (bob)
158.2550 -.fi
158.2551 -.ft 1
158.2552 .LP
158.2553 .SS
158.2554 -アイデンティティデータベース署名者を含む JAR ファイルの検証
158.2555 +≪ゃ潟cc若若帥若鴻臀峨 JAR <ゃ罎荐
158.2556 .LP
158.2557 -.IX "jarsigner" "Verification of a JAR File" "\fLjarsigner\fP \(em JAR signing and verification tool "
158.2558 -JAR ファイルが、JDK 1.1 の
158.2559 -.B javakey
158.2560 -ツールを使って署名されている場合、署名者はアイデンティティデータベース内の
158.2561 -別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、
158.2562 -アイデンティティデータベース内の別名とキーストア内の別名の両方によって署名
158.2563 -されている場合は、k と i の両方が表示されます。
158.2564 .LP
158.2565 -.I -certs
158.2566 -オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティ
158.2567 -ティデータベース内の別名は角括弧で囲まれて表示されます。たとえば、次のように
158.2568 -表示されます。
158.2569 +JAR <ゃJDK 1.1 \f3javakey\fP 若篏帥c臀峨翫臀峨≪ゃ潟cc若若帥若劫ュс 翫罎荐若阪 i 荐垩障障JAR <ゃ≪ゃ潟cc若若帥若劫ュ若鴻√ュ筝≧鴻c臀峨翫k i 筝≧鴻茵腓冴障
158.2570 .LP
158.2571 -.ft 3
158.2572 +.LP
158.2573 +\f2\-certs\fP 激с潟絎翫若鴻≪ュ綣су蚊障絲障≪ゃ潟cc若若帥若劫ュ茹綣су蚊障茵腓冴障箴腓冴障
158.2574 +.LP
158.2575 .nf
158.2576 -jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
158.2577 +\f3
158.2578 +.fl
158.2579 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
158.2580 +.fl
158.2581
158.2582 - 198 Fri Sep 26 16:14:06 PDT 1997 META-INF/MANIFEST.MF
158.2583 - 199 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.SF
158.2584 - 1013 Fri Sep 26 16:22:10 PDT 1997 META-INF/JANE.DSA
158.2585 - 199 Fri Sep 27 12:22:30 PDT 1997 META-INF/DUKE.SF
158.2586 - 1013 Fri Sep 27 12:22:30 PDT 1997 META-INF/DUKE.DSA
158.2587 -smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
158.2588 +.fl
158.2589 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
158.2590 +.fl
158.2591 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
158.2592 +.fl
158.2593 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
158.2594 +.fl
158.2595 + 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
158.2596 +.fl
158.2597 + 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
158.2598 +.fl
158.2599 + smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
158.2600 +.fl
158.2601
158.2602 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
158.2603 - X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
158.2604 +.fl
158.2605 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
158.2606 +.fl
158.2607 + X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
158.2608 +.fl
158.2609
158.2610 - s = signature was verified
158.2611 - m = entry is listed in manifest
158.2612 - k = at least one certificate was found in keystore
158.2613 - i = at least one certificate was found in identity scope
158.2614 +.fl
158.2615 + s = 臀峨罎荐若障
158.2616 +.fl
158.2617 + m = 潟с鴻鴻障
158.2618 +.fl
158.2619 + k = 1 や札筝荐惹吾若鴻≪ф冴障
158.2620 +.fl
158.2621 + i = 1 や札筝荐惹吾≪ゃ潟cc若鴻潟若ф冴障
158.2622 +.fl
158.2623
158.2624 -jar verified.
158.2625 +.fl
158.2626 + jar 罎荐若障
158.2627 +.fl
158.2628 +\fP
158.2629 .fi
158.2630 -.ft 1
158.2631 +
158.2632 .LP
158.2633 -別名 duke は角括弧で囲まれているので、この別名はキーストアの別名ではなく、
158.2634 -アイデンティティデータベースの別名です。
158.2635 -.SH "関連項目"
158.2636 +.LP
158.2637 +ュ duke 茹綣су蚊障сュ若鴻≪ュс≪ゃ潟cc若若帥若鴻ュс
158.2638 +.LP
158.2639 +.RE
158.2640 +.SH "∫i"
158.2641 .LP
158.2642
158.2643 .LP
158.2644 .RS 3
158.2645 .TP 2
158.2646 o
158.2647 -jar ツールのドキュメント
158.2648 +jar(1) 若ャ<潟
158.2649 .TP 2
158.2650 o
158.2651 -keytool ツールのドキュメント
158.2652 +keytool(1) 若ャ<潟
158.2653 .TP 2
158.2654 o
158.2655 -\f3jarsigner\fP ツールの使用例については、「Java Tutorial」
158.2656 -(http://java.sun.com/docs/books/tutorial/trailmap.html)
158.2657 -の「Security」( http://java.sun.com/docs/books/tutorial/security1.2/index.html)
158.2658 -を参照
158.2659 +\f3jarsigner\fP 若篏睡箴ゃ
158.2660 .na
158.2661 +\f4Java Tutorial\fP @
158.2662 +.fi
158.2663 +http://java.sun.com/docs/books/tutorial/index.html
158.2664 +.na
158.2665 +\f4Security\fP @
158.2666 +.fi
158.2667 +http://java.sun.com/docs/books/tutorial/security/index.html
158.2668 .RE
158.2669
158.2670 .LP
159.1 --- a/src/solaris/doc/sun/man/man1/ja/java.1 Tue May 12 15:21:55 2009 +0900
159.2 +++ b/src/solaris/doc/sun/man/man1/ja/java.1 Thu May 14 00:17:25 2009 -0700
159.3 @@ -1,643 +1,437 @@
159.4 -'\" t
159.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
159.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
159.7 -.\"
159.8 -.\" This code is free software; you can redistribute it and/or modify it
159.9 -.\" under the terms of the GNU General Public License version 2 only, as
159.10 -.\" published by the Free Software Foundation.
159.11 -.\"
159.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
159.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
159.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
159.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
159.16 -.\" accompanied this code).
159.17 -.\"
159.18 -.\" You should have received a copy of the GNU General Public License version
159.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
159.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
159.21 -.\"
159.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
159.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
159.24 -.\" have any questions.
159.25 -.\" `
159.26 -.TH java 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
159.27 -.SH "名前"
159.28 -java \- Java アプリケーション起動プログラム
159.29 -.SH "形式"
159.30 -.B java
159.31 -[
159.32 -.B options
159.33 -]
159.34 -.B class
159.35 -[
159.36 -.B argument ...
159.37 -]
159.38 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
159.39 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
159.40 +."
159.41 +." This code is free software; you can redistribute it and/or modify it
159.42 +." under the terms of the GNU General Public License version 2 only, as
159.43 +." published by the Free Software Foundation.
159.44 +."
159.45 +." This code is distributed in the hope that it will be useful, but WITHOUT
159.46 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
159.47 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
159.48 +." version 2 for more details (a copy is included in the LICENSE file that
159.49 +." accompanied this code).
159.50 +."
159.51 +." You should have received a copy of the GNU General Public License version
159.52 +." 2 along with this work; if not, write to the Free Software Foundation,
159.53 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
159.54 +."
159.55 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
159.56 +." CA 95054 USA or visit www.sun.com if you need additional information or
159.57 +." have any questions.
159.58 +."
159.59 +.TH java 1 "04 May 2009"
159.60 +." Generated from HTML by html2man (author: Eric Armstrong)
159.61 +
159.62 .LP
159.63 -.B java
159.64 -[
159.65 -.B options
159.66 -]
159.67 -.B \-jar " file.jar"
159.68 -.if n .ti +5n
159.69 -[
159.70 -.B argument ...
159.71 -]
159.72 +.SH ""
159.73 +java \- Java ≪宴若激с活儀若
159.74 .LP
159.75 -.TP 15
159.76 -.B options
159.77 -コマンド行オプション。
159.78 -.TP
159.79 -.B class
159.80 -呼び出されるクラスの名前。
159.81 -.TP
159.82 -.B file.jar
159.83 -呼び出されるファイルの名前。必ず
159.84 -.I \-jar
159.85 -と同時に使用される。
159.86 -.TP
159.87 -.B argument
159.88 -.B main
159.89 -関数に渡される引数。
159.90 -.SH "機能説明"
159.91 -.IX "Java interpreter" "" "Java interpreter \(em \fLjava\fP"
159.92 -.IX "java" "" "\fLjava\fP \(em Java interpreter"
159.93 +.RS 3
159.94 +.TP 2
159.95 +o
159.96 +綵√
159.97 +.TP 2
159.98 +o
159.99 +茯
159.100 +.TP 2
159.101 +o
159.102 +激с
159.103 +.TP 2
159.104 +o
159.105 +∫i
159.106 +.RE
159.107 +
159.108 .LP
159.109 -.B java
159.110 -ツールは、Java アプリケーションを起動します。
159.111 -.B java
159.112 -ツールは、Java Runtime Environment を起動したあと、指定されたクラスをロードし、このクラスの
159.113 -.B main
159.114 -メソッドを呼び出して Java アプリケーションを起動します。
159.115 +.SH "綵√"
159.116 .LP
159.117 -このメソッドは
159.118 -.B public
159.119 -および
159.120 -.B static
159.121 -で宣言され、値を返さず、パラメータとして
159.122 -.I String
159.123 -配列を使用できなければなりません。
159.124 -メソッド宣言は次のようにする必要があります。
159.125 -.LP
159.126 -.ft 3
159.127 -.nf
159.128 - public static void main(String args[])
159.129 -.fi
159.130 -.ft 1
159.131 -.LP
159.132 -デフォルトでは、オプションではない最初の引数が、呼び出すクラスの名前に
159.133 -なります。この名前には、完全指定のクラス名を使用する必要があります。
159.134 -.B \-jar
159.135 -オプションを指定した場合、オプションではない最初の引数は、アプリケーションの
159.136 -クラスファイルとリソースファイルを含む JAR アーカイブの名前になります。
159.137 -この場合、Main-Class マニフェストヘッダで指定されたクラスがスタート
159.138 -アップクラスになります。
159.139 -.LP
159.140 -Java Runtime は、ブートストラップクラスパス、インストール型拡張機能、
159.141 -およびユーザクラスパスの 3 つの場所から、起動クラスとその他の
159.142 -使用するクラスを探します。
159.143 -.LP
159.144 -クラス名または JAR ファイル名のあとにあるオプションではない引数は、
159.145 -main 関数に渡されます。
159.146 -.LP
159.147 -.SH "オプション"
159.148 -起動コマンドには、現在の実行環境および将来のリリースでサポートされる
159.149 -標準オプションがあります。
159.150 -また、仮想マシンの現在の実装では、非標準オプションをサポートしています。
159.151 -この仕様は将来変更される可能性があります。
159.152 -.SS "標準オプション"
159.153 -.IX "java" "Standard Options" "\fLjava\fP \(em Java interpreter"
159.154 -.TP 3
159.155 -.LP
159.156 -.B \-client
159.157 -Java HotSpot Client
159.158 -.SM VM\s0
159.159 -を選択します。
159.160 -64 ビット対応 JDK は現時点では、このオプションを無視し、代わりに Java Hotspot Server VM を使用します。
159.161 -デフォルトの VM の選択については、
159.162 -.fi
159.163 -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
159.164 -の
159.165 -.na
159.166 -「\f2Server\-Class Machine Detection\fP」を参照してください。
159.167 -.TP
159.168 -.B \-server
159.169 -Java HotSpot Server
159.170 -VM
159.171 -を選択します。
159.172 -64 ビット対応 JDK 上では、サポートされるのは Java Hotspot Server VM だけであるため、\-server オプションが暗黙的に選択されます。
159.173 -デフォルトの VM の選択については、
159.174 -.fi
159.175 -http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
159.176 -の
159.177 -.na
159.178 -「\f2Server\-Class Machine Detection\fP」を参照してください。
159.179 -.TP
159.180 -.B \-agentlib:libname[=options]
159.181 -ネイティブのエージェントライブラリ
159.182 -.I libname
159.183 -を読み込みします。次に例を示します。
159.184 -.LP
159.185 -.RS 5
159.186 -.nf
159.187 -\-agentlib:hprof
159.188 -\-agentlib:jdwp=help
159.189 -\-agentlib:hprof=help
159.190 -.fi
159.191 -.RE
159.192 -.LP
159.193 -詳細は、
159.194 -.fi
159.195 -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting
159.196 -の
159.197 -.na
159.198 -「\f2JVMTI Agent Command Line Options\fP」を参照してください。
159.199 -.TP
159.200 -.B \-agentpath:pathname[=options]
159.201 -ネイティブのエージェントライブラリをフルパス名を使用して読み込みします。
159.202 -詳細は、
159.203 -.fi
159.204 -http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting
159.205 -の
159.206 -.na
159.207 -「\f2JVMTI Agent Command Line Options\fP」を参照してください。
159.208 -.TP
159.209 -.B \-classpath " classpath"
159.210 -.TP
159.211 -.B \-cp " classpath"
159.212 -クラスファイルを探すディレクトリ、JAR アーカイブ、および ZIP アーカイブのリストを指定します。クラスパスの各エントリはコロン (:) で区切ります。
159.213 -.B \-classpath
159.214 -または
159.215 -.B \-cp
159.216 -を指定すると、これらのオプションの値によって
159.217 -.SB CLASSPATH
159.218 -環境変数の設定は上書きされます。
159.219 -.LP
159.220 -.B \-classpath
159.221 -と
159.222 -.B \-cp
159.223 -を使用せず、
159.224 -.SB CLASSPATH
159.225 -も設定されていない場合、ユーザクラスパスは現在のディレクトリ (.) になります。
159.226 -.LP
159.227 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
159.228 -.br
159.229 -.br
159.230 -たとえば、ディレクトリ
159.231 -.I foo
159.232 -に
159.233 -.I a.jar
159.234 -と
159.235 -.I b.JAR
159.236 -が含まれている場合、クラスパス要素
159.237 -.I foo/*
159.238 -は
159.239 -.I A.jar:b.JAR
159.240 -に展開されます。ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。
159.241 -* だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。
159.242 -.I CLASSPATH
159.243 -環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、
159.244 -.I System.getenv
159.245 -("
159.246 -.I CLASSPATH
159.247 -")
159.248 -呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
159.249 -.LP
159.250 -クラスパスの詳細については、「クラスパスの設定」を参照してください。
159.251 -.TP
159.252 -.B \-Dproperty=value
159.253 -システムプロパティの値を設定します。
159.254 -.TP
159.255 -.B \-d32
159.256 -.TP
159.257 -.B \-d64
159.258 -それぞれ 32 ビット環境、64 ビット環境でプログラムを実行することを要求します。要求された環境がインストールされていないかサポートされていない場合は、エラーが報告されます。
159.259 -.LP
159.260 -現時点では、64 ビット操作をサポートしているのは Java HotSpot Server VM
159.261 -だけであり、
159.262 -.B \-server
159.263 -オプションでは、
159.264 -.B \-d64
159.265 -が暗黙的に使用されます。
159.266 -したがって、\-d64 使用時には「-client」オプションは無視されます。
159.267 -この仕様は将来変更される場合があります。
159.268 -.LP
159.269 -.B \-d32
159.270 -と
159.271 -.B \-d64
159.272 -のどちらも指定しなかった場合、
159.273 -64 ビット専用システムを除いて、
159.274 -デフォルトでは 32 ビット環境で実行されます。
159.275 -この仕様は将来変更される場合があります。
159.276 -.TP 3
159.277 -\-enableassertions[:<package name>"..." | :<class name> ]
159.278 -.TP 3
159.279 -\-ea[:<package name>"..." | :<class name> ]
159.280 -.LP
159.281 -表明を有効にします。デフォルトで、表明は無効です。
159.282 -.sp 1n
159.283 -引数を指定しなくても、
159.284 -.BR enableassertions
159.285 -または
159.286 -.BR \-ea
159.287 -で表明が有効になります。
159.288 -「...」で終わる引数を 1 つ指定すると、
159.289 -スイッチにより、指定したパッケージおよびすべての
159.290 -サブパッケージ内の表明が有効になります。
159.291 -「...」という引数を指定すると、スイッチにより、
159.292 -現在の作業用ディレクトリ内にある名前のないパッケージ内の
159.293 -表明が有効になります。
159.294 -「...」で終わらない引数を 1 つ指定すると、
159.295 -スイッチにより、指定したクラス内の表明が有効になります。
159.296 -.LP
159.297 -1 行のコマンドに、これらのスイッチの複数のインスタンスが
159.298 -含まれている場合、クラスを読み込む前に、正しく処理されます。
159.299 -たとえば、パッケージ
159.300 -.I com.wombat.fruitbat
159.301 - (およびすべてのサブパッケージ) 内だけの有効な表明を
159.302 -含んだプログラムを実行する場合、次のコマンドを使用できます。
159.303 -.TP
159.304 -.BR java -ea:com.wombat.fruitbat... <Main Class>
159.305 -.LP
159.306 -.BR \-enableassertions
159.307 -および
159.308 -.BR \-ea
159.309 -スイッチは、すべての
159.310 -クラスローダおよびシステムクラス (クラスローダを持たない) に適用されます。
159.311 -この規則には 1 つ例外があります。引数がない形式の場合、
159.312 -スイッチはシステムに適用されません。これを利用して、簡単に、
159.313 -システムクラスを除くすべてのクラスの表明を有効にすることができます。
159.314 -すべてのシステムクラスの表明を有効にする個別のスイッチも
159.315 -用意されています。
159.316 -.BR \-enablesystemassertions
159.317 -を参照してください。
159.318 -.TP 3
159.319 -\-disableassertions[:<package name>"..." | :<class name> ]
159.320 -.TP 3
159.321 -\-da[:<package name>"..." | :<class name> ]
159.322 -.LP
159.323 -表明を無効にします。これはデフォルトです。
159.324 -.sp 1n
159.325 -引数を指定せずに、
159.326 -.BR disableassertions
159.327 -または
159.328 -.BR \-da
159.329 -で表明を無効にします。
159.330 -「...」で終わる引数を 1 つ指定すると、
159.331 -スイッチにより、指定したパッケージおよびすべての
159.332 -サブパッケージ内の表明が無効になります。
159.333 -「...」という引数を指定すると、スイッチにより、現在の作業用
159.334 -ディレクトリ内にある名前のないパッケージ内の表明が無効に
159.335 -なります。「...」で終わらない引数を 1 つ指定すると、スイッチにより、
159.336 -指定したクラス内の表明が無効になります。
159.337 -.LP
159.338 -パッケージ
159.339 -.I com.wombat.fruitbat
159.340 -の表明は有効に、クラス
159.341 -.I com.wombat.fruitbat.Brickbat
159.342 -の表明は無効にしてプログラムを実行するには、
159.343 -次のコマンドを使用します。
159.344 -
159.345 -java -ea:com.wombat.fruitbat... -da:com.wombat.fruitbat.Brickbat <Main Class>
159.346 -
159.347 -.BR \-disableassertions
159.348 -および
159.349 -.BR \-da
159.350 -スイッチは、すべての
159.351 -クラスローダおよびシステムクラス (クラスローダを持たない) に適用されます。
159.352 -この規則には 1 つ例外があります。
159.353 -引数を持たない形式の場合、スイッチはシステムに適用されません。
159.354 -これを利用して、簡単に、
159.355 -システムクラスを除くすべてのクラス内の表明を有効にすることができます。
159.356 -すべてのシステムクラス内内の表明を有効にする個別のスイッチも
159.357 -用意されています。
159.358 -.BR \-disablesystemassertions
159.359 -を参照してください。
159.360 -.TP
159.361 -.BR \-enablesystemassertions
159.362 -.TP 3
159.363 -\-esa
159.364 -すべてのシステムクラスの表明を有効にします (システムクラスの
159.365 -デフォルトの表明ステータスを true に設定します)。
159.366 -.TP
159.367 -.BR \-disablesystemassertions
159.368 -.TP 3
159.369 -\-dsa
159.370 -すべてのシステムクラスの表明を無効にします。
159.371 -.TP 3
159.372 -\-jar
159.373 -JAR の中にカプセル化されたプログラムを実行します。最初の引数は、起動クラスの名前ではなく、JAR アーカイブファイルの名前になります。
159.374 -このオプションが動作するためには、JAR ファイルのマニフェストに形式 \f3Main-Class:\f1\f2classname\f1 の行が入っていなければなりません。
159.375 -.I classname
159.376 -は、ユーザのアプリケーションの開始点となる
159.377 -.I public static void main(String[] args)
159.378 -メソッドを持つクラスを識別します。
159.379 -Jar ファイルと Jar ファイルのマニフェストを扱う方法については、Jar ツールのリファレンスページと、
159.380 -.na
159.381 -\f2Java Tutorial\fP
159.382 -.fi
159.383 -(http://java.sun.com/docs/books/tutorial/jar)
159.384 -の Jar トレールを参照してください。
159.385 -.LP
159.386 -このオプションを使用するときは、JAR ファイルがすべてのユーザクラスのソースとなるため、他のユーザクラスパスの設定は無視されます。
159.387 -.LP
159.388 -.B "java \-jar"
159.389 -オプションで実行できる JAR ファイルでは、
159.390 -.B "java \-jar"
159.391 -なしでも実行できるように、実行権限を設定できます。
159.392 -.fi
159.393 -http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html
159.394 -の
159.395 -.na
159.396 -「\f2Java Archive (JAR) Files\f」を参照してください。
159.397 -.TP
159.398 -.B \-javaagent:jarpath[=options]
159.399 -Java プログラミング言語エージェントを読み込みます。
159.400 -http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html
159.401 -の
159.402 -「\f2java.lang.instrument\fP」を参照してください。
159.403 -.LP
159.404 -.B \-verbose
159.405 -.LP
159.406 -.TP 3
159.407 -\-verbose: class
159.408 -クラスが読み込まれるたびにクラスに関する情報を表示します。
159.409 -.PD
159.410 -.LP
159.411 -.TP 3
159.412 -\-verbose:gc
159.413 -ガベージコレクションイベントが発生するたびに報告します。
159.414 -.TP 3
159.415 -.B \-verbose:jni
159.416 -ネイティブメソッドおよびその他の Java Native Interface (JNI) の使用に関する
159.417 -情報を報告します。
159.418 -.TP 3
159.419 -.B \-version
159.420 -バージョン情報を表示して終了します。
159.421 -.TP 3
159.422 -.B \-version:release
159.423 -コマンド行に指定されたクラスまたは JAR ファイルが、\f2release\fP で指定されたバージョンを必要としていることを示します。起動された java コマンドのバージョンがこの指定内容を満たさず、かつ適切な実装がシステム上で見つかった場合には、その適切な実装が使用されます。
159.424 -.LP
159.425 -\f2release\fP では、特定のバージョンを指定できるだけでなく、バージョン文字列と呼ばれるバージョンのリストを指定することもできます。バージョン文字列は、いくつかのバージョン範囲を空白で区切った形式の順序付きリストです。バージョン範囲は、バージョン ID、バージョン ID の後にアスタリスク (*) を付加したもの、バージョン ID の後にプラス記号 (+) を付加したもの、2 つのバージョン範囲をアンパサンド (&) で結合したもの、のいずれかになります。アスタリスクはプレフィックス一致を、プラス記号は指定されたバージョン以上を、アンパサンドは 2 つのバージョン範囲の論理積を、それぞれ意味します。次に例を示します。
159.426 .nf
159.427 \f3
159.428 .fl
159.429 --version:"1.5.0_04 1.5*&1.5.1_02+"
159.430 + \fP\f3java\fP [ options ] class [ argument ... ]
159.431 +.fl
159.432 + \f3java\fP [ options ] \f3\-jar\fP file.jar [ argument ... ]
159.433 +.fl
159.434 +.fi
159.435 +
159.436 +.LP
159.437 +.RS 3
159.438 +
159.439 +.LP
159.440 +.RS 3
159.441 +.TP 3
159.442 +options
159.443 +潟潟茵激с潟
159.444 +.TP 3
159.445 +class
159.446 +若喝冴鴻
159.447 +.TP 3
159.448 +file.jar
159.449 +若喝冴 JAR <ゃ綽 \f2\-jar\fP 篏睡
159.450 +.TP 3
159.451 +argument
159.452 +\f3main\fP ∽違羝<綣
159.453 +.RE
159.454 +
159.455 +.LP
159.456 +.RE
159.457 +.SH " 茯"
159.458 +.LP
159.459 +
159.460 +.LP
159.461 +.LP
159.462 +\f3java\fP 若Java ≪宴若激с潟莎桁障java 若Java Runtime Environment 莎桁絎鴻若鴻 \f3main\fP <純若喝冴Java ≪宴若激с潟莎桁障
159.463 +.LP
159.464 +.LP
159.465 +<純public static 絎h綽荀障 障ゃ菴障 \f2String\fP <若帥絎с違障<純絎h罨<c違障
159.466 +.LP
159.467 +.nf
159.468 +\f3
159.469 +.fl
159.470 + public static void main(String args[])
159.471 .fl
159.472 \fP
159.473 .fi
159.474 -上記の意味は、バージョン 1.5.0_04、または 1.5.1_02 以上で 1.5 をバージョン ID プレフィックスとして持つバージョン、のいずれかをクラスまたは JAR ファイルが必要とする、ということです。バージョン文字列の厳密な構文や定義については、「Java Network Launching Protocol & API Specification (JSR\-56)」の「Appendix A」を参照してください。
159.475 +
159.476 .LP
159.477 -JAR ファイルの場合は通常、バージョン要件をコマンド行に指定するよりも、JAR ファイルのマニフェスト内に指定することが推奨されています。
159.478 .LP
159.479 -このオプションの使用に関する重要なポリシー情報については、後述の「注」節を参照してください。
159.480 -.TP
159.481 -.B \-showversion
159.482 -バージョン情報を表示して、実行を継続します。
159.483 -.TP
159.484 -.B \-?
159.485 -.PD 0
159.486 -.TP
159.487 -.B \-help
159.488 -使用法を表示して終了します。
159.489 -.PD
159.490 -.TP
159.491 -.B \-X
159.492 -非標準オプションに関する情報を表示して終了します。
159.493 +с潟潟茵激с割札紊綣違若喝冴鴻障絎絎劫篏睡綽荀障\f3\-jar\fP 激с潟絎翫潟潟茵激с割札紊綣違≪宴若激с潟鴻<ゃ純若鴻<ゃ \f3JAR\fP ≪若ゃ障 翫с鴻 \f3Main\-Class\fP 若ф絎鴻莎桁鴻障
159.494 .LP
159.495 -.SS "非標準オプション"
159.496 .LP
159.497 -.IX "java" "Non-Standard Options" "\fLjava\fP \(em Java interpreter"
159.498 +Java Runtime 若鴻鴻鴻ゃ潟鴻若≦宍罘純潟若吟若鴻鴻 3 膊莎桁鴻篁篏睡鴻罎膣≪障
159.499 +.LP
159.500 +.LP
159.501 +劫障 JAR <ゃ潟潟茵激с割札紊綣違\f3main\fP ∽違羝<障
159.502 +.LP
159.503 +.SH "激с"
159.504 +.LP
159.505 +
159.506 +.LP
159.507 +.LP
159.508 +莎桁若憜絎茵医喝ャ若鴻с泣若罔羣激с潟障障篁潟激潟憜絎茖с罔羣激с潟祉泣若障 絨ャ若鴻у眼醇с障
159.509 +.LP
159.510 +.SH "罔羣激с"
159.511 +.LP
159.512 +
159.513 +.LP
159.514 +.RS 3
159.515 +.TP 3
159.516 +\-client
159.517 +.LP
159.518 +Java HotSpot Client VM 御障64 絲上 JDK 憝鴻с激с潟∴篁c Java Hotspot Server VM 篏睡障
159.519 +.LP
159.520 + VM 御ゃ
159.521 +.na
159.522 +\f2泣若 \- 鴻激潟罎冴\fP @
159.523 +.fi
159.524 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
159.525 +.TP 3
159.526 +\-server
159.527 +.LP
159.528 +Java HotSpot Server VM 御障64 絲上 JDK 筝с泣若 Java Hotspot Server VM с\-server 激с潟藥御障
159.529 +.LP
159.530 + VM 御ゃ
159.531 +.na
159.532 +\f2泣若 \- 鴻激潟罎冴\fP @
159.533 +.fi
159.534 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.htmlс
159.535 +.TP 3
159.536 +\-agentlib:libname[=options]
159.537 +ゃc若吾с潟ゃ \f2libname\fP 若障 井<絎障
159.538 +.LP
159.539 +\-agentlib:hprof
159.540 +.LP
159.541 +\-agentlib:jdwp=help
159.542 +.LP
159.543 +\-agentlib:hprof=help
159.544 +.LP
159.545 +荅括完ゃ
159.546 +.na
159.547 +\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
159.548 +.fi
159.549 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
159.550 +.TP 3
159.551 +\-agentpath:pathname[=options]
159.552 +劫篏睡若c若吾с潟ゃ若障荅括完ゃ
159.553 +.na
159.554 +\f2JVMTI 若吾с潟潟潟茵激с潟\fP @
159.555 +.fi
159.556 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#startingс
159.557 +.TP 3
159.558 +\-classpath classpath
159.559 +.TP 3
159.560 +\-cp classpath
159.561 +鴻<ゃ罎膣≪cJAR ≪若ゃ ZIP ≪若ゃ鴻絎障鴻鴻潟潟 (\f3:\fP) у阪障\f3\-classpath\fP 障 \f3\-cp\fP 絎激с潟ゃc \f3CLASSPATH\fP 医紊違荐絎若若ゃ障
159.562 +.LP
159.563 +\f3\-classpath\fP \f3\-cp\fP 篏睡\f3CLASSPATH\fP 荐絎翫若吟若鴻鴻憜c (\f4.\fP) 障
159.564 +.LP
159.565 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
159.566 +.br
159.567 +.br
159.568 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
159.569 +.LP
159.570 +鴻鴻荅括完
159.571 +.na
159.572 +\f2鴻鴻荐絎\fP @
159.573 +.fi
159.574 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
159.575 +.TP 3
159.576 +\-Dproperty=value
159.577 +激鴻c若ゃ荐絎障
159.578 +.TP 3
159.579 +\-d32
159.580 +.TP 3
159.581 +\-d64
159.582 + 32 医64 医с違絎茵荀羆障荀羆医ゃ潟鴻若泣若翫若怨障
159.583 +.LP
159.584 +憜Java HotSpot Server VM 64 篏泣若\-d64 篏睡 \-server 激с潟藥鴻障c\-d64 篏睡\-client激с潟∴障篁罕絨ャ若鴻с紊眼醇с障
159.585 +.LP
159.586 +\f3\-d32\fP \f3\-d64\fP <絎翫32 医у茵障篁罕絨ャ若鴻с紊眼醇с障
159.587 +.TP 3
159.588 +\-enableassertions[:<package name>"..."| :<class name> ]
159.589 +.TP 3
159.590 +\-ea[:<package name>"..."| :<class name> ]
159.591 +≪泣若激с潟鴻障≪泣若激с潟с≦鴻c障
159.592 +.LP
159.593 +綣違 \f3enableassertions\fP 障 \f3\-ea\fP 絎≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟鴻障綣違\f2...\fP絎憜篏罐c宴若後с≪泣若激с潟鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟鴻障
159.594 +.LP
159.595 +筝潟潟茵鴻ゃゃ潟鴻帥潟鴻茲井絎翫絎鴻ゃ鴻若障c違宴若 \f2com.wombat.fruitbat\fP (泣宴若吾) с帥≪泣若激с潟鴻違絎茵罨<潟潟篏睡障
159.596 +.nf
159.597 +\f3
159.598 +.fl
159.599 +java \-ea:com.wombat.fruitbat... <Main Class>
159.600 +.fl
159.601 +\fP
159.602 +.fi
159.603 +.LP
159.604 +\f3\-enableassertions\fP \f3\-ea\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟鴻ャ鴻ゃ障 \f3\-enablesystemassertions\fP с
159.605 +.TP 3
159.606 +\-disableassertions[:<package name>"..."| :<class name> ]
159.607 +.TP 3
159.608 +\-da[:<package name>"..."| :<class name> ]
159.609 +≪泣若激с潟≦鴻障荐絎с
159.610 +.LP
159.611 +綣違 \f3disableassertions\fP 障 \f3\-da\fP 絎≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎宴若吾泣宴若後с≪泣若激с潟≦鴻障綣違\f2...\fP絎憜篏罐c宴若後с≪泣若激с潟≦鴻障\f2...\fPх綣違 1 ゆ絎絎劫с≪泣若激с潟≦鴻障
159.612 +.LP
159.613 +宴若 \f2com.wombat.fruitbat\fP с≪泣若激с潟鴻 \f2com.wombat.fruitbat.Brickbat\fP с≪泣若激с潟≦鴻с違絎茵罨<潟潟篏睡障
159.614 +.nf
159.615 +\f3
159.616 +.fl
159.617 +java \-ea:com.wombat.fruitbat... \-da:com.wombat.fruitbat.Brickbat <Main Class>
159.618 +.fl
159.619 +\fP
159.620 +.fi
159.621 +.LP
159.622 +\f3\-disableassertions\fP \f3\-da\fP 鴻ゃ鴻鴻若潟激鴻鴻障 激鴻鴻鴻若障荀箴紊 1 ゃ障綣違с鴻ゃ絎絎激鴻鴻с箴紊違激鴻鴻ゃ鴻鴻с≪泣若激с潟膂≦鴻с障鴻激鴻鴻с≪泣若激с潟≦鴻ャ鴻ゃ障 \f3\-disablesystemassertions\fP с
159.623 +.TP 3
159.624 +\-enablesystemassertions
159.625 +.TP 3
159.626 +\-esa
159.627 +鴻激鴻劫с≪泣若激с潟鴻障 ゃ障激鴻鴻ゃ≪泣若激с潟鴻若帥鴻 \f2true\fP 荐絎障
159.628 +.TP 3
159.629 +\-disablesystemassertions
159.630 +.TP 3
159.631 +\-dsa
159.632 +鴻激鴻劫с≪泣若激с潟≦鴻障
159.633 .LP
159.634 .TP 3
159.635 -.B \-Xint
159.636 -インタプリタ専用モードで動作します。ネイティブコードへのコンパイルは
159.637 -無効になり、すべてのバイトコードがインタプリタによって実行されます。
159.638 -Java HotSpot VM 適応型コンパイラによって得られるパフォーマンス上の
159.639 -利点は、このモードでは実現されません。
159.640 +\-jar
159.641 +JAR <ゃ祉違絎茵障綣違莎桁鴻сJAR <ゃ障激с潟罘純JAR <ゃс鴻\f3Main\-Class:\fP\f4classname\fP\f3\fP綵√茵絎綽荀障\f2classname\fP ≪宴若激с潟紮篏臀罘純 \f2public\ static\ void\ main(String[]\ args)\fP <純鴻絎障JAR <ゃс鴻ゃjar(1)
159.642 +.na
159.643 +\f2Java ャ若≪\fP @
159.644 +.fi
159.645 +http://java.sun.com/docs/books/tutorial/jarTrail: Jar Filesс
159.646 +.LP
159.647 +激с潟篏睡絎 JAR <ゃ鴻若吟若鴻純若鴻若吟若鴻鴻祉荐絎∴障
159.648 +.LP
159.649 +Solaris 8 сjava \-jar激с潟у茵с JAR <ゃ絎茵罔祉篆障 java \-jar篏睡у茵純с
159.650 +.na
159.651 +\f2Java Archive (JAR) <ゃ\fP @
159.652 +.fi
159.653 +http://java.sun.com/javase/6/docs/technotes/guides/jar/index.htmlс
159.654 .TP 3
159.655 -.B \-Xbatch
159.656 -バックグラウンドコンパイルを無効にします。
159.657 -通常、VM ではメソッドをバックグラウンドタスクとしてコンパイルします。
159.658 -このとき、バックグラウンドコンパイルが終了するまでは、
159.659 -インタプリタモードでメソッドが実行されます。
159.660 -.B \-Xbatch
159.661 -フラグを使用すると、バックグラウンドコンパイルが
159.662 -無効になるため、すべてのメソッドのコンパイルは完了するまで
159.663 -フォアグラウンドのタスクとして処理されます。
159.664 +\-javaagent:jarpath[=options]
159.665 +Java 違潟域茯若吾с潟若障
159.666 +.na
159.667 +\f2java.lang.instrument\fP @
159.668 +.fi
159.669 +http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html с
159.670 .TP 3
159.671 -.B \-Xbootclasspath: bootclasspath
159.672 -ブートクラスファイルを探すため、ディレクトリ、JAR アーカイブ、および ZIP
159.673 -アーカイブをコロンで区切ったリストを指定します。指定されたパスに
159.674 -存在するブートクラスファイルは、JDK に含まれる
159.675 -ブートクラスファイルの代わりに使われます。
159.676 -注: rt.jar 内のクラスを上書きする目的でこのオプションを
159.677 -使用するアプリケーションは配備しないでください。
159.678 -配備すると、Java Runtime Environment
159.679 -バイナリコードライセンス違反になることがあります。
159.680 +\-verbose
159.681 .TP 3
159.682 -.B \-Xbootclasspath/a:path
159.683 -デフォルトのブートストラップクラスパスに追加するディレクトリ、
159.684 -.SM JAR
159.685 -アーカイブ、および
159.686 -.SM ZIP
159.687 -アーカイブのパスをコロンで区切って指定します。
159.688 +\-verbose:class
159.689 +鴻若潟鴻≪宴茵腓冴障
159.690 .TP 3
159.691 -.B \-Xbootclasspath/p:path
159.692 -デフォルトのブートストラップクラスパスの前に追加する
159.693 -ディレクトリ、
159.694 -.SM JAR
159.695 -アーカイブ、および
159.696 -.SM ZIP
159.697 -アーカイブのパスをコロンで区切って指定します。
159.698 -注: このオプションを、
159.699 -.B rt.jar
159.700 -内のクラスをオーバーライド
159.701 -する目的で使用するアプリケーションは指定しないでください。
159.702 -指定すると、Java Runtime Environment
159.703 -バイナリコードライセンス違反になることがあります。
159.704 +\-verbose:gc
159.705 +若吾潟激с潟ゃ潟榊潟怨障
159.706 .TP 3
159.707 -.B \-Xcheck:jni
159.708 -Java Native Interface (JNI) 機能に対して
159.709 -追加チェックを実行します。特に、Java 仮想マシン (JVM) は
159.710 -JNI 要求を処理する前に、JNI 機能に渡される
159.711 -パラメータおよび実行環境データを検証します。
159.712 -無効なデータを検出した場合、ネイティブコードに
159.713 -問題があると判断し、Java 仮想マシンは
159.714 -致命的なエラーで終了します。
159.715 -このオプションを使用すると、
159.716 -パフォーマンスが低下します。
159.717 +\-verbose:jni
159.718 +ゃc<純篏睡潟篁 Java Native Interface (JNI) ≪cc若≪宴怨障
159.719 .TP 3
159.720 -.B \-Xfuture
159.721 -厳密なクラスファイル形式の検査を実行します。下位互換性を維持
159.722 -するため、JDK の Virtual Machine で実行されるデフォルトの
159.723 -形式検査は、JDK ソフトウェアの 1.1.x バージョンで実行される検査よりも
159.724 -厳密ではありません。
159.725 -.B \-Xfuture
159.726 -フラグを使用すると、クラスファイル形式を
159.727 -より仕様に準拠したものにするための、さらに厳密なクラスファイル形式検査が
159.728 -有効になります。開発者が新しいコードを開発する際には、このフラグの
159.729 -使用を推奨します。Java アプリケーション起動ツールの
159.730 -将来のリリースでは、より厳密な検査がデフォルトになるからです。
159.731 +\-version
159.732 +若吾с恰宴茵腓冴腟篋障
159.733 .TP 3
159.734 -.B \-Xnoclassgc
159.735 -クラスのガベージコレクションを無効にします。
159.736 -このオプションを使用すると、ロード済みクラスからメモリが回復されることがなくなるため、全体的なメモリ使用量が増大します。この場合、アプリケーションによっては OutOfMemoryError がスローされる可能性があります。
159.737 +\-version:release
159.738 +潟潟茵絎鴻障 JAR <ゃ\f2release\fP ф絎若吾с潟綽荀腓冴障莎桁 java 潟潟若吾с潟絎絎鴻羣ら絎茖激鴻筝цゃc翫絎茖篏睡障
159.739 +.LP
159.740 +\f2release\fP с劫若吾с潟絎сс若吾с恰絖若違若吾с潟鴻絎с障若吾с恰絖ゃ若吾с括蚊腥榊純у阪c綵√綺鋌鴻с若吾с括蚊若吾с ID若吾с ID 緇≪鴻帥鴻 (*) 篁若吾с ID 緇壕 (+) 篁2 ゃ若吾с括蚊≪潟泣潟 (&) х障≪鴻帥鴻c剛眼壕垩絎若吾с割札筝≪潟泣潟 2 ゃ若吾с括蚊茫腥潟障箴腓冴障
159.741 +.nf
159.742 +\f3
159.743 +.fl
159.744 +\-version:"1.5.0_04 1.5*&1.5.1_02+"
159.745 +.fl
159.746 +\fP
159.747 +.fi
159.748 +筝荐潟若吾с 1.5.0_04障 1.5.1_02 篁ヤ 1.5 若吾с ID c鴻ゃ若吾с潟鴻障 JAR <ゃ綽荀с 若吾с恰絖ウ絲罕絎臂ゃJava Network Launching Protocol & API Specification (JSR\-56)Appendix Aс
159.749 +.LP
159.750 +JAR <ゃ翫絽吾若吾с活篁吟潟潟茵絎JAR <ゃс鴻絎ィ絅障
159.751 +.LP
159.752 +激с潟篏睡≪荀激惹宴ゃ緇菴違羈膀с
159.753 .TP 3
159.754 -.BI \-Xincgc
159.755 -インクリメンタルガベージコレクタを有効にします。
159.756 -インクリメンタルガベージコレクタは、デフォルトでは
159.757 -無効に設定されていますが、有効にするとプログラムの実行中の
159.758 -ガベージコレクションによる停止を防ぎます。
159.759 -インクリメンタルガベージコレクタは、場合によってはプログラムと同時に
159.760 -実行されます。同時に実行されている間は、プログラムで利用可能な
159.761 -プロセッサ能力が減少します。
159.762 +\-showversion
159.763 +若吾с恰宴茵腓冴膓茵障
159.764 .TP 3
159.765 -.B \-Xloggc:file
159.766 -.BR \-verbose:gc
159.767 -と同様、各ガベージコレクションイベントで
159.768 -レポートを作成し、このデータを
159.769 -.I file
159.770 -に記録します。
159.771 -.I \-verbose:gc
159.772 -により入手できる情報に加えて、レポートされるイベントには
159.773 -最初のガベージコレクションイベントからの経過時間 (秒数) が付けられます。
159.774 -.sp 1
159.775 -ネットワークの遅延による JVM の停止を避けるために、このファイルの
159.776 -記憶域として常にローカルファイルシステムを使用します。
159.777 -このファイルは、フルファイルシステムおよびロギングが不完全なファイル
159.778 -に追加される場合、切り詰められることがあります。
159.779 -コマンド行で
159.780 -.I \-verbose:gc
159.781 -といっしょに指定された場合、このオプションが優先されます。
159.782 +\-?
159.783 .TP 3
159.784 -.B \-Xmsn
159.785 -メモリ割り当てプールの初期サイズを指定します。
159.786 -指定する値は、1M バイトよりも大きな 1024 の倍数でなければなりません。
159.787 -文字
159.788 -.B k
159.789 -または
159.790 -.B K
159.791 -を付けると K バイト、文字
159.792 -.B m
159.793 -または
159.794 -.B M
159.795 -を付けると M バイトを表します。
159.796 -デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「HotSpot Ergonomics」を参照してください
159.797 +\-help
159.798 +篏睡羈茵腓冴腟篋障
159.799 +.TP 3
159.800 +\-X
159.801 +罔羣激с潟≪宴茵腓冴腟篋障
159.802 +.RE
159.803 +
159.804 +.LP
159.805 +.SS
159.806 +罔羣激с
159.807 +.LP
159.808 +.RS 3
159.809 +
159.810 +.LP
159.811 +.RS 3
159.812 +.TP 3
159.813 +\-Xint
159.814 +ゃ潟帥水≪若у篏障ゃc潟若吾潟潟ゃ≦鴻鴻ゃ潟若ゃ潟帥帥c絎茵障Java HotSpot VM 絲上潟潟ゃ箴若潟剛鴻≪若с絎憗障
159.815 +.TP 3
159.816 +\-Xbatch
159.817 +違潟潟潟ゃ≦鴻障絽吾VM с違潟潟潟ゃ腟篋障с<純違潟帥鴻潟潟ゃゃ潟帥帥≪若с<純絎茵障\f2\-Xbatch\fP 違絎違潟潟潟ゃ≦鴻鴻<純潟潟ゃ絎篋障с≪違潟帥鴻障
159.818 +.TP 3
159.819 +\-Xbootclasspath:bootclasspath
159.820 +若鴻<ゃ「cJAR ≪若ゃ ZIP ≪若ゃ潟潟у阪c鴻ф絎障絎鴻絖若鴻<ゃJava 2 SDK 障若鴻<ゃ篁c篏睡障\f2羈: rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava 2 Runtime Environment ゃ潟若ゃ祉潟拷障\fP
159.821 +.TP 3
159.822 +\-Xbootclasspath/a:path
159.823 +cJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪c絎障 鴻若鴻鴻鴻菴遵障
159.824 +.TP 3
159.825 +\-Xbootclasspath/p:path
159.826 +cJAR ≪若ゃ ZIP ≪若ゃ鴻潟潟у阪c絎障 鴻若鴻鴻鴻菴遵障\f2羈 rt.jar 鴻若若ゃс激с潟篏睡≪宴若激с潟激鴻臀сJava 2 Runtime Environment ゃ潟若ゃ祉潟拷障\fP
159.827 +.TP 3
159.828 +\-Xcheck:jni
159.829 +Java Native Interface (JNI) 罘純絲障菴遵с茵障隙Java 篁潟激潟 JNI 荀羆JNI ∽違羝<<若帥絎茵医若帥罎荐若障≦鴻若帥荀ゃc翫ゃc潟若馹腓冴Java 篁潟激潟翫順若榊腟篋障激с潟篏睡若潟剛筝篋潟障
159.830 +.TP 3
159.831 +\-Xfuture
159.832 +鴻<ゃ綵√ウ絲с障筝篏篋с篆ゃJava 2 SDK 篁潟激潟絎茵綵√сJDK 純с≪若吾с 1.1.x 絎茵с腮綺ウ絲c障\f3\-Xfuture\fP 違絎鴻<ゃ綵√篁罕吾羣綣桁ウ絲с鴻障Java ≪宴若激с活儀若絨ャ若鴻сウ絲с違潟若冴違篏睡с障
159.833 +.TP 3
159.834 +\-Xnoclassgc
159.835 +鴻若吾潟激с潟≦鴻障激с潟篏睡若羝帥鴻<≪若緇篏<≪寂戎紜紊с障翫≪宴若激с潟c OutOfMemoryError 鴻若醇с障
159.836 +.TP 3
159.837 +\-Xincgc
159.838 +ゃ潟<潟帥若吾潟帥鴻障ゃ潟<潟帥若吾潟帥с≦鴻c障 鴻違絎茵筝若吾潟激с潟筝罩≪榊障ゃ潟<潟帥若吾潟帥違絎茵翫違с祉笈遵篏筝障
159.839 +.TP 3
159.840 +\-Xloggc:file
159.841 +\-verbose:gc 罕若吾潟激с潟ゃ潟榊潟怨障若帥 \f2file\fP 荐蚊障\f2\-verbose:gc\fP 絎怨宴祉怨ゃ潟若吾潟激с潟ゃ潟腟 (腱篏) 篁障
159.842 +.LP
159.843 +若綽膈c JVM 絎茵綺篏筝帥<ゃ主絽吾若<ゃ激鴻<ゃ激鴻羣<ゃ荅違<ゃ若帥綣膓荐蚊障激с潟 \f2\-verbose:gc\fP 筝≧鴻潟潟茵絎翫激с潟障
159.844 +.LP
159.845 +.TP 3
159.846 +\-Xmsn
159.847 +<≪弱蚊綵若泣ゃ冴ゃ違ф絎障絎ゃ1M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 <ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
159.848 .br
159.849 -例:
159.850 +箴:
159.851 +.RS 3
159.852 +
159.853 .LP
159.854 -.RS 5
159.855 .nf
159.856 -\-Xms6291456
159.857 -\-Xms6144k
159.858 -\-Xms6m
159.859 +\f3
159.860 +.fl
159.861 + \-Xms6291456
159.862 +.fl
159.863 + \-Xms6144k
159.864 +.fl
159.865 + \-Xms6m
159.866 +.fl
159.867 +
159.868 +.fl
159.869 +\fP
159.870 .fi
159.871 .RE
159.872 .TP 3
159.873 -.B \-Xmxn
159.874 -メモリ割り当てプールの最大サイズをバイト単位で指定します。
159.875 -指定する値は、2M バイトよりも大きな 1024 の倍数でなければなりません。
159.876 -文字
159.877 -.B k
159.878 -または
159.879 -.B K
159.880 -を付けると K バイト、文字
159.881 -.B m
159.882 -または
159.883 -.B M
159.884 -を付けると M バイトを表します。
159.885 -デフォルト値は、実行時にシステムの設定に基づいて選択されます。詳細については、「HotSpot Ergonomics」を参照してください
159.886 +\-Xmxn
159.887 +<≪弱蚊綵若紊с泣ゃ冴ゃ違ф絎障絎ゃ2M ゃ紊с 1024 違違障ゃ絎絖 \f2k\fP 障 \f2K\fP 篁障 <ゃ絎絖 \f2m\fP 障 \f2M\fP 篁障ゃ絎茵激鴻荐絎冴ャ御障荅括完ゃHotSpot Ergonomicsс
159.888 .br
159.889 -例:
159.890 +箴:
159.891 +.RS 3
159.892 +
159.893 .LP
159.894 -.RS 5
159.895 .nf
159.896 -\-Xmx83886080
159.897 -\-Xmx81920k
159.898 -\-Xmx80m
159.899 +\f3
159.900 +.fl
159.901 + \-Xmx83886080
159.902 +.fl
159.903 + \-Xmx81920k
159.904 +.fl
159.905 + \-Xmx80m
159.906 +.fl
159.907 +
159.908 +.fl
159.909 +\fP
159.910 .fi
159.911 .RE
159.912 +Solaris 7 Solaris 8 SPARC 若翫ゃ筝 4000m 若若綣сSolaris 2.6 x86 若翫 2000m 若若綣сLinux 若翫筝 2000m 若若綣с
159.913 +.TP 3
159.914 +\-Xprof
159.915 +絎茵筝違<ゃ<ゃ潟違若帥罔羣阪阪障激с潟違榊若cc若箴障 腮弱激鴻с篏睡с障
159.916 .LP
159.917 -Solaris 7 および Solaris 8 SPARC プラットフォームの場合、この値の上限はおよそ 4000m からオーバーヘッドの量を引いたものであり、Solaris 2.6 および x86 プラットフォームの場合は 2000m からオーバーヘッドの量を引いたものです。
159.918 -Linux プラットフォームの場合の上限は、およそ
159.919 -2000m からオーバーヘッドの量を引いたものです。
159.920 .TP 3
159.921 -.BI \-Xprof
159.922 -実行中のプログラムのプロファイルを生成し、プロファイリングデータを
159.923 -標準出力に送ります。このオプションは、プログラム開発に役立つ
159.924 -ユーティリティとして提供されているもので、本番稼動システムでの使用を
159.925 -目的としたものではありません。
159.926 -.TP 3
159.927 -\-Xrs
159.928 -Java 仮想マシン (JVM) によるオペレーティングシステムシグナルの利用
159.929 -を減らします。
159.930 +\-Xrs
159.931 +Java 篁潟激 (JVM) 若c潟違激鴻激違篏睡羝障
159.932 .LP
159.933 -前回のリリースではシャットダウンフック機能が追加され、
159.934 -Java アプリケーションを順番にシャットダウンできるようになりました。
159.935 -この機能により、JVM が異常終了した場合でも、シャットダウン時に
159.936 -クリーンアップコード (データベース接続を閉じる、など) を
159.937 -実行できるようになりました。
159.938 +篁ュ若鴻сJava ≪宴若激с潟腱綺閫c激c潟激c潟罘純菴遵障罘純JVM 腦句篋翫с激c恰若吟若若潟≪潟若 (若帥若号・膓若冴) 絎茵с障
159.939 .LP
159.940 -Sun の JVM は、シグナルをキャッチして異常な JVM 終了
159.941 -に対するシャットダウンフックを実装します。JVM は、SIGHUP、SIGINT、SIGTERM を
159.942 -使用してシャットダウンフックの実行を開始します。
159.943 +Sun JVM 激違ccJVM 医幻腟篋激c潟絎茖障JVM SIGHUPSIGINT SIGTERM 篏睡激c潟絎茵紮障
159.944 .LP
159.945 -JVM では、同様の機構を使用して、1.2 以前のデバッグ用の
159.946 -スレッドスタックダンプ機能を実装しています。Sun の JVM は、
159.947 -SIGQUIT を使用してスレッドダンプを実行します。
159.948 +JVM 違с鴻鴻帥潟1.2 罘純絎憗罕罘罕篏睡障Sun JVM 鴻潟絎茵 SIGQUIT 篏睡障
159.949 .LP
159.950 -JVM を組み込んだアプリケーションは、SIGINT や SIGTERM のような
159.951 -シグナルを頻繁にトラップする必要があります。このような場合、JVM の
159.952 -シグナルハンドラとの間に干渉が発生する可能性があります。
159.953 -このような干渉を避けるために、\-Xrs コマンド行オプションを
159.954 -使用できます。
159.955 -Sun の JVM で \-Xrs が使用されると、SIGINT、SIGTERM、SIGHUP、
159.956 -および SIGQUIT のシグナルマスクは JVM によって変更されず、
159.957 -これらのシグナルのシグナルハンドラはインストールされません。
159.958 +JVM 莨若с≪宴若激с潟 SIGINT SIGTERM 激違紫綽荀JVM 激違潟冴醇с障\f3\-Xrs\fP 潟潟茵激с潟篏睡馹絲上с障Sun JVM 絲障 \f3\-Xrs\fP 篏睡SIGINTSIGTERMSIGHUP SIGQUIT 絲障激違鴻 JVM c紊眼激違絲障激違潟ゃ潟鴻若障
159.959 .LP
159.960 -\-Xrs を指定することによって、影響が 2 つあります。
159.961 +\f3\-Xrs\fP 絎翫罨< 2 ゃ綵演帥障
159.962 .RS 3
159.963 .TP 2
159.964 -*
159.965 -SIGQUIT スレッドダンプは使用できません。
159.966 +o
159.967 +SIGQUIT 鴻潟с
159.968 .TP 2
159.969 -*
159.970 -シャットダウンフックの実行は、ユーザコードが受け持ちます。
159.971 -たとえば JVM が終了するときに System.exit() を呼び出します。
159.972 -.TP
159.973 -.B \-Xssn
159.974 -スレッドスタックサイズを設定します。
159.975 -.TP
159.976 -.BI \-XX:+UseAltSigs
159.977 -VM ではデフォルトで
159.978 -.I SIGUSR1
159.979 -および
159.980 -.I SIGUSR2
159.981 -を使用しますが、
159.982 -.I SIGUSR1
159.983 -および
159.984 -.I SIGUSR2
159.985 -をシグナル連鎖するアプリケーションと
159.986 -競合する場合があります。
159.987 -.I \-XX:+UseAltSigs
159.988 -オプションは、VM にデフォルトとして
159.989 -.I SIGUSR1
159.990 -と
159.991 -.I SIGUSR2
159.992 -以外のシグナルを使用させます。
159.993 +o
159.994 +激c潟絎茵JVM 腟篋鴻 System.exit() 若喝冴若吟若潟若眼ц綽荀
159.995 +.RE
159.996 +.TP 3
159.997 +\-Xssn
159.998 +鴻鴻帥泣ゃ冴荐絎障
159.999 +.TP 3
159.1000 +\-XX:+UseAltSigs
159.1001 +VM с \f2SIGUSR1\fP \f2SIGUSR2\fP 篏睡障\f2SIGUSR1\fP \f2SIGUSR2\fP 激違i≪宴若激с潟 腴九翫障\f2\-XX:+UseAltSigs\fP 激с潟VM \f2SIGUSR1\fP \f2SIGUSR2\fP 篁ュ激違篏睡障
159.1002 +.RE
159.1003 +
159.1004 .LP
159.1005 -.SH "注"
159.1006 +.RE
159.1007 +.SH "羈"
159.1008 .LP
159.1009
159.1010 .LP
159.1011 -\f3\-version:\fP\f2release\fP コマンド行オプションでは、どんなに複雑にリリースを指定してもかまいません。ただし、現実的なリリース指定の限られたサブセットを使用するだけでも適切なポリシーを表現できるため、それらのサブセットのみが完全にサポートされます。それらのポリシーを次に示します。
159.1012 +\f3\-version:\fP\f2release\fP 潟潟茵激с潟с茲若鴻絎障障憜若号絎泣祉篏睡с激若茵憗с泣祉帥絎泣若障激若罨<腓冴障
159.1013 .RS 3
159.1014 .TP 3
159.1015 1.
159.1016 -任意のバージョン。これは、このオプションを使用しないことで表現できます。
159.1017 +篁紙若吾с潟 激с潟篏睡ц;憗с障
159.1018 .TP 3
159.1019 2.
159.1020 -ある特定のバージョン ID よりも大きい任意のバージョン。次に例を示します。
159.1021 +劫若吾с ID 紊с篁紙若吾с潟 罨<箴腓冴障
159.1022 .nf
159.1023 \f3
159.1024 .fl
159.1025 @@ -646,15 +440,20 @@
159.1026 \fP
159.1027 .fi
159.1028 .LP
159.1029 -この場合、1.5.0_03 よりも大きい任意のバージョンが使用されます。これは、指定されたバージョンで特定のインタフェースが導入された (あるいはそのバグが修正された) 場合に便利です。
159.1030 +翫1.5.0_03 紊с篁紙若吾с潟篏睡障 絎若吾с潟х劫ゃ潟帥с若鴻絨ャ (違篆罩c) 翫箴水с
159.1031 .TP 3
159.1032 3.
159.1033 -ある特定のバージョン ID よりも大きいバージョン。ただし、そのリリースファミリの上限によって制限するもの。次に例を示します。
159.1034 -.TP
159.1035 +劫若吾с ID 紊с若吾с潟 若鴻<筝c狗箴腓冴障
159.1036 +.nf
159.1037 +\f3
159.1038 +.fl
159.1039 "1.5.0_03+&1.5*"
159.1040 +.fl
159.1041 +\fP
159.1042 +.fi
159.1043 .TP 3
159.1044 4.
159.1045 -上の項目 2 または 3 の「OR」表現。次に例を示します。
159.1046 +筝 2 障 3 OR茵憗箴腓冴障
159.1047 .nf
159.1048 \f3
159.1049 .fl
159.1050 @@ -662,48 +461,45 @@
159.1051 .fl
159.1052 \fP
159.1053 .fi
159.1054 -これは項目 2 に似ていますが、ある変更が特定のリリース (1.5) で導入されたが、その同じ変更が以前のリリースのアップデートでも利用可能になった、という場合に便利です。
159.1055 + 2 篌若障紊眼劫若 (1.5) уャ紊眼篁ュ若鴻≪若с純c翫箴水с
159.1056 .RE
159.1057
159.1058 .LP
159.1059 -.SH "関連項目"
159.1060 +.SH "∫i"
159.1061 .LP
159.1062
159.1063 .LP
159.1064 .RS 3
159.1065 .TP 2
159.1066 -*
159.1067 -javac \- Java プログラム言語コンパイラ
159.1068 +o
159.1069 +javac(1)
159.1070 .TP 2
159.1071 -*
159.1072 -jdb \- Java アプリケーションデバッガ
159.1073 +o
159.1074 +jdb(1)
159.1075 .TP 2
159.1076 -*
159.1077 -javah \- C ヘッダとスタブファイルジェネレータ
159.1078 +o
159.1079 +javah(1)
159.1080 .TP 2
159.1081 -*
159.1082 -jar \- JAR アーカイブツール
159.1083 +o
159.1084 +jar(1)
159.1085 .TP 2
159.1086 -*
159.1087 +o
159.1088 +.na
159.1089 +\f2Java ≦宍罘純若若\fP @
159.1090 .fi
159.1091 -http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
159.1092 -の
159.1093 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
159.1094 +.TP 2
159.1095 +o
159.1096 .na
159.1097 -「\f2The Java Extensions Framework\fP」
159.1098 +\f2祉ャc若\fP @
159.1099 +.fi
159.1100 +http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
159.1101 .TP 2
159.1102 -*
159.1103 +o
159.1104 +.na
159.1105 +\f2HotSpot VM Specific Options\fP @
159.1106 .fi
159.1107 -http://java.sun.com/javase/6/docs/technotes/guides/security/index.html
159.1108 -の
159.1109 -.na
159.1110 -「\f2Security Features\fP」
159.1111 -.TP 2
159.1112 -*
159.1113 -.fi
159.1114 -http://java.sun.com/docs/hotspot/VMOptions.html
159.1115 -の
159.1116 -.na
159.1117 -「\f2HotSpot VM Specific Options\fP」
159.1118 +http://java.sun.com/docs/hotspot/VMOptions.html
159.1119 .RE
159.1120
159.1121 .LP
160.1 --- a/src/solaris/doc/sun/man/man1/ja/javac.1 Tue May 12 15:21:55 2009 +0900
160.2 +++ b/src/solaris/doc/sun/man/man1/ja/javac.1 Thu May 14 00:17:25 2009 -0700
160.3 @@ -1,4 +1,3 @@
160.4 -.'" t
160.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
160.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
160.7 ."
160.8 @@ -19,15 +18,46 @@
160.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
160.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
160.11 ." have any questions.
160.12 -." `
160.13 -.TH javac 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
160.14 -." Generated by html2man
160.15 +."
160.16 +.TH javac 1 "04 May 2009"
160.17 +." Generated from HTML by html2man (author: Eric Armstrong)
160.18
160.19 .LP
160.20 -.SH 名前
160.21 -javac \- Java プログラミング言語コンパイラ
160.22 +.SH ""
160.23 +javac \- Java 違潟域茯潟潟ゃ
160.24 .LP
160.25 -.SH "形式"
160.26 +.RS 3
160.27 +.TP 2
160.28 +o
160.29 +綵√
160.30 +.TP 2
160.31 +o
160.32 +茯
160.33 +.TP 2
160.34 +o
160.35 +激с
160.36 +.TP 2
160.37 +o
160.38 +潟潟茵綣違<ゃ
160.39 +.TP 2
160.40 +o
160.41 +羈
160.42 +.TP 2
160.43 +o
160.44 +罎膣
160.45 +.TP 2
160.46 +o
160.47 +違cゃ潟帥с若
160.48 +.TP 2
160.49 +o
160.50 +箴
160.51 +.TP 2
160.52 +o
160.53 +∫i
160.54 +.RE
160.55 +
160.56 +.LP
160.57 +.SH "綵√"
160.58 .LP
160.59
160.60 .LP
160.61 @@ -42,7 +72,7 @@
160.62
160.63 .LP
160.64 .LP
160.65 -引数は順不同です。
160.66 +綣違筝с
160.67 .LP
160.68 .RS 3
160.69
160.70 @@ -50,61 +80,61 @@
160.71 .RS 3
160.72 .TP 3
160.73 options
160.74 -コマンド行オプション
160.75 +潟潟茵激с潟
160.76 .TP 3
160.77 sourcefiles
160.78 -コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
160.79 +潟潟ゃ 1 や札筝純若鴻<ゃ (MyClass.java )
160.80 .TP 3
160.81 classes
160.82 -注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)。
160.83 +羈絲乗院 1 や札筝 (MyPackage.MyClass )
160.84 .TP 3
160.85 @argfiles
160.86 -オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では、\f2\-J\fP オプションは指定できません。
160.87 +激с潟純若鴻<ゃ 1 や札筝<ゃ<ゃ筝с\f2\-J\fP 激с潟絎с障
160.88 .RE
160.89
160.90 .LP
160.91 .RE
160.92 -.SH "機能説明"
160.93 +.SH "茯"
160.94 .LP
160.95
160.96 .LP
160.97 .LP
160.98 -\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
160.99 +\f3javac\fP 若Java 違潟域茯ц菴違鴻ゃ潟帥с若鴻絎臂茯水ゃ潟若鴻<ゃ潟潟ゃ障障Java 純若鴻<ゃ潟劫羈茵障
160.100 .LP
160.101 .LP
160.102 -ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
160.103 +純若鴻潟若<ゃ \f3javac\fP 羝<罨< 2 ゃ号障
160.104 .LP
160.105 .RS 3
160.106 .TP 2
160.107 o
160.108 -ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
160.109 +純若鴻<ゃ違絨翫<ゃ潟潟茵х贋・絎障
160.110 .TP 2
160.111 o
160.112 -ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
160.113 +純若鴻<ゃ違紊翫<ゃ腥榊純障壕у阪c1 ゃ<ゃ障罨<鴻<ゃ \f3@\fP 篁\f3javac\fP 潟潟茵ф絎障
160.114 .RE
160.115
160.116 .LP
160.117 .LP
160.118 -ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、\f2MyClass\fP という名前のクラスは、\f2MyClass.class\fP という名前のソースファイルに記述します。このソースファイルは、MyClass.class という名前のバイトコードクラスファイルにコンパイルされます。
160.119 +純若鴻潟若<ゃ \f2.java\fP ≦宍絖鴻<ゃ \f2.class\fP ≦宍絖c違障 障純若鴻<ゃ鴻<ゃ<荅峨鴻絲上若c違障違\f2MyClass\fP 鴻\f2MyClass.java\fP 純若鴻<ゃ荐菴違障 純若鴻<ゃ\f2MyClass.class\fP ゃ潟若鴻<ゃ潟潟ゃ障
160.120 .LP
160.121 .LP
160.122 -内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、\f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
160.123 +鴻絎臂菴遵鴻<ゃ障鴻<ゃ\f2MyClass$MyInnerClass.class\fP 紊劫劫腟水障
160.124 .LP
160.125 .LP
160.126 -ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、\f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
160.127 +純若鴻<ゃ宴若吾若c若臀綽荀障違鴻純若鴻<ゃ \f3/workspace\fP 臀翫\f2com.mysoft.mypack.MyClass\fP 純若鴻潟若 \f3/workspace/com/mysoft/mypack/MyClass.java\fP 綽荀障
160.128 .LP
160.129 .LP
160.130 -デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとの「オプション」を参照)。
160.131 +с潟潟ゃ鴻<ゃ絲上純若鴻<ゃc臀障ャ阪c絎\f3\-d\fP 篏睡障 (激с潟)
160.132 .LP
160.133 -.SH "オプション"
160.134 +.SH "激с"
160.135 .LP
160.136
160.137 .LP
160.138 .LP
160.139 -コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
160.140 +潟潟ゃ憜榊医с泣若絨ャ若鴻с泣若罔羣激с潟祉障篁ュ罔羣激с潟憜篁潟激潟潟潟潟ゃ絎茖堺激с潟с絨ャ紊眼醇с障罔羣激с潟\f3\-X\fP у障障
160.141 .LP
160.142 .SS
160.143 -標準オプション
160.144 +罔羣激с
160.145 .LP
160.146 .RS 3
160.147
160.148 @@ -112,162 +142,162 @@
160.149 .RS 3
160.150 .TP 3
160.151 \-Akey[=value]
160.152 -注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
160.153 +羈祉泣羝<激с潟javac c贋・茹i祉泣c篏睡障 \f2key\fP 1 ゃ障茲違茘ュ.у阪c絎
160.154 .TP 3
160.155 -\-cp path または \-classpath path
160.156 -ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、
160.157 +\-cp path 障 \-classpath path
160.158 +若吟若鴻<ゃ (翫c) 羈祉泣純若鴻<ゃ罎膣√贋絎障鴻鴻 \f3CLASSPATH\fP 医紊違若吟若鴻鴻若若ゃ障\f3CLASSPATH\fP\f3\-cp\fP\f3\-classpath\fP 絎翫若吟若鴻鴻憜c障荅括完
160.159 .na
160.160 -「\f2Setting the Class Path\fP」
160.161 +\f2鴻鴻荐絎\fP @
160.162 .fi
160.163 -(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
160.164 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
160.165 .LP
160.166 -\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
160.167 +\f3\-sourcepath\fP 激с潟絎翫純若鴻<ゃ若吟若鴻鴻罎膣≪障
160.168 .LP
160.169 -\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもクラスパス内で検索されます。
160.170 +\f3\-processorpath\fP 激с潟絎翫羈祉泣若吟若鴻鴻罎膣≪障
160.171 .LP
160.172 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じであるとみなされます。
160.173 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障
160.174 .br
160.175 .br
160.176 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。\f3注:\fP \ コマンド行環境の構成によっては、\f2javac \-cp "*.jar" MyClass.java\fP などのように、ワイルドカード文字を引用符で囲まなければならない場合があります。
160.177 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障\f3羈:\fP潟潟茵医罕c\f2javac \-cp "*.jar" MyClass.java\fP ゃ若絖綣膃у蚊障違翫障
160.178 .TP 3
160.179 \-Djava.ext.dirs=directories
160.180 -インストール型拡張機能の位置をオーバーライドします。
160.181 +ゃ潟鴻若≦宍罘純篏臀若若ゃ障
160.182 .TP 3
160.183 \-Djava.endorsed.dirs=directories
160.184 -承認された標準パスの位置をオーバーライドします。
160.185 +粋罔羣鴻篏臀若若ゃ障
160.186 .TP 3
160.187 \-d directory
160.188 -クラスファイルの出力先ディレクトリを設定します。このディレクトリはあらかじめ用意されている必要があります。\f3javac\fP はディレクトリの作成を行いません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
160.189 +鴻<ゃ阪c荐絎障cс絖綽荀障 \f3javac\fP c篏障鴻宴若吾筝с翫\f3javac\fP 綽荀綽c篏宴若後泣c鴻<ゃ臀障違\f3\-d /home/myclasses\fP 絎鴻 \f2com.mypackage.MyClass\fP с翫鴻<ゃ \f2/home/myclasses/com/mypackage/MyClass.class\fP 障
160.190 .LP
160.191 -\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
160.192 +\f3\-d\fP 絎c翫\f3javac\fP 鴻<ゃ純若鴻<ゃc主障
160.193 .LP
160.194 -\f3注:\fP \ \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
160.195 +\f3羈:\fP\f3\-d\fP ф絎c若吟若鴻鴻菴遵障
160.196 .TP 3
160.197 \-deprecation
160.198 -推奨されないメンバやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
160.199 +ィ絅<潟若鴻篏睡障若若ゃ潟茯茵腓冴障\f3\-deprecation\fP 絎翫\f3javac\fP ィ絅<潟若鴻篏睡障若若ゃ純若鴻<ゃ荀膣茵腓冴障\f3\-deprecation\fP \f3\-Xlint:deprecation\fP ヨ;荐с
160.200 .TP 3
160.201 \-encoding encoding
160.202 -ソースファイルのエンコーディング名 (\f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
160.203 +純若鴻<ゃ潟潟若c潟医 (\f2EUC\-JP\fP \f2UTF\-8\fP ) 絎障\f3\-encoding\fP 絎翫若潟潟若帥篏帥障
160.204 .TP 3
160.205 \-g
160.206 -局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
160.207 +絮紊違鴻井宴障с茵垩潟純若鴻<ゃ宴障
160.208 .TP 3
160.209 \-g:none
160.210 -デバッグ情報を生成しません。
160.211 +井宴障
160.212 .TP 3
160.213 \-g:{keyword list}
160.214 -コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
160.215 +潟潟у阪若若鴻絎劫腮蕁井宴障罨<若若鴻с
160.216 .RS 3
160.217 .TP 3
160.218 source
160.219 -ソースファイルのデバッグ情報
160.220 +純若鴻<ゃ井
160.221 .TP 3
160.222 lines
160.223 -行番号のデバッグ情報
160.224 +茵垩井
160.225 .TP 3
160.226 vars
160.227 -局所変数のデバッグ情報
160.228 +絮紊違井
160.229 .RE
160.230 .TP 3
160.231 \-help
160.232 -標準オプションの形式を表示します。
160.233 +罔羣激с潟綵√茵腓冴障
160.234 .TP 3
160.235 \-implicit:{class,none}
160.236 -暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。
160.237 +藥若純若鴻<ゃ絲障鴻<ゃ九勝障鴻<ゃ\f3\-implicit:class\fP 篏睡障鴻<ゃ吟\f3\-implicit:none\fP 篏睡障 激с潟絎c翫篏鴻<ゃ障翫鴻<ゃ羈絎茵潟潟ゃ茘肴障 激с潟腓榊荐絎翫茘肴障 罎膣≪с
160.238 .TP 3
160.239 \-nowarn
160.240 -警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
160.241 +茘<祉若吾≦鴻障 \f3\-Xlint:none\fP 潟с
160.242 .TP 3
160.243 \-proc: {none,only}
160.244 -注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
160.245 +羈潟潟ゃ筝≧鴻絎茵九勝障\f3\-proc:none\fP 羈с潟潟ゃ絎茵潟障\f3\-proc:only\fP 羈絎茵緇膓潟潟ゃ障c鎘茵潟障
160.246 .TP 3
160.247 \-processor class1[,class2,class3...]
160.248 -実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
160.249 +絎茵羈祉泣絎翫罎膣√ャ障
160.250 .TP 3
160.251 \-processorpath path
160.252 -注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
160.253 +羈祉泣罎膣√贋絎障 激с潟篏睡c翫鴻劫с祉泣罎膣≪茵障
160.254 .TP 3
160.255 \-s dir
160.256 -生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
160.257 +純若鴻<ゃ主c絎障cс絖綽荀障 \f3javac\fP 篏障鴻宴若吾筝c翫潟潟ゃ純若鴻<ゃ宴若後泣c主障 綽荀綽c篏障違若吟若 \f3\-s /home/mysrc\fP 絎鴻 \f2com.mypackage.MyClass\fP сc翫純若鴻<ゃ \f2/home/mysrc/com/mypackage/MyClass.java\fP 主障
160.258 .TP 3
160.259 \-source release
160.260 -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
160.261 +篁純若鴻潟若若吾с潟絎障\f2release\fP 罨<ゃ絎с障
160.262 .RS 3
160.263 .TP 3
160.264 1.3
160.265 -このコンパイラでは、JDK 1.3 以降に導入されたアサーション、汎用機能、または他の言語機能をサポート\f2しません\fP。
160.266 +潟潟ゃсJDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
160.267 .TP 3
160.268 1.4
160.269 -JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
160.270 +JDK 1.4 уャ≪泣若激с潟潟若篁障
160.271 .TP 3
160.272 1.5
160.273 -JDK 5 で導入された汎用機能および他の言語機能を含んだコードを受け付けます。
160.274 +JDK 5 уャ膩霡違割荐茯罘純潟若篁障
160.275 .TP 3
160.276 5
160.277 -1.5 と同義です。
160.278 +1.5 臂с
160.279 .TP 3
160.280 1.6
160.281 -これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
160.282 +ゃсJava SE 6 с荐茯絲障紊眼絨ャ障с純若鴻<ゃ潟潟若c潟違若篁ュ茘с若怨障
160.283 .TP 3
160.284 6
160.285 -1.6 と同義です。
160.286 +1.6 臂с
160.287 .RE
160.288 .TP 3
160.289 \-sourcepath sourcepath
160.290 -クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。 ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
160.291 +鴻障ゃ潟帥с若鴻絎臂罎膣≪純若鴻潟若鴻絎障若吟若鴻鴻罕純若鴻鴻茲違潟潟 (\f3:\fP) у阪障 純若鴻鴻潟cJAR ≪若ゃ障 ZIP ≪若ゃ絎с障宴若吾篏帥c翫c障≪若ゃ若劫宴若後違障
160.292 .LP
160.293 -\f3注:\fP \ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
160.294 +\f3羈:\fP\ 鴻鴻鴻с純若鴻荀ゃc翫鴻潟潟ゃ絲乗院障罎膣≪с
160.295 .TP 3
160.296 \-verbose
160.297 -詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
160.298 +荅括完阪茵腓冴障若鴻潟潟潟ゃ純若鴻<ゃ宴阪障
160.299 .TP 3
160.300 \-X
160.301 -非標準オプションに関する情報を表示して終了します。
160.302 +罔羣激с潟≪宴茵腓冴腟篋障
160.303 .RE
160.304
160.305 .LP
160.306 .RE
160.307 .SS
160.308 -クロスコンパイルオプション
160.309 +鴻潟潟ゃ激с
160.310 .LP
160.311 .RS 3
160.312
160.313 .LP
160.314 .LP
160.315 -デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「\f2クロスコンパイル\fP」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。
160.316 +с鴻潟潟ゃ\f3javac\fP 羞私若若鴻鴻恰≦宍罘純鴻絲障茵障\f3javac\fP 違 Java 若絎茖若鴻鴻恰≦宍罘純鴻絲障潟潟ゃ茵鴻潟潟ゃ泣若障鴻潟潟ゃ茵翫\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥荀с 鴻潟潟ゃ箴с
160.317 .LP
160.318 .RS 3
160.319 .TP 3
160.320 \-target version
160.321 -指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、および \f31.6\fP (\f36\fP も可) です。
160.322 +絎若吾с潟 VM 帥若蚊鴻<ゃ障鴻<ゃ絎帥若蚊篁ラ若吾с潟с篏障若吾с潟 VM с篏障鴻帥若蚊\f31.1\fP\f31.2\fP\f31.3\fP\f31.4\fP\f31.5\fP (\f35\fP ) \f31.6\fP (\f36\fP ) с
160.323 .LP
160.324 -\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
160.325 +\f3\-target\fP 罨< \f3\-source\fP ゃc羆冴障障
160.326 .RS 3
160.327 .TP 2
160.328 o
160.329 -\-source が\f3指定されなかった\fP場合、\-target の値は \f31.6\fP になります。
160.330 +\-source \f3絎c\fP翫\-target ゃ \f31.6\fP 障
160.331 .TP 2
160.332 o
160.333 -\-source が \f31.2\fP の場合、\-target の値は \f31.4\fP になります。
160.334 +\-source \f31.2\fP 翫\-target ゃ \f31.4\fP 障
160.335 .TP 2
160.336 o
160.337 -\-source が \f31.3\fP の場合、\-target の値は \f31.4\fP になります。
160.338 +\-source \f31.3\fP 翫\-target ゃ \f31.4\fP 障
160.339 .TP 2
160.340 o
160.341 -\-source が\f3それ以外の値の場合はすべて\fP、\-target の値は \f3\-source\fP の値になります。
160.342 +\-source \f3篁ュゃ翫鴻\fP\\\-target ゃ \f3\-source\fP ゃ障
160.343 .RE
160.344 .TP 3
160.345 \-bootclasspath bootclasspath
160.346 -指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
160.347 +絎筝c若鴻絲障鴻潟潟ゃ茵障若吟若鴻鴻罕若鴻鴻茲違潟潟 (\f3:\fP) у阪障 若鴻鴻潟cJAR ≪若ゃ障 ZIP ≪若ゃ絎с障
160.348 .TP 3
160.349 \-extdirs directories
160.350 -指定された拡張機能ディレクトリに対してクロスコンパイルを行います。\f2directories\fP には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。
160.351 +絎≦宍罘純c絲障鴻潟潟ゃ茵障\f2directories\fP 潟潟у阪cc鴻絎障絎c JAR ≪若ゃ鴻<ゃ罎膣≪障
160.352 .RE
160.353
160.354 .LP
160.355 .RE
160.356 .SS
160.357 -非標準オプション
160.358 +罔羣激с
160.359 .LP
160.360 .RS 3
160.361
160.362 @@ -275,37 +305,37 @@
160.363 .RS 3
160.364 .TP 3
160.365 \-Xbootclasspath/p:path
160.366 -ブートストラップクラスパスの前に追加します。
160.367 +若鴻鴻鴻菴遵障
160.368 .TP 3
160.369 \-Xbootclasspath/a:path
160.370 -ブートストラップクラスパスの後ろに追加します。
160.371 +若鴻鴻鴻緇菴遵障
160.372 .TP 3
160.373 \-Xbootclasspath/:path
160.374 -ブートストラップクラスファイルの位置をオーバーライドします。
160.375 +若鴻鴻<ゃ篏臀若若ゃ障
160.376 .TP 3
160.377 \-Xlint
160.378 -推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告が推奨されています。
160.379 +ィ絅鴻茘鴻障若鴻с純鴻茘ィ絅障
160.380 .TP 3
160.381 \-Xlint:none
160.382 -Java 言語仕様では指定されていないすべての警告を無効にします。
160.383 +Java 荐茯篁罕с絎鴻茘≦鴻障
160.384 .TP 3
160.385 \-Xlint:\-name
160.386 -警告 \f2name\fP を無効にします。ただし、\f2name\fP は、\f3\-Xlint:\fP\f2name\fP に使用できる警告名のいずれかになります。この警告名は次のとおりです。
160.387 +茘 \f2name\fP ≦鴻障 \f2name\fP \f3\-Xlint:\fP\f2name\fP 篏睡с茘障 茘罨<с
160.388 .TP 3
160.389 \-Xlint:unchecked
160.390 -Java 言語仕様で指定されている未検査変換警告の詳細を示します。
160.391 +Java 荐茯篁罕ф絎罎糸茘荅括完腓冴障
160.392 .TP 3
160.393 \-Xlint:path
160.394 -存在しないパス (classpath、sourcepath など) ディレクトリについて警告します。
160.395 +絖 (classpathsourcepath ) cゃ茘障
160.396 .TP 3
160.397 \-Xlint:serial
160.398 -\f2serialVersionUID\fP 定義が直列化可能クラスにないことを警告します。
160.399 +\f2serialVersionUID\fP 絎臂翫純鴻茘障
160.400 .TP 3
160.401 \-Xlint:finally
160.402 -正常に完了できない \f2finally\fP 節について警告します。
160.403 +罩e幻絎篋с \f2finally\fP 膀ゃ茘障
160.404 .TP 3
160.405 \-Xlint:fallthrough
160.406 -fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
160.407 +fall\-through 宴若鴻 \f2switch\fP с罎冴絲障茘<祉若吾茵腓冴障Fall\-through 宴若鴻\f2switch\fP 緇宴若鴻ゃ宴若鴻с 潟若 \f2break\fP 障障 潟若絎茵宴若鴻罨<宴若鴻悟Щ障違 \f2switch\fP \f2case 1\fP 膓潟若\f2break\fP хc障
160.408 .RS 3
160.409
160.410 .LP
160.411 @@ -331,34 +361,34 @@
160.412 \fP
160.413 .fi
160.414 .RE
160.415 -このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
160.416 +潟若潟潟ゃ \f2\-Xlint:fallthrough\fP 違篏睡翫潟潟ゃ 綵荅蚊宴若鴻茵垩fall\-through 宴若鴻醇с腓冴茘肴障
160.417 .TP 3
160.418 -\-Xmaxerrors number
160.419 -印刷するエラーの最大数を設定します。
160.420 +\-Xmaxerrs number
160.421 +医激若紊ф違荐絎障
160.422 .TP 3
160.423 \-Xmaxwarns number
160.424 -印刷する警告の最大数を設定します。
160.425 +医激茘紊ф違荐絎障
160.426 .TP 3
160.427 \-Xstdout filename
160.428 -コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
160.429 +潟潟ゃ<祉若吾絎<ゃ障с潟潟ゃ<祉若吾 \f2System.err\fP 障
160.430 .TP 3
160.431 \-Xprefer:{newer,source}
160.432 -ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。\f2SOURCE\fP の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにしたい場合は、\f2\-Xprefer:source\fP を使用してください。
160.433 +絲障純若鴻<ゃ鴻<ゃ筝≧鴻荀ゃc翫<<ゃ茯水鴻絎障 (罎膣≪)\f2\-Xprefer:newer\fP 篏睡翫絲障純若鴻<ゃ鴻<ゃ違鴻茯水障 ()\f2\-Xprefer:source\fP激с潟篏睡翫純若鴻<ゃ茯水障\f2SOURCE\fP 篆絖激若篏帥c絎h羈篁紙羈祉泣≪祉鴻с翫\f2\-Xprefer:source\fP篏睡
160.434 .TP 3
160.435 \-Xprint
160.436 -指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
160.437 +絎鴻茵憗亥у阪障 羈潟潟ゃ<絎茵障阪綵√紊眼醇с障
160.438 .TP 3
160.439 \-XprintProcessorInfo
160.440 -ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
160.441 +劫祉泣箴若羈≪宴阪障
160.442 .TP 3
160.443 \-XprintRounds
160.444 -初回および後続の注釈処理ラウンドに関する情報を出力します。
160.445 +喝膓羈潟≪宴阪障
160.446 .RE
160.447
160.448 .LP
160.449 .RE
160.450 .SS
160.451 -\-J オプション
160.452 +\-J 激с
160.453 .LP
160.454 .RS 3
160.455
160.456 @@ -366,34 +396,34 @@
160.457 .RS 3
160.458 .TP 3
160.459 \-Joption
160.460 -\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリは 48M バイトに設定されます。このオプションは \f3\-X\fP で始まっていませんが、\f3javac\fP の「標準オプション」ではありません。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
160.461 +\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟 \f3\-X\fP у障c障\f3javac\fP 罔羣激с潟с障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
160.462 .LP
160.463 -\f3注:\fP \ \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものでは\f2ありません\fP。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
160.464 +\f3羈:\fP \ \f3CLASSPATH\fP\f3\-classpath\fP\f3\-bootclasspath\fP \f3\-extdirs\fP \f3javac\fP 絎茵篏帥鴻絎с障号с潟潟ゃ絎茖篏絽吾≧潟с絽吾演冴篌眼障号篏帥綽荀翫\f3\-J\fP 激с潟篏帥c綽荀激с潟緇 \f3java\fP 莎桁若羝<
160.465 .RE
160.466
160.467 .LP
160.468 .RE
160.469 -.SH "コマンド行引数ファイル"
160.470 +.SH "潟潟茵綣違<ゃ"
160.471 .LP
160.472
160.473 .LP
160.474 .LP
160.475 -javac のコマンド行を短くしたり簡潔にしたりするために、\f2javac\fP コマンドに対する引数 (\f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
160.476 +\f2javac\fP 潟潟茵膂≧\f2javac\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) 1 や札筝<ゃ絎с障号篏帥若c潟違激鴻筝с篁紙激 javac 潟潟篏с障
160.477 .LP
160.478 .LP
160.479 -引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
160.480 +綣違<ゃjavac 激с潟純若鴻<ゃ宴腟水荐菴違с障<ゃ綣違鴻若鴻障壕у阪障<ゃ腥榊純障翫<ゃ篏篋綣膃у蚊帥障
160.481 .LP
160.482 .LP
160.483 -引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、\f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
160.484 +綣違<ゃ<ゃ憜c荀後障鴻障綣違<ゃ篏臀荀後障鴻с障綣違<ゃ<ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
160.485 .LP
160.486 .LP
160.487 -javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
160.488 +javac 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障javac \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
160.489 .LP
160.490 .SS
160.491 -例 \- 引数ファイルを 1 つ指定
160.492 +綣違<ゃ 1 ゆ絎箴
160.493 .LP
160.494 .LP
160.495 -\f2argfile\fP という名前の引数ファイルにすべての javac 引数を格納する場合は、次のように指定します。
160.496 +\f2argfile\fP 綣違<ゃ鴻 javac 綣違主翫罨<絎障
160.497 .LP
160.498 .nf
160.499 \f3
160.500 @@ -406,16 +436,16 @@
160.501
160.502 .LP
160.503 .LP
160.504 -この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
160.505 +綣違<ゃ罨<箴хず 2 ゃ<ゃ絎鴻筝≧鴻ャс障
160.506 .LP
160.507 .SS
160.508 -例 \- 引数ファイルを 2 つ指定
160.509 +綣違<ゃ 2 ゆ絎箴
160.510 .LP
160.511 .LP
160.512 -たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
160.513 +違javac 激с括 1 <ゃ純若鴻<ゃ 1 <ゃ2 ゃ綣違<ゃ篏с障鴻с茵膓膓絖篏睡障
160.514 .LP
160.515 .LP
160.516 -以下の内容を含む \f2options\fP という名前のファイルを作成します。
160.517 +篁ヤ絎鴻 \f2options\fP <ゃ篏障
160.518 .LP
160.519 .nf
160.520 \f3
160.521 @@ -433,7 +463,7 @@
160.522
160.523 .LP
160.524 .LP
160.525 -以下の内容を含む \f2classes\fP という名前のファイルを作成します。
160.526 +篁ヤ絎鴻 \f2classes\fP <ゃ篏障
160.527 .LP
160.528 .nf
160.529 \f3
160.530 @@ -451,7 +481,7 @@
160.531
160.532 .LP
160.533 .LP
160.534 -次のコマンドを使用して \f3javac\fP を実行します。
160.535 +罨<潟潟篏睡 \f3javac\fP 絎茵障
160.536 .LP
160.537 .nf
160.538 \f3
160.539 @@ -464,10 +494,10 @@
160.540
160.541 .LP
160.542 .SS
160.543 -例 \- パス付きの引数ファイル
160.544 +剛綣違<ゃ箴
160.545 .LP
160.546 .LP
160.547 -引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fP や \f2path2\fP から見た相対パスではありません。
160.548 +綣違<ゃ鴻絎с障 <ゃ絎<ゃ憜篏罐c荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
160.549 .LP
160.550 .nf
160.551 \f3
160.552 @@ -479,81 +509,85 @@
160.553 .fi
160.554
160.555 .LP
160.556 -.SH "注釈処理"
160.557 +.SH "羈"
160.558 .LP
160.559
160.560 .LP
160.561 .LP
160.562 -\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
160.563 +\f3javac\fP 羈贋・泣若腴羈若с \f3apt\fP 篏睡綽荀障
160.564 .LP
160.565 .LP
160.566 -注釈処理の API は、\f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
160.567 +羈 API \f2javax.annotation.processing\fP \f2javax.lang.model\fP 宴若吾泣宴若後絎臂障
160.568 .LP
160.569 .SS
160.570 -注釈処理の概要
160.571 +羈网荀
160.572 .LP
160.573 .LP
160.574 -\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META_INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
160.575 +\f3\-proc:none\fP 激с潟c羈≦劫潟潟ゃ篏睡純鴻羈祉泣罎膣≪障罎膣≪鴻 \f3\-processorpath\fP 激с潟篏帥c絎с障 罎膣≪鴻絎c翫若吟若鴻鴻篏睡障祉泣罎膣≪罎膣≪剛
160.576 +.br
160.577 +\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
160.578 +.br
160.579 +泣若鴻ゃ罕<ゃ冴ャ茵障<ゃ篏睡鴻羈祉泣1 茵 1 ゃゅ障ャ号\f3\-processor\fP 激с潟篏帥c祉泣腓榊絎с障
160.580 .LP
160.581 .LP
160.582 -コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。 その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
160.583 +潟潟ゃ潟潟茵純若鴻<ゃ鴻莎井祉с羈絖腆肴腟祉泣絲障茵祉泣羈с腆肴障筝眼荀ゃc翫祉泣若喝冴障祉泣荳羈荀羆с障 翫羈絲障ャ祉泣荀ゃ荅帥茵障鴻羈荀羆障潟潟ゃ篁ヤ祉泣罎膣≪茵障
160.584 .LP
160.585 .LP
160.586 -いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
160.587 +祉泣c違純若鴻<ゃ羈 2 潟紮障違鴻純若鴻<ゃ莎井祉罕羈障篁ュ潟у若喝冴祉泣鴻緇膓潟с若喝冴障違純若鴻<ゃ障х障
160.588 .LP
160.589 .LP
160.590 -あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
160.591 +潟ф違純若鴻<ゃc翫羈祉泣 1 若喝冴綽荀絎茵罘篌筝障 緇\f3\-proc:only\fP 激с潟篏睡潟潟ゃ純若鴻<ゃ鴻純若鴻<ゃ潟潟ゃ障
160.592 .LP
160.593 .SS
160.594 -暗黙的にロードされたソースファイル
160.595 +藥若純若鴻<ゃ
160.596 .LP
160.597 .LP
160.598 -コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードしなければならない場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
160.599 +潟潟ゃ筝c純若鴻<ゃ潟潟ゃャ純若鴻<ゃ藥若違翫障 (罎膣≪)<ゃ憝鴻с羈絲乗院障с羈絎茵ゆ藥若純若鴻<ゃ 1 ゃс潟潟ゃ翫潟潟ゃ茘肴障茘吟号ゃ\-implicit 激с潟с
160.600 .LP
160.601 -.SH "型の検索"
160.602 +.SH "罎膣"
160.603 .LP
160.604
160.605 .LP
160.606 .LP
160.607 -ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
160.608 +純若鴻<ゃ潟潟ゃ翫潟潟茵ф絎純若鴻<ゃ絎臂荀ゃ潟潟ゃ絽吾≪宴綽荀障潟潟ゃ純若鴻<ゃт戎鴻障ゃ潟帥с若鴻≦宍鴻障ゃ潟帥с若鴻絎茖鴻障ゃ潟帥с若鴻鴻ゃ宴綽荀障純若鴻<ゃф腓榊荐膓帥宴箴鴻ゃ潟帥с若鴻障障
160.609 .LP
160.610 .LP
160.611 -たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、アプレットの祖先のクラス (\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP) を使用していることになります。
160.612 +違\f3java.applet.Applet\fP 泣鴻翫\f3≪\fP腑刻\f3java.awt.Panel\fP\f3java.awt.Container\fP\f3java.awt.Component\fP\f3java.lang.Object\fP鐚篏睡障
160.613 .LP
160.614 .LP
160.615 -コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、
160.616 +潟潟ゃ宴綽荀絎臂純若鴻<ゃ障鴻<ゃ「障障若鴻鴻≦宍罘純鴻罎膣≪膓若吟若鴻 (с潟c) 罎膣≪障若吟若鴻鴻\f3CLASSPATH\fP 医紊違荐絎絎臂障 \f3\-classpath\fP 潟潟茵激с潟篏帥c荐絎障荅括完
160.617 .na
160.618 -「\f2Setting the Class Path\fP」
160.619 +\f2鴻鴻荐絎\fP @
160.620 .fi
160.621 -(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
160.622 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathс
160.623 .LP
160.624 .LP
160.625 -\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
160.626 +\-sourcepath 激с潟絎翫潟潟ゃ絎鴻純若鴻<ゃ罎膣≪障 篁ュ翫若吟若鴻鴻鴻<ゃ純若鴻<ゃ筝≧鴻罎膣≪障
160.627 .LP
160.628 .LP
160.629 -\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。このあとの「クロスコンパイルオプション」を参照してください。
160.630 +\f3\-bootclasspath\fP 激с潟 \f3\-extdirs\fP 激с潟篏帥ャ若鴻鴻≦宍罘純鴻絎с障 鴻潟潟ゃ激с潟с
160.631 .LP
160.632 .LP
160.633 -型の検索に成功した場合の結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
160.634 +罎膣≪緇腟鴻<ゃ純若鴻<ゃ障筝≧鴻с翫障筝≧鴻荀ゃc翫<篏睡鴻 \-Xprefer 激с潟с潟潟ゃ腓冴с障\f3newer\fP 絎翫潟潟ゃ 2 ゃ<ゃ違鴻篏睡障\f3source\fP 絎翫潟潟ゃ純若鴻<ゃ篏睡障 \f3newer\fP с
160.635 .LP
160.636 .LP
160.637 -型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
160.638 +罎膣∵篏c障 \f3\-Xprefer\fP 荐絎腟綽荀純若鴻<ゃ荀ゃc翫潟潟ゃ純若鴻<ゃ茯水綽荀宴緇障潟潟ゃс純若鴻<ゃ潟潟ゃ茵障\-implicit 激с潟篏帥違篏絎с障\f3none\fP 絎翫純若鴻<ゃ鴻<ゃ障\f3class\fP 絎翫純若鴻<ゃ鴻<ゃ障
160.639 .LP
160.640 .LP
160.641 -コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識する場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
160.642 +潟潟ゃ羈絎篋緇宴綽荀с茯茘翫障宴純若鴻<ゃ荀ゃ \f3\-implicit\fP 激с潟絎翫<ゃ羈絲乗院潟潟ゃ潟潟ゃ若吟若茘障茘≦鴻(<ゃ羈絲乗院) <ゃ潟潟茵絎純若鴻<ゃ絲障鴻<ゃ鴻 \f3\-implicit\fP 激с潟篏帥c絎障
160.643 .LP
160.644 -.SH "プログラマティックインタフェース"
160.645 +.SH "違cゃ潟帥с若"
160.646 .LP
160.647
160.648 .LP
160.649 .LP
160.650 -\f3javac\fP は、\f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
160.651 +\f3javac\fP \f2javax.tools\fP 宴若後鴻ゃ潟帥с若鴻c絎臂違 Java Compiler API 泣若障
160.652 .LP
160.653 .SS
160.654 -例
160.655 +箴
160.656 .LP
160.657 .LP
160.658 -コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
160.659 +潟潟茵絎綣違篏帥c潟潟ゃ絎茵罨<潟若篏睡障
160.660 .LP
160.661 .nf
160.662 \f3
160.663 @@ -569,22 +603,22 @@
160.664
160.665 .LP
160.666 .LP
160.667 -この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
160.668 +翫罔羣阪鴻若鴻荐堺<祉若吾吾冴潟潟茵若喝冴 \f3javac\fP 菴腟篋潟若菴障
160.669 .LP
160.670 .LP
160.671 -\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
160.672 +\f2javax.tools.JavaCompiler\fP ゃ潟帥с若剛祉<純篏帥違荐堺<祉若吾<ゃ茯水/吾莨若水九勝茵障
160.673 .LP
160.674 .SS
160.675 -旧式のインタフェース
160.676 +уゃ潟帥с若
160.677 .LP
160.678 .RS 3
160.679
160.680 .LP
160.681 .LP
160.682 -\f3注:\fP \ この API は、下位互換性を確保するためだけに残されています。新しいコードでは、必ず前述の Java Compiler API を使用してください。
160.683 +\f3羈:\fP \ API 筝篏篋с腆坂罧障 違潟若с綽菴違 Java Compiler API 篏睡
160.684 .LP
160.685 .LP
160.686 -\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。それらを次に示します。
160.687 +\f2com.sun.tools.javac.Main\fP 鴻違潟潟ゃ若喝冴 static <純 2 ょ障 罨<腓冴障
160.688 .LP
160.689 .nf
160.690 \f3
160.691 @@ -600,28 +634,28 @@
160.692
160.693 .LP
160.694 .LP
160.695 -\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。その概要については、前出の「形式」節を参照してください。
160.696 +\f2args\fP <若帥javac 違絽御検篁紙潟潟茵綣違茵障 网荀ゃ冴綵√膀с
160.697 .LP
160.698 .LP
160.699 -\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
160.700 +\f2out\fP <若帥潟潟ゃ荐堺<祉若吾阪腓冴障
160.701 .LP
160.702 .LP
160.703 -戻り値は、\f3javac\fP の終了値と同じです。
160.704 +祉ゃ\f3javac\fP 腟篋ゃс
160.705 .LP
160.706 .LP
160.707 -名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれる\f3その他の\fPクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
160.708 + \f2com.sun.tools.javac\fP у障宴若 (綣 \f2com.sun.tools.javac\fP 泣宴若吾ャ) 障\f3篁\fP鴻<純絎сゃс紊眼醇с障
160.709 .LP
160.710 .RE
160.711 -.SH "例"
160.712 +.SH "箴"
160.713 .LP
160.714 .SS
160.715 -簡単なプログラムのコンパイル
160.716 +膂≦違潟潟ゃ
160.717 .LP
160.718 .RS 3
160.719
160.720 .LP
160.721 .LP
160.722 -\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。\f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
160.723 +\f2Hello.java\fP 純若鴻<ゃс\f3greetings.Hello\fP 鴻絎臂障\f2greetings\fP c純若鴻<ゃ鴻<ゃ筝≧鴻宴若吾cс憜c筝障箴с若吟若鴻鴻篏睡с障障\f3\-d\fP 篏帥cャ阪c絎綽荀障
160.724 .LP
160.725 .RS 3
160.726
160.727 @@ -679,13 +713,13 @@
160.728 .LP
160.729 .RE
160.730 .SS
160.731 -複数のソースファイルのコンパイル
160.732 +茲違純若鴻<ゃ潟潟ゃ
160.733 .LP
160.734 .RS 3
160.735
160.736 .LP
160.737 .LP
160.738 -次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
160.739 +罨<箴с宴若 \f2greetings\fP 鴻純若鴻<ゃ潟潟ゃ障
160.740 .LP
160.741 .RS 3
160.742
160.743 @@ -719,13 +753,13 @@
160.744 .LP
160.745 .RE
160.746 .SS
160.747 -ユーザークラスパスの指定
160.748 +若吟若鴻鴻絎
160.749 .LP
160.750 .RS 3
160.751
160.752 .LP
160.753 .LP
160.754 -上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
160.755 +筝箴純若鴻<ゃ 1 ゃ紊眼紊翫<ゃ潟潟ゃ障
160.756 .LP
160.757 .RS 3
160.758
160.759 @@ -746,7 +780,7 @@
160.760
160.761 .LP
160.762 .LP
160.763 -\f2greetings.Hi\fP は、\f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
160.764 +\f2greetings.Hi\fP \f2greetings\fP 宴若後祉鴻с潟潟ゃ鴻「綽荀障筝箴с若吟若鴻鴻宴若吾ccс潟潟ゃ罩e幻絎茵障憜c≫<ゃ潟潟ゃ翫若吟若鴻鴻 \f2/examples\fP 菴遵綽荀障若吟若鴻鴻潟菴遵\f3CLASSPATH\fP 荐絎号障с \f3\-classpath\fP 激с潟篏帥障
160.765 .LP
160.766 .RS 3
160.767
160.768 @@ -763,7 +797,7 @@
160.769
160.770 .LP
160.771 .LP
160.772 -再度 \f2greetings.Hi\fp を変更してバナーユーティリティを使うようにした場合は、このバナーユーティリティもユーザークラスパスを通じてアクセスできるようになっている必要があります。
160.773 +綺 \f2greetings.Hi\fP 紊眼若若cc若篏帥翫若若cc若若吟若鴻鴻≪祉鴻сc綽荀障
160.774 .LP
160.775 .RS 3
160.776
160.777 @@ -782,7 +816,7 @@
160.778
160.779 .LP
160.780 .LP
160.781 -\f2greetings\fP 内のクラスを実行するには、\f2greetings\fP と、\f2greetings\fP が使うクラスの両方にアクセスできる必要があります。
160.782 +\f2greetings\fP 鴻絎茵\f2greetings\fP \f2greetings\fP 篏帥鴻筝≧鴻≪祉鴻с綽荀障
160.783 .LP
160.784 .RS 3
160.785
160.786 @@ -800,13 +834,13 @@
160.787 .LP
160.788 .RE
160.789 .SS
160.790 -ソースファイルとクラスファイルの分離
160.791 +純若鴻<ゃ鴻<ゃ
160.792 .LP
160.793 .RS 3
160.794
160.795 .LP
160.796 .LP
160.797 -特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
160.798 +鴻紊ц閞<吾с翫純若鴻<ゃ鴻<ゃャc臀箴水障鴻<ゃ阪ャ絎\f3\-d\fP 篏帥障純若鴻<ゃ若吟若鴻鴻с\f3\-sourcepath\fP 篏帥c潟潟ゃ純若鴻<ゃ荀ゃс障
160.799 .LP
160.800 .RS 3
160.801
160.802 @@ -853,17 +887,17 @@
160.803
160.804 .LP
160.805 .LP
160.806 -\f3注:\fP \ コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
160.807 +\f3羈:\fP \ 潟潟茵с \f2src/farewells/Base.java\fP 絎障<ゃ潟潟ゃc潟潟ゃ障潟潟ゃh\f3\-verbose\fP 激с潟篏帥障
160.808 .LP
160.809 .RE
160.810 .SS
160.811 -クロスコンパイルの例
160.812 +鴻潟潟ゃ箴
160.813 .LP
160.814 .RS 3
160.815
160.816 .LP
160.817 .LP
160.818 -ここでは、javac を使って、1.5 VM 上で実行するコードをコンパイルします。
160.819 +с\f3javac\fP 篏帥c1.5 VM 筝у茵潟若潟潟ゃ障
160.820 .LP
160.821 .RS 3
160.822
160.823 @@ -882,13 +916,13 @@
160.824
160.825 .LP
160.826 .LP
160.827 -\f3\-target 1.5\fP オプションにより、1.5 VM と互換性のあるクラスファイルが生成されます。デフォルトでは、\f3javac\fP は JDK 6 用にコンパイルします。
160.828 +\f3\-target 1.5\fP 激с潟1.5 VM 篋с鴻<ゃ障с\f3javac\fP JDK 6 潟潟ゃ障
160.829 .LP
160.830 .LP
160.831 -Java プラットフォーム JDK の \f3javac\fP は、デフォルトではそれ自身のブートストラップクラスに対してコンパイルを行うので、代わりに JDK 1.5 のブートストラップクラスに対してコンパイルを行うように \f3javac\fP を設定する必要があります。これは、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使って指定します。この指定を行わないと、1.5 VM には存在しない Java プラットフォーム API に対応したコンパイルが行われるため、プログラムの実行時に失敗するでしょう。
160.832 +Java 若 JDK \f3javac\fP сJava 2 SDK 若鴻鴻絲障潟潟ゃ茵сJava 2 SDK с JDK 1.5 若鴻鴻絲障潟潟ゃ茵絎綽荀障\f3\-bootclasspath\fP \f3\-extdirs\fP 篏帥c絎障絎茵1.5 VM 絖 Java 2 若 API 絲上潟潟ゃ茵違絎茵絎潟榊障
160.833 .LP
160.834 .RE
160.835 -.SH "関連項目"
160.836 +.SH "∫i"
160.837 .LP
160.838
160.839 .LP
160.840 @@ -896,33 +930,33 @@
160.841 .TP 2
160.842 o
160.843 .na
160.844 -「\f2The javac Guide\fP」
160.845 +\f2The javac Guide\fP @
160.846 .fi
160.847 -(http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html)
160.848 +http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
160.849 .TP 2
160.850 o
160.851 -java(1) \- Java アプリケーション起動プログラム
160.852 +java(1) \- Java ≪宴若激с活儀若
160.853 .TP 2
160.854 o
160.855 -jdb(1) \- Java デバッガ
160.856 +jdb(1) \- Java
160.857 .TP 2
160.858 o
160.859 -javah(1) \- C 言語のヘッダとスタブファイルのジェネレータ
160.860 +javah(1) \- C 若鴻帥<ゃ吾с若帥
160.861 .TP 2
160.862 o
160.863 -javap(1) \- Java クラスファイル逆アセンブラ
160.864 +javap(1) \- 鴻<ゃ≪祉潟
160.865 .TP 2
160.866 o
160.867 -javadoc(1) \- Java API ドキュメントジェネレータ
160.868 +javadoc(1) \- Java API ャ<潟吾с若帥
160.869 .TP 2
160.870 o
160.871 -jar(1) \- JAR アーカイブツール
160.872 +jar(1) \- JAR ≪若ゃ若
160.873 .TP 2
160.874 o
160.875 .na
160.876 -「\f2The Java Extensions Framework\fP」
160.877 +\f2Java ≦宍罘純若若\fP @
160.878 .fi
160.879 -(http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html)
160.880 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
160.881 .RE
160.882
160.883 .LP
161.1 --- a/src/solaris/doc/sun/man/man1/ja/javadoc.1 Tue May 12 15:21:55 2009 +0900
161.2 +++ b/src/solaris/doc/sun/man/man1/ja/javadoc.1 Thu May 14 00:17:25 2009 -0700
161.3 @@ -1,930 +1,844 @@
161.4 -'\" t
161.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
161.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
161.7 -.\"
161.8 -.\" This code is free software; you can redistribute it and/or modify it
161.9 -.\" under the terms of the GNU General Public License version 2 only, as
161.10 -.\" published by the Free Software Foundation.
161.11 -.\"
161.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
161.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
161.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
161.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
161.16 -.\" accompanied this code).
161.17 -.\"
161.18 -.\" You should have received a copy of the GNU General Public License version
161.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
161.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
161.21 -.\"
161.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
161.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
161.24 -.\" have any questions.
161.25 -.\" `
161.26 -.TH javadoc 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
161.27 -.hw javadoc
161.28 -.SH "名前"
161.29 -javadoc \- Java API ドキュメントジェネレータ
161.30 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
161.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
161.32 +."
161.33 +." This code is free software; you can redistribute it and/or modify it
161.34 +." under the terms of the GNU General Public License version 2 only, as
161.35 +." published by the Free Software Foundation.
161.36 +."
161.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
161.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
161.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
161.40 +." version 2 for more details (a copy is included in the LICENSE file that
161.41 +." accompanied this code).
161.42 +."
161.43 +." You should have received a copy of the GNU General Public License version
161.44 +." 2 along with this work; if not, write to the Free Software Foundation,
161.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
161.46 +."
161.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
161.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
161.49 +." have any questions.
161.50 +."
161.51 +.TH javadoc 1 "04 May 2009"
161.52 +." Generated from HTML by html2man (author: Eric Armstrong)
161.53 +.SH ""
161.54 +javadoc \- Java API ャ<潟吾с若
161.55 .RS 3
161.56
161.57 .LP
161.58 .LP
161.59 -Java ソースファイルから、API ドキュメントの HTML ページを生成します。このドキュメントで紹介されている Javadoc の例は、Sun Solaris を使用した場合のものです。
161.60 -.LP
161.61 -.SH "形式"
161.62 -.B javadoc
161.63 -[
161.64 -.I options
161.65 -] [
161.66 -.I packagenames
161.67 -] [
161.68 -.I sourcefilenames
161.69 -] [
161.70 -.I \-subpackages pkg1:pkg2:...
161.71 -] [
161.72 -.I @argfiles
161.73 -]
161.74 -.LP
161.75 -.LP
161.76 -引数を指定する順序は任意です。Javadoc ツールでの、処理対象の \f2.java\fP ファイルを決定する方法の詳細については、「ソースファイルの処理」を参照してください。
161.77 -.TP 15
161.78 -.I options
161.79 -このドキュメントで指定されているコマンド行オプションです。
161.80 -.B javadoc
161.81 -のオプションの一般的な使用法については、「使用例」を参照してください。
161.82 -.TP
161.83 -.I packagenames
161.84 -.BR "java.lang java.lang.reflect java.awt"
161.85 -などの、スペースで区切られた
161.86 -一連のパッケージ名です。ドキュメント化するパッケージごとに別個に
161.87 -指定する必要があります。
161.88 -.B javadoc
161.89 -ツールはこれらのパッケージ名を探すとき、
161.90 -.B \-sourcepath
161.91 -を使用します。
161.92 -.B javadoc
161.93 -ツールは、サブパッケージを再帰的に処理することはありません。
161.94 -アスタリスク (\f3*\f1) などのワイルドカードは使うことができません。
161.95 -「1 つ以上のパッケージのドキュメント化」の
161.96 -例を参照してください。
161.97 -.TP
161.98 -.I sourcefilenames
161.99 -スペースで区切られた一連のファイル名です。パス、および
161.100 -アスタリスク (\f3*\f1) などのワイルドカードを含めることができます。
161.101 -.B javadoc
161.102 -ツールが処理するのは、ファイル名が「.java」という拡張子で終わり、
161.103 -その拡張子を除いた名前が実際に有効なクラス名
161.104 +Java 純若鴻<ゃAPI ャ<潟 HTML 若吾障ャ<潟х換篁 Javadoc 箴Sun Solaris 篏睡翫с
161.105 +.LP
161.106 +.RE
161.107 +.SH "綵√"
161.108 +.LP
161.109 +.LP
161.110 +\f4javadoc\fP\f2\ [\ \fP\f2options\fP\f2\ ]\ [\ packagenames\ ]\ [\ sourcefilenames\ ]\ [\ \-subpackages\fP\ \f2pkg1:pkg2:...\fP\f2\ ]\ [\ \fP\f2@argfiles\fP\f2\ ]\fP
161.111 +.LP
161.112 +.LP
161.113 +綣違絎綺篁紙сJavadoc 若с絲乗院 \f2.java\fP <ゃ羆阪号荅括完ゃ純若鴻<ゃс
161.114 +.LP
161.115 +.RS 3
161.116 +
161.117 +.LP
161.118 +.RS 3
161.119 +.TP 3
161.120 +options
161.121 +ャ<潟ц潟潟茵激с潟сJavadoc 激с潟罔羣篏睡羈ゃ篏睡箴с
161.122 +.TP 3
161.123 +packagenames
161.124 +鴻若鴻у阪筝c宴若後с 違\f2java.lang\ java.lang.reflect\ java.awt\fP 絎障ャ<潟宴若吾ャ絎綽荀障ゃ若篏睡筝с 絽亥\-subpackages 篏睡障Javadoc 若\f2\-sourcepath\fP 篏帥c宴若後罎膣≪障1 や札筝宴若吾ャ<潟箴с
161.125 +.TP 3
161.126 +sourcefilenames
161.127 +鴻若鴻у阪筝c純若鴻<ゃс<ゃ鴻у障障≪鴻帥鴻 (*) ゃ若с障 Javadoc 若<ゃ.java≦宍絖х≦宍絖ゃ絎鴻劫с鴻<ゃс (
161.128 +.na
161.129 +\f2Identifiers\fP @
161.130 .fi
161.131 - (http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625
161.132 -の
161.133 -.na
161.134 -「\f2Identifiers\fP」を参照) であるすべてのファイルです。
161.135 -したがって、ハイフンを含む名前 (X-Buffer など) や、
161.136 -その他の無効な文字を含む名前を付けることによって、
161.137 -それらのファイルをドキュメント化の対象から除外できます。
161.138 -これは、テスト用のファイルや、テンプレートから生成されたファイルの場合に便利です。
161.139 -.B javadoc
161.140 -ツールは、ソースファイル名の前に指定されたパスを使用して、
161.141 -ソースファイル名を探します。この場合、
161.142 -.B -sourcepath
161.143 -は使用しません。たとえば、
161.144 -.B Button.java
161.145 -を渡すことは
161.146 -.BR ./Button.java
161.147 -と指定することと同じです。完全パスを付けたソースファイル名の
161.148 -例は「
161.149 -.BR /home/src/java/awt/Graphics*.java
161.150 -」のようになります。「1 つ以上のクラスのドキュメント化」の例を
161.151 -参照してください。また、「パッケージとクラスのドキュメント化」の
161.152 -例のように、パッケージ名とソースファイル名を組み合わせることもできます。
161.153 -.TP
161.154 -.I \-subpackages pkg1:pkg2:...
161.155 -指定されたパッケージ内のソースファイルからドキュメントを生成し、
161.156 -再帰的にサブパッケージを処理します。 パッケージ名または
161.157 -ソールファイル名を指定するための代替手段です。
161.158 -.TP
161.159 -.I @argfiles
161.160 -Javadoc オプション、パッケージ名、およびソースファイル名を
161.161 -任意の順序で並べたリストが含まれる 1 つ以上のファイルです。
161.162 -このファイルの中では、ワイルドカード (*) および
161.163 -.B \-J
161.164 -オプションは指定できません。
161.165 -.SH "機能説明"
161.166 -.B javadoc
161.167 -ツールは、一連の Java ソースファイルの宣言およびドキュメント
161.168 -コメントを解析し、デフォルトでは public クラスと protected クラス、
161.169 -入れ子クラス(匿名の内部クラスを除く)、インタフェース、コンストラクタ、メソッド、および
161.170 -フィールドについて説明した一連の HTML ページを生成します。また、API (アプリケーションプログラミングインタフェース) ドキュメントの生成や、一連のソースファイルの実装ドキュメントの生成に使用できます。
161.171 -.LP
161.172 -.B javadoc
161.173 -ツールは、パッケージ全体、個々のソースファイル、またはその両方に対して
161.174 -実行できます。
161.175 -.B javadoc
161.176 -ツールをパッケージ全体に対して実行する場合は、最上位ディレクトリから再帰的にたどるために -subpackages を使用するか、パッケージ名の明示的なリストを渡します。
161.177 -個々のクラスに対して javadoc を実行する場合は、一連の
161.178 -ソース (\f3.java\f1) ファイル名を渡します。具体的な例は、
161.179 -このページの最後で示します。
161.180 -次に、Javadoc によるソースファイルの処理について説明します。
161.181 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)cゃ潟 (\f2X\-Buffer\fP ) 篁≦鴻絖篁c<ゃャ<潟絲乗院ゅс障鴻<ゃ潟若<ゃ翫箴水с 純若鴻<ゃ絎鴻cjavadoc <ゃ罎膣≪贋羆冴障障Javadoc 若純若鴻<ゃ罎膣≪ \f2\-sourcepath\fP 篏帥障後障鴻憜c後障鴻с \f2Button.java\fP 羝<\f2./Button.java\fP 羝<с純若鴻<ゃ鴻ф絎\f2/home/src/java/awt/Graphics*.java\fP 障1 や札筝鴻ャ<潟箴с障宴若吾鴻ャ<潟箴宴若後純若鴻<ゃ羞桁с障
161.182 +.TP 3
161.183 +\-subpackages pkg1:pkg2:...
161.184 +純若鴻<ゃ絎宴若吾潟泣宴若後絽亥ャ<潟障宴若後障純若鴻<ゃ絎綽荀障
161.185 +.TP 3
161.186 +@argfiles
161.187 +Javadoc 激с潟宴若後潟純若鴻<ゃ篁紙綺т研鴻鴻障 1 や札筝<ゃс<ゃ筝сゃ若 (*) \f2\-J\fP 激с潟絎с障
161.188 +.RE
161.189 +
161.190 +.LP
161.191 +.RE
161.192 +.SH " 茯"
161.193 +.LP
161.194 +.LP
161.195 +\f3Javadoc\fP 若筝c Java 純若鴻<ゃ絎h潟ャ<潟若激с潟潟<潟茹fс public 鴻protected 鴻ャ絖 (水鴻ゃ)ゃ潟帥с若鴻潟潟鴻帥<純潟c若ゃ茯筝c HTML 若吾障障API (≪宴若激с潟違潟違ゃ潟帥с若) ャ<潟筝c純若鴻<ゃ絎茖ャ<潟篏睡с障
161.196 +.LP
161.197 +.LP
161.198 +Javadoc 若宴若後篏純若鴻<ゃ障筝≧鴻絲障絎茵с障javadoc 若宴若後篏絲障絎茵翫筝篏c絽亥 \f2\-subpackages\fP 篏睡宴若後腓榊鴻羝<障純若鴻<ゃ絲障 javadoc 絎茵翫筝c純若 (\f2.java\fP) <ゃ羝<障隙箴ャ<潟緇膣剛障罨<Javadoc 純若鴻<ゃゃ茯障
161.199 .LP
161.200 .SS
161.201 -ソースファイルの処理
161.202 -.LP
161.203 -.LP
161.204 -Javadoc ツールは、末尾に \f2.java\fP の付いたファイル以外に、ソースファイルで説明する他のファイルも処理します。個々のソースファイル名を明示的に渡すことによって Javadoc ツールを実行する場合、\f2.java\fP ファイルを処理するかを正確に指定できます。ただし、多くの開発者はこの方法では作業しません。パッケージ名を渡すほうが簡単だからです。ソースファイル名を明示的に指定しなくても、Javadoc ツールは 3 つの方法で実行できます。この方法は、(1) パッケージ名を渡す、(2) \f2\-subpackages\fP を使用する、(3) ソースファイル名にワイルドカードを使用する (\f2*.java\fP) という方法です。これらの方法を使用する場合、Javadoc ツールは、\f2*.java\fP ファイルが次のすべての要件を満たしている場合にかぎり、このファイルを処理します。
161.205 +純若鴻<ゃ
161.206 +.LP
161.207 +.LP
161.208 +Javadoc 若絨障 \f2.java\fP 篁<ゃ篁ュ純若鴻<ゃц篁<ゃ障純若鴻<ゃ腓榊羝<c Javadoc 若絎茵翫 \f2.java\fP <ゃ罩g∈絎с障紊肴号с篏罐障 宴若後羝<祉膂≦с純若鴻<ゃ腓榊絎Javadoc 若 3 ゃ号у茵с障号(1) 宴若後羝<(2) \f2\-subpackages\fP 篏睡(3) 純若鴻<ゃゃ若篏睡 (\f2*.java\fP) 号с号篏睡翫Javadoc 若\f2.java\fP <ゃ罨<鴻荀篁吟羣翫<ゃ障
161.209 .LP
161.210 .RS 3
161.211 .TP 2
161.212 o
161.213 -名前から \f2.java\fP の接尾辞を取り除くと、実際に有効なクラス名になっている (有効な文字については、
161.214 + \f2.java\fP ・絨乗ゃ絎鴻劫c (鴻絖ゃ
161.215 +.na
161.216 +\f2Identifiers\fP @
161.217 .fi
161.218 -http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625
161.219 -の
161.220 -.na
161.221 -「\f2Identifiers\fP」を参照)
161.222 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
161.223 .TP 2
161.224 o
161.225 -ソースツリーのルートから相対的なディレクトリパスが、区切り文字をドットに変換すると、実際に有効なパッケージ名になっている
161.226 +純若鴻若若後丞c鴻阪絖紊絎鴻宴若後c
161.227 .TP 2
161.228 o
161.229 -パッケージ文には有効なパッケージ名が含まれる (前項目で指定)
161.230 +宴若御鴻宴若後障 (ф絎)
161.231 .RE
161.232
161.233 .LP
161.234 .LP
161.235 -\f3リンクの処理\fP \-
161.236 -実行時に、
161.237 -.B javadoc
161.238 -ツールはその実行の一部として記述されているパッケージ、クラス、
161.239 -およびメンバの名称にクロスリファレンスリンクを自動的に
161.240 -追加します。リンクは、次の箇所に現われます。
161.241 -.LP
161.242 -.TP 2
161.243 -\(bu
161.244 -宣言 (戻り値の型、引数の型、フィールドの型)
161.245 -.TP 2
161.246 -\(bu
161.247 -@see タグから生成される [関連項目] のセクション
161.248 -.TP 2
161.249 -\(bu
161.250 -{@link} タグから生成されるインラインテキスト
161.251 -.TP 2
161.252 -\(bu
161.253 -@throws タグから生成される例外の名称
161.254 -.TP 2
161.255 -\(bu
161.256 -インタフェースのメンバに対する [定義] リンクと、クラスのメンバに対する [オーバーライド] リンク
161.257 -.TP 2
161.258 -\(bu
161.259 -パッケージ、クラス、およびメンバを記述した一覧表
161.260 -.TP 2
161.261 -\(bu
161.262 -パッケージとクラスの継承ツリー
161.263 -.TP 2
161.264 -\(bu
161.265 -索引
161.266 -.LP
161.267 -\-link と \-linkoffline オプションを使用して、
161.268 -コマンド行に含まれていない、個別に生成されるクラスの既存のテキストに
161.269 -ハイパーリンクを追加できます。
161.270 -.LP
161.271 -\f3その他の処理についての詳細\fP \-
161.272 -javadoc ツールは、実行のたびにひとつの完全なドキュメントを生成します。javadoc は、
161.273 -追加生成を行えません。つまり、以前に実行した javadoc の結果を変更したり、
161.274 -それらを直接取り込むことはできません。しかし、前述のようにほかの
161.275 -実行の結果にリンクすることは可能です。
161.276 -.LP
161.277 -実装上の理由から、
161.278 -.B javadoc
161.279 -ツールは実行に java コンパイラを必要とし、java コンパイラに依存しています。
161.280 -.B javadoc
161.281 -ツールは
161.282 -.B javac
161.283 -の一部を呼び出して、宣言をコンパイルし、メンバの実装は無視します。
161.284 -.B javadoc
161.285 -ツールは、クラス階層を含むクラスの豊富な内部表現、および「使用」関係を
161.286 -構築し、そこから HTML を生成します。
161.287 -.B javadoc
161.288 -ツールは、ソースコードのドキュメンテーションコメントから、ユーザの
161.289 -提供するドキュメントも取得します。
161.290 -.LP
161.291 -.B javadoc
161.292 -ツールは、メソッド本体のない純粋なスタブファイルである
161.293 -.B .java
161.294 -ソースファイル上で実行されます。つまり、API の作成時には、コードを
161.295 -記述する前の設計の早い段階でドキュメンテーションコメントを記述し、
161.296 -.B javadoc
161.297 -を実行できます。
161.298 -.LP
161.299 -コンパイラに依存することによって、HTML 出力が、実際の実装に正確に対応
161.300 -することが保証されます。実際の実装は、明示的でなく暗黙的に
161.301 -ソースコードに依存している場合があります。たとえば、
161.302 -.B javadoc
161.303 -ツールは、
161.304 -.B .class
161.305 -ファイル内には存在するが、ソースコード内には存在しない
161.306 -デフォルトコンストラクタ (「Java Language Specification」のセクション 8.6.7: http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154)
161.307 -をドキュメント化します。
161.308 -.LP
161.309 -多くの場合、
161.310 -.B javadoc
161.311 -ツールでは、ソースファイルのコードが不完全またはエラーを
161.312 -含んでいる場合でもドキュメントを生成できます。
161.313 -このため、デバッグやトラブルシューティングが完了する前に
161.314 -ドキュメントを生成できます。 たとえば、Java 言語仕様によると、
161.315 -抽象メソッドを含むクラスはそれ自体を抽象と宣言しなければなりません。
161.316 -このエラーを検出すると、javac コンパイラの場合は、このエラーで
161.317 -停止しますが、javadoc ツールは警告を出さずに処理を進めます。
161.318 -javadoc ツールはドキュメンテーションコメントの基本的なチェックを行います。
161.319 -ドキュメンテーションコメントをより詳しくチェックする必要がある場合は、
161.320 -DocCheck ドックレットを使用してください。
161.321 -.LP
161.322 -.B javadoc
161.323 -ツールがドキュメント用の内部構造を構築するときは、参照する
161.324 -クラスをすべてロードします。このため、ブートストラップクラス、
161.325 -拡張機能、またはユーザクラスにかかわらず、
161.326 -.B javadoc
161.327 -ツールは、参照するクラスをすべて検出できなければなりません。
161.328 -一般的に、作成する
161.329 -クラスは、拡張機能としてロードされるか、
161.330 -.BR javadoc
161.331 -ツールのクラスパス内にある必要があります。
161.332 -.SS "Javadoc ドックレット"
161.333 -.B javadoc
161.334 -ツールの出力の内容と形式は、ドックレットを使ってカスタマイズできます。
161.335 -.B javadoc
161.336 -ツールには、標準ドックレットと呼ばれるデフォルトの「組み込み型」
161.337 -ドックレットがあり、これによって HTML 形式の API
161.338 -ドキュメントを生成します。標準ドックレット
161.339 -の修正やサブクラス化を行なったり、HTML、XML、MIF、RTF などの好みの
161.340 -出力形式を生成する独自のドックレットを記述することも可能です。
161.341 -ドックレットとその使用法については、次を参照してください。
161.342 -.LP
161.343 -.TP 2
161.344 -\(bu
161.345 -.B Javadoc
161.346 -ドックレット
161.347 -.TP 2
161.348 -\(bu
161.349 -.B -doclet
161.350 -コマンド行オプション
161.351 -.LP
161.352 -.B -doclet
161.353 -コマンド行オプションでカスタムドックレットが指定されていない場合、
161.354 -.B javadoc
161.355 -ツールは、デフォルトの標準ドックレットを使用します。
161.356 -.B javadoc
161.357 -ツールには、どのドックレットが使われているかには関係なく使用できる
161.358 -コマンド行オプションがあります。標準ドックレットでは、これらの
161.359 -ほかに、いくつかのコマンド行オプションが追加されます。どちらの
161.360 -オプションについても、後述の「オプション」で説明します。
161.361 -.SS 関連ドキュメントおよびドックレット
161.362 -.TP 2
161.363 -\(bu
161.364 -Javadoc に施された機能強化 - Javadoc に追加された改良点の詳細
161.365 -.TP 2
161.366 -\(bu
161.367 -Javadoc FAQ - 頻繁に寄せられる質問に対する回答、Javadoc 関連のツールについての情報、およびバグの回避方法
161.368 -.TP 2
161.369 -\(bu
161.370 -Javadoc のドキュメンテーションを作成するには - Sun で
161.371 -一般的なドキュメンテーションコメントの記述方法の詳細
161.372 -.TP 2
161.373 -\(bu
161.374 -API 仕様を記述するための要件 - Java 2 プラットフォーム仕様を記述する際に
161.375 -使用された標準要件。 この情報は、ソースファイルのドキュメンテーションコメント
161.376 -形式で API 仕様を記述する場合にも、その他の形式で記述する場合にも
161.377 -役立ちます。 検証可能なアサーションを満たすパッケージ、クラス、
161.378 -インタフェース、フィールド、およびメソッドについての要件を定めています。
161.379 -.TP 2
161.380 -\(bu
161.381 -ドキュメンテーションコメントの仕様 - ドキュメンテーションコメントの
161.382 -オリジナル仕様については、『Java Language Specification』
161.383 -(James Gosling、Bill Joy、Guy Steele 共著) の初版の
161.384 -第 18 章「Documentation Comments」を参照してください。
161.385 -この章は、第 2 版では削除されました。
161.386 -.TP 2
161.387 -\(bu
161.388 -DocCheck ドックレット - ソースファイル内のドキュメンテーションコメントを検査し、
161.389 -見つかったエラーや不規則な箇所を一覧にしたレポートを生成します。
161.390 -これは Sun Doc チェックユーティリティの一部です。
161.391 -.TP 2
161.392 -\(bu
161.393 -MIF ドックレット - MIF、FrameMaker、および PDF 形式での API ドキュメントの
161.394 -生成を自動化します。 MIF は Adobe FrameMaker の互換形式です。
161.395 -.SS "用語"
161.396 -.LP
161.397 -.LP
161.398 -「\f2ドキュメンテーションコメント\fP」、「\f2doc コメント\fP」、「\f2主説明\fP」、「\f2タグ\fP」、「\f2ブロックタグ\fP」、および「\f2インラインタグ\fP」の用語については、「ドキュメンテーションコメント」で説明します。以下のその他の用語は、Javadoc ツールのコンテキストで特定の意味を持ちます。
161.399 -.RS 3
161.400 -.TP 3
161.401 -生成されるドキュメント
161.402 -.B javadoc
161.403 -ツールが Java ソースコード内の doc コメントから生成したドキュメント
161.404 -のことです。デフォルトの生成ドキュメントは HTML 形式で、標準
161.405 -ドックレットによって作成されます。
161.406 -.LP
161.407 -.TP 3
161.408 -名前
161.409 -Java 言語での名前、つまりパッケージ、クラス、インタフェース、
161.410 -フィールド、コンストラクタ、またはメソッドの名前のことです。名前は、
161.411 -.BR java.lang.String.equals(java.lang.Object)
161.412 -のように完全修飾することも、
161.413 -.BR equals(Object)
161.414 -のように部分修飾することもできます。
161.415 -.LP
161.416 -.TP 3
161.417 -ドキュメント化されるクラス
161.418 -.B javadoc
161.419 -の実行によって完全なドキュメントが生成されるクラスと
161.420 -インタフェースです。ドキュメント化するには、ソースファイルが
161.421 -使用可能でなければならず、ソースファイル名またはパッケージ名の
161.422 -どちらかを
161.423 -.B javadoc
161.424 -コマンドに渡さなければなりません。ドキュメント化されるクラスは、
161.425 -.B javadoc
161.426 -の実行で組み込まれるクラス、つまり「組み込みクラス」とも呼ばれます。
161.427 -.LP
161.428 -.TP 3
161.429 -含まれるクラス
161.430 -対応するソースファイル名またはパッケージ名が javadoc コマンドに
161.431 -渡されるクラスおよびインタフェースのことです。
161.432 -.LP
161.433 -.TP 3
161.434 -除外されるクラス
161.435 -javadoc コマンドにソースファイル名またはパッケージ名が
161.436 -渡されないクラスとインタフェースです。
161.437 -.LP
161.438 -.TP 3
161.439 -参照クラス
161.440 -ドキュメント化されるクラスとインタフェースの定義
161.441 -(実装) またはドキュメンテーションコメント内で明示的に参照される
161.442 -クラスとインタフェースです。参照の例としては、
161.443 -戻り値の型、パラメータの型、キャストの型、
161.444 -拡張されるクラス、実装されるインタフェース、
161.445 -インポートされるクラス、メソッド本体で使用される
161.446 -クラス、@see、{@link}、{@linkplain}、
161.447 -および {@inheritDoc} タグなどがあります
161.448 -(この定義は 1.3
161.449 -.fi
161.450 -(http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses)
161.451 -から
161.452 -変更されていることに注意)。
161.453 -javadoc ツールは動作中、
161.454 -.B javadoc
161.455 -のブートクラスパスと
161.456 -クラスパス内にある参照されているクラスを
161.457 -すべてメモリにロードするためです。
161.458 -参照されているクラスが見つからなかった
161.459 -場合は、[クラスが見つかりません] という警告が表示されます。
161.460 -.B javadoc
161.461 -ツールは、クラスの存在とそのメンバの完全修飾名を決定するのに十分な情報を、
161.462 -.B .class
161.463 -ファイルから引き出すことができます。
161.464 -.LP
161.465 -.TP 3
161.466 -外部参照クラス
161.467 -参照されるクラスのうち、
161.468 -.B javadoc
161.469 -を実行してもドキュメントが生成されないクラスです。
161.470 -つまり、これらのクラスは、コマンド行で
161.471 -.B javadoc
161.472 -ツールに渡されていません。
161.473 -生成ドキュメント内でこれらのクラスにリンクしている箇所は、
161.474 -「外部参照」または「外部リンク」と呼ばれます。 たとえば、
161.475 -.B java.awt
161.476 -パッケージに対してだけ
161.477 -.B javadoc
161.478 -を実行した場合、Object などの
161.479 -.BR java.lang
161.480 -内のすべてのクラスは、外部参照クラスになります。外部参照クラスには、
161.481 -.B \-link
161.482 -および
161.483 -.B \-linkoffline
161.484 -オプションを使ってリンクすることができます。
161.485 -外部参照クラスには、通常そのソースコメントを
161.486 -.B \javadoc
161.487 -ツールの実行で利用できないという重要な特徴があります。
161.488 -この場合、それらのコメントを継承することはできません。
161.489 -.SH "ソースファイル"
161.490 -.B javadoc
161.491 -ツールは、クラスの Java 言語ソースファイル (\f3.java\f1)、パッケージコメントファイル、
161.492 -概要コメントファイル、およびその他の処理されないファイルの 4 種類の
161.493 -「ソース」ファイルを基にして、出力を生成します。また、ドキュメント化しないがソースツリーに存在する場合があるテストファイルやテンプレートについても説明します。
161.494 -.SS "クラスソースコードファイル"
161.495 -各クラスまたはインタフェース、およびそのメンバは、
161.496 -.B .java
161.497 -ファイルの中にそれ自身のドキュメンテーションコメントを
161.498 -持つことができます。ドキュメンテーションコメントの詳細については、
161.499 -「ドキュメンテーションコメント」の節を参照してください。
161.500 -.SS "パッケージコメントファイル"
161.501 -各パッケージは、独自のドキュメンテーションコメントを
161.502 -持つことができ、「ソース」ファイルに保持します。
161.503 -.B javadoc
161.504 -ツールは、生成するパッケージの要約ページにこのコメントをマージします。
161.505 -通常、このコメントには、パッケージ全体に適用される
161.506 -ドキュメントを含めます。
161.507 -.LP
161.508 -パッケージコメントファイルを作成する場合、コメントの格納先として、次の 2 つのファイルのいずれかを選択できます。
161.509 +\f3潟\fP \- Javadoc 若絎茵筝絎茵сャ<潟宴若吾鴻潟<潟若絲障娯с潟菴遵障潟罨<贋菴遵障
161.510 .LP
161.511 .RS 3
161.512 .TP 2
161.513 o
161.514 -\f2package\-info.java\fP \- パッケージ宣言、パッケージ注釈、パッケージコメント、および Javadoc タグを格納できます。このファイルは JDK 5.0 で導入されたものであり、package.html よりも推奨されています。
161.515 +絎h (祉ゃ綣違c若)
161.516 .TP 2
161.517 o
161.518 -\f2package.html\fP \- 格納できるのはパッケージコメントと Javadoc タグだけです。パッケージ注釈は格納できません。
161.519 +\f2@see\fP 帥違 [∫i] 祉激с
161.520 +.TP 2
161.521 +o
161.522 +\f2{@link}\fP 帥違ゃ潟ゃ潟鴻
161.523 +.TP 2
161.524 +o
161.525 +\f2@throws\fP 帥違箴紊
161.526 +.TP 2
161.527 +o
161.528 +"ゃ潟帥с若鴻<潟若絲障 [絎臂] 潟鴻<潟若絲障 [若若ゃ] 潟
161.529 +.TP 2
161.530 +o
161.531 +宴若吾鴻潟<潟若网荀若
161.532 +.TP 2
161.533 +o
161.534 +宴若吾潟鴻膓帥
161.535 +.TP 2
161.536 +o
161.537 +膣√
161.538 .RE
161.539
161.540 .LP
161.541 .LP
161.542 -各パッケージは、単一の \f2package.html\fP ファイル、単一の \f2package\-info.java\fP ファイルのいずれかを持つことができますが、両方を持つことはできません。このどちらかのファイルを \f2.java\fP ファイルとともに、ソースツリー内のそのパッケージのディレクトリ内に配置してください。
161.543 -.LP
161.544 -.LP
161.545 -\f4package\-info.java\fP このファイルには、次の構造のパッケージコメントを格納できます。コメントはパッケージ宣言の前に配置します。
161.546 -.LP
161.547 -.LP
161.548 -File: \f2java/applet/package\-info.java\fP
161.549 -.LP
161.550 -.ft 3
161.551 -.nf
161.552 -/**
161.553 - * Provides the classes necessary to create an
161.554 - * applet and the classes an applet uses
161.555 - * to communicate with its applet context.
161.556 - * <p>
161.557 - * The applet framework involves two entities:
161.558 - * the applet and the applet context.
161.559 - * An applet is an embeddable window (see the
161.560 - * {@link java.awt.Panel} class) with a few extra
161.561 - * methods that the applet context can use to
161.562 - * initialize, start, and stop the applet.
161.563 - *
161.564 - * @since 1.0
161.565 - * @see java.awt
161.566 - */
161.567 -package java.lang.applet;
161.568 +潟潟茵ф絎c鴻ゃ√鴻 (ャ鴻) 絲障ゃ若潟菴遵\f2\-link\fP \f2\-linkoffline\fP 激с潟с障
161.569 +.LP
161.570 +.LP
161.571 +\f3篁ゃ荅括完\fP \- Javadoc 若絎茵潟 1 ゃ絎ャ<潟篏障 ャ<潟菴遵с障 ゃ障Javadoc 若篁ュ絎茵腟篆罩c絎鴻贋・腟水ャс障菴違篁ュ絎茵腟絲障潟菴遵с障
161.572 +.LP
161.573 +.LP
161.574 +絎茖筝宴Javadoc 若絎茵 java 潟潟ゃ綽荀java 潟潟ゃ箴絖障Javadoc 若 \f2javac\fP 筝若喝冴絎h潟潟ゃ<潟若絎茖∴障Javadoc 若拷絮ゃ鴻莟絲茵憗鴻篏睡≫罕膀宴 HTML 障Javadoc 若純若鴻潟若ャ<潟若激с潟潟<潟若吟若箴ャ<潟緇障
161.575 +.LP
161.576 +.LP
161.577 +Javadoc 若<純篏膣膕鴻帥<ゃс \f2.java\fP 純若鴻<ゃ絲障絎茵с障cAPI 篏絎茖荐菴違荐荐罧級сャ<潟若激с潟潟<潟荐菴違 javadoc 若絎茵с障
161.578 +.LP
161.579 +.LP
161.580 +潟潟ゃ箴絖cHTML 阪絎絎茖罩g∈絲上障 絎絎茖腓榊純若鴻潟若с藥純若鴻潟若箴絖翫障違Javadoc 若\f2.class\fP <ゃ絖純若鴻潟若絖
161.581 +.na
161.582 +\f2潟潟鴻\fP @
161.583 .fi
161.584 -.ft 1
161.585 -.LP
161.586 -コメント区切り文字の \f2/**\fP と \f2*/\fP は記述する必要がありますが、中間行の行頭のアスタリスクは省略してもかまいません。
161.587 -.LP
161.588 -.LP
161.589 -\f4package.html\fP \- このファイルには、次の構造のパッケージコメントを格納できます。コメントは \f2<body>\fP 要素内に配置します。
161.590 -.LP
161.591 -.LP
161.592 -File: \f2java/applet/package.html\fP
161.593 -.LP
161.594 -.LP
161.595 -.ft 3
161.596 -.nf
161.597 -<HTML>
161.598 -<BODY>
161.599 -Provides the classes necessary to create an applet and the
161.600 -classes an applet uses to communicate with its applet context.
161.601 -<p>
161.602 -The applet framework involves two entities: the applet
161.603 -and the applet context. An applet is an embeddable
161.604 -window (see the {@link java.awt.Panel} class) with a
161.605 -few extra methods that the applet context can use to
161.606 -initialize, start, and stop the applet.
161.607 -
161.608 -@since 1.0
161.609 -@see java.awt
161.610 -</BODY>
161.611 -</HTML>
161.612 +http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (Java 荐茯篁罕祉激с 8.6.7) ャ<潟障
161.613 +.LP
161.614 +.LP
161.615 +絽吾Javadoc 若с純若鴻<ゃ潟若筝絎障若с翫сャ<潟с障違激ャ若c潟違絎篋ャ<潟с障違Java 荐茯篁罕処院<純鴻篏処院絎h違障若罎冴javac 潟潟ゃ罩≪障Javadoc 若茘冴膓茵障Javadoc 若ャ<潟若激с潟潟<潟堺с茵障ャ<潟若激с潟潟<潟荅潟с綽荀翫DocCheck 篏睡
161.616 +.LP
161.617 +.LP
161.618 +Javadoc 若ャ<潟罕罕膀с鴻鴻若障Javadoc 若若鴻鴻≦宍罘純障若吟若鴻鴻с鴻罎膣≪с違障荅括完
161.619 +.na
161.620 +\f2鴻罎膣∽号\fP @
161.621 .fi
161.622 -.ft 1
161.623 -.LP
161.624 -.LP
161.625 -これは単なる通常の HTML ファイルであり、パッケージ宣言を含んでいない点に注意してください。パッケージコメントファイルの内容は、ほかのすべてのコメントと同様に HTML で記述されています。ただし、ほかのコメントと異なる点が 1 つだけあります。それは、このドキュメンテーションコメントには、コメント区切り文字である \f2/**\fP と \f2*/\fP、および行頭のアスタリスクを含めてはならない、ということです。コメントを書く場合は、最初の文をパッケージの概要とし、\f2<body>\fP と最初の文の間にタイトルやその他のテキストを含めないようにします。パッケージタグを含めることはできますが、ほかのドキュメンテーションコメントと同様、全てのブロックタグは説明のあとに置かなければなりません。パッケージコメントファイルに \f2@see\fP タグを追加する場合は、完全指定の名前を使用する必要があります。詳細は、
161.626 -.fi
161.627 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecomments
161.628 -の
161.629 -.na
161.630 -「\f2example of \fP\f2package.html\fP」を参照してください。
161.631 -.LP
161.632 -.LP
161.633 -\f3パッケージコメントファイルの処理\fP \- Javadoc ツールは、実行時にパッケージコメントファイルを自動的に検索し、このファイルを見つけると次の処理を行います。
161.634 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.htmlс絽吾篏鴻≦宍罘純若Javadoc 若鴻劫臀鏆荀障
161.635 +.LP
161.636 +.SS
161.637 +Javadoc
161.638 +.LP
161.639 +.LP
161.640 +Javadoc 若阪絎鴻綵√篏帥c鴻帥ゃ冴с障Javadoc 若罔羣若違腟粋昭帥障 罔羣HTML 綵√ API ャ<潟障罔羣篆罩c障泣劫HTMLXMLMIFRTF 絅純帥阪綵√荐菴違純с篏睡羈ゃ罨<с
161.641 .LP
161.642 .RS 3
161.643 .TP 2
161.644 o
161.645 -処理できるようにコメントをコピーする (\f2package.html\fP の場合であれば、\f2<body>\fP と \f2</body>\fP HTML タグの間にある内容をすべてコピーする。\f2<head>\fP を含め、そこに \f2<title>\fP やソースファイルの著作権記述などの情報を配置することもできるが、生成後のドキュメンテーションにはそれらは一切表示されない)
161.646 +.na
161.647 +\f2Javadoc \fP @
161.648 +.fi
161.649 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
161.650 .TP 2
161.651 o
161.652 -パッケージタグがあれば、すべて処理する
161.653 +\f2\-doclet\fP 潟潟茵激с
161.654 +.RE
161.655 +
161.656 +.LP
161.657 +.LP
161.658 +\f2\-doclet\fP 潟潟茵激с潟с鴻帥絎翫Javadoc 若罔羣篏睡障javadoc 若篏睡≫鋎睡с潟潟茵激с潟障罔羣с祉ゃ潟潟茵激с潟菴遵障<激с潟ゃ激с潟ц障
161.659 +.LP
161.660 +.SS
161.661 +∫cャ<潟潟
161.662 +.LP
161.663 +.RS 3
161.664 .TP 2
161.665 o
161.666 -生成したパッケージの概要ページの最後に、処理したテキストを挿入する (例: パッケージの概要)
161.667 +.na
161.668 +\f2Javadoc 純罘遵七\fP @
161.669 +.fi
161.670 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html \- Javadoc ц申壕鴻荅括完
161.671 .TP 2
161.672 o
161.673 -パッケージの概要ページの先頭に、パッケージコメントの最初の文をコピーする。さらに、概要ページのパッケージリストに、パッケージ名とパッケージコメントの最初の文を追加する (例: 概要の要約)。文の末尾は、クラスやメンバの主説明の最初の文の末尾と同じ規則によって判断される
161.674 +.na
161.675 +\f2Javadoc FAQ\fP @
161.676 +.fi
161.677 +http://java.sun.com/j2se/javadoc/faq/index.html \- 紫絲莖絲障膈Javadoc ∫c若ゃ宴潟違炊号
161.678 +.TP 2
161.679 +o
161.680 +.na
161.681 +\f2How to Write Doc Comments for Javadoc\fP @
161.682 +.fi
161.683 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html \- ャ<潟若激с潟潟<潟荐菴井号≪ Sun 荀靘
161.684 +.TP 2
161.685 +o
161.686 +.na
161.687 +\f2Requirements for Writing API Specifications\fP @
161.688 +.fi
161.689 +http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Java 2 若篁罕荐菴違篏睡罔羣荀篁吟宴純若鴻<ゃャ<潟若激с潟潟<潟綵√ API 篁罕荐菴違翫篁綵√ц菴違翫綵合<障罎荐弱純≪泣若激с潟羣宴若吾鴻ゃ潟帥с若鴻c若潟<純ゃ荀篁吟絎障
161.690 +.TP 2
161.691 +o
161.692 +.na
161.693 +\f2ャ<潟若激с潟潟<潟篁罕\fP @
161.694 +.fi
161.695 +http://java.sun.com/docs/books/jls/first_edition/html/18.doc.html \- ャ<潟若激с潟潟<潟吾篁罕ゃJava Language Specification (James GoslingBill JoyGuy Steele 沿) 膃 18 腴Documentation Commentsс腴膃 2 сゃ障
161.696 +.TP 2
161.697 +o
161.698 +.na
161.699 +\f2DocCheck \fP @
161.700 +.fi
161.701 +http://java.sun.com/javadoc/doccheck \- 純若鴻<ゃャ<潟若激с潟潟<潟с罎冴若筝罩c若障Sun Doc Check 若cc若筝сSun Doc Check 若cc若筝с
161.702 +.TP 2
161.703 +o
161.704 +.na
161.705 +\f2MIF \fP @
161.706 +.fi
161.707 +http://java.sun.com/javadoc/mifdoclet \- MIFFrameMakerPDF 後 API ャ<潟障MIF Adobe FrameMaker 篋ゆ後с
161.708 .RE
161.709
161.710 .LP
161.711 -.SS "概要コメントファイル"
161.712 -ドキュメント化する各アプリケーションまたはパッケージのセットは、
161.713 -独自の概要ドキュメンテーションコメントを持つことができ、それは
161.714 -「ソース」ファイルに保持されます。
161.715 -.B javadoc
161.716 -ツールは、生成する概要ページにこのコメントをマージします。通常、この
161.717 -コメントには、アプリケーションまたはパッケージのセット全体に
161.718 -当てはまるドキュメントを含めます。
161.719 -.LP
161.720 -概要コメントファイルを作成する場合、ファイルに好きな名前を付けて、
161.721 -好きな場所に置くことができますが、通常はファイル名を
161.722 -.B overview.html
161.723 -にして、ソースツリーの一番上の階層に置きます。
161.724 -たとえば、
161.725 -.B java.applet
161.726 -パッケージのソースファイルが
161.727 -.B /home/user/src/java/applet
161.728 -ディレクトリに含まれているとすると、
161.729 -.BR /home/user/src/overview.html
161.730 -に概要コメントファイルを作成することができます。
161.731 -.LP
161.732 -異なるパッケージのセットに対して javadoc を複数回実行する場合は、同じ 1 つのソースファイルのセットに対して複数の概要コメントファイルを作成できます。
161.733 -たとえば、内部ドキュメンテーション用に \-private を指定して javadoc を 1 回実行したあと、公開ドキュメンテーション用にそのオプションを指定しないで再度実行することができます。この場合、各概要コメントファイルの 1 文目で、そのドキュメンテーションを公開用または内部用として記述できます。
161.734 -.LP
161.735 -概要コメントファイルの内容は、前に述べたパッケージコメントファイルと
161.736 -同様、HTML で記述された 1 つの大きなドキュメント
161.737 -コメントです。詳細は、前述の説明を参照してください。繰り返しに
161.738 -なりますが、このコメントを書く場合は、最初の文をアプリケーション
161.739 -またはパッケージのセットの要約にし、
161.740 -.B <body>
161.741 -と最初の文の間にタイトルまたはその他のテキストを含めてはなりません。
161.742 -概要タグを含めることができます。どのドキュメンテーションコメントに
161.743 -ついても、{\f3@link\f1}
161.744 -以外のタグは、説明のあとに置く必要があります。
161.745 -.B @see
161.746 -タグを追加する場合は、完全指定の名前を使用する必要があります。
161.747 -.LP
161.748 -.BR javadoc
161.749 -ツールの実行時に、
161.750 -.B \-overview
161.751 -オプションを使って概要コメントファイル名を指定します。ファイルは、
161.752 -パッケージコメントファイルと同じように処理されます。
161.753 +.SS
161.754 +茯
161.755 +.LP
161.756 +.LP
161.757 +\f2ャ<潟若激с潟潟<潟\fP\f2doc 潟<潟\fP\f2筝肢\fP\f2帥違\fP\f2帥違\fP\f2ゃ潟ゃ潟帥違\fP茯ゃャ<潟若激с潟潟<潟ц障罨<篁茯Javadoc 若潟潟鴻х劫潟<障
161.758 +.LP
161.759 +.RS 3
161.760 +.TP 3
161.761 +ャ<潟 (generated document)
161.762 +javadoc 若 Java 純若鴻潟若ャ<潟若激с潟潟<潟ャ<潟сャ<潟 HTML 綵√с罔羣c篏障
161.763 +.LP
161.764 +.TP 3
161.765 + (name)
161.766 +Java 荐茯ф吾違荀膣ゃ障宴若吾鴻ゃ潟帥с若鴻c若潟潟鴻帥障<純с\f2java.lang.String.equals(java.lang.Object)\fP 絎篆蕋障\f2equals(Object)\fP 篆蕋障с障
161.767 +.LP
161.768 +.TP 3
161.769 +ャ<潟 (documented classes)
161.770 +javadoc 若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻сャ<潟純若鴻<ゃ篏睡純с違純若鴻<ゃ障宴若後 javadoc 潟潟羝<≪祉剛信蕋上 (publicprotectedpackage\-private 障 private) cc水違障ャ<潟鴻javadoc 若阪腟粋昭障鴻ゃ障鴻若違障
161.771 +.LP
161.772 +.TP 3
161.773 + (included classes)
161.774 +若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻сャ<潟鴻
161.775 +.LP
161.776 +.TP 3
161.777 +ゅ (excluded classes)
161.778 +若絎茵c荅括完ャ<潟鴻潟ゃ潟帥с若鴻с
161.779 +.LP
161.780 +.TP 3
161.781 +с (referenced classes)
161.782 +ャ<潟鴻潟ゃ潟帥с若鴻絎臂 (絎茖) 障ャ<潟若激с潟潟<潟筝ф腓榊с鴻潟ゃ潟帥с若鴻сс箴祉ゃ<若帥c鴻≦宍鴻絎茖ゃ潟帥с若鴻ゃ潟若鴻<純篏т戎鴻@see{@link}{@linkplain}{@inheritDoc} 帥違障絎臂
161.783 +.na
161.784 +\f21.3\fP @
161.785 +.fi
161.786 +http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javadoc.html#referencedclasses 紊眼障javadoc 若絎茵Javadoc 若鴻鴻潟鴻劫鴻с鴻<≪若若綽荀障с鴻荀ゃ翫鴻荀ゃ障茘茵腓冴障Javadoc 若鴻絖<潟若絎絎ゅャ綽荀鴻宴.class <ゃ綣冴с障
161.787 +.LP
161.788 +.TP 3
161.789 +紊с (external referenced classes)
161.790 +с鴻<javadoc 若絎茵筝ャ<潟鴻сゃ障鴻潟潟茵 Javadoc 若羝<障ャ<潟с鴻潟膊紊с障紊潟若違障違\f2java.awt\fP 宴若吾絲障 Javadoc 若絎茵翫\f2Object\fP \f2java.lang\fP 鴻鴻紊с鴻障紊с鴻潟\f2\-link\fP \f2\-linkoffline\fP 激с潟篏睡障紊с鴻絽吾純若鴻潟<潟 javadoc 若絎茵ус荀劫彰障翫潟<潟膓帥с障
161.791 +.RE
161.792 +
161.793 +.LP
161.794 +.SH "純若鴻<ゃ"
161.795 +.LP
161.796 +.LP
161.797 +Javadoc 若4 腮蕁違純若鴻<ゃ阪腟障<ゃ鴻 Java 荐茯純若鴻<ゃ (\f2.java\fP)宴若吾潟<潟<ゃ网荀潟<潟<ゃ潟篁<ゃс障ャ<潟純若鴻若絖翫鴻<ゃ潟若<ゃゃ茯障
161.798 +.LP
161.799 +.SS
161.800 +鴻純若鴻潟若<ゃ
161.801 +.LP
161.802 +.LP
161.803 +鴻障ゃ潟帥с若鴻潟<潟若ャ<潟若激с潟潟<潟ゃс \f2.java\fP <ゃ篆障ャ<潟若激с潟潟<潟荅括完ャ<潟若激с潟潟<潟с
161.804 +.LP
161.805 +.SS
161.806 +宴若吾潟<潟<ゃ
161.807 +.LP
161.808 +.LP
161.809 +宴若吾ャ<潟若激с潟潟<潟ゃс絨純若鴻<ゃ篆障 絎鴻Javadoc 若c网荀若吾腟粋昭障障潟<潟絽吾宴若後篏綵障ャ<潟荐菴違障
161.810 +.LP
161.811 +.LP
161.812 +宴若吾潟<潟<ゃ篏翫潟<潟主罨< 2 ゃ<ゃ御с障
161.813 +.LP
161.814 +.RS 3
161.815 .TP 2
161.816 -\(bu
161.817 -.B <body>
161.818 -タグと
161.819 -.B </body>
161.820 -タグとの間にあるすべての内容を処理のためにコピーする
161.821 +o
161.822 +\f2package\-info.java\fP \- 宴若後h宴若御絵宴若吾潟<潟 Javadoc 帥違主с障<ゃ JDK 5.0 уャсpackage.html ィ絅障
161.823 .TP 2
161.824 -\(bu
161.825 -存在する概要タグを処理する
161.826 +o
161.827 +\f2package.html\fP \- 主с宴若吾潟<潟 Javadoc 帥違с 宴若御絵主с障
161.828 +.RE
161.829 +
161.830 +.LP
161.831 +.LP
161.832 +宴若吾筝 \f2package.html\fP <ゃ筝 \f2package\-info.java\fP <ゃゃс障筝≧鴻ゃс障<<ゃ \f2.java\fP <ゃ純若鴻弱宴若吾c臀
161.833 +.LP
161.834 +.LP
161.835 +\f4package\-info.java\fP \- <ゃ罨<罕宴若吾潟<潟主с障 潟<潟宴若後h臀障
161.836 +.LP
161.837 +.LP
161.838 +File:\f2java/applet/package\-info.java\fP
161.839 +.LP
161.840 +.LP
161.841 +.TS
161.842 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.843 +.de 35
161.844 +.ps \n(.s
161.845 +.vs \n(.vu
161.846 +.in \n(.iu
161.847 +.if \n(.u .fi
161.848 +.if \n(.j .ad
161.849 +.if \n(.j=0 .na
161.850 +..
161.851 +.nf
161.852 +.nr #~ 0
161.853 +.if n .nr #~ 0.6n
161.854 +.ds #d .d
161.855 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.856 +.fc
161.857 +.nr 33 \n(.s
161.858 +.rm 80
161.859 +.nr 34 \n(.lu
161.860 +.eo
161.861 +.am 80
161.862 +.br
161.863 +.di a+
161.864 +.35
161.865 +.ft \n(.f
161.866 +.ll \n(34u*1u/2u
161.867 +.if \n(.l<\n(80 .ll \n(80u
161.868 +.in 0
161.869 +.nf
161.870 +\f3
161.871 +.fl
161.872 +/**
161.873 +.fl
161.874 + * Provides the classes necessary to create an
161.875 +.fl
161.876 + * applet and the classes an applet uses
161.877 +.fl
161.878 + * to communicate with its applet context.
161.879 +.fl
161.880 + * <p>
161.881 +.fl
161.882 + * The applet framework involves two entities:
161.883 +.fl
161.884 + * the applet and the applet context.
161.885 +.fl
161.886 + * An applet is an embeddable window (see the
161.887 +.fl
161.888 + * {@link java.awt.Panel} class) with a few extra
161.889 +.fl
161.890 + * methods that the applet context can use to
161.891 +.fl
161.892 + * initialize, start, and stop the applet.
161.893 +.fl
161.894 + *
161.895 +.fl
161.896 + * @since 1.0
161.897 +.fl
161.898 + * @see java.awt
161.899 +.fl
161.900 + */
161.901 +.fl
161.902 +package java.lang.applet;
161.903 +.fl
161.904 +\fP
161.905 +.fi
161.906 +.br
161.907 +.di
161.908 +.nr a| \n(dn
161.909 +.nr a- \n(dl
161.910 +..
161.911 +.ec \
161.912 +.35
161.913 +.nf
161.914 +.ll \n(34u
161.915 +.nr 80 0
161.916 +.80
161.917 +.rm 80
161.918 +.nr 38 \n(a-
161.919 +.if \n(80<\n(38 .nr 80 \n(38
161.920 +.35
161.921 +.nf
161.922 +.ll \n(34u
161.923 +.nr 38 1n
161.924 +.nr 79 0
161.925 +.nr 40 \n(79+(0*\n(38)
161.926 +.nr 80 +\n(40
161.927 +.nr TW \n(80
161.928 +.if t .if \n(TW>\n(.li .tm Table at line 353 file Input is too wide - \n(TW units
161.929 +.fc
161.930 +.nr #T 0-1
161.931 +.nr #a 0-1
161.932 +.eo
161.933 +.de T#
161.934 +.ds #d .d
161.935 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.936 +.mk ##
161.937 +.nr ## -1v
161.938 +.ls 1
161.939 +.ls
161.940 +..
161.941 +.ec
161.942 +.ne \n(a|u+\n(.Vu
161.943 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.944 +.ta \n(80u
161.945 +.nr 31 \n(.f
161.946 +.nr 35 1m
161.947 +\&\h'|\n(40u'
161.948 +.mk ##
161.949 +.nr 31 \n(##
161.950 +.sp |\n(##u-1v
161.951 +.nr 37 \n(40u
161.952 +.in +\n(37u
161.953 +.a+
161.954 +.in -\n(37u
161.955 +.mk 32
161.956 +.if \n(32>\n(31 .nr 31 \n(32
161.957 +.sp |\n(31u
161.958 +.fc
161.959 +.nr T. 1
161.960 +.T# 1
161.961 +.35
161.962 +.rm a+
161.963 +.TE
161.964 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
161.965 +
161.966 +.LP
161.967 +.LP
161.968 +潟<潟阪絖 \f2/**\fP \f2/*\fP 荐菴違綽荀障筝茵茵≪鴻帥鴻ャ障障
161.969 +.LP
161.970 +.LP
161.971 +\f4package.html\fP \- <ゃ罨<罕宴若吾潟<潟主с障 潟<潟 \f2<body>\fP 荀膣臀障
161.972 +.LP
161.973 +.LP
161.974 +File:\f2java/applet/package.html\fP
161.975 +.LP
161.976 +.LP
161.977 +.TS
161.978 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.979 +.de 35
161.980 +.ps \n(.s
161.981 +.vs \n(.vu
161.982 +.in \n(.iu
161.983 +.if \n(.u .fi
161.984 +.if \n(.j .ad
161.985 +.if \n(.j=0 .na
161.986 +..
161.987 +.nf
161.988 +.nr #~ 0
161.989 +.if n .nr #~ 0.6n
161.990 +.ds #d .d
161.991 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.992 +.fc
161.993 +.nr 33 \n(.s
161.994 +.rm 80
161.995 +.nr 34 \n(.lu
161.996 +.eo
161.997 +.am 80
161.998 +.br
161.999 +.di a+
161.1000 +.35
161.1001 +.ft \n(.f
161.1002 +.ll \n(34u*1u/2u
161.1003 +.if \n(.l<\n(80 .ll \n(80u
161.1004 +.in 0
161.1005 +.nf
161.1006 +\f3
161.1007 +.fl
161.1008 +<HTML>
161.1009 +.fl
161.1010 +<BODY>
161.1011 +.fl
161.1012 +Provides the classes necessary to create an applet and the
161.1013 +.fl
161.1014 +classes an applet uses to communicate with its applet context.
161.1015 +.fl
161.1016 +<p>
161.1017 +.fl
161.1018 +The applet framework involves two entities: the applet
161.1019 +.fl
161.1020 +and the applet context. An applet is an embeddable
161.1021 +.fl
161.1022 +window (see the {@link java.awt.Panel} class) with a
161.1023 +.fl
161.1024 +few extra methods that the applet context can use to
161.1025 +.fl
161.1026 +initialize, start, and stop the applet.
161.1027 +.fl
161.1028 +
161.1029 +.fl
161.1030 +@since 1.0
161.1031 +.fl
161.1032 +@see java.awt
161.1033 +.fl
161.1034 +</BODY>
161.1035 +.fl
161.1036 +</HTML>
161.1037 +.fl
161.1038 +\fP
161.1039 +.fi
161.1040 +.br
161.1041 +.di
161.1042 +.nr a| \n(dn
161.1043 +.nr a- \n(dl
161.1044 +..
161.1045 +.ec \
161.1046 +.35
161.1047 +.nf
161.1048 +.ll \n(34u
161.1049 +.nr 80 0
161.1050 +.80
161.1051 +.rm 80
161.1052 +.nr 38 \n(a-
161.1053 +.if \n(80<\n(38 .nr 80 \n(38
161.1054 +.35
161.1055 +.nf
161.1056 +.ll \n(34u
161.1057 +.nr 38 1n
161.1058 +.nr 79 0
161.1059 +.nr 40 \n(79+(0*\n(38)
161.1060 +.nr 80 +\n(40
161.1061 +.nr TW \n(80
161.1062 +.if t .if \n(TW>\n(.li .tm Table at line 406 file Input is too wide - \n(TW units
161.1063 +.fc
161.1064 +.nr #T 0-1
161.1065 +.nr #a 0-1
161.1066 +.eo
161.1067 +.de T#
161.1068 +.ds #d .d
161.1069 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.1070 +.mk ##
161.1071 +.nr ## -1v
161.1072 +.ls 1
161.1073 +.ls
161.1074 +..
161.1075 +.ec
161.1076 +.ne \n(a|u+\n(.Vu
161.1077 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.1078 +.ta \n(80u
161.1079 +.nr 31 \n(.f
161.1080 +.nr 35 1m
161.1081 +\&\h'|\n(40u'
161.1082 +.mk ##
161.1083 +.nr 31 \n(##
161.1084 +.sp |\n(##u-1v
161.1085 +.nr 37 \n(40u
161.1086 +.in +\n(37u
161.1087 +.a+
161.1088 +.in -\n(37u
161.1089 +.mk 32
161.1090 +.if \n(32>\n(31 .nr 31 \n(32
161.1091 +.sp |\n(31u
161.1092 +.fc
161.1093 +.nr T. 1
161.1094 +.T# 1
161.1095 +.35
161.1096 +.rm a+
161.1097 +.TE
161.1098 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-40
161.1099 +
161.1100 +.LP
161.1101 +.LP
161.1102 +絽吾 HTML <ゃс宴若後hс鴻羈宴若吾潟<潟<ゃ絎鴻祉鴻潟<潟罕 HTML ц菴違障ャ<潟若激с潟潟<潟潟<潟阪絖с \f2/**\fP \f2*/\fP活≪鴻帥鴻с潟<潟吾翫宴若吾网荀\f2<body>\fP 帥ゃ篁鴻障宴若吾帥違с障祉ャ<潟若激с潟潟<潟罕鴻帥違筝肢臀違障宴若吾潟<潟<ゃ \f2@see\fP 帥違菴遵翫絎絎篏睡綽荀障荅括完
161.1103 +.na
161.1104 +\f2package.html\fP 箴 @
161.1105 +.fi
161.1106 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#packagecommentsс
161.1107 +.LP
161.1108 +.LP
161.1109 +\f3宴若吾潟<潟<ゃ\fP \- Javadoc 若絎茵宴若吾潟<潟<ゃ罎膣≪<ゃ荀ゃ罨<茵障
161.1110 +.LP
161.1111 +.RS 3
161.1112 .TP 2
161.1113 -\(bu
161.1114 -概要の要約などの Javadoc が生成する概要ページの最後に、
161.1115 -処理されたテキストを挿入する
161.1116 +o
161.1117 +с潟<潟潟若 (\f2package.html\fP 翫с違\f2<body>\fP \f2</body>\fP HTML 帥違絎鴻鴻潟若\f2<head>\fP \f2<title>\fP 純若鴻<ゃ篏罔荐菴違宴臀с緇ャ<潟若激с潟筝茵腓冴)
161.1118 .TP 2
161.1119 -\(bu
161.1120 -概要ページの先頭に、概要コメントの最初の文をコピーする
161.1121 -.SS "その他の処理されないファイル"
161.1122 -ソースには、
161.1123 -.B javadoc
161.1124 -ツールで生成先のディレクトリにコピーする、その他の任意のファイルを
161.1125 -含めることができます。一般に、このようなファイルには、
161.1126 -サンプルのグラフィックファイル、Java ソース
161.1127 -(\f3.java\f1) およびクラス (\f3.class\f1) ファイル、内容が
161.1128 -通常の Java ソース
161.1129 -ファイルのドキュメンテーションコメントの影響を受けない
161.1130 -独立した HTML ファイルなどがあります。
161.1131 -.LP
161.1132 -処理されないファイルを含めるには、それらのファイルを
161.1133 -.BR doc-files
161.1134 -というディレクトリに置きます。このディレクトリは、任意のパッケージ
161.1135 -ディレクトリの下に作成できます。パッケージごとにこのようなサブ
161.1136 -ディレクトリを 1 つ持つことができます。このサブディレクトリには、
161.1137 -イメージ、サンプルコード、ソースファイル、
161.1138 -.B .class
161.1139 -ファイル、アプレット、および HTML ファイルを入れることができます。
161.1140 -たとえば、ボタンの画像
161.1141 -.B button.gif
161.1142 -を
161.1143 -.B java.awt.Button
161.1144 -クラスドキュメントに含めたい場合は、そのファイルを
161.1145 -.B /home/user/src/java/awt/doc-files/
161.1146 -ディレクトリに置きます。
161.1147 -.BR doc-files
161.1148 -ディレクトリを
161.1149 -.B /home/user/src/java/doc-files
161.1150 -に置くことはできません。これは、
161.1151 -.B java
161.1152 -はパッケージではなく、そのディレクトリそのものにソースファイルが
161.1153 -入っていないからです。
161.1154 -.LP
161.1155 -これらの処理されないファイルへのリンクは
161.1156 -すべて明示的に記述する必要があります。これは、
161.1157 -.B javadoc
161.1158 -ツールがファイルを見ずに、単にディレクトリとその内容物を生成先に
161.1159 -コピーするだけだからです。たとえば、
161.1160 -.B Button.java
161.1161 -ドキュメンテーションコメント内のリンクは、次のようになります。
161.1162 -.LP
161.1163 -.ft 3
161.1164 +o
161.1165 +宴若吾帥違違鴻
161.1166 +.TP 2
161.1167 +o
161.1168 +宴若吾网荀若吾緇鴻水ャ (箴:
161.1169 +.na
161.1170 +\f2宴若吾网荀\fP @
161.1171 +.fi
161.1172 +http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html)
161.1173 +.TP 2
161.1174 +o
161.1175 +宴若吾网荀若吾宴若吾潟<潟潟若网荀若吾宴若吾鴻宴若後宴若吾潟<潟菴遵 (箴:
161.1176 +.na
161.1177 +\f2网荀荀膣\fP @
161.1178 +.fi
161.1179 +http://java.sun.com/javase/6/docs/api/overview\-summary.html)絨障鴻<潟若筝肢絨障荀cゆ
161.1180 +.RE
161.1181 +
161.1182 +.LP
161.1183 +.SS
161.1184 +网荀潟<潟<ゃ
161.1185 +.LP
161.1186 +.LP
161.1187 +ャ<潟≪宴若激с潟障宴若吾祉网荀ャ<潟若激с潟潟<潟ゃс絨純若鴻<ゃ篆障 絎鴻Javadoc 若c网荀若吾腟粋昭障障潟<潟絽吾≪宴若激с潟障宴若吾祉篏綵障ャ<潟荐菴違障
161.1188 +.LP
161.1189 +.LP
161.1190 +网荀潟<潟<ゃ篏翫<ゃ篁紙篁篁紙贋臀с障絽吾<ゃ \f4overview.html\fP 純若鴻若筝篏臀障違\f2java.applet\fP 宴若吾純若鴻<ゃ \f2/home/user/src/java/applet\fP c障翫\f2/home/user/src/overview.html\fP 网荀潟<潟<ゃ篏с障
161.1191 +.LP
161.1192 +.LP
161.1193 +違宴若吾祉絲障 javadoc 茲医絎茵翫 1 ゃ純若鴻<ゃ祉絲障茲違网荀潟<潟<ゃ篏с障違ャ<潟若激с括 \-private 絎 javadoc 1 絎茵ャ<潟若激с括激с潟絎у綺絎茵с障翫网荀潟<潟<ゃ 1 сャ<潟若激с潟障荐菴違с障
161.1194 +.LP
161.1195 +.LP
161.1196 +网荀潟<潟<ゃ絎鴻菴違宴若吾潟<潟<ゃ罕HTML ц菴違 1 ゃ紊сャ<潟若激с潟潟<潟с荅括完菴違茯с荀鴻膵違菴潟<潟荐菴違翫≪宴若激с潟障宴若吾祉荀膣\f2<body>\fP 帥ゃ篁鴻障网荀帥違с障 ャ<潟若激с潟潟<潟ゃゃ潟ゃ潟帥 (\f2{@link}\fP ) 篁ュ鴻帥違筝肢臀鏆荀障\f2@see\fP 帥違菴遵翫絎絎篏睡違障
161.1197 +.LP
161.1198 +.LP
161.1199 +Javadoc 若絎茵\-overview 激с潟篏帥c网荀潟<潟<ゃ絎障<ゃ宴若吾潟<潟<ゃ障
161.1200 +.LP
161.1201 +.RS 3
161.1202 +.TP 2
161.1203 +o
161.1204 +\f2<body>\fP 帥違 \f2</body>\fP 帥違鴻絎鴻潟若
161.1205 +.TP 2
161.1206 +o
161.1207 +网荀帥違違鴻
161.1208 +.TP 2
161.1209 +o
161.1210 +网荀若吾緇鴻水ャ (箴:
161.1211 +.na
161.1212 +\f2网荀荀膣\fP @
161.1213 +.fi
161.1214 +http://java.sun.com/javase/6/docs/api/overview\-summary.html)
161.1215 +.TP 2
161.1216 +o
161.1217 +网荀若吾网荀潟<潟潟若
161.1218 +.RE
161.1219 +
161.1220 +.LP
161.1221 +.SS
161.1222 +篁<ゃ
161.1223 +.LP
161.1224 +.LP
161.1225 +純若鴻Javadoc 若cc潟若篁篁紙<ゃс障筝<ゃ違c<ゃ泣潟 Java 純若 (.java) 潟 (.class) <ゃ絎鴻絽吾 Java 純若鴻<ゃャ<潟若激с潟潟<潟綵演帥腴 HTML <ゃ障
161.1226 +.LP
161.1227 +.LP
161.1228 +<ゃ純若鴻<ゃ \f4doc\-files\fP c臀障 c純若鴻<ゃ篁紙宴若吾c筝篏с障泣c宴若吾 1 ょс障ゃ<若吾泣潟潟若純若鴻<ゃ.class <ゃ≪ HTML <ゃc主с障違帥潟ゃ<若 \f2button.gif\fP \f2java.awt.Button\fP 鴻ャ<潟翫<ゃ \f2/home/user/src/java/awt/doc\-files/\fP c臀障\f2doc\-files\fP c \f2/home/user/src/java/doc\-files\fP 臀с障 \f2java\fP 宴若吾сc純若鴻<ゃャcс
161.1229 +.LP
161.1230 +.LP
161.1231 +<ゃ吾潟鴻腓榊荐菴違綽荀障 Javadoc 若<ゃ荀c絎鴻潟若с違\f2Button.java\fP ャ<潟若激с潟潟<潟潟罨<障
161.1232 +.LP
161.1233 .nf
161.1234 -/**
161.1235 -* This button looks like this:
161.1236 -* <img src="doc-files/Button.gif">
161.1237 -*/
161.1238 +\f3
161.1239 +.fl
161.1240 + /**
161.1241 +.fl
161.1242 + * This button looks like this:
161.1243 +.fl
161.1244 + * <img src="doc\-files/Button.gif">
161.1245 +.fl
161.1246 + */
161.1247 +.fl
161.1248 +\fP
161.1249 .fi
161.1250 -.ft 1
161.1251 -.SH "テストファイルおよびテンプレートファイル"
161.1252 -一部の開発者から、テストファイルおよびテンプレートファイルを
161.1253 -対応するソースファイルの近くのソースツリーに保存したいという要望がありました。
161.1254 -つまり、これらのソースファイルと同じディレクトリまたはサブディレクトリに
161.1255 -保存したいということです。
161.1256 -.LP
161.1257 -個別のソースファイル名で明示的に渡して
161.1258 -.B Javadoc
161.1259 -ツールを実行する場合は、
161.1260 -テストファイルおよびテンプレートファイルを意図的に除外して、
161.1261 -処理されないようにすることができます。ただし、パッケージ名または
161.1262 -ワイルドカードで渡す場合は、以下のルールに従って、これらのテストファイル
161.1263 -およびテンプレートファイルが
161.1264 -処理されないようにする必要があります。
161.1265 -.LP
161.1266 -テストファイルとテンプレートファイルの違いは、
161.1267 -テストファイルは、正当でコンパイル可能なソースファイルであるのに対して、
161.1268 -テンプレートファイルは、そうではないという点です。ただし、
161.1269 -テンプレートファイルも「.java」で終わることができます。
161.1270 -.TP
161.1271 -テストファイル \-
161.1272 -開発者の多くは、あるパッケージのコンパイル可能で実行可能な
161.1273 -テストファイルをそのパッケージのソースファイルと同じ
161.1274 -ディレクトリに配置したいと考えています。
161.1275 -しかしテストファイルは、名前なしパッケージなど、
161.1276 -ソースファイルパッケージとは別のパッケージに属させたいとも
161.1277 -考えています (そのため、テストファイルには package ステートメントがないか、
161.1278 -またはソースとは別の package ステートメントがあります)。
161.1279 -このような状況では、コマンド行で指定されているソースのパッケージ名を指定して
161.1280 -そのソースがドキュメント化されているときに、
161.1281 -テストファイルは警告またはエラーを引き起こします。
161.1282 -そのようなテストファイルはサブディレクトリに配置する必要があります。
161.1283 -たとえばソースファイルのテストファイルを
161.1284 -.B com.package1
161.1285 -に追加する場合は、それらのテストファイルを、ハイフンが含まれるため
161.1286 -パッケージ名としては無効になる
161.1287 -サブディレクトリに配置します。
161.1288 -.LP
161.1289 -.RS 5
161.1290 -com/package1/test-files/
161.1291 +
161.1292 +.LP
161.1293 +.SS
161.1294 +鴻<ゃ潟潟若<ゃ
161.1295 +.LP
161.1296 +.LP
161.1297 +筝肴鴻<ゃ潟潟若<ゃ絲上純若鴻<ゃ菴純若鴻若篆絖荀障ゃ障純若鴻<ゃc障泣c篆絖с
161.1298 +.LP
161.1299 +.LP
161.1300 +ャ純若鴻<ゃф腓榊羝< Javadoc 若絎茵翫鴻<ゃ潟潟若<ゃ括ゅс障宴若後障ゃ若ф検翫篁ヤ若緇c鴻<ゃ潟潟若<ゃ綽荀障
161.1301 +.LP
161.1302 +.LP
161.1303 +鴻<ゃ潟若<ゃ鴻<ゃ罩eс潟潟ゃ純純若鴻<ゃс絲障潟若<ゃс鴻с 潟若<ゃ.javaхс障
161.1304 +.LP
161.1305 +.LP
161.1306 +\f3鴻<ゃ\fP \- 肴紊宴若吾潟潟ゃ純у茵純鴻<ゃ宴若吾純若鴻<ゃc臀障鴻<ゃ宴若吾純若鴻<ゃ宴若吾ャ宴若吾絮障 (鴻<ゃ package 鴻若<潟障純若鴻ャ package 鴻若<潟)倶с潟潟茵ф絎純若鴻宴若後絎純若鴻ャ<潟鴻<ゃ茘障若綣莎激障鴻<ゃ泣c臀綽荀障\f2com.package1\fP 菴遵翫鴻<ゃゃ潟障宴若後≦鴻泣c臀障
161.1307 +.LP
161.1308 +.nf
161.1309 +\f3
161.1310 +.fl
161.1311 + com/package1/test\-files/
161.1312 +.fl
161.1313 +\fP
161.1314 +.fi
161.1315 +
161.1316 +.LP
161.1317 +.LP
161.1318 +Javadoc 若с茘 test c鴻障
161.1319 +.LP
161.1320 +.LP
161.1321 +鴻<ゃ doc 潟<潟障翫罨<ゃ若鴻純若鴻<ゃф検鴻<ゃャ<潟Javadoc 若ュ絎茵с荐絎с障 違\f2com/package1/test\-files/*.java\fP с
161.1322 +.LP
161.1323 +.LP
161.1324 +\f3純若鴻<ゃ潟若\fP \- 潟若<ゃ.javaх障潟若<ゃ潟潟ゃс障純若鴻c篆純若鴻<ゃ潟若翫<ゃゃ (\f2Buffer\-Template.java\fP ) 篁筝罩c Java 絖篏睡障 с障Javadoc 若.java・絨乗ゃ 罩h劫с純若鴻<ゃсс (
161.1325 +.na
161.1326 +\f2茘ュ\fP @
161.1327 +.fi
161.1328 +http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625)
161.1329 +.LP
161.1330 +.SH "<ゃ"
161.1331 +.LP
161.1332 +.LP
161.1333 +сjavadoc 若HTML 綵√ャ<潟罔羣篏帥障篁ヤ腮蕁<ゃ障 HTML 若吾<ゃ後障javadoc <ゃ鴻ゃ潟帥с若鴻<с (\f2package\-summary.html\fP ) 2 腮蕁障緇違若<ゃ違若<ゃ腴九ゃ潟障障
161.1334 +.LP
161.1335 +.LP
161.1336 +\f3堺絎鴻若\fP
161.1337 +.LP
161.1338 +.RS 3
161.1339 +.TP 2
161.1340 +o
161.1341 +ャ<潟鴻障ゃ潟帥с若鴻 1 ゃ\f3鴻若吾障ゃ潟帥с若鴻若\fP (\f2劫\fP\f2.html\fP)
161.1342 +.TP 2
161.1343 +o
161.1344 +ャ<潟宴若吾 1 ゃ\f3宴若吾若\fP (\f2package\-summary.html\fP)Javadoc 若純若鴻若宴若吾c \f2package.html\fP 障 \f2package\-info.java\fP <ゃ違筝 HTML 鴻若吾腟水ャ障
161.1345 +.TP 2
161.1346 +o
161.1347 +宴若吾祉篏絲障 1 ゃ\f3网荀若\fP (\f2overview\-summary.html\fP)ャ<潟若吾障Javadoc 若\f2\-overview\fP 激с潟ф絎<ゃ HTML 鴻若吾腟水ャ障若吾<ゃjavadoc 茲違宴若後羝<翫篏障荅括完HTML 若с
161.1348 .RE
161.1349 -.LP
161.1350 -こうすると、
161.1351 -.B Javadoc
161.1352 -ツールでは警告なしで
161.1353 -test ディレクトリをスキップします。
161.1354 -.LP
161.1355 -テストファイルに doc コメントが含まれる場合、
161.1356 -次のようにワイルドカードを含んだテストソースファイル名で渡して
161.1357 -テストファイルのドキュメントを生成するように、
161.1358 -.B Javadoc
161.1359 -ツールを別個に実行できるように設定できます。
161.1360 -\f2com/package1/test\-files/*.java\fP.
161.1361 -.TP
161.1362 -ソースファイルのテンプレート\-
161.1363 -テンプレートファイルの名前は「.java」で終わることもありますが、
161.1364 -テンプレートファイルはコンパイルできません。
161.1365 -ソースディレクトリに保持したいソースファイルの
161.1366 -テンプレートがある場合は、
161.1367 -このファイル名にハイフン (Buffer-Template.java など) や
161.1368 -その他の不正な Java 文字を使用します。
161.1369 -こうすることで、処理されないようになります。
161.1370 -これは、
161.1371 -.B Javadoc
161.1372 -ツールが処理するのは、「.java」接尾辞を除いた名前が
161.1373 -正規のクラス名であるソースファイルだけであるためです (「識別子」http://java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#40625 参照)。
161.1374 -.SS "生成されるファイル"
161.1375 -デフォルトでは、
161.1376 -.B javadoc
161.1377 -は、HTML 形式のドキュメントを生成する標準ドックレットを
161.1378 -使います。
161.1379 -このドックレットは、以下の種類のファイルを生成します。以下の
161.1380 -各 HTML「ページ」は、それぞれ別のファイルに対応します。
161.1381 -.B javadoc
161.1382 -が生成するファイルの名前には、クラスやインタフェースの名前に
161.1383 -ちなんだものと、そうでないもの (\f3package-summary.html\f1 など)
161.1384 -の 2 種類があります。後者のグループには、前者のグループの名前と
161.1385 -ファイル名が競合しないように、ハイフンが含まれています。
161.1386 -.SS "基本内容ページ"
161.1387 +
161.1388 +.LP
161.1389 +.LP
161.1390 +\f3娯с若\fP
161.1391 +.LP
161.1392 +.RS 3
161.1393 .TP 2
161.1394 -\(bu
161.1395 -ドキュメント化する各クラスまたは各インタフェースに対し、1 つのクラス
161.1396 -ページまたはインタフェースページ (\f3classname.html\f1)
161.1397 +o
161.1398 +\f3宴若吾祉篏絲障 1 ゃ拷絮ゃ若\fP (\f2overview\-tree.html\fP)若吾茵腓冴蚊若激с潟若 [网荀] [絮ゃ] 障
161.1399 .TP 2
161.1400 -\(bu
161.1401 -ドキュメント化する各パッケージに対し、1 つのパッケージ
161.1402 -ページ (\f3package-summary.html\f1)。
161.1403 -.B javadoc
161.1404 -ツールによって、ソースツリーのパッケージディレクトリ内の
161.1405 -.B package.html
161.1406 -または
161.1407 -package\-info.java
161.1408 -というファイル内のすべての HTML テキストが含められる
161.1409 +o
161.1410 +\f3宴若吾 1 ゃ拷絮ゃ若\fP (\f2package\-tree.html\fP) 劫宴若吾鴻障ゃ潟帥с若鴻若吾茵腓冴[絮ゃ] 宴若吾拷絮ゃ茵腓冴障
161.1411 .TP 2
161.1412 -\(bu
161.1413 -パッケージのセット全体に対して 1 つの概要
161.1414 -ページ (\f3overview-summary.html\f1)。これは、生成される
161.1415 -ドキュメントの先頭ページになる。
161.1416 -.B javadoc
161.1417 -ツールによって、
161.1418 -.B -overview
161.1419 -オプションで指定されたファイル内のすべての HTML テキストが含められる。
161.1420 -このファイルが作成されるのは、
161.1421 -.B javadoc
161.1422 -に 2 つ以上のパッケージ名を渡した
161.1423 -場合だけであることに注意する。詳細は、以下の「HTML フレーム」節を参照
161.1424 -.SS "相互参照ページ"
161.1425 +o
161.1426 +\f3宴若吾 1 ゃ [篏睡] 若\fP (\f2package\-use.html\fP)\f3鴻潟ゃ潟帥с若鴻 1 ゃゃ [篏睡] 若\fP (\f2class\-use/\fP\f2劫\fP\f2.html\fP)若吾劫鴻ゃ潟帥с若鴻障宴若吾筝篏帥c宴若吾鴻<純潟潟鴻帥潟c若ゃ荐菴違障鴻障ゃ潟帥с若 A 箴 [篏睡] 若吾A 泣鴻A 絎hc若A 菴<純A <若帥ゃ<純潟潟潟鴻帥茵腓冴障 若吾茵腓冴障宴若吾鴻障ゃ潟帥с若鴻若吾腱糸蚊若激с潟若 [篏睡] 潟障
161.1427 .TP 2
161.1428 -\(bu
161.1429 -パッケージのセット全体に対して 1 つのクラス階層ページ
161.1430 -(\f3overview-tree.html\f1)。これを表示するには、ナビゲーション
161.1431 -バーの [概要] をクリックしてから、[階層ツリー] をクリックする
161.1432 +o
161.1433 +\f3ィ絅 API 若\fP (\f2deprecated\-list.html\fP) ィ絅鴻筝荀ц;腓冴障ィ絅筝壕 API 絖篏睡ィ絅 API с絽吾臀腓冴障ィ絅 API 絨ャ絎茖сゃ醇с障
161.1434 .TP 2
161.1435 -\(bu
161.1436 -各パッケージに対して 1 つのクラス階層
161.1437 -ページ (\f3package-tree.html\f1)。
161.1438 -特定のパッケージページ、クラスページ、またはインタフェースページを
161.1439 -表示し、[階層ツリー] をクリックすると、そのパッケージの階層が
161.1440 -表示される
161.1441 +o
161.1442 +\f3絎違c若ゃ若\fP (\f2constant\-values.html\fP) static c若ょс
161.1443 .TP 2
161.1444 -\(bu
161.1445 -各パッケージに対して 1 つの [使用]
161.1446 -ページ (\f3package-use.html\f1)と、
161.1447 -各クラスおよびインタフェースに対して別に 1 つの [使用]
161.1448 -ページ(\f3class-use/classname.html\f1)。このページは、特定のクラス、
161.1449 -インタフェース、またはパッケージのなんらかの部分を使っている
161.1450 -パッケージ、クラス、メソッド、コンストラクタ、およびフィールドを
161.1451 -記述する。クラスまたはインタフェース A について考えると、
161.1452 -その[使用] ページには、A のサブクラス、A として宣言された
161.1453 -フィールド、A を返すメソッド、A 型のパラメータを持つメソッド
161.1454 -およびコンストラクタが表示される。このページには、パッケージ、
161.1455 -クラス、またはインタフェースに移動してから、ナビゲーションバー
161.1456 -の [使用] リンクをクリックすることによってアクセスできる
161.1457 +o
161.1458 +\f3翫若若\fP (\f2serialized\-form.html\fP) 翫喝純鴻с鴻翫c若潟<純≪茯障宴API 篏帥肴с絎茖茵肴綽荀宴с蚊若激с潟若若吾吾潟障翫鴻腱糸鴻茯 [∫i] 祉激с潟 [翫綵√] 宴緇с障罔羣翫綵√若吾障Serializable 絎茖 public 障 public 鴻腟粋昭障\f2readObject\fP <純\f2writeObject\fP <純翫c若 \f2@serial\fP 帥違\f2@serialField\fP 帥違\f2@serialData\fP 帥違ャ<潟若激с潟潟<潟腟粋昭障障翫純 public 鴻ゅ鴻障鴻絮宴若吾 \f2@serial exclude\fP 帥違ф絎障 翫純 package private 鴻鴻障鴻絮宴若吾 \f2@serial include\fP 帥違ф絎障若吾с 1.4 с\f2\-private\fP 激с潟絎 javadoc 若絎茵public 鴻 private 鴻絎翫鴻с障
161.1459 .TP 2
161.1460 -\(bu
161.1461 -非推奨 API ページ (\f3deprecated-list.html\f1)。推奨されない
161.1462 -名前すべての一覧が含まれている (非推奨名は、通常は改良された API が
161.1463 -存在するために使用が推奨されていない API の名前で、たいていはそれに
161.1464 -置き換わる名前が提示されている。非推奨 API は、将来の実装では
161.1465 -削除される可能性がある)
161.1466 +o
161.1467 +\f3膣√\fP (\f2index\-*.html\fP) 鴻劫ゃ潟帥с若劫潟潟鴻水c若潟<純≪<筝с障膣√Unicode 宴初障 1 ゃ<ゃ絖 (沿翫 A Z) ャ<ゃс障
161.1468 +.RE
161.1469 +
161.1470 +.LP
161.1471 +.LP
161.1472 +\f3泣若<ゃ\fP
161.1473 +.LP
161.1474 +.RS 3
161.1475 .TP 2
161.1476 -\(bu
161.1477 -定数フィールド値ページ (\f3constant-values.html\f1) 。
161.1478 -static フィールドの値が表示される。
161.1479 +o
161.1480 +\f3若\fP (\f2help\-doc.html\fP) 蚊若激с潟若菴違若吾≪茯荐莠障\f2\-helpfile\fP 篏帥<ゃ篁c鴻帥<ゃ箴с障
161.1481 .TP 2
161.1482 -\(bu
161.1483 -直列化形式ページ (\f3serialized-form.html\f1)。直列化可能クラス
161.1484 -および外部化可能クラスの情報用。これらの各クラスには、直列化
161.1485 -フィールドおよびメソッドに関する説明がある。これらの情報は、API を
161.1486 -使う開発者ではなく、再実装者に必要な情報である。ナビゲーションバーに
161.1487 -リンクがない場合、任意の直列化されたクラスに移動して、
161.1488 -クラスの [関連項目] セクション内の [直列化された形式] をクリック
161.1489 -するとこの情報を取得できる
161.1490 -標準ドックレットは、直列化された形式のページを自動的に生成する。
161.1491 -ここには、Serializable を実装する public または非 public の
161.1492 -クラスが組み込まれており、さらに、
161.1493 -.B readObject
161.1494 -メソッド、
161.1495 -.B writeObject
161.1496 -メソッド、直列化されたフィールド、
161.1497 -および @serial タグ、@serialField タグ、@serialData タグからの
161.1498 -ドキュメンテーションコメントが組み込まれている。
161.1499 -直列化が可能な public クラスを除外するには、
161.1500 -そのクラスまたはそのクラスが属するパッケージを @serial exclude タグで
161.1501 -指定する。直列化が可能な package private クラスを含めるには、
161.1502 -そのクラスまたはそのクラスが属するパッケージを @serial include タグで
161.1503 -指定する。 1.4 では、
161.1504 -\-private
161.1505 -オプションを指定せずに javadoc を実行することで、public クラスおよび
161.1506 -private クラスに完全な直列化形式を生成することができる。
161.1507 +o
161.1508 +茵腓榊 HTML 若篏 1 ゃ \f3index.html <ゃ\fP<ゃ若篁若吾茵腓冴翫若障<ゃ篏鴻絎鴻障障
161.1509 .TP 2
161.1510 -\(bu
161.1511 -索引 (\f3index-*.html\f1)。すべてのクラス名、
161.1512 -インタフェース名、コンストラクタ名、フィールド名、およびメソッド名を
161.1513 -アルファベット順に並べてある。索引は、Unicode を扱えるように
161.1514 -国際化されており、1 つのファイルとして生成するか、または先頭
161.1515 -文字 (英語の場合 A から Z) ごとに別のファイルとして生成できる
161.1516 -.SS "サポートファイル"
161.1517 +o
161.1518 +茲違\f3若<ゃ\fP (\f2*\-frame.html\fP) 宴若吾鴻潟ゃ潟帥с若鴻鴻障障 HTML 若茵腓冴篏睡障
161.1519 .TP 2
161.1520 -\(bu
161.1521 -ヘルプページ (\f3help-doc.html\f1)。ナビゲーションバーおよび
161.1522 -上記のページについて説明する。
161.1523 -.BR \-helpfile
161.1524 -を使って、デフォルトの
161.1525 -ヘルプファイルに置き換わる独自のカスタムヘルプファイルを提供する
161.1526 -こともできる
161.1527 +o
161.1528 +\f3宴若吾鴻\fP<ゃ (\f2package\-list\fP) \f2\-link\fP 激с潟 \f2\-linkoffline\fP 激с潟т戎障HTML <ゃс鴻<ゃс潟≪祉鴻с障
161.1529 .TP 2
161.1530 -\(bu
161.1531 -1 つの
161.1532 -.B index.html
161.1533 -ファイル。表示用 の HTML フレームを作成する。このファイルは、
161.1534 -フレーム付きの最初のページを表示する場合にロードする。このファイル
161.1535 -自体は、テキスト内容を含まない
161.1536 +o
161.1537 +\f3鴻帥ゃ激若\fP<ゃ (\f2stylesheet.css\fP) 若娯ゃ荀膣ゃ蚊潟<潟泣ゃ冴潟鴻帥ゃ渇臀九勝障
161.1538 .TP 2
161.1539 -\(bu
161.1540 -複数のフレームファイル (\f3*-frame.html\f1)。パッケージ、クラス、
161.1541 -およびインタフェースの一覧を含む。HTML フレームを表示するときに
161.1542 -使われる
161.1543 +o
161.1544 +\f3doc\-files\fP c c潟若ゃ<若吾泣潟潟若純若鴻潟若<ゃ鴻主障<ゃJavadoc 若c<ゃ javadoc 帥違c∴障c純若鴻若筝翫睡障
161.1545 +.RE
161.1546 +
161.1547 +.LP
161.1548 +.LP
161.1549 +\f3HTML 若\fP
161.1550 +.LP
161.1551 +.LP
161.1552 +Javadoc 若筝潟腓冴2 3 ゃ HTML 若障1 ゃ宴若吾翫 (障宴若吾翫) 宴若吾筝荀сャc篏綽荀違若篏障筝宴若吾絮純若鴻<ゃ (*.java) 障筝宴若後綣違 javadoc 潟潟羝<翫綏眼鴻筝荀с茵腓冴若 (C) 1 ゃ篏障Javadoc 茲違宴若後羝<翫网荀若 (Detail) 鴻宴若吾筝荀ц;腓冴膃 3 若 (P) 篏障网荀若吾<ゃ\f2overview\-summary.html\fP сc<ゃ2 や札筝宴若後羝<翫篏障[若] 潟overview\-summary.html 茵腓冴若ャс障
161.1553 +.LP
161.1554 +.LP
161.1555 +HTML 若c翫劫若医激潟鴻若若若鴻違羈若若鴻筝若障紊吟с√違若若吾若篏帥c若鴻若[医] <ャ若潟潟篏帥c若医激с障
161.1556 +.LP
161.1557 +.nf
161.1558 +\f3
161.1559 +.fl
161.1560 + \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
161.1561 +.fl
161.1562 + |C| Detail | |P| Detail |
161.1563 +.fl
161.1564 + | | | | | |
161.1565 +.fl
161.1566 + | | | |\-| |
161.1567 +.fl
161.1568 + | | | |C| |
161.1569 +.fl
161.1570 + | | | | | |
161.1571 +.fl
161.1572 + | | | | | |
161.1573 +.fl
161.1574 + \-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-
161.1575 +.fl
161.1576 + javadoc *.java javadoc java.lang java.awt
161.1577 +.fl
161.1578 +\fP
161.1579 +.fi
161.1580 +
161.1581 +.LP
161.1582 +.LP
161.1583 +HTML 若綽荀c罨<<<ゃ紮若吾若障
161.1584 +.LP
161.1585 +.RS 3
161.1586 .TP 2
161.1587 -\(bu
161.1588 -パッケージリストファイル (\f3package-list\f1)。
161.1589 -.B \-link
161.1590 -オプションおよび
161.1591 -.B \-linkoffline
161.1592 -オプションで使われる。これは、HTML ファイルではなくテキストファイル
161.1593 -のため、リンクではアクセスできない
161.1594 +o
161.1595 +\f2index.html\fP (若)
161.1596 .TP 2
161.1597 -\(bu
161.1598 -スタイルシートファイル (\f3stylesheet.css\f1)。生成されるページ上に
161.1599 -表示される限られた色数、フォントファミリ、フォントサイズ、フォントの
161.1600 -スタイルおよび配置を制御する
161.1601 -.TP 2
161.1602 -\(bu
161.1603 -コピー先ディレクトリにコピーしたいファイル (イメージ、サンプル、
161.1604 -ソースファイルなど) が入っている doc ファイルのディレクトリ。
161.1605 -.B javadoc
161.1606 -ツールはこのようなファイルを処理しない。つまり、このようなファイル内の
161.1607 -.B javadoc
161.1608 -タグはすべて無視される。ソースツリーに存在しない限り、この
161.1609 -ディレクトリは生成されない
161.1610 -.SS "HTML フレーム"
161.1611 -.B javadoc
161.1612 -ツールは、下の図に示すように、2 つか 3 つの HTML フレームを生成します。
161.1613 -1 つのパッケージしかない場合 (またはパッケージがない場合) は、パッケージの一覧を省略することによって最低限必要な数のフレームを作成します。
161.1614 -ソースファイル (*\f3.java\f1) または単一のパッケージ名を引数として
161.1615 -.B javadoc
161.1616 -コマンドに渡す場合は、左側の列にクラスの一覧を表示する
161.1617 -フレーム (C) 1 つだけが作成されます。
161.1618 -.B javadoc
161.1619 -に複数のパッケージ名を渡す場合は、概要ページ (Detail) に加えて、
161.1620 -すべてのパッケージの一覧を表示する第 3 のフレーム (P) が
161.1621 -作成されます。この概要ページのファイル名は
161.1622 -.BR overview-summary.html
161.1623 -です。したがって、このファイルが作成されるのは、2 つ以上のパッケージ
161.1624 -名を渡した場合だけです。[フレームなし] リンクをクリックするか、
161.1625 -.BR overview-summary.html
161.1626 -から表示するようにすると、フレームを省略できます。
161.1627 -.LP
161.1628 -HTML フレームに慣れていない場合は、フレームには、印刷および
161.1629 -スクロール用の「フォーカス」が必要であることに注意する
161.1630 -必要があります。フレームにフォーカスを与えるには、そのフレームを
161.1631 -クリックします。すると、多くのブラウザでは、矢印キーおよびページキー
161.1632 -を使ってそのフレームをスクロールしたり、[印刷] メニュー
161.1633 -コマンドを使ってそのフレームを印刷したりできるようになります。
161.1634 -.LP
161.1635 -.ft 3
161.1636 -.nf
161.1637 - ------------ ------------
161.1638 - |C| Detail | |P| Detail |
161.1639 - | | | | | |
161.1640 - | | | |-| |
161.1641 - | | | |C| |
161.1642 - | | | | | |
161.1643 - | | | | | |
161.1644 - ------------ ------------
161.1645 - javadoc *.java javadoc java.lang java.awt
161.1646 -.fi
161.1647 -.ft 1
161.1648 -.LP
161.1649 -HTML フレームが必要かどうかによって、次のどちらかのファイルを
161.1650 -開始ページとしてロードします。
161.1651 -.LP
161.1652 -.TP 2
161.1653 -\(bu
161.1654 -.B index.html
161.1655 -(フレームあり)
161.1656 -.TP 2
161.1657 -\(bu
161.1658 -.B overview-summary.html
161.1659 -(フレームなし)
161.1660 -.SS "生成されるファイル構造"
161.1661 -生成されるクラスファイルおよびインタフェースファイルは、Java ソース
161.1662 -ファイルおよびクラスファイルと同じディレクトリ階層で組織
161.1663 -されます。この構造は、1 つのサブパッケージにつき 1 つのディレクトリ
161.1664 -で構成されます。
161.1665 -.LP
161.1666 -たとえば、
161.1667 -.B java.applet.Applet
161.1668 -クラスに対して生成されるドキュメントは、
161.1669 -.BR java/applet/Applet.html
161.1670 -に格納されます。生成先のディレクトリの名前が apidocs だと
161.1671 -すると、java.applet パッケージのファイル構造もこれに従います。
161.1672 -前述したように、「frame」という語を名前に含むファイルは、
161.1673 -すべて左上または左下のフレームに表示されます。それ
161.1674 -以外の HTML ファイルは、すべて右側のフレームに表示されます。
161.1675 -.LP
161.1676 -注: ディレクトリは、太字 (bold) で示してあります。
161.1677 -アスタリスク (*) は、
161.1678 -.B javadoc
161.1679 -への引数がパッケージ名でなくソースファイル名 (*\f3.java\f1) の
161.1680 -ときに、省略されるファイルおよびディレクトリを示しています。また、
161.1681 -引数がソースファイル名のときには、
161.1682 -.B package-list
161.1683 -は作成されますが、空です。
161.1684 -.B doc-files
161.1685 -ディレクトリは、ソースツリー内に存在しない限り、生成先に表示されません。
161.1686 +o
161.1687 +\f2overview\-summary.html\fP (若)
161.1688 +.RE
161.1689 +
161.1690 +.LP
161.1691 +.LP
161.1692 +\f3<ゃ罕\fP
161.1693 +.LP
161.1694 +.LP
161.1695 +鴻<ゃ潟ゃ潟帥с若鴻<ゃJava 純若鴻<ゃ潟鴻<ゃc絮ゃ膩障1 ゃ泣宴若吾ゃ 1 ゃc罕障
161.1696 +.LP
161.1697 +.LP
161.1698 +違\f2java.applet.Applet\fP 鴻絲障ャ<潟\f2java/applet/Applet.html\fP 主障c \f2apidocs\fP java.applet 宴若吾<ゃ罕筝罕膀障菴違frame茯<ゃ鴻綏筝障綏筝若茵腓冴障篁ュ HTML <ゃ鴻勀眼若茵腓冴障
161.1699 +.LP
161.1700 +.RS 3
161.1701 +
161.1702 +.LP
161.1703 +.LP
161.1704 +羈 \- 筝絮ゅ潟сc\f3紊絖\fP (\f3bold\fP) хず障≪鴻帥鴻 (\f2*\fP) javadoc 吾綣違宴若後с純若鴻<ゃ (*.java) с翫ャ<ゃ潟c腓冴障障綣違純若鴻<ゃ翫\f2package\-list\fP 篏障絎鴻腥冴сdoc\-files c純若鴻弱絖翫帥篏障
161.1705 .LP
161.1706 .RE
161.1707 .nf
161.1708 @@ -932,90 +846,90 @@
161.1709 .fl
161.1710
161.1711 .fl
161.1712 -\fP\f3apidocs\fP 最上位ディレクトリ
161.1713 -.fl
161.1714 - index.html HTML フレームを設定する初期ページ
161.1715 -.fl
161.1716 - * overview\-summary.html 全パッケージのリスト。先頭に要約文がある
161.1717 -.fl
161.1718 - overview\-tree.html 全パッケージのクラス階層のリスト
161.1719 -.fl
161.1720 - deprecated\-list.html 全パッケージの推奨されない API のリスト
161.1721 -.fl
161.1722 - constant\-values.html 全パッケージの static フィールドの値のリスト
161.1723 -.fl
161.1724 - serialized\-form.html 全パッケージの直列化された形式のリスト
161.1725 -.fl
161.1726 - * overview\-frame.html 全パッケージのリスト。左上のフレームに表示される
161.1727 -.fl
161.1728 - allclasses\-frame.html 全パッケージの全クラスのリスト。左下のフレームに表示される
161.1729 -.fl
161.1730 - help\-doc.html これらのページの構成を示すユーザヘルプを表示する
161.1731 -.fl
161.1732 - index\-all.html \-splitindex オプションなしで作成されたデフォルト索引
161.1733 -.fl
161.1734 - \f3index\-files\fP \-splitindex オプションを指定して作成されたディレクトリ
161.1735 -.fl
161.1736 - index\-<number>.html \-splitindex オプションを指定して作成された索引ファイル
161.1737 -.fl
161.1738 - package\-list パッケージ名のリスト。外部参照を解決するためだけに使用される
161.1739 -.fl
161.1740 - stylesheet.css フォント、色、配置を定義する HTML スタイルシート
161.1741 -.fl
161.1742 - \f3java\fP パッケージディレクトリ
161.1743 -.fl
161.1744 - \f3applet\fP サブパッケージディレクトリ
161.1745 -.fl
161.1746 - Applet.html Applet クラスのページ
161.1747 -.fl
161.1748 - AppletContext.html AppletContext インタフェースのページ
161.1749 -.fl
161.1750 - AppletStub.html AppletStub インタフェースのページ
161.1751 -.fl
161.1752 - AudioClip.html AudioClip インタフェースのページ
161.1753 -.fl
161.1754 - * package\-summary.html このパッケージのクラスのリスト。先頭に要約文がある
161.1755 -.fl
161.1756 - * package\-frame.html このパッケージのクラスのリスト。左下のフレームに表示される
161.1757 -.fl
161.1758 - * package\-tree.html このパッケージのクラス階層のリスト
161.1759 -.fl
161.1760 - package\-use このパッケージが使用されている場所のリスト
161.1761 -.fl
161.1762 - \f3doc\-files\fP イメージやサンプルのファイルが格納されるディレクトリ
161.1763 -.fl
161.1764 - \f3class\-use\fP API が使用されている場所のページを格納するディレクトリ
161.1765 -.fl
161.1766 - Applet.html Applet クラスを使用するページ
161.1767 -.fl
161.1768 - AppletContext.html AppletContext インタフェースを使用するページ
161.1769 -.fl
161.1770 - AppletStub.html AppletStub インタフェースを使用するページ
161.1771 -.fl
161.1772 - AudioClip.html AudioClip インタフェースを使用するページ
161.1773 -.fl
161.1774 - \f3src\-html\fP ソースコードディレクトリ
161.1775 -.fl
161.1776 - \f3java\fP パッケージディレクトリ
161.1777 -.fl
161.1778 - \f3applet\fP サブパッケージディレクトリ
161.1779 -.fl
161.1780 - Applet.html Applet ソースコードのページ
161.1781 -.fl
161.1782 - AppletContext.html AppletContext ソースコードのページ
161.1783 -.fl
161.1784 - AppletStub.html AppletStub ソースコードのページ
161.1785 -.fl
161.1786 - AudioClip.html AudioClip ソースコードのページ
161.1787 +\fP\f3apidocs\fP 筝篏c
161.1788 +.fl
161.1789 + index.html HTML 若荐絎若
161.1790 +.fl
161.1791 + * overview\-summary.html 宴若吾鴻 荀膣
161.1792 +.fl
161.1793 + overview\-tree.html 宴若吾拷絮ゃ鴻
161.1794 +.fl
161.1795 + deprecated\-list.html 宴若吾ィ絅 API 鴻
161.1796 +.fl
161.1797 + constant\-values.html 宴若吾 static c若ゃ鴻
161.1798 +.fl
161.1799 + serialized\-form.html 宴若吾翫綵√鴻
161.1800 +.fl
161.1801 + * overview\-frame.html 宴若吾鴻 綏筝若茵腓冴
161.1802 +.fl
161.1803 + allclasses\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
161.1804 +.fl
161.1805 + help\-doc.html 若吾罕腓冴若吟若茵腓冴
161.1806 +.fl
161.1807 + index\-all.html \-splitindex 激с潟т膣√
161.1808 +.fl
161.1809 + \f3index\-files\fP \-splitindex 激с潟絎篏c
161.1810 +.fl
161.1811 + index\-<number>.html \-splitindex 激с潟絎篏膣√<ゃ
161.1812 +.fl
161.1813 + package\-list 宴若後鴻 紊с茹f浦篏睡
161.1814 +.fl
161.1815 + stylesheet.css 潟蚊臀絎臂 HTML 鴻帥ゃ激若
161.1816 +.fl
161.1817 + \f3java\fP 宴若吾c
161.1818 +.fl
161.1819 + \f3applet\fP 泣宴若吾c
161.1820 +.fl
161.1821 + Applet.html Applet 鴻若
161.1822 +.fl
161.1823 + AppletContext.html AppletContext ゃ潟帥с若鴻若
161.1824 +.fl
161.1825 + AppletStub.html AppletStub ゃ潟帥с若鴻若
161.1826 +.fl
161.1827 + AudioClip.html AudioClip ゃ潟帥с若鴻若
161.1828 +.fl
161.1829 + * package\-summary.html 宴若吾鴻鴻 荀膣
161.1830 +.fl
161.1831 + * package\-frame.html 宴若吾鴻鴻 綏筝若茵腓冴
161.1832 +.fl
161.1833 + * package\-tree.html 宴若吾拷絮ゃ鴻
161.1834 +.fl
161.1835 + package\-use 宴若吾篏睡贋鴻
161.1836 +.fl
161.1837 + \f3doc\-files\fP ゃ<若吾泣潟<ゃ主c
161.1838 +.fl
161.1839 + \f3class\-use\fP API 篏睡贋若吾主c
161.1840 +.fl
161.1841 + Applet.html Applet 鴻篏睡若
161.1842 +.fl
161.1843 + AppletContext.html AppletContext ゃ潟帥с若鴻篏睡若
161.1844 +.fl
161.1845 + AppletStub.html AppletStub ゃ潟帥с若鴻篏睡若
161.1846 +.fl
161.1847 + AudioClip.html AudioClip ゃ潟帥с若鴻篏睡若
161.1848 +.fl
161.1849 + \f3src\-html\fP 純若鴻潟若c
161.1850 +.fl
161.1851 + \f3java\fP 宴若吾c
161.1852 +.fl
161.1853 + \f3applet\fP 泣宴若吾c
161.1854 +.fl
161.1855 + Applet.html Applet 純若鴻潟若若
161.1856 +.fl
161.1857 + AppletContext.html AppletContext 純若鴻潟若若
161.1858 +.fl
161.1859 + AppletStub.html AppletStub 純若鴻潟若若
161.1860 +.fl
161.1861 + AudioClip.html AudioClip 純若鴻潟若若
161.1862 .fl
161.1863 .fi
161.1864
161.1865 .LP
161.1866 -.SS "生成される API 宣言"
161.1867 -javadoc ツールは、各クラス、インタフェース、フィールド、コンストラクタ、
161.1868 -およびメソッドの説明の初めで宣言を生成します。
161.1869 -この宣言は、その API 項目の宣言です。たとえば、
161.1870 -ブール型クラスの宣言は次のようになります。
161.1871 +.SS
161.1872 + API 絎h
161.1873 +.LP
161.1874 +.LP
161.1875 +Javadoc 若鴻ゃ潟帥с若鴻c若潟潟鴻帥潟<純茯 API 絎h障 絎h API 絎hс違\f2Boolean\fP 鴻絎h罨<障
161.1876 .LP
161.1877 .LP
161.1878 \f2public final class Boolean\fP
161.1879 @@ -1025,145 +939,36 @@
161.1880 \f2implements Serializable\fP
161.1881 .LP
161.1882 .LP
161.1883 -Boolean.valueOf メソッドの宣言は次のようになります。
161.1884 +障\f2Boolean.valueOf\fP <純絎h罨<障
161.1885 .LP
161.1886 .LP
161.1887 \f2public static Boolean valueOf(String s)\fP
161.1888 .LP
161.1889 .LP
161.1890 -javadoc ツールは修飾子
161.1891 -.BR public
161.1892 -、
161.1893 -.BR protected
161.1894 -、
161.1895 -.BR private
161.1896 -、
161.1897 -.BR abstract
161.1898 -、
161.1899 -.BR final
161.1900 -、
161.1901 -.BR static
161.1902 -、
161.1903 -.BR transient
161.1904 -、
161.1905 -および
161.1906 -.BR volatile
161.1907 -を組み込むことができますが、
161.1908 -.BR synchronized
161.1909 -と
161.1910 -.BR native
161.1911 -は組み込むことができません。
161.1912 -.BR synchronized
161.1913 -と
161.1914 -.BR native
161.1915 -修飾子は実装の詳細と見なされ、API 仕様の一部とは見なされません。
161.1916 -.LP
161.1917 -キーワード
161.1918 -.BR synchronized
161.1919 -に依存するよりも、「複数のスレッドによって単一の
161.1920 -.BR Enumeration
161.1921 -を並行して使用してはならない」というように、並行処理のセマンティックスを
161.1922 -コメント説明の中でドキュメント化するべきです。ドキュメントでは、
161.1923 -これらのセマンティックスの達成方法を説明すべきではありません。別の
161.1924 -例を挙げると、
161.1925 -.BR Hashtable
161.1926 -はスレッドに対して安全でなければなりませんが、エクスポートされるその
161.1927 -メソッドすべてを同期させることによってこれを実現すると明記する必要
161.1928 -はないということです。バケットレベルで内部的に同期をとる権限を留保して、
161.1929 -より高度な並行性を提供すべきです。
161.1930 -.LP
161.1931 -.SH "ドキュメンテーションコメント"
161.1932 -.LP
161.1933 -.LP
161.1934 -オリジナルの「ドキュメンテーションコメントの仕様」は、「関連項目」を参照してください。
161.1935 -.LP
161.1936 -.SS
161.1937 -ソースコードへのコメントの挿入
161.1938 -.LP
161.1939 -.LP
161.1940 -ソースコードの任意の宣言 (クラス、インタフェース、メソッド、コンストラクタ、
161.1941 -またはフィールド) の前に、ドキュメンテーションコメント (doc コメント)
161.1942 -を記述することができます。 各パッケージにドキュメンテーションコメントを
161.1943 -作成でき、構文は若干異なりますが、概要にもドキュメンテーションコメントを
161.1944 -作成できます。 ドキュメンテーションコメントは、Javadoc コメントとも呼ばれます。
161.1945 -ドキュメンテーションコメントは、コメントの始まりを示す文字列
161.1946 -.B /**
161.1947 - と、コメントの終わりを示す文字列
161.1948 -.B */
161.1949 -の間にある文字で構成されます。 行頭のアスタリスクは、各行に記述できます。詳細は、以下で説明します。 Linux ではテキストは、複数行にわたって記述できます。
161.1950 -.LP
161.1951 -.RS
161.1952 -.ft 3
161.1953 -.nf
161.1954 -/**
161.1955 -* This is the typical format of a simple documentation comment
161.1956 -* that spans two lines.
161.1957 -*/
161.1958 -.fi
161.1959 -.ft 1
161.1960 -.RE
161.1961 -.LP
161.1962 -次のように、コメントは 1 行にまとめることもできます。
161.1963 -.LP
161.1964 -.RS
161.1965 -.ft 3
161.1966 -.nf
161.1967 -/** This comment takes up only one line. */
161.1968 -.fi
161.1969 -.ft 1
161.1970 -.RE
161.1971 -.LP
161.1972 -コメントの配置 - ドキュメンテーションコメントが認識されるのは、クラス、
161.1973 -インタフェース、コンストラクタ、メソッド、またはフィールド
161.1974 -宣言の前に置かれた場合だけです (クラス、メソッド、およびフィールドの
161.1975 -例を参照)。メソッドの本体に置かれたドキュメント
161.1976 -コメントは無視されます。
161.1977 -.B javadoc
161.1978 -ツールは、宣言文ごとに 1 つのドキュメンテーションコメントだけを
161.1979 -認識します。
161.1980 -.LP
161.1981 -よく発生する間違いは、重要な文をクラスコメントとクラス宣言の間に
161.1982 -入れてしまうことです。
161.1983 -.B javadoc
161.1984 -はクラスコメントを無視するため、注意してください。
161.1985 -.LP
161.1986 -.RS
161.1987 -.ft 3
161.1988 -.nf
161.1989 -/**
161.1990 -* This is the class comment for the class Whatever.
161.1991 -*/
161.1992 -
161.1993 -import com.sun; // MISTAKE - Important not to put statements here
161.1994 -
161.1995 -public class Whatever {
161.1996 -}
161.1997 -.fi
161.1998 -.ft 1
161.1999 -.RE
161.2000 -.LP
161.2001 -コメントの説明のあとにタグが続く - コメントの開始区切り文字である
161.2002 -.B /**
161.2003 -のあとからタグセクションまでが説明になります。 タグセクションは、
161.2004 -先頭文字が
161.2005 -.B @
161.2006 -である行から始まります (行の先頭のアスタリスクおよび空白文字
161.2007 -は除く)。 説明を記述せず、コメントだけのタグを記述することもできます。
161.2008 -説明は、タグセクション以降に続けることはできません。
161.2009 -タグの引数は複数の行にまたがって記述できます。 タグの数に
161.2010 -制限はありません。何回も記述できるタグと、1 回しか記述できない
161.2011 -タグがあります。 次の例の
161.2012 -.B @see
161.2013 -からタグセクションが始まります。
161.2014 +Javadoc 若篆蕋上 \f2public\fP\f2protected\fP\f2private\fP\f2abstract\fP\f2final\fP\f2static\fP\f2transient\fP \f2volatile\fP 腟粋昭с障\f2synchronized\fP \f2native\fP 腟粋昭с障緇 2 ゃ篆蕋上絎茖荅括完荀API 篁罕障障
161.2015 +.LP
161.2016 +.LP
161.2017 +API с筝茵с祉潟c鴻ゃ若若 \f2synchronized\fP 箴絖с潟<潟筝肢ャ<潟綽荀障 違1 ゃ \f2Enumeration\fP 茲違鴻筝茵篏睡с潟<潟荐菴違障ャ<潟祉潟c鴻絎憗号荐菴違鴻с障違\f2Hashtable\fP 鴻絲障絎с綽荀障鴻若鴻<純違絎憗с絎号障宴у罔罧鏆荀障 違蕭綺筝茵с箴障
161.2018 +.LP
161.2019 +.SH "ャ<潟若激с潟潟<潟"
161.2020 +.LP
161.2021 +.LP
161.2022 +吾ャ<潟若激с潟潟<潟篁罕∫iс
161.2023 +.LP
161.2024 +.SS
161.2025 +純若鴻潟若吾潟<潟水
161.2026 +.LP
161.2027 +.LP
161.2028 +純若鴻潟若篁紙鴻ゃ潟帥с若鴻<純潟潟鴻帥障c若絎hャ<潟若激с潟潟<潟 ("doc comments") 荐菴違с障宴若吾ャ<潟若激с潟潟<潟篏с障 罕ュ慌違障网荀ャ<潟若激с潟潟<潟篏с障ャ<潟若激с潟潟<潟綣Javadoc 潟<潟若違障 (茯罔∫c篏睡羈)ャ<潟若激с潟潟<潟潟<潟紮障腓冴絖 \f2/**\fP 潟<潟腟腓冴絖 \f2*/\fP 絖ф障茵≪鴻帥鴻茵荐菴違с障 荅括完篁ヤц障潟<潟鴻茲域c荐菴違с障
161.2029 .LP
161.2030 .nf
161.2031 \f3
161.2032 .fl
161.2033 /**
161.2034 .fl
161.2035 - * This sentence would hold the main description for this doc comment.
161.2036 -.fl
161.2037 - * @see java.lang.Object
161.2038 + * This is the typical format of a simple documentation comment
161.2039 +.fl
161.2040 + * that spans two lines.
161.2041 .fl
161.2042 */
161.2043 .fl
161.2044 @@ -1172,4025 +977,4859 @@
161.2045
161.2046 .LP
161.2047 .LP
161.2048 -標準タグとインラインタグ: タグは、javadoc ツールが処理できる、
161.2049 -doc コメント内の特別なキーワードです。javadoc ツールには、@tag として現れる
161.2050 -標準タグと、中括弧内に
161.2051 -.B {\f3@tag\f1}
161.2052 -として現れるインラインタグがあります。解釈
161.2053 -させるためには、先頭のアスタリスク、空白、コメント区切り文字 (/**) を
161.2054 -除いては標準タグが行の先頭であるように配置する必要があります。つ
161.2055 -まり、ユーザはテキスト内の任意の位置で @ 文字を使用でき、
161.2056 -この文字はタグの始めとは解釈されません。@ 文字で行を開
161.2057 -始してこれが解釈されないようにしたい場合は、HTML エンティティの
161.2058 -@ を使用してください。各スタンドアロンタグには関連するテキストがあり
161.2059 -ます。これは、そのタグの後から次のタグの直前まで、または doc コメント
161.2060 -の最後までの任意のテキストです。関連付けられたテキストは、
161.2061 -複数行にまたがって記述できます。
161.2062 -インラインタグは、そのテキストが許
161.2063 -可される位置にはどこでも指定でき、解釈の対象となります。次の例は、
161.2064 -標準タグ
161.2065 -.BR @deprecated
161.2066 -とインラインタグ
161.2067 -.BR {@link}
161.2068 -が含まれています。
161.2069 -.LP
161.2070 -.RS
161.2071 -.ft 3
161.2072 +罨< 1 茵荐菴違鴻若鴻膀膣с障
161.2073 +.LP
161.2074 .nf
161.2075 +\f3
161.2076 +.fl
161.2077 +/** This comment takes up only one line. */
161.2078 +.fl
161.2079 +\fP
161.2080 +.fi
161.2081 +
161.2082 +.LP
161.2083 +.LP
161.2084 +\f3潟<潟臀\fP \- ャ<潟若激с潟潟<潟鴻ゃ潟帥с若鴻潟潟鴻帥<純障c若絎h翫臀茯茘障 鴻箴<純箴潟c若箴с<純篏臀ャ<潟若激с潟潟<潟∴障javadoc 若с1 ゃ絎hゃ 1 ゃャ<潟若激с潟潟<潟茯茘障
161.2085 +.LP
161.2086 +.LP
161.2087 +鴻潟<潟鴻絎h \f2import\fP 臀障с荐菴違с 鴻潟<潟∴障
161.2088 +.LP
161.2089 +.nf
161.2090 +\f3
161.2091 +.fl
161.2092 + /**
161.2093 +.fl
161.2094 + * This is the class comment for the class Whatever.
161.2095 +.fl
161.2096 + */
161.2097 +.fl
161.2098 +
161.2099 +.fl
161.2100 + import com.sun; // MISTAKE \- Important not to put import statement here
161.2101 +.fl
161.2102 +
161.2103 +.fl
161.2104 + public class Whatever {
161.2105 +.fl
161.2106 + }
161.2107 +.fl
161.2108 +\fP
161.2109 +.fi
161.2110 +
161.2111 +.LP
161.2112 +.LP
161.2113 +\f3ャ<潟若激с潟潟<潟筝肢帥違祉激с潟膓\fP \- 潟<潟紮阪絖с \f2/**\fP 帥違祉激с潟障с筝肢障帥違祉激с潟絖 \f2@\fP с茵у臂帥違紮障障 (茵≪鴻帥鴻腥榊純活阪絖 \f2/**\fP ゃ)筝肢荐菴違帥違祉激с潟潟<潟荐菴違с障筝肢帥違祉激с割札膓с障帥違綣違茲域c荐菴違с障帥違違狗障 篏荐菴違с帥違1 荐菴違с帥違障箴違罨< \f2@see\fP 帥違祉激с潟紮障障
161.2114 +.LP
161.2115 +.nf
161.2116 +\f3
161.2117 +.fl
161.2118 /**
161.2119 - * @deprecated As of JDk 1.1, replaced by {@link #setBounds(int,int,int,int)}
161.2120 +.fl
161.2121 + * This sentence would hold the main description for this doc comment.
161.2122 +.fl
161.2123 + * @see java.lang.Object
161.2124 +.fl
161.2125 */
161.2126 +.fl
161.2127 +\fP
161.2128 .fi
161.2129 -.ft 1
161.2130 +
161.2131 +.LP
161.2132 +.LP
161.2133 +\f3帥違ゃ潟ゃ潟帥\fP \- 帥違Javadoc сャ<潟若激с潟潟<潟劫ャ若若с\f2@tag\fP 荐菴違帥 (鴻帥潟≪潟帥違若違) ゃ潟ゃ潟帥 (\f2{@tag}\fP 筝綣су蚊ц菴) 2 腮蕁帥違障帥違罩c頵i茵≪鴻帥鴻腥榊純阪絖 (\f2/**\fP) ゃ茵臀違障鴻篁ュ篏臀 \f2@\fP 絖篏睡帥違紮茹i潟障茵 \f2@\fP 絖篏睡帥違茹iHTML 潟cc若\f2@\fP篏睡帥違絲上篁鴻障 鴻帥違罨<帥違障ャ<潟若激с潟潟<潟緇障с荐菴違鴻 (帥違潟<潟阪絖ゃ) с∫c鴻茲域c荐菴違с障ゃ潟ゃ潟帥違鴻荐菴違с贋с違с臀с罩c頵i障罨<潟若箴帥 \f2@deprecated\fP ゃ潟ゃ潟帥 \f2{@link}\fP 障障
161.2134 +.LP
161.2135 +.nf
161.2136 +\f3
161.2137 +.fl
161.2138 +/**
161.2139 +.fl
161.2140 + * @deprecated As of JDK 1.1, replaced by {@link #setBounds(int,int,int,int)}
161.2141 +.fl
161.2142 + */
161.2143 +.fl
161.2144 +\fP
161.2145 +.fi
161.2146 +
161.2147 +.LP
161.2148 +.LP
161.2149 +\f3潟<潟 HTML ц菴違\fP \- 鴻 HTML 綵√ц菴違違障 HTML 潟cc若篏帥綽荀 HTML 帥違篏睡с潟障荐菴違 HTML 若吾с潟篏睡吟泣若篁紙若吾с潟篏睡с障 罔羣鴻宴若c潟違鴻帥ゃ激若 (CSS) 若鴻 (ャ<潟若激с潟潟<潟篁ュ) HTML 3.2 羣潟若篏障若祉絲上<ゃHTML 4.0荐菴違障
161.2150 +.LP
161.2151 +.LP
161.2152 +違絨 (\f2<\fP) 潟紊с (\f2>\fP) 荐垩\f2<\fP \f2>\fP 荐菴違綽荀障罕≪潟泣潟 (\f2&\fP) \f2&\fP 荐菴違綽荀障罨<箴с若 HTML 帥 \f2<b>\fP 篏帥c障
161.2153 +.LP
161.2154 +.LP
161.2155 +罨<ャ<潟若激с潟潟<潟腓冴障
161.2156 +.LP
161.2157 +.nf
161.2158 +\f3
161.2159 +.fl
161.2160 +/**
161.2161 +.fl
161.2162 + * This is a <b>doc</b> comment.
161.2163 +.fl
161.2164 + * @see java.lang.Object
161.2165 +.fl
161.2166 + */
161.2167 +.fl
161.2168 +\fP
161.2169 +.fi
161.2170 +
161.2171 +.LP
161.2172 +.LP
161.2173 +\f3茵≪鴻帥鴻\fP \- Javadoc ャ<潟若激с潟潟<潟茹f茵≪鴻帥鴻 (\f2*\fP) 鴻贋障 障≪鴻帥鴻 (\f2*\fP) 腥榊純帥贋障若吾с 1.4 茵≪鴻帥鴻ャ腥榊醇絖ゃ障潟若箴贋・ャ<潟若激с潟潟<潟 \f2<PRE>\fP 帥医若鴻ゃ潟潟篆障絽吾吟腥榊醇絖帥筝緇茹i障ゃ潟潟阪絖 \f2/**\fP 障 \f2<PRE>\fP 帥違綏絲障
161.2174 +.LP
161.2175 +.LP
161.2176 +\f3\fP \- ャ<潟若激с潟潟<潟絎h潟cc若≪膂≧ゅ荀膣с綽荀障翫鴻若鴻帥障壕膓 (宴若沿荐絎翫)障帥違篏臀х障Javadoc 若c HTML 若吾<潟若网荀潟若障
161.2177 +.LP
161.2178 +.LP
161.2179 +\f3茲違c若絎h\fP \- Java с1 ゃц違c若絎hс障 1 ゃャ<潟若激с潟潟<潟荐菴違с障 潟<潟鴻c若絲障潟若障cc若ャ<潟若激с潟潟<潟荐菴違綽荀翫c若ャуh違障違罨<ャ<潟若激с潟潟<潟1 ゃ絎h荐菴違筝с 翫絎h 2 ゃс障
161.2180 +.LP
161.2181 +.RS 3
161.2182 +
161.2183 +.LP
161.2184 +.nf
161.2185 +\f3
161.2186 +.fl
161.2187 +/**
161.2188 +.fl
161.2189 + * The horizontal and vertical distances of point (x,y)
161.2190 +.fl
161.2191 + */
161.2192 +.fl
161.2193 +public int x, y; // Avoid this
161.2194 +.fl
161.2195 +\fP
161.2196 +.fi
161.2197 .RE
161.2198 -.LP
161.2199 -コメントは HTML で記述します。テキストは HTML で
161.2200 -記述しなければなりません。
161.2201 -これは、HTML のエンティティを使う必要があること、
161.2202 -および HTML タグを使用できること
161.2203 -を意味します。HTML は、使用するブラウザがサポートする
161.2204 -任意のバージョンを使うことが
161.2205 -できます。標準ドックレットは、階層式スタイルシートと
161.2206 -フレームを含むほかの部分 (ドキュメンテーションコメント
161.2207 -以外) は、HTML 3.2 に準拠したコードを生成するように記述
161.2208 -されています
161.2209 -(フレームセット対応のため、生成される各
161.2210 -ファイルは、「HTML 4.0」で始まる)。
161.2211 -.LP
161.2212 -たとえば、より小さい (<) およびより大きい (>) という
161.2213 -記号は、
161.2214 -.B <
161.2215 -と
161.2216 -.BR >
161.2217 -と記述する必要があります。同様に、アンパサンド (&) は、
161.2218 -.BR &
161.2219 -と記述する必要があります。次の例で
161.2220 -は、ボールドの HTML タグ <b> を示します。
161.2221 -.LP
161.2222 -次に doc コメントを示します。
161.2223 -.LP
161.2224 -.RS
161.2225 -.ft 3
161.2226 +
161.2227 +.LP
161.2228 +.LP
161.2229 +筝荐潟若罨<ャ<潟障
161.2230 +.LP
161.2231 +.RS 3
161.2232 +
161.2233 +.LP
161.2234 .nf
161.2235 -/**
161.2236 -* This is a <b>doc</b> comment.
161.2237 -* @see java.lang.Object
161.2238 -*/
161.2239 +\f3
161.2240 +.fl
161.2241 +public int \fP\f3x\fP
161.2242 +.fl
161.2243 .fi
161.2244 -.ft 1
161.2245 +
161.2246 +.LP
161.2247 +.RS 3
161.2248 +The horizontal and vertical distances of point (x,y)
161.2249 .RE
161.2250 -.LP
161.2251 -行頭のアスタリスク -
161.2252 -.B javadoc
161.2253 -は、doc コメントを解析するときに、各行の先頭にある
161.2254 -文字アスタリスク (*) をすべて破棄し
161.2255 -ます。また、最初のアスタリスク (*) より前の空白と
161.2256 -タブも破棄します。1.4 からは、行頭のアスタリスクを省略した場合、行頭の空白は削除されません。これにより、<PRE> タグの中の doc コメントに、サンプルコードをインデントを残したままで直接ペーストすることができます。空白は一般的に、タブよりも均一にブラウザで解釈されます。インデントは、区切り文字 /** や <PRE> タグではなく、左マージンに相対的です。
161.2257 -.LP
161.2258 -最初の文 - 各 doc コメントの最初の文は、宣言されている
161.2259 -エンティティに関する簡潔かつ完全
161.2260 -な説明を含む要約文でなければなりません。
161.2261 -この文は、空白、タブ、または行末記
161.2262 -号が続いている最初のピリオド、あるいは最初のスタンドアロンタグで終了します。
161.2263 -.B javadoc
161.2264 -ツールは、HTML ページの最初にあるメンバ要約に、この最初の文をコピーします。
161.2265 -.LP
161.2266 -複数フィールドの宣言 -
161.2267 -.B java
161.2268 -では、単一の文で複数のフィールドを宣言できます。
161.2269 -しかし、この文のドキュメンテ
161.2270 -ーションコメントは 1 つだけで、このコメントが
161.2271 -すべてのフィールドにコピーされます。
161.2272 -したがって、フィールドごとに個々の
161.2273 -ドキュメンテーションコメントを付けたい場合は、
161.2274 -各フィールドを異なる文で宣言しなければなりません。
161.2275 -たとえば、次のドキュメンテー
161.2276 -ションコメントは単一の宣言としては意味を成さず、
161.2277 -2 つの宣言として処理するべき
161.2278 -です。
161.2279 -.LP
161.2280 -.RS
161.2281 -.ft 3
161.2282 +
161.2283 +.LP
161.2284 .nf
161.2285 -/**
161.2286 -* The horizontal and vertical distances of point (x,y)
161.2287 -*/
161.2288 -public int x, y; // Avoid this
161.2289 +\f3
161.2290 +.fl
161.2291 +public int \fP\f3y\fP
161.2292 +.fl
161.2293 .fi
161.2294 -.ft 1
161.2295 +
161.2296 +.LP
161.2297 +.RS 3
161.2298 +The horizontal and vertical distances of point (x,y)
161.2299 .RE
161.2300 -.LP
161.2301 -.B javadoc
161.2302 -ツールは、上記コードから次のドキュメントを生成します。
161.2303 -.LP
161.2304 -.RS
161.2305 -.ft 3
161.2306 -public int x
161.2307 -.fi
161.2308 -.ft 1
161.2309 -The horizontal and vertical distances of point
161.2310 -(x,y).
161.2311 -.ft 3
161.2312 -.nf
161.2313 -public int y
161.2314 -.fi
161.2315 -.ft 1
161.2316 -The horizontal and vertical distances of point
161.2317 -(x,y).
161.2318 +
161.2319 +.LP
161.2320 .RE
161.2321 .LP
161.2322 -ヘッダタグを使用するときは注意してください。
161.2323 -メンバ用のドキュメントコ
161.2324 -メントを書くときは、
161.2325 -.B <H1>
161.2326 -や
161.2327 -.BR <H2>
161.2328 -などの HTML ヘッダタグを使用しないでください。これは、
161.2329 -.B javadoc
161.2330 -が全ドキュメントを構造化して生成するため、
161.2331 -これらの構造化タグを使用すると、
161.2332 -ドキュメントの書式が乱れる可能性があるためです。
161.2333 -しかし、クラスやパッケージの
161.2334 -コメントでは、これらのヘッダタグを使用して構造化を指示してください。
161.2335 -.LP
161.2336 -メソッドコメントの自動コピー
161.2337 -.LP
161.2338 -.LP
161.2339 -Javadoc ツールには、次の 2 つの場合に、クラスおよびインタフェースのメソッドコメントをコピーまたは「継承」する機能があります。コンストラクタ、フィールド、および入れ子のクラスは、ドキュメンテーションコメントを継承しません。
161.2340 +\f3荀冴帥違鴻鋎睡\fP \- <潟若絲障ャ<潟若激с潟潟<潟荐菴違<H1> <H2> HTML 荀冴帥違鴻鋎帥с Javadoc 若絎罕ャ<潟篏с罕帥違篏帥ャ<潟綵√綵演帥障鴻宴若吾潟<潟с荀冴帥違篏帥c罕腟睡障障
161.2341 +.LP
161.2342 +.SS
161.2343 +<純潟<潟潟
161.2344 +.LP
161.2345 +.LP
161.2346 +Javadoc 若罨< 2 ゃ翫鴻潟ゃ潟帥с若鴻<純潟<潟潟若障膓帥罘純障潟潟鴻帥c若喝ャ絖鴻ャ<潟若激с潟潟<潟膓帥障
161.2347 .LP
161.2348 .RS 3
161.2349 .TP 2
161.2350 o
161.2351 -\f3自動的にコメントを継承して、見つからないテキストを埋める\fP \- 主説明または、\f2@return\fP、\f2@param\fP、\f2@throws\fP タグが、メソッドコメントで見つからない場合、Javadoc ツールは、オーバーライドしたメソッドまたは実装している場合はそのメソッドから、対応する主説明およびタグコメントを、次のアルゴリズムに従ってコピーします。
161.2352 -.LP
161.2353 -厳密には、特定のパラメータの \f2@param\fP タグが見つからない場合、そのパラメータのコメントが、上位の継承階層のメソッドからコピーされます。特定の例外の \f2@throws\fP タグが見つからない場合、\f2その例外が宣言されている場合にかぎり\fP、その \f2@throws\fP タグがコピーされます。
161.2354 -.LP
161.2355 -この動作はバージョン 1.3 以前の動作とは対照的です。これまでのバージョンでは、主説明またはタグが存在すれば、コメントは一切継承されませんでした。
161.2356 +\f3潟<潟膓帥荀ゃ鴻\fP \- 筝肢障 \f2@return\fP 帥違\f2@param\fP 帥違\f2@throws\fP 帥違<純潟<潟цゃ翫Javadoc 若若若ゃ<純障絎茖翫<純絲上筝肢障帥違潟<潟罨<≪眼冴緇c潟若障
161.2357 +.LP
161.2358 +ウ絲劫<若帥 \f2@param\fP 帥違荀ゃ翫<若帥潟<潟筝篏膓翠絮ゃ<純潟若障劫箴紊 \f2@throws\fP 帥違荀ゃ翫箴紊絎h翫 \f2@throws\fP 帥違潟若障
161.2359 +.LP
161.2360 +篏若吾с 1.3 篁ュ篏絲丞хс 障с若吾с潟с筝肢障帥違絖違潟<潟筝膓帥障с
161.2361 .TP 2
161.2362 o
161.2363 -\f3{@inheritDoc} タグを持つコメントを明示的に継承する\fP \- インラインタグ \f2{@inheritDoc}\fP を、メソッドの主説明、または \f2@return\fP、\f2@param\fP、\f2@throws\fP タグコメントに挿入します。継承した対応する主説明またはタグコメントは、その箇所にコピーされます。
161.2364 +\f3{@inheritDoc} 帥違ゃ潟<潟腓榊膓帥\fP \- ゃ潟ゃ潟帥 \f2{@inheritDoc}\fP <純筝肢障 \f2@return\fP\f2@param\fP\f2@throws\fP 帥違潟<潟水ャ障 膓帥絲上筝肢障帥違潟<潟膊潟若障
161.2365 .RE
161.2366
161.2367 .LP
161.2368 .LP
161.2369 -ドキュメンテーションコメントを実際にコピーに利用するには、継承したメソッドのソースファイルが \-sourcepath で指定したパスだけに置かれていることが必要になります。コマンド行で、クラスもパッケージも渡す必要はありません。この点は、クラスが ドキュメント化されるクラスでなければならなかった 1.3.x 以前のリリースと異なります。
161.2370 -.LP
161.2371 -.LP
161.2372 -\f3クラスおよびインタフェースからの継承\fP \- クラスおよびインタフェースから継承する次の 3 つの場合に、コメントの継承が行われます。
161.2373 +ャ<潟若激с潟潟<潟絎潟若膓帥<純純若鴻<ゃ \-sourcepath ф絎鴻臀綽荀障潟潟茵с鴻宴若吾羝<綽荀障鴻鴻ャ<潟鴻с違c 1.3.x 篁ュ若鴻違障
161.2374 +.LP
161.2375 +.LP
161.2376 +\f3鴻潟ゃ潟帥с若鴻膓\fP \- 鴻潟ゃ潟帥с若鴻膓帥罨< 3 ゃ翫潟<潟膓帥茵障
161.2377 .LP
161.2378 .RS 3
161.2379 .TP 2
161.2380 o
161.2381 -クラスのメソッドがスーパークラスのメソッドをオーバーライドしている
161.2382 +鴻<純鴻若若鴻<純若若ゃ
161.2383 .TP 2
161.2384 o
161.2385 -インタフェースのメソッドがスーパーインタフェースのメソッドをオーバーライドしている
161.2386 +ゃ潟帥с若鴻<純鴻若若ゃ潟帥с若鴻<純若若ゃ
161.2387 .TP 2
161.2388 o
161.2389 -クラスのメソッドがインタフェースのメソッドを実装している
161.2390 +鴻<純ゃ潟帥с若鴻<純絎茖
161.2391 .RE
161.2392
161.2393 .LP
161.2394 .LP
161.2395 -最初の 2 つのケース (メソッドがオーバーライドしている場合) では、
161.2396 -.B javadoc
161.2397 -ツールは、オーバーライドしているメソッドのドキュメント内に
161.2398 -「オーバーライド」という小見出しを生成し、コメントが継承されているかどうかにかかわらず、オーバーライドされている
161.2399 -メソッドへのリンクを書き込みます。
161.2400 -.LP
161.2401 -3 つ目のケース (特定のクラスのメソッドがインタフェースの
161.2402 -メソッドを実装している場合) では、
161.2403 -.B javadoc
161.2404 -ツールは、実装している
161.2405 -メソッドのドキュメント内に「定義」という小見出しを生成し、コメントが継承されているかどうかにかかわらず、
161.2406 -実装されているメソッドへのリンクを書き込みます。
161.2407 -.LP
161.2408 -メソッドの説明が継承されるアルゴリズム - あるメソッドに
161.2409 -ドキュメンテーションコメントが記述されていない場合、または {@inheritDoc} タグがある場合、
161.2410 -.B javadoc
161.2411 -ツールは、次のようなアルゴリズムを使用して適切なコメントを検索します。
161.2412 -このアルゴリズムは、もっとも適切なドキュメンテーションコメントを
161.2413 -検索できるように設計されており、スーパークラスよりも
161.2414 -インタフェースが優先されるようになっています。
161.2415 -.TP 4
161.2416 -1.
161.2417 -直接に実装されている (または、拡張されている) インタフェースを、
161.2418 -メソッドの宣言で implements (または extends) キーワードのあとに
161.2419 -登場する順序で、1 つずつ調べる。 このメソッドについて
161.2420 -最初に見つかったドキュメンテーションコメントを採用する
161.2421 -.TP 4
161.2422 -2.
161.2423 -手順 1 でドキュメンテーションコメントが見つからなかった場合は、
161.2424 -直接実装されている (または、拡張されている) インタフェースの
161.2425 -それぞれに対して、このアルゴリズム全体を再帰的に適用する (その際の順序は、手順 1 でインタフェースを調べたときの順序と同じ)
161.2426 -.TP 4
161.2427 -3.
161.2428 -手順 2 でドキュメンテーションコメントが見つからなかった場合で、
161.2429 -このクラスが Object 以外のクラスである (インタフェースではない) 場合は、
161.2430 -次のように処理する
161.2431 -.sp 1n
161.2432 + 2 ゃ宴若 (<純若若ゃ翫) сJavadoc 若潟<潟膓帥若若ゃ<純ャ<潟若若ゃ絨頳冴若若ゃ<純吾潟吾莨若帥障
161.2433 +.LP
161.2434 +.LP
161.2435 +3 ょ宴若 (劫鴻<純ゃ潟帥с若鴻<純絎茖翫) сjavadoc 若若若ゃ<純ャ<潟絎臂絨頳冴絎茖<純吾潟吾莨若帥障潟<潟膓帥障
161.2436 +.LP
161.2437 +.LP
161.2438 +\f3<純茯膓帥≪眼冴\fP \- <純ャ<潟若激с潟潟<潟荐菴違翫障 {@inheritDoc} 帥違翫Javadoc 若罨<≪眼冴篏睡潟<潟罎膣≪障 ≪眼冴cャ<潟若激с潟潟<潟罎膣≪с荐荐鴻若若鴻ゃ潟帥с若鴻c障
161.2439 +.LP
161.2440 +.RS 3
161.2441 +.TP 3
161.2442 +1.
161.2443 +贋・絎茖 (障≦宍) ゃ潟帥с若鴻<純絎h implements (障 extends) 若若糸眼綺с1 ゃよ帥鴻<純ゃ荀ゃcャ<潟若激с潟潟<潟。
161.2444 +.TP 3
161.2445 +2.
161.2446 + 1 сャ<潟若激с潟潟<潟荀ゃc翫贋・絎茖 (障≦宍) ゃ潟帥с若鴻絲障≪眼冴篏絽亥 (綺 1 сゃ潟帥с若鴻茯帥鴻綺)
161.2447 +.TP 3
161.2448 +3.
161.2449 + 2 сャ<潟若激с潟潟<潟荀ゃc翫с鴻 Object 篁ュ鴻с (ゃ潟帥с若鴻с) 翫罨<
161.2450 +.RS 3
161.2451 +.TP 3
161.2452 +a.
161.2453 +鴻若若鴻<純ゃャ<潟若激с潟潟<潟荐菴違違潟<潟。
161.2454 +.TP 3
161.2455 +b.
161.2456 + 3a сャ<潟若激с潟潟<潟荀ゃc翫鴻若若鴻絲障≪眼冴篏
161.2457 +.RE
161.2458 +.RE
161.2459 +
161.2460 +.LP
161.2461 +.SH "javadoc 帥"
161.2462 +.LP
161.2463 +.LP
161.2464 +Javadoc 若Java ャ<潟若激с潟潟<潟莨若障劫ャ帥違茹f障ャ<潟若激с潟帥違篏帥後眼c絎 API ャ<潟純若鴻潟若с障帥違箴∴ (\f2@\fP) у障紊ф絖絨絖阪ャ障 帥違絎紊ф絖絨絖篏睡荐菴違綽荀障帥違茵 (茵腥榊純ュ純≪鴻帥鴻ゃ) 臀違障d帥違 1 障荐菴違障違\f2@see\fP 帥違茲違翫鴻 1 障荐菴違障
161.2465 +.LP
161.2466 +.LP
161.2467 +帥違 2 ゃ帥ゃ障
161.2468 +.LP
161.2469 +.RS 3
161.2470 +.TP 2
161.2471 +o
161.2472 +\f3帥\fP \- 筝肢膓帥違祉激с喝粋菴医純帥違\f2@tag\fP 綵√障
161.2473 +.TP 2
161.2474 +o
161.2475 +\f3ゃ潟ゃ潟帥\fP \- 潟<潟筝肢障帥違潟<潟荐菴医純ゃ潟ゃ潟帥違\f2{@tag}\fP 筝綣су蚊帥障
161.2476 +.RE
161.2477 +
161.2478 +.LP
161.2479 +.LP
161.2480 +篁緇若鴻уャ帥違ゃ
161.2481 +.na
161.2482 +\f2Proposed Javadoc Tags\fP @
161.2483 +.fi
161.2484 +http://java.sun.com/j2se/javadoc/proposed\-tags.htmlс
161.2485 +.LP
161.2486 +.LP
161.2487 +憝鴻ф鴻帥違罨<с
161.2488 +.LP
161.2489 +.RS 3
161.2490 +
161.2491 +.LP
161.2492 +.LP
161.2493 +.TS
161.2494 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.2495 +.de 35
161.2496 +.ps \n(.s
161.2497 +.vs \n(.vu
161.2498 +.in \n(.iu
161.2499 +.if \n(.u .fi
161.2500 +.if \n(.j .ad
161.2501 +.if \n(.j=0 .na
161.2502 +..
161.2503 .nf
161.2504 -.ft 3
161.2505 -a. スーパークラスにこのメソッドについてのドキュメンテーションコメントが記述されていれば、そのコメントを採用する
161.2506 -b. 手順 3a でドキュメンテーションコメントが見つからなかった場合は、スーパークラスに対して、このアルゴリズム全体を適用する
161.2507 -.ft 1
161.2508 +.nr #~ 0
161.2509 +.if n .nr #~ 0.6n
161.2510 +.ds #d .d
161.2511 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.2512 +.fc
161.2513 +.nr 33 \n(.s
161.2514 +.rm 80 81
161.2515 +.nr 34 \n(.lu
161.2516 +.eo
161.2517 +.am 81
161.2518 +.br
161.2519 +.di a+
161.2520 +.35
161.2521 +.ft \n(.f
161.2522 +.ll \n(34u*1u/3u
161.2523 +.if \n(.l<\n(81 .ll \n(81u
161.2524 +.in 0
161.2525 +\f3絨ャ JDK/SDK 若吾с\fP
161.2526 +.br
161.2527 +.di
161.2528 +.nr a| \n(dn
161.2529 +.nr a- \n(dl
161.2530 +..
161.2531 +.ec \
161.2532 +.35
161.2533 +.nf
161.2534 +.ll \n(34u
161.2535 +.nr 80 0
161.2536 +.nr 38 \w\f3帥\fP
161.2537 +.if \n(80<\n(38 .nr 80 \n(38
161.2538 +.nr 38 \w\f2@author\fP
161.2539 +.if \n(80<\n(38 .nr 80 \n(38
161.2540 +.nr 38 \w\f2{@code}\fP
161.2541 +.if \n(80<\n(38 .nr 80 \n(38
161.2542 +.nr 38 \w\f2{@docRoot}\fP
161.2543 +.if \n(80<\n(38 .nr 80 \n(38
161.2544 +.nr 38 \w\f2@deprecated\fP
161.2545 +.if \n(80<\n(38 .nr 80 \n(38
161.2546 +.nr 38 \w\f2@exception\fP
161.2547 +.if \n(80<\n(38 .nr 80 \n(38
161.2548 +.nr 38 \w\f2{@inheritDoc}\fP
161.2549 +.if \n(80<\n(38 .nr 80 \n(38
161.2550 +.nr 38 \w\f2{@link}\fP
161.2551 +.if \n(80<\n(38 .nr 80 \n(38
161.2552 +.nr 38 \w\f2{@linkplain}\fP
161.2553 +.if \n(80<\n(38 .nr 80 \n(38
161.2554 +.nr 38 \w\f2{@literal}\fP
161.2555 +.if \n(80<\n(38 .nr 80 \n(38
161.2556 +.nr 38 \w\f2@param\fP
161.2557 +.if \n(80<\n(38 .nr 80 \n(38
161.2558 +.nr 38 \w\f2@return\fP
161.2559 +.if \n(80<\n(38 .nr 80 \n(38
161.2560 +.nr 38 \w\f2@see\fP
161.2561 +.if \n(80<\n(38 .nr 80 \n(38
161.2562 +.nr 38 \w\f2@serial\fP
161.2563 +.if \n(80<\n(38 .nr 80 \n(38
161.2564 +.nr 38 \w\f2@serialData\fP
161.2565 +.if \n(80<\n(38 .nr 80 \n(38
161.2566 +.nr 38 \w\f2@serialField\fP
161.2567 +.if \n(80<\n(38 .nr 80 \n(38
161.2568 +.nr 38 \w\f2@since\fP
161.2569 +.if \n(80<\n(38 .nr 80 \n(38
161.2570 +.nr 38 \w\f2@throws\fP
161.2571 +.if \n(80<\n(38 .nr 80 \n(38
161.2572 +.nr 38 \w\f2{@value}\fP
161.2573 +.if \n(80<\n(38 .nr 80 \n(38
161.2574 +.nr 38 \w\f2@version\fP
161.2575 +.if \n(80<\n(38 .nr 80 \n(38
161.2576 +.80
161.2577 +.rm 80
161.2578 +.nr 81 0
161.2579 +.nr 38 \w1.0
161.2580 +.if \n(81<\n(38 .nr 81 \n(38
161.2581 +.nr 38 \w1.5
161.2582 +.if \n(81<\n(38 .nr 81 \n(38
161.2583 +.nr 38 \w1.3
161.2584 +.if \n(81<\n(38 .nr 81 \n(38
161.2585 +.nr 38 \w1.0
161.2586 +.if \n(81<\n(38 .nr 81 \n(38
161.2587 +.nr 38 \w1.0
161.2588 +.if \n(81<\n(38 .nr 81 \n(38
161.2589 +.nr 38 \w1.4
161.2590 +.if \n(81<\n(38 .nr 81 \n(38
161.2591 +.nr 38 \w1.2
161.2592 +.if \n(81<\n(38 .nr 81 \n(38
161.2593 +.nr 38 \w1.4
161.2594 +.if \n(81<\n(38 .nr 81 \n(38
161.2595 +.nr 38 \w1.5
161.2596 +.if \n(81<\n(38 .nr 81 \n(38
161.2597 +.nr 38 \w1.0
161.2598 +.if \n(81<\n(38 .nr 81 \n(38
161.2599 +.nr 38 \w1.0
161.2600 +.if \n(81<\n(38 .nr 81 \n(38
161.2601 +.nr 38 \w1.0
161.2602 +.if \n(81<\n(38 .nr 81 \n(38
161.2603 +.nr 38 \w1.2
161.2604 +.if \n(81<\n(38 .nr 81 \n(38
161.2605 +.nr 38 \w1.2
161.2606 +.if \n(81<\n(38 .nr 81 \n(38
161.2607 +.nr 38 \w1.2
161.2608 +.if \n(81<\n(38 .nr 81 \n(38
161.2609 +.nr 38 \w1.1
161.2610 +.if \n(81<\n(38 .nr 81 \n(38
161.2611 +.nr 38 \w1.2
161.2612 +.if \n(81<\n(38 .nr 81 \n(38
161.2613 +.nr 38 \w1.4
161.2614 +.if \n(81<\n(38 .nr 81 \n(38
161.2615 +.nr 38 \w1.0
161.2616 +.if \n(81<\n(38 .nr 81 \n(38
161.2617 +.81
161.2618 +.rm 81
161.2619 +.nr 38 \n(a-
161.2620 +.if \n(81<\n(38 .nr 81 \n(38
161.2621 +.35
161.2622 +.nf
161.2623 +.ll \n(34u
161.2624 +.nr 38 1n
161.2625 +.nr 79 0
161.2626 +.nr 40 \n(79+(0*\n(38)
161.2627 +.nr 80 +\n(40
161.2628 +.nr 41 \n(80+(3*\n(38)
161.2629 +.nr 81 +\n(41
161.2630 +.nr TW \n(81
161.2631 +.if t .if \n(TW>\n(.li .tm Table at line 1125 file Input is too wide - \n(TW units
161.2632 +.fc
161.2633 +.nr #T 0-1
161.2634 +.nr #a 0-1
161.2635 +.eo
161.2636 +.de T#
161.2637 +.ds #d .d
161.2638 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.2639 +.mk ##
161.2640 +.nr ## -1v
161.2641 +.ls 1
161.2642 +.ls
161.2643 +..
161.2644 +.ec
161.2645 +.ne \n(a|u+\n(.Vu
161.2646 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.2647 +.ta \n(80u \n(81u
161.2648 +.nr 31 \n(.f
161.2649 +.nr 35 1m
161.2650 +\&\h'|\n(40u'\f3帥\fP\h'|\n(41u'
161.2651 +.mk ##
161.2652 +.nr 31 \n(##
161.2653 +.sp |\n(##u-1v
161.2654 +.nr 37 (\n(41u+\n(81u-\n(a-u)/2u
161.2655 +.in +\n(37u
161.2656 +.a+
161.2657 +.in -\n(37u
161.2658 +.mk 32
161.2659 +.if \n(32>\n(31 .nr 31 \n(32
161.2660 +.sp |\n(31u
161.2661 +.ta \n(80u \n(81u
161.2662 +.nr 31 \n(.f
161.2663 +.nr 35 1m
161.2664 +\&\h'|\n(40u'\f2@author\fP\h'|\n(41u'1.0
161.2665 +.ta \n(80u \n(81u
161.2666 +.nr 31 \n(.f
161.2667 +.nr 35 1m
161.2668 +\&\h'|\n(40u'\f2{@code}\fP\h'|\n(41u'1.5
161.2669 +.ta \n(80u \n(81u
161.2670 +.nr 31 \n(.f
161.2671 +.nr 35 1m
161.2672 +\&\h'|\n(40u'\f2{@docRoot}\fP\h'|\n(41u'1.3
161.2673 +.ta \n(80u \n(81u
161.2674 +.nr 31 \n(.f
161.2675 +.nr 35 1m
161.2676 +\&\h'|\n(40u'\f2@deprecated\fP\h'|\n(41u'1.0
161.2677 +.ta \n(80u \n(81u
161.2678 +.nr 31 \n(.f
161.2679 +.nr 35 1m
161.2680 +\&\h'|\n(40u'\f2@exception\fP\h'|\n(41u'1.0
161.2681 +.ta \n(80u \n(81u
161.2682 +.nr 31 \n(.f
161.2683 +.nr 35 1m
161.2684 +\&\h'|\n(40u'\f2{@inheritDoc}\fP\h'|\n(41u'1.4
161.2685 +.ta \n(80u \n(81u
161.2686 +.nr 31 \n(.f
161.2687 +.nr 35 1m
161.2688 +\&\h'|\n(40u'\f2{@link}\fP\h'|\n(41u'1.2
161.2689 +.ta \n(80u \n(81u
161.2690 +.nr 31 \n(.f
161.2691 +.nr 35 1m
161.2692 +\&\h'|\n(40u'\f2{@linkplain}\fP\h'|\n(41u'1.4
161.2693 +.ta \n(80u \n(81u
161.2694 +.nr 31 \n(.f
161.2695 +.nr 35 1m
161.2696 +\&\h'|\n(40u'\f2{@literal}\fP\h'|\n(41u'1.5
161.2697 +.ta \n(80u \n(81u
161.2698 +.nr 31 \n(.f
161.2699 +.nr 35 1m
161.2700 +\&\h'|\n(40u'\f2@param\fP\h'|\n(41u'1.0
161.2701 +.ta \n(80u \n(81u
161.2702 +.nr 31 \n(.f
161.2703 +.nr 35 1m
161.2704 +\&\h'|\n(40u'\f2@return\fP\h'|\n(41u'1.0
161.2705 +.ta \n(80u \n(81u
161.2706 +.nr 31 \n(.f
161.2707 +.nr 35 1m
161.2708 +\&\h'|\n(40u'\f2@see\fP\h'|\n(41u'1.0
161.2709 +.ta \n(80u \n(81u
161.2710 +.nr 31 \n(.f
161.2711 +.nr 35 1m
161.2712 +\&\h'|\n(40u'\f2@serial\fP\h'|\n(41u'1.2
161.2713 +.ta \n(80u \n(81u
161.2714 +.nr 31 \n(.f
161.2715 +.nr 35 1m
161.2716 +\&\h'|\n(40u'\f2@serialData\fP\h'|\n(41u'1.2
161.2717 +.ta \n(80u \n(81u
161.2718 +.nr 31 \n(.f
161.2719 +.nr 35 1m
161.2720 +\&\h'|\n(40u'\f2@serialField\fP\h'|\n(41u'1.2
161.2721 +.ta \n(80u \n(81u
161.2722 +.nr 31 \n(.f
161.2723 +.nr 35 1m
161.2724 +\&\h'|\n(40u'\f2@since\fP\h'|\n(41u'1.1
161.2725 +.ta \n(80u \n(81u
161.2726 +.nr 31 \n(.f
161.2727 +.nr 35 1m
161.2728 +\&\h'|\n(40u'\f2@throws\fP\h'|\n(41u'1.2
161.2729 +.ta \n(80u \n(81u
161.2730 +.nr 31 \n(.f
161.2731 +.nr 35 1m
161.2732 +\&\h'|\n(40u'\f2{@value}\fP\h'|\n(41u'1.4
161.2733 +.ta \n(80u \n(81u
161.2734 +.nr 31 \n(.f
161.2735 +.nr 35 1m
161.2736 +\&\h'|\n(40u'\f2@version\fP\h'|\n(41u'1.0
161.2737 +.fc
161.2738 +.nr T. 1
161.2739 +.T# 1
161.2740 +.35
161.2741 +.rm a+
161.2742 +.TE
161.2743 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-44
161.2744 +
161.2745 +.LP
161.2746 +.RE
161.2747 +.LP
161.2748 +鴻帥帥違ゃ\-tag 激с潟с
161.2749 +.LP
161.2750 +.RS 3
161.2751 +.TP 3
161.2752 +@author\ name\-text
161.2753 +\-author 激с潟篏帥翫ャ<潟菴遵絎 \f2name\-text\fP 吾莨若帥障1 ゃャ<潟若激с潟潟<潟茲違 \f2@author\fP 帥違с障1 ゃ \f2@author\fP 帥違 1 ゃ絎1 ゃ帥違茲違絎с障翫Javadoc 若c潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹fャ<潟障障潟若障c潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
161.2754 +.RE
161.2755 +
161.2756 +.LP
161.2757 +.RS 3
161.2758 +
161.2759 +.LP
161.2760 +.LP
161.2761 +荅括完ゃ帥違篏睡с贋
161.2762 +.na
161.2763 +\f2@author 帥違ャ<潟\fP @
161.2764 .fi
161.2765 -.LP
161.2766 -.SS "javadoc のタグ"
161.2767 -.LP
161.2768 -.B javadoc
161.2769 -ツールは、
161.2770 -.B java doc
161.2771 -コメント内に埋め込まれた特殊なタグを解析します。これらの
161.2772 -特殊な doc タグを使うと、
161.2773 -書式の整った完全な API ドキュメントをソース
161.2774 -コードから自動的に生成できます。
161.2775 -タグは、単価記号 (\f3@\f1) で始まり、大文字小文字が
161.2776 -区別されます。これらのタグは、
161.2777 -以下に示すとおりに、大文字と小文字を区別して入力する
161.2778 -必要があります。タグは、行
161.2779 -の先頭 (ただし先行する空白と省略可能なアスタリスクは除く) から
161.2780 -始めなければなり
161.2781 -ません。慣習上、同じ名前のタグは 1 個所にまとめて記述します。
161.2782 -たとえば、
161.2783 -.B @see
161.2784 -タグが複数ある場合は、すべてを 1 個所にまとめて記述します。
161.2785 -.LP
161.2786 -タグは次の 2 種類あります。
161.2787 -.LP
161.2788 -\(bu
161.2789 -スタンドアロンタグ - 説明のあとのタグセクションだけに
161.2790 -置くことができます。 このタグは、@tag のように中括弧で囲みません。
161.2791 -.LP
161.2792 -\(bu
161.2793 -インラインタグ - コメントの説明内またはスタンドアロンタグの
161.2794 -コメント中の任意の場所に置くことができます。 インラインタグは、{@tag} の
161.2795 -ように中括弧で囲みます。
161.2796 -.LP
161.2797 -今後のリリースで導入されるタグについては、
161.2798 -.fi
161.2799 -http://java.sun.com/j2se/javadoc/proposed\-tags.html
161.2800 -の
161.2801 -.na
161.2802 -「\f2Proposed Tags\fP」を参照してください。
161.2803 -.LP
161.2804 -.LP
161.2805 -現時点で有効なタグは、次のとおりです。
161.2806 -.LP
161.2807 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@authorс
161.2808 +.LP
161.2809 +.LP
161.2810 +
161.2811 +.LP
161.2812 +.RE
161.2813 .RS 3
161.2814 -
161.2815 -.LP
161.2816 -.LP
161.2817 -.TS
161.2818 -center;
161.2819 -cbp-1 cbp-1
161.2820 -l l.
161.2821 -タグ 導入された JDK/SDK のバージョン
161.2822 -@author 1.0
161.2823 -{@code} 1.5
161.2824 -{@docRoot} 1.3
161.2825 -@deprecated} 1.0
161.2826 -@exception 1.0
161.2827 -{@inheritDoc} 1.4
161.2828 -{@link} 1.2
161.2829 -{@linkplain} 1.4
161.2830 -{@literal} 1.5
161.2831 -@param 1.0
161.2832 -@return 1.0
161.2833 -@see 1.0
161.2834 -@serial 1.2
161.2835 -@serialData 1.2
161.2836 -@serialField 1.2
161.2837 -@since 1.1
161.2838 -@throws 1.2
161.2839 -{@value} 1.4
161.2840 -@version 1.0
161.2841 -.TE
161.2842 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-42
161.2843 -
161.2844 -.LP
161.2845 -.LP
161.2846 -カスタムタグについては、\-tag オプションを参照してください。
161.2847 -.TP
161.2848 -.BI @author " name-text"
161.2849 -.B \-author
161.2850 -オプションが使われている場合、
161.2851 -生成されるドキュメントに、指定された
161.2852 -name-text を持つ Author エントリを追加します。
161.2853 -1 つの doc コメントに複数の
161.2854 -.B @author
161.2855 -タグを含めることができます。
161.2856 -.B @author
161.2857 -タグごとに 1 つ、またはタグごとに複数の名前を
161.2858 -指定できます。前者の場合は、
161.2859 -.B javadoc
161.2860 -ツールは、名前と名前の間にコンマ (\f3,\f1) とスペースを挿入します。
161.2861 -後者の場合、テキスト全体が
161.2862 -解析されることなく生成されるドキュメントにコピーされるだけです。
161.2863 -このため、コンマ以外
161.2864 -の現地仕様の名前区切り文字を使う場合は、1 行に複数の名前を指定します。
161.2865 -.LP
161.2866 -詳細については、「タグを使用できる場所」および
161.2867 -.fi
161.2868 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@author
161.2869 -の
161.2870 -.na
161.2871 -\f2@author タグのドキュメント\fPを参照してください。
161.2872 -.LP
161.2873 .TP 3
161.2874 @deprecated\ deprecated\-text
161.2875 .RS 3
161.2876
161.2877 .LP
161.2878 .LP
161.2879 -注: JDK 5.0 から、@Deprecated 注釈を使って特定のプログラム要素を非推奨にできるようになりました。
161.2880 -.LP
161.2881 -この API は (動作はするが) 使用すべきでないことを示す
161.2882 -コメントを追加します。
161.2883 -.B javadoc
161.2884 - は、deprecated-text を説明の前に移動してイタリックにし、
161.2885 -その前にボールドの警告
161.2886 -「推奨されません。」を追加します。このタグはすべての doc コメント (概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、フィールド) で有効です。
161.2887 -.LP
161.2888 -.RS
161.2889 -deprecated-text の最初の文では、少なくともユーザにどのようなときに
161.2890 -その API が推奨されないか、およびそれに代わる API を提示する
161.2891 -必要があります。
161.2892 -.B javadoc
161.2893 -は、最初の文だけを要約セクションと索引にコピーします。
161.2894 -あとに続く文で、なぜその API が推奨されないかを
161.2895 -説明することもできます。代わりの API を
161.2896 -指し示す {\f3@link\f1} タグ (
161.2897 -.B javadoc
161.2898 -1.2 以降の場合) を含める必要があります。
161.2899 -.LP
161.2900 -詳細については、
161.2901 +羈: JDK 5.0
161.2902 +.na
161.2903 +\f2@Deprecated 羈\fP @
161.2904 .fi
161.2905 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated
161.2906 -の
161.2907 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html篏帥c劫違荀膣ィ絅с障
161.2908 +.LP
161.2909 +.RE
161.2910 +.RE
161.2911 +.RS 3
161.2912 +
161.2913 +.LP
161.2914 +.LP
161.2915 + API 篏膓障 API 篏睡鴻с腓冴潟<潟菴遵障Javadoc 若\f2deprecated\-text\fP 筝肢腱糸ゃ帥若茘ィ絅障菴遵障帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
161.2916 +.LP
161.2917 +.LP
161.2918 +\f2deprecated\-text\fP с絨 API ィ絅c篁f推戎鴻 API 茯腓冴綽荀障Javadoc 若网荀祉激с潟膣√潟若障с API ィ絅宴茯с障障篁c API 腓冴 \f2{@link}\fP 帥 (Javadoc 1.2 篁ラ翫) 綽荀障 罨<荐菴違障
161.2919 +.LP
161.2920 +.LP
161.2921 +荅括完ゃ
161.2922 .na
161.2923 -\f2@deprecated タグのドキュメント\fPを参照してください。
161.2924 -.LP
161.2925 -.TP 2
161.2926 -\(bu
161.2927 -.B javadoc
161.2928 -1.2 以降では、{\f3@link\f1} タグを使用してください。これにより、
161.2929 -必要な場所にインラインで
161.2930 -リンクが作成されます。たとえば、次のように使います。
161.2931 -.LP
161.2932 -.RS
161.2933 -.ft 3
161.2934 -.nf
161.2935 -/**
161.2936 - * @deprecated As of JDK 1.1, replaced by
161.2937 - * {@link #setBounds(int,int,int,int)}
161.2938 - */
161.2939 +\f2@deprecated 帥違ャ<潟\fP @
161.2940 .fi
161.2941 -.ft 1
161.2942 -.RE
161.2943 -.LP
161.2944 -.TP 2
161.2945 -\(bu
161.2946 -.B javadoc
161.2947 -1.1 では、各
161.2948 -.B @deprecated
161.2949 -タグに
161.2950 -.B @see
161.2951 -タグ (インラインにできない) を作成するのが標準の形式です。
161.2952 -.LP
161.2953 -推奨されないタグについての詳細は、「
161.2954 -.B @deprecated
161.2955 -タグ」 を参照してください。
161.2956 -.RE
161.2957 -.TP
161.2958 -.B {@code text}
161.2959 -<code>{@literal}</code> と同等です。
161.2960 -.LP
161.2961 -テキストを HTML マークアップまたは
161.2962 -入れ子になった javadoc タグとして解釈せずに、
161.2963 -テキストをコードフォントで表示します。
161.2964 -これにより doc コメントでは、
161.2965 -パラメータの種類 ( <Object> )、不等号 ( 3 < 4 )、
161.2966 -または矢印 ( <- ) などで、HTML エンティティ ( < および > ) ではなく、
161.2967 -通常の山括弧 (< および >) を使用できます。
161.2968 -たとえば doc コメントのテキスト
161.2969 -.LP
161.2970 -.RS 5
161.2971 -{@code A<B>C}
161.2972 -.RE
161.2973 -.LP
161.2974 -は、生成された HTML ページで、次のようにそのまま表示されます。
161.2975 -.LP
161.2976 -.RS 5
161.2977 -A<B>C
161.2978 -.RE
161.2979 -.LP
161.2980 -注目すべき点として、<B> は太字であると解釈されませんが、
161.2981 -コードフォントになります。
161.2982 -.LP
161.2983 -コードフォントなしで同じ機能を実現するには、
161.2984 -{@literal} を使用します。
161.2985 -.RE
161.2986 -.TP
161.2987 -.B {@docRoot}
161.2988 -生成された任意のページを起点とした、ドキュメントの (出力先)
161.2989 -ルートディレクトリの相対パスを表します。このタグは、著作権ページ
161.2990 -または会社のロゴなど、生成されるすべてのページから参照するファイル
161.2991 -を取り込むときに使います。通常は、各ページの最下部から著作権
161.2992 -ページにリンクします。
161.2993 -.RS
161.2994 -.LP
161.2995 -この \f2{@docRoot}\fP タグは、コマンド行からも、ドキュメンテーションコメントの中でも使用できます。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
161.2996 -.TP 4
161.2997 -1.
161.2998 -コマンド行では、次のようにヘッダ (header)、フッタ (footer)、
161.2999 -またはページの最下部 (bottom)を定義します。
161.3000 -.sp 1n
161.3001 -.B javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
161.3002 -.LP
161.3003 -注 - Makefile の中で {\f3@docRoot\f1}をこのように利用する場合、
161.3004 -一部の Makefile プログラムでは、中括弧 { } 文字をエスケープする
161.3005 -必要があります。 たとえば、Inprise MAKE バージョン 5.2 を
161.3006 -Windows 上で実行する場合は、{{\f3@docRoot\f1}} のように、
161.3007 -中括弧を二重にする必要があります。さらに、\-bottom などの
161.3008 -オプションに対する引数を、単一引用符ではなく、
161.3009 -二重引用符で囲む必要があります。href
161.3010 -引数の値を囲む引用符は省略します。
161.3011 -.TP
161.3012 -2.
161.3013 -doc コメントには次のように記述します。
161.3014 -.sp 1n
161.3015 -.nf
161.3016 -.ft 3
161.3017 -/**
161.3018 -* See the <a href="{@docRoot}/copyright.html">Copyright</a>.
161.3019 -*/
161.3020 -.ft 1
161.3021 -.fi
161.3022 -.LP
161.3023 -このタグが必要な理由は、生成されるドキュメントが、サブパッケージと
161.3024 -同じ階層のディレクトリに格納されるためです。たとえば、次のように指定します。
161.3025 -.LP
161.3026 -.ti +5n
161.3027 -.B <a href="{@docRoot}/copyright.html">
161.3028 -.LP
161.3029 -次のように解決されます。
161.3030 -.LP
161.3031 -.ti +5n
161.3032 -\f3<a href=".\|.\|/.\|.\|/copyright.html">\f1 .\|.\|. java/lang/Object.java の場合
161.3033 -.sp 1n
161.3034 -および
161.3035 -.sp 1n
161.3036 -.ti +5n
161.3037 -\f3<a href=".\|.\|/.\|.\|/.\|.\|/copyright.html">\f1 .\|.\|. java/lang/ref/Reference.java の場合
161.3038 -.RE
161.3039 -.TP
161.3040 -.BI @exception " class-name description"
161.3041 -.B @exception
161.3042 -タグは、
161.3043 -.BR @throws
161.3044 -と同義です。
161.3045 -.TP
161.3046 -{\f3@inheritDoc\f1}
161.3047 -最も近いスーパークラスから現在の ドキュメンテーションコメントに、ドキュメントを継承します。 この機能により、コメントは継承ツリーの上位に移動し、開発者はコピーしたテキストに記述を追加することができます。
161.3048 -.LP
161.3049 -このタグは、ドキュメンテーションコメントの次の位置でのみ有効です。
161.3050 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecatedс
161.3051 +.LP
161.3052 .RS 3
161.3053 .TP 2
161.3054 o
161.3055 -メソッドの主説明ブロック内。この場合、主説明は、上位階層のクラスまたはインタフェースからコピーされる
161.3056 +Javadoc 1.2 篁ラс\f2{@link}\fP 帥違篏睡障綽荀贋ゃ潟ゃ潟с潟篏с障箴腓冴障
161.3057 +.RE
161.3058 +
161.3059 +.LP
161.3060 +.RS 3
161.3061 +
161.3062 +.LP
161.3063 +.nf
161.3064 +\f3
161.3065 +.fl
161.3066 +/**
161.3067 +.fl
161.3068 + * @deprecated As of JDK 1.1, replaced by {@link #setBounds(int,int,int,int)}
161.3069 +.fl
161.3070 + */
161.3071 +.fl
161.3072 +
161.3073 +.fl
161.3074 +\fP
161.3075 +.fi
161.3076 +.RE
161.3077 +
161.3078 +.LP
161.3079 +.RS 3
161.3080 .TP 2
161.3081 o
161.3082 -メソッドの @return、@param、@throws タグのテキスト引数内。この場合、タグテキストは、上位階層の対応するタグからコピーされる
161.3083 +Javadoc 1.1 с \f2@deprecated\fP 帥違絲障 \f2@see\fP 帥 (ゃ潟ゃ潟с) 荐菴違罔羣綵√с
161.3084 .RE
161.3085 -.LP
161.3086 -継承階層でコメントを見つける方法に関する正確な説明について、「メソッドコメントの自動コピー」を参照してください。このタグが見つからない場合、コメントは、この節で説明するルールに応じて、自動的に継承されるかどうかが決まります。
161.3087 -.LP
161.3088 +
161.3089 +.LP
161.3090 +.LP
161.3091 +ィ絅帥違ゃ荅括完
161.3092 +.na
161.3093 +\f2@deprecated 帥\fP @
161.3094 +.fi
161.3095 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.htmlャ<潟с
161.3096 +.LP
161.3097 +.LP
161.3098 +
161.3099 +.LP
161.3100 +.RE
161.3101 +.RS 3
161.3102 .TP 3
161.3103 -{@link\ package.class#member\ label}
161.3104 -表示テキスト label とのインラインリンクを挿入します。\f2label\fP は、参照クラスの指定されたパッケージ、クラス、またはメンバの名前のドキュメンテーションを指し示します。このタグは、@return、@param、@deprecated などの任意のタグのテキスト部分を含む、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。
161.3105 -.LP
161.3106 -このタグは、
161.3107 -.B @see
161.3108 -タグとよく似ています。どちらのタグも、package.class#member および
161.3109 -.BI label
161.3110 -の参照の仕方が同じで、有効な構文もまったく同じです。
161.3111 -大きな違いは、{\f3@link\f1} は、リンクを [関連項目] セクションに
161.3112 -置くのではなく、インラインリンクを生成するということです。
161.3113 -また、インラインテキストのほかの部分と区別するために、
161.3114 -{\f3@link\f1} タグの最初と最後に中括弧を記述します。
161.3115 -ラベルの中で「}」を使う必要がある場合は、HTML
161.3116 -エンティティの「}」を使います。
161.3117 -.LP
161.3118 -1 つの文の中で使用できる {@link} タグの数に制限はありません。
161.3119 -このタグは、ドキュメンテーションコメントの説明部分、または
161.3120 -.BR @deprecated
161.3121 -、
161.3122 -.BR @return
161.3123 -、
161.3124 -.BR @param
161.3125 -などの任意のタグのテキスト部分で使うことができます。
161.3126 -.LP
161.3127 -たとえば、次のコメントでは、
161.3128 -.B getComponentAt(int, int)
161.3129 -メソッドを参照しています。
161.3130 -.LP
161.3131 -.ft 3
161.3132 -.nf
161.3133 -Use the {\f3@link #getComponentAt(int, int) getComponentAt\f1} method.
161.3134 -.fi
161.3135 -.ft 1
161.3136 -.LP
161.3137 -標準ドックレットでは、上記のコメントから次の HTML が
161.3138 -生成されます (このコメントが同じパッケージの別のクラスを参照している場合)。
161.3139 -.LP
161.3140 -.ft 3
161.3141 -.nf
161.3142 -Use the
161.3143 -<a href="Component.html#getComponentAt(int, int)">getComponentAt</a>method.
161.3144 -.fi
161.3145 -.ft 1
161.3146 -.LP
161.3147 -この HTML は、Web ページ上では次のように表示されます。
161.3148 -.LP
161.3149 -.ft 3
161.3150 -.nf
161.3151 -Use the getComponentAt method.
161.3152 -.fi
161.3153 -.ft 1
161.3154 -.LP
161.3155 -{\f3@link\f1} を、ドキュメント化の対象にしていないクラスにまで
161.3156 -拡張するには、
161.3157 -.BR \-link
161.3158 -オプションを使用します。
161.3159 -.LP
161.3160 -詳細については、
161.3161 -.fi
161.3162 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}
161.3163 -の
161.3164 -.na
161.3165 -\f2{@link} タグのドキュメント\fPを参照してください。
161.3166 +{@code\ text}
161.3167 +\f2<code>{@literal}</code>\fP 膈с
161.3168 .RE
161.3169 -.TP
161.3170 -{@linkplain package.class#member label}
161.3171 -リンクのラベルがコードフォントではなくプレーンテキストで
161.3172 -表示されている点以外は、
161.3173 -{\f3@link\f1} と同じです。 ラベルがプレーンテキストで
161.3174 -記述されている場合に便利です。次の例を参照してください。
161.3175 -.LP
161.3176 -.ft 3
161.3177 -.nf
161.3178 -Refer to {\f3@linkplain\f1 add() the overridden method}.
161.3179 -.fi
161.3180 -.ft 1
161.3181 -.LP
161.3182 -これは以下のように表示されます。
161.3183 -.LP
161.3184 -.ft 3
161.3185 -.nf
161.3186 -Refer to the overridden method.
161.3187 -.fi
161.3188 -.ft 1
161.3189 -.LP
161.3190 -.TP
161.3191 -.B {@literal text}
161.3192 -テキストを HTML マークアップまたは
161.3193 -入れ子になった javadoc タグとして解釈せずに、
161.3194 -テキストをコードフォントで表示します。
161.3195 -これにより doc コメントでは、
161.3196 -パラメータの種類 ( <Object> )、不等号 ( 3 < 4 )、
161.3197 -または矢印 ( <- ) などで、HTML エンティティ ( < および > ) ではなく、
161.3198 -通常の山括弧 (< および >) を使用できます。
161.3199 -たとえば doc コメントのテキスト
161.3200 -.LP
161.3201 -.RS 5
161.3202 -{@literal A<B>C}
161.3203 -.RE
161.3204 -.LP
161.3205 -は、生成された HTML ページはブラウザで次のようにそのまま表示されます。
161.3206 -.LP
161.3207 -.RS 5
161.3208 -A<B>C
161.3209 -.RE
161.3210 -.LP
161.3211 -注目すべき点として、<B> は太字であると解釈され、
161.3212 -コードフォントになりません。
161.3213 -.LP
161.3214 -コードフォントで同じ機能を実現するには、
161.3215 -{@code} を使用します。
161.3216 -.TP
161.3217 -.BI @param " parameter-name description"
161.3218 -指定した parameter-name と指定した description を使用して
161.3219 -パラメータを「Parameters」セクションに追加します。
161.3220 -doc コメントを記述するときは、description を複数行に
161.3221 -続けることができます。このタグは、
161.3222 -メソッド、コンストラクタ、またはクラスの
161.3223 -doc コメント内でのみ有効です。
161.3224 -.LP
161.3225 -\f2parameter\-name\fP は、メソッドまたはコンストラクタでのパラメータの名前か、クラス、メソッドまたはコンストラクタのタイプパラメータの名前になります。
161.3226 -山括弧でパラメータ名を囲むと、型パラメータを使用することを
161.3227 -指定します。
161.3228 -.LP
161.3229 -クラスの型パラメータの例:
161.3230 +
161.3231 +.LP
161.3232 +.RS 3
161.3233 +
161.3234 +.LP
161.3235 +.LP
161.3236 +鴻 HTML 若≪障ャ絖c javadoc 帥違茹i\f2text\fP \f2code\fP 潟ц;腓冴障 doc 潟<潟с<若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟cc (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟<潟鴻
161.3237 +.LP
161.3238 .nf
161.3239 \f3
161.3240 .fl
161.3241 - /**
161.3242 -.fl
161.3243 - * @param <E> Type of element stored in a list
161.3244 -.fl
161.3245 - */
161.3246 -.fl
161.3247 - public interface List<E> extends Collection<E> {
161.3248 -.fl
161.3249 - }
161.3250 + \fP\f4{@code A<B>C}\fP\f3
161.3251 +.fl
161.3252 +
161.3253 .fl
161.3254 \fP
161.3255 .fi
161.3256 -.LP
161.3257 -メソッドの型パラメータの例:
161.3258 +
161.3259 +.LP
161.3260 +.LP
161.3261 + HTML 若吾с罨<障乗;腓冴障
161.3262 +.LP
161.3263 .nf
161.3264 \f3
161.3265 .fl
161.3266 - /**
161.3267 -.fl
161.3268 - * @param string the string to be converted
161.3269 -.fl
161.3270 - * @param type the type to convert the string to
161.3271 -.fl
161.3272 - * @param <T> the type of the element
161.3273 -.fl
161.3274 - * @param <V> the value of the element
161.3275 -.fl
161.3276 - */
161.3277 -.fl
161.3278 - <T, V extends T> V convert(String string, Class<T> type) {
161.3279 -.fl
161.3280 - }
161.3281 + \fP\f4A<B>C\fP\f3
161.3282 +.fl
161.3283 +
161.3284 .fl
161.3285 \fP
161.3286 .fi
161.3287 -詳細については、
161.3288 +
161.3289 +.LP
161.3290 +.LP
161.3291 +羈鴻鴻\f2<B>\fP 紊絖с茹i障潟若潟障
161.3292 +.LP
161.3293 +.LP
161.3294 +潟若潟у罘純絎憗\f2{@literal}\fP 篏睡障
161.3295 +.LP
161.3296 +.LP
161.3297 +
161.3298 +.LP
161.3299 +.RE
161.3300 +.RS 3
161.3301 +.TP 3
161.3302 +{@docRoot}
161.3303 +若吾荀ャ<潟 () 若c吾後障鴻茵障帥違篏罔若吾篌腓障眼鴻若吾с<ゃ腟粋昭箴水с絽吾若吾筝篏罔若吾潟障
161.3304 +.RE
161.3305 +
161.3306 +.LP
161.3307 +.RS 3
161.3308 +
161.3309 +.LP
161.3310 +.LP
161.3311 + \f2{@docRoot}\fP 帥違潟潟茵ャ<潟若激с潟潟<潟筝с篏睡с障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
161.3312 +.LP
161.3313 +.RS 3
161.3314 +.TP 3
161.3315 +1.
161.3316 +潟潟茵с若帥若障若罨<絎臂障
161.3317 +.nf
161.3318 +\f3
161.3319 +.fl
161.3320 + javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
161.3321 +.fl
161.3322 +
161.3323 +.fl
161.3324 +\fP
161.3325 .fi
161.3326 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@param
161.3327 -の
161.3328 +.LP
161.3329 +\- \f2{@docRoot}\fP 翫筝 Makefile 違с筝綣 { } 絖鴻宴若綽荀障違Inprise MAKE 若吾с 5.2 Windows 筝у茵翫\f2{{@docRoot}}\fP筝綣с篋綽荀障\f2\-bottom\fP 激с潟絲障綣違筝綣膃с篋綣膃у蚊綽荀障 \f2href\fP 綣違ゃ蚊綣膃ャ障
161.3330 +.TP 3
161.3331 +2.
161.3332 +ャ<潟若激с潟潟<潟筝с罨<篏睡障
161.3333 +.nf
161.3334 +\f3
161.3335 +.fl
161.3336 + /**
161.3337 +.fl
161.3338 + * See the <a href="{@docRoot}/copyright.html">Copyright</a>.
161.3339 +.fl
161.3340 + */
161.3341 +.fl
161.3342 +
161.3343 +.fl
161.3344 +\fP
161.3345 +.fi
161.3346 +.RE
161.3347 +
161.3348 +.LP
161.3349 +.LP
161.3350 +帥違綽荀宴ャ<潟泣宴若吾羞宴ら絮ゆc主с罨<箴腓冴障
161.3351 +.LP
161.3352 +.nf
161.3353 +\f3
161.3354 +.fl
161.3355 + <a href="{@docRoot}/copyright.html">
161.3356 +.fl
161.3357 +
161.3358 +.fl
161.3359 +\fP
161.3360 +.fi
161.3361 +
161.3362 +.LP
161.3363 +.LP
161.3364 +罨<茹f浦障
161.3365 +.LP
161.3366 +.nf
161.3367 +\f3
161.3368 +.fl
161.3369 + <a href="../../copyright.html"> java/lang/Object.java 翫
161.3370 +.fl
161.3371 +
161.3372 +.fl
161.3373 +\fP
161.3374 +.fi
161.3375 +
161.3376 +.LP
161.3377 +.LP
161.3378 +
161.3379 +.LP
161.3380 +.nf
161.3381 +\f3
161.3382 +.fl
161.3383 + <a href="../../../copyright.html"> java/lang/ref/Reference.java 翫
161.3384 +.fl
161.3385 +
161.3386 +.fl
161.3387 +\fP
161.3388 +.fi
161.3389 +
161.3390 +.LP
161.3391 +.LP
161.3392 +
161.3393 +.LP
161.3394 +.RE
161.3395 +.RS 3
161.3396 +.TP 3
161.3397 +@exception\ class\-name\ description
161.3398 +\f2@exception\fP 帥違\f2@throws\fP 帥違臂с
161.3399 +.RE
161.3400 +
161.3401 +.LP
161.3402 +.RS 3
161.3403 +
161.3404 +.LP
161.3405 +.LP
161.3406 +
161.3407 +.LP
161.3408 +.RE
161.3409 +.RS 3
161.3410 +.TP 3
161.3411 +{@inheritDoc}\
161.3412 +c菴膓水純鴻障絎茖純ゃ潟帥с若鴻帥違憜ャ<潟若激с潟潟<潟ャ<潟膓 (潟) 障罘純羆潟<潟膓帥若筝篏荐菴違潟若鴻篏帥c荐菴違с障
161.3413 +.RE
161.3414 +
161.3415 +.LP
161.3416 +.RS 3
161.3417 +
161.3418 +.LP
161.3419 +.LP
161.3420 +帥違ャ<潟若激с潟潟<潟罨<篏臀с炊鴻с
161.3421 +.LP
161.3422 +.RS 3
161.3423 +.TP 2
161.3424 +o
161.3425 +<純筝肢翫筝肢筝篏絮ゃ鴻障ゃ潟帥с若鴻潟若
161.3426 +.TP 2
161.3427 +o
161.3428 +<純 @return@param@throws 帥違鴻綣医翫帥違鴻筝篏絮ゃ絲上帥違潟若
161.3429 +.RE
161.3430 +
161.3431 +.LP
161.3432 +.LP
161.3433 +膓翠絮ゃс潟<潟荀ゃ号≪罩g∈茯ゃ<純潟<潟潟若с帥違荀ゃ翫潟<潟膀ц若綽膓帥羆冴障障
161.3434 +.LP
161.3435 +.LP
161.3436 +
161.3437 +.LP
161.3438 +.RE
161.3439 +.RS 3
161.3440 +.TP 3
161.3441 +{@link\ \ package.class#member\ \ label}\
161.3442 +茵腓冴鴻 \f2label\fP ゃ潟ゃ潟潟水ャ障 \f2label\fP с鴻絎宴若吾鴻障<潟若ャ<潟若激с潟腓冴障帥違@return@param@deprecated 篁紙帥違鴻鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с
161.3443 +.RE
161.3444 +
161.3445 +.LP
161.3446 +.RS 3
161.3447 +
161.3448 +.LP
161.3449 +.LP
161.3450 +帥違\f2@see\fP 帥違鋍若障 <帥違\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP с篁鴻с鴻罕障cс紊с\f2{@link}\fP 潟 [∫i] 祉激с潟臀сゃ潟ゃ潟潟с障ゃ潟ゃ潟鴻祉阪ャ\f2{@link}\fP 帥違緇筝綣с荐菴違障筝с}篏帥綽荀翫HTML 潟cc若}篏帥障
161.3451 +.LP
161.3452 +.LP
161.3453 +1 ゃ筝т戎с \f2{@link}\fP 帥違違狗障帥違ャ<潟若激с潟潟<潟筝肢障 @deprecated@return@param 篁紙帥違鴻т戎с障
161.3454 +.LP
161.3455 +.LP
161.3456 +違罨<潟<潟с \f2getComponentAt(int, int)\fP <純с障
161.3457 +.LP
161.3458 +.nf
161.3459 +\f3
161.3460 +.fl
161.3461 +{@link #getComponentAt(int, int) getComponentAt} <純篏睡障
161.3462 +.fl
161.3463 +
161.3464 +.fl
161.3465 +\fP
161.3466 +.fi
161.3467 +
161.3468 +.LP
161.3469 +.LP
161.3470 +罔羣с筝荐潟<潟罨< HTML 障 (潟<潟宴若吾ャ鴻с翫)
161.3471 +.LP
161.3472 +.nf
161.3473 +\f3
161.3474 +.fl
161.3475 +<a href="Component.html#getComponentAt(int, int)">getComponentAt</a> <純篏睡障
161.3476 +.fl
161.3477 +
161.3478 +.fl
161.3479 +\fP
161.3480 +.fi
161.3481 +
161.3482 +.LP
161.3483 +.LP
161.3484 + HTML Web 若娯с罨<茵腓冴障
161.3485 +.LP
161.3486 +.nf
161.3487 +\f3
161.3488 +.fl
161.3489 +getComponentAt <純篏睡障
161.3490 +.fl
161.3491 +
161.3492 +.fl
161.3493 +\fP
161.3494 +.fi
161.3495 +
161.3496 +.LP
161.3497 +.LP
161.3498 +\f2{@link}\fP ャ<潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
161.3499 +.LP
161.3500 +.LP
161.3501 +荅括完ゃ
161.3502 .na
161.3503 -\f2@param タグのドキュメント\fPを参照してください。
161.3504 -.LP
161.3505 +\f2{@link} 帥違ャ<潟\fP @
161.3506 +.fi
161.3507 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#{@link}с
161.3508 +.LP
161.3509 +.LP
161.3510 +
161.3511 +.LP
161.3512 +.RE
161.3513 +.RS 3
161.3514 +.TP 3
161.3515 +{@linkplain\ package.class#member\ label}
161.3516 +潟潟若潟с若潟鴻ц;腓冴剛札紊 \f2{@link}\fP с若潟鴻ц菴違箴水с箴:
161.3517 +.RE
161.3518 +
161.3519 +.LP
161.3520 +.RS 3
161.3521 +
161.3522 +.LP
161.3523 +.nf
161.3524 +\f3
161.3525 +.fl
161.3526 + {@linkplain add() the overridden method} с
161.3527 +.fl
161.3528 +
161.3529 +.fl
161.3530 +\fP
161.3531 +.fi
161.3532 +
161.3533 +.LP
161.3534 +.LP
161.3535 +篁ヤ茵腓冴障
161.3536 +.LP
161.3537 +.RS 3
161.3538 +
161.3539 +.LP
161.3540 +.LP
161.3541 +the overridden method с
161.3542 +.LP
161.3543 +.RE
161.3544 +.LP
161.3545 +
161.3546 +.LP
161.3547 +.RE
161.3548 +.RS 3
161.3549 +.TP 3
161.3550 +{@literal\ text}
161.3551 +鴻 HTML 若≪障ャ絖c javadoc 帥違茹i\f2text\fP 茵腓冴障 doc 潟<潟с<若帥腮蕁 (\f2<Object>\fP)筝膈 (\f23 < 4\fP)障√ (\f2<\-\fP) сHTML 潟cc (\f2<\fP \f2>\fP) с絽吾絮掩綣 (\f2<\fP \f2>\fP) 篏睡с障 doc 潟<潟鴻
161.3552 +.RE
161.3553 +
161.3554 +.LP
161.3555 +.RS 3
161.3556 +
161.3557 +.LP
161.3558 +.nf
161.3559 +\f3
161.3560 +.fl
161.3561 + \fP\f4{@literal A<B>C}\fP\f3
161.3562 +.fl
161.3563 +
161.3564 +.fl
161.3565 +\fP
161.3566 +.fi
161.3567 +
161.3568 +.LP
161.3569 +.LP
161.3570 + HTML 若吾吟ф<障乗;腓冴障
161.3571 +.LP
161.3572 +.LP
161.3573 +\f2\ \ \ \ \ \fPA<B>C
161.3574 +.LP
161.3575 +.LP
161.3576 +羈鴻鴻\f2<B>\fP 紊絖с茹i障 (潟若潟)
161.3577 +.LP
161.3578 +.LP
161.3579 +潟若潟у罘純絎憗\f2{@code}\fP 篏睡障
161.3580 +.LP
161.3581 +.LP
161.3582 +
161.3583 +.LP
161.3584 +.RE
161.3585 +.RS 3
161.3586 +.TP 3
161.3587 +@param\ parameter\-name description
161.3588 +絎 \f2parameter\-name\fP 絎 \f2description\fP 篏睡<若帥Parameters祉激с潟菴遵障doc 潟<潟荐菴違\f2description\fP 茲域膓с障帥違<純潟潟鴻帥障鴻 doc 潟<潟с炊鴻с
161.3589 +.RE
161.3590 +
161.3591 +.LP
161.3592 +.RS 3
161.3593 +
161.3594 +.LP
161.3595 +.LP
161.3596 +\f2parameter\-name\fP <純障潟潟鴻帥с<若帥鴻<純障潟潟鴻帥帥ゃ<若帥障絮掩綣сс<若水蚊<若帥篏睡絎障
161.3597 +.LP
161.3598 +.LP
161.3599 +鴻<若帥箴:
161.3600 +.LP
161.3601 +.nf
161.3602 +\f3
161.3603 +.fl
161.3604 + /**
161.3605 +.fl
161.3606 + * @param <E> Type of element stored in a list
161.3607 +.fl
161.3608 + */
161.3609 +.fl
161.3610 + public interface List<E> extends Collection<E> {
161.3611 +.fl
161.3612 + }
161.3613 +.fl
161.3614 +
161.3615 +.fl
161.3616 +\fP
161.3617 +.fi
161.3618 +
161.3619 +.LP
161.3620 +.LP
161.3621 +<純<若帥箴:
161.3622 +.LP
161.3623 +.nf
161.3624 +\f3
161.3625 +.fl
161.3626 + /**
161.3627 +.fl
161.3628 + * @param string the string to be converted
161.3629 +.fl
161.3630 + * @param type the type to convert the string to
161.3631 +.fl
161.3632 + * @param <T> the type of the element
161.3633 +.fl
161.3634 + * @param <V> the value of the element
161.3635 +.fl
161.3636 + */
161.3637 +.fl
161.3638 + <T, V extends T> V convert(String string, Class<T> type) {
161.3639 +.fl
161.3640 + }
161.3641 +.fl
161.3642 +
161.3643 +.fl
161.3644 +\fP
161.3645 +.fi
161.3646 +
161.3647 +.LP
161.3648 +.LP
161.3649 +荅括完ゃ
161.3650 +.na
161.3651 +\f2@param 帥違ャ<潟\fP @
161.3652 +.fi
161.3653 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@paramс
161.3654 +.LP
161.3655 +.LP
161.3656 +
161.3657 +.LP
161.3658 +.RE
161.3659 +.RS 3
161.3660 .TP 3
161.3661 @return\ description
161.3662 -「戻り値」セクションを追加して、\f2description\fP のテキストを書き込みます。このテキストでは、戻り値の型と、取り得る値の範囲について記述する必要があります。このタグは、メソッドのドキュメンテーションコメントでのみ有効です。
161.3663 -.LP
161.3664 -詳細については、
161.3665 +[祉] 祉激с潟菴遵\f2description\fP 鴻吾莨若帥障鴻с祉ゃ緇ゃ膀蚊ゃ荐菴違綽荀障帥違<純ャ<潟若激с潟潟<潟с炊鴻с
161.3666 +.RE
161.3667 +
161.3668 +.LP
161.3669 +.RS 3
161.3670 +
161.3671 +.LP
161.3672 +.LP
161.3673 +荅括完ゃ
161.3674 +.na
161.3675 +\f2@return 帥違ャ<潟\fP @
161.3676 .fi
161.3677 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@return
161.3678 -の
161.3679 -.na
161.3680 -\f2@return タグのドキュメント\fPを参照してください。
161.3681 -.LP
161.3682 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@returnс
161.3683 +.LP
161.3684 +.LP
161.3685 +
161.3686 +.LP
161.3687 +.RE
161.3688 +.RS 3
161.3689 .TP 3
161.3690 -@see\ reference
161.3691 -「関連項目」見出しを追加し、\f2reference\fP を指すリンクか、またはテキストエントリを書き込みます。1 つのドキュメンテーションコメントには、任意の数の \f2@see\fP タグを指定できます。すべての \f2@see\fP タグの内容は、同じ見出しの下にグループ化されます。\f2@see\fP タグには、次の 3 種類の形式があります。もっともよく使われるのは、3 番目の形式です。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。パッケージ、クラス、またはメンバに対するインラインリンクを文中に挿入する方法は、\f2{@link}\fP を参照してください。
161.3692 +@see\ \ reference
161.3693 +[∫i] 荀冴菴遵\f2reference\fP 潟障鴻潟吾莨若帥障1 ゃャ<潟若激с潟潟<潟篁紙違 \f2@see\fP 帥違絎с障 鴻 \f2@see\fP 帥違絎鴻荀冴筝違若障\f2@see\fP 帥違罨< 3 腮蕁綵√障 c鋎帥3 綵√с帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с宴若吾鴻障<潟若絲障ゃ潟ゃ潟潟筝水ャ号\f2{@link}\fP с
161.3694 .RS 3
161.3695 .TP 3
161.3696 @see "string"
161.3697 -string のテキストエントリを追加します。
161.3698 -リンクは生成されません。string は、書籍、または
161.3699 -URL ではアクセスできない情報の参照先です。
161.3700 -.B javadoc
161.3701 -ツールは、最初の文字が二重引用符 (") かどうかを調べて、
161.3702 -上の 2 つの形式とこの形式とを区
161.3703 -別します。次に例を示します。
161.3704 -.LP
161.3705 -.RS
161.3706 -.ft 3
161.3707 -.nf
161.3708 - @see "The Java Programming Language"
161.3709 -.fi
161.3710 -.ft 1
161.3711 -.LP
161.3712 -これは次のようなテキストを生成します。
161.3713 -.LP
161.3714 -.ft 3
161.3715 -.nf
161.3716 - 関連項目:
161.3717 - "The Java Programming Language"
161.3718 -.fi
161.3719 -.ft 1
161.3720 -.RE
161.3721 -.TP
161.3722 -\f3@see <a href="\f2URL#value\f3">\f2label\f3</a>\f1
161.3723 -.IR URL#value
161.3724 -で定義されたとおりにリンクを追加します。
161.3725 -.I URL#value
161.3726 -は、相対 URL または絶対 URL です。
161.3727 -.B javadoc
161.3728 -ツールは、最初の文字として、小なり括弧 (\f3<\f1) を探すことで、
161.3729 -このリンクをその他の場合と区別します。
161.3730 -.LP
161.3731 -.RS
161.3732 -.ft 3
161.3733 -.nf
161.3734 - @see <a href="spec.html#section">Java Spec</a>
161.3735 -.fi
161.3736 -.ft 1
161.3737 -.LP
161.3738 -これは次のようなリンクを生成します。
161.3739 -.LP
161.3740 -.ft 3
161.3741 -.nf
161.3742 - 関連項目:
161.3743 - Java Spec
161.3744 -.fi
161.3745 -.ft 1
161.3746 -.RE
161.3747 -.TP
161.3748 -.BI @see " package.class#member label"
161.3749 -参照される Java 言語で指定された名前のドキュメントを指す、
161.3750 -表示テキスト label を持つ
161.3751 -リンクを追加します。label は省略可能です。label を省略した場合は、
161.3752 -該当する名前が
161.3753 -適切に短くされて (「名前の表示方法」を参照)、
161.3754 -表示テキストとして代わりに表示されます。-noqualifier を使用すると、表示テキストからパッケージ名が全体的に削除されます。ラベルは、自動生成される表示テキストとは異なる表示テキストを指定する場合に使います。
161.3755 -.LP
161.3756 -.RS
161.3757 -バージョン 1.2 では、ラベルではなく、名前だけが
161.3758 -HTML タグ
161.3759 -.B <code>
161.3760 -に囲まれて自動的に表示されます。バージョン 1.2.2 以降は、
161.3761 -.B <code>
161.3762 -は常に、ラベルが使用されているかどうかにかかわらず、
161.3763 -表示可能なテキストを囲みます。
161.3764 -.TP 2
161.3765 -\(bu
161.3766 -.I package.class#member
161.3767 -には、Java 言語で有効な任意の名前、つまりパッケージ、
161.3768 -クラス、インタフェース、
161.3769 -コンストラクタ、メソッド、またはフィールドの名前を指定します
161.3770 -。ただし、メンバ名の前の
161.3771 -ドットは、ハッシュ文字 (#) で置き換えます。
161.3772 -指定した名前が、ドキュメント化されるクラス
161.3773 -にある場合、
161.3774 -.B javadoc
161.3775 -ツールは該当する名前へのリンクを自動的に作成します。
161.3776 -外部参照クラスへのリンクを作成する
161.3777 -には、
161.3778 -.B \-link
161.3779 -オプションを使います。参照されるクラスに属していない名前の
161.3780 -ドキュメントを参
161.3781 -照するには、ほかの 2 つの形式の
161.3782 -.B @see
161.3783 -タグを使います。1 番目の引数については、「名前の指定」 で
161.3784 -詳しく説明します。
161.3785 -.TP 2
161.3786 -\(bu
161.3787 -.I label
161.3788 -は省略可能なテキストで、
161.3789 -リンクのラベルとして表示されます。label には空白を含
161.3790 -めることができます。label を省略した場合は、
161.3791 -.I package.class.member
161.3792 -が、現在のクラスおよびパッケージに応じて
161.3793 -適切に短くされて表示されます。「名前の表示方法」を参照してください。
161.3794 -.TP 2
161.3795 -\(bu
161.3796 -空白文字は
161.3797 -.I package.class#member
161.3798 -と
161.3799 -.IR label
161.3800 -の間の区切り文字です。括弧内の空白文字は、
161.3801 -ラベルの開始を意味しないため、
161.3802 -メソッドのパラメータ間のデリミタとして使うことができます。
161.3803 -.LP
161.3804 -例-この例では、Character クラスの
161.3805 -.B @see
161.3806 -タグが String クラスの equals メソッドを参照しています。
161.3807 -タグには、名前 \f3String#equals(Object)\f1 とラベル \f3equals\f1 の
161.3808 -両方の引数が含まれています。
161.3809 -.LP
161.3810 -.ft 3
161.3811 -.nf
161.3812 - /**
161.3813 - * @see String#equals(Object) equals
161.3814 - */
161.3815 -.fi
161.3816 -.ft 1
161.3817 -.LP
161.3818 -標準ドックレットは、次のような HTML を生成します。
161.3819 -.LP
161.3820 -.ft 3
161.3821 -.nf
161.3822 - <dl>
161.3823 - <dt><b>関連項目:</b>
161.3824 - <dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals</code></a>
161.3825 - </dl>
161.3826 -.fi
161.3827 -.ft 1
161.3828 -.LP
161.3829 -これは、ブラウザでは次のように表示され、
161.3830 -ラベルがリンクテキストになります。
161.3831 -.LP
161.3832 -.ft 3
161.3833 -.nf
161.3834 - 関連項目:
161.3835 - equals
161.3836 -.fi
161.3837 -.ft 1
161.3838 -.LP
161.3839 -.B 名前の指定:
161.3840 -この
161.3841 -.I package.class#member
161.3842 -の名前は、
161.3843 -.BR java.lang.String#toUpperCase()
161.3844 -のように完全指定することも、
161.3845 -.B String#toUpperCase()
161.3846 -や
161.3847 -.BR #toUpperCase()
161.3848 -などのように完全指定しないことも可能です。
161.3849 -完全指定しない場合、
161.3850 -.B javadoc
161.3851 -ツールは、通常の Java コンパイラの検索順序で検索を行います。
161.3852 -詳細は、以下の「
161.3853 -.BR @see
161.3854 -の検索順序」を参照してください。指定する名前では、
161.3855 -メソッドの複数の引数の型の間など、
161.3856 -括弧内に空白を含めることができます。
161.3857 -.LP
161.3858 -短い部分修飾名を指定することの利点は、入力する
161.3859 -文字数が減ることと、ソースコードが
161.3860 -読みやすくなることです。以下の表に示すのは、さまざまな
161.3861 -形式の名前です。Class には
161.3862 -クラスかインタフェース、Type にはクラス、インタフェース、
161.3863 -配列、または基本データ型、
161.3864 -method にはメソッドまたはコンストラクタを指定できます。
161.3865 -.LP
161.3866 -.LP
161.3867 -.TS
161.3868 -box;
161.3869 -lp-1.
161.3870 -@see package.class#member の一般的な形式
161.3871 -_
161.3872 -現在のクラスのメンバを参照する
161.3873 -@see #field
161.3874 -@see #method(Type, Type,...)
161.3875 -@see #method(Type argname, Type argname,...)
161.3876 -@see #constructor(Type, Type,...)
161.3877 -@see #constructor(Type argname, Type argname,...)
161.3878 -_
161.3879 -T{
161.3880 -現在の、またはインポートされたパッケージの別のクラスを参照する
161.3881 -T}
161.3882 -@see Class#field
161.3883 -@see Class#method(Type, Type,...)
161.3884 -@see Class#method(Type argname, Type argname,...)
161.3885 -@see Class#constructor(Type, Type,...)
161.3886 -T{
161.3887 -@see Class#constructor(Type argname, Type argname,...)
161.3888 -T}
161.3889 -@see Class.NestedClass
161.3890 -@see Class
161.3891 -_
161.3892 -別のパッケージの要素を参照する (完全修飾)
161.3893 -@see package.Class#field
161.3894 -@see package.Class#method(Type, Type,...)
161.3895 -@see package.Class#method(Type argname, Type argname,...)
161.3896 -@see package.Class#constructor(Type, Type,...)
161.3897 -T{
161.3898 -@see package.Class#constructor(Type argname, Type argname,...)
161.3899 -T}
161.3900 -@see package.Class.NestedClass
161.3901 -@see package.Class
161.3902 -@see package
161.3903 -.TE
161.3904 -.LP
161.3905 -上の表に対する注を以下に示します。
161.3906 -.LP
161.3907 -.TP 2
161.3908 -\(bu
161.3909 -クラスまたはパッケージを省いた最初の形式のセットでは、
161.3910 -.B javadoc
161.3911 -ツールは現在のクラス階層だけで検索を行います。
161.3912 -.B javadoc
161.3913 -ツールは、現在のクラスかインタフェースのメンバ、スーパークラスか
161.3914 -スーパーインタフェースの 1 つ、または
161.3915 -親クラスかインタフェースの 1 つ (検索手順 1 〜 3) を検索します。
161.3916 -現在のパッケージのほかの部分やほかのパッケージ (検索手順 4 〜 5) は
161.3917 -検索しません。
161.3918 -.TP 2
161.3919 -\(bu
161.3920 -メソッドまたはコンストラクタが、getValue のように
161.3921 -括弧を付けずに名前として入力され、
161.3922 -かつ同じ名前のフィールドがない場合は、
161.3923 -.B javadoc
161.3924 -ツールは正確にリンクを作成しますが、括弧と引数を追加するように
161.3925 -促す警告メッセージを出力
161.3926 -します。このメソッドをオーバーロードした場合、
161.3927 -.B javadoc
161.3928 -ツールは、指定されたメソッドではなく、検索で見つかった
161.3929 -最初のメソッドにリンクします。
161.3930 -.TP 2
161.3931 -\(bu
161.3932 -入れ子の内部クラスは、どの形式の場合でも、単に
161.3933 -.BR inner
161.3934 -という形ではなく、
161.3935 -.BR outer.inner
161.3936 -という形で指定しなければなりません。
161.3937 -.TP 2
161.3938 -\(bu
161.3939 -すでに述べたとおり、クラスとメンバを区切るのに、ドット (\f3.\f1) ではなく
161.3940 -ハッシュ文字 (\f3#\f1) が
161.3941 -使われていることに注意してください。ドットは、クラス、
161.3942 -入れ子のクラス、パッケージ、および
161.3943 -サブパッケージを区切るのにも使われます。
161.3944 -ただし、
161.3945 -.B javadoc
161.3946 -ツールでは一般に許容範囲が広く、
161.3947 -あいまいさがなければ、ドットでも正しく解析されます。
161.3948 -その場合でも警告は表示されます。
161.3949 -
161.3950 -.LP
161.3951 -.B @see の検索順序:
161.3952 -.B javadoc
161.3953 -は、ソースファイル (\f3.java\f1)、パッケージ
161.3954 -ファイル (\f3package.html\f1 か \f3package\-info.java\f1)、または
161.3955 -概要ファイル (\f3overview.html\f1) 内で使われる
161.3956 -.B @see
161.3957 -タグを処理します。
161.3958 -あとの 2 つのファイルでは、
161.3959 -.BR @see
161.3960 -を使って指定する名前を完全修飾する必要があります。
161.3961 -ソースファイルでは、完全修飾名
161.3962 -と部分修飾名のどちらを指定することもできます。
161.3963 -.LP
161.3964 -.B javadoc
161.3965 -ツールが、完全修飾されていない
161.3966 -.B .java
161.3967 -ファイルで
161.3968 -.B @see
161.3969 -タグを見つけた場合、指定された名前を Java コンパイラと
161.3970 -同じ順序で検索します。ただし、
161.3971 -.B javadoc
161.3972 -ツールは、一部の名前空間のあいまいさは検出しません。これは、
161.3973 -.B javadoc
161.3974 -ツールが、ソースコードにこれらのエラーが存在していないことを
161.3975 -前提として動作するためです。
161.3976 -検索順序は、「Java Language Specification」第 2 版の第 6 章「Names」で
161.3977 -正式に定義されています。具体的には、検索は次の順序で行われます。
161.3978 -.LP
161.3979 -.TP 4
161.3980 -1.
161.3981 -現在のクラスまたはインタフェース
161.3982 -.PD 0
161.3983 -.TP 4
161.3984 -2.
161.3985 -名前を囲むクラスとインタフェース。もっとも近いものを最初に検索
161.3986 -.TP 4
161.3987 -3.
161.3988 -スーパークラスとスーパーインタフェース。もっとも近いものを最初に検索
161.3989 -.TP 4
161.3990 -4.
161.3991 -現在のパッケージ
161.3992 -.TP 4
161.3993 -5.
161.3994 -インポートされるパッケージ、クラス、
161.3995 -およびインタフェース。import 文の順序に従って検索
161.3996 -.PD
161.3997 -.LP
161.3998 -.B javadoc
161.3999 -ツールは、一致する名前が見つかるまで、各クラスについて
161.4000 -手順 1 〜 3 を繰り返して検索を続け
161.4001 -ます。つまり、現在のクラスとそのクラスを囲む
161.4002 -クラス E を検索したあと、E のスーパクラスを
161.4003 -検索し、最後に E を囲むクラスを検索します。手順 4 と 5 では、
161.4004 -.B javadoc
161.4005 -ツールは、1 つのパッケージ内でのクラスまたはインタフェースの検索を、
161.4006 -なんらかの決まった順
161.4007 -序で行うわけではありません (この検索順序はコンパイラに依存します)。
161.4008 -手順 5 では、
161.4009 -.B javadoc
161.4010 -ツールは、
161.4011 -.BR java.lang
161.4012 -を検索します。これは、
161.4013 -.BR java.lang
161.4014 -がすべてのプログラムによって自動的にインポートされるためです。
161.4015 -.LP
161.4016 -.B javadoc
161.4017 -ツールは、必ずしもサブクラスを検索するわけではなく、Javadoc ツールの
161.4018 -実行中にほかのパッケージ
161.4019 -のドキュメントが生成される場合でも、ほかのパッケージの
161.4020 -検索は行いません。
161.4021 -たとえば、
161.4022 -.B @see
161.4023 -タグが
161.4024 -.B java.awt.event.KeyEvent
161.4025 -クラスにあって、
161.4026 -.B java.awt
161.4027 -パッケージにある名前を参照する場合、
161.4028 -.B javadoc
161.4029 -は、そのクラスがインポートしない限りそのパッケージを検索しません。
161.4030 -.LP
161.4031 -.B 名前の表示方法:
161.4032 -.I label
161.4033 -が省略された場合は、
161.4034 -.I package.class.member
161.4035 -が表示されます。通常、package.class.member は、現在の
161.4036 -クラスおよびパッケージに
161.4037 -応じて適切に短くされます。「短くされる」とは、
161.4038 -.B javadoc
161.4039 -ツールが必要最小限の名前を表示するということです。
161.4040 -たとえば、String.toUpperCase() メソッドが同じ
161.4041 -クラスのメンバへの参照と、別のクラスのメンバへの
161.4042 -参照を含んでいる場合、クラス名は後者の場合だけ表示されます。
161.4043 -.LP
161.4044 -パッケージ名を広域的に削除するには、\-noqualifier を使用します。
161.4045 -.br
161.4046 -.LP
161.4047 -.TP 4
161.4048 -.TS
161.4049 -box, center;
161.4050 -cbp-1 | cbp-1 | cbp-1
161.4051 -l | l | l .
161.4052 -参照の種類 T{
161.4053 -String.toUppercase() での例
161.4054 -T} 表示
161.4055 -_
161.4056 -T{
161.4057 -@see タグが同じクラス、同じパッケージのメンバを参照している
161.4058 -T} T{
161.4059 -@see String#toLowerCase()
161.4060 -T} T{
161.4061 -toLowerCase() (パッケージおよびクラス名は省略)
161.4062 -T}
161.4063 -_
161.4064 -T{
161.4065 -@see タグが異なるクラス、同じパッケージのメンバを参照している
161.4066 -T} T{
161.4067 -@see Character#toLowerCase(char)
161.4068 -T} T{
161.4069 -Character.toLowerCase(char) (パッケージ名は省略し、クラス名を含む)
161.4070 -T}
161.4071 -_
161.4072 -T{
161.4073 -@see タグが異なるクラス、異なるパッケージのメンバを参照している
161.4074 -T} T{
161.4075 -@see java.io.File#exists()
161.4076 -T} T{
161.4077 -java.io.File.exists() (パッケージ名とクラス名を含む)
161.4078 -T}
161.4079 -.TE
161.4080 -.LP
161.4081 -\f3@see の例\fP
161.4082 -.br
161.4083 -右側のコメントは、\f2@see\fP タグが別のパッケージ (\f2java.applet.Applet\fP など) のクラス内にある場合に、名前がどのように表示されるかを示しています。
161.4084 +\f2string\fP 鴻潟菴遵障潟障\f2string\fP 悟障 URL с≪祉鴻с宴усJavadoc 若絖篋綣膃 (\f2"\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
161.4085 .nf
161.4086 \f3
161.4087 .fl
161.4088 - See also:
161.4089 -.fl
161.4090 -@see java.lang.String // String \fP\f3
161.4091 -.fl
161.4092 -@see java.lang.String The String class // The String class \fP\f3
161.4093 -.fl
161.4094 -@see String // String \fP\f3
161.4095 -.fl
161.4096 -@see String#equals(Object) // String.equals(Object) \fP\f3
161.4097 -.fl
161.4098 -@see String#equals // String.equals(java.lang.Object) \fP\f3
161.4099 -.fl
161.4100 -@see java.lang.Object#wait(long) // java.lang.Object.wait(long) \fP\f3
161.4101 -.fl
161.4102 -@see Character#MAX_RADIX // Character.MAX_RADIX \fP\f3
161.4103 -.fl
161.4104 -@see <a href="spec.html">Java Spec</a> // Java Spec \fP\f3
161.4105 -.fl
161.4106 -@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
161.4107 + @see "The Java Programming Language"
161.4108 +.fl
161.4109 +
161.4110 .fl
161.4111 \fP
161.4112 .fi
161.4113 -.I @see
161.4114 -を、ドキュメント化の対象にしていないクラスにまで拡張するには、
161.4115 -.I -link
161.4116 -オプションを使用します。
161.4117 -.LP
161.4118 -詳細については、
161.4119 -.fi
161.4120 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@see
161.4121 -の
161.4122 -.na
161.4123 -\f2@see タグのドキュメント\fPを参照してください。
161.4124 +.LP
161.4125 +罨<鴻障
161.4126 +.RE
161.4127 +.RS 3
161.4128 +.RS 3
161.4129 +
161.4130 +.LP
161.4131 +.RS 3
161.4132 +.TP 3
161.4133 +∫i:
161.4134 +The Java Programming Language
161.4135 +.RE
161.4136 +
161.4137 +.LP
161.4138 +.RE
161.4139 .RE
161.4140 .TP 3
161.4141 -.BI @serial " field-description" | include | exclude
161.4142 -デフォルトの直列化可能フィールドの doc コメントで使用します。
161.4143 -.RS
161.4144 -.LP
161.4145 -省略可能な field-description は、
161.4146 -フィールドの doc コメントを拡張します。
161.4147 -この説明では、フィールドの意味および
161.4148 -取り得る値のリストを指定しなければなりません。
161.4149 -必要な場合には、複数の行にまたがって説明を記述することができます。
161.4150 -標準ドックレットは、この情報を、直列化された形式のページに追加します。
161.4151 -.LP
161.4152 -クラスを直列化したあとしばらくしてから直列化可能フィールドをクラスに追加した場合、主説明に、追加したバージョンを識別する文を追加する必要があります。
161.4153 -.LP
161.4154 -.BR include
161.4155 -と
161.4156 -.BR exclude
161.4157 -引数は、直列化された形式のページにクラスまたはパッケージを含めるべきか、
161.4158 -あるいはこれらの引数を除くべきかを指定します。
161.4159 -これらは、次のように動作します。
161.4160 -.LP
161.4161 -.TP 2
161.4162 -\(bu
161.4163 -.BR Serializable
161.4164 -を実装する public クラスまたは protected クラスは、
161.4165 -そのクラス (またはそのパッケージ) が
161.4166 -.BR @serial
161.4167 -.BR exclude
161.4168 -とマークされていない限り含められます。
161.4169 -.TP 2
161.4170 -\(bu
161.4171 -.BR Serializable
161.4172 -を実装する private クラスまたは package\-private クラスは、
161.4173 -そのクラス (またはそのパッケージ) が
161.4174 -.BR @serial
161.4175 -.BR include
161.4176 -とマークされていない限り除かれます。
161.4177 -.LP
161.4178 -例:
161.4179 -.BR javax.swing
161.4180 -パッケージは、(package.html または \f2package\-info.java\fP 内で)
161.4181 -.BR @serial
161.4182 -.BR exclude
161.4183 -とマークされます。
161.4184 -public クラスである
161.4185 -.BR java.sercurity.BasicPermission
161.4186 -は、
161.4187 -.BR @serial
161.4188 -.BR exclude
161.4189 -とマークされます。package\-private クラスである
161.4190 -.BR java.util.PropertyPermissionCollection
161.4191 -は、
161.4192 -.BR @serial
161.4193 -.BR include
161.4194 -とマークされます。
161.4195 -.LP
161.4196 -クラスレベルのタグ
161.4197 -.BR @serial
161.4198 -は、パッケージレベルの
161.4199 -.BR @serial
161.4200 -をオーバーライドします。
161.4201 -.LP
161.4202 -これらのタグの使用法についての詳細と使用例は、「Java オブジェクト直列化仕様」の第 1.6 節「クラスの直列化可能なフィールドおよびデータの文書化」を参照してください。また、
161.4203 -.fi
161.4204 -http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missing
161.4205 -の
161.4206 -.na
161.4207 -「\f2直列化の FAQ\fP」も参照してください。この FAQ には、「\-private スイッチを指定しないで javadoc を実行しているのに private フィールドの @serial タグが見つからないという javadoc の警告が表示される」などの一般的な質問への回答が記載されています。直列化形式仕様にクラスを含める場合には、
161.4208 -.fi
161.4209 -http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.html
161.4210 -の
161.4211 -.na
161.4212 -「\f2Sun の仕様\fP」も参照してください。
161.4213 -.LP
161.4214 -.RE
161.4215 -.TP
161.4216 -.BI @serialField " field-name field-type field-description"
161.4217 -Serializable クラスの serialPersistentFields メンバの ObjectStreamField コンポーネント
161.4218 -をドキュメント化します。各 ObjectStreamField コンポーネントに対して
161.4219 -.B @serialField
161.4220 -タグを 1 つ使う必要があります。
161.4221 -.TP
161.4222 -.BI @serialData " data-description"
161.4223 -.I data-description
161.4224 -は、直列化された形式でのデータの型と順序を
161.4225 -説明するテキストです。 このデータには、
161.4226 -特に、writeObject メソッドによって書き込まれる省略可能な
161.4227 -データ、および Externalizable.writeExternal メソッドによって
161.4228 -書き込まれるすべてのデータ (基底クラスを含む) が含まれます。
161.4229 -.TP
161.4230 -.B @serialData
161.4231 -タグは、writeObject、readObject、writeExternal、および readExternal の各メソッドの
161.4232 -doc コメントで使用できます。
161.4233 -.LP
161.4234 -.TP 3
161.4235 -@since\ since\-text
161.4236 -生成ドキュメントに「導入されたバージョン」見出しを追加し、指定された \f2since\-text\fP を書き込みます。このテキストには、特別な内部構造はありません。このタグは、すべてのドキュメンテーションコメント、つまり概要、パッケージ、クラス、インタフェース、コンストラクタ、メソッド、およびフィールドで有効です。このタグは、特定の変更または機能が、\f2since\-text\fP に示されたソフトウェアリリース以降、存在していることを意味します。次に例を示します。
161.4237 +@see <a href="URL#value">label</a>
161.4238 +\f2URL\fP#\f2value\fP у臂潟菴遵障\f2URL\fP#\f2value\fP 後 URL 障腟九 URL сJavadoc 若絖絨荐 (\f2<\fP) 茯帥鴻綵√祉 2 ゃ綵√阪ャ障箴腓冴障
161.4239 .nf
161.4240 \f3
161.4241 .fl
161.4242 - @since 1.5
161.4243 + @see <a href="spec.html#section">Java Spec</a>
161.4244 +.fl
161.4245 +
161.4246 .fl
161.4247 \fP
161.4248 .fi
161.4249 -Java プラットフォームのソースコードの場合、このタグは、Java プラットフォーム API 仕様のバージョンを示します。その変更や機能がリファレンス実装に追加された時期を示すとは限りません。複数の @since タグを使用でき、複数の @author タグのように扱われます。プログラム要素が複数の API で使用される場合、複数のタグを使用できます。
161.4250 +.LP
161.4251 +罨<潟障
161.4252 +.RS 3
161.4253 +.RS 3
161.4254 +.TP 3
161.4255 +∫i:
161.4256 +Java Spec
161.4257 .RE
161.4258 -.TP
161.4259 -.BI @throws " class-name description"
161.4260 -.B @throws
161.4261 -タグと
161.4262 -.B @exception
161.4263 -タグは同義です。生成されるドキュメンテーションに、
161.4264 -.I class-name
161.4265 -および
161.4266 -.I description
161.4267 -テキストを持つ [例外] 小見出しを追加します。
161.4268 -.I class-name
161.4269 -は、該当するメソッドによって
161.4270 -スローされる可能性のある例外の名前です。このタグは、doc コメントまたはコンストラクタでのみ有効です。このクラスが完全
161.4271 -修飾されていない場合、
161.4272 -.B javadoc
161.4273 -ツールは検索順序に従ってクラスを探します。
161.4274 -同じまたは異なる例外の doc コメントで、
161.4275 -複数の @throws タグを使用できます。
161.4276 -.LP
161.4277 -すべてのチェック済み例外がドキュメント化されるようにするために、
161.4278 -@throws タグが throws 節内の例外用に存在しない場合は、
161.4279 -@throws タグのあるドキュメントであるかのように、
161.4280 -.B Javadoc
161.4281 -ツールによって例外が HTML 出力に説明なしで
161.4282 -自動的に追加されます。
161.4283 -.LP
161.4284 -オーバーライドされたメソッドで明示的に例外が宣言されている場合に限って、
161.4285 -オーバーライドされたメソッドからサブクラスへ
161.4286 -@throws ドキュメントがコピーされます。
161.4287 -インタフェースメソッドから実装メソッドにコピーされる場合も
161.4288 -同様です。{@inheritDoc} を使用して、継承ドキュメントに対して
161.4289 -強制的に @throws を適用することも可能です。
161.4290 -.LP
161.4291 -詳細は
161.4292 -.fi
161.4293 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exception
161.4294 -の
161.4295 -.na
161.4296 -\f2@throws タグのドキュメント\fPを参照してください。
161.4297 -.TP
161.4298 -.B {@value package.class#field}
161.4299 -{@value} が静的フィールドの doc コメントで
161.4300 -引数なしで使用されている場合、その定数の値が表示されます。
161.4301 -.LP
161.4302 -.RS 5
161.4303 -.nf
161.4304 -/**
161.4305 -* The value of this constant is {@value}.
161.4306 -*/
161.4307 -public static final String SCRIPT_START = "<script>"
161.4308 -.fi
161.4309 .RE
161.4310 -.LP
161.4311 -任意の doc コメント内で引数
161.4312 -.B package.class#field
161.4313 - ありで使用されている場合は、指定した定数の値が表示されます。
161.4314 -.LP
161.4315 -.RS 5
161.4316 -.nf
161.4317 -/**
161.4318 -* Evaluates the script starting with {@value #SCRIPT_START}.
161.4319 -*/
161.4320 -public String evalScript(String script) {
161.4321 -}
161.4322 -.fi
161.4323 .RE
161.4324 -.LP
161.4325 -引数 package.class#field は、@see 引数と同一の形式になります。
161.4326 -ただし、メンバが静的フィールドになければならない点が異なります。
161.4327 -.LP
161.4328 -これらの定数での値は、「定数フィールド値」ページにも表示されます。
161.4329 -.TP
161.4330 -.BI @version " version-text"
161.4331 -\-version オプションが使われている場合、生成ドキュメントに「バージョン」小見出しを追加して、指定された \f2version\-text\fP を書き込みます。このタグは、このコードが含まれるソフトウェアの現在のバージョン番号を保持するように意図されています。これに対し、@since は、このコードが導入されたバージョン番号を保持します。\f2version\-text\fP には、特別な内部構造はありません。バージョンタグを使用できる場所を調べるには、「タグを使用できる場所」を参照してください。
161.4332 -.LP
161.4333 -1 つのドキュメンテーションコメントに複数の \f2@version\fP タグを含めることができます。必要に応じて、\f2@version\fP タグごとに 1 つのバージョン番号を指定することも、タグごとに複数のバージョン番号を指定することもできます。前者の場合は、Javadoc ツールによって、名前と名前の間にコンマ (\f2,\fP) とスペースが挿入されます。後者の場合は、テキスト全体が、解析されることなく、生成ドキュメントにそのままコピーされます。したがって、コンマではなく、各言語に対応した名前区切り文字を使う必要がある場合は、1 つのタグに複数の名前を指定できます。
161.4334 -.LP
161.4335 -詳細については、
161.4336 -.fi
161.4337 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@version
161.4338 -の
161.4339 -.na
161.4340 -\f2@version タグのドキュメント\fPを参照してください。
161.4341 -.SS "タグを使用できる場所"
161.4342 -以下では、タグを使用できる場所について説明します。@see、@since、@deprecated、{@link}、{@linkplain} および {@docroot} のタグは、すべての doc コメントで使用できます。
161.4343 -.SS "概要ドキュメントタグ"
161.4344 -概要タグは、概要ページのドキュメント
161.4345 -コメント (通常は \f3overview.html\f1
161.4346 -という名前のソースファイル内にある) で使用できるタグです。
161.4347 -ほかのドキュメント
161.4348 -コメントと同様に、これらのタグは、説明のあとで使う必要があります。
161.4349 -.LP
161.4350 -注:バージョン 1.2 では、概要ドキュメント内の {\f3@link\f1} タグに
161.4351 -バグがあります。テキストは適切に表示されますが、
161.4352 -リンクが設定されません。
161.4353 -現在のところ、{\f2@docRoot\f1} タグは、
161.4354 -概要ドキュメント内では動作しません。
161.4355 -.LP
161.4356 -.LP
161.4357 -.TS
161.4358 -;
161.4359 -cbp-1
161.4360 -l .
161.4361 -概要タグ
161.4362 -@see
161.4363 -@since
161.4364 -@author
161.4365 -@version
161.4366 -{@link}
161.4367 -{@linkplain}
161.4368 -{@docRoot}
161.4369 -.TE
161.4370 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
161.4371 -
161.4372 -.LP
161.4373 -.SS "パッケージドキュメントタグ"
161.4374 -パッケージタグは、パッケージのドキュメント
161.4375 -コメント (\f3package.html\f1 または \f2package\-info.java\fP という
161.4376 -名前のソースファイルに存在) で使用できるタグです。
161.4377 -ここで使用できる @serial タグは、include または
161.4378 -exclude 引数を指定したものだけです。
161.4379 -.LP
161.4380 -.LP
161.4381 -.TS
161.4382 -;
161.4383 -cbp-1
161.4384 -l .
161.4385 -パッケージタグ
161.4386 -@see
161.4387 -@since
161.4388 -@serial
161.4389 -@author
161.4390 -@version
161.4391 -{@link}
161.4392 -{@linkplain}
161.4393 -{@docRoot}
161.4394 -.TE
161.4395 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
161.4396 -
161.4397 -.LP
161.4398 -.SS "クラスおよびインタフェースドキュメントタグ"
161.4399 -次に示すのは、クラスまたはインタフェースのドキュメント
161.4400 -コメントで使用できるタグです。
161.4401 -ここで使用できる @serial タグは、
161.4402 -include または exclude 引数を指定したものだけです。
161.4403 -.LP
161.4404 -.LP
161.4405 -.TS
161.4406 -;
161.4407 -cbp-1
161.4408 -l .
161.4409 -クラスおよびインタフェースタグ
161.4410 -@see
161.4411 -@since
161.4412 -@deprecated
161.4413 -@serial
161.4414 -@author
161.4415 -@version
161.4416 -{@link}
161.4417 -{@linkplain}
161.4418 -{@docRoot}
161.4419 -.TE
161.4420 -
161.4421 -.LP
161.4422 -次は、クラスコメントの例です。
161.4423 -.LP
161.4424 -.RS
161.4425 -.ft 3
161.4426 -.nf
161.4427 -/**
161.4428 -* A class representing a window on the screen.
161.4429 -* For example:
161.4430 -* <pre>
161.4431 -* Window win = new Window(parent);
161.4432 -* win.show();
161.4433 -* </pre>
161.4434 -*
161.4435 -* @author Sami Shaio
161.4436 -* @version 1.13, 06/08/06
161.4437 -* @see java.awt.BaseWindow
161.4438 -* @see java.awt.Button
161.4439 -*/
161.4440 -class Window extends BaseWindow {
161.4441 -...
161.4442 -}
161.4443 -.fi
161.4444 -.ft 1
161.4445 +.RS 3
161.4446 +
161.4447 +.LP
161.4448 +.LP
161.4449 +
161.4450 +.LP
161.4451 .RE
161.4452 -.SS "フィールドドキュメントタグ"
161.4453 -次に示すのは、フィールドのドキュメンテーションコメントで
161.4454 -使用できるタグです。
161.4455 -.LP
161.4456 -.LP
161.4457 -.TS
161.4458 -;
161.4459 -cbp-1
161.4460 -l .
161.4461 -フィールドタグ
161.4462 -@see
161.4463 -@since
161.4464 -@deprecated
161.4465 -@serial
161.4466 -@serialField
161.4467 -{@link}
161.4468 -{@linkplain}
161.4469 -{@docRoot}
161.4470 -{@value}
161.4471 -.TE
161.4472 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
161.4473 -
161.4474 -.LP
161.4475 -次は、フィールドコメントの例です。
161.4476 -.LP
161.4477 -.RS
161.4478 -.ft 3
161.4479 -.nf
161.4480 -/**
161.4481 -* The X-coordinate of the component.
161.4482 -*
161.4483 -* @see #getLocation()
161.4484 -*/
161.4485 -int x = 1263732;
161.4486 -.fi
161.4487 -.ft 1
161.4488 -.RE
161.4489 -.SS "コンストラクタおよびメソッドドキュメントタグ"
161.4490 -次に、コンストラクタまたはメソッドのドキュメンテーションコメント内で表示できるタグを示します。ただし、@return はコンストラクタでは表示できず、{@inheritDoc} は
161.4491 -表示に制限があります。@serialData タグは特定の直列化メソッドの doc コメントでのみ使用できます。
161.4492 -.LP
161.4493 -.LP
161.4494 -.TS
161.4495 -;
161.4496 -cbp-1
161.4497 -l .
161.4498 -メソッドおよびコンストラクタタグ
161.4499 -@see
161.4500 -@since
161.4501 -@deprecated
161.4502 -@param
161.4503 -@return
161.4504 -@throws and @exception
161.4505 -@serialData
161.4506 -{@link}
161.4507 -{@linkplain}
161.4508 -{@inheritDoc}
161.4509 -{@docRoot}
161.4510 -.TE
161.4511 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
161.4512 -
161.4513 -.LP
161.4514 -次はメソッドの doc コメントの例です。
161.4515 -.LP
161.4516 -.RS
161.4517 -.ft 3
161.4518 -.nf
161.4519 -/**
161.4520 -* Returns the character at the specified index. An index
161.4521 -* ranges from <code>0</code> to <code>length() - 1</code>.
161.4522 -*
161.4523 -* @param index the index of the desired character.
161.4524 -* @return the desired character.
161.4525 -* @exception StringIndexOutOfRangeException
161.4526 -* if the index is not in the range <code>0</code>
161.4527 -* to <code>length()-1</code>.
161.4528 -* @see java.lang.Character#charValue()
161.4529 -*/
161.4530 -public char charAt(int index) {
161.4531 -...
161.4532 -}
161.4533 -.fi
161.4534 -.ft 1
161.4535 -.RE
161.4536 -.SH "オプション"
161.4537 -.B javadoc
161.4538 -ツールは、ドックレットを使って出力を決定します。
161.4539 -.B javadoc
161.4540 -ツールは、
161.4541 -.B \-doclet
161.4542 -オプションでカスタムドックレットが指定されている場合以外は、
161.4543 -デフォルトの標準ドック
161.4544 -レットを使います。
161.4545 -.B javadoc
161.4546 -ツールには、任意のドックレットとともに使用できるコマンド行
161.4547 -オプションがあります。これらのオプ
161.4548 -ションについては、後述の「javadoc のオプション」で説明します。
161.4549 -標準ドックレットでは、こ
161.4550 -のほかに、いくつかの追加のコマンド行オプションが提供されます。
161.4551 -これらのオプションに
161.4552 -ついては、後述の「標準ドックレットが提供するオプション」で
161.4553 -説明します。どのオプション
161.4554 -名も大文字と小文字を区別しません。ただし、オプションの引数では
161.4555 -大文字と小文字が区
161.4556 -別されることがあります。
161.4557 -.LP
161.4558 -オプションを以下に示します。
161.4559 -.LP
161.4560 .RS 3
161.4561 -
161.4562 -.LP
161.4563 -.LP
161.4564 -.TS
161.4565 -center;
161.4566 -li l li
161.4567 -l li li
161.4568 -li l li
161.4569 -l li li
161.4570 -li l l
161.4571 -l l li
161.4572 -li l li
161.4573 -l l l
161.4574 -l li l
161.4575 -l l li
161.4576 -li l l
161.4577 -li l l
161.4578 -l l l
161.4579 -li l l
161.4580 -li l l
161.4581 -l l li
161.4582 -li l l
161.4583 -l l l
161.4584 -l l l
161.4585 -l li l
161.4586 -l li l.
161.4587 --1.1 -header -private
161.4588 --author -help -protected
161.4589 --bootclasspath -helpfile -public
161.4590 --bottom -J -quiet
161.4591 --breakiterator -keywords -serialwarn
161.4592 --charset -link -source
161.4593 --classpath -linkoffline -sourcepath
161.4594 --d -linksource -splitindex
161.4595 --docencoding -locale -stylesheetfile
161.4596 --docfilessubdirs -nocomment -subpackages
161.4597 --doclet -nodeprecated -tag
161.4598 --docletpath -nodeprecatedlist -taglet
161.4599 --doctitle -nohelp -tagletpath
161.4600 --encoding -noindex -title
161.4601 --exclude -nonavbar -use
161.4602 --excludedocfilessubdir -noqualifier -verbose
161.4603 --extdirs -nosince -version
161.4604 --footer -notimestamp -windowtitle
161.4605 --group -notree
161.4606 - -overview
161.4607 - -package
161.4608 -.TE
161.4609 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
161.4610 -
161.4611 -.LP
161.4612 -.RE
161.4613 -.LP
161.4614 -\f2下線付き\fPで示されたオプションは、Javadoc の基本オプションであり、Javadoc ツールのフロントエンドによって提供され、すべてのドックレットで使用できます。標準ドックレット自体は、下線付きでないオプションを提供します。
161.4615 -.LP
161.4616 -.SS "Javadoc のオプション"
161.4617 -.TP
161.4618 -.BI \-overview " path/filename"
161.4619 -.B javadoc
161.4620 -に対して、
161.4621 -.I path/filename
161.4622 -で指定された「ソース」ファイルから
161.4623 -概要ドキュメント用のテキスト
161.4624 -を取得し、概要ページ (\f3overview-summary.html\f1) に配置することを
161.4625 -指示します。
161.4626 -.I path/filename
161.4627 -は、
161.4628 -.BR \-sourcepath
161.4629 -への相対パスです。
161.4630 -.LP
161.4631 -.RS
161.4632 -.I filename
161.4633 -と
161.4634 -.IR path
161.4635 -には、それぞれ任意の名前と場所を指定できますが、通常は、
161.4636 -.B overview.html
161.4637 -という名前を付けて、ソースツリー内の最上位の
161.4638 -パッケージディレクトリを含むディレクトリ
161.4639 -に配置します。この場所では、
161.4640 -.B \-sourcepath
161.4641 -がこのファイルを指すので、パッケージを
161.4642 -ドキュメント化する際に path が必要ありません。
161.4643 -たとえば、java.lang パッケージのソースツリーが
161.4644 -.BR /src/classes/java/lang/
161.4645 -の場合、概要ファイルを
161.4646 -.BR /src/classes/overview.html
161.4647 -に配置できます。「使用例」を参照してください。
161.4648 -.LP
161.4649 -.IR path/filename
161.4650 -で指定するファイルについては、
161.4651 -「概要コメントファイル」を参照してください。
161.4652 -.LP
161.4653 -概要ページが作成されるのは、
161.4654 -.B javadoc
161.4655 -に 2 つ以上のパッケージ名を渡した場合だけです。
161.4656 -詳細は、「HTML フレーム」
161.4657 -節を参照してください。
161.4658 -.LP
161.4659 -概要ページのタイトルは、
161.4660 -.B \-doctitle
161.4661 -によって設定されます。
161.4662 -.RE
161.4663 -.TP
161.4664 -.B \-public
161.4665 -public なクラスとメンバだけを表示します。
161.4666 -.TP
161.4667 -.B \-protected
161.4668 -protected および public なクラスとメンバだけを表示します。
161.4669 -これはデフォルトの動作です。
161.4670 -.TP
161.4671 -.B \-package
161.4672 -パッケージ、および protected と public な
161.4673 -クラスとメンバだけを表示します。
161.4674 -.TP
161.4675 -.B \-private
161.4676 -すべてのクラスとメンバを表示します。
161.4677 -.TP
161.4678 -.B \-help
161.4679 -オンラインヘルプを表示します。
161.4680 -.B javadoc
161.4681 -とドックレットのコマンド行オプションの一覧が表示されます。
161.4682 -.TP
161.4683 -.BI \-doclet " class"
161.4684 -ドキュメントの生成に使う
161.4685 -ドックレットを起動するためのクラスファイルを指定します。
161.4686 -完全指定の名前を指定してください。
161.4687 -ドックレットでは、出力の内容と形式を定義します。
161.4688 -.B \-doclet
161.4689 -オプションが使われていない場合、
161.4690 -.B javadoc
161.4691 -は標準ドックレットを使ってデフォルトの HTML 形式を生成します。
161.4692 -このクラスには、
161.4693 -start(Root) メソッドが含まれていなければなりません。
161.4694 -この起動クラスへのパスは、
161.4695 -.B \-docletpath
161.4696 -オプションによって定義されます。
161.4697 -.LP
161.4698 -たとえば、MIF ドックレットを呼び出すには、次のように指定します。
161.4699 -.LP
161.4700 -.RS
161.4701 -.ft 3
161.4702 -.nf
161.4703 - -doclet com.sun.tools.doclets.mif.MIFDoclet
161.4704 -.fi
161.4705 -.ft 1
161.4706 -.LP
161.4707 -特定のドックレットを実行した完全な例については、
161.4708 -.fi
161.4709 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet
161.4710 -の
161.4711 -.na
161.4712 -「\f2Running the MIF Doclet\fP」を参照してください。
161.4713 -.RE
161.4714 -.TP
161.4715 -.BI \-docletpath " classpathlist"
161.4716 -.B \-doclet
161.4717 -オプションで指定されているドックレットクラスファイル、
161.4718 -およびそれに依存する jar ファイルへのパスを指定します。
161.4719 -起動クラスファイルが jar ファイル内にある場合、
161.4720 -例に従って、その jar ファイルへのパスを指定します。
161.4721 -絶対パス、または現在のディレクトリからの相対パスを指定できます。
161.4722 -.IR classpathlist
161.4723 -には、複数のパスまたは jar ファイルを含める
161.4724 -ことができます。その場合、各パスまたは jar ファイルを Solaris ではコロン (\f3:\f1)で、Windows ではセミコロン (;) で区切ります。
161.4725 -目的のドックレットの開始クラスがすでに検索パス内にある場合は、
161.4726 -このオプションは不要です。
161.4727 -.LP
161.4728 -次の例の jar ファイルへのパスには、ドックレットの
161.4729 -開始クラスファイルが含まれています。
161.4730 -jar ファイル名が含まれている点に注意してください。
161.4731 -.nf
161.4732 -\f3
161.4733 -.fl
161.4734 - \-docletpath /home/user/mifdoclet/lib/mifdoclet.jar
161.4735 -.fl
161.4736 -\fP
161.4737 -.fi
161.4738 -次はドックレットの開始クラスファイルのパスの例です。
161.4739 -クラスファイル名が省略されていることに注意してください。
161.4740 -.nf
161.4741 -\f3
161.4742 -.fl
161.4743 - \-docletpath /home/user/mifdoclet/classes/com/sun/tools/doclets/mif/
161.4744 -.fl
161.4745 -\fP
161.4746 -.fi
161.4747 -特定のドックレットを実行した完全な例については、
161.4748 -.fi
161.4749 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet
161.4750 -の
161.4751 -.na
161.4752 -「\f2Running the MIF Doclet\fP」を参照してください。
161.4753 -.RE
161.4754 -.LP
161.4755 -.TP
161.4756 -.B \-1.1
161.4757 -この機能は、javadoc 1.4 から削除されました。代替の機能は
161.4758 -存在しません。このオプションは、javadoc 1.1 で生成される
161.4759 -ドキュメントの外観と機能 (サポートされなくなった、入れ子になったクラスを
161.4760 -含む) を備えたドキュメントを作成するためのものでした。
161.4761 -このオプションが必要であれば、代わ
161.4762 -りに javadoc 1.2 または 1.3 を使用してください。
161.4763 .TP 3
161.4764 -\-source release
161.4765 -受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
161.4766 -.LP
161.4767 -.TS
161.4768 -;
161.4769 -l l.
161.4770 -1.5 T{
161.4771 -Javadoc は、JDK 1.5 で導入された総称機能および他の言語機能を含んだコードを受け付けます。-source フラグを指定しないと、コンパイラはデフォルトとして 1.5 の動作をします。
161.4772 -T}
161.4773 -1.4 T{
161.4774 -Javadoc は、JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
161.4775 -T}
161.4776 -1.3 T{
161.4777 -Javadoc は、JDK 1.3 以降に導入されたアサーション、総称機能、または他の言語機能をサポートしません。
161.4778 -T}
161.4779 -.TE
161.4780 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
161.4781 -.LP
161.4782 -javac でコードをコンパイルするときに使用した値に対応する \f2release\fP の値を使用します。
161.4783 -.LP
161.4784 -.TP
161.4785 -.BI \-sourcepath " sourcepathlist"
161.4786 -.B javadoc
161.4787 -コマンドにパッケージ名または \-subpackages
161.4788 -を渡す際に、
161.4789 -ソースファイル (.java) 検索用のパスを指定します。
161.4790 -.BI sourcepathlist
161.4791 -には、コロン (\f3:\f1)
161.4792 -で区切った複数のパスを含めることができます。
161.4793 -.B Javadoc
161.4794 -ツールは、指定されたパス以下のすべての
161.4795 -サブディレクトリを検索します。 このオプションを使って、
161.4796 -ドキュメント化されるソースファイルの位置だけでなく、
161.4797 -それ自体はドキュメント化されていないが、ドキュメント化
161.4798 -されているソースファイルから継承されたコメントをもつ
161.4799 -ソースファイルの位置も確認できます。
161.4800 -.LP
161.4801 -.B \-sourcepath
161.4802 -オプションは、
161.4803 -.B javadoc
161.4804 -コマンドを使ってパッケージ名を指定するときにだけ使用でき、
161.4805 -.B javadoc
161.4806 -コマンドに渡される
161.4807 -.B .java
161.4808 -ファイルは検索できないことに注意してください。
161.4809 -.B .java
161.4810 -ファイルを検索するには、
161.4811 -そのディレクトリに移動するか、
161.4812 -各ファイルの前にそのパスを付けます (「1 つ以上
161.4813 -のパッケージのドキュメント化」を参照)。
161.4814 -.B \-sourcepath
161.4815 -が省略された場合は、
161.4816 -.B javadoc
161.4817 -はクラスパスを使ってソースファイルを検索します (
161.4818 -.B \-classpath
161.4819 -を参照)。 したがって、
161.4820 -.B \-sourcepath
161.4821 -のデフォルトは
161.4822 -.B \-classpath
161.4823 -の値です。
161.4824 -.B -classpath
161.4825 -を省略してパッケージ名を
161.4826 -.BR javadoc
161.4827 -に渡した場合、
161.4828 -.BR javadoc
161.4829 -は、ソースファイルの現在のディレクトリ (およびサブディレクトリ) を
161.4830 -検索します。
161.4831 -.LP
161.4832 -.RS
161.4833 -.I sourcepathlist
161.4834 -では、ドキュメント化するパッケージ名の
161.4835 -ソースツリーのルートディレクトリを
161.4836 -設定します。たとえば、ソースファイルが次の
161.4837 -場所にある
161.4838 -.B com.mypackage
161.4839 -という名前のパッケージをドキュメント化するとします。
161.4840 -.LP
161.4841 -.RS
161.4842 -.ft 3
161.4843 -.nf
161.4844 -/home/user/src/com/mypackage/*.java
161.4845 -.fi
161.4846 -.ft 1
161.4847 -.RE
161.4848 -.LP
161.4849 -この場合、次のようにしてソースパスを
161.4850 -.BR /home/user/src
161.4851 -、つまり
161.4852 -.BR com.mypackage
161.4853 -を含むディレクトリに指定し、それからパッケージ名
161.4854 -.BR com.mypackage
161.4855 -を指定します。
161.4856 -.LP
161.4857 -.RS
161.4858 -.ft 3
161.4859 -.nf
161.4860 -% javadoc \-sourcepath /home/user/src/ com.mypackage
161.4861 -.fi
161.4862 -.ft 1
161.4863 -.RE
161.4864 -.LP
161.4865 -これは、ソースパスの値とパッケージ名をつなげて、
161.4866 -ドットをスラッシュ (/) に変えると、以下のパッケージのフルパス
161.4867 -になることに注目すると覚えやすいでしょう。
161.4868 -.LP
161.4869 -.RS
161.4870 -.ft 3
161.4871 -.BR /home/user/src/com/mypackage
161.4872 -.RE
161.4873 -.LP
161.4874 -2 つのソースパスを指定するには、次のようにします。
161.4875 -.LP
161.4876 -.RS
161.4877 -.ft 3
161.4878 -.nf
161.4879 -% javadoc \-sourcepath /home/user/src/:/home/user2/src com.mypackage
161.4880 -.fi
161.4881 -.ft 1
161.4882 -.RE
161.4883 -.LP
161.4884 -.RE
161.4885 -.TP
161.4886 -.BI \-classpath " classpathlist"
161.4887 -.B javadoc
161.4888 -が参照されるクラスの検索を行うパスを指定します。
161.4889 -参照されるクラス (\f3.class\f1) とは、
161.4890 -ドキュメント化されるクラスとそれらのクラスによって
161.4891 -参照される任意のクラスのことです。
161.4892 -.B javadoc
161.4893 -は、指定されたパス以下のすべてのサブディレクトリで
161.4894 -検索を行います。
161.4895 -.I classpathlist
161.4896 -には、パス間をコロン (\f3:\f1) で区切って複数のパスを
161.4897 -含めることができます。
161.4898 -.B javadoc
161.4899 -ツールは、指定されたパス以下の
161.4900 -すべてのサブディレクトリを検索します。
161.4901 -.IR classpathlist
161.4902 -の指定
161.4903 -については、クラスパスのドキュメントを参照してください。
161.4904 -.LP
161.4905 -.RS
161.4906 -.B \-sourcepath
161.4907 -を省略した場合は、
161.4908 -.B javadoc
161.4909 -ツールは、クラスファイル (下位互換用) とともに、
161.4910 -.B \-classpath
161.4911 -を使ってソースファイルを検索します。このため、
161.4912 -異なるパス内のソースファイルおよびクラスファイルを検索する場合は、
161.4913 -.B \-sourcepath
161.4914 -と
161.4915 -.BR \-classpath
161.4916 -の両方を使います。
161.4917 -.LP
161.4918 -たとえば、
161.4919 -.BR com.mypackage
161.4920 -をドキュメント化したい場合に、パッケージのクラスがディレクトリ
161.4921 -.BR /home/user/src/com/mypackage
161.4922 -にあり、このパッケージが
161.4923 -.BR /home/user/lib
161.4924 -内のライブラリを使う場合は、次のように指定します。
161.4925 -.LP
161.4926 -.RS
161.4927 -.ft 3
161.4928 -.nf
161.4929 -% javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage
161.4930 -.fi
161.4931 -.ft 1
161.4932 -.RE
161.4933 -.LP
161.4934 -ほかのツールと同様に、
161.4935 -.BR \-classpath
161.4936 -を指定しない場合は、CLASSPATH 環境変数が
161.4937 -設定されていれば、
161.4938 -.B javadoc
161.4939 -ツールはこの環境変数を使います。
161.4940 -どちらも設定されていない場合
161.4941 -は、
161.4942 -.B javadoc
161.4943 -ツールは現在のディレクトリでクラスを検索します。
161.4944 -.LP
161.4945 -.B javadoc
161.4946 -ツールが拡張機能クラスおよびブートストラップクラスと通信する際に、
161.4947 -.B -classpath
161.4948 -を使ってユーザクラスを検索する方法についての
161.4949 -詳細は、「クラスの検索方法」を
161.4950 -参照してください。
161.4951 -.LP
161.4952 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じであるとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
161.4953 -.br
161.4954 -.br
161.4955 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しなどの環境に対する問い合わせを行わない限り、展開されていないワイルドカードを Java プログラムが認識することはありません。
161.4956 -.LP
161.4957 -.TP 3
161.4958 -\-subpackages\ \ package1:package2:...
161.4959 -ソースファイルから指定されたパッケージおよびそのサブパッケージ内に再帰的にドキュメントを生成します。このオプションは、ソースコードに新しいサブパッケージを追加する際に便利です。新しいサブパッケージは自動的に組み込まれます。各 package 引数は、任意の最上位サブパッケージ (java など) または完全指定のパッケージ (javax.swing など) になります。ソースファイルを含める必要はありません。引数は、コロンで区切られます (すべてのオペレーティングシステム)。ワイルドカードは不要です (使用不可)。パッケージの検索場所を指定するには、\-sourcepath を使用します。このオプションは、「ソースファイルの処理」で説明したとおり、ソースツリーにあるがパッケージには属していないソースファイルを処理しないので役立ちます。
161.4960 -.LP
161.4961 -次に例を示します。
161.4962 -.nf
161.4963 -\f3
161.4964 -.fl
161.4965 - % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
161.4966 -.fl
161.4967 -.fi
161.4968 -このコマンドは、「java」および「javax.swing」という名前のパッケージとこれらのサブパッケージ全部のドキュメントを生成します。
161.4969 -.LP
161.4970 -\f2\-exclude\fP とともに \f2\-subpackages\fP を使用すると、特定のパッケージを除外できます。
161.4971 -.LP
161.4972 -.TP 3
161.4973 -\-exclude\ \ packagename1:packagename2:...
161.4974 -指定されたパッケージとそのサブパッケージを \f2\-subpackages\fP によって作成されたリストから無条件に除外します。過去の \f2\-subpackages\fP オプションの指定によって組み込まれたパッケージ、または将来組み込まれるパッケージも除外の対象となります。次に例を示します。
161.4975 -.nf
161.4976 -\f3
161.4977 -.fl
161.4978 - % \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
161.4979 -.fl
161.4980 -.fi
161.4981 -このうち、\f2java.io\fP、\f2java.util\fP、\f2java.math\fP は組み込まれますが、\f2java.net\fP と \f2java.lang\fP 以下のパッケージは除外されます。ただし、\f2java.lang\fP のサブパッケージである \f2java.lang.ref\fP は除外されます。
161.4982 -.RE
161.4983 -.TP
161.4984 -.BI \-bootclasspath " classpathlist"
161.4985 -ブートクラスが存在するパスを指定します。
161.4986 -ブートクラスとは、Java プラットフォームクラスのことです。
161.4987 -.B bootclasspath
161.4988 -は、
161.4989 -.B javadoc
161.4990 -ツールがソースファイルとクラスファイルを探すときに
161.4991 -使う検索パスの一部です。詳細は、
161.4992 -「Javac と Javadoc がクラスを検索する方法」 を
161.4993 -参照してください。
161.4994 -.I classpathlist
161.4995 -内の複数の
161.4996 -クラスパスリストは、コロン (:) で区切ります。
161.4997 -.TP
161.4998 -.BI \-extdirs " dirlist"
161.4999 -拡張機能クラスが存在するディレクトリを指定します。
161.5000 -拡張機能クラスは、Java 拡張機能
161.5001 -機構を使うすべてのクラスです。拡張機能ディレクトリ (
161.5002 -.B extdirs
161.5003 -) は、
161.5004 -.B javadoc
161.5005 -ツールがソースファイルとクラスファイルを探すときに使う検索パスの一部です。
161.5006 -詳細は、上の
161.5007 -.B \-classpath
161.5008 -を参照してください。
161.5009 -.I dirlist
161.5010 -内の複数のディレクトリは、
161.5011 -コロン (:) で区切ります。
161.5012 -.TP
161.5013 -.B \-verbose
161.5014 -.B javadoc
161.5015 -の実行中に詳細なメッセージを表示します。冗長オプションを
161.5016 -指定しない場合は、ソースファイルのロード時、ドキュメントの
161.5017 -生成時 (ソースファイルごとに 1 つのメッセージ)、およびソート時に
161.5018 -メッセージが表示されます。冗長オプションを指定した場合は、
161.5019 -各 java ソースファイルの解析に要したミリ秒数などの
161.5020 -追加メッセージを表示します。
161.5021 -.TP
161.5022 -.BI \-quiet
161.5023 -エラーメッセージ以外、および警告メッセージ以外の
161.5024 -メッセージを除外し、
161.5025 -エラーメッセージおよび警告メッセージだけを
161.5026 -表示して見つけやすくします。
161.5027 -また、バージョン文字列の表示も抑制します。
161.5028 -.LP
161.5029 -.TP 3
161.5030 -\-breakiterator\
161.5031 -英語言語というロケール固有のアルゴリズムではなく、\f2java.text.BreakIterator\fP の国際化された文境界を使用して、英文の最初の文の終わりを判断します (他のすべてのロケールはすでに \f2BreakIterator\fP を使用)。「\f2最初の文\fP」とは、パッケージ、クラス、またはメンバの主説明での最初の文のことです。この文は、パッケージ、クラス、またはメンバの要約にコピーされ、アルファベット順のインデックスにコピーされます。
161.5032 -.LP
161.5033 -JDK 1.2 以降、BreakIterator クラスは、英語を除くすべての言語の文の終わりを判断するために、すでに使用されています。したがって、1.2 以降では、\f2\-breakiterator\fP オプションは英文以外には効果がありません。英文には、次のような独自のデフォルトのアルゴリズムがあります。
161.5034 +@see\ package.class#member\ label
161.5035 +絎ゃс Java 荐茯<潟若ゃャ<潟潟茵腓冴鴻 \f2label\fP 菴遵障\f2label\fP ュ純с \f2label\fP ャ潟<潟若膰茵腓冴障 茵腓冴号с\-noqualifier 篏睡茵腓冴鴻宴若後篏ゃ障茵腓冴鴻違茵腓冴鴻絎翫篏帥障
161.5036 +.LP
161.5037 +若吾с 1.2 с <code> HTML 帥医茵腓冴障 1.2.2 篏睡<code> 絽吾茵腓冴鴻蚊<с障障
161.5038 +.LP
161.5039 .RS 3
161.5040 .TP 2
161.5041 o
161.5042 -英文のデフォルトの文区切りアルゴリズム \- 空白または HTML ブロックタグ (\f2<P>\fP など) が続くピリオドで停止する
161.5043 +\f4package.class\fP\f4#\fP\f4member\fP с篁紙鴻違荀膣絎障 ゃ障宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純障c若с <潟弱若激c若荐 (\f2#\fP) х舟障\f2class\fP 篁紙障ャ絖鴻障ゃ潟帥с若鴻茵障\f2member\fP 篁紙潟潟鴻帥<純障c若 (ャ絖鴻障ゃ潟帥с若鴻с) 茵障絎ャ<潟鴻障翫Javadoc 若吾潟篏障紊с鴻吾潟篏\f2\-link\fP 激с潟篏帥障с鴻絮ャ<潟с祉 2 ゃ綵√ \f2@see\fP 帥違篏帥障綣違ゃ絎ц潟顄障
161.5044 .TP 2
161.5045 o
161.5046 -breakiterator 文区切りアルゴリズム \- 一般に、次の語が大文字で始まる場合、空白文字が続くピリオド、疑問符、または感嘆符で停止する。このアルゴリズムでは、ほとんどの省略表記が処理される (「The serial no. is valid」は処理されるが「Mr. Smith」は処理されない)。HTML タグや、数字または記号で始まる文では停止しない。HTML タグに埋め込まれている場合でも、「../filename」の最後のピリオドで停止する
161.5047 +\f4label\fP ュ純鴻с潟茵腓冴障\f2label\fP 腥榊純с障\f2label\fP ャ\f2package.class.member\fP 憜鴻潟宴若吾綽膰茵腓冴障 茵腓冴号с
161.5048 +.TP 2
161.5049 +o
161.5050 +腥榊醇絖\f2package.class\fP\f2#\fP\f2member\fP \f2label\fP 阪絖с綣с眼腥榊醇絖茹i<純<若翠腥榊醇絖ャ障障
161.5051 +.RE
161.5052 +.LP
161.5053 +\f3箴\fP \- 箴с\f2Character\fP 鴻 \f2@see\fP 帥違\f2String\fP 鴻 \f2equals\fP <純с障帥違 \f2String#equals(Object)\fP \f2equals\fP 筝≧鴻綣違障障
161.5054 +.RS 3
161.5055 +
161.5056 +.LP
161.5057 +.nf
161.5058 +\f3
161.5059 +.fl
161.5060 + /**
161.5061 +.fl
161.5062 + * @see String#equals(Object) equals
161.5063 +.fl
161.5064 + */
161.5065 +.fl
161.5066 +
161.5067 +.fl
161.5068 +\fP
161.5069 +.fi
161.5070 +.RE
161.5071 +.LP
161.5072 +罔羣罨< HTML 障
161.5073 +.RS 3
161.5074 +
161.5075 +.LP
161.5076 +.nf
161.5077 +\f3
161.5078 +.fl
161.5079 +<dl>
161.5080 +.fl
161.5081 +<dt><b>See also:</b>
161.5082 +.fl
161.5083 +<dd><a href="../../java/lang/String#equals(java.lang.Object)"><code>equals<code></a>
161.5084 +.fl
161.5085 +</dl>
161.5086 +.fl
161.5087 +
161.5088 +.fl
161.5089 +\fP
161.5090 +.fi
161.5091 +.RE
161.5092 +.LP
161.5093 +吟с罨<茵腓冴潟鴻障
161.5094 +.RS 3
161.5095 +.RS 3
161.5096 +.TP 3
161.5097 +∫i:
161.5098 +equals
161.5099 +.RE
161.5100 +.RE
161.5101 +.RE
161.5102 +
161.5103 +.LP
161.5104 +.RS 3
161.5105 +
161.5106 +.LP
161.5107 +.LP
161.5108 +
161.5109 +.LP
161.5110 +.LP
161.5111 +\f3絎\fP \- 帥違絎 \f2package.class\fP\f2#\fP\f2member\fP \f2java.lang.String#toUpperCase()\fP 絎絎\f2String#toUpperCase()\fP \f2#toUpperCase()\fP 絎с障絎絎翫Javadoc 若Java 潟潟ゃ絽吾罎膣∫綺с罎膣≪障荅括完@see 罎膣∫綺с<純茲違綣違綣с眼с亥榊純с障
161.5112 +.LP
161.5113 +.LP
161.5114 +絎絎鴻ュ絖違羝純若鴻潟若茯帥с罨<茵障障綵√腓冴障 茵筝с\f2Class\fP 鴻障ゃ潟帥с若鴻\f2Type\fP 鴻ゃ潟帥с若鴻障堺若水 \f2method\fP <純障潟潟鴻帥絎с障
161.5115 +.LP
161.5116 +.LP
161.5117 +
161.5118 +.LP
161.5119 .RE
161.5120 .RS 3
161.5121 -.LP
161.5122 -.LP
161.5123 -注: 1.5.0 からは、1.4.x に設けられていた breakiterator 警告メッセージを削除し、デフォルトの文区切りアルゴリズムを変更していません。つまり、\-breakiterator オプションは、1.5.0 ではデフォルトではなくなり、またデフォルトにするつもりもありません。これは、「次のメジャーリリース」(1.5.0) でデフォルトを変更するという、以前の目的とは逆になっています。つまり、ソースコードを変更せず、1.4.x での breakiterator 警告を除去していない場合でも、1.5.0 からは何もする必要がなく、警告は消滅しています。この逆戻りの理由は、breakiterator をデフォルトにするメリットよりも、デフォルトにするために必要となる、互換性のないソースの変更の方が負担が大きかったためです。これに費やした作業や混乱が無駄になり残念です。
161.5124 -.LP
161.5125 -.TP
161.5126 -.BI \-locale " language_country_variant"
161.5127 -.B 重要:
161.5128 -\-locale オプションは、標準ドックレットやその他のドックレット
161.5129 -によって提供されるオプションよりも前に (左側に)
161.5130 -指定する必要があります。そうでなければ、ナビゲーションバーは
161.5131 -英語で表示されます。順序に依存するコマンド行オプションは、
161.5132 -このオプションのみです。
161.5133 -.LP
161.5134 -.RS
161.5135 -.B javadoc
161.5136 -がドキュメントを生成するときに使うロケールを指定します。
161.5137 -引数には、java.util.Locale のドキュメントで説明されている
161.5138 -ロケールを指定します。
161.5139 -たとえば、en_US (英語、米国)、en_US_WIN (Windows で使われる英語) などを
161.5140 -指定します。
161.5141 -.LP
161.5142 -ロケールを指定すると、
161.5143 -.B javadoc
161.5144 -は指定されたロケールのリソースファイルを選択して
161.5145 -メッセージ (ナビゲーションバー、リストと表の見出し、
161.5146 -ヘルプファイルの目次、
161.5147 -.BR stylesheet.css
161.5148 -のコメントなどの文字列) に
161.5149 -使います。また、アルファベット順にソートされるリストのソート順、
161.5150 -および最初の文の末尾を決定する文の区切り文字も、
161.5151 -指定したロケールによって決まります。このオプションは、
161.5152 -ドキュメント化されるクラスのソースファイル内で
161.5153 -指定されている doc コメントテキストの
161.5154 -ロケールを決定するものではありません。
161.5155 +.RS 3
161.5156 +.LP
161.5157 +.TS
161.5158 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.5159 +.de 35
161.5160 +.ps \n(.s
161.5161 +.vs \n(.vu
161.5162 +.in \n(.iu
161.5163 +.if \n(.u .fi
161.5164 +.if \n(.j .ad
161.5165 +.if \n(.j=0 .na
161.5166 +..
161.5167 +.nf
161.5168 +.nr #~ 0
161.5169 +.if n .nr #~ 0.6n
161.5170 +.ds #d .d
161.5171 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.5172 +.fc
161.5173 +.nr 33 \n(.s
161.5174 +.rm 80
161.5175 +.nr 34 \n(.lu
161.5176 +.eo
161.5177 +.am 80
161.5178 +.br
161.5179 +.di a+
161.5180 +.35
161.5181 +.ft \n(.f
161.5182 +.ll \n(34u*1u/2u
161.5183 +.if \n(.l<\n(80 .ll \n(80u
161.5184 +.in 0
161.5185 +\f4@see\fP\f3\ \fP\f4package.class#member\fP\f3 筝綵√\fP
161.5186 +.br
161.5187 +.di
161.5188 +.nr a| \n(dn
161.5189 +.nr a- \n(dl
161.5190 +..
161.5191 +.ec \
161.5192 +.eo
161.5193 +.am 80
161.5194 +.br
161.5195 +.di b+
161.5196 +.35
161.5197 +.ft \n(.f
161.5198 +.ll \n(34u*1u/2u
161.5199 +.if \n(.l<\n(80 .ll \n(80u
161.5200 +.in 0
161.5201 +\f3憜鴻<潟若с\fP
161.5202 +.br
161.5203 +\f2@see\fP\ \f2#\fP\f2field\fP
161.5204 +.br
161.5205 +\f2@see\fP\ \f2#\fP\f2method(Type,\ Type,...)\fP
161.5206 +.br
161.5207 +\f2@see\fP\ \f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
161.5208 +.br
161.5209 +\f2@see\fP\ \f2#\fP\f2constructor(Type,\ Type,...)\fP
161.5210 +.br
161.5211 +\f2@see\fP\ \f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
161.5212 +.br
161.5213 +.di
161.5214 +.nr b| \n(dn
161.5215 +.nr b- \n(dl
161.5216 +..
161.5217 +.ec \
161.5218 +.eo
161.5219 +.am 80
161.5220 +.br
161.5221 +.di c+
161.5222 +.35
161.5223 +.ft \n(.f
161.5224 +.ll \n(34u*1u/2u
161.5225 +.if \n(.l<\n(80 .ll \n(80u
161.5226 +.in 0
161.5227 +\f3憜障ゃ潟若宴若吾ャ鴻с\fP
161.5228 +.br
161.5229 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2field\fP
161.5230 +.br
161.5231 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
161.5232 +.br
161.5233 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
161.5234 +.br
161.5235 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
161.5236 +.br
161.5237 +\f2@see\fP\ \f2Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
161.5238 +.br
161.5239 +\f2@see\fP\ \f2Class.NestedClass\fP
161.5240 +.br
161.5241 +\f2@see\fP\ \f2Class\fP
161.5242 +.br
161.5243 +.di
161.5244 +.nr c| \n(dn
161.5245 +.nr c- \n(dl
161.5246 +..
161.5247 +.ec \
161.5248 +.eo
161.5249 +.am 80
161.5250 +.br
161.5251 +.di d+
161.5252 +.35
161.5253 +.ft \n(.f
161.5254 +.ll \n(34u*1u/2u
161.5255 +.if \n(.l<\n(80 .ll \n(80u
161.5256 +.in 0
161.5257 +\f3ャ宴若吾荀膣с\fP\ (絎篆蕋)
161.5258 +.br
161.5259 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2field\fP
161.5260 +.br
161.5261 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type,\ Type,...)\fP
161.5262 +.br
161.5263 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2method(Type\ argname,\ Type\ argname,...)\fP
161.5264 +.br
161.5265 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2constructor(Type,\ Type,...)\fP
161.5266 +.br
161.5267 +\f2@see\fP\ \f2package.Class\fP\f2#\fP\f2constructor(Type\ argname,\ Type\ argname,...)\fP
161.5268 +.br
161.5269 +\f2@see\fP\ \f2package.Class.NestedClass\fP
161.5270 +.br
161.5271 +\f2@see\fP\ \f2package.Class\fP
161.5272 +.br
161.5273 +\f2@see\fP\ \f2package\fP
161.5274 +.br
161.5275 +.di
161.5276 +.nr d| \n(dn
161.5277 +.nr d- \n(dl
161.5278 +..
161.5279 +.ec \
161.5280 +.35
161.5281 +.nf
161.5282 +.ll \n(34u
161.5283 +.nr 80 0
161.5284 +.80
161.5285 +.rm 80
161.5286 +.nr 38 \n(a-
161.5287 +.if \n(80<\n(38 .nr 80 \n(38
161.5288 +.nr 38 \n(b-
161.5289 +.if \n(80<\n(38 .nr 80 \n(38
161.5290 +.nr 38 \n(c-
161.5291 +.if \n(80<\n(38 .nr 80 \n(38
161.5292 +.nr 38 \n(d-
161.5293 +.if \n(80<\n(38 .nr 80 \n(38
161.5294 +.35
161.5295 +.nf
161.5296 +.ll \n(34u
161.5297 +.nr 38 1n
161.5298 +.nr 79 0
161.5299 +.nr 40 \n(79+(0*\n(38)
161.5300 +.nr 80 +\n(40
161.5301 +.nr TW \n(80
161.5302 +.if t .if \n(TW>\n(.li .tm Table at line 1861 file Input is too wide - \n(TW units
161.5303 +.fc
161.5304 +.nr #T 0-1
161.5305 +.nr #a 0-1
161.5306 +.eo
161.5307 +.de T#
161.5308 +.ds #d .d
161.5309 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.5310 +.mk ##
161.5311 +.nr ## -1v
161.5312 +.ls 1
161.5313 +.ls
161.5314 +..
161.5315 +.ec
161.5316 +.ne \n(a|u+\n(.Vu
161.5317 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.5318 +.ta \n(80u
161.5319 +.nr 31 \n(.f
161.5320 +.nr 35 1m
161.5321 +\&\h'|\n(40u'
161.5322 +.mk ##
161.5323 +.nr 31 \n(##
161.5324 +.sp |\n(##u-1v
161.5325 +.nr 37 \n(40u
161.5326 +.in +\n(37u
161.5327 +.a+
161.5328 +.in -\n(37u
161.5329 +.mk 32
161.5330 +.if \n(32>\n(31 .nr 31 \n(32
161.5331 +.sp |\n(31u
161.5332 +.ne \n(b|u+\n(.Vu
161.5333 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.5334 +.ta \n(80u
161.5335 +.nr 31 \n(.f
161.5336 +.nr 35 1m
161.5337 +\&\h'|\n(40u'
161.5338 +.mk ##
161.5339 +.nr 31 \n(##
161.5340 +.sp |\n(##u-1v
161.5341 +.nr 37 \n(40u
161.5342 +.in +\n(37u
161.5343 +.b+
161.5344 +.in -\n(37u
161.5345 +.mk 32
161.5346 +.if \n(32>\n(31 .nr 31 \n(32
161.5347 +.sp |\n(31u
161.5348 +.ne \n(c|u+\n(.Vu
161.5349 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
161.5350 +.ta \n(80u
161.5351 +.nr 31 \n(.f
161.5352 +.nr 35 1m
161.5353 +\&\h'|\n(40u'
161.5354 +.mk ##
161.5355 +.nr 31 \n(##
161.5356 +.sp |\n(##u-1v
161.5357 +.nr 37 \n(40u
161.5358 +.in +\n(37u
161.5359 +.c+
161.5360 +.in -\n(37u
161.5361 +.mk 32
161.5362 +.if \n(32>\n(31 .nr 31 \n(32
161.5363 +.sp |\n(31u
161.5364 +.ne \n(d|u+\n(.Vu
161.5365 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
161.5366 +.ta \n(80u
161.5367 +.nr 31 \n(.f
161.5368 +.nr 35 1m
161.5369 +\&\h'|\n(40u'
161.5370 +.mk ##
161.5371 +.nr 31 \n(##
161.5372 +.sp |\n(##u-1v
161.5373 +.nr 37 \n(40u
161.5374 +.in +\n(37u
161.5375 +.d+
161.5376 +.in -\n(37u
161.5377 +.mk 32
161.5378 +.if \n(32>\n(31 .nr 31 \n(32
161.5379 +.sp |\n(31u
161.5380 +.fc
161.5381 +.nr T. 1
161.5382 +.T# 1
161.5383 +.35
161.5384 +.rm a+
161.5385 +.rm b+
161.5386 +.rm c+
161.5387 +.rm d+
161.5388 +.TE
161.5389 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-58
161.5390 .RE
161.5391 -.TP
161.5392 -.BI \-encoding " name"
161.5393 -ソースファイルのエンコーディング名 (EUCJIS/SJIS など) を指定します。
161.5394 -このオプションが指定されていない場合は、プラットフォームの
161.5395 -デフォルトコンバータが使われます。
161.5396 -.LP
161.5397 -\-docencoding および \-charset も参照してください。
161.5398 -.TP
161.5399 -.BI \-J flag
161.5400 -.BR javadoc
161.5401 -を実行する実行システム java に flag を直接渡します。J と flag の間に
161.5402 -空白を入れてはなりません。たとえば、生成される
161.5403 -ドキュメントを処理するために、システムで 32M バイトを
161.5404 -確保する必要がある場合は、Java の
161.5405 -.B \-Xmx
161.5406 -オプションを次のように呼び出します。\-Xms はオプションです。初期メモリのサイズのみを設定するため、必要な最小メモリを知っている場合に便利です。
161.5407 -.LP
161.5408 -.RS
161.5409 -.ft 3
161.5410 -.nf
161.5411 -% javadoc \-J\-Xmx32m \-J\-Xms32m com.mypackage
161.5412 -.fi
161.5413 -.ft 1
161.5414 .RE
161.5415
161.5416 -
161.5417 -.LP
161.5418 -使用している javadoc のバージョンを確認するには、
161.5419 -次のように java の「-version」オプションを呼び出します。
161.5420 -.LP
161.5421 -.RS
161.5422 -.ft 3
161.5423 -.nf
161.5424 -% javadoc -J-version
161.5425 -java version "1.2"
161.5426 -Classic VM (build JDK-1.2-V, green threads, sunwjit)
161.5427 -.fi
161.5428 -.ft 1
161.5429 -.RE
161.5430 -.LP
161.5431 -(標準ドックレットのバージョン番号は出力ストリームに表示されます。)
161.5432 -.SS "標準ドックレットが提供するオプション"
161.5433 -.TP
161.5434 -.BI \-d " directory"
161.5435 -生成された HTML ファイルを保存するディレクトリを
161.5436 -指定します (d は「生成先 (destination)」の意味)。このオプションを
161.5437 -省略すると、生成されたファイルは現在のディレクトリに保存されます。
161.5438 -値
161.5439 -.I directory
161.5440 -には、絶対ディレクトリまたは現在の作業
161.5441 -ディレクトリからの相対ディレクトリを指定できます。
161.5442 -1.4 では、javadoc の実行時に
161.5443 -自動的に生成先ディレクトリが作成されます。
161.5444 -.LP
161.5445 -たとえば、
161.5446 -次の例は、com.mypackage パッケージのドキュメントを生成し、
161.5447 -結果を
161.5448 -.B /home/user/doc/
161.5449 -ディレクトリに保存します。
161.5450 -.LP
161.5451 -.RS
161.5452 -.ft 3
161.5453 -.nf
161.5454 -% javadoc \-d /home/user/doc com.mypackage
161.5455 -.fi
161.5456 -.ft 1
161.5457 -.RE
161.5458 -.TP
161.5459 -.B \-use
161.5460 -ドキュメント化されるクラスとパッケージごとに 1 つの [使用] ページを
161.5461 -含めます。このページには、ドキュメント化されるクラスまたは
161.5462 -パッケージの API を使っているパッケージ、クラス、メソッド、
161.5463 -コンストラクタ、およびフィールドが記述されます。たとえば、クラス
161.5464 -C およびクラス C を使うものは、C のサブクラス、C として
161.5465 -宣言されているフィールド、C を返すメソッド、および、型 C の
161.5466 -パラメータを持つメソッドとコンストラクタがページに含ま
161.5467 -れます。
161.5468 -.LP
161.5469 -.RS
161.5470 -たとえば、String について、[使用] ページに何が表示されるかを
161.5471 -見てみましょう。
161.5472 -.B java.awt.Font
161.5473 -クラスの
161.5474 -.B getName()
161.5475 -メソッドは、String 型を返します。
161.5476 -このため、
161.5477 -.B getName()
161.5478 -は String を使うので、[使用] ページの String で
161.5479 -このメソッドを見つけることができます。
161.5480 -.LP
161.5481 -このページでは API の使用だけがドキュメント化され、実装はドキュメント化されません。
161.5482 -あるメソッドが実装内に String を使っているが、引数として
161.5483 -文字列をとったり、文字列を返したりしない
161.5484 -場合は、String の「使用」とはみなされません。
161.5485 -.LP
161.5486 -生成された [使用] ページにアクセスするには、目的のクラスまたは
161.5487 -パッケージを表示して、ナビゲーションバーの [使用] リンクを
161.5488 -クリックします。
161.5489 -.RE
161.5490 -.TP
161.5491 -.B \-version
161.5492 -生成されるドキュメントに
161.5493 -.B @version
161.5494 -テキストを含めます。このテキストは、デフォルトでは省略されます。
161.5495 -使用している javadoc ツールのバージョンを確認するには、
161.5496 -.B \-J\-version
161.5497 -オプションを使用します。
161.5498 -.TP
161.5499 -.B \-author
161.5500 -生成されるドキュメントに
161.5501 -.B @author
161.5502 -テキストを含めます。
161.5503 -.TP
161.5504 -.B \-splitindex
161.5505 -索引ファイルをアルファベットごとに複数のファイルに分割し、
161.5506 -文字ごとに 1 つのファイルと、アルファベット以外の文字で始まる
161.5507 -索引エントリ用のファイルを 1 つ作成します。
161.5508 -.TP
161.5509 -.BI \-windowtitle " title"
161.5510 -HTML の
161.5511 -.B <title>
161.5512 -タグで使うタイトルを指定します。指定したタイトルは、
161.5513 -ウィンドウタイトルと、該当するページに対して作成されたブラウザの
161.5514 -ブックマーク (よくアクセスする場所) に表示されます。
161.5515 -タイトルには HTML タグを含めないでください。タイトルに HTML タグが
161.5516 -含まれていると、ブラウザによるタグの解釈が不適切になる
161.5517 -可能性があります。
161.5518 -.I title
161.5519 -の中で引用符を使う場合は、引用符を
161.5520 -エスケープする必要があります。
161.5521 -.B -windowtitle
161.5522 -が省略されている場合、
161.5523 -.B javadoc
161.5524 -ツールはこのオプションの代わりに -doctitle の値を使います。
161.5525 -.LP
161.5526 -.RS
161.5527 -.ft 3
161.5528 -.nf
161.5529 -% javadoc -windowtitle "Java 2 Platform" com.mypackage
161.5530 -.fi
161.5531 -.ft 1
161.5532 -.RE
161.5533 -.TP
161.5534 -.BI \-doctitle " title"
161.5535 -概要ファイルの最上部近くに配置するタイトルを指定します。
161.5536 -タイトルは中央揃えされ、レベル 1 の見出しとして上部
161.5537 -ナビゲーションバーのすぐ下に置かれます。
161.5538 -.I title
161.5539 -には、HTML タグと
161.5540 -空白を含めることができますが、これらを含める場合は全体を引用符で囲
161.5541 -まなければなりません。
161.5542 -.I title
161.5543 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
161.5544 -.LP
161.5545 -.RS
161.5546 -.ft 3
161.5547 -.nf
161.5548 -% javadoc -doctitle "Java<sup><font size=\"-2\">TM</font></sup>" com.mypackage
161.5549 -.fi
161.5550 -.ft 1
161.5551 -.RE
161.5552 -.TP
161.5553 -.BI \-title " title"
161.5554 -このオプションは、現在は存在しません。
161.5555 -.B javadoc
161.5556 -1.2 のベータ版にだけ存在しました。このオプションは、
161.5557 -ウィンドウタイトルではなくドキュメントタイトルを定義することを
161.5558 -明確にするため、
161.5559 -.BR \-doctitle
161.5560 -に名前が変更されました。
161.5561 -.TP
161.5562 -.BI \-header " header"
161.5563 -各出力ファイルの上部に配置するヘッダテキストを指定します。ヘッダは、
161.5564 -上部ナビゲーションバーの右側に配置されます。
161.5565 -.I header
161.5566 -には、HTML タグと
161.5567 -空白を含めることができますが、これらを含める場合は全体を引用符で
161.5568 -囲まなければなりません。header の中で引用符を使う場合は、引用符を
161.5569 -エスケープする必要があります。
161.5570 -.nf
161.5571 -\f3
161.5572 -.fl
161.5573 - % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP
161.5574 -.fl
161.5575 -.fi
161.5576 -.LP
161.5577 -.TP
161.5578 -.BI \-footer " footer"
161.5579 -各出力ファイルの下部に配置するフッタテキストを指定します。フッタは、
161.5580 -下部ナビゲーションバーの右側に配置されます。
161.5581 -.I footer
161.5582 -には、HTML タグと
161.5583 -空白を含めることができますが、これらを含める場合は全体を引用符で
161.5584 -囲まなければなりません。
161.5585 -.I footer
161.5586 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
161.5587 -.TP
161.5588 -.BI \-bottom " text"
161.5589 -各出力ファイルの最下部に配置するテキストを指定します。
161.5590 -このテキストは、下部ナビゲーションバーの下のページの最下部に
161.5591 -配置されます。
161.5592 -.I text
161.5593 -には、HTML タグと空白を含めることができますが、
161.5594 -これらを含める場合は全体を引用符で囲まなければなりません。
161.5595 -.I text
161.5596 -の中で引用符を使う場合は、引用符をエスケープする必要があります。
161.5597 -.TP
161.5598 -.BI \-link " extdocURL"
161.5599 -.B javadoc
161.5600 -ツールにより生成された既存の
161.5601 -外部参照クラスのドキュメンテーションへのリンクを作成します。
161.5602 -引数は 1 つです。
161.5603 -.TP
161.5604 -\(bu
161.5605 -.I extdocURL
161.5606 -は、javadoc によって生成され、リンク先として指定する
161.5607 -外部ドキュメントがあるディレクトリの絶対 URL または相対 URL です。 あとで例を示します。 このディレクトリ内に package-list ファイルが存在して
161.5608 -いなければなりません。存在しない場合は、\-linkoffline を使用します。
161.5609 -.B javadoc
161.5610 -ツールは package-list ファイルからパッケージ名を読み取り、それを
161.5611 -.I extdocURL
161.5612 -のパッケージにリンクします。 javadoc ツールを実行すると、
161.5613 -.I extdocURL
161.5614 -値は作成された <A HREF> リンクにそのままコピーされます。 したがって、
161.5615 -.I extdocURL
161.5616 -はファイルではなく、
161.5617 -.I extdocURL
161.5618 -の URL である必要があります。
161.5619 -.LP
161.5620 -ドキュメントを任意の Web サイト上のドキュメントにリンクするには
161.5621 -.I extdocURL
161.5622 -の絶対リンクを、相対ロケーションだけを指定するには
161.5623 -相対リンクを使用できます。相対リンクを使用する場合、生成先ディレクトリ (\-d で指定) からの相対パスを、
161.5624 -リンク先パッケージがあるディレクトリに渡す必要があります。
161.5625 -.LP
161.5626 -通常、絶対リンクを指定する場合は、http: リンクを使用します。
161.5627 -ただし、Web サーバをもたないファイルシステムに
161.5628 -リンクする場合は、file: リンクを使用できます。
161.5629 -ただし、この方法は、生成されたドキュメントに
161.5630 -アクセスしようとする
161.5631 -すべてのユーザが同じファイルシステムを共有している
161.5632 -場合以外は使用しないでください。
161.5633 -.LP
161.5634 -すべての場合、すべてのオペレーティングシステムで、絶対 URL と相対 URL、「http:」ベースと「file:」ベースにかかわらず、スラッシュを区切り文字として使用します
161.5635 -.fi
161.5636 -(http://www.ietf.org/rfc/rfc1738.txt
161.5637 -の
161.5638 -.na
161.5639 -\f2URL Memo\fP で指定)。
161.5640 +.LP
161.5641 .RS 3
161.5642 -.TP 3
161.5643 -http: ベースの絶対リンク:
161.5644 -\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
161.5645 -.TP 3
161.5646 -file: ベースの絶対リンク:
161.5647 -\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
161.5648 -.TP 3
161.5649 -相対リンク:
161.5650 -\f2\-link <directory>/<directory>/.../<name>\fP
161.5651 -.RE
161.5652 -.RE
161.5653 -.LP
161.5654 -javadoc 実行時に複数の \-link オプションを指定して、
161.5655 -複数のドキュメントへのリンクを作成することもできます。
161.5656 -.LP
161.5657 -\-linkoffline または \-link の選択
161.5658 -.LP
161.5659 -\-link を使用する場合:
161.5660 -.TP 3
161.5661 -\(bu
161.5662 -外部 API ドキュメントへの相対パスを使用している
161.5663 -.TP 3
161.5664 -\(bu
161.5665 -外部 API ドキュメントへの絶対 URL を使用している (プログラムがその URL に接続し、読み取りを行うことが
161.5666 -シェルによって許可されている場合)
161.5667 -.LP
161.5668 -\-linkoffline を使用する場合:
161.5669 -.TP 3
161.5670 -\(bu
161.5671 -外部 API ドキュメントへの絶対 URL を使用している
161.5672 -(プログラムがその URL に接続し、読み取りを行うことが
161.5673 -シェルによって許可されていない場合)。このような状況は、
161.5674 -リンク先のドキュメントがファイアウォールの
161.5675 -向こう側にある場合に発生します。
161.5676 -.LP
161.5677 -外部ドキュメントへの絶対リンクの使用例 -
161.5678 -java.lang、java.io、および他の Java 2 プラットフォームパッケージ
161.5679 -(\f2http://java.sun.com/j2se/1.5.0/docs/api\fP) に
161.5680 -リンクしたい場合があります。
161.5681 -次のコマンドは、
161.5682 -Java 2 プラットフォームパッケージへのリンクを持つ
161.5683 -com.mypackage パッケージのドキュメントを生成します。
161.5684 -生成されたドキュメントには、たとえばクラスツリー内の
161.5685 -Object クラスへのリンクが含まれています
161.5686 -(\-sourcepath や \-d などの他のオプションは表示されません)。
161.5687 -.LP
161.5688 -.RS
161.5689 -.ft 3
161.5690 -.nf
161.5691 -% \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
161.5692 -.fi
161.5693 -.ft 1
161.5694 -.RE
161.5695 -.LP
161.5696 -外部 ドキュメントへの相対リンクの使用例 -
161.5697 -.B javadoc
161.5698 -ツールの異なる実行で生成されたドキュメントを持つ
161.5699 -2 つのパッケージがあり、それらが別々の
161.5700 -相対パスをもっているとします。
161.5701 -この例では、2 つのパッケージを
161.5702 -com.apipackage (API)、com.spipackage
161.5703 -(SPI - Service Provide Interface) とします。 ドキュメントの置き場所は docs/api/com/apipackage および
161.5704 -docs/spi/com/spipackage です。
161.5705 -API パッケージドキュメントはすでに生成され、ドキュメントが現在の
161.5706 -ディレクトリ内にある場合、次のように実行することで、
161.5707 -API ドキュメントにリンクした SPI パッケージをドキュメント化できます。
161.5708 -.LP
161.5709 -.RS
161.5710 -.ft 3
161.5711 -.nf
161.5712 -% javadoc \-d ./spi \-link ../api com.spipackage
161.5713 -.fi
161.5714 -.ft 1
161.5715 -.RE
161.5716 -.LP
161.5717 -\-link 引数が生成先ディレクトリの相対パス (docs/spi) で
161.5718 -あることに注意してください。
161.5719 -.LP
161.5720 -詳細 -
161.5721 -\-link オプションを使うと、コードからは参照されていても、
161.5722 -Javadoc の現在の実行ではドキュメント化されないクラスにリンク
161.5723 -できるようになります。 リンクから有効なページに
161.5724 -移動できるようにするには、それらの HTML ページが
161.5725 -ある場所を調べ、その場所を
161.5726 -.I extdocURL
161.5727 -に指定する必要があります。
161.5728 -このオプションを使うと、たとえば、サードパーティのドキュメントから、
161.5729 -http://java.sun.com にある java.* のドキュメントにリンクすることができます。
161.5730 -.LP
161.5731 -今回の実行で
161.5732 -.B javadoc
161.5733 -によって生成されるドキュメント内の
161.5734 -API だけを対象にリンクを作成する場合は、
161.5735 -\-link オプションを省略します。 \-link オプションが
161.5736 -指定されていない場合、
161.5737 -.B javadoc
161.5738 -ツールは、外部参照されたドキュメントへのリンクを
161.5739 -作成しません。これは、そのドキュメントが
161.5740 -存在するかどうか、あるいは存在していてもどこに
161.5741 -存在しているのかを判別できないからです。
161.5742 -.LP
161.5743 -このオプションは、生成ドキュメント内の複数の場所に
161.5744 -リンクを作成できます。
161.5745 -.LP
161.5746 -また、このオプションを使うと、複数のパッケージ群の間にクロスリンクを作成することもできます。つまり、ある一式のパッケージに対して javadoc を実行したあと、別の一式のパッケージに対して javadoc を実行し、これら 2 つのパッケージ群の間にクロスリンクを作成できます。
161.5747 -.LP
161.5748 -\f3クラスの参照方法\fP - 外部参照クラスへのリンクを、テキストラベルだけではなく実際に表示するには、次の方法でクラスを参照する必要があります。メソッドの本体でクラスを参照するだけでは十分ではありません。\f2import\fP 文または宣言で参照する必要があります。次に、クラス \f2java.io.File\fP を参照する方法の例を示します。
161.5749 +
161.5750 +.LP
161.5751 +.LP
161.5752 +筝茵絲障茖莇割罨<腓冴障
161.5753 +.LP
161.5754 .RS 3
161.5755 .TP 2
161.5756 o
161.5757 -すべての種類の \f2import\fP 文の場合: ワイルドカードによるインポート、名前による明示的なインポート、または \f2java.lang.*\fP に対する自動的なインポート。たとえば、次のようにすれば十分です。
161.5758 -.br
161.5759 -\f2import java.io.*;\fP
161.5760 -.br
161.5761 -1.3.x および 1.2.x では、名前による明示的なインポートだけです。ワイルドカードによるインポート文も、自動インポート \f2java.lang.*\fP も使用できません。
161.5762 +腮蕁綵√ (宴若吾鴻) 翫Javadoc 若憜鴻絮ゃ罎膣≪障ゃ障憜鴻ゃ潟帥с若鴻鴻若若鴻鴻若若ゃ潟帥с若鴻障憜鴻ゃ潟帥с若鴻蚊с鴻ゃ潟帥с若鴻<潟若罎膣≪障 (罎膣∽ 1 3)憜宴若吾祉祉宴若吾罎膣≪障 (罎膣∽ 4 5)
161.5763 .TP 2
161.5764 o
161.5765 -宣言の場合:
161.5766 -.br
161.5767 -\f2void foo(File f) {}\fP
161.5768 -.br
161.5769 -この参照を使用し、メソッド、コンストラクタ、フィールド、クラス、またはインタフェースのリターンタイプまたはパラメータタイプに置くか、\f2implements\fP、\f2extends\fP、または \f2throws\fP 文に置きます。
161.5770 +<純障潟潟鴻帥絎綣с篁 (\f2getValue\fP ) 篏睡翫c若絖違Javadoc 若<純絲障罩c潟篏障 綣с綣違菴遵篆茘<祉若吾阪障<純若若若翫Javadoc 若罎膣≪ф荀ゃc<純潟障 腟c劫с障
161.5771 +.TP 2
161.5772 +o
161.5773 +ャ絖鴻筝荐綵√翫\f2inner\fPс\f2outer\fP\f2.\fP\f2inner\fP絎違障
161.5774 +.TP 2
161.5775 +o
161.5776 +с菴違鴻鴻<潟若阪 (\f2.\fP) с激c若荐 (\f2#\fP) 篏睡羈絎Javadoc 若障茹f浦с障 鴻ャ絖鴻宴若吾潟泣宴若吾阪篏睡障Javadoc 若с筝荐怨合蚊綺障違с罩c頵f障 翫с茘茵腓冴障
161.5777 .RE
161.5778 -.LP
161.5779 -この結果、\f2\-link\fP オプションを使用しても、この制限のために誤って表示されない多くのリンクが多数発生する可能性があります。テキストはハイパーテキストリンクが付けられずに表示されます。これらのリンクが表示する警告から、このリンクを認識できます。クラスを正しく参照し、それによってリンクを追加するためのもっとも安全な方法は上で説明したとおり、当該のクラスをインポートすることです。
161.5780 -.LP
161.5781 -.B パッケージリスト:
161.5782 -.B \-link
161.5783 -オプションでは、javadoc ツールによって生成された
161.5784 -.BR package-list
161.5785 -という名前のファイルが、このオプションで指定する URL に存在している
161.5786 -必要があります。
161.5787 -.BR package-list
161.5788 -ファイルは、その場所でドキュメント化されているパッケージの
161.5789 -名前のリストを含む単純なテキストファイルです。
161.5790 -前の例では、
161.5791 -.B javadoc
161.5792 -ツールは、指定された URL にある
161.5793 -.BR package-list
161.5794 -という名前のファイルを探し、パッケージ名を読み込んで、
161.5795 -その URL にあるそれらのパッケージへのリンクを作成しました。
161.5796 -.LP
161.5797 -たとえば、Java プラットフォーム v5.0 API のパッケージリストは以下にあり、
161.5798 -.na
161.5799 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP
161.5800 +
161.5801 +.LP
161.5802 +.LP
161.5803 +\f3@see 罎膣∫綺\fP \- Javadoc 若純若鴻<ゃ (.java)宴若吾<ゃ (package.html 障 package\-info.java)障网荀<ゃ (overview.html) 筝糸眼 \f2@see\fP 帥違障緇 2 ゃ<ゃс絎絎 \f2@see\fP 帥違絎違障純若鴻<ゃс絎絎障絎絎с障
161.5804 +.LP
161.5805 +.LP
161.5806 +Javadoc 若\f2.java\fP <ゃу絎с荐菴違 \f2@see\fP 帥違荀ゃJava 潟潟ゃ綺ф絎罎膣≪障 Javadoc 若劫腥咲障罎冴障 純若鴻潟若若絖с罎膣∫綺Java 荐茯篁罕膃 2 膃 6 腴Namesфe絎臂障Javadoc 若∫c鴻宴若吾潟ゃ潟若鴻宴若吾鴻罎膣≪障隙罨<綺ф膣≪障
161.5807 +.LP
161.5808 +.RS 3
161.5809 +.TP 3
161.5810 +1.
161.5811 +憜鴻障ゃ潟帥с若
161.5812 +.TP 3
161.5813 +2.
161.5814 +紊眼蚊с鴻ゃ潟帥с若 (c菴罎膣)
161.5815 +.TP 3
161.5816 +3.
161.5817 +鴻若若鴻鴻若若ゃ潟帥с若 (c菴罎膣)
161.5818 +.TP 3
161.5819 +4.
161.5820 +憜宴若
161.5821 +.TP 3
161.5822 +5.
161.5823 +ゃ潟若宴若吾鴻潟ゃ潟帥с若 (import 綺緇c罎膣)
161.5824 .RE
161.5825 -.LP
161.5826 -次のような内容で始まっています。
161.5827 -.LP
161.5828 -.RS
161.5829 -.ft 3
161.5830 +
161.5831 +.LP
161.5832 +.LP
161.5833 +Javadoc 若鴻ゃ 1 3 絽亥筝眼荀ゃ障ф膣≪膓障ゃ障障憜鴻罎膣≪罨<鴻蚊с E 罎膣≪罨< E 鴻若若鴻罎膣≪罨< E 蚊с鴻罎膣≪障 4 5 с1 ゃ宴若後鴻障ゃ潟帥с若鴻罎膣≪綺羆冴障c障 綺潟潟ゃc違障 5 сJavadoc 若java.lang 罎膣≪障 宴若吾鴻違ゃ潟若с
161.5834 +.LP
161.5835 +.LP
161.5836 +Javadoc 若綽泣鴻罎膣≪障 障javadoc 絎茵筝祉宴若吾ャ<潟翫с祉宴若吾罎膣≪障違\f2@see\fP 帥違 \f2java.awt.event.KeyEvent\fP 劫c\f2java.awt\fP 宴若吾с翫Javadoc 鴻ゃ潟若宴若吾罎膣≪障
161.5837 +.LP
161.5838 +.LP
161.5839 +\f3茵腓冴号\fP \- \f2label\fP ャ\f2package.class.member\fP 茵腓冴障筝package.class.member 憜鴻潟宴若吾綽膰障膰綽荀絨茵腓冴с違\f2String.toUpperCase()\fP <純鴻<潟若吾с祉鴻<潟若吾с障翫劫茵腓冴緇宴若鴻с (罨<茵)
161.5840 +.LP
161.5841 +.LP
161.5842 +宴若後綺ゃ\-noqualifier 篏睡障
161.5843 +.br
161.5844 +
161.5845 +.LP
161.5846 +.RE
161.5847 +.RS 3
161.5848 +.RS 3
161.5849 +.LP
161.5850 +.TS
161.5851 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.5852 +.de 35
161.5853 +.ps \n(.s
161.5854 +.vs \n(.vu
161.5855 +.in \n(.iu
161.5856 +.if \n(.u .fi
161.5857 +.if \n(.j .ad
161.5858 +.if \n(.j=0 .na
161.5859 +..
161.5860 .nf
161.5861 -java.applet
161.5862 -java.awt
161.5863 -java.awt.color
161.5864 -java.awt.datatransfer
161.5865 -java.awt.dnd
161.5866 -java.awt.event
161.5867 -java.awt.font
161.5868 -その他 ...
161.5869 -.fi
161.5870 -.ft 1
161.5871 +.nr #~ 0
161.5872 +.if n .nr #~ 0.6n
161.5873 +.ds #d .d
161.5874 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.5875 +.fc
161.5876 +.nr 33 \n(.s
161.5877 +.rm 80 81 82
161.5878 +.nr 34 \n(.lu
161.5879 +.eo
161.5880 +.am 81
161.5881 +.br
161.5882 +.di a+
161.5883 +.35
161.5884 +.ft \n(.f
161.5885 +.ll \n(34u*1u/4u
161.5886 +.if \n(.l<\n(81 .ll \n(81u
161.5887 +.in 0
161.5888 +\f4String.toUpperCase()\fP\f3 с箴\fP
161.5889 +.br
161.5890 +.di
161.5891 +.nr a| \n(dn
161.5892 +.nr a- \n(dl
161.5893 +..
161.5894 +.ec \
161.5895 +.eo
161.5896 +.am 80
161.5897 +.br
161.5898 +.di b+
161.5899 +.35
161.5900 +.ft \n(.f
161.5901 +.ll \n(34u*1u/4u
161.5902 +.if \n(.l<\n(80 .ll \n(80u
161.5903 +.in 0
161.5904 +\f2@see\fP 帥違鴻<潟若с
161.5905 +.br
161.5906 +.di
161.5907 +.nr b| \n(dn
161.5908 +.nr b- \n(dl
161.5909 +..
161.5910 +.ec \
161.5911 +.eo
161.5912 +.am 82
161.5913 +.br
161.5914 +.di c+
161.5915 +.35
161.5916 +.ft \n(.f
161.5917 +.ll \n(34u*1u/4u
161.5918 +.if \n(.l<\n(82 .ll \n(82u
161.5919 +.in 0
161.5920 +\f2toLowerCase()\fP (劫)
161.5921 +.br
161.5922 +.di
161.5923 +.nr c| \n(dn
161.5924 +.nr c- \n(dl
161.5925 +..
161.5926 +.ec \
161.5927 +.eo
161.5928 +.am 80
161.5929 +.br
161.5930 +.di d+
161.5931 +.35
161.5932 +.ft \n(.f
161.5933 +.ll \n(34u*1u/4u
161.5934 +.if \n(.l<\n(80 .ll \n(80u
161.5935 +.in 0
161.5936 +\f2@see\fP 帥違ャ鴻<潟若с
161.5937 +.br
161.5938 +.di
161.5939 +.nr d| \n(dn
161.5940 +.nr d- \n(dl
161.5941 +..
161.5942 +.ec \
161.5943 +.eo
161.5944 +.am 81
161.5945 +.br
161.5946 +.di e+
161.5947 +.35
161.5948 +.ft \n(.f
161.5949 +.ll \n(34u*1u/4u
161.5950 +.if \n(.l<\n(81 .ll \n(81u
161.5951 +.in 0
161.5952 +\f2@see Character#toLowerCase(char)\fP
161.5953 +.br
161.5954 +.di
161.5955 +.nr e| \n(dn
161.5956 +.nr e- \n(dl
161.5957 +..
161.5958 +.ec \
161.5959 +.eo
161.5960 +.am 82
161.5961 +.br
161.5962 +.di f+
161.5963 +.35
161.5964 +.ft \n(.f
161.5965 +.ll \n(34u*1u/4u
161.5966 +.if \n(.l<\n(82 .ll \n(82u
161.5967 +.in 0
161.5968 +\f2Character.toLowerCase(char)\fP (宴若後ャ劫)
161.5969 +.br
161.5970 +.di
161.5971 +.nr f| \n(dn
161.5972 +.nr f- \n(dl
161.5973 +..
161.5974 +.ec \
161.5975 +.eo
161.5976 +.am 80
161.5977 +.br
161.5978 +.di g+
161.5979 +.35
161.5980 +.ft \n(.f
161.5981 +.ll \n(34u*1u/4u
161.5982 +.if \n(.l<\n(80 .ll \n(80u
161.5983 +.in 0
161.5984 +\f2@see\fP 帥違ャ鴻<潟若с
161.5985 +.br
161.5986 +.di
161.5987 +.nr g| \n(dn
161.5988 +.nr g- \n(dl
161.5989 +..
161.5990 +.ec \
161.5991 +.eo
161.5992 +.am 81
161.5993 +.br
161.5994 +.di h+
161.5995 +.35
161.5996 +.ft \n(.f
161.5997 +.ll \n(34u*1u/4u
161.5998 +.if \n(.l<\n(81 .ll \n(81u
161.5999 +.in 0
161.6000 +\f2@see java.io.File#exists()\fP
161.6001 +.br
161.6002 +.di
161.6003 +.nr h| \n(dn
161.6004 +.nr h- \n(dl
161.6005 +..
161.6006 +.ec \
161.6007 +.eo
161.6008 +.am 82
161.6009 +.br
161.6010 +.di i+
161.6011 +.35
161.6012 +.ft \n(.f
161.6013 +.ll \n(34u*1u/4u
161.6014 +.if \n(.l<\n(82 .ll \n(82u
161.6015 +.in 0
161.6016 +\f2java.io.File.exists()\fP (宴若後劫)
161.6017 +.br
161.6018 +.di
161.6019 +.nr i| \n(dn
161.6020 +.nr i- \n(dl
161.6021 +..
161.6022 +.ec \
161.6023 +.35
161.6024 +.nf
161.6025 +.ll \n(34u
161.6026 +.nr 80 0
161.6027 +.nr 38 \w\f3с腮蕁\fP
161.6028 +.if \n(80<\n(38 .nr 80 \n(38
161.6029 +.80
161.6030 +.rm 80
161.6031 +.nr 38 \n(b-
161.6032 +.if \n(80<\n(38 .nr 80 \n(38
161.6033 +.nr 38 \n(d-
161.6034 +.if \n(80<\n(38 .nr 80 \n(38
161.6035 +.nr 38 \n(g-
161.6036 +.if \n(80<\n(38 .nr 80 \n(38
161.6037 +.nr 81 0
161.6038 +.nr 38 \w\f2@see String#toLowerCase()\fP
161.6039 +.if \n(81<\n(38 .nr 81 \n(38
161.6040 +.81
161.6041 +.rm 81
161.6042 +.nr 38 \n(a-
161.6043 +.if \n(81<\n(38 .nr 81 \n(38
161.6044 +.nr 38 \n(e-
161.6045 +.if \n(81<\n(38 .nr 81 \n(38
161.6046 +.nr 38 \n(h-
161.6047 +.if \n(81<\n(38 .nr 81 \n(38
161.6048 +.nr 82 0
161.6049 +.nr 38 \w\f3茵腓冴\fP
161.6050 +.if \n(82<\n(38 .nr 82 \n(38
161.6051 +.82
161.6052 +.rm 82
161.6053 +.nr 38 \n(c-
161.6054 +.if \n(82<\n(38 .nr 82 \n(38
161.6055 +.nr 38 \n(f-
161.6056 +.if \n(82<\n(38 .nr 82 \n(38
161.6057 +.nr 38 \n(i-
161.6058 +.if \n(82<\n(38 .nr 82 \n(38
161.6059 +.35
161.6060 +.nf
161.6061 +.ll \n(34u
161.6062 +.nr 38 1n
161.6063 +.nr 79 0
161.6064 +.nr 40 \n(79+(0*\n(38)
161.6065 +.nr 80 +\n(40
161.6066 +.nr 41 \n(80+(3*\n(38)
161.6067 +.nr 81 +\n(41
161.6068 +.nr 42 \n(81+(3*\n(38)
161.6069 +.nr 82 +\n(42
161.6070 +.nr TW \n(82
161.6071 +.if t .if \n(TW>\n(.li .tm Table at line 1959 file Input is too wide - \n(TW units
161.6072 +.fc
161.6073 +.nr #T 0-1
161.6074 +.nr #a 0-1
161.6075 +.eo
161.6076 +.de T#
161.6077 +.ds #d .d
161.6078 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.6079 +.mk ##
161.6080 +.nr ## -1v
161.6081 +.ls 1
161.6082 +.ls
161.6083 +..
161.6084 +.ec
161.6085 +.ne \n(a|u+\n(.Vu
161.6086 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.6087 +.ta \n(80u \n(81u \n(82u
161.6088 +.nr 31 \n(.f
161.6089 +.nr 35 1m
161.6090 +\&\h'|\n(40u'\f3с腮蕁\fP\h'|\n(41u'\h'|\n(42u'\f3茵腓冴\fP
161.6091 +.mk ##
161.6092 +.nr 31 \n(##
161.6093 +.sp |\n(##u-1v
161.6094 +.nr 37 \n(41u
161.6095 +.in +\n(37u
161.6096 +.a+
161.6097 +.in -\n(37u
161.6098 +.mk 32
161.6099 +.if \n(32>\n(31 .nr 31 \n(32
161.6100 +.sp |\n(31u
161.6101 +.ne \n(b|u+\n(.Vu
161.6102 +.ne \n(c|u+\n(.Vu
161.6103 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.6104 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
161.6105 +.ta \n(80u \n(81u \n(82u
161.6106 +.nr 31 \n(.f
161.6107 +.nr 35 1m
161.6108 +\&\h'|\n(40u'\h'|\n(41u'\f2@see String#toLowerCase()\fP\h'|\n(42u'
161.6109 +.mk ##
161.6110 +.nr 31 \n(##
161.6111 +.sp |\n(##u-1v
161.6112 +.nr 37 \n(40u
161.6113 +.in +\n(37u
161.6114 +.b+
161.6115 +.in -\n(37u
161.6116 +.mk 32
161.6117 +.if \n(32>\n(31 .nr 31 \n(32
161.6118 +.sp |\n(##u-1v
161.6119 +.nr 37 \n(42u
161.6120 +.in +\n(37u
161.6121 +.c+
161.6122 +.in -\n(37u
161.6123 +.mk 32
161.6124 +.if \n(32>\n(31 .nr 31 \n(32
161.6125 +.sp |\n(31u
161.6126 +.ne \n(d|u+\n(.Vu
161.6127 +.ne \n(e|u+\n(.Vu
161.6128 +.ne \n(f|u+\n(.Vu
161.6129 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
161.6130 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
161.6131 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
161.6132 +.ta \n(80u \n(81u \n(82u
161.6133 +.nr 31 \n(.f
161.6134 +.nr 35 1m
161.6135 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
161.6136 +.mk ##
161.6137 +.nr 31 \n(##
161.6138 +.sp |\n(##u-1v
161.6139 +.nr 37 \n(40u
161.6140 +.in +\n(37u
161.6141 +.d+
161.6142 +.in -\n(37u
161.6143 +.mk 32
161.6144 +.if \n(32>\n(31 .nr 31 \n(32
161.6145 +.sp |\n(##u-1v
161.6146 +.nr 37 \n(41u
161.6147 +.in +\n(37u
161.6148 +.e+
161.6149 +.in -\n(37u
161.6150 +.mk 32
161.6151 +.if \n(32>\n(31 .nr 31 \n(32
161.6152 +.sp |\n(##u-1v
161.6153 +.nr 37 \n(42u
161.6154 +.in +\n(37u
161.6155 +.f+
161.6156 +.in -\n(37u
161.6157 +.mk 32
161.6158 +.if \n(32>\n(31 .nr 31 \n(32
161.6159 +.sp |\n(31u
161.6160 +.ne \n(g|u+\n(.Vu
161.6161 +.ne \n(h|u+\n(.Vu
161.6162 +.ne \n(i|u+\n(.Vu
161.6163 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
161.6164 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
161.6165 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
161.6166 +.ta \n(80u \n(81u \n(82u
161.6167 +.nr 31 \n(.f
161.6168 +.nr 35 1m
161.6169 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
161.6170 +.mk ##
161.6171 +.nr 31 \n(##
161.6172 +.sp |\n(##u-1v
161.6173 +.nr 37 \n(40u
161.6174 +.in +\n(37u
161.6175 +.g+
161.6176 +.in -\n(37u
161.6177 +.mk 32
161.6178 +.if \n(32>\n(31 .nr 31 \n(32
161.6179 +.sp |\n(##u-1v
161.6180 +.nr 37 \n(41u
161.6181 +.in +\n(37u
161.6182 +.h+
161.6183 +.in -\n(37u
161.6184 +.mk 32
161.6185 +.if \n(32>\n(31 .nr 31 \n(32
161.6186 +.sp |\n(##u-1v
161.6187 +.nr 37 \n(42u
161.6188 +.in +\n(37u
161.6189 +.i+
161.6190 +.in -\n(37u
161.6191 +.mk 32
161.6192 +.if \n(32>\n(31 .nr 31 \n(32
161.6193 +.sp |\n(31u
161.6194 +.fc
161.6195 +.nr T. 1
161.6196 +.T# 1
161.6197 +.35
161.6198 +.rm a+
161.6199 +.rm b+
161.6200 +.rm c+
161.6201 +.rm d+
161.6202 +.rm e+
161.6203 +.rm f+
161.6204 +.rm g+
161.6205 +.rm h+
161.6206 +.rm i+
161.6207 +.TE
161.6208 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-28
161.6209 .RE
161.6210 -.LP
161.6211 -.B \-link
161.6212 -オプションを指定せずに
161.6213 -.B javadoc
161.6214 -ツールを実行した場合、ドキュメントの生成時に外部参照
161.6215 -クラスに属する名前を
161.6216 -見つけると、
161.6217 -.B javadoc
161.6218 -はその名前をリンクを持たない形で出力します。一方、
161.6219 -.B \-link
161.6220 -オプションが指定されている場合、
161.6221 -.B javadoc
161.6222 -ツールは、指定された
161.6223 -.IR extdocURL
161.6224 -の場所にある
161.6225 -.B package-list
161.6226 -ファイルから、該当する名前のパッケージを探します。パッケージ名が
161.6227 -見つかった場合は、その
161.6228 -.IR extdocURL
161.6229 -を名前の前に付けます。
161.6230 -.LP
161.6231 -すべてのリンクが正しく機能するためには、外部参照の
161.6232 -ドキュメントのすべてが、指定された URL に
161.6233 -存在していなければなりません。
161.6234 -.B javadoc
161.6235 -ツールは、
161.6236 -.B package-list
161.6237 -が存在するかどうかを調べるだけで、指定された URL に
161.6238 -目的のページが存在するかどうかはチェックしません。
161.6239 -.LP
161.6240 -.B 複数のリンク:
161.6241 -複数の
161.6242 -.B \-link
161.6243 -オプションを提供して、外部で生成されたドキュメントに任意数のリンクを設定できます。Javadoc 1.2 には、複数の
161.6244 -.B -link
161.6245 -コマンドを提供できないというバグがあります。このバグは、
161.6246 -1.2.2 で修正されました。
161.6247 -.LP
161.6248 -リンクする外部ドキュメントごとに別のリンクオプションを指定します。
161.6249 -.LP
161.6250 -.RS
161.6251 -.ft 3
161.6252 -.nf
161.6253 -% javadoc \-link extdocURL1 \-link extdocURL2 ... \-link extdocURLn com.mypackage
161.6254 -.fi
161.6255 -.ft 1
161.6256 .RE
161.6257 -.LP
161.6258 -.BR extdocURL1、
161.6259 -.BR extdocURL2、...
161.6260 -.BR extdocURLn
161.6261 -は、それぞれ外部ドキュメントの
161.6262 -ルートを指し、各ルートには、
161.6263 -.BR package-list
161.6264 -という名前のファイルが含まれています。
161.6265 -.LP
161.6266 -クロスリンク - まだ生成されていない 2 つ以上のドキュメントを
161.6267 -クロスリンクする場合は、「ブートストラッピング」が必要になることに
161.6268 -注意してください。言い換えると、どのドキュメントの
161.6269 -.B package-list
161.6270 -も存在していない場合、最初のドキュメントに対して
161.6271 -.B javadoc
161.6272 -ツールを実行した時点では、2 番目のドキュメントの
161.6273 -.B package-list
161.6274 -はまだ存在していません。したがって、外部リンクを作成するには、
161.6275 -2 番目のドキュメントを
161.6276 -生成したあと、最初のドキュメントを生成し直す必要があります。
161.6277 -.LP
161.6278 -この場合、最初に行うドキュメント生成の目的は、
161.6279 -.B package-list
161.6280 -を作成することです。パッケージ名をすべて把握している場合は、
161.6281 -.B package-list
161.6282 -を手動で作成することもできます。次に、2 番目のドキュメントと
161.6283 -その外部リンクを生成します。
161.6284 -.B javadoc
161.6285 -ツールは、必要な外部の
161.6286 -.B package-list
161.6287 -ファイルが存在しない場合は、警告を表示します。
161.6288 -.TP
161.6289 -.BI \-linkoffline " extdocURL packagelistLoc"
161.6290 -このオプションは、
161.6291 -.BR \-link
161.6292 -オプションを変えたものです。どちらも、javadoc で
161.6293 -生成された外部参照クラスのドキュメントへのリンクを作成します。
161.6294 -.B Javadoc
161.6295 -ツールが「オフライン」で、Web 上のドキュメントに
161.6296 -リンクする場合は、Web 接続経由ではドキュメントに
161.6297 -アクセスできないため、
161.6298 -.B \-linkoffline
161.6299 -オプションを使用します。
161.6300 -.LP
161.6301 -厳密には、外部ドキュメントの \f2package\-list\fP ファイルにアクセスできないとき、またはこのファイルが \f2extdocURL\fP で指定された場所とは異なる場所 (通常、\f2packageListLoc\fP で指定可能なローカルな場所) に存在するとき、\f2\-linkoffline\fP を使用します。したがって、\f2extdocURL\fP に WWW 上でしかアクセスできない場合は、\f2\-linkoffline\fP を指定することにより、ドキュメントの生成時に javadoc ツールが Web に接続できなければならないという制約がなくなります。
161.6302 -.LP
161.6303 -さらに、ドキュメントを更新するための「ハッキング」としての使用も可能です。パッケージのセット全体に対して javadoc を実行したあと、変更した一部のパッケージだけに対して javadoc を実行します。こうして、更新されたファイルを、オリジナルのファイルセットに挿入できるようにします。例をあとで示します。
161.6304 -.LP
161.6305 -.BR \-linkoffline
161.6306 -オプションには 2 つの引数があります。1 つは
161.6307 -<a href> リンクに埋め込む文字列、もう 1 つは
161.6308 -.BR package-list:
161.6309 -の検索場所を示します。
161.6310 -.LP
161.6311 -.RS
161.6312 -.TP 2
161.6313 -\(bu
161.6314 -.I extdocURL
161.6315 -は、\f3javadoc\f1 によって生成され、リンク先として指定する
161.6316 -外部ドキュメントがあるディレクトリの絶対
161.6317 -URL または相対 URL です。 相対リンクの場合、
161.6318 -生成先ディレクトリ (\-d で指定) からの相対パスを、
161.6319 -リンク先パッケージのルートに渡す必要があります。 詳細は、
161.6320 -.B \-link
161.6321 -オプションの
161.6322 -.I extdocURL
161.6323 -を参照してください。
161.6324 -.TP 2
161.6325 -\(bu
161.6326 -.I packagelistLoc
161.6327 -には、外部ドキュメントの
161.6328 -.B package-list
161.6329 -ファイルが入っているディレクトリのパスまたは
161.6330 -URL を指定します。 URL (http: または file:)
161.6331 -またはファイルパスを指定できます。
161.6332 -また、絶対パスと相対パスのどちらでもかまいません。
161.6333 -相対パスの場合は、javadoc が実行される現在の
161.6334 -ディレクトリからの相対パスとして指定します。
161.6335 -.BR package-list
161.6336 -というファイル名は含めないでください。
161.6337 -.LP
161.6338 -.B javadoc
161.6339 -の 1 回の実行で、複数の
161.6340 -.B \-linkoffline
161.6341 -オプションを指定できます。
161.6342 -1.2.2 より前のバージョンでは、複数のオプションは指定できませんでした。
161.6343 -.LP
161.6344 -外部ドキュメントへの絶対リンクを使った例 -
161.6345 -.BR java.lang
161.6346 -、
161.6347 -.BR java.io
161.6348 -、およびその他の Java 2 プラットフォームパッケージ (\f2http://java.sun.com/j2se/1.5.0/docs/api\fP)
161.6349 -にリンクしたくても、Web にアクセスできない
161.6350 -場合について考えてみます。
161.6351 -.BR package-list
161.6352 -ファイルをブラウザで開き (\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP)、
161.6353 -ローカルディレクトリに保存します。
161.6354 -次に、2 番目の引数
161.6355 -.I packagelistLoc
161.6356 -でそのローカルコピーを指定します。このとき
161.6357 -パッケージリストファイルは現在のディレクトリ
161.6358 -「.」に保存されています。 次のコマンドは、
161.6359 -Java 2 プラットフォームパッケージへのリンクを含む、
161.6360 -com.mypackage パッケージのドキュメントを生成します。
161.6361 -生成されたドキュメントには、たとえばクラスツリー内の
161.6362 -Object クラスへのリンクが含まれています
161.6363 -(\-sourcepath などの他の必要なオプションは表示されません)。
161.6364 -.LP
161.6365 -.RS
161.6366 -.ft 3
161.6367 -.nf
161.6368 -% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
161.6369 -.fi
161.6370 -.ft 1
161.6371 -.RE
161.6372 -.LP
161.6373 -外部ドキュメントへの相対リンクを使った例 -
161.6374 -.B \-linkoffline
161.6375 -を相対パスで指定するのはあまり一般的ではありません。通常は、
161.6376 -.B \-link
161.6377 -で十分だからです。
161.6378 -.B \-linkoffline
161.6379 -を使用している場合、
161.6380 -.BR package-list
161.6381 -ファイルは通常ローカルで、相対リンクを使用している場合は、
161.6382 -リンク先のファイルもローカルであるのが普通です。
161.6383 -そのため、
161.6384 -.B \-linkoffline
161.6385 -に 2 つの異なる引数のパスを
161.6386 -与える必要はありません。 2 つの引数が同じである場合、
161.6387 -.B \-link
161.6388 -を使用できます。
161.6389 -.B \-link
161.6390 -の相対リンクの使用例を参照してください。
161.6391 -.LP
161.6392 -package-list ファイルの手動作成 -
161.6393 -.BR package-list
161.6394 -ファイルがまだ存在しなくても、ドキュメントのリンク先のパッケージ名がわかっている場合は、このファイルのコピーを自分で作成し、
161.6395 -.I packagelistLoc
161.6396 -でそのパスを指定することができます。
161.6397 -com.apipackage が最初に作成されたときに
161.6398 -com.spipackage のパッケージリストが存在しなかった、
161.6399 -以前の場合がその例です。
161.6400 -この方法は、パッケージ名はわかっているものの、
161.6401 -まだ公開されていない、新しい外部ドキュメントにリンクする
161.6402 -ドキュメントを生成する場合に便利です。
161.6403 -また、Javadoc 1.0 または 1.1 では package-list ファイルが
161.6404 -生成されないため、この方法で、これらのバージョンで
161.6405 -生成されたパッケージの package-list ファイルを生成できます。
161.6406 -2 つの会社が未公開の package-list ファイルを
161.6407 -共有することもできるため、クロスリンクを設定した
161.6408 -ドキュメントを同時にリリースすることも可能です。
161.6409 -.LP
161.6410 -複数のドキュメントにリンク -
161.6411 -.B \-linkoffline
161.6412 -は、参照先の生成ドキュメントごとに 1 つずつ指定します。
161.6413 -次の例では、わかりやすくするために
161.6414 -オプションごとに行を分けています。
161.6415 -.LP
161.6416 -.RS
161.6417 -.ft 3
161.6418 -.nf
161.6419 -.ta 18n
161.6420 -% javadoc \-linkoffline docURL1 packagelistURL1 \\
161.6421 - \-linkoffline docURL2 packagelistURL2 \\
161.6422 -.ft 1
161.6423 - ...
161.6424 -.fi
161.6425 -.RE
161.6426 -.LP
161.6427 -.B ドキュメントの更新:
161.6428 -.B \-linkoffline
161.6429 -オプションのもう 1 つの用途は、プロジェクトで多数のパッケージを使い、
161.6430 -すでにツリー全体に対して
161.6431 -.B javadoc
161.6432 -を実行してある場合に、次の実行では、すばやく細かい
161.6433 -変更を行なってから、ソース
161.6434 -ツリーの一部に対してだけ
161.6435 -.B javadoc
161.6436 -を実行し直したい場合に便利です。これは、
161.6437 -変更がドキュメンテーションコメントに対し
161.6438 -てであり、シグニチャに対してではない場合にだけ正常に
161.6439 -処理されるので、ハッキング
161.6440 -のようなものです。ソースコードに対してシグニチャを追加、
161.6441 -削除または変更した場合は、索引、パッケージツリー、
161.6442 -継承されるメンバのリスト、[使用] ページなどの場所
161.6443 -で壊れたリンクが表示されます。
161.6444 -.LP
161.6445 -まず、新しい実行のため、新規の
161.6446 -生成先ディレクトリ (update) を作成します。オリジナルの生成先ディレクトリを html とします。もっとも簡単な例として、html の親に移動します。
161.6447 -.B \-linkoffline
161.6448 -の 1 番目の引数に現在のディレクトリ「.」を
161.6449 -設定し、2 番目の引数に package-list
161.6450 -を検索する場所である html への相対パスを設定します。更新したいパッケージのパッケージ名のみを渡します。
161.6451 -.LP
161.6452 -.RS
161.6453 -.ft 3
161.6454 -.nf
161.6455 -% javadoc \-d update \-linkoffline . html com.mypackage
161.6456 -.fi
161.6457 -.ft 1
161.6458 -.RE
161.6459 -.LP
161.6460 -.B javadoc
161.6461 -の実行が終了したとき、
161.6462 -.B update/com/package
161.6463 -内に生成されたクラス (概要や索引ではない) で、
161.6464 -html/com/package 内にあるオリジナルのファイルを上書きコピーします。
161.6465 -.TP
161.6466 -\-linksource
161.6467 -各ソースファイル (行番号付き) の HTML バージョンを作成し、標準 HTML ドキュメントからソースファイルへのリンクを追加します。リンクは、ソースファイル内に宣言されているクラス、インタフェース、コンストラクタ、メソッド、フィールドに対して作成されます。デフォルトコンストラクタ、生成されたクラスに対しては作成されません。
161.6468 -.LP
161.6469 -\f3このオプションは、\fP\f4\-public\fP\f3、\fP\f4\-package\fP\f3、\fP\f4\-protected\fP\f3、\fP\f4\-private\fP\f3 の各オプションとは関係なく、非公開のクラス、フィールド、非公開のメソッドの本体をはじめとする組み込まれたソースファイル内の\fP\f4すべての\fP\f3非公開実装の詳細を公開します。\fP\f2\-private\fP オプションを指定しないかぎり、非公開のクラスやインタフェースの一部には、リンクを介してアクセスできないことがあります。
161.6470 -.LP
161.6471 -各リンクは、その宣言内の識別子名の上に作成されます。たとえば、\f2Button\fP クラスのソースコードヘのリンクは、「Button」という語の上に作成されます。
161.6472 +
161.6473 +.LP
161.6474 +.RS 3
161.6475 +
161.6476 +.LP
161.6477 +.LP
161.6478 +\f3@see 箴\fP
161.6479 +.br
161.6480 +勀眼潟<潟\f2@see\fP 帥違ャ宴若 (\f2java.applet.Applet\fP ) 劫翫茵腓冴腓冴障
161.6481 +.LP
161.6482 .nf
161.6483 \f3
161.6484 .fl
161.6485 - public class Button
161.6486 -.fl
161.6487 - extends Component
161.6488 -.fl
161.6489 - implements Accessible
161.6490 + ∫i:
161.6491 +.fl
161.6492 +@see java.lang.String // String \fP\f3
161.6493 +.fl
161.6494 +@see java.lang.String The String class // The String class \fP\f3
161.6495 +.fl
161.6496 +@see String // String \fP\f3
161.6497 +.fl
161.6498 +@see String#equals(Object) // String.equals(Object) \fP\f3
161.6499 +.fl
161.6500 +@see String#equals // String.equals(java.lang.Object) \fP\f3
161.6501 +.fl
161.6502 +@see java.lang.Object#wait(long) // java.lang.Object.wait(long) \fP\f3
161.6503 +.fl
161.6504 +@see Character#MAX_RADIX // Character.MAX_RADIX \fP\f3
161.6505 +.fl
161.6506 +@see <a href="spec.html">Java Spec</a> // Java Spec \fP\f3
161.6507 +.fl
161.6508 +@see "The Java Programming Language" // "The Java Programming Language" \fP\f3
161.6509 +.fl
161.6510 +
161.6511 .fl
161.6512 \fP
161.6513 .fi
161.6514 -Button クラスの \f2getLabel()\fP メソッドのソースコードへのリンクは、「getLabel」という語の上に作成されます。
161.6515 -.nf
161.6516 -\f3
161.6517 -.fl
161.6518 - public String getLabel()
161.6519 -.fl
161.6520 -\fP
161.6521 +
161.6522 +.LP
161.6523 +.LP
161.6524 +\f2@see\fP ャ<潟絲乗院鴻障ф≦宍\f2\-link\fP 激с潟篏睡障
161.6525 +.LP
161.6526 +.LP
161.6527 +荅括完ゃ
161.6528 +.na
161.6529 +\f2@see 帥違ャ<潟\fP @
161.6530 .fi
161.6531 -.LP
161.6532 -.TP
161.6533 -.BI \-group " groupheading packagepattern:packagepattern:..."
161.6534 -概要ページの複数のパッケージを指定のグループに分け、
161.6535 -グループ単位で表を作成
161.6536 -します。各グループは、それぞれ別の
161.6537 -.B \-group
161.6538 -オプションで指定します。これらのグループは、
161.6539 -コマンド行で指定した順序でページに
161.6540 -表示されます。パッケージは、1 つのグループ内では
161.6541 -アルファベット順に並べられます。各
161.6542 -.B \-group
161.6543 -オプションでは、
161.6544 -.I packagepattern
161.6545 -式のリストに一致する
161.6546 -パッケージが、見出し
161.6547 -.IR groupheading
161.6548 -を持つ 1 つの表にまとめて表示されます。
161.6549 -.RS
161.6550 -.TP 2
161.6551 -\(bu
161.6552 -.I groupheading
161.6553 -には任意のテキストを指定でき、空白を含めることができます。
161.6554 -指定したテキストは、グループの表見出しになります。
161.6555 -.TP 2
161.6556 -\(bu
161.6557 -.I packagepattern
161.6558 -には、任意のパッケージ名、または任意のパッケージ名の先頭部分とそれに続く 1 つのアスタリスク (*)を指定できます。
161.6559 -アスタリスクは、「任意の文字に一致する」という意味のワイルドカードです。ワイルドカードとして許容されるのは、アスタリスクだけです。1 つのグループには、
161.6560 -コロン (:) で区切った複数のパターンを含めることができます。
161.6561 -.LP
161.6562 -注: パターンやパターンリスト内でアスタリスクを
161.6563 -使う場合は、"java.lang*:java.util"
161.6564 -のように、パターンリストを引用符で囲む必要があります。
161.6565 -.LP
161.6566 -.B \-group
161.6567 -オプションが 1 つも指定されていない場合は、すべての
161.6568 -パッケージが、[パッケージ]
161.6569 -という見出しを持つ 1 つのグループに入れられます。
161.6570 -ドキュメント化されるパッケージの
161.6571 -中に、指定したグループのどのグループにも入らない
161.6572 -パッケージがある場合、このような
161.6573 -パッケージは [その他のパッケージ] という見出しを
161.6574 -持つ独立したグループに入れられます。
161.6575 -.LP
161.6576 -たとえば、次のようにオプションを指定すると、
161.6577 -ドキュメント化される 4 つのパッケージは、
161.6578 -コアパッケージ、拡張機能パッケージ、
161.6579 -およびその他のパッケージに分かれます。
161.6580 -\f3java.lang*\f1 では、後続のドットがないことに
161.6581 -注意してください。\f3java.lang.*\f1 のようにドットを
161.6582 -入れると、
161.6583 -.B java.lang
161.6584 -パッケージは含まれないことになります。
161.6585 -.LP
161.6586 -.RS
161.6587 -.ft 3
161.6588 -.nf
161.6589 -% javadoc \-group "Core Packages" "java.lang*:java.util"
161.6590 - \-group "Extension Packages" "javax.*"
161.6591 - java.lang java.lang.reflect java.util javax.servlet java.new
161.6592 -.fi
161.6593 -.ft 1
161.6594 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@seeс
161.6595 +.LP
161.6596 .RE
161.6597 .LP
161.6598 -この結果、次のようなグループ化が行われます。
161.6599 -.LP
161.6600 -.RS
161.6601 -.ft 3
161.6602 -.nf
161.6603 -Core Packages
161.6604 - java.lang
161.6605 - java.lang.reflect
161.6606 - java.util
161.6607 -Extension Packages
161.6608 - javax.servlet
161.6609 -Other Packages
161.6610 - java.new
161.6611 -.fi
161.6612 -.ft 1
161.6613 +
161.6614 +.LP
161.6615 +.RS 3
161.6616 +.TP 3
161.6617 +@serial\ field\-description | include | exclude
161.6618 +翫純c若ャ<潟若激с潟潟<潟т戎障
161.6619 .RE
161.6620 -.RE
161.6621 -.TP
161.6622 -.B \-nodeprecated
161.6623 -推奨されない API をドキュメントに生成することを禁止します。
161.6624 -これは、
161.6625 -.B \-nodeprecatedlist
161.6626 -オプションを指定した場合の動作に加えて、
161.6627 -ドキュメントのほかの部分を通じて、
161.6628 -推奨されない API を生成しないことと同じです。
161.6629 -このオプションは、コードを記述していて、
161.6630 -推奨されないコードを無視したい場合に便利です。
161.6631 -.TP
161.6632 -.B \-nodeprecatedlist
161.6633 -推奨されない API のリストを含む
161.6634 -ファイル (\f3deprecated-list.html\f1) の生成を禁止
161.6635 -します。また、このページへのリンクを
161.6636 -ナビゲーションバーに生成することを禁止します。
161.6637 -ただし、ドキュメントのほかの部分では、
161.6638 -推奨されない API の生成を続行します。この
161.6639 -オプションは、推奨されない API がソースコードに
161.6640 -含まれておらず、ナビゲーションバーを
161.6641 -すっきりと見せたい場合に便利です。
161.6642 -.TP
161.6643 -.B \-nosince
161.6644 -生成されるドキュメントから、
161.6645 -.BR @since
161.6646 -タグに関連した「Since」セクションを削除します。
161.6647 -.TP
161.6648 -.B \-notree
161.6649 -生成されるドキュメントからクラスおよびインタフェース
161.6650 -階層を省略します。これらのページには、ナビゲーションバーの「ツリー」ボタンからアクセスできます。
161.6651 -デフォルトでは、階層が作成されます。
161.6652 -.TP
161.6653 -.B \-noindex
161.6654 -生成されるドキュメントから索引を省略します。
161.6655 -デフォルトでは、
161.6656 -索引が作成されます。
161.6657 -.TP
161.6658 -.B \-nohelp
161.6659 -各出力ページの最上部と最下部の
161.6660 -ナビゲーションバーから [ヘルプ] リンクを
161.6661 -省略します。
161.6662 -.TP
161.6663 -.B \-nonavbar
161.6664 -生成されるページの最上部と最下部に表示される
161.6665 -ナビゲーションバー、ヘッダ、
161.6666 -およびフッタの生成を禁止します。
161.6667 -このオプションは、bottom オプションには影響しません。
161.6668 -.B \-nonavbar
161.6669 -オプションは、印刷するためだけに
161.6670 -ファイルを PostScript または PDF に変換する
161.6671 -場合など、内容だけが重要でナビゲーションの
161.6672 -必要性がない場合に便利です。
161.6673 -.TP
161.6674 -.BI \-helpfile " path/filename"
161.6675 -上部と下部のナビゲーションバーの [ヘルプ] リンクの
161.6676 -リンク先となる代替ヘルプファイル
161.6677 -.I path/filename
161.6678 -のパスを指定します。このオプションが指定されていない場合、
161.6679 -.B javadoc
161.6680 -は、javadoc にハードコードされているヘルプファイル
161.6681 -.B help-doc.html
161.6682 -を自動的に作成します。このオプションを使えば、
161.6683 -デフォルトの設定をオーバーライドでき
161.6684 -ます。ファイル名にはどのような
161.6685 -名前も指定でき、\f3help-doc.html\f1 には限定されま
161.6686 -せん。
161.6687 -.B javadoc
161.6688 -は、それに従って、ナビゲーションバーにある
161.6689 -リンクに調整を加えます。
161.6690 -次に例を示します。
161.6691 -.LP
161.6692 -.RS
161.6693 -.RS
161.6694 -.ft 3
161.6695 -.nf
161.6696 -% javadoc \-helpfile /home/doc/myhelp.html java.awt
161.6697 -.fi
161.6698 -.RE
161.6699 -.RE
161.6700 -.ft 1
161.6701 -.TP
161.6702 -.BI \-stylesheetfile " path/filename"
161.6703 -代替 HTML スタイルシートファイルのパスを指定します。
161.6704 -このオプションが指定されてい
161.6705 -ない場合、
161.6706 -.B javadoc
161.6707 -ツールは、内部的にハードコードされている
161.6708 -スタイルシートファイル
161.6709 -.BR stylesheet.css
161.6710 -を自動的に作成します。このオプションを使えば、
161.6711 -デフォルトの設定をオーバーライドできます。
161.6712 -filename にはどんなファイル名でも指定でき、
161.6713 -.BR stylesheet.css
161.6714 -には限定されません。
161.6715 -次に例を示します。
161.6716 -.LP
161.6717 -.RS
161.6718 -.RS
161.6719 -.ft 3
161.6720 -.nf
161.6721 -% javadoc \-stylesheetfile /home/user/mystylesheet.css com.mypackage
161.6722 -.fi
161.6723 -.ft 1
161.6724 -.RE
161.6725 -.RE
161.6726 -.TP
161.6727 -.B \-serialwarn
161.6728 -.B @serial
161.6729 -タグがない場合、コンパイル時に警告を生成します。デフォルトでは、
161.6730 -.B javadoc
161.6731 -1.2.2 (およびそれ以降) は
161.6732 -.B @serial
161.6733 -の警告を生成しません。
161.6734 -(これは、以前のバージョンとは逆です。)
161.6735 -.B @serial
161.6736 -の警告を生成するには、
161.6737 -このオプションを使用してください。このオプションは、デフォルトの
161.6738 -直列化可能なフィールドと writeExternal メソッドを正しく
161.6739 -ドキュメント化するのに役立ちます。
161.6740 -.TP
161.6741 -.BI \-charset " name"
161.6742 -このドキュメント用の HTML 文字セットを指定します。この名前は、
161.6743 -.na
161.6744 -\f2IANA Registry\fP
161.6745 -.fi
161.6746 -(http://www.iana.org/assignments/character\-sets) で与えられた、推奨される MIME 名でなければなりません。次に例を示します。
161.6747 -.nf
161.6748 -\f3
161.6749 -.fl
161.6750 - % \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
161.6751 -.fl
161.6752 -.fi
161.6753 -生成されるすべてのページの先頭に、次の行が挿入されます。
161.6754 -.nf
161.6755 -\f3
161.6756 -.fl
161.6757 - <META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">
161.6758 -.fl
161.6759 -\fP
161.6760 -.fi
161.6761 -この META タグについては、
161.6762 -.fi
161.6763 -http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2
161.6764 -の
161.6765 -.na
161.6766 -\f2HTML の標準\fP (4197265 および 4137321) を参照してください。
161.6767 -.LP
161.6768 -\-encoding と \-docencoding も参照してください。
161.6769 -.LP
161.6770 -.TP 3
161.6771 -\-docencoding\ name
161.6772 -生成される HTML ファイルのエンコーディングを指定します。この名前は、
161.6773 -.na
161.6774 -\f2IANA Registry\fP
161.6775 -.fi
161.6776 -(http://www.iana.org/assignments/character\-sets) で与えられた、推奨される MIME 名でなければなりません。このオプションを省略しながら \-encoding を使用した場合、生成される HTML ファイルのエンコードは、\-encoding によって決められます。次に例を示します。
161.6777 -.nf
161.6778 -\f3
161.6779 -.fl
161.6780 - % \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
161.6781 -.fl
161.6782 -.fi
161.6783 -\-encoding および \-charset も参照してください。
161.6784 -.LP
161.6785 -.TP 3
161.6786 -\-keywords
161.6787 -HTML メタキーワードタグを、クラスごとに生成されるファイルに追加します。これらのタグは、メタタグを検索するサーチエンジンがページを見つける場合に役立ちます。インターネット全体を検索する多くのサーチエンジンは、ページがメタタグを誤用しているため、メタタグを調べません。一方、検索を自身の Web サイトに限定している企業では、サーチエンジンがメタタグを調べることによってメリットを得られます。
161.6788 -.LP
161.6789 -メタタグには、クラスの完全修飾名と、フィールドおよびメソッドの修飾されていない名前が含まれます。コンストラクタは、クラス名と同じであるため含まれません。たとえば、クラス String は次のキーワードで開始します。
161.6790 -.nf
161.6791 -\f3
161.6792 -.fl
161.6793 - <META NAME="keywords" CONTENT="java.lang.String class">
161.6794 -.fl
161.6795 - <META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">
161.6796 -.fl
161.6797 - <META NAME="keywords" CONTENT="length()">
161.6798 -.fl
161.6799 - <META NAME="keywords" CONTENT="charAt()">
161.6800 -.fl
161.6801 -\fP
161.6802 -.fi
161.6803 -.LP
161.6804 -.TP 3
161.6805 -\-tag\ \ tagname:Xaoptcmf:"taghead"
161.6806 -Javadoc ツールがドキュメンテーションコメント内の引数を 1 つ取る単純なカスタムブロックタグ \f2@\fP\f2tagname\fP を解釈できるようにします。これにより、Javadoc ツールはタグ名の「スペルチェック」を行うことができるので、ソースコード内のすべてのカスタムタグに \f2\-tag\fP オプションを組み込むことをお勧めします。今回の実行で出力されないタグは、\f2X\fP を付けて無効にします。
161.6807 -.LP
161.6808 -コロン (\f4:\fP) は常に区切り文字になります。\f2tagname\fP でコロンを使用するには、「タグ名でのコロンの使用」を参照してください。
161.6809 -.LP
161.6810 -\f2\-tag\fP オプションは、タグの見出し「\f2taghead\fP」を太字で出力します。その次の行には、このオプションの引数で指定したテキストが続きます。以下の例を参照してください。ブロックタグと同様、この引数のテキストにはインラインタグを含めることができます。このインラインタグも解釈されます。出力は、引数を 1 つ取る標準のタグ (\f2@return\fP、\f2@author\fP など) の出力とよく似ています。\f2taghead\fP を省略すると、\f2tagname\fP が見出しとして表示されます。
161.6811 -.LP
161.6812 -\f3タグの配置\fP \- 引数の \f4Xaoptcmf\fP 部分は、ソースコード内のタグを配置できる位置と、\f2X\fP を使ってこのタグを無効にできるかどうかを特定します。タグの配置位置を制限しない場合は \f4a\fP を指定します。それ以外の文字の組み合わせも可能です。
161.6813 -.br
161.6814 -\f4X\fP (タグの無効化)
161.6815 -.br
161.6816 -\f4a\fP (すべての位置)
161.6817 -.br
161.6818 -\f4o\fP (概要)
161.6819 -.br
161.6820 -\f4p\fP (パッケージ)
161.6821 -.br
161.6822 -\f4t\fP (型すなわちクラスおよびインタフェース)
161.6823 -.br
161.6824 -\f4c\fP (コンストラクタ)
161.6825 -.br
161.6826 -\f4m\fP (メソッド)
161.6827 -.br
161.6828 -\f4f\fP (フィールド)
161.6829 -.LP
161.6830 -シングルタグの例 -
161.6831 -ソースコードの任意の場所で使用できる
161.6832 -タグのタグオプションの例を示します。
161.6833 -.LP
161.6834 -.RS
161.6835 -.TP 3
161.6836 -\-tag todo:a:"To Do:"
161.6837 -.RE
161.6838 -.LP
161.6839 -コンストラクタ、メソッド、およびフィールドだけで @todo を
161.6840 -使用させるには、次のようにします。
161.6841 -.LP
161.6842 -.RS
161.6843 -.ft 3
161.6844 -.nf
161.6845 -\-tag todo:cmf:"To Do:"
161.6846 -.fi
161.6847 -.ft 1
161.6848 -.RE
161.6849 -.LP
161.6850 -上記では、末尾のコロン (:) がパラメータの
161.6851 -区切り記号ではなく、表示のとおり、
161.6852 -見出しテキストの一部であることに注意してください。
161.6853 -次のように、@todo タグを含むソースコードに
161.6854 -どちらかのタグオプションを使用します。
161.6855 -.LP
161.6856 -.RS
161.6857 -.ft 3
161.6858 -.nf
161.6859 -@todo The documentation for this method needs work.
161.6860 -.fi
161.6861 -.ft 1
161.6862 -.LP
161.6863 -タグ名にコロンを使用する \-
161.6864 -コロン (:) をバックスラッシュでエスケープすると、
161.6865 -コロンをタグ名に使用することができます。
161.6866 -.LP
161.6867 -.RS 5
161.6868 -.nf
161.6869 -/**
161.6870 -* @ejb:bean
161.6871 -*/
161.6872 -.RE
161.6873 -.fi
161.6874 -.LP
161.6875 -でこのタグオプションを使用すると、
161.6876 -.LP
161.6877 -.RS 5
161.6878 -.nf
161.6879 -\-tag ejb\\:bean:a:"EJB Bean:"
161.6880 -.RE
161.6881 -.LP
161.6882 -となります。
161.6883 -.fi
161.6884 -.ft 1
161.6885 -.RE
161.6886 -.LP
161.6887 -タグ名のスペルチェック (タグの無効化) - 開発者は、ソースコードの中で出力できないカスタムタグを使用することがあります。その場合、ソースタグに存在するすべてのタグをリストし、出力するタグを有効化し、出力しないタグを無効化することが重要です。 X を使用するとタグを無効化でき、これがない場合はタグが有効となります。 この文字の存在によって、
161.6888 -.B Javadoc
161.6889 -ツールは、検出したタグが未知のタグで、おそらく綴り間違いであると判断できます。 この場合、警告メッセージが表示されます。
161.6890 -.LP
161.6891 -すでに存在する、配置を指定する引数の値に X を追加した場合、タグを有効にしたいときに X を削除できます。 たとえば、@todo が出力したくないタグの場合、次のようにします。
161.6892 -.LP
161.6893 -.RS
161.6894 -.ft 3
161.6895 -.nf
161.6896 -\-tag todo:Xcmf:"To Do:"
161.6897 -.fi
161.6898 -.ft 1
161.6899 -.RE
161.6900 -.LP
161.6901 -または、次のようにより簡単にすることもできます。
161.6902 -.LP
161.6903 -.RS
161.6904 -.ft 3
161.6905 -.nf
161.6906 -\-tag todo:X
161.6907 -.fi
161.6908 -.ft 1
161.6909 -.RE
161.6910 -.LP
161.6911 -\-tag todo:X の構文は、@todo がタグレットで
161.6912 -定義されている場合も有効です。
161.6913 -.LP
161.6914 -タグの順序 -
161.6915 -\-tag (および \-taglet) オプションの順序に従って
161.6916 -タグが出力されます。 カスタムタグと標準タグを
161.6917 -混在させることができます。 標準タグのタグオプションは、
161.6918 -順序を決定するためだけのプレースホルダです。
161.6919 -これらは標準タグ名だけを使用します
161.6920 -(標準タグの小見出しは変更できません)。
161.6921 -これを次の例に示します。
161.6922 -.LP
161.6923 -\-tag がない場合、\-taglet の場所によってその順序が決まります。
161.6924 -この 2 つが両方ある場合は、コマンド行の最後に使用された方が
161.6925 -順序を決定します (これは、タグとタグレットが、
161.6926 -コマンド行で使用された順に処理されるためです)。
161.6927 -たとえば、\-taglet と \-tag が両方とも todo という
161.6928 -名前である場合、コマンド行の最後で使用された
161.6929 -方が順序を決定します。
161.6930 -.LP
161.6931 -タグの完全なセットの例 -
161.6932 -この例では、出力の Parameters と Throws の間に
161.6933 -To Do を挿入します。 「X」を使用して、@example が
161.6934 -ソースコード内の今回の実行で出力されないタグで
161.6935 -あることを指定できます。 @argfile を使用すると、
161.6936 -次のように行の継続文字なしで、
161.6937 -引数ファイルの異なる行にタグを配置できます。
161.6938 -.LP
161.6939 -.RS
161.6940 -.ft 3
161.6941 -.nf
161.6942 -\-tag param
161.6943 -\-tag return
161.6944 -\-tag todo:a:"To Do:"
161.6945 -\-tag throws
161.6946 -\-tag see
161.6947 -\-tag example:X
161.6948 -.fi
161.6949 -.ft 1
161.6950 -.RE
161.6951 -.LP
161.6952 -javadoc がドキュメンテーションコメントを解析する際に、
161.6953 -検出されたタグのうち、標準タグでもなく、
161.6954 -\-tag や \-taglet で渡されるタグでもないものは、
161.6955 -不明なタグとして認識し、警告がスローされます。
161.6956 -.LP
161.6957 -標準タグは、最初、デフォルトの順序で
161.6958 -リスト内部的に格納されます。
161.6959 -\-tag オプションを使用すると、このタグがリストに追加されます。
161.6960 -標準タグはデフォルトの位置から移動します。
161.6961 -そのため、標準タグで \-tag オプションが省略されると、
161.6962 -デフォルトの位置に配置されたままになります。
161.6963 -.LP
161.6964 -競合の回避 -
161.6965 -固有のネームスペースを細かく分けるには、
161.6966 -パッケージに使用されている com.mycompany.todo
161.6967 -という名前のように、ドット (.) を区切り記号とする名前を使います。
161.6968 -Sun は今後もドットを含まない標準タグを作成します。
161.6969 -ユーザが作成したタグは、Sun が定義した同じ
161.6970 -名前のタグの動作をオーバーライドします。
161.6971 -つまり、ユーザが @todo という名前のタグまたは
161.6972 -タグレットを作成していた場合、そのあとで Sun が
161.6973 -同じ名前の標準タグを作成しても、ユーザが定義した
161.6974 -動作はそのまま維持されます。
161.6975 -.LP
161.6976 -\f3注釈 vs. Javadoc タグ\fP \- 一般に、追加する必要のあるマークアップが、ドキュメンテーションに影響を与えたりドキュメンテーションを生成したりするためのものである場合、そのマークアップは javadoc タグにすべきです。それ以外の場合は注釈にすべきです。
161.6977 -.na
161.6978 -「\f2Comparing Annotations and Javadoc Tags\fP」
161.6979 -.fi
161.6980 -(http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotations) を参照してください。
161.6981 -.LP
161.6982 -\-taglet オプションを使用して、より複雑な
161.6983 -スタンドアロンタグやカスタムインラインタグを
161.6984 -作成することができます。
161.6985 -.TP
161.6986 -\-taglet class
161.6987 -タグのドキュメントの生成に使うタグレットを起動するための
161.6988 -クラスファイルを指定します。
161.6989 -クラスの完全修飾名を指定してください。
161.6990 -このタグレットは、カスタムタグが持っているテキスト引数の
161.6991 -数も定義します。 タグレットはこれらの引数を受け取り、
161.6992 -処理し、出力を生成します。 タグレットの例の詳細については、
161.6993 -タグレットの概要を参照してください。
161.6994 -.LP
161.6995 -タグレットはスタンドアロンタグまたはインラインタグに
161.6996 -使用すると便利です。 タグレットでは任意の
161.6997 -数の引数を持つことができ、カスタムの動作を実装できます。
161.6998 -たとえば、テキストを太字にしたり、箇条書き形式にしたり、
161.6999 -テキストをファイルに書き出したり、
161.7000 -他のプロセスを起動したりすることができるのです。
161.7001 -.LP
161.7002 -タグレットで指定できるのは、タグの配置場所と配置形式のみです。その他のすべての決定は、ドックレットによって行われます。タグレットを使用しても、包含クラスのリストからクラス名を削除するなどの処理は実行できません。ただし、タグのテキストをファイルに出力したり、別のプロセスをトリガするなどの副作用は得られます。
161.7003 -.LP
161.7004 -タグレットへのパスを指定するには、
161.7005 -.B \-tagletpath
161.7006 -オプションを使用します。
161.7007 -生成されたページの Parameters と Throws の間に
161.7008 -To Do タグレットを挿入する例を示します。
161.7009 -.LP
161.7010 -.RS
161.7011 -.ft 3
161.7012 -.nf
161.7013 -\-taglet com.sun.tools.doclets.ToDoTaglet
161.7014 -\-tagletpath /home/taglets
161.7015 -\-tag return
161.7016 -\-tag param
161.7017 -\-tag todo
161.7018 -\-tag throws
161.7019 -\-tag see
161.7020 -.fi
161.7021 -.ft 1
161.7022 -.RE
161.7023 -.LP
161.7024 -.B \-taglet
161.7025 -オプションを
161.7026 -.B \-tag
161.7027 -オプションの代わりに使用することもできますが、
161.7028 -その結果、読みにくくなります。
161.7029 -.TP
161.7030 -\-tagletpath tagletpathlist
161.7031 -taglet クラスファイル (.class) を探すための検索パスを指定します。
161.7032 -.I tagletpathlist
161.7033 -には、コロン (:) で
161.7034 -区切って複数のパスを含めることができます。
161.7035 -.B Javadoc
161.7036 -ツールは、指定されたパス以下のすべての
161.7037 -サブディレクトリを検索します。
161.7038 -.TP
161.7039 -\-docfilessubdirs
161.7040 -doc-files ディレクトリを、下の階層を含めてコピー
161.7041 -できるようにします。 つまり、サブディレクトリとすべての
161.7042 -コンテンツが、生成先ディレクトリに再帰的にコピーされます。
161.7043 -たとえば、
161.7044 -.BR doc-files/example/images
161.7045 -ディレクトリとその中のファイルがコピーされます。
161.7046 -サブディレクトリを除外するためのオプションもあります。
161.7047 -.TP
161.7048 -\-excludedocfilessubdirs name1:name2:...
161.7049 -doc-files のサブディレクトリで、指定された
161.7050 -名前のものを除外します。 このオプションを使用すると、
161.7051 -SCCS およびその他のソースコード管理の
161.7052 -サブディレクトリをコピーしないようにできます。
161.7053 -.TP
161.7054 -\-noqualifier all | packagename1:packagename2:...
161.7055 -修飾パッケージ名を、出力のクラス名の前から削除します。
161.7056 -\-noqualifier の引数は
161.7057 -all (すべてのパッケージ修飾子を削除)、
161.7058 -またはコロンで区切られたパッケージリストの
161.7059 -いずれかで、修飾子として削除されます。
161.7060 -ワイルドカードも使用できます。
161.7061 -パッケージ名はクラス名またはインタフェース名が
161.7062 -表示されたところから削除されます。
161.7063 -.LP
161.7064 -次の例では、すべてのパッケージ修飾子を省略します。
161.7065 -.LP
161.7066 -.RS
161.7067 -.ft 3
161.7068 -.nf
161.7069 -\-noqualifier all
161.7070 -.fi
161.7071 -.ft 1
161.7072 -.RE
161.7073 -.LP
161.7074 -次の例では、パッケージ修飾子 java.lang
161.7075 -および java.io を省略します。
161.7076 -.LP
161.7077 -.RS
161.7078 -.ft 3
161.7079 -.nf
161.7080 -\-noqualifier java.lang:java.io
161.7081 -.fi
161.7082 -.ft 1
161.7083 -.RE
161.7084 -.LP
161.7085 -次の例では、java および com.sun から
161.7086 -始まる (javax を除く)
161.7087 -サブパッケージのパッケージ修飾子を削除します。
161.7088 -.LP
161.7089 -.RS
161.7090 -.ft 3
161.7091 -.nf
161.7092 -\-noqualifier java.*:com.sun.*
161.7093 -.fi
161.7094 -.ft 1
161.7095 -.RE
161.7096 -.LP
161.7097 -パッケージ修飾子が上記の動作に従って表示される場合、名前は適切に短くされます。詳細は「名前の表示方法」を参照してください。この規則は、
161.7098 -\-noqualifier が
161.7099 -使用されているかどうかにかかわらず存在します。
161.7100 -.TP
161.7101 -.BI \-notimestamp
161.7102 -タイムスタンプが抑制されます。
161.7103 -各ページ先頭近くにある、生成された HTML 内の
161.7104 -HTML コメントでタイムスタンプが隠されます。
161.7105 -.B Javadoc
161.7106 -を 2 つのソースベースで実行し、それらに対して
161.7107 -diff を実行するときにこのオプションを使用すると、
161.7108 -タイムスタンプによって diff が発生しなくなるので
161.7109 -便利です (このオプションを使用しないと、
161.7110 -各ページで diff になります)。
161.7111 -タイムスタンプには
161.7112 -.B Javadoc
161.7113 -のバージョン番号が含まれており、
161.7114 -次のようになります。
161.7115 -.LP
161.7116 -.RS 5
161.7117 - <!-- Generated by javadoc (build 1.5.0-internal)
161.7118 - on Tue Jun 22 09:57:24 PDT 2004 -->
161.7119 -.RE
161.7120 -.TP
161.7121 -\-nocomment
161.7122 -記述およびすべてのタグを含むコメント
161.7123 -本文全体を抑制し、宣言だけを生成します。
161.7124 -このオプションにより、元は異なる目的のためだった
161.7125 -ソースファイルを再利用し、
161.7126 -新しいプロジェクトのためのスケルトンを
161.7127 -作成できるようになりました。
161.7128 -.SS コマンド行引数ファイル
161.7129 -.BR javadoc
161.7130 -のコマンド行を短くしたり簡潔にしたりするために、
161.7131 -.BR javadoc
161.7132 -コマンドに対する引数 (\-J オプションを除く) が
161.7133 -入った 1 つ以上のファイルを指定することができます。
161.7134 -このことを利用すれば、どのオペレーティングシステム
161.7135 -上でも、任意の長さの
161.7136 -.BR javadoc
161.7137 -コマンドを作成できます。
161.7138 -.LP
161.7139 -引数ファイルには、javac オプションとソースファイル名を
161.7140 -自由に組み合わせて記述できます。
161.7141 -また、Javadoc オプションに対する引数だけを記述してもかまいません。
161.7142 -ファイル内の各引数は、空白文字または改行で区切ります。
161.7143 -ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲む必要があります。
161.7144 -.LP
161.7145 -.LP
161.7146 -引数ファイル内のファイル名は、
161.7147 -現在のディレクトリから見た相対パスになります。
161.7148 -引数ファイルの位置から見た相対パスではありません。
161.7149 -引数ファイル内のファイル名リストでは、
161.7150 -ワイルドカード (*) は使用できません。
161.7151 -たとえば、*.java とは指定できません。
161.7152 -引数ファイル内の引数で @ 文字を使用して、
161.7153 -複数のファイルを再帰的に解釈することはサポートされていません。
161.7154 -また、\-J オプションもサポートされていません。
161.7155 -このオプションは起動ツールに渡されますが、
161.7156 -起動ツールでは引数ファイルをサポートしていないからです。
161.7157 -.LP
161.7158 -.BR javadoc
161.7159 -を実行するときに、各引数ファイルのパスとファイル名の
161.7160 -先頭に @ 文字を付けて渡します。
161.7161 -.BR javadoc
161.7162 -は、@ 文字で始まる引数を見つけると、
161.7163 -そのファイルの内容を展開して引数リストに挿入します。
161.7164 -.LP
161.7165 -引数ファイルを 1 つ指定する例
161.7166 -.LP
161.7167 -argfile という名前の引数ファイルにすべての
161.7168 -Javadoc 引数を格納し、次のように使用することができます。
161.7169 -.LP
161.7170 -.RS
161.7171 -.ft 3
161.7172 -.nf
161.7173 -% javadoc @argfile
161.7174 -.fi
161.7175 -.ft 1
161.7176 -.RE
161.7177 -.LP
161.7178 -この引数ファイルには、次の例で示されている
161.7179 -2 つのファイルの内容を両方とも入れることができます。
161.7180 -.LP
161.7181 -引数ファイルを 2 つ指定する例
161.7182 -.LP
161.7183 -Javadoc オプション用に 1 つ、パッケージ名またはソースファイル名用に
161.7184 -1 つというように、2 つの引数ファイルを作成し、
161.7185 -次のようにして使用することができます。
161.7186 -なお、このあとのリストでは、行の継続文字を使用していません。
161.7187 -.LP
161.7188 -以下の内容を含む options という名前のファイルを作成します。
161.7189 -.LP
161.7190 -.RS
161.7191 -.ft 3
161.7192 -.nf
161.7193 -\-d docs-filelist
161.7194 -\-use
161.7195 -\-splitindex
161.7196 -\-windowtitle 'Java 2 Platform v1.3 API Specification'
161.7197 -\-doctitle 'Java<sup><font size="-2">TM</font></sup> 2\\
161.7198 - Platform 5.0 API Specification'
161.7199 -\-header '<b>Java 2 Platform </b><br><font size="-1">5.0</font>'
161.7200 -\-bottom 'Copyright 1993-2000 Sun Microsystems, Inc. All Rights Reserved.'
161.7201 -\-group "Core Packages" "java.*"
161.7202 -\-overview /java/pubs/ws/1.5/src/share/classes/overview-core.html
161.7203 -\-sourcepath /java/pubs/ws/1.5/src/share/classes
161.7204 -.fi
161.7205 -.ft 1
161.7206 -.RE
161.7207 -.LP
161.7208 -以下の内容を含む packages という名前のファイルを作成します。
161.7209 -.LP
161.7210 -.RS
161.7211 -.ft 3
161.7212 -.nf
161.7213 -com.mypackage1
161.7214 -com.mypackage2
161.7215 -com.mypackage3
161.7216 -.fi
161.7217 -.ft 1
161.7218 -.RE
161.7219 -.LP
161.7220 -そのあと、次のコマンドを使用して javadoc を実行します。
161.7221 -.LP
161.7222 -.RS
161.7223 -.ft 3
161.7224 -.nf
161.7225 -% javadoc @options @packages
161.7226 -.fi
161.7227 -.ft 1
161.7228 -.RE
161.7229 -.LP
161.7230 -パス付きの引数ファイルの例
161.7231 -.LP
161.7232 -引数ファイルには、パスを指定できます。
161.7233 -ただし、そのファイル内に指定されたファイル名は、
161.7234 -現在の作業ディレクトリから見た相対パスになります。
161.7235 -つまり、下の例の場合は、path1 や
161.7236 -path2 から見た相対パスではありません。
161.7237 -.LP
161.7238 -.RS
161.7239 -.ft 3
161.7240 -.nf
161.7241 -% javadoc @path1/options @path2/packages
161.7242 -.fi
161.7243 -.ft 1
161.7244 -.RE
161.7245 -.LP
161.7246 -オプションの引数の例
161.7247 -.LP
161.7248 -次に、javadoc オプションに対する引数だけを引数ファイルに
161.7249 -格納する例を示します。 ここでは、\-bottom オプションを
161.7250 -例に取り上げます。そのオプションには、
161.7251 -かなり長い引数を指定することがあるからです。
161.7252 -まず、このオプションのテキスト引数になる
161.7253 -次のような内容を含む、bottom という名前の
161.7254 -ファイルを作成します。
161.7255 -.LP
161.7256 -'<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">
161.7257 -Submit a bug or feature</a><br><br>Java is a
161.7258 -trademark or registered trademark of
161.7259 -Sun Microsystems, Inc. in the US and other
161.7260 -countries.<br>Copyright 1993-2000 Sun
161.7261 -Microsystems, Inc. 901 San Antonio Road,<br>Palo
161.7262 -Alto, California, 94303, U.S.A.
161.7263 -All Rights Reserved.</font>'
161.7264 -.LP
161.7265 -そのあと、次のようにして
161.7266 -.B javadoc
161.7267 -ツールを実行します。
161.7268 -.LP
161.7269 -.TP 3
161.7270 -% javadoc \-bottom @bottom @packages
161.7271 -.LP
161.7272 -また、引数ファイルの先頭に
161.7273 -\-bottom オプションを組み込んでおけば、次のようにして実行できます。
161.7274 -.LP
161.7275 -.RS
161.7276 -.ft 3
161.7277 -.nf
161.7278 -% javadoc @bottom @packages
161.7279 -.fi
161.7280 -.ft 1
161.7281 -.RE
161.7282 -.TP
161.7283 -.SH 実行
161.7284 -.SS Javadoc の実行
161.7285 -バージョン番号 -
161.7286 -.LP
161.7287 -javadoc のバージョン番号は
161.7288 -.BR javadoc \-J\-version
161.7289 -を使用することで確認できます。
161.7290 -標準ドックレットのバージョン番号は出力ストリームに
161.7291 -表示されます。
161.7292 -これは \-quiet オプションでオフにできます。
161.7293 -.LP
161.7294 -プログラムから利用できる public インタフェース -
161.7295 -Java 言語で書かれたプログラム内から
161.7296 -.B javadoc
161.7297 -ツールを呼び出します。
161.7298 -このインタフェースは
161.7299 -.BR com.sun.tools.javadoc.Main
161.7300 -(javadoc は再入)
161.7301 -にあります。 詳細は、「標準ドックレット」
161.7302 -を参照してください。
161.7303 -.LP
161.7304 -\f3ドックレットの実行\fP \-
161.7305 -下記の説明は、標準 HTML ドックレットを呼び出すためのものです。カスタムドックレットを呼び出すには、\-doclet および \-docletpath オプションを使用します。特定のドックレットを実行した完全な例については、
161.7306 -.na
161.7307 -「\f2Running the MIF Doclet\fP」
161.7308 -.fi
161.7309 -(http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet) を参照してください。
161.7310 -.LP
161.7311 -.SH "使用例"
161.7312 -.B javadoc
161.7313 -は、パッケージ全体に対して実行することも、
161.7314 -個々のソースファイルに対して実行することも
161.7315 -できます。各パッケージ名は、それぞれの
161.7316 -パッケージ名に対応するディレクトリ名を
161.7317 -持ちます。次の例では、ソースファイルは
161.7318 -.BR /home/src/java/awt/*java
161.7319 -にあります。生成先ディレクトリは
161.7320 -.BR /home/html
161.7321 -です。
161.7322 -.SS "1 つ以上のパッケージのドキュメント化"
161.7323 -パッケージをドキュメント化するには、その
161.7324 -パッケージのソースファイル (*\f3.java\f1)
161.7325 -が、パッケージと同じ名前を持つディレクトリ
161.7326 -内に存在していなければなりません。
161.7327 -パッケージ名が複数の識別子で構成されている
161.7328 -(java.awt.color のように、各識別子はドットで
161.7329 -区切られている) 場合は、後続の各識別子が下位の
161.7330 -サブディレクトリに対応して
161.7331 -いなければなりません (java/awt/color など)。
161.7332 -1 つのパッケージのための複数のソースファイルを、
161.7333 -異なる場所にある 2 つのディレクトリツリーに分けて
161.7334 -格納することも可能です
161.7335 - (
161.7336 -.BR src1/java/awt/color
161.7337 -と
161.7338 -.BR src2/java/awt/color
161.7339 -など)。
161.7340 -ただし、その場合は、\-sourcepath によって、
161.7341 -その両方の場所を指定しなければなりません。
161.7342 -.LP
161.7343 -.B javadoc
161.7344 -を実行するには、cd コマンドを使って
161.7345 -ディレクトリを変更するか、
161.7346 -または
161.7347 -.B \-sourcepath
161.7348 -オプションを使用します。
161.7349 -それぞれの例を次に示します。
161.7350 -.TP 2
161.7351 -\(bu
161.7352 -.B ケース 1 - 1 つ以上のパッケージからの起動を再帰的に実行 -
161.7353 -この例では javadoc が任意のディレクトリから実行できるように、
161.7354 -.BR \-sourcepath
161.7355 -を使用し、再帰的処理のために -subpackages (1.4 の新オプション) を使用します。 これは、java のサブパッケージ (
161.7356 -.BR java.net
161.7357 -および
161.7358 -.BR java.lang
161.7359 -をルートとするパッケージを除く) を処理します。
161.7360 -これによって
161.7361 -.BR java.lang.ref (
161.7362 -.BR java.lang
161.7363 -のサブパッケージ) が
161.7364 -除外されることに注意してください。
161.7365 -.LP
161.7366 -.RS
161.7367 -.ft 3
161.7368 -.nf
161.7369 -% javadoc \-d /home/html \-sourcepath /home/src \-subpackages java \-exclude java.net:java.lang
161.7370 -.fi
161.7371 -.ft 1
161.7372 -.RE
161.7373 -.LP
161.7374 -他のパッケージツリーを処理するには、
161.7375 -.BR java:javax:org.xml.sax
161.7376 -のように、その名前を
161.7377 -.BR \-subpackages
161.7378 -引数に追加します。
161.7379 -.TP 2
161.7380 -\(bu
161.7381 -.B ケース 2 - ルートソースディレクトリに移ってから明示的なパッケージを実行 -
161.7382 -完全修飾パッケージの
161.7383 -親ディレクトリに移動します。
161.7384 -次に、ドキュメント化する
161.7385 -1 つ以上のパッケージ名を指定して
161.7386 -.BR javadoc
161.7387 -を実行します。
161.7388 -.LP
161.7389 -.RS
161.7390 -.ft 3
161.7391 -.nf
161.7392 -% cd /home/src/
161.7393 -% javadoc \-d /home/html java.awt java.awt.event
161.7394 -.fi
161.7395 -.ft 1
161.7396 -.RE
161.7397 -.TP 2
161.7398 -\(bu
161.7399 -.B ケース 3 - 任意のディレクトリから実行。ソースファイルは 1 つのディレクトリツリー内にある - このケースでは、現在のディレクトリがどこであってもかまいません。 トップレベルのパッケージの親ディレクトリを
161.7400 -.B \-sourcepath
161.7401 -に指定し、ドキュメント化する 1 つ以上のパッケージ名を指定して、
161.7402 -.B javadoc
161.7403 -を実行します。
161.7404 -.LP
161.7405 -.RS
161.7406 -.ft 3
161.7407 -.nf
161.7408 - % javadoc -d /home/html -sourcepath /home/src java.awt java.awt.event
161.7409 -.fi
161.7410 -.ft 1
161.7411 -.RE
161.7412 -.TP 2
161.7413 -\(bu
161.7414 -.B ケース 4 - 任意のディレクトリから実行。ソースファイルは複数のディレクトリツリー内にある - これはケース 3 と似ていますが、パッケージが複数のディレクトリツリーに存在します。 各ツリーのルートへのパスを
161.7415 -.B \-sourcepath
161.7416 -に指定し (コロンで区切る)、ドキュメント化する 1 つ以上のパッケージ名を指定して、javadoc を実行します。 1 つのパッケージのすべてのソースファイルが、1 つのルートディレクトリの下に存在しなければならない、ということはありません。ソースパスとして指定された場所のどこかで見付かれば十分です。
161.7417 -.LP
161.7418 -.RS
161.7419 -.ft 3
161.7420 -.nf
161.7421 -% javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java.awt java.awt.event
161.7422 -.fi
161.7423 -.ft 1
161.7424 -.RE
161.7425 -.LP
161.7426 -結果: どちらのケースでも、パッケージ
161.7427 -.B java.awt
161.7428 -と
161.7429 -.B java.awt.event
161.7430 -の public および protected
161.7431 -なクラスとインタフェースを対象に、HTML 形式の
161.7432 -ドキュメントが生成され、指定
161.7433 -された生成先ディレクトリ (\f3/home/html\f1) に HTML ファイルが
161.7434 -保存されます。2 つ
161.7435 -以上のパッケージが生成されるので、ドキュメントは、
161.7436 -パッケージのリスト、クラスのリスト、
161.7437 -およびメインページの 3 つのフレームを持つことになります。
161.7438 -.SS "1 つ以上のクラスのドキュメント化"
161.7439 -.B javadoc
161.7440 -ツールを実行する 2 番目の方法は、1 つ以上のソースファイル (
161.7441 -.B .java
161.7442 -) を渡すことです。
161.7443 -.B javadoc
161.7444 -は、次の 2 つのどちらかの方法で実行できます。
161.7445 -1 つは、(cd によって) ディレクトリを
161.7446 -変更する方法、もう 1 つは
161.7447 -.B .java
161.7448 -ファイルへのパスを完全指定する方法です。
161.7449 -相対パスは、現在のディレクトリからの相対パスです。
161.7450 -ソースファイルを渡した場合、
161.7451 -.B \-sourcepath
161.7452 -オプションは無視されます。
161.7453 -アスタリスク (*) の
161.7454 -ようなコマンド行ワイルドカードを使用すると、
161.7455 -クラスのグループを指定できます。
161.7456 -.TP 2
161.7457 -\(bu
161.7458 -.B ケース 1 ソースディレクトリへの移動:
161.7459 -.B .java
161.7460 -ファイルのあるディレクトリに移動します。
161.7461 -次に、ドキュメント化する 1 つ以上の
161.7462 -ソースファイルの名前を指定して
161.7463 -.BR javadoc
161.7464 -を実行します。
161.7465 -.LP
161.7466 -.RS
161.7467 -.ft 3
161.7468 -.nf
161.7469 -% cd /home/src/java/awt
161.7470 -% javadoc \-d /home/html Button.java Canvas.java Graphics*.java
161.7471 -.fi
161.7472 -.ft 1
161.7473 -.RE
161.7474 -.LP
161.7475 -.RS 2
161.7476 -この例では、クラス Button と Canvas、
161.7477 -および先頭が Graphics で始まるクラスの
161.7478 -HTML 形式のドキュメントが生成されます。
161.7479 -.BR javadoc
161.7480 -の引数として渡されているのは、
161.7481 -パッケージ名ではなくソースファイルなので、
161.7482 -ドキュメントは、クラスのリストと
161.7483 -メインページの 2 つのフレームを持つことになります。
161.7484 -.RE
161.7485 -.TP 2
161.7486 -\(bu
161.7487 -.B ケース 2 パッケージのルートディレクトリへの移動:
161.7488 -これは、同じルート内にある複数のサブパッケージのソースファイルを個々に
161.7489 -ドキュメント化する場合に便利です。パッケージの
161.7490 -ルートディレクトリに移動し、各ソースファイルを
161.7491 -ルートからのパスで指定します。
161.7492 -.LP
161.7493 -.RS
161.7494 -.ft 3
161.7495 -.nf
161.7496 -% cd /home/src/
161.7497 -% javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java
161.7498 -.fi
161.7499 -.ft 1
161.7500 -.RE
161.7501 -.LP
161.7502 -.RS 2
161.7503 -この例では、Button クラスおよび Applet クラス
161.7504 -用の HTML 形式のドキュメント
161.7505 -が生成されます。
161.7506 -.RE
161.7507 -.TP 2
161.7508 -\(bu
161.7509 -.B ケース 3 すべてのディレクトリから:
161.7510 -このケースでは、現在のディレクトリがどの
161.7511 -ディレクトリでも問題はありません。
161.7512 -ドキュメント化する
161.7513 -.B .java
161.7514 -ファイルへの絶対パスまたは
161.7515 -相対パスを指定して
161.7516 -.BR javadoc
161.7517 -を実行します。
161.7518 -.LP
161.7519 -.RS
161.7520 -.ft 3
161.7521 -.nf
161.7522 -% javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java
161.7523 -.fi
161.7524 -.ft 1
161.7525 -.RE
161.7526 -.LP
161.7527 -.RS 2
161.7528 -この例では、クラス
161.7529 -.B Button
161.7530 -および先頭が
161.7531 -.BR Graphics
161.7532 -で始まるクラスの HTML 形式
161.7533 -のドキュメントが生成されます。
161.7534 -.RE
161.7535 -.SS "パッケージとクラスのドキュメント化"
161.7536 -パッケージ全体と個々のクラスを同時にドキュメント
161.7537 -化できます。次に示すのは、上に示
161.7538 -した 2 つの例を組み合わせた例です。
161.7539 -.B \-sourcepath
161.7540 -は、パッケージへのパスに対しては使用できますが、
161.7541 -個々のクラスのパスに対しては使用
161.7542 -できません。
161.7543 -.LP
161.7544 -.RS
161.7545 -.ft 3
161.7546 -.nf
161.7547 -% javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java
161.7548 -.fi
161.7549 -.ft 1
161.7550 -.RE
161.7551 -.LP
161.7552 -この例では、パッケージ
161.7553 -.B java.awt
161.7554 -とクラス
161.7555 -.B Applet
161.7556 -の HTML 形式のドキュメントが
161.7557 -生成されます。
161.7558 -.B javadoc
161.7559 -は、Applet のパッケージ名を、
161.7560 -.B Applet.java
161.7561 -ソースファイル内のパッケージの宣言 (宣言がある場合) から決定します。
161.7562 -.SS "使用例"
161.7563 -.B javadoc
161.7564 -ツールには、多くの便利なオプションがあり、
161.7565 -その中のいくつかは、ほかのオプションよりもよく
161.7566 -使われます。以下は、makefile 変数を使って Java プラット
161.7567 -フォーム API 上で
161.7568 -.B javadoc
161.7569 -ツールを実行するために使う効果的なコマンドです。
161.7570 -ここでは 180M バイトのメモリを使用して、
161.7571 -Java 2 Platform, Standard Edition, v1.2 に
161.7572 -存在する、約 1500 個の public および protected
161.7573 -クラスについてドキュメントを生成します。
161.7574 -.LP
161.7575 -同じ例を 2 回掲載します。最初の例はコマンド行から実行するもので、2 番目の例は Makefile から実行するものです。 オプションの引数に絶対パスを使用しているため、任意のディレクトリからこの
161.7576 -.B javadoc
161.7577 -コマンドを実行できます。
161.7578 -.SS コマンド行の例
161.7579 -次のコマンド行の例は 900 文字を超えているため、
161.7580 -DOS などのシェルには大きすぎます。
161.7581 -この制限を回避するには、コマンド行
161.7582 -引数ファイルを使用します。
161.7583 -または、シェルスクリプトを記述します。
161.7584 -.LP
161.7585 -.nf
161.7586 -\f3
161.7587 -.fl
161.7588 -% javadoc \-sourcepath /java/jdk/src/share/classes \\
161.7589 -.fl
161.7590 - \-overview /java/jdk/src/share/classes/overview.html \\
161.7591 -.fl
161.7592 - \-d /java/jdk/build/api \\
161.7593 -.fl
161.7594 - \-use \\
161.7595 -.fl
161.7596 - \-splitIndex \\
161.7597 -.fl
161.7598 - \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
161.7599 -.fl
161.7600 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification' \\
161.7601 -.fl
161.7602 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
161.7603 -.fl
161.7604 - \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
161.7605 -.fl
161.7606 -a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
161.7607 -.fl
161.7608 -Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
161.7609 -.fl
161.7610 -901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
161.7611 -.fl
161.7612 - \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
161.7613 -.fl
161.7614 - \-group "Extension Packages" "javax.*" \\
161.7615 -.fl
161.7616 - \-J\-Xmx180m \\
161.7617 -.fl
161.7618 - @packages
161.7619 -.fl
161.7620 -\fP
161.7621 -.fi
161.7622 -
161.7623 -.LP
161.7624 -.LP
161.7625 -上記のコマンドで、packages は、
161.7626 -処理対象のパッケージ名 (
161.7627 -.BR java.applett
161.7628 -.BR java.lang など) が
161.7629 -入っているファイルの名前です。 各オプションの、
161.7630 -単一引用符で囲まれた引数の内側には、
161.7631 -改行文字を挿入できません。 たとえば、
161.7632 -この例をコピー&ペーストする場合は、
161.7633 -.B \-bottom
161.7634 -オプションから改行文字を削除してください。
161.7635 -さらに、このあとの「注」も参照してください。
161.7636 -.SS Makefile の例
161.7637 -ここでは、GNU Makefile の例を示します。
161.7638 -Windows の Makefile の例については、
161.7639 -.na
161.7640 -「\f2creating a makefile for Windows\fP」
161.7641 -.fi
161.7642 -(http://java.sun.com/j2se/javadoc/faq/index.html#makefiles) を参照してください。
161.7643 -.LP
161.7644 -.nf
161.7645 -\f3
161.7646 -.fl
161.7647 -javadoc \-\fP\f3sourcepath\fP\f3 $(SRCDIR) \\ /* Sets path for source files */
161.7648 -.fl
161.7649 - \-\fP\f3overview\fP\f3 $(SRCDIR)/overview.html \\ /* Sets file for overview text */
161.7650 -.fl
161.7651 - \-\fP\f3d\fP\f3 /java/jdk/build/api \\ /* Sets destination directory */
161.7652 -.fl
161.7653 - \-\fP\f3use\fP\f3 \\ /* Adds "Use" files */
161.7654 -.fl
161.7655 - \-\fP\f3splitIndex\fP\f3 \\ /* Splits index A\-Z */
161.7656 -.fl
161.7657 - \-\fP\f3windowtitle\fP\f3 $(WINDOWTITLE) \\ /* Adds a window title */
161.7658 -.fl
161.7659 - \-\fP\f3doctitle\fP\f3 $(DOCTITLE) \\ /* Adds a doc title */
161.7660 -.fl
161.7661 - \-\fP\f3header\fP\f3 $(HEADER) \\ /* Adds running header text */
161.7662 -.fl
161.7663 - \-\fP\f3bottom\fP\f3 $(BOTTOM) \\ /* Adds text at bottom */
161.7664 -.fl
161.7665 - \-\fP\f3group\fP\f3 $(GROUPCORE) \\ /* 1st subhead on overview page */
161.7666 -.fl
161.7667 - \-\fP\f3group\fP\f3 $(GROUPEXT) \\ /* 2nd subhead on overview page */
161.7668 -.fl
161.7669 - \-\fP\f3J\fP\f3\-Xmx180m \\ /* Sets memory to 180MB */
161.7670 -.fl
161.7671 - java.lang java.lang.reflect \\ /* Sets packages to document */
161.7672 -.fl
161.7673 - java.util java.io java.net \\
161.7674 -.fl
161.7675 - java.applet
161.7676 -.fl
161.7677 -
161.7678 -.fl
161.7679 -WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
161.7680 -.fl
161.7681 -DOCTITLE = 'Java<sup><font size="\-2">TM</font></sup> 2 Platform v1.2 API Specification'
161.7682 -.fl
161.7683 -HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
161.7684 -.fl
161.7685 -BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
161.7686 -.fl
161.7687 - a bug or feature</a><br><br>Java is a trademark or registered trademark
161.7688 -.fl
161.7689 - of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
161.7690 -.fl
161.7691 - Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
161.7692 -.fl
161.7693 - All Rights Reserved.</font>'
161.7694 -.fl
161.7695 -GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
161.7696 -.fl
161.7697 -GROUPEXT = '"Extension Packages" "javax.*"'
161.7698 -.fl
161.7699 -SRCDIR = '/java/jdk/1.2/src/share/classes'
161.7700 -.fl
161.7701 -\fP
161.7702 -.fi
161.7703 -
161.7704 -.LP
161.7705 -.LP
161.7706 -Makefile の引数は、単一引用符で囲みます。
161.7707 -.SS 注
161.7708 -.TP 2
161.7709 -\(bu
161.7710 -.B \-windowtitle
161.7711 -オプションを省略すると、
161.7712 -.B Javadoc
161.7713 -ツールによってドキュメントタイトルが
161.7714 -ウィンドウタイトルにコピーされます。
161.7715 -.B \-windowtitle
161.7716 -のテキストは、基本的に
161.7717 -.B \-doctitle
161.7718 -と同じです。ただし、HTML タグは使用しません。
161.7719 -HTML タグは、ウィンドウタイトルにそのままの
161.7720 -テキストとして表示されてしまいます。
161.7721 -.TP 2
161.7722 -\(bu
161.7723 -この例のように
161.7724 -.B \-footer
161.7725 -オプションを省略すると、
161.7726 -.B Javadoc
161.7727 -ツールによってヘッダテキストが
161.7728 -フッタにコピーされます。
161.7729 -.TP 2
161.7730 -\(bu
161.7731 -この例では必要ありませんが、
161.7732 -.B \-classpath
161.7733 -および
161.7734 -.BR \-link
161.7735 -も重要なオプションです。
161.7736 -
161.7737 -.LP
161.7738 -.SH トラブルシューティング
161.7739 -.SS 一般的なトラブルシューティング
161.7740 -.TP 2
161.7741 -\(bu
161.7742 -Javadoc FAQ - よく問題となるバグや
161.7743 -トラブルシューティングの
161.7744 -ヒントは
161.7745 -.na
161.7746 -「\f2Javadoc FAQ\fP」
161.7747 -.fi
161.7748 -(http://java.sun.com/j2se/javadoc/faq/index.html#B) にあります。
161.7749 -.TP 2
161.7750 -\(bu
161.7751 -バグおよび制限事項 - また、バグの一部は、
161.7752 -.na
161.7753 -「\f2Important Bug Fixes and Changes\fP」
161.7754 -.fi
161.7755 -(http://java.sun.com/j2se/1.5.0/fixedbugs/index.html) でも参照できます。
161.7756 -.TP 2
161.7757 -\(bu
161.7758 -バージョン番号 - バージョン番号を参照してください。
161.7759 -.TP 2
161.7760 -\(bu
161.7761 -有効なクラスだけをドキュメント化 -
161.7762 -javadoc がパッケージをドキュメント化するとき、
161.7763 -有効なクラス名で構成されているファイルだけを
161.7764 -読み込むようになりました。
161.7765 -ファイル名にハイフン (-) などを含めることで、
161.7766 -javadoc がファイルを解析しないようにできます。
161.7767 -.SS エラーと警告
161.7768 -エラーメッセージおよび警告メッセージには、
161.7769 -ファイル名と宣言行に対する行番号が
161.7770 -含まれますが、doc コメントの特定の
161.7771 -行に対する行番号は含まれません。
161.7772 -.TP 2
161.7773 -\(bu
161.7774 -"error: cannot read: Class1.java" -
161.7775 -.B Javadoc
161.7776 -ツールは現在のディレクトリの
161.7777 -.BR Class1.java
161.7778 -クラスを読み込もうとしています。
161.7779 -クラス名は、絶対パスまたは相対パスで表示されます。
161.7780 -この場合、./Class1.java と同じです。
161.7781 -.LP
161.7782 -.SH "環境"
161.7783 -.TP 20
161.7784 -.SB CLASSPATH
161.7785 -環境変数は、
161.7786 -.B javadoc
161.7787 -がユーザクラスファイルを探すときに使う、パスを指定します。環境変数は、
161.7788 -.B \-classpath
161.7789 -オプションによってオーバーライドされます。ディレクトリは
161.7790 -コロンで分割します。たとえば、
161.7791 -次のとおりです。
161.7792 -.RS 15
161.7793 -.sp 1n
161.7794 -.B .:/home/classes:/usr/local/java/classes
161.7795 -.RE
161.7796 -.br
161.7797 -.ne 11
161.7798 -.SH "関連項目"
161.7799 +
161.7800 +.LP
161.7801 +.RS 3
161.7802 +
161.7803 +.LP
161.7804 +.LP
161.7805 +\f2field\-description\fP (ュ) сc若潟茯緇ゃ鴻腓冴綽荀障綽荀綽茲違茵羝<c茯荐菴違с障罔羣宴翫綵√若吾菴遵障
161.7806 +.LP
161.7807 +.LP
161.7808 +鴻翫違翫純c若鴻菴遵翫筝肢菴遵若吾с潟茘ャ菴遵綽荀障
161.7809 +.LP
161.7810 +.LP
161.7811 +\f2include\fP \f2exclude\fP 綣違翫綵√若吾鴻障宴若吾ゅ腓冴障綣違罨<号障
161.7812 .LP
161.7813 .RS 3
161.7814 .TP 2
161.7815 o
161.7816 -javac
161.7817 +\f2Serializable\fP 絎茖 public 障 protected 鴻絽吾若吾障 鴻障鴻絮宴若吾 \f2@serial exclude\fP ф絎若吾ゅ障
161.7818 .TP 2
161.7819 o
161.7820 -java
161.7821 +\f2Serializable\fP 絎茖 private 障 package private 鴻絽吾若吾ゅ障 鴻障鴻絮宴若吾 \f2@serial include\fP ф絎若吾障
161.7822 +.RE
161.7823 +
161.7824 +.LP
161.7825 +.LP
161.7826 +箴: \f2javax.swing\fP 宴若吾\f2@serial exclude\fP ф絎障 (\f2package.html\fP 障 \f2package\-info.java\fP )public \f2java.security.BasicPermission\fP \f2@serial exclude\fP ф絎障package private \f2java.util.PropertyPermissionCollection\fP \f2@serial include\fP ф絎障
161.7827 +.LP
161.7828 +.LP
161.7829 +鴻ф絎 @serial 帥違宴若吾ф絎 @serial 帥違若若ゃ障
161.7830 +.LP
161.7831 +.LP
161.7832 +帥違篏睡羈ゃ荅括完篏睡箴Java 吾с翫篁罕膃 1.6 膀
161.7833 +.na
161.7834 +\f2鴻翫純c若潟若帥後\fP @
161.7835 +.fi
161.7836 +http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.htmlс障
161.7837 +.na
161.7838 +\f2翫 FAQ\fP @
161.7839 +.fi
161.7840 +http://java.sun.com/products/jdk/serialization/faq/#javadoc_warn_missingс FAQ \-private 鴻ゃ絎 javadoc 絎茵 private c若 @serial 帥違荀ゃ javadoc 茘茵腓冴筝莖吾膈荐莠障翫綵√鋌罕鴻翫
161.7841 +.na
161.7842 +\f2Sun 篁罕\fP @
161.7843 +.fi
161.7844 +http://java.sun.com/j2se/javadoc/writingapispecs/serialized\-criteria.htmlс
161.7845 +.LP
161.7846 +.LP
161.7847 +
161.7848 +.LP
161.7849 +.RE
161.7850 +.RS 3
161.7851 +.TP 3
161.7852 +@serialField\ field\-name\ field\-type\ field\-description
161.7853 +\f2Serializable\fP 鴻 \f2serialPersistentFields\fP <潟若 \f2ObjectStreamField\fP 潟潟若潟ャ<潟障 \f2ObjectStreamField\fP 潟潟若潟絲障 \f2@serialField\fP 帥違 1 や戎綽荀障
161.7854 +.RE
161.7855 +
161.7856 +.LP
161.7857 +.RS 3
161.7858 +
161.7859 +.LP
161.7860 +.LP
161.7861 +
161.7862 +.LP
161.7863 +.RE
161.7864 +.RS 3
161.7865 +.TP 3
161.7866 +@serialData\ data\-description
161.7867 +\f2data\-description\fP 翫綵√с若帥綺茯鴻с若帥鴻\f2writeObject\fP <純c吾莨若障ュ純若帥 \f2Externalizable.writeExternal\fP <純c吾莨若障鴻若 (阪鴻) 障障
161.7868 +.RE
161.7869 +
161.7870 +.LP
161.7871 +.RS 3
161.7872 +
161.7873 +.LP
161.7874 +.LP
161.7875 +\f2@serialData\fP 帥違\f2writeObject\fP\f2readObject\fP\f2writeExternal\fP\f2readExternal\fP\f2writeReplace\fP \f2readResolve\fP <純ャ<潟若激с潟潟<潟т戎с障
161.7876 +.LP
161.7877 +.LP
161.7878 +
161.7879 +.LP
161.7880 +.RE
161.7881 +.RS 3
161.7882 +.TP 3
161.7883 +@since\ since\-text
161.7884 +ャ<潟 [絨ャ若吾с] 荀冴菴遵絎 \f2since\-text\fP 吾莨若帥障鴻劫ャ罕障帥違鴻ャ<潟若激с潟潟<潟ゃ障网荀宴若吾鴻ゃ潟帥с若鴻潟潟鴻帥<純潟c若ф鴻с帥違劫紊眼障罘純\f2since\-text\fP 腓冴純с≪若剛札絖潟障箴腓冴障
161.7885 +.RE
161.7886 +
161.7887 +.LP
161.7888 +.RS 3
161.7889 +
161.7890 +.LP
161.7891 +.nf
161.7892 +\f3
161.7893 +.fl
161.7894 + @since 1.5
161.7895 +.fl
161.7896 +
161.7897 +.fl
161.7898 +\fP
161.7899 +.fi
161.7900 +
161.7901 +.LP
161.7902 +.LP
161.7903 +Java 若純若鴻潟若翫帥違Java 若 API 篁罕若吾с潟腓冴障 紊眼罘純<潟劫茖菴遵腓冴障茲違 @since 帥違篏睡с茲違 @author 帥違宴障違荀膣茲違 API т戎翫茲違帥違篏睡с障
161.7904 +.LP
161.7905 +.LP
161.7906 +
161.7907 +.LP
161.7908 +.RE
161.7909 +.RS 3
161.7910 +.TP 3
161.7911 +@throws\ class\-name\ description\
161.7912 +\f2@throws\fP 帥違 \f2@exception\fP 帥違臂сャ<潟 [箴紊] 絨頳冴菴遵\f2class\-name\fP \f2description\fP 鴻吾莨若帥障\f2class\-name\fP <純鴻若醇с箴紊с帥違<純潟潟鴻帥 doc 潟<潟с炊鴻с鴻絎絎ц菴違翫Javadoc 若罎膣∫綺緇c鴻「障障違箴紊 doc 潟<潟с茲違 \f2@throws\fP 帥違篏睡с障
161.7913 +.RE
161.7914 +
161.7915 +.LP
161.7916 +.RS 3
161.7917 +
161.7918 +.LP
161.7919 +.LP
161.7920 +鴻с羝推紊ャ<潟\f2@throws\fP 帥違 throws 膀箴紊絖翫@throws 帥違ャ<潟сJavadoc 若c箴紊 HTML 阪茯ц菴遵障
161.7921 +.LP
161.7922 +.LP
161.7923 +若若ゃ<純т紊腓榊絎h翫帥\f2@throws\fP ャ<潟若激с潟<純泣鴻潟若障ゃ潟帥с若鴻<純絎茖<純潟若翫罕с@throws ャ<潟若激с潟膓帥{@inheritDoc} 篏睡с障
161.7924 +.LP
161.7925 +.LP
161.7926 +荅括完ゃ
161.7927 +.na
161.7928 +\f2@throws 帥違ャ<潟\fP @
161.7929 +.fi
161.7930 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@exceptionс
161.7931 +.LP
161.7932 +.LP
161.7933 +
161.7934 +.LP
161.7935 +.RE
161.7936 +.RS 3
161.7937 +.TP 3
161.7938 +{@value\ package.class#field}
161.7939 +\f2{@value}\fP c若 doc 潟<潟 綣違т戎翫絎違ゃ茵腓冴障
161.7940 +.RE
161.7941 +
161.7942 +.LP
161.7943 +.RS 3
161.7944 +
161.7945 +.LP
161.7946 +.nf
161.7947 +\f3
161.7948 +.fl
161.7949 + /**
161.7950 +.fl
161.7951 + * The value of this constant is {@value}.
161.7952 +.fl
161.7953 + */
161.7954 +.fl
161.7955 + public static final String SCRIPT_START = "<script>"
161.7956 +.fl
161.7957 +
161.7958 +.fl
161.7959 +\fP
161.7960 +.fi
161.7961 +
161.7962 +.LP
161.7963 +.LP
161.7964 +篁紙 doc 潟<潟у \f2package.class#field\fP т戎翫絎絎違ゃ茵腓冴障
161.7965 +.LP
161.7966 +.nf
161.7967 +\f3
161.7968 +.fl
161.7969 + /**
161.7970 +.fl
161.7971 + * Evaluates the script starting with {@value #SCRIPT_START}.
161.7972 +.fl
161.7973 + */
161.7974 +.fl
161.7975 + public String evalScript(String script) {
161.7976 +.fl
161.7977 + }
161.7978 +.fl
161.7979 +
161.7980 +.fl
161.7981 +\fP
161.7982 +.fi
161.7983 +
161.7984 +.LP
161.7985 +.LP
161.7986 +綣 \f2package.class#field\fP @see 綣違筝綵√障<潟若c若違鴻違障
161.7987 +.LP
161.7988 +.LP
161.7989 +絎違сゃ
161.7990 +.na
161.7991 +\f2絎違c若\fP @
161.7992 +.fi
161.7993 +http://java.sun.com/javase/6/docs/api/constant\-values.html若吾茵腓冴障
161.7994 +.LP
161.7995 +.LP
161.7996 +
161.7997 +.LP
161.7998 +.RE
161.7999 +.RS 3
161.8000 +.TP 3
161.8001 +@version\ version\-text
161.8002 +\-version 激с潟篏帥翫ャ<潟 [若吾с] 絨頳冴菴遵絎 \f2version\-text\fP 吾莨若帥障帥違潟若障純с≪憜若吾с括垩篆潟障 絲障@since 潟若絨ャ若吾с括垩篆障\f2version\-text\fP 劫ャ罕障若吾с潟帥違篏睡с贋茯帥鴻帥違篏睡с贋с
161.8003 +.RE
161.8004 +
161.8005 +.LP
161.8006 +.RS 3
161.8007 +
161.8008 +.LP
161.8009 +.LP
161.8010 +1 ゃャ<潟若激с潟潟<潟茲違 \f2@version\fP 帥違с障綽荀綽\f2@version\fP 帥違 1 ゃ若吾с括垩絎帥違茲違若吾с括垩絎с障翫Javadoc 若c潟潟 (\f2,\fP) 鴻若鴻水ャ障緇翫鴻篏茹fャ<潟障障潟若障c潟潟с荐茯絲上阪絖篏帥綽荀1 ゃ帥違茲違絎
161.8011 +.LP
161.8012 +.LP
161.8013 +荅括完ゃ
161.8014 +.na
161.8015 +\f2@version 帥違ャ<潟\fP @
161.8016 +.fi
161.8017 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@versionс
161.8018 +.LP
161.8019 +.RE
161.8020 +.LP
161.8021 +.SS
161.8022 +帥違篏睡с贋
161.8023 +.LP
161.8024 +с帥違篏睡с贋ゃ茯障\f2@see\fP\f2@since\fP\f2@deprecated\fP\f2{@link}\fP\f2{@linkplain}\fP \f2{@docroot}\fP 帥違鴻 doc 潟<潟т戎с障
161.8025 +.RS 3
161.8026 +
161.8027 +.LP
161.8028 +.SS
161.8029 +网荀ャ<潟若激с潟帥
161.8030 +.LP
161.8031 +.LP
161.8032 +网荀帥違网荀若吾ャ<潟若激с潟潟<潟т戎с帥違с ャ<潟若激с潟潟<潟絽 \f2overview.html\fP 純若鴻<ゃ障祉ャ<潟若激с潟潟<潟翫罕帥違筝肢т戎綽荀障
161.8033 +.LP
161.8034 +.LP
161.8035 +\f3羈\fP \- 若吾с 1.2 с网荀ャ<潟 \f2{@link}\fP 帥違違障鴻罩c頫腓冴障潟荐絎障憜\f2{@docRoot}\fP 帥違网荀ャ<潟с篏障
161.8036 +.LP
161.8037 +.RS 3
161.8038 +
161.8039 +.LP
161.8040 +.LP
161.8041 +.TS
161.8042 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8043 +.de 35
161.8044 +.ps \n(.s
161.8045 +.vs \n(.vu
161.8046 +.in \n(.iu
161.8047 +.if \n(.u .fi
161.8048 +.if \n(.j .ad
161.8049 +.if \n(.j=0 .na
161.8050 +..
161.8051 +.nf
161.8052 +.nr #~ 0
161.8053 +.if n .nr #~ 0.6n
161.8054 +.ds #d .d
161.8055 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8056 +.fc
161.8057 +.nr 33 \n(.s
161.8058 +.rm 80
161.8059 +.nr 34 \n(.lu
161.8060 +.eo
161.8061 +.am 80
161.8062 +.br
161.8063 +.di a+
161.8064 +.35
161.8065 +.ft \n(.f
161.8066 +.ll \n(34u*1u/2u
161.8067 +.if \n(.l<\n(80 .ll \n(80u
161.8068 +.in 0
161.8069 +\f2@see\fP
161.8070 +.br
161.8071 +\f2@since\fP
161.8072 +.br
161.8073 +\f2@author\fP
161.8074 +.br
161.8075 +\f2@version\fP
161.8076 +.br
161.8077 +\f2{@link}\fP
161.8078 +.br
161.8079 +\f2{@linkplain}\fP
161.8080 +.br
161.8081 +\f2{@docRoot}\fP
161.8082 +.br
161.8083 +.di
161.8084 +.nr a| \n(dn
161.8085 +.nr a- \n(dl
161.8086 +..
161.8087 +.ec \
161.8088 +.35
161.8089 +.nf
161.8090 +.ll \n(34u
161.8091 +.nr 80 0
161.8092 +.nr 38 \w\f3网荀帥\fP
161.8093 +.if \n(80<\n(38 .nr 80 \n(38
161.8094 +.80
161.8095 +.rm 80
161.8096 +.nr 38 \n(a-
161.8097 +.if \n(80<\n(38 .nr 80 \n(38
161.8098 +.35
161.8099 +.nf
161.8100 +.ll \n(34u
161.8101 +.nr 38 1n
161.8102 +.nr 79 0
161.8103 +.nr 40 \n(79+(0*\n(38)
161.8104 +.nr 80 +\n(40
161.8105 +.nr TW \n(80
161.8106 +.if t .if \n(TW>\n(.li .tm Table at line 2280 file Input is too wide - \n(TW units
161.8107 +.fc
161.8108 +.nr #T 0-1
161.8109 +.nr #a 0-1
161.8110 +.eo
161.8111 +.de T#
161.8112 +.ds #d .d
161.8113 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8114 +.mk ##
161.8115 +.nr ## -1v
161.8116 +.ls 1
161.8117 +.ls
161.8118 +..
161.8119 +.ec
161.8120 +.ta \n(80u
161.8121 +.nr 31 \n(.f
161.8122 +.nr 35 1m
161.8123 +\&\h'|\n(40u'\f3网荀帥\fP
161.8124 +.ne \n(a|u+\n(.Vu
161.8125 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.8126 +.ta \n(80u
161.8127 +.nr 31 \n(.f
161.8128 +.nr 35 1m
161.8129 +\&\h'|\n(40u'
161.8130 +.mk ##
161.8131 +.nr 31 \n(##
161.8132 +.sp |\n(##u-1v
161.8133 +.nr 37 \n(40u
161.8134 +.in +\n(37u
161.8135 +.a+
161.8136 +.in -\n(37u
161.8137 +.mk 32
161.8138 +.if \n(32>\n(31 .nr 31 \n(32
161.8139 +.sp |\n(31u
161.8140 +.fc
161.8141 +.nr T. 1
161.8142 +.T# 1
161.8143 +.35
161.8144 +.rm a+
161.8145 +.TE
161.8146 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-20
161.8147 +
161.8148 +.LP
161.8149 +.RE
161.8150 +.SS
161.8151 +宴若吾ャ<潟若激с潟帥
161.8152 +.LP
161.8153 +.LP
161.8154 +宴若吾帥違宴若吾ャ<潟若激с潟潟<潟т戎с帥違с ャ<潟若激с潟潟<潟\f2package.html\fP 障 \f2package\-info.java\fP 純若鴻<ゃ障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
161.8155 +.LP
161.8156 +.RS 3
161.8157 +
161.8158 +.LP
161.8159 +.LP
161.8160 +.TS
161.8161 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8162 +.de 35
161.8163 +.ps \n(.s
161.8164 +.vs \n(.vu
161.8165 +.in \n(.iu
161.8166 +.if \n(.u .fi
161.8167 +.if \n(.j .ad
161.8168 +.if \n(.j=0 .na
161.8169 +..
161.8170 +.nf
161.8171 +.nr #~ 0
161.8172 +.if n .nr #~ 0.6n
161.8173 +.ds #d .d
161.8174 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8175 +.fc
161.8176 +.nr 33 \n(.s
161.8177 +.rm 80
161.8178 +.nr 34 \n(.lu
161.8179 +.eo
161.8180 +.am 80
161.8181 +.br
161.8182 +.di a+
161.8183 +.35
161.8184 +.ft \n(.f
161.8185 +.ll \n(34u*1u/2u
161.8186 +.if \n(.l<\n(80 .ll \n(80u
161.8187 +.in 0
161.8188 +\f2@see\fP
161.8189 +.br
161.8190 +\f2@since\fP
161.8191 +.br
161.8192 +\f2@serial\fP
161.8193 +.br
161.8194 +\f2@author\fP
161.8195 +.br
161.8196 +\f2@version\fP
161.8197 +.br
161.8198 +\f2{@link}\fP
161.8199 +.br
161.8200 +\f2{@linkplain}\fP
161.8201 +.br
161.8202 +\f2{@docRoot}\fP
161.8203 +.br
161.8204 +.di
161.8205 +.nr a| \n(dn
161.8206 +.nr a- \n(dl
161.8207 +..
161.8208 +.ec \
161.8209 +.35
161.8210 +.nf
161.8211 +.ll \n(34u
161.8212 +.nr 80 0
161.8213 +.nr 38 \w\f3宴若吾帥\fP
161.8214 +.if \n(80<\n(38 .nr 80 \n(38
161.8215 +.80
161.8216 +.rm 80
161.8217 +.nr 38 \n(a-
161.8218 +.if \n(80<\n(38 .nr 80 \n(38
161.8219 +.35
161.8220 +.nf
161.8221 +.ll \n(34u
161.8222 +.nr 38 1n
161.8223 +.nr 79 0
161.8224 +.nr 40 \n(79+(0*\n(38)
161.8225 +.nr 80 +\n(40
161.8226 +.nr TW \n(80
161.8227 +.if t .if \n(TW>\n(.li .tm Table at line 2316 file Input is too wide - \n(TW units
161.8228 +.fc
161.8229 +.nr #T 0-1
161.8230 +.nr #a 0-1
161.8231 +.eo
161.8232 +.de T#
161.8233 +.ds #d .d
161.8234 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8235 +.mk ##
161.8236 +.nr ## -1v
161.8237 +.ls 1
161.8238 +.ls
161.8239 +..
161.8240 +.ec
161.8241 +.ta \n(80u
161.8242 +.nr 31 \n(.f
161.8243 +.nr 35 1m
161.8244 +\&\h'|\n(40u'\f3宴若吾帥\fP
161.8245 +.ne \n(a|u+\n(.Vu
161.8246 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.8247 +.ta \n(80u
161.8248 +.nr 31 \n(.f
161.8249 +.nr 35 1m
161.8250 +\&\h'|\n(40u'
161.8251 +.mk ##
161.8252 +.nr 31 \n(##
161.8253 +.sp |\n(##u-1v
161.8254 +.nr 37 \n(40u
161.8255 +.in +\n(37u
161.8256 +.a+
161.8257 +.in -\n(37u
161.8258 +.mk 32
161.8259 +.if \n(32>\n(31 .nr 31 \n(32
161.8260 +.sp |\n(31u
161.8261 +.fc
161.8262 +.nr T. 1
161.8263 +.T# 1
161.8264 +.35
161.8265 +.rm a+
161.8266 +.TE
161.8267 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-22
161.8268 +
161.8269 +.LP
161.8270 +.RE
161.8271 +.SS
161.8272 +鴻潟ゃ潟帥с若鴻ャ<潟若激с潟帥
161.8273 +.LP
161.8274 +.LP
161.8275 +罨<鴻障ゃ潟帥с若鴻ャ<潟若激с潟潟<潟т戎с帥違腓冴障т戎с \f2@serial\fP 帥違\f2include\fP 障 \f2exclude\fP 綣違絎с
161.8276 +.LP
161.8277 +.RS 3
161.8278 +
161.8279 +.LP
161.8280 +.LP
161.8281 +.TS
161.8282 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8283 +.de 35
161.8284 +.ps \n(.s
161.8285 +.vs \n(.vu
161.8286 +.in \n(.iu
161.8287 +.if \n(.u .fi
161.8288 +.if \n(.j .ad
161.8289 +.if \n(.j=0 .na
161.8290 +..
161.8291 +.nf
161.8292 +.nr #~ 0
161.8293 +.if n .nr #~ 0.6n
161.8294 +.ds #d .d
161.8295 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8296 +.fc
161.8297 +.nr 33 \n(.s
161.8298 +.rm 80
161.8299 +.nr 34 \n(.lu
161.8300 +.eo
161.8301 +.am 80
161.8302 +.br
161.8303 +.di a+
161.8304 +.35
161.8305 +.ft \n(.f
161.8306 +.ll \n(34u*1u/2u
161.8307 +.if \n(.l<\n(80 .ll \n(80u
161.8308 +.in 0
161.8309 +\f3鴻潟ゃ潟帥с若鴻帥\fP
161.8310 +.br
161.8311 +.di
161.8312 +.nr a| \n(dn
161.8313 +.nr a- \n(dl
161.8314 +..
161.8315 +.ec \
161.8316 +.eo
161.8317 +.am 80
161.8318 +.br
161.8319 +.di b+
161.8320 +.35
161.8321 +.ft \n(.f
161.8322 +.ll \n(34u*1u/2u
161.8323 +.if \n(.l<\n(80 .ll \n(80u
161.8324 +.in 0
161.8325 +\f2@see\fP
161.8326 +.br
161.8327 +\f2@since\fP
161.8328 +.br
161.8329 +\f2@deprecated\fP
161.8330 +.br
161.8331 +\f2@serial\fP
161.8332 +.br
161.8333 +\f2@author\fP
161.8334 +.br
161.8335 +\f2@version\fP
161.8336 +.br
161.8337 +\f2{@link}\fP
161.8338 +.br
161.8339 +\f2{@linkplain}\fP
161.8340 +.br
161.8341 +\f2{@docRoot}\fP
161.8342 +.br
161.8343 +.di
161.8344 +.nr b| \n(dn
161.8345 +.nr b- \n(dl
161.8346 +..
161.8347 +.ec \
161.8348 +.35
161.8349 +.nf
161.8350 +.ll \n(34u
161.8351 +.nr 80 0
161.8352 +.80
161.8353 +.rm 80
161.8354 +.nr 38 \n(a-
161.8355 +.if \n(80<\n(38 .nr 80 \n(38
161.8356 +.nr 38 \n(b-
161.8357 +.if \n(80<\n(38 .nr 80 \n(38
161.8358 +.35
161.8359 +.nf
161.8360 +.ll \n(34u
161.8361 +.nr 38 1n
161.8362 +.nr 79 0
161.8363 +.nr 40 \n(79+(0*\n(38)
161.8364 +.nr 80 +\n(40
161.8365 +.nr TW \n(80
161.8366 +.if t .if \n(TW>\n(.li .tm Table at line 2356 file Input is too wide - \n(TW units
161.8367 +.fc
161.8368 +.nr #T 0-1
161.8369 +.nr #a 0-1
161.8370 +.eo
161.8371 +.de T#
161.8372 +.ds #d .d
161.8373 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8374 +.mk ##
161.8375 +.nr ## -1v
161.8376 +.ls 1
161.8377 +.ls
161.8378 +..
161.8379 +.ec
161.8380 +.ne \n(a|u+\n(.Vu
161.8381 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.8382 +.ta \n(80u
161.8383 +.nr 31 \n(.f
161.8384 +.nr 35 1m
161.8385 +\&\h'|\n(40u'
161.8386 +.mk ##
161.8387 +.nr 31 \n(##
161.8388 +.sp |\n(##u-1v
161.8389 +.nr 37 \n(40u
161.8390 +.in +\n(37u
161.8391 +.a+
161.8392 +.in -\n(37u
161.8393 +.mk 32
161.8394 +.if \n(32>\n(31 .nr 31 \n(32
161.8395 +.sp |\n(31u
161.8396 +.ne \n(b|u+\n(.Vu
161.8397 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.8398 +.ta \n(80u
161.8399 +.nr 31 \n(.f
161.8400 +.nr 35 1m
161.8401 +\&\h'|\n(40u'
161.8402 +.mk ##
161.8403 +.nr 31 \n(##
161.8404 +.sp |\n(##u-1v
161.8405 +.nr 37 \n(40u
161.8406 +.in +\n(37u
161.8407 +.b+
161.8408 +.in -\n(37u
161.8409 +.mk 32
161.8410 +.if \n(32>\n(31 .nr 31 \n(32
161.8411 +.sp |\n(31u
161.8412 +.fc
161.8413 +.nr T. 1
161.8414 +.T# 1
161.8415 +.35
161.8416 +.rm a+
161.8417 +.rm b+
161.8418 +.TE
161.8419 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-26
161.8420 +
161.8421 +.LP
161.8422 +.RE
161.8423 +\f3罨<鴻潟<潟箴腓冴障\fP
161.8424 +.LP
161.8425 +.nf
161.8426 +\f3
161.8427 +.fl
161.8428 +/**
161.8429 +.fl
161.8430 + * A class representing a window on the screen.
161.8431 +.fl
161.8432 + * For example:
161.8433 +.fl
161.8434 + * <pre>
161.8435 +.fl
161.8436 + * Window win = new Window(parent);
161.8437 +.fl
161.8438 + * win.show();
161.8439 +.fl
161.8440 + * </pre>
161.8441 +.fl
161.8442 + *
161.8443 +.fl
161.8444 + * @author Sami Shaio
161.8445 +.fl
161.8446 + * @version 1.13, 06/08/06
161.8447 +.fl
161.8448 + * @see java.awt.BaseWindow
161.8449 +.fl
161.8450 + * @see java.awt.Button
161.8451 +.fl
161.8452 + */
161.8453 +.fl
161.8454 +class Window extends BaseWindow {
161.8455 +.fl
161.8456 + ...
161.8457 +.fl
161.8458 +}
161.8459 +.fl
161.8460 +
161.8461 +.fl
161.8462 +\fP
161.8463 +.fi
161.8464 +
161.8465 +.LP
161.8466 +.SS
161.8467 +c若ャ<潟若激с潟帥
161.8468 +.LP
161.8469 +.LP
161.8470 +罨<c若ャ<潟若激с潟潟<潟т戎с帥違腓冴障
161.8471 +.LP
161.8472 +.RS 3
161.8473 +
161.8474 +.LP
161.8475 +.LP
161.8476 +.TS
161.8477 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8478 +.de 35
161.8479 +.ps \n(.s
161.8480 +.vs \n(.vu
161.8481 +.in \n(.iu
161.8482 +.if \n(.u .fi
161.8483 +.if \n(.j .ad
161.8484 +.if \n(.j=0 .na
161.8485 +..
161.8486 +.nf
161.8487 +.nr #~ 0
161.8488 +.if n .nr #~ 0.6n
161.8489 +.ds #d .d
161.8490 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8491 +.fc
161.8492 +.nr 33 \n(.s
161.8493 +.rm 80
161.8494 +.nr 34 \n(.lu
161.8495 +.eo
161.8496 +.am 80
161.8497 +.br
161.8498 +.di a+
161.8499 +.35
161.8500 +.ft \n(.f
161.8501 +.ll \n(34u*1u/2u
161.8502 +.if \n(.l<\n(80 .ll \n(80u
161.8503 +.in 0
161.8504 +\f2@see\fP
161.8505 +.br
161.8506 +\f2@since\fP
161.8507 +.br
161.8508 +\f2@deprecated\fP
161.8509 +.br
161.8510 +\f2@serial\fP
161.8511 +.br
161.8512 +\f2@serialField\fP
161.8513 +.br
161.8514 +\f2{@link}\fP
161.8515 +.br
161.8516 +\f2{@linkplain}\fP
161.8517 +.br
161.8518 +\f2{@docRoot}\fP
161.8519 +.br
161.8520 +\f2{@value}\fP
161.8521 +.br
161.8522 +.di
161.8523 +.nr a| \n(dn
161.8524 +.nr a- \n(dl
161.8525 +..
161.8526 +.ec \
161.8527 +.35
161.8528 +.nf
161.8529 +.ll \n(34u
161.8530 +.nr 80 0
161.8531 +.nr 38 \w\f3c若帥\fP
161.8532 +.if \n(80<\n(38 .nr 80 \n(38
161.8533 +.80
161.8534 +.rm 80
161.8535 +.nr 38 \n(a-
161.8536 +.if \n(80<\n(38 .nr 80 \n(38
161.8537 +.35
161.8538 +.nf
161.8539 +.ll \n(34u
161.8540 +.nr 38 1n
161.8541 +.nr 79 0
161.8542 +.nr 40 \n(79+(0*\n(38)
161.8543 +.nr 80 +\n(40
161.8544 +.nr TW \n(80
161.8545 +.if t .if \n(TW>\n(.li .tm Table at line 2437 file Input is too wide - \n(TW units
161.8546 +.fc
161.8547 +.nr #T 0-1
161.8548 +.nr #a 0-1
161.8549 +.eo
161.8550 +.de T#
161.8551 +.ds #d .d
161.8552 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8553 +.mk ##
161.8554 +.nr ## -1v
161.8555 +.ls 1
161.8556 +.ls
161.8557 +..
161.8558 +.ec
161.8559 +.ta \n(80u
161.8560 +.nr 31 \n(.f
161.8561 +.nr 35 1m
161.8562 +\&\h'|\n(40u'\f3c若帥\fP
161.8563 +.ne \n(a|u+\n(.Vu
161.8564 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.8565 +.ta \n(80u
161.8566 +.nr 31 \n(.f
161.8567 +.nr 35 1m
161.8568 +\&\h'|\n(40u'
161.8569 +.mk ##
161.8570 +.nr 31 \n(##
161.8571 +.sp |\n(##u-1v
161.8572 +.nr 37 \n(40u
161.8573 +.in +\n(37u
161.8574 +.a+
161.8575 +.in -\n(37u
161.8576 +.mk 32
161.8577 +.if \n(32>\n(31 .nr 31 \n(32
161.8578 +.sp |\n(31u
161.8579 +.fc
161.8580 +.nr T. 1
161.8581 +.T# 1
161.8582 +.35
161.8583 +.rm a+
161.8584 +.TE
161.8585 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-24
161.8586 +
161.8587 +.LP
161.8588 +.RE
161.8589 +\f3罨<c若潟<潟箴腓冴障\fP
161.8590 +.LP
161.8591 +.nf
161.8592 +\f3
161.8593 +.fl
161.8594 + /**
161.8595 +.fl
161.8596 + * The X\-coordinate of the component.
161.8597 +.fl
161.8598 + *
161.8599 +.fl
161.8600 + * @see #getLocation()
161.8601 +.fl
161.8602 + */
161.8603 +.fl
161.8604 + int x = 1263732;
161.8605 +.fl
161.8606 +
161.8607 +.fl
161.8608 +\fP
161.8609 +.fi
161.8610 +
161.8611 +.LP
161.8612 +.SS
161.8613 +潟潟鴻帥潟<純ャ<潟若激с潟帥
161.8614 +.LP
161.8615 +.LP
161.8616 +罨<潟潟鴻帥障<純ャ<潟若激с潟潟<潟ц;腓冴с帥違腓冴障 \f2@return\fP 潟潟鴻帥с茵腓冴с\f2{@inheritDoc}\fP 茵腓冴狗障\f2@serialData\fP 帥違劫翫<純 doc 潟<潟с推戎с障
161.8617 +.LP
161.8618 +.RS 3
161.8619 +
161.8620 +.LP
161.8621 +.LP
161.8622 +.TS
161.8623 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8624 +.de 35
161.8625 +.ps \n(.s
161.8626 +.vs \n(.vu
161.8627 +.in \n(.iu
161.8628 +.if \n(.u .fi
161.8629 +.if \n(.j .ad
161.8630 +.if \n(.j=0 .na
161.8631 +..
161.8632 +.nf
161.8633 +.nr #~ 0
161.8634 +.if n .nr #~ 0.6n
161.8635 +.ds #d .d
161.8636 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8637 +.fc
161.8638 +.nr 33 \n(.s
161.8639 +.rm 80
161.8640 +.nr 34 \n(.lu
161.8641 +.eo
161.8642 +.am 80
161.8643 +.br
161.8644 +.di a+
161.8645 +.35
161.8646 +.ft \n(.f
161.8647 +.ll \n(34u*1u/2u
161.8648 +.if \n(.l<\n(80 .ll \n(80u
161.8649 +.in 0
161.8650 +\f3<純潟潟潟鴻帥帥\fP
161.8651 +.br
161.8652 +.di
161.8653 +.nr a| \n(dn
161.8654 +.nr a- \n(dl
161.8655 +..
161.8656 +.ec \
161.8657 +.eo
161.8658 +.am 80
161.8659 +.br
161.8660 +.di b+
161.8661 +.35
161.8662 +.ft \n(.f
161.8663 +.ll \n(34u*1u/2u
161.8664 +.if \n(.l<\n(80 .ll \n(80u
161.8665 +.in 0
161.8666 +\f2@see\fP
161.8667 +.br
161.8668 +\f2@since\fP
161.8669 +.br
161.8670 +\f2@deprecated\fP
161.8671 +.br
161.8672 +\f2@param\fP
161.8673 +.br
161.8674 +\f2@return\fP
161.8675 +.br
161.8676 +\f2@throws\fP \f2@exception\fP
161.8677 +.br
161.8678 +\f2@serialData\fP
161.8679 +.br
161.8680 +\f2{@link}\fP
161.8681 +.br
161.8682 +\f2{@linkplain}\fP
161.8683 +.br
161.8684 +\f2{@inheritDoc}\fP
161.8685 +.br
161.8686 +\f2{@docRoot}\fP
161.8687 +.br
161.8688 +.di
161.8689 +.nr b| \n(dn
161.8690 +.nr b- \n(dl
161.8691 +..
161.8692 +.ec \
161.8693 +.35
161.8694 +.nf
161.8695 +.ll \n(34u
161.8696 +.nr 80 0
161.8697 +.80
161.8698 +.rm 80
161.8699 +.nr 38 \n(a-
161.8700 +.if \n(80<\n(38 .nr 80 \n(38
161.8701 +.nr 38 \n(b-
161.8702 +.if \n(80<\n(38 .nr 80 \n(38
161.8703 +.35
161.8704 +.nf
161.8705 +.ll \n(34u
161.8706 +.nr 38 1n
161.8707 +.nr 79 0
161.8708 +.nr 40 \n(79+(0*\n(38)
161.8709 +.nr 80 +\n(40
161.8710 +.nr TW \n(80
161.8711 +.if t .if \n(TW>\n(.li .tm Table at line 2504 file Input is too wide - \n(TW units
161.8712 +.fc
161.8713 +.nr #T 0-1
161.8714 +.nr #a 0-1
161.8715 +.eo
161.8716 +.de T#
161.8717 +.ds #d .d
161.8718 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8719 +.mk ##
161.8720 +.nr ## -1v
161.8721 +.ls 1
161.8722 +.ls
161.8723 +..
161.8724 +.ec
161.8725 +.ne \n(a|u+\n(.Vu
161.8726 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.8727 +.ta \n(80u
161.8728 +.nr 31 \n(.f
161.8729 +.nr 35 1m
161.8730 +\&\h'|\n(40u'
161.8731 +.mk ##
161.8732 +.nr 31 \n(##
161.8733 +.sp |\n(##u-1v
161.8734 +.nr 37 \n(40u
161.8735 +.in +\n(37u
161.8736 +.a+
161.8737 +.in -\n(37u
161.8738 +.mk 32
161.8739 +.if \n(32>\n(31 .nr 31 \n(32
161.8740 +.sp |\n(31u
161.8741 +.ne \n(b|u+\n(.Vu
161.8742 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.8743 +.ta \n(80u
161.8744 +.nr 31 \n(.f
161.8745 +.nr 35 1m
161.8746 +\&\h'|\n(40u'
161.8747 +.mk ##
161.8748 +.nr 31 \n(##
161.8749 +.sp |\n(##u-1v
161.8750 +.nr 37 \n(40u
161.8751 +.in +\n(37u
161.8752 +.b+
161.8753 +.in -\n(37u
161.8754 +.mk 32
161.8755 +.if \n(32>\n(31 .nr 31 \n(32
161.8756 +.sp |\n(31u
161.8757 +.fc
161.8758 +.nr T. 1
161.8759 +.T# 1
161.8760 +.35
161.8761 +.rm a+
161.8762 +.rm b+
161.8763 +.TE
161.8764 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-30
161.8765 +
161.8766 +.LP
161.8767 +.RE
161.8768 +\f3罨<<純ャ<潟若激с潟潟<潟箴腓冴障\fP
161.8769 +.LP
161.8770 +.nf
161.8771 +\f3
161.8772 +.fl
161.8773 + /**
161.8774 +.fl
161.8775 + * Returns the character at the specified index. An index
161.8776 +.fl
161.8777 + * ranges from <code>0</code> to <code>length() \- 1</code>.
161.8778 +.fl
161.8779 + *
161.8780 +.fl
161.8781 + * @param index the index of the desired character.
161.8782 +.fl
161.8783 + * @return the desired character.
161.8784 +.fl
161.8785 + * @exception StringIndexOutOfRangeException
161.8786 +.fl
161.8787 + * if the index is not in the range <code>0</code>
161.8788 +.fl
161.8789 + * to <code>length()\-1</code>.
161.8790 +.fl
161.8791 + * @see java.lang.Character#charValue()
161.8792 +.fl
161.8793 + */
161.8794 +.fl
161.8795 + public char charAt(int index) {
161.8796 +.fl
161.8797 + ...
161.8798 +.fl
161.8799 + }
161.8800 +.fl
161.8801 +
161.8802 +.fl
161.8803 +\fP
161.8804 +.fi
161.8805 +.RE
161.8806 +.SH "激с"
161.8807 +.LP
161.8808 +.LP
161.8809 +javadoc 若篏帥c阪羆阪障Javadoc 若\-doclet 激с潟с鴻帥絎翫篁ュ罔羣篏帥障Javadoc 若篁紙篏睡с潟潟茵激с潟障 激с潟ゃJavadoc 激с潟ц障罔羣с祉ゃ菴遵潟潟茵激с潟箴障 激с潟ゃ罔羣箴激с潟ц障激с喝紊ф絖絨絖阪ャ障 激с潟綣違с紊ф絖絨絖阪ャ障
161.8810 +.LP
161.8811 +.LP
161.8812 +激с潟罨<腓冴障
161.8813 +.LP
161.8814 +.RS 3
161.8815 +
161.8816 +.LP
161.8817 +.LP
161.8818 +.TS
161.8819 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.8820 +.de 35
161.8821 +.ps \n(.s
161.8822 +.vs \n(.vu
161.8823 +.in \n(.iu
161.8824 +.if \n(.u .fi
161.8825 +.if \n(.j .ad
161.8826 +.if \n(.j=0 .na
161.8827 +..
161.8828 +.nf
161.8829 +.nr #~ 0
161.8830 +.if n .nr #~ 0.6n
161.8831 +.ds #d .d
161.8832 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.8833 +.fc
161.8834 +.nr 33 \n(.s
161.8835 +.rm 80 81 82
161.8836 +.nr 34 \n(.lu
161.8837 +.eo
161.8838 +.am 80
161.8839 +.br
161.8840 +.di a+
161.8841 +.35
161.8842 +.ft \n(.f
161.8843 +.ll \n(34u*1u/4u
161.8844 +.if \n(.l<\n(80 .ll \n(80u
161.8845 +.in 0
161.8846 +\-\f21.1\fP
161.8847 +.br
161.8848 +\-author
161.8849 +.br
161.8850 +\-\f2bootclasspath\fP
161.8851 +.br
161.8852 +\-bottom
161.8853 +.br
161.8854 +\-\f2breakiterator\fP
161.8855 +.br
161.8856 +\-charset
161.8857 +.br
161.8858 +\-\f2classpath\fP
161.8859 +.br
161.8860 +\-d
161.8861 +.br
161.8862 +\-docencoding
161.8863 +.br
161.8864 +\-docfilessubdirs
161.8865 +.br
161.8866 +\-\f2doclet\fP
161.8867 +.br
161.8868 +\-\f2docletpath\fP
161.8869 +.br
161.8870 +\-doctitle
161.8871 +.br
161.8872 +\-\f2encoding\fP
161.8873 +.br
161.8874 +\-\f2exclude\fP
161.8875 +.br
161.8876 +\-excludedocfilessubdir
161.8877 +.br
161.8878 +\-\f2extdirs\fP
161.8879 +.br
161.8880 +\-footer
161.8881 +.br
161.8882 +\-group
161.8883 +.br
161.8884 +.br
161.8885 +.di
161.8886 +.nr a| \n(dn
161.8887 +.nr a- \n(dl
161.8888 +..
161.8889 +.ec \
161.8890 +.eo
161.8891 +.am 81
161.8892 +.br
161.8893 +.di b+
161.8894 +.35
161.8895 +.ft \n(.f
161.8896 +.ll \n(34u*1u/4u
161.8897 +.if \n(.l<\n(81 .ll \n(81u
161.8898 +.in 0
161.8899 +\-header
161.8900 +.br
161.8901 +\-\f2help\fP
161.8902 +.br
161.8903 +\-helpfile
161.8904 +.br
161.8905 +\-\f2J\fP
161.8906 +.br
161.8907 +\-keywords
161.8908 +.br
161.8909 +\-link
161.8910 +.br
161.8911 +\-linkoffline
161.8912 +.br
161.8913 +\-linksource
161.8914 +.br
161.8915 +\-\f2locale\fP
161.8916 +.br
161.8917 +\-nocomment
161.8918 +.br
161.8919 +\-nodeprecated
161.8920 +.br
161.8921 +\-nodeprecatedlist
161.8922 +.br
161.8923 +\-nohelp
161.8924 +.br
161.8925 +\-noindex
161.8926 +.br
161.8927 +\-nonavbar
161.8928 +.br
161.8929 +\-noqualifier
161.8930 +.br
161.8931 +\-nosince
161.8932 +.br
161.8933 +\-notimestamp
161.8934 +.br
161.8935 +\-notree
161.8936 +.br
161.8937 +\-\f2overview\fP
161.8938 +.br
161.8939 +\-\f2package\fP
161.8940 +.br
161.8941 +.br
161.8942 +.di
161.8943 +.nr b| \n(dn
161.8944 +.nr b- \n(dl
161.8945 +..
161.8946 +.ec \
161.8947 +.eo
161.8948 +.am 82
161.8949 +.br
161.8950 +.di c+
161.8951 +.35
161.8952 +.ft \n(.f
161.8953 +.ll \n(34u*1u/4u
161.8954 +.if \n(.l<\n(82 .ll \n(82u
161.8955 +.in 0
161.8956 +\-\f2private\fP
161.8957 +.br
161.8958 +\-\f2protected\fP
161.8959 +.br
161.8960 +\-\f2public\fP
161.8961 +.br
161.8962 +\-\f2quiet\fP
161.8963 +.br
161.8964 +\-serialwarn
161.8965 +.br
161.8966 +\-\f2source\fP
161.8967 +.br
161.8968 +\-\f2sourcepath\fP
161.8969 +.br
161.8970 +\-splitindex
161.8971 +.br
161.8972 +\-stylesheetfile
161.8973 +.br
161.8974 +\-\f2subpackages\fP
161.8975 +.br
161.8976 +\-tag
161.8977 +.br
161.8978 +\-taglet
161.8979 +.br
161.8980 +\-tagletpath
161.8981 +.br
161.8982 +\-title
161.8983 +.br
161.8984 +\-use
161.8985 +.br
161.8986 +\-\f2verbose\fP
161.8987 +.br
161.8988 +\-version
161.8989 +.br
161.8990 +\-windowtitle
161.8991 +.br
161.8992 +.br
161.8993 +.di
161.8994 +.nr c| \n(dn
161.8995 +.nr c- \n(dl
161.8996 +..
161.8997 +.ec \
161.8998 +.35
161.8999 +.nf
161.9000 +.ll \n(34u
161.9001 +.nr 80 0
161.9002 +.80
161.9003 +.rm 80
161.9004 +.nr 38 \n(a-
161.9005 +.if \n(80<\n(38 .nr 80 \n(38
161.9006 +.nr 81 0
161.9007 +.81
161.9008 +.rm 81
161.9009 +.nr 38 \n(b-
161.9010 +.if \n(81<\n(38 .nr 81 \n(38
161.9011 +.nr 82 0
161.9012 +.82
161.9013 +.rm 82
161.9014 +.nr 38 \n(c-
161.9015 +.if \n(82<\n(38 .nr 82 \n(38
161.9016 +.35
161.9017 +.nf
161.9018 +.ll \n(34u
161.9019 +.nr 38 1n
161.9020 +.nr 79 0
161.9021 +.nr 40 \n(79+(0*\n(38)
161.9022 +.nr 80 +\n(40
161.9023 +.nr 41 \n(80+(3*\n(38)
161.9024 +.nr 81 +\n(41
161.9025 +.nr 42 \n(81+(3*\n(38)
161.9026 +.nr 82 +\n(42
161.9027 +.nr TW \n(82
161.9028 +.if t .if \n(TW>\n(.li .tm Table at line 2681 file Input is too wide - \n(TW units
161.9029 +.fc
161.9030 +.nr #T 0-1
161.9031 +.nr #a 0-1
161.9032 +.eo
161.9033 +.de T#
161.9034 +.ds #d .d
161.9035 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.9036 +.mk ##
161.9037 +.nr ## -1v
161.9038 +.ls 1
161.9039 +.ls
161.9040 +..
161.9041 +.ec
161.9042 +.ne \n(a|u+\n(.Vu
161.9043 +.ne \n(b|u+\n(.Vu
161.9044 +.ne \n(c|u+\n(.Vu
161.9045 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.9046 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.9047 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
161.9048 +.ta \n(80u \n(81u \n(82u
161.9049 +.nr 31 \n(.f
161.9050 +.nr 35 1m
161.9051 +\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
161.9052 +.mk ##
161.9053 +.nr 31 \n(##
161.9054 +.sp |\n(##u-1v
161.9055 +.nr 37 \n(40u
161.9056 +.in +\n(37u
161.9057 +.a+
161.9058 +.in -\n(37u
161.9059 +.mk 32
161.9060 +.if \n(32>\n(31 .nr 31 \n(32
161.9061 +.sp |\n(##u-1v
161.9062 +.nr 37 \n(41u
161.9063 +.in +\n(37u
161.9064 +.b+
161.9065 +.in -\n(37u
161.9066 +.mk 32
161.9067 +.if \n(32>\n(31 .nr 31 \n(32
161.9068 +.sp |\n(##u-1v
161.9069 +.nr 37 \n(42u
161.9070 +.in +\n(37u
161.9071 +.c+
161.9072 +.in -\n(37u
161.9073 +.mk 32
161.9074 +.if \n(32>\n(31 .nr 31 \n(32
161.9075 +.sp |\n(31u
161.9076 +.fc
161.9077 +.nr T. 1
161.9078 +.T# 1
161.9079 +.35
161.9080 +.rm a+
161.9081 +.rm b+
161.9082 +.rm c+
161.9083 +.TE
161.9084 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-123
161.9085 +
161.9086 +.LP
161.9087 +.RE
161.9088 +.LP
161.9089 +\f2ゃ帥\fPхず激с潟Javadoc 堺激с潟сJavadoc 若潟潟c箴鴻т戎с障罔羣篏ゃ帥с激с潟箴障
161.9090 +.LP
161.9091 +.SS
161.9092 +Javadoc 激с
161.9093 +.LP
161.9094 +.RS 3
161.9095 +.TP 3
161.9096 +\-overview \ path/filename
161.9097 +Javadoc 絲障\f2path/filename\fP ф絎純若鴻<ゃ网荀ャ<潟鴻緇鴻网荀若 (\f2overview\-summary.html\fP) 臀絎障\f2path/filename\fP \f2\-sourcepath\fP 吾後障鴻с
161.9098 +.LP
161.9099 +\f2filename\fP \f2path\fP 篁紙贋絎с障絽吾\f2overview.html\fP 篁純若鴻弱筝篏宴若吾cc臀障贋臀\f2\-sourcepath\fP c<ゃ腓冴с宴若吾ャ<潟 \f2path\fP 筝荀障違\f2java.lang\fP 宴若吾純若鴻若 \f2/src/classes/java/lang/\fP 翫网荀<ゃ \f2/src/classes/overview.html\fP 臀с障篏睡箴с
161.9100 +.LP
161.9101 +\f2path/filename\fP ф絎<ゃゃ网荀潟<潟<ゃс
161.9102 +.LP
161.9103 +网荀若吾篏Javadoc 茲違宴若後羝<翫с荅括完HTML 若с
161.9104 +.LP
161.9105 +网荀若吾帥ゃ\f2\-doctitle\fP c荐絎障
161.9106 +.LP
161.9107 +.TP 3
161.9108 +\-public
161.9109 +public 鴻潟<潟若茵腓冴障
161.9110 +.LP
161.9111 +.TP 3
161.9112 +\-protected
161.9113 +protected public 鴻<潟若茵腓冴障荐絎с
161.9114 +.LP
161.9115 +.TP 3
161.9116 +\-package
161.9117 +packageprotected public 鴻<潟若茵腓冴障
161.9118 +.LP
161.9119 +.TP 3
161.9120 +\-private
161.9121 +鴻鴻<潟若茵腓冴障
161.9122 +.LP
161.9123 +.TP 3
161.9124 +\-help
161.9125 +潟ゃ潟茵腓冴障 Javadoc 潟潟茵激с潟筝荀ц;腓冴障
161.9126 +.LP
161.9127 +.TP 3
161.9128 +\-doclet\ class
161.9129 +ャ<潟篏帥莎桁鴻<ゃ絎障絎絎絎阪絎鴻綵√絎臂障\f4\-doclet\fP 激с潟篏帥翫Javadoc 罔羣篏帥c HTML 綵√障鴻\f2start(Root)\fP <純障違障莎桁鴻吾鴻\f2\-docletpath\fP 激с潟c絎臂障
161.9130 +.LP
161.9131 +違MIF 若喝冴罨<絎障
161.9132 +.nf
161.9133 +\f3
161.9134 +.fl
161.9135 + \-doclet com.sun.tools.doclets.mif.MIFDoclet
161.9136 +.fl
161.9137 +\fP
161.9138 +.fi
161.9139 +.LP
161.9140 +劫絎茵絎箴ゃ
161.9141 +.na
161.9142 +\f2MIF Doclet ャ<潟\fP @
161.9143 +.fi
161.9144 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
161.9145 +.LP
161.9146 +.TP 3
161.9147 +\-docletpath\ classpathlist
161.9148 +\f2\-doclet\fP 激с潟ф絎紮鴻<ゃ潟箴絖鴻 jar <ゃ吾鴻絎障紮鴻<ゃ jar <ゃ翫篁ヤ箴 jar <ゃ鴻絎障腟九障鴻障憜c後障鴻絎с障\f2classpathlist\fP 茲違鴻障 JAR <ゃс障 翫鴻障 JAR <ゃSolaris 翫潟 (:)Windows 翫祉潟 (;) у阪障紮鴻с罎膣≪劫翫激с潟筝荀с
161.9149 +.LP
161.9150 +jar <ゃ吾鴻箴紮鴻<ゃ障障jar <ゃ障鴻羈
161.9151 +.nf
161.9152 +\f3
161.9153 +.fl
161.9154 + \-docletpath /home/user/mifdoclet/lib/mifdoclet.jar
161.9155 +.fl
161.9156 +\fP
161.9157 +.fi
161.9158 +紮鴻<ゃ鴻箴鴻<ゃャ鴻羈
161.9159 +.nf
161.9160 +\f3
161.9161 +.fl
161.9162 + \-docletpath /home/user/mifdoclet/classes/com/sun/tools/doclets/mif/
161.9163 +.fl
161.9164 +\fP
161.9165 +.fi
161.9166 +劫絎茵絎箴ゃ
161.9167 +.na
161.9168 +\f2MIF Doclet ャ<潟\fP @
161.9169 +.fi
161.9170 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
161.9171 +.LP
161.9172 +.TP 3
161.9173 +\-1.1
161.9174 +\f2罘純Javadoc 1.4 сゃ障篁f炊純障激с潟Javadoc 1.1 c紊荀罘純ゃャ<潟篏с ャ絖鴻泣若障激с潟綽荀翫Javadoc 1.2 障 1.3 篏睡\fP
161.9175 +.LP
161.9176 +.TP 3
161.9177 +\-source release
161.9178 +篁純若鴻潟若若吾с潟絎障\f2release\fP 罨<ゃ絎с障
161.9179 +.LP
161.9180 +.TS
161.9181 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
161.9182 +.de 35
161.9183 +.ps \n(.s
161.9184 +.vs \n(.vu
161.9185 +.in \n(.iu
161.9186 +.if \n(.u .fi
161.9187 +.if \n(.j .ad
161.9188 +.if \n(.j=0 .na
161.9189 +..
161.9190 +.nf
161.9191 +.nr #~ 0
161.9192 +.if n .nr #~ 0.6n
161.9193 +.ds #d .d
161.9194 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.9195 +.fc
161.9196 +.nr 33 \n(.s
161.9197 +.rm 80 81
161.9198 +.nr 34 \n(.lu
161.9199 +.eo
161.9200 +.am 81
161.9201 +.br
161.9202 +.di a+
161.9203 +.35
161.9204 +.ft \n(.f
161.9205 +.ll \n(34u*1u/3u
161.9206 +.if \n(.l<\n(81 .ll \n(81u
161.9207 +.in 0
161.9208 +Javadoc JDK 1.5 уャ膩霡違割荐茯罘純潟若篁障\f3\-source\fP 違絎潟潟ゃ 1.5 篏障
161.9209 +.br
161.9210 +.di
161.9211 +.nr a| \n(dn
161.9212 +.nr a- \n(dl
161.9213 +..
161.9214 +.ec \
161.9215 +.eo
161.9216 +.am 81
161.9217 +.br
161.9218 +.di b+
161.9219 +.35
161.9220 +.ft \n(.f
161.9221 +.ll \n(34u*1u/3u
161.9222 +.if \n(.l<\n(81 .ll \n(81u
161.9223 +.in 0
161.9224 +Javadoc JDK 1.4 уャ≪泣若激с潟潟若篁障
161.9225 +.br
161.9226 +.di
161.9227 +.nr b| \n(dn
161.9228 +.nr b- \n(dl
161.9229 +..
161.9230 +.ec \
161.9231 +.eo
161.9232 +.am 81
161.9233 +.br
161.9234 +.di c+
161.9235 +.35
161.9236 +.ft \n(.f
161.9237 +.ll \n(34u*1u/3u
161.9238 +.if \n(.l<\n(81 .ll \n(81u
161.9239 +.in 0
161.9240 +Javadoc JDK 1.3 篁ラ絨ャ≪泣若激с潟膩霡違障篁荐茯罘純泣若障
161.9241 +.br
161.9242 +.di
161.9243 +.nr c| \n(dn
161.9244 +.nr c- \n(dl
161.9245 +..
161.9246 +.ec \
161.9247 +.35
161.9248 +.nf
161.9249 +.ll \n(34u
161.9250 +.nr 80 0
161.9251 +.nr 31 0
161.9252 +.nr 32 0
161.9253 +.nr 38 \w\f31
161.9254 +.if \n(31<\n(38 .nr 31 \n(38
161.9255 +.nr 38 \w.5\fP
161.9256 +.if \n(32<\n(38 .nr 32 \n(38
161.9257 +.nr 38 \w\f31
161.9258 +.if \n(31<\n(38 .nr 31 \n(38
161.9259 +.nr 38 \w.4\fP
161.9260 +.if \n(32<\n(38 .nr 32 \n(38
161.9261 +.nr 38 \w\f31
161.9262 +.if \n(31<\n(38 .nr 31 \n(38
161.9263 +.nr 38 \w.3\fP
161.9264 +.if \n(32<\n(38 .nr 32 \n(38
161.9265 +.80
161.9266 +.rm 80
161.9267 +.nr 60 \n(31
161.9268 +.nr 38 \n(60+\n(32
161.9269 +.if \n(38>\n(80 .nr 80 \n(38
161.9270 +.if \n(38<\n(80 .nr 60 +(\n(80-\n(38)/2
161.9271 +.nr 81 0
161.9272 +.81
161.9273 +.rm 81
161.9274 +.nr 38 \n(a-
161.9275 +.if \n(81<\n(38 .nr 81 \n(38
161.9276 +.nr 38 \n(b-
161.9277 +.if \n(81<\n(38 .nr 81 \n(38
161.9278 +.nr 38 \n(c-
161.9279 +.if \n(81<\n(38 .nr 81 \n(38
161.9280 +.35
161.9281 +.nf
161.9282 +.ll \n(34u
161.9283 +.nr 38 1n
161.9284 +.nr 79 0
161.9285 +.nr 40 \n(79+(0*\n(38)
161.9286 +.nr 80 +\n(40
161.9287 +.nr 60 +\n(40
161.9288 +.nr 41 \n(80+(3*\n(38)
161.9289 +.nr 81 +\n(41
161.9290 +.nr TW \n(81
161.9291 +.if t .if \n(TW>\n(.li .tm Table at line 2791 file Input is too wide - \n(TW units
161.9292 +.fc
161.9293 +.nr #T 0-1
161.9294 +.nr #a 0-1
161.9295 +.eo
161.9296 +.de T#
161.9297 +.ds #d .d
161.9298 +.if \(ts\n(.z\(ts\(ts .ds #d nl
161.9299 +.mk ##
161.9300 +.nr ## -1v
161.9301 +.ls 1
161.9302 +.ls
161.9303 +..
161.9304 +.ec
161.9305 +.ne \n(a|u+\n(.Vu
161.9306 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
161.9307 +.ta \n(60u \n(80u \n(81u
161.9308 +.nr 31 \n(.f
161.9309 +.nr 35 1m
161.9310 +\&\h'|\n(40u'\f31.5\fP\h'|\n(41u'
161.9311 +.mk ##
161.9312 +.nr 31 \n(##
161.9313 +.sp |\n(##u-1v
161.9314 +.nr 37 \n(41u
161.9315 +.in +\n(37u
161.9316 +.a+
161.9317 +.in -\n(37u
161.9318 +.mk 32
161.9319 +.if \n(32>\n(31 .nr 31 \n(32
161.9320 +.sp |\n(31u
161.9321 +.ne \n(b|u+\n(.Vu
161.9322 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
161.9323 +.ta \n(60u \n(80u \n(81u
161.9324 +.nr 31 \n(.f
161.9325 +.nr 35 1m
161.9326 +\&\h'|\n(40u'\f31.4\fP\h'|\n(41u'
161.9327 +.mk ##
161.9328 +.nr 31 \n(##
161.9329 +.sp |\n(##u-1v
161.9330 +.nr 37 \n(41u
161.9331 +.in +\n(37u
161.9332 +.b+
161.9333 +.in -\n(37u
161.9334 +.mk 32
161.9335 +.if \n(32>\n(31 .nr 31 \n(32
161.9336 +.sp |\n(31u
161.9337 +.ne \n(c|u+\n(.Vu
161.9338 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
161.9339 +.ta \n(60u \n(80u \n(81u
161.9340 +.nr 31 \n(.f
161.9341 +.nr 35 1m
161.9342 +\&\h'|\n(40u'\f31.3\fP\h'|\n(41u'
161.9343 +.mk ##
161.9344 +.nr 31 \n(##
161.9345 +.sp |\n(##u-1v
161.9346 +.nr 37 \n(41u
161.9347 +.in +\n(37u
161.9348 +.c+
161.9349 +.in -\n(37u
161.9350 +.mk 32
161.9351 +.if \n(32>\n(31 .nr 31 \n(32
161.9352 +.sp |\n(31u
161.9353 +.fc
161.9354 +.nr T. 1
161.9355 +.T# 1
161.9356 +.35
161.9357 +.rm a+
161.9358 +.rm b+
161.9359 +.rm c+
161.9360 +.TE
161.9361 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-14
161.9362 +.LP
161.9363 +javac с潟若潟潟ゃ篏睡ゃ絲上 \f2release\fP ゃ篏睡障
161.9364 +.LP
161.9365 +.TP 3
161.9366 +\-sourcepath\ sourcepathlist
161.9367 +\f2javadoc\fP 潟潟宴若後障 \f2\-subpackages\fP 羝<純若鴻<ゃ (\f2.java\fP) 罎膣≪鴻絎障\f2sourcepathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎剛札筝鴻泣c罎膣≪障激с潟篏帥cャ<潟純若鴻<ゃ篏臀с篏ャ<潟ャ<潟純若鴻<ゃ膓帥潟<潟ゃ純若鴻<ゃ篏臀腆肴с障
161.9368 +.LP
161.9369 +\f2\-sourcepath\fP 激с潟javadoc 潟潟宴若後羝<篏睡с障 \f2javadoc\fP 潟潟羝< \f2.java\fP <ゃ鴻罎膣≪障\f2.java\fP <ゃ罎膣≪<ゃc cd c腱糸障<ゃ鴻障 (1 や札筝鴻ャ<潟)\f2\-sourcepath\fP ャ翫Javadoc 鴻鴻篏帥c純若鴻<ゃ罎膣≪障 (\-classpath )c \-sourcepath 鴻鴻ゃс\-classpath ャ宴若後 Javadoc 羝<Javadoc 憜c潟泣c純若鴻<ゃ罎膣≪障
161.9370 +.LP
161.9371 +\f2sourcepathlist\fP ャ<潟宴若後純若鴻若若c荐絎障違\f2com.mypackage\fP 宴若吾ャ<潟翫純若鴻<ゃ罨<贋障
161.9372 +.nf
161.9373 +\f3
161.9374 +.fl
161.9375 + /home/user/src/com/mypackage/*.java
161.9376 +.fl
161.9377 +\fP
161.9378 +.fi
161.9379 +翫罨< \f2sourcepath\fP \f2/home/user/src\fPゃ障 \f2com/mypackage\fP c絎宴若後 \f2com.mypackage\fP 絎障
161.9380 +.nf
161.9381 +\f3
161.9382 +.fl
161.9383 + % \fP\f3javadoc \-sourcepath /home/user/src/ com.mypackage\fP
161.9384 +.fl
161.9385 +.fi
161.9386 +号純若鴻鴻ゃ宴若後g (荐) \\紊宴若吾 (C:\\user\\src\\com\\mypackage) 茹c膂≦с\f2/home/user/src/com/mypackage\fP.
161.9387 +.LP
161.9388 +2 ゃ純若鴻鴻荐絎罨<障
161.9389 +.nf
161.9390 +\f3
161.9391 +.fl
161.9392 + % \fP\f3javadoc \-sourcepath /home/user1/src:/home/user2/src com.mypackage\fP
161.9393 +.fl
161.9394 +.fi
161.9395 +.LP
161.9396 +.TP 3
161.9397 +\-classpath\ classpathlist
161.9398 +Javadoc с (\f2.class\fP <ゃ) 罎膣≪鴻絎障 с鴻ャ<潟鴻鴻cс鴻鴻с\f2classpathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣c罎膣≪障\f2classpathlist\fP 絎
161.9399 +.na
161.9400 +\f2鴻\fP @
161.9401 +.fi
161.9402 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#generalャ<潟腓冴緇c
161.9403 +.LP
161.9404 +\f2\-sourcepath\fP ャ翫Javadoc 若\f2\-classpath\fP 篏帥c鴻<ゃс純若鴻<ゃ罎膣≪障 (筝篏篋с)c純若鴻<ゃ鴻<ゃャ鴻罎膣≪綽荀翫\f2\-sourcepath\fP \f2\-classpath\fP 筝≧鴻篏帥障
161.9405 +.LP
161.9406 +違\f2com.mypackage\fP ャ<潟翫純若鴻<ゃc \f2/home/user/src/com/mypackage\fP 宴若吾 \f2/home/user/lib\fP ゃ篏帥с違罨<絎障
161.9407 +.nf
161.9408 +\f3
161.9409 +.fl
161.9410 + % \fP\f3javadoc \-classpath /home/user/lib \-sourcepath /home/user/src com.mypackage\fP
161.9411 +.fl
161.9412 +.fi
161.9413 +祉若罕\f2\-classpath\fP 絎翫CLASSPATH 医紊違荐絎違Javadoc 若医紊違篏帥障<荐絎翫Javadoc 若憜c鴻罎膣≪障
161.9414 +.LP
161.9415 +Javadoc 若≦宍罘純鴻潟若鴻鴻∫cJavadoc 若 \f2\-classpath\fP 篏睡若吟若鴻罎膣≪号ゃ荅括完
161.9416 +.na
161.9417 +\f2鴻罎膣∽号\fP @
161.9418 +.fi
161.9419 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html荀с
161.9420 +.LP
161.9421 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
161.9422 +.br
161.9423 +.br
161.9424 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
161.9425 +.LP
161.9426 +.TP 3
161.9427 +\-subpackages\ \ package1:package2:...
161.9428 +純若鴻<ゃ絎宴若吾潟泣宴若後絽亥ャ<潟障激с潟純若鴻潟若違泣宴若吾菴遵箴水с違泣宴若吾腟粋昭障障 \f2package\fP 綣違篁紙筝篏泣宴若 (\f2java\fP ) 障絎絎宴若 (\f2javax.swing\fP ) 障純若鴻<ゃ綽荀障綣違潟潟у阪障 (鴻若c潟違激鴻)ゃ若筝荀с (篏睡筝)宴若吾罎膣√贋絎\f2\-sourcepath\fP 篏睡障激с潟純若鴻<ゃц純若鴻若宴若吾絮純若鴻<ゃу醜腴<障
161.9429 +.LP
161.9430 +箴腓冴障
161.9431 +.nf
161.9432 +\f3
161.9433 +.fl
161.9434 + % \fP\f3javadoc \-d docs \-sourcepath /home/user/src \-subpackages java:javax.swing\fP
161.9435 +.fl
161.9436 +.fi
161.9437 +潟潟java潟javax.swing宴若吾泣宴若後ャ<潟障
161.9438 +.LP
161.9439 +\f2\-exclude\fP \f2\-subpackages\fP 篏睡劫宴若吾ゅс障
161.9440 +.LP
161.9441 +.TP 3
161.9442 +\-exclude\ \ packagename1:packagename2:...
161.9443 +絎宴若吾泣宴若吾 \f2\-subpackages\fP c篏鴻≧>散ゅ障サ \f2\-subpackages\fP 激с潟絎c腟粋昭障宴若吾障絨ョ粋昭障宴若吾ゅ絲乗院障箴腓冴障
161.9444 +.nf
161.9445 +\f3
161.9446 +.fl
161.9447 + % \fP\f3javadoc \-sourcepath /home/user/src \-subpackages java \-exclude java.net:java.lang\fP
161.9448 +.fl
161.9449 +.fi
161.9450 +<\f2java.io\fP\f2java.util\fP\f2java.math\fP 腟粋昭障障\f2java.net\fP \f2java.lang\fP 篁ヤ宴若吾ゅ障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
161.9451 +.LP
161.9452 +.TP 3
161.9453 +\-bootclasspath\ classpathlist
161.9454 +若鴻絖鴻絎障若鴻絽吾Java 若潟≪鴻с若鴻鴻Javadoc 若純若鴻<ゃ鴻<ゃ「篏帥罎膣≪鴻筝с荅括完
161.9455 +.na
161.9456 +\f2javac javadoc 鴻罎膣≪号\fP @
161.9457 +.fi
161.9458 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfilesс\f2classpathlist\fP 茲違c潟 (:) у阪障
161.9459 +.LP
161.9460 +.TP 3
161.9461 +\-extdirs\ dirlist
161.9462 +≦宍罘純鴻絖c絎障≦宍罘純鴻Java ≦宍罘醇罕篏帥鴻鴻сextdirs Javadoc 若純若鴻<ゃ鴻<ゃ「篏帥罎膣≪鴻筝с荅括完菴違 \f2\-classpath\fP с\f2dirlist\fP 茲違c潟 (:) у阪障
161.9463 +.LP
161.9464 +.TP 3
161.9465 +\-verbose
161.9466 +javadoc 絎茵筝荅括完<祉若吾茵腓冴障verbose 激с潟絎純若鴻<ゃ若ャ<潟 (純若鴻<ゃ 1 ゃ<祉若)潟純若<祉若吾茵腓冴障verbose 激с潟絎 Java 純若鴻<ゃ茹f荀 (腱篏) 菴遵<祉若吾茵腓冴障
161.9467 +.LP
161.9468 +.TP 3
161.9469 +\-quiet
161.9470 +若<祉若吾障茘<祉若娯札紊<祉若吾吟茘若茵腓冴劫障若吾с恰絖吟障
161.9471 +.LP
161.9472 +.TP 3
161.9473 +\-breakiterator\
161.9474 +沿荐茯宴若堺≪眼冴с
161.9475 +.na
161.9476 +\f2java.text.BreakIterator\fP @
161.9477 +.fi
161.9478 +http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html 初紜篏睡掩腟ゆ障 (篁鴻宴若с \f2BreakIterator\fP 篏睡)\f2\fP宴若吾鴻障<潟若筝肢сс宴若吾鴻障<潟若荀膣潟若≪<ゃ潟鴻潟若障
161.9479 +.LP
161.9480 +JDK 1.2 篁ラBreakIterator 鴻沿ゃ鴻荐茯腟ゆс篏睡障c1.2 篁ラс\f2\-breakiterator\fP 激с潟掩篁ュ号障掩罨<≪眼冴障
161.9481 +.RS 3
161.9482 .TP 2
161.9483 o
161.9484 -jdb
161.9485 +掩阪≪眼冴 \- 腥榊純障 HTML 帥 (\f2<P>\fP ) 膓у罩≪
161.9486 .TP 2
161.9487 o
161.9488 -javah
161.9489 +breakiterator 阪≪眼冴 \- 筝罨<茯紊ф絖у障翫腥榊醇絖膓霳障膃у罩≪≪眼冴с祉ヨ;荐 (The serial no. is validMr. Smith)HTML 帥違医障荐垩у障с罩≪HTML 帥違莨若障翫с../filename緇у罩≪
161.9490 +.RE
161.9491 +.RS 3
161.9492 +
161.9493 +.LP
161.9494 +.LP
161.9495 +羈: 1.5.0 1.4.x 荐 breakiterator 茘<祉若吾ゃ阪≪眼冴紊眼障ゃ障\\\-breakiterator 激с潟1.5.0 сс障ゃ障罨<<吾c若若鴻(1.5.0) с紊眼篁ュc障ゃ障純若鴻潟若紊眼1.4.x с breakiterator 茘ゅサ翫с1.5.0 篏綽荀茘羔羯障 祉宴breakiterator <綽荀篋с純若鴻紊眼鴻莢紊сcс篁吟х罕篏羞隙恒荅潟障
161.9496 +.LP
161.9497 +.RE
161.9498 +.TP 3
161.9499 +\-locale\ language_country_variant
161.9500 +.RS 3
161.9501 +.LP
161.9502 +\f3荀\fP \- \f2\-locale\fP 激с潟罔羣箴鴻激с潟障篁篁紙箴鴻激с潟 (綏) 絎綽荀障蚊若激с潟若沿ц;腓冴障潟潟茵激с潟絎綺箴絖障
161.9503 +.LP
161.9504 +.RE
161.9505 +.LP
161.9506 +Javadoc ャ<潟篏帥宴若絎障綣違java.util.Locale ャ<潟ц宴若絎障違\f2en_US\fP (沿膠喝)\f2en_US_WIN\fP (Windows т戎沿) 絎障
161.9507 +.LP
161.9508 +宴若絎絎宴若純若鴻<ゃ Javadoc c御<祉若 (蚊若激с潟若鴻茵荀冴<ゃ罨<stylesheet.css 潟<潟絖) 篏帥障障≪<純若鴻純若恰絨障ゅャ阪絖絎宴若c羆冴障障激с潟ャ<潟鴻純若鴻<ゃф絎ャ<潟若激с潟潟<潟鴻宴若羆阪с障
161.9509 +.LP
161.9510 +.TP 3
161.9511 +\-encoding\ name
161.9512 +純若鴻<ゃ潟潟若c潟違 (\f2EUCJIS/SJIS\fP ) 絎障激с潟絎翫若潟潟若帥篏帥障
161.9513 +.LP
161.9514 +\-docencoding \-charset с
161.9515 +.LP
161.9516 +.TP 3
161.9517 +\-Jflag
161.9518 +javadoc 絎茵絎茵激鴻 java \f2flag\fP 贋・羝<障\f2J\fP \f2flag\fP 腥榊純ャ障違ャ<潟激鴻 32M ゃ<≪若腆坂鏆荀翫Java \f2\-Xmx\fP 激с潟罨<若喝冴障 \f2\-Xms\fP ュ純с <≪若泣ゃ冴荐絎激с潟с綽荀<≪若絨泣ゃ冴c翫箴水с
161.9519 +.nf
161.9520 +\f3
161.9521 +.fl
161.9522 + % \fP\f3javadoc \-J\-Xmx32m \-J\-Xms32m\fP \f3com.mypackage\fP
161.9523 +.fl
161.9524 +.fi
161.9525 +篏睡 javadoc 若吾с潟腆肴罨< java \f2\-version\fP激с潟若喝冴障
161.9526 +.nf
161.9527 +\f3
161.9528 +.fl
161.9529 + % \fP\f3javadoc \-J\-version\fP
161.9530 +.fl
161.9531 + java version "1.2"
161.9532 +.fl
161.9533 + Classic VM (build JDK\-1.2\-V, green threads, sunwjit)
161.9534 +.fl
161.9535 +.fi
161.9536 +阪鴻若罔羣若吾с括垩障障
161.9537 +.RE
161.9538 +.SS
161.9539 +罔羣箴激с
161.9540 +.LP
161.9541 +.RS 3
161.9542 +.TP 3
161.9543 +\-d\ directory
161.9544 + HTML <ゃ篆絖c絎障(d (destination))激с潟ャ<ゃ憜c篆絖障 \f2directory\fP 腟九障c障憜篏罐c後障c絎с障若吾с 1.4 сjavadoc 絎茵c篏障
161.9545 +.LP
161.9546 +違罨<箴с\f2com.mypackage\fP 宴若吾ャ<潟腟 \f2/home/user/doc/\fP c篆絖障
161.9547 +.nf
161.9548 +\f3
161.9549 +.fl
161.9550 + % \fP\f3javadoc \-d /home/user/doc com.mypackage\fP
161.9551 +.fl
161.9552 +.fi
161.9553 +.LP
161.9554 +.TP 3
161.9555 +\-use
161.9556 +ャ<潟鴻潟宴若吾 1 ゃ [篏睡] 若吾腟粋昭帥障若吾劫鴻障宴若吾 API 篏帥c宴若吾鴻<純潟潟鴻帥潟c若荐菴違障違 C 箴 C 篏帥cC 泣鴻C 絎hc若C 菴<純潟 C <若帥ゃ<純潟潟鴻帥障
161.9557 +.LP
161.9558 +違String [篏睡] 若吾篏茵腓冴荀帥障\f2java.awt.Font\fP 鴻 \f2getName()\fP <純\f2String\fP 菴障c\f2getName()\fP \f2String\fP 篏帥cс\f2String\fP [篏睡] 若吾<純障
161.9559 +.LP
161.9560 +ャ<潟 API 篏睡сc絎茖ャ<潟障<純絎茖筝 \f2String\fP 篏帥c綣違絖c絖菴翫\f2String\fP 篏睡帥障
161.9561 +.LP
161.9562 + [篏睡] 若吾≪祉鴻鴻障宴若吾腱糸蚊若激с潟若 [篏睡] 潟障
161.9563 +.TP 3
161.9564 +\-version
161.9565 +ャ<潟@version 鴻腟粋昭帥障鴻сャ障篏睡 Javadoc 若若吾с潟腆肴\f2\-J\-version\fP 激с潟篏睡障
161.9566 +.LP
161.9567 +.TP 3
161.9568 +\-author
161.9569 +ャ<潟@author 鴻腟粋昭帥障
161.9570 +.LP
161.9571 +.TP 3
161.9572 +\-splitindex
161.9573 +膣√<ゃ≪<茲違<ゃ蚊絖 1 ゃ<ゃ≪<篁ュ絖у障膣√潟 1 ゃ<ゃ篏障
161.9574 +.LP
161.9575 +.TP 3
161.9576 +\-windowtitle\ title
161.9577 +HTML <title> 帥違臀帥ゃ絎障絎帥ゃc潟帥ゃ若吾絲障篏吟若 (羂ャ) 茵腓冴障帥ゃ HTML 帥違с 帥ゃ HTML 帥違障吟帥違罩c頵iс障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障\-windowtitle ャ翫Javadoc 若激с潟篁c \-doctitle ゃ篏帥障
161.9578 +.nf
161.9579 +\f3
161.9580 +.fl
161.9581 + % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
161.9582 +.fl
161.9583 +.fi
161.9584 +.TP 3
161.9585 +\-doctitle\ title
161.9586 +网荀<ゃ筝菴臀帥ゃ絎障帥ゃ筝紊 1 荀冴筝蚊若激с潟若筝臀障\f2title\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2title\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
161.9587 +.nf
161.9588 +\f3
161.9589 +.fl
161.9590 + % \fP\f3javadoc \-doctitle "Java (TM)" com.mypackage\fP
161.9591 +.fl
161.9592 +.fi
161.9593 +.TP 3
161.9594 +\-title\ title
161.9595 +\f3激с潟憜絖障\fPJavadoc 1.2 若睡絖障激с潟\f2\-doctitle\fP 紊眼障紊眼宴激с潟c潟帥ゃсャ<潟帥ゃ絎臂腆冴с
161.9596 +.LP
161.9597 +.TP 3
161.9598 +\-header\ header
161.9599 +阪<ゃ筝腴臀若鴻絎障若筝蚊若激с潟若勀眼臀障\f2header\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2header\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
161.9600 +.nf
161.9601 +\f3
161.9602 +.fl
161.9603 + % \fP\f3javadoc \-header "<b>Java 2 Platform </b><br>v1.4" com.mypackage\fP
161.9604 +.fl
161.9605 +.fi
161.9606 +.LP
161.9607 +.TP 3
161.9608 +\-footer\ footer
161.9609 +阪<ゃ筝腴臀帥若鴻絎障帥若筝蚊若激с潟若勀眼臀障 \f2footer\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2footer\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
161.9610 +.LP
161.9611 +.TP 3
161.9612 +\-bottom\ text
161.9613 +阪<ゃ筝臀鴻絎障鴻筝蚊若激с潟若筝若吾筝臀障\f2text\fP HTML 帥違腥榊純с障翫篏綣膃у蚊障違障\f2text\fP 筝у膃篏帥翫綣膃鴻宴若綽荀障
161.9614 +.LP
161.9615 +.TP 3
161.9616 +\-link\ extdocURL
161.9617 +javadoc √紊с鴻ャ<潟若激с潟吾潟篏障綣違 1 ゃ障
161.9618 +.LP
161.9619 +.RS 3
161.9620 .TP 2
161.9621 o
161.9622 -javap
161.9623 +\f4extdocURL\fP 潟絎javadoc c紊ャ<潟c腟九 URL 障後 URL ст腓冴障c宴若吾鴻<ゃ絖違障 絖翫\f2\-linkoffline\fP 篏睡障Javadoc 若\f2宴若吾鴻\fP<ゃ宴若後茯水宴若吾 URL 潟障Javadoc 若絎茵篏 \f2<A HREF>\fP 潟 \f2extdocURL\fP ゃ障障潟若障c\f2extdocURL\fP <ゃ吾 URL сc吾 URLс違障
161.9624 +.LP
161.9625 +\f2extdocURL\fP 吾腟九障潟篏睡若吟若ャ<潟篁紙 Web 泣ゃ筝ャ<潟潟с障 後鞘臀吾潟с翫後障潟篏睡с障後障潟篏睡翫\f2\-d\fP 篏帥cc潟宴若吾c後障鴻絎綽荀障
161.9626 +.LP
161.9627 +絽吾腟九障潟絎翫\f2http:\fP潟篏睡障Web 泣若若<ゃ激鴻潟翫\f2file:\fP 潟篏睡с障号鴻若吟若<ゃ激鴻掩ャ<潟≪祉鴻綽荀翫篁ュ篏睡с
161.9628 +.LP
161.9629 +翫若c潟違激鴻с腟九 URL 後 URL http:若鴻file:若鴻鴻激ャ阪絖篏睡障 (
161.9630 +.na
161.9631 +\f2URL Memo\fP @
161.9632 +.fi
161.9633 +http://www.ietf.org/rfc/rfc1738.txt ф絎)
161.9634 +.RS 3
161.9635 +.TP 3
161.9636 +http:若鴻腟九障潟:
161.9637 +\f2\-link http://<host>/<directory>/<directory>/.../<name>\fP
161.9638 +.TP 3
161.9639 +file:若鴻腟九障潟:
161.9640 +\f2\-link file://<host>/<directory>/<directory>/.../<name>\fP
161.9641 +.TP 3
161.9642 +後障潟:
161.9643 +\f2\-link <directory>/<directory>/.../<name>\fP
161.9644 +.RE
161.9645 +.RE
161.9646 +.LP
161.9647 +javadoc 絎茵茲違 \f2\-link\fP 激с潟絎茲違ャ<潟吾潟篏с障 \f3\-linkoffline 障 \-link 御\fP
161.9648 +.br
161.9649 +\f2\-link\fP 篏睡翫:
161.9650 +.RS 3
161.9651 .TP 2
161.9652 o
161.9653 +紊 API ャ<潟吾後障鴻篏睡翫
161.9654 +.TP 2
161.9655 +o
161.9656 +紊 API ャ<潟吾腟九 URL 篏睡翫 (違 URL ・膓茯水茵激сc荐怨翫)
161.9657 +.RE
161.9658 +罨<翫\f2\-linkoffline\fP 激с潟篏睡障
161.9659 +.RS 3
161.9660 +.TP 2
161.9661 +o
161.9662 +違 URL ・膓茯水茵激сc荐怨翫紊 API ャ<潟吾腟九 URL 篏睡翫倶潟ャ<潟<ゃ≪若眼翫榊障
161.9663 +.RE
161.9664 +.LP
161.9665 +\f3紊ャ<潟吾腟九障潟篏睡箴\fP \-
161.9666 +.na
161.9667 +\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
161.9668 +.fi
161.9669 +http://java.sun.com/j2se/1.5.0/docs/api \f2java.lang\fP\f2java.io\fP篁 Java 2 若宴若吾潟翫障 罨<潟潟\f2com.mypackage\fP 宴若吾ャ<潟 Java 2 若宴若吾吾潟障ャ<潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP \f2\-d\fP 篁激с潟茵腓冴障
161.9670 +.nf
161.9671 +\f3
161.9672 +.fl
161.9673 + % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
161.9674 +.fl
161.9675 +.fi
161.9676 +\f3紊ャ<潟吾後障潟篏睡箴\fP \- 2 ゃ宴若吾ャ<潟 Javadoc 若茲医絎茵腟с障 ャ<潟後障鴻у蚊障箴翫2 ゃ宴若吾API с \f2com.apipackage\fP SPI (泣若鴻ゃゃ潟帥с若) с \f2com.spipackage\fP сャ<潟主 \f2docs/api/com/apipackage\fP 宴若吾 \f2docs/spi/com/spipackage\fP 宴若吾сAPI 宴若吾ャ<潟с憜c \f2docs\fP с翫罨<潟潟絎茵c API ャ<潟吾潟 SPI 宴若吾ャ<潟障
161.9677 +.nf
161.9678 +\f3
161.9679 +.fl
161.9680 + % \fP\f3javadoc \-d ./spi \-link ../api com.spipackage\fP
161.9681 +.fl
161.9682 +.fi
161.9683 +.LP
161.9684 +\f2\-link\fP 綣違c (\f2docs/spi\fP) 後障鴻с
161.9685 +.LP
161.9686 +\f3荅括完\fP \- \f2\-link\fP 激с潟篏帥潟若сJavadoc 篁絎茵сャ<潟鴻潟с障潟鴻若吾腱糸с HTML 若吾贋茯帥鴻贋 \f2extdocURL\fP 絎綽荀障激с潟篏帥違泣若若c若ャ<潟\f2http://java.sun.com\fP \f2java.*\fP ャ<潟潟с障
161.9687 +.LP
161.9688 +篁絎茵 Javadoc cャ<潟 API 絲乗院潟篏翫\f2\-link\fP 激с潟ャ障\f2\-link\fP 激с潟絎翫Javadoc 若紊сャ<潟吾潟篏障ャ<潟絖喝翫贋ゅャсс
161.9689 +.LP
161.9690 +激с潟сャ<潟茲違贋潟篏с障
161.9691 +.LP
161.9692 +障激с潟篏帥茲違宴若悟召鴻潟篏с障ゃ障筝綣宴若吾絲障 javadoc 絎茵ャ筝綣宴若吾絲障 javadoc 絎茵 2 ゃ宴若悟召鴻潟篏с障
161.9693 +.LP
161.9694 +\f3鴻ф号\fP \- 紊с鴻吾潟鴻с鎘茵腓冴罨<号с鴻с綽荀障<純篏с鴻ссс障\f2import\fP 障絎hус綽荀障罨< \f2java.io.File\fP с号箴腓冴障
161.9695 +.RS 3
161.9696 +.TP 2
161.9697 +o
161.9698 +鴻腮蕁 \f2import\fP 翫: ゃ若ゃ潟若腓榊ゃ潟若障 \f2java.lang.*\fP 絲障ゃ潟若違罨<医с
161.9699 +.br
161.9700 +\f2import java.io.*;\fP
161.9701 +.br
161.9702 +1.3.x 1.2.x с腓榊ゃ潟若сゃ若ゃ潟若ゃ潟若 \f2java.lang.*\fP 篏睡с障
161.9703 +.TP 2
161.9704 +o
161.9705 +絎h翫:
161.9706 +.br
161.9707 +\f2void foo(File f) {}\fP
161.9708 +.br
161.9709 +с篏睡<純潟潟鴻帥c若鴻障ゃ潟帥с若鴻祉ゃ障<若帥臀\f2implements\fP\f2extends\fP障 \f2throws\fP 臀障
161.9710 +.RE
161.9711 +.LP
161.9712 +腟\f2\-link\fP 激с潟篏睡狗茯ゃc茵腓冴紊潟紊亥榊醇с障鴻ゃ若鴻潟篁茵腓冴障潟茵腓冴茘潟茯茘с障鴻罩cсc潟菴遵c絎号筝ц綵荅蚊鴻ゃ潟若с
161.9713 +.LP
161.9714 +\f3宴若吾鴻\fP \- \f2\-link\fP 激с潟\f2package\-list\fP <ゃ荀羆障 <ゃJavadoc 若c\f2\-link\fP c絎 URL 絖障\f2package\-list\fP <ゃ贋ャ<潟宴若吾鴻ャc膣鴻<ゃс箴сJavadoc 若絎 URL \f2package\-list\fP <ゃ「宴若後茯粋昭с URL 宴若吾吾潟篏障
161.9715 +.LP
161.9716 +違Java 若 v5.0 API 宴若吾鴻
161.9717 +.na
161.9718 +\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
161.9719 +.fi
161.9720 +http://java.sun.com/j2se/1.5.0/docs/api/package\-list 罨<絎鴻у障c障
161.9721 +.nf
161.9722 +\f3
161.9723 +.fl
161.9724 + java.applet
161.9725 +.fl
161.9726 + java.awt
161.9727 +.fl
161.9728 + java.awt.color
161.9729 +.fl
161.9730 + java.awt.datatransfer
161.9731 +.fl
161.9732 + java.awt.dnd
161.9733 +.fl
161.9734 + java.awt.event
161.9735 +.fl
161.9736 + java.awt.font
161.9737 +.fl
161.9738 + 篁 ...
161.9739 +.fl
161.9740 +\fP
161.9741 +.fi
161.9742 +.LP
161.9743 +\f2\-link\fP 激с潟絎 javadoc 絎茵翫紊с鴻絮荀ゃjavadoc 潟綵≪у阪障筝鴻\f2\-link\fP 激с潟絎翫絎 \f2extdocURL\fP \f2package\-list\fP <ゃ荅峨宴若後罎膣≪障宴若後荀ゃ\f2extdocURL\fP 篁障
161.9744 +.LP
161.9745 +鴻潟罩c閟純紊с鴻ャ<潟絎 URL 絖違障Javadoc 若絎 package\-list 絖茯帥鴻с絎 URL 若吾絖с障
161.9746 +.LP
161.9747 +\f3茲違潟\fP \- 茲違 \f2\-link\fP 激с潟絎篁紙違紊ャ<潟絲障潟荐絎с障Javadoc 1.2 茲違 \f2\-link\fP 激с潟絎с違障 1.2.2 т信罩c障
161.9748 +.LP
161.9749 +潟紊ャ<潟罨<ャ潟激с潟絎障
161.9750 +.LP
161.9751 +\ \ \f2% \fP\f4javadoc \-link\fP \f2extdocURL1\fP \f4\-link\fP \f2extdocURL2\fP \f2...\fP\f4\-link\fP \f2extdocURLn\fP \f4com.mypackage\fP
161.9752 +.LP
161.9753 +\f2extdocURL1\fP\f2extdocURL2\fP... \f2extdocURLn\fP 紊ャ<潟若若 \f2package\-list\fP <ゃャc障
161.9754 +.LP
161.9755 +\f3鴻潟\fP \- 障 2 や札筝ャ<潟鴻潟翫若鴻綽荀障ゃ障ャ<潟ゃ \f2package\-list\fP 絖翫ャ<潟絲障 javadoc 若絎茵鴻с2 ャ<潟 \f2package\-list\fP 障絖障c紊潟篏2 ャ<潟сャ<潟眼綽荀障
161.9756 +.LP
161.9757 +翫ャ<潟ャ<潟 \f2package\-list\fP 篏с 宴若後鴻<翫package\-list тс障罨<2 ャ<潟紊潟障綽荀紊 \f2package\-list\fP <ゃ絖翫Javadoc 若茘茵腓冴障
161.9758 +.LP
161.9759 +.TP 3
161.9760 +\-linkoffline\ extdocURL\ packagelistLoc
161.9761 +激с潟\f2\-link\fP 激с潟紊с <javadoc c紊с鴻ャ<潟吾潟篏障Javadoc 若篏ゃ潟c (Web ・膓篏帥cャ<潟≪祉鴻с)Web 筝ャ<潟潟\f2\-linkoffline\fP 激с潟篏睡障
161.9762 +.LP
161.9763 +ウ絲紊ャ<潟 \f2package\-list\fP <ゃ≪祉鴻с障<ゃ \f2extdocURL\fP ф絎贋違贋 (絽吾\f2packageListLoc\fP ф絎純若贋) 絖\f2\-linkoffline\fP 篏睡障c\f2extdocURL\fP WWW 筝с≪祉鴻с翫\f2\-linkoffline\fP 絎ャ<潟 javadoc 若 Web ・膓с違句障
161.9764 +.LP
161.9765 +ャ<潟贋違潟違篏睡純с宴若吾祉篏絲障 javadoc 絎茵紊眼筝宴若吾絲障 javadoc 絎茵障 贋違<ゃ吾<ゃ祉水ャс障箴хず障
161.9766 +.LP
161.9767 +\f2\-linkoffline\fP 激с潟綣違 2 ゅ障 綣違 \f2<a href>\fP 潟腟粋昭障絖絎綣違2 綣違 \f2package\-list\fP 罎膣√贋絎綣違с
161.9768 +.RS 3
161.9769 +.TP 2
161.9770 +o
161.9771 +\f4extdocURL\fP 潟絎javadoc c紊ャ<潟c腟九 URL 障後 URL с後障潟篏睡翫\f2\-d\fP 篏帥cc潟宴若吾若後障鴻絎綽荀障荅括完\f2\-link\fP 激с潟 \f2extdocURL\fP с
161.9772 +.TP 2
161.9773 +o
161.9774 +\f4packagelistLoc\fP 紊ャ<潟 \f2package\-list\fP <ゃャcc鴻障 URL 絎障URL (http: 障 file:)or file:)<ゃ鴻<с障障障腟九障鴻後障鴻<с絎с障後障鴻翫javadoc 絎茵潟c後障鴻絎障\f2package\-list\fP <ゃс
161.9775 +.RE
161.9776 +.LP
161.9777 +javadoc 1 絎茵с茲違 \f2\-linkoffline\fP 激с潟絎с障1.2.2 茲違激с潟絎с障с
161.9778 +.LP
161.9779 +\f3紊ャ<潟吾腟九障潟篏帥c箴\fP \- \f2http://java.sun.com/j2se/1.5.0/docs/api\fP \f2java.lang\fP\f2java.io\fP潟篁 Java 2 若宴若吾潟Web ≪祉鴻с 翫ゃ帥障翫吟
161.9780 +.na
161.9781 +\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
161.9782 +.fi
161.9783 +http://java.sun.com/j2se/1.5.0/docs/api/package\-list \f2package\-list\fP <ゃ若c篆絖障 2 綣 \f2packagelistLoc\fP 若潟若贋絎障箴с宴若吾鴻<ゃ潟c "\f2.\fP" 篆絖障罨<潟潟Java 2 若 API 吾潟\f2com.mypackage\fP 宴若吾ャ<潟障ャ<潟違鴻弱 \f2Object\fP 鴻吾潟障障\f2\-sourcepath\fP 篁綽荀激с潟茵腓冴障
161.9784 +.nf
161.9785 +\f3
161.9786 +.fl
161.9787 +% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
161.9788 +.fl
161.9789 +.fi
161.9790 +.LP
161.9791 +\f3紊ャ<潟吾後障潟篏睡箴\fP \- 絽吾\f2\-linkoffline\fP 後障鴻絎障 \f2\-link\fP усс\f2\-linkoffline\fP 篏睡\f2package\-list\fP 絽吾若<ゃ絎障 後障潟篏睡潟<ゃ絽吾若<ゃ絎障c\f2\-linkoffline\fP 2 ゃ綣違ャ鴻絎綽荀障2 ゃ綣違筝с翫\f2\-link\fP 篏睡с障\f2\-link\fP 後障潟箴с
161.9792 +.LP
161.9793 +\f4package\-list\fP\f3 <ゃт\fP \- \f2package\-list\fP <ゃ障絖ャ<潟潟宴若後c翫<ゃт\f2packagelistLoc\fP с鴻絎с障\f2com.apipackage\fP \f2com.spipackage\fP 宴若吾鴻絖冴箴с号宴若後c障違紊ャ<潟潟ャ<潟綽荀翫箴水с障\f2package\-list\fP <ゃ Javadoc 1.0 1.1 х宴若後 \f2package\-list\fP <ゃ篏号障罕2 ゃ篌腓障 \f2package\-list\fP <ゃ掩с鴻潟荐絎ャ<潟若鴻純с
161.9794 +.LP
161.9795 +\f3茲違ャ<潟吾潟\fP \- \f2\-linkoffline\fP уャ<潟 1 ゃゆ絎障 罨<箴с激с潟茵障
161.9796 +.LP
161.9797 +\f2% \fP\f4javadoc \-linkoffline\fP \f2extdocURL1\fP \f2packagelistLoc1\fP \f2\\\fP
161.9798 +.br
161.9799 +\f2\ \ \ \ \ \ \ \ \ \ \fP\f4\-linkoffline\fP \f2extdocURL2\fP \f2packagelistLoc2\fP \f2\\\fP
161.9800 +.br
161.9801 +\f2\ \ \ \ \ \ \ \ \ \ ...\fP
161.9802 +.LP
161.9803 +\f3ャ<潟贋\fP \- 菴違 \f2\-linkoffline\fP 激с潟蚊ゃ吾с紊ч宴若吾障с弱篏絲障 javadoc 絎茵絎篋翫罨<絎茵с絨紊眼純若鴻若鋇絲障 javadoc 絎茵翫箴水сャ<潟若激с潟潟<潟絲障紊眼絎h紊眼翫炊cс潟違с純若鴻潟若絎h菴遵ゃ障紊眼翫膣√宴若吾若膓帥<潟若鴻[篏睡] 若吾贋с潟紕障
161.9804 +.LP
161.9805 +障篁絎茵т戎違c (\f2update\fP) 篏障c \f2html\fP 障c膣箴с\f2html\fP c荀c腱糸 (cd) 障\f2\-linkoffline\fP 綣違潟c "." 絎2 綣違 \f2html\fP 吾後障鴻絎障 с\f2package\-list\fP 罎膣≪障 贋医丞с宴若吾宴若後絎
161.9806 +.nf
161.9807 +\f3
161.9808 +.fl
161.9809 + % \fP\f3javadoc \-d update \-linkoffline . html com.mypackage\fP
161.9810 +.fl
161.9811 +.fi
161.9812 +Javadoc 若腟篋緇\f2update/com/package\fP 鴻若吾潟若 (网荀膣√ゃ)\f2html/com/package\fP <ゃ筝吾障
161.9813 +.LP
161.9814 +.TP 3
161.9815 +\-linksource\
161.9816 +純若鴻<ゃ (茵垬) HTML 若吾с潟篏罔羣 HTML ャ<潟純若鴻<ゃ吾潟菴遵障潟純若鴻<ゃ絎h鴻ゃ潟帥с若鴻潟潟鴻帥<純c若絲障篏障潟潟鴻帥鴻絲障篏障
161.9817 +.LP
161.9818 +\f3激с潟\fP\f4\-public\fP\f3\fP\f4\-package\fP\f3\fP\f4\-protected\fP\f3\fP\f4\-private\fP\f3 激с潟≫鴻c若<純篏腟粋昭障純若鴻<ゃ鴻絎茖荅括完障\fP\f2\-private\fP 激с潟絎鴻ゃ潟帥с若鴻筝潟篁≪祉鴻с障
161.9819 +.LP
161.9820 +潟絎h茘ュ筝篏障違\f2Button\fP 鴻純若鴻潟若潟Button茯筝篏障
161.9821 +.nf
161.9822 +\f3
161.9823 +.fl
161.9824 + public class Button
161.9825 +.fl
161.9826 + extends Component
161.9827 +.fl
161.9828 + implements Accessible
161.9829 +.fl
161.9830 +\fP
161.9831 +.fi
161.9832 +Button 鴻 \f2getLabel()\fP <純純若鴻潟若吾潟getLabel茯筝篏障
161.9833 +.nf
161.9834 +\f3
161.9835 +.fl
161.9836 + public String getLabel()
161.9837 +.fl
161.9838 +\fP
161.9839 +.fi
161.9840 +.LP
161.9841 +.TP 3
161.9842 +\-group\ groupheading\ packagepattern:packagepattern:...
161.9843 +网荀若吾茲違宴若吾絎違若違若茵篏障違若ャ \f2\-group\fP 激с潟ф絎障違若潟潟茵ф絎綺с若吾茵腓冴障 違若с宴若吾≪<筝鴻障絎 \f2\-group\fP 激с潟\f2packagepattern\fP 綣鴻筝眼宴若吾荀冴 \f2groupheading\fP 1 ゃ茵障茵腓冴障
161.9844 +.RS 3
161.9845 +.TP 2
161.9846 +o
161.9847 +\f4groupheading\fP 篁紙鴻絎с腥榊純с障絎鴻違若茵荀冴障
161.9848 +.TP 2
161.9849 +o
161.9850 +\f4packagepattern\fP 篁紙宴若後障篁紙宴若後膓 1 ゃ≪鴻帥鴻 (\f2*\fP) 絎с障≪鴻帥鴻篁紙絖筝眼潟ゃ若сゃ若絎с≪鴻帥鴻с1 ゃ違若潟 (\f2:\fP) у阪c茲違帥若潟с障
161.9851 +.RE
161.9852 +.RS 3
161.9853 +
161.9854 +.LP
161.9855 +.LP
161.9856 +\f3羈: 帥若潟帥若潟鴻с≪鴻帥鴻篏帥翫\fP\f4"java.lang*:java.util"\fP\f3 帥若潟鴻綣膃у蚊綽荀障\fP
161.9857 +.LP
161.9858 +.RE
161.9859 +.LP
161.9860 +\f2\-group\fP 激с潟絎翫鴻宴若吾宴若吾荀冴 1 ゃ違若ャ障ャ<潟宴若吾筝絎違若違若ャ宴若吾翫宴若吾篁宴若吾荀冴ょ腴違若ャ障
161.9861 +.LP
161.9862 +違罨<激с潟絎ャ<潟 5 ゃ宴若吾潟≪宴若吾≦宍罘純宴若吾潟篁宴若吾障java.lang*с緇絎羈 java.lang.*ャjava.lang 宴若吾ゅ障
161.9863 +.nf
161.9864 +\f3
161.9865 +.fl
161.9866 + % \fP\f3javadoc \-group "Core Packages" "java.lang*:java.util"
161.9867 +.fl
161.9868 + \-group "Extension Packages" "javax.*"
161.9869 +.fl
161.9870 + java.lang java.lang.reflect java.util javax.servlet java.new\fP
161.9871 +.fl
161.9872 +.fi
161.9873 +腟罨<違若茵障
161.9874 +.RS 3
161.9875 +.RS 3
161.9876 +.TP 3
161.9877 +潟≪宴若
161.9878 +\f2java.lang\fP
161.9879 +\f2java.lang.reflect\fP
161.9880 +\f2java.util\fP
161.9881 +.TP 3
161.9882 +≦宍罘純宴若
161.9883 +\f2javax.servlet\fP
161.9884 +.TP 3
161.9885 +篁宴若
161.9886 +\f2java.new\fP
161.9887 +.RE
161.9888 +
161.9889 +.LP
161.9890 +.RE
161.9891 +.LP
161.9892 +.TP 3
161.9893 +\-nodeprecated
161.9894 +ィ絅 API ャ<潟障激с潟絎\-nodeprecatedlist 激с潟絎翫号ャ<潟祉篏сィ絅 API 障激с潟潟若荐菴違ィ絅潟若c羂c翫箴水с
161.9895 +.LP
161.9896 +.TP 3
161.9897 +\-nodeprecatedlist
161.9898 +ィ絅 API 鴻<ゃ (deprecated\-list.html)潟蚊若激с潟若若吾吾潟障ャ<潟祉сィ絅 API 障激с潟ィ絅 API 純若鴻潟若障蚊若激с潟若c荀翫箴水с
161.9899 +.LP
161.9900 +.TP 3
161.9901 +\-nosince
161.9902 +ャ<潟@since 帥違絲上絨ャ若吾с潟 祉激с潟ャ障
161.9903 +.LP
161.9904 +.TP 3
161.9905 +\-notree
161.9906 +ャ<潟鴻潟ゃ潟帥с若鴻絮ゃ若吾ャ障若吾蚊若激с潟若若帥潟≪祉鴻с障с絮ゃ障
161.9907 +.LP
161.9908 +.TP 3
161.9909 +\-noindex
161.9910 +ャ<潟膣√ャ障с膣√障
161.9911 +.LP
161.9912 +.TP 3
161.9913 +\-nohelp
161.9914 +阪若吾筝筝蚊若激с潟若 [] 潟ャ障
161.9915 +.LP
161.9916 +.TP 3
161.9917 +\-nonavbar
161.9918 +若吾筝筝茵腓冴蚊若激с潟若若潟帥若障激с潟bottom 激с潟綵演帥筝障\f2\-nonavbar\fP 激с潟医激<ゃ PostScript 障 PDF 紊翫絎鴻荀с蚊若激с潟綽荀翫箴水с
161.9919 +.LP
161.9920 +.TP 3
161.9921 +\-helpfile\ path/filename
161.9922 +筝筝蚊若激с潟若 [] 潟潟篁f帥<ゃ \f2path/filename\fP 鴻絎障激с潟絎翫Javadoc 若若潟若<ゃ \f2help\-doc.html\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP <ゃс絎с\f2help\-doc.html\fP 絎障箴腓冴障
161.9923 +.nf
161.9924 +\f3
161.9925 +.fl
161.9926 + % \fP\f3javadoc \-helpfile /home/user/myhelp.html java.awt\fP
161.9927 +.fl
161.9928 +.fi
161.9929 +.TP 3
161.9930 +\-stylesheetfile\ path/filename
161.9931 +篁f HTML 鴻帥ゃ激若<ゃ鴻絎障激с潟絎翫Javadoc 若若潟若鴻帥ゃ激若<ゃ \f2stylesheet.css\fP 篏障激с潟篏帥篏若若ゃс障\f2filename\fP <ゃс絎с\f2stylesheet.css\fP 絎障箴腓冴障
161.9932 +.nf
161.9933 +\f3
161.9934 +.fl
161.9935 + % \fP\f3javadoc \-stylesheetfile /home/user/mystylesheet.css com.mypackage\fP
161.9936 +.fl
161.9937 +.fi
161.9938 +.TP 3
161.9939 +\-serialwarn
161.9940 +@serial 帥違翫潟潟ゃ茘障сJavadoc 1.2.2 篁ラ若吾с潟с翫茘障1.2.2 若吾с潟с茘障激с潟篏睡翫茘茵腓冴с翫純c若 \f2writeExternal\fP <純ャ<潟綵合<障
161.9941 +.LP
161.9942 +.TP 3
161.9943 +\-charset\ name
161.9944 +ャ<潟 HTML 絖祉絎障
161.9945 +.na
161.9946 +\f2IANA Registry\fP @
161.9947 +.fi
161.9948 +http://www.iana.org/assignments/character\-sets тィ絅 MIME с違障箴腓冴障
161.9949 +.nf
161.9950 +\f3
161.9951 +.fl
161.9952 + % \fP\f3javadoc \-charset "iso\-8859\-1" mypackage\fP
161.9953 +.fl
161.9954 +.fi
161.9955 +鴻若吾罨<茵水ャ障
161.9956 +.nf
161.9957 +\f3
161.9958 +.fl
161.9959 + <META http\-equiv="Content\-Type" content="text/html; charset=ISO\-8859\-1">
161.9960 +.fl
161.9961 +\fP
161.9962 +.fi
161.9963 + META 帥違ゃ
161.9964 +.na
161.9965 +\f2HTML 罔羣\fP @
161.9966 +.fi
161.9967 +http://www.w3.org/TR/REC\-html40/charset.html#h\-5.2.2 (4197265 4137321) с
161.9968 +.LP
161.9969 +\-encoding \-docencoding с
161.9970 +.LP
161.9971 +.TP 3
161.9972 +\-docencoding\ name
161.9973 + HTML <ゃ潟潟若c潟違絎障
161.9974 +.na
161.9975 +\f2IANA Registry\fP @
161.9976 +.fi
161.9977 +http://www.iana.org/assignments/character\-sets тィ絅 MIME с違障激с潟ャ \-encoding 篏睡翫 HTML <ゃ潟潟若\-encoding c羆冴障箴:
161.9978 +.nf
161.9979 +\f3
161.9980 +.fl
161.9981 + % \fP\f3javadoc \-docencoding "ISO\-8859\-1" mypackage\fP
161.9982 +.fl
161.9983 +.fi
161.9984 +\-encoding \-charset с
161.9985 +.LP
161.9986 +.TP 3
161.9987 +\-keywords
161.9988 +HTML <帥若若帥違鴻<ゃ菴遵障帥違<帥帥違罎膣≪泣若潟吾潟若吾荀ゃ翫綵合<障ゃ潟帥若篏罎膣≪紊泣若潟吾潟若吾<帥帥違茯ょ<帥帥違茯帥鴻障 筝鴻罎膣≪荳 Web 泣ゃ絎篌罐с泣若潟吾潟<帥帥違茯帥鴻c<緇障
161.9989 +.LP
161.9990 +<帥帥違鴻絎篆蕋上c若潟<純篆蕋障障障潟潟鴻帥劫с障障違 String 罨<若若ч紮障
161.9991 +.nf
161.9992 +\f3
161.9993 +.fl
161.9994 + <META NAME="keywords" CONTENT="java.lang.String class">
161.9995 +.fl
161.9996 + <META NAME="keywords" CONTENT="CASE_INSENSITIVE_ORDER">
161.9997 +.fl
161.9998 + <META NAME="keywords" CONTENT="length()">
161.9999 +.fl
161.10000 + <META NAME="keywords" CONTENT="charAt()">
161.10001 +.fl
161.10002 +\fP
161.10003 +.fi
161.10004 +.LP
161.10005 +.TP 3
161.10006 +\-tag\ \ tagname:Xaoptcmf:"taghead"
161.10007 +Javadoc 若ャ<潟若激с潟潟<潟綣違 1 ゅ膣鴻帥帥 \f2@\fP\f2tagname\fP 茹iс障Javadoc 若帥医鴻с茵сс純若鴻潟若鴻鴻帥帥違 \f2\-tag\fP 激с潟腟粋昭с障篁絎茵у阪帥違\f2X\fP 篁≦鴻障
161.10008 +.LP
161.10009 +潟 (\f4:\fP) 絽吾阪絖障\f2tagname\fP с潟潟篏睡帥医с潟潟篏睡с
161.10010 +.LP
161.10011 +\f2\-tag\fP 激с潟帥違荀冴taghead紊絖у阪障 罨<茵激с潟綣違ф絎鴻膓障 篁ヤ箴с帥違罕綣違鴻ゃ潟ゃ潟帥違с障 ゃ潟ゃ潟帥違茹i障阪綣違 1 ゅ罔羣帥 (\f2@return\fP\f2@author\fP ) 阪鋍若障\f2taghead\fP ャ\f2tagname\fP 荀冴茵腓冴障
161.10012 +.LP
161.10013 +\f3帥違臀\fP \- 綣違 \f4Xaoptcmf\fP 純若鴻潟若帥違臀с篏臀\f2X\fP 篏帥c帥違≦鴻с劫障帥違臀篏臀狗翫 \f4a\fP 絎障 篁ュ絖腟水純с \f4X\fP (帥違≦劫)
161.10014 +.br
161.10015 +\f4a\fP (鴻篏臀)
161.10016 +.br
161.10017 +\f4o\fP (网荀)
161.10018 +.br
161.10019 +\f4p\fP (宴若)
161.10020 +.br
161.10021 +\f4t\fP (<鴻潟ゃ潟帥с若)
161.10022 +.br
161.10023 +\f4c\fP (潟潟鴻)
161.10024 +.br
161.10025 +\f4m\fP (<純)
161.10026 +.br
161.10027 +\f4f\fP (c若)
161.10028 +.LP
161.10029 +\f3激潟違帥違箴\fP \- 純若鴻潟若篁紙篏臀т戎ф帥違帥違激с潟箴腓冴障
161.10030 +.nf
161.10031 +\f3
161.10032 +.fl
161.10033 + \-tag todo:a:"To Do:"
161.10034 +.fl
161.10035 +\fP
161.10036 +.fi
161.10037 +@todo 潟潟鴻帥<純c若帥т戎翫篁ヤ激с潟篏睡障
161.10038 +.nf
161.10039 +\f3
161.10040 +.fl
161.10041 + \-tag todo:cmf:"To Do:"
161.10042 +.fl
161.10043 +\fP
161.10044 +.fi
161.10045 +筝箴緇潟 (\f2:\fP) <若水阪絖с荀冴鴻筝c障 (篁ヤ箴)罨<箴\f2@todo\fP 帥違純若鴻潟若с帥違激с潟篏睡障
161.10046 +.nf
161.10047 +\f3
161.10048 +.fl
161.10049 + @todo The documentation for this method needs work.
161.10050 +.fl
161.10051 +\fP
161.10052 +.fi
161.10053 +\f3帥医潟潟篏睡\fP \- 潟 (:) 鴻激ャс鴻宴若潟潟帥医篏睡с障ャ<潟若激с潟潟<潟筝с罨<篏睡障
161.10054 +.nf
161.10055 +\f3
161.10056 +.fl
161.10057 + /**
161.10058 +.fl
161.10059 + * @ejb:bean
161.10060 +.fl
161.10061 + */
161.10062 +.fl
161.10063 +\fP
161.10064 +.fi
161.10065 +с帥違激с潟篏睡
161.10066 +.nf
161.10067 +\f3
161.10068 +.fl
161.10069 + \-tag ejb\\\\:bean:a:"EJB Bean:"
161.10070 +.fl
161.10071 +\fP
161.10072 +.fi
161.10073 +\f3帥医鴻с (帥違≦劫)\fP \- 純若鴻潟若臀筝鴻帥帥違阪吟翫障翫純若鴻潟若鴻帥違臀阪吟帥違鴻阪吟帥違≦鴻障帥違≦鴻\f2X\fP 絎障絎帥違鴻障 Javadoc 若罎冴帥違ュ鴻ャ帥違с劫с障ャ帥違罎冴翫Javadoc 若茘阪障
161.10074 +.LP
161.10075 +с臀ゃ \f2X\fP 菴遵с障 違\f2X\fP ゃс帥違鴻с障違@todo 帥違阪吟翫罨<絎障
161.10076 +.nf
161.10077 +\f3
161.10078 +.fl
161.10079 + \-tag todo:Xcmf:"To Do:"
161.10080 +.fl
161.10081 +\fP
161.10082 +.fi
161.10083 +膣絎号障
161.10084 +.nf
161.10085 +\f3
161.10086 +.fl
161.10087 + \-tag todo:X
161.10088 +.fl
161.10089 +\fP
161.10090 +.fi
161.10091 +.LP
161.10092 +罕 \f2\-tag todo:X\fP \f2@todo\fP taglet у臂翫鴻с
161.10093 +.LP
161.10094 +\f3帥違綺\fP \- \f2\-tag\fP ( \f2\-taglet\fP) 激с潟綺c阪綺羆阪障鴻帥帥違罔羣帥違腟水篏睡с障罔羣帥違帥違激с潟綺羆阪若鴻с罔羣帥医帥篏睡障(罔羣帥違絨頳冴紊眼с障)ゃ篁ヤ箴ц障
161.10095 +.LP
161.10096 +\f2\-tag\fP 翫\f2\-taglet\fP 篏臀c綺羆阪障帥違筝≧鴻絖翫潟潟茵緇祉綺羆阪障帥違帥違潟潟茵絎с違\f2\-taglet\fP \f2\-tag\fP 筝≧鴻 todo c翫潟潟茵緇祉綺羆阪障
161.10097 +.LP
161.10098 +\f3帥違絎祉箴\fP \- 箴с阪ParametersThrowsTo Do水ャ障X 篏睡@example 純若鴻潟若篁絎茵с阪帥違с絎障@argfile 篏睡翫罨<綣違<ゃャ茵帥違臀с障 茵膓膓腓冴絖筝荀с
161.10099 +.nf
161.10100 +\f3
161.10101 +.fl
161.10102 + \-tag param
161.10103 +.fl
161.10104 + \-tag return
161.10105 +.fl
161.10106 + \-tag todo:a:"To Do:"
161.10107 +.fl
161.10108 + \-tag throws
161.10109 +.fl
161.10110 + \-tag see
161.10111 +.fl
161.10112 + \-tag example:X
161.10113 +.fl
161.10114 +\fP
161.10115 +.fi
161.10116 +.LP
161.10117 +javadoc ャ<潟若激с潟潟<潟茹f罎冴帥違<罔羣帥違с \f2\-tag\fP \f2\-taglet\fP ф検帥違сャ帥違荀障 翫茘鴻若障
161.10118 +.LP
161.10119 +罔羣帥違綺с鴻主障\f2\-tag\fP 激с潟篏睡鴻菴遵帥違≧羣帥違篏臀篏臀腱糸障ゃ障罔羣帥違 \f2\-tag\fP 激с潟篁違篏臀臀障障障
161.10120 +.LP
161.10121 +\f3腴九\fP \- 堺腥咲蚊宴若吾篏睡 \f2com.mycompany.todo\fP (.) 阪遵荀篏睡障Sun 篁緇障罔羣帥違篏障若吟若篏帥違Sun 箴帥違篏若若ゃ障ゃ障若吟若 \f2@todo\fP 帥違障帥違篏翫Sun 罔羣帥違篏帥違障帥違篏篆障
161.10122 +.LP
161.10123 +\f3羈 vs. Javadoc 帥\fP \- 筝菴遵綽荀若≪ャ<潟若激с潟綵演帥筝ャ<潟若激с潟с翫若≪ javadoc 帥違鴻с 篁ュ翫羈鴻с
161.10124 +.na
161.10125 +\f2Comparing Annotations and Javadoc Tags\fP @
161.10126 +.fi
161.10127 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#annotationsс
161.10128 +.LP
161.10129 +\-taglet 激с潟篏睡茲帥違鴻帥ゃ潟ゃ潟帥違 篏с障
161.10130 +.LP
161.10131 +.TP 3
161.10132 +\-taglet\ \ class
161.10133 +帥違ャ<潟篏帥莎桁鴻<ゃ絎障鴻絎絎絎帥違鴻帥帥違鴻綣違違絎臂障帥違綣違篁阪障紊ャ<潟泣潟帥違ゃ篁ヤс
161.10134 +.RS 3
161.10135 +.TP 2
161.10136 +o
161.10137 +.na
161.10138 +\f2帥違网荀\fP @
161.10139 +.fi
161.10140 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
161.10141 +.RE
161.10142 +.LP
161.10143 +帥違罔羣帥違障ゃ潟ゃ潟帥違т梢с帥違篁紙違綣違с障 障鴻紊絖膊≧吾篏鴻<ゃ吾冴篁祉鴻紮鴻帥篏絎茖с障
161.10144 +.LP
161.10145 +帥違ф絎с帥違臀贋臀綵√帥с篁鴻羆阪c茵障帥違篏睡鴻鴻劫ゃ絎茵с障帥違鴻<ゃ阪ャ祉鴻若篏緇障
161.10146 +.LP
161.10147 +帥違鴻絎\f2\-tagletpath\fP 激с潟篏睡障篁ヤ若吾ParameterThrowsTo Do帥違水ャ箴с
161.10148 +.nf
161.10149 +\f3
161.10150 +.fl
161.10151 + \-taglet com.sun.tools.doclets.ToDoTaglet
161.10152 +.fl
161.10153 + \-tagletpath /home/taglets
161.10154 +.fl
161.10155 + \-tag return
161.10156 +.fl
161.10157 + \-tag param
161.10158 +.fl
161.10159 + \-tag todo
161.10160 +.fl
161.10161 + \-tag throws
161.10162 +.fl
161.10163 + \-tag see
161.10164 +.fl
161.10165 +\fP
161.10166 +.fi
161.10167 +.LP
161.10168 +\f2\-tag\fP 激с潟篁c \f2\-taglet\fP 激с潟篏睡с障茯帥\f2\-tag\fP 激с潟篏睡祉с
161.10169 +.LP
161.10170 +.TP 3
161.10171 +\-tagletpath\ \ tagletpathlist
161.10172 +taglet 鴻<ゃ (.class) 罎膣≪鴻絎障\f2tagletpathlist\fP 潟 (\f2:\fP) у阪c茲違鴻с障Javadoc 若絎鴻篁ヤ鴻泣c罎膣≪障
161.10173 +.LP
161.10174 +.TP 3
161.10175 +\-docfilessubdirs\
161.10176 +\f2doc\-files\fP c羞宴潟若鴻障ゃ障潟弱泣c鴻潟潟潟潟若障違\f2doc\-files/example/images\fP c筝<ゃ潟若障с泣cゅ絎純с
161.10177 +.LP
161.10178 +.TP 3
161.10179 +\-excludedocfilessubdir\ \ name1:name2...
161.10180 +絎 \f2doc\-files\fP 泣cゅ障SCCS 篁純若鴻潟若九勝泣c潟若蚊障
161.10181 +.LP
161.10182 +.TP 3
161.10183 +\-noqualifier\ \ all\ | \ packagename1:packagename2:...
161.10184 +阪劫宴若後 (宴若娯信蕋上) ャ障\f2\-noqualifier\fP 綣違 \f2all\fP 絎翫鴻宴若娯信蕋上鴻ャ障 ゃ茲違宴若後潟潟у阪cゃ若絎с障鴻障ゃ潟帥с若劫茵腓冴篏臀宴若後ゃ障
161.10185 +.LP
161.10186 +罨<箴с鴻宴若娯信蕋上ャ障
161.10187 +.nf
161.10188 +\f3
161.10189 +.fl
161.10190 + \-noqualifier all
161.10191 +.fl
161.10192 +\fP
161.10193 +.fi
161.10194 +罨<箴с宴若娯信蕋上 java.lang java.io ャ障
161.10195 +.nf
161.10196 +\f3
161.10197 +.fl
161.10198 + \-noqualifier java.lang:java.io
161.10199 +.fl
161.10200 +\fP
161.10201 +.fi
161.10202 +罨<箴сjava у障宴若娯信蕋上 com.sun 泣宴若 (javax с) ャ障
161.10203 +.nf
161.10204 +\f3
161.10205 +.fl
161.10206 + \-noqualifier java.*:com.sun.*
161.10207 +.fl
161.10208 +\fP
161.10209 +.fi
161.10210 +宴若娯信蕋上筝荐篏緇c茵腓冴翫障 荅括完茵腓堺号с荀\f2\-noqualifier\fP 篏睡鴻с
161.10211 +.LP
161.10212 +.TP 3
161.10213 +\-notimestamp\
161.10214 +帥ゃ鴻帥潟吟障 若後菴 HTML HTML 潟<潟с帥ゃ鴻帥潟障Javadoc 2 ゃ純若鴻若鴻у茵絲障 diff 絎茵激с潟篏睡帥ゃ鴻帥潟c diff 榊т梢с (激с潟篏睡若吾 diff 障)帥ゃ鴻帥潟 Javadoc 若吾с括垩障罨<障
161.10215 +.nf
161.10216 +\f3
161.10217 +.fl
161.10218 + <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
161.10219 +.fl
161.10220 +\fP
161.10221 +.fi
161.10222 +.LP
161.10223 +.TP 3
161.10224 +\-nocomment\
161.10225 +筝肢潟鴻帥違潟<潟篏吟絎h障激с潟違c純若鴻<ゃ違吾с罧級с鴻宴 HTML ャ<潟篏с障
161.10226 +.RE
161.10227 +.SH "潟潟茵綣違<ゃ"
161.10228 +.LP
161.10229 +.LP
161.10230 +\f2javadoc\fP 潟潟茵膂≧\f2javadoc\fP 潟潟絲障綣 (\f2\-J\fP 激с潟ゃ) ャc 1 や札筝<ゃ絎с障違若c潟違激鴻筝с篁紙激 javadoc 潟潟篏с障
161.10231 +.LP
161.10232 +.LP
161.10233 +綣違<ゃjavac 激с潟純若鴻<ゃ宴腟水荐菴違с障<ゃ綣違鴻若鴻障壕у阪障<ゃ腥榊純障翫<ゃ篏篋綣膃у蚊帥障
161.10234 +.LP
161.10235 +.LP
161.10236 +綣違<ゃ<ゃ憜c荀後障鴻障綣違<ゃ篏臀荀後障鴻с障綣違<ゃ<ゃ鴻сゃ若 (*) 篏睡с障違\f2*.java\fP 絎с障綣違<ゃ綣違 \f2@\fP 絖篏睡茲違<ゃ絽亥茹i泣若障障\f2\-J\fP 激с潟泣若障 激с潟莎桁若羝<障莎桁若с綣違<ゃ泣若с
161.10237 +.LP
161.10238 +.LP
161.10239 +javadoc 絎茵綣違<ゃ鴻<ゃ \f2@\fP 絖篁羝<障javadoc \f2@\fP 絖у障綣違荀ゃ<ゃ絎鴻絮綣違鴻水ャ障
161.10240 +.LP
161.10241 +.SS
161.10242 +綣違<ゃ 1 ゆ絎箴
161.10243 +.LP
161.10244 +.LP
161.10245 +\f2argfile\fP 綣違<ゃ鴻 Javadoc 綣違主罨<篏睡с障
161.10246 +.LP
161.10247 +.nf
161.10248 +\f3
161.10249 +.fl
161.10250 + % \fP\f3javadoc @argfile\fP
161.10251 +.fl
161.10252 +.fi
161.10253 +
161.10254 +.LP
161.10255 +.LP
161.10256 +綣違<ゃ罨<箴хず 2 ゃ<ゃ絎鴻筝≧鴻ャс障
161.10257 +.LP
161.10258 +.SS
161.10259 +綣違<ゃ 2 ゆ絎箴
161.10260 +.LP
161.10261 +.LP
161.10262 +Javadoc 激с括 1 ゃ純若鴻<ゃ 1 ゃ2 ゃ綣違<ゃ篏罨<篏睡с障鴻с茵膓膓絖篏睡障
161.10263 +.LP
161.10264 +.LP
161.10265 +篁ヤ絎鴻 \f2options\fP <ゃ篏障
161.10266 +.LP
161.10267 +.nf
161.10268 +\f3
161.10269 +.fl
161.10270 + \-d docs\-filelist
161.10271 +.fl
161.10272 + \-use
161.10273 +.fl
161.10274 + \-splitindex
161.10275 +.fl
161.10276 + \-windowtitle 'Java 2 Platform v1.3 API Specification'
161.10277 +.fl
161.10278 + \-doctitle 'Java(TM) 2 Platform 5.0 API Specification'
161.10279 +.fl
161.10280 + \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
161.10281 +.fl
161.10282 + \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
161.10283 +.fl
161.10284 + \-group "Core Packages" "java.*"
161.10285 +.fl
161.10286 + \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
161.10287 +.fl
161.10288 + \-sourcepath /java/pubs/ws/1.5/src/share/classes
161.10289 +.fl
161.10290 +\fP
161.10291 +.fi
161.10292 +
161.10293 +.LP
161.10294 +.LP
161.10295 +篁ヤ絎鴻 \f2packages\fP <ゃ篏障
161.10296 +.LP
161.10297 +.nf
161.10298 +\f3
161.10299 +.fl
161.10300 + com.mypackage1
161.10301 +.fl
161.10302 + com.mypackage2
161.10303 +.fl
161.10304 + com.mypackage3
161.10305 +.fl
161.10306 +\fP
161.10307 +.fi
161.10308 +
161.10309 +.LP
161.10310 +.LP
161.10311 +罨<潟潟篏睡 javadoc 絎茵障
161.10312 +.LP
161.10313 +.nf
161.10314 +\f3
161.10315 +.fl
161.10316 + % \fP\f3javadoc @options @packages\fP
161.10317 +.fl
161.10318 +.fi
161.10319 +
161.10320 +.LP
161.10321 +.SS
161.10322 +剛綣違<ゃ箴
161.10323 +.LP
161.10324 +.LP
161.10325 +綣違<ゃ鴻絎с障 <ゃ絎<ゃ憜篏罐c荀後障鴻障 ゃ障筝箴翫\f2path1\fP \f2path2\fP 荀後障鴻с障
161.10326 +.LP
161.10327 +.nf
161.10328 +\f3
161.10329 +.fl
161.10330 + % \fP\f3javadoc @path1/options @path2/packages\fP
161.10331 +.fl
161.10332 +.fi
161.10333 +
161.10334 +.LP
161.10335 +.SS
161.10336 +激с潟綣違箴
161.10337 +.LP
161.10338 +.LP
161.10339 +罨<Javadoc 激с潟絲障綣違綣違<ゃ主箴腓冴障с\f2\-bottom\fP 箴筝障 激с潟激綣違絎с障激с潟鴻綣違罨<絎鴻\f2bottom\fP <ゃ篏障
161.10340 +.LP
161.10341 +.nf
161.10342 +\f3
161.10343 +.fl
161.10344 +'<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit a
161.10345 +.fl
161.10346 +bug or feature</a><br><br>Java is a trademark or registered trademark of
161.10347 +.fl
161.10348 +Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-2000 Sun
161.10349 +.fl
161.10350 +Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
161.10351 +.fl
161.10352 +All Rights Reserved.</font>'
161.10353 +.fl
161.10354 +\fP
161.10355 +.fi
161.10356 +
161.10357 +.LP
161.10358 +.LP
161.10359 +罨< Javadoc 若絎茵障
161.10360 +.LP
161.10361 +.nf
161.10362 +\f3
161.10363 +.fl
161.10364 + % \fP\f3javadoc \-bottom @bottom @packages\fP
161.10365 +.fl
161.10366 +.fi
161.10367 +
161.10368 +.LP
161.10369 +.LP
161.10370 +障綣違<ゃ \f2\-bottom\fP 激с潟腟粋昭с違罨<絎茵с障
161.10371 +.LP
161.10372 +.nf
161.10373 +\f3
161.10374 +.fl
161.10375 + % \fP\f3javadoc @bottom @packages\fP
161.10376 +.fl
161.10377 +.fi
161.10378 +.SH ""
161.10379 +絎茵
161.10380 +.SH "Javadoc 絎茵"
161.10381 +.LP
161.10382 +.LP
161.10383 +\f3若吾с括\fP \- javadoc 若吾с括垩ゅャ\f3javadoc \-J\-version\fP 篏睡障阪鴻若罔羣若吾с括垩障障\f2\-quiet\fP х≦鴻с障
161.10384 +.LP
161.10385 +.LP
161.10386 +\f3違ゃ潟帥с若\fP \- Java 荐茯ц菴違違 Javadoc 若莎桁篏睡障ゃ潟帥с若鴻 \f2com.sun.tools.javadoc.Main\fP 障 (javadoc ュ)荅括完
161.10387 +.na
161.10388 +\f2罔羣\fP @
161.10389 +.fi
161.10390 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammaticallyс
161.10391 +.LP
161.10392 +.LP
161.10393 +\f3絎茵\fP \- 筝荐茯罔羣 HTML 若喝冴с鴻帥若喝冴\-doclet \-docletpath 激с潟篏睡障劫絎茵絎箴ゃ
161.10394 +.na
161.10395 +\f2MIF Doclet ャ<潟\fP @
161.10396 +.fi
161.10397 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.htmlс
161.10398 +.LP
161.10399 +.SH "膂≦箴"
161.10400 +.LP
161.10401 +.LP
161.10402 +javadoc 宴若後篏絲障絎茵純若鴻<ゃ絲障絎茵с障宴若後宴若後絲上c<障罨<箴с純若鴻<ゃ \f2/home/src/java/awt/*.java\fP 障c \f2/home/html\fP с
161.10403 +.LP
161.10404 +.SS
161.10405 +1 や札筝宴若吾ャ<潟
161.10406 +.LP
161.10407 +.LP
161.10408 +宴若吾ャ<潟宴若吾純若鴻<ゃ (\f2*.java\fP) 宴若吾ゃc絖違障宴若後茲違茘ュф (\f2java.awt.color\fP 茘ュу阪) 翫緇膓茘ュ筝篏泣c絲上違障 (\f2java/awt/color\fP )1 ゃ宴若吾茲違純若鴻<ゃ違贋 2 ゃc若主純с (\f2src1/java/awt/color\fP \f2src2/java/awt/color\fP ) 翫\f2\-sourcepath\fP c筝≧鴻贋絎違障
161.10409 +.LP
161.10410 +.LP
161.10411 +javadoc 絎茵\f2cd\fP 潟潟篏帥cc紊眼障 \f2\-sourcepath\fP 激с潟篏睡障篁ヤ箴с筝≧鴻号ゃ茯障
161.10412 +.LP
161.10413 +.RS 3
161.10414 +.TP 2
161.10415 +o
161.10416 +\f3宴若 1 \- 1 や札筝宴若吾莎桁絽亥絎茵\fP \- 箴с javadoc 篁紙c絎茵с\-sourcepath 篏睡絽亥 \-subpackages (1.4 違激с) 篏睡障\f2java\fP 泣宴若 (\f2java.net\fP \f2java.lang\fP 若宴若吾ゃ) 障\f2java.lang\fP 泣宴若吾с \f2java.lang.ref\fP ゅ障
161.10417 +.nf
161.10418 +\f3
161.10419 +.fl
161.10420 + % \fP\f3javadoc \fP\f3\-d\fP\f3 /home/html \fP\f3\-sourcepath\fP\f3 /home/src \fP\f3\-subpackages\fP\f3 java \fP\f3\-exclude\fP\f3 java.net:java.lang\fP
161.10421 +.fl
161.10422 +.fi
161.10423 +.LP
161.10424 +篁宴若吾若綏≦\f2java:javax:org.xml.sax\fP \f2\-subpackages\fP 綣違菴遵障
161.10425 +.TP 2
161.10426 +o
161.10427 +\f3宴若 2 \- 若純若鴻c腱祉c腓榊宴若吾絲障絎茵\fP \- 絎絎宴若後荀c腱祉障罨<ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障
161.10428 +.nf
161.10429 +\f3
161.10430 +.fl
161.10431 + % \fP\f3cd /home/src/\fP
161.10432 +.fl
161.10433 + % \f3javadoc \-d /home/html java.awt java.awt.event\fP
161.10434 +.fl
161.10435 +.fi
161.10436 +.TP 2
161.10437 +o
161.10438 +\f3宴若 3 \- 篁紙c絎茵 純若鴻<ゃ 1 ゃc弱\fP \- 宴若鴻с憜cсc障障筝篏宴若吾荀c \f2\-sourcepath\fP 絎ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障
161.10439 +.nf
161.10440 +\f3
161.10441 +.fl
161.10442 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt java.awt.event\fP
161.10443 +.fl
161.10444 +.fi
161.10445 +.TP 2
161.10446 +o
161.10447 +\f3宴若 4 \- 篁紙c絎茵 純若鴻<ゃ茲違c弱\fP \- 宴若 3 篌若障宴若吾茲違c若絖障若若吾鴻 \f2\-sourcepath\fP 絎 (潟潟у阪)ャ<潟 1 や札筝宴若後絎 javadoc 絎茵障1 ゃ宴若吾鴻純若鴻<ゃ1 ゃ若c筝絖違障 純若鴻鴻絎贋цゃ医с
161.10448 +.nf
161.10449 +\f3
161.10450 +.fl
161.10451 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src1:/home/src2 java.awt java.awt.event\fP
161.10452 +.fl
161.10453 +.fi
161.10454 +.RE
161.10455 +
161.10456 +.LP
161.10457 +.LP
161.10458 +腟: 筝荐宴若鴻с\f2java.awt\fP \f2java.awt.event\fP 宴若後 public protected 鴻ゃ潟帥с若鴻ゃHTML 綵√ャ<潟絎c (\f2/home/html\fP) HTML <ゃ篆絖障2 や札筝宴若吾сャ<潟宴若吾鴻鴻鴻潟<ゃ潟鴻若吾 3 ゃ若ゃ障
161.10459 +.LP
161.10460 +.SS
161.10461 +1 や札筝鴻ャ<潟
161.10462 +.LP
161.10463 +.LP
161.10464 +障1 や札筝純若鴻<ゃ (\f2.java\fP) 羝<Javadoc 若絎茵с障javadoc 罨< 2 ゃ<号у茵с障 1 ゃ\f2cd\fP 潟潟сc紊眼号 1 ゃ \f2.java\fP <ゃ吾鴻絎絎号с後障鴻憜c莎欠鴻障純若鴻<ゃ羝<\f2\-sourcepath\fP 激с潟∴障≪鴻帥鴻 (*) 潟潟茵ゃ若篏睡鴻違若絎с障
161.10465 +.LP
161.10466 +.RS 3
161.10467 +.TP 2
161.10468 +o
161.10469 +\f3宴若 1 \- 純若鴻c腱祉\fP \- \f2.java\fP <ゃc腱祉障罨<ャ<潟 1 や札筝純若鴻<ゃ絎 javadoc 絎茵障
161.10470 +.nf
161.10471 +\f3
161.10472 +.fl
161.10473 + % \fP\f3cd /home/src/java/awt\fP
161.10474 +.fl
161.10475 + % \f3javadoc \-d /home/html Button.java Canvas.java Graphics*.java\fP
161.10476 +.fl
161.10477 +.fi
161.10478 +箴с \f2Button\fP \f2Canvas\fP喝 \f2Graphics\fP у障鴻ゃHTML 綵√ャ<潟障宴若後с純若鴻<ゃ javadoc 綣違羝<сャ<潟鴻鴻<ゃ潟若吾 2 ゃ若ゃ障
161.10479 +.TP 2
161.10480 +o
161.10481 +\f3宴若 2 \- 宴若吾若c腱祉\fP \- 若茲違泣宴若吾純若鴻<ゃャ<潟翫箴水с宴若吾若c腱祉純若鴻<ゃ若鴻絎障
161.10482 +.nf
161.10483 +\f3
161.10484 +.fl
161.10485 + % \fP\f3cd /home/src/\fP
161.10486 +.fl
161.10487 + % \f3javadoc \-d /home/html java/awt/Button.java java/applet/Applet.java\fP
161.10488 +.fl
161.10489 +.fi
161.10490 +箴с\f2Button\fP 鴻 \f2Applet\fP 鴻ゃHTML 綵√ャ<潟障
161.10491 +.TP 2
161.10492 +o
161.10493 +\f3宴若 3 \- 篁紙c\fP \- 宴若鴻с憜cсc障障ャ<潟 \f2.java\fP <ゃ吾腟九障 (障憜c後障) 絎 javadoc 絎茵障
161.10494 +.nf
161.10495 +\f3
161.10496 +.fl
161.10497 + % \fP\f3javadoc \-d /home/html /home/src/java/awt/Button.java /home/src/java/awt/Graphics*.java\fP
161.10498 +.fl
161.10499 +.fi
161.10500 +箴с \f2Button\fP \f2Graphics\fP у障鴻ゃHTML 綵√ャ<潟障
161.10501 +.RE
161.10502 +
161.10503 +.LP
161.10504 +.SS
161.10505 +宴若吾鴻ャ<潟
161.10506 +.LP
161.10507 +.LP
161.10508 +宴若後篏鴻絎ャ<潟с障罨<菴違 2 ゃ箴腟水箴腓冴障\f2\-sourcepath\fP 宴若吾吾鴻絲障篏睡с障鴻鴻絲障篏睡с障
161.10509 +.LP
161.10510 +.nf
161.10511 +\f3
161.10512 +.fl
161.10513 + % \fP\f3javadoc \-d /home/html \-sourcepath /home/src java.awt /home/src/java/applet/Applet.java\fP
161.10514 +.fl
161.10515 +.fi
161.10516 +
161.10517 +.LP
161.10518 +.LP
161.10519 +箴с宴若 \f2java.awt\fP \f2Applet\fP ゃHTML 綵√ャ<潟障Javadoc 若\f2Applet\fP 宴若後\f2Applet.java\fP 純若鴻<ゃ宴若後h (絎h翫) ゅャ障
161.10520 +.LP
161.10521 +.SH "篏睡箴"
161.10522 +.LP
161.10523 +.LP
161.10524 +Javadoc 若紊箴水激с潟筝祉激с潟紫篏帥障х換篁Java 若 API 絲障 Javadoc 若絎茵篏睡絎潟潟сJava 2 Platform, Standard Edition, v1.2 絖膣 1500 public protected 鴻ゃャ<潟180M ゃ<≪若篏睡障
161.10525 +.LP
161.10526 +.LP
161.10527 +箴 2 イ莠障 箴潟潟茵絎茵с2 箴 Makefile 絎茵с激с潟綣違腟九障鴻篏睡篁紙c \f2javadoc\fP 潟潟絎茵с障
161.10528 +.LP
161.10529 +.SS
161.10530 +潟潟茵箴
161.10531 +.LP
161.10532 +.LP
161.10533 +罨<潟潟茵箴 900 絖莇DOS 激с紊с障狗帥潟潟茵綣違<ゃ篏睡障 障激с鴻荐菴違障
161.10534 +.LP
161.10535 +.nf
161.10536 +\f3
161.10537 +.fl
161.10538 +% javadoc \-sourcepath /java/jdk/src/share/classes \\
161.10539 +.fl
161.10540 + \-overview /java/jdk/src/share/classes/overview.html \\
161.10541 +.fl
161.10542 + \-d /java/jdk/build/api \\
161.10543 +.fl
161.10544 + \-use \\
161.10545 +.fl
161.10546 + \-splitIndex \\
161.10547 +.fl
161.10548 + \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
161.10549 +.fl
161.10550 + \-doctitle 'Java(TM) 2 Platform 5.0 API Specification' \\
161.10551 +.fl
161.10552 + \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
161.10553 +.fl
161.10554 + \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
161.10555 +.fl
161.10556 +a bug or feature</a><br><br>Java is a trademark or registered trademark of Sun Microsystems,
161.10557 +.fl
161.10558 +Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, Inc.
161.10559 +.fl
161.10560 +901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
161.10561 +.fl
161.10562 + \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
161.10563 +.fl
161.10564 + \-group "Extension Packages" "javax.*" \\
161.10565 +.fl
161.10566 + \-J\-Xmx180m \\
161.10567 +.fl
161.10568 + @packages
161.10569 +.fl
161.10570 +\fP
161.10571 +.fi
161.10572 +
161.10573 +.LP
161.10574 +.LP
161.10575 +筝荐潟潟с\f2packages\fP 絲乗院宴若後 (\f2java.applet java.lang\fP ) ャc<ゃс激с潟筝綣膃у蚊障綣違眼壕絖水ャс障違箴潟種若鴻翫\f2\-bottom\fP 激с潟壕絖ゃ羈с
161.10576 +.LP
161.10577 +.SS
161.10578 +Makefile 箴
161.10579 +.LP
161.10580 +.LP
161.10581 +сGNU Makefile 箴腓冴障Windows Makefile 箴ゃ
161.10582 +.na
161.10583 +\f2Windows Makefile 篏号\fP @
161.10584 +.fi
161.10585 +http://java.sun.com/j2se/javadoc/faq/index.html#makefilesс
161.10586 +.LP
161.10587 +.nf
161.10588 +\f3
161.10589 +.fl
161.10590 +javadoc \-\fP\f3sourcepath\fP\f3 $(SRCDIR) \\ /* Sets path for source files */
161.10591 +.fl
161.10592 + \-\fP\f3overview\fP\f3 $(SRCDIR)/overview.html \\ /* Sets file for overview text */
161.10593 +.fl
161.10594 + \-\fP\f3d\fP\f3 /java/jdk/build/api \\ /* Sets destination directory */
161.10595 +.fl
161.10596 + \-\fP\f3use\fP\f3 \\ /* Adds "Use" files */
161.10597 +.fl
161.10598 + \-\fP\f3splitIndex\fP\f3 \\ /* Splits index A\-Z */
161.10599 +.fl
161.10600 + \-\fP\f3windowtitle\fP\f3 $(WINDOWTITLE) \\ /* Adds a window title */
161.10601 +.fl
161.10602 + \-\fP\f3doctitle\fP\f3 $(DOCTITLE) \\ /* Adds a doc title */
161.10603 +.fl
161.10604 + \-\fP\f3header\fP\f3 $(HEADER) \\ /* Adds running header text */
161.10605 +.fl
161.10606 + \-\fP\f3bottom\fP\f3 $(BOTTOM) \\ /* Adds text at bottom */
161.10607 +.fl
161.10608 + \-\fP\f3group\fP\f3 $(GROUPCORE) \\ /* 1st subhead on overview page */
161.10609 +.fl
161.10610 + \-\fP\f3group\fP\f3 $(GROUPEXT) \\ /* 2nd subhead on overview page */
161.10611 +.fl
161.10612 + \-\fP\f3J\fP\f3\-Xmx180m \\ /* Sets memory to 180MB */
161.10613 +.fl
161.10614 + java.lang java.lang.reflect \\ /* Sets packages to document */
161.10615 +.fl
161.10616 + java.util java.io java.net \\
161.10617 +.fl
161.10618 + java.applet
161.10619 +.fl
161.10620 +
161.10621 +.fl
161.10622 +WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
161.10623 +.fl
161.10624 +DOCTITLE = 'Java(TM) 2 Platform v1.2 API Specification'
161.10625 +.fl
161.10626 +HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
161.10627 +.fl
161.10628 +BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
161.10629 +.fl
161.10630 + a bug or feature</a><br><br>Java is a trademark or registered trademark
161.10631 +.fl
161.10632 + of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993\-1999
161.10633 +.fl
161.10634 + Sun Microsystems, Inc. 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A.
161.10635 +.fl
161.10636 + All Rights Reserved.</font>'
161.10637 +.fl
161.10638 +GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
161.10639 +.fl
161.10640 +GROUPEXT = '"Extension Packages" "javax.*"'
161.10641 +.fl
161.10642 +SRCDIR = '/java/jdk/1.2/src/share/classes'
161.10643 +.fl
161.10644 +\fP
161.10645 +.fi
161.10646 +
161.10647 +.LP
161.10648 +.LP
161.10649 +Makefile 綣違筝綣膃у蚊帥障
161.10650 +.LP
161.10651 +.LP
161.10652 +\f3羈\fP
161.10653 +.LP
161.10654 +.RS 3
161.10655 +.TP 2
161.10656 +o
161.10657 +\f2\-windowtitle\fP 激с潟ャJavadoc 若cャ<潟帥ゃc潟帥ゃ潟若障\f2\-windowtitle\fP 鴻堺 \f2\-doctitle\fP с HTML 帥違篏睡障 HTML 帥違c潟帥ゃ障障鴻茵腓冴障障
161.10658 +.TP 2
161.10659 +o
161.10660 +箴 \f2\-footer\fP 激с潟ャJavadoc 若c若鴻帥若潟若障
161.10661 +.TP 2
161.10662 +o
161.10663 +箴с綽荀障\-\f2classpath\fP \-\f2link\fP 荀激с潟с
161.10664 +.RE
161.10665 +
161.10666 +.LP
161.10667 +.SH "激ャ若c潟"
161.10668 +.LP
161.10669 +.SS
161.10670 +筝激ャ若c潟
161.10671 +.LP
161.10672 +.RS 3
161.10673 +.TP 2
161.10674 +o
161.10675 +\f3Javadoc FAQ\fP \- 筝違潟激ャ若c潟違潟
161.10676 +.na
161.10677 +\f2Javadoc FAQ\fP @
161.10678 +.fi
161.10679 +http://java.sun.com/j2se/javadoc/faq/index.html#B усс障
161.10680 +.TP 2
161.10681 +o
161.10682 +\f3違喝狗篋\fP \- 違筝Important Bug Fixes and Changes ссс障
161.10683 +.TP 2
161.10684 +o
161.10685 +\f3若吾с括\fP \- 若吾с括垩с
161.10686 +.TP 2
161.10687 +o
161.10688 +\f3鴻鴻ャ<潟\fP \- 宴若吾ャ<潟Javadoc 鴻劫ф<ゃ帥茯粋昭帥障違<ゃゃ潟\-сjavadoc <ゃ茹f蚊с障
161.10689 +.RE
161.10690 +
161.10691 +.LP
161.10692 +.SS
161.10693 +若茘
161.10694 +.LP
161.10695 +.LP
161.10696 +若活<祉若吾<ゃ絎h茵 (ャ<潟若激с潟潟<潟劫茵с) 茵垩障障
161.10697 +.LP
161.10698 +.RS 3
161.10699 +.TP 2
161.10700 +o
161.10701 +\f2"error:cannot read:Class1.java"\fP Javadoc 若潟c Class1.java 鴻若障腟九障鴻障後障鴻茵腓冴劫箴翫 \f2./Class1.java\fP с
161.10702 +.RE
161.10703 +
161.10704 +.LP
161.10705 +.SH "医"
161.10706 +.LP
161.10707 +.RS 3
161.10708 +.TP 3
161.10709 +CLASSPATH
161.10710 +Javadoc 若吟若鴻<ゃ「篏帥鴻絎医紊違с医紊違\f2\-classpath\fP 激с潟c若若ゃ障c罨<潟潟у阪障
161.10711 +.:/home/classes:/usr/local/java/classes
161.10712 +.RE
161.10713 +
161.10714 +.LP
161.10715 +.SH "∫i"
161.10716 +.LP
161.10717 +.RS 3
161.10718 +.TP 2
161.10719 +o
161.10720 +javac(1)
161.10721 +.TP 2
161.10722 +o
161.10723 +java(1)
161.10724 +.TP 2
161.10725 +o
161.10726 +jdb(1)
161.10727 +.TP 2
161.10728 +o
161.10729 +javah(1)
161.10730 +.TP 2
161.10731 +o
161.10732 +javap(1)
161.10733 +.TP 2
161.10734 +o
161.10735 +.na
161.10736 +\f2Javadoc 若若\fP @
161.10737 .fi
161.10738 http://java.sun.com/j2se/javadoc/index.jsp
161.10739 -の
161.10740 -.na
161.10741 -「\f2Javadoc Home Page\fP」
161.10742 .TP 2
161.10743 o
161.10744 +.na
161.10745 +\f2How to Write Doc Comments for Javadoc\fP @
161.10746 .fi
161.10747 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
161.10748 -の
161.10749 -.na
161.10750 -「\f2How to Write Doc Comments for Javadoc\fP」
161.10751 .TP 2
161.10752 o
161.10753 -クラスパスの設定
161.10754 +.na
161.10755 +\f2鴻鴻荐絎\fP @
161.10756 +.fi
161.10757 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
161.10758 .TP 2
161.10759 o
161.10760 -javac と javadoc がクラスを検索する方法 (tools.jar)
161.10761 +.na
161.10762 +\f2javac javadoc 鴻罎膣≪号\fP @
161.10763 +.fi
161.10764 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
161.10765 .RE
161.10766
161.10767 .LP
161.10768 .LP
161.10769 -Javadoc は、Sun Microsystems, Inc の商標です (\f2javadoc\fP コマンド自体には商標シンボルは不要)。
161.10770 +javadoc Sun Microsystems, Inc 罔с (\f2javadoc\fP 潟潟篏罔激潟筝荀)
162.1 --- a/src/solaris/doc/sun/man/man1/ja/javah.1 Tue May 12 15:21:55 2009 +0900
162.2 +++ b/src/solaris/doc/sun/man/man1/ja/javah.1 Thu May 14 00:17:25 2009 -0700
162.3 @@ -1,225 +1,160 @@
162.4 -'\" t
162.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
162.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
162.7 -.\"
162.8 -.\" This code is free software; you can redistribute it and/or modify it
162.9 -.\" under the terms of the GNU General Public License version 2 only, as
162.10 -.\" published by the Free Software Foundation.
162.11 -.\"
162.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
162.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
162.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
162.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
162.16 -.\" accompanied this code).
162.17 -.\"
162.18 -.\" You should have received a copy of the GNU General Public License version
162.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
162.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
162.21 -.\"
162.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
162.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
162.24 -.\" have any questions.
162.25 -.\" `
162.26 -'\"macro stdmacro
162.27 -.TH javah 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
162.28 -.SH "名前"
162.29 -javah \- C 言語のヘッダとスタブファイルのジェネレータ
162.30 -.\"
162.31 -.\" This document was created by saving an HTML file as text
162.32 -.\" from the JavaSoft web site:
162.33 -.\"
162.34 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
162.35 -.\"
162.36 -.\" and adding appropriate troff macros. Because the JavaSoft web site
162.37 -.\" man pages can change without notice, it may be helpful to diff
162.38 -.\" files to identify changes other than new functionality.
162.39 -.\"
162.40 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
162.41 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
162.42 +."
162.43 +." This code is free software; you can redistribute it and/or modify it
162.44 +." under the terms of the GNU General Public License version 2 only, as
162.45 +." published by the Free Software Foundation.
162.46 +."
162.47 +." This code is distributed in the hope that it will be useful, but WITHOUT
162.48 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
162.49 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
162.50 +." version 2 for more details (a copy is included in the LICENSE file that
162.51 +." accompanied this code).
162.52 +."
162.53 +." You should have received a copy of the GNU General Public License version
162.54 +." 2 along with this work; if not, write to the Free Software Foundation,
162.55 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
162.56 +."
162.57 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
162.58 +." CA 95054 USA or visit www.sun.com if you need additional information or
162.59 +." have any questions.
162.60 +."
162.61 +.TH javah 1 "04 May 2009"
162.62 +." Generated from HTML by html2man (author: Eric Armstrong)
162.63 +
162.64 +.LP
162.65 +.SH ""
162.66 +javah \- C 若鴻帥<ゃ吾с若
162.67 +.LP
162.68 +.RS 3
162.69 +
162.70 +.LP
162.71 +.LP
162.72 +\f3javah\fP Java 鴻 C 若<ゃ C 純若鴻<ゃ篏障<ゃJava 違潟域茯ф吾潟若C 篁荐茯ф吾潟若・膓潟若娯篏障
162.73 +.LP
162.74 +.RE
162.75 +.SH "綵√"
162.76 .LP
162.77
162.78 .LP
162.79 +.nf
162.80 +\f3
162.81 +.fl
162.82 +javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
162.83 +.fl
162.84 +javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
162.85 +.fl
162.86 +\fP
162.87 +.fi
162.88 +
162.89 .LP
162.90 -\f3javah\fP は、Java クラスから C ヘッダファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
162.91 -.LP
162.92 -.SH "形式"
162.93 -.B javah
162.94 -[
162.95 -.B options
162.96 -]
162.97 -.I fully-qualified-classname . . .
162.98 -.br
162.99 -.B javah_g
162.100 -[
162.101 -.B options
162.102 -]
162.103 -.I fully-qualified-classname . . .
162.104 -.SH "機能説明"
162.105 -.IX "stub file generator" "" "stub file generator \(em \fLjavah\fP"
162.106 -.IX "C header and stub file generator" "" "C header and stub file generator \(em \fLjavah\fP"
162.107 -.IX "javah" "" "\fLjavah\fP \(em C header and stub file generator"
162.108 -.B javah
162.109 -コマンドは、ネイティブメソッドを実装するのに必要な
162.110 -C
162.111 -言語のヘッダおよびソースファイルを生成します。
162.112 -C
162.113 -のプログラムは、
162.114 -生成されたヘッダとソースファイルを使って、
162.115 -ネイティブソースコードからオブジェクトのインスタンス
162.116 -変数を参照できます。
162.117 -.B .h
162.118 -ファイルは、対応するクラスに合ったレイアウトの
162.119 -構造体定義を含んでいます。
162.120 -構造体に含まれるフィールドは、クラス内のインスタンス変数に
162.121 -対応しています。
162.122 -.LP
162.123 -ヘッダファイル名およびヘッダファイル中で定義される構造体名は、
162.124 -クラス名から派生します。
162.125 -.B javah
162.126 -に渡されるクラスがパッケージ内部にあれば、
162.127 -そのパッケージ名がファイル名および構造体名の先頭に付加されます。
162.128 -名前の間は下線
162.129 -(_)
162.130 -で区切られます。
162.131 -.LP
162.132 -デフォルトでは、
162.133 -.B javah
162.134 -はコマンド行で指定された個々のクラスに対して
162.135 -ヘッダファイルを作成し、現在のディレクトリに出力します。
162.136 -.B \-stubs
162.137 -オプションを指定するとソースファイルが生成されます。
162.138 -.B \-o
162.139 -オプションを指定すると、指定した全クラスに対する出力ファイル
162.140 -を連結して
162.141 -1
162.142 -個のファイルとして生成します。
162.143 -.LP
162.144 -新しいネイティブメソッドインタフェースの
162.145 -Java Native Interface (JNI)
162.146 -は、ヘッダ情報やスタブファイルを必要としません。
162.147 -ただし
162.148 -.B javah
162.149 -コマンドは現在も JNI 形式のネイティブメソッドに必要な
162.150 -ネイティブメソッド関数プロトタイプを生成できます。
162.151 -.B javah
162.152 -はデフォルトで JNI 形式で出力し、その結果を
162.153 -.B .h
162.154 -ファイルに格納します。
162.155 -.LP
162.156 -.B javah_g
162.157 -は非最適化バージョンの
162.158 -.B javah
162.159 -で、
162.160 -.B jdb
162.161 -などのデバッガ用の使用に適しています。
162.162 -.SH "オプション"
162.163 -.TP 15
162.164 -.BI \-o " outputfile"
162.165 -コマンド行で指定したすべてのクラスに対する結果のヘッダファイルまたは
162.166 -ソースファイルを連結し、
162.167 -.BR outputfile
162.168 -に格納します。
162.169 -.B \-o
162.170 -オプションまたは
162.171 -.B \-d
162.172 -オプションだけを使用できます。
162.173 -.TP 15
162.174 -.BI \-d " directory"
162.175 -.B javah
162.176 -がヘッダファイルまたはスタブファイルを書き出す
162.177 -ディレクトリを指定します。
162.178 -.TP 15
162.179 -.B \-stubs
162.180 -Java オブジェクトファイルから C 言語の宣言を生成します。
162.181 -.TP 15
162.182 -.B \-verbose
162.183 -詳細情報の出力を要求します。
162.184 -.B javah
162.185 -は、生成されたファイルの状態に関するメッセージを
162.186 -.B stdout
162.187 -に書き出します。
162.188 -.TP 15
162.189 -.B \-help
162.190 -.B javah
162.191 -の使用法についてヘルプメッセージを出力します。
162.192 -.TP 15
162.193 -.B \-version
162.194 -javah バージョン情報を出力します。
162.195 -.TP 15
162.196 -.B \-jni
162.197 -JNI 形式のネイティブなメソッド関数のプロトタイプが入った出力ファイルを
162.198 -作成します。これはデフォルトの出力であるため、
162.199 --B \-jni
162.200 -は省略可能です。
162.201 -.TP 15
162.202 -.BI \-classpath " path"
162.203 -.B javah
162.204 -がクラスを検索するために用いるパスを
162.205 -.I path
162.206 -で指定します。この指定値は、デフォルトおよび
162.207 -.B CLASSPATH
162.208 -環境変数の設定値をオーバーライドします。
162.209 -複数のディレクトリを指定する場合はコロンで区切ります。
162.210 -したがって
162.211 -.I path
162.212 -の通常の形式は次のようになります。
162.213 -.RS 20
162.214 -.sp 1n
162.215 -.LP
162.216 -.BI .:< your_path >
162.217 -.sp 1n
162.218 -.RE
162.219 -.RS 15
162.220 -.LP
162.221 -パスの指定例:
162.222 -.RE
162.223 -.RS 20
162.224 -.sp 1n
162.225 -.LP
162.226 -.B .:/home/avh/classes:/usr/local/java/classes
162.227 -.sp 1n
162.228 -.RE
162.229 -.LP
162.230 -便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
162.231 -.br
162.232 -.br
162.233 -たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。ただし、JAR ファイルの順番は未定義となります。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しなどの環境に対する問い合わせを行わない限り、展開されていないワイルドカードを Java プログラムは認識しません。
162.234 -.TP 15
162.235 -.BI \-bootclasspath " path"
162.236 -bootstrap クラスをロードするパスを指定します。デフォルトでは、bootstrap
162.237 -クラスはコアとなる Java 2 プラットフォームを実装するクラスで、
162.238 -.B jre/lib/rt.jar
162.239 -および他の重要な jar ファイルに含まれています。
162.240 -.TP 15
162.241 -.B \-old
162.242 -古い JDK 1.0 形式のヘッダファイルを生成します。
162.243 -.TP 15
162.244 -.B \-force
162.245 -常に出力ファイルに書き込むことを指定します。
162.246 -.TP 15
162.247 -.BI \-J "option"
162.248 -.I option
162.249 -を Java 仮想マシンに渡します。ここで、
162.250 -.I option
162.251 -は、Java アプリケーション起動プログラムの参照ページで
162.252 -説明されているオプションの 1 つです。たとえば、
162.253 -.I \-J-Xms48m
162.254 -は、起動時に使用するメモリを 48M バイトに設定します。
162.255 -.SH "環境変数"
162.256 -.TP 15
162.257 -.B CLASSPATH
162.258 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
162.259 -複数のディレクトリを指定する場合はコロンで区切ります。
162.260 -以下に例を示します。
162.261 -.RS 10
162.262 -.sp 1n
162.263 -.LP
162.264 -.B .:/home/avh/classes:/usr/local/java/classes
162.265 -.RE
162.266 -.SH "関連項目"
162.267 +.SH "茯"
162.268 .LP
162.269
162.270 .LP
162.271 .LP
162.272 -javac、java、jdb、javap、javadoc
162.273 +\f3javah\fP ゃc<純絎茖綽荀 C 若純若鴻<ゃ障篏若純若鴻<ゃゃc純若鴻潟若吾сゃ潟鴻帥潟劫違с C 違c篏睡障.h <ゃ絲上鴻筝眼臀ゆ篏絎臂帥障罕篏c若鴻ゃ潟鴻帥潟劫違絲上障
162.274 +.LP
162.275 +.LP
162.276 +若<ゃ筝уh罕篏鴻羇丞障\f3javah\fP 羝<鴻宴若吾筝翫宴若後若<ゃ罕篏筝≧鴻篁障筝膩 (_) 阪絖篏睡障
162.277 +.LP
162.278 +.LP
162.279 +с \f3javah\fP 潟潟茵鴻鴻若<ゃ篏憜c<ゃ臀障純若鴻<ゃ篏\f2\-stubs\fP 激с潟篏睡1 ゃ<ゃ筝鴻鴻鴻腟g\f2\-o\fP 激с潟篏睡
162.280 +.LP
162.281 +.LP
162.282 +違ゃc<純ゃ潟帥с若鴻с Java Native Interface (JNI) 惹宴障鴻帥<ゃ綽荀障 憜с\f3javah\fP JNI 綵√ゃc<純綽荀ゃc<純罘純帥ゃ障 с\f3javah\fP JNI 綵√у阪腟 .h <ゃ主障
162.283 +.LP
162.284 +.LP
162.285 +\f3javah_g\fP jdb(1) \f3javah\fP 若吾с潟с
162.286 +.LP
162.287 +.SH "激с"
162.288 +.LP
162.289 +
162.290 +.LP
162.291 +.RS 3
162.292 +.TP 3
162.293 +\-o outputfile
162.294 +潟潟茵鴻鴻鴻絲障腟若障純若鴻<ゃg \f2outputfile\fP 主障\f3\-o\fP 障 \f3\-d\fP <筝鴻篏帥障
162.295 +.TP 3
162.296 +\-d directory
162.297 +\f3javah\fP 若<ゃ障鴻帥<ゃ篆絖c荐絎障\f3\-d\fP 障 \f3\-o\fP <筝鴻篏帥障
162.298 +.TP 3
162.299 +\-stubs
162.300 +\f3javah\fP Java 吾с<ゃ C 絎h障
162.301 +.TP 3
162.302 +\-verbose
162.303 +荅括完阪絎篏<ゃ倶≪<祉若吾\f3javah\fP 罔羣阪阪障
162.304 +.TP 3
162.305 +\-help
162.306 +\f3javah\fP 篏睡羈ゃ<祉若吾阪障
162.307 +.TP 3
162.308 +\-version
162.309 +\f3javah\fP 若吾с恰宴阪障
162.310 +.TP 3
162.311 +\-jni
162.312 +JNI 綵√ゃc<ゃ罘純帥ゃ阪<ゃ\f3javah\fP 篏障罔羣阪с\f3\-jni\fP 篏睡激с潟с
162.313 +.TP 3
162.314 +\-classpath path
162.315 +鴻「 \f3javah\fP 篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
162.316 +.nf
162.317 +\f3
162.318 +.fl
162.319 + .:<your_path>
162.320 +.fl
162.321 +\fP
162.322 +.fi
162.323 +箴腓冴障
162.324 +.nf
162.325 +\f3
162.326 +.fl
162.327 + .:/home/avh/classes:/usr/local/java/classes
162.328 +.fl
162.329 +\fP
162.330 +.fi
162.331 +.LP
162.332 +箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
162.333 +.br
162.334 +.br
162.335 +違c \f2foo\fP \f2a.jar\fP \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障
162.336 +.TP 3
162.337 +\-bootclasspath path
162.338 +若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR <ゃ 潟 Java 2 若絎茖鴻с
162.339 +.TP 3
162.340 +\-old
162.341 +ゃ JDK1.0 綵√若<ゃ絎障
162.342 +.TP 3
162.343 +\-force
162.344 +阪<ゃ絽吾吾莨若障絎障
162.345 +.TP 3
162.346 +\-Joption
162.347 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
162.348 +.RE
162.349 +
162.350 +.LP
162.351 +.SH "医紊"
162.352 +.LP
162.353 +
162.354 +.LP
162.355 +.RS 3
162.356 +.TP 3
162.357 +CLASSPATH
162.358 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障
162.359 +.nf
162.360 +\f3
162.361 +.fl
162.362 +.:/home/avh/classes:/usr/local/java/classes
162.363 +.fl
162.364 +\fP
162.365 +.fi
162.366 +.RE
162.367 +
162.368 +.LP
162.369 +.SH "∫i"
162.370 +.LP
162.371 +
162.372 +.LP
162.373 +.LP
162.374 +javac(1)java(1)jdb(1)javap(1)javadoc(1)
162.375 .LP
162.376
162.377 .LP
163.1 --- a/src/solaris/doc/sun/man/man1/ja/javap.1 Tue May 12 15:21:55 2009 +0900
163.2 +++ b/src/solaris/doc/sun/man/man1/ja/javap.1 Thu May 14 00:17:25 2009 -0700
163.3 @@ -1,115 +1,137 @@
163.4 -'\" t
163.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
163.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
163.7 -.\"
163.8 -.\" This code is free software; you can redistribute it and/or modify it
163.9 -.\" under the terms of the GNU General Public License version 2 only, as
163.10 -.\" published by the Free Software Foundation.
163.11 -.\"
163.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
163.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
163.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
163.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
163.16 -.\" accompanied this code).
163.17 -.\"
163.18 -.\" You should have received a copy of the GNU General Public License version
163.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
163.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
163.21 -.\"
163.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
163.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
163.24 -.\" have any questions.
163.25 -.\" `
163.26 -'\"macro stdmacro
163.27 -.TH javap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
163.28 -.SH "名前"
163.29 -javap \- Java クラスファイル逆アセンブラ
163.30 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
163.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
163.32 +."
163.33 +." This code is free software; you can redistribute it and/or modify it
163.34 +." under the terms of the GNU General Public License version 2 only, as
163.35 +." published by the Free Software Foundation.
163.36 +."
163.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
163.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
163.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
163.40 +." version 2 for more details (a copy is included in the LICENSE file that
163.41 +." accompanied this code).
163.42 +."
163.43 +." You should have received a copy of the GNU General Public License version
163.44 +." 2 along with this work; if not, write to the Free Software Foundation,
163.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
163.46 +."
163.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
163.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
163.49 +." have any questions.
163.50 +."
163.51 +.TH javap 1 "04 May 2009"
163.52 +." Generated from HTML by html2man (author: Eric Armstrong)
163.53 +
163.54 +.LP
163.55 +.SH ""
163.56 +javap \- Java 鴻<ゃ≪祉潟
163.57 +.LP
163.58 +.RS 3
163.59 +
163.60 +.LP
163.61 +.LP
163.62 +鴻<ゃ≪祉潟障
163.63 +.LP
163.64 +.RE
163.65 +.SH "綵√"
163.66 .LP
163.67
163.68 .LP
163.69 -.LP
163.70 -クラスファイルを逆アセンブルします。
163.71 -.LP
163.72 -.\"
163.73 -.\" This document was created by saving an HTML file as text
163.74 -.\" from the JavaSoft web site:
163.75 -.\"
163.76 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
163.77 -.\"
163.78 -.\" and adding appropriate troff macros. Because the JavaSoft web site
163.79 -.\" man pages can change without notice, it may be helpful to diff
163.80 -.\" files to identify changes other than new functionality.
163.81 -.\"
163.82 -.SH "形式"
163.83 -.B javap
163.84 -[
163.85 -.B options
163.86 -]
163.87 -.IR class .\|.\|.
163.88 -.SH "機能説明"
163.89 -.IX "Java class file disassembler" "" "Java class file disassembler \(em \fLjavap\fP"
163.90 -.IX "javap" "" "\fLjavap\fP \(em Java class file disassembler"
163.91 -.B javap
163.92 -コマンドは、
163.93 -Java クラスファイルを逆アセンブルします。
163.94 -出力内容はオプションで指定します。
163.95 -オプションを
163.96 -1
163.97 -つも指定しないと、
163.98 -.B javap
163.99 -は渡されたクラスの
163.100 -.BR package、
163.101 -.BR protected、
163.102 -および
163.103 -.B public
163.104 -フィールドとメソッドを出力します。
163.105 -.B javap
163.106 -コマンドの出力先は
163.107 -.B stdout
163.108 -です。たとえば、以下のクラス宣言をコンパイルします。
163.109 -.RS
163.110 .nf
163.111 \f3
163.112 +.fl
163.113 +javap [ \fP\f3options\fP\f3 ] class. . .
163.114 +.fl
163.115 +\fP
163.116 +.fi
163.117 +
163.118 +.LP
163.119 +.SH "茯"
163.120 +.LP
163.121 +
163.122 +.LP
163.123 +.LP
163.124 +\f3javap\fP 潟潟鴻<ゃ≪祉潟障阪絎激с潟違障激с潟絎翫\f3javap\fP 宴若吾羝<鴻 protected public c若<純阪障 \f3javap\fP 阪罔羣阪茵腓冴障違罨<劫h潟潟ゃ障
163.125 +.LP
163.126 +.RS 3
163.127 +
163.128 +.LP
163.129 +.nf
163.130 +\f3
163.131 +.fl
163.132 import java.awt.*;
163.133 +.fl
163.134 import java.applet.*;
163.135 +.fl
163.136
163.137 +.fl
163.138 public class DocFooter extends Applet {
163.139 - String date;
163.140 - String email;
163.141 +.fl
163.142 + String date;
163.143 +.fl
163.144 + String email;
163.145 +.fl
163.146
163.147 - public void init() {
163.148 - resize(500,100);
163.149 - date = getParameter("LAST_UPDATED");
163.150 - email = getParameter("EMAIL");
163.151 - }
163.152 +.fl
163.153 + public void init() {
163.154 +.fl
163.155 + resize(500,100);
163.156 +.fl
163.157 + date = getParameter("LAST_UPDATED");
163.158 +.fl
163.159 + email = getParameter("EMAIL");
163.160 +.fl
163.161 + }
163.162 +.fl
163.163
163.164 - public void paint(Graphics g) {
163.165 - g.drawString(date + " by ",100, 15);
163.166 - g.drawString(email,290,15);
163.167 - }
163.168 +.fl
163.169 + public void paint(Graphics g) {
163.170 +.fl
163.171 + g.drawString(date + " by ",100, 15);
163.172 +.fl
163.173 + g.drawString(email,290,15);
163.174 +.fl
163.175 + }
163.176 +.fl
163.177 }
163.178 -\f1
163.179 +.fl
163.180 +\fP
163.181 .fi
163.182 .RE
163.183 +
163.184 .LP
163.185 -この場合、
163.186 -.B javap DocFooter
163.187 -を実行すると以下の出力が得られます。
163.188 -.RS
163.189 +.LP
163.190 +\f3javap DocFooter\fP 阪罨<障
163.191 +.LP
163.192 +.RS 3
163.193 +
163.194 +.LP
163.195 +.nf
163.196 \f3
163.197 -.nf
163.198 +.fl
163.199 Compiled from DocFooter.java
163.200 +.fl
163.201 public class DocFooter extends java.applet.Applet {
163.202 - java.lang.String date;
163.203 - java.lang.String email;
163.204 - public void init();
163.205 - public void paint(java.awt.Graphics);
163.206 - public DocFooter();
163.207 +.fl
163.208 + java.lang.String date;
163.209 +.fl
163.210 + java.lang.String email;
163.211 +.fl
163.212 + public DocFooter();
163.213 +.fl
163.214 + public void init();
163.215 +.fl
163.216 + public void paint(java.awt.Graphics);
163.217 +.fl
163.218 }
163.219 -\f1
163.220 +.fl
163.221 +\fP
163.222 .fi
163.223 +.RE
163.224 +
163.225 .LP
163.226 -\f3javap \-c DocFooter\fP を実行すると以下の出力が得られます。
163.227 +.LP
163.228 +\f3javap \-c DocFooter\fP 阪罨<障
163.229 .LP
163.230 .RS 3
163.231
163.232 @@ -226,34 +248,35 @@
163.233 .RE
163.234
163.235 .LP
163.236 -.SH "オプション"
163.237 +.SH "激с"
163.238 .LP
163.239
163.240 .LP
163.241 +.RS 3
163.242 .TP 3
163.243 \-help
163.244 -\f3javap\fP のヘルプメッセージを出力します。
163.245 +\f3javap\fP <祉若吾阪障
163.246 .TP 3
163.247 \-l
163.248 -行番号と局所変数テーブルを表示します。
163.249 +茵垩絮紊違若茵腓冴障
163.250 .TP 3
163.251 \-b
163.252 -JDK 1.1 の \f3javap\fP との下位互換性を保証します。
163.253 +JDK 1.1 \f3javap\fP 筝篏篋с篆荐若障
163.254 .TP 3
163.255 \-public
163.256 -public クラスおよびメンバだけを表示します。
163.257 +public 鴻潟<潟若茵腓冴障
163.258 .TP 3
163.259 \-protected
163.260 -protected および public のクラスとメンバだけを表示します。
163.261 +protected public 鴻<潟若茵腓冴障
163.262 .TP 3
163.263 \-package
163.264 -package、protected、および public のクラスとメンバだけを表示します。これはデフォルトの設定です。
163.265 +packageprotected public 鴻<潟若茵腓冴障荐絎с
163.266 .TP 3
163.267 \-private
163.268 -すべてのクラスとメンバを表示します。
163.269 +鴻鴻<潟若茵腓冴障
163.270 .TP 3
163.271 \-Jflag
163.272 -ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
163.273 +潟帥ゃ激鴻贋・ \f2flag\fP 羝<障篏睡箴罨<腓冴障
163.274 .RS 3
163.275
163.276 .LP
163.277 @@ -269,21 +292,20 @@
163.278 .RE
163.279 .TP 3
163.280 \-s
163.281 -内部の型シグニチャーを出力します。
163.282 +激違c若阪障
163.283 .TP 3
163.284 \-c
163.285 -クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
163.286 +鴻<純≪祉潟潟若 Java ゃ潟若巡擦茵腓冴障
163.287 +.na
163.288 +\f2Java Virtual Machine Specification\fP @
163.289 .fi
163.290 -http://java.sun.com/docs/books/vmspec/
163.291 -の
163.292 -.na
163.293 -「\f2Java Virtual Machine Specification\fP」にドキュメント化されています。
163.294 +http://java.sun.com/docs/books/vmspec/ャ<潟障
163.295 .TP 3
163.296 \-verbose
163.297 -メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
163.298 +<純鴻帥泣ゃ冴 \f2locals\fP \f2args\fP 違阪障
163.299 .TP 3
163.300 \-classpath path
163.301 -\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
163.302 +\f3javap\fP 鴻「篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
163.303 .nf
163.304 \f3
163.305 .fl
163.306 @@ -291,7 +313,7 @@
163.307 .fl
163.308 \fP
163.309 .fi
163.310 -次に例を示します。
163.311 +箴腓冴障
163.312 .nf
163.313 \f3
163.314 .fl
163.315 @@ -301,27 +323,41 @@
163.316 .fi
163.317 .TP 3
163.318 \-bootclasspath path
163.319 -ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java プラットフォームを実装するクラスです。
163.320 +若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR <ゃ 潟 Java 2 若絎茖鴻с
163.321 .TP 3
163.322 \-extdirs dirs
163.323 -インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
163.324 +ゃ潟鴻若≦宍罘純罎膣≪贋若若ゃ障The default location for extensions is the value of \f2java.ext.dirs\fP.
163.325 +.RE
163.326 +
163.327 .LP
163.328 -.SH "環境変数"
163.329 -.TP 15
163.330 -.B CLASSPATH
163.331 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
163.332 -複数のディレクトリを指定する場合はコロンで区切ります。
163.333 -以下に例を示します。
163.334 -.sp 1n
163.335 -.RS 10
163.336 -.B .:/home/avh/classes:/usr/local/java/classes
163.337 -.RE
163.338 -.SH "関連項目"
163.339 +.SH "医紊"
163.340 .LP
163.341
163.342 .LP
163.343 +.RS 3
163.344 +.TP 3
163.345 +CLASSPATH
163.346 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障 罨<箴腓冴障
163.347 +.RS 3
163.348 +
163.349 .LP
163.350 -javac、java、jdb、javah、javadoc
163.351 +.nf
163.352 +\f3
163.353 +.fl
163.354 +.:/home/avh/classes:/usr/local/java/classes
163.355 +.fl
163.356 +\fP
163.357 +.fi
163.358 +.RE
163.359 +.RE
163.360 +
163.361 +.LP
163.362 +.SH "∫i"
163.363 +.LP
163.364 +
163.365 +.LP
163.366 +.LP
163.367 +javac(1) java(1)jdb(1)javah(1)javadoc(1)
163.368 .LP
163.369
163.370 .LP
164.1 --- a/src/solaris/doc/sun/man/man1/ja/javaws.1 Tue May 12 15:21:55 2009 +0900
164.2 +++ b/src/solaris/doc/sun/man/man1/ja/javaws.1 Thu May 14 00:17:25 2009 -0700
164.3 @@ -1,30 +1,51 @@
164.4 -'\" t
164.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
164.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
164.7 -.\"
164.8 -.\" This code is free software; you can redistribute it and/or modify it
164.9 -.\" under the terms of the GNU General Public License version 2 only, as
164.10 -.\" published by the Free Software Foundation.
164.11 -.\"
164.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
164.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
164.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
164.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
164.16 -.\" accompanied this code).
164.17 -.\"
164.18 -.\" You should have received a copy of the GNU General Public License version
164.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
164.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
164.21 -.\"
164.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
164.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
164.24 -.\" have any questions.
164.25 -.\" `
164.26 -.TH javaws 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
164.27 -.SH 名前
164.28 -\fBjavaws \fP- Java Web Start 起動コマンド
164.29 -\fB
164.30 -.SH 形式
164.31 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
164.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
164.33 +."
164.34 +." This code is free software; you can redistribute it and/or modify it
164.35 +." under the terms of the GNU General Public License version 2 only, as
164.36 +." published by the Free Software Foundation.
164.37 +."
164.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
164.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
164.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
164.41 +." version 2 for more details (a copy is included in the LICENSE file that
164.42 +." accompanied this code).
164.43 +."
164.44 +." You should have received a copy of the GNU General Public License version
164.45 +." 2 along with this work; if not, write to the Free Software Foundation,
164.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
164.47 +."
164.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
164.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
164.50 +." have any questions.
164.51 +."
164.52 +.TH javaws 1 "04 May 2009"
164.53 +." Generated from HTML by html2man (author: Eric Armstrong)
164.54 +
164.55 +.LP
164.56 +
164.57 +.LP
164.58 +.SH ""
164.59 +\f2javaws\fP 潟潟茵
164.60 +.LP
164.61 +
164.62 +.LP
164.63 +.LP
164.64 +\
164.65 +.LP
164.66 +.SS
164.67 +NAME
164.68 +.LP
164.69 +.RS 3
164.70 +
164.71 +.LP
164.72 +.LP
164.73 +\f2javaws\fP \- Java Web Start 莎桁潟潟
164.74 +.LP
164.75 +.RE
164.76 +.SS
164.77 +綵√
164.78 +.LP
164.79 .RS 3
164.80
164.81 .LP
164.82 @@ -35,21 +56,20 @@
164.83 \f2javaws [control\-options]\fP
164.84 .LP
164.85 .RE
164.86 -.SS
164.87 -パラメータ
164.88 +.SS
164.89 +<若
164.90 .LP
164.91 .RS 3
164.92
164.93 .LP
164.94 .LP
164.95 -[run\-options]
164.96 +\f2[run\-options]\fP
164.97 .LP
164.98 .RS 3
164.99
164.100 .LP
164.101 .LP
164.102 -コマンド行実行オプション。
164.103 -実行オプションの順序は任意です。個々の実行オプションについては、後述の「実行オプション」節を参照してください。
164.104 +潟潟茵絎茵激с潟 絎茵激с潟篁紙綺ф絎с障腮激с潟ゃ筝 絎茵激с潟с
164.105 .LP
164.106 .RE
164.107 .LP
164.108 @@ -59,7 +79,7 @@
164.109
164.110 .LP
164.111 .LP
164.112 -パスまたは JNLP (Java Network Launching Protocol) ファイルの URL (Uniform Resource Locater) を指定できます。
164.113 +JNLP (Java Network Launching Protocol) <ゃ鴻障 URL (Uniform Resource Locator) <с
164.114 .LP
164.115 .RE
164.116 .LP
164.117 @@ -69,28 +89,28 @@
164.118
164.119 .LP
164.120 .LP
164.121 -コマンド行制御オプション。制御オプションの順序は任意です。個々の制御オプションについては、後述の「制御オプション」節を参照してください。
164.122 +潟潟茵九勝激с潟 九勝激с潟篁紙綺ф絎с障腮激с潟ゃ筝 九勝激с潟с
164.123 .LP
164.124 .RE
164.125 .RE
164.126 -.SS
164.127 -機能説明
164.128 +.SS
164.129 +茯
164.130 .LP
164.131 .RS 3
164.132
164.133 .LP
164.134 .LP
164.135 -\fBjavaws\fP コマンドにより JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動できます。Java Web Start はネットワーク上に置かれる Java アプリケーションまたはアプレットを起動します。
164.136 +\f2javaws\fP 潟潟JNLP (Java Network Launching Protocol) <潟劫茖с Java Web Start 莎桁障Java Web Start 若筝у篏 Java ≪宴若激с潟障≪莎桁障
164.137 .LP
164.138 .LP
164.139 -JNLP ファイルを指定すると、\fBjavaws\fP は JNLP ファイルに指定されている Java アプリケーションまたはアプレットを起動します。
164.140 +JNLP <ゃ絎\f2javaws\fP JNLP <ゃ絎 Java ≪宴若激с潟障≪莎桁障
164.141 .LP
164.142 .LP
164.143 -現在のリリースでサポートされている \f2javaws\fP 起動ツールの一連のオプションは、将来のリリースで削除される可能性があります。
164.144 +\f2javaws\fP 莎桁若憜若鴻с泣若 1 腟激с潟障激с潟絨ャ若鴻сゃ醇с障
164.145 .LP
164.146 .RE
164.147 -.SS
164.148 -実行オプション
164.149 +.SS
164.150 +絎茵激с
164.151 .LP
164.152 .RS 3
164.153
164.154 @@ -102,7 +122,7 @@
164.155
164.156 .LP
164.157 .LP
164.158 -Java Web Start をオフラインモードで実行します。
164.159 +Java Web Start ゃ潟≪若у茵障
164.160 .LP
164.161 .RE
164.162 .LP
164.163 @@ -112,7 +132,7 @@
164.164
164.165 .LP
164.166 .LP
164.167 -初期スプラッシュ画面の表示を無効にします。
164.168 +鴻激ョ脂≪茵腓冴≦鴻障
164.169 .LP
164.170 .RE
164.171 .LP
164.172 @@ -122,8 +142,7 @@
164.173
164.174 .LP
164.175 .LP
164.176 -jnlp ファイルの引数を \f2\-open <arguments> と置き換えます。
164.177 -\fP.
164.178 +激с潟絎JNLP <ゃ綣違 \f2\-open <arguments>\fP 臀障
164.179 .LP
164.180 .RE
164.181 .LP
164.182 @@ -133,7 +152,7 @@
164.183
164.184 .LP
164.185 .LP
164.186 -jnlp ファイルの引数を \f2\-print <arguments>\fP と置き換えます。
164.187 +激с潟絎JNLP <ゃ綣違 \f2\-print <arguments>\fP 臀障
164.188 .LP
164.189 .RE
164.190 .LP
164.191 @@ -143,7 +162,7 @@
164.192
164.193 .LP
164.194 .LP
164.195 -オンラインモードで実行します (デフォルトの動作)。
164.196 +潟ゃ潟≪若у茵障 (篏)
164.197 .LP
164.198 .RE
164.199 .LP
164.200 @@ -153,7 +172,7 @@
164.201
164.202 .LP
164.203 .LP
164.204 -アプリケーションが終了するまで \f2javaws\fP プロセスは終了しません。
164.205 +激с潟絎≪宴若激с潟腟篋障 \f2javaws\fP 祉鴻腟篋障
164.206 .LP
164.207 .RE
164.208 .LP
164.209 @@ -163,7 +182,7 @@
164.210
164.211 .LP
164.212 .LP
164.213 -追加の出力を表示します。
164.214 +菴遵阪茵腓冴障
164.215 .LP
164.216 .RE
164.217 .LP
164.218 @@ -173,7 +192,7 @@
164.219
164.220 .LP
164.221 .LP
164.222 -vm にオプションを補います。
164.223 +vm 激с潟茖障
164.224 .LP
164.225 .RE
164.226 .LP
164.227 @@ -183,12 +202,12 @@
164.228
164.229 .LP
164.230 .LP
164.231 -アプリケーションをシステムキャッシュからのみ実行します。
164.232 +≪宴若激с潟激鴻c激ャ水茵障
164.233 .LP
164.234 .RE
164.235 .RE
164.236 -.SS
164.237 -制御オプション
164.238 +.SS
164.239 +九勝激с
164.240 .LP
164.241 .RS 3
164.242
164.243 @@ -200,7 +219,7 @@
164.244
164.245 .LP
164.246 .LP
164.247 -Java コントロールパネルでキャッシュビューアを表示します。
164.248 +Java 潟潟若сc激ャャ若≪茵腓冴障
164.249 .LP
164.250 .RE
164.251 .LP
164.252 @@ -210,7 +229,7 @@
164.253
164.254 .LP
164.255 .LP
164.256 -指定された配備プロパティをクリアします。
164.257 +絎c若≪障
164.258 .LP
164.259 .RE
164.260 .LP
164.261 @@ -220,7 +239,7 @@
164.262
164.263 .LP
164.264 .LP
164.265 -指定された配備プロパティを指定された値に設定します。
164.266 +絎c若絎ゃ荐絎障
164.267 .LP
164.268 .RE
164.269 .LP
164.270 @@ -230,7 +249,7 @@
164.271
164.272 .LP
164.273 .LP
164.274 -キャッシュからすべてのアプリケーションを削除します。
164.275 +c激ャ鴻≪宴若激с潟ゃ障
164.276 .LP
164.277 .RE
164.278 .LP
164.279 @@ -240,7 +259,7 @@
164.280
164.281 .LP
164.282 .LP
164.283 -キャッシュからアプリケーションを削除します。
164.284 +c激ャ≪宴若激с潟ゃ障
164.285 .LP
164.286 .RE
164.287 .LP
164.288 @@ -250,10 +269,10 @@
164.289
164.290 .LP
164.291 .LP
164.292 -キャッシュにアプリケーションをインポートします。
164.293 +c激ャ≪宴若激с潟ゃ潟若障
164.294 .LP
164.295 .RE
164.296 -インポートオプション
164.297 +\f3ゃ潟若激с\fP
164.298 .LP
164.299 .LP
164.300 \f2\-silent\fP
164.301 @@ -262,7 +281,7 @@
164.302
164.303 .LP
164.304 .LP
164.305 -サイレントモードでインポートします (UI は表示されません)。
164.306 +泣ゃ潟≪若сゃ潟若障 (UI 茵腓冴障)
164.307 .LP
164.308 .RE
164.309 .LP
164.310 @@ -272,7 +291,7 @@
164.311
164.312 .LP
164.313 .LP
164.314 -システムキャッシュにアプリケーションをインポートします。
164.315 +激鴻c激ャ≪宴若激с潟ゃ潟若障
164.316 .LP
164.317 .RE
164.318 .LP
164.319 @@ -282,7 +301,7 @@
164.320
164.321 .LP
164.322 .LP
164.323 -任意の codebase からリソースを取得します。
164.324 +篁紙 codebase 純若鴻緇障
164.325 .LP
164.326 .RE
164.327 .LP
164.328 @@ -292,7 +311,7 @@
164.329
164.330 .LP
164.331 .LP
164.332 -ユーザ許容プロンプトのようにショートカットをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
164.333 +若吟取┗絎鴻潟激с若ゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
164.334 .LP
164.335 .RE
164.336 .LP
164.337 @@ -302,20 +321,43 @@
164.338
164.339 .LP
164.340 .LP
164.341 -ユーザ許容プロンプトのように関連付けをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
164.342 +若吟取┗絎鴻潟∫dゃ潟鴻若障激с潟\f2\-silent\fP 激с潟筝膩篏睡号障
164.343 .LP
164.344 .RE
164.345 .RE
164.346 -.SS
164.347 -.SH ファイル
164.348 +.SS
164.349 +<ゃ
164.350 .LP
164.351 -ユーザキャッシュ、システムキャッシュ、および deployment.properties ファイルの詳細は、
164.352 +.RS 3
164.353 +
164.354 +.LP
164.355 +.LP
164.356 +若吟若c激ャ激鴻c激ャ deployment.properties <ゃゃ
164.357 .na
164.358 -「\f2System\- and User\-Level Properties\fP」
164.359 +\f2激鴻潟若吟若c\fP @
164.360 .fi
164.361 -(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html)
164.362 -を参照してください。
164.363 -.SH 詳細情報
164.364 -Java Web Start の詳細は、
164.365 -http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html
164.366 -を参照してください。
164.367 +http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlс
164.368 +.LP
164.369 +.RE
164.370 +.SS
164.371 +荅括完
164.372 +.LP
164.373 +.RS 3
164.374 +
164.375 +.LP
164.376 +.LP
164.377 +Java Web Start 荅括完
164.378 +.na
164.379 +\f2Java Web Start\fP @
164.380 +.fi
164.381 +http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlс
164.382 +.LP
164.383 +.RS 3
164.384 +
164.385 +.LP
164.386 +.LP
164.387 +\
164.388 +.LP
164.389 +.RE
164.390 +.RE
164.391 +
165.1 --- a/src/solaris/doc/sun/man/man1/ja/jconsole.1 Tue May 12 15:21:55 2009 +0900
165.2 +++ b/src/solaris/doc/sun/man/man1/ja/jconsole.1 Thu May 14 00:17:25 2009 -0700
165.3 @@ -1,29 +1,51 @@
165.4 -'\" t
165.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
165.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
165.7 -.\"
165.8 -.\" This code is free software; you can redistribute it and/or modify it
165.9 -.\" under the terms of the GNU General Public License version 2 only, as
165.10 -.\" published by the Free Software Foundation.
165.11 -.\"
165.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
165.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
165.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
165.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
165.16 -.\" accompanied this code).
165.17 -.\"
165.18 -.\" You should have received a copy of the GNU General Public License version
165.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
165.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
165.21 -.\"
165.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
165.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
165.24 -.\" have any questions.
165.25 -.\" `
165.26 -.TH "jconsole" 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
165.27 -.SH 名前
165.28 -jconsole \- Java 監視/管理コンソール
165.29 -.SH 形式
165.30 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
165.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
165.32 +."
165.33 +." This code is free software; you can redistribute it and/or modify it
165.34 +." under the terms of the GNU General Public License version 2 only, as
165.35 +." published by the Free Software Foundation.
165.36 +."
165.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
165.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
165.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
165.40 +." version 2 for more details (a copy is included in the LICENSE file that
165.41 +." accompanied this code).
165.42 +."
165.43 +." You should have received a copy of the GNU General Public License version
165.44 +." 2 along with this work; if not, write to the Free Software Foundation,
165.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
165.46 +."
165.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
165.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
165.49 +." have any questions.
165.50 +."
165.51 +.TH jconsole 1 "04 May 2009"
165.52 +." Generated from HTML by html2man (author: Eric Armstrong)
165.53 +
165.54 +.LP
165.55 +.SH ""
165.56 +jconsole \- Java h括∞潟潟純若
165.57 +.LP
165.58 +.RS 3
165.59 +.TP 2
165.60 +o
165.61 +綵√
165.62 +.TP 2
165.63 +o
165.64 +<若
165.65 +.TP 2
165.66 +o
165.67 +茯
165.68 +.TP 2
165.69 +o
165.70 +激с
165.71 +.TP 2
165.72 +o
165.73 +∫i
165.74 +.RE
165.75 +
165.76 +.LP
165.77 +.SH "綵√"
165.78 .LP
165.79
165.80 .LP
165.81 @@ -37,49 +59,63 @@
165.82 .fi
165.83
165.84 .LP
165.85 -.SH "パラメータ"
165.86 +.SH "<若"
165.87 .LP
165.88
165.89 .LP
165.90 +.RS 3
165.91 .TP 3
165.92 -options
165.93 -オプションを使用する場合、コマンド名の直後に記述してください。
165.94 -.TP
165.95 +options
165.96 +激с潟篏睡翫潟潟翫荐菴違
165.97 +.br
165.98 +.TP 3
165.99 connection = pid | host:port | jmxUrl
165.100 +.RS 3
165.101 +\f2pid\fP\ \ \ 若 Java VM 祉 IDJava VM jconsole 絎茵若吟 ID 若吟 ID 篏睡絎茵綽荀障荅括完ゃ
165.102 +.na
165.103 +\f2JMX h括∞\fP @
165.104 +.fi
165.105 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
165.106 +.br
165.107 +\f2host\fP:\f2port\fP\ \ Java VM 絎茵鴻激鴻JVM 莎桁激鴻c \f2com.sun.management.jmxremote.port\fP ф絎若垩荅括完ゃ
165.108 +.na
165.109 +\f2JMX h括∞\fP @
165.110 +.fi
165.111 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlс
165.112 +.br
165.113 +\f2jmxUrl\fP ・膓 JMX 若吾с潟≪鴻 ゃ
165.114 +.na
165.115 +\f2JMXServiceURL\fP @
165.116 +.fi
165.117 +http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html с
165.118 +.RE
165.119 +.RE
165.120 +
165.121 .LP
165.122 -\f2pid\fP\ \ \ ローカルの Java VM のプロセス ID。この Java VM は、jconsole を実行しているユーザ ID と同じユーザ ID で実行されている必要があります。詳細については、
165.123 -.na
165.124 -「\f2JMX Monitoring and Management\fP」
165.125 -.fi
165.126 -(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
165.127 +.SH " 茯"
165.128 .LP
165.129 -\f2host\fP:\f2port\fP\ \ Java VM が実行されているホストシステムの名前と、その Java VM の起動時にシステムプロパティ \f2com.sun.management.jmxremote.port\fP に指定されたポート番号。詳細については、
165.130 -.na
165.131 -「\f2JMX Monitoring and Management\fP」
165.132 -.fi
165.133 -(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
165.134 +
165.135 .LP
165.136 -\f2jmxUrl\fP\ \ 接続先の JMX エージェントのアドレス。これについては、
165.137 -.na
165.138 -「\f2JMXServiceURL\fP」
165.139 -.fi
165.140 -(http://java.sun.com/javase/6/docs/api/javax/management/remote/jmxserviceurl.html) を参照してください。
165.141 .LP
165.142 -.SH 機能説明
165.143 +\f3jconsole\fP 潟潟若激潟障≪若激割 Java ≪宴若激с潟篁潟激潟h膊∞茵違c潟潟純若若莎桁障
165.144 +.LP
165.145 +.LP
165.146 +Windows 筝с\f3jconsole\fP 潟潟純若c潟∫d障宴 \f3jconsole\fP 潟潟紊掩惹宴腓冴ゃ≪違鴻茵腓冴障
165.147 +.LP
165.148 +.SH "激с"
165.149 +.LP
165.150
165.151 -.B jconsole
165.152 -コマンドは、ローカルまたはリモートマシン上の Java アプリケーションと仮想マシンを監視および管理するためのグラフィカルコンソールツールを起動します。
165.153 .LP
165.154 -.SH オプション
165.155 -.TP 15
165.156 -.B \-interval=n
165.157 -更新間隔を n 秒に設定します。(デフォルトは 4 秒)
165.158 -.TP
165.159 -.B \-notile
165.160 -初期状態でウィンドウを並べて表示しません。(接続が 2 つ以上ある場合)
165.161 +.RS 3
165.162 +.TP 3
165.163 +\-interval=n
165.164 +贋育 \f2n\fP 腱荐絎障 ( 4 腱)
165.165 +.TP 3
165.166 +\-notile\
165.167 +c潟帥ゃ潟違障 (茲違・膓)
165.168 .TP 3
165.169 \-pluginpath\ plugins
165.170 -JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
165.171 +JConsole 違ゃ潟罎膣√c障 JAR <ゃ鴻絎障\f2plugins\fP 鴻罨<ゃ罕<ゃ
165.172 .br
165.173 .nf
165.174 \f3
165.175 @@ -89,38 +125,38 @@
165.176 \fP
165.177 .fi
165.178 .LP
165.179 -これには、
165.180 +
165.181 .na
165.182 -\f2com.sun.tools.jconsole.JConsolePlugin\fP
165.183 +\f2com.sun.tools.jconsole.JConsolePlugin\fP @
165.184 .fi
165.185 -(http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/jconsoleplugin.html) クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
165.186 -.TP
165.187 -.B \-version
165.188 -バージョン情報を出力して終了します。
165.189 -.TP
165.190 -.B \-help
165.191 -ヘルプメッセージを出力して終了します。
165.192 +http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html 鴻絎茖鴻絎篆蕋障劫絎茵違ゃ潟 1 茵ゅ障障
165.193 +.TP 3
165.194 +\-version\
165.195 +若吾с恰宴阪腟篋障
165.196 +.TP 3
165.197 +\-help\
165.198 +<祉若吾阪腟篋障
165.199 .TP 3
165.200 \-J<flag>\
165.201 -jconsole が実行されている Java 仮想マシンに <flag> を渡します。
165.202 +jconsole 絎茵 Java 篁潟激潟 <flag> 羝<障
165.203 +.RE
165.204 +
165.205 .LP
165.206 -.SH "関連項目"
165.207 +.SH "∫i"
165.208 .LP
165.209 .RS 3
165.210 .TP 2
165.211 -*
165.212 +o
165.213 +.na
165.214 +\f2jconsole 篏睡\fP @
165.215 .fi
165.216 http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
165.217 -の
165.218 +.TP 2
165.219 +o
165.220 .na
165.221 -「\f2Using JConsole\fP」
165.222 -.TP 2
165.223 -*
165.224 +\f2Java 若h括∞\fP @
165.225 .fi
165.226 http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
165.227 -の
165.228 -.na
165.229 -「\f2Monitoring and Management for Java Platform\fP」
165.230 .RE
165.231
165.232 .LP
166.1 --- a/src/solaris/doc/sun/man/man1/ja/jdb.1 Tue May 12 15:21:55 2009 +0900
166.2 +++ b/src/solaris/doc/sun/man/man1/ja/jdb.1 Thu May 14 00:17:25 2009 -0700
166.3 @@ -1,107 +1,101 @@
166.4 -'\" t
166.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
166.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
166.7 -.\"
166.8 -.\" This code is free software; you can redistribute it and/or modify it
166.9 -.\" under the terms of the GNU General Public License version 2 only, as
166.10 -.\" published by the Free Software Foundation.
166.11 -.\"
166.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
166.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
166.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
166.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
166.16 -.\" accompanied this code).
166.17 -.\"
166.18 -.\" You should have received a copy of the GNU General Public License version
166.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
166.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
166.21 -.\"
166.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
166.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
166.24 -.\" have any questions.
166.25 -.\" `
166.26 -.\"
166.27 -.\" This document was created by saving an HTML file as text
166.28 -.\" from the JavaSoft web site:
166.29 -.\"
166.30 -.\" http://java.sun.com/j2se/1.4/docs/tooldocs/tools.html
166.31 -.\"
166.32 -.\" and adding appropriate troff macros. Because the JavaSoft web site
166.33 -.\" man pages can change without notice, it may be helpful to diff
166.34 -.\" files to identify changes other than new functionality.
166.35 -.\"
166.36 -.TH jdb 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
166.37 -.SH "名前"
166.38 -jdb \- Java デバッガ
166.39 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
166.40 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
166.41 +."
166.42 +." This code is free software; you can redistribute it and/or modify it
166.43 +." under the terms of the GNU General Public License version 2 only, as
166.44 +." published by the Free Software Foundation.
166.45 +."
166.46 +." This code is distributed in the hope that it will be useful, but WITHOUT
166.47 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
166.48 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
166.49 +." version 2 for more details (a copy is included in the LICENSE file that
166.50 +." accompanied this code).
166.51 +."
166.52 +." You should have received a copy of the GNU General Public License version
166.53 +." 2 along with this work; if not, write to the Free Software Foundation,
166.54 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
166.55 +."
166.56 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
166.57 +." CA 95054 USA or visit www.sun.com if you need additional information or
166.58 +." have any questions.
166.59 +."
166.60 +.TH jdb 1 "04 May 2009"
166.61 +." Generated from HTML by html2man (author: Eric Armstrong)
166.62 +
166.63 +.LP
166.64 +.SH ""
166.65 +jdb \- Java
166.66 +.LP
166.67 +.RS 3
166.68 +
166.69 +.LP
166.70 +.LP
166.71 +\f3jdb\fP Java 荐茯違違荀ゃ篆罩c篏睡若с
166.72 +.LP
166.73 +.RE
166.74 +.SH "綵√"
166.75 .LP
166.76
166.77 .LP
166.78 +.nf
166.79 +\f3
166.80 +.fl
166.81 +\fP\f3jdb\fP [ options ] [ class ] [ arguments ]
166.82 +.fl
166.83 +.fi
166.84 +
166.85 .LP
166.86 -\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
166.87 +.RS 3
166.88 +
166.89 .LP
166.90 -.SH "形式"
166.91 -.B jdb
166.92 -[
166.93 -.I options
166.94 -] [
166.95 -.I class
166.96 -] [
166.97 -.I arguments
166.98 -]
166.99 +.RS 3
166.100 +.TP 3
166.101 +options
166.102 +罨<腓冴潟潟茵激с
166.103 +.TP 3
166.104 +class
166.105 +違紮鴻
166.106 +.TP 3
166.107 +arguments
166.108 +\f2class\fP \f2main()\fP <純羝<綣
166.109 +.RE
166.110 +
166.111 .LP
166.112 -.TP 15
166.113 -.I options
166.114 -以下に指定するコマンド行オプション
166.115 -.TP
166.116 -.I class
166.117 -デバッグを開始するクラス名
166.118 -.TP
166.119 -.I arguments
166.120 -クラスの
166.121 -.B main(\|)
166.122 -メソッドに渡される引数
166.123 -.SH "機能説明"
166.124 -.IX "Java debugger" "" "Java debugger \(em \fLjdb\fP"
166.125 -.IX "jdb" "" "\fLjdb\fP \(em Java debugger"
166.126 -Java デバッガの
166.127 -.BR jdb
166.128 -は、
166.129 -Java
166.130 -クラス用の単純なコマンド行デバッガです。
166.131 +.RE
166.132 +.SH " 茯"
166.133 +.LP
166.134 +
166.135 +.LP
166.136 +.LP
166.137 +Java \f3jdb\fP Java 合膂≦潟潟茵с
166.138 .na
166.139 -「\f2Java Platform Debugger Architecture\fP」
166.140 +\f2Java Platform Debugger Architecture\fP @
166.141 .fi
166.142 - (http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html)
166.143 -を画面に表示しながら実行し、ローカルまたはリモートの Java 仮想マシン
166.144 -の検査とデバッグを行うことができます。
166.145 -.SS "jdb セッションの開始"
166.146 -.IX "jdb" "Starting a jdb Session" "\fLjdb\fP \(em Java debugger"
166.147 -jdb セッションを開始するにはさまざまな方法があります。 もっとも頻繁に使
166.148 -われるのは、アプリケーションのメインクラスをデバッグして、
166.149 -.B jdb
166.150 -から新しく Java 仮想マシン (VM) を起動する方法です。 コマンド行で、
166.151 -.BR java (1)
166.152 -の代わりに
166.153 -.B jdb
166.154 -コマンドを入力します。たとえば、アプリケーションのメインクラスが
166.155 -.BR MyClass
166.156 -の場合は、次のコマンドを使用して jdb 環境でデバッグします。
166.157 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html 荀荀絎茵若障≪若 Java Virtual Machine 罎祉違茵с障
166.158 .LP
166.159 -.RS
166.160 -.B % jdb MyClass
166.161 -.RE
166.162 +.SS
166.163 +jdb 祉激с潟紮
166.164 .LP
166.165 -このようにして起動すると、
166.166 -.B jdb
166.167 -は 2 つ目の Java VM を呼び出し、指定されたパラメータを渡し、
166.168 -指定されたクラスをロードします。そのあと、
166.169 -クラスの最初の命令を実行する前に VM を停止させます。
166.170 +.RS 3
166.171 +
166.172 .LP
166.173 -.B jdb
166.174 -のもう 1 つの使用方法は、すでに起動している Java VM に
166.175 -.B jdb
166.176 -を接続することです。
166.177 -jdb が接続する VM を、その実行中に起動するための構文を次に示します。 これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
166.178 +.LP
166.179 +jdb 祉激с潟紮障障号障c紫篏帥違≪宴若激с潟<ゃ潟鴻篏睡\f3jdb\fP 違 Java 篁潟激 (VM) 莎桁号с潟潟茵с \f3java\fP 篁c \f3jdb\fP 潟潟ュ障違≪宴若激с潟<ゃ潟鴻 MyClass 翫JDB 医с違罨<潟潟篏睡障
166.180 +.LP
166.181 +.nf
166.182 +\f3
166.183 +.fl
166.184 + % jdb MyClass
166.185 +.fl
166.186 +\fP
166.187 +.fi
166.188 +
166.189 +.LP
166.190 +.LP
166.191 +号ц儀\f3jdb\fP 絎<若帥篏帥c 2 ょ Java VM 若喝冴障 罨<絎鴻若鴻巡擦絎茵 VM 罩≪障
166.192 +.LP
166.193 +.LP
166.194 +\f3jdb\fP 1 ゃ篏睡号с莎桁 Java VM jdb ・膓сjdb ・膓 VM 絎茵筝莎桁罕罨<腓冴障ゃ潟祉鴻亥ゃ若・膓腮蕁絎障
166.195 .LP
166.196 .nf
166.197 \f3
166.198 @@ -113,11 +107,7 @@
166.199
166.200 .LP
166.201 .LP
166.202 -たとえば、次のコマンドは
166.203 -.B MyClass
166.204 -アプリケーションを実行し、後で
166.205 -.B jdb
166.206 -を接続できるようにします。
166.207 +違罨<潟潟MyClass ≪宴若激с潟絎茵\f3jdb\fP с≪宴若激с潟・膓с障
166.208 .LP
166.209 .nf
166.210 \f3
166.211 @@ -129,375 +119,250 @@
166.212
166.213 .LP
166.214 .LP
166.215 -次のコマンドで
166.216 -.B jdb
166.217 -を VM に接続できます。
166.218 +罨<潟潟篏睡\f3jdb\fP VM ・膓с障
166.219 .LP
166.220 -.RS
166.221 -.B % jdb \-attach 8000
166.222 -.RE
166.223 -.LP
166.224 -このとき、
166.225 -.B jdb
166.226 -は新しい VM を起動するのではなく、既存の VM に接続するので、
166.227 -.B jdb
166.228 -コマンド行で
166.229 -.B MyClass
166.230 -を指定しないことに注意してください。
166.231 -.LP
166.232 -これ以外にもデバッガ (jdb) を VM に接続する方法はたくさんあり、
166.233 -.BR jdb
166.234 -はそのすべての方法をサポートしています。
166.235 -このような接続オプションについては、
166.236 +.nf
166.237 +\f3
166.238 +.fl
166.239 + % jdb \-attach 8000
166.240 +.fl
166.241 +\fP
166.242 .fi
166.243 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
166.244 -で Java Platform Debugger Architecture のマニュアルを参照してください。
166.245 -\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
166.246 -.fi
166.247 -http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
166.248 -の 1.4.2 のドキュメントを参照してください。
166.249 -.SS " jdb 基本コマンド"
166.250 -.IX "jdb" "Basic jdb Commands" "\fLjdb\fP \(em Java debugger"
166.251 -以下に
166.252 -.B jdb
166.253 -基本コマンドの一覧を示します。
166.254 -Java
166.255 -デバッガで使用可能なその他のコマンドは、
166.256 -.B help
166.257 -コマンドで表示できます。
166.258 -.TP 15
166.259 -.B help または ?
166.260 -.BR jdb
166.261 -のコマンドの中でもっとも重要なのが、この
166.262 -.B help
166.263 -コマンドです。利用可能なコマンドの一覧を、
166.264 -各コマンドの簡単な説明つきで表示します。
166.265 -.TP 15
166.266 -.B run
166.267 -.BR jdb
166.268 -を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、
166.269 -デバッグするアプリケーションの実行を開始します。このコマンドは、
166.270 -デバッグするアプリケーションを
166.271 -.B jdb
166.272 -から起動するときにだけ使用できます。
166.273 -既存の VM に接続する場合とは異なります。
166.274 -.TP
166.275 -.B cont
166.276 -ブレークポイント、例外、またはステップ実行のあとで、デバッグ中の
166.277 -アプリケーションの実行を継続します。
166.278 -.TP 15
166.279 -.B print
166.280 -Java オブジェクトおよびプリミティブ値を表示します。 プリミティブ型の変数
166.281 -またはフィールドの場合には、実際の値を出力します。 オブジェクトの場合
166.282 -には、短い説明を出力します。 オブジェクトについては、以降の
166.283 -.B dump
166.284 -コマンドの説明を参照してください。
166.285 -.sp 1n
166.286 -.LP
166.287 -注: 局所
166.288 -(スタック)
166.289 -変数をブラウズするには、そのクラスが
166.290 -.B javac \-g
166.291 -オプションでコンパイルされている必要があります。
166.292 -.sp 1n
166.293 -.LP
166.294 -.B print
166.295 -は、メソッドの呼び出しを含む多数の簡単な Java 式をサポートします。
166.296 -次に例を示します。
166.297 -.RS
166.298 -.TP 3
166.299 -\(bu
166.300 -.B print MyClass.myStaticField
166.301 -.PD 0
166.302 -.TP
166.303 -\(bu
166.304 -.B print myObj.myInstanceField
166.305 -.TP
166.306 -\(bu
166.307 -\f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 (
166.308 -.IR i、
166.309 -.IR j 、
166.310 -および
166.311 -.I k
166.312 -はプリミティブであり、フィールドまたは局所変数のいずれか)
166.313 -.TP
166.314 -\(bu
166.315 -\f3print myObj.myMethod(\|)\f1 (
166.316 -.B myMethod
166.317 -が null 以外を返す場合)
166.318 -.TP
166.319 -\(bu
166.320 -.B print new java.lang.String("Hello").length(\|)
166.321 -.RE
166.322 -.PD
166.323 -.TP
166.324 -.B dump
166.325 -プリミティブ値の場合には、このコマンドは
166.326 -.BR print
166.327 -と同じです。オブジェクトの場合には、オブジェクト内に定義されている
166.328 -各フィールドの現在の値を出力します。 static フィールドと instance
166.329 -フィールドを出力します。
166.330 -.sp 1n
166.331 -.LP
166.332 -.B dump
166.333 -コマンドは、
166.334 -.B print
166.335 -コマンドと同じ式をサポートします。
166.336 -.TP
166.337 -.B threads
166.338 -現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、
166.339 -およびほかのコマンドに使用できるインデックスを出力します。次に例を
166.340 -示します。
166.341 -.sp 1n
166.342 -.RS 20
166.343 -.LP
166.344 -.B 4. (java.lang.Thread)0x1 main running
166.345 -.RE
166.346 -.RS
166.347 -.sp 1n
166.348 -.LP
166.349 -この例では、スレッドインデックスは
166.350 -.BR 4
166.351 -であり、スレッドは
166.352 -.BR java.lang.Thread
166.353 -のインスタンスです。スレッドの名前は「
166.354 -.BR main
166.355 -」であり、現在実行中です。
166.356 -.RE
166.357 -.TP 15
166.358 -.B thread
166.359 -現在のスレッドを選択します。 多くの
166.360 -.B jdb
166.361 -コマンドは、現在のスレッドの設定に基づいて実行されます。 スレッドは、
166.362 -.B threads
166.363 -コマンドで説明するスレッドインデックスとともに指定します。
166.364 -.TP 15
166.365 -.B where
166.366 -引数のない
166.367 -.B where
166.368 -コマンドは、現在のスレッド
166.369 -(
166.370 -.B thread
166.371 -コマンドで設定)
166.372 -のスタックをダンプします。
166.373 -.B where all
166.374 -と指定すると、現在のスレッドグループにある全スレッドの
166.375 -スタックをダンプします。
166.376 -.BI where " threadindex"
166.377 -と指定すると、
166.378 -.I threadindex
166.379 -が示すスレッドのスタックだけをダンプします。
166.380 -.sp 1n
166.381 -.LP
166.382 -現在のスレッドが (ブレークポイントなどのイベントや
166.383 -.B suspend
166.384 -コマンドで) 中断している場合、
166.385 -.B print
166.386 -コマンドや
166.387 -.B dump
166.388 -コマンドを使用すれば、局所変数やフィールドを表示できます。
166.389 -どのスタックフレームを現在のフレームにするかは、
166.390 -.B up
166.391 -および
166.392 -.B down
166.393 -コマンドで選択できます。
166.394 -.SS "ブレークポイント用コマンド"
166.395 -.IX "jdb" "Breakpoints" "\fLjdb\fP \(em Java debugger"
166.396 -.B jdb
166.397 -では、ブレークポイントを行番号で、
166.398 -またはメソッドの最初の命令で
166.399 -設定できます。次に例を示します。
166.400 -.TP 25
166.401 -.B stop at MyClass:22
166.402 -.BR MyClass
166.403 -が含まれるソースファイルの
166.404 -.B 22
166.405 -行目の最初の命令にブレークポイントを設定する
166.406 -.TP
166.407 -.B stop in java.lang.String.length
166.408 -.BR java.lang.String.length
166.409 -メソッドの最初にブレークポイントを設定する
166.410 -.TP
166.411 -.BI "stop in MyClass." init
166.412 -.I init
166.413 -は
166.414 -.B MyClass
166.415 -コンストラクタを識別する
166.416 -.TP
166.417 -.BI "stop in MyClass." clinit
166.418 -.I clinit
166.419 -は
166.420 -.BR MyClass
166.421 -の静的な初期化コードを識別する
166.422 -.LP
166.423 -メソッドがオーバーロードされる場合には、メソッドの引数の型も指定して、
166.424 -ブレークポイントに対して適切なメソッドが選択されるようにしなければなりませ
166.425 -ん。 たとえば、次のように指定します。
166.426 -.LP
166.427 -.RS 15
166.428 -.B MyClass.myMethod(int,java.lang.String)
166.429 -.RE
166.430 -.LP
166.431 -または
166.432 -.LP
166.433 -.RS 15
166.434 -.B MyClass.myMethod()
166.435 -.RE
166.436 -.LP
166.437 -.B clear
166.438 -コマンドは、「
166.439 -.BR clear MyClass:45
166.440 -」のような構文を使用してブレークポイントを削除します。
166.441 -引数を指定しないで
166.442 -.B clear
166.443 -コマンドを使用すると、現在設定されてい
166.444 -るすべてのブレークポイントが表示されます。
166.445 -.B cont
166.446 -コマンドで実行が継続します。
166.447 -.SS "コマンドのステップ実行"
166.448 -.IX "jdb" "Stepping" "\fLjdb\fP \(em Java debugger"
166.449 -.B step
166.450 -コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、
166.451 -次の行を実行します。
166.452 -.B next
166.453 -コマンドは、現在のスタックフレームの次の行を
166.454 -実行します。
166.455 -.SS "例外処理用コマンド"
166.456 -.IX "jdb" "Exceptions" "\fLjdb\fP \(em Java debugger"
166.457 -スローしているスレッドの呼び出しスタック上のどこにも catch 文がないような
166.458 -例外が発生すると、VM は通常、例外トレースを出力して終了します。 ただし、
166.459 -.BR jdb
166.460 -環境で実行している場合は、このような例外が発生すると
166.461 -.B jdb
166.462 -に制御が戻ります。 次に、
166.463 -.BR jdb
166.464 -を使用して例外の原因を診断します。
166.465 -.TP 15
166.466 -.B catch
166.467 -デバッグ中のアプリケーションは他の例外がスローされたところで停止します。
166.468 -次に例を示します。
166.469 -.LP
166.470 -.RS 20
166.471 -.B catch java.io.FileNotFoundException
166.472 -.RE
166.473 -.sp 1n
166.474 -.RS 15
166.475 -または
166.476 -.RE
166.477 -.LP
166.478 -.RS 20
166.479 -.B catch mypackage.BigTroubleException
166.480 -.RE
166.481 -.sp 1n
166.482 -.RS 15
166.483 -例外が指定したクラス (または、サブクラス) のインスタンスである場合、
166.484 -アプリケーションはスローされたところで停止します。
166.485 -.RE
166.486 -.TP 15
166.487 -.B ignore
166.488 -以前の
166.489 -.B catch
166.490 -コマンドの効果を無効にします。なお、この指定によって例外を無視するのは
166.491 -デバッガだけであり、デバッグされた VM は無視しません。
166.492 -.SH "コマンド行オプション"
166.493 -コマンド行で Java アプリケーション起動ツールの代わりに
166.494 -.B jdb
166.495 -を使用する場合、
166.496 -.B jdb
166.497 -は、
166.498 -.BR \-D、
166.499 -.BR \-classpath、
166.500 -.BI \-X option\f1
166.501 -など、
166.502 -.BR java (1)
166.503 -コマンドと同じオプションを多数使用できます。
166.504 -.LP
166.505 -.B jdb
166.506 -は、そのほかに次のオプションも使用できます。
166.507 -.TP 3
166.508 -.BI \-help
166.509 -ヘルプメッセージを表示します。
166.510 -.TP 3
166.511 -.BI \-sourcepath " dir1\f1:\f2dir2\f1:..."
166.512 -指定されたパスで、ソースファイルを検索します。 このオプションが
166.513 -指定されていない場合は、デフォルトパスの「.」を検索します。
166.514 -.TP
166.515 -.BI \-attach " address"
166.516 -デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続
166.517 -します。
166.518 -.TP
166.519 -.BI \-listen " address"
166.520 -実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
166.521 -.TP
166.522 -.BI \-listenany
166.523 -実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
166.524 -.TP
166.525 -.B \-launch
166.526 -デバッグするアプリケーションを
166.527 -.BR jdb
166.528 -の起動後ただちに起動します。 このオプションを使用すると、
166.529 -.B run
166.530 -コマンドを使用する必要はありません。 デバッグするアプリケーションは、
166.531 -起動後、最初のアプリケーションクラスがロードされる直前に停止します。
166.532 -その時点で、必要なブレークポイントを設定できます。
166.533 -実行を継続するには
166.534 -.B cont
166.535 -コマンドを使用します。
166.536 -.TP 3
166.537 -\-listconnectors
166.538 -この VM で利用できるコネクタを一覧表示します。
166.539 -.TP 3
166.540 -\-connect
166.541 -<connector\-name>:<name1>=<value1>,...
166.542 -一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
166.543 -.TP 3
166.544 -\-dbgtrace [flags]
166.545 -jdb のデバッグ情報を出力します。
166.546 -.TP 3
166.547 -\-tclient
166.548 -Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
166.549 -.TP 3
166.550 -\-tserver
166.551 -Java HotSpot(tm) VM (サーバ) 内でアプリケーションを実行します。
166.552 -.TP
166.553 -.BI \-J "option"
166.554 -jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される。)
166.555 -たとえば、
166.556 -.I \-J-Xms48m
166.557 -は、起動時に使用するメモリを 48M バイトに設定します。
166.558 -
166.559
166.560 .LP
166.561 -これ以外にも、デバッガをデバッグされる VM に接続するための代替機構
166.562 -用のオプションがサポートされています。
166.563 -このような接続の代替機構については、
166.564 +.LP
166.565 +翫\f3jdb\fP 違 VM 莎桁篁c√ VM ・膓\f3jdb\fP 潟潟茵MyClass絎障
166.566 +.LP
166.567 +.LP
166.568 + VM ・膓祉障障号鴻 \f3jdb\fP с泣若障・膓激с潟ゃJava Platform Debugger Architecture
166.569 +.na
166.570 +\f2ャ<潟\fP @
166.571 .fi
166.572 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
166.573 -の Java Platform Debugger Architecture のマニュアルを参照してください。
166.574 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс\f3jdb\fP т戎 J2SE 1.4.2 篁ュ VM 莎桁号ゃ
166.575 +.na
166.576 +\f21.4.2 ャ<潟\fP @
166.577 +.fi
166.578 +http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlс
166.579 .LP
166.580 .SS
166.581 -デバッグ対象のプロセスに転送されるオプション
166.582 +堺 jdb 潟潟
166.583 .LP
166.584 +.LP
166.585 +堺 \f3jdb\fP 潟潟筝荀с腓冴障Java 泣若潟潟篁ュ \f3jdb\fP \f2help\fP 潟潟篏睡茵腓冴с障
166.586 +.LP
166.587 +.RS 3
166.588 +
166.589 +.LP
166.590 +.RS 3
166.591 .TP 3
166.592 -\-v \-verbose[:class|gc|jni]
166.593 -冗長モードにします。
166.594 +help 障 ?
166.595 +c荀 \f3jdb\fP 潟潟 \f2help\fP 茯茘潟潟鴻膂≧茯篁茵腓冴障
166.596 .TP 3
166.597 -\-D<name>=<value>
166.598 -システムプロパティを設定します。
166.599 +run
166.600 +\f3jdb\fP 莎桁綽荀若ゃ潟荐絎潟潟篏睡違≪宴若激с潟絎茵紮с障潟潟√ VM ・膓翫違違≪宴若激с潟 \f3jdb\fP 莎桁篏睡с障
166.601 .TP 3
166.602 -\-classpath <directories separated by
166.603 -":">
166.604 -クラスを検索するディレクトリを一覧表示します。
166.605 +cont
166.606 +若ゃ潟箴紊障鴻絎茵с違≪宴若激с潟絎茵膓膓障
166.607 .TP 3
166.608 -\-X<option>
166.609 -非標準ターゲット VM オプションです。
166.610 +print
166.611 +Java 吾с潟cゃ茵腓冴障c紊違障c若翫絎ゃ阪障吾с翫茯阪障吾сゃ篁ラ \f2dump\fP 潟潟茯с
166.612 .LP
166.613 -.SH "関連項目"
166.614 +\f2羈:絮紊違茵腓冴紊違鴻 \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP 激с潟с潟潟ゃ違障
166.615 +.LP
166.616 +\f2print\fP с<純若喝冴紊違膂≦ Java 綣泣若障 罨<箴腓冴障
166.617 +.RS 3
166.618 +.TP 2
166.619 +o
166.620 +\f2print MyClass.myStaticField\fP
166.621 +.TP 2
166.622 +o
166.623 +\f2print myObj.myInstanceField\fP
166.624 +.TP 2
166.625 +o
166.626 +\f2print i + j + k\fP (ij k cсc若障絮紊違)
166.627 +.TP 2
166.628 +o
166.629 +\f2print myObj.myMethod()\fP (myMethod null 篁ュ菴翫)
166.630 +.TP 2
166.631 +o
166.632 +\f2print new java.lang.String("Hello").length()\fP
166.633 +.RE
166.634 +.TP 3
166.635 +dump
166.636 +cゃ翫潟潟 \f2print\fP с吾с翫吾с絎臂c若憜ゃ阪障static c若 instance c若阪障
166.637 +.LP
166.638 +\f2dump\fP 潟潟с\f2print\fP 潟潟綣泣若障
166.639 +.TP 3
166.640 +threads
166.641 +憜絎茵筝鴻筝荀ц;腓冴障鴻憜倶潟祉潟潟篏睡сゃ潟鴻阪障 罨<箴腓冴障
166.642 +.RS 3
166.643 +
166.644 +.LP
166.645 +.nf
166.646 +\f3
166.647 +.fl
166.648 +4. (java.lang.Thread)0x1 main running
166.649 +.fl
166.650 +\fP
166.651 +.fi
166.652 +.RE
166.653 +箴с鴻ゃ潟鴻 4 с鴻 java.lang.Thread ゃ潟鴻帥潟鴻с 鴻mainс憜絎茵筝с
166.654 +.TP 3
166.655 +thread
166.656 +憜鴻鴻御障紊 \f3jdb\fP 潟潟憜鴻荐絎冴ャ絎茵障鴻\f2threads\fP 潟潟ц鴻ゃ潟鴻絎障
166.657 +.TP 3
166.658 +where
166.659 +綣違絎 \f2where\fP 絎茵憜鴻鴻帥潟障 \f2where all\fP 潟潟憜鴻違若鴻鴻帥鴻潟障 \f2where\fP \f2threadindex\fP 絎鴻鴻帥潟障
166.660 +.LP
166.661 +憜鴻 (若ゃ潟 \f2suspend\fP 潟潟c) 筝翫絮紊違c若 \f2print\fP 潟潟 \f2dump\fP 潟潟ц;腓冴с障\f2up\fP 潟潟 \f2down\fP 潟潟с鴻帥若潟吾吟с障
166.662 +.RE
166.663 +
166.664 +.LP
166.665 +.RE
166.666 +.SS
166.667 +若ゃ潟
166.668 +.LP
166.669 +.RS 3
166.670 +
166.671 +.LP
166.672 +.LP
166.673 +若ゃ潟茵垩障<純巡擦 \f3jdb\fP 荐絎с障 罨<箴腓冴障
166.674 +.LP
166.675 +.RS 3
166.676 +.TP 2
166.677 +o
166.678 +\f2stop at MyClass:22\fP (MyClass 障純若鴻<ゃ 22 茵巡擦若ゃ潟荐絎)
166.679 +.TP 2
166.680 +o
166.681 +\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP <純若ゃ潟荐絎)
166.682 +.TP 2
166.683 +o
166.684 +\f2stop in MyClass.<init>\fP (<init> MyClass 潟潟鴻帥茘)
166.685 +.TP 2
166.686 +o
166.687 +\f2stop in MyClass.<clinit>\fP (<clinit> MyClass 潟若茘)
166.688 +.RE
166.689 +
166.690 +.LP
166.691 +.LP
166.692 +<純若若若翫<純綣違絎若ゃ潟絲障<純御違障違\f2MyClass.myMethod(int,java.lang.String)\fP障\f2MyClass.myMethod()\fP絎障
166.693 +.LP
166.694 +.LP
166.695 +\f2clear\fP 潟潟\f2clear\ MyClass:45\fP罕篏睡若ゃ潟ゃ障\f2clear\fP 篏睡綣違絎с潟潟篏睡憜荐絎鴻若ゃ潟茵腓冴障\f2cont\fP 潟潟絎茵膓膓障
166.696 +.LP
166.697 +.RE
166.698 +.SS
166.699 +鴻絎茵
166.700 +.LP
166.701 +.RS 3
166.702 +
166.703 +.LP
166.704 +.LP
166.705 +\f2step\fP 潟潟憜鴻帥若障若喝冴<純с罨<茵絎茵障\f2next\fP 潟潟憜鴻帥若罨<茵絎茵障
166.706 +.LP
166.707 +.RE
166.708 +.SS
166.709 +箴紊
166.710 +.LP
166.711 +.RS 3
166.712 +
166.713 +.LP
166.714 +.LP
166.715 +鴻若鴻若喝冴鴻帥筝 catch 翫箴紊榊VM 絽吾箴紊若鴻阪腟篋障\f3jdb\fP 医у茵翫箴紊榊 \f3jdb\fP 九勝祉障罨<\f3jdb\fP 篏睡箴紊荐堺障
166.716 +.LP
166.717 +.LP
166.718 +違\f2catch java.io.FileNotFoundException\fP障\f2catch mypackage.BigTroubleException\fP \f2catch\fP 潟潟篏睡違≪宴若激с潟祉箴紊鴻若罩≪障箴紊劫 (障泣) ゃ潟鴻帥潟鴻翫≪宴若激с潟箴紊鴻若贋у罩≪障
166.719 +.LP
166.720 +.LP
166.721 +\f2ignore\fP 潟潟篏帥篁ュ \f2catch\fP 潟潟号≦鴻障
166.722 +.LP
166.723 +.LP
166.724 +\f2羈:\fP\f2ignore\fP 潟潟с違 VM 箴紊∴箴紊∴障
166.725 +.LP
166.726 +.RE
166.727 +.RE
166.728 +.SH "潟潟茵激с"
166.729 .LP
166.730
166.731 .LP
166.732 .LP
166.733 -javac、java、javah、javap、javadoc
166.734 +潟潟茵 Java ≪宴若激с活儀若篁c \f3jdb\fP 篏睡翫\f3jdb\fP \f2\-D\fP\f2\-classpath\fP\f2\-X<option>\fP java 潟潟違激с潟ャ障
166.735 +.LP
166.736 +.LP
166.737 +\f3jdb\fP 祉罨<激с潟ャ障
166.738 +.LP
166.739 +.RS 3
166.740 +.TP 3
166.741 +\-help
166.742 +<祉若吾茵腓冴障
166.743 +.TP 3
166.744 +\-sourcepath <dir1:dir2:...>
166.745 +絎鴻篏睡純若鴻<ゃ罎膣≪障激с潟絎翫鴻.篏帥障
166.746 +.TP 3
166.747 +\-attach <address>
166.748 +・膓罘罕篏睡с絎茵筝 VM ・膓障
166.749 +.TP 3
166.750 +\-listen <address>
166.751 +絎茵筝 VM 罔羣潟帥篏帥c絎≪鴻・膓緇罘障
166.752 +.TP 3
166.753 +\-listenany
166.754 +絎茵筝 VM 罔羣潟帥篏帥c純篁紙≪鴻・膓緇罘障
166.755 +.TP 3
166.756 +\-launch
166.757 +違≪宴若激с潟 jdb 莎桁緇<莎桁障激с潟c\f2run\fP 潟潟篏睡綽荀障違≪宴若激с潟莎桁緇≪宴若激с潟鴻若翫罩≪障鴻с綽荀若ゃ潟荐絎\f2cont\fP 篏睡絎茵膓膓с障
166.758 +.TP 3
166.759 +\-listconnectors
166.760 + VM ус潟帥筝荀ц;腓冴障
166.761 +.TP 3
166.762 +\-connect <connector\-name>:<name1>=<value1>,...
166.763 +筝荀ц;腓冴綣違ゃ絎潟帥篏帥c帥若蚊 VM ・膓障
166.764 +.TP 3
166.765 +\-dbgtrace [flags]
166.766 +jdb 井宴阪障
166.767 +.TP 3
166.768 +\-tclient
166.769 +Java HotSpot(tm) VM (ゃ≪潟) с≪宴若激с潟絎茵障
166.770 +.TP 3
166.771 +\-tserver
166.772 +Java HotSpot(tm) VM (泣若) с≪宴若激с潟絎茵障
166.773 +.TP 3
166.774 +\-Joption
166.775 +jdb 絎茵篏睡 Java 篁潟激潟 \f2option\fP 羝<障(≪宴若激с Java 篁潟激潟絲障激с潟\f3run\fP 潟潟羝<)違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
166.776 +.RE
166.777 +
166.778 +.LP
166.779 +.LP
166.780 +違茵 VM ・膓篁f炊罕絲障篁激с潟泣若障篁・膓激с潟ゃJava Platform Debugger Architecture
166.781 +.na
166.782 +\f2ャ<潟\fP @
166.783 +.fi
166.784 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlс
166.785 +.LP
166.786 +.SS
166.787 +医乗院祉鴻荵∫激с
166.788 +.LP
166.789 +.RS 3
166.790 +.TP 3
166.791 +\-v \-verbose[:class|gc|jni]
166.792 +激≪若障
166.793 +.TP 3
166.794 +\-D<name>=<value>
166.795 +激鴻c若荐絎障
166.796 +.TP 3
166.797 +\-classpath <directories separated by ":">
166.798 +鴻罎膣≪c筝荀ц;腓冴障
166.799 +.TP 3
166.800 +\-X<option>
166.801 +罔羣帥若蚊 VM 激с潟с
166.802 +.RE
166.803 +
166.804 +.LP
166.805 +.SH "∫i"
166.806 +.LP
166.807 +
166.808 +.LP
166.809 +.LP
166.810 +javac(1)java(1)javah(1)javap(1)javadoc(1)
166.811 .LP
166.812
166.813 .LP
167.1 --- a/src/solaris/doc/sun/man/man1/ja/jhat.1 Tue May 12 15:21:55 2009 +0900
167.2 +++ b/src/solaris/doc/sun/man/man1/ja/jhat.1 Thu May 14 00:17:25 2009 -0700
167.3 @@ -1,4 +1,3 @@
167.4 -.'" t
167.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
167.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
167.7 ."
167.8 @@ -19,15 +18,34 @@
167.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
167.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
167.11 ." have any questions.
167.12 -." `
167.13 -.TH jhat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
167.14 -." Generated by html2roff
167.15 +."
167.16 +.TH jhat 1 "04 May 2009"
167.17 +." Generated from HTML by html2man (author: Eric Armstrong)
167.18
167.19 .LP
167.20 -.SH 名前
167.21 -jhat \- Java ヒープ解析ツール
167.22 +.SH ""
167.23 +jhat \- Java 若茹f若
167.24 .LP
167.25 -.SH "形式"
167.26 +.RS 3
167.27 +.TP 2
167.28 +o
167.29 +綵√
167.30 +.TP 2
167.31 +o
167.32 +<若
167.33 +.TP 2
167.34 +o
167.35 +茯
167.36 +.TP 2
167.37 +o
167.38 +激с
167.39 +.TP 2
167.40 +o
167.41 +∫i
167.42 +.RE
167.43 +
167.44 +.LP
167.45 +.SH "綵√"
167.46 .LP
167.47
167.48 .LP
167.49 @@ -41,107 +59,101 @@
167.50 .fi
167.51
167.52 .LP
167.53 -.SH "パラメータ"
167.54 +.SH "<若"
167.55 .LP
167.56
167.57 .LP
167.58 +.RS 3
167.59 .TP 3
167.60 options
167.61 -オプションを使用する場合、コマンド名の直後に記述してください。
167.62 +激с潟篏睡翫潟潟翫荐菴違
167.63 +.br
167.64 .TP 3
167.65 heap\-dump\-file
167.66 -ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
167.67 +阪乗院 Java ゃ若潟<ゃ茲違若潟潟<ゃ翫foo.hprof#3<ゃ緇#<number>篁с<ゃ劫潟絎с障
167.68 +.SH "茯"
167.69 .LP
167.70 -.SH "説明"
167.71 .LP
167.72 -
167.73 +\f3jhat\fP 潟潟java 若潟<ゃ茹fWeb 泣若若莎桁障 jhat 篏帥違絅純帥 Web 吟篏帥c若潟冴с障 jhat ∝ャ鴻Foo鴻ゃ潟鴻帥潟鴻茵腓冴c篋荐荐祉\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) 泣若障OQL jhat c茵腓冴 OQL 若吾≪祉鴻с障若篏睡翫OQL http://localhost:7000/oqlhelp/ у純с
167.74 .LP
167.75 .LP
167.76 -\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバを起動します。jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。\f3OQL\fP は、ヒープダンプに対するクエリを行うための、SQL に似たクエリ言語です。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
167.77 -.LP
167.78 -.LP
167.79 -Java のヒープダンプを生成するには、いくつかの方法があります。
167.80 +Java 若潟ゃ号障
167.81 .LP
167.82 .RS 3
167.83 .TP 2
167.84 -*
167.85 -jmap の \-dump オプションを使って実行時にヒープダンプを取得する。
167.86 +o
167.87 +jmap(1) \-dump 激с潟篏帥c絎茵若潟緇
167.88 .TP 2
167.89 -*
167.90 -jconsole のオプションを使って
167.91 +o
167.92 +jconsole(1) 激с潟篏帥c
167.93 .na
167.94 -\f2HotSpotDiagnosticMXBean\fP
167.95 +\f2HotSpotDiagnosticMXBean\fP @
167.96 .fi
167.97 -(http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html) 経由で実行時にヒープダンプを取得する。
167.98 +http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 腟宴у茵若潟緇
167.99 .TP 2
167.100 -*
167.101 -\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
167.102 +o
167.103 +\-XX:+HeapDumpOnOutOfMemoryError VM 激с潟絎OutOfMemoryError 鴻惹若潟
167.104 .TP 2
167.105 -*
167.106 -
167.107 +o
167.108 .na
167.109 -\f2hprof\fP
167.110 +\f2hprof\fP @
167.111 .fi
167.112 -(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) を使用する。
167.113 +http://java.sun.com/developer/technicalArticles/Programming/HPROF.html 篏睡
167.114 .RE
167.115
167.116 .LP
167.117 .LP
167.118 -\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
167.119 +\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
167.120 .LP
167.121 -.SH "オプション"
167.122 -.LP
167.123 -
167.124 -.LP
167.125 +.SH "激с"
167.126 +.RS 3
167.127 .TP 3
167.128 \-stack false/true
167.129 -オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
167.130 +吾с蚊綵若喝冴鴻帥菴処掘≦鴻障若潟у蚊綵泣ゃ宴篏睡с翫違 false 荐絎綽荀障 true с
167.131 .TP 3
167.132 \-refs false/true
167.133 -オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。つまり、参照者または受信参照) が計算されます。
167.134 +吾с吾с菴処掘≦鴻障 true сс若鴻吾сゃゃ潟 (絎吾сゃ潟吾с ц障篆≦с若違) 荐膊障
167.135 .TP 3
167.136 \-port port\-number
167.137 -jhat の HTTP サーバのポートを設定します。デフォルトは 7000 です。
167.138 +jhat HTTP 泣若若若荐絎障 7000 с
167.139 .TP 3
167.140 \-exclude exclude\-file
167.141 -「到達可能なオブジェクト」のクエリから除外すべきデータメンバの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
167.142 +育純吾сゅ鴻若帥<潟若筝荀с<ゃ絎障違<ゃ \f2java.lang.String.value\fP 障翫劫吾сo育純吾с鴻荐膊\f2java.lang.String.value\fP c若∫cс鴻障
167.143 .TP 3
167.144 \-baseline baseline\-dump\-file
167.145 -ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
167.146 +若鴻ゃ潟若潟絎障筝≧鴻若潟у吾с ID ゃ吾с域с若障篁吾с域若障違 2 ゃ若潟罸莠綵合<障
167.147 .TP 3
167.148 \-debug int
167.149 -このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
167.150 +若違荐絎障0 医阪潟障紊сゃ荐絎激≪若障
167.151 .TP 3
167.152 \-version\
167.153 -バージョン番号を報告したあと、終了します。
167.154 +若吾с括垩怨腟篋障
167.155 .TP 3
167.156 \-h\
167.157 -ヘルプメッセージを出力したあと、終了します。
167.158 +<祉若吾阪腟篋障
167.159 .TP 3
167.160 \-help\
167.161 -ヘルプメッセージを出力したあと、終了します。
167.162 +<祉若吾阪腟篋障
167.163 .TP 3
167.164 \-J<flag>\
167.165 -jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
167.166 -.LP
167.167 -.SH "関連項目"
167.168 -.LP
167.169 -.RS 3
167.170 -.TP 2
167.171 -*
167.172 -jmap \- Java メモリマップ
167.173 -.TP 2
167.174 -*
167.175 -jconsole \- Java 監視および管理コンソール
167.176 -.TP 2
167.177 -*
167.178 -.na
167.179 -\f2hprof \- ヒープおよび CPU プロファイリングツール\fP
167.180 -.fi
167.181 -(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html)
167.182 +jhat 絎茵 Java 篁潟激潟 <flag> 羝<障違512M ゃ紊с若泣ゃ冴篏睡\-J\-Xmx512m 障
167.183 .RE
167.184
167.185 .LP
167.186 -
167.187 -.LP
167.188 +.SH "∫i"
167.189 +.RS 3
167.190 +.TP 2
167.191 +o
167.192 +jmap(1)
167.193 +.TP 2
167.194 +o
167.195 +jconsole(1)
167.196 +.TP 2
167.197 +o
167.198 +.na
167.199 +\f2hprof \- 若 CPU <ゃ潟違若\fP @
167.200 +.fi
167.201 +http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
167.202 +.RE
167.203 +.RE
167.204
168.1 --- a/src/solaris/doc/sun/man/man1/ja/jinfo.1 Tue May 12 15:21:55 2009 +0900
168.2 +++ b/src/solaris/doc/sun/man/man1/ja/jinfo.1 Thu May 14 00:17:25 2009 -0700
168.3 @@ -1,70 +1,108 @@
168.4 -'\" t
168.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
168.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
168.7 -.\"
168.8 -.\" This code is free software; you can redistribute it and/or modify it
168.9 -.\" under the terms of the GNU General Public License version 2 only, as
168.10 -.\" published by the Free Software Foundation.
168.11 -.\"
168.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
168.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
168.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
168.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
168.16 -.\" accompanied this code).
168.17 -.\"
168.18 -.\" You should have received a copy of the GNU General Public License version
168.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
168.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
168.21 -.\"
168.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
168.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
168.24 -.\" have any questions.
168.25 -.\" `
168.26 -.TH jinfo 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
168.27 -.SH 名前
168.28 -jinfo \- 構成情報
168.29 -.\"
168.30 -.SH 形式
168.31 -.B jinfo
168.32 -.BI [ option ] " pid"
168.33 -.br
168.34 -.B jinfo
168.35 -.BI [ option ] " executable core"
168.36 -.br
168.37 -.B jinfo
168.38 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
168.39 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
168.40 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
168.41 +."
168.42 +." This code is free software; you can redistribute it and/or modify it
168.43 +." under the terms of the GNU General Public License version 2 only, as
168.44 +." published by the Free Software Foundation.
168.45 +."
168.46 +." This code is distributed in the hope that it will be useful, but WITHOUT
168.47 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
168.48 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
168.49 +." version 2 for more details (a copy is included in the LICENSE file that
168.50 +." accompanied this code).
168.51 +."
168.52 +." You should have received a copy of the GNU General Public License version
168.53 +." 2 along with this work; if not, write to the Free Software Foundation,
168.54 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
168.55 +."
168.56 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
168.57 +." CA 95054 USA or visit www.sun.com if you need additional information or
168.58 +." have any questions.
168.59 +."
168.60 +.TH jinfo 1 "04 May 2009"
168.61 +." Generated from HTML by html2man (author: Eric Armstrong)
168.62 +
168.63 .LP
168.64 -.SH パラメータ
168.65 +.SH ""
168.66 +jinfo \- 罕
168.67 +.LP
168.68 +.RS 3
168.69 +.TP 2
168.70 +o
168.71 +綵√
168.72 +.TP 2
168.73 +o
168.74 +<若
168.75 +.TP 2
168.76 +o
168.77 +茯
168.78 +.TP 2
168.79 +o
168.80 +激с
168.81 +.TP 2
168.82 +o
168.83 +∫i
168.84 +.RE
168.85 +
168.86 +.LP
168.87 +.SH "綵√"
168.88 .LP
168.89
168.90 .LP
168.91 +.nf
168.92 +\f3
168.93 +.fl
168.94 +\fP\f3jinfo\fP [ option ] pid
168.95 +.fl
168.96 +\f3jinfo\fP [ option ] executable core
168.97 +.fl
168.98 +\f3jinfo\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
168.99 +.fl
168.100 +.fi
168.101 +
168.102 +.LP
168.103 +.SH "<若"
168.104 +.LP
168.105 +
168.106 +.LP
168.107 +.RS 3
168.108 .TP 3
168.109 -option
168.110 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
168.111 +option
168.112 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
168.113 +.RS 3
168.114 .TP 3
168.115 -pid
168.116 -構成情報を出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
168.117 -.B jps
168.118 -を使用します。
168.119 +pid
168.120 +阪罕宴祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
168.121 +.RE
168.122 +.RS 3
168.123 .TP 3
168.124 executable
168.125 -コアダンプが生成された Java 実行可能ファイル。
168.126 +潟≪潟篏 Java 絎茵純<ゃс
168.127 +.RE
168.128 +.RS 3
168.129 .TP 3
168.130 core
168.131 -構成情報を出力するコアファイル。
168.132 +阪罕宴潟≪<ゃ
168.133 +.RE
168.134 +.RS 3
168.135 .TP 3
168.136 remote\-hostname\-or\-IP
168.137 -リモートデバッグサーバ (
168.138 -.B jsadebugd
168.139 -を参照) のホスト名または IP アドレス。
168.140 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
168.141 +.RE
168.142 +.RS 3
168.143 .TP 3
168.144 server\-id
168.145 -同じリモートホスト上で複数のデバッグサーバが実行している場合の、オプションの一意 ID。
168.146 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
168.147 +.RE
168.148 +.RE
168.149 +
168.150 .LP
168.151 -.SH 機能説明
168.152 -.B jinfo
168.153 -は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバの Java 構成情報を出力します。構成情報には、Java システムプロパティと Java 仮想マシンコマンド行フラグが含まれます。
168.154 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
168.155 +.SH "茯"
168.156 +.LP
168.157 +
168.158 +.LP
168.159 +.LP
168.160 +\f3jinfo\fP 絎 Java 祉鴻潟≪<ゃ障≪若違泣若若 Java 罕宴阪障罕宴Java 激鴻c若 Java 篁潟激潟潟潟茵違罕障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
168.161 .br
168.162
168.163 .LP
168.164 @@ -74,51 +112,55 @@
168.165 jinfo \-J\-d64 \-sysprops pid
168.166 .RE
168.167 .LP
168.168 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
168.169 -Windows 上の jinfo でサポートされているのは、実行中のプロセスの \-flag オプションだけです。
168.170 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 筝 jinfo с泣若絎茵筝祉鴻 \-flag 激с潟с\fP
168.171 .LP
168.172 -.SH オプション
168.173 -.if t .TP 20
168.174 -.if n .TP 15
168.175 -.B " <no option>"
168.176 -コマンド行フラグとシステムプロパティと値のペアの両方を出力します。
168.177 +.SH "激с"
168.178 +.LP
168.179 +
168.180 +.LP
168.181 +.RS 3
168.182 +.TP 3
168.183 +<激с潟>
168.184 +潟潟茵違激鴻c弱ゃ≪阪障
168.185 .br
168.186 .TP 3
168.187 \-flag name
168.188 -指定されたコマンド行フラグの名前と値を出力します。
168.189 +絎潟潟茵違ゃ阪障
168.190 .br
168.191 .TP 3
168.192 \-flag [+|\-]name
168.193 -指定されたブール型のコマンド行フラグを有効または無効にします。
168.194 +絎若潟潟茵違鴻障≦鴻障
168.195 .br
168.196 .TP 3
168.197 \-flag name=value
168.198 -指定されたコマンド行フラグを指定された値に設定します。
168.199 -.if t .TP 20
168.200 -.if n .TP 15
168.201 -.B \-flags
168.202 -JVM に渡されるコマンド行フラグをペアで出力します。
168.203 -.if t .TP 20
168.204 -.if n .TP 15
168.205 -.B \-sysprops
168.206 -Java システムプロパティを名前と値のペアとして出力します。
168.207 -.if t .TP 20
168.208 -.if n .TP 15
168.209 -.B \-h
168.210 -ヘルプメッセージを出力します。
168.211 -.if t .TP 20
168.212 -.if n .TP 15
168.213 -.B \-help
168.214 -ヘルプメッセージを出力します。
168.215 -.SH 関連項目
168.216 +絎潟潟茵違絎ゃ荐絎障
168.217 +.br
168.218 +.TP 3
168.219 +\-flags
168.220 +JVM 羝<潟潟茵違≪у阪障
168.221 +.br
168.222 +.TP 3
168.223 +\-sysprops
168.224 +Java 激鴻c若ゃ≪阪障
168.225 +.br
168.226 +.TP 3
168.227 +\-h
168.228 +<祉若吾阪障
168.229 +.TP 3
168.230 +\-help
168.231 +<祉若吾阪障
168.232 +.RE
168.233 +
168.234 +.LP
168.235 +.SH "∫i"
168.236 .LP
168.237 .RS 3
168.238 .TP 2
168.239 -*
168.240 -jps
168.241 +o
168.242 +jps(1)
168.243 .TP 2
168.244 -*
168.245 -jsadebugd
168.246 +o
168.247 +jsadebugd(1)
168.248 .RE
168.249
168.250 .LP
169.1 --- a/src/solaris/doc/sun/man/man1/ja/jmap.1 Tue May 12 15:21:55 2009 +0900
169.2 +++ b/src/solaris/doc/sun/man/man1/ja/jmap.1 Thu May 14 00:17:25 2009 -0700
169.3 @@ -1,71 +1,103 @@
169.4 -'\" t
169.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
169.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
169.7 -.\"
169.8 -.\" This code is free software; you can redistribute it and/or modify it
169.9 -.\" under the terms of the GNU General Public License version 2 only, as
169.10 -.\" published by the Free Software Foundation.
169.11 -.\"
169.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
169.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
169.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
169.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
169.16 -.\" accompanied this code).
169.17 -.\"
169.18 -.\" You should have received a copy of the GNU General Public License version
169.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
169.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
169.21 -.\"
169.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
169.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
169.24 -.\" have any questions.
169.25 -.\" `
169.26 -.TH jmap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
169.27 -.SH 名前
169.28 -jmap \- メモリマップ
169.29 -.\"
169.30 -.SH 形式
169.31 -.B jmap
169.32 -.BI [ option ] " pid"
169.33 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
169.34 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
169.35 +."
169.36 +." This code is free software; you can redistribute it and/or modify it
169.37 +." under the terms of the GNU General Public License version 2 only, as
169.38 +." published by the Free Software Foundation.
169.39 +."
169.40 +." This code is distributed in the hope that it will be useful, but WITHOUT
169.41 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
169.42 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
169.43 +." version 2 for more details (a copy is included in the LICENSE file that
169.44 +." accompanied this code).
169.45 +."
169.46 +." You should have received a copy of the GNU General Public License version
169.47 +." 2 along with this work; if not, write to the Free Software Foundation,
169.48 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
169.49 +."
169.50 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
169.51 +." CA 95054 USA or visit www.sun.com if you need additional information or
169.52 +." have any questions.
169.53 +."
169.54 +.TH jmap 1 "04 May 2009"
169.55 +." Generated from HTML by html2man (author: Eric Armstrong)
169.56 +
169.57 +.LP
169.58 +.SH ""
169.59 +jmap \- <≪若
169.60 +.LP
169.61 +.RS 3
169.62 +.TP 2
169.63 +o
169.64 +綵√
169.65 +.TP 2
169.66 +o
169.67 +<若
169.68 +.TP 2
169.69 +o
169.70 +茯
169.71 +.TP 2
169.72 +o
169.73 +激с
169.74 +.TP 2
169.75 +o
169.76 +∫i
169.77 +.RE
169.78 +
169.79 +.LP
169.80 +.SH "綵√"
169.81 +.LP
169.82 +
169.83 +.LP
169.84 +.nf
169.85 +\f3
169.86 +.fl
169.87 +\fP\f3jmap\fP [ option ] pid
169.88 +.fl
169.89 +\f3jmap\fP [ option ] executable core
169.90 +.fl
169.91 +\f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
169.92 +.fl
169.93 +.fi
169.94 +
169.95 +.LP
169.96 +.SH "<若"
169.97 +.LP
169.98 +
169.99 +.LP
169.100 +.RS 3
169.101 +.TP 3
169.102 +option
169.103 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障
169.104 +.TP 3
169.105 +pid
169.106 +医激<≪若祉 ID祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
169.107 .br
169.108 -.B jmap
169.109 -.BI [ option ] " executable core"
169.110 +.TP 3
169.111 +executable
169.112 +潟≪潟篏 Java 絎茵純<ゃс
169.113 .br
169.114 -.B jmap
169.115 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
169.116 -.SH パラメータ
169.117 -.if t .TP 20
169.118 -.if n .TP 15
169.119 -.BI option
169.120 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
169.121 -.if t .TP 20
169.122 -.if n .TP 15
169.123 -.I pid
169.124 -メモリマップを表示するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
169.125 -.B jps
169.126 -を使用します。
169.127 -.if t .TP 20
169.128 -.if n .TP 15
169.129 -.I executable
169.130 -コアダンプが生成された Java 実行可能ファイル。
169.131 -.if t .TP 20
169.132 -.if n .TP 15
169.133 -.I core
169.134 -メモリマップを表示するコアファイル。
169.135 -.if t .TP 20
169.136 -.if n .TP 15
169.137 -.I remote-hostname-or-IP
169.138 -リモートデバッグサーバ (
169.139 -.B jsadebugd
169.140 -を参照) のホスト名または IP アドレス。
169.141 -.if t .TP 20
169.142 -.if n .TP 15
169.143 -.I server-id
169.144 -同じリモートホスト上で複数のデバッグサーバが実行している場合、オプションの一意 ID。
169.145 -.SH 機能説明
169.146 -.B jmap
169.147 -は、指定されたプロセスまたはコアファイルまたはリモートデバッグサーバの、共有オブジェクトメモリマップまたはヒープメモリの詳細を表示します。
169.148 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
169.149 +.TP 3
169.150 +core
169.151 +医激<≪若潟≪<ゃ
169.152 +.br
169.153 +.TP 3
169.154 +remote\-hostname\-or\-IP
169.155 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
169.156 +.br
169.157 +.TP 3
169.158 +server\-id
169.159 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
169.160 +.br
169.161 +.RE
169.162 +
169.163 +.LP
169.164 +.SH " 茯"
169.165 +.LP
169.166 +
169.167 +.LP
169.168 +.LP
169.169 +\f3jmap\fP 絎祉鴻潟≪<ゃ障≪若違泣若若援吾с<≪若障若<≪若荅括完医激障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
169.170 .LP
169.171 .RS 3
169.172
169.173 @@ -80,82 +112,87 @@
169.174 .RE
169.175
169.176 .LP
169.177 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
169.178 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障\fP
169.179 .br
169.180
169.181 .LP
169.182 -Windows プラットフォーム上で使用可能な唯一の jmap 形式は、次のとおりです。
169.183 +Windows 若筝т戎純筝 jmap 綵√罨<с
169.184 .RS 3
169.185
169.186 .LP
169.187 jmap \-dump:<\f2dump\-options\fP> pid
169.188 .RE
169.189 -および
169.190 +
169.191 .RS 3
169.192
169.193 .LP
169.194 jmap \-histo[:live] pid
169.195 .RE
169.196 -.SH オプション
169.197 -.if t .TP 20
169.198 -.if n .TP 15
169.199 -.BI " <no option>"
169.200 -オプションが使用されなかった場合、
169.201 -.B jmap
169.202 -は共有オブジェクトマッピングを表示します。ターゲット VM に読み込まれた各共有オブジェクトについて、開始アドレス、マッピングのサイズ、および共有オブジェクトファイルのフルパスが表示されます。これは、Solaris の
169.203 -.B pmap
169.204 -ユーティリティと同様です。
169.205 +.SH "激с"
169.206 +.LP
169.207 +
169.208 +.LP
169.209 +.RS 3
169.210 +.TP 3
169.211 +<激с潟>
169.212 +激с潟篏睡翫\f3jmap\fP 援吾с潟違医激障帥若蚊 VM 若援吾с紮≪鴻潟違泣ゃ冴喝援吾с<ゃ鴻医激障Solaris \f3pmap\fP 若cc若蕁篌若障
169.213 +.br
169.214 .TP 3
169.215 \-dump:[live,]format=b,file=<filename>
169.216 -Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat (Java Heap Analysis Tool) を使って読み取ります。
169.217 +Java 若 hprof ゃ綵√ filename 潟障\f2live\fP 泣激с潟ュ純с絎翫若х絖筝吾с帥潟障若潟с<ゃ jhat(1) (Java Heap Analysis Tool) 篏帥c茯水障
169.218 +.br
169.219 .TP 3
169.220 \-finalizerinfo
169.221 -ファイナライズを待っているオブジェクトに関する情報を出力します。
169.222 -.if t .TP 20
169.223 -.if n .TP 15
169.224 -.B \-heap
169.225 -ヒープのサマリを表示します。使用された GC アルゴリズム、ヒープ構成、および生成規模のヒープ使用率が表示されます。
169.226 -.if t .TP 20
169.227 -.if n .TP 15
169.228 -.B \-histo[:live]
169.229 -ヒープのヒストグラムを表示します。各 Java クラスについて、オブジェクト数、メモリサイズ(バイト数)、および完全修飾クラス名が表示されます。VM 内部クラス名の前には '*' が表示されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
169.230 -.if t .TP 20
169.231 -.if n .TP 15
169.232 -.B \-permstat
169.233 -Java ヒープの永続的生成のクラスローダ規模の統計を表示します。各クラスローダについて、名前、活動性、アドレス、親クラスローダ、および読み込まれたクラスのサイズが表示されます。
169.234 -さらに、intern された文字列の数とサイズも出力されます。
169.235 +<ゃゃ冴緇c吾с≪宴阪障
169.236 +.br
169.237 +.TP 3
169.238 +\-heap
169.239 +若泣若医激障篏睡 GC ≪眼冴若罕割篁c若篏睡医激障
169.240 +.br
169.241 +.TP 3
169.242 +\-histo[:live]
169.243 +若鴻違医激障Java 鴻吾с違ゃ篏с<≪若泣ゃ冴喝篆蕋障劫医激障VM 劫*・莨篁医激障\f2live\fP 泣激с潟絎翫絖筝吾с帥潟障
169.244 +.br
169.245 +.TP 3
169.246 +\-permstat
169.247 +Permanent 筝篁c Java 若鴻若守∫c腟沿若帥医激障鴻若若倶≪鴻荀鴻若若潟鴻若若若鴻違泣ゃ冴医激障intern 絖違泣ゃ冴阪障
169.248 +.br
169.249 .TP 3
169.250 \-F
169.251 -強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
169.252 -.if t .TP 20
169.253 -.if n .TP 15
169.254 -.B \-h
169.255 -ヘルプメッセージを表示します。
169.256 -.if t .TP 20
169.257 -.if n .TP 15
169.258 -.B \-help
169.259 -ヘルプメッセージを表示します。
169.260 +綣桁 (Force)pid 綽膈翫jmap \-dump 障 jmap \-histo 激с潟篏睡障≪若с\f2live\fP 泣激с潟泣若障
169.261 +.br
169.262 +.TP 3
169.263 +\-h
169.264 +<祉若吾医激障
169.265 +.br
169.266 +.br
169.267 +.TP 3
169.268 +\-help
169.269 +<祉若吾医激障
169.270 +.br
169.271 .br
169.272 .TP 3
169.273 \-J<flag>
169.274 -jmap が実行されている Java 仮想マシンに <flag> を渡します。
169.275 +jmap 絎茵 Java 篁潟激潟 <flag> 羝<障
169.276 +.br
169.277 +.RE
169.278
169.279 .LP
169.280 -.SH 関連項目
169.281 +.SH "∫i"
169.282 .LP
169.283 .RS 3
169.284 .TP 2
169.285 -*
169.286 +o
169.287 pmap (1)
169.288 .TP 2
169.289 -*
169.290 -jhat
169.291 +o
169.292 +jhat(1)
169.293 .TP 2
169.294 -*
169.295 -jps
169.296 +o
169.297 +jps(1)
169.298 .TP 2
169.299 -*
169.300 -jsadebugd
169.301 +o
169.302 +jsadebugd(1)
169.303 .RE
169.304
169.305 .LP
170.1 --- a/src/solaris/doc/sun/man/man1/ja/jps.1 Tue May 12 15:21:55 2009 +0900
170.2 +++ b/src/solaris/doc/sun/man/man1/ja/jps.1 Thu May 14 00:17:25 2009 -0700
170.3 @@ -1,202 +1,294 @@
170.4 -'\" t
170.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
170.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
170.7 -.\"
170.8 -.\" This code is free software; you can redistribute it and/or modify it
170.9 -.\" under the terms of the GNU General Public License version 2 only, as
170.10 -.\" published by the Free Software Foundation.
170.11 -.\"
170.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
170.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
170.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
170.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
170.16 -.\" accompanied this code).
170.17 -.\"
170.18 -.\" You should have received a copy of the GNU General Public License version
170.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
170.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
170.21 -.\"
170.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
170.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
170.24 -.\" have any questions.
170.25 -.\" `
170.26 -.TH jps 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
170.27 -.SH 名前
170.28 -jps \- Java 仮想マシンプロセスステータスツール
170.29 -.\"
170.30 -.SH 形式
170.31 -.B jps
170.32 -.BI [ options ]
170.33 -.BI [ hostid ]
170.34 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
170.35 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
170.36 +."
170.37 +." This code is free software; you can redistribute it and/or modify it
170.38 +." under the terms of the GNU General Public License version 2 only, as
170.39 +." published by the Free Software Foundation.
170.40 +."
170.41 +." This code is distributed in the hope that it will be useful, but WITHOUT
170.42 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
170.43 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
170.44 +." version 2 for more details (a copy is included in the LICENSE file that
170.45 +." accompanied this code).
170.46 +."
170.47 +." You should have received a copy of the GNU General Public License version
170.48 +." 2 along with this work; if not, write to the Free Software Foundation,
170.49 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
170.50 +."
170.51 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
170.52 +." CA 95054 USA or visit www.sun.com if you need additional information or
170.53 +." have any questions.
170.54 +."
170.55 +.TH jps 1 "04 May 2009"
170.56 +." Generated from HTML by html2man (author: Eric Armstrong)
170.57 +
170.58 .LP
170.59 -.SH パラメータ
170.60 -.if t .TP 20
170.61 -.if n .TP 15
170.62 -.I options
170.63 -コマンド行オプション。
170.64 -.if t .TP 20
170.65 -.if n .TP 15
170.66 -.I hostid
170.67 -プロセスレポートを生成するホストのホスト識別子。
170.68 -.I hostid
170.69 -には、通信プロトコル、ポート番号、およびその他固有の実装データを示すオプションコンポーネントを含めることができます。
170.70 -.SH 機能説明
170.71 -.B jps
170.72 -ツールは、ターゲットシステム上の計測機構付き HotSpot Java 仮想マシン (JVM) をリストします。このツールは、アクセス権がある JVM 上の情報だけを報告します。
170.73 -.LP
170.74 -ホスト ID を指定せずに
170.75 -.B jps
170.76 -が実行された場合は、ローカルホスト上の計測機構付き JVM を探します。ホスト ID が指定された場合は、指定されたホスト上の JVM を、指定されたプロトコルとポートを使用して探します。
170.77 -.B jstatd
170.78 -プロセスがターゲットホスト上で稼動していることが前提となります。
170.79 -.LP
170.80 -.B jps
170.81 -コマンドは、ターゲットシステム上で見つかった計測機構付き JVM のそれぞれについて、ローカル VM 識別子 (lvmid) を報告します。lvmid は、一般に、オペレーティングシステムの JVM プロセスのプロセス識別子ですが、必ずしもそうとは限りません。オプションが指定されなかった場合、
170.82 -.B jps
170.83 -は各 Java アプリケーションの lvmid の後に短い形式のアプリケーションのクラス名または jar ファイル名を続けてリストします。短い形式のクラス名または JAR ファイル名では、クラスのパッケージ情報や JAR ファイルのパス情報は省かれます。
170.84 -.LP
170.85 -.B jps
170.86 -コマンドは java 起動ツールを使用して、クラス名と main メソッドに渡された引数を探します。ターゲット JVM がカスタム起動ツールで起動された場合、クラス名 (または JAR ファイル名) と main メソッドに渡された引数は入手できません。この場合、
170.87 -.B jps
170.88 -コマンドは、クラス名または JAR ファイル名と main メソッドの引数として、Unknown という文字列を出力します。
170.89 -.LP
170.90 -.B jps
170.91 -コマンドによって生成される JVM のリストは、コマンドを実行した主体に許可されているアクセス権によって制限されることがあります。このコマンドは、オペレーティングシステム固有のアクセス制御機構に従って、主体がアクセス権を持っている JVM だけをリストします。
170.92 -.LP
170.93 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現在、Windows 98 および Windows ME プラットフォームでは使用できません。
170.94 -.SH オプション
170.95 -.B jps
170.96 -コマンドは、コマンド出力を変更する多数のオプションをサポートしています。これらのオプションは、将来、変更または削除されることがあります。
170.97 -.if t .TP 20
170.98 -.if n .TP 15
170.99 -.BI \-q
170.100 -クラス名、JAR ファイル名、および main メソッドに渡された引数の出力を抑制して、ローカル VM 識別子のリストだけを生成します。
170.101 -.if t .TP 20
170.102 -.if n .TP 15
170.103 -.BI \-m
170.104 -main メソッドに渡された引数を出力します。埋め込み JVM の場合、出力は NULL になることがあります。
170.105 -.if t .TP 20
170.106 -.if n .TP 15
170.107 -.BI \-l
170.108 -アプリケーションの main クラスのフルパッケージ名、またはアプリケーションの JAR ファイルのフルパス名を出力します。
170.109 -.if t .TP 20
170.110 -.if n .TP 15
170.111 -.BI \-v
170.112 -JVM に渡された引数を出力します。
170.113 -.if t .TP 20
170.114 -.if n .TP 15
170.115 -.BI \-V
170.116 -フラグファイル (.hotspotrc ファイル、または -XX:Flags=<filename> 引数によって指定されたファイル) を通じて JVM に渡された引数を出力します。
170.117 -.if t .TP 20
170.118 -.if n .TP 15
170.119 -.BI \-J "option"
170.120 -.B jps
170.121 -によって呼び出された java 起動ツールにオプションを渡します。
170.122 -たとえば、-J-Xms48m は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、\-J の一般的規則です。
170.123 -.SH ホスト識別子
170.124 -ホスト識別子 (hostid) は、ターゲットシステムを示す文字列です。hostid 文字列の構文は、URI の構文とほぼ同じです。
170.125 -.LP
170.126 -.RS
170.127 -.ft 3
170.128 -.nf
170.129 -[protocol:][[//]hostname][:port][/servername]
170.130 -.fi
170.131 -.ft 1
170.132 -.RE
170.133 -.if t .TP 20
170.134 -.if n .TP 15
170.135 -.B protocol
170.136 -通信プロトコル。protocol が省かれ、hostname が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。protocol が省かれ、hostname が指定された場合、デフォルトのプロトコルは rmi です。
170.137 -.if t .TP 20
170.138 -.if n .TP 15
170.139 -.I hostname
170.140 -ターゲットホストを示すホスト名または IP アドレス。hostname が省かれた場合、ターゲットホストはローカルホストです。
170.141 -.if t .TP 20
170.142 -.if n .TP 15
170.143 -.I port
170.144 -リモートサーバーと通信するためのデフォルトポート。hostname が省かれるか、protocol が最適化されたローカルプロトコルを指定している場合、port は無視されます。そうでない場合、port パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、port はリモートホスト上の rmiregistry のポート番号を示します。port が省かれ、protocol が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。
170.145 -.if t .TP 20
170.146 -.if n .TP 15
170.147 -.I servername
170.148 -このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表す文字列です。
170.149 -.B jstatd
170.150 -コマンドの \-n オプションを参照してください。
170.151 -.SH 出力形式
170.152 -jps コマンドの出力は、次のパターンに従います。
170.153 -.LP
170.154 -.RS
170.155 -.ft 3
170.156 -.nf
170.157 -lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]
170.158 -.fi
170.159 -.ft 1
170.160 -.RE
170.161 -.LP
170.162 -出力トークンはすべて、空白で区切られます。埋め込まれた空白を含む arg があると、引数を実際の位置パラメータにマップするときにあいまいさが生じます。
170.163 -.LP
170.164 -注 - 将来のリリースで形式が変更される可能性があるので、
170.165 -.B jps
170.166 -の出力を解析するスクリプトは書かない方がよいでしょう。jps 出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを予想しておいてください。
170.167 -.SH 使用例
170.168 -このセクションでは、
170.169 -.B jps
170.170 -コマンドの例を示します。
170.171 -.LP
170.172 -ローカルホスト上の計測機構付き JVM をリストする:
170.173 -.LP
170.174 -.RS
170.175 -.ft 3
170.176 -.nf
170.177 -jps
170.178 -18027 Java2Demo.JAR
170.179 -18032 jps
170.180 -18005 jstat
170.181 -.fi
170.182 -.ft 1
170.183 -.RE
170.184 -.TP
170.185 -リモートホスト上の計測機構付き JVM をリストする:
170.186 -.LP
170.187 -この例では、jstat サーバーとその内部 RMI レジストリまたは個別の外部 rmiregistry プロセスがリモートホストのデフォルトポート (ポート 1099) で実行していることを前提としています。また、ローカルホストはリモートホストにアクセスするための適切なアクセス権を持っているものとします。また、この例には、長い形式のクラス名または JAR ファイル名を出力するための -l オプションが含まれています。
170.188 -.LP
170.189 -.RS
170.190 -.ft 3
170.191 -.nf
170.192 -jps -l remote.domain
170.193 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
170.194 -2857 sun.tools.jstatd.jstatd
170.195 -.fi
170.196 -.ft 1
170.197 -.RE
170.198 -.LP
170.199 -RMI レジストリ用にデフォルト以外のポートを使用するリモートホスト上の計測機構付き Java 仮想マシンをリストする:
170.200 -.LP
170.201 -この例では、jstatd サーバーがリモートホスト上で実行していて、内部 RMI レジストリがポート 2002 にバインドされていることを前提としています。また、この例では、リストされる各 Java アプリケーションの main メソッドに渡された引数を含めるために、-m オプションを使用しています。
170.202 -.LP
170.203 -.RS
170.204 -.ft 3
170.205 -.nf
170.206 -jps -m remote.domain:2002
170.207 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
170.208 -3102 sun.tools.jstatd.jstatd -p 2002
170.209 -.fi
170.210 -.ft 1
170.211 -.RE
170.212 -.SH 関連項目
170.213 +.SH ""
170.214 +jps \- Java 篁潟激潟祉鴻鴻若帥鴻若
170.215 .LP
170.216 .RS 3
170.217 .TP 2
170.218 -*
170.219 -java \- Java アプリケーション起動プログラム
170.220 +o
170.221 +綵√
170.222 .TP 2
170.223 -*
170.224 -jstat \- Java 仮想マシン統計監視ツール
170.225 +o
170.226 +<若
170.227 .TP 2
170.228 -*
170.229 -jstatd \- 仮想マシン jstat デーモン
170.230 +o
170.231 +茯
170.232 .TP 2
170.233 -*
170.234 -rmiregistry \- Java リモートオブジェクトレジストリ
170.235 +o
170.236 +激с
170.237 +.TP 2
170.238 +o
170.239 +鴻茘ュ
170.240 +.TP 2
170.241 +o
170.242 +阪綵√
170.243 +.TP 2
170.244 +o
170.245 +箴
170.246 +.TP 2
170.247 +o
170.248 +∫i
170.249 +.RE
170.250 +
170.251 +.LP
170.252 +.SH "綵√"
170.253 +.LP
170.254 +
170.255 +.LP
170.256 +.nf
170.257 +\f3
170.258 +.fl
170.259 +\fP\f3jps\fP [ \f2options\fP ] [ \f2hostid\fP ]
170.260 +.br
170.261 +
170.262 +.fl
170.263 +.fi
170.264 +
170.265 +.LP
170.266 +.SH "<若"
170.267 +.LP
170.268 +
170.269 +.LP
170.270 +.RS 3
170.271 +.TP 3
170.272 +options
170.273 +潟潟茵激с潟
170.274 +.TP 3
170.275 +hostid
170.276 +祉鴻若鴻鴻茘ュ\f2hostid\fP 篆<潟若垩絎茖堺篁若帥絎激с潟潟潟若潟с障
170.277 +.RE
170.278 +
170.279 +.LP
170.280 +.SH " 茯"
170.281 +.LP
170.282 +
170.283 +.LP
170.284 +.LP
170.285 +\f3jps\fP 若帥若蚊激鴻筝ц羝 HotSpot Java 篁潟激 (JVM) 筝荀ц;腓冴障若ц;腓冴с若宴≪祉号┤c JVM ≪絎障
170.286 +.LP
170.287 +.LP
170.288 +\f2hostid\fP 絎 \f3jps\fP 絎茵翫若鴻ц羝 JVM 罎膣≪障\f2hostid\fP 絎莎桁翫絎潟若篏睡絎鴻筝 JVM 罎膣≪障\f3jstatd\fP 祉鴻帥若蚊鴻筝у茵喝障
170.289 +.LP
170.290 +.LP
170.291 +\f3jps\fP 潟潟帥若蚊激鴻ц羝 JVM ゃ若 VM 茘ュゃ障 \f2lvmid\fP 若障\f3lvmid\fP 綽с障筝 JVM 祉鴻絲障若c潟違激鴻祉壕ュс激с潟絎翫\f3jps\fP c Java ≪宴若激с潟 \f2lvmid\fP 筝荀ц;腓冴≪宴若激с潟劫障 JAR <ゃ膂≦綵√хず障膂≦綵√劫 JAR <ゃс鴻宴若御宴障 JAR <ゃ号宴ャ障
170.292 +.LP
170.293 +.LP
170.294 +\f3jps\fP 潟潟\f3Java\fP 莎桁若篏睡\f2main\fP <純羝<劫綣違罎膣≪障莎桁若篏睡帥若蚊 JVM 莎桁翫\f2main\fP <純羝<劫 (障 JAR <ゃ) 綣違с障翫\f3jps\fP 潟潟main <純御検劫 (障 JAR <ゃ) 綣違絲障絖 \f2Unknown\fP 阪障
170.295 +.LP
170.296 +.LP
170.297 +\f3jps\fP 潟潟х JVM 鴻潟潟絎茵筝私筝≪祉号┤冴ャ狗翫障潟潟若c潟違激鴻≪祉劫九勝罘罕羆阪冴ャ筝私≪祉号┤筝 JVM 筝荀ц;腓冴障
170.298 +.LP
170.299 +.LP
170.300 +\f3羈:\fP 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
170.301 +.LP
170.302 +.SH "激с"
170.303 +.LP
170.304 +
170.305 +.LP
170.306 +.LP
170.307 +\f3jps\fP 潟潟с潟潟阪紊眼激с潟紊違泣若障絨ャ激с潟紊眼障綮罩≪醇с障
170.308 +.LP
170.309 +.RS 3
170.310 +.TP 3
170.311 +\-q
170.312 +若 VM 茘ュ鴻\f2main\fP <純羝<劫JAR <ゃ喝違阪九勝障
170.313 +.TP 3
170.314 +\-m
170.315 +main <純羝<綣違阪障阪腟粋昭障 JVM 絲障 null 障
170.316 +.TP 3
170.317 +\-l
170.318 +≪宴若激с潟筝肢鴻宴若後障≪宴若激с潟 JAR <ゃ吾劫阪障
170.319 +.TP 3
170.320 +\-v
170.321 +JVM 羝<綣違阪障
170.322 +.TP 3
170.323 +\-V
170.324 +違<ゃ (.hotspotrc <ゃ障 \-XX:Flags=<\f2filename\fP> 綣違ф絎<ゃ) JVM 羝<綣違阪障
170.325 +.TP 3
170.326 +\-Joption
170.327 +\f3jps\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
170.328 +.RE
170.329 +
170.330 +.LP
170.331 +.SS
170.332 +鴻茘ュ
170.333 +.LP
170.334 +.RS 3
170.335 +
170.336 +.LP
170.337 +.LP
170.338 +鴻茘ュゃ障 \f2hostid\fP 帥若蚊激鴻腓冴絖с\f2hostid\fP 絖罕紊чURI 罕絲上障
170.339 +.LP
170.340 +.nf
170.341 +\f3
170.342 +.fl
170.343 +[\fP\f4protocol\fP\f3:][[//]\fP\f4hostname\fP\f3][:\fP\f4port\fP\f3][/\fP\f4servername\fP\f3]\fP
170.344 +.br
170.345 +\f3
170.346 +.fl
170.347 +\fP
170.348 +.fi
170.349 +
170.350 +.LP
170.351 +.RS 3
170.352 +.TP 3
170.353 +protocol
170.354 +篆<潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
170.355 +.TP 3
170.356 +hostname
170.357 +帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
170.358 +.TP 3
170.359 +port
170.360 +≪若泣若若篆<若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP <若帥宴絎茖c違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
170.361 +.TP 3
170.362 +servername
170.363 +<若帥宴絎茖c違障若潟翫c若∴障\f3rmi\fP 潟翫<若帥≪若鴻筝 RMI ≪若吾с腓冴絖障jstatd(1) 潟潟ゃ\f3\-n\fP 激с潟с
170.364 +.RE
170.365 +
170.366 +.LP
170.367 +.RE
170.368 +.SH "阪綵√"
170.369 +.LP
170.370 +
170.371 +.LP
170.372 +.LP
170.373 +\f3jps\fP 潟潟阪罨<帥若潟緇障
170.374 +.LP
170.375 +.nf
170.376 +\f3
170.377 +.fl
170.378 +\fP\f4lvmid\fP\f3 [ [ \fP\f4classname\fP\f3 | \fP\f4JARfilename\fP\f3 | "Unknown"] [ \fP\f4arg\fP\f3* ] [ \fP\f4jvmarg\fP\f3* ] ]\fP
170.379 +.br
170.380 +\f3
170.381 +.fl
170.382 +\fP
170.383 +.fi
170.384 +
170.385 +.LP
170.386 +.LP
170.387 +鴻阪若潟腥榊純у阪障\f2arg\fP 筝х榊純篏睡絎絎篏臀<若帥綣違潟違障障
170.388 +.br
170.389 +.br
170.390 +\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jps\fP 阪茹f鴻篏с障\f3jps\fP 阪茹f鴻篏若絨ャ若鴻с篏鴻紊眼綽荀篋羝障
170.391 +.br
170.392 +
170.393 +.LP
170.394 +.SH "箴"
170.395 +.LP
170.396 +
170.397 +.LP
170.398 +.LP
170.399 +膀с\f3jps\fP 潟潟箴腓冴障
170.400 +.LP
170.401 +.LP
170.402 +若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
170.403 +.LP
170.404 +.nf
170.405 +\f3
170.406 +.fl
170.407 +\fP\f3jps\fP
170.408 +.br
170.409 +
170.410 +.fl
170.411 +18027 Java2Demo.JAR
170.412 +.br
170.413 +
170.414 +.fl
170.415 +18032 jps
170.416 +.br
170.417 +
170.418 +.fl
170.419 +18005 jstat
170.420 +.br
170.421 +
170.422 +.fl
170.423 +.fi
170.424 +
170.425 +.LP
170.426 +.LP
170.427 +≪若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
170.428 +.LP
170.429 +.LP
170.430 +箴с\f3jstat\fP 泣若若 RMI 吾鴻障ャ紊 \f3rmiregistry\fP 祉鴻≪若鴻若 (若 1099) у茵喝障障若鴻≪若鴻吾鴻≪祉号┤c喝障箴\f2\-l\fP 激с潟障劫障 JAR <ゃ荅括完綵√у阪障
170.431 +.LP
170.432 +.nf
170.433 +\f3
170.434 +.fl
170.435 +\fP\f3jps \-l remote.domain\fP
170.436 +.br
170.437 +
170.438 +.fl
170.439 +3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
170.440 +.br
170.441 +
170.442 +.fl
170.443 +2857 sun.tools.jstatd.jstatd
170.444 +.br
170.445 +
170.446 +.fl
170.447 +.fi
170.448 +
170.449 +.LP
170.450 +.LP
170.451 +RMI 吾鴻с若篏睡≪若鴻筝ц羝 JVM 筝荀ц;腓冴翫:
170.452 +.LP
170.453 +.LP
170.454 +箴с RMI 吾鴻若 2002 ゃ潟 \f3jstatd\fP 泣若若≪若鴻筝у茵喝障障\f2\-m\fP 激с潟篏睡筝荀ц;腓冴 Java ≪宴若激с潟 \f2main\fP <純羝<綣違腟粋昭с障
170.455 +.LP
170.456 +.nf
170.457 +\f3
170.458 +.fl
170.459 +\fP\f3jps \-m remote.domain:2002\fP
170.460 +.br
170.461 +
170.462 +.fl
170.463 +3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
170.464 +.br
170.465 +
170.466 +.fl
170.467 +3102 sun.tools.jstatd.jstatd \-p 2002
170.468 +.fl
170.469 +.fi
170.470 +
170.471 +.LP
170.472 +.SH "∫i"
170.473 +.LP
170.474 +.RS 3
170.475 +.TP 2
170.476 +o
170.477 +java(1) \- Java ≪宴若激с活儀若
170.478 +.TP 2
170.479 +o
170.480 +jstat(1) \- Java 篁潟激括輝荐若睡h若
170.481 +.TP 2
170.482 +o
170.483 +jstatd(1) \- 篁潟激 jstat 若≪潟
170.484 +.TP 2
170.485 +o
170.486 +rmiregistry(1) \- Java ≪若吾с吾鴻
170.487 .RE
170.488
170.489 .LP
171.1 --- a/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Tue May 12 15:21:55 2009 +0900
171.2 +++ b/src/solaris/doc/sun/man/man1/ja/jrunscript.1 Thu May 14 00:17:25 2009 -0700
171.3 @@ -1,4 +1,3 @@
171.4 -.'" t
171.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
171.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
171.7 ."
171.8 @@ -19,15 +18,40 @@
171.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
171.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
171.11 ." have any questions.
171.12 -." `
171.13 -.TH jrunscript 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
171.14 -." Generated by html2roff
171.15 +."
171.16 +.TH jrunscript 1 "04 May 2009"
171.17 +." Generated from HTML by html2man (author: Eric Armstrong)
171.18
171.19 .LP
171.20 -.SH 名前
171.21 -jrunscript \- コマンド行スクリプトシェル
171.22 +.SH ""
171.23 +jrunscript \- 潟潟茵鴻激с
171.24 .LP
171.25 -.SH "形式"
171.26 +.RS 3
171.27 +.TP 2
171.28 +o
171.29 +綵√
171.30 +.TP 2
171.31 +o
171.32 +<若
171.33 +.TP 2
171.34 +o
171.35 +茯
171.36 +.TP 2
171.37 +o
171.38 +激с
171.39 +.TP 2
171.40 +o
171.41 +綣
171.42 +.TP 2
171.43 +o
171.44 +箴
171.45 +.TP 2
171.46 +o
171.47 +∫i
171.48 +.RE
171.49 +
171.50 +.LP
171.51 +.SH "綵√"
171.52 .LP
171.53
171.54 .LP
171.55 @@ -36,148 +60,166 @@
171.56 .fl
171.57 \fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
171.58 .fl
171.59 -
171.60 -.fl
171.61 .fi
171.62
171.63 .LP
171.64 -.SH "パラメータ"
171.65 +.SH "<若"
171.66 .LP
171.67
171.68 .LP
171.69 +.RS 3
171.70 .TP 3
171.71 options
171.72 -オプションを使用する場合、コマンド名の直後に記述してください。
171.73 +激с潟篏睡翫潟潟翫荐菴違
171.74 .TP 3
171.75 arguments
171.76 -引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
171.77 +綣違篏睡翫激с潟障潟潟翫荐菴違
171.78 +.RE
171.79 +
171.80 .LP
171.81 -.SH "説明"
171.82 +.SH " 茯"
171.83 .LP
171.84
171.85 .LP
171.86 .LP
171.87 -\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
171.88 +\f3jrunscript\fP 潟潟茵鴻激сс jrunscript 絲乗怨 (茯水 \- 荅箴 \- 阪) ≪若 (\-f 激с) ≪若筝≧鴻鴻絎茵泣若障鴻荐茯箴絖激сс篏睡荐茯 JavaScript с\-l 激с潟篏帥違祉荐茯絎с障jrunscript Java 鴻荐茯篆<c「羆違潟違鴻帥ゃ泣若障
171.89 .LP
171.90 .LP
171.91 -\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
171.92 +\f3羈:\fP 若\f3荅薑\fPс絨ャ JDK 若吾с潟с\f3с\fP醇с障
171.93 .LP
171.94 -.SH "オプション"
171.95 +.SH "激с"
171.96 .LP
171.97
171.98 .LP
171.99 +.RS 3
171.100 .TP 3
171.101 \-classpath path
171.102 -スクリプトからのアクセス対象となるユーザの .class ファイルの検索場所を指定します。
171.103 +鴻≪祉劫乗院若吟若 .class <ゃ罎膣√贋絎障
171.104 .TP 3
171.105 \-cp path
171.106 -\-classpath \f2path\fP と同義です。
171.107 +\-classpath \f2path\fP 臂с
171.108 .TP 3
171.109 \-Dname=value
171.110 -Java のシステムプロパティを設定します。
171.111 +Java 激鴻c若荐絎障
171.112 .TP 3
171.113 \-J<flag>
171.114 -jrunscript が実行されている Java 仮想マシンに、直接 <flag> を渡します。
171.115 +jrunscript 絎茵 Java 篁潟激潟 <flag> 羝<障
171.116 .TP 3
171.117 \-l language
171.118 -指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。
171.119 +絎鴻荐茯篏睡障с JavaScript 篏睡障祉鴻荐茯篏睡絲上鴻潟吾潟 JAR <ゃ絎綽荀障 \-cp\-classpath 激с潟篏睡障
171.120 .TP 3
171.121 \-e script
171.122 -指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
171.123 +絎鴻荅箴<障激с潟篏帥違潟潟茵鴻絎1 茵鴻絎茵с障
171.124 .TP 3
171.125 \-encoding encoding
171.126 -スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
171.127 +鴻<ゃ茯水篏睡絖潟潟若c潟違絎障
171.128 .TP 3
171.129 \-f script\-file
171.130 -指定されたスクリプトファイルを評価します (バッチモード)。
171.131 +絎鴻<ゃ荅箴<障 (≪若)
171.132 .TP 3
171.133 \-f \-
171.134 -標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
171.135 +罔羣ュ鴻茯水荅箴<障 (絲乗怨≪若)
171.136 .TP 3
171.137 \-help\
171.138 -ヘルプメッセージを出力したあと、終了します。
171.139 +<祉若吾阪腟篋障
171.140 .TP 3
171.141 \-?\
171.142 -ヘルプメッセージを出力したあと、終了します。
171.143 +<祉若吾阪腟篋障
171.144 .TP 3
171.145 \-q\
171.146 -利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
171.147 +純鴻鴻潟吾潟筝荀ц;腓冴腟篋障
171.148 +.RE
171.149 +
171.150 .LP
171.151 -.SH "引数"
171.152 +.SH "綣"
171.153 .LP
171.154 .LP
171.155 -[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ \f3\-e\fP、\f3\-f\fP のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
171.156 +[arguments...] 絖 \f3\-e\fP\f3\-f\fP 激с潟篏睡c翫綣違鴻<ゃ篁綣違絖翫鴻綣違羝<障[arguments..] 篏睡 \f3\-e\fP\f3\-f\fP 激с潟篏睡翫鴻 [arguments..] 鴻綣違羝<障[arguments..]\f3\-e\fP\f3\-f\fP 絖c翫絲乗怨≪若篏睡障鴻鴻綣違篏睡arguments String 潟吾喝違篏睡障
171.157 .LP
171.158 -.SH "例"
171.159 +.SH "箴"
171.160 .LP
171.161 -\f3インラインスクリプトの実行\fP
171.162 +\f3ゃ潟ゃ潟鴻絎茵\fP
171.163 +.LP
171.164 +.RS 3
171.165 +
171.166 .LP
171.167 .nf
171.168 \f3
171.169 .fl
171.170 - jrunscript \-e "print('hello world')"
171.171 +jrunscript \-e "print('hello world')"
171.172 .fl
171.173 - jrunscript \-e "cat('http://java.sun.com')"
171.174 +jrunscript \-e "cat('http://java.sun.com')"
171.175 .fl
171.176 \fP
171.177 .fi
171.178 +.RE
171.179
171.180 .LP
171.181 -\f3指定された言語を使用し、指定されたスクリプトファイルを評価する\fP
171.182 +\f3絎荐茯篏睡絎鴻<ゃ荅箴<\fP
171.183 +.LP
171.184 +.RS 3
171.185 +
171.186 .LP
171.187 .nf
171.188 \f3
171.189 .fl
171.190 - jrunscript \-l js \-f test.js
171.191 +jrunscript \-l js \-f test.js
171.192 .fl
171.193 \fP
171.194 .fi
171.195 +.RE
171.196
171.197 .LP
171.198 -\f3対話型モード\fP
171.199 +\f3絲乗怨≪若\fP
171.200 +.LP
171.201 +.RS 3
171.202 +
171.203 .LP
171.204 .nf
171.205 \f3
171.206 .fl
171.207 - jrunscript
171.208 +jrunscript
171.209 .fl
171.210 - js>print('hello world');
171.211 +js>print('hello world');
171.212 .fl
171.213 - hello world
171.214 +hello world
171.215 .fl
171.216 - js>34 + 55
171.217 +js>34 + 55
171.218 .fl
171.219 - 89
171.220 +89
171.221 .fl
171.222 - js> thread(function() { print('hello world'); }
171.223 +js> thread(function() { print('hello world'); }
171.224 .fl
171.225 - hello world
171.226 +hello world
171.227 .fl
171.228 - js>
171.229 +js>
171.230 .fl
171.231 \fP
171.232 .fi
171.233 +.RE
171.234
171.235 .LP
171.236 -\f3スクリプト引数を指定してスクリプトファイルを実行する\fP
171.237 +\f3鴻綣違絎鴻<ゃ絎茵\fP
171.238 +.LP
171.239 +.RS 3
171.240 +
171.241 .LP
171.242 .nf
171.243 \f3
171.244 .fl
171.245 - jrunscript test.js arg1 arg2 arg3
171.246 +jrunscript test.js arg1 arg2 arg3
171.247 .fl
171.248 \fP
171.249 .fi
171.250 -
171.251 -.LP
171.252 -test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
171.253 -.SH "関連項目"
171.254 -.LP
171.255 -.LP
171.256 -JavaScript が使用される場合、jrunscript は、最初のユーザ定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
171.257 -.LP
171.258 -.RS 3
171.259 .RE
171.260
171.261 .LP
171.262 +test.js 絎茵絲乗院鴻<ゃсarg1arg2 arg3 鴻綣違鴻羝<障鴻arguments篏帥c≪祉鴻с障
171.263 +.SH "∫i"
171.264 +.LP
171.265 +.LP
171.266 +JavaScript 篏睡翫jrunscript 若吟弱臂鴻荅箴<ゃ腟粋昭翠∽違腟粋昭帥吾с障 JavaScript 腟粋昭炊純ゃjsdocs с
171.267 +.LP
171.268 +
171.269 +.LP
171.270
172.1 --- a/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Tue May 12 15:21:55 2009 +0900
172.2 +++ b/src/solaris/doc/sun/man/man1/ja/jsadebugd.1 Thu May 14 00:17:25 2009 -0700
172.3 @@ -1,105 +1,149 @@
172.4 -'\" t
172.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
172.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
172.7 -.\"
172.8 -.\" This code is free software; you can redistribute it and/or modify it
172.9 -.\" under the terms of the GNU General Public License version 2 only, as
172.10 -.\" published by the Free Software Foundation.
172.11 -.\"
172.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
172.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
172.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
172.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
172.16 -.\" accompanied this code).
172.17 -.\"
172.18 -.\" You should have received a copy of the GNU General Public License version
172.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
172.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
172.21 -.\"
172.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
172.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
172.24 -.\" have any questions.
172.25 -.\" `
172.26 -.TH jsadebugd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
172.27 -.SH 名前
172.28 -jsadebugd \- サービスエージェントデバッグデーモン
172.29 -.\"
172.30 -.SH 形式
172.31 -.B jsadebugd
172.32 -.I pid [ server-id ]
172.33 -.br
172.34 -.B jsadebugd
172.35 -.I executable core [ server-id ]
172.36 -.SH パラメータ
172.37 -.if t .TP 20
172.38 -.if n .TP 15
172.39 -.I pid
172.40 -デバッグサーバがアタッチするプロセスのプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
172.41 -.B jps
172.42 -を使用します。1 つのプロセスにアタッチできるのは、1 つのデバッグサーバだけです。
172.43 -.if t .TP 20
172.44 -.if n .TP 15
172.45 -.I executable
172.46 -コアダンプが生成された Java 実行可能ファイル。
172.47 -.if t .TP 20
172.48 -.if n .TP 15
172.49 -.I core
172.50 -デバッグサーバがアタッチするコアファイル。
172.51 -.if t .TP 20
172.52 -.if n .TP 15
172.53 -.I server-id
172.54 -同じマシン上で複数のデバッグサーバを起動する場合に必要な、オプションの一意 ID。リモートクライアントがアタッチする特定のデバッグサーバを識別するには、この ID を使用する必要があります。1 つのマシン内で、この ID は一意でなければなりません。
172.55 -.SH 機能説明
172.56 -.B jsadebugd
172.57 -は、Java プロセスまたはコアファイルにアタッチして、デバッグサーバとして機能します。
172.58 -.B jstack
172.59 -、
172.60 -.B jmap
172.61 -、
172.62 -.B jinfo
172.63 -などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用してサーバにアタッチできます。
172.64 -.B jsadebugd
172.65 -を起動する前に、次のように指定して
172.66 -.B rmiregistry
172.67 -を起動する必要があります。
172.68 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
172.69 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
172.70 +."
172.71 +." This code is free software; you can redistribute it and/or modify it
172.72 +." under the terms of the GNU General Public License version 2 only, as
172.73 +." published by the Free Software Foundation.
172.74 +."
172.75 +." This code is distributed in the hope that it will be useful, but WITHOUT
172.76 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
172.77 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
172.78 +." version 2 for more details (a copy is included in the LICENSE file that
172.79 +." accompanied this code).
172.80 +."
172.81 +." You should have received a copy of the GNU General Public License version
172.82 +." 2 along with this work; if not, write to the Free Software Foundation,
172.83 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
172.84 +."
172.85 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
172.86 +." CA 95054 USA or visit www.sun.com if you need additional information or
172.87 +." have any questions.
172.88 +."
172.89 +.TH jsadebugd 1 "04 May 2009"
172.90 +." Generated from HTML by html2man (author: Eric Armstrong)
172.91 +
172.92 .LP
172.93 -.RS
172.94 -.ft 3
172.95 -.nf
172.96 -rmiregistry -J-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar
172.97 -.fi
172.98 -.ft 1
172.99 -.RE
172.100 -.LP
172.101 -$JAVA_HOME は、JDK のインストールディレクトリです。
172.102 -.B rmiregistry
172.103 -が起動していなかった場合、
172.104 -.B jsadebugd
172.105 -は標準 (1099) ポートで内部的に
172.106 -.B rmiregistry
172.107 -を起動します。デバッグサーバを停止するには、SIGINT を送信します (Ctrl-C を押す) 。
172.108 -.LP
172.109 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
172.110 -.B jsadebugd
172.111 -は、現時点では、Windows プラットフォームでは使用できません。
172.112 -.SH 関連項目
172.113 +.SH ""
172.114 +jsadebugd \- 泣若鴻≪c若若吾с潟違若≪
172.115 .LP
172.116 .RS 3
172.117 .TP 2
172.118 -*
172.119 -jinfo
172.120 +o
172.121 +綵√
172.122 .TP 2
172.123 -*
172.124 -jmap
172.125 +o
172.126 +<若
172.127 .TP 2
172.128 -*
172.129 -jps
172.130 +o
172.131 +茯
172.132 .TP 2
172.133 -*
172.134 -jstack
172.135 +o
172.136 +∫i
172.137 +.RE
172.138 +
172.139 +.LP
172.140 +.SH "綵√"
172.141 +.LP
172.142 +
172.143 +.LP
172.144 +.nf
172.145 +\f3
172.146 +.fl
172.147 +\fP\f3jsadebugd\fP pid [ server\-id ]
172.148 +.fl
172.149 +\f3jsadebugd\fP executable core [ server\-id ]
172.150 +.fl
172.151 +.fi
172.152 +
172.153 +.LP
172.154 +.SH "<若"
172.155 +.LP
172.156 +
172.157 +.LP
172.158 +.RS 3
172.159 +.TP 3
172.160 +pid
172.161 +違泣若若・膓祉鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障筝祉鴻・膓с違泣若若ゃ潟鴻帥潟鴻1 ゃ狗障
172.162 +.RE
172.163 +
172.164 +.LP
172.165 +.RS 3
172.166 +.TP 3
172.167 +executable
172.168 +.RE
172.169 +
172.170 +.LP
172.171 +.RS 3
172.172 +.TP 3
172.173 +潟≪潟篏 Java 絎茵純<ゃс
172.174 +.RE
172.175 +
172.176 +.LP
172.177 +.RS 3
172.178 +.TP 3
172.179 +core
172.180 +違泣若若・膓潟≪<ゃс
172.181 +.RE
172.182 +
172.183 +.LP
172.184 +.RS 3
172.185 +.TP 3
172.186 +server\-id
172.187 +茲違違泣若若筝激割у茵翫綽荀激с喝堺 ID с ID ≪若ゃ≪潟・膓違泣若若劫篏睡綽荀障 ID 筝激喝тс違障
172.188 +.RE
172.189 +
172.190 +.LP
172.191 +.SH "茯"
172.192 +.LP
172.193 +
172.194 +.LP
172.195 +.LP
172.196 +\f3jsadebugd\fP Java 祉鴻障潟≪<ゃ・膓違泣若若罘純障jstack(1)jmap(1) jinfo(1) ≪若ゃ≪潟Java Remote Method Invocation (RMI) 篏睡泣若若・膓с障\f2jsadebugd\fP 莎桁罨<絎
172.197 +.na
172.198 +\f2rmiregistry\fP @
172.199 +.fi
172.200 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi 莎桁綽荀障
172.201 +.LP
172.202 +.RS 3
172.203 +
172.204 +.LP
172.205 +.nf
172.206 +\f3
172.207 +.fl
172.208 +\fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3
172.209 +.fl
172.210 +\fP
172.211 +.fi
172.212 +.RE
172.213 +
172.214 +.LP
172.215 +.LP
172.216 +с\f2$JAVA_HOME\fP JDK ゃ潟鴻若cсrmiregistry 莎桁翫jsadebugd 罔羣 (1099) 若 rmiregistry ц儀障違泣若若SIGINT 篆< (Ctrl+C 若) 罩≪с障
172.217 +.LP
172.218 +.LP
172.219 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障 jsadebugd 憝鴻сWindows 若с篏睡с障\fP
172.220 +.LP
172.221 +.SH "∫i"
172.222 +.LP
172.223 +.RS 3
172.224 .TP 2
172.225 -*
172.226 -rmiregistry
172.227 +o
172.228 +jinfo(1)
172.229 +.TP 2
172.230 +o
172.231 +jmap(1)
172.232 +.TP 2
172.233 +o
172.234 +jps(1)
172.235 +.TP 2
172.236 +o
172.237 +jstack(1)
172.238 +.TP 2
172.239 +o
172.240 +.na
172.241 +\f2rmiregistry\fP @
172.242 +.fi
172.243 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
172.244 .RE
172.245
172.246 .LP
173.1 --- a/src/solaris/doc/sun/man/man1/ja/jstack.1 Tue May 12 15:21:55 2009 +0900
173.2 +++ b/src/solaris/doc/sun/man/man1/ja/jstack.1 Thu May 14 00:17:25 2009 -0700
173.3 @@ -1,73 +1,112 @@
173.4 -'\" t
173.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
173.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
173.7 -.\"
173.8 -.\" This code is free software; you can redistribute it and/or modify it
173.9 -.\" under the terms of the GNU General Public License version 2 only, as
173.10 -.\" published by the Free Software Foundation.
173.11 -.\"
173.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
173.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
173.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
173.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
173.16 -.\" accompanied this code).
173.17 -.\"
173.18 -.\" You should have received a copy of the GNU General Public License version
173.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
173.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
173.21 -.\"
173.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
173.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
173.24 -.\" have any questions.
173.25 -.\" `
173.26 -.TH jstack 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
173.27 -.SH 名前
173.28 -jstack \- スタックトレース
173.29 -.\"
173.30 -.SH 形式
173.31 -.B jstack
173.32 -.BI [ option ] " pid"
173.33 -.br
173.34 -.B jstack
173.35 -.BI [ option ] " executable core"
173.36 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
173.37 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
173.38 +."
173.39 +." This code is free software; you can redistribute it and/or modify it
173.40 +." under the terms of the GNU General Public License version 2 only, as
173.41 +." published by the Free Software Foundation.
173.42 +."
173.43 +." This code is distributed in the hope that it will be useful, but WITHOUT
173.44 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
173.45 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
173.46 +." version 2 for more details (a copy is included in the LICENSE file that
173.47 +." accompanied this code).
173.48 +."
173.49 +." You should have received a copy of the GNU General Public License version
173.50 +." 2 along with this work; if not, write to the Free Software Foundation,
173.51 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
173.52 +."
173.53 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
173.54 +." CA 95054 USA or visit www.sun.com if you need additional information or
173.55 +." have any questions.
173.56 +."
173.57 +.TH jstack 1 "04 May 2009"
173.58 +." Generated from HTML by html2man (author: Eric Armstrong)
173.59 +
173.60 +.LP
173.61 +.SH ""
173.62 +jstack \- 鴻帥若
173.63 .br
173.64 -.B jstack
173.65 -.BI [ option ] " [server-id@]remote-hostname-or-IP"
173.66 -.SH パラメータ
173.67 -オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
173.68 -「オプション」を参照してください。
173.69 -.if t .TP 20
173.70 -.if n .TP 15
173.71 -.I pid
173.72 -スタックトレースを出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
173.73 -.B jps
173.74 -を使用します。
173.75 -.if t .TP 20
173.76 -.if n .TP 15
173.77 -.I executable
173.78 -コアダンプが生成された Java 実行可能ファイル。
173.79 -.if t .TP 20
173.80 -.if n .TP 15
173.81 -.I core
173.82 -スタックトレースを出力するコアファイル。
173.83 -.if t .TP 20
173.84 -.if n .TP 15
173.85 -.BI remote-hostname-or-IP
173.86 -リモートデバッグサーバー (
173.87 -.B jsadebugd
173.88 -を参照) のホスト名または IP アドレス。
173.89 -.if t .TP 20
173.90 -.if n .TP 15
173.91 -.I server-id
173.92 -同じリモートホスト上で複数のデバッグサーバーが動作している場合の、オプションの一意 ID。
173.93 -.SH 機能説明
173.94 -.B jstack
173.95 -は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバーの Java スレッドの Java スタックトレースを出力します。それぞれの Java フレームについて、完全なクラス名、メソッド名、'bci' (バイトコードインデックス) 、および行番号 (入手可能な場合) が出力されます。
173.96 -.B \-m
173.97 -オプションを指定した場合、
173.98 -.B jstack
173.99 -は、すべてのスレッドの Java とネイティブの両方のフレームを 'pc' (プログラムカウンタ) とともに出力します。それぞれのネイティブフレームについて、'pc' に最も近いネイティブシンボル (入手可能な場合) が出力されます。C++ の符号化された (mangled) 名前は復号化 (demangled) されません。C++ 名を復号化するには、このコマンドの出力を c++filt にパイプで渡します。
173.100 -指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
173.101 +
173.102 +.LP
173.103 +.RS 3
173.104 +.TP 2
173.105 +o
173.106 +綵√
173.107 +.TP 2
173.108 +o
173.109 +<若
173.110 +.br
173.111 +.TP 2
173.112 +o
173.113 +茯
173.114 +.TP 2
173.115 +o
173.116 +激с
173.117 +.TP 2
173.118 +o
173.119 +∫i
173.120 +.TP 2
173.121 +o
173.122 +∝ャ
173.123 +.br
173.124 +.RE
173.125 +
173.126 +.LP
173.127 +.SH "綵√"
173.128 +.LP
173.129 +
173.130 +.LP
173.131 +.nf
173.132 +\f3
173.133 +.fl
173.134 +\fP\f3jstack\fP [ option ] pid
173.135 +.fl
173.136 +\f3jstack\fP [ option ] executable core
173.137 +.fl
173.138 +\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
173.139 +.fl
173.140 +.fi
173.141 +
173.142 +.LP
173.143 +.SH "<若"
173.144 +.LP
173.145 +
173.146 +.LP
173.147 +.LP
173.148 +激с潟篋篁с激с潟篏睡翫潟潟翫荐菴違障激с潟с
173.149 +.LP
173.150 +.RS 3
173.151 +.TP 3
173.152 +pid
173.153 +医激鴻帥若鴻祉 ID с祉鴻 Java 祉鴻с綽荀障激割у茵 Java 祉鴻筝荀с緇jps(1) 篏睡障
173.154 +.RE
173.155 +
173.156 +.LP
173.157 +.RS 3
173.158 +.TP 3
173.159 +executable
173.160 +潟≪潟篏 Java 絎茵純<ゃс
173.161 +.br
173.162 +.TP 3
173.163 +core
173.164 +医激鴻帥若鴻潟≪<ゃс
173.165 +.br
173.166 +.TP 3
173.167 +remote\-hostname\-or\-IP
173.168 +≪若違泣若 (jsadebugd(1) ) 鴻障 IP ≪鴻с
173.169 +.br
173.170 +.TP 3
173.171 +server\-id
173.172 +茲違違泣若若筝≪若鴻у茵翫激с喝堺 ID с
173.173 +.RE
173.174 +
173.175 +.LP
173.176 +.SH "茯"
173.177 +.LP
173.178 +
173.179 +.LP
173.180 +.LP
173.181 +\f3jstack\fP 絎 Java 祉鴻潟≪<ゃ障≪若違泣若若絲障 Java 鴻 Java 鴻帥若鴻医激障Java 若劫<純bci(ゃ潟若ゃ潟)活 (純翫) 医激障\-m 激с潟篏睡jstack 鴻鴻 Java 若ゃc若筝≧鴻pc(違潟) 医激障ゃc若pcc菴ゃc激潟 (純翫) 医激障C++ 茹e茹hВゃ障C++ 茹hВゃ潟潟阪 \f3c++filt\fP ゃ障絎祉鴻 64 VM 筝у茵翫\f2\-J\-d64\fP 激с潟絎違翫障 罨<箴腓冴障
173.182 .br
173.183
173.184 .LP
173.185 @@ -84,57 +123,72 @@
173.186 .RE
173.187
173.188 .LP
173.189 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
173.190 -Windows プラットフォーム上で使用可能な唯一の jstack 形式は、次のとおりです。
173.191 +.LP
173.192 +\f3羈 \- 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障Windows 若筝т戎純筝 jstack 綵√罨<с\fP
173.193 .LP
173.194 .nf
173.195 \f3
173.196 .fl
173.197 -\fP\f3 jstack pid \fP
173.198 +\fP\f3 jstack [\-l] pid \fP
173.199 .fl
173.200 .fi
173.201
173.202 .LP
173.203 -.SH オプション
173.204 +.SH "激с"
173.205 .LP
173.206
173.207 .LP
173.208 +.RS 3
173.209 .TP 3
173.210 \-F
173.211 -「jstack pid」が応答しない場合にスタックダンプを強制します。
173.212 +jstack [\-l] pid綽膈翫鴻帥潟綣桁吟障
173.213 +.TP 3
173.214 +\-l
173.215 +桁就綣鴻 java.util.concurrent
173.216 +.na
173.217 +\f2с激潟ゃ\fP @
173.218 +.fi
173.219 +http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html筝荀сゃ菴遵宴医激障
173.220 .TP 3
173.221 \-m
173.222 -混合モード (Java とネイティブの両方の C/C++ フレーム) のスタックトレースを出力します。
173.223 +羞桁≪若 (Java 潟ゃc C/C++ 若筝≧) 鴻帥若鴻医激障
173.224 .TP 3
173.225 -\-h
173.226 -ヘルプメッセージを出力します。
173.227 +\-h
173.228 +<祉若吾医激障
173.229 .br
173.230 .br
173.231 .TP 3
173.232 -\-help
173.233 -ヘルプメッセージを出力します。
173.234 +\-help
173.235 +<祉若吾医激障
173.236 .br
173.237 +.RE
173.238
173.239 .LP
173.240 -.SH 関連項目
173.241 +.SH "∫i"
173.242 .LP
173.243 .RS 3
173.244 .TP 2
173.245 -*
173.246 +o
173.247 pstack(1)
173.248 .TP 2
173.249 -*
173.250 +o
173.251 c++filt(1)
173.252 .TP 2
173.253 -*
173.254 -jps
173.255 +o
173.256 +jps(1)
173.257 .TP 2
173.258 -*
173.259 -jsadebugd
173.260 +o
173.261 +jsadebugd(1)
173.262 .RE
173.263
173.264 .LP
173.265 -.SH 既知の問題
173.266 -混合モードのスタックトレース (
173.267 -.B \-m
173.268 -オプション) は、リモートデバッグサーバーでは機能しません。
173.269 +.SH "∝ャ"
173.270 +.LP
173.271 +
173.272 +.LP
173.273 +.LP
173.274 +羞桁≪若鴻帥若 (\-m 激с割戎) ≪若違泣若若с罘純障
173.275 +.LP
173.276 +
173.277 +.LP
173.278 +
174.1 --- a/src/solaris/doc/sun/man/man1/ja/jstat.1 Tue May 12 15:21:55 2009 +0900
174.2 +++ b/src/solaris/doc/sun/man/man1/ja/jstat.1 Thu May 14 00:17:25 2009 -0700
174.3 @@ -1,665 +1,5467 @@
174.4 -'\" t
174.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
174.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
174.7 -.\"
174.8 -.\" This code is free software; you can redistribute it and/or modify it
174.9 -.\" under the terms of the GNU General Public License version 2 only, as
174.10 -.\" published by the Free Software Foundation.
174.11 -.\"
174.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
174.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
174.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
174.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
174.16 -.\" accompanied this code).
174.17 -.\"
174.18 -.\" You should have received a copy of the GNU General Public License version
174.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
174.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
174.21 -.\"
174.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
174.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
174.24 -.\" have any questions.
174.25 -.\"
174.26 -.TH jstat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
174.27 -.SH 名前
174.28 -jstat \- Java 仮想マシン統計監視ツール
174.29 -.\"
174.30 -.SH 形式
174.31 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
174.32 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
174.33 +."
174.34 +." This code is free software; you can redistribute it and/or modify it
174.35 +." under the terms of the GNU General Public License version 2 only, as
174.36 +." published by the Free Software Foundation.
174.37 +."
174.38 +." This code is distributed in the hope that it will be useful, but WITHOUT
174.39 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
174.40 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
174.41 +." version 2 for more details (a copy is included in the LICENSE file that
174.42 +." accompanied this code).
174.43 +."
174.44 +." You should have received a copy of the GNU General Public License version
174.45 +." 2 along with this work; if not, write to the Free Software Foundation,
174.46 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
174.47 +."
174.48 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
174.49 +." CA 95054 USA or visit www.sun.com if you need additional information or
174.50 +." have any questions.
174.51 +."
174.52 +.TH jstat 1 "04 May 2009"
174.53 +." Generated from HTML by html2man (author: Eric Armstrong)
174.54 +
174.55 +.LP
174.56 +.SH ""
174.57 +jstat \- Java 篁潟激括輝荐若睡h若
174.58 +.LP
174.59 +.RS 3
174.60 +.TP 2
174.61 +o
174.62 +綵√
174.63 +.TP 2
174.64 +o
174.65 +<若
174.66 +.TP 2
174.67 +o
174.68 +茯
174.69 +.TP 2
174.70 +o
174.71 +篁潟激活ュ
174.72 +.TP 2
174.73 +o
174.74 +激с
174.75 +.br
174.76 +\ \ \- 筝激с
174.77 +.br
174.78 +\ \ \- 阪激с
174.79 +.TP 2
174.80 +o
174.81 +箴
174.82 +.TP 2
174.83 +o
174.84 +∫i
174.85 +.RE
174.86 +
174.87 +.LP
174.88 +.SH "綵√"
174.89 +.LP
174.90 +
174.91 +.LP
174.92 .nf
174.93 -\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP\f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
174.94 +\f3
174.95 +.fl
174.96 +\fP\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP \f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
174.97 .fl
174.98 .fi
174.99 -.SH パラメータ
174.100 -.if t .TP 20
174.101 -.if n .TP 15
174.102 -.I generalOption
174.103 -単一の汎用コマンド行オプション (
174.104 -.B \-help
174.105 -、
174.106 -.B \-options
174.107 -、または
174.108 -.B \-version
174.109 -)
174.110 -.if t .TP 20
174.111 -.if n .TP 15
174.112 -.I outputOptions
174.113 -1 つ以上の出力オプション。1 つの statOption と
174.114 -.B \-t
174.115 -、
174.116 -.B \-h
174.117 -、および
174.118 -.B \-J
174.119 -オプションのいずれかで構成されます。
174.120 -.if t .TP 20
174.121 -.if n .TP 15
174.122 -.I vmid
174.123 -仮想マシン識別子。ターゲットの Java 仮想マシン (JVM) を示す文字列。一般的な構文は、次のとおりです。
174.124 +
174.125 .LP
174.126 -.RS
174.127 -.ft 3
174.128 +.SH "<若"
174.129 +.LP
174.130 +
174.131 +.LP
174.132 +.RS 3
174.133 +.TP 3
174.134 +generalOption
174.135 +т戎筝潟潟茵激с潟с (\-help\-options障 \-version)
174.136 +.TP 3
174.137 +outputOptions
174.138 +筝 \f2statOption\fP \-t\-h \-J 激с潟腟水1 ゃ障茲違阪激с潟с
174.139 +.TP 3
174.140 +vmid
174.141 +帥若蚊 Java 篁潟激 (JVM) 腓冴絖с篁潟激活ュс筝罕罨<障
174.142 .nf
174.143 +\f3
174.144 +.fl
174.145 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
174.146 +.fl
174.147 .fi
174.148 -.ft 1
174.149 +vmid 絖罕紊чURI 罕絲上障\f2vmid\fP 若 JVM 茵膣贋違篆<潟若垩割絎茖堺ゃ腓冴茲罕障с障障違障荅括完篁潟激活ュс
174.150 +.TP 3
174.151 +interval[s|ms]
174.152 +腱 (s) 障腱 (ms) ≧絎篏с泣潟潟育с篏腱с\ 罩c贋違с違障\ 絎翫\f3jstat\fP interval 阪障
174.153 +.TP 3
174.154 +count
174.155 +茵腓冴泣潟違сゃ♂с ゃ障\f3jstat\fP 帥若蚊 JVM 腟篋障с障 \f3jstat\fP 潟潟腟篋障с腟沿若帥茵腓冴障 罩c贋医ゃ篏睡綽荀障
174.156 .RE
174.157 +
174.158 .LP
174.159 -vmid 文字列の構文は、URI の構文とほぼ同じです。vmid は、ローカル JVM を表す単純な整数から、通信プロトコル、ポート番号、およびその他の実装固有の値を指定する複雑な構造までさまざまです。詳しくは、以下の「仮想マシン識別子」を参照してください。
174.160 -.if t .TP 20
174.161 -.if n .TP 15
174.162 -.I interval[s|ms]
174.163 -指定された単位 (秒 (s) またはミリ秒 (ms) ) でのサンプリング間隔。デフォルトの単位はミリ秒です。正の整数でなければなりません。これが指定された場合、
174.164 -.B jstat
174.165 -は
174.166 -.I interval
174.167 -ごとに出力を生成します。
174.168 -.if t .TP 20
174.169 -.if n .TP 15
174.170 -.I count
174.171 -表示するサンプル数。デフォルトの値は infinity です。つまり、
174.172 -.B jstat
174.173 -はターゲット JVM が終了するか
174.174 -.B jstat
174.175 -コマンドが終了されるまで統計を表示します。正の整数でなければなりません。
174.176 -.SH 機能説明
174.177 -.B jstat
174.178 -ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) のパフォーマンス統計を表示します。ターゲット JVM は、仮想マシン識別子、すなわち、以下の
174.179 -.I vmid
174.180 -オプションによって識別されます。
174.181 +.SH " 茯"
174.182 .LP
174.183 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
174.184 -.SS 仮想マシン識別子
174.185 -vmid 文字列の構文は、URI の構文とほぼ同じです。
174.186 +
174.187 .LP
174.188 -.RS
174.189 -.ft 3
174.190 +.LP
174.191 +\f3jstat\fP 若荐臀 HotSpot Java 篁潟激 (JVM) 若潟合輝荐若帥茵腓冴障帥若蚊 JVM 篁潟激活ュゃ障筝荐 \f2vmid\fP 激с潟c茘ャ障
174.192 +.LP
174.193 +.LP
174.194 +\f3羈\fP: 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
174.195 +.br
174.196 +
174.197 +.LP
174.198 +.SS
174.199 +篁潟激活ュ
174.200 +.LP
174.201 +.RS 3
174.202 +
174.203 +.LP
174.204 +.LP
174.205 +\f2vmid\fP 絖罕紊чURI 罕絲上障
174.206 +.LP
174.207 .nf
174.208 -[protocol:][//]lvmid[@hostname][:port][/servername]
174.209 +\f3
174.210 +.fl
174.211 +[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP][:\f2port\fP][/\f2servername\fP]
174.212 +.fl
174.213 .fi
174.214 -.ft 1
174.215 +
174.216 +.LP
174.217 +.RS 3
174.218 +.TP 3
174.219 +protocol
174.220 +篆<潟с\f2protocol\fP ャ\f2hostname\fP 絎翫潟若堺若潟障\f2protocol\fP ャ\f2hostname\fP 絎翫潟 \f3rmi\fP 障
174.221 +.TP 3
174.222 +lvmid
174.223 +帥若蚊 JVM 若篁潟激活ュс\f2lvmid\fP 激鴻筝 JVM 筝茘ャ若堺ゃс\f2lvmid\fP 篁潟激活ュ筝綽荀膣с\f2lvmid\fP 腟九障с障筝帥若蚊 JVM 祉鴻絲障若c潟違激鴻祉壕ュсjps(1) 潟潟篏睡\f2lvmid\fP 絎с障障Unix 若с\f3ps\fP 潟潟篏睡Windows с Windows 帥鴻若吾c若篏睡\f2lvmid\fP 絎с障
174.224 +.TP 3
174.225 +hostname
174.226 +帥若蚊鴻腓冴鴻障 IP ≪鴻с\f2hostname\fP ャ翫帥若蚊鴻若鴻障
174.227 +.TP 3
174.228 +port
174.229 +≪若泣若若篆<若с\f2hostname\fP ャ\f2protocol\fP ф若潟絎翫\f2port\fP ∴障с違\f2port\fP <若帥宴絎茖c違障 \f3rmi\fP 潟翫\f2port\fP ≪若鴻筝 rmiregistry 若垩腓冴障\f2port\fP ャ\f2protocol\fP \f3rmi\fP 絎翫 rmiregistry 若 (1099) 篏睡障
174.230 +.TP 3
174.231 +servername
174.232 +<若帥宴絎茖c違障若潟翫c若∴障\f3rmi\fP 潟翫<若帥≪若鴻筝 RMI 純若鴻吾с腓冴障
174.233 .RE
174.234 -.if t .TP 20
174.235 -.if n .TP 15
174.236 -.I protocol
174.237 -通信プロトコル。
174.238 -.I protocol
174.239 -が省かれ、
174.240 -.I hostname
174.241 -が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。
174.242 -.I protocol
174.243 -が省かれ、
174.244 -.I hostname
174.245 -が指定された場合、デフォルトのプロトコルは rmi です。
174.246 -.if t .TP 20
174.247 -.if n .TP 15
174.248 -.I lvmid
174.249 -ターゲット JVM のローカル仮想マシン識別子。
174.250 -.I lvmid
174.251 -は、プラットフォーム固有の値であり、システム上の JVM を一意に識別します。
174.252 -.I lvmid
174.253 -は、仮想マシン識別子の唯一の必須コンポーネントです。
174.254 -.I lvmid
174.255 -は、一般に、ターゲット JVM プロセスのオペレーティングシステムのプロセス識別子ですが、必ずしもそうとは限りません。
174.256 -.B jps
174.257 -コマンドを使用して、
174.258 -.I lvmid
174.259 -を調べることができます。また、UNIX プラットフォームでは
174.260 -.B ps
174.261 -コマンドで、Windows ではタスクマネージャで
174.262 -.I lvmid
174.263 -を調べることができます。
174.264 -.if t .TP 20
174.265 -.if n .TP 15
174.266 -.I hostname
174.267 -ターゲットホストを示すホスト名または IP アドレス。
174.268 -.I hostname
174.269 -が省かれた場合、ターゲットホストはローカルホストです。
174.270 -.if t .TP 20
174.271 -.if n .TP 15
174.272 -.B port
174.273 -リモートサーバと通信するためのデフォルトポート。
174.274 -.I hostname
174.275 -が省かれるか、
174.276 -.I protocol
174.277 -が最適化されたローカルプロトコルを指定している場合、
174.278 -.B port
174.279 -は無視されます。そうでない場合、
174.280 -.B port
174.281 -パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、
174.282 -.B port
174.283 -はリモートホスト上の
174.284 -.B rmiregistry
174.285 -のポート番号を示します。
174.286 -.B port
174.287 -が省かれ、
174.288 -.I protocol
174.289 -が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。
174.290 -.if t .TP 20
174.291 -.if n .TP 15
174.292 -.I servername
174.293 -このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表します。
174.294 -.SH オプション
174.295 -.B jstat
174.296 -コマンドは、汎用オプションと出力オプションの 2 種類のオプションをサポートしています。汎用オプションを指定すると、
174.297 -.B jstat
174.298 -は簡単な使用法とバージョン情報を表示します。出力オプションによって、統計出力の内容と形式が決まります。
174.299 +
174.300 .LP
174.301 -注 - すべてのオプションとそれらの機能は、将来のリリースで変更または削除されることがあります。
174.302 -.SS 汎用オプション
174.303 -汎用オプションの 1 つを指定した場合、他のオプションやパラメータを指定することはできません。
174.304 -.if t .TP 20
174.305 -.if n .TP 15
174.306 -.BI \-help
174.307 -ヘルプメッセージを表示します。
174.308 -.if t .TP 20
174.309 -.if n .TP 15
174.310 -.BI \-version
174.311 -バージョン情報を表示します。
174.312 -.if t .TP 20
174.313 -.if n .TP 15
174.314 -.BI \-options
174.315 -統計オプションのリストを表示します。次の「出力オプション」を参照してください。
174.316 -.SS 出力オプション
174.317 -汎用オプションを指定しなかった場合は、出力オプションを指定することができます。出力オプションは、
174.318 -.B jstat
174.319 -の出力の内容と形式を決め、1 つの statOption と他のオプション (
174.320 -.B \-h
174.321 -、
174.322 -.B \-t
174.323 -、および
174.324 -.B \-J
174.325 -) のいずれかで構成されます。statOption は最初に指定する必要があります。
174.326 +.RE
174.327 +.SH "激с"
174.328 .LP
174.329 -出力は、列が空白文字で区切られた表として書式化されます。タイトルの付いた見出し行が列の内容を表します。
174.330 -.B \-h
174.331 -オプションを使用すると、見出しを表示する頻度を設定できます。列見出しの名前は、一般にオプション間で整合性が取れています。一般に、2 つのオプションで列の名前が同じになる場合、2 つの列のデータソースは同じです。
174.332 +
174.333 .LP
174.334 -.B \-t
174.335 -オプションを使用すると、出力の最初の列に Timestamp というラベルの付いたタイムスタンプ列が表示されます。Timestamp 列には、ターゲット JVM の起動からの経過時間が秒単位で表示されます。タイムスタンプの分解能は、さまざまな要因によって異なり、高負荷システムでは、遅延スレッドスケジューリングによって変動が生じることがあります。
174.336 .LP
174.337 -.I interval
174.338 -および
174.339 -.I count
174.340 -パラメータは、それぞれ
174.341 -.B jstat
174.342 -が出力を表示する頻度と回数を決めます。
174.343 +\f3jstat\fP 潟潟筝激с潟阪激с潟 2 ゃ帥ゃ激с潟泣若障筝激с潟篏睡翫\f3jstat\fP 膂≦篏睡潟若吾с恰宴茵腓冴障阪激с潟с腟沿若水阪絎鴻綵√絎障
174.344 +.br
174.345 +
174.346 .LP
174.347 -注 - 将来のリリースで形式が変更される可能性があるので、
174.348 -.B jstat
174.349 -の出力を解析するスクリプトは書かない方がよいでしょう。
174.350 -.B jstat
174.351 -出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを想定しておいてください。
174.352 -.if t .TP 20
174.353 -.if n .TP 15
174.354 -.BI \-statOption
174.355 -.B jstat が表示する統計情報を決めます。次の表に、使用可能なオプションを示します。\-options 汎用オプションを使用すると、特定のプラットフォームインストールでのオプションのリストが表示されます。
174.356 .LP
174.357 -.sp 1n
174.358 +\f3羈\fP: 鴻激с潟罘純絨ャ若鴻у眼障綮罩≪醇с障
174.359 +.LP
174.360 +.SS
174.361 +筝激с
174.362 +.LP
174.363 +.LP
174.364 +筝激с潟絎翫篁激с潟障<若帥筝絎с障
174.365 +.LP
174.366 +.RS 3
174.367 +.TP 3
174.368 +\-help
174.369 +<祉若吾茵腓冴障
174.370 +.TP 3
174.371 +\-version
174.372 +若吾с恰宴茵腓冴障
174.373 +.TP 3
174.374 +\-options
174.375 +腟沿若帥激с潟筝荀ц;腓冴障筝荐阪激с潟膀с
174.376 +.RE
174.377 +
174.378 +.LP
174.379 +.SS
174.380 +阪激с
174.381 +.LP
174.382 +.RS 3
174.383 +
174.384 +.LP
174.385 +.LP
174.386 +筝激с潟絎翫阪激с潟絎с障阪激с潟\f3jstat\fP 阪絎鴻喝就綣絎筝 \f2statOption\fP 篁阪激с (\-h\-t \-J) ф障\ \f2statOption\fP 荐菴違綽荀障
174.387 +.LP
174.388 +.LP
174.389 +阪腥榊純у阪若綵√ф障帥ゃ荐取茯荐障 \f3\-h\fP 激с潟篏睡若茵腓冴糸墾荐絎障\ 絽吾弱激с潟違c翫с筝莢障筝2 ゃ激с潟у篏睡違2 ゃ若帥純若鴻障
174.390 +.LP
174.391 +.LP
174.392 +\f3\-t\fP 激с潟篏睡\f2Timestamp\fP 篁帥ゃ鴻帥潟阪茵腓冴障\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏ц;腓冴障帥ゃ鴻帥潟膕上墾障障荀c違紊ч莢激c激鴻с鴻鴻宴吾ャ若綮吟紊障
174.393 +.LP
174.394 +.LP
174.395 +\f2interval\fP \f2count\fP <若帥篏睡\f3jstat\fP 阪茵腓冴糸墾違絎障
174.396 +.LP
174.397 +.LP
174.398 +\f3羈\fP: 絨ャ若鴻с綵√紊眼醇с\f3jstat\fP 阪茹f鴻篏с障\f3jstat\fP 阪茹f鴻篏翫若絨ャ若鴻с鴻紊眼違
174.399 +.LP
174.400 +.RS 3
174.401 +.TP 3
174.402 +\-statOption
174.403 +\f3jstat\fP 茵腓冴腟沿若炊宴絎障罨<茵純激с潟筝荀ц;腓冴障 劫若ゃ潟鴻若ゃ激с潟筝荀ц;腓冴筝激с潟 \f3\-options\fP 篏睡障
174.404 +.br
174.405 +.br
174.406 +.LP
174.407 .TS
174.408 -box;
174.409 -cbp-1 | cbp-1
174.410 -l | l .
174.411 -オプション 表示される情報
174.412 -_
174.413 -class クラスローダの動作に関する統計
174.414 -compiler T{
174.415 -HotSpot Just-In-Time コンパイラの動作に関する統計
174.416 -T}
174.417 -gc T{
174.418 -ガベージコレクトされたヒープの動作に関する統計
174.419 -T}
174.420 -gccapacity 世代の容量とそれらに対応する空間の統計
174.421 -gccause T{
174.422 -ガベージコレクション統計の要約 ( \-gcutil と同じ) と、
174.423 -前回および現在 (該当する場合) のガベージコレクション
174.424 -イベントの原因
174.425 -T}
174.426 -gcnew 新しい世代の動作の統計
174.427 -gcnewcapacity 新しい世代とそれらに対応する空間のサイズの統計
174.428 -gcold T{
174.429 -古い永続的世代の動作の統計
174.430 -T}
174.431 -gcoldcapacity 古い世代のサイズの統計
174.432 -gcpermcapacity 永続的世代のサイズの統計
174.433 -gcutil ガベージコレクション統計の要約
174.434 -printcompilation ガベージコレクション統計の要約
174.435 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.436 +.de 35
174.437 +.ps \n(.s
174.438 +.vs \n(.vu
174.439 +.in \n(.iu
174.440 +.if \n(.u .fi
174.441 +.if \n(.j .ad
174.442 +.if \n(.j=0 .na
174.443 +..
174.444 +.nf
174.445 +.nr #~ 0
174.446 +.if n .nr #~ 0.6n
174.447 +.ds #d .d
174.448 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.449 +.fc
174.450 +.nr 33 \n(.s
174.451 +.rm 80 81
174.452 +.nr 34 \n(.lu
174.453 +.eo
174.454 +.am 81
174.455 +.br
174.456 +.di a+
174.457 +.35
174.458 +.ft \n(.f
174.459 +.ll \n(34u*1u/3u
174.460 +.if \n(.l<\n(81 .ll \n(81u
174.461 +.in 0
174.462 +鴻若若篏≪腟沿若
174.463 +.br
174.464 +.di
174.465 +.nr a| \n(dn
174.466 +.nr a- \n(dl
174.467 +..
174.468 +.ec \
174.469 +.eo
174.470 +.am 81
174.471 +.br
174.472 +.di b+
174.473 +.35
174.474 +.ft \n(.f
174.475 +.ll \n(34u*1u/3u
174.476 +.if \n(.l<\n(81 .ll \n(81u
174.477 +.in 0
174.478 +HotSpot Just\-in\-Time 潟潟ゃ篏≪腟沿若
174.479 +.br
174.480 +.di
174.481 +.nr b| \n(dn
174.482 +.nr b- \n(dl
174.483 +..
174.484 +.ec \
174.485 +.eo
174.486 +.am 81
174.487 +.br
174.488 +.di c+
174.489 +.35
174.490 +.ft \n(.f
174.491 +.ll \n(34u*1u/3u
174.492 +.if \n(.l<\n(81 .ll \n(81u
174.493 +.in 0
174.494 +若吾潟若篏≪腟沿若
174.495 +.br
174.496 +.di
174.497 +.nr c| \n(dn
174.498 +.nr c- \n(dl
174.499 +..
174.500 +.ec \
174.501 +.eo
174.502 +.am 81
174.503 +.br
174.504 +.di d+
174.505 +.35
174.506 +.ft \n(.f
174.507 +.ll \n(34u*1u/3u
174.508 +.if \n(.l<\n(81 .ll \n(81u
174.509 +.in 0
174.510 +筝篁c絎拷絲上≪腟沿若
174.511 +.br
174.512 +.di
174.513 +.nr d| \n(dn
174.514 +.nr d- \n(dl
174.515 +..
174.516 +.ec \
174.517 +.eo
174.518 +.am 81
174.519 +.br
174.520 +.di e+
174.521 +.35
174.522 +.ft \n(.f
174.523 +.ll \n(34u*1u/3u
174.524 +.if \n(.l<\n(81 .ll \n(81u
174.525 +.in 0
174.526 +若吾潟激с括輝荐若帥网荀 (\f3\-gcutil\fP ) 翫括憜 (純翫) 若吾潟激с潟ゃ潟
174.527 +.br
174.528 +.di
174.529 +.nr e| \n(dn
174.530 +.nr e- \n(dl
174.531 +..
174.532 +.ec \
174.533 +.eo
174.534 +.am 81
174.535 +.br
174.536 +.di f+
174.537 +.35
174.538 +.ft \n(.f
174.539 +.ll \n(34u*1u/3u
174.540 +.if \n(.l<\n(81 .ll \n(81u
174.541 +.in 0
174.542 +New 筝篁c篏≪腟沿若
174.543 +.br
174.544 +.di
174.545 +.nr f| \n(dn
174.546 +.nr f- \n(dl
174.547 +..
174.548 +.ec \
174.549 +.eo
174.550 +.am 81
174.551 +.br
174.552 +.di g+
174.553 +.35
174.554 +.ft \n(.f
174.555 +.ll \n(34u*1u/3u
174.556 +.if \n(.l<\n(81 .ll \n(81u
174.557 +.in 0
174.558 +New 筝篁c泣ゃ冴絲上≪腟沿若
174.559 +.br
174.560 +.di
174.561 +.nr g| \n(dn
174.562 +.nr g- \n(dl
174.563 +..
174.564 +.ec \
174.565 +.eo
174.566 +.am 81
174.567 +.br
174.568 +.di h+
174.569 +.35
174.570 +.ft \n(.f
174.571 +.ll \n(34u*1u/3u
174.572 +.if \n(.l<\n(81 .ll \n(81u
174.573 +.in 0
174.574 +Old 筝篁c Permanent 筝篁c篏≪腟沿若
174.575 +.br
174.576 +.di
174.577 +.nr h| \n(dn
174.578 +.nr h- \n(dl
174.579 +..
174.580 +.ec \
174.581 +.eo
174.582 +.am 81
174.583 +.br
174.584 +.di i+
174.585 +.35
174.586 +.ft \n(.f
174.587 +.ll \n(34u*1u/3u
174.588 +.if \n(.l<\n(81 .ll \n(81u
174.589 +.in 0
174.590 +Old 筝篁c泣ゃ冴≪腟沿若
174.591 +.br
174.592 +.di
174.593 +.nr i| \n(dn
174.594 +.nr i- \n(dl
174.595 +..
174.596 +.ec \
174.597 +.eo
174.598 +.am 81
174.599 +.br
174.600 +.di j+
174.601 +.35
174.602 +.ft \n(.f
174.603 +.ll \n(34u*1u/3u
174.604 +.if \n(.l<\n(81 .ll \n(81u
174.605 +.in 0
174.606 +Permanent 筝篁c泣ゃ冴≪腟沿若
174.607 +.br
174.608 +.di
174.609 +.nr j| \n(dn
174.610 +.nr j- \n(dl
174.611 +..
174.612 +.ec \
174.613 +.eo
174.614 +.am 81
174.615 +.br
174.616 +.di k+
174.617 +.35
174.618 +.ft \n(.f
174.619 +.ll \n(34u*1u/3u
174.620 +.if \n(.l<\n(81 .ll \n(81u
174.621 +.in 0
174.622 +若吾潟激с括輝荐若帥网荀
174.623 +.br
174.624 +.di
174.625 +.nr k| \n(dn
174.626 +.nr k- \n(dl
174.627 +..
174.628 +.ec \
174.629 +.eo
174.630 +.am 81
174.631 +.br
174.632 +.di l+
174.633 +.35
174.634 +.ft \n(.f
174.635 +.ll \n(34u*1u/3u
174.636 +.if \n(.l<\n(81 .ll \n(81u
174.637 +.in 0
174.638 +HotSpot 潟潟ゃ号腟沿若
174.639 +.br
174.640 +.di
174.641 +.nr l| \n(dn
174.642 +.nr l- \n(dl
174.643 +..
174.644 +.ec \
174.645 +.35
174.646 +.nf
174.647 +.ll \n(34u
174.648 +.nr 80 0
174.649 +.nr 38 \w\f3激с\fP
174.650 +.if \n(80<\n(38 .nr 80 \n(38
174.651 +.nr 38 \wclass
174.652 +.if \n(80<\n(38 .nr 80 \n(38
174.653 +.nr 38 \wcompiler
174.654 +.if \n(80<\n(38 .nr 80 \n(38
174.655 +.nr 38 \wgc
174.656 +.if \n(80<\n(38 .nr 80 \n(38
174.657 +.nr 38 \wgccapacity
174.658 +.if \n(80<\n(38 .nr 80 \n(38
174.659 +.nr 38 \wgccause
174.660 +.if \n(80<\n(38 .nr 80 \n(38
174.661 +.nr 38 \wgcnew
174.662 +.if \n(80<\n(38 .nr 80 \n(38
174.663 +.nr 38 \wgcnewcapacity
174.664 +.if \n(80<\n(38 .nr 80 \n(38
174.665 +.nr 38 \wgcold
174.666 +.if \n(80<\n(38 .nr 80 \n(38
174.667 +.nr 38 \wgcoldcapacity
174.668 +.if \n(80<\n(38 .nr 80 \n(38
174.669 +.nr 38 \wgcpermcapacity
174.670 +.if \n(80<\n(38 .nr 80 \n(38
174.671 +.nr 38 \wgcutil
174.672 +.if \n(80<\n(38 .nr 80 \n(38
174.673 +.nr 38 \wprintcompilation
174.674 +.if \n(80<\n(38 .nr 80 \n(38
174.675 +.80
174.676 +.rm 80
174.677 +.nr 81 0
174.678 +.nr 38 \w\f3茵腓阪絎\fP
174.679 +.if \n(81<\n(38 .nr 81 \n(38
174.680 +.81
174.681 +.rm 81
174.682 +.nr 38 \n(a-
174.683 +.if \n(81<\n(38 .nr 81 \n(38
174.684 +.nr 38 \n(b-
174.685 +.if \n(81<\n(38 .nr 81 \n(38
174.686 +.nr 38 \n(c-
174.687 +.if \n(81<\n(38 .nr 81 \n(38
174.688 +.nr 38 \n(d-
174.689 +.if \n(81<\n(38 .nr 81 \n(38
174.690 +.nr 38 \n(e-
174.691 +.if \n(81<\n(38 .nr 81 \n(38
174.692 +.nr 38 \n(f-
174.693 +.if \n(81<\n(38 .nr 81 \n(38
174.694 +.nr 38 \n(g-
174.695 +.if \n(81<\n(38 .nr 81 \n(38
174.696 +.nr 38 \n(h-
174.697 +.if \n(81<\n(38 .nr 81 \n(38
174.698 +.nr 38 \n(i-
174.699 +.if \n(81<\n(38 .nr 81 \n(38
174.700 +.nr 38 \n(j-
174.701 +.if \n(81<\n(38 .nr 81 \n(38
174.702 +.nr 38 \n(k-
174.703 +.if \n(81<\n(38 .nr 81 \n(38
174.704 +.nr 38 \n(l-
174.705 +.if \n(81<\n(38 .nr 81 \n(38
174.706 +.35
174.707 +.nf
174.708 +.ll \n(34u
174.709 +.nr 38 1n
174.710 +.nr 79 0
174.711 +.nr 40 \n(79+(0*\n(38)
174.712 +.nr 80 +\n(40
174.713 +.nr 41 \n(80+(3*\n(38)
174.714 +.nr 81 +\n(41
174.715 +.nr TW \n(81
174.716 +.if t .if \n(TW>\n(.li .tm Table at line 260 file Input is too wide - \n(TW units
174.717 +.fc
174.718 +.nr #T 0-1
174.719 +.nr #a 0-1
174.720 +.eo
174.721 +.de T#
174.722 +.ds #d .d
174.723 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.724 +.mk ##
174.725 +.nr ## -1v
174.726 +.ls 1
174.727 +.ls
174.728 +..
174.729 +.ec
174.730 +.ta \n(80u \n(81u
174.731 +.nr 31 \n(.f
174.732 +.nr 35 1m
174.733 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茵腓阪絎\fP
174.734 +.ne \n(a|u+\n(.Vu
174.735 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.736 +.ta \n(80u \n(81u
174.737 +.nr 31 \n(.f
174.738 +.nr 35 1m
174.739 +\&\h'|\n(40u'class\h'|\n(41u'
174.740 +.mk ##
174.741 +.nr 31 \n(##
174.742 +.sp |\n(##u-1v
174.743 +.nr 37 \n(41u
174.744 +.in +\n(37u
174.745 +.a+
174.746 +.in -\n(37u
174.747 +.mk 32
174.748 +.if \n(32>\n(31 .nr 31 \n(32
174.749 +.sp |\n(31u
174.750 +.ne \n(b|u+\n(.Vu
174.751 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.752 +.ta \n(80u \n(81u
174.753 +.nr 31 \n(.f
174.754 +.nr 35 1m
174.755 +\&\h'|\n(40u'compiler\h'|\n(41u'
174.756 +.mk ##
174.757 +.nr 31 \n(##
174.758 +.sp |\n(##u-1v
174.759 +.nr 37 \n(41u
174.760 +.in +\n(37u
174.761 +.b+
174.762 +.in -\n(37u
174.763 +.mk 32
174.764 +.if \n(32>\n(31 .nr 31 \n(32
174.765 +.sp |\n(31u
174.766 +.ne \n(c|u+\n(.Vu
174.767 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.768 +.ta \n(80u \n(81u
174.769 +.nr 31 \n(.f
174.770 +.nr 35 1m
174.771 +\&\h'|\n(40u'gc\h'|\n(41u'
174.772 +.mk ##
174.773 +.nr 31 \n(##
174.774 +.sp |\n(##u-1v
174.775 +.nr 37 \n(41u
174.776 +.in +\n(37u
174.777 +.c+
174.778 +.in -\n(37u
174.779 +.mk 32
174.780 +.if \n(32>\n(31 .nr 31 \n(32
174.781 +.sp |\n(31u
174.782 +.ne \n(d|u+\n(.Vu
174.783 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.784 +.ta \n(80u \n(81u
174.785 +.nr 31 \n(.f
174.786 +.nr 35 1m
174.787 +\&\h'|\n(40u'gccapacity\h'|\n(41u'
174.788 +.mk ##
174.789 +.nr 31 \n(##
174.790 +.sp |\n(##u-1v
174.791 +.nr 37 \n(41u
174.792 +.in +\n(37u
174.793 +.d+
174.794 +.in -\n(37u
174.795 +.mk 32
174.796 +.if \n(32>\n(31 .nr 31 \n(32
174.797 +.sp |\n(31u
174.798 +.ne \n(e|u+\n(.Vu
174.799 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.800 +.ta \n(80u \n(81u
174.801 +.nr 31 \n(.f
174.802 +.nr 35 1m
174.803 +\&\h'|\n(40u'gccause\h'|\n(41u'
174.804 +.mk ##
174.805 +.nr 31 \n(##
174.806 +.sp |\n(##u-1v
174.807 +.nr 37 \n(41u
174.808 +.in +\n(37u
174.809 +.e+
174.810 +.in -\n(37u
174.811 +.mk 32
174.812 +.if \n(32>\n(31 .nr 31 \n(32
174.813 +.sp |\n(31u
174.814 +.ne \n(f|u+\n(.Vu
174.815 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.816 +.ta \n(80u \n(81u
174.817 +.nr 31 \n(.f
174.818 +.nr 35 1m
174.819 +\&\h'|\n(40u'gcnew\h'|\n(41u'
174.820 +.mk ##
174.821 +.nr 31 \n(##
174.822 +.sp |\n(##u-1v
174.823 +.nr 37 \n(41u
174.824 +.in +\n(37u
174.825 +.f+
174.826 +.in -\n(37u
174.827 +.mk 32
174.828 +.if \n(32>\n(31 .nr 31 \n(32
174.829 +.sp |\n(31u
174.830 +.ne \n(g|u+\n(.Vu
174.831 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.832 +.ta \n(80u \n(81u
174.833 +.nr 31 \n(.f
174.834 +.nr 35 1m
174.835 +\&\h'|\n(40u'gcnewcapacity\h'|\n(41u'
174.836 +.mk ##
174.837 +.nr 31 \n(##
174.838 +.sp |\n(##u-1v
174.839 +.nr 37 \n(41u
174.840 +.in +\n(37u
174.841 +.g+
174.842 +.in -\n(37u
174.843 +.mk 32
174.844 +.if \n(32>\n(31 .nr 31 \n(32
174.845 +.sp |\n(31u
174.846 +.ne \n(h|u+\n(.Vu
174.847 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.848 +.ta \n(80u \n(81u
174.849 +.nr 31 \n(.f
174.850 +.nr 35 1m
174.851 +\&\h'|\n(40u'gcold\h'|\n(41u'
174.852 +.mk ##
174.853 +.nr 31 \n(##
174.854 +.sp |\n(##u-1v
174.855 +.nr 37 \n(41u
174.856 +.in +\n(37u
174.857 +.h+
174.858 +.in -\n(37u
174.859 +.mk 32
174.860 +.if \n(32>\n(31 .nr 31 \n(32
174.861 +.sp |\n(31u
174.862 +.ne \n(i|u+\n(.Vu
174.863 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.864 +.ta \n(80u \n(81u
174.865 +.nr 31 \n(.f
174.866 +.nr 35 1m
174.867 +\&\h'|\n(40u'gcoldcapacity\h'|\n(41u'
174.868 +.mk ##
174.869 +.nr 31 \n(##
174.870 +.sp |\n(##u-1v
174.871 +.nr 37 \n(41u
174.872 +.in +\n(37u
174.873 +.i+
174.874 +.in -\n(37u
174.875 +.mk 32
174.876 +.if \n(32>\n(31 .nr 31 \n(32
174.877 +.sp |\n(31u
174.878 +.ne \n(j|u+\n(.Vu
174.879 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
174.880 +.ta \n(80u \n(81u
174.881 +.nr 31 \n(.f
174.882 +.nr 35 1m
174.883 +\&\h'|\n(40u'gcpermcapacity\h'|\n(41u'
174.884 +.mk ##
174.885 +.nr 31 \n(##
174.886 +.sp |\n(##u-1v
174.887 +.nr 37 \n(41u
174.888 +.in +\n(37u
174.889 +.j+
174.890 +.in -\n(37u
174.891 +.mk 32
174.892 +.if \n(32>\n(31 .nr 31 \n(32
174.893 +.sp |\n(31u
174.894 +.ne \n(k|u+\n(.Vu
174.895 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
174.896 +.ta \n(80u \n(81u
174.897 +.nr 31 \n(.f
174.898 +.nr 35 1m
174.899 +\&\h'|\n(40u'gcutil\h'|\n(41u'
174.900 +.mk ##
174.901 +.nr 31 \n(##
174.902 +.sp |\n(##u-1v
174.903 +.nr 37 \n(41u
174.904 +.in +\n(37u
174.905 +.k+
174.906 +.in -\n(37u
174.907 +.mk 32
174.908 +.if \n(32>\n(31 .nr 31 \n(32
174.909 +.sp |\n(31u
174.910 +.ne \n(l|u+\n(.Vu
174.911 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
174.912 +.ta \n(80u \n(81u
174.913 +.nr 31 \n(.f
174.914 +.nr 35 1m
174.915 +\&\h'|\n(40u'printcompilation\h'|\n(41u'
174.916 +.mk ##
174.917 +.nr 31 \n(##
174.918 +.sp |\n(##u-1v
174.919 +.nr 37 \n(41u
174.920 +.in +\n(37u
174.921 +.l+
174.922 +.in -\n(37u
174.923 +.mk 32
174.924 +.if \n(32>\n(31 .nr 31 \n(32
174.925 +.sp |\n(31u
174.926 +.fc
174.927 +.nr T. 1
174.928 +.T# 1
174.929 +.35
174.930 +.rm a+
174.931 +.rm b+
174.932 +.rm c+
174.933 +.rm d+
174.934 +.rm e+
174.935 +.rm f+
174.936 +.rm g+
174.937 +.rm h+
174.938 +.rm i+
174.939 +.rm j+
174.940 +.rm k+
174.941 +.rm l+
174.942 .TE
174.943 -.if t .TP 20
174.944 -.if n .TP 15
174.945 -.BI \-h " n"
174.946 -.I n
174.947 -個のサンプル (出力行
174.948 -.I n
174.949 -行) ごとに列見出しを表示します。
174.950 -.I n
174.951 -は正の整数です。デフォルト値は 0 であり、データの最初の行の上に列見出しを表示します。
174.952 -.if t .TP
174.953 -.if n .TP
174.954 -.BI \-t " n"
174.955 -出力の最初の列としてタイムスタンプ列を表示します。タイムスタンプは、ターゲット JVM が起動してからの時間です。
174.956 -.if t .TP
174.957 -.if n .TP
174.958 -.BI \-J javaOption
174.959 -.I javaOption
174.960 -を Java アプリケーション起動ツールに渡します。たとえば、
174.961 -.BI \-J \-Xms48m
174.962 -は、起動メモリを 48M バイトに設定します。オプションの完全なリストについては、以下のドキュメントを参照してください。
174.963 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-52
174.964 +.TP 3
174.965 +\-h n
174.966 +\f2n\fP 泣潟 (阪茵) 若茵腓冴 \f2n\fP 罩c贋医ゃゃ 0 若帥茵筝若茵腓冴
174.967 +.TP 3
174.968 +\-t n
174.969 +帥ゃ鴻帥潟阪茵腓冴帥ゃ鴻帥潟帥若蚊 JVM 莎桁腟
174.970 +.TP 3
174.971 +\-J javaOption
174.972 +\f2javaOption\fP \f3java\fP ≪宴若激с活儀若御検違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟絎鴻ゃjava(1)ャ<潟с
174.973 +.RE
174.974 +
174.975 +.LP
174.976 +.RE
174.977 +.SS
174.978 +statOption 阪
174.979 +.LP
174.980 +.RS 3
174.981 +
174.982 +.LP
174.983 +.LP
174.984 +篁ラ茵с\f3jstat\fP \f2statOption\fP 阪ゃ网荀腓冴障
174.985 +.br
174.986 +
174.987 +.LP
174.988 +.SS
174.989 +\-class 激с
174.990 +.LP
174.991 +.LP
174.992 +.TS
174.993 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.994 +.de 35
174.995 +.ps \n(.s
174.996 +.vs \n(.vu
174.997 +.in \n(.iu
174.998 +.if \n(.u .fi
174.999 +.if \n(.j .ad
174.1000 +.if \n(.j=0 .na
174.1001 +..
174.1002 +.nf
174.1003 +.nr #~ 0
174.1004 +.if n .nr #~ 0.6n
174.1005 +.ds #d .d
174.1006 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1007 +.fc
174.1008 +.nr 33 \n(.s
174.1009 +.rm 80 81
174.1010 +.nr 34 \n(.lu
174.1011 +.eo
174.1012 +.am 81
174.1013 +.br
174.1014 +.di a+
174.1015 +.35
174.1016 +.ft \n(.f
174.1017 +.ll \n(34u*1u/3u
174.1018 +.if \n(.l<\n(81 .ll \n(81u
174.1019 +.in 0
174.1020 +若鴻
174.1021 +.br
174.1022 +.di
174.1023 +.nr a| \n(dn
174.1024 +.nr a- \n(dl
174.1025 +..
174.1026 +.ec \
174.1027 +.eo
174.1028 +.am 81
174.1029 +.br
174.1030 +.di b+
174.1031 +.35
174.1032 +.ft \n(.f
174.1033 +.ll \n(34u*1u/3u
174.1034 +.if \n(.l<\n(81 .ll \n(81u
174.1035 +.in 0
174.1036 +若 K ゃ
174.1037 +.br
174.1038 +.di
174.1039 +.nr b| \n(dn
174.1040 +.nr b- \n(dl
174.1041 +..
174.1042 +.ec \
174.1043 +.eo
174.1044 +.am 81
174.1045 +.br
174.1046 +.di c+
174.1047 +.35
174.1048 +.ft \n(.f
174.1049 +.ll \n(34u*1u/3u
174.1050 +.if \n(.l<\n(81 .ll \n(81u
174.1051 +.in 0
174.1052 +≪潟若鴻
174.1053 +.br
174.1054 +.di
174.1055 +.nr c| \n(dn
174.1056 +.nr c- \n(dl
174.1057 +..
174.1058 +.ec \
174.1059 +.eo
174.1060 +.am 81
174.1061 +.br
174.1062 +.di d+
174.1063 +.35
174.1064 +.ft \n(.f
174.1065 +.ll \n(34u*1u/3u
174.1066 +.if \n(.l<\n(81 .ll \n(81u
174.1067 +.in 0
174.1068 +≪潟若 K ゃ
174.1069 +.br
174.1070 +.di
174.1071 +.nr d| \n(dn
174.1072 +.nr d- \n(dl
174.1073 +..
174.1074 +.ec \
174.1075 +.eo
174.1076 +.am 81
174.1077 +.br
174.1078 +.di e+
174.1079 +.35
174.1080 +.ft \n(.f
174.1081 +.ll \n(34u*1u/3u
174.1082 +.if \n(.l<\n(81 .ll \n(81u
174.1083 +.in 0
174.1084 +鴻若≪潟若荀
174.1085 +.br
174.1086 +.di
174.1087 +.nr e| \n(dn
174.1088 +.nr e- \n(dl
174.1089 +..
174.1090 +.ec \
174.1091 +.35
174.1092 +.nf
174.1093 +.ll \n(34u
174.1094 +.nr 80 0
174.1095 +.nr 38 \w鴻若若腟沿若
174.1096 +.if \n(80<\n(38 .nr 80 \n(38
174.1097 +.nr 38 \w\f3\fP
174.1098 +.if \n(80<\n(38 .nr 80 \n(38
174.1099 +.nr 38 \wLoaded
174.1100 +.if \n(80<\n(38 .nr 80 \n(38
174.1101 +.nr 38 \wBytes
174.1102 +.if \n(80<\n(38 .nr 80 \n(38
174.1103 +.nr 38 \wUnloaded
174.1104 +.if \n(80<\n(38 .nr 80 \n(38
174.1105 +.nr 38 \wBytes
174.1106 +.if \n(80<\n(38 .nr 80 \n(38
174.1107 +.nr 38 \wTime
174.1108 +.if \n(80<\n(38 .nr 80 \n(38
174.1109 +.80
174.1110 +.rm 80
174.1111 +.nr 81 0
174.1112 +.nr 38 \w\f3茯\fP
174.1113 +.if \n(81<\n(38 .nr 81 \n(38
174.1114 +.81
174.1115 +.rm 81
174.1116 +.nr 38 \n(a-
174.1117 +.if \n(81<\n(38 .nr 81 \n(38
174.1118 +.nr 38 \n(b-
174.1119 +.if \n(81<\n(38 .nr 81 \n(38
174.1120 +.nr 38 \n(c-
174.1121 +.if \n(81<\n(38 .nr 81 \n(38
174.1122 +.nr 38 \n(d-
174.1123 +.if \n(81<\n(38 .nr 81 \n(38
174.1124 +.nr 38 \n(e-
174.1125 +.if \n(81<\n(38 .nr 81 \n(38
174.1126 +.35
174.1127 +.nf
174.1128 +.ll \n(34u
174.1129 +.nr 38 1n
174.1130 +.nr 79 0
174.1131 +.nr 40 \n(79+(0*\n(38)
174.1132 +.nr 80 +\n(40
174.1133 +.nr 41 \n(80+(3*\n(38)
174.1134 +.nr 81 +\n(41
174.1135 +.nr TW \n(81
174.1136 +.if t .if \n(TW>\n(.li .tm Table at line 314 file Input is too wide - \n(TW units
174.1137 +.fc
174.1138 +.nr #T 0-1
174.1139 +.nr #a 0-1
174.1140 +.eo
174.1141 +.de T#
174.1142 +.ds #d .d
174.1143 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1144 +.mk ##
174.1145 +.nr ## -1v
174.1146 +.ls 1
174.1147 +.ls
174.1148 +..
174.1149 +.ec
174.1150 +.ta \n(80u \n(81u
174.1151 +.nr 31 \n(.f
174.1152 +.nr 35 1m
174.1153 +\&\h'|\n(40u'鴻若若腟沿若\h'|\n(41u'
174.1154 +.ta \n(80u \n(81u
174.1155 +.nr 31 \n(.f
174.1156 +.nr 35 1m
174.1157 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.1158 +.ne \n(a|u+\n(.Vu
174.1159 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.1160 +.ta \n(80u \n(81u
174.1161 +.nr 31 \n(.f
174.1162 +.nr 35 1m
174.1163 +\&\h'|\n(40u'Loaded\h'|\n(41u'
174.1164 +.mk ##
174.1165 +.nr 31 \n(##
174.1166 +.sp |\n(##u-1v
174.1167 +.nr 37 \n(41u
174.1168 +.in +\n(37u
174.1169 +.a+
174.1170 +.in -\n(37u
174.1171 +.mk 32
174.1172 +.if \n(32>\n(31 .nr 31 \n(32
174.1173 +.sp |\n(31u
174.1174 +.ne \n(b|u+\n(.Vu
174.1175 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.1176 +.ta \n(80u \n(81u
174.1177 +.nr 31 \n(.f
174.1178 +.nr 35 1m
174.1179 +\&\h'|\n(40u'Bytes\h'|\n(41u'
174.1180 +.mk ##
174.1181 +.nr 31 \n(##
174.1182 +.sp |\n(##u-1v
174.1183 +.nr 37 \n(41u
174.1184 +.in +\n(37u
174.1185 +.b+
174.1186 +.in -\n(37u
174.1187 +.mk 32
174.1188 +.if \n(32>\n(31 .nr 31 \n(32
174.1189 +.sp |\n(31u
174.1190 +.ne \n(c|u+\n(.Vu
174.1191 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.1192 +.ta \n(80u \n(81u
174.1193 +.nr 31 \n(.f
174.1194 +.nr 35 1m
174.1195 +\&\h'|\n(40u'Unloaded\h'|\n(41u'
174.1196 +.mk ##
174.1197 +.nr 31 \n(##
174.1198 +.sp |\n(##u-1v
174.1199 +.nr 37 \n(41u
174.1200 +.in +\n(37u
174.1201 +.c+
174.1202 +.in -\n(37u
174.1203 +.mk 32
174.1204 +.if \n(32>\n(31 .nr 31 \n(32
174.1205 +.sp |\n(31u
174.1206 +.ne \n(d|u+\n(.Vu
174.1207 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.1208 +.ta \n(80u \n(81u
174.1209 +.nr 31 \n(.f
174.1210 +.nr 35 1m
174.1211 +\&\h'|\n(40u'Bytes\h'|\n(41u'
174.1212 +.mk ##
174.1213 +.nr 31 \n(##
174.1214 +.sp |\n(##u-1v
174.1215 +.nr 37 \n(41u
174.1216 +.in +\n(37u
174.1217 +.d+
174.1218 +.in -\n(37u
174.1219 +.mk 32
174.1220 +.if \n(32>\n(31 .nr 31 \n(32
174.1221 +.sp |\n(31u
174.1222 +.ne \n(e|u+\n(.Vu
174.1223 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.1224 +.ta \n(80u \n(81u
174.1225 +.nr 31 \n(.f
174.1226 +.nr 35 1m
174.1227 +\&\h'|\n(40u'Time\h'|\n(41u'
174.1228 +.mk ##
174.1229 +.nr 31 \n(##
174.1230 +.sp |\n(##u-1v
174.1231 +.nr 37 \n(41u
174.1232 +.in +\n(37u
174.1233 +.e+
174.1234 +.in -\n(37u
174.1235 +.mk 32
174.1236 +.if \n(32>\n(31 .nr 31 \n(32
174.1237 +.sp |\n(31u
174.1238 +.fc
174.1239 +.nr T. 1
174.1240 +.T# 1
174.1241 +.35
174.1242 +.rm a+
174.1243 +.rm b+
174.1244 +.rm c+
174.1245 +.rm d+
174.1246 +.rm e+
174.1247 +.TE
174.1248 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-25
174.1249 +
174.1250 +.LP
174.1251 +.SS
174.1252 +\-compiler 激с
174.1253 +.LP
174.1254 +.LP
174.1255 +.TS
174.1256 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.1257 +.de 35
174.1258 +.ps \n(.s
174.1259 +.vs \n(.vu
174.1260 +.in \n(.iu
174.1261 +.if \n(.u .fi
174.1262 +.if \n(.j .ad
174.1263 +.if \n(.j=0 .na
174.1264 +..
174.1265 +.nf
174.1266 +.nr #~ 0
174.1267 +.if n .nr #~ 0.6n
174.1268 +.ds #d .d
174.1269 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1270 +.fc
174.1271 +.nr 33 \n(.s
174.1272 +.rm 80 81
174.1273 +.nr 34 \n(.lu
174.1274 +.eo
174.1275 +.am 81
174.1276 +.br
174.1277 +.di a+
174.1278 +.35
174.1279 +.ft \n(.f
174.1280 +.ll \n(34u*1u/3u
174.1281 +.if \n(.l<\n(81 .ll \n(81u
174.1282 +.in 0
174.1283 +絎茵潟潟ゃ帥鴻
174.1284 +.br
174.1285 +.di
174.1286 +.nr a| \n(dn
174.1287 +.nr a- \n(dl
174.1288 +..
174.1289 +.ec \
174.1290 +.eo
174.1291 +.am 81
174.1292 +.br
174.1293 +.di b+
174.1294 +.35
174.1295 +.ft \n(.f
174.1296 +.ll \n(34u*1u/3u
174.1297 +.if \n(.l<\n(81 .ll \n(81u
174.1298 +.in 0
174.1299 +紊掩潟潟ゃ帥鴻
174.1300 +.br
174.1301 +.di
174.1302 +.nr b| \n(dn
174.1303 +.nr b- \n(dl
174.1304 +..
174.1305 +.ec \
174.1306 +.eo
174.1307 +.am 81
174.1308 +.br
174.1309 +.di c+
174.1310 +.35
174.1311 +.ft \n(.f
174.1312 +.ll \n(34u*1u/3u
174.1313 +.if \n(.l<\n(81 .ll \n(81u
174.1314 +.in 0
174.1315 +≦鴻潟潟ゃ帥鴻
174.1316 +.br
174.1317 +.di
174.1318 +.nr c| \n(dn
174.1319 +.nr c- \n(dl
174.1320 +..
174.1321 +.ec \
174.1322 +.eo
174.1323 +.am 81
174.1324 +.br
174.1325 +.di d+
174.1326 +.35
174.1327 +.ft \n(.f
174.1328 +.ll \n(34u*1u/3u
174.1329 +.if \n(.l<\n(81 .ll \n(81u
174.1330 +.in 0
174.1331 +潟潟ゃ帥鴻絎茵荀
174.1332 +.br
174.1333 +.di
174.1334 +.nr d| \n(dn
174.1335 +.nr d- \n(dl
174.1336 +..
174.1337 +.ec \
174.1338 +.eo
174.1339 +.am 81
174.1340 +.br
174.1341 +.di e+
174.1342 +.35
174.1343 +.ft \n(.f
174.1344 +.ll \n(34u*1u/3u
174.1345 +.if \n(.l<\n(81 .ll \n(81u
174.1346 +.in 0
174.1347 +緇紊掩潟潟ゃ潟潟ゃ帥ゃ
174.1348 +.br
174.1349 +.di
174.1350 +.nr e| \n(dn
174.1351 +.nr e- \n(dl
174.1352 +..
174.1353 +.ec \
174.1354 +.eo
174.1355 +.am 81
174.1356 +.br
174.1357 +.di f+
174.1358 +.35
174.1359 +.ft \n(.f
174.1360 +.ll \n(34u*1u/3u
174.1361 +.if \n(.l<\n(81 .ll \n(81u
174.1362 +.in 0
174.1363 +緇紊掩潟潟ゃ劫<純
174.1364 +.br
174.1365 +.di
174.1366 +.nr f| \n(dn
174.1367 +.nr f- \n(dl
174.1368 +..
174.1369 +.ec \
174.1370 +.35
174.1371 +.nf
174.1372 +.ll \n(34u
174.1373 +.nr 80 0
174.1374 +.nr 38 \wHotSpot Just\-In\-Time 潟潟ゃ腟沿若
174.1375 +.if \n(80<\n(38 .nr 80 \n(38
174.1376 +.nr 38 \w\f3\fP
174.1377 +.if \n(80<\n(38 .nr 80 \n(38
174.1378 +.nr 38 \wCompiled
174.1379 +.if \n(80<\n(38 .nr 80 \n(38
174.1380 +.nr 38 \wFailed
174.1381 +.if \n(80<\n(38 .nr 80 \n(38
174.1382 +.nr 38 \wInvalid
174.1383 +.if \n(80<\n(38 .nr 80 \n(38
174.1384 +.nr 38 \wTime
174.1385 +.if \n(80<\n(38 .nr 80 \n(38
174.1386 +.nr 38 \wFailedType
174.1387 +.if \n(80<\n(38 .nr 80 \n(38
174.1388 +.nr 38 \wFailedMethod
174.1389 +.if \n(80<\n(38 .nr 80 \n(38
174.1390 +.80
174.1391 +.rm 80
174.1392 +.nr 81 0
174.1393 +.nr 38 \w\f3茯\fP
174.1394 +.if \n(81<\n(38 .nr 81 \n(38
174.1395 +.81
174.1396 +.rm 81
174.1397 +.nr 38 \n(a-
174.1398 +.if \n(81<\n(38 .nr 81 \n(38
174.1399 +.nr 38 \n(b-
174.1400 +.if \n(81<\n(38 .nr 81 \n(38
174.1401 +.nr 38 \n(c-
174.1402 +.if \n(81<\n(38 .nr 81 \n(38
174.1403 +.nr 38 \n(d-
174.1404 +.if \n(81<\n(38 .nr 81 \n(38
174.1405 +.nr 38 \n(e-
174.1406 +.if \n(81<\n(38 .nr 81 \n(38
174.1407 +.nr 38 \n(f-
174.1408 +.if \n(81<\n(38 .nr 81 \n(38
174.1409 +.35
174.1410 +.nf
174.1411 +.ll \n(34u
174.1412 +.nr 38 1n
174.1413 +.nr 79 0
174.1414 +.nr 40 \n(79+(0*\n(38)
174.1415 +.nr 80 +\n(40
174.1416 +.nr 41 \n(80+(3*\n(38)
174.1417 +.nr 81 +\n(41
174.1418 +.nr TW \n(81
174.1419 +.if t .if \n(TW>\n(.li .tm Table at line 350 file Input is too wide - \n(TW units
174.1420 +.fc
174.1421 +.nr #T 0-1
174.1422 +.nr #a 0-1
174.1423 +.eo
174.1424 +.de T#
174.1425 +.ds #d .d
174.1426 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1427 +.mk ##
174.1428 +.nr ## -1v
174.1429 +.ls 1
174.1430 +.ls
174.1431 +..
174.1432 +.ec
174.1433 +.ta \n(80u \n(81u
174.1434 +.nr 31 \n(.f
174.1435 +.nr 35 1m
174.1436 +\&\h'|\n(40u'HotSpot Just\-In\-Time 潟潟ゃ腟沿若\h'|\n(41u'
174.1437 +.ta \n(80u \n(81u
174.1438 +.nr 31 \n(.f
174.1439 +.nr 35 1m
174.1440 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.1441 +.ne \n(a|u+\n(.Vu
174.1442 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.1443 +.ta \n(80u \n(81u
174.1444 +.nr 31 \n(.f
174.1445 +.nr 35 1m
174.1446 +\&\h'|\n(40u'Compiled\h'|\n(41u'
174.1447 +.mk ##
174.1448 +.nr 31 \n(##
174.1449 +.sp |\n(##u-1v
174.1450 +.nr 37 \n(41u
174.1451 +.in +\n(37u
174.1452 +.a+
174.1453 +.in -\n(37u
174.1454 +.mk 32
174.1455 +.if \n(32>\n(31 .nr 31 \n(32
174.1456 +.sp |\n(31u
174.1457 +.ne \n(b|u+\n(.Vu
174.1458 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.1459 +.ta \n(80u \n(81u
174.1460 +.nr 31 \n(.f
174.1461 +.nr 35 1m
174.1462 +\&\h'|\n(40u'Failed\h'|\n(41u'
174.1463 +.mk ##
174.1464 +.nr 31 \n(##
174.1465 +.sp |\n(##u-1v
174.1466 +.nr 37 \n(41u
174.1467 +.in +\n(37u
174.1468 +.b+
174.1469 +.in -\n(37u
174.1470 +.mk 32
174.1471 +.if \n(32>\n(31 .nr 31 \n(32
174.1472 +.sp |\n(31u
174.1473 +.ne \n(c|u+\n(.Vu
174.1474 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.1475 +.ta \n(80u \n(81u
174.1476 +.nr 31 \n(.f
174.1477 +.nr 35 1m
174.1478 +\&\h'|\n(40u'Invalid\h'|\n(41u'
174.1479 +.mk ##
174.1480 +.nr 31 \n(##
174.1481 +.sp |\n(##u-1v
174.1482 +.nr 37 \n(41u
174.1483 +.in +\n(37u
174.1484 +.c+
174.1485 +.in -\n(37u
174.1486 +.mk 32
174.1487 +.if \n(32>\n(31 .nr 31 \n(32
174.1488 +.sp |\n(31u
174.1489 +.ne \n(d|u+\n(.Vu
174.1490 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.1491 +.ta \n(80u \n(81u
174.1492 +.nr 31 \n(.f
174.1493 +.nr 35 1m
174.1494 +\&\h'|\n(40u'Time\h'|\n(41u'
174.1495 +.mk ##
174.1496 +.nr 31 \n(##
174.1497 +.sp |\n(##u-1v
174.1498 +.nr 37 \n(41u
174.1499 +.in +\n(37u
174.1500 +.d+
174.1501 +.in -\n(37u
174.1502 +.mk 32
174.1503 +.if \n(32>\n(31 .nr 31 \n(32
174.1504 +.sp |\n(31u
174.1505 +.ne \n(e|u+\n(.Vu
174.1506 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.1507 +.ta \n(80u \n(81u
174.1508 +.nr 31 \n(.f
174.1509 +.nr 35 1m
174.1510 +\&\h'|\n(40u'FailedType\h'|\n(41u'
174.1511 +.mk ##
174.1512 +.nr 31 \n(##
174.1513 +.sp |\n(##u-1v
174.1514 +.nr 37 \n(41u
174.1515 +.in +\n(37u
174.1516 +.e+
174.1517 +.in -\n(37u
174.1518 +.mk 32
174.1519 +.if \n(32>\n(31 .nr 31 \n(32
174.1520 +.sp |\n(31u
174.1521 +.ne \n(f|u+\n(.Vu
174.1522 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.1523 +.ta \n(80u \n(81u
174.1524 +.nr 31 \n(.f
174.1525 +.nr 35 1m
174.1526 +\&\h'|\n(40u'FailedMethod\h'|\n(41u'
174.1527 +.mk ##
174.1528 +.nr 31 \n(##
174.1529 +.sp |\n(##u-1v
174.1530 +.nr 37 \n(41u
174.1531 +.in +\n(37u
174.1532 +.f+
174.1533 +.in -\n(37u
174.1534 +.mk 32
174.1535 +.if \n(32>\n(31 .nr 31 \n(32
174.1536 +.sp |\n(31u
174.1537 +.fc
174.1538 +.nr T. 1
174.1539 +.T# 1
174.1540 +.35
174.1541 +.rm a+
174.1542 +.rm b+
174.1543 +.rm c+
174.1544 +.rm d+
174.1545 +.rm e+
174.1546 +.rm f+
174.1547 +.TE
174.1548 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-29
174.1549 +
174.1550 +.LP
174.1551 +.SS
174.1552 +\-gc 激с
174.1553 +.LP
174.1554 +.LP
174.1555 +.TS
174.1556 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.1557 +.de 35
174.1558 +.ps \n(.s
174.1559 +.vs \n(.vu
174.1560 +.in \n(.iu
174.1561 +.if \n(.u .fi
174.1562 +.if \n(.j .ad
174.1563 +.if \n(.j=0 .na
174.1564 +..
174.1565 +.nf
174.1566 +.nr #~ 0
174.1567 +.if n .nr #~ 0.6n
174.1568 +.ds #d .d
174.1569 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1570 +.fc
174.1571 +.nr 33 \n(.s
174.1572 +.rm 80 81
174.1573 +.nr 34 \n(.lu
174.1574 +.eo
174.1575 +.am 81
174.1576 +.br
174.1577 +.di a+
174.1578 +.35
174.1579 +.ft \n(.f
174.1580 +.ll \n(34u*1u/3u
174.1581 +.if \n(.l<\n(81 .ll \n(81u
174.1582 +.in 0
174.1583 +Survivor 0 憜絎拷 (KB)
174.1584 +.br
174.1585 +.di
174.1586 +.nr a| \n(dn
174.1587 +.nr a- \n(dl
174.1588 +..
174.1589 +.ec \
174.1590 +.eo
174.1591 +.am 81
174.1592 +.br
174.1593 +.di b+
174.1594 +.35
174.1595 +.ft \n(.f
174.1596 +.ll \n(34u*1u/3u
174.1597 +.if \n(.l<\n(81 .ll \n(81u
174.1598 +.in 0
174.1599 +Survivor 1 憜絎拷 (KB)
174.1600 +.br
174.1601 +.di
174.1602 +.nr b| \n(dn
174.1603 +.nr b- \n(dl
174.1604 +..
174.1605 +.ec \
174.1606 +.eo
174.1607 +.am 81
174.1608 +.br
174.1609 +.di c+
174.1610 +.35
174.1611 +.ft \n(.f
174.1612 +.ll \n(34u*1u/3u
174.1613 +.if \n(.l<\n(81 .ll \n(81u
174.1614 +.in 0
174.1615 +Survivor 0 篏睡 (KB)
174.1616 +.br
174.1617 +.di
174.1618 +.nr c| \n(dn
174.1619 +.nr c- \n(dl
174.1620 +..
174.1621 +.ec \
174.1622 +.eo
174.1623 +.am 81
174.1624 +.br
174.1625 +.di d+
174.1626 +.35
174.1627 +.ft \n(.f
174.1628 +.ll \n(34u*1u/3u
174.1629 +.if \n(.l<\n(81 .ll \n(81u
174.1630 +.in 0
174.1631 +Survivor 1 篏睡 (KB)
174.1632 +.br
174.1633 +.di
174.1634 +.nr d| \n(dn
174.1635 +.nr d- \n(dl
174.1636 +..
174.1637 +.ec \
174.1638 +.eo
174.1639 +.am 81
174.1640 +.br
174.1641 +.di e+
174.1642 +.35
174.1643 +.ft \n(.f
174.1644 +.ll \n(34u*1u/3u
174.1645 +.if \n(.l<\n(81 .ll \n(81u
174.1646 +.in 0
174.1647 +Eden 憜絎拷 (KB)
174.1648 +.br
174.1649 +.di
174.1650 +.nr e| \n(dn
174.1651 +.nr e- \n(dl
174.1652 +..
174.1653 +.ec \
174.1654 +.eo
174.1655 +.am 81
174.1656 +.br
174.1657 +.di f+
174.1658 +.35
174.1659 +.ft \n(.f
174.1660 +.ll \n(34u*1u/3u
174.1661 +.if \n(.l<\n(81 .ll \n(81u
174.1662 +.in 0
174.1663 +Eden 篏睡 (KB)
174.1664 +.br
174.1665 +.di
174.1666 +.nr f| \n(dn
174.1667 +.nr f- \n(dl
174.1668 +..
174.1669 +.ec \
174.1670 +.eo
174.1671 +.am 81
174.1672 +.br
174.1673 +.di g+
174.1674 +.35
174.1675 +.ft \n(.f
174.1676 +.ll \n(34u*1u/3u
174.1677 +.if \n(.l<\n(81 .ll \n(81u
174.1678 +.in 0
174.1679 +Old 憜絎拷 (KB)
174.1680 +.br
174.1681 +.di
174.1682 +.nr g| \n(dn
174.1683 +.nr g- \n(dl
174.1684 +..
174.1685 +.ec \
174.1686 +.eo
174.1687 +.am 81
174.1688 +.br
174.1689 +.di h+
174.1690 +.35
174.1691 +.ft \n(.f
174.1692 +.ll \n(34u*1u/3u
174.1693 +.if \n(.l<\n(81 .ll \n(81u
174.1694 +.in 0
174.1695 +Old 篏睡 (KB)
174.1696 +.br
174.1697 +.di
174.1698 +.nr h| \n(dn
174.1699 +.nr h- \n(dl
174.1700 +..
174.1701 +.ec \
174.1702 +.eo
174.1703 +.am 81
174.1704 +.br
174.1705 +.di i+
174.1706 +.35
174.1707 +.ft \n(.f
174.1708 +.ll \n(34u*1u/3u
174.1709 +.if \n(.l<\n(81 .ll \n(81u
174.1710 +.in 0
174.1711 +Permanent 憜絎拷 (KB)
174.1712 +.br
174.1713 +.di
174.1714 +.nr i| \n(dn
174.1715 +.nr i- \n(dl
174.1716 +..
174.1717 +.ec \
174.1718 +.eo
174.1719 +.am 81
174.1720 +.br
174.1721 +.di j+
174.1722 +.35
174.1723 +.ft \n(.f
174.1724 +.ll \n(34u*1u/3u
174.1725 +.if \n(.l<\n(81 .ll \n(81u
174.1726 +.in 0
174.1727 +Permanent 篏睡 (KB)
174.1728 +.br
174.1729 +.di
174.1730 +.nr j| \n(dn
174.1731 +.nr j- \n(dl
174.1732 +..
174.1733 +.ec \
174.1734 +.eo
174.1735 +.am 81
174.1736 +.br
174.1737 +.di k+
174.1738 +.35
174.1739 +.ft \n(.f
174.1740 +.ll \n(34u*1u/3u
174.1741 +.if \n(.l<\n(81 .ll \n(81u
174.1742 +.in 0
174.1743 +ャ筝篁c GC ゃ潟
174.1744 +.br
174.1745 +.di
174.1746 +.nr k| \n(dn
174.1747 +.nr k- \n(dl
174.1748 +..
174.1749 +.ec \
174.1750 +.eo
174.1751 +.am 81
174.1752 +.br
174.1753 +.di l+
174.1754 +.35
174.1755 +.ft \n(.f
174.1756 +.ll \n(34u*1u/3u
174.1757 +.if \n(.l<\n(81 .ll \n(81u
174.1758 +.in 0
174.1759 +ャ筝篁c若吾潟激с恰
174.1760 +.br
174.1761 +.di
174.1762 +.nr l| \n(dn
174.1763 +.nr l- \n(dl
174.1764 +..
174.1765 +.ec \
174.1766 +.eo
174.1767 +.am 81
174.1768 +.br
174.1769 +.di m+
174.1770 +.35
174.1771 +.ft \n(.f
174.1772 +.ll \n(34u*1u/3u
174.1773 +.if \n(.l<\n(81 .ll \n(81u
174.1774 +.in 0
174.1775 +若吾潟激с恰
174.1776 +.br
174.1777 +.di
174.1778 +.nr m| \n(dn
174.1779 +.nr m- \n(dl
174.1780 +..
174.1781 +.ec \
174.1782 +.eo
174.1783 +.am 81
174.1784 +.br
174.1785 +.di n+
174.1786 +.35
174.1787 +.ft \n(.f
174.1788 +.ll \n(34u*1u/3u
174.1789 +.if \n(.l<\n(81 .ll \n(81u
174.1790 +.in 0
174.1791 +若吾潟激с括
174.1792 +.br
174.1793 +.di
174.1794 +.nr n| \n(dn
174.1795 +.nr n- \n(dl
174.1796 +..
174.1797 +.ec \
174.1798 +.35
174.1799 +.nf
174.1800 +.ll \n(34u
174.1801 +.nr 80 0
174.1802 +.nr 38 \w若吾潟若腟沿若
174.1803 +.if \n(80<\n(38 .nr 80 \n(38
174.1804 +.nr 38 \w\f3\fP
174.1805 +.if \n(80<\n(38 .nr 80 \n(38
174.1806 +.nr 38 \wS0C
174.1807 +.if \n(80<\n(38 .nr 80 \n(38
174.1808 +.nr 38 \wS1C
174.1809 +.if \n(80<\n(38 .nr 80 \n(38
174.1810 +.nr 38 \wS0U
174.1811 +.if \n(80<\n(38 .nr 80 \n(38
174.1812 +.nr 38 \wS1U
174.1813 +.if \n(80<\n(38 .nr 80 \n(38
174.1814 +.nr 38 \wEC
174.1815 +.if \n(80<\n(38 .nr 80 \n(38
174.1816 +.nr 38 \wEU
174.1817 +.if \n(80<\n(38 .nr 80 \n(38
174.1818 +.nr 38 \wOC
174.1819 +.if \n(80<\n(38 .nr 80 \n(38
174.1820 +.nr 38 \wOU
174.1821 +.if \n(80<\n(38 .nr 80 \n(38
174.1822 +.nr 38 \wPC
174.1823 +.if \n(80<\n(38 .nr 80 \n(38
174.1824 +.nr 38 \wPU
174.1825 +.if \n(80<\n(38 .nr 80 \n(38
174.1826 +.nr 38 \wYGC
174.1827 +.if \n(80<\n(38 .nr 80 \n(38
174.1828 +.nr 38 \wYGCT
174.1829 +.if \n(80<\n(38 .nr 80 \n(38
174.1830 +.nr 38 \wFGC
174.1831 +.if \n(80<\n(38 .nr 80 \n(38
174.1832 +.nr 38 \wFGCT
174.1833 +.if \n(80<\n(38 .nr 80 \n(38
174.1834 +.nr 38 \wGCT
174.1835 +.if \n(80<\n(38 .nr 80 \n(38
174.1836 +.80
174.1837 +.rm 80
174.1838 +.nr 81 0
174.1839 +.nr 38 \w\f3茯\fP
174.1840 +.if \n(81<\n(38 .nr 81 \n(38
174.1841 +.nr 38 \w GC ゃ潟
174.1842 +.if \n(81<\n(38 .nr 81 \n(38
174.1843 +.81
174.1844 +.rm 81
174.1845 +.nr 38 \n(a-
174.1846 +.if \n(81<\n(38 .nr 81 \n(38
174.1847 +.nr 38 \n(b-
174.1848 +.if \n(81<\n(38 .nr 81 \n(38
174.1849 +.nr 38 \n(c-
174.1850 +.if \n(81<\n(38 .nr 81 \n(38
174.1851 +.nr 38 \n(d-
174.1852 +.if \n(81<\n(38 .nr 81 \n(38
174.1853 +.nr 38 \n(e-
174.1854 +.if \n(81<\n(38 .nr 81 \n(38
174.1855 +.nr 38 \n(f-
174.1856 +.if \n(81<\n(38 .nr 81 \n(38
174.1857 +.nr 38 \n(g-
174.1858 +.if \n(81<\n(38 .nr 81 \n(38
174.1859 +.nr 38 \n(h-
174.1860 +.if \n(81<\n(38 .nr 81 \n(38
174.1861 +.nr 38 \n(i-
174.1862 +.if \n(81<\n(38 .nr 81 \n(38
174.1863 +.nr 38 \n(j-
174.1864 +.if \n(81<\n(38 .nr 81 \n(38
174.1865 +.nr 38 \n(k-
174.1866 +.if \n(81<\n(38 .nr 81 \n(38
174.1867 +.nr 38 \n(l-
174.1868 +.if \n(81<\n(38 .nr 81 \n(38
174.1869 +.nr 38 \n(m-
174.1870 +.if \n(81<\n(38 .nr 81 \n(38
174.1871 +.nr 38 \n(n-
174.1872 +.if \n(81<\n(38 .nr 81 \n(38
174.1873 +.35
174.1874 +.nf
174.1875 +.ll \n(34u
174.1876 +.nr 38 1n
174.1877 +.nr 79 0
174.1878 +.nr 40 \n(79+(0*\n(38)
174.1879 +.nr 80 +\n(40
174.1880 +.nr 41 \n(80+(3*\n(38)
174.1881 +.nr 81 +\n(41
174.1882 +.nr TW \n(81
174.1883 +.if t .if \n(TW>\n(.li .tm Table at line 420 file Input is too wide - \n(TW units
174.1884 +.fc
174.1885 +.nr #T 0-1
174.1886 +.nr #a 0-1
174.1887 +.eo
174.1888 +.de T#
174.1889 +.ds #d .d
174.1890 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.1891 +.mk ##
174.1892 +.nr ## -1v
174.1893 +.ls 1
174.1894 +.ls
174.1895 +..
174.1896 +.ec
174.1897 +.ta \n(80u \n(81u
174.1898 +.nr 31 \n(.f
174.1899 +.nr 35 1m
174.1900 +\&\h'|\n(40u'若吾潟若腟沿若\h'|\n(41u'
174.1901 +.ta \n(80u \n(81u
174.1902 +.nr 31 \n(.f
174.1903 +.nr 35 1m
174.1904 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.1905 +.ne \n(a|u+\n(.Vu
174.1906 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.1907 +.ta \n(80u \n(81u
174.1908 +.nr 31 \n(.f
174.1909 +.nr 35 1m
174.1910 +\&\h'|\n(40u'S0C\h'|\n(41u'
174.1911 +.mk ##
174.1912 +.nr 31 \n(##
174.1913 +.sp |\n(##u-1v
174.1914 +.nr 37 \n(41u
174.1915 +.in +\n(37u
174.1916 +.a+
174.1917 +.in -\n(37u
174.1918 +.mk 32
174.1919 +.if \n(32>\n(31 .nr 31 \n(32
174.1920 +.sp |\n(31u
174.1921 +.ne \n(b|u+\n(.Vu
174.1922 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.1923 +.ta \n(80u \n(81u
174.1924 +.nr 31 \n(.f
174.1925 +.nr 35 1m
174.1926 +\&\h'|\n(40u'S1C\h'|\n(41u'
174.1927 +.mk ##
174.1928 +.nr 31 \n(##
174.1929 +.sp |\n(##u-1v
174.1930 +.nr 37 \n(41u
174.1931 +.in +\n(37u
174.1932 +.b+
174.1933 +.in -\n(37u
174.1934 +.mk 32
174.1935 +.if \n(32>\n(31 .nr 31 \n(32
174.1936 +.sp |\n(31u
174.1937 +.ne \n(c|u+\n(.Vu
174.1938 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.1939 +.ta \n(80u \n(81u
174.1940 +.nr 31 \n(.f
174.1941 +.nr 35 1m
174.1942 +\&\h'|\n(40u'S0U\h'|\n(41u'
174.1943 +.mk ##
174.1944 +.nr 31 \n(##
174.1945 +.sp |\n(##u-1v
174.1946 +.nr 37 \n(41u
174.1947 +.in +\n(37u
174.1948 +.c+
174.1949 +.in -\n(37u
174.1950 +.mk 32
174.1951 +.if \n(32>\n(31 .nr 31 \n(32
174.1952 +.sp |\n(31u
174.1953 +.ne \n(d|u+\n(.Vu
174.1954 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.1955 +.ta \n(80u \n(81u
174.1956 +.nr 31 \n(.f
174.1957 +.nr 35 1m
174.1958 +\&\h'|\n(40u'S1U\h'|\n(41u'
174.1959 +.mk ##
174.1960 +.nr 31 \n(##
174.1961 +.sp |\n(##u-1v
174.1962 +.nr 37 \n(41u
174.1963 +.in +\n(37u
174.1964 +.d+
174.1965 +.in -\n(37u
174.1966 +.mk 32
174.1967 +.if \n(32>\n(31 .nr 31 \n(32
174.1968 +.sp |\n(31u
174.1969 +.ne \n(e|u+\n(.Vu
174.1970 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.1971 +.ta \n(80u \n(81u
174.1972 +.nr 31 \n(.f
174.1973 +.nr 35 1m
174.1974 +\&\h'|\n(40u'EC\h'|\n(41u'
174.1975 +.mk ##
174.1976 +.nr 31 \n(##
174.1977 +.sp |\n(##u-1v
174.1978 +.nr 37 \n(41u
174.1979 +.in +\n(37u
174.1980 +.e+
174.1981 +.in -\n(37u
174.1982 +.mk 32
174.1983 +.if \n(32>\n(31 .nr 31 \n(32
174.1984 +.sp |\n(31u
174.1985 +.ne \n(f|u+\n(.Vu
174.1986 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.1987 +.ta \n(80u \n(81u
174.1988 +.nr 31 \n(.f
174.1989 +.nr 35 1m
174.1990 +\&\h'|\n(40u'EU\h'|\n(41u'
174.1991 +.mk ##
174.1992 +.nr 31 \n(##
174.1993 +.sp |\n(##u-1v
174.1994 +.nr 37 \n(41u
174.1995 +.in +\n(37u
174.1996 +.f+
174.1997 +.in -\n(37u
174.1998 +.mk 32
174.1999 +.if \n(32>\n(31 .nr 31 \n(32
174.2000 +.sp |\n(31u
174.2001 +.ne \n(g|u+\n(.Vu
174.2002 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.2003 +.ta \n(80u \n(81u
174.2004 +.nr 31 \n(.f
174.2005 +.nr 35 1m
174.2006 +\&\h'|\n(40u'OC\h'|\n(41u'
174.2007 +.mk ##
174.2008 +.nr 31 \n(##
174.2009 +.sp |\n(##u-1v
174.2010 +.nr 37 \n(41u
174.2011 +.in +\n(37u
174.2012 +.g+
174.2013 +.in -\n(37u
174.2014 +.mk 32
174.2015 +.if \n(32>\n(31 .nr 31 \n(32
174.2016 +.sp |\n(31u
174.2017 +.ne \n(h|u+\n(.Vu
174.2018 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.2019 +.ta \n(80u \n(81u
174.2020 +.nr 31 \n(.f
174.2021 +.nr 35 1m
174.2022 +\&\h'|\n(40u'OU\h'|\n(41u'
174.2023 +.mk ##
174.2024 +.nr 31 \n(##
174.2025 +.sp |\n(##u-1v
174.2026 +.nr 37 \n(41u
174.2027 +.in +\n(37u
174.2028 +.h+
174.2029 +.in -\n(37u
174.2030 +.mk 32
174.2031 +.if \n(32>\n(31 .nr 31 \n(32
174.2032 +.sp |\n(31u
174.2033 +.ne \n(i|u+\n(.Vu
174.2034 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.2035 +.ta \n(80u \n(81u
174.2036 +.nr 31 \n(.f
174.2037 +.nr 35 1m
174.2038 +\&\h'|\n(40u'PC\h'|\n(41u'
174.2039 +.mk ##
174.2040 +.nr 31 \n(##
174.2041 +.sp |\n(##u-1v
174.2042 +.nr 37 \n(41u
174.2043 +.in +\n(37u
174.2044 +.i+
174.2045 +.in -\n(37u
174.2046 +.mk 32
174.2047 +.if \n(32>\n(31 .nr 31 \n(32
174.2048 +.sp |\n(31u
174.2049 +.ne \n(j|u+\n(.Vu
174.2050 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
174.2051 +.ta \n(80u \n(81u
174.2052 +.nr 31 \n(.f
174.2053 +.nr 35 1m
174.2054 +\&\h'|\n(40u'PU\h'|\n(41u'
174.2055 +.mk ##
174.2056 +.nr 31 \n(##
174.2057 +.sp |\n(##u-1v
174.2058 +.nr 37 \n(41u
174.2059 +.in +\n(37u
174.2060 +.j+
174.2061 +.in -\n(37u
174.2062 +.mk 32
174.2063 +.if \n(32>\n(31 .nr 31 \n(32
174.2064 +.sp |\n(31u
174.2065 +.ne \n(k|u+\n(.Vu
174.2066 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
174.2067 +.ta \n(80u \n(81u
174.2068 +.nr 31 \n(.f
174.2069 +.nr 35 1m
174.2070 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.2071 +.mk ##
174.2072 +.nr 31 \n(##
174.2073 +.sp |\n(##u-1v
174.2074 +.nr 37 \n(41u
174.2075 +.in +\n(37u
174.2076 +.k+
174.2077 +.in -\n(37u
174.2078 +.mk 32
174.2079 +.if \n(32>\n(31 .nr 31 \n(32
174.2080 +.sp |\n(31u
174.2081 +.ne \n(l|u+\n(.Vu
174.2082 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
174.2083 +.ta \n(80u \n(81u
174.2084 +.nr 31 \n(.f
174.2085 +.nr 35 1m
174.2086 +\&\h'|\n(40u'YGCT\h'|\n(41u'
174.2087 +.mk ##
174.2088 +.nr 31 \n(##
174.2089 +.sp |\n(##u-1v
174.2090 +.nr 37 \n(41u
174.2091 +.in +\n(37u
174.2092 +.l+
174.2093 +.in -\n(37u
174.2094 +.mk 32
174.2095 +.if \n(32>\n(31 .nr 31 \n(32
174.2096 +.sp |\n(31u
174.2097 +.ta \n(80u \n(81u
174.2098 +.nr 31 \n(.f
174.2099 +.nr 35 1m
174.2100 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.2101 +.ne \n(m|u+\n(.Vu
174.2102 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
174.2103 +.ta \n(80u \n(81u
174.2104 +.nr 31 \n(.f
174.2105 +.nr 35 1m
174.2106 +\&\h'|\n(40u'FGCT\h'|\n(41u'
174.2107 +.mk ##
174.2108 +.nr 31 \n(##
174.2109 +.sp |\n(##u-1v
174.2110 +.nr 37 \n(41u
174.2111 +.in +\n(37u
174.2112 +.m+
174.2113 +.in -\n(37u
174.2114 +.mk 32
174.2115 +.if \n(32>\n(31 .nr 31 \n(32
174.2116 +.sp |\n(31u
174.2117 +.ne \n(n|u+\n(.Vu
174.2118 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
174.2119 +.ta \n(80u \n(81u
174.2120 +.nr 31 \n(.f
174.2121 +.nr 35 1m
174.2122 +\&\h'|\n(40u'GCT\h'|\n(41u'
174.2123 +.mk ##
174.2124 +.nr 31 \n(##
174.2125 +.sp |\n(##u-1v
174.2126 +.nr 37 \n(41u
174.2127 +.in +\n(37u
174.2128 +.n+
174.2129 +.in -\n(37u
174.2130 +.mk 32
174.2131 +.if \n(32>\n(31 .nr 31 \n(32
174.2132 +.sp |\n(31u
174.2133 +.fc
174.2134 +.nr T. 1
174.2135 +.T# 1
174.2136 +.35
174.2137 +.rm a+
174.2138 +.rm b+
174.2139 +.rm c+
174.2140 +.rm d+
174.2141 +.rm e+
174.2142 +.rm f+
174.2143 +.rm g+
174.2144 +.rm h+
174.2145 +.rm i+
174.2146 +.rm j+
174.2147 +.rm k+
174.2148 +.rm l+
174.2149 +.rm m+
174.2150 +.rm n+
174.2151 +.TE
174.2152 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
174.2153 +
174.2154 +.LP
174.2155 +.SS
174.2156 +\-gccapacity 激с
174.2157 +.LP
174.2158 +.LP
174.2159 +.TS
174.2160 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.2161 +.de 35
174.2162 +.ps \n(.s
174.2163 +.vs \n(.vu
174.2164 +.in \n(.iu
174.2165 +.if \n(.u .fi
174.2166 +.if \n(.j .ad
174.2167 +.if \n(.j=0 .na
174.2168 +..
174.2169 +.nf
174.2170 +.nr #~ 0
174.2171 +.if n .nr #~ 0.6n
174.2172 +.ds #d .d
174.2173 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.2174 +.fc
174.2175 +.nr 33 \n(.s
174.2176 +.rm 80 81
174.2177 +.nr 34 \n(.lu
174.2178 +.eo
174.2179 +.am 81
174.2180 +.br
174.2181 +.di a+
174.2182 +.35
174.2183 +.ft \n(.f
174.2184 +.ll \n(34u*1u/3u
174.2185 +.if \n(.l<\n(81 .ll \n(81u
174.2186 +.in 0
174.2187 +New 筝篁c絨鎘拷 (KB)
174.2188 +.br
174.2189 +.di
174.2190 +.nr a| \n(dn
174.2191 +.nr a- \n(dl
174.2192 +..
174.2193 +.ec \
174.2194 +.eo
174.2195 +.am 81
174.2196 +.br
174.2197 +.di b+
174.2198 +.35
174.2199 +.ft \n(.f
174.2200 +.ll \n(34u*1u/3u
174.2201 +.if \n(.l<\n(81 .ll \n(81u
174.2202 +.in 0
174.2203 +New 筝篁c紊у拷 (KB)
174.2204 +.br
174.2205 +.di
174.2206 +.nr b| \n(dn
174.2207 +.nr b- \n(dl
174.2208 +..
174.2209 +.ec \
174.2210 +.eo
174.2211 +.am 81
174.2212 +.br
174.2213 +.di c+
174.2214 +.35
174.2215 +.ft \n(.f
174.2216 +.ll \n(34u*1u/3u
174.2217 +.if \n(.l<\n(81 .ll \n(81u
174.2218 +.in 0
174.2219 +New 筝篁c憜絎拷 (KB)
174.2220 +.br
174.2221 +.di
174.2222 +.nr c| \n(dn
174.2223 +.nr c- \n(dl
174.2224 +..
174.2225 +.ec \
174.2226 +.eo
174.2227 +.am 81
174.2228 +.br
174.2229 +.di d+
174.2230 +.35
174.2231 +.ft \n(.f
174.2232 +.ll \n(34u*1u/3u
174.2233 +.if \n(.l<\n(81 .ll \n(81u
174.2234 +.in 0
174.2235 +Survivor 0 憜絎拷 (KB)
174.2236 +.br
174.2237 +.di
174.2238 +.nr d| \n(dn
174.2239 +.nr d- \n(dl
174.2240 +..
174.2241 +.ec \
174.2242 +.eo
174.2243 +.am 81
174.2244 +.br
174.2245 +.di e+
174.2246 +.35
174.2247 +.ft \n(.f
174.2248 +.ll \n(34u*1u/3u
174.2249 +.if \n(.l<\n(81 .ll \n(81u
174.2250 +.in 0
174.2251 +Survivor 1 憜絎拷 (KB)
174.2252 +.br
174.2253 +.di
174.2254 +.nr e| \n(dn
174.2255 +.nr e- \n(dl
174.2256 +..
174.2257 +.ec \
174.2258 +.eo
174.2259 +.am 81
174.2260 +.br
174.2261 +.di f+
174.2262 +.35
174.2263 +.ft \n(.f
174.2264 +.ll \n(34u*1u/3u
174.2265 +.if \n(.l<\n(81 .ll \n(81u
174.2266 +.in 0
174.2267 +Eden 憜絎拷 (KB)
174.2268 +.br
174.2269 +.di
174.2270 +.nr f| \n(dn
174.2271 +.nr f- \n(dl
174.2272 +..
174.2273 +.ec \
174.2274 +.eo
174.2275 +.am 81
174.2276 +.br
174.2277 +.di g+
174.2278 +.35
174.2279 +.ft \n(.f
174.2280 +.ll \n(34u*1u/3u
174.2281 +.if \n(.l<\n(81 .ll \n(81u
174.2282 +.in 0
174.2283 +Old 筝篁c絨鎘拷 (KB)
174.2284 +.br
174.2285 +.di
174.2286 +.nr g| \n(dn
174.2287 +.nr g- \n(dl
174.2288 +..
174.2289 +.ec \
174.2290 +.eo
174.2291 +.am 81
174.2292 +.br
174.2293 +.di h+
174.2294 +.35
174.2295 +.ft \n(.f
174.2296 +.ll \n(34u*1u/3u
174.2297 +.if \n(.l<\n(81 .ll \n(81u
174.2298 +.in 0
174.2299 +Old 筝篁c紊у拷 (KB)
174.2300 +.br
174.2301 +.di
174.2302 +.nr h| \n(dn
174.2303 +.nr h- \n(dl
174.2304 +..
174.2305 +.ec \
174.2306 +.eo
174.2307 +.am 81
174.2308 +.br
174.2309 +.di i+
174.2310 +.35
174.2311 +.ft \n(.f
174.2312 +.ll \n(34u*1u/3u
174.2313 +.if \n(.l<\n(81 .ll \n(81u
174.2314 +.in 0
174.2315 +Old 筝篁c憜絎拷 (KB)
174.2316 +.br
174.2317 +.di
174.2318 +.nr i| \n(dn
174.2319 +.nr i- \n(dl
174.2320 +..
174.2321 +.ec \
174.2322 +.eo
174.2323 +.am 81
174.2324 +.br
174.2325 +.di j+
174.2326 +.35
174.2327 +.ft \n(.f
174.2328 +.ll \n(34u*1u/3u
174.2329 +.if \n(.l<\n(81 .ll \n(81u
174.2330 +.in 0
174.2331 +Old 憜絎拷 (KB)
174.2332 +.br
174.2333 +.di
174.2334 +.nr j| \n(dn
174.2335 +.nr j- \n(dl
174.2336 +..
174.2337 +.ec \
174.2338 +.eo
174.2339 +.am 81
174.2340 +.br
174.2341 +.di k+
174.2342 +.35
174.2343 +.ft \n(.f
174.2344 +.ll \n(34u*1u/3u
174.2345 +.if \n(.l<\n(81 .ll \n(81u
174.2346 +.in 0
174.2347 +Permanent 筝篁c絨鎘拷 (KB)
174.2348 +.br
174.2349 +.di
174.2350 +.nr k| \n(dn
174.2351 +.nr k- \n(dl
174.2352 +..
174.2353 +.ec \
174.2354 +.eo
174.2355 +.am 81
174.2356 +.br
174.2357 +.di l+
174.2358 +.35
174.2359 +.ft \n(.f
174.2360 +.ll \n(34u*1u/3u
174.2361 +.if \n(.l<\n(81 .ll \n(81u
174.2362 +.in 0
174.2363 +Permanent 筝篁c紊у拷 (KB)
174.2364 +.br
174.2365 +.di
174.2366 +.nr l| \n(dn
174.2367 +.nr l- \n(dl
174.2368 +..
174.2369 +.ec \
174.2370 +.eo
174.2371 +.am 81
174.2372 +.br
174.2373 +.di m+
174.2374 +.35
174.2375 +.ft \n(.f
174.2376 +.ll \n(34u*1u/3u
174.2377 +.if \n(.l<\n(81 .ll \n(81u
174.2378 +.in 0
174.2379 +Permanent 筝篁c憜絎拷 (KB)
174.2380 +.br
174.2381 +.di
174.2382 +.nr m| \n(dn
174.2383 +.nr m- \n(dl
174.2384 +..
174.2385 +.ec \
174.2386 +.eo
174.2387 +.am 81
174.2388 +.br
174.2389 +.di n+
174.2390 +.35
174.2391 +.ft \n(.f
174.2392 +.ll \n(34u*1u/3u
174.2393 +.if \n(.l<\n(81 .ll \n(81u
174.2394 +.in 0
174.2395 +Permanent 憜絎拷 (KB)
174.2396 +.br
174.2397 +.di
174.2398 +.nr n| \n(dn
174.2399 +.nr n- \n(dl
174.2400 +..
174.2401 +.ec \
174.2402 +.eo
174.2403 +.am 81
174.2404 +.br
174.2405 +.di o+
174.2406 +.35
174.2407 +.ft \n(.f
174.2408 +.ll \n(34u*1u/3u
174.2409 +.if \n(.l<\n(81 .ll \n(81u
174.2410 +.in 0
174.2411 +ャ筝篁c GC ゃ潟
174.2412 +.br
174.2413 +.di
174.2414 +.nr o| \n(dn
174.2415 +.nr o- \n(dl
174.2416 +..
174.2417 +.ec \
174.2418 +.35
174.2419 +.nf
174.2420 +.ll \n(34u
174.2421 +.nr 80 0
174.2422 +.nr 38 \w<≪若若筝篁c渇絎拷
174.2423 +.if \n(80<\n(38 .nr 80 \n(38
174.2424 +.nr 38 \w\f3\fP
174.2425 +.if \n(80<\n(38 .nr 80 \n(38
174.2426 +.nr 38 \wNGCMN
174.2427 +.if \n(80<\n(38 .nr 80 \n(38
174.2428 +.nr 38 \wNGCMX
174.2429 +.if \n(80<\n(38 .nr 80 \n(38
174.2430 +.nr 38 \wNGC
174.2431 +.if \n(80<\n(38 .nr 80 \n(38
174.2432 +.nr 38 \wS0C
174.2433 +.if \n(80<\n(38 .nr 80 \n(38
174.2434 +.nr 38 \wS1C
174.2435 +.if \n(80<\n(38 .nr 80 \n(38
174.2436 +.nr 38 \wEC
174.2437 +.if \n(80<\n(38 .nr 80 \n(38
174.2438 +.nr 38 \wOGCMN
174.2439 +.if \n(80<\n(38 .nr 80 \n(38
174.2440 +.nr 38 \wOGCMX
174.2441 +.if \n(80<\n(38 .nr 80 \n(38
174.2442 +.nr 38 \wOGC
174.2443 +.if \n(80<\n(38 .nr 80 \n(38
174.2444 +.nr 38 \wOC
174.2445 +.if \n(80<\n(38 .nr 80 \n(38
174.2446 +.nr 38 \wPGCMN
174.2447 +.if \n(80<\n(38 .nr 80 \n(38
174.2448 +.nr 38 \wPGCMX
174.2449 +.if \n(80<\n(38 .nr 80 \n(38
174.2450 +.nr 38 \wPGC
174.2451 +.if \n(80<\n(38 .nr 80 \n(38
174.2452 +.nr 38 \wPC
174.2453 +.if \n(80<\n(38 .nr 80 \n(38
174.2454 +.nr 38 \wYGC
174.2455 +.if \n(80<\n(38 .nr 80 \n(38
174.2456 +.nr 38 \wFGC
174.2457 +.if \n(80<\n(38 .nr 80 \n(38
174.2458 +.80
174.2459 +.rm 80
174.2460 +.nr 81 0
174.2461 +.nr 38 \w\f3茯\fP
174.2462 +.if \n(81<\n(38 .nr 81 \n(38
174.2463 +.nr 38 \w GC ゃ潟
174.2464 +.if \n(81<\n(38 .nr 81 \n(38
174.2465 +.81
174.2466 +.rm 81
174.2467 +.nr 38 \n(a-
174.2468 +.if \n(81<\n(38 .nr 81 \n(38
174.2469 +.nr 38 \n(b-
174.2470 +.if \n(81<\n(38 .nr 81 \n(38
174.2471 +.nr 38 \n(c-
174.2472 +.if \n(81<\n(38 .nr 81 \n(38
174.2473 +.nr 38 \n(d-
174.2474 +.if \n(81<\n(38 .nr 81 \n(38
174.2475 +.nr 38 \n(e-
174.2476 +.if \n(81<\n(38 .nr 81 \n(38
174.2477 +.nr 38 \n(f-
174.2478 +.if \n(81<\n(38 .nr 81 \n(38
174.2479 +.nr 38 \n(g-
174.2480 +.if \n(81<\n(38 .nr 81 \n(38
174.2481 +.nr 38 \n(h-
174.2482 +.if \n(81<\n(38 .nr 81 \n(38
174.2483 +.nr 38 \n(i-
174.2484 +.if \n(81<\n(38 .nr 81 \n(38
174.2485 +.nr 38 \n(j-
174.2486 +.if \n(81<\n(38 .nr 81 \n(38
174.2487 +.nr 38 \n(k-
174.2488 +.if \n(81<\n(38 .nr 81 \n(38
174.2489 +.nr 38 \n(l-
174.2490 +.if \n(81<\n(38 .nr 81 \n(38
174.2491 +.nr 38 \n(m-
174.2492 +.if \n(81<\n(38 .nr 81 \n(38
174.2493 +.nr 38 \n(n-
174.2494 +.if \n(81<\n(38 .nr 81 \n(38
174.2495 +.nr 38 \n(o-
174.2496 +.if \n(81<\n(38 .nr 81 \n(38
174.2497 +.35
174.2498 +.nf
174.2499 +.ll \n(34u
174.2500 +.nr 38 1n
174.2501 +.nr 79 0
174.2502 +.nr 40 \n(79+(0*\n(38)
174.2503 +.nr 80 +\n(40
174.2504 +.nr 41 \n(80+(3*\n(38)
174.2505 +.nr 81 +\n(41
174.2506 +.nr TW \n(81
174.2507 +.if t .if \n(TW>\n(.li .tm Table at line 494 file Input is too wide - \n(TW units
174.2508 +.fc
174.2509 +.nr #T 0-1
174.2510 +.nr #a 0-1
174.2511 +.eo
174.2512 +.de T#
174.2513 +.ds #d .d
174.2514 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.2515 +.mk ##
174.2516 +.nr ## -1v
174.2517 +.ls 1
174.2518 +.ls
174.2519 +..
174.2520 +.ec
174.2521 +.ta \n(80u \n(81u
174.2522 +.nr 31 \n(.f
174.2523 +.nr 35 1m
174.2524 +\&\h'|\n(40u'<≪若若筝篁c渇絎拷\h'|\n(41u'
174.2525 +.ta \n(80u \n(81u
174.2526 +.nr 31 \n(.f
174.2527 +.nr 35 1m
174.2528 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.2529 +.ne \n(a|u+\n(.Vu
174.2530 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.2531 +.ta \n(80u \n(81u
174.2532 +.nr 31 \n(.f
174.2533 +.nr 35 1m
174.2534 +\&\h'|\n(40u'NGCMN\h'|\n(41u'
174.2535 +.mk ##
174.2536 +.nr 31 \n(##
174.2537 +.sp |\n(##u-1v
174.2538 +.nr 37 \n(41u
174.2539 +.in +\n(37u
174.2540 +.a+
174.2541 +.in -\n(37u
174.2542 +.mk 32
174.2543 +.if \n(32>\n(31 .nr 31 \n(32
174.2544 +.sp |\n(31u
174.2545 +.ne \n(b|u+\n(.Vu
174.2546 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.2547 +.ta \n(80u \n(81u
174.2548 +.nr 31 \n(.f
174.2549 +.nr 35 1m
174.2550 +\&\h'|\n(40u'NGCMX\h'|\n(41u'
174.2551 +.mk ##
174.2552 +.nr 31 \n(##
174.2553 +.sp |\n(##u-1v
174.2554 +.nr 37 \n(41u
174.2555 +.in +\n(37u
174.2556 +.b+
174.2557 +.in -\n(37u
174.2558 +.mk 32
174.2559 +.if \n(32>\n(31 .nr 31 \n(32
174.2560 +.sp |\n(31u
174.2561 +.ne \n(c|u+\n(.Vu
174.2562 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.2563 +.ta \n(80u \n(81u
174.2564 +.nr 31 \n(.f
174.2565 +.nr 35 1m
174.2566 +\&\h'|\n(40u'NGC\h'|\n(41u'
174.2567 +.mk ##
174.2568 +.nr 31 \n(##
174.2569 +.sp |\n(##u-1v
174.2570 +.nr 37 \n(41u
174.2571 +.in +\n(37u
174.2572 +.c+
174.2573 +.in -\n(37u
174.2574 +.mk 32
174.2575 +.if \n(32>\n(31 .nr 31 \n(32
174.2576 +.sp |\n(31u
174.2577 +.ne \n(d|u+\n(.Vu
174.2578 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.2579 +.ta \n(80u \n(81u
174.2580 +.nr 31 \n(.f
174.2581 +.nr 35 1m
174.2582 +\&\h'|\n(40u'S0C\h'|\n(41u'
174.2583 +.mk ##
174.2584 +.nr 31 \n(##
174.2585 +.sp |\n(##u-1v
174.2586 +.nr 37 \n(41u
174.2587 +.in +\n(37u
174.2588 +.d+
174.2589 +.in -\n(37u
174.2590 +.mk 32
174.2591 +.if \n(32>\n(31 .nr 31 \n(32
174.2592 +.sp |\n(31u
174.2593 +.ne \n(e|u+\n(.Vu
174.2594 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.2595 +.ta \n(80u \n(81u
174.2596 +.nr 31 \n(.f
174.2597 +.nr 35 1m
174.2598 +\&\h'|\n(40u'S1C\h'|\n(41u'
174.2599 +.mk ##
174.2600 +.nr 31 \n(##
174.2601 +.sp |\n(##u-1v
174.2602 +.nr 37 \n(41u
174.2603 +.in +\n(37u
174.2604 +.e+
174.2605 +.in -\n(37u
174.2606 +.mk 32
174.2607 +.if \n(32>\n(31 .nr 31 \n(32
174.2608 +.sp |\n(31u
174.2609 +.ne \n(f|u+\n(.Vu
174.2610 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.2611 +.ta \n(80u \n(81u
174.2612 +.nr 31 \n(.f
174.2613 +.nr 35 1m
174.2614 +\&\h'|\n(40u'EC\h'|\n(41u'
174.2615 +.mk ##
174.2616 +.nr 31 \n(##
174.2617 +.sp |\n(##u-1v
174.2618 +.nr 37 \n(41u
174.2619 +.in +\n(37u
174.2620 +.f+
174.2621 +.in -\n(37u
174.2622 +.mk 32
174.2623 +.if \n(32>\n(31 .nr 31 \n(32
174.2624 +.sp |\n(31u
174.2625 +.ne \n(g|u+\n(.Vu
174.2626 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.2627 +.ta \n(80u \n(81u
174.2628 +.nr 31 \n(.f
174.2629 +.nr 35 1m
174.2630 +\&\h'|\n(40u'OGCMN\h'|\n(41u'
174.2631 +.mk ##
174.2632 +.nr 31 \n(##
174.2633 +.sp |\n(##u-1v
174.2634 +.nr 37 \n(41u
174.2635 +.in +\n(37u
174.2636 +.g+
174.2637 +.in -\n(37u
174.2638 +.mk 32
174.2639 +.if \n(32>\n(31 .nr 31 \n(32
174.2640 +.sp |\n(31u
174.2641 +.ne \n(h|u+\n(.Vu
174.2642 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.2643 +.ta \n(80u \n(81u
174.2644 +.nr 31 \n(.f
174.2645 +.nr 35 1m
174.2646 +\&\h'|\n(40u'OGCMX\h'|\n(41u'
174.2647 +.mk ##
174.2648 +.nr 31 \n(##
174.2649 +.sp |\n(##u-1v
174.2650 +.nr 37 \n(41u
174.2651 +.in +\n(37u
174.2652 +.h+
174.2653 +.in -\n(37u
174.2654 +.mk 32
174.2655 +.if \n(32>\n(31 .nr 31 \n(32
174.2656 +.sp |\n(31u
174.2657 +.ne \n(i|u+\n(.Vu
174.2658 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.2659 +.ta \n(80u \n(81u
174.2660 +.nr 31 \n(.f
174.2661 +.nr 35 1m
174.2662 +\&\h'|\n(40u'OGC\h'|\n(41u'
174.2663 +.mk ##
174.2664 +.nr 31 \n(##
174.2665 +.sp |\n(##u-1v
174.2666 +.nr 37 \n(41u
174.2667 +.in +\n(37u
174.2668 +.i+
174.2669 +.in -\n(37u
174.2670 +.mk 32
174.2671 +.if \n(32>\n(31 .nr 31 \n(32
174.2672 +.sp |\n(31u
174.2673 +.ne \n(j|u+\n(.Vu
174.2674 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
174.2675 +.ta \n(80u \n(81u
174.2676 +.nr 31 \n(.f
174.2677 +.nr 35 1m
174.2678 +\&\h'|\n(40u'OC\h'|\n(41u'
174.2679 +.mk ##
174.2680 +.nr 31 \n(##
174.2681 +.sp |\n(##u-1v
174.2682 +.nr 37 \n(41u
174.2683 +.in +\n(37u
174.2684 +.j+
174.2685 +.in -\n(37u
174.2686 +.mk 32
174.2687 +.if \n(32>\n(31 .nr 31 \n(32
174.2688 +.sp |\n(31u
174.2689 +.ne \n(k|u+\n(.Vu
174.2690 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
174.2691 +.ta \n(80u \n(81u
174.2692 +.nr 31 \n(.f
174.2693 +.nr 35 1m
174.2694 +\&\h'|\n(40u'PGCMN\h'|\n(41u'
174.2695 +.mk ##
174.2696 +.nr 31 \n(##
174.2697 +.sp |\n(##u-1v
174.2698 +.nr 37 \n(41u
174.2699 +.in +\n(37u
174.2700 +.k+
174.2701 +.in -\n(37u
174.2702 +.mk 32
174.2703 +.if \n(32>\n(31 .nr 31 \n(32
174.2704 +.sp |\n(31u
174.2705 +.ne \n(l|u+\n(.Vu
174.2706 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
174.2707 +.ta \n(80u \n(81u
174.2708 +.nr 31 \n(.f
174.2709 +.nr 35 1m
174.2710 +\&\h'|\n(40u'PGCMX\h'|\n(41u'
174.2711 +.mk ##
174.2712 +.nr 31 \n(##
174.2713 +.sp |\n(##u-1v
174.2714 +.nr 37 \n(41u
174.2715 +.in +\n(37u
174.2716 +.l+
174.2717 +.in -\n(37u
174.2718 +.mk 32
174.2719 +.if \n(32>\n(31 .nr 31 \n(32
174.2720 +.sp |\n(31u
174.2721 +.ne \n(m|u+\n(.Vu
174.2722 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
174.2723 +.ta \n(80u \n(81u
174.2724 +.nr 31 \n(.f
174.2725 +.nr 35 1m
174.2726 +\&\h'|\n(40u'PGC\h'|\n(41u'
174.2727 +.mk ##
174.2728 +.nr 31 \n(##
174.2729 +.sp |\n(##u-1v
174.2730 +.nr 37 \n(41u
174.2731 +.in +\n(37u
174.2732 +.m+
174.2733 +.in -\n(37u
174.2734 +.mk 32
174.2735 +.if \n(32>\n(31 .nr 31 \n(32
174.2736 +.sp |\n(31u
174.2737 +.ne \n(n|u+\n(.Vu
174.2738 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
174.2739 +.ta \n(80u \n(81u
174.2740 +.nr 31 \n(.f
174.2741 +.nr 35 1m
174.2742 +\&\h'|\n(40u'PC\h'|\n(41u'
174.2743 +.mk ##
174.2744 +.nr 31 \n(##
174.2745 +.sp |\n(##u-1v
174.2746 +.nr 37 \n(41u
174.2747 +.in +\n(37u
174.2748 +.n+
174.2749 +.in -\n(37u
174.2750 +.mk 32
174.2751 +.if \n(32>\n(31 .nr 31 \n(32
174.2752 +.sp |\n(31u
174.2753 +.ne \n(o|u+\n(.Vu
174.2754 +.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
174.2755 +.ta \n(80u \n(81u
174.2756 +.nr 31 \n(.f
174.2757 +.nr 35 1m
174.2758 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.2759 +.mk ##
174.2760 +.nr 31 \n(##
174.2761 +.sp |\n(##u-1v
174.2762 +.nr 37 \n(41u
174.2763 +.in +\n(37u
174.2764 +.o+
174.2765 +.in -\n(37u
174.2766 +.mk 32
174.2767 +.if \n(32>\n(31 .nr 31 \n(32
174.2768 +.sp |\n(31u
174.2769 +.ta \n(80u \n(81u
174.2770 +.nr 31 \n(.f
174.2771 +.nr 35 1m
174.2772 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.2773 +.fc
174.2774 +.nr T. 1
174.2775 +.T# 1
174.2776 +.35
174.2777 +.rm a+
174.2778 +.rm b+
174.2779 +.rm c+
174.2780 +.rm d+
174.2781 +.rm e+
174.2782 +.rm f+
174.2783 +.rm g+
174.2784 +.rm h+
174.2785 +.rm i+
174.2786 +.rm j+
174.2787 +.rm k+
174.2788 +.rm l+
174.2789 +.rm m+
174.2790 +.rm n+
174.2791 +.rm o+
174.2792 +.TE
174.2793 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-67
174.2794 +
174.2795 +.LP
174.2796 +.SS
174.2797 +\-gccause 激с
174.2798 +.LP
174.2799 +.LP
174.2800 +激с潟\f3\-gcutil\fP 激с潟若吾潟激с括輝荐若帥网荀茵腓冴障緇若吾潟激с潟ゃ潟 (純翫) 憜若吾潟激с潟ゃ潟障障\f3\-gcutil\fP т荀ц;腓冴篁激с潟с罨<菴遵障
174.2801 +.LP
174.2802 +.LP
174.2803 +.TS
174.2804 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.2805 +.de 35
174.2806 +.ps \n(.s
174.2807 +.vs \n(.vu
174.2808 +.in \n(.iu
174.2809 +.if \n(.u .fi
174.2810 +.if \n(.j .ad
174.2811 +.if \n(.j=0 .na
174.2812 +..
174.2813 +.nf
174.2814 +.nr #~ 0
174.2815 +.if n .nr #~ 0.6n
174.2816 +.ds #d .d
174.2817 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.2818 +.fc
174.2819 +.nr 33 \n(.s
174.2820 +.rm 80 81
174.2821 +.nr 34 \n(.lu
174.2822 +.eo
174.2823 +.am 81
174.2824 +.br
174.2825 +.di a+
174.2826 +.35
174.2827 +.ft \n(.f
174.2828 +.ll \n(34u*1u/3u
174.2829 +.if \n(.l<\n(81 .ll \n(81u
174.2830 +.in 0
174.2831 +緇若吾潟激с潟
174.2832 +.br
174.2833 +.di
174.2834 +.nr a| \n(dn
174.2835 +.nr a- \n(dl
174.2836 +..
174.2837 +.ec \
174.2838 +.eo
174.2839 +.am 81
174.2840 +.br
174.2841 +.di b+
174.2842 +.35
174.2843 +.ft \n(.f
174.2844 +.ll \n(34u*1u/3u
174.2845 +.if \n(.l<\n(81 .ll \n(81u
174.2846 +.in 0
174.2847 +憜若吾潟激с潟
174.2848 +.br
174.2849 +.di
174.2850 +.nr b| \n(dn
174.2851 +.nr b- \n(dl
174.2852 +..
174.2853 +.ec \
174.2854 +.35
174.2855 +.nf
174.2856 +.ll \n(34u
174.2857 +.nr 80 0
174.2858 +.nr 38 \wGC ゃ潟若吾潟激с括輝荐若
174.2859 +.if \n(80<\n(38 .nr 80 \n(38
174.2860 +.nr 38 \w\f3\fP
174.2861 +.if \n(80<\n(38 .nr 80 \n(38
174.2862 +.nr 38 \wLGCC
174.2863 +.if \n(80<\n(38 .nr 80 \n(38
174.2864 +.nr 38 \wGCC
174.2865 +.if \n(80<\n(38 .nr 80 \n(38
174.2866 +.80
174.2867 +.rm 80
174.2868 +.nr 81 0
174.2869 +.nr 38 \w\f3茯\fP
174.2870 +.if \n(81<\n(38 .nr 81 \n(38
174.2871 +.81
174.2872 +.rm 81
174.2873 +.nr 38 \n(a-
174.2874 +.if \n(81<\n(38 .nr 81 \n(38
174.2875 +.nr 38 \n(b-
174.2876 +.if \n(81<\n(38 .nr 81 \n(38
174.2877 +.35
174.2878 +.nf
174.2879 +.ll \n(34u
174.2880 +.nr 38 1n
174.2881 +.nr 79 0
174.2882 +.nr 40 \n(79+(0*\n(38)
174.2883 +.nr 80 +\n(40
174.2884 +.nr 41 \n(80+(3*\n(38)
174.2885 +.nr 81 +\n(41
174.2886 +.nr TW \n(81
174.2887 +.if t .if \n(TW>\n(.li .tm Table at line 517 file Input is too wide - \n(TW units
174.2888 +.fc
174.2889 +.nr #T 0-1
174.2890 +.nr #a 0-1
174.2891 +.eo
174.2892 +.de T#
174.2893 +.ds #d .d
174.2894 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.2895 +.mk ##
174.2896 +.nr ## -1v
174.2897 +.ls 1
174.2898 +.ls
174.2899 +..
174.2900 +.ec
174.2901 +.ta \n(80u \n(81u
174.2902 +.nr 31 \n(.f
174.2903 +.nr 35 1m
174.2904 +\&\h'|\n(40u'GC ゃ潟若吾潟激с括輝荐若\h'|\n(41u'
174.2905 +.ta \n(80u \n(81u
174.2906 +.nr 31 \n(.f
174.2907 +.nr 35 1m
174.2908 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.2909 +.ne \n(a|u+\n(.Vu
174.2910 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.2911 +.ta \n(80u \n(81u
174.2912 +.nr 31 \n(.f
174.2913 +.nr 35 1m
174.2914 +\&\h'|\n(40u'LGCC\h'|\n(41u'
174.2915 +.mk ##
174.2916 +.nr 31 \n(##
174.2917 +.sp |\n(##u-1v
174.2918 +.nr 37 \n(41u
174.2919 +.in +\n(37u
174.2920 +.a+
174.2921 +.in -\n(37u
174.2922 +.mk 32
174.2923 +.if \n(32>\n(31 .nr 31 \n(32
174.2924 +.sp |\n(31u
174.2925 +.ne \n(b|u+\n(.Vu
174.2926 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.2927 +.ta \n(80u \n(81u
174.2928 +.nr 31 \n(.f
174.2929 +.nr 35 1m
174.2930 +\&\h'|\n(40u'GCC\h'|\n(41u'
174.2931 +.mk ##
174.2932 +.nr 31 \n(##
174.2933 +.sp |\n(##u-1v
174.2934 +.nr 37 \n(41u
174.2935 +.in +\n(37u
174.2936 +.b+
174.2937 +.in -\n(37u
174.2938 +.mk 32
174.2939 +.if \n(32>\n(31 .nr 31 \n(32
174.2940 +.sp |\n(31u
174.2941 +.fc
174.2942 +.nr T. 1
174.2943 +.T# 1
174.2944 +.35
174.2945 +.rm a+
174.2946 +.rm b+
174.2947 +.TE
174.2948 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-13
174.2949 +
174.2950 +.LP
174.2951 +.SS
174.2952 +\-gcnew 激с
174.2953 +.LP
174.2954 +.LP
174.2955 +.TS
174.2956 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.2957 +.de 35
174.2958 +.ps \n(.s
174.2959 +.vs \n(.vu
174.2960 +.in \n(.iu
174.2961 +.if \n(.u .fi
174.2962 +.if \n(.j .ad
174.2963 +.if \n(.j=0 .na
174.2964 +..
174.2965 +.nf
174.2966 +.nr #~ 0
174.2967 +.if n .nr #~ 0.6n
174.2968 +.ds #d .d
174.2969 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.2970 +.fc
174.2971 +.nr 33 \n(.s
174.2972 +.rm 80 81
174.2973 +.nr 34 \n(.lu
174.2974 +.eo
174.2975 +.am 81
174.2976 +.br
174.2977 +.di a+
174.2978 +.35
174.2979 +.ft \n(.f
174.2980 +.ll \n(34u*1u/3u
174.2981 +.if \n(.l<\n(81 .ll \n(81u
174.2982 +.in 0
174.2983 +Survivor 0 憜絎拷 (KB)
174.2984 +.br
174.2985 +.di
174.2986 +.nr a| \n(dn
174.2987 +.nr a- \n(dl
174.2988 +..
174.2989 +.ec \
174.2990 +.eo
174.2991 +.am 81
174.2992 +.br
174.2993 +.di b+
174.2994 +.35
174.2995 +.ft \n(.f
174.2996 +.ll \n(34u*1u/3u
174.2997 +.if \n(.l<\n(81 .ll \n(81u
174.2998 +.in 0
174.2999 +Survivor 1 憜絎拷 (KB)
174.3000 +.br
174.3001 +.di
174.3002 +.nr b| \n(dn
174.3003 +.nr b- \n(dl
174.3004 +..
174.3005 +.ec \
174.3006 +.eo
174.3007 +.am 81
174.3008 +.br
174.3009 +.di c+
174.3010 +.35
174.3011 +.ft \n(.f
174.3012 +.ll \n(34u*1u/3u
174.3013 +.if \n(.l<\n(81 .ll \n(81u
174.3014 +.in 0
174.3015 +Survivor 0 篏睡 (KB)
174.3016 +.br
174.3017 +.di
174.3018 +.nr c| \n(dn
174.3019 +.nr c- \n(dl
174.3020 +..
174.3021 +.ec \
174.3022 +.eo
174.3023 +.am 81
174.3024 +.br
174.3025 +.di d+
174.3026 +.35
174.3027 +.ft \n(.f
174.3028 +.ll \n(34u*1u/3u
174.3029 +.if \n(.l<\n(81 .ll \n(81u
174.3030 +.in 0
174.3031 +Survivor 1 篏睡 (KB)
174.3032 +.br
174.3033 +.di
174.3034 +.nr d| \n(dn
174.3035 +.nr d- \n(dl
174.3036 +..
174.3037 +.ec \
174.3038 +.eo
174.3039 +.am 81
174.3040 +.br
174.3041 +.di e+
174.3042 +.35
174.3043 +.ft \n(.f
174.3044 +.ll \n(34u*1u/3u
174.3045 +.if \n(.l<\n(81 .ll \n(81u
174.3046 +.in 0
174.3047 +紊ф水ャ
174.3048 +.br
174.3049 +.di
174.3050 +.nr e| \n(dn
174.3051 +.nr e- \n(dl
174.3052 +..
174.3053 +.ec \
174.3054 +.eo
174.3055 +.am 81
174.3056 +.br
174.3057 +.di f+
174.3058 +.35
174.3059 +.ft \n(.f
174.3060 +.ll \n(34u*1u/3u
174.3061 +.if \n(.l<\n(81 .ll \n(81u
174.3062 +.in 0
174.3063 + Survivor 泣ゃ (KB)
174.3064 +.br
174.3065 +.di
174.3066 +.nr f| \n(dn
174.3067 +.nr f- \n(dl
174.3068 +..
174.3069 +.ec \
174.3070 +.eo
174.3071 +.am 81
174.3072 +.br
174.3073 +.di g+
174.3074 +.35
174.3075 +.ft \n(.f
174.3076 +.ll \n(34u*1u/3u
174.3077 +.if \n(.l<\n(81 .ll \n(81u
174.3078 +.in 0
174.3079 +Eden 憜絎拷 (KB)
174.3080 +.br
174.3081 +.di
174.3082 +.nr g| \n(dn
174.3083 +.nr g- \n(dl
174.3084 +..
174.3085 +.ec \
174.3086 +.eo
174.3087 +.am 81
174.3088 +.br
174.3089 +.di h+
174.3090 +.35
174.3091 +.ft \n(.f
174.3092 +.ll \n(34u*1u/3u
174.3093 +.if \n(.l<\n(81 .ll \n(81u
174.3094 +.in 0
174.3095 +Eden 篏睡 (KB)
174.3096 +.br
174.3097 +.di
174.3098 +.nr h| \n(dn
174.3099 +.nr h- \n(dl
174.3100 +..
174.3101 +.ec \
174.3102 +.eo
174.3103 +.am 81
174.3104 +.br
174.3105 +.di i+
174.3106 +.35
174.3107 +.ft \n(.f
174.3108 +.ll \n(34u*1u/3u
174.3109 +.if \n(.l<\n(81 .ll \n(81u
174.3110 +.in 0
174.3111 +ャ筝篁c GC ゃ潟
174.3112 +.br
174.3113 +.di
174.3114 +.nr i| \n(dn
174.3115 +.nr i- \n(dl
174.3116 +..
174.3117 +.ec \
174.3118 +.eo
174.3119 +.am 81
174.3120 +.br
174.3121 +.di j+
174.3122 +.35
174.3123 +.ft \n(.f
174.3124 +.ll \n(34u*1u/3u
174.3125 +.if \n(.l<\n(81 .ll \n(81u
174.3126 +.in 0
174.3127 +ャ筝篁c若吾潟激с恰
174.3128 +.br
174.3129 +.di
174.3130 +.nr j| \n(dn
174.3131 +.nr j- \n(dl
174.3132 +..
174.3133 +.ec \
174.3134 +.35
174.3135 +.nf
174.3136 +.ll \n(34u
174.3137 +.nr 80 0
174.3138 +.nr 38 \wNew 筝篁c腟沿若
174.3139 +.if \n(80<\n(38 .nr 80 \n(38
174.3140 +.nr 38 \w\f3\fP
174.3141 +.if \n(80<\n(38 .nr 80 \n(38
174.3142 +.nr 38 \wS0C
174.3143 +.if \n(80<\n(38 .nr 80 \n(38
174.3144 +.nr 38 \wS1C
174.3145 +.if \n(80<\n(38 .nr 80 \n(38
174.3146 +.nr 38 \wS0U
174.3147 +.if \n(80<\n(38 .nr 80 \n(38
174.3148 +.nr 38 \wS1U
174.3149 +.if \n(80<\n(38 .nr 80 \n(38
174.3150 +.nr 38 \wTT
174.3151 +.if \n(80<\n(38 .nr 80 \n(38
174.3152 +.nr 38 \wMTT
174.3153 +.if \n(80<\n(38 .nr 80 \n(38
174.3154 +.nr 38 \wDSS
174.3155 +.if \n(80<\n(38 .nr 80 \n(38
174.3156 +.nr 38 \wEC
174.3157 +.if \n(80<\n(38 .nr 80 \n(38
174.3158 +.nr 38 \wEU
174.3159 +.if \n(80<\n(38 .nr 80 \n(38
174.3160 +.nr 38 \wYGC
174.3161 +.if \n(80<\n(38 .nr 80 \n(38
174.3162 +.nr 38 \wYGCT
174.3163 +.if \n(80<\n(38 .nr 80 \n(38
174.3164 +.80
174.3165 +.rm 80
174.3166 +.nr 81 0
174.3167 +.nr 38 \w\f3茯\fP
174.3168 +.if \n(81<\n(38 .nr 81 \n(38
174.3169 +.nr 38 \w罧水ャ
174.3170 +.if \n(81<\n(38 .nr 81 \n(38
174.3171 +.81
174.3172 +.rm 81
174.3173 +.nr 38 \n(a-
174.3174 +.if \n(81<\n(38 .nr 81 \n(38
174.3175 +.nr 38 \n(b-
174.3176 +.if \n(81<\n(38 .nr 81 \n(38
174.3177 +.nr 38 \n(c-
174.3178 +.if \n(81<\n(38 .nr 81 \n(38
174.3179 +.nr 38 \n(d-
174.3180 +.if \n(81<\n(38 .nr 81 \n(38
174.3181 +.nr 38 \n(e-
174.3182 +.if \n(81<\n(38 .nr 81 \n(38
174.3183 +.nr 38 \n(f-
174.3184 +.if \n(81<\n(38 .nr 81 \n(38
174.3185 +.nr 38 \n(g-
174.3186 +.if \n(81<\n(38 .nr 81 \n(38
174.3187 +.nr 38 \n(h-
174.3188 +.if \n(81<\n(38 .nr 81 \n(38
174.3189 +.nr 38 \n(i-
174.3190 +.if \n(81<\n(38 .nr 81 \n(38
174.3191 +.nr 38 \n(j-
174.3192 +.if \n(81<\n(38 .nr 81 \n(38
174.3193 +.35
174.3194 +.nf
174.3195 +.ll \n(34u
174.3196 +.nr 38 1n
174.3197 +.nr 79 0
174.3198 +.nr 40 \n(79+(0*\n(38)
174.3199 +.nr 80 +\n(40
174.3200 +.nr 41 \n(80+(3*\n(38)
174.3201 +.nr 81 +\n(41
174.3202 +.nr TW \n(81
174.3203 +.if t .if \n(TW>\n(.li .tm Table at line 571 file Input is too wide - \n(TW units
174.3204 +.fc
174.3205 +.nr #T 0-1
174.3206 +.nr #a 0-1
174.3207 +.eo
174.3208 +.de T#
174.3209 +.ds #d .d
174.3210 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.3211 +.mk ##
174.3212 +.nr ## -1v
174.3213 +.ls 1
174.3214 +.ls
174.3215 +..
174.3216 +.ec
174.3217 +.ta \n(80u \n(81u
174.3218 +.nr 31 \n(.f
174.3219 +.nr 35 1m
174.3220 +\&\h'|\n(40u'New 筝篁c腟沿若\h'|\n(41u'
174.3221 +.ta \n(80u \n(81u
174.3222 +.nr 31 \n(.f
174.3223 +.nr 35 1m
174.3224 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.3225 +.ne \n(a|u+\n(.Vu
174.3226 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.3227 +.ta \n(80u \n(81u
174.3228 +.nr 31 \n(.f
174.3229 +.nr 35 1m
174.3230 +\&\h'|\n(40u'S0C\h'|\n(41u'
174.3231 +.mk ##
174.3232 +.nr 31 \n(##
174.3233 +.sp |\n(##u-1v
174.3234 +.nr 37 \n(41u
174.3235 +.in +\n(37u
174.3236 +.a+
174.3237 +.in -\n(37u
174.3238 +.mk 32
174.3239 +.if \n(32>\n(31 .nr 31 \n(32
174.3240 +.sp |\n(31u
174.3241 +.ne \n(b|u+\n(.Vu
174.3242 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.3243 +.ta \n(80u \n(81u
174.3244 +.nr 31 \n(.f
174.3245 +.nr 35 1m
174.3246 +\&\h'|\n(40u'S1C\h'|\n(41u'
174.3247 +.mk ##
174.3248 +.nr 31 \n(##
174.3249 +.sp |\n(##u-1v
174.3250 +.nr 37 \n(41u
174.3251 +.in +\n(37u
174.3252 +.b+
174.3253 +.in -\n(37u
174.3254 +.mk 32
174.3255 +.if \n(32>\n(31 .nr 31 \n(32
174.3256 +.sp |\n(31u
174.3257 +.ne \n(c|u+\n(.Vu
174.3258 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.3259 +.ta \n(80u \n(81u
174.3260 +.nr 31 \n(.f
174.3261 +.nr 35 1m
174.3262 +\&\h'|\n(40u'S0U\h'|\n(41u'
174.3263 +.mk ##
174.3264 +.nr 31 \n(##
174.3265 +.sp |\n(##u-1v
174.3266 +.nr 37 \n(41u
174.3267 +.in +\n(37u
174.3268 +.c+
174.3269 +.in -\n(37u
174.3270 +.mk 32
174.3271 +.if \n(32>\n(31 .nr 31 \n(32
174.3272 +.sp |\n(31u
174.3273 +.ne \n(d|u+\n(.Vu
174.3274 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.3275 +.ta \n(80u \n(81u
174.3276 +.nr 31 \n(.f
174.3277 +.nr 35 1m
174.3278 +\&\h'|\n(40u'S1U\h'|\n(41u'
174.3279 +.mk ##
174.3280 +.nr 31 \n(##
174.3281 +.sp |\n(##u-1v
174.3282 +.nr 37 \n(41u
174.3283 +.in +\n(37u
174.3284 +.d+
174.3285 +.in -\n(37u
174.3286 +.mk 32
174.3287 +.if \n(32>\n(31 .nr 31 \n(32
174.3288 +.sp |\n(31u
174.3289 +.ta \n(80u \n(81u
174.3290 +.nr 31 \n(.f
174.3291 +.nr 35 1m
174.3292 +\&\h'|\n(40u'TT\h'|\n(41u'罧水ャ
174.3293 +.ne \n(e|u+\n(.Vu
174.3294 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.3295 +.ta \n(80u \n(81u
174.3296 +.nr 31 \n(.f
174.3297 +.nr 35 1m
174.3298 +\&\h'|\n(40u'MTT\h'|\n(41u'
174.3299 +.mk ##
174.3300 +.nr 31 \n(##
174.3301 +.sp |\n(##u-1v
174.3302 +.nr 37 \n(41u
174.3303 +.in +\n(37u
174.3304 +.e+
174.3305 +.in -\n(37u
174.3306 +.mk 32
174.3307 +.if \n(32>\n(31 .nr 31 \n(32
174.3308 +.sp |\n(31u
174.3309 +.ne \n(f|u+\n(.Vu
174.3310 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.3311 +.ta \n(80u \n(81u
174.3312 +.nr 31 \n(.f
174.3313 +.nr 35 1m
174.3314 +\&\h'|\n(40u'DSS\h'|\n(41u'
174.3315 +.mk ##
174.3316 +.nr 31 \n(##
174.3317 +.sp |\n(##u-1v
174.3318 +.nr 37 \n(41u
174.3319 +.in +\n(37u
174.3320 +.f+
174.3321 +.in -\n(37u
174.3322 +.mk 32
174.3323 +.if \n(32>\n(31 .nr 31 \n(32
174.3324 +.sp |\n(31u
174.3325 +.ne \n(g|u+\n(.Vu
174.3326 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.3327 +.ta \n(80u \n(81u
174.3328 +.nr 31 \n(.f
174.3329 +.nr 35 1m
174.3330 +\&\h'|\n(40u'EC\h'|\n(41u'
174.3331 +.mk ##
174.3332 +.nr 31 \n(##
174.3333 +.sp |\n(##u-1v
174.3334 +.nr 37 \n(41u
174.3335 +.in +\n(37u
174.3336 +.g+
174.3337 +.in -\n(37u
174.3338 +.mk 32
174.3339 +.if \n(32>\n(31 .nr 31 \n(32
174.3340 +.sp |\n(31u
174.3341 +.ne \n(h|u+\n(.Vu
174.3342 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.3343 +.ta \n(80u \n(81u
174.3344 +.nr 31 \n(.f
174.3345 +.nr 35 1m
174.3346 +\&\h'|\n(40u'EU\h'|\n(41u'
174.3347 +.mk ##
174.3348 +.nr 31 \n(##
174.3349 +.sp |\n(##u-1v
174.3350 +.nr 37 \n(41u
174.3351 +.in +\n(37u
174.3352 +.h+
174.3353 +.in -\n(37u
174.3354 +.mk 32
174.3355 +.if \n(32>\n(31 .nr 31 \n(32
174.3356 +.sp |\n(31u
174.3357 +.ne \n(i|u+\n(.Vu
174.3358 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.3359 +.ta \n(80u \n(81u
174.3360 +.nr 31 \n(.f
174.3361 +.nr 35 1m
174.3362 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.3363 +.mk ##
174.3364 +.nr 31 \n(##
174.3365 +.sp |\n(##u-1v
174.3366 +.nr 37 \n(41u
174.3367 +.in +\n(37u
174.3368 +.i+
174.3369 +.in -\n(37u
174.3370 +.mk 32
174.3371 +.if \n(32>\n(31 .nr 31 \n(32
174.3372 +.sp |\n(31u
174.3373 +.ne \n(j|u+\n(.Vu
174.3374 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
174.3375 +.ta \n(80u \n(81u
174.3376 +.nr 31 \n(.f
174.3377 +.nr 35 1m
174.3378 +\&\h'|\n(40u'YGCT\h'|\n(41u'
174.3379 +.mk ##
174.3380 +.nr 31 \n(##
174.3381 +.sp |\n(##u-1v
174.3382 +.nr 37 \n(41u
174.3383 +.in +\n(37u
174.3384 +.j+
174.3385 +.in -\n(37u
174.3386 +.mk 32
174.3387 +.if \n(32>\n(31 .nr 31 \n(32
174.3388 +.sp |\n(31u
174.3389 +.fc
174.3390 +.nr T. 1
174.3391 +.T# 1
174.3392 +.35
174.3393 +.rm a+
174.3394 +.rm b+
174.3395 +.rm c+
174.3396 +.rm d+
174.3397 +.rm e+
174.3398 +.rm f+
174.3399 +.rm g+
174.3400 +.rm h+
174.3401 +.rm i+
174.3402 +.rm j+
174.3403 +.TE
174.3404 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
174.3405 +
174.3406 +.LP
174.3407 +.SS
174.3408 +\-gcnewcapacity 激с
174.3409 +.LP
174.3410 +.LP
174.3411 +.TS
174.3412 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.3413 +.de 35
174.3414 +.ps \n(.s
174.3415 +.vs \n(.vu
174.3416 +.in \n(.iu
174.3417 +.if \n(.u .fi
174.3418 +.if \n(.j .ad
174.3419 +.if \n(.j=0 .na
174.3420 +..
174.3421 +.nf
174.3422 +.nr #~ 0
174.3423 +.if n .nr #~ 0.6n
174.3424 +.ds #d .d
174.3425 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.3426 +.fc
174.3427 +.nr 33 \n(.s
174.3428 +.rm 80 81
174.3429 +.nr 34 \n(.lu
174.3430 +.eo
174.3431 +.am 80
174.3432 +.br
174.3433 +.di a+
174.3434 +.35
174.3435 +.ft \n(.f
174.3436 +.ll \n(34u*1u/3u
174.3437 +.if \n(.l<\n(80 .ll \n(80u
174.3438 +.in 0
174.3439 +NGCMN\ \ \ \ \ \ \ \ \ T}~T{
174.3440 +New 筝篁c絨鎘拷 (KB)
174.3441 +.br
174.3442 +.di
174.3443 +.nr a| \n(dn
174.3444 +.nr a- \n(dl
174.3445 +..
174.3446 +.ec \
174.3447 +.eo
174.3448 +.am 81
174.3449 +.br
174.3450 +.di b+
174.3451 +.35
174.3452 +.ft \n(.f
174.3453 +.ll \n(34u*1u/3u
174.3454 +.if \n(.l<\n(81 .ll \n(81u
174.3455 +.in 0
174.3456 +New 筝篁c紊у拷 (KB)
174.3457 +.br
174.3458 +.di
174.3459 +.nr b| \n(dn
174.3460 +.nr b- \n(dl
174.3461 +..
174.3462 +.ec \
174.3463 +.eo
174.3464 +.am 81
174.3465 +.br
174.3466 +.di c+
174.3467 +.35
174.3468 +.ft \n(.f
174.3469 +.ll \n(34u*1u/3u
174.3470 +.if \n(.l<\n(81 .ll \n(81u
174.3471 +.in 0
174.3472 +New 筝篁c憜絎拷 (KB)
174.3473 +.br
174.3474 +.di
174.3475 +.nr c| \n(dn
174.3476 +.nr c- \n(dl
174.3477 +..
174.3478 +.ec \
174.3479 +.eo
174.3480 +.am 81
174.3481 +.br
174.3482 +.di d+
174.3483 +.35
174.3484 +.ft \n(.f
174.3485 +.ll \n(34u*1u/3u
174.3486 +.if \n(.l<\n(81 .ll \n(81u
174.3487 +.in 0
174.3488 +Survivor 0 紊у拷 (KB)
174.3489 +.br
174.3490 +.di
174.3491 +.nr d| \n(dn
174.3492 +.nr d- \n(dl
174.3493 +..
174.3494 +.ec \
174.3495 +.eo
174.3496 +.am 81
174.3497 +.br
174.3498 +.di e+
174.3499 +.35
174.3500 +.ft \n(.f
174.3501 +.ll \n(34u*1u/3u
174.3502 +.if \n(.l<\n(81 .ll \n(81u
174.3503 +.in 0
174.3504 +Survivor 0 憜絎拷 (KB)
174.3505 +.br
174.3506 +.di
174.3507 +.nr e| \n(dn
174.3508 +.nr e- \n(dl
174.3509 +..
174.3510 +.ec \
174.3511 +.eo
174.3512 +.am 81
174.3513 +.br
174.3514 +.di f+
174.3515 +.35
174.3516 +.ft \n(.f
174.3517 +.ll \n(34u*1u/3u
174.3518 +.if \n(.l<\n(81 .ll \n(81u
174.3519 +.in 0
174.3520 +Survivor 1 紊у拷 (KB)
174.3521 +.br
174.3522 +.di
174.3523 +.nr f| \n(dn
174.3524 +.nr f- \n(dl
174.3525 +..
174.3526 +.ec \
174.3527 +.eo
174.3528 +.am 81
174.3529 +.br
174.3530 +.di g+
174.3531 +.35
174.3532 +.ft \n(.f
174.3533 +.ll \n(34u*1u/3u
174.3534 +.if \n(.l<\n(81 .ll \n(81u
174.3535 +.in 0
174.3536 +Survivor 1 憜絎拷 (KB)
174.3537 +.br
174.3538 +.di
174.3539 +.nr g| \n(dn
174.3540 +.nr g- \n(dl
174.3541 +..
174.3542 +.ec \
174.3543 +.eo
174.3544 +.am 81
174.3545 +.br
174.3546 +.di h+
174.3547 +.35
174.3548 +.ft \n(.f
174.3549 +.ll \n(34u*1u/3u
174.3550 +.if \n(.l<\n(81 .ll \n(81u
174.3551 +.in 0
174.3552 +Eden 紊у拷 (KB)
174.3553 +.br
174.3554 +.di
174.3555 +.nr h| \n(dn
174.3556 +.nr h- \n(dl
174.3557 +..
174.3558 +.ec \
174.3559 +.eo
174.3560 +.am 81
174.3561 +.br
174.3562 +.di i+
174.3563 +.35
174.3564 +.ft \n(.f
174.3565 +.ll \n(34u*1u/3u
174.3566 +.if \n(.l<\n(81 .ll \n(81u
174.3567 +.in 0
174.3568 +Eden 憜絎拷 (KB)
174.3569 +.br
174.3570 +.di
174.3571 +.nr i| \n(dn
174.3572 +.nr i- \n(dl
174.3573 +..
174.3574 +.ec \
174.3575 +.eo
174.3576 +.am 81
174.3577 +.br
174.3578 +.di j+
174.3579 +.35
174.3580 +.ft \n(.f
174.3581 +.ll \n(34u*1u/3u
174.3582 +.if \n(.l<\n(81 .ll \n(81u
174.3583 +.in 0
174.3584 +ャ筝篁c GC ゃ潟
174.3585 +.br
174.3586 +.di
174.3587 +.nr j| \n(dn
174.3588 +.nr j- \n(dl
174.3589 +..
174.3590 +.ec \
174.3591 +.35
174.3592 +.nf
174.3593 +.ll \n(34u
174.3594 +.nr 80 0
174.3595 +.nr 38 \wNew 筝篁i泣ゃ冴腟沿若
174.3596 +.if \n(80<\n(38 .nr 80 \n(38
174.3597 +.nr 38 \w\f3\fP
174.3598 +.if \n(80<\n(38 .nr 80 \n(38
174.3599 +.nr 38 \wNGCMX \ \ \
174.3600 +.if \n(80<\n(38 .nr 80 \n(38
174.3601 +.nr 38 \wNGC \ \ \
174.3602 +.if \n(80<\n(38 .nr 80 \n(38
174.3603 +.nr 38 \wS0CMX
174.3604 +.if \n(80<\n(38 .nr 80 \n(38
174.3605 +.nr 38 \wS0C
174.3606 +.if \n(80<\n(38 .nr 80 \n(38
174.3607 +.nr 38 \wS1CMX
174.3608 +.if \n(80<\n(38 .nr 80 \n(38
174.3609 +.nr 38 \wS1C
174.3610 +.if \n(80<\n(38 .nr 80 \n(38
174.3611 +.nr 38 \wECMX
174.3612 +.if \n(80<\n(38 .nr 80 \n(38
174.3613 +.nr 38 \wEC
174.3614 +.if \n(80<\n(38 .nr 80 \n(38
174.3615 +.nr 38 \wYGC
174.3616 +.if \n(80<\n(38 .nr 80 \n(38
174.3617 +.nr 38 \wFGC
174.3618 +.if \n(80<\n(38 .nr 80 \n(38
174.3619 +.80
174.3620 +.rm 80
174.3621 +.nr 38 \n(a-
174.3622 +.if \n(80<\n(38 .nr 80 \n(38
174.3623 +.nr 81 0
174.3624 +.nr 38 \w\f3茯\fP
174.3625 +.if \n(81<\n(38 .nr 81 \n(38
174.3626 +.nr 38 \w GC ゃ潟
174.3627 +.if \n(81<\n(38 .nr 81 \n(38
174.3628 +.81
174.3629 +.rm 81
174.3630 +.nr 38 \n(b-
174.3631 +.if \n(81<\n(38 .nr 81 \n(38
174.3632 +.nr 38 \n(c-
174.3633 +.if \n(81<\n(38 .nr 81 \n(38
174.3634 +.nr 38 \n(d-
174.3635 +.if \n(81<\n(38 .nr 81 \n(38
174.3636 +.nr 38 \n(e-
174.3637 +.if \n(81<\n(38 .nr 81 \n(38
174.3638 +.nr 38 \n(f-
174.3639 +.if \n(81<\n(38 .nr 81 \n(38
174.3640 +.nr 38 \n(g-
174.3641 +.if \n(81<\n(38 .nr 81 \n(38
174.3642 +.nr 38 \n(h-
174.3643 +.if \n(81<\n(38 .nr 81 \n(38
174.3644 +.nr 38 \n(i-
174.3645 +.if \n(81<\n(38 .nr 81 \n(38
174.3646 +.nr 38 \n(j-
174.3647 +.if \n(81<\n(38 .nr 81 \n(38
174.3648 +.35
174.3649 +.nf
174.3650 +.ll \n(34u
174.3651 +.nr 38 1n
174.3652 +.nr 79 0
174.3653 +.nr 40 \n(79+(0*\n(38)
174.3654 +.nr 80 +\n(40
174.3655 +.nr 41 \n(80+(3*\n(38)
174.3656 +.nr 81 +\n(41
174.3657 +.nr TW \n(81
174.3658 +.if t .if \n(TW>\n(.li .tm Table at line 627 file Input is too wide - \n(TW units
174.3659 +.fc
174.3660 +.nr #T 0-1
174.3661 +.nr #a 0-1
174.3662 +.eo
174.3663 +.de T#
174.3664 +.ds #d .d
174.3665 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.3666 +.mk ##
174.3667 +.nr ## -1v
174.3668 +.ls 1
174.3669 +.ls
174.3670 +..
174.3671 +.ec
174.3672 +.ta \n(80u \n(81u
174.3673 +.nr 31 \n(.f
174.3674 +.nr 35 1m
174.3675 +\&\h'|\n(40u'New 筝篁i泣ゃ冴腟沿若\h'|\n(41u'
174.3676 +.ta \n(80u \n(81u
174.3677 +.nr 31 \n(.f
174.3678 +.nr 35 1m
174.3679 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.3680 +.ne \n(a|u+\n(.Vu
174.3681 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.3682 +.ta \n(80u \n(81u
174.3683 +.nr 31 \n(.f
174.3684 +.nr 35 1m
174.3685 +\&\h'|\n(40u'\h'|\n(41u'
174.3686 +.mk ##
174.3687 +.nr 31 \n(##
174.3688 +.sp |\n(##u-1v
174.3689 +.nr 37 \n(40u
174.3690 +.in +\n(37u
174.3691 +.a+
174.3692 +.in -\n(37u
174.3693 +.mk 32
174.3694 +.if \n(32>\n(31 .nr 31 \n(32
174.3695 +.sp |\n(31u
174.3696 +.ne \n(b|u+\n(.Vu
174.3697 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.3698 +.ta \n(80u \n(81u
174.3699 +.nr 31 \n(.f
174.3700 +.nr 35 1m
174.3701 +\&\h'|\n(40u'NGCMX \ \ \\h'|\n(41u'
174.3702 +.mk ##
174.3703 +.nr 31 \n(##
174.3704 +.sp |\n(##u-1v
174.3705 +.nr 37 \n(41u
174.3706 +.in +\n(37u
174.3707 +.b+
174.3708 +.in -\n(37u
174.3709 +.mk 32
174.3710 +.if \n(32>\n(31 .nr 31 \n(32
174.3711 +.sp |\n(31u
174.3712 +.ne \n(c|u+\n(.Vu
174.3713 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.3714 +.ta \n(80u \n(81u
174.3715 +.nr 31 \n(.f
174.3716 +.nr 35 1m
174.3717 +\&\h'|\n(40u'NGC \ \ \\h'|\n(41u'
174.3718 +.mk ##
174.3719 +.nr 31 \n(##
174.3720 +.sp |\n(##u-1v
174.3721 +.nr 37 \n(41u
174.3722 +.in +\n(37u
174.3723 +.c+
174.3724 +.in -\n(37u
174.3725 +.mk 32
174.3726 +.if \n(32>\n(31 .nr 31 \n(32
174.3727 +.sp |\n(31u
174.3728 +.ne \n(d|u+\n(.Vu
174.3729 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.3730 +.ta \n(80u \n(81u
174.3731 +.nr 31 \n(.f
174.3732 +.nr 35 1m
174.3733 +\&\h'|\n(40u'S0CMX\h'|\n(41u'
174.3734 +.mk ##
174.3735 +.nr 31 \n(##
174.3736 +.sp |\n(##u-1v
174.3737 +.nr 37 \n(41u
174.3738 +.in +\n(37u
174.3739 +.d+
174.3740 +.in -\n(37u
174.3741 +.mk 32
174.3742 +.if \n(32>\n(31 .nr 31 \n(32
174.3743 +.sp |\n(31u
174.3744 +.ne \n(e|u+\n(.Vu
174.3745 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.3746 +.ta \n(80u \n(81u
174.3747 +.nr 31 \n(.f
174.3748 +.nr 35 1m
174.3749 +\&\h'|\n(40u'S0C\h'|\n(41u'
174.3750 +.mk ##
174.3751 +.nr 31 \n(##
174.3752 +.sp |\n(##u-1v
174.3753 +.nr 37 \n(41u
174.3754 +.in +\n(37u
174.3755 +.e+
174.3756 +.in -\n(37u
174.3757 +.mk 32
174.3758 +.if \n(32>\n(31 .nr 31 \n(32
174.3759 +.sp |\n(31u
174.3760 +.ne \n(f|u+\n(.Vu
174.3761 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.3762 +.ta \n(80u \n(81u
174.3763 +.nr 31 \n(.f
174.3764 +.nr 35 1m
174.3765 +\&\h'|\n(40u'S1CMX\h'|\n(41u'
174.3766 +.mk ##
174.3767 +.nr 31 \n(##
174.3768 +.sp |\n(##u-1v
174.3769 +.nr 37 \n(41u
174.3770 +.in +\n(37u
174.3771 +.f+
174.3772 +.in -\n(37u
174.3773 +.mk 32
174.3774 +.if \n(32>\n(31 .nr 31 \n(32
174.3775 +.sp |\n(31u
174.3776 +.ne \n(g|u+\n(.Vu
174.3777 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.3778 +.ta \n(80u \n(81u
174.3779 +.nr 31 \n(.f
174.3780 +.nr 35 1m
174.3781 +\&\h'|\n(40u'S1C\h'|\n(41u'
174.3782 +.mk ##
174.3783 +.nr 31 \n(##
174.3784 +.sp |\n(##u-1v
174.3785 +.nr 37 \n(41u
174.3786 +.in +\n(37u
174.3787 +.g+
174.3788 +.in -\n(37u
174.3789 +.mk 32
174.3790 +.if \n(32>\n(31 .nr 31 \n(32
174.3791 +.sp |\n(31u
174.3792 +.ne \n(h|u+\n(.Vu
174.3793 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.3794 +.ta \n(80u \n(81u
174.3795 +.nr 31 \n(.f
174.3796 +.nr 35 1m
174.3797 +\&\h'|\n(40u'ECMX\h'|\n(41u'
174.3798 +.mk ##
174.3799 +.nr 31 \n(##
174.3800 +.sp |\n(##u-1v
174.3801 +.nr 37 \n(41u
174.3802 +.in +\n(37u
174.3803 +.h+
174.3804 +.in -\n(37u
174.3805 +.mk 32
174.3806 +.if \n(32>\n(31 .nr 31 \n(32
174.3807 +.sp |\n(31u
174.3808 +.ne \n(i|u+\n(.Vu
174.3809 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.3810 +.ta \n(80u \n(81u
174.3811 +.nr 31 \n(.f
174.3812 +.nr 35 1m
174.3813 +\&\h'|\n(40u'EC\h'|\n(41u'
174.3814 +.mk ##
174.3815 +.nr 31 \n(##
174.3816 +.sp |\n(##u-1v
174.3817 +.nr 37 \n(41u
174.3818 +.in +\n(37u
174.3819 +.i+
174.3820 +.in -\n(37u
174.3821 +.mk 32
174.3822 +.if \n(32>\n(31 .nr 31 \n(32
174.3823 +.sp |\n(31u
174.3824 +.ne \n(j|u+\n(.Vu
174.3825 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
174.3826 +.ta \n(80u \n(81u
174.3827 +.nr 31 \n(.f
174.3828 +.nr 35 1m
174.3829 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.3830 +.mk ##
174.3831 +.nr 31 \n(##
174.3832 +.sp |\n(##u-1v
174.3833 +.nr 37 \n(41u
174.3834 +.in +\n(37u
174.3835 +.j+
174.3836 +.in -\n(37u
174.3837 +.mk 32
174.3838 +.if \n(32>\n(31 .nr 31 \n(32
174.3839 +.sp |\n(31u
174.3840 +.ta \n(80u \n(81u
174.3841 +.nr 31 \n(.f
174.3842 +.nr 35 1m
174.3843 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.3844 +.fc
174.3845 +.nr T. 1
174.3846 +.T# 1
174.3847 +.35
174.3848 +.rm a+
174.3849 +.rm b+
174.3850 +.rm c+
174.3851 +.rm d+
174.3852 +.rm e+
174.3853 +.rm f+
174.3854 +.rm g+
174.3855 +.rm h+
174.3856 +.rm i+
174.3857 +.rm j+
174.3858 +.TE
174.3859 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
174.3860 +
174.3861 +.LP
174.3862 +.SS
174.3863 +\-gcold 激с
174.3864 +.LP
174.3865 +.LP
174.3866 +.TS
174.3867 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.3868 +.de 35
174.3869 +.ps \n(.s
174.3870 +.vs \n(.vu
174.3871 +.in \n(.iu
174.3872 +.if \n(.u .fi
174.3873 +.if \n(.j .ad
174.3874 +.if \n(.j=0 .na
174.3875 +..
174.3876 +.nf
174.3877 +.nr #~ 0
174.3878 +.if n .nr #~ 0.6n
174.3879 +.ds #d .d
174.3880 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.3881 +.fc
174.3882 +.nr 33 \n(.s
174.3883 +.rm 80 81
174.3884 +.nr 34 \n(.lu
174.3885 +.eo
174.3886 +.am 81
174.3887 +.br
174.3888 +.di a+
174.3889 +.35
174.3890 +.ft \n(.f
174.3891 +.ll \n(34u*1u/3u
174.3892 +.if \n(.l<\n(81 .ll \n(81u
174.3893 +.in 0
174.3894 +Permanent 憜絎拷 (KB)
174.3895 +.br
174.3896 +.di
174.3897 +.nr a| \n(dn
174.3898 +.nr a- \n(dl
174.3899 +..
174.3900 +.ec \
174.3901 +.eo
174.3902 +.am 81
174.3903 +.br
174.3904 +.di b+
174.3905 +.35
174.3906 +.ft \n(.f
174.3907 +.ll \n(34u*1u/3u
174.3908 +.if \n(.l<\n(81 .ll \n(81u
174.3909 +.in 0
174.3910 +Permanent 篏睡 (KB)
174.3911 +.br
174.3912 +.di
174.3913 +.nr b| \n(dn
174.3914 +.nr b- \n(dl
174.3915 +..
174.3916 +.ec \
174.3917 +.eo
174.3918 +.am 81
174.3919 +.br
174.3920 +.di c+
174.3921 +.35
174.3922 +.ft \n(.f
174.3923 +.ll \n(34u*1u/3u
174.3924 +.if \n(.l<\n(81 .ll \n(81u
174.3925 +.in 0
174.3926 +Old 憜絎拷 (KB)
174.3927 +.br
174.3928 +.di
174.3929 +.nr c| \n(dn
174.3930 +.nr c- \n(dl
174.3931 +..
174.3932 +.ec \
174.3933 +.eo
174.3934 +.am 81
174.3935 +.br
174.3936 +.di d+
174.3937 +.35
174.3938 +.ft \n(.f
174.3939 +.ll \n(34u*1u/3u
174.3940 +.if \n(.l<\n(81 .ll \n(81u
174.3941 +.in 0
174.3942 +Old 篏睡 (KB)
174.3943 +.br
174.3944 +.di
174.3945 +.nr d| \n(dn
174.3946 +.nr d- \n(dl
174.3947 +..
174.3948 +.ec \
174.3949 +.eo
174.3950 +.am 81
174.3951 +.br
174.3952 +.di e+
174.3953 +.35
174.3954 +.ft \n(.f
174.3955 +.ll \n(34u*1u/3u
174.3956 +.if \n(.l<\n(81 .ll \n(81u
174.3957 +.in 0
174.3958 +ャ筝篁c GC ゃ潟
174.3959 +.br
174.3960 +.di
174.3961 +.nr e| \n(dn
174.3962 +.nr e- \n(dl
174.3963 +..
174.3964 +.ec \
174.3965 +.eo
174.3966 +.am 81
174.3967 +.br
174.3968 +.di f+
174.3969 +.35
174.3970 +.ft \n(.f
174.3971 +.ll \n(34u*1u/3u
174.3972 +.if \n(.l<\n(81 .ll \n(81u
174.3973 +.in 0
174.3974 +若吾潟激с恰
174.3975 +.br
174.3976 +.di
174.3977 +.nr f| \n(dn
174.3978 +.nr f- \n(dl
174.3979 +..
174.3980 +.ec \
174.3981 +.eo
174.3982 +.am 81
174.3983 +.br
174.3984 +.di g+
174.3985 +.35
174.3986 +.ft \n(.f
174.3987 +.ll \n(34u*1u/3u
174.3988 +.if \n(.l<\n(81 .ll \n(81u
174.3989 +.in 0
174.3990 +若吾潟激с括
174.3991 +.br
174.3992 +.di
174.3993 +.nr g| \n(dn
174.3994 +.nr g- \n(dl
174.3995 +..
174.3996 +.ec \
174.3997 +.35
174.3998 +.nf
174.3999 +.ll \n(34u
174.4000 +.nr 80 0
174.4001 +.nr 38 \wOld Permanent 筝篁c腟沿若
174.4002 +.if \n(80<\n(38 .nr 80 \n(38
174.4003 +.nr 38 \w\f3\fP
174.4004 +.if \n(80<\n(38 .nr 80 \n(38
174.4005 +.nr 38 \wPC
174.4006 +.if \n(80<\n(38 .nr 80 \n(38
174.4007 +.nr 38 \wPU
174.4008 +.if \n(80<\n(38 .nr 80 \n(38
174.4009 +.nr 38 \wOC
174.4010 +.if \n(80<\n(38 .nr 80 \n(38
174.4011 +.nr 38 \wOU
174.4012 +.if \n(80<\n(38 .nr 80 \n(38
174.4013 +.nr 38 \wYGC
174.4014 +.if \n(80<\n(38 .nr 80 \n(38
174.4015 +.nr 38 \wFGC
174.4016 +.if \n(80<\n(38 .nr 80 \n(38
174.4017 +.nr 38 \wFGCT
174.4018 +.if \n(80<\n(38 .nr 80 \n(38
174.4019 +.nr 38 \wGCT
174.4020 +.if \n(80<\n(38 .nr 80 \n(38
174.4021 +.80
174.4022 +.rm 80
174.4023 +.nr 81 0
174.4024 +.nr 38 \w\f3茯\fP
174.4025 +.if \n(81<\n(38 .nr 81 \n(38
174.4026 +.nr 38 \w GC ゃ潟
174.4027 +.if \n(81<\n(38 .nr 81 \n(38
174.4028 +.81
174.4029 +.rm 81
174.4030 +.nr 38 \n(a-
174.4031 +.if \n(81<\n(38 .nr 81 \n(38
174.4032 +.nr 38 \n(b-
174.4033 +.if \n(81<\n(38 .nr 81 \n(38
174.4034 +.nr 38 \n(c-
174.4035 +.if \n(81<\n(38 .nr 81 \n(38
174.4036 +.nr 38 \n(d-
174.4037 +.if \n(81<\n(38 .nr 81 \n(38
174.4038 +.nr 38 \n(e-
174.4039 +.if \n(81<\n(38 .nr 81 \n(38
174.4040 +.nr 38 \n(f-
174.4041 +.if \n(81<\n(38 .nr 81 \n(38
174.4042 +.nr 38 \n(g-
174.4043 +.if \n(81<\n(38 .nr 81 \n(38
174.4044 +.35
174.4045 +.nf
174.4046 +.ll \n(34u
174.4047 +.nr 38 1n
174.4048 +.nr 79 0
174.4049 +.nr 40 \n(79+(0*\n(38)
174.4050 +.nr 80 +\n(40
174.4051 +.nr 41 \n(80+(3*\n(38)
174.4052 +.nr 81 +\n(41
174.4053 +.nr TW \n(81
174.4054 +.if t .if \n(TW>\n(.li .tm Table at line 669 file Input is too wide - \n(TW units
174.4055 +.fc
174.4056 +.nr #T 0-1
174.4057 +.nr #a 0-1
174.4058 +.eo
174.4059 +.de T#
174.4060 +.ds #d .d
174.4061 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4062 +.mk ##
174.4063 +.nr ## -1v
174.4064 +.ls 1
174.4065 +.ls
174.4066 +..
174.4067 +.ec
174.4068 +.ta \n(80u \n(81u
174.4069 +.nr 31 \n(.f
174.4070 +.nr 35 1m
174.4071 +\&\h'|\n(40u'Old Permanent 筝篁c腟沿若\h'|\n(41u'
174.4072 +.ta \n(80u \n(81u
174.4073 +.nr 31 \n(.f
174.4074 +.nr 35 1m
174.4075 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.4076 +.ne \n(a|u+\n(.Vu
174.4077 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.4078 +.ta \n(80u \n(81u
174.4079 +.nr 31 \n(.f
174.4080 +.nr 35 1m
174.4081 +\&\h'|\n(40u'PC\h'|\n(41u'
174.4082 +.mk ##
174.4083 +.nr 31 \n(##
174.4084 +.sp |\n(##u-1v
174.4085 +.nr 37 \n(41u
174.4086 +.in +\n(37u
174.4087 +.a+
174.4088 +.in -\n(37u
174.4089 +.mk 32
174.4090 +.if \n(32>\n(31 .nr 31 \n(32
174.4091 +.sp |\n(31u
174.4092 +.ne \n(b|u+\n(.Vu
174.4093 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.4094 +.ta \n(80u \n(81u
174.4095 +.nr 31 \n(.f
174.4096 +.nr 35 1m
174.4097 +\&\h'|\n(40u'PU\h'|\n(41u'
174.4098 +.mk ##
174.4099 +.nr 31 \n(##
174.4100 +.sp |\n(##u-1v
174.4101 +.nr 37 \n(41u
174.4102 +.in +\n(37u
174.4103 +.b+
174.4104 +.in -\n(37u
174.4105 +.mk 32
174.4106 +.if \n(32>\n(31 .nr 31 \n(32
174.4107 +.sp |\n(31u
174.4108 +.ne \n(c|u+\n(.Vu
174.4109 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.4110 +.ta \n(80u \n(81u
174.4111 +.nr 31 \n(.f
174.4112 +.nr 35 1m
174.4113 +\&\h'|\n(40u'OC\h'|\n(41u'
174.4114 +.mk ##
174.4115 +.nr 31 \n(##
174.4116 +.sp |\n(##u-1v
174.4117 +.nr 37 \n(41u
174.4118 +.in +\n(37u
174.4119 +.c+
174.4120 +.in -\n(37u
174.4121 +.mk 32
174.4122 +.if \n(32>\n(31 .nr 31 \n(32
174.4123 +.sp |\n(31u
174.4124 +.ne \n(d|u+\n(.Vu
174.4125 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.4126 +.ta \n(80u \n(81u
174.4127 +.nr 31 \n(.f
174.4128 +.nr 35 1m
174.4129 +\&\h'|\n(40u'OU\h'|\n(41u'
174.4130 +.mk ##
174.4131 +.nr 31 \n(##
174.4132 +.sp |\n(##u-1v
174.4133 +.nr 37 \n(41u
174.4134 +.in +\n(37u
174.4135 +.d+
174.4136 +.in -\n(37u
174.4137 +.mk 32
174.4138 +.if \n(32>\n(31 .nr 31 \n(32
174.4139 +.sp |\n(31u
174.4140 +.ne \n(e|u+\n(.Vu
174.4141 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.4142 +.ta \n(80u \n(81u
174.4143 +.nr 31 \n(.f
174.4144 +.nr 35 1m
174.4145 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.4146 +.mk ##
174.4147 +.nr 31 \n(##
174.4148 +.sp |\n(##u-1v
174.4149 +.nr 37 \n(41u
174.4150 +.in +\n(37u
174.4151 +.e+
174.4152 +.in -\n(37u
174.4153 +.mk 32
174.4154 +.if \n(32>\n(31 .nr 31 \n(32
174.4155 +.sp |\n(31u
174.4156 +.ta \n(80u \n(81u
174.4157 +.nr 31 \n(.f
174.4158 +.nr 35 1m
174.4159 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.4160 +.ne \n(f|u+\n(.Vu
174.4161 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.4162 +.ta \n(80u \n(81u
174.4163 +.nr 31 \n(.f
174.4164 +.nr 35 1m
174.4165 +\&\h'|\n(40u'FGCT\h'|\n(41u'
174.4166 +.mk ##
174.4167 +.nr 31 \n(##
174.4168 +.sp |\n(##u-1v
174.4169 +.nr 37 \n(41u
174.4170 +.in +\n(37u
174.4171 +.f+
174.4172 +.in -\n(37u
174.4173 +.mk 32
174.4174 +.if \n(32>\n(31 .nr 31 \n(32
174.4175 +.sp |\n(31u
174.4176 +.ne \n(g|u+\n(.Vu
174.4177 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.4178 +.ta \n(80u \n(81u
174.4179 +.nr 31 \n(.f
174.4180 +.nr 35 1m
174.4181 +\&\h'|\n(40u'GCT\h'|\n(41u'
174.4182 +.mk ##
174.4183 +.nr 31 \n(##
174.4184 +.sp |\n(##u-1v
174.4185 +.nr 37 \n(41u
174.4186 +.in +\n(37u
174.4187 +.g+
174.4188 +.in -\n(37u
174.4189 +.mk 32
174.4190 +.if \n(32>\n(31 .nr 31 \n(32
174.4191 +.sp |\n(31u
174.4192 +.fc
174.4193 +.nr T. 1
174.4194 +.T# 1
174.4195 +.35
174.4196 +.rm a+
174.4197 +.rm b+
174.4198 +.rm c+
174.4199 +.rm d+
174.4200 +.rm e+
174.4201 +.rm f+
174.4202 +.rm g+
174.4203 +.TE
174.4204 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.4205 +
174.4206 +.LP
174.4207 +.SS
174.4208 +\-gcoldcapacity 激с
174.4209 +.LP
174.4210 +.LP
174.4211 +.TS
174.4212 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.4213 +.de 35
174.4214 +.ps \n(.s
174.4215 +.vs \n(.vu
174.4216 +.in \n(.iu
174.4217 +.if \n(.u .fi
174.4218 +.if \n(.j .ad
174.4219 +.if \n(.j=0 .na
174.4220 +..
174.4221 +.nf
174.4222 +.nr #~ 0
174.4223 +.if n .nr #~ 0.6n
174.4224 +.ds #d .d
174.4225 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4226 +.fc
174.4227 +.nr 33 \n(.s
174.4228 +.rm 80 81
174.4229 +.nr 34 \n(.lu
174.4230 +.eo
174.4231 +.am 81
174.4232 +.br
174.4233 +.di a+
174.4234 +.35
174.4235 +.ft \n(.f
174.4236 +.ll \n(34u*1u/3u
174.4237 +.if \n(.l<\n(81 .ll \n(81u
174.4238 +.in 0
174.4239 +Old 筝篁c絨鎘拷 (KB)
174.4240 +.br
174.4241 +.di
174.4242 +.nr a| \n(dn
174.4243 +.nr a- \n(dl
174.4244 +..
174.4245 +.ec \
174.4246 +.eo
174.4247 +.am 81
174.4248 +.br
174.4249 +.di b+
174.4250 +.35
174.4251 +.ft \n(.f
174.4252 +.ll \n(34u*1u/3u
174.4253 +.if \n(.l<\n(81 .ll \n(81u
174.4254 +.in 0
174.4255 +Old 筝篁c紊у拷 (KB)
174.4256 +.br
174.4257 +.di
174.4258 +.nr b| \n(dn
174.4259 +.nr b- \n(dl
174.4260 +..
174.4261 +.ec \
174.4262 +.eo
174.4263 +.am 81
174.4264 +.br
174.4265 +.di c+
174.4266 +.35
174.4267 +.ft \n(.f
174.4268 +.ll \n(34u*1u/3u
174.4269 +.if \n(.l<\n(81 .ll \n(81u
174.4270 +.in 0
174.4271 +Old 筝篁c憜絎拷 (KB)
174.4272 +.br
174.4273 +.di
174.4274 +.nr c| \n(dn
174.4275 +.nr c- \n(dl
174.4276 +..
174.4277 +.ec \
174.4278 +.eo
174.4279 +.am 81
174.4280 +.br
174.4281 +.di d+
174.4282 +.35
174.4283 +.ft \n(.f
174.4284 +.ll \n(34u*1u/3u
174.4285 +.if \n(.l<\n(81 .ll \n(81u
174.4286 +.in 0
174.4287 +Old 憜絎拷 (KB)
174.4288 +.br
174.4289 +.di
174.4290 +.nr d| \n(dn
174.4291 +.nr d- \n(dl
174.4292 +..
174.4293 +.ec \
174.4294 +.eo
174.4295 +.am 81
174.4296 +.br
174.4297 +.di e+
174.4298 +.35
174.4299 +.ft \n(.f
174.4300 +.ll \n(34u*1u/3u
174.4301 +.if \n(.l<\n(81 .ll \n(81u
174.4302 +.in 0
174.4303 +ャ筝篁c GC ゃ潟
174.4304 +.br
174.4305 +.di
174.4306 +.nr e| \n(dn
174.4307 +.nr e- \n(dl
174.4308 +..
174.4309 +.ec \
174.4310 +.eo
174.4311 +.am 81
174.4312 +.br
174.4313 +.di f+
174.4314 +.35
174.4315 +.ft \n(.f
174.4316 +.ll \n(34u*1u/3u
174.4317 +.if \n(.l<\n(81 .ll \n(81u
174.4318 +.in 0
174.4319 +若吾潟激с恰
174.4320 +.br
174.4321 +.di
174.4322 +.nr f| \n(dn
174.4323 +.nr f- \n(dl
174.4324 +..
174.4325 +.ec \
174.4326 +.eo
174.4327 +.am 81
174.4328 +.br
174.4329 +.di g+
174.4330 +.35
174.4331 +.ft \n(.f
174.4332 +.ll \n(34u*1u/3u
174.4333 +.if \n(.l<\n(81 .ll \n(81u
174.4334 +.in 0
174.4335 +若吾潟激с括
174.4336 +.br
174.4337 +.di
174.4338 +.nr g| \n(dn
174.4339 +.nr g- \n(dl
174.4340 +..
174.4341 +.ec \
174.4342 +.35
174.4343 +.nf
174.4344 +.ll \n(34u
174.4345 +.nr 80 0
174.4346 +.nr 38 \wOld 筝篁c腟沿若
174.4347 +.if \n(80<\n(38 .nr 80 \n(38
174.4348 +.nr 38 \w\f3\fP
174.4349 +.if \n(80<\n(38 .nr 80 \n(38
174.4350 +.nr 38 \wOGCMN
174.4351 +.if \n(80<\n(38 .nr 80 \n(38
174.4352 +.nr 38 \wOGCMX
174.4353 +.if \n(80<\n(38 .nr 80 \n(38
174.4354 +.nr 38 \wOGC
174.4355 +.if \n(80<\n(38 .nr 80 \n(38
174.4356 +.nr 38 \wOC
174.4357 +.if \n(80<\n(38 .nr 80 \n(38
174.4358 +.nr 38 \wYGC
174.4359 +.if \n(80<\n(38 .nr 80 \n(38
174.4360 +.nr 38 \wFGC
174.4361 +.if \n(80<\n(38 .nr 80 \n(38
174.4362 +.nr 38 \wFGCT
174.4363 +.if \n(80<\n(38 .nr 80 \n(38
174.4364 +.nr 38 \wGCT
174.4365 +.if \n(80<\n(38 .nr 80 \n(38
174.4366 +.80
174.4367 +.rm 80
174.4368 +.nr 81 0
174.4369 +.nr 38 \w\f3茯\fP
174.4370 +.if \n(81<\n(38 .nr 81 \n(38
174.4371 +.nr 38 \w GC ゃ潟
174.4372 +.if \n(81<\n(38 .nr 81 \n(38
174.4373 +.81
174.4374 +.rm 81
174.4375 +.nr 38 \n(a-
174.4376 +.if \n(81<\n(38 .nr 81 \n(38
174.4377 +.nr 38 \n(b-
174.4378 +.if \n(81<\n(38 .nr 81 \n(38
174.4379 +.nr 38 \n(c-
174.4380 +.if \n(81<\n(38 .nr 81 \n(38
174.4381 +.nr 38 \n(d-
174.4382 +.if \n(81<\n(38 .nr 81 \n(38
174.4383 +.nr 38 \n(e-
174.4384 +.if \n(81<\n(38 .nr 81 \n(38
174.4385 +.nr 38 \n(f-
174.4386 +.if \n(81<\n(38 .nr 81 \n(38
174.4387 +.nr 38 \n(g-
174.4388 +.if \n(81<\n(38 .nr 81 \n(38
174.4389 +.35
174.4390 +.nf
174.4391 +.ll \n(34u
174.4392 +.nr 38 1n
174.4393 +.nr 79 0
174.4394 +.nr 40 \n(79+(0*\n(38)
174.4395 +.nr 80 +\n(40
174.4396 +.nr 41 \n(80+(3*\n(38)
174.4397 +.nr 81 +\n(41
174.4398 +.nr TW \n(81
174.4399 +.if t .if \n(TW>\n(.li .tm Table at line 711 file Input is too wide - \n(TW units
174.4400 +.fc
174.4401 +.nr #T 0-1
174.4402 +.nr #a 0-1
174.4403 +.eo
174.4404 +.de T#
174.4405 +.ds #d .d
174.4406 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4407 +.mk ##
174.4408 +.nr ## -1v
174.4409 +.ls 1
174.4410 +.ls
174.4411 +..
174.4412 +.ec
174.4413 +.ta \n(80u \n(81u
174.4414 +.nr 31 \n(.f
174.4415 +.nr 35 1m
174.4416 +\&\h'|\n(40u'Old 筝篁c腟沿若\h'|\n(41u'
174.4417 +.ta \n(80u \n(81u
174.4418 +.nr 31 \n(.f
174.4419 +.nr 35 1m
174.4420 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.4421 +.ne \n(a|u+\n(.Vu
174.4422 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.4423 +.ta \n(80u \n(81u
174.4424 +.nr 31 \n(.f
174.4425 +.nr 35 1m
174.4426 +\&\h'|\n(40u'OGCMN\h'|\n(41u'
174.4427 +.mk ##
174.4428 +.nr 31 \n(##
174.4429 +.sp |\n(##u-1v
174.4430 +.nr 37 \n(41u
174.4431 +.in +\n(37u
174.4432 +.a+
174.4433 +.in -\n(37u
174.4434 +.mk 32
174.4435 +.if \n(32>\n(31 .nr 31 \n(32
174.4436 +.sp |\n(31u
174.4437 +.ne \n(b|u+\n(.Vu
174.4438 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.4439 +.ta \n(80u \n(81u
174.4440 +.nr 31 \n(.f
174.4441 +.nr 35 1m
174.4442 +\&\h'|\n(40u'OGCMX\h'|\n(41u'
174.4443 +.mk ##
174.4444 +.nr 31 \n(##
174.4445 +.sp |\n(##u-1v
174.4446 +.nr 37 \n(41u
174.4447 +.in +\n(37u
174.4448 +.b+
174.4449 +.in -\n(37u
174.4450 +.mk 32
174.4451 +.if \n(32>\n(31 .nr 31 \n(32
174.4452 +.sp |\n(31u
174.4453 +.ne \n(c|u+\n(.Vu
174.4454 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.4455 +.ta \n(80u \n(81u
174.4456 +.nr 31 \n(.f
174.4457 +.nr 35 1m
174.4458 +\&\h'|\n(40u'OGC\h'|\n(41u'
174.4459 +.mk ##
174.4460 +.nr 31 \n(##
174.4461 +.sp |\n(##u-1v
174.4462 +.nr 37 \n(41u
174.4463 +.in +\n(37u
174.4464 +.c+
174.4465 +.in -\n(37u
174.4466 +.mk 32
174.4467 +.if \n(32>\n(31 .nr 31 \n(32
174.4468 +.sp |\n(31u
174.4469 +.ne \n(d|u+\n(.Vu
174.4470 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.4471 +.ta \n(80u \n(81u
174.4472 +.nr 31 \n(.f
174.4473 +.nr 35 1m
174.4474 +\&\h'|\n(40u'OC\h'|\n(41u'
174.4475 +.mk ##
174.4476 +.nr 31 \n(##
174.4477 +.sp |\n(##u-1v
174.4478 +.nr 37 \n(41u
174.4479 +.in +\n(37u
174.4480 +.d+
174.4481 +.in -\n(37u
174.4482 +.mk 32
174.4483 +.if \n(32>\n(31 .nr 31 \n(32
174.4484 +.sp |\n(31u
174.4485 +.ne \n(e|u+\n(.Vu
174.4486 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.4487 +.ta \n(80u \n(81u
174.4488 +.nr 31 \n(.f
174.4489 +.nr 35 1m
174.4490 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.4491 +.mk ##
174.4492 +.nr 31 \n(##
174.4493 +.sp |\n(##u-1v
174.4494 +.nr 37 \n(41u
174.4495 +.in +\n(37u
174.4496 +.e+
174.4497 +.in -\n(37u
174.4498 +.mk 32
174.4499 +.if \n(32>\n(31 .nr 31 \n(32
174.4500 +.sp |\n(31u
174.4501 +.ta \n(80u \n(81u
174.4502 +.nr 31 \n(.f
174.4503 +.nr 35 1m
174.4504 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.4505 +.ne \n(f|u+\n(.Vu
174.4506 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.4507 +.ta \n(80u \n(81u
174.4508 +.nr 31 \n(.f
174.4509 +.nr 35 1m
174.4510 +\&\h'|\n(40u'FGCT\h'|\n(41u'
174.4511 +.mk ##
174.4512 +.nr 31 \n(##
174.4513 +.sp |\n(##u-1v
174.4514 +.nr 37 \n(41u
174.4515 +.in +\n(37u
174.4516 +.f+
174.4517 +.in -\n(37u
174.4518 +.mk 32
174.4519 +.if \n(32>\n(31 .nr 31 \n(32
174.4520 +.sp |\n(31u
174.4521 +.ne \n(g|u+\n(.Vu
174.4522 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.4523 +.ta \n(80u \n(81u
174.4524 +.nr 31 \n(.f
174.4525 +.nr 35 1m
174.4526 +\&\h'|\n(40u'GCT\h'|\n(41u'
174.4527 +.mk ##
174.4528 +.nr 31 \n(##
174.4529 +.sp |\n(##u-1v
174.4530 +.nr 37 \n(41u
174.4531 +.in +\n(37u
174.4532 +.g+
174.4533 +.in -\n(37u
174.4534 +.mk 32
174.4535 +.if \n(32>\n(31 .nr 31 \n(32
174.4536 +.sp |\n(31u
174.4537 +.fc
174.4538 +.nr T. 1
174.4539 +.T# 1
174.4540 +.35
174.4541 +.rm a+
174.4542 +.rm b+
174.4543 +.rm c+
174.4544 +.rm d+
174.4545 +.rm e+
174.4546 +.rm f+
174.4547 +.rm g+
174.4548 +.TE
174.4549 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.4550 +
174.4551 +.LP
174.4552 +.SS
174.4553 +\-gcpermcapacity 激с
174.4554 +.LP
174.4555 +.LP
174.4556 +.TS
174.4557 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.4558 +.de 35
174.4559 +.ps \n(.s
174.4560 +.vs \n(.vu
174.4561 +.in \n(.iu
174.4562 +.if \n(.u .fi
174.4563 +.if \n(.j .ad
174.4564 +.if \n(.j=0 .na
174.4565 +..
174.4566 +.nf
174.4567 +.nr #~ 0
174.4568 +.if n .nr #~ 0.6n
174.4569 +.ds #d .d
174.4570 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4571 +.fc
174.4572 +.nr 33 \n(.s
174.4573 +.rm 80 81
174.4574 +.nr 34 \n(.lu
174.4575 +.eo
174.4576 +.am 81
174.4577 +.br
174.4578 +.di a+
174.4579 +.35
174.4580 +.ft \n(.f
174.4581 +.ll \n(34u*1u/3u
174.4582 +.if \n(.l<\n(81 .ll \n(81u
174.4583 +.in 0
174.4584 +Permanent 筝篁c絨鎘拷 (KB)
174.4585 +.br
174.4586 +.di
174.4587 +.nr a| \n(dn
174.4588 +.nr a- \n(dl
174.4589 +..
174.4590 +.ec \
174.4591 +.eo
174.4592 +.am 81
174.4593 +.br
174.4594 +.di b+
174.4595 +.35
174.4596 +.ft \n(.f
174.4597 +.ll \n(34u*1u/3u
174.4598 +.if \n(.l<\n(81 .ll \n(81u
174.4599 +.in 0
174.4600 +Permanent 筝篁c紊у拷 (KB)
174.4601 +.br
174.4602 +.di
174.4603 +.nr b| \n(dn
174.4604 +.nr b- \n(dl
174.4605 +..
174.4606 +.ec \
174.4607 +.eo
174.4608 +.am 81
174.4609 +.br
174.4610 +.di c+
174.4611 +.35
174.4612 +.ft \n(.f
174.4613 +.ll \n(34u*1u/3u
174.4614 +.if \n(.l<\n(81 .ll \n(81u
174.4615 +.in 0
174.4616 +Permanent 筝篁c憜絎拷 (KB)
174.4617 +.br
174.4618 +.di
174.4619 +.nr c| \n(dn
174.4620 +.nr c- \n(dl
174.4621 +..
174.4622 +.ec \
174.4623 +.eo
174.4624 +.am 81
174.4625 +.br
174.4626 +.di d+
174.4627 +.35
174.4628 +.ft \n(.f
174.4629 +.ll \n(34u*1u/3u
174.4630 +.if \n(.l<\n(81 .ll \n(81u
174.4631 +.in 0
174.4632 +Permanent 憜絎拷 (KB)
174.4633 +.br
174.4634 +.di
174.4635 +.nr d| \n(dn
174.4636 +.nr d- \n(dl
174.4637 +..
174.4638 +.ec \
174.4639 +.eo
174.4640 +.am 81
174.4641 +.br
174.4642 +.di e+
174.4643 +.35
174.4644 +.ft \n(.f
174.4645 +.ll \n(34u*1u/3u
174.4646 +.if \n(.l<\n(81 .ll \n(81u
174.4647 +.in 0
174.4648 +ャ筝篁c GC ゃ潟
174.4649 +.br
174.4650 +.di
174.4651 +.nr e| \n(dn
174.4652 +.nr e- \n(dl
174.4653 +..
174.4654 +.ec \
174.4655 +.eo
174.4656 +.am 81
174.4657 +.br
174.4658 +.di f+
174.4659 +.35
174.4660 +.ft \n(.f
174.4661 +.ll \n(34u*1u/3u
174.4662 +.if \n(.l<\n(81 .ll \n(81u
174.4663 +.in 0
174.4664 +若吾潟激с恰
174.4665 +.br
174.4666 +.di
174.4667 +.nr f| \n(dn
174.4668 +.nr f- \n(dl
174.4669 +..
174.4670 +.ec \
174.4671 +.eo
174.4672 +.am 81
174.4673 +.br
174.4674 +.di g+
174.4675 +.35
174.4676 +.ft \n(.f
174.4677 +.ll \n(34u*1u/3u
174.4678 +.if \n(.l<\n(81 .ll \n(81u
174.4679 +.in 0
174.4680 +若吾潟激с括
174.4681 +.br
174.4682 +.di
174.4683 +.nr g| \n(dn
174.4684 +.nr g- \n(dl
174.4685 +..
174.4686 +.ec \
174.4687 +.35
174.4688 +.nf
174.4689 +.ll \n(34u
174.4690 +.nr 80 0
174.4691 +.nr 38 \wPermanent 筝篁c腟沿若
174.4692 +.if \n(80<\n(38 .nr 80 \n(38
174.4693 +.nr 38 \w\f3\fP
174.4694 +.if \n(80<\n(38 .nr 80 \n(38
174.4695 +.nr 38 \wPGCMN
174.4696 +.if \n(80<\n(38 .nr 80 \n(38
174.4697 +.nr 38 \wPGCMX
174.4698 +.if \n(80<\n(38 .nr 80 \n(38
174.4699 +.nr 38 \wPGC
174.4700 +.if \n(80<\n(38 .nr 80 \n(38
174.4701 +.nr 38 \wPC
174.4702 +.if \n(80<\n(38 .nr 80 \n(38
174.4703 +.nr 38 \wYGC
174.4704 +.if \n(80<\n(38 .nr 80 \n(38
174.4705 +.nr 38 \wFGC
174.4706 +.if \n(80<\n(38 .nr 80 \n(38
174.4707 +.nr 38 \wFGCT
174.4708 +.if \n(80<\n(38 .nr 80 \n(38
174.4709 +.nr 38 \wGCT
174.4710 +.if \n(80<\n(38 .nr 80 \n(38
174.4711 +.80
174.4712 +.rm 80
174.4713 +.nr 81 0
174.4714 +.nr 38 \w\f3茯\fP
174.4715 +.if \n(81<\n(38 .nr 81 \n(38
174.4716 +.nr 38 \w GC ゃ潟
174.4717 +.if \n(81<\n(38 .nr 81 \n(38
174.4718 +.81
174.4719 +.rm 81
174.4720 +.nr 38 \n(a-
174.4721 +.if \n(81<\n(38 .nr 81 \n(38
174.4722 +.nr 38 \n(b-
174.4723 +.if \n(81<\n(38 .nr 81 \n(38
174.4724 +.nr 38 \n(c-
174.4725 +.if \n(81<\n(38 .nr 81 \n(38
174.4726 +.nr 38 \n(d-
174.4727 +.if \n(81<\n(38 .nr 81 \n(38
174.4728 +.nr 38 \n(e-
174.4729 +.if \n(81<\n(38 .nr 81 \n(38
174.4730 +.nr 38 \n(f-
174.4731 +.if \n(81<\n(38 .nr 81 \n(38
174.4732 +.nr 38 \n(g-
174.4733 +.if \n(81<\n(38 .nr 81 \n(38
174.4734 +.35
174.4735 +.nf
174.4736 +.ll \n(34u
174.4737 +.nr 38 1n
174.4738 +.nr 79 0
174.4739 +.nr 40 \n(79+(0*\n(38)
174.4740 +.nr 80 +\n(40
174.4741 +.nr 41 \n(80+(3*\n(38)
174.4742 +.nr 81 +\n(41
174.4743 +.nr TW \n(81
174.4744 +.if t .if \n(TW>\n(.li .tm Table at line 753 file Input is too wide - \n(TW units
174.4745 +.fc
174.4746 +.nr #T 0-1
174.4747 +.nr #a 0-1
174.4748 +.eo
174.4749 +.de T#
174.4750 +.ds #d .d
174.4751 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4752 +.mk ##
174.4753 +.nr ## -1v
174.4754 +.ls 1
174.4755 +.ls
174.4756 +..
174.4757 +.ec
174.4758 +.ta \n(80u \n(81u
174.4759 +.nr 31 \n(.f
174.4760 +.nr 35 1m
174.4761 +\&\h'|\n(40u'Permanent 筝篁c腟沿若\h'|\n(41u'
174.4762 +.ta \n(80u \n(81u
174.4763 +.nr 31 \n(.f
174.4764 +.nr 35 1m
174.4765 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.4766 +.ne \n(a|u+\n(.Vu
174.4767 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.4768 +.ta \n(80u \n(81u
174.4769 +.nr 31 \n(.f
174.4770 +.nr 35 1m
174.4771 +\&\h'|\n(40u'PGCMN\h'|\n(41u'
174.4772 +.mk ##
174.4773 +.nr 31 \n(##
174.4774 +.sp |\n(##u-1v
174.4775 +.nr 37 \n(41u
174.4776 +.in +\n(37u
174.4777 +.a+
174.4778 +.in -\n(37u
174.4779 +.mk 32
174.4780 +.if \n(32>\n(31 .nr 31 \n(32
174.4781 +.sp |\n(31u
174.4782 +.ne \n(b|u+\n(.Vu
174.4783 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.4784 +.ta \n(80u \n(81u
174.4785 +.nr 31 \n(.f
174.4786 +.nr 35 1m
174.4787 +\&\h'|\n(40u'PGCMX\h'|\n(41u'
174.4788 +.mk ##
174.4789 +.nr 31 \n(##
174.4790 +.sp |\n(##u-1v
174.4791 +.nr 37 \n(41u
174.4792 +.in +\n(37u
174.4793 +.b+
174.4794 +.in -\n(37u
174.4795 +.mk 32
174.4796 +.if \n(32>\n(31 .nr 31 \n(32
174.4797 +.sp |\n(31u
174.4798 +.ne \n(c|u+\n(.Vu
174.4799 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.4800 +.ta \n(80u \n(81u
174.4801 +.nr 31 \n(.f
174.4802 +.nr 35 1m
174.4803 +\&\h'|\n(40u'PGC\h'|\n(41u'
174.4804 +.mk ##
174.4805 +.nr 31 \n(##
174.4806 +.sp |\n(##u-1v
174.4807 +.nr 37 \n(41u
174.4808 +.in +\n(37u
174.4809 +.c+
174.4810 +.in -\n(37u
174.4811 +.mk 32
174.4812 +.if \n(32>\n(31 .nr 31 \n(32
174.4813 +.sp |\n(31u
174.4814 +.ne \n(d|u+\n(.Vu
174.4815 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.4816 +.ta \n(80u \n(81u
174.4817 +.nr 31 \n(.f
174.4818 +.nr 35 1m
174.4819 +\&\h'|\n(40u'PC\h'|\n(41u'
174.4820 +.mk ##
174.4821 +.nr 31 \n(##
174.4822 +.sp |\n(##u-1v
174.4823 +.nr 37 \n(41u
174.4824 +.in +\n(37u
174.4825 +.d+
174.4826 +.in -\n(37u
174.4827 +.mk 32
174.4828 +.if \n(32>\n(31 .nr 31 \n(32
174.4829 +.sp |\n(31u
174.4830 +.ne \n(e|u+\n(.Vu
174.4831 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.4832 +.ta \n(80u \n(81u
174.4833 +.nr 31 \n(.f
174.4834 +.nr 35 1m
174.4835 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.4836 +.mk ##
174.4837 +.nr 31 \n(##
174.4838 +.sp |\n(##u-1v
174.4839 +.nr 37 \n(41u
174.4840 +.in +\n(37u
174.4841 +.e+
174.4842 +.in -\n(37u
174.4843 +.mk 32
174.4844 +.if \n(32>\n(31 .nr 31 \n(32
174.4845 +.sp |\n(31u
174.4846 +.ta \n(80u \n(81u
174.4847 +.nr 31 \n(.f
174.4848 +.nr 35 1m
174.4849 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.4850 +.ne \n(f|u+\n(.Vu
174.4851 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.4852 +.ta \n(80u \n(81u
174.4853 +.nr 31 \n(.f
174.4854 +.nr 35 1m
174.4855 +\&\h'|\n(40u'FGCT\h'|\n(41u'
174.4856 +.mk ##
174.4857 +.nr 31 \n(##
174.4858 +.sp |\n(##u-1v
174.4859 +.nr 37 \n(41u
174.4860 +.in +\n(37u
174.4861 +.f+
174.4862 +.in -\n(37u
174.4863 +.mk 32
174.4864 +.if \n(32>\n(31 .nr 31 \n(32
174.4865 +.sp |\n(31u
174.4866 +.ne \n(g|u+\n(.Vu
174.4867 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.4868 +.ta \n(80u \n(81u
174.4869 +.nr 31 \n(.f
174.4870 +.nr 35 1m
174.4871 +\&\h'|\n(40u'GCT\h'|\n(41u'
174.4872 +.mk ##
174.4873 +.nr 31 \n(##
174.4874 +.sp |\n(##u-1v
174.4875 +.nr 37 \n(41u
174.4876 +.in +\n(37u
174.4877 +.g+
174.4878 +.in -\n(37u
174.4879 +.mk 32
174.4880 +.if \n(32>\n(31 .nr 31 \n(32
174.4881 +.sp |\n(31u
174.4882 +.fc
174.4883 +.nr T. 1
174.4884 +.T# 1
174.4885 +.35
174.4886 +.rm a+
174.4887 +.rm b+
174.4888 +.rm c+
174.4889 +.rm d+
174.4890 +.rm e+
174.4891 +.rm f+
174.4892 +.rm g+
174.4893 +.TE
174.4894 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.4895 +
174.4896 +.LP
174.4897 +.SS
174.4898 +\-gcutil 激с
174.4899 +.LP
174.4900 +.LP
174.4901 +.TS
174.4902 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.4903 +.de 35
174.4904 +.ps \n(.s
174.4905 +.vs \n(.vu
174.4906 +.in \n(.iu
174.4907 +.if \n(.u .fi
174.4908 +.if \n(.j .ad
174.4909 +.if \n(.j=0 .na
174.4910 +..
174.4911 +.nf
174.4912 +.nr #~ 0
174.4913 +.if n .nr #~ 0.6n
174.4914 +.ds #d .d
174.4915 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.4916 +.fc
174.4917 +.nr 33 \n(.s
174.4918 +.rm 80 81
174.4919 +.nr 34 \n(.lu
174.4920 +.eo
174.4921 +.am 81
174.4922 +.br
174.4923 +.di a+
174.4924 +.35
174.4925 +.ft \n(.f
174.4926 +.ll \n(34u*1u/3u
174.4927 +.if \n(.l<\n(81 .ll \n(81u
174.4928 +.in 0
174.4929 +Survivor 0 篏睡 (憜絎拷絲障若祉潟若)
174.4930 +.br
174.4931 +.di
174.4932 +.nr a| \n(dn
174.4933 +.nr a- \n(dl
174.4934 +..
174.4935 +.ec \
174.4936 +.eo
174.4937 +.am 81
174.4938 +.br
174.4939 +.di b+
174.4940 +.35
174.4941 +.ft \n(.f
174.4942 +.ll \n(34u*1u/3u
174.4943 +.if \n(.l<\n(81 .ll \n(81u
174.4944 +.in 0
174.4945 +Survivor 1 篏睡 (憜絎拷絲障若祉潟若)
174.4946 +.br
174.4947 +.di
174.4948 +.nr b| \n(dn
174.4949 +.nr b- \n(dl
174.4950 +..
174.4951 +.ec \
174.4952 +.eo
174.4953 +.am 81
174.4954 +.br
174.4955 +.di c+
174.4956 +.35
174.4957 +.ft \n(.f
174.4958 +.ll \n(34u*1u/3u
174.4959 +.if \n(.l<\n(81 .ll \n(81u
174.4960 +.in 0
174.4961 +Eden 篏睡 (憜絎拷絲障若祉潟若)
174.4962 +.br
174.4963 +.di
174.4964 +.nr c| \n(dn
174.4965 +.nr c- \n(dl
174.4966 +..
174.4967 +.ec \
174.4968 +.eo
174.4969 +.am 81
174.4970 +.br
174.4971 +.di d+
174.4972 +.35
174.4973 +.ft \n(.f
174.4974 +.ll \n(34u*1u/3u
174.4975 +.if \n(.l<\n(81 .ll \n(81u
174.4976 +.in 0
174.4977 +Old 篏睡 (憜絎拷絲障若祉潟若)
174.4978 +.br
174.4979 +.di
174.4980 +.nr d| \n(dn
174.4981 +.nr d- \n(dl
174.4982 +..
174.4983 +.ec \
174.4984 +.eo
174.4985 +.am 81
174.4986 +.br
174.4987 +.di e+
174.4988 +.35
174.4989 +.ft \n(.f
174.4990 +.ll \n(34u*1u/3u
174.4991 +.if \n(.l<\n(81 .ll \n(81u
174.4992 +.in 0
174.4993 +Permanent 篏睡 (憜絎拷絲障若祉潟若)
174.4994 +.br
174.4995 +.di
174.4996 +.nr e| \n(dn
174.4997 +.nr e- \n(dl
174.4998 +..
174.4999 +.ec \
174.5000 +.eo
174.5001 +.am 81
174.5002 +.br
174.5003 +.di f+
174.5004 +.35
174.5005 +.ft \n(.f
174.5006 +.ll \n(34u*1u/3u
174.5007 +.if \n(.l<\n(81 .ll \n(81u
174.5008 +.in 0
174.5009 +ャ筝篁c GC ゃ潟
174.5010 +.br
174.5011 +.di
174.5012 +.nr f| \n(dn
174.5013 +.nr f- \n(dl
174.5014 +..
174.5015 +.ec \
174.5016 +.eo
174.5017 +.am 81
174.5018 +.br
174.5019 +.di g+
174.5020 +.35
174.5021 +.ft \n(.f
174.5022 +.ll \n(34u*1u/3u
174.5023 +.if \n(.l<\n(81 .ll \n(81u
174.5024 +.in 0
174.5025 +ャ筝篁c若吾潟激с恰
174.5026 +.br
174.5027 +.di
174.5028 +.nr g| \n(dn
174.5029 +.nr g- \n(dl
174.5030 +..
174.5031 +.ec \
174.5032 +.eo
174.5033 +.am 81
174.5034 +.br
174.5035 +.di h+
174.5036 +.35
174.5037 +.ft \n(.f
174.5038 +.ll \n(34u*1u/3u
174.5039 +.if \n(.l<\n(81 .ll \n(81u
174.5040 +.in 0
174.5041 +若吾潟激с恰
174.5042 +.br
174.5043 +.di
174.5044 +.nr h| \n(dn
174.5045 +.nr h- \n(dl
174.5046 +..
174.5047 +.ec \
174.5048 +.eo
174.5049 +.am 81
174.5050 +.br
174.5051 +.di i+
174.5052 +.35
174.5053 +.ft \n(.f
174.5054 +.ll \n(34u*1u/3u
174.5055 +.if \n(.l<\n(81 .ll \n(81u
174.5056 +.in 0
174.5057 +若吾潟激с括
174.5058 +.br
174.5059 +.di
174.5060 +.nr i| \n(dn
174.5061 +.nr i- \n(dl
174.5062 +..
174.5063 +.ec \
174.5064 +.35
174.5065 +.nf
174.5066 +.ll \n(34u
174.5067 +.nr 80 0
174.5068 +.nr 38 \w若吾潟激с括輝荐若帥网荀
174.5069 +.if \n(80<\n(38 .nr 80 \n(38
174.5070 +.nr 38 \w\f3\fP
174.5071 +.if \n(80<\n(38 .nr 80 \n(38
174.5072 +.nr 38 \wS0
174.5073 +.if \n(80<\n(38 .nr 80 \n(38
174.5074 +.nr 38 \wS1
174.5075 +.if \n(80<\n(38 .nr 80 \n(38
174.5076 +.nr 38 \wE
174.5077 +.if \n(80<\n(38 .nr 80 \n(38
174.5078 +.nr 38 \wO
174.5079 +.if \n(80<\n(38 .nr 80 \n(38
174.5080 +.nr 38 \wP
174.5081 +.if \n(80<\n(38 .nr 80 \n(38
174.5082 +.nr 38 \wYGC
174.5083 +.if \n(80<\n(38 .nr 80 \n(38
174.5084 +.nr 38 \wYGCT
174.5085 +.if \n(80<\n(38 .nr 80 \n(38
174.5086 +.nr 38 \wFGC
174.5087 +.if \n(80<\n(38 .nr 80 \n(38
174.5088 +.nr 38 \wFGCT
174.5089 +.if \n(80<\n(38 .nr 80 \n(38
174.5090 +.nr 38 \wGCT
174.5091 +.if \n(80<\n(38 .nr 80 \n(38
174.5092 +.80
174.5093 +.rm 80
174.5094 +.nr 81 0
174.5095 +.nr 38 \w\f3茯\fP
174.5096 +.if \n(81<\n(38 .nr 81 \n(38
174.5097 +.nr 38 \w GC ゃ潟
174.5098 +.if \n(81<\n(38 .nr 81 \n(38
174.5099 +.81
174.5100 +.rm 81
174.5101 +.nr 38 \n(a-
174.5102 +.if \n(81<\n(38 .nr 81 \n(38
174.5103 +.nr 38 \n(b-
174.5104 +.if \n(81<\n(38 .nr 81 \n(38
174.5105 +.nr 38 \n(c-
174.5106 +.if \n(81<\n(38 .nr 81 \n(38
174.5107 +.nr 38 \n(d-
174.5108 +.if \n(81<\n(38 .nr 81 \n(38
174.5109 +.nr 38 \n(e-
174.5110 +.if \n(81<\n(38 .nr 81 \n(38
174.5111 +.nr 38 \n(f-
174.5112 +.if \n(81<\n(38 .nr 81 \n(38
174.5113 +.nr 38 \n(g-
174.5114 +.if \n(81<\n(38 .nr 81 \n(38
174.5115 +.nr 38 \n(h-
174.5116 +.if \n(81<\n(38 .nr 81 \n(38
174.5117 +.nr 38 \n(i-
174.5118 +.if \n(81<\n(38 .nr 81 \n(38
174.5119 +.35
174.5120 +.nf
174.5121 +.ll \n(34u
174.5122 +.nr 38 1n
174.5123 +.nr 79 0
174.5124 +.nr 40 \n(79+(0*\n(38)
174.5125 +.nr 80 +\n(40
174.5126 +.nr 41 \n(80+(3*\n(38)
174.5127 +.nr 81 +\n(41
174.5128 +.nr TW \n(81
174.5129 +.if t .if \n(TW>\n(.li .tm Table at line 803 file Input is too wide - \n(TW units
174.5130 +.fc
174.5131 +.nr #T 0-1
174.5132 +.nr #a 0-1
174.5133 +.eo
174.5134 +.de T#
174.5135 +.ds #d .d
174.5136 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.5137 +.mk ##
174.5138 +.nr ## -1v
174.5139 +.ls 1
174.5140 +.ls
174.5141 +..
174.5142 +.ec
174.5143 +.ta \n(80u \n(81u
174.5144 +.nr 31 \n(.f
174.5145 +.nr 35 1m
174.5146 +\&\h'|\n(40u'若吾潟激с括輝荐若帥网荀\h'|\n(41u'
174.5147 +.ta \n(80u \n(81u
174.5148 +.nr 31 \n(.f
174.5149 +.nr 35 1m
174.5150 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.5151 +.ne \n(a|u+\n(.Vu
174.5152 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.5153 +.ta \n(80u \n(81u
174.5154 +.nr 31 \n(.f
174.5155 +.nr 35 1m
174.5156 +\&\h'|\n(40u'S0\h'|\n(41u'
174.5157 +.mk ##
174.5158 +.nr 31 \n(##
174.5159 +.sp |\n(##u-1v
174.5160 +.nr 37 \n(41u
174.5161 +.in +\n(37u
174.5162 +.a+
174.5163 +.in -\n(37u
174.5164 +.mk 32
174.5165 +.if \n(32>\n(31 .nr 31 \n(32
174.5166 +.sp |\n(31u
174.5167 +.ne \n(b|u+\n(.Vu
174.5168 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.5169 +.ta \n(80u \n(81u
174.5170 +.nr 31 \n(.f
174.5171 +.nr 35 1m
174.5172 +\&\h'|\n(40u'S1\h'|\n(41u'
174.5173 +.mk ##
174.5174 +.nr 31 \n(##
174.5175 +.sp |\n(##u-1v
174.5176 +.nr 37 \n(41u
174.5177 +.in +\n(37u
174.5178 +.b+
174.5179 +.in -\n(37u
174.5180 +.mk 32
174.5181 +.if \n(32>\n(31 .nr 31 \n(32
174.5182 +.sp |\n(31u
174.5183 +.ne \n(c|u+\n(.Vu
174.5184 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.5185 +.ta \n(80u \n(81u
174.5186 +.nr 31 \n(.f
174.5187 +.nr 35 1m
174.5188 +\&\h'|\n(40u'E\h'|\n(41u'
174.5189 +.mk ##
174.5190 +.nr 31 \n(##
174.5191 +.sp |\n(##u-1v
174.5192 +.nr 37 \n(41u
174.5193 +.in +\n(37u
174.5194 +.c+
174.5195 +.in -\n(37u
174.5196 +.mk 32
174.5197 +.if \n(32>\n(31 .nr 31 \n(32
174.5198 +.sp |\n(31u
174.5199 +.ne \n(d|u+\n(.Vu
174.5200 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
174.5201 +.ta \n(80u \n(81u
174.5202 +.nr 31 \n(.f
174.5203 +.nr 35 1m
174.5204 +\&\h'|\n(40u'O\h'|\n(41u'
174.5205 +.mk ##
174.5206 +.nr 31 \n(##
174.5207 +.sp |\n(##u-1v
174.5208 +.nr 37 \n(41u
174.5209 +.in +\n(37u
174.5210 +.d+
174.5211 +.in -\n(37u
174.5212 +.mk 32
174.5213 +.if \n(32>\n(31 .nr 31 \n(32
174.5214 +.sp |\n(31u
174.5215 +.ne \n(e|u+\n(.Vu
174.5216 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
174.5217 +.ta \n(80u \n(81u
174.5218 +.nr 31 \n(.f
174.5219 +.nr 35 1m
174.5220 +\&\h'|\n(40u'P\h'|\n(41u'
174.5221 +.mk ##
174.5222 +.nr 31 \n(##
174.5223 +.sp |\n(##u-1v
174.5224 +.nr 37 \n(41u
174.5225 +.in +\n(37u
174.5226 +.e+
174.5227 +.in -\n(37u
174.5228 +.mk 32
174.5229 +.if \n(32>\n(31 .nr 31 \n(32
174.5230 +.sp |\n(31u
174.5231 +.ne \n(f|u+\n(.Vu
174.5232 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
174.5233 +.ta \n(80u \n(81u
174.5234 +.nr 31 \n(.f
174.5235 +.nr 35 1m
174.5236 +\&\h'|\n(40u'YGC\h'|\n(41u'
174.5237 +.mk ##
174.5238 +.nr 31 \n(##
174.5239 +.sp |\n(##u-1v
174.5240 +.nr 37 \n(41u
174.5241 +.in +\n(37u
174.5242 +.f+
174.5243 +.in -\n(37u
174.5244 +.mk 32
174.5245 +.if \n(32>\n(31 .nr 31 \n(32
174.5246 +.sp |\n(31u
174.5247 +.ne \n(g|u+\n(.Vu
174.5248 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
174.5249 +.ta \n(80u \n(81u
174.5250 +.nr 31 \n(.f
174.5251 +.nr 35 1m
174.5252 +\&\h'|\n(40u'YGCT\h'|\n(41u'
174.5253 +.mk ##
174.5254 +.nr 31 \n(##
174.5255 +.sp |\n(##u-1v
174.5256 +.nr 37 \n(41u
174.5257 +.in +\n(37u
174.5258 +.g+
174.5259 +.in -\n(37u
174.5260 +.mk 32
174.5261 +.if \n(32>\n(31 .nr 31 \n(32
174.5262 +.sp |\n(31u
174.5263 +.ta \n(80u \n(81u
174.5264 +.nr 31 \n(.f
174.5265 +.nr 35 1m
174.5266 +\&\h'|\n(40u'FGC\h'|\n(41u' GC ゃ潟
174.5267 +.ne \n(h|u+\n(.Vu
174.5268 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
174.5269 +.ta \n(80u \n(81u
174.5270 +.nr 31 \n(.f
174.5271 +.nr 35 1m
174.5272 +\&\h'|\n(40u'FGCT\h'|\n(41u'
174.5273 +.mk ##
174.5274 +.nr 31 \n(##
174.5275 +.sp |\n(##u-1v
174.5276 +.nr 37 \n(41u
174.5277 +.in +\n(37u
174.5278 +.h+
174.5279 +.in -\n(37u
174.5280 +.mk 32
174.5281 +.if \n(32>\n(31 .nr 31 \n(32
174.5282 +.sp |\n(31u
174.5283 +.ne \n(i|u+\n(.Vu
174.5284 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
174.5285 +.ta \n(80u \n(81u
174.5286 +.nr 31 \n(.f
174.5287 +.nr 35 1m
174.5288 +\&\h'|\n(40u'GCT\h'|\n(41u'
174.5289 +.mk ##
174.5290 +.nr 31 \n(##
174.5291 +.sp |\n(##u-1v
174.5292 +.nr 37 \n(41u
174.5293 +.in +\n(37u
174.5294 +.i+
174.5295 +.in -\n(37u
174.5296 +.mk 32
174.5297 +.if \n(32>\n(31 .nr 31 \n(32
174.5298 +.sp |\n(31u
174.5299 +.fc
174.5300 +.nr T. 1
174.5301 +.T# 1
174.5302 +.35
174.5303 +.rm a+
174.5304 +.rm b+
174.5305 +.rm c+
174.5306 +.rm d+
174.5307 +.rm e+
174.5308 +.rm f+
174.5309 +.rm g+
174.5310 +.rm h+
174.5311 +.rm i+
174.5312 +.TE
174.5313 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-43
174.5314 +
174.5315 +.LP
174.5316 +.SS
174.5317 +\-printcompilation 激с
174.5318 +.LP
174.5319 +.LP
174.5320 +.TS
174.5321 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
174.5322 +.de 35
174.5323 +.ps \n(.s
174.5324 +.vs \n(.vu
174.5325 +.in \n(.iu
174.5326 +.if \n(.u .fi
174.5327 +.if \n(.j .ad
174.5328 +.if \n(.j=0 .na
174.5329 +..
174.5330 +.nf
174.5331 +.nr #~ 0
174.5332 +.if n .nr #~ 0.6n
174.5333 +.ds #d .d
174.5334 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.5335 +.fc
174.5336 +.nr 33 \n(.s
174.5337 +.rm 80 81
174.5338 +.nr 34 \n(.lu
174.5339 +.eo
174.5340 +.am 81
174.5341 +.br
174.5342 +.di a+
174.5343 +.35
174.5344 +.ft \n(.f
174.5345 +.ll \n(34u*1u/3u
174.5346 +.if \n(.l<\n(81 .ll \n(81u
174.5347 +.in 0
174.5348 +絎茵潟潟ゃ帥鴻
174.5349 +.br
174.5350 +.di
174.5351 +.nr a| \n(dn
174.5352 +.nr a- \n(dl
174.5353 +..
174.5354 +.ec \
174.5355 +.eo
174.5356 +.am 81
174.5357 +.br
174.5358 +.di b+
174.5359 +.35
174.5360 +.ft \n(.f
174.5361 +.ll \n(34u*1u/3u
174.5362 +.if \n(.l<\n(81 .ll \n(81u
174.5363 +.in 0
174.5364 +<純ゃ潟若ゃ
174.5365 +.br
174.5366 +.di
174.5367 +.nr b| \n(dn
174.5368 +.nr b- \n(dl
174.5369 +..
174.5370 +.ec \
174.5371 +.eo
174.5372 +.am 81
174.5373 +.br
174.5374 +.di c+
174.5375 +.35
174.5376 +.ft \n(.f
174.5377 +.ll \n(34u*1u/3u
174.5378 +.if \n(.l<\n(81 .ll \n(81u
174.5379 +.in 0
174.5380 +潟潟ゃ号劫劫<純劫с腥咲阪絖.с/篏睡<純絎劫<純с 2 ゃc若綵√HotSpot \- \f3XX:+PrintComplation\fP 激с潟絲上
174.5381 +.br
174.5382 +.di
174.5383 +.nr c| \n(dn
174.5384 +.nr c- \n(dl
174.5385 +..
174.5386 +.ec \
174.5387 +.35
174.5388 +.nf
174.5389 +.ll \n(34u
174.5390 +.nr 80 0
174.5391 +.nr 38 \wHotSpot 潟潟ゃ号腟沿若
174.5392 +.if \n(80<\n(38 .nr 80 \n(38
174.5393 +.nr 38 \w\f3\fP
174.5394 +.if \n(80<\n(38 .nr 80 \n(38
174.5395 +.nr 38 \wCompiled
174.5396 +.if \n(80<\n(38 .nr 80 \n(38
174.5397 +.nr 38 \w泣ゃ
174.5398 +.if \n(80<\n(38 .nr 80 \n(38
174.5399 +.nr 38 \w
174.5400 +.if \n(80<\n(38 .nr 80 \n(38
174.5401 +.nr 38 \w<純
174.5402 +.if \n(80<\n(38 .nr 80 \n(38
174.5403 +.80
174.5404 +.rm 80
174.5405 +.nr 81 0
174.5406 +.nr 38 \w\f3茯\fP
174.5407 +.if \n(81<\n(38 .nr 81 \n(38
174.5408 +.nr 38 \w潟潟ゃ帥ゃ
174.5409 +.if \n(81<\n(38 .nr 81 \n(38
174.5410 +.81
174.5411 +.rm 81
174.5412 +.nr 38 \n(a-
174.5413 +.if \n(81<\n(38 .nr 81 \n(38
174.5414 +.nr 38 \n(b-
174.5415 +.if \n(81<\n(38 .nr 81 \n(38
174.5416 +.nr 38 \n(c-
174.5417 +.if \n(81<\n(38 .nr 81 \n(38
174.5418 +.35
174.5419 +.nf
174.5420 +.ll \n(34u
174.5421 +.nr 38 1n
174.5422 +.nr 79 0
174.5423 +.nr 40 \n(79+(0*\n(38)
174.5424 +.nr 80 +\n(40
174.5425 +.nr 41 \n(80+(3*\n(38)
174.5426 +.nr 81 +\n(41
174.5427 +.nr TW \n(81
174.5428 +.if t .if \n(TW>\n(.li .tm Table at line 829 file Input is too wide - \n(TW units
174.5429 +.fc
174.5430 +.nr #T 0-1
174.5431 +.nr #a 0-1
174.5432 +.eo
174.5433 +.de T#
174.5434 +.ds #d .d
174.5435 +.if \(ts\n(.z\(ts\(ts .ds #d nl
174.5436 +.mk ##
174.5437 +.nr ## -1v
174.5438 +.ls 1
174.5439 +.ls
174.5440 +..
174.5441 +.ec
174.5442 +.ta \n(80u \n(81u
174.5443 +.nr 31 \n(.f
174.5444 +.nr 35 1m
174.5445 +\&\h'|\n(40u'HotSpot 潟潟ゃ号腟沿若\h'|\n(41u'
174.5446 +.ta \n(80u \n(81u
174.5447 +.nr 31 \n(.f
174.5448 +.nr 35 1m
174.5449 +\&\h'|\n(40u'\f3\fP\h'|\n(41u'\f3茯\fP
174.5450 +.ne \n(a|u+\n(.Vu
174.5451 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
174.5452 +.ta \n(80u \n(81u
174.5453 +.nr 31 \n(.f
174.5454 +.nr 35 1m
174.5455 +\&\h'|\n(40u'Compiled\h'|\n(41u'
174.5456 +.mk ##
174.5457 +.nr 31 \n(##
174.5458 +.sp |\n(##u-1v
174.5459 +.nr 37 \n(41u
174.5460 +.in +\n(37u
174.5461 +.a+
174.5462 +.in -\n(37u
174.5463 +.mk 32
174.5464 +.if \n(32>\n(31 .nr 31 \n(32
174.5465 +.sp |\n(31u
174.5466 +.ne \n(b|u+\n(.Vu
174.5467 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
174.5468 +.ta \n(80u \n(81u
174.5469 +.nr 31 \n(.f
174.5470 +.nr 35 1m
174.5471 +\&\h'|\n(40u'泣ゃ\h'|\n(41u'
174.5472 +.mk ##
174.5473 +.nr 31 \n(##
174.5474 +.sp |\n(##u-1v
174.5475 +.nr 37 \n(41u
174.5476 +.in +\n(37u
174.5477 +.b+
174.5478 +.in -\n(37u
174.5479 +.mk 32
174.5480 +.if \n(32>\n(31 .nr 31 \n(32
174.5481 +.sp |\n(31u
174.5482 +.ta \n(80u \n(81u
174.5483 +.nr 31 \n(.f
174.5484 +.nr 35 1m
174.5485 +\&\h'|\n(40u'\h'|\n(41u'潟潟ゃ帥ゃ
174.5486 +.ne \n(c|u+\n(.Vu
174.5487 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
174.5488 +.ta \n(80u \n(81u
174.5489 +.nr 31 \n(.f
174.5490 +.nr 35 1m
174.5491 +\&\h'|\n(40u'<純\h'|\n(41u'
174.5492 +.mk ##
174.5493 +.nr 31 \n(##
174.5494 +.sp |\n(##u-1v
174.5495 +.nr 37 \n(41u
174.5496 +.in +\n(37u
174.5497 +.c+
174.5498 +.in -\n(37u
174.5499 +.mk 32
174.5500 +.if \n(32>\n(31 .nr 31 \n(32
174.5501 +.sp |\n(31u
174.5502 +.fc
174.5503 +.nr T. 1
174.5504 +.T# 1
174.5505 +.35
174.5506 +.rm a+
174.5507 +.rm b+
174.5508 +.rm c+
174.5509 +.TE
174.5510 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
174.5511 +
174.5512 +.LP
174.5513 +.SS
174.5514 +
174.5515 +.LP
174.5516 +.SH ""
174.5517 +.LP
174.5518 +.LP
174.5519 +с21891 \f2lvmid\fP ゃ若 JVM h箴腓冴障
174.5520 +.LP
174.5521 +.SS
174.5522 +gcutil 激с潟篏睡
174.5523 +.LP
174.5524 +.LP
174.5525 +箴\f2lvmid\fP 21891 ・膓250 腱 7 ゃ泣潟緇\f3\-gcutil\fP 激с潟с絎緇c阪茵腓冴障
174.5526 +.LP
174.5527 +.nf
174.5528 +\f3
174.5529 +.fl
174.5530 +\fP\f3jstat \-gcutil 21891 250 7\fP
174.5531 +.br
174.5532 +
174.5533 +.fl
174.5534 + S0 S1 E O P YGC YGCT FGC FGCT GCT
174.5535 +.br
174.5536 +
174.5537 +.fl
174.5538 + 12.44 0.00 27.20 9.49 96.70 78 0.176 5 0.495 0.672
174.5539 +.br
174.5540 +
174.5541 +.fl
174.5542 + 12.44 0.00 62.16 9.49 96.70 78 0.176 5 0.495 0.672
174.5543 +.br
174.5544 +
174.5545 +.fl
174.5546 + 12.44 0.00 83.97 9.49 96.70 78 0.176 5 0.495 0.672
174.5547 +.br
174.5548 +
174.5549 +.fl
174.5550 + 0.00 7.74 0.00 9.51 96.70 79 0.177 5 0.495 0.673
174.5551 +.br
174.5552 +
174.5553 +.fl
174.5554 + 0.00 7.74 23.37 9.51 96.70 79 0.177 5 0.495 0.673
174.5555 +.br
174.5556 +
174.5557 +.fl
174.5558 + 0.00 7.74 43.82 9.51 96.70 79 0.177 5 0.495 0.673
174.5559 +.br
174.5560 +
174.5561 +.fl
174.5562 + 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
174.5563 +.br
174.5564 +
174.5565 +.fl
174.5566 +.fi
174.5567 +
174.5568 +.LP
174.5569 +.LP
174.5570 +箴阪ャ筝篁c潟激с潟 3 4 泣潟ц腓冴障潟激с潟 0.001 腱c吾с Eden (E) Old (O) 若Old 篏睡 9.49% 9.51% 紜障Survivor 潟激с喝 12.44% 篏睡障潟激с喝 7.74% 篏睡障
174.5571 +.LP
174.5572 +.SS
174.5573 +惹絖膵違菴
174.5574 +.LP
174.5575 +.LP
174.5576 +箴\f2lvmid\fP 21891 ・膓250 腱с泣潟緇\f3\-gcutil\fP 激с潟с絎緇c阪茵腓冴障\f3\-h3\fP 激с潟篏睡若帥 3 茵茵腓冴若阪障
174.5577 +.LP
174.5578 +.nf
174.5579 +\f3
174.5580 +.fl
174.5581 +\fP\f3jstat \-gcnew \-h3 21891 250\fP
174.5582 +.br
174.5583 +
174.5584 +.fl
174.5585 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.5586 +.br
174.5587 +
174.5588 +.fl
174.5589 + 64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203
174.5590 +.br
174.5591 +
174.5592 +.fl
174.5593 + 64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203
174.5594 +.br
174.5595 +
174.5596 +.fl
174.5597 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204
174.5598 +.br
174.5599 +
174.5600 +.fl
174.5601 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.5602 +.br
174.5603 +
174.5604 +.fl
174.5605 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204
174.5606 +.br
174.5607 +
174.5608 +.fl
174.5609 + 64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204
174.5610 +.br
174.5611 +
174.5612 +.fl
174.5613 + 64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204
174.5614 +.br
174.5615 +
174.5616 +.fl
174.5617 + S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.5618 +.br
174.5619 +
174.5620 +.fl
174.5621 + 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
174.5622 +.br
174.5623 +
174.5624 +.fl
174.5625 +.fi
174.5626 +
174.5627 +.LP
174.5628 +.LP
174.5629 +箴с惹絖膵違菴荀祉2 3 泣潟 Young GC 茵障膓膓 0.001 腱с潟激с潟сSurvivor 0 篏睡 (S0U) Survivor 泣ゃ (DSS) 莇ゃ若帥罎冴障腟吾сOld 筝篁 (阪茵腓) 御若罧水ャ (TT) 31 2 檎若障
174.5630 +.LP
174.5631 +.LP
174.5632 +ャ潟激с潟5 6 泣潟ц障潟激с潟сSurvivor 祉荀罧水ャゃ 31 祉障
174.5633 +.LP
174.5634 +.SS
174.5635 +泣潟帥ゃ鴻帥潟水
174.5636 +.LP
174.5637 +.LP
174.5638 +箴\f2lvmid\fP 21891 御・膓250 腱 3 ゃ泣潟緇障\f3\-t\fP 激с潟篏睡泣潟帥ゃ鴻帥潟茵腓冴障
174.5639 +.LP
174.5640 +.nf
174.5641 +\f3
174.5642 +.fl
174.5643 +\fP\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
174.5644 +.br
174.5645 +
174.5646 +.fl
174.5647 +Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT
174.5648 +.br
174.5649 +
174.5650 +.fl
174.5651 + 150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799
174.5652 +.br
174.5653 +
174.5654 +.fl
174.5655 + 150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
174.5656 +.br
174.5657 +
174.5658 +.fl
174.5659 + 150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
174.5660 +.br
174.5661 +
174.5662 +.fl
174.5663 +.fi
174.5664 +
174.5665 +.LP
174.5666 +.LP
174.5667 +\f2Timestamp\fP 帥若蚊 JVM 莎桁腟腱篏с若障\f3\-gcoldcapacity\fP 阪с蚊綵荀羆障取羆筝≧鴻羣若≦宍Old 筝篁c絎拷 (OGC) Old 絎拷 (OC) 紜障Old 筝篁c絎拷 (OGC) 81 GC (FGC) 緇11696 KB 13820 KB 後障Old 筝篁 (渇) 紊у拷60544 KB (OGCMX) с障≦宍с篏茖罧障
174.5668 +.LP
174.5669 +.SS
174.5670 +≪若 JVM ゃ潟鴻ャ<潟若激с潟h
174.5671 +.LP
174.5672 +.LP
174.5673 +箴\f3\-gcutil\fP 激с潟篏睡\f2remote.domain\fP 激鴻筝 \f2lvmid\fP 40496 ・膓泣潟腱篏х≧緇障
174.5674 +.LP
174.5675 +.nf
174.5676 +\f3
174.5677 +.fl
174.5678 +\fP\f3jstat \-gcutil 40496@remote.domain 1000\fP
174.5679 +.br
174.5680 +
174.5681 +.fl
174.5682 +... \f2output omitted\fP
174.5683 +.br
174.5684 +
174.5685 +.fl
174.5686 +.fi
174.5687 +
174.5688 +.LP
174.5689 +.LP
174.5690 +\f2lvmid\fP ≪若鴻腟\f240496@remote.domain\fP \f2vmid\fP 罕障腟 \f2vmid\fP \f3rmi\fP 潟篏睡≪若鴻筝 \f3jstatd\fP 泣若若篆<障\f3jstatd\fP 泣若若\f3rmiregistry\fP 篏睡 \f3rmiregistry\fP 若 (若 1099) ゃ潟 \f2remote.domain\fP 臀障
174.5691 +.LP
174.5692 +.RE
174.5693 +.SH "∫i"
174.5694 +.LP
174.5695 .RS 3
174.5696 .TP 2
174.5697 -*
174.5698 -.na
174.5699 -java \- Java アプリケーション起動ツール (Solaris) @
174.5700 -.fi
174.5701 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html
174.5702 +o
174.5703 +java(1) \- Java ≪宴若激с活儀若
174.5704 .TP 2
174.5705 -*
174.5706 -.na
174.5707 -java \- Java アプリケーション起動ツール(Linux) @
174.5708 -.fi
174.5709 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html
174.5710 +o
174.5711 +jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
174.5712 .TP 2
174.5713 -*
174.5714 -.na
174.5715 -java \- Java アプリケーション起動ツール (Windows) @
174.5716 -.fi
174.5717 -http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html
174.5718 +o
174.5719 +jstatd(1) \- 篁潟激 jstat 若≪潟
174.5720 +.TP 2
174.5721 +o
174.5722 +rmiregistry(1) \- Java ≪若吾с吾鴻
174.5723 .RE
174.5724 -.SS statOption と出力
174.5725 -次の表に、各
174.5726 -.I statOption
174.5727 -に対して
174.5728 -.B jstat
174.5729 -が出力する列の要約を示します。
174.5730 -.br
174.5731 -.SS
174.5732 -\-class オプション
174.5733 -.br
174.5734 -クラスローダ統計
174.5735 -.br
174.5736 +
174.5737 .LP
174.5738 -.sp 1n
174.5739 -.TS
174.5740 -box;
174.5741 -cbp-1 | cbp-1
174.5742 -l | l .
174.5743 -列 説明
174.5744 -_
174.5745 -Loaded ロードされたクラスの数
174.5746 -Bytes ロードされた K バイト数
174.5747 -Unloaded アンロードされたクラスの数
174.5748 -Bytes アンロードされた K バイト数
174.5749 -Time クラスのロードおよびアンロード操作の実行に要した時間
174.5750 -.TE
174.5751 -.SS
174.5752 -\-compiler
174.5753 -オプション
174.5754 -.br
174.5755 -HotSpot Just-In-Time コンパイラ統計
174.5756 -.br
174.5757 -.sp 1n
174.5758 -.TS
174.5759 -box;
174.5760 -cbp-1 | cbp-1
174.5761 -l | l .
174.5762 -列 説明
174.5763 -_
174.5764 -Compiled 実行されたコンパイルタスクの数
174.5765 -Failed 失敗したコンパイルタスクの数
174.5766 -Invalid 無効化されたコンパイルタスクの数
174.5767 -Time コンパイルタスクの実行に要した時間
174.5768 -FailedType 前回失敗したコンパイルのコンパイルタイプ
174.5769 -FailedMethod 前回失敗したコンパイルのクラス名とメソッド
174.5770 -.TE
174.5771 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-29
174.5772 -.SS
174.5773 -\-gc オプション
174.5774 -.br
174.5775 -ガベージコレクトされたヒープの統計
174.5776 -.br
174.5777 -.TS
174.5778 -box;
174.5779 -cbp-1 | cbp-1
174.5780 -l | l .
174.5781 -列 説明
174.5782 -_
174.5783 -SOC 現在のサバイバースペース 0 の容量 (K バイト)
174.5784 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
174.5785 -S0U サバイバースペース 0 の使用量 (K バイト)
174.5786 -S1U サバイバースペース 1 の使用量 (K バイト)
174.5787 -EC 現在のエデンスペースの容量 (K バイト)
174.5788 -EU エデンスペースの使用量 (K バイト)
174.5789 -OC 現在のオールドスペースの容量 (K バイト)
174.5790 -OU オールドスペースの使用量 (K バイト)
174.5791 -PC 現在の永続的スペースの容量 (K バイト)
174.5792 -PU 永続的スペースの使用量 (K バイト)
174.5793 -YGC 若い世代の GC イベントの数
174.5794 -YGCT 若い世代のガベージコレクション時間
174.5795 -FGC フル GC イベントの数
174.5796 -FGCT フルガベージコレクション時間
174.5797 -GCT ガベージコレクション合計時間
174.5798 -.TE
174.5799 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
174.5800 -.SS
174.5801 -\-gccapacity オプション
174.5802 -.br
174.5803 -メモリプール世代とスペース容量
174.5804 -.br
174.5805 -.TS
174.5806 -box;
174.5807 -cbp-1 | cbp-1
174.5808 -l | l .
174.5809 -列 説明
174.5810 -_
174.5811 -NGCMN 新世代の最小容量 (K バイト)
174.5812 -NGCMX 新世代の最大容量 (K バイト)
174.5813 -NGC 新世代の現在の容量 (K バイト)
174.5814 -S0C 現在のサバイバースペース 0 の容量 (K バイト)
174.5815 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
174.5816 -EC 現在のエデンスペースの容量 (K バイト)
174.5817 -OGCMN 旧世代の最小容量 (K バイト)
174.5818 -OGCMX 旧世代の最大容量 (K バイト)
174.5819 -OGC 旧世代の現在の容量 (K バイト)
174.5820 -OC 現在のオールドスペースの容量 (K バイト)
174.5821 -PGCMN 永続的世代の最小容量 (K バイト)
174.5822 -PGCMX 永続的世代の最大容量 (K バイト)
174.5823 -PGC 永続的世代の現在の容量 (K バイト)
174.5824 -PC 永続的スペースの現在の容量 (K バイト)
174.5825 -YGC 若い世代の GC イベントの数。
174.5826 -FGC フル GC イベントの数。
174.5827 -.TE
174.5828 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-67
174.5829 -.SS
174.5830 -\-gccause
174.5831 -オプション
174.5832 +
174.5833 .LP
174.5834 -このオプションは、\f3\-gcutil\fP オプションと同じガベージコレクション統計データの概要を表示しますが、最後のガベージコレクションイベントと (適用可能な場合は) 現在のガベージコレクションイベントの原因が含まれます。\f3\-gcutil\fP で一覧表示される列の他に、このオプションでは次の列が追加されます。
174.5835 -.TS
174.5836 -box;
174.5837 -cbp-1 | cbp-1
174.5838 -l | l .
174.5839 -列 説明
174.5840 -_
174.5841 -LGCC 前回のガベージコレクションの原因
174.5842 -GCC 現在のガベージコレクションの原因
174.5843 -.TE
174.5844 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-13
174.5845 -.SS
174.5846 -\-gcnew オプション
174.5847 -.br
174.5848 -新世代統計
174.5849 -.br
174.5850 -.TS
174.5851 -box;
174.5852 -cbp-1 | cbp-1
174.5853 -l | l .
174.5854 -列 説明
174.5855 -_
174.5856 -SOC 現在のサバイバースペース 0 の容量 (K バイト)
174.5857 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
174.5858 -S0U サバイバースペース 0 の使用量 (K バイト)
174.5859 -S1U サバイバースペース 1 の使用量 (K バイト)
174.5860 -TT 保有しきい値
174.5861 -MTT 最大保有しきい値
174.5862 -DSS 目標サバイバーサイズ (K バイト)
174.5863 -EC 現在のエデンスペースの容量 (K バイト)
174.5864 -EU エデンスペースの使用量 (K バイト)
174.5865 -YGC 若い世代の GC イベントの数。
174.5866 -YGCT 若い世代のガベージコレクション時間。
174.5867 -.TE
174.5868 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
174.5869 -.SS
174.5870 -\-gcnewcapacity オプション
174.5871 -.br
174.5872 -新世代のスペースサイズ統計
174.5873 -.br
174.5874 -.TS
174.5875 -box;
174.5876 -cbp-1 | cbp-1
174.5877 -l | l .
174.5878 -列 説明
174.5879 -_
174.5880 -NGCMN 新世代の最小容量 (K バイト)
174.5881 -NGCMX 新世代の最大容量 (K バイト)
174.5882 -NGC 現在の新世代容量 (K バイト)
174.5883 -S0CMX サバイバースペース 0 の最大容量 (K バイト)
174.5884 -S0C 現在のサバイバースペース 0 の容量 (K バイト)
174.5885 -S1CMX サバイバースペース 1 の最大容量 (K バイト)
174.5886 -S1C 現在のサバイバースペース 1 の容量 (K バイト)
174.5887 -ECMX エデンスペースの最大容量 (K バイト)
174.5888 -EC 現在のエデンスペースの容量 (K バイト)
174.5889 -YGC 若い世代の GC イベントの数
174.5890 -FGC フル GC イベントの数
174.5891 -.TE
174.5892 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
174.5893 -.SS
174.5894 -\-gcold オプション
174.5895 -.br
174.5896 -旧および永続世代統計
174.5897 -.br
174.5898 -.TS
174.5899 -box;
174.5900 -cbp-1 | cbp-1
174.5901 -l | l .
174.5902 -列 説明
174.5903 -_
174.5904 -PC 現在の永続スペースの容量 (K バイト)
174.5905 -PU 永続スペースの使用量 (K バイト)
174.5906 -OC 現在のオールドスペースの容量 (K バイト)
174.5907 -OU オールドスペースの使用量 (K バイト)
174.5908 -YGC 若い世代の GC イベントの数
174.5909 -FGC フル GC イベントの数
174.5910 -FGCT フルガベージコレクション時間
174.5911 -GCT ガベージコレクション合計時間
174.5912 -.TE
174.5913 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.5914 -.SS
174.5915 -\-gcoldcapacity オプション
174.5916 -.br
174.5917 -旧世代統計
174.5918 -.br
174.5919 -.TS
174.5920 -box;
174.5921 -cbp-1 | cbp-1
174.5922 -l | l .
174.5923 -列 説明
174.5924 -_
174.5925 -OGCMN 旧世代の最小容量 (K バイト)
174.5926 -OGCMV 旧世代の最大容量 (K バイト)
174.5927 -OGC 旧世代の現在の容量 (K バイト)
174.5928 -OC 現在のオールドスペースの容量 (K バイト)
174.5929 -YGC 若い世代の GC イベントの数
174.5930 -FGC フル GC イベントの数
174.5931 -FGCT フルガベージコレクション時間
174.5932 -GCT ガベージコレクション合計時間
174.5933 -.TE
174.5934 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.5935 -.SS
174.5936 -\-gcpermcapacity オプション
174.5937 -.br
174.5938 -永続世代統計
174.5939 -.br
174.5940 -.TS
174.5941 -box;
174.5942 -cbp-1 | cbp-1
174.5943 -l | l .
174.5944 -列 説明
174.5945 -_
174.5946 -PGCMN 永続世代の最小容量 (K バイト)
174.5947 -PGCMX 永続世代の最大容量 (K バイト)
174.5948 -PGC 永続世代の現在の容量 (K バイト)
174.5949 -PC 永続スペースの現在の容量 (K バイト)
174.5950 -YGC 若い世代の GC イベントの数
174.5951 -FGC フル GC イベントの数
174.5952 -FGCT フルガベージコレクション時間
174.5953 -GCT ガベージコレクション合計時間
174.5954 -.TE
174.5955 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
174.5956 -.SS
174.5957 -\-gcutil
174.5958 -オプション
174.5959 -.br
174.5960 -ガベージコレクション統計の要約
174.5961 -.br
174.5962 -.TS
174.5963 -box;
174.5964 -cbp-1 | cbp-1
174.5965 -l | l .
174.5966 -列 説明
174.5967 -_
174.5968 -S0 T{
174.5969 -サバイバースペース 0 の使用率 (スペースの現在の容量に対するパーセンテージ)
174.5970 -T}
174.5971 -S1 T{
174.5972 -サバイバースペース 1 の使用率 (スペースの現在の容量に対するパーセンテージ)
174.5973 -T}
174.5974 -E T{
174.5975 -エデンスペースの使用率 (スペースの現在の容量に対するパーセンテージ)
174.5976 -T}
174.5977 -O T{
174.5978 -オールドスペースの使用率 (スペースの現在の容量に対するパーセンテージ)
174.5979 -T}
174.5980 -P T{
174.5981 -永続スペースの使用率 (スペースの現在の容量に対するパーセンテージ)
174.5982 -T}
174.5983 -YGC 若い世代の GC イベントの数
174.5984 -YGCT 若い世代のガベージコレクション時間
174.5985 -FGC フル GC イベントの数
174.5986 -FGCT フルガベージコレクション時間
174.5987 -GCT ガベージコレクション合計時間
174.5988 -.TE
174.5989 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-43
174.5990 -.SS
174.5991 -\-printcompilation オプション
174.5992 -.br
174.5993 -HotSpot コンパイラメソッド統計
174.5994 -.br
174.5995 -.TS
174.5996 -box;
174.5997 -cbp-1 | cbp-1
174.5998 -l | l .
174.5999 -列 説明
174.6000 -_
174.6001 -Compiled 実行されたコンパイルタスクの数
174.6002 -Size メソッドのバイトコードのバイト数
174.6003 -Type コンパイルタイプ
174.6004 -Method T{
174.6005 -コンパイルされたメソッドを識別するクラス名とメソッド名。クラス名では、名前空間セパレータとして "." の代わりに "/" を使用します。メソッド名は、指定されたクラス内のメソッドです。この 2 つのフィールドの形式は、
174.6006 -"HotSpot \- XX:+PrintComplation"
174.6007 -オプションと同じです。
174.6008 -T}
174.6009 -.TE
174.6010 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
174.6011 -.SS
174.6012 -.SH
174.6013 -このセクションでは、lvmid が 21891 であるローカル JVM の監視例をいくつか示します。
174.6014 -.SS gcutil オプションの使用
174.6015 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔で 7 つのサンプルを採取し、
174.6016 -.B \-gcutil
174.6017 -オプションでの指定に従って出力を表示します。
174.6018 -.LP
174.6019 -.ft 3
174.6020 -.nf
174.6021 -jstat -gcutil 21891 250 7
174.6022 - S0 S1 E O P YGC YGCT FGC FGCT GCT
174.6023 - 12.44 0.00 27.20 9.49 96.70 78 0.176 5 0.495 0.672
174.6024 - 12.44 0.00 62.16 9.49 96.70 78 0.176 5 0.495 0.672
174.6025 - 12.44 0.00 83.97 9.49 96.70 78 0.176 5 0.495 0.672
174.6026 - 0.00 7.74 0.00 9.51 96.70 79 0.177 5 0.495 0.673
174.6027 - 0.00 7.74 23.37 9.51 96.70 79 0.177 5 0.495 0.673
174.6028 - 0.00 7.74 43.82 9.51 96.70 79 0.177 5 0.495 0.673
174.6029 - 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
174.6030 -.fi
174.6031 -.ft 1
174.6032 -.LP
174.6033 -この例の出力は、3 番目と 4 番目のサンプルの間に若い世代のコレクションが発生したことを示しています。コレクションの所要時間は 0.001 秒であり、オブジェクトがエデンスペース (E) からオールドスペース (O) に昇格されたため、オールドスペースの使用率が 9.49% から 9.51% に増加しています。コレクションの前のサバイバースペースの使用率は 12.44% でしたが、このコレクションの後の使用率は、わずか 7.74% です。
174.6034 -.SS 列見出し文字列の繰り返し
174.6035 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔でサンプルを採取し、
174.6036 -.B \-gcutil
174.6037 -オプションでの指定に従って出力を表示します。また、
174.6038 -.B \-h3
174.6039 -オプションを使用して、3 行のデータごとに列見出しを出力します。
174.6040 -.LP
174.6041 -.ft 3
174.6042 -.nf
174.6043 -jstat -gcnew -h3 21891 250
174.6044 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.6045 - 64.0 64.0 0.0 31.7 31 31 32.0 512.0 178.6 249 0.203
174.6046 - 64.0 64.0 0.0 31.7 31 31 32.0 512.0 355.5 249 0.203
174.6047 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 21.9 250 0.204
174.6048 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.6049 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 245.9 250 0.204
174.6050 - 64.0 64.0 35.4 0.0 2 31 32.0 512.0 421.1 250 0.204
174.6051 - 64.0 64.0 0.0 19.0 31 31 32.0 512.0 84.4 251 0.204
174.6052 - S0C S1C S0U S1U TT MTT DSS EC EU YGC YGCT
174.6053 - 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
174.6054 -.fi
174.6055 -.ft 1
174.6056 -.LP
174.6057 -見出し文字列の繰り返しを示しているほかに、この例は、2 番目と 3 番目のサンプルの間に若い世代の GC が発生したことを示しています。その所要時間は 0.001 秒でした。コレクションによって、サバイバースペース 0 の使用量 (S0U) が目標サバイバーサイズ (DSS) を超える十分なライブデータが見つかりました。結果として、オブジェクトは旧世代に昇格され (この出力には示されていない)、保有しきい値 (TT) が 31 から 2 に下がっています。
174.6058 -.LP
174.6059 -5 番目と 6 番目のサンプルの間にもう 1 つのコレクションが発生しています。このコレクションでは、ごくわずかのサバイバーが見つかり、保有しきい値が 31 に戻っています。
174.6060 -.SS 各サンプルのタイムスタンプの表示
174.6061 -この例では、lvmid 21891 にアタッチして、250 ミリ秒間隔で 3 つのサンプルを採取します。
174.6062 -.B \-t
174.6063 -オプションを使用して、最初の列に各サンプルのタイムスタンプを生成します。
174.6064 -.LP
174.6065 -.ft 3
174.6066 -.nf
174.6067 -jstat \-gcoldcapacity \-t 21891 250 3
174.6068 -Timestamp OGCMN OGCMX OGC OC YGC FGC FGCT GCT
174.6069 -150.1 1408.0 60544.0 11696.0 11696.0 194 80 2.874 3.799
174.6070 -150.4 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
174.6071 -150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
174.6072 -.br
174.6073 -.fi
174.6074 -.LP
174.6075 -\f2Timestamp\fP 列には、ターゲット JVM の起動時からの経過時間が、秒単位でレポートされています。さらに、\f3\-gcoldcapacity\fP 出力では、割り当て要求または昇格要求あるいはその両方を満たすためにヒープが拡張するごとに、Old 世代の容量 (OGC) と Old 領域の容量 (OC) とが増加していることがわかります。Old 世代の容量 (OGC) は、81 番目のフル GC (FGC) 後に、11696 KB から 13820 KB へ増加しています。Old 世代 (および領域) の最大容量は、60544 KB (OGCMX) なので、まだ拡張できる余裕が残されています。
174.6076 -.SS
174.6077 -リモート JVM のインストゥルメンテーションの監視
174.6078 -.LP
174.6079 -この例は、\f3\-gcutil\fP オプションを使用して、\f2remote.domain\fP というシステム上の \f2lvmid\fP 40496 に接続し、サンプルを秒単位で無期限に取得しています。
174.6080 -.nf
174.6081 -\f3jstat \-gcutil 40496@remote.domain 1000\fP
174.6082 -.br
174.6083 -
174.6084 -.fl
174.6085 -... \f2出力省略\fP
174.6086 -.br
174.6087 -.fi
174.6088 -.LP
174.6089 -\f2lvmid\fP は、リモートホストの名前と結合されて、\f240496@remote.domain\fP の \f2vmid\fP を構成しています。結果として、この \f2vmid\fP は、\f3rmi\fP プロトコルを使用して、リモートホスト上のデフォルトの \f3jstatd\fP サーバと通信します。\f3jstatd\fP サーバは、\f3rmiregistry\fP を使用して、デフォルトの \f3rmiregistry\fP ポート (ポート 1099) にバインドされた \f2remote.domain\fP に配置されれます。
174.6090 -.SH 関連項目
174.6091 -.RS 3
174.6092 -.TP 2
174.6093 -*
174.6094 -java \- Java アプリケーション起動ツール
174.6095 -.TP 2
174.6096 -*
174.6097 -jps \- Java プロセスステータスツール
174.6098 -.TP 2
174.6099 -*
174.6100 -jstatd \- jvmstat デーモン
174.6101 -.TP 2
174.6102 -*
174.6103 -rmiregistry \- Java リモートオブジェクトレジストリ
174.6104 -.RE
174.6105
175.1 --- a/src/solaris/doc/sun/man/man1/ja/jstatd.1 Tue May 12 15:21:55 2009 +0900
175.2 +++ b/src/solaris/doc/sun/man/man1/ja/jstatd.1 Thu May 14 00:17:25 2009 -0700
175.3 @@ -1,246 +1,300 @@
175.4 -'\" t
175.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
175.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
175.7 -.\"
175.8 -.\" This code is free software; you can redistribute it and/or modify it
175.9 -.\" under the terms of the GNU General Public License version 2 only, as
175.10 -.\" published by the Free Software Foundation.
175.11 -.\"
175.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
175.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
175.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
175.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
175.16 -.\" accompanied this code).
175.17 -.\"
175.18 -.\" You should have received a copy of the GNU General Public License version
175.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
175.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
175.21 -.\"
175.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
175.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
175.24 -.\" have any questions.
175.25 -.\"
175.26 -.TH jstatd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
175.27 -.SH 名前
175.28 -jstatd \- 仮想マシン jstat デーモン
175.29 -.\"
175.30 -.SH 形式
175.31 -.B jstatd
175.32 -.BI [ options ]
175.33 -.SH パラメータ
175.34 -.if t .TP 20
175.35 -.if n .TP 15
175.36 -.BI options
175.37 -コマンド行オプション。オプションは任意の順序で指定できます。冗長または矛盾するオプションがあった場合は、最後に指定されたオプションが優先されます。
175.38 -.SH 機能説明
175.39 -.B jstatd
175.40 -ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) の作成と終了を監視する RMI サーバーアプリケーションであり、リモート監視ツールがローカルホスト上で実行している JVM にアタッチするためのインタフェースを備えています。
175.41 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
175.42 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
175.43 +."
175.44 +." This code is free software; you can redistribute it and/or modify it
175.45 +." under the terms of the GNU General Public License version 2 only, as
175.46 +." published by the Free Software Foundation.
175.47 +."
175.48 +." This code is distributed in the hope that it will be useful, but WITHOUT
175.49 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
175.50 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
175.51 +." version 2 for more details (a copy is included in the LICENSE file that
175.52 +." accompanied this code).
175.53 +."
175.54 +." You should have received a copy of the GNU General Public License version
175.55 +." 2 along with this work; if not, write to the Free Software Foundation,
175.56 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
175.57 +."
175.58 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
175.59 +." CA 95054 USA or visit www.sun.com if you need additional information or
175.60 +." have any questions.
175.61 +."
175.62 +.TH jstatd 1 "04 May 2009"
175.63 +." Generated from HTML by html2man (author: Eric Armstrong)
175.64 +
175.65 .LP
175.66 -jstatd サーバーが機能するためには、ローカルホスト上に RMI レジストリが存在する必要があります。jstatd サーバーは、デフォルトポートまたは
175.67 -.BI \-p " port"
175.68 -オプションによって示されたポート上の RMI レジストリへのアタッチを試みます。RMI レジストリが見つからなかった場合は、
175.69 -.BI \-p " port"
175.70 -オプションによって示されたポートにバインドされた jstatd アプリケーション内で作成され、
175.71 -.BI \-p " port"
175.72 -が省かれた場合はデフォルトの RMI レジストリにバインドされた jstatd アプリケーション内で作成されます。内部 RMI レジストリの作成は、
175.73 -.B \-nr
175.74 -オプションを指定することによって禁止できます。
175.75 -.LP
175.76 -注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
175.77 -.SH オプション
175.78 -.B jstatd
175.79 -コマンドは、以下のオプションをサポートします。
175.80 -.if t .TP 20
175.81 -.if n .TP 15
175.82 -.BI \-nr
175.83 -既存の RMI レジストリが見つからないときに、
175.84 -.B jstatd
175.85 -プロセス内での内部 RMI レジストリの作成を試みません。
175.86 -.if t .TP 20
175.87 -.if n .TP 15
175.88 -.BI \-p " port"
175.89 -RMI レジストリを探すポート番号。または、RMI レジストリが見つからず、
175.90 -.B \-nr
175.91 -が指定されなかった場合に、RMI レジストリが作成されるポート番号。
175.92 -.if t .TP 20
175.93 -.if n .TP 15
175.94 -.BI \-n " rminame"
175.95 -RMI レジストリでリモート RMI オブジェクトがバインドされる名前。デフォルトの名前は、JStatRemoteHost です。同じホスト上で複数の
175.96 -.B jstatd
175.97 -サーバーが起動している場合、各サーバーのエクスポート RMI オブジェクトの名前を一意にするには、このオプションを指定します。ただし、そのためには、監視クライアントの hostid および vmid 文字列に一意のサーバー名が含まれている必要があります。
175.98 -.if t .TP 20
175.99 -.if n .TP 15
175.100 -.BI \-J option
175.101 -.I option
175.102 -を
175.103 -.B javac
175.104 -によって呼び出された java 起動ツールに渡します。たとえば、
175.105 -.B \-J-Xms48m
175.106 -は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、
175.107 -.B \-J
175.108 -の一般的規則です。
175.109 -.SH セキュリティ
175.110 -
175.111 -.B jstatd
175.112 -サーバーは、適切なネイティブアクセス権を持っている JVM だけを監視できます。
175.113 -このため、jstatd プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。
175.114 -UNIX(TM) ベースのシステムの root ユーザーなど、一部のユーザー資格には、
175.115 -そのシステム上の任意の JVM によってエクスポートされた計測機構への
175.116 -アクセス権が割り当てられています。
175.117 -このような資格で実行中の jstatd プロセスは、そのシステム上の任意の JVM を監視できますが、
175.118 -これに伴うセキュリティ上の問題も考慮する必要があります。
175.119 -.LP
175.120 -jstatd サーバーは、リモートクライアントの認証は行いません。
175.121 -つまり、jstatd サーバープロセスを実行すると、
175.122 -jstatd プロセスがアクセス権を持つすべての JVM から
175.123 -エクスポートされる計測機構が、ネットワーク上の任意のユーザーに公開されます。
175.124 -計測機構が公開されると、環境によっては望ましくない場合があります。
175.125 -特に運用環境や安全性の低いネットワークでは、
175.126 -jstatd プロセスを開始する前に
175.127 -ローカルセキュリティポリシーを検討する必要があります。
175.128 -.LP
175.129 -.B jstatd
175.130 -サーバーは、他にセキュリティマネージャがインストールされていない場合は、RMISecurityPolicy のインスタンスをインストールするので、セキュリティポリシーファイルを指定する必要があります。
175.131 -ポリシーファイルは、デフォルトのポリシー実装のポリシーファイル構文
175.132 -.fi
175.133 - (http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html)
175.134 -に従う必要があります。
175.135 -.LP
175.136 -次のポリシーファイルでは、
175.137 -.B jstatd
175.138 -サーバーはセキュリティ例外を起こさずに実行できます。このポリシーは、
175.139 -すべてのコードベースへのすべてのアクセス権を許可するよりは自由度が低いですが、
175.140 -.B jstatd
175.141 -サーバーの実行に必要な最小限度のアクセス権を許可するポリシーよりは自由度が高いです。
175.142 -.LP
175.143 -.RS
175.144 -.ft 3
175.145 -.nf
175.146 -grant codebase "file:${java.home}/../lib/tools.jar" {
175.147 - permission java.security.AllPermission;
175.148 -};
175.149 -.fi
175.150 -.ft 1
175.151 -.RE
175.152 -.LP
175.153 -このポリシーを使用するには、テキストを jstatd.all.policy という名前のファイルにコピーしたあと、次のようにして
175.154 -.B jstatd
175.155 -サーバーを実行します。
175.156 -.LP
175.157 -.RS
175.158 -.ft 3
175.159 -.nf
175.160 -jstatd -J-Djava.security.policy=jstatd.all.policy
175.161 -.fi
175.162 -.ft 1
175.163 -.RE
175.164 -.LP
175.165 -より厳格なセキュリティを採用しているサイトでは、
175.166 -カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークに
175.167 -アクセスを制限できます。ただし、この方法を使用しても、
175.168 -IP アドレスのスプーフィング攻撃にさらされます。
175.169 -カスタムポリシーファイルを使用することでセキュリティの問題に対応できない場合には、
175.170 -jstatd サーバーを実行せずに、
175.171 -jstat および jps ツールをローカルで使用するのが最も安全です。
175.172 -.SH リモートインタフェース
175.173 -.B jstatd
175.174 -プロセスによってエクスポートされるインタフェースはプロプライエタリであり、変更が保証されています。ユーザーおよび開発者は、このインタフェースに書き込まないようにしてください。
175.175 -.SH 使用例
175.176 -.B jstatd
175.177 -の起動例をいくつか示します。これらの
175.178 -.B jstatd
175.179 -スクリプトは、バックグラウンドで自動的にサーバーを起動します。
175.180 -.SS 内部 RMI レジストリの使用
175.181 -この例は、内部 RMI レジストリを使用した
175.182 -.B jstatd
175.183 -の起動を示しています。この例では、他のサーバーがデフォルトの RMI レジストリポート (ポート 1099) にバインドされていないことを前提としています。
175.184 -.LP
175.185 -.RS
175.186 -.ft 3
175.187 -.nf
175.188 -jstatd -J-Djava.security.policy=all.policy
175.189 -.fi
175.190 -.ft 1
175.191 -.RE
175.192 -.SS 外部 RMI レジストリの使用
175.193 -この例は、外部 RMI レジストリを使用した
175.194 -.B jstatd
175.195 -の起動を示しています。
175.196 -.LP
175.197 -.RS
175.198 -.ft 3
175.199 -.nf
175.200 -rmiregistry&
175.201 -jstatd -J-Djava.security.policy=all.policy
175.202 -.fi
175.203 -.ft 1
175.204 -.RE
175.205 -.LP
175.206 -この例は、ポート 2020 上の外部 RMI レジストリサーバーを使用した
175.207 -.B jstatd
175.208 -の起動を示しています。
175.209 -.LP
175.210 -.RS
175.211 -.ft 3
175.212 -.nf
175.213 -rmiregistry 2020&
175.214 -jstatd -J-Djava.security.policy=all.policy -p 2020
175.215 -.fi
175.216 -.ft 1
175.217 -.RE
175.218 -.LP
175.219 -この例は、ポート 2020 上の、AlternateJstatdServerName という名前にバインドされた外部 RMI レジストリを使用した
175.220 -.B jstatd
175.221 -の起動を示しています。
175.222 -.LP
175.223 -.RS
175.224 -.ft 3
175.225 -.nf
175.226 -rmiregistry 2020&
175.227 -jstatd -J-Djava.security.policy=all.policy -p 2020 -n AlternateJstatdServerName
175.228 -.fi
175.229 -.ft 1
175.230 -.RE
175.231 -.SS プロセス内 RMI レジストリの作成の禁止
175.232 -この例は、RMI レジストリが見つからない場合も RMI レジストリを作成しないように
175.233 -.B jstatd
175.234 -を起動する例を示しています。この例では、RMI がすでに実行していることを前提としています。実行していなかった場合は、適切なエラーメッセージが表示されます。
175.235 -.LP
175.236 -.RS
175.237 -.ft 3
175.238 -.nf
175.239 -jstatd -J-Djava.security.policy=all.policy -nr
175.240 -.fi
175.241 -.ft 1
175.242 -.RE
175.243 -.SS RMI ロギング機能の有効化
175.244 -この例は、RMI ロギング機能を有効にして
175.245 -.B jstatd
175.246 -を起動する例を示しています。この方法は、障害追跡やサーバー活動の監視に役立ちます。
175.247 -.LP
175.248 -.RS
175.249 -.ft 3
175.250 -.nf
175.251 -jstatd -J-Djava.security.policy=all.policy -J-Djava.rmi.server.logCalls=true
175.252 -.fi
175.253 -.ft 1
175.254 -.RE
175.255 -.LP
175.256 -.SH 関連項目
175.257 +.SH ""
175.258 +jstatd \- 篁潟激 jstat 若≪
175.259 .LP
175.260 .RS 3
175.261 .TP 2
175.262 -*
175.263 -java \- Java アプリケーション起動プログラム
175.264 +o
175.265 +綵√
175.266 .TP 2
175.267 -*
175.268 -jps \- Java 仮想マシンプロセスステータスツール
175.269 +o
175.270 +<若
175.271 .TP 2
175.272 -*
175.273 -jstat \- Java 仮想マシン統計監視ツール
175.274 +o
175.275 +茯
175.276 .TP 2
175.277 -*
175.278 -rmiregistry \- Java リモートオブジェクトレジストリ
175.279 +o
175.280 +激с
175.281 +.TP 2
175.282 +o
175.283 +祉ャc
175.284 +.TP 2
175.285 +o
175.286 +≪若ゃ潟帥с若
175.287 +.TP 2
175.288 +o
175.289 +箴
175.290 +.TP 2
175.291 +o
175.292 +∫i
175.293 +.RE
175.294 +
175.295 +.LP
175.296 +.SH "綵√"
175.297 +.LP
175.298 +
175.299 +.LP
175.300 +.nf
175.301 +\f3
175.302 +.fl
175.303 +jstatd [ \fP\f4options\fP\f3 ]\fP
175.304 +.br
175.305 +\f3
175.306 +.fl
175.307 +\fP
175.308 +.fi
175.309 +
175.310 +.LP
175.311 +.SH "<若"
175.312 +.LP
175.313 +
175.314 +.LP
175.315 +.RS 3
175.316 +.TP 3
175.317 +options
175.318 +潟潟茵激с潟激с潟篁紙綺ф絎с障茲障障激с潟翫緇絎激с潟障
175.319 +.RE
175.320 +
175.321 +.LP
175.322 +.SH " 茯"
175.323 +.LP
175.324 +
175.325 +.LP
175.326 +.LP
175.327 +\f3jstatd\fP 若荐羝 HotSpot Java 篁潟激 (JVM) 篏腟篋h若激鴻筝у茵 Java 篁潟激潟≪若h若・膓сゃ潟帥с若鴻箴 RMI 泣若若≪宴若激с潟с
175.328 +.LP
175.329 +.LP
175.330 +\f3jstatd\fP 泣若若с若鴻 RMI 吾鴻絖綽荀障\f3jstatd\fP 泣若若若障 \f2\-p port\fP 激с潟ф絎若筝 RMI 吾鴻・膓障RMI 吾鴻荀ゃ翫\f2\-p port\fP 激с潟ф絎若障 \f2\-p port\fP ャ翫 RMI 吾鴻ゃ潟 \f3jstatd\fP ≪宴若激с喝1 ゃ RMI 吾鴻篏障 RMI 吾鴻篏\f2\-nr\fP 激с潟絎c胼罩≪с障
175.331 +.LP
175.332 +.LP
175.333 +\f3羈:\fP 若cc若泣若絲乗院紊с絨ャ JDK 若吾с潟сс醇с障憜Windows 98 Windows Me 若с篏睡с障
175.334 +.LP
175.335 +.SH "激с"
175.336 +.LP
175.337 +
175.338 +.LP
175.339 +.LP
175.340 +\f3jstatd\fP 潟潟罨<激с潟泣若障
175.341 +.LP
175.342 +.RS 3
175.343 +.TP 3
175.344 +\-nr
175.345 +√ RMI 吾鴻荀ゃ翫\f2jstatd\fP 祉劫 RMI 吾鴻篏障
175.346 +.TP 3
175.347 +\-p\ port
175.348 +RMI 吾鴻篋潟若垩с 荀ゃ翫\f2\-nr\fP 絎遺障
175.349 +.TP 3
175.350 +\-n\ rminame
175.351 +RMI 吾鴻≪若 RMI 吾сゃ潟с \f2JStatRemoteHost\fP с茲違 \f3jstatd\fP 泣若若鴻筝ц儀翫泣若若鴻若 RMI 吾с激с潟絎c筝с障激с潟篏睡翫hゃ≪潟 \f2hostid\fP \f2vmid\fP 絖筝泣若弱綽荀障
175.352 +.TP 3
175.353 +\-Joption
175.354 +\f3javac\fP 若喝冴 \f3java\fP 莎桁若\f2option\fP 羝<障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
175.355 +.RE
175.356 +
175.357 +.LP
175.358 +.SH "祉ャc"
175.359 +.LP
175.360 +
175.361 +.LP
175.362 +.LP
175.363 +\f3jstatd\fP 泣若若鴻ゃc≪祉号┤ JVM hс障c\f3jstatd\fP 祉鴻帥若蚊 JVM 若吟取若у茵綽荀障筝若吟取若Unix(TM) 若鴻激鴻 \f2root\fP 若吟若激鴻筝篁紙 JVM c鴻若ゃ潟鴻ャ<潟若激с潟吾≪祉号┤c障莖若у茵 \f3jstatd\fP 祉鴻激鴻筝鴻 JVM hс障祉ャc寂ャ馹莎激障
175.364 +.LP
175.365 +.LP
175.366 +\f3jstatd\fP 泣若若≪若ゃ≪潟茯荐若筝筝障\f3jstatd\fP 泣若若祉鴻絎茵\f3jstatd\fP 祉鴻≪祉号┤ゃ鴻 JVM ゃ潟鴻ャ<潟若激с潟鴻若若筝鴻若吟若障♂峨倶医障翫障 鴻絎腮弱医障絎с若с\f3jstatd\fP 祉鴻莎桁若祉ャc若激若罎荐綽荀障
175.367 +.LP
175.368 +.LP
175.369 +\f3jstatd\fP 泣若若篁祉ャc若若吾c若ゃ潟鴻若翫RMISecurityPolicy ゃ潟鴻帥潟鴻ゃ潟鴻若障 祉ャc若激若<ゃ絎綽荀障激若<ゃ激弱茖
175.370 +.na
175.371 +\f2激若<ゃ罕\fP @
175.372 +.fi
175.373 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html羣綽荀障
175.374 +.LP
175.375 +.LP
175.376 +罨<激若<ゃ翫\f3jstatd\fP 泣若若筝祉ャc寂紊篏睡絎茵с障激若鴻潟若若鴻吾≪祉号┤茯激若怨墾篏с\f3jstatd\fP 泣若若絎茵篏綽荀≪祉号┤茯激若怨墾蕭c障
175.377 +.LP
175.378 +.nf
175.379 +\f3
175.380 +.fl
175.381 +grant codebase "file:${java.home}/../lib/tools.jar" {\fP
175.382 +.br
175.383 +\f3
175.384 +.fl
175.385 + permission java.security.AllPermission;\fP
175.386 +.br
175.387 +\f3
175.388 +.fl
175.389 +};\fP
175.390 +.br
175.391 +\f3
175.392 +.fl
175.393 +\fP
175.394 +.fi
175.395 +
175.396 +.LP
175.397 +.LP
175.398 +激若篏睡鴻 \f2jstatd.all.policy\fP <ゃ潟若罨< \f3jstatd\fP 泣若若絎茵障
175.399 +.LP
175.400 +.nf
175.401 +\f3
175.402 +.fl
175.403 +jstatd \-J\-Djava.security.policy=jstatd.all.policy\fP
175.404 +.br
175.405 +\f3
175.406 +.fl
175.407 +\fP
175.408 +.fi
175.409 +
175.410 +.LP
175.411 +.LP
175.412 +ウ祉ャc若絎純泣ゃ翫鴻帥激若<ゃ篏睡劫篆♂若с鴻障若≪祉鴻狗с障 号IP ≪鴻贋紙障祉ャc若馹ゃ鴻帥ゃ冴激若<ゃс絲上с翫\f3jstatd\fP 泣若若絎茵\f3jstat\fP \f3jps\fP 若若т戎c絎号障
175.413 +.LP
175.414 +.SH "≪若ゃ潟帥с若"
175.415 +.LP
175.416 +
175.417 +.LP
175.418 +.LP
175.419 +\f3jstatd\fP 祉鴻鴻若ゃ潟帥с若鴻冴с紊眼篋絎с若吟若渇肴ゃ潟帥с若鴻吾吾莨若帥茵с
175.420 +.LP
175.421 +.SH "箴"
175.422 +.LP
175.423 +
175.424 +.LP
175.425 +.LP
175.426 +罨< \f3jstatd\fP 莎桁箴膣剛障\f3jstatd\fP 鴻c泣若若違潟ц莎桁障
175.427 +.LP
175.428 +.SS
175.429 + RMI 吾鴻篏睡
175.430 +.LP
175.431 +.LP
175.432 +箴 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障箴с RMI 吾鴻若 (若 1099) 篁泣若若ゃ潟喝障
175.433 +.LP
175.434 +.nf
175.435 +\f3
175.436 +.fl
175.437 +jstatd \-J\-Djava.security.policy=all.policy
175.438 +.fl
175.439 +\fP
175.440 +.fi
175.441 +
175.442 +.LP
175.443 +.SS
175.444 +紊 RMI 吾鴻篏睡
175.445 +.LP
175.446 +.LP
175.447 +箴紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
175.448 +.LP
175.449 +.nf
175.450 +\f3
175.451 +.fl
175.452 +rmiregistry&
175.453 +.fl
175.454 +jstatd \-J\-Djava.security.policy=all.policy
175.455 +.fl
175.456 +\fP
175.457 +.fi
175.458 +
175.459 +.LP
175.460 +.LP
175.461 +箴若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
175.462 +.LP
175.463 +.nf
175.464 +\f3
175.465 +.fl
175.466 +rmiregistry 2020&
175.467 +.fl
175.468 +jstatd \-J\-Djava.security.policy=all.policy \-p 2020
175.469 +.fl
175.470 +\fP
175.471 +.fi
175.472 +
175.473 +.LP
175.474 +.LP
175.475 +箴AlternateJstatdServerName ゃ潟若 2020 紊 RMI 吾鴻篏睡 \f3jstatd\fP 莎桁茵障
175.476 +.LP
175.477 +.nf
175.478 +\f3
175.479 +.fl
175.480 +rmiregistry 2020&
175.481 +.fl
175.482 +jstatd \-J\-Djava.security.policy=all.policy \-p 2020 \-n AlternateJstatdServerName
175.483 +.fl
175.484 +\fP
175.485 +.fi
175.486 +
175.487 +.LP
175.488 +.SS
175.489 +ゃ潟祉 RMI 吾鴻篏胼罩
175.490 +.LP
175.491 +.LP
175.492 +箴RMI 吾鴻荀ゃ翫 RMI 吾鴻篏 \f3jstatd\fP 莎桁茵障箴сRMI 吾鴻с絎茵喝障絎茵翫荅峨若<祉若吾茵腓冴障
175.493 +.LP
175.494 +.nf
175.495 +\f3
175.496 +.fl
175.497 +jstatd \-J\-Djava.security.policy=all.policy \-nr
175.498 +.fl
175.499 +\fP
175.500 +.fi
175.501 +
175.502 +.LP
175.503 +.SS
175.504 +RMI 井純劫
175.505 +.LP
175.506 +.LP
175.507 +箴RMI 井純鴻 \f3jstatd\fP 莎桁茵障号激ャ若c潟違障泣若惹柑h綵合<障
175.508 +.LP
175.509 +.nf
175.510 +\f3
175.511 +.fl
175.512 +jstatd \-J\-Djava.security.policy=all.policy \-J\-Djava.rmi.server.logCalls=true
175.513 +.fl
175.514 +\fP
175.515 +.fi
175.516 +
175.517 +.LP
175.518 +.SH "∫i"
175.519 +.LP
175.520 +.RS 3
175.521 +.TP 2
175.522 +o
175.523 +java(1) \- Java ≪宴若激с活儀若
175.524 +.TP 2
175.525 +o
175.526 +jps(1) \- Java 篁潟激潟祉鴻鴻若帥鴻若
175.527 +.TP 2
175.528 +o
175.529 +jstat(1) \- Java 篁潟激括輝荐若睡h若
175.530 +.TP 2
175.531 +o
175.532 +
175.533 +.na
175.534 +\f2rmiregistry\fP @
175.535 +.fi
175.536 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java ≪若吾с吾鴻
175.537 .RE
175.538
175.539 .LP
176.1 --- a/src/solaris/doc/sun/man/man1/ja/keytool.1 Tue May 12 15:21:55 2009 +0900
176.2 +++ b/src/solaris/doc/sun/man/man1/ja/keytool.1 Thu May 14 00:17:25 2009 -0700
176.3 @@ -1,5 +1,4 @@
176.4 -.'" t
176.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
176.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
176.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
176.8 ."
176.9 ." This code is free software; you can redistribute it and/or modify it
176.10 @@ -19,20 +18,20 @@
176.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
176.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
176.13 ." have any questions.
176.14 -." `
176.15 -.TH keytool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
176.16 -." Generated by html2man
176.17 +."
176.18 +.TH keytool 1 "04 May 2009"
176.19 +." Generated from HTML by html2man (author: Eric Armstrong)
176.20
176.21 .LP
176.22 -.SH 名前
176.23 -keytool \- 鍵と証明書の管理ツール
176.24 +.SH ""
176.25 +keytool \- 泣荐惹吾膊∞若
176.26 .LP
176.27 .RS 3
176.28
176.29 .LP
176.30 -暗号化鍵、X.509 証明連鎖、および信頼できる証明書を含むキーストア (データベース) を管理します。
176.31 +垸泣X.509 荐惹吾с若潟割拭若с荐惹吾若鴻 (若帥若) 膊∞障
176.32 .RE
176.33 -.SH "形式"
176.34 +.SH "綵√"
176.35 .LP
176.36
176.37 .LP
176.38 @@ -45,48 +44,48 @@
176.39
176.40 .LP
176.41 .LP
176.42 -Java SE 6 で keytool のコマンドインタフェースが変更されました。詳細については「変更点」の節を参照してください。以前に定義されたコマンドも引き続きサポートされています。
176.43 +Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障 荅括完ゃ紊雁鴻膀с篁ュ絎臂潟潟綣膓泣若障
176.44 .LP
176.45 -.SH "説明"
176.46 +.SH "茯"
176.47 .LP
176.48
176.49 .LP
176.50 -\f3keytool\fP は、鍵と証明書を管理するためのユーティリティです。\f3keytool\fP を使うと、自分の公開鍵と非公開鍵のペア、および関連する証明書を管理し、デジタル署名を使った自己認証 (ほかのユーザまたはサービスに対して自分自身を認証すること) や、データの完全性と証明書に関するサービスを利用することができます。\f3keytool\fP では、通信相手の公開鍵を (証明書の形で) キャッシュすることもできます。
176.51 +\f3keytool\fP 泣荐惹吾膊∞若cc若сkeytool 篏帥泣泣≪渇∫c荐惹吾膊∞吾帥臀峨篏帥c綏沿荐 (祉若吟若障泣若鴻絲障荳茯荐若) 若帥翫с荐惹吾≪泣若鴻с障keytool с篆∞御泣 (荐惹吾綵≪) c激ャс障
176.52 .LP
176.53 -「証明書」とは、あるエンティティ (人物、会社など) からのデジタル署名付きの文書のことです。証明書には、ほかのあるエンティティの公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています(「証明書」を参照)。データにデジタル署名が付いている場合は、デジタル署名を検証することで、データの完全性およびデータが本物であることをチェックできます。データの「完全性」とは、データが変更されたり、改変されたりしていないことを意味します。また、データが「本物である」とは、そのデータが、データを作成して署名したと称する人物から実際に渡されたデータであることを意味します。
176.54 +荐惹吾潟cc (篋榊篌腓障) 吾帥臀峨篁吾с 荐惹吾祉潟cc若 (潟篁) 劫ャゃc吾障(荐惹吾)若帥吾帥臀峨篁翫吾帥臀峨罎荐若с若帥翫с潟若帥ссс障若帥翫с若帥紊眼劫潟障 障若帥с若帥若帥篏臀峨腱違篋榊絎羝<若帥с潟障
176.55 .LP
176.56 .LP
176.57 -また、\f3keytool\fP を使えば、DES などの対称暗号化/復号化で使用される秘密鍵を管理することもできます。
176.58 +障\f3keytool\fP 篏帥違DES 絲丞О垸/緇垸т戎腱絲泣膊∞с障
176.59 .LP
176.60 .LP
176.61 -\f3keytool\fP は、鍵と証明書をキーストアに格納します。
176.62 +\f3keytool\fP 泣荐惹吾\f2若鴻≪\fP主障
176.63 .LP
176.64 -.SH "コマンドとオプションに関する注意"
176.65 +.SH "潟潟激с潟≪羈"
176.66 .LP
176.67
176.68 .LP
176.69 .LP
176.70 -以下では、コマンドとそのオプションについて説明します。次の点に注意してください。
176.71 +篁ヤс潟潟激с潟ゃ茯障羈:
176.72 .LP
176.73 .RS 3
176.74 .TP 2
176.75 o
176.76 -どのコマンド名およびオプション名にも先頭にマイナス記号 (\-) が付く
176.77 +潟潟潟激с喝ゃ壕 (\-) 篁
176.78 .TP 2
176.79 o
176.80 -各コマンドのオプションは任意の順序で指定できる
176.81 +潟潟激с潟篁紙綺ф絎с
176.82 .TP 2
176.83 o
176.84 -イタリック体になっていないすべての項目、または中括弧か角括弧で囲まれているすべての項目は、そのとおりに指定する必要がある
176.85 +ゃ帥篏c鴻障筝綣с茹綣су蚊障鴻絎綽荀
176.86 .TP 2
176.87 o
176.88 -オプションを囲む中括弧は、一般に、そのオプションをコマンド行で指定しなかった場合に、既定値が使われることを意味する。中括弧は、\f2\-v\fP、\f2\-rfc\fP、および \f2\-J\fP オプションを囲むのにも使われるが、これらのオプションはコマンド行で指定された場合にのみ意味を持つ (つまり、これらのオプションには、オプション自体を指定しないこと以外に「既定値」は存在しない)
176.89 +激с潟蚊筝綣с筝激с潟潟潟茵ф絎c翫ゃ篏帥潟筝綣с\f2\-v\fP\f2\-rfc\fP \f2\-J\fP 激с潟蚊篏帥激с潟潟潟茵ф絎翫炊潟 (ゃ障激с潟激с活篏絎篁ュゃ絖)
176.90 .TP 2
176.91 o
176.92 -オプションを囲む角括弧は、そのオプションをコマンド行で指定しなかった場合に、値の入力を求められることを意味する。ただし、\f2\-keypass\fP オプションをコマンド行で指定しなかった場合は、\f3keytool\fP がキーストアのパスワードから非公開/秘密鍵の復元を試みる。ユーザは、この試みが失敗した場合に非公開/秘密鍵パスワードの入力を求められる
176.93 +激с潟蚊茹綣с激с潟潟潟茵ф絎c翫ゃュ羆潟\f2\-keypass\fP 激с潟潟潟茵ф絎c翫\f3keytool\fP 若鴻≪鴻若/腱絲泣緇荅帥 若吟若荅帥紊掩翫/腱絲泣ュ羆
176.94 .TP 2
176.95 o
176.96 -イタリック体の項目の実際の値 (オプションの値) は、ユーザが指定する必要がある。たとえば、\f2\-printcert\fP コマンドの形式は次のとおりである
176.97 +ゃ帥篏絎 (激с潟) 若吟若絎綽荀違\f2\-printcert\fP 潟潟綵√罨<с
176.98 .nf
176.99 \f3
176.100 .fl
176.101 @@ -95,7 +94,7 @@
176.102 \fP
176.103 .fi
176.104 .LP
176.105 -\f2\-printcert\fP コマンドを指定するときは、\f2cert_file\fP の代わりに実際のファイル名を指定する。 次に例を示す
176.106 +\f2\-printcert\fP 潟潟絎\f2cert_file\fP 篁c絎<ゃ絎罨<箴腓冴
176.107 .nf
176.108 \f3
176.109 .fl
176.110 @@ -105,10 +104,10 @@
176.111 .fi
176.112 .TP 2
176.113 o
176.114 -オプションの値に空白 (スペース) が含まれている場合は、値を引用符で囲む必要がある
176.115 +激с潟ゃ腥榊 (鴻若) 障翫ゃ綣膃у蚊綽荀
176.116 .TP 2
176.117 o
176.118 -\f2\-help\fP コマンドはデフォルトのコマンドである。たとえば、次のようにコマンド行を指定したとする
176.119 +\f2\-help\fP 潟潟潟潟с違罨<潟潟茵絎
176.120 .nf
176.121 \f3
176.122 .fl
176.123 @@ -116,7 +115,7 @@
176.124 .fl
176.125 \fP
176.126 .fi
176.127 -これは、次のように指定することと同じである
176.128 +罨<絎с
176.129 .nf
176.130 \f3
176.131 .fl
176.132 @@ -128,12 +127,12 @@
176.133
176.134 .LP
176.135 .SS
176.136 -オプションの既定値
176.137 +激с潟
176.138 .LP
176.139 .RS 3
176.140
176.141 .LP
176.142 -オプションの既定値は、次のとおりです。
176.143 +激с潟ゃ罨<с
176.144 .nf
176.145 \f3
176.146 .fl
176.147 @@ -143,19 +142,19 @@
176.148 .fl
176.149 \-keyalg
176.150 .fl
176.151 - "DSA" (\fP\f3\-genkeypair\fP\f3 を使用している場合)
176.152 + "DSA" (\fP\f3\-genkeypair\fP\f3 篏睡翫)
176.153 .fl
176.154 - "DES" (\fP\f3\-genseckey\fP\f3 を使用している場合)
176.155 + "DES" (\fP\f3\-genseckey\fP\f3 篏睡翫)
176.156 .fl
176.157
176.158 .fl
176.159 \-keysize
176.160 .fl
176.161 - 1024 (\fP\f3\-genkeypair\fP\f3 を使用している場合)
176.162 + 1024 (\fP\f3\-genkeypair\fP\f3 篏睡翫)
176.163 .fl
176.164 - 56 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DES" の場合)
176.165 + 56 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DES" 翫)
176.166 .fl
176.167 - 168 (\fP\f3\-genseckey\fP\f3 を使用していて \-keyalg が "DESede" の場合)
176.168 + 168 (\fP\f3\-genseckey\fP\f3 篏睡 \-keyalg "DESede" 翫)
176.169 .fl
176.170
176.171 .fl
176.172 @@ -163,15 +162,17 @@
176.173 .fl
176.174
176.175 .fl
176.176 -\-keystore ユーザのホームディレクトリの .keystore というファイル
176.177 +\-keystore \fP\f4若吟若若c \fP\f4.keystore\fP\f3 <ゃ\fP\f3
176.178 .fl
176.179
176.180 .fl
176.181 -\-storetype セキュリティプロパティファイルの「keystore.type」プロパティの値で、 java.security.KeyStore の静的な getDefaultType メソッドから返される
176.182 +\-storetype \fP\f4祉ャc若c若<ゃkeystore.typec若ゃс
176.183 +.fl
176.184 + \fP\f4java.security.KeyStore\fP\f3 \fP\f4getDefaultType\fP\f3 <純菴\fP\f3
176.185 .fl
176.186
176.187 .fl
176.188 -\-file 読み込みの場合は標準入力、書き込みの場合は標準出力
176.189 +\-file \fP\f4茯粋昭帥翫罔羣ュ吾莨若帥翫罔羣阪\fP\f3
176.190 .fl
176.191
176.192 .fl
176.193 @@ -183,293 +184,265 @@
176.194 .fi
176.195
176.196 .LP
176.197 -非公開/秘密鍵ペアの生成において、署名アルゴリズム (\f2\-sigalg\fP オプション) は、基になる非公開鍵のアルゴリズムから派生します。基になる非公開鍵が DSA タイプである場合、\f2\-sigalg\fP オプションの既定値は SHA1withDSA になり、基になる非公開鍵が RSA タイプである場合は、\f2\-sigalg\fP オプションの既定値は MD5withRSA になります。選択可能な \f2\-keyalg\fP および \f2\-sigalg\fP の完全な一覧については、
176.198 +/泣≪臀峨≪眼冴 (\f2\-sigalg\fP 激с) 冴泣≪眼冴羇丞障冴泣 DSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ SHA1withDSA 冴泣 RSA 帥ゃс翫\f2\-sigalg\fP 激с潟ゃ MD5withRSA 障御純 \f2\-keyalg\fP \f2\-sigalg\fP 絎筝荀сゃ
176.199 +.na
176.200 +\f2Java Cryptography Architecture API Specification & Reference\fP @
176.201 .fi
176.202 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA
176.203 -の
176.204 -.na
176.205 -「\f2Java Cryptography Architecture API Specification & Reference\fP」を参照してください。
176.206 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppAс
176.207 .RE
176.208 .SS
176.209 -一般オプション
176.210 +筝激с
176.211 .LP
176.212 .RS 3
176.213
176.214 .LP
176.215 -\f2\-v\fP オプションは、\f2\-help\fP コマンドを除くすべてのコマンドで使用できます。このオプションを指定した場合、コマンドは「冗長」モードで実行され、詳細な情報が出力されます。
176.216 +\f2\-v\fP 激с潟\f2\-help\fP 潟潟ゃ鴻潟潟т戎с障激с潟絎翫潟潟激≪若у茵荅括完荐惹御宴阪障
176.217 .LP
176.218 -また、\f2\-J\fP\f2javaoption\fP オプションも、任意のコマンドで使用できます。このオプションを指定した場合、指定された \f2javaoption\fP 文字列が Java インタプリタに直接渡されます。
176.219 -このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリ使用を調整する場合に便利です。指定できるインタプリタオプションを一覧表示するには、コマンド行で \f2java \-h\fP または \f2java \-X\fP と入力してください。
176.220 +障\f2\-J\fP\f2javaoption\fP 激с潟篁紙潟潟т戎с障激с潟絎翫絎 \f2javaoption\fP 絖 Java ゃ潟帥帥贋・羝<障激с潟腥榊純с障激с潟絎茵医障<≪寂戎茯炊眼翫箴水с絎сゃ潟帥帥激с潟筝荀ц;腓冴潟潟茵 \f2java \-h\fP 障 \f2java \-X\fP ュ
176.221 .LP
176.222 .LP
176.223 -次のオプションは、キーストアに対する操作を行うすべてのコマンドで指定できます。
176.224 +罨<激с潟若鴻≪絲障篏茵鴻潟潟ф絎с障
176.225 .LP
176.226 .RS 3
176.227 .TP 3
176.228 \-storetype storetype
176.229 -この修飾子は、インスタンスを生成するキーストアのタイプを指定します。
176.230 +篆蕋上ゃ潟鴻帥潟鴻若鴻≪帥ゃ絎障
176.231 .TP 3
176.232 \-keystore keystore
176.233 -キーストアの場所を指定します。
176.234 +若鴻≪贋絎障
176.235 .LP
176.236 -特定の \f3keytool\fP コマンドを実行する際に、JKS ストアタイプが使用され、かつキーストアファイルがまだ存在していなかった場合、新しいキーストアファイルが作成されます。たとえば、\f2keytool \-genkeypair\fP の実行時に \f2\-keystore\fP オプションが指定されなかった場合、\f2.keystore\fP という名前のデフォルトキーストアファイルがユーザのホームディレクトリ内にまだ存在していなければ、そこに作成されます。同様に、\f2\-keystore \fP\f2ks_file\fP というオプションが指定されてもその \f2ks_file\fP が存在しなかった場合、そのファイルが作成されます。
176.237 +劫 \f3keytool\fP 潟潟絎茵JKS 鴻≪帥ゃ篏睡ゃ若鴻≪<ゃ障絖c翫違若鴻≪<ゃ篏障違\f2keytool \-genkeypair\fP 絎茵 \f2\-keystore\fP 激с潟絎c翫\f2.keystore\fP 若鴻≪<ゃ若吟若若c障絖違篏障罕\f2\-keystore \fP\f2ks_file\fP 激с潟絎 \f2ks_file\fP 絖c翫<ゃ篏障
176.238 .LP
176.239 -\f2\-keystore\fP オプションからの入力ストリームは \f2KeyStore.load\fP メソッドに渡されます。\f2NONE\fP が URL として指定された場合は、null ストリームが \f2KeyStore.load\fP メソッドに渡されます。\f2KeyStore\fP がファイルベースでない場合 (ハードウェアトークンデバイス上に存在している場合など)、\f2NONE\fP を指定してください。
176.240 +\f2\-keystore\fP 激с潟ュ鴻若\f2KeyStore.load\fP <純羝<障URL \f2NONE\fP 絎翫null 鴻若 \f2KeyStore.load\fP <純羝<障\f2NONE\fP \f2KeyStore\fP <ゃ若鴻с違若с≪若潟ゃ鴻臀翫絎障
176.241 .TP 3
176.242 \-storepass storepass
176.243 -キーストアの完全性を保護するために使うパスワードを指定します。
176.244 +若鴻≪翫с篆茘激篏帥鴻若絎障
176.245 .LP
176.246 -\f2storepass\fP は、6 文字以上でなければなりません。指定したパスワードは、キーストアの内容にアクセスするすべてのコマンドで使われます。この種のコマンドを実行するときに、コマンド行で \f2\-storepass\fP オプションを指定しなかった場合は、パスワードの入力を求められます。
176.247 +\f2storepass\fP 6 絖篁ヤ綽荀障絎鴻若若鴻≪絎鴻≪祉鴻鴻潟潟т戎障腮潟潟絎茵潟潟茵 \f2\-storepass\fP 激с潟絎c翫鴻若ュ羆障
176.248 .LP
176.249 -キーストアから情報を取り出す場合は、パスワードを省略できます。 パスワードを省略すると、取り出す情報の完全性をチェックできないので、警告が表示されます。
176.250 +若鴻≪宴冴翫鴻若ャс障 鴻若ャ冴宴翫сссс茘茵腓冴障
176.251 .TP 3
176.252 \-providerName provider_name
176.253 -セキュリティプロパティファイル内に含まれる暗号化サービスプロバイダ名を特定するために使用されます。
176.254 +祉ャc若c若<ゃ障垸泣若鴻ゃ劫篏睡障
176.255 .TP 3
176.256 \-providerClass provider_class_name
176.257 -暗号化サービスプロバイダがセキュリティプロパティファイルに指定されていない場合は、そのマスタークラスファイルの名前を指定するときに使われます。
176.258 +垸泣若鴻ゃ祉ャc若c若<ゃ絎鴻帥若鴻<ゃ絎篏帥障
176.259 .TP 3
176.260 \-providerArg provider_arg
176.261 -\f2\-providerClass\fP と組み合わせて使用します。\f2provider_class_name\fP のコンストラクタに対する省略可能な文字列入力引数を表します。
176.262 +\f2\-providerClass\fP 腟水篏睡障\f2provider_class_name\fP 潟潟鴻帥絲障ュ純絖ュ綣違茵障
176.263 .TP 3
176.264 \-protected
176.265 -\f2true\fP、\f2false\fP のいずれか。専用 PIN リーダなどの保護された認証パスを介してパスワードを指定する必要がある場合には、この値に \f2true\fP を指定してください。
176.266 +\f2true\fP 障 \f2false\fP 絨 PIN 若若篆茘激茯荐若鴻篁鴻若絎綽荀翫ゃ \f2true\fP 絎
176.267 .RE
176.268
176.269 .LP
176.270 .RE
176.271 -.SH "コマンド"
176.272 +.SH "潟潟"
176.273 .LP
176.274
176.275 .LP
176.276 .SS
176.277 -キーストアへのデータの作成および追加
176.278 +若鴻≪吾若帥篏障菴遵
176.279 .LP
176.280 .RS 3
176.281
176.282 .LP
176.283 .RS 3
176.284 .TP 3
176.285 -\-genkeypair {\-alias alias}
176.286 -{\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.287 +\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.288 .LP
176.289 -鍵のペア (公開鍵および関連する非公開鍵) を生成します。公開鍵は X.509 v3 自己署名証明書でラップされます。
176.290 -証明書は、単一の要素を持つ証明連鎖として格納されます。この証明連鎖と非公開鍵は、\f2alias\fP で特定される新しいキーストアエントリに格納されます。
176.291 +泣 (泣渇∫c) 障泣 X.509 v3 綏援讐荐惹吾с障 荐惹吾筝荀膣よ┝吾с若潟主障荐惹吾с若潟泣\f2alias\fP х劫違若鴻≪潟主障
176.292 .LP
176.293 -\f2keyalg\fP には、鍵のペアを生成するのに使うアルゴリズムを指定し、\f2keysize\fP には、生成する各鍵のサイズを指定します。\f2sigalg\fP には、自己署名証明書に署名を付けるときに使うアルゴリズムを指定します。 このアルゴリズムは、\f2keyalg\fP と互換性のあるものでなければなりません。
176.294 +\f2keyalg\fP 泣≪篏帥≪眼冴絎\f2keysize\fP 泣泣ゃ冴絎障 \f2sigalg\fP 綏援讐荐惹吾臀峨篁篏帥≪眼冴絎障≪眼冴\f2keyalg\fP 篋сс違障
176.295 .LP
176.296 -\f2dname\fP には、\f2alias\fP に関連付け、自己署名証明書の \f2issuer\fP フィールドと \f2subject\fP フィールドとして使う X.500 識別名を指定します。コマンド行で識別名を指定しなかった場合は、識別名の入力を求められます。
176.297 +\f2dname\fP \f2alias\fP ∫d綏援讐荐惹吾 \f2issuer\fP c若 \f2subject\fP c若篏帥 X.500 茘ュ絎障潟潟茵цュ絎c翫茘ュュ羆障
176.298 .LP
176.299 -\f2keypass\fP には、生成される鍵のペアのうち、非公開鍵を保護するのに使うパスワードを指定します。パスワードを指定しなかった場合は、パスワードの入力を求められます。このとき、Return キーを押すと、キーストアのパスワードと同じパスワードが鍵のパスワードに設定されます。\f2keypass\fP は、6 文字以上でなければなりません。
176.300 +\f2keypass\fP 泣≪<泣篆茘激篏帥鴻若絎障鴻若絎c翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
176.301 .LP
176.302 -\f2valDays\fP には、証明書の有効日数を指定します。
176.303 +\f2valDays\fP 荐惹吾号ユ違絎障
176.304 .LP
176.305 -このコマンドは、以前のリリースでは \f2\-genkey\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-genkeypair\fP を使用することをお勧めします。
176.306 +潟潟篁ュ若鴻с \f2\-genkey\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-genkeypair\fP 篏睡с障
176.307 .TP 3
176.308 -\-genseckey {\-alias alias}
176.309 -{\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.310 +\-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.311 .LP
176.312 -秘密鍵を生成し、それを \f2alias\fP で特定される新しい \f2KeyStore.SecretKeyEntry\fP 内に格納します。
176.313 +腱絲泣 \f2alias\fP х劫違 \f2KeyStore.SecretKeyEntry\fP 主障
176.314 .LP
176.315 -\f2keyalg\fP は秘密鍵の生成に使用するアルゴリズムを、\f2keysize\fP は生成する鍵のサイズを、それぞれ指定します。\f2keypass\fP は秘密鍵の保護に使用するパスワードです。パスワードを指定しなかった場合、ユーザはその入力を求められます。ユーザがプロンプトで RETURN キーを押した場合、鍵のパスワードはキーストアと同じパスワードに設定されます。\f2keypass\fP の長さは 6 文字以上でなければいけません。
176.316 +\f2keyalg\fP 腱絲泣篏睡≪眼冴\f2keysize\fP 泣泣ゃ冴絎障\f2keypass\fP 腱絲泣篆茘激篏睡鴻若с鴻若絎c翫若吟若ュ羆障Return 若若若鴻≪鴻若鴻若泣鴻若荐絎障 \f2keypass\fP 6 絖篁ヤс違障
176.317 .TP 3
176.318 -\-importcert {\-alias alias}
176.319 -{\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.320 +\-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.321 .LP
176.322 -ファイル \f2cert_file\fP から証明書または証明連鎖 (証明連鎖の場合は、PKCS#7 形式の応答で提供されるもの) を読み込み、\f2alias\fP によって特定されるキーストアエントリに格納します。ファイルが指定されていない場合は、標準入力から証明書または PKCS#7 応答を読み込みます。
176.323 +<ゃ \f2cert_file\fP 荐惹吾障荐惹吾с若 (荐惹吾с若潟翫PKCS#7 綵√綽膈ф箴) 茯粋昭帥\f2alias\fP c劫若鴻≪潟主障<ゃ絎翫罔羣ュ荐惹吾障 PKCS#7 綽膈茯粋昭帥障
176.324 .LP
176.325 -\f3keytool\fP では、X.509 v1、v2、v3 の証明書、および、PKCS#7 形式の証明書から構成されている PKCS#7 形式の証明連鎖をインポートできます。インポートするデータは、バイナリ符号化方式、または出力可能符号化方式 (Base64 符号化とも呼ばれる) のどちらかで提供する必要があります。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。この符号化方式の場合、証明書は「\-\-\-\-\-BEGIN」で始まる文字列で開始され、「\-\-\-\-\-END」で始まる文字列で終了しなければなりません。
176.326 +\f3keytool\fP сX.509 v1v2v3 荐惹吾潟PKCS#7 綵√荐惹吾罕 PKCS#7 綵√荐惹吾с若潟ゃ潟若с障ゃ潟若若帥ゃ膃垸劫障阪順垸劫 (Base64 膃垸若違) <ф箴綽荀障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障膃垸劫翫荐惹吾\-\-\-\-\-BEGINу障絖ч紮\-\-\-\-\-ENDу障絖х篋違障
176.327 .LP
176.328 -証明書のインポートには、次の 2 つの目的があります。
176.329 +荐惹吾ゃ潟若罨< 2 ゃ障
176.330 .RS 3
176.331 .TP 3
176.332 1.
176.333 -信頼できる証明書のリストに証明書を追加する
176.334 +篆♂若с荐惹吾鴻荐惹吾菴遵
176.335 .TP 3
176.336 2.
176.337 -CA に証明書署名要求 (\-certreq コマンドを参照) を送信した結果として、CA から受け取った証明応答をインポートする
176.338 +CA 荐惹悟讐荀羆 (\-certreq 潟潟) 篆<腟CA c荐惹綽膈ゃ潟若
176.339 .RE
176.340 .LP
176.341 -ユーザがどのタイプのインポートを意図しているかは、次のように \f2\-alias\fP オプションの値によって示されます。
176.342 +<腮蕁ゃ潟若茵\f2\-alias\fP 激с潟ゃc絎障
176.343 .RS 3
176.344 .TP 3
176.345 1.
176.346 -\f3別名が特定の鍵エントリを指していない場合\fP、\f3keytool\fP は、ユーザが信頼できる証明書のエントリを追加しようとしていると見なします。この場合、その別名がキーストア内にすでに存在していてはいけません。その別名がすでに存在していた場合、その別名の信頼できる証明書がすでに存在することになるので、\f3keytool\fP はエラーを出力し、証明書のインポートを行いません。
176.347 +\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障翫ュ若鴻√с絖障ュс絖翫ュ篆♂若с荐惹吾с絖с\f3keytool\fP 若阪荐惹吾ゃ潟若茵障
176.348 .TP 3
176.349 2.
176.350 -\f3別名が特定の鍵エントリを指している場合\fP、\f3keytool\fP は、ユーザが証明書応答をインポートしようとしていると見なします。
176.351 +\f3ュ若潟ゃ潟翫\fP\f3keytool\fP 若吟若篆♂若с荐惹吾潟菴遵荀障
176.352 .RE
176.353 -.LP
176.354 -\f3新しい信頼できる証明書のインポート\fP
176.355 +\f3違篆♂若с荐惹吾ゃ潟若\fP
176.356 .RS 3
176.357
176.358 .LP
176.359 .LP
176.360 -\f3keytool\fP は、キーストアに証明書を追加する前に、キーストア内にすでに存在する信頼できる証明書を使って、インポートする証明書から (ルート CA の) 自己署名証明書に至るまでの信頼の連鎖の構築を試みます。
176.361 +\f3keytool\fP 若鴻≪荐惹吾菴遵若鴻√с絖篆♂若с荐惹吾篏帥cゃ潟若荐惹吾 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟罕膀荅帥障
176.362 .LP
176.363 .LP
176.364 -\f2\-trustcacerts\fP オプションを指定した場合、追加の証明書は信頼できる、すなわち cacerts という名前のファイルに含まれる証明書の連鎖と見なされます。
176.365 +\f2\-trustcacerts\fP 激с潟絎翫菴遵荐惹吾篆♂若с cacerts <ゃ障荐惹吾с若潟荀障
176.366 .LP
176.367 .LP
176.368 -\f3keytool\fP が、インポートする証明書から自己署名証明書 (キーストアまたは cacerts ファイルに含まれている自己署名証明書) に至るまでの信頼のパスの構築に失敗した場合は、インポートする証明書の情報を表示し、ユーザに確認を求めます。この場合は、表示された証明書のフィンガープリントと、ほかの何らかの (信頼できる) 情報源 (証明書の所有者本人など) から入手したフィンガープリントとを比較します。「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。詳細は、「信頼できる証明書のインポートに関する注意事項」を参照してください。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
176.369 +\f3keytool\fP ゃ潟若荐惹吾綏援讐荐惹 (若鴻≪障 cacerts <ゃ障綏援讐荐惹) 潟障с篆♂若鴻罕膀紊掩翫ゃ潟若荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾c潟若潟祉 (篆♂若с) 掩 (荐惹吾篋冴) ユc潟若潟罸莠障篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障荅括完篆♂若с荐惹吾ゃ潟若≪羈鋋сゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
176.370 .LP
176.371 .RE
176.372 -\f3証明応答のインポート\fP
176.373 +\f3荐惹綽膈ゃ潟若\fP
176.374 .RS 3
176.375 .LP
176.376 -「証明応答」をインポートするときは、キーストア内の信頼できる証明書、および (\f2\-trustcacerts\fP オプションが指定されている場合は) cacerts キーストアファイルで構成された証明書を使って証明応答が検査されます。
176.377 +荐惹綽膈ゃ潟若若鴻√篆♂若с荐惹吾 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪<ゃф荐惹吾篏帥c荐惹綽膈罎祉障
176.378 .LP
176.379 .LP
176.380 -証明応答が信頼できるかどうかを決定する方法は次のとおりです。
176.381 +荐惹綽膈篆♂若с羆阪号罨<с
176.382 .LP
176.383 .RS 3
176.384 .TP 2
176.385 o
176.386 -\f3証明応答が単一の X.509 証明書である場合\fP、\f3keytool\fP は、証明応答から (ルート CA の) 自己署名証明書に至るまでの信頼連鎖の確立を試みます。証明応答と、証明応答の認証に使われる証明書の階層構造は、\f2alias\fP の新しい証明連鎖を形成します。信頼連鎖が確立されない場合、証明応答はインポートされません。この場合、\f3keytool\fP は証明書を出力せず、ユーザに検証を求めるプロンプトを表示します。ユーザが証明応答の信頼性を判断するのは、不可能ではなくても非常に困難だからです。
176.387 +\f3荐惹綽膈筝 X.509 荐惹吾с翫\fP\f3keytool\fP 荐惹綽膈 (若 CA ) 綏援讐荐惹吾潟障с篆♂若с若潟腆榊荅帥障荐惹綽膈荐惹綽膈茯荐若篏帥荐惹吾絮ゆ\f2alias\fP 違荐惹吾с若潟綵∽障篆♂若с若潟腆榊翫荐惹綽膈ゃ潟若障翫\f3keytool\fP 荐惹吾阪若吟若罎荐若羆潟茵腓冴障 若吟若荐惹綽膈篆♂惹сゆ筝純с絽吾育cс
176.388 .TP 2
176.389 o
176.390 -\f3証明応答が PKCS#7 形式の証明連鎖である場合\fP、\f3keytool\fP は、まず連鎖を並べ替えて、ユーザの証明書が最初に、ルート CA の自己署名証明書が最後にくるようにしたあと、証明応答に含まれるルート CA の証明書と、キーストア内または (\f2\-trustcacerts\fP オプションが指定されている場合は) cacerts キーストアファイル内の信頼できる証明書とをすべて比較し、一致するものがあるかどうかを調べます。一致するものが見つからなかった場合は、ルート CA の証明書の情報を表示し、ユーザに確認を求めます。 この場合は、表示された証明書のフィンガープリントと、ほかの何らかの (信頼できる) 情報源 (ルート CA 自身など) から入手したフィンガープリントとを比較します。インポート操作は、証明書を確認する時点で中止できます。ただし、\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
176.391 +\f3荐惹綽膈 PKCS#7 綵√荐惹吾с若潟с翫\fP\f3keytool\fP 障с若潟筝号帥若吟若荐惹吾若 CA 綏援讐荐惹吾緇荐惹綽膈障若 CA 荐惹吾若鴻√障 (\f2\-trustcacerts\fP 激с潟絎翫) cacerts 若鴻≪<ゃ篆♂若с荐惹吾鴻罸莠筝眼茯帥鴻障筝眼荀ゃc翫若 CA 荐惹吾宴茵腓冴若吟若腆肴羆障 翫茵腓冴荐惹吾c潟若潟祉 (篆♂若с) 掩 (若 CA 荳) ユc潟若潟罸莠障ゃ潟若篏荐惹吾腆肴鴻т賢罩≪с障\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
176.392 .RE
176.393
176.394 .LP
176.395 .LP
176.396 -証明書応答内の公開鍵が \f2alias\fP の下にすでに格納されているユーザの公開鍵に一致した場合、古い証明連鎖が応答内の新しい証明連鎖で置き換えられます。
176.397 -以前の証明連鎖を新しい証明連鎖で置き換えることができるのは、有効な \f2keypass\fP、つまり該当するエントリの非公開鍵を保護するためのパスワードを指定した場合だけです。パスワードを指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
176.398 +荐惹後膈泣 \f2alias\fP 筝с主若吟若泣筝眼翫ゃ荐惹吾с若潟綽膈違荐惹吾с若潟х舟障篁ュ荐惹吾с若潟違荐惹吾с若潟х舟с鴻 \f2keypass\fPゃ障荅峨潟泣篆茘激鴻若絎翫с鴻若絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
176.399 .LP
176.400 .RE
176.401 .LP
176.402 -このコマンドは、以前のリリースでは \f2\-import\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-importcert\fP を使用することをお勧めします。
176.403 +潟潟篁ュ若鴻с \f2\-import\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-importcert\fP 篏睡с障
176.404 .TP 3
176.405 -\-importkeystore \-srckeystore srckeystore
176.406 -\-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.407 +\-importkeystore \-srckeystore srckeystore \-destkeystore destkeystore {\-srcstoretype srcstoretype} {\-deststoretype deststoretype} [\-srcstorepass srcstorepass] [\-deststorepass deststorepass] {\-srcprotected} {\-destprotected} {\-srcalias srcalias {\-destalias destalias} [\-srckeypass srckeypass] [\-destkeypass destkeypass] } {\-noprompt} {\-srcProviderName src_provider_name} {\-destProviderName dest_provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.408 .LP
176.409 -ソースキーストアからターゲットキーストアへ、単一のエントリまたはすべてのエントリをインポートします。
176.410 +純若鴻若鴻≪帥若蚊若鴻≪吾筝潟障鴻潟ゃ潟若障
176.411 .LP
176.412 -\f2srcalias\fP オプションが指定された場合、このコマンドは、その別名で特定される単一のエントリをターゲットキーストアにインポートします。\f2destalias\fP 経由でターゲット別名が指定されなかった場合、\f2srcalias\fP がターゲット別名として使用されます。ソースのエントリがパスワードで保護されていた場合、\f2srckeypass\fP を使ってそのエントリが回復されます。\f2srckeypass\fP が指定されなかった場合、\f3keytool\fP は \f2srcstorepass\fP を使ってそのエントリを回復しようとします。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザはパスワードの入力を求められます。ターゲットエントリは \f2destkeypass\fP によって保護されます。\f2destkeypass\fP が指定されなかった場合、ターゲットエントリはソースエントリのパスワードによって保護されます。
176.413 +\f2srcalias\fP 激с潟絎翫潟潟ュх劫筝潟帥若蚊若鴻≪ゃ潟若障\f2destalias\fP 腟宴с帥若蚊ュ絎c翫\f2srcalias\fP 帥若蚊ュ篏睡障純若鴻潟鴻若т茘激翫\f2srckeypass\fP 篏帥c潟緇障\f2srckeypass\fP 絎c翫\f3keytool\fP \f2srcstorepass\fP 篏帥c潟緇障\f2srcstorepass\fP 絎c罩cc翫若吟若鴻若ュ羆障帥若蚊潟 \f2destkeypass\fP c篆茘激障\f2destkeypass\fP 絎c翫帥若蚊潟純若鴻潟鴻若c篆茘激障
176.414 .LP
176.415 -\f2srcalias\fP オプションが指定されなかった場合、ソースキーストア内のすべてのエントリがターゲットキーストア内にインポートされます。各ターゲットエントリは対応するソースエントリの別名の下に格納されます。ソースエントリがパスワードで保護されていた場合、\f2srcstorepass\fP を使ってそのエントリが回復されます。\f2srcstorepass\fP が指定されなかったか正しくなかった場合、ユーザはパスワードの入力を求められます。ソースキーストア内のあるエントリタイプがターゲットキーストアでサポートされていない場合や、あるエントリをターゲットキーストアに格納する際にエラーが発生した場合、ユーザはそのエントリをスキップして処理を続行するか、あるいは処理を中断するかの選択を求められます。ターゲットエントリはソースエントリのパスワードによって保護されます。
176.416 +\f2srcalias\fP 激с潟絎c翫純若鴻若鴻√鴻潟帥若蚊若鴻√ゃ潟若障帥若蚊潟絲上純若鴻潟ュ筝主障純若鴻潟鴻若т茘激翫\f2srcstorepass\fP 篏帥c潟緇障\f2srcstorepass\fP 絎c罩cc翫若吟若鴻若ュ羆障純若鴻若鴻√潟帥ゃ帥若蚊若鴻≪с泣若翫潟帥若蚊若鴻≪主若榊翫若吟若潟鴻膓茵筝御羆障帥若蚊潟純若鴻潟鴻若c篆茘激障
176.417 .LP
176.418 -ターゲット別名がターゲットキーストア内にすでに存在していた場合、ユーザは、そのエントリを上書きするか、あるいは異なる別名の下で新しいエントリを作成するかの選択を求められます。
176.419 +帥若蚊ュ帥若蚊若鴻√с絖翫若吟若潟筝吾違ュ筝ф違潟篏御羆障
176.420 .LP
176.421 -\f2\-noprompt\fP を指定した場合、ユーザは新しいターゲット別名の入力を求められません。既存のエントリはそのターゲット別名で自動的に上書きされます。最後に、インポートできないエントリは自動的にスキップされ、警告が出力されます。
176.422 +\f2\-noprompt\fP 絎翫若吟若違帥若蚊ュュ羆障√潟帥若蚊ュц筝吾障緇ゃ潟若с潟鴻茘阪障
176.423 .RE
176.424 .RE
176.425 .SS
176.426 -データのエクスポート
176.427 +若帥鴻若
176.428 .LP
176.429 .RS 3
176.430
176.431 .LP
176.432 .RS 3
176.433 .TP 3
176.434 -\-certreq {\-alias alias}
176.435 -{\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.436 +\-certreq {\-alias alias} {\-sigalg sigalg} {\-file certreq_file} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.437 .LP
176.438 -PKCS#10 形式を使って証明書署名要求 (CSR) を生成します。
176.439 +PKCS#10 綵√篏帥c荐惹悟讐荀羆 (CSR) 障
176.440 .LP
176.441 -CSR は、認証局 (CA) に送信することを目的としたものです。CA は、証明書要求者を (通常はオフラインで) 認証し、証明書または証明連鎖を送り返します。 この証明書または証明連鎖は、キーストア内の既存の証明連鎖 (最初は 1 つの自己署名証明書から構成される) に置き換えて使います。
176.442 +CSR 荐惹悟肴絮 (CA) 篆<сCA 荐惹梧羆 (絽吾ゃ潟) 茯荐若荐惹吾障荐惹吾с若潟菴障 荐惹吾障荐惹吾с若潟若鴻√√荐惹吾с若 ( 1 ゃ綏援讐荐惹吾罕) 臀篏帥障
176.443 .LP
176.444 -\f2alias\fP に関連付けられた非公開鍵と X.500 識別名は、PKCS#10 証明書要求を作成するのに使われます。非公開鍵はキーストア内ではパスワードによって保護されているので、非公開鍵にアクセスするには、適切なパスワードを提供する必要があります。コマンド行で \f2keypass\fP を指定しておらず、非公開鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
176.445 +\f2alias\fP ∫d泣 X.500 茘ュPKCS#10 荐惹梧羆篏篏帥障泣若鴻√с鴻若c篆茘激с泣≪祉鴻鴻若箴綽荀障潟潟茵 \f2keypass\fP 絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
176.446 .LP
176.447 -\f2sigalg\fP には、CSR に署名を付けるときに使うアルゴリズムを指定します。
176.448 +\f2sigalg\fP CSR 臀峨篁篏帥≪眼冴絎障
176.449 .LP
176.450 -CSR は、ファイル \f2certreq_file\fP に格納されます。ファイルが指定されていない場合は、標準出力に CSR が出力されます。
176.451 +CSR <ゃ \f2certreq_file\fP 主障<ゃ絎翫罔羣阪 CSR 阪障
176.452 .LP
176.453 -CA からの応答をインポートするには、\f2importcert\fP コマンドを使います。
176.454 +CA 綽膈ゃ潟若\f2importcert\fP 潟潟篏帥障
176.455 .TP 3
176.456 -\-exportcert {\-alias alias}
176.457 -{\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
176.458 +\-exportcert {\-alias alias} {\-file cert_file} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-rfc} {\-v} {\-protected} {\-Jjavaoption}
176.459 .LP
176.460 -\f2alias\fP に関連付けられた証明書を (キーストアから) 読み込み、ファイル \f2cert_file\fP に格納します。
176.461 +\f2alias\fP ∫d荐惹吾 (若鴻≪) 茯粋昭帥<ゃ \f2cert_file\fP 主障
176.462 .LP
176.463 -ファイルが指定されていない場合は、標準出力に証明書が出力されます。
176.464 +<ゃ絎翫罔羣阪荐惹吾阪障
176.465 .LP
176.466 -デフォルトでは、バイナリ符号化方式の証明書が出力されます。 ただし、\f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
176.467 +сゃ膃垸劫荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
176.468 .LP
176.469 -\f2alias\fP が、信頼できる証明書を参照している場合は、該当する証明書が出力されます。それ以外の場合、\f2alias\fP は、関連付けられた証明連鎖を持つ鍵エントリを参照します。この場合は、連鎖内の最初の証明書が返されます。この証明書は、\f2alias\fP によって表されるエンティティの公開鍵を認証する証明書です。
176.470 +\f2alias\fP 篆♂若с荐惹吾с翫荅峨荐惹吾阪障篁ュ翫\f2alias\fP ∫d荐惹吾с若潟ら泣潟с障翫с若喝荐惹吾菴障荐惹吾\f2alias\fP c茵潟cc若泣茯荐若荐惹吾с
176.471 .LP
176.472 -このコマンドは、以前のリリースでは \f2\-export\fP という名前でした。この古い名前は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。ただし、今後はわかりやすいように、新しい名前 \f2\-exportcert\fP を使用することをお勧めします。
176.473 +潟潟篁ュ若鴻с \f2\-export\fP сゃ若鴻с綣膓泣若篁緇若鴻с泣若篋絎с篁緇違 \f2\-exportcert\fP 篏睡с障
176.474 .RE
176.475
176.476 .LP
176.477 .RE
176.478 .SS
176.479 -データの表示
176.480 +若帥茵腓
176.481 .LP
176.482 .RS 3
176.483
176.484 .LP
176.485 .RS 3
176.486 .TP 3
176.487 -\-list {\-alias alias}
176.488 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
176.489 +\-list {\-alias alias} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v | \-rfc} {\-protected} {\-Jjavaoption}
176.490 .LP
176.491 -\f2alias\fP で特定されるキーストアエントリの内容を (標準出力に) 出力します。別名が指定されていない場合は、キーストア全体の内容が表示されます。
176.492 +\f2alias\fP х劫若鴻≪潟絎鴻 (罔羣阪) 阪障ュ絎翫若鴻√篏絎鴻茵腓冴障
176.493 .LP
176.494 -このコマンドは、デフォルトでは証明書の MD5 フィンガープリントを表示します。
176.495 -\f2\-v\fP オプションが指定されている場合は、所有者、発行者、シリアル番号、拡張機能などの付加的な情報とともに、人間が読むことのできる形式で証明書が表示されます。
176.496 --rfc オプションが指定されている場合は、出力可能符号化方式で証明書の内容が表示されます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
176.497 +潟潟с荐惹吾 MD5 c潟若潟茵腓冴障\f2\-v\fP 激с潟絎翫肴激≪垩≦宍罘純篁宴篋咲茯с綵√ц┝吾茵腓冴障\f2\-rfc\fP 激с潟絎翫阪順垸劫ц┝吾絎鴻茵腓冴障 阪順垸劫ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
176.498 .LP
176.499 -\f2\-v\fP オプションと \f2\-rfc\fP オプションとを同時に指定することはできません。
176.500 +\f2\-v\fP 激с潟 \f2\-rfc\fP 激с潟絎с障
176.501 .TP 3
176.502 \-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
176.503 .LP
176.504 +<ゃ
176.505 .LP
176.506 -\f2cert_file\fP ファイルから証明書を読み込み、人間が読むことのできる形式で証明書の内容を表示します。ファイルが指定されていない場合は、標準入力から証明書を読み込みます。
176.507 +ゃ潟帥若 RFC 1421 荐惹悟垸荀若у臂障
176.508 .LP
176.509 -証明書は、バイナリ符号化方式または出力可能符号化方式で表示できます。 出力可能符号化方式は、インターネット RFC 1421 証明書符号化規格で定義されています。
176.510 -.LP
176.511 -注: このコマンドはキーストアとは関係なく動作します。
176.512 +羈:潟潟若鴻≪≫篏障
176.513 .RE
176.514
176.515 .LP
176.516 .RE
176.517 .SS
176.518 -キーストアの管理
176.519 +若鴻≪膊∞
176.520 .LP
176.521 .RS 3
176.522
176.523 .LP
176.524 .RS 3
176.525 .TP 3
176.526 -\-storepasswd [\-new new_storepass]
176.527 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
176.528 +\-storepasswd [\-new new_storepass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
176.529 .LP
176.530 -キーストアの内容の完全性を保護するために使うパスワードを変更します。\f2new_storepass\fP には、新しいパスワードを指定します。\f2new_storepass\fP は、6 文字以上でなければなりません。
176.531 +若鴻≪絎鴻翫с篆茘激篏帥鴻若紊眼障\f2new_storepass\fP 違鴻若絎障 \f2new_storepass\fP 6 絖篁ヤс違障
176.532 .TP 3
176.533 -\-keypasswd {\-alias alias}
176.534 -[\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
176.535 +\-keypasswd {\-alias alias} [\-keypass old_keypass] [\-new new_keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-Jjavaoption}
176.536 .LP
176.537 -.I
176.538 -alias
176.539 -によって特定される非公開/秘密鍵を保護するためのパスワードを、
176.540 -.I old_keypass
176.541 -から
176.542 -.I new_keypass
176.543 -に変更します。
176.544 -.I new_keypass
176.545 -は、6 文字以上でなければなりません。
176.546 +\f2alias\fP c劫/腱絲泣篆茘激鴻若\f2old_keypass\fP \f2new_keypass\fP 紊眼障 \f2new_keypass\fP 6 絖篁ヤс違障
176.547 .LP
176.548 -コマンド行で \f2\-keypass\fP オプションを指定しておらず、鍵のパスワードがキーストアのパスワードと異なる場合は、非公開鍵のパスワードの入力を求められます。
176.549 +潟潟茵 \f2\-keypass\fP 激с潟絎泣鴻若若鴻≪鴻若違翫泣鴻若ュ羆障
176.550 .LP
176.551 -コマンド行で \f2\-new\fP オプションを指定しなかった場合は、新しいパスワードの入力を求められます。
176.552 +潟潟茵 \f2\-new\fP 激с潟絎c翫違鴻若ュ羆障
176.553 .TP 3
176.554 -\-delete [\-alias alias]
176.555 -{\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.556 +\-delete [\-alias alias] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.557 .LP
176.558 -.I alias
176.559 -によって特定されるエントリをキーストアから削除します。コマンド行で別名を指定しなかった場合は、別名の入力を求められます。
176.560 +\f2alias\fP c劫潟若鴻≪ゃ障潟潟茵уュ絎c翫ュュ羆障
176.561 .TP 3
176.562 -\-changealias {\-alias alias}
176.563 -[\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.564 +\-changealias {\-alias alias} [\-destalias destalias] [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
176.565 .LP
176.566 -指定された \f2alias\fP から新しい別名 \f2destalias\fP へ、既存のキーストアエントリを移動します。ターゲット別名が指定されなかった場合、このコマンドはその入力を求めます。元のエントリがエントリパスワードで保護されていた場合、「-keypass」オプション経由でそのパスワードを指定できます。鍵パスワードが指定されなかった場合、\f2storepass\fP (指定された場合) がまず試みられます。その試みが失敗すると、ユーザはパスワードの入力を求められます。
176.567 +絎 \f2alias\fP 違ュ \f2destalias\fP 吾√若鴻≪潟腱糸障帥若蚊ュ絎c翫潟潟ュ羆障潟潟鴻若т茘激翫\-keypass激с括宴с鴻若絎с障泣鴻若絎c翫\f2storepass\fP (絎翫) 障荅帥障荅帥紊掩若吟若鴻若ュ羆障
176.568 .RE
176.569
176.570 .LP
176.571 .RE
176.572 .SS
176.573 -ヘルプの表示
176.574 +茵腓
176.575 .LP
176.576 .RS 3
176.577
176.578 @@ -478,26 +451,26 @@
176.579 .TP 3
176.580 \-help
176.581 .LP
176.582 -基本的なコマンドとそのオプションの一覧を表示します。
176.583 +堺潟潟激с潟筝荀с茵腓冴障
176.584 .RE
176.585
176.586 .LP
176.587 .RE
176.588 -.SH "例"
176.589 +.SH "箴"
176.590 .LP
176.591
176.592 .LP
176.593 .LP
176.594 -ここでは、自分の鍵のペアおよび信頼できるエンティティからの証明書を管理するためのキーストアを作成する場合を例として示します。
176.595 +с泣≪割拭若с潟cc若荐惹吾膊∞若鴻≪篏翫箴腓冴障
176.596 .LP
176.597 .SS
176.598 -鍵のペアの生成
176.599 +泣≪
176.600 .LP
176.601 .RS 3
176.602
176.603 .LP
176.604 .LP
176.605 -まず、キーストアを作成して鍵のペアを生成する必要があります。次に示すのは、実行するコマンドの例です。
176.606 +障若鴻≪篏泣≪綽荀障罨<腓冴絎茵潟潟箴с
176.607 .LP
176.608 .nf
176.609 \f3
176.610 @@ -513,16 +486,16 @@
176.611
176.612 .LP
176.613 .LP
176.614 -注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。
176.615 +羈:潟潟 1 茵ュ違障箴ц域ュ茯帥с
176.616 .LP
176.617 .LP
176.618 -この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアにパスワード ab987c を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティの「識別名」は、通称が「Mark Jones」、組織単位が「JavaSoft」、組織が「Sun」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
176.619 +箴сworking c mykeystore 若鴻≪篏 (若鴻≪障絖篁絎)篏若鴻≪鴻若 ab987c 蚊綵障泣泣≪絲上潟cc若茘ュ腱違Mark Jones腟膵篏JavaSoft腟膵Sun2 絖順垩USс泣泣泣ゃ冴< 1024 с泣篏 DSA 窮≪眼冴篏睡障
176.620 .LP
176.621 .LP
176.622 -このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵にはパスワード「kpi135」が割り当てられます。
176.623 +潟潟泣茘ュ宴綏援讐荐惹 ( SHA1withDSA 臀峨≪眼冴篏睡) 篏障荐惹吾号 180 ャс 荐惹吾ュbusinessх劫若鴻≪潟泣∫d障泣鴻若kpi135蚊綵障
176.624 .LP
176.625 .LP
176.626 -オプションの既定値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。既定値を持つオプションでは、オプションを指定しなければ既定値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。
176.627 +激с潟ゃ篏帥翫筝腓冴潟潟紊ус障絎激с潟 1 ゃ絎潟潟絎茵純с ゃゃ激с潟с激с潟絎違ゃ篏帥綽荀ゃゃュ羆障違罨<ュс障
176.628 .LP
176.629 .nf
176.630 \f3
176.631 @@ -533,19 +506,19 @@
176.632 .fi
176.633
176.634 .LP
176.635 -この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。
176.636 +翫mykey ュс若鴻≪潟篏違泣≪ 90 ラ鴻荐惹吾潟主障潟若c .keystore 若鴻≪臀障若鴻≪障絖翫篏障茘ュ宴若鴻≪鴻若渇泣鴻若ゃュ羆障
176.637 .LP
176.638 -以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行した場合の例を示します。 情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、非公開鍵のパスワードには kpi135 と指定)。
176.639 +篁ヤс激с潟絎 \f2\-genkeypair\fP 潟潟絎茵箴腓冴障 宴ュ羆翫腓冴 \f2\-genkeypair\fP 潟潟ゃュ障 (違泣鴻若 kpi135 絎)
176.640 .LP
176.641 .RE
176.642 .SS
176.643 -認証局に対する署名付き証明書の要求
176.644 +荐惹悟肴絮絲障臀峨篁荐惹吾荀羆
176.645 .LP
176.646 .RS 3
176.647
176.648 .LP
176.649 .LP
176.650 -現時点で手元にあるのは、1 通の自己署名証明書だけです。証明書に認証局 (CA) の署名が付いていれば、ほかのユーザから証明書が信頼できる可能性も高くなります。CA の署名を取得するには、まず、証明書署名要求 (CSR) を生成します。 たとえば、次のようにします。
176.651 +憝鴻ф1 綏援讐荐惹吾с荐惹吾荐惹悟肴絮 (CA) 臀峨篁違祉若吟若荐惹吾篆♂若с醇с蕭障CA 臀峨緇障荐惹悟讐荀羆 (CSR) 障 違罨<障
176.652 .LP
176.653 .nf
176.654 \f3
176.655 @@ -556,43 +529,41 @@
176.656 .fi
176.657
176.658 .LP
176.659 -CSR (デフォルト別名「mykey」によって特定されるエンティティの CSR) が作成され、MarkJ.csr という名前のファイルに置かれます。このファイルは、VeriSign などの CA に提出します。 CA は要求者を (通常はオフラインで) 認証し、要求者の公開鍵を認証した署名付きの証明書を送り返します。場合によっては、CA が証明書の連鎖を返すこともあります。証明書の連鎖では、各証明書が連鎖内のその前の署名者の公開鍵を認証します。
176.660 -
176.661 +CSR (ュmykeyc劫潟cc若 CSR) 篏MarkJ.csr <ゃ臀障<ゃVeriSign CA 冴障 CA 荀羆 (絽吾ゃ潟) 茯荐若荀羆泣茯荐若臀峨篁荐惹吾菴障翫cCA 荐惹吾с若潟菴障 荐惹吾с若潟с荐惹吾с若喝臀峨泣茯荐若障
176.662 +.RE
176.663 .SS
176.664 -CA からの証明書のインポート
176.665 +CA 荐惹吾ゃ潟若
176.666 .LP
176.667 .RS 3
176.668
176.669 .LP
176.670 .LP
176.671 -作成した自己署名証明書は、証明連鎖で置き換える必要があります。 証明連鎖では、各証明書が、「ルート」CA を起点とする連鎖内の次の証明書の署名者の公開鍵を認証します。
176.672 +篏綏援讐荐惹吾荐惹吾с若潟х舟綽荀障 荐惹吾с若潟с荐惹吾若CA 莎欠鴻с若喝罨<荐惹吾臀峨泣茯荐若障
176.673 .LP
176.674 .LP
176.675 -CA からの証明応答をインポートするには、キーストアか、(importcert コマンドで説明しているように) \f2cacerts\fP キーストアファイル内に 1 つまたは複数の「信頼できる証明書」がある必要があります。
176.676 +CA 荐惹綽膈ゃ潟若若鴻≪(importcert 潟潟 ц) \f2cacerts\fP 若鴻≪<ゃ 1 や札筝篆♂若с荐惹吾綽荀障
176.677 .LP
176.678 .RS 3
176.679 .TP 2
176.680 o
176.681 -証明応答が証明連鎖の場合は、連鎖のトップの証明書 (その CA の公開鍵を認証する「ルート」CA の証明書) だけを必要とする
176.682 +荐惹綽膈荐惹吾с若潟翫с若潟荐惹 ( CA 泣茯荐若若CA 荐惹) 綽荀
176.683 .TP 2
176.684 o
176.685 -証明応答が単一の証明書の場合は、証明書に署名した CA の発行用の証明書が必要で、その証明書が自己署名されない場合は、さらにその証明書の署名者用の証明書を必要とする。 このようにして自己署名される「ルート」CA の証明書までそれぞれ証明書を必要とする
176.686 +荐惹綽膈筝荐惹吾翫荐惹吾臀峨 CA 肴荐惹吾綽荀с荐惹吾綏援讐翫荐惹吾臀峨荐惹吾綽荀 綏援讐若CA 荐惹吾障с荐惹吾綽荀
176.687 .RE
176.688
176.689 .LP
176.690 .LP
176.691 -cacerts キーストアファイルは、5 つの VeriSign ルート CA 証明書を含んだ状態で出荷されているので、VeriSign の証明書を、信頼できる証明書としてキーストア内にインポートする必要はないかもしれません。ただし、ほかの CA に対して署名付き証明書を要求していて、この CA の公開鍵を認証する証明書が、cacerts にまだ追加されていない場合は、該当する CA からの証明書を、「信頼できる証明書」としてインポートする必要があります。
176.692 +cacerts 若鴻≪<ゃ5 ゃ VeriSign 若 CA 荐惹吾倶у肴激сVeriSign 荐惹吾篆♂若с荐惹吾若鴻√ゃ潟若綽荀障祉 CA 絲障臀峨篁荐惹吾荀羆 CA 泣茯荐若荐惹吾cacerts 障菴遵翫荅峨 CA 荐惹吾篆♂若с荐惹吾ゃ潟若綽荀障
176.693 .LP
176.694 .LP
176.695 -通常、CA からの証明書は、自己署名証明書、またはほかの CA によって署名された証明書です (後者の場合は、該当するほかの CA の公開鍵を認証する証明書も必要)。たとえば、ABC という企業が CA だとします。 このとき、この CA の公開鍵を認証する自己署名証明書と考えられる ABCCA.cer という名前のファイルを、ABC から入手したとします。
176.696 +絽吾CA 荐惹吾綏援讐荐惹吾障祉 CA c臀峨荐惹吾с (緇翫荅峨祉 CA 泣茯荐若荐惹吾綽荀)違ABC 篌罐 CA 障 CA 泣茯荐若綏援讐荐惹吾 ABCCA.cer <ゃABC ユ障
176.697 .LP
176.698 .LP
176.699 -「信頼できる証明書」として証明書をインポートするときは、証明書が有効であることを慎重に確認する必要があります。
176.700 -まず、証明書の内容を表示し (\f3keytool\fP \f2\-printcert\fP コマンドを使用するか、または \f2\-noprompt\fP オプションを指定しないで \f3keytool\fP \f2\-importcert\fP コマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。
176.701 -証明書を送信した人物に連絡し、この人物が提示した (または安全な公開鍵のリポジトリによって提示される) フィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのものを信頼することになります。
176.702 +篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾鴻с腆肴綽荀障障荐惹吾絎鴻茵腓冴 (\f3keytool\fP \f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f3keytool\fP \f2\-importcert\fP 潟潟篏睡)茵腓冴荐惹吾c潟若潟緇c潟若潟筝眼腆肴障荐惹吾篆<篋榊g機篋榊腓冴 (障絎泣吾c腓冴) c潟若潟筝潟潟ц;腓冴c潟若潟罸莠障c潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙c臀峨鴻篆♂若障
176.703 .LP
176.704 .LP
176.705 -ABCCA.cer を有効な証明書として信頼する場合は、証明書をキーストアに追加できます。 たとえば、次のようにします。
176.706 +ABCCA.cer 鴻荐惹吾篆♂若翫荐惹吾若鴻≪菴遵с障 違罨<障
176.707 .LP
176.708 .nf
176.709 \f3
176.710 @@ -603,19 +574,19 @@
176.711 .fi
176.712
176.713 .LP
176.714 -ABCCA.cer ファイルのデータを含む「信頼できる証明書」のエントリがキーストア内に作成され、該当するエントリに abc という別名が割り当てられます。
176.715 +ABCCA.cer <ゃ若帥篆♂若с荐惹吾潟若鴻√篏荅峨潟 abc ュ蚊綵障
176.716 .RE
176.717 .SS
176.718 -CA からの証明応答のインポート
176.719 +CA 荐惹綽膈ゃ潟若
176.720 .LP
176.721 .RS 3
176.722
176.723 .LP
176.724 .LP
176.725 -証明書署名要求の提出先の CA の公開鍵を認証する証明書をインポートしたあとは (または同種の証明書がすでに cacerts ファイル内に存在している場合は)、証明応答をインポートし、自己署名証明書を証明連鎖で置き換えることができます。この証明連鎖は、CA の応答が連鎖の場合、証明書署名要求に対する応答として CA から送り返された証明連鎖です。 また、CA の応答が単一の証明書の場合は、この証明応答と、インポート先のキーストア内または cacerts キーストアファイル内にすでに存在する信頼できる証明書とを使って構築した証明連鎖です。
176.726 +荐惹悟讐荀羆阪 CA 泣茯荐若荐惹吾ゃ潟若 (障腮荐惹吾с cacerts <ゃ絖翫)荐惹綽膈ゃ潟若綏援讐荐惹吾荐惹吾с若潟х舟с障荐惹吾с若潟CA 綽膈с若潟翫荐惹悟讐荀羆絲障綽膈 CA 菴荐惹吾с若潟с 障CA 綽膈筝荐惹吾翫荐惹綽膈ゃ潟若若鴻√障 cacerts 若鴻≪<ゃс絖篆♂若с荐惹吾篏帥c罕膀荐惹吾с若潟с
176.727 .LP
176.728 .LP
176.729 -たとえば、証明書署名要求を VeriSign に送信したとします。送り返された証明書の名前が VSMarkJ.cer だとすると、次のようにして応答をインポートできます。
176.730 +違荐惹悟讐荀羆 VeriSign 篆<障菴荐惹吾 VSMarkJ.cer 罨<綽膈ゃ潟若с障
176.731 .LP
176.732 .nf
176.733 \f3
176.734 @@ -628,17 +599,14 @@
176.735
176.736 .LP
176.737 .SS
176.738 -公開鍵を認証する証明書のエクスポート
176.739 +泣茯荐若荐惹吾鴻若
176.740 .LP
176.741 .RS 3
176.742
176.743 .LP
176.744 -たとえば、
176.745 -.fi
176.746 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html
176.747 -の \f2jarsigner\fP ツールを使って Java ARchive (JAR) ファイルに署名を付けたとします。この JAR ファイルはクライアントによって使われますが、クライアント側では署名を認証したいと考えています。
176.748 +違jarsigner(1) 篏帥c Java ARchive (JAR) <ゃ臀峨障 JAR <ゃゃ≪潟c篏帥障ゃ≪潟眼с臀峨茯荐若障
176.749 .LP
176.750 -クライアントが署名を認証する方法の 1 つに、まず自分の公開鍵の証明書を「信頼できる」エントリとしてクライアントのキーストアにインポートする方法があります。そのためには、証明書をエクスポートして、クライアントに提供します。たとえば、次のようにして、証明書を \f2MJ.cer\fP という名前のファイルにコピーします。 このエントリには「mykey」という別名が使われているとします。
176.751 +ゃ≪潟臀峨茯荐若号 1 ゃ障泣荐惹吾篆♂若с潟ゃ≪潟若鴻≪ゃ潟若号障荐惹吾鴻若ゃ≪潟箴障違罨<荐惹吾 \f2MJ.cer\fP <ゃ潟若障 潟mykeyュ篏帥障
176.752 .LP
176.753 .nf
176.754 \f3
176.755 @@ -649,19 +617,19 @@
176.756 .fi
176.757
176.758 .LP
176.759 -証明書と署名付き JAR ファイルを入手したクライアントは、\f3jarsigner\fP ツールを使って署名を認証できます。
176.760 +荐惹吾臀峨篁 JAR <ゃユゃ≪潟\f3jarsigner\fP 若篏帥c臀峨茯荐若с障
176.761 .RE
176.762 .SS
176.763 -キーストアのインポート
176.764 +若鴻≪ゃ潟若
176.765 .LP
176.766 .RS 3
176.767
176.768 .LP
176.769 .LP
176.770 -コマンド「importkeystore」を使えば、あるキーストアの全体を別のキーストア内にインポートできます。これは、鍵や証明書といったソースキーストア内のすべてのエントリが、単一のコマンドを使ってターゲットキーストア内にインポートされることを意味します。このコマンドを使えば、異なるタイプのキーストア内に含まれるエントリをインポートすることができます。インポート時には、ターゲットキーストア内の新しいエントリはすべて、元と同じ別名および (秘密鍵や非公開鍵の場合は) 保護用パスワードを持ちます。ソースキーストア内の非公開鍵や秘密鍵の回復時に問題が発生した場合、\f3keytool\fP はユーザにパスワードの入力を求めます。このコマンドは、別名の重複を検出すると、ユーザに新しい別名の入力を求めます。ユーザは、新しい別名を指定することも、単純に既存の別名の上書きを \f3keytool\fP に許可することもできます。
176.771 +潟潟importkeystore篏帥違若鴻≪篏ャ若鴻√ゃ潟若с障 泣荐惹吾c純若鴻若鴻√鴻潟筝潟潟篏帥c帥若蚊若鴻√ゃ潟若潟障潟潟篏帥違違帥ゃ若鴻√障潟ゃ潟若с障ゃ潟若帥若蚊若鴻√違潟鴻ュ (腱絲泣泣翫) 篆茘欠鴻若<障純若鴻若鴻√泣腱絲泣緇馹榊翫\f3keytool\fP 若吟若鴻若ュ羆障潟潟ュ茲罎冴若吟若違ュュ羆障 若吟若違ュ絎膣√ュ筝吾 \f3keytool\fP 荐怨с障
176.772 .LP
176.773 .LP
176.774 -たとえば、通常の JKS タイプのキーストア key.jks 内のエントリを PKCS #11 タイプのハードウェアベースのキーストア内にインポートするには、次のコマンドを使用できます。
176.775 +違絽吾 JKS 帥ゃ若鴻 key.jks 潟 PKCS #11 帥ゃ若с≪若鴻若鴻√ゃ潟若罨<潟潟篏睡с障
176.776 .LP
176.777 .nf
176.778 \f3
176.779 @@ -679,7 +647,7 @@
176.780
176.781 .LP
176.782 .LP
176.783 -また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。そうすれば、プロンプトのまったく表示されない \f3keytool\fP コマンドを発行できます。これは、\f3keytool\fP コマンドをスクリプトファイルに含める際に非常に便利です。次に例を示します。
176.784 +障importkeystore 潟潟篏帥違純若鴻若鴻√筝潟帥若蚊若鴻≪ゃ潟若с障翫筝荐箴хず激с潟ゃ潟若絲乗院ュ絎綽荀障srcalias 激с潟絎翫帥若蚊ュ潟潟茵絎с祉腱絲/泣篆茘欠鴻若帥若蚊篆茘欠鴻若絎с障違潟障c頫腓冴 \f3keytool\fP 潟潟肴с障\f3keytool\fP 潟潟鴻<ゃ絽吾箴水с 罨<箴腓冴障
176.785 .LP
176.786 .nf
176.787 \f3
176.788 @@ -703,51 +671,51 @@
176.789 .RE
176.790
176.791 .LP
176.792 -.SH "用語と警告"
176.793 +.SH "茯茘"
176.794 .LP
176.795
176.796 .LP
176.797 .SS
176.798 -キーストア
176.799 +若鴻
176.800 .LP
176.801 .RS 3
176.802
176.803 .LP
176.804 -キーストアは、暗号化の鍵と証明書を格納するための機構です。
176.805 +若鴻≪垸泣荐惹吾主罘純с
176.806 .RE
176.807 .RS 3
176.808 .TP 2
176.809 o
176.810 -\f3キーストアのエントリ\fP
176.811 +.TP 2
176.812 +o
176.813 +\f3若鴻≪潟\fP
176.814 .RS 3
176.815
176.816 .LP
176.817 -キーストアには異なるタイプのエントリを含めることができます。\f3keytool\fP でもっとも適用範囲の広いエントリタイプは、次の 2 つです。
176.818 +若鴻≪違帥ゃ潟с障\f3keytool\fP сc膀蚊綺潟帥ゃ罨< 2 ゃс
176.819 .RS 3
176.820 .TP 3
176.821 1.
176.822 -\f3鍵のエントリ\fP \- 各エントリは、非常に重要な暗号化の鍵の情報を保持します。この情報は、許可していないアクセスを防ぐために、保護された形で格納されます。一般に、この種のエントリとして格納される鍵は、秘密鍵か、対応する公開鍵の証明連鎖を伴う非公開鍵です。
176.823 -\f3keytool\fP がこの両方のタイプのエントリを処理できるのに対し、\f3jarsigner\fP ツールは後者のタイプのエントリ、つまり非公開鍵とそれに関連付けられた証明連鎖のみを処理します。
176.824 +\f3泣潟\fP \- 潟絽吾荀垸泣宴篆障宴荐怨≪祉鴻蚊篆茘激綵≪ф主障筝腮潟主泣腱絲泣絲上泣荐惹吾с若潟篌眼泣с\f3keytool\fP 筝≧鴻帥ゃ潟с絲障\f3jarsigner\fP 若緇帥ゃ潟ゃ障泣∫d荐惹吾с若潟帥障
176.825 .TP 3
176.826 2.
176.827 -\f3信頼できる証明書のエントリ\fP \- 各エントリは、第三者からの公開鍵証明書を 1 つ含んでいます。この証明書は、「信頼できる証明書」と呼ばれます。 それは、証明書内の公開鍵が、証明書の「Subject」(所有者) によって特定されるアイデンティティに由来するものであることを、キーストアの所有者が信頼するからです。証明書の発行者は、証明書に署名を付けることによって、その内容を保証します。
176.828 +\f3篆♂若с荐惹吾潟\fP \- 潟膃筝笈┝吾 1 ゅс障荐惹吾篆♂若с荐惹吾若違障 荐惹後泣荐惹吾Subject() c劫≪ゃ潟cc若掩ャс若鴻≪篆♂若с荐惹吾肴荐惹吾臀峨篁c絎鴻篆荐若障
176.829 .RE
176.830
176.831 .LP
176.832 .RE
176.833 .TP 2
176.834 o
176.835 -\f3キーストアの別名\fP
176.836 +\f3若鴻≪ュ\fP
176.837 .RS 3
176.838 .LP
176.839 -キーストアのすべてのエントリ (鍵および信頼できる証明書) は、一意の「別名」を介してアクセスされます。
176.840 +若鴻≪鴻潟 (泣割拭若с荐惹) 筝ュ篁≪祉鴻障
176.841 .LP
176.842 .LP
176.843 -別名を指定するのは、\-genseckey コマンドを使って秘密鍵を生成したり、\-genkeypair コマンドを使って鍵ペア (公開鍵と非公開鍵) を生成したり、\-importcert コマンドを使って証明書または証明連鎖を信頼できる証明書のリストに追加したりするなど、特定のエンティティをキーストアに追加する場合です。
176.844 -これ以後、\f3keytool\fP コマンドでエンティティを参照する場合は、このときに指定した別名を使用する必要があります。
176.845 +ュ絎\-genseckey 潟潟篏帥c腱絲泣\-genkeypair 潟潟篏帥c泣 (泣) \-importcert 潟潟篏帥c荐惹吾障荐惹吾с若潟篆♂若с荐惹吾鴻菴遵劫潟cc若若鴻≪菴遵翫с篁ュ\f3keytool\fP 潟潟с潟cc若с翫絎ュ篏睡綽荀障
176.846 .LP
176.847 .LP
176.848 -たとえば、\f2duke\fP という別名を使って新しい公開鍵と非公開鍵のペアを生成し、公開鍵を自己署名証明書 (「証明連鎖」を参照) でラップするとします。 この場合は、次のコマンドを実行します。
176.849 +違\f2duke\fP ュ篏帥c違泣泣≪泣綏援讐荐惹 (荐惹吾с若潟) с障 翫罨<潟潟絎茵障
176.850 .LP
176.851 .nf
176.852 \f3
176.853 @@ -758,7 +726,7 @@
176.854 .fi
176.855
176.856 .LP
176.857 -ここでは、初期パスワードとして dukekeypasswd を指定しています。 以後、別名 \f2duke\fP に関連付けられた非公開鍵にアクセスするコマンドを実行するときは、このパスワードが必要になります。duke の非公開鍵のパスワードをあとから変更するには、次のコマンドを実行します。
176.858 +с鴻若 dukekeypasswd 絎障 篁ュュ \f2duke\fP ∫d泣≪祉鴻潟潟絎茵鴻若綽荀障duke 泣鴻若紊眼罨<潟潟絎茵障
176.859 .nf
176.860 \f3
176.861 .fl
176.862 @@ -768,44 +736,46 @@
176.863 .fi
176.864
176.865 .LP
176.866 -パスワードが、dukekeypasswd から newpass に変更されます。
176.867 +鴻若dukekeypasswd newpass 紊眼障
176.868 .LP
176.869 -注 - テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
176.870 +羈 \-鴻翫障絎сc激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с綽荀鴻若激с潟潟潟茵ф絎c翫鴻若ュ羆障
176.871 .LP
176.872 .RE
176.873 .TP 2
176.874 o
176.875 -\f3キーストアの実装\fP
176.876 +\f3若鴻≪絎茖\fP
176.877 .RS 3
176.878 -\f2java.security\fP パッケージで提供される \f2KeyStore\fP クラスには、キーストア内の情報に対するアクセスと変更を行うための明確に定義されたインタフェースが用意されています。キーストアの固定実装としては、それぞれが特定の「タイプ」のキーストアを対象とする複数の異なる実装が存在可能です。
176.879 +\f2java.security\fP 宴若吾ф箴 \f2KeyStore\fP 鴻若鴻√宴絲障≪祉鴻紊眼茵腆冴絎臂ゃ潟帥с若鴻障若鴻≪阪絎茖劫帥ゃ若鴻≪絲乗院茲違違絎茖絖純с
176.880 .LP
176.881 -現在、\f3keytool\fP と \f3jarsigner\fP の 2 つのコマンド行ツールと、\f3Policy Tool\fP という名前の 1 つの GUI ベースのツールが、キーストアの実装を使用しています。\f2KeyStore\fP は public として使用可能なので、JDK ユーザは \f2KeyStore\fP を使ったほかのセキュリティアプリケーションも作成できます。
176.882 +憜\f3keytool\fP \f3jarsigner\fP 2 ゃ潟潟茵若\f3Policy Tool\fP 1 ゃ GUI 若鴻若若鴻≪絎茖篏睡障\f2KeyStore\fP public 篏睡純сJDK 若吟若 \f2KeyStore\fP 篏帥c祉祉ャc若≪宴若激с潟篏с障
176.883 .LP
176.884 .LP
176.885 -キーストアには、Sun が提供する組み込みのデフォルトの実装があります。これは、JKS という名前の独自のキーストアタイプ (形式) を利用するもので、キーストアをファイルとして実装しています。この実装では、個々の非公開鍵は個別のパスワードによって保護され、キーストア全体の完全性も (非公開鍵とは別の) パスワードによって保護されます。
176.886 +若鴻≪Sun 箴腟粋昭帥絎茖障JKS 若鴻≪帥ゃ (綵√) с若鴻≪<ゃ絎茖障絎茖с泣ャ鴻若c篆茘激若鴻√篏翫с (泣ャ) 鴻若c篆茘激障
176.887 .LP
176.888 .LP
176.889 -キーストアの実装は、プロバイダベースです。具体的には、\f2KeyStore\fP が提供するアプリケーションインタフェースは、Service Provider Interface (SPI) という形で実装されています。つまり、対応する \f2KeystoreSpi\fP 抽象クラス (これも \f2java.security\fP パッケージに含まれている) があり、このクラスが Service Provider Interface のメソッドを定義しています。これらのメソッドは、「プロバイダ」が実装しなければなりません。ここで、「プロバイダ」とは、Java Security API によってアクセス可能なサービスのサブセットに対し、その固定実装を提供するパッケージまたはパッケージの集合のことです。したがって、キーストアの実装を提供するには、「Java(TM) 暗号化アーキテクチャ用プロバイダの実装方法」で説明しているように、クライアントが「プロバイダ」を実装し、KeystoreSpi サブクラスの実装を提供する必要があります。
176.890 +若鴻≪絎茖ゃ若鴻с隙\f2KeyStore\fP 箴≪宴若激с潟ゃ潟帥с若鴻Service Provider Interface (SPI) 綵≪у茖障ゃ障絲上 \f2KeystoreSpi\fP 処院 ( \f2java.security\fP 宴若吾障) 鴻 Service Provider Interface <純絎臂障 <純ゃ絎茖違障сゃJava Security API c≪祉劫純泣若鴻泣祉絲障阪絎茖箴宴若吾障宴若吾сc若鴻≪絎茖箴
176.891 +.na
176.892 +\f2Java(TM) 垸≪若c主ゃ絎茖号\fP @
176.893 +.fi
176.894 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.htmlцゃ≪潟ゃ絎茖KeystoreSpi 泣鴻絎茖箴綽荀障
176.895 .LP
176.896 .LP
176.897 -アプリケーションでは、\f2KeyStore\fP クラスが提供する getInstance ファクトリメソッドを使うことで、さまざまなプロバイダから異なる「タイプ」のキーストアの実装を選択できます。
176.898 -キーストアのタイプは、キーストア情報の格納形式とデータ形式を定義するとともに、キーストア内の非公開/秘密鍵とキーストア自体の完全性を保護するために使われるアルゴリズムを定義します。
176.899 -異なるタイプのキーストアの実装には、互換性はありません。
176.900 +≪宴若激с潟с\f2KeyStore\fP 鴻箴 getInstance <<純篏帥с障障ゃ違帥ゃ若鴻≪絎茖御с障若鴻≪帥ゃ若鴻∽宴主綵√若水就綣絎臂若鴻√/腱絲泣若鴻∵篏翫с篆茘激篏帥≪眼冴絎臂障違帥ゃ若鴻≪絎茖篋с障
176.901 .LP
176.902 .LP
176.903 -\f3keytool\fP は、任意のファイルベースのキーストア実装で動作します。\f3keytool\fP は、コマンド行から渡されたキーストアの場所をファイル名として扱い、これを FileInputStream に変換して、FileInputStream からキーストアの情報をロードします。一方、\f3jarsigner\fP と \f3policytool\fP ツールは、URL で指定可能な任意の場所からキーストアを読み込むことができます。
176.904 +\f3keytool\fP 篁紙<ゃ若鴻若鴻√茖у篏障keytool 潟潟茵羝<若鴻≪贋<ゃ宴 FileInputStream 紊FileInputStream 若鴻≪宴若障筝鴻\f3jarsigner\fP 若 \f3policytool\fP 若URL ф絎純篁紙贋若鴻≪茯粋昭с障
176.905 .LP
176.906 .LP
176.907 -\f3keytool\fP と \f3jarsigner\fP の場合、\f2\-storetype\fP オプションを使ってコマンド行でキーストアのタイプを指定できます。\f3Policy Tool\fP の場合は、「キーストア」メニューによってキーストアのタイプを指定できます。
176.908 +\f3keytool\fP \f3jarsigner\fP 翫\f2\-storetype\fP 激с潟篏帥c潟潟茵с若鴻≪帥ゃ絎с障\f3Policy Tool\fP翫若鴻≪<ャ若c若鴻≪帥ゃ絎с障
176.909 .LP
176.910 .LP
176.911 -キーストアのタイプを明示的に指定しない場合、keytool、jarsigner、および policytool の各ツールは、セキュリティプロパティファイル内で指定された \f2keystore.type\fP プロパティの値に基づいてキーストアの実装を選択します。セキュリティプロパティファイルは、\f2java.security\fP という名前でセキュリティプロパティディレクトリ \f2java.home\fP/lib/security に置かれています。 \f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
176.912 +若鴻≪帥ゃ腓榊絎翫keytooljarsigner policytool 若祉ャc若c若<ゃф絎 \f2keystore.type\fP c若ゃ冴ャ若鴻≪絎茖御障祉ャc若c若<ゃ\f2java.security\fP с祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
176.913 .LP
176.914 .LP
176.915 -各ツールは、\f2keystore.type\fP の値を取得し、この値で指定されたタイプのキーストアを実装しているプロバイダが見つかるまで、現在インストールされているすべてのプロバイダを調べます。目的のプロバイダが見つかると、そのプロバイダからのキーストアの実装を使います。
176.916 +若\f2keystore.type\fP ゃ緇ゃф絎帥ゃ若鴻≪絎茖ゃ荀ゃ障с憜ゃ潟鴻若鴻ゃ茯帥鴻障ゃ荀ゃゃ若鴻≪絎茖篏帥障
176.917 .LP
176.918 .LP
176.919 -\f2KeyStore\fP クラスでは \f2getDefaultType\fP という名前の static メソッドが定義されており、アプリケーションとアプレットはこのメソッドを使うことで \f2keystore.type\fP プロパティの値を取得できます。次のコードは、デフォルトのキーストアタイプ (\f2keystore.type\fP プロパティで指定されたタイプ) のインスタンスを生成します。
176.920 +\f2KeyStore\fP 鴻с \f2getDefaultType\fP static <純絎臂≪宴若激с潟≪<純篏帥 \f2keystore.type\fP c若ゃ緇с障罨<潟若若鴻≪帥ゃ (\f2keystore.type\fP c若ф絎帥ゃ) ゃ潟鴻帥潟鴻障
176.921 .LP
176.922 .nf
176.923 \f3
176.924 @@ -817,7 +787,7 @@
176.925
176.926 .LP
176.927 .LP
176.928 -デフォルトのキーストアタイプは JKS (Sun が提供する独自のタイプのキーストアの実装) です。これは、セキュリティプロパティファイル内の次の行によって指定されています。
176.929 +若鴻≪帥ゃ JKS (Sun 箴帥ゃ若鴻≪絎茖) с祉ャc若c若<ゃ罨<茵c絎障
176.930 .LP
176.931 .nf
176.932 \f3
176.933 @@ -829,10 +799,10 @@
176.934
176.935 .LP
176.936 .LP
176.937 -各ツールでデフォルト以外のキーストアの実装を使用するには、上の行を変更して別のキーストアのタイプを指定します。
176.938 +若с篁ュ若鴻≪絎茖篏睡筝茵紊眼ャ若鴻≪帥ゃ絎障
176.939 .LP
176.940 .LP
176.941 -たとえば、pkcs12 と呼ばれるタイプのキーストアの実装を提供しているプロバイダパッケージを使用するには、上の行を次のように変更します。
176.942 +違pkcs12 若違帥ゃ若鴻≪絎茖箴ゃ宴若吾篏睡筝茵罨<紊眼障
176.943 .LP
176.944 .nf
176.945 \f3
176.946 @@ -843,103 +813,103 @@
176.947 .fi
176.948
176.949 .LP
176.950 -注: キーストアのタイプの指定では、大文字と小文字は区別されません。たとえば、JKS と jks は同じものとして扱われます。
176.951 +羈:若鴻≪帥ゃ絎с紊ф絖絨絖阪ャ障違JKS jks 宴障
176.952 .RE
176.953 .RE
176.954 .SS
176.955 -証明書
176.956 +荐惹
176.957 .LP
176.958 .RS 3
176.959
176.960 .LP
176.961 -証明書 (公開鍵証明書とも呼ぶ) とは、あるエンティティ (「発行者」) からのデジタル署名付きの文書のことです。 証明書には、ほかのあるエンティティ (「署名者」) の公開鍵 (およびその他の情報) が特別な値を持っていることが書かれています。
176.962 +\f3荐惹\fP (\f3笈┝\fP若) 潟cc (肴) 吾帥臀峨篁吾с 荐惹吾祉潟cc (臀峨) (潟篁) 劫ャゃc吾障
176.963 .RE
176.964 .RS 3
176.965 .TP 2
176.966 o
176.967 -\f3証明書の用語\fP
176.968 +.TP 2
176.969 +o
176.970 +\f3荐惹吾茯\fP
176.971 .RS 3
176.972
176.973 .LP
176.974 .RS 3
176.975 .TP 3
176.976 -公開鍵
176.977 -公開鍵は、特定のエンティティに関連付けられた数です。公開鍵は、該当するエンティティとの間に信頼できる関係を持つ必要があるすべての人に対して公開することを意図したものです。公開鍵は、署名を検証するのに使われます。
176.978 +
176.979 +泣劫潟cc若∫d違с 泣荅峨潟cc若篆♂若с≫ゅ荀鴻篋冴絲障潟с泣臀峨罎荐若篏帥障
176.980 .TP 3
176.981 -デジタル署名
176.982 -データが「デジタル署名」されると、そのデータは、エンティティの「アイデンティティ」と、そのエンティティがデータの内容について知っていることを証明する署名とともに格納されます。エンティティの非公開鍵を使ってデータに署名を付けると、データの偽造は不可能になります。
176.983 +吾帥臀峨
176.984 +若帥\f2吾帥臀峨\fP若帥潟cc若≪ゃ潟cc若潟cc若若帥絎鴻ゃャc荐惹臀峨主障潟cc若泣篏帥c若帥臀峨篁若帥初筝純障
176.985 .TP 3
176.986 -アイデンティティ
176.987 -エンティティを特定するための既知の方法です。システムによっては、公開鍵をアイデンティティにするものがあります。公開鍵のほかにも、Unix UID や電子メールアドレス、X.509 識別名など、さまざまなものをアイデンティティとすることができます。
176.988 +≪ゃ潟cc
176.989 +潟cc若劫∝ャ号с激鴻c泣≪ゃ潟cc若障 泣祉Unix UID 糸<若≪鴻X.509 茘ュ障障≪ゃ潟cc若с障
176.990 .TP 3
176.991 -署名
176.992 -署名は、何らかのデータを基にエンティティ (署名者。 証明書に関しては発行者とも呼ばれる) の非公開鍵を使って計算されます。
176.993 +臀峨
176.994 +臀峨若帥冴潟cc (臀峨 荐惹吾≪肴若違) 泣篏帥c荐膊障
176.995 .TP 3
176.996 -非公開鍵
176.997 -非公開鍵は特定のエンティティだけが知っている数のことで、この数のことを、そのエンティティの非公開鍵といいます。非公開鍵は、ほかに知られないように秘密にしておくことが前提になっています。非公開鍵と公開鍵は、すべての公開鍵暗号化システムで対になって存在しています。DSA などの典型的な公開鍵暗号化システムの場合、1 つの非公開鍵は正確に 1 つの公開鍵に対応します。非公開鍵は、署名を計算するのに使われます。
176.998 +
176.999 +泣劫潟cc若ャc違с違潟cc若泣障泣祉ャ腱絲c障 泣泣鴻究垸激鴻у障c絖障DSA 後究垸激鴻翫1 ゃ泣罩g∈ 1 ゃ泣絲上障泣臀峨荐膊篏帥障
176.1000 .TP 3
176.1001 -エンティティ
176.1002 -エンテンティは、人、組織、プログラム、コンピュータ、企業、銀行など、一定の度合いで信頼の対象となるさまざまなものを指します。
176.1003 +潟cc
176.1004 +潟潟c若篋冴腟膵違潟潟ャ若帥篌罐茵筝絎綺т拭若絲乗院障障障
176.1005 .RE
176.1006
176.1007 .LP
176.1008 .LP
176.1009 -公開鍵暗号化では、その性質上、ユーザの公開鍵にアクセスする必要があります。大規模なネットワーク環境では、互いに通信しているエンティティ間で以前の関係が引き続き確立されていると仮定したり、使われているすべての公開鍵を収めた信頼できるリポジトリが存在すると仮定したりすることは不可能です。このような公開鍵の配布に関する問題を解決するために証明書が考案されました。現在では、「認証局 (CA)」が信頼できる第三者として機能します。CA は、ほかのエンティティの証明書に署名する (発行する) 行為を、信頼して任されているエンティティ (企業など) です。CA は法律上の契約に拘束されるので、有効かつ信頼できる証明書だけを作成するものとして扱われます。
176.1010 +究垸сц蟹筝若吟若泣≪祉鴻綽荀障紊ц閞<若医с篋篆<潟cc守т札≫綣膓腆榊篁絎篏帥鴻泣篆♂若с吾絖篁絎筝純с泣絽≪馹茹f浦荐惹吾罅障憜с荐惹悟肴絮 (CA)篆♂若с膃筝罘純障CA 祉潟cc若荐惹吾臀峨 (肴) 茵冴篆♂若篁祉潟cc (篌罐) сCA 羈緇筝絅膣с鴻や拭若с荐惹吾篏宴障
176.1011 .na
176.1012 -\f2VeriSign\fP
176.1013 +\f2VeriSign\fP @
176.1014 .fi
176.1015 -(http://www.verisign.com/)、
176.1016 +http://www.verisign.com/
176.1017 .na
176.1018 -\f2Thawte\fP
176.1019 +\f2Thawte\fP @
176.1020 .fi
176.1021 -(http://www.thawte.com/)、
176.1022 +http://www.thawte.com/
176.1023 .na
176.1024 -\f2Entrust\fP
176.1025 +\f2Entrust\fP @
176.1026 .fi
176.1027 -(http://www.entrust.com/) をはじめ、多くの CA が存在します。
176.1028 -Netscape や Microsoft の認証サーバ、Entrust の CA 製品などを所属組織内で利用すれば、独自の認証局を運営することも可能です。
176.1029 +http://www.entrust.com/ 紊 CA 絖障Netscape Microsoft 茯荐若泣若若Entrust CA 茖遵絮腟膵у違荐惹悟肴絮吟純с
176.1030 .LP
176.1031 .LP
176.1032 -\f3keytool\fP を使うと、証明書の表示、インポート、およびエクスポートを行うことができます。また、自己署名証明書を生成することもできます。
176.1033 +\f3keytool\fP 篏帥荐惹吾茵腓冴ゃ潟若潟鴻若茵с障障綏援讐荐惹吾с障
176.1034 .LP
176.1035 .LP
176.1036 -現在、\f3keytool\fP は X.509 証明書を対象にしています。
176.1037 +憜\f3keytool\fP X.509 荐惹吾絲乗院障
176.1038 .LP
176.1039 .RE
176.1040 .TP 2
176.1041 o
176.1042 -\f3X.509 証明書\fP
176.1043 +\f3X.509 荐惹\fP
176.1044 .RS 3
176.1045 -X.509 規格では、証明書に含める情報が定義されており、この情報を証明書に書き込む方法 (データ形式) についても記述されています。証明書のすべてのデータは、ASN.1/DER と呼ばれる 2 つの関連規格を使って符号化されます。\f2Abstract Syntax Notation 1\fP はデータについて記述しています。\f2Definite Encoding Rules\fP は、データの保存および転送の方法について記述しています。
176.1046 +X.509 荀若с荐惹吾宴絎臂宴荐惹吾吾莨若号 (若水就綣) ゃ荐菴違障荐惹吾鴻若帥ASN.1/DER 若違 2 ゃ∫h若篏帥c膃垸障\f2Abstract Syntax Notation 1\fP 若帥ゃ荐菴違障\f2Definite Encoding Rules\fP 若帥篆絖活拶号ゃ荐菴違障
176.1047 .LP
176.1048 -すべての X.509 証明書は、署名のほかに次のデータを含んでいます。
176.1049 +鴻 X.509 荐惹吾臀峨祉罨<若帥с障
176.1050 .LP
176.1051 .RS 3
176.1052 .TP 3
176.1053 -バージョン
176.1054 -証明書に適用される X.509 規格のバージョンを特定します。証明書に指定できる情報は、バージョンによって異なります。これまでに、3 つのバージョンが定義されています。\f3keytool\fP では、v1、v2、および v3 の証明書のインポートとエクスポートが可能です。
176.1055 -\f3keytool\fP が生成するのは、v3 の証明書です。
176.1056 +若吾с
176.1057 +荐惹吾 X.509 荀若若吾с潟劫障 荐惹吾絎с宴若吾с潟c違障障с3 ゃ若吾с潟絎臂障\f3keytool\fP сv1v2 v3 荐惹吾ゃ潟若鴻若純сkeytool v3 荐惹吾с
176.1058 .LP
176.1059 -「\f2X.509 Version 1\fP」は、1988 年から利用されて広く普及しており、もっとも一般的です。
176.1060 +X.509 Version 11988 綛眼綺c筝с
176.1061 .LP
176.1062 -「\f2X.509 Version 2\fP」では、Subject や発行者の名前をあとで再利用できるようにするために、Subject と発行者の一意識別子の概念が導入されました。ほとんどの証明書プロファイル文書では、名前を再使用しないことと、証明書で一意な識別子を使わないことが、強く推奨されています。Version 2 の証明書は、広くは使われていません。
176.1063 +X.509 Version 2сSubject 肴усSubject 肴筝顑ュ网綽泣絨ャ障祉荐惹吾<ゃ吾с篏睡荐惹吾т茘ュ篏帥綣激ィ絅障Version 2 荐惹吾綺篏帥障
176.1064 .LP
176.1065 -「\f2X.509 Version 3\fP」はもっとも新しい (1996 年) 規格で、エクステンションの概念をサポートしています。エクステンションは誰でも定義することができ、証明書に含めることができます。現在使われている一般的なエクステンションとしては、\f2KeyUsage\fP (「署名専用」など、鍵の使用を特定の目的に制限する)、\f2AlternativeNames\fP (DNS 名、電子メールアドレス、IP アドレスなど、ほかのアイデンティティを公開鍵に関連付けることができる) などがあります。エクステンションには、\f2critical\fP というマークを付けて、そのエクステンションのチェックと使用を義務づけることができます。たとえば、critical とマークされ、KeyCertSign が設定された KeyUsage エクステンションが証明書に含まれている場合、この証明書を SSL 通信中に提示すると、証明書が拒否されます。これは、証明書のエクステンションによって、関連する非公開鍵が証明書の署名専用として指定されており、SSL では使用できないためです。
176.1066 +X.509 Version 3c違 (1996 綛) 荀若с鴻潟激с潟网綽泣泣若障鴻潟激с潟茯違с絎臂с荐惹吾с障憜篏帥筝鴻潟激с潟KeyUsage (臀峨絨泣篏睡劫狗)AlternativeNames (DNS 糸<若≪鴻IP ≪鴻祉≪ゃ潟cc若泣∫dс) 障鴻潟激с潟critical 若篁鴻潟激с潟с篏睡臂ャс障違critical 若KeyCertSign 荐絎 KeyUsage 鴻潟激с潟荐惹吾障翫荐惹吾 SSL 篆>賢腓冴荐惹吾障 荐惹吾鴻潟激с潟c∫c泣荐惹吾臀峨絨絎SSL с篏睡сс
176.1067 .TP 3
176.1068 -シリアル番号
176.1069 -証明書を作成したエンティティは、そのエンティティが発行するほかの証明書と区別するために、証明書にシリアル番号を割り当てます。この情報は、さまざまな方法で使われます。たとえば、証明書が取り消されると、シリアル番号が証明書の取り消しリスト (CRL) に格納されます。
176.1070 +激≪
176.1071 +荐惹吾篏潟cc若潟cc若肴祉荐惹吾阪ャ荐惹吾激≪垩蚊綵障宴障障号т戎障 違荐惹吾羔激≪垩荐惹吾羔鴻 (CRL) 主障
176.1072 .TP 3
176.1073 -署名アルゴリズム識別子
176.1074 -証明書に署名を付けるときに CA が使ったアルゴリズムを特定します。
176.1075 +臀峨≪眼冴茘ュ
176.1076 +荐惹吾臀峨篁 CA 篏帥c≪眼冴劫障
176.1077 .TP 3
176.1078 -発行者名
176.1079 -証明書に署名を付けたエンティティの X.500 識別名です。エンティティは、通常は CA です。この証明書を使うことは、証明書に署名を付けたエンティティを信頼することを意味します。「ルート」つまり「トップレベル」の CA の証明書など、場合によっては発行者が自身の証明書に署名を付けることがある点に注意してください。
176.1080 +肴
176.1081 +荐惹吾臀峨篁潟cc若 X.500 茘ュс潟cc若絽吾 CA с荐惹吾篏帥荐惹吾臀峨篁潟cc若篆♂若潟障若ゃ障 CA 荐惹吾翫c肴荳荐惹吾臀峨篁鴻羈
176.1082 .TP 3
176.1083 -有効期間
176.1084 -各証明書は、限られた期間だけ有効になります。この期間は開始の日時と終了の日時によって指定され、数秒の短い期間から 100 年という長期にわたることもあります。選択される有効期間は、証明書への署名に使われる非公開鍵の強度や証明書に支払う金額など、さまざまな要因で異なります。有効期間は、使用する非公開鍵が損なわれない場合に、エンティティが公開鍵を信頼できると期待される期間です。
176.1085 +号
176.1086 +荐惹吾鴻障紮ユ腟篋ユc絎亥 100 綛眼傑障御号荐惹吾吾臀峨篏帥泣綣桁墾荐惹吾蕁障障荀х違障号篏睡泣翫潟cc若泣篆♂若с緇с
176.1087 .TP 3
176.1088 -Subject 名
176.1089 -証明書で公開鍵が識別されているエンティティの名前です。この名前は X.500 標準を使うので、インターネット全体で一意なものと想定されます。これは、エンティティの X.500 識別名 (DN) です。 次に例を示します。
176.1090 +Subject
176.1091 +荐惹吾у泣茘ャ潟cc若с X.500 罔羣篏帥сゃ潟帥若篏т喝障潟cc若 X.500 茘ュ (DN) с 罨<箴腓冴障
176.1092 .nf
176.1093 \f3
176.1094 .fl
176.1095 @@ -947,56 +917,56 @@
176.1096 .fl
176.1097 \fP
176.1098 .fi
176.1099 -これらはそれぞれ主体の通称、組織単位、組織、国を表します。
176.1100 +筝私腱違腟膵篏腟膵純茵障
176.1101 .TP 3
176.1102 -Subject の公開鍵情報
176.1103 -名前を付けられたエンティティの公開鍵とアルゴリズム識別子です。アルゴリズム識別子では、公開鍵に対して使われている公開鍵暗号化システムおよび関連する鍵パラメータが指定されています。
176.1104 +Subject 究
176.1105 +篁潟cc若泣≪眼冴茘ュс ≪眼冴茘ュс泣絲障篏帥究垸激鴻渇∫c泣<若帥絎障
176.1106 .RE
176.1107
176.1108 .LP
176.1109 .RE
176.1110 .TP 2
176.1111 o
176.1112 -\f3証明連鎖\fP
176.1113 +\f3荐惹吾с若\fP
176.1114 .RS 3
176.1115 .LP
176.1116 -\f3keytool\fP では、非公開鍵および関連する証明「連鎖」を含むキーストアの「鍵」エントリを作成し、管理することができます。このようなエントリでは、非公開鍵に対応する公開鍵は、連鎖の最初の証明書に含まれています。
176.1117 +\f3keytool\fP с泣渇∫c荐惹吾с若潟若鴻≪泣潟篏膊∞с障潟с泣絲上泣с若潟荐惹吾障障
176.1118 .LP
176.1119 .LP
176.1120 -鍵を初めて作成すると (\-genkeypair コマンドを参照)、「自己署名証明書」という 1 つの要素だけを含む連鎖が開始されます。自己署名証明書は、発行者 (署名者) が主体 (証明書で認証されている公開鍵の持ち主) と同じである証明書のことです。\f2\-genkeypair\fP コマンドを呼び出して新しい公開鍵と非公開鍵のペアを作成すると、公開鍵は常に自己署名証明書でラップされます。
176.1121 +泣篏 (\-genkeypair 潟潟)綏援讐荐惹吾 1 ゃ荀膣с若潟紮障綏援讐荐惹吾肴 (臀峨) 筝私 (荐惹吾ц荐若泣>源) с荐惹吾с\f2\-genkeypair\fP 潟潟若喝冴違泣泣≪篏泣絽吾綏援讐荐惹吾с障
176.1122 .LP
176.1123 .LP
176.1124 -このあと、証明書署名要求 (CSR) が生成されて (\-certreq コマンドを参照)、CSR が認証局 (CA) に送信されると、CA からの応答がインポートされ (\-importcert コマンドを参照)、元の自己署名証明書は証明連鎖によって置き換えられます。連鎖の最後にあるのは、Subject の公開鍵を認証した CA が発行した証明書 (応答) です。連鎖内のその前の証明書は、「CA」の公開鍵を認証する証明書です。
176.1125 +荐惹悟讐荀羆 (CSR) (\-certreq 潟潟)CSR 荐惹悟肴絮 (CA) 篆<CA 綽膈ゃ潟若 (\-importcert 潟潟)綏援讐荐惹吾荐惹吾с若潟c臀障с若潟緇Subject 泣茯荐若 CA 肴荐惹 (綽膈) сс若喝荐惹吾CA泣茯荐若荐惹吾с
176.1126 .LP
176.1127 .LP
176.1128 -CA の公開鍵を認証する証明書は、多くの場合、自己署名証明書 (つまり CA が自身の公開鍵を認証した証明書) であり、これは連鎖の最初の証明書になります。場合によっては、CA が証明書の連鎖を返すこともあります。この場合、連鎖内の最後の証明書 (CA によって署名され、鍵エントリの公開鍵を認証する証明書) に変わりはありませんが、連鎖内のその前の証明書は、CSR の送信先の CA とは「別の」CA によって署名され、CSR の送信先の CA の公開鍵を認証する証明書になります。さらに、連鎖内のその前の証明書は、次の CA の鍵を認証する証明書になります。以下同様に、自己署名された「ルート」証明書に達するまで連鎖が続きます。したがって、連鎖内の (最初の証明書以後の) 各証明書では、連鎖内の次の証明書の署名者の公開鍵が認証されていることになります。
176.1129 +CA 泣茯荐若荐惹吾紊翫綏援讐荐惹 (ゃ障 CA 荳泣茯荐若荐惹) сс若潟荐惹吾障翫cCA 荐惹吾с若潟菴障翫с若喝緇荐惹 (CA c臀峨泣潟泣茯荐若荐惹) 紊障с若喝荐惹吾CSR 篆≦ CA ャCA c臀峨CSR 篆≦ CA 泣茯荐若荐惹吾障с若喝荐惹吾罨< CA 泣茯荐若荐惹吾障 篁ヤ罕綏援讐若荐惹吾障сс若潟膓障cс若喝 (荐惹娯札緇) 荐惹吾сс若喝罨<荐惹吾臀峨泣茯荐若障
176.1130 .LP
176.1131 .LP
176.1132 -多くの CA は、連鎖をサポートせずに発行済みの証明書だけを返します。特に、中間の CA が存在しないフラットな階層構造の場合は、その傾向が顕著です。このような場合は、キーストアにすでに格納されている信頼できる証明書情報から、証明連鎖を確立する必要があります。
176.1133 +紊 CA с若潟泣若肴羝帥荐惹吾菴障 鴻筝 CA 絖絮ゆ翫上蕁с翫若鴻≪с主篆♂若с荐惹御宴荐惹吾с若潟腆榊綽荀障
176.1134 .LP
176.1135 .LP
176.1136 -別の応答形式 (PKCS#7 で定義されている形式) でも、発行済み証明書に加え、証明連鎖のサポートが含まれています。\f3keytool\fP では、どちらの応答形式も扱うことができます。
176.1137 +ャ綽膈綵√ (PKCS#7 у臂綵√) с肴羝粋┝吾荐惹吾с若潟泣若障障\f3keytool\fP с<綽膈綵√宴с障
176.1138 .LP
176.1139 .LP
176.1140 -トップレベル (ルート) CA の証明書は、自己署名証明書です。ただし、ルートの公開鍵に対する信頼は、ルートの証明書自体から導き出されるものではなく (たとえば、VeriSign ルート CA のような有名な識別名を使った自己署名証明書を作成すること自体は誰でも可能)、新聞などのほかの情報源に由来するものです。ルート CA の公開鍵は広く知られています。ルート CA の公開鍵を証明書に格納する理由は、証明書という形式にすることで多くのツールから利用できるようになるからにすぎません。 つまり、証明書は、ルート CA の公開鍵を運ぶ「媒体」として利用されるだけです。ルート CA の証明書をキーストアに追加するときは、その前に証明書の内容を表示し (\f2\-printcert\fP オプションを使用)、表示されたフィンガープリントと、新聞やルート CA の Web ページなどから入手した既知のフィンガープリントとを比較する必要があります。
176.1141 + (若) CA 荐惹吾綏援讐荐惹吾с若泣絲障篆♂若若荐惹梧篏絨冴с (違VeriSign 若 CA 茘ュ篏帥c綏援讐荐惹吾篏篏茯違с)域祉掩掩ャс若 CA 泣綺ャ障若 CA 泣荐惹吾主宴荐惹吾綵√у若с障 ゃ障荐惹吾若 CA 泣吟紵篏с若 CA 荐惹吾若鴻≪菴遵荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 激с潟篏睡)茵腓冴c潟若潟域若 CA Web 若吾ユ∝ャc潟若潟罸莠綽荀障
176.1142 .LP
176.1143 .RE
176.1144 .TP 2
176.1145 o
176.1146 -\f3cacerts 証明書ファイル\fP
176.1147 +\f3cacerts 荐惹吾<ゃ\fP
176.1148 .RS 3
176.1149 .LP
176.1150 -cacerts 証明書ファイルは、セキュリティプロパティディレクトリ \f2java.home\fP/lib/security に置かれています。\f2java.home\fP は、実行環境のディレクトリ (SDK の \f2jre\fP ディレクトリまたは Java 2 Runtime Environment の最上位ディレクトリ) です。
176.1151 +\f3cacerts\fP 荐惹吾<ゃ祉ャc若c若c \f2java.home\fP/lib/security 臀障 \f2java.home\fP 絎茵医c (SDK \f2jre\fP c障 Java 2 Runtime Environment 筝篏c) с
176.1152 .LP
176.1153 .LP
176.1154 -cacerts ファイルは、CA の証明書を含む、システム全体のキーストアです。システム管理者は、キーストアタイプに jks を指定することで、\f3keytool\fP を使ってこのファイルの構成と管理を行うことができます。cacerts キーストアファイルは、次の別名および X.500 所有者識別名を持ついくつかのルート CA 証明書を含んだ状態で出荷されています。
176.1155 +cacerts <ゃCA 荐惹吾激鴻篏若鴻≪с激鴻膊∞若鴻≪帥ゃ jks 絎с\f3keytool\fP 篏帥c<ゃ罕膊∞茵с障cacerts 若鴻≪<ゃ罨<ュ X.500 茘ュゃゃ若 CA 荐惹吾倶у肴激障
176.1156 .LP
176.1157 .RS 3
176.1158 .TP 2
176.1159 *
176.1160 -\f3Alias\fP: thawtepersonalfreemailca
176.1161 +\f3Alias\fP:thawtepersonalfreemailca
176.1162 .br
176.1163 -\f3Owner DN\fP: EmailAddress=personal\-freemail@thawte.com,
176.1164 +\f3Owner DN\fP:EmailAddress=personal\-freemail@thawte.com,
176.1165 .br
176.1166 CN=Thawte Personal Freemail CA,
176.1167 .br
176.1168 @@ -1005,9 +975,9 @@
176.1169 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
176.1170 .TP 2
176.1171 *
176.1172 -\f3Alias\fP: thawtepersonalbasicca
176.1173 +\f3Alias\fP:thawtepersonalbasicca
176.1174 .br
176.1175 -\f3Owner DN\fP: EmailAddress=personal\-basic@thawte.com,
176.1176 +\f3Owner DN\fP:EmailAddress=personal\-basic@thawte.com,
176.1177 .br
176.1178 CN=Thawte Personal Basic CA,
176.1179 .br
176.1180 @@ -1016,8 +986,9 @@
176.1181 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
176.1182 .TP 2
176.1183 *
176.1184 +\f3Alias\fP:thawtepersonalpremiumca
176.1185 .br
176.1186 -\f3Owner DN\fP: EmailAddress=personal\-premium@thawte.com,
176.1187 +\f3Owner DN\fP:EmailAddress=personal\-premium@thawte.com,
176.1188 .br
176.1189 CN=Thawte Personal Premium CA,
176.1190 .br
176.1191 @@ -1026,18 +997,18 @@
176.1192 O=Thawte Consulting, L=Cape Town, ST=Western Cape, C=ZA
176.1193 .TP 2
176.1194 *
176.1195 -\f3Alias\fP: thawteserverca
176.1196 +\f3Alias\fP:thawteserverca
176.1197 .br
176.1198 -\f3Owner DN\fP: EmailAddress=server\-certs@thawte.com,
176.1199 +\f3Owner DN\fP:EmailAddress=server\-certs@thawte.com,
176.1200 .br
176.1201 CN=Thawte Server CA, OU=Certification Services Division,
176.1202 .br
176.1203 O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
176.1204 .TP 2
176.1205 *
176.1206 -\f3Alias\fP: thawtepremiumserverca
176.1207 +\f3Alias\fP:thawtepremiumserverca
176.1208 .br
176.1209 -\f3Owner DN\fP: EmailAddress=premium\-server@thawte.com,
176.1210 +\f3Owner DN\fP:EmailAddress=premium\-server@thawte.com,
176.1211 .br
176.1212 CN=Thawte Premium Server CA,
176.1213 .br
176.1214 @@ -1046,37 +1017,37 @@
176.1215 O=Thawte Consulting cc, L=Cape Town, ST=Western Cape, C=ZA
176.1216 .TP 2
176.1217 *
176.1218 -\f3Alias\fP: verisignclass1ca
176.1219 +\f3Alias\fP:verisignclass1ca
176.1220 .br
176.1221 -\f3Owner DN\fP: OU=Class 1 Public Primary Certification Authority,
176.1222 +\f3Owner DN\fP:OU=Class 1 Public Primary Certification Authority,
176.1223 .br
176.1224 O="VeriSign, Inc.", C=US
176.1225 .TP 2
176.1226 *
176.1227 -\f3Alias\fP: verisignclass2ca
176.1228 +\f3Alias\fP:verisignclass2ca
176.1229 .br
176.1230 -\f3Owner DN\fP: OU=Class 2 Public Primary Certification Authority,
176.1231 +\f3Owner DN\fP:OU=Class 2 Public Primary Certification Authority,
176.1232 .br
176.1233 O="VeriSign, Inc.", C=US
176.1234 .TP 2
176.1235 *
176.1236 -\f3Alias\fP: verisignclass3ca
176.1237 +\f3Alias\fP:verisignclass3ca
176.1238 .br
176.1239 -\f3Owner DN\fP: OU=Class 3 Public Primary Certification Authority,
176.1240 +\f3Owner DN\fP:OU=Class 3 Public Primary Certification Authority,
176.1241 .br
176.1242 O="VeriSign, Inc.", C=US
176.1243 .TP 2
176.1244 *
176.1245 -\f3Alias\fP: verisignserverca
176.1246 +\f3Alias\fP:verisignserverca
176.1247 .br
176.1248 -\f3Owner DN\fP: OU=Secure Server Certification Authority,
176.1249 +\f3Owner DN\fP:OU=Secure Server Certification Authority,
176.1250 .br
176.1251 O="RSA Data Security, Inc.", C=US
176.1252 .TP 2
176.1253 *
176.1254 -\f3Alias\fP: verisignclass1g2ca
176.1255 +\f3Alias\fP:verisignclass1g2ca
176.1256 .br
176.1257 -\f3Owner DN\fP: OU=VeriSign Trust Network,
176.1258 +\f3Owner DN\fP:OU=VeriSign Trust Network,
176.1259 .br
176.1260 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
176.1261 .br
176.1262 @@ -1085,18 +1056,18 @@
176.1263 O="VeriSign, Inc.", C=US
176.1264 .TP 2
176.1265 *
176.1266 -\f3Alias\fP: verisignclass1g3ca
176.1267 +\f3Alias\fP:verisignclass1g3ca
176.1268 .br
176.1269 -\f3Owner DN\fP: CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
176.1270 +\f3Owner DN\fP:CN=VeriSign Class 1 Public Primary Certification Authority \- G3, OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
176.1271 .br
176.1272 OU=VeriSign Trust Network,
176.1273 .br
176.1274 O="VeriSign, Inc.", C=US
176.1275 .TP 2
176.1276 *
176.1277 -\f3Alias\fP: verisignclass2g2ca
176.1278 +\f3Alias\fP:verisignclass2g2ca
176.1279 .br
176.1280 -\f3Owner DN\fP: OU=VeriSign Trust Network,
176.1281 +\f3Owner DN\fP:OU=VeriSign Trust Network,
176.1282 .br
176.1283 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
176.1284 .br
176.1285 @@ -1105,9 +1076,9 @@
176.1286 O="VeriSign, Inc.", C=US
176.1287 .TP 2
176.1288 *
176.1289 -\f3Alias\fP: verisignclass2g3ca
176.1290 +\f3Alias\fP:verisignclass2g3ca
176.1291 .br
176.1292 -\f3Owner DN\fP: CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
176.1293 +\f3Owner DN\fP:CN=VeriSign Class 2 Public Primary Certification Authority \- G3,
176.1294 .br
176.1295 OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
176.1296 .br
176.1297 @@ -1116,9 +1087,9 @@
176.1298 O="VeriSign, Inc.", C=US
176.1299 .TP 2
176.1300 *
176.1301 -\f3Alias\fP: verisignclass3g2ca
176.1302 +\f3Alias\fP:verisignclass3g2ca
176.1303 .br
176.1304 -\f3Owner DN\fP: OU=VeriSign Trust Network,
176.1305 +\f3Owner DN\fP:OU=VeriSign Trust Network,
176.1306 .br
176.1307 OU="(c) 1998 VeriSign, Inc. \- For authorized use only",
176.1308 .br
176.1309 @@ -1127,9 +1098,9 @@
176.1310 O="VeriSign, Inc.", C=US
176.1311 .TP 2
176.1312 *
176.1313 -\f3Alias\fP: verisignclass3g3ca
176.1314 +\f3Alias\fP:verisignclass3g3ca
176.1315 .br
176.1316 -\f3Owner DN\fP: CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
176.1317 +\f3Owner DN\fP:CN=VeriSign Class 3 Public Primary Certification Authority \- G3,
176.1318 .br
176.1319 OU="(c) 1999 VeriSign, Inc. \- For authorized use only",
176.1320 .br
176.1321 @@ -1138,44 +1109,37 @@
176.1322 O="VeriSign, Inc.", C=US
176.1323 .TP 2
176.1324 *
176.1325 -\f3Alias\fP: baltimorecodesigningca
176.1326 +\f3Alias\fP:baltimorecodesigningca
176.1327 .br
176.1328 -\f3Owner DN\fP: CN=Baltimore CyberTrust Code Signing Root,
176.1329 +\f3Owner DN\fP:CN=Baltimore CyberTrust Code Signing Root,
176.1330 .br
176.1331 OU=CyberTrust, O=Baltimore, C=IE
176.1332 .TP 2
176.1333 *
176.1334 -\f3Alias\fP: gtecybertrustglobalca
176.1335 +\f3Alias\fP:gtecybertrustglobalca
176.1336 .br
176.1337 -\f3Owner DN\fP: CN=GTE CyberTrust Global Root,
176.1338 +\f3Owner DN\fP:CN=GTE CyberTrust Global Root,
176.1339 .br
176.1340 OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
176.1341 .TP 2
176.1342 *
176.1343 -\f3Alias\fP: baltimorecybertrustca
176.1344 +\f3Alias\fP:baltimorecybertrustca
176.1345 .br
176.1346 -\f3Owner DN\fP: CN=Baltimore CyberTrust Root,
176.1347 +\f3Owner DN\fP:CN=Baltimore CyberTrust Root,
176.1348 .br
176.1349 OU=CyberTrust, O=Baltimore, C=IE
176.1350 .TP 2
176.1351 *
176.1352 -\f3Alias\fP: gtecybertrustca
176.1353 +\f3Alias\fP:gtecybertrust5ca
176.1354 .br
176.1355 -\f3Owner DN\fP: CN=GTE CyberTrust Root,
176.1356 -.br
176.1357 -O=GTE Corporation, C=US
176.1358 -.TP 2
176.1359 -*
176.1360 -\f3Alias\fP: gtecybertrust5ca
176.1361 -.br
176.1362 -\f3Owner DN\fP: CN=GTE CyberTrust Root 5,
176.1363 +\f3Owner DN\fP:CN=GTE CyberTrust Root 5,
176.1364 .br
176.1365 OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
176.1366 .TP 2
176.1367 *
176.1368 -\f3Alias\fP: entrustclientca
176.1369 +\f3Alias\fP:entrustclientca
176.1370 .br
176.1371 -\f3Owner DN\fP: CN=Entrust.net Client Certification Authority,
176.1372 +\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
176.1373 .br
176.1374 OU=(c) 1999 Entrust.net Limited,
176.1375 .br
176.1376 @@ -1184,9 +1148,9 @@
176.1377 O=Entrust.net, C=US
176.1378 .TP 2
176.1379 *
176.1380 -\f3Alias\fP: entrustglobalclientca
176.1381 +\f3Alias\fP:entrustglobalclientca
176.1382 .br
176.1383 -\f3Owner DN\fP: CN=Entrust.net Client Certification Authority,
176.1384 +\f3Owner DN\fP:CN=Entrust.net Client Certification Authority,
176.1385 .br
176.1386 OU=(c) 2000 Entrust.net Limited,
176.1387 .br
176.1388 @@ -1195,9 +1159,9 @@
176.1389 O=Entrust.net
176.1390 .TP 2
176.1391 *
176.1392 -\f3Alias\fP: entrust2048ca
176.1393 +\f3Alias\fP:entrust2048ca
176.1394 .br
176.1395 -\f3Owner DN\fP: CN=Entrust.net Certification Authority (2048),
176.1396 +\f3Owner DN\fP:CN=Entrust.net Certification Authority (2048),
176.1397 .br
176.1398 OU=(c) 1999 Entrust.net Limited,
176.1399 .br
176.1400 @@ -1206,9 +1170,9 @@
176.1401 O=Entrust.net
176.1402 .TP 2
176.1403 *
176.1404 -\f3Alias\fP: entrustsslca
176.1405 +\f3Alias\fP:entrustsslca
176.1406 .br
176.1407 -\f3Owner DN\fP: CN=Entrust.net Secure Server Certification Authority,
176.1408 +\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
176.1409 .br
176.1410 OU=(c) 1999 Entrust.net Limited,
176.1411 .br
176.1412 @@ -1217,9 +1181,9 @@
176.1413 O=Entrust.net, C=US
176.1414 .TP 2
176.1415 *
176.1416 -\f3Alias\fP: entrustgsslca
176.1417 +\f3Alias\fP:entrustgsslca
176.1418 .br
176.1419 -\f3Owner DN\fP: CN=Entrust.net Secure Server Certification Authority,
176.1420 +\f3Owner DN\fP:CN=Entrust.net Secure Server Certification Authority,
176.1421 .br
176.1422 OU=(c) 2000 Entrust.net Limited,
176.1423 .br
176.1424 @@ -1228,23 +1192,23 @@
176.1425 O=Entrust.net
176.1426 .TP 2
176.1427 *
176.1428 -\f3Alias\fP: godaddyclass2ca
176.1429 +\f3Alias\fP:godaddyclass2ca
176.1430 .br
176.1431 -\f3Owner DN\fP: OU=Go Daddy Class 2 Certification Authority,
176.1432 +\f3Owner DN\fP:OU=Go Daddy Class 2 Certification Authority,
176.1433 .br
176.1434 O="The Go Daddy Group, Inc.", C=US
176.1435 .TP 2
176.1436 *
176.1437 -\f3Alias\fP: starfieldclass2ca
176.1438 +\f3Alias\fP:starfieldclass2ca
176.1439 .br
176.1440 -\f3Owner DN\fP: OU=Starfield Class 2 Certification Authority,
176.1441 +\f3Owner DN\fP:OU=Starfield Class 2 Certification Authority,
176.1442 .br
176.1443 O="Starfield Technologies, Inc.", C=US
176.1444 .TP 2
176.1445 *
176.1446 -\f3Alias\fP: valicertclass2ca
176.1447 +\f3Alias\fP:valicertclass2ca
176.1448 .br
176.1449 -\f3Owner DN\fP: EMAILADDRESS=info@valicert.com,
176.1450 +\f3Owner DN\fP:EMAILADDRESS=info@valicert.com,
176.1451 .br
176.1452 CN=http://www.valicert.com/,
176.1453 .br
176.1454 @@ -1253,109 +1217,109 @@
176.1455 O="ValiCert, Inc.", L=ValiCert Validation Network
176.1456 .TP 2
176.1457 *
176.1458 -\f3Alias\fP: geotrustglobalca
176.1459 +\f3Alias\fP:geotrustglobalca
176.1460 .br
176.1461 -\f3Owner DN\fP: CN=GeoTrust Global CA,
176.1462 +\f3Owner DN\fP:CN=GeoTrust Global CA,
176.1463 .br
176.1464 O=GeoTrust Inc., C=US
176.1465 .TP 2
176.1466 *
176.1467 -\f3Alias\fP: equifaxsecureca
176.1468 +\f3Alias\fP:equifaxsecureca
176.1469 .br
176.1470 -\f3Owner DN\fP: OU=Equifax Secure Certificate Authority,
176.1471 +\f3Owner DN\fP:OU=Equifax Secure Certificate Authority,
176.1472 .br
176.1473 O=Equifax, C=US
176.1474 .TP 2
176.1475 *
176.1476 -\f3Alias\fP: equifaxsecureebusinessca1
176.1477 +\f3Alias\fP:equifaxsecureebusinessca1
176.1478 .br
176.1479 -\f3Owner DN\fP: CN=Equifax Secure eBusiness CA\-1,
176.1480 +\f3Owner DN\fP:CN=Equifax Secure eBusiness CA\-1,
176.1481 .br
176.1482 O=Equifax Secure Inc., C=US
176.1483 .TP 2
176.1484 *
176.1485 -\f3Alias\fP: equifaxsecureebusinessca2
176.1486 +\f3Alias\fP:equifaxsecureebusinessca2
176.1487 .br
176.1488 -\f3Owner DN\fP: OU=Equifax Secure eBusiness CA\-2,
176.1489 +\f3Owner DN\fP:OU=Equifax Secure eBusiness CA\-2,
176.1490 .br
176.1491 O=Equifax Secure, C=US
176.1492 .TP 2
176.1493 *
176.1494 -\f3Alias\fP: equifaxsecureglobalebusinessca1
176.1495 +\f3Alias\fP:equifaxsecureglobalebusinessca1
176.1496 .br
176.1497 -\f3Owner DN\fP: CN=Equifax Secure Global eBusiness CA\-1,
176.1498 +\f3Owner DN\fP:CN=Equifax Secure Global eBusiness CA\-1,
176.1499 .br
176.1500 O=Equifax Secure Inc., C=US
176.1501 .TP 2
176.1502 *
176.1503 -\f3Alias\fP: soneraclass1ca
176.1504 +\f3Alias\fP:soneraclass1ca
176.1505 .br
176.1506 -\f3Owner DN\fP: CN=Sonera Class1 CA, O=Sonera, C=FI
176.1507 +\f3Owner DN\fP:CN=Sonera Class1 CA, O=Sonera, C=FI
176.1508 .TP 2
176.1509 *
176.1510 -\f3Alias\fP: soneraclass2ca
176.1511 +\f3Alias\fP:soneraclass2ca
176.1512 .br
176.1513 -\f3Owner DN\fP: CN=Sonera Class2 CA, O=Sonera, C=FI
176.1514 +\f3Owner DN\fP:CN=Sonera Class2 CA, O=Sonera, C=FI
176.1515 .TP 2
176.1516 *
176.1517 -\f3Alias\fP: comodoaaaca
176.1518 +\f3Alias\fP:comodoaaaca
176.1519 .br
176.1520 -\f3Owner DN\fP: CN=AAA Certificate Services,
176.1521 +\f3Owner DN\fP:CN=AAA Certificate Services,
176.1522 .br
176.1523 O=Comodo CA Limited, L=Salford, ST=Greater Manchester, C=GB
176.1524 .TP 2
176.1525 *
176.1526 -\f3Alias\fP: addtrustclass1ca
176.1527 +\f3Alias\fP:addtrustclass1ca
176.1528 .br
176.1529 -\f3Owner DN\fP: CN=AddTrust Class 1 CA Root,
176.1530 +\f3Owner DN\fP:CN=AddTrust Class 1 CA Root,
176.1531 .br
176.1532 OU=AddTrust TTP Network, O=AddTrust AB, C=SE
176.1533 .TP 2
176.1534 *
176.1535 -\f3Alias\fP: addtrustexternalca
176.1536 +\f3Alias\fP:addtrustexternalca
176.1537 .br
176.1538 -\f3Owner DN\fP: CN=AddTrust External CA Root,
176.1539 +\f3Owner DN\fP:CN=AddTrust External CA Root,
176.1540 .br
176.1541 OU=AddTrust External TTP Network, O=AddTrust AB, C=SE
176.1542 .TP 2
176.1543 *
176.1544 -\f3Alias\fP: addtrustqualifiedca
176.1545 +\f3Alias\fP:addtrustqualifiedca
176.1546 .br
176.1547 -\f3Owner DN\fP: CN=AddTrust Qualified CA Root,
176.1548 +\f3Owner DN\fP:CN=AddTrust Qualified CA Root,
176.1549 .br
176.1550 OU=AddTrust TTP Network, O=AddTrust AB, C=SE
176.1551 .TP 2
176.1552 *
176.1553 -\f3Alias\fP: utnuserfirsthardwareca
176.1554 +\f3Alias\fP:utnuserfirsthardwareca
176.1555 .br
176.1556 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Hardware,
176.1557 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Hardware,
176.1558 .br
176.1559 OU=http://www.usertrust.com, O=The USERTRUST Network,
176.1560 .br
176.1561 L=Salt Lake City, ST=UT, C=US
176.1562 .TP 2
176.1563 *
176.1564 -\f3Alias\fP: utnuserfirstclientauthemailca
176.1565 +\f3Alias\fP:utnuserfirstclientauthemailca
176.1566 .br
176.1567 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Client Authentication and Email,
176.1568 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Client Authentication and Email,
176.1569 .br
176.1570 OU=http://www.usertrust.com, O=The USERTRUST Network,
176.1571 .br
176.1572 L=Salt Lake City, ST=UT, C=US
176.1573 .TP 2
176.1574 *
176.1575 -\f3Alias\fP: utndatacorpsgcca
176.1576 +\f3Alias\fP:utndatacorpsgcca
176.1577 .br
176.1578 -\f3Owner DN\fP: CN=UTN \- DATACorp SGC,
176.1579 +\f3Owner DN\fP:CN=UTN \- DATACorp SGC,
176.1580 .br
176.1581 OU=http://www.usertrust.com, O=The USERTRUST Network,
176.1582 .br
176.1583 L=Salt Lake City, ST=UT, C=US
176.1584 .TP 2
176.1585 *
176.1586 -\f3Alias\fP: utnuserfirstobjectca
176.1587 +\f3Alias\fP:utnuserfirstobjectca
176.1588 .br
176.1589 -\f3Owner DN\fP: CN=UTN\-USERFirst\-Object,
176.1590 +\f3Owner DN\fP:CN=UTN\-USERFirst\-Object,
176.1591 .br
176.1592 OU=http://www.usertrust.com, O=The USERTRUST Network,
176.1593 .br
176.1594 @@ -1364,18 +1328,18 @@
176.1595
176.1596 .LP
176.1597 .LP
176.1598 -cacerts キーストアファイルの初期パスワードは、changeit です。システム管理者は、SDK のインストール後、このファイルのパスワードとデフォルトアクセス権を変更する必要があります。
176.1599 +cacerts 若鴻≪<ゃ鴻若changeit с激鴻膊∞SDK ゃ潟鴻若緇<ゃ鴻若≪祉号┤紊眼綽荀障
176.1600 .LP
176.1601 .RS 3
176.1602
176.1603 .LP
176.1604
176.1605 .LP
176.1606 -\f3重要: \fP\f4cacerts\fP\f3 ファイルを確認してください。\fP
176.1607 +\f3荀:\fP\f4cacerts\fP\f3 <ゃ腆肴\fP
176.1608 .br
176.1609
176.1610 .LP
176.1611 -\f2cacerts\fP ファイル内の CA は、署名および他のエンティティへの証明書発行のためのエンティティとして信頼されるため、\f2cacerts\fP ファイルの管理は慎重に行う必要があります。\f2cacerts\fP ファイルには、信頼する CA の証明書だけが含まれていなければなりません。ユーザは、自身の責任において、\f2cacerts\fP ファイルにバンドルされている信頼できるルート CA 証明書を検証し、信頼性に関する独自の決定を行います。信頼できない CA 証明書を \f2cacerts\fP ファイルから削除するには、\f2keytool\fP コマンドの削除オプションを使用します。\f2cacerts\fP ファイルは JRE のインストールディレクトリにあります。このファイルを編集するアクセス権がない場合は、システム管理者に連絡してください。
176.1612 +\f2cacerts\fP <ゃ CA 臀峨割潟cc若吾荐惹悟肴潟cc若篆♂若\f2cacerts\fP <ゃ膊∞茵綽荀障\f2cacerts\fP <ゃ篆♂若 CA 荐惹吾障違障若吟若荳莢篁祉\f2cacerts\fP <ゃ潟篆♂若с若 CA 荐惹吾罎荐若篆♂惹с≪羆阪茵障篆♂若с CA 荐惹吾 \f2cacerts\fP <ゃゃ\f2keytool\fP 潟潟ゃ激с潟篏睡障\f2cacerts\fP <ゃ JRE ゃ潟鴻若c障<ゃ膩≪祉号┤翫激鴻膊∞g機
176.1613 .br
176.1614
176.1615 .LP
176.1616 @@ -1385,23 +1349,22 @@
176.1617 .RE
176.1618 .TP 2
176.1619 o
176.1620 -\f3インターネット RFC 1421 証明書符号化規格\fP
176.1621 +\f3ゃ潟帥若 RFC 1421 荐惹悟垸荀\fP
176.1622 .RS 3
176.1623 .LP
176.1624 -多くの場合、証明書は、バイナリ符号化ではなく、インターネット RFC 1421 規格で定義されている出力可能符号化方式を使って格納されます。「Base 64 符号化」とも呼ばれるこの証明書形式では、電子メールやその他の機構を通じて、ほかのアプリケーションに証明書を容易にエクスポートできます。
176.1625 +紊翫荐惹吾ゃ膃垸сゃ潟帥若 RFC 1421 荀若у臂阪順垸劫篏帥c主障Base 64 膃垸若違荐惹後就綣с糸<若篁罘罕祉≪宴若激с潟荐惹吾絎号鴻若с障
176.1626 .LP
176.1627 .LP
176.1628 -\f2\-importcert\fP と \f2\-printcert\fP コマンドでは、この形式の証明書とバイナリ符号化の証明書を読み込むことができます。
176.1629 +\f2\-importcert\fP 潟潟 \f2\-printcert\fP 潟潟с綵√荐惹吾ゃ膃垸荐惹吾茯粋昭с障
176.1630 .LP
176.1631 .LP
176.1632 -\f2\-exportcert\fP コマンドでは、デフォルトでバイナリ符号化の証明書が出力されます。
176.1633 -ただし、\f2\-rfc\fP オプションを指定した場合は、出力可能符号化方式の証明書が出力されます。
176.1634 +\f2\-exportcert\fP 潟潟ссゃ膃垸荐惹吾阪障 \f2\-rfc\fP 激с潟絎翫阪順垸劫荐惹吾阪障
176.1635 .LP
176.1636 .LP
176.1637 -\f2\-list\fP コマンドでは、デフォルトで証明書の MD5 フィンガープリントが出力されます。\f2\-v\fP オプションを指定すると、人間が読むことのできる形式で証明書が出力されます。一方、\f2\-rfc\fP オプションを指定すると、出力可能符号化方式で証明書が出力されます。
176.1638 +\f2\-list\fP 潟潟сц┝吾 MD5 c潟若潟阪障\f2\-v\fP 激с潟絎篋咲茯с綵√ц┝吾阪障 筝鴻\f2\-rfc\fP 激с潟絎阪順垸劫ц┝吾阪障
176.1639 .LP
176.1640 .LP
176.1641 -出力可能符号化方式で符号化された証明書は、次の行で始まります。
176.1642 +阪順垸劫х垸荐惹吾罨<茵у障障
176.1643 .LP
176.1644 .nf
176.1645 \f3
176.1646 @@ -1413,7 +1376,7 @@
176.1647
176.1648 .LP
176.1649 .LP
176.1650 -最後は、次の行で終わります。
176.1651 +緇罨<茵х障
176.1652 .LP
176.1653 .nf
176.1654 \f3
176.1655 @@ -1427,36 +1390,36 @@
176.1656
176.1657 .LP
176.1658 .SS
176.1659 -X.500 識別名
176.1660 +X.500 茘ュ
176.1661 .LP
176.1662 .RS 3
176.1663
176.1664 .LP
176.1665 -X.500 識別名は、エンティティを特定するために使われます。 たとえば、X.509 証明書の \f2subject\fP フィールドと \f2issuer\fP (署名者) フィールドで指定される名前は、X.500 識別名です。\f3keytool\fP は、次のサブパートをサポートしています。
176.1666 +X.500 茘ュ潟cc若劫篏帥障 違X.509 荐惹吾 \f2subject\fP c若 \f2issuer\fP (臀峨) c若ф絎X.500 茘ュс \f3keytool\fP 罨<泣若泣若障
176.1667 .RS 3
176.1668 .TP 2
176.1669 o
176.1670 -\f2commonName\fP \- 人の通称。「Susan Jones」など
176.1671 +\f2commonName\fP \- 篋冴腱違 Susan Jones
176.1672 .TP 2
176.1673 o
176.1674 -\f2organizationUnit\fP \- 小さな組織 (部、課など) の名称。「仕入部」など
176.1675 +\f2organizationUnit\fP \- 絨腟膵 (茯蚊) 腱違 篁ラ
176.1676 .TP 2
176.1677 o
176.1678 -\f2organizationName\fP \- 大きな組織の名称。「ABCSystems, Inc.」など
176.1679 +\f2organizationName\fP \- 紊с腟膵腱違 ABCSystems, Inc.
176.1680 .TP 2
176.1681 o
176.1682 -\f2localityName\fP \- 地域 (都市) 名。「Palo Alto」など
176.1683 +\f2localityName\fP \- 医 (遵) Palo Alto
176.1684 .TP 2
176.1685 o
176.1686 -\f2stateName\fP \- 州名または地方名。「California」など
176.1687 +\f2stateName\fP \- 綏障井劫 California
176.1688 .TP 2
176.1689 o
176.1690 -\f2country\fP \- 2 文字の国番号。「CH」など
176.1691 +\f2country\fP \- 2 絖順垩 CH
176.1692 .RE
176.1693
176.1694 .LP
176.1695 .LP
176.1696 -\f2\-genkeypair\fP コマンドの \f2\-dname\fP オプションの値として識別名文字列を指定する場合は、次の形式で指定する必要があります。
176.1697 +\f2\-genkeypair\fP 潟潟 \f2\-dname\fP 激с潟ゃ茘ュ絖絎翫罨<綵√ф絎綽荀障
176.1698 .LP
176.1699 .nf
176.1700 \f3
176.1701 @@ -1468,7 +1431,7 @@
176.1702
176.1703 .LP
176.1704 .LP
176.1705 -イタリック体の項目は、実際に指定する値を表します。短縮形のキーワードの意味は、次のとおりです。
176.1706 +ゃ帥篏絎絎ゃ茵障 膰綵≪若若潟罨<с
176.1707 .LP
176.1708 .nf
176.1709 \f3
176.1710 @@ -1490,7 +1453,7 @@
176.1711
176.1712 .LP
176.1713 .LP
176.1714 -次に示すのは、識別名文字列の例です。
176.1715 +罨<腓冴茘ュ絖箴с
176.1716 .LP
176.1717 .nf
176.1718 \f3
176.1719 @@ -1501,7 +1464,7 @@
176.1720 .fi
176.1721
176.1722 .LP
176.1723 -次は、この文字列を使ったコマンドの例です。
176.1724 +罨<絖篏帥c潟潟箴с
176.1725 .nf
176.1726 \f3
176.1727 .fl
176.1728 @@ -1514,10 +1477,10 @@
176.1729
176.1730 .LP
176.1731 .LP
176.1732 -キーワードの短縮形では、大文字と小文字は区別されません。たとえば、CN、cn、および Cn は、どれも同じものとして扱われます。
176.1733 +若若膰綵≪с紊ф絖絨絖阪ャ障違CNcn Cn 宴障
176.1734 .LP
176.1735 .LP
176.1736 -一方、キーワードの指定順序には意味があり、各サブコンポーネントは上に示した順序で指定する必要があります。ただし、サブコンポーネントをすべて指定する必要はありません。たとえば、次のように一部のサブコンポーネントだけを指定できます。
176.1737 +筝鴻若若絎綺潟泣潟潟若潟筝腓冴綺ф絎綽荀障泣潟潟若潟鴻絎綽荀障違罨<筝泣潟潟若潟絎с障
176.1738 .LP
176.1739 .nf
176.1740 \f3
176.1741 @@ -1529,7 +1492,7 @@
176.1742
176.1743 .LP
176.1744 .LP
176.1745 -識別名文字列の値にコンマが含まれる場合に、コマンド行の文字列を指定するときには、次のようにコンマを文字 \\ でエスケープする必要があります。
176.1746 +茘ュ絖ゃ潟潟障翫潟潟茵ф絖絎罨<潟潟絖 \\ с鴻宴若綽荀障
176.1747 .LP
176.1748 .nf
176.1749 \f3
176.1750 @@ -1541,19 +1504,18 @@
176.1751
176.1752 .LP
176.1753 .LP
176.1754 -識別名文字列をコマンド行で指定する必要はありません。識別名を必要とするコマンドを実行するときに、コマンド行で識別名を指定しなかった場合は、各サブコンポーネントの入力を求められます。この場合は、コンマを文字 \\ でエスケープする必要はありません。
176.1755 +茘ュ絖潟潟茵ф絎綽荀障茘ュ綽荀潟潟絎茵潟潟茵цュ絎c翫泣潟潟若潟ュ羆障翫潟潟絖 \\ с鴻宴若綽荀障
176.1756 .LP
176.1757 .RE
176.1758 .SS
176.1759 -信頼できる証明書のインポートに関する注意事項
176.1760 +篆♂若с荐惹吾ゃ潟若≪羈鋋
176.1761 .LP
176.1762 .RS 3
176.1763
176.1764 .LP
176.1765 -重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。
176.1766 +荀:篆♂若с荐惹吾荐惹吾ゃ潟若荐惹吾絎鴻茯帥鴻
176.1767 .LP
176.1768 -まず、証明書の内容を表示し (\f2\-printcert\fP コマンドを使用するか、または \f2\-noprompt\fP オプションを指定しないで \f2\-importcert\fP コマンドを使用)、表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。
176.1769 -たとえば、あるユーザから証明書が送られてきて、この証明書を \f2/tmp/cert\fP という名前でファイルに格納しているとします。この場合は、信頼できる証明書のリストにこの証明書を追加する前に、\f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
176.1770 +障荐惹吾絎鴻茵腓冴 (\f2\-printcert\fP 潟潟篏睡障 \f2\-noprompt\fP 激с潟絎 \f2\-import\fP 潟潟篏睡)茵腓冴荐惹吾c潟若潟緇c潟若潟筝眼腆肴障違若吟若荐惹吾荐惹吾 \f2/tmp/cert\fP с<ゃ主障翫篆♂若с荐惹吾鴻荐惹吾菴遵\f2\-printcert\fP 潟潟絎茵c潟若潟茵腓冴с障 違罨<障
176.1771 .LP
176.1772 .nf
176.1773 \f3
176.1774 @@ -1578,119 +1540,106 @@
176.1775 .fi
176.1776
176.1777 .LP
176.1778 -次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。
176.1779 +罨<荐惹吾篆<篋榊g機篋榊腓冴c潟若潟筝潟潟ц;腓冴c潟若潟罸莠障c潟若潟筝眼違篆♂筝с祉篏 (紙) 荐惹吾帥茵腆肴с障篆♂筝с腮紙茵翫с茵荐惹吾ゃ潟若紙c臀峨鴻 (紙潟ゃ鴻<ゃ JAR <ゃ) 篆♂若障
176.1780 .LP
176.1781 -注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。
176.1782 -\f2\-importcert\fP コマンドを実行すると、キーストア内の信頼できる証明書のリストに証明書を追加する前に、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\f2\-importcert\fP コマンドを \f2\-noprompt\fP オプションを指定せずに実行した場合だけです。
176.1783 -\f2\-noprompt\fP オプションが指定されている場合、ユーザとの対話は行われません。
176.1784 +羈:荐惹吾ゃ潟若綽 \f2\-printcert\fP 潟潟絎茵違с障 若鴻√篆♂若с荐惹吾鴻荐惹吾菴遵 \f2\-importcert\fP 潟潟絎茵荐惹吾宴茵腓冴腆肴羆<祉若吾茵腓冴障ゃ潟若篏鴻т賢罩≪с障腆肴<祉若吾茵腓冴\f2\-importcert\fP 潟潟 \f2\-noprompt\fP 激с潟絎絎茵翫с\f2\-noprompt\fP 激с潟絎翫若吟若絲乗宴茵障
176.1785 .LP
176.1786 .RE
176.1787 .SS
176.1788 -パスワードに関する注意事項
176.1789 +鴻若≪羈鋋
176.1790 .LP
176.1791 .RS 3
176.1792
176.1793 .LP
176.1794 .LP
176.1795 -キーストアに対する操作を行うほとんどのコマンドでは、ストアのパスワードが必要です。
176.1796 -また、一部のコマンドでは、非公開/秘密鍵のパスワードが必要になることがあります。
176.1797 +若鴻≪絲障篏茵祉潟潟с鴻≪鴻若綽荀с障筝潟潟с/腱絲泣鴻若綽荀障
176.1798 .LP
176.1799 .LP
176.1800 -パスワードはコマンド行で指定できます (ストアのパスワードには \f2\-storepass\fP オプション、非公開鍵のパスワードには \f2\-keypass\fP オプションを使用)。ただし、テストを目的とする場合、または安全であることがわかっているシステムで実行する場合以外は、コマンド行やスクリプトでパスワードを指定しないでください。
176.1801 +鴻若潟潟茵ф絎с障 (鴻≪鴻若 \f2\-storepass\fP 激с潟泣鴻若 \f2\-keypass\fP 激с潟篏睡)鴻翫障絎сc激鴻у茵翫篁ュ潟潟茵鴻с鴻若絎с
176.1802 .LP
176.1803 .LP
176.1804 -必要なパスワードのオプションをコマンド行で指定しなかった場合は、パスワードの入力を求められます。
176.1805 +綽荀鴻若激с潟潟潟茵ф絎c翫鴻若ュ羆障
176.1806 .LP
176.1807 .RE
176.1808 -.SH "関連項目"
176.1809 +.SH "∫i"
176.1810 .LP
176.1811
176.1812 .LP
176.1813 .RS 3
176.1814 .TP 2
176.1815 o
176.1816 -.fi
176.1817 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jar.html
176.1818 -の
176.1819 -.na
176.1820 -「\f2jar\fP」ツールのドキュメント
176.1821 +.LP
176.1822 +jar(1) 若ャ<潟
176.1823 .TP 2
176.1824 o
176.1825 -.fi
176.1826 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html
176.1827 -の
176.1828 -.na
176.1829 -「\f2jarsigner\fP」ツールのドキュメント
176.1830 +.LP
176.1831 +jarsigner(1) 若ャ<潟
176.1832 .TP 2
176.1833 o
176.1834 -\f3keytool\fP の使用例については、
176.1835 +.LP
176.1836 +\f3keytool\fP 篏睡箴ゃ
176.1837 +.na
176.1838 +\f4Java Tutorial\fP @
176.1839 .fi
176.1840 -http://java.sun.com/docs/books/tutorial/security/index.html
176.1841 -の
176.1842 +http://java.sun.com/docs/books/tutorial
176.1843 .na
176.1844 -「\f4Java Tutorial\fP」にある
176.1845 +\f4Security\fP @
176.1846 .fi
176.1847 -http://java.sun.com/docs/books/tutorial/trailmap.html
176.1848 -の
176.1849 -.na
176.1850 -「\f4Security\fP」トレール
176.1851 +http://java.sun.com/docs/books/tutorial/security/index.html
176.1852 .RE
176.1853
176.1854 .LP
176.1855 -.SH "変更点"
176.1856 +.SH "紊雁"
176.1857 .LP
176.1858
176.1859 .LP
176.1860 .LP
176.1861 -Java SE 6 で keytool のコマンドインタフェースが変更されました。
176.1862 +Java SE 6 keytool 潟潟ゃ潟帥с若鴻紊眼障
176.1863 .LP
176.1864 .LP
176.1865 -\f3keytool\fP は、ユーザがパスワードを入力する際にその入力内容を表示しなくなりました。ユーザはパスワード入力時にその入力内容を確認できなくなったため、初期キーストアパスワードを設定したり鍵パスワードを変更したりするなど、パスワードの設定や変更を行うたびにパスワードの再入力を求められます。
176.1866 +\f3keytool\fP 若吟若鴻若ュュ絎鴻茵腓冴障若吟若鴻若ュュ絎鴻腆肴сc若鴻≪鴻若荐絎泣鴻若紊眼鴻若荐絎紊眼茵潟鴻若ュ羆障
176.1867 .LP
176.1868 .LP
176.1869 -変更されたコマンドの中には、名前が変更されただけのものもあれば、廃止されてこのドキュメントに記載されなくなったものもあります。以前のすべてのコマンド (名前が変更されたものと廃止されたものの両方) は、このリリースでも引き続きサポートされており、今後のリリースでもサポートされる予定です。keytool のコマンドインタフェースに加えられたすべての変更点の概要を、次に示します。
176.1870 +紊眼潟潟筝紊眼違綮罩≪ャ<潟荐莠c障篁ュ鴻潟潟 (紊眼綮罩≪筝≧) 若鴻с綣膓泣若篁緇若鴻с泣若篋絎сkeytool 潟潟ゃ潟帥с若鴻鴻紊雁鴻网荀罨<腓冴障
176.1871 .LP
176.1872 .LP
176.1873 -名前が変更されたコマンド:
176.1874 +紊眼潟潟:
176.1875 .LP
176.1876 .RS 3
176.1877 .TP 2
176.1878 o
176.1879 -\f2\-export\fP の名前が \f2\-exportcert\fP に変更
176.1880 +\f2\-export\fP \f2\-exportcert\fP 紊
176.1881 .TP 2
176.1882 o
176.1883 -\f2\-genkey\fP の名前が \f2\-genkeypair\fP に変更
176.1884 +\f2\-genkey\fP \f2\-genkeypair\fP 紊
176.1885 .TP 2
176.1886 o
176.1887 -\f2\-import\fP の名前が \f2\-importcert\fP に変更
176.1888 +\f2\-import\fP \f2\-importcert\fP 紊
176.1889 .RE
176.1890
176.1891 .LP
176.1892 .LP
176.1893 -廃止されてドキュメントに記載されなくなったコマンド:
176.1894 +綮罩≪ャ<潟荐莠c潟潟:
176.1895 .LP
176.1896 .RS 3
176.1897 .TP 2
176.1898 o
176.1899 +.na
176.1900 +\f2\-keyclone\fP @
176.1901 .fi
176.1902 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#keycloneCmd
176.1903 -の
176.1904 -.na
176.1905 -\f2\-keyclone\fP
176.1906 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#keycloneCmd
176.1907 .TP 2
176.1908 o
176.1909 +.na
176.1910 +\f2\-identitydb\fP @
176.1911 .fi
176.1912 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#identitydbCmd
176.1913 -の
176.1914 -.na
176.1915 -\f2\-identitydb\fP
176.1916 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#identitydbCmd
176.1917 .TP 2
176.1918 o
176.1919 +.na
176.1920 +\f2\-selfcert\fP @
176.1921 .fi
176.1922 -http://java.sun.com/j2se/1.5.0/ja/docs/ja/tooldocs/solaris/keytool.html#selfcertCmd
176.1923 -の
176.1924 -.na
176.1925 -\f2\-selfcert\fP
176.1926 +http://java.sun.com/j2se/1.5.0/docs/tooldocs/solaris/keytool.html#selfcertCmd
176.1927 .RE
176.1928
176.1929 .LP
177.1 --- a/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Tue May 12 15:21:55 2009 +0900
177.2 +++ b/src/solaris/doc/sun/man/man1/ja/native2ascii.1 Thu May 14 00:17:25 2009 -0700
177.3 @@ -1,101 +1,83 @@
177.4 -'\" t
177.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
177.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
177.7 -.\"
177.8 -.\" This code is free software; you can redistribute it and/or modify it
177.9 -.\" under the terms of the GNU General Public License version 2 only, as
177.10 -.\" published by the Free Software Foundation.
177.11 -.\"
177.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
177.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
177.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
177.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
177.16 -.\" accompanied this code).
177.17 -.\"
177.18 -.\" You should have received a copy of the GNU General Public License version
177.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
177.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
177.21 -.\"
177.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
177.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
177.24 -.\" have any questions.
177.25 -.\"
177.26 -.TH native2ascii 1 "2004 年 6 月 22 日"
177.27 -.SH "名前"
177.28 -native2ascii \- ネイティブコードから ASCII への変換
177.29 -.\"
177.30 -.\" This document was created by saving an HTML file as text
177.31 -.\" from the JavaSoft web site:
177.32 -.\"
177.33 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
177.34 -.\"
177.35 -.\" and adding appropriate troff macros. Because the JavaSoft web site
177.36 -.\" man pages can change without notice, it may be helpful to diff
177.37 -.\" files to identify changes other than new functionality.
177.38 -.\"
177.39 -.SH "形式"
177.40 -.B native2ascii
177.41 -[
177.42 -.B options
177.43 -]
177.44 -.if n .ti +5n
177.45 -[
177.46 -.IR inputfile " [" outputfile "]]"
177.47 -.SH "機能説明"
177.48 -.IX "native to ASCII converter" "" "native to ASCII converter \(em \fLnative2ascii\fP"
177.49 -.IX "native2ascii" "" "\fLnative2ascii\fP \(em native to ASCII converter"
177.50 -Java コンパイラなどの
177.51 -Java
177.52 -ツールが処理できるファイルは、
177.53 -Latin-1
177.54 -文字もしくは\^
177.55 -Unicode
177.56 -でエンコードされた文字
177.57 -(\\udddd)
177.58 -からなるファイルだけです。
177.59 -.B native2ascii
177.60 -は、他の文字コードのファイルを
177.61 -Latin-1
177.62 -または
177.63 -Unicode
177.64 -エンコーディングのファイルに変換します。
177.65 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
177.66 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
177.67 +."
177.68 +." This code is free software; you can redistribute it and/or modify it
177.69 +." under the terms of the GNU General Public License version 2 only, as
177.70 +." published by the Free Software Foundation.
177.71 +."
177.72 +." This code is distributed in the hope that it will be useful, but WITHOUT
177.73 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
177.74 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
177.75 +." version 2 for more details (a copy is included in the LICENSE file that
177.76 +." accompanied this code).
177.77 +."
177.78 +." You should have received a copy of the GNU General Public License version
177.79 +." 2 along with this work; if not, write to the Free Software Foundation,
177.80 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
177.81 +."
177.82 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
177.83 +." CA 95054 USA or visit www.sun.com if you need additional information or
177.84 +." have any questions.
177.85 +."
177.86 +.TH native2ascii 1 "04 May 2009"
177.87 +." Generated from HTML by html2man (author: Eric Armstrong)
177.88 +
177.89 .LP
177.90 -.I outputfile
177.91 -引数を省略すると、出力先は標準出力となります。
177.92 -また、
177.93 -.I inputfile
177.94 -引数を省略すると、入力元は標準入力となります。
177.95 -.SH "オプション"
177.96 -以下のオプションが使用できます。
177.97 -.TP 5
177.98 -.B \-encoding \f2encoding_name\f1
177.99 -変換処理で用いるエンコーディング名を指定します。
177.100 -デフォルトのエンコーディング名は、システムプロパティの
177.101 -\f3file.encoding\f1
177.102 -から得られます。
177.103 -.I encoding_name
177.104 -文字列は、ドキュメント「サポートされているエンコーディング」の、
177.105 -サポートされるエンコーディングの表で最初の列にある文字列の 1 つでなければ
177.106 -なりません。
177.107 +.SH ""
177.108 +native2ascii \- ゃc \- ASCII 潟潟若
177.109 +.LP
177.110 +.RS 3
177.111 +
177.112 +.LP
177.113 +.LP
177.114 +ゃc潟若 (Latin 1 Unicode 篁ュ) <ゃ Unicode 潟若紊障
177.115 +.LP
177.116 +.RE
177.117 +.SH "綵√"
177.118 +.LP
177.119 +
177.120 +.LP
177.121 +.nf
177.122 +\f3
177.123 +.fl
177.124 +\fP\f4native2ascii\fP\f2 [options] [inputfile [outputfile]]\fP
177.125 +.fl
177.126 +.fi
177.127 +
177.128 +.LP
177.129 +.SH "茯"
177.130 +.LP
177.131 +
177.132 +.LP
177.133 +.LP
177.134 +Java 潟潟ゃ潟篁 Java 若Latin\-1 障 Unicode 潟若 (\\udddd 茵荐) 絖<ゃс障 \f2native2ascii\fP 篁ュ絖潟若<ゃ Latin\-1 障 Unicode 潟若<ゃ紊障
177.135 +.LP
177.136 +.LP
177.137 +\f2outputfile\fP ャ翫罔羣阪阪障\f2inputfile\fP ャ翫罔羣ュュ障
177.138 +.LP
177.139 +.SH "激с"
177.140 +.LP
177.141 +
177.142 +.LP
177.143 +.RS 3
177.144 +.TP 3
177.145 +\-reverse
177.146 +茵障ゃ障Latin\-1 障 Unicode 潟若<ゃゃc潟若紊障
177.147 .br
177.148 -http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
177.149 -.\" http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
177.150 -.TP 5
177.151 -.B \-reverse
177.152 -逆の変換処理を行います。つまり
177.153 -Latin-1
177.154 -または
177.155 -Unicode
177.156 -でエンコーディングされている文字を、ネイティブコードに変換します。
177.157 -.TP 15
177.158 -.BI \-J "option"
177.159 -.I option
177.160 -を Java 仮想マシンに渡します。ここで、
177.161 -.I option
177.162 -は、Java アプリケーション起動プログラム java(1) のマニュアルページで
177.163 -説明されているオプションの 1 つです。たとえば、
177.164 -.I \-J-Xms48m
177.165 -は、起動時に使用するメモリを 48M バイトに設定します。
177.166 -.B \-J
177.167 -が基本となる仮想マシンにオプションを渡すことは、共通の規約です。
177.168 +.br
177.169 +.TP 3
177.170 +\-encoding encoding_name
177.171 +紊т戎潟若絎障潟若激鴻c若 \f2file.encoding\fP 緇障\f2encoding_name\fP 絖
177.172 +.na
177.173 +\f4泣若潟潟若c潟違\fP @
177.174 +.fi
177.175 +http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlャ<潟腓冴泣若潟潟若c潟違茵緇綽荀障
177.176 +.TP 3
177.177 +\-Joption
177.178 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
177.179 +.RE
177.180
177.181 +.LP
177.182 +
177.183 +.LP
177.184 +
178.1 --- a/src/solaris/doc/sun/man/man1/ja/orbd.1 Tue May 12 15:21:55 2009 +0900
178.2 +++ b/src/solaris/doc/sun/man/man1/ja/orbd.1 Thu May 14 00:17:25 2009 -0700
178.3 @@ -1,40 +1,46 @@
178.4 -'\" t
178.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
178.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
178.7 -.\"
178.8 -.\" This code is free software; you can redistribute it and/or modify it
178.9 -.\" under the terms of the GNU General Public License version 2 only, as
178.10 -.\" published by the Free Software Foundation.
178.11 -.\"
178.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
178.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
178.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
178.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
178.16 -.\" accompanied this code).
178.17 -.\"
178.18 -.\" You should have received a copy of the GNU General Public License version
178.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
178.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
178.21 -.\"
178.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
178.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
178.24 -.\" have any questions.
178.25 -.\" `
178.26 -.TH orbd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
178.27 -.SH "名前"
178.28 -orbd - Object Request Broker デーモン
178.29 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
178.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
178.31 +."
178.32 +." This code is free software; you can redistribute it and/or modify it
178.33 +." under the terms of the GNU General Public License version 2 only, as
178.34 +." published by the Free Software Foundation.
178.35 +."
178.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
178.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
178.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
178.39 +." version 2 for more details (a copy is included in the LICENSE file that
178.40 +." accompanied this code).
178.41 +."
178.42 +." You should have received a copy of the GNU General Public License version
178.43 +." 2 along with this work; if not, write to the Free Software Foundation,
178.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
178.45 +."
178.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
178.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
178.48 +." have any questions.
178.49 +."
178.50 +.TH orbd 1 "04 May 2009"
178.51 +." Generated from HTML by html2man (author: Eric Armstrong)
178.52 +
178.53 .LP
178.54 -.B orbd
178.55 -は、クライアントが CORBA 環境内のサーバー上に存在する
178.56 -持続オブジェクトを透過的に特定して呼び出す場合に使用します。
178.57 +.SH ""
178.58 +orbd \- The Object Request Broker Daemon
178.59 .LP
178.60 -\f3関連項目:\fP
178.61 +.RS 3
178.62 +
178.63 +.LP
178.64 +.LP
178.65 +\f3orbd\fP ゃ≪潟 CORBA 医泣若若膓吾с罎膣≪若喝冴篏睡障
178.66 +.LP
178.67 +.LP
178.68 +\f3∫i:\fP
178.69 .na
178.70 -\f2「Naming Service」\fP
178.71 +\f2若泣若\fP @
178.72 .fi
178.73 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
178.74 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
178.75 .LP
178.76 -.SH "形式"
178.77 +.RE
178.78 +.SH "綵√"
178.79 .LP
178.80
178.81 .LP
178.82 @@ -47,86 +53,118 @@
178.83 .fi
178.84
178.85 .LP
178.86 -.SH "機能説明"
178.87 -\f3orbd\fP ツールを含むサーバーマネージャは、クライアントが CORBA 環境内のサーバー上に存在する持続オブジェクトを透過的に特定して呼び出す場合に使用します。持続サーバーは、ネームサービス内の持続オブジェクト参照を発行する一方で、オブジェクト参照内にサーバーのポート番号ではなく ORBD のポート番号を組み込みます。持続オブジェクト参照のためにオブジェクト参照内に ORBD ポート番号を組み込むと、以下の利点が得られます。
178.88 +.SH "茯"
178.89 +.LP
178.90 +
178.91 +.LP
178.92 +.LP
178.93 +\f3orbd\fP 若障泣若若若吾c若篏帥ゃ≪潟 CORBA 医с泣若寂膓吾с罎膣≪若喝冴с障膓泣若若若泣若鴻膓吾сс肴泣若若若垩篁c OBRD 若垩吾сс障膓吾сс吾сс ORBD 若垩罨<鴻障
178.94 .LP
178.95 .RS 3
178.96 .TP 2
178.97 -*
178.98 -ネームサービス内のオブジェクト参照は、サーバーのライフサイクルとは無関係に維持されます。たとえば、オブジェクト参照はサーバーの最初のインストール時にネームサービス内でサーバーによって発行され、その後は何度サーバーの起動または停止が行われても ORBD は常に呼び出し側のクライアントに正しいオブジェクト参照を返します。
178.99 +o
178.100 +若泣若鴻吾сс泣若若ゃ帥ゃ♂≫吾сс紮ゃ潟鴻若若泣若鴻泣若若若泣若鴻肴障緇泣若若紮障激c潟違ORBD ゃс若喝冴ゃ≪潟罩c吾сс菴障
178.101 .TP 2
178.102 -*
178.103 -クライアントはネームサービス内でオブジェクト参照を 1 度確認する必要があり、サーバーのライフサイクルが原因で起きる変更に関係なくこの参照を繰り返し使用できます。
178.104 +o
178.105 +ゃ≪潟筝綺若潟違泣若鴻吾сс≪綽荀緇泣若若ゃ帥ゃ紊眼♂≫сс
178.106 .RE
178.107
178.108 .LP
178.109 .LP
178.110 -ORBD のサーバーマネージャにアクセスするには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2サーバーマネージャ\fPの詳細については、このドキュメントの「サーバーマネージャ」の節を参照してください。
178.111 +ORBD 泣若若若吾c若≪祉鴻servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激c潟茵潟潟茵ゃ潟帥с若鴻с泣若若若吾c若荅括完ゃャ<潟\f2泣若若若吾c若\fPс
178.112 .LP
178.113 .LP
178.114 -\f2orbd\fP の起動時にはネームサービスも起動されます。ネームサービスの詳細については、
178.115 +\f2orbd\fP 莎桁若泣若鴻莎桁障若泣若鴻ゃ
178.116 .na
178.117 -「\f2Naming Service\fP」
178.118 +\f2若泣若鴻\fP @
178.119 .fi
178.120 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
178.121 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
178.122 .LP
178.123 -.SH 必須オプション
178.124 +.SH "激с"
178.125 +.LP
178.126 +.SS
178.127 +綽激с
178.128 +.LP
178.129 +.RS 3
178.130 +.TP 3
178.131 +\-ORBInitialPort nameserverport
178.132 +若泣若若莎桁若垩絎障\f2orbd\fP 莎桁若筝х篆∴羆緇罘障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 (綽)
178.133 +.RE
178.134 +
178.135 +.LP
178.136 .LP
178.137
178.138 .LP
178.139 -.TP 3
178.140 -\-ORBInitialPort nameserverport
178.141 -ネームサーバーを起動するポートを指定します。起動後に \f2orbd\fP はこのポートで着信要求を待機します。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。 (必須)
178.142 -.LP
178.143 -.SH その他のオプション
178.144 -.LP
178.145 -
178.146 -.LP
178.147 -.TP 3
178.148 -\-port port
178.149 -ORBD を開始する起動ポートを指定します。ORBD はこのポートで、持続オブジェクトの要求を受け付けます。このポートのデフォルト値は 1049 です。このポート番号は、持続 Interoperable Object References (IOR) のポートフィールドに追加されます。(省略可能)
178.150 -.TP 3
178.151 -\-defaultdb directory
178.152 -ORBD 持続ストレージディレクトリである \f2orb.db\fP が作成されるベースを指定します。このオプションが指定されない場合、デフォルト値は "./orb.db" です。(省略可能)
178.153 -.TP 3
178.154 -\-serverPollingTime milliseconds
178.155 -\f2servertool\fP 経由で登録された持続サーバーの健全性を ORBD が検査する頻度を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
178.156 -.TP 3
178.157 -\-serverStartupDelay milliseconds
178.158 -\f2servertool\fP 経由で登録された持続サーバーが再起動されてから ORBD がロケーション転送例外を送信するまでの、ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
178.159 -.TP 3
178.160 -\-Joption
178.161 -\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、「\f2Java アプリケーション起動プログラム\fP」
178.162 -.fi
178.163 - (http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP は、起動時に使用するメモリを 48M バイトに設定します。\f3\-J\fP が基本にする仮想マシンにオプションを渡すことは、共通の規約です。
178.164 -.LP
178.165 -.SH ネームサービスの起動と停止
178.166 -.LP
178.167 -.LP
178.168 -ネームサービスは、名前をオブジェクト参照にバインドすることによって、「\f2CORBA objects\fP」
178.169 -.fi
178.170 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object) を指定できるようにする CORBA サービスです。「\f2name binding\fP」
178.171 -.fi
178.172 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding) は、ネーミングサービスに保存できます。クライアントは名前を指定して、目的のオブジェクト参照を取得できます。
178.173 -.LP
178.174 -.LP
178.175 -クライアントまたはサーバーを実行する前に、ORBD を開始します。ORBD には、持続ネーミングサービスと一時ネーミングサービスが含まれています。これらは両方とも COS ネーミングサービスの実装です。
178.176 +.SS
178.177 +篁激с
178.178 .LP
178.179 .RS 3
178.180 -.TP 2
178.181 -*
178.182 -\f4持続\fP\f3ネーミングサービス\fPは、ネーミングコンテキストに持続性を提供します。つまり、この情報はサービスの停止と起動の間で持続し、サービスに障害が発生した場合に回復可能です。ORBD が再起動されると、持続ネーミングサービスはネーミングコンテキストグラフを復元するため、すべてのクライアントとサーバーの名前のバインディングは損傷を受けません (持続する)。
178.183 -.TP 2
178.184 -*
178.185 -以前のバージョンとの互換性のため、\f2tnameserv\fP (以前のバージョンの JDK と一緒に出荷された\f4一時\fP\f3ネーミングサービス\fP) もこのリリースの J2SE に含まれています。一時ネーミングサービスが実行されている限り、ネーミングコンテキストは保持されます。サービスが中断された場合、ネーミングコンテキストグラフは失われます。
178.186 +.TP 3
178.187 +\-port port
178.188 +ORBD 莎桁若絎障 ORBD 若с膓吾с絲障荀羆障若ゃ 1049 с 若垩膓 Interoperable Object References (IOR) 若c若菴遵障(ュ)
178.189 .RE
178.190
178.191 .LP
178.192 +.RS 3
178.193 +.TP 3
178.194 +\-defaultdb directory
178.195 +ORBD 膓主c \f2orb.db\fP 篏若鴻c絎障激с潟絎翫ゃ./orb.db障(ュ)
178.196 +.RE
178.197 +
178.198 .LP
178.199 -\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP に必須のコマンド行引数で、ネーミングサービスが実行されるポート番号の設定に使用されます。以下の説明は、Java\ IDL Object Request Broker Daemon にポート 1050 を使用できると仮定しています。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。必要な場合は、別のポートを使用することもできます。
178.200 +.RS 3
178.201 +.TP 3
178.202 +\-serverPollingTime milliseconds
178.203 +\f2servertool\fP 篏睡脂蚊膓泣若若罩e幻篏 ORBD 腆肴違絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
178.204 +.RE
178.205 +
178.206 .LP
178.207 +.RS 3
178.208 +.TP 3
178.209 +\-serverStartupDelay milliseconds
178.210 +\f2servertool\fP 篏睡脂蚊膓泣若若莎桁篏臀荵∫箴紊篆<障с ORBD 緇罘絎障ゃ 1,000 腱с 腱絎ゃ鴻贋医ゃс綽荀障(ュ)
178.211 +.RE
178.212 +
178.213 .LP
178.214 -UNIX コマンドシェルから \f2orbd\fP を起動するには、次のように入力します。
178.215 +.RS 3
178.216 +.TP 3
178.217 +\-Joption
178.218 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
178.219 +.TP 3
178.220 +
178.221 +.RE
178.222 +
178.223 +.LP
178.224 +.SH "若泣若鴻莎桁罩"
178.225 +.LP
178.226 +.LP
178.227 +若泣若鴻
178.228 +.na
178.229 +\f2CORBA 吾с\fP @
178.230 +.fi
178.231 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object若潟違純 CORBA 泣若鴻с 若潟違吾ссゃ潟純障
178.232 +.na
178.233 +\f2若ゃ潟c潟違\fP @
178.234 +.fi
178.235 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding若泣若鴻主ゃ≪潟筝吾сс緇с障
178.236 +.LP
178.237 +.LP
178.238 +ORBD ゃ≪潟障泣若若絎茵莎桁障ORBD 膓若泣若鴻割若泣若鴻腟粋昭障障 < COS 若泣若鴻絎茖с
178.239 +.LP
178.240 +.LP
178.241 +\f3膓若泣若\fP若潟違潟潟鴻絲障膓с箴障ゃ障宴泣若鴻罩≪莎桁緇膓泣若鴻絎潟榊翫с緇с障ORBD 莎桁膓若泣若鴻若潟違潟潟鴻違緇鴻ゃ≪潟泣若若ゃ潟c潟違篆障
178.242 +.LP
178.243 +.LP
178.244 +\
178.245 +.LP
178.246 +.LP
178.247 +筝篏篋сс若吾с潟 JDK 罌宴\f3筝若泣若\fP篁若鴻 J2SE 罌宴障筝若泣若鴻с若泣若鴻絎茵筝帥若潟違潟潟鴻篆障泣若鴻筝若潟違潟潟鴻紊宴障
178.248 +.LP
178.249 +.LP
178.250 +\f2\-ORBInitialPort\fP 綣違\f2orbd\fP 綽潟潟茵綣違с若泣若鴻絎茵若垩荐絎篏帥障篁ヤ茯сJava\ IDL Object Request Broker Daemon 若 1050 篏睡с障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
178.251 +.LP
178.252 +.LP
178.253 +UNIX 潟潟激с \f2orbd\fP 莎桁罨<ュ障
178.254 .LP
178.255 .nf
178.256 \f3
178.257 @@ -138,7 +176,7 @@
178.258
178.259 .LP
178.260 .LP
178.261 -MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
178.262 +Windows MS\-DOS 激鴻潟с罨<ュ障
178.263 .LP
178.264 .nf
178.265 \f3
178.266 @@ -150,7 +188,7 @@
178.267
178.268 .LP
178.269 .LP
178.270 -ORBD の実行後に、サーバーおよびクライアントアプリケーションを実行できます。クライアントおよびサーバーアプリケーションを実行する場合は、ネーミングサービスが実行されているポート番号 (および該当する場合は、マシン名) をアプリケーションに認識させる必要があります。これを実行する方法の 1 つとして、次のコードをアプリケーションに追加することができます。
178.271 + ORBD 絎茵泣若若ゃ≪潟≪宴若激с潟絎茵с障ゃ≪潟泣若若≪宴若激с潟絎茵若泣若鴻絎茵若 (綽荀翫激喝) 茯茘綽荀障絎憗 1 ゃ号罨<潟若≪宴若激с潟菴遵с
178.272 .LP
178.273 .nf
178.274 \f3
178.275 @@ -168,7 +206,7 @@
178.276
178.277 .LP
178.278 .LP
178.279 -この例では、ネーミングサービスはホスト「MyHost」のポート 1050 で実行されています。また、サーバーまたはクライアントアプリケーションの実行時にコマンド行からポート番号またはマシン名を指定することもできます。たとえば、「HelloApplication」を次のコマンド行で起動します。
178.280 +箴с若泣若鴻鴻 MyHost 若 1050 筝у茵障ャ号潟潟茵泣若若障ゃ≪潟≪宴若激с潟絎茵若垩障激喝筝≧鴻絎号障違罨<潟潟茵激с潟篏睡HelloApplication莎桁с障
178.281 .LP
178.282 .nf
178.283 \f3
178.284 @@ -180,31 +218,39 @@
178.285
178.286 .LP
178.287 .LP
178.288 -ネーミングサービスを停止するには、該当するオペレーティングシステムコマンドを使用します (Solaris での \f2pkill orbd\fP、または \f2orbd\fP が実行されている DOS ウィンドウでの \f2Ctrl+C\fP など)。一時ネームサービスの場合、サービスが終了すると、ネーミングサービスに登録されている名前が消失する可能性があります。Java IDL ネーミングサービスは明示的に停止されるまで実行します。
178.289 +若泣若鴻罩≪若c潟違激鴻潟潟篏睡障 違Solaris с \f2pkill orbd\fP 篏睡\f2orbd\fP 絎茵 DOS c潟с \f2Ctrl+C\fP 若篏睡障筝若泣若鴻翫泣若鴻腟篋若泣若鴻脂蚊羔サ翫障Java IDL 若泣若鴻腓榊罩≪障у茵障
178.290 .LP
178.291 -ORBD に含まれているネーミングサービスの詳細については、「\f2Naming Service\fP」
178.292 +.LP
178.293 +ORDB 障若泣若鴻荅括完ゃ
178.294 +.na
178.295 +\f2若泣若鴻\fP @
178.296 .fi
178.297 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
178.298 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlс
178.299 .LP
178.300 -.SH サーバーマネージャ
178.301 +.SH "泣若若若吾c"
178.302 .LP
178.303 .LP
178.304 -ORBD のサーバーマネージャにアクセスして持続サーバーを実行するには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合、\f2orbd\fP と同じホストおよびポートで起動する必要があります。異なるポートでサーバーが起動された場合、ローカルコンテキストのデータベースに格納されている情報は無効になり、サービスは正常に機能しなくなります。
178.305 +ORBD 泣若若若吾c若≪祉鴻膓泣若若絎茵servertool(1) 篏睡泣若若莎桁綽荀障 servertool ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁潟激c潟茵潟潟茵ゃ潟帥с若鴻сservertool 篏睡泣若若莎桁翫\f2orbd\fP 絎茵贋若鴻ц儀綽荀障泣若若違若у茵若潟潟鴻若帥若鴻篆絖宴≦鴻泣若鴻罩c篏障
178.306 .LP
178.307 -.SS
178.308 -サーバーマネージャ: 例
178.309 +.SS
178.310 +泣若若若吾c:箴
178.311 .LP
178.312 .LP
178.313 -デモ用のサンプルチュートリアル
178.314 +∝
178.315 +.na
178.316 +\f2泣潟ャ若≪\fP @
178.317 .fi
178.318 - (http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html) を使って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラをチュートリアルで示されているように実行します。サーバーマネージャを実行するには、以下の手順に従ってアプリケーションを実行します。
178.319 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html篏睡ャ若≪緇c\f2idlj\fP 潟潟ゃ \f2javac\fP 潟潟ゃ絎茵障泣若若若吾c若絎茵罨<緇c≪宴若激с潟絎茵障
178.320 .LP
178.321 -.RS 3
178.322 -.TP 3
178.323 -1.
178.324 -orbd を起動します。
178.325 .LP
178.326 -\f2orbd\fP を UNIX コマンドシェルから起動するには、次のように入力します。
178.327 +\f2orbd\fP 莎桁障
178.328 +.LP
178.329 +.LP
178.330 +UNIX 潟潟激с \f2orbd\fP 莎桁罨<ュ障
178.331 +.LP
178.332 +.LP
178.333 +\
178.334 +.LP
178.335 .nf
178.336 \f3
178.337 .fl
178.338 @@ -212,8 +258,11 @@
178.339 .fl
178.340 \fP
178.341 .fi
178.342 +
178.343 .LP
178.344 -MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
178.345 +.LP
178.346 +Windows MS\-DOS 激鴻潟с罨<ュ障
178.347 +.LP
178.348 .nf
178.349 \f3
178.350 .fl
178.351 @@ -221,13 +270,17 @@
178.352 .fl
178.353 \fP
178.354 .fi
178.355 +
178.356 .LP
178.357 -\f21050\fP は、ネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必須のコマンド行引数です。Solaris ソフトウェアを使用する場合は、ルートから 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。
178.358 -.TP 3
178.359 -2.
178.360 -\f2servertool\fP を起動します。
178.361 .LP
178.362 -Hello サーバーを起動するには、次のように入力します。
178.363 +\f21050\fP 若泣若若絎茵若с\f2\-ORBInitialPort\fP 綽荀潟潟茵綣違сSolaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障
178.364 +.LP
178.365 +.LP
178.366 +\f2servertool\fP 莎桁障
178.367 +.LP
178.368 +.LP
178.369 +Hello 泣若若莎桁罨<ュ障
178.370 +.LP
178.371 .nf
178.372 \f3
178.373 .fl
178.374 @@ -235,26 +288,43 @@
178.375 .fl
178.376 \fP
178.377 .fi
178.378 +
178.379 .LP
178.380 -ネームサーバー (\f2orbd\fP) のポートが前の手順で使用したポート (たとえば、\f2\-ORBInitialPort 1050\fP) と同じであることを確認してください。\f2servertool\fP は、ネームサーバーと同じポートで起動する必要があります。
178.381 .LP
178.382 -\f2servertool\fP コマンド行インタフェースが表示されます。
178.383 -.TP 3
178.384 -3.
178.385 -Hello サーバーを \f2servertool\fP プロンプトから起動します。
178.386 +罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障\f2servertool\fP 若泣若若若筝ц儀綽荀障
178.387 +.LP
178.388 +.LP
178.389 +\f2servertool\fP 潟潟茵ゃ潟帥с若鴻茵腓冴障
178.390 +.LP
178.391 +.LP
178.392 +
178.393 +.LP
178.394 +.LP
178.395 +\f2servertool\fP 潟 Hello 泣若若莎桁障
178.396 +.LP
178.397 .nf
178.398 \f3
178.399 .fl
178.400 - servertool > register \-server HelloServer \-classpath .
178.401 - \-applicationName HelloServerApName
178.402 + servertool > register \-server HelloServer \-classpath . \-applicationName
178.403 +.fl
178.404 + HelloServerApName
178.405 .fl
178.406 \fP
178.407 .fi
178.408 +
178.409 .LP
178.410 -\f2servertool\fP は、このサーバーを登録し、それに「HelloServerApName」という名前を割り当て、そのサーバー ID と登録されているすべてのサーバーの一覧を表示します。
178.411 -.TP 3
178.412 -4.
178.413 -クライアントアプリケーションを別のターミナルウィンドウまたはプロンプトから実行します。
178.414 +.LP
178.415 +\f2servertool\fP c泣若若脂蚊HelloServerApName泣若若蚊綵泣若 ID 茵腓冴障
178.416 +.LP
178.417 +.LP
178.418 +
178.419 +.LP
178.420 +.LP
178.421 +ャ腴c潟障潟ゃ≪潟≪宴若激с潟絎茵障
178.422 +.LP
178.423 +.LP
178.424 +\
178.425 +.LP
178.426 .nf
178.427 \f3
178.428 .fl
178.429 @@ -262,32 +332,42 @@
178.430 .fl
178.431 \fP
178.432 .fi
178.433 -.LP
178.434 -この例の場合、ネームサーバーは Hello クライアントと同じホストで実行されているので、\f2\-ORBInitialHost localhost\fP を省くことができます。ネームサーバーが別のホストで実行されている場合は、\f2\-ORBInitialHost\fP \f2nameserverhost\fP を使用して IDL ネームサーバーが実行されているホストを指定します。
178.435 -.LP
178.436 -前の手順と同様に、ネームサーバー (\f2orbd\fP) のポート (たとえば、\f2\-ORBInitialPort 1050\fP) を指定します。
178.437 -.TP 3
178.438 -5.
178.439 -サーバーマネージャの実験が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を必ず停止 (終了) してください。
178.440 -.LP
178.441 -\f2orbd\fP を DOS プロンプトから停止するには、サーバーが実行されているウィンドウを選択し、\f2Ctrl+C\fP を押して停止します。\f2orbd\fP を UNIX シェルから停止するには、プロセスを検索して終了します。サーバーは、明示的に停止されるまで起動を引き続き待機します。
178.442 -.LP
178.443 -\f2servertool\fP を停止するには、\f2quit\fP と入力し、キーボードの \f2Enter\fP キーを押します。
178.444 -.RE
178.445
178.446 .LP
178.447 -.SH 関連項目
178.448 +.LP
178.449 +箴 \f2\-ORBInitialHost localhost\fP ャс障 若泣若若 Hello ゃ≪潟筝鴻筝у篏с若泣若若ャ鴻у篏翫IDL 若泣若若篏鴻 \f2\-ORBInitialHost\fP \f2nameserverhost\fP ф絎障
178.450 +.LP
178.451 +.LP
178.452 +罕若泣若 (\f2orbd\fP) 若絎障 \f2\-ORBInitialPort 1050\fP 障
178.453 +.LP
178.454 +.LP
178.455 +\
178.456 +.LP
178.457 +.LP
178.458 +\
178.459 +.LP
178.460 +.LP
178.461 +泣若若若吾c若篏腟篋若泣若 (\f2orbd\fP) \f2servertool\fP 罩≪腟篋
178.462 +.LP
178.463 +.LP
178.464 +DOS 潟 \f2orbd\fP 激c潟泣若若絎茵c潟御 \f2Ctrl+C\fP ュ障UNIX 激с \f2orbd\fP 激c潟祉鴻罎冴腟篋 (kill) 障泣若若腓榊罩≪障с若喝冴緇罘倶膓障
178.465 +.LP
178.466 +.LP
178.467 +\f2servertool\fP 激c潟\f2quit\fP ュ若若 \f2Enter\fP 若若障
178.468 +.LP
178.469 +.SH "∫i"
178.470 .LP
178.471 .RS 3
178.472 .TP 2
178.473 -*
178.474 -「\f2Naming Service\fP」
178.475 +o
178.476 +.na
178.477 +\f2若泣若\fP @
178.478 .fi
178.479 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
178.480 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
178.481 .br
178.482 .TP 2
178.483 -*
178.484 -servertool
178.485 +o
178.486 +servertool(1)
178.487 .RE
178.488
178.489 .LP
179.1 --- a/src/solaris/doc/sun/man/man1/ja/pack200.1 Tue May 12 15:21:55 2009 +0900
179.2 +++ b/src/solaris/doc/sun/man/man1/ja/pack200.1 Thu May 14 00:17:25 2009 -0700
179.3 @@ -1,90 +1,121 @@
179.4 -'\" t
179.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
179.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
179.7 -.\"
179.8 -.\" This code is free software; you can redistribute it and/or modify it
179.9 -.\" under the terms of the GNU General Public License version 2 only, as
179.10 -.\" published by the Free Software Foundation.
179.11 -.\"
179.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
179.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
179.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
179.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
179.16 -.\" accompanied this code).
179.17 -.\"
179.18 -.\" You should have received a copy of the GNU General Public License version
179.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
179.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
179.21 -.\"
179.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
179.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
179.24 -.\" have any questions.
179.25 -.\"
179.26 -.TH pack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
179.27 -.SH 名前
179.28 -pack200 \- JAR パックツール
179.29 -.SH 形式
179.30 -.B pack200
179.31 -[
179.32 -.I options
179.33 -]
179.34 -.I output\-file
179.35 -.I JAR\-file
179.36 -.SH
179.37 -オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
179.38 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
179.39 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
179.40 +."
179.41 +." This code is free software; you can redistribute it and/or modify it
179.42 +." under the terms of the GNU General Public License version 2 only, as
179.43 +." published by the Free Software Foundation.
179.44 +."
179.45 +." This code is distributed in the hope that it will be useful, but WITHOUT
179.46 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
179.47 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
179.48 +." version 2 for more details (a copy is included in the LICENSE file that
179.49 +." accompanied this code).
179.50 +."
179.51 +." You should have received a copy of the GNU General Public License version
179.52 +." 2 along with this work; if not, write to the Free Software Foundation,
179.53 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
179.54 +."
179.55 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
179.56 +." CA 95054 USA or visit www.sun.com if you need additional information or
179.57 +." have any questions.
179.58 +."
179.59 +.TH pack200 1 "04 May 2009"
179.60 +." Generated from HTML by html2man (author: Eric Armstrong)
179.61 +
179.62 +.LP
179.63 +.SH ""
179.64 +pack200 \- JAR 若
179.65 +.LP
179.66 +.RS 3
179.67 +.TP 2
179.68 +o
179.69 +綵√
179.70 +.TP 2
179.71 +o
179.72 +茯
179.73 +.TP 2
179.74 +o
179.75 +激с
179.76 +.TP 2
179.77 +o
179.78 +腟篋鴻若帥
179.79 +.TP 2
179.80 +o
179.81 +∫i
179.82 +.TP 2
179.83 +o
179.84 +茯
179.85 +.RE
179.86 +
179.87 +.LP
179.88 +.SH "綵√"
179.89 +.LP
179.90 +
179.91 +.LP
179.92 +.LP
179.93 +\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
179.94 +.LP
179.95 +.LP
179.96 +激с潟絎綺羆冴障障潟潟茵障 properties <ゃ絎緇激с潟篁ュ絎鴻激с潟障
179.97 .LP
179.98 .RS 3
179.99
179.100 -.JP
179.101 +.LP
179.102 +.RS 3
179.103 .TP 3
179.104 options
179.105 -コマンド行オプション。
179.106 +潟潟茵激с潟
179.107 .TP 3
179.108 -output\-file
179.109 -出力ファイルの名前。
179.110 +output\-file
179.111 +阪<ゃ
179.112 .TP 3
179.113 -JAR\-file
179.114 -入力ファイルの名前。
179.115 +JAR\-file
179.116 +ュ<ゃ
179.117 +.RE
179.118 +
179.119 .LP
179.120 .RE
179.121 -.SH 機能説明
179.122 +.SH " 茯"
179.123 .LP
179.124
179.125 .LP
179.126 .LP
179.127 -\f2pack200\fP ツールは、Java \f2gzip\fP 圧縮ツールを使って JAR ファイルを圧縮 \f2pack200\fP ファイルに変換する Java アプリケーションです。\f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
179.128 -.LP
179.129 +\f2pack200\fP 若Java \f2gzip\fP х軒違篏睡JAR <ゃ \f2pack200\fP х軒<ゃ紊 Java ≪宴若激с潟с\f2pack200\fP <ゃ蕭х軒<ゃс絽綛膀膣潟若膰贋・с障
179.130 .LP
179.131 -\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
179.132 -.TP
179.133 -一般的な使用方法:
179.134 .LP
179.135 -.ft 3
179.136 -.nf
179.137 +\f2pack200\fP 若х軒潟吾潟荐絎緇茯炊眼茵激с潟障
179.138 +.LP
179.139 +.SS
179.140 +筝篏睡号:
179.141 +.LP
179.142 +.RS 3
179.143 +
179.144 +.LP
179.145 +.LP
179.146 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
179.147 -.fi
179.148 -.ft 1
179.149 .LP
179.150 -この例では、デフォルトの \f2pack200\fP 設定で、\f2myarchive.pack.gz\fP が作成されます。
179.151 +.RE
179.152 .LP
179.153 -.SH オプション
179.154 +箴с \f2pack200\fP 荐絎с\f2myarchive.pack.gz\fP 篏障
179.155 +.LP
179.156 +.SH "激с"
179.157 .LP
179.158
179.159 .LP
179.160 -.LP
179.161 +.LP
179.162 \f4\-r \-\-repack\fP
179.163 .LP
179.164 .RS 3
179.165
179.166 .LP
179.167 .LP
179.168 -\f2myarchive.jar\fP ファイルのパックまたはアンパックにより、JAR ファイルを作成します。作成されたファイルは、\f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
179.169 +\f2myarchive.jar\fP <ゃ緇≪潟JAR <ゃ障<ゃ\f2jarsigner(1)\fP 若ュ<ゃ篏睡с障
179.170 .LP
179.171 .RS 3
179.172
179.173 .LP
179.174 .LP
179.175 -\f2% pack200 \-\-repack myarchive\-packed.jar myarchive.jar\fP
179.176 +\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
179.177 .LP
179.178 .LP
179.179 \f2% pack200 \-\-repack myarchive.jar\fP
179.180 @@ -98,7 +129,7 @@
179.181
179.182 .LP
179.183 .LP
179.184 -\f2pack200\fP ファイルを作成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
179.185 +\f2pack200\fP <ゃ障激с潟絎х軒若篏睡綽荀障 障帥若蚊激鴻с絲上х軒茹iゃ若篏睡綽荀障
179.186 .LP
179.187 .RS 3
179.188
179.189 @@ -109,13 +140,13 @@
179.190 .RE
179.191 .RE
179.192 .LP
179.193 -\f4\-G \-\-strip-debug\fP
179.194 +\f4\-G \-\-strip\-debug\fP
179.195 .LP
179.196 .RS 3
179.197
179.198 .LP
179.199 .LP
179.200 -出力からデバッグ用の属性を削除します。対象となる属性には、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、および \f2LocalVariableTypeTable\fP などがあります。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
179.201 +阪亥絮сゃ障絲乗院絮с\f2SourceFile\fP\f2LineNumberTable\fP\f2LocalVariableTable\fP \f2LocalVariableTypeTable\fP 障絮сゃ違潟若ゃ潟鴻若泣ゃ冴絨障罘純狗障
179.202 .LP
179.203 .RE
179.204 .LP
179.205 @@ -125,7 +156,7 @@
179.206
179.207 .LP
179.208 .LP
179.209 -パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
179.210 +若鴻荀膣筝号帥荵∫障障JAR cゃ障潟若泣ゃ冴絨障ゃ潟鴻 JAR <ゃ罘純罩e幻篏障
179.211 .LP
179.212 .RE
179.213 .LP
179.214 @@ -135,16 +166,18 @@
179.215
179.216 .LP
179.217 .LP
179.218 -各アーカイブセグメントの予測ターゲットサイズ N (バイト) を指定します。N バイト以上を必要とする単一の入力ファイルには、独立したアーカイブセグメントが割り当てられます。たとえば、これは特殊な例ですが、値が \f2-1\fP の場合、すべての入力ファイルを含む単一の巨大なセグメントが生成されます。一方、値が \f20\fP の場合、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントのサイズが大きければ大きいほど断片化は起こりにくく、圧縮率も高くなります。しかし、こうしたセグメントを処理するためには、大量のメモリが必要になります。
179.219 +ゃ≪若ゃ祉違<潟篋潟帥若蚊泣ゃ N (ゃ篏) сN ゃ篁ヤ綽荀筝ュ<ゃ
179.220 +.br
179.221 +腴≪若ゃ祉違<潟蚊綵障違号箴сゃ \f2\-1\fP 翫鴻ュ<ゃ筝綏紊с祉違<潟障 筝鴻ゃ \f20\fP 翫鴻祉違<潟 1 ゃょ障≪若ゃ祉違<潟泣ゃ冴紊с医ぇ祉莎激х軒蕭障祉違<潟紊ч<≪若綽荀障
179.222 .LP
179.223 .LP
179.224 -各セグメントのサイズは、セグメント内で転送される入力ファイルのサイズと、このファイルの名前のサイズ、およびその他の転送プロパティによって予測されます。
179.225 +祉違<潟泣ゃ冴祉違<潟ц拶ュ<ゃ泣ゃ冴<ゃ泣ゃ冴潟篁荵∫c若c篋羝障
179.226 .LP
179.227 .LP
179.228 -デフォルトのサイズは \f21000000\fP (百万バイト) です。これは、標準サイズの入力 JAR ファイルを単一セグメント内で転送できるサイズです。パックツールおよびアンパックツールのメモリ要件には制限が課されます。
179.229 +泣ゃ冴 \f21000000\fP (100 筝ゃ) с罔羣泣ゃ冴ュ JAR <ゃ筝祉違<潟ц拶с泣ゃ冴с若潟≪潟若<≪取篁吟狗茯蚊障
179.230 .LP
179.231 .LP
179.232 -この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
179.233 +狗茯蚊 10M ゃ JAR <ゃ絽吾 10% 腮綺泣ゃ冴障 若с紊с Java 若 (祉違<潟狗膣 10 ) 綽荀翫障
179.234 .LP
179.235 .RE
179.236 .LP
179.237 @@ -154,11 +187,10 @@
179.238
179.239 .LP
179.240 .LP
179.241 -単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合、圧縮速度は速くても圧縮率はそれほど高くありません。レベル \f29\fP の場合、圧縮速度は遅くても圧縮率は高くなります。
179.242 -特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべてのアンパックツールはこの特殊な処理をアーカイブ全体のパススルーとして理解する必要があります。
179.243 +筝 10 我医ゃ絎翫若絎х軒с≪若ゃх軒障 \f21\fP 翫х軒綺х軒祉蕭障 \f29\fP 翫х軒綺х軒蕭障号 \f20\fP 絎翫 JAR <ゃх軒х贋・潟若障JSR 200 罔羣с鴻≪潟若号≪若ゃ篏鴻鴻若茹c綽荀障
179.244 .LP
179.245 .LP
179.246 -デフォルト値は \f25\fP です。この場合、標準的な時間で、適度な圧縮が行われます。
179.247 +ゃ \f25\fP с 翫罔羣с綺х軒茵障
179.248 .LP
179.249 .RE
179.250 .LP
179.251 @@ -168,33 +200,43 @@
179.252
179.253 .LP
179.254 .LP
179.255 -デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。可能な値:
179.256 +ゃ筝吾ュ宴篆障 荵∫≪若ゃ泣ゃ冴紊с障純:
179.257 .LP
179.258 +.RS 3
179.259 .TP 3
179.260 -true
179.261 +true
179.262 .TP 3
179.263 -false
179.264 -どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
179.265 +false
179.266 +<翫с若若激с潟潟阪≪若ゃ荐絎障 ≪若ゃ荀膣若激с潟潟荵∫障
179.267 +.RE
179.268 +
179.269 .LP
179.270 +.RS 3
179.271 .TP 3
179.272 -keep
179.273 -入力 JAR 内のデフレーションヒントを保存します (デフォルト)。
179.274 -.in
179.275 -.TP
179.276 +keep
179.277 +ュ JAR 若激с潟潟篆障 ()
179.278 +.RE
179.279 +
179.280 +.LP
179.281 +.RE
179.282 +.LP
179.283 \f4\-mvalue \-\-modification\-time=\fP\f2value\fP
179.284 .LP
179.285 .RS 3
179.286
179.287 .LP
179.288 .LP
179.289 -可能な値:
179.290 +純:
179.291 .LP
179.292 +.RS 3
179.293 .TP 3
179.294 -latest
179.295 -パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
179.296 +latest
179.297 +若≪若ゃ潟腟贋井祉祉違<潟鴻潟腟贋井祉劫障筝ゃ祉違<潟筝荵∫祉違<潟潟障翫鴻ゃ潟鴻若<ゃ筝ヤ荐絎馹障≪若ゃ荵∫泣ゃ冴絨絨с障
179.298 .TP 3
179.299 -keep
179.300 -入力 JAR 内の更新時刻を保存します (デフォルト)。
179.301 +keep
179.302 +ュ JAR 贋井祉篆障 ()
179.303 +.RE
179.304 +
179.305 .LP
179.306 .RE
179.307 .LP
179.308 @@ -204,7 +246,7 @@
179.309
179.310 .LP
179.311 .LP
179.312 -ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。パス名の変換は行われません。システムファイルの区切り文字が JAR ファイルの区切り文字 "\f2/\fP" で置き換えられるだけです。ファイル名は、JAR ファイル内の文字列と完全に一致していなければなりません。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
179.313 +<ゃх軒ゃ篏ц拶絎障激с潟膵違菴篏睡茲違<ゃ絎с障劫紊茵障 激鴻<ゃ阪絖 JAR <ゃ阪絖\f2/\fPх舟с<ゃJAR <ゃ絖絎筝眼違障file c絎翫c鴻<ゃ荵∫障
179.314 .LP
179.315 .RE
179.316 .LP
179.317 @@ -214,48 +256,54 @@
179.318
179.319 .LP
179.320 .LP
179.321 -デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
179.322 +篏≦鴻障 違筝絮с鴻<ゃ絎≪激с潟ц拶障≪激с潟絎純:
179.323 .LP
179.324 +.RS 3
179.325 .TP 3
179.326 -error
179.327 -\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
179.328 +error
179.329 +\f2pack200\fP 篏紊掩茹h茵腓冴障
179.330 .TP 3
179.331 -strip
179.332 -属性はドロップされます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
179.333 +strip
179.334 +絮с障羈: VM 綽絮сゃ鴻若若絎潟榊障
179.335 .TP 3
179.336 -pass
179.337 -この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
179.338 +pass
179.339 +絮с罎冴翫劫篏 1 ゃ純若鴻荵∫障
179.340 +.RE
179.341 +
179.342 .LP
179.343 .RE
179.344 .LP
179.345 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
179.346 .br
179.347 - \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
179.348 +\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
179.349 .br
179.350 - \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
179.351 +\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
179.352 .br
179.353 - \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
179.354 +\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
179.355 .LP
179.356 .RS 3
179.357
179.358 .LP
179.359 .LP
179.360 -これら 4 つのオプションでは、クラスエンティティに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
179.361 + 4 ゃ激с潟с鴻潟cc若 Class 絮сField 絮сMethod 絮сCode 絮с絮сゃ≪絎с障attribute\-name ゃ≪障≪激с潟絎臂絮с絎障≪激с潟絎純:
179.362 .LP
179.363 +.RS 3
179.364 .TP 3
179.365 -(一部のレイアウト文字列)
179.366 -レイアウト言語は、JSR 200 仕様に定義されています。
179.367 +(筝ゃ≪絖)
179.368 +ゃ≪荐茯JSR 200 篁罕絎臂障
179.369 .LP
179.370 -例: \f2\-\-class\-attribute=SourceFile=RUH\fP
179.371 +箴: \f2\-\-class\-attribute=SourceFile=RUH\fP
179.372 .TP 3
179.373 -error
179.374 -この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
179.375 +error
179.376 +絮с罎冴翫pack200 篏紊掩茹h茵腓冴障
179.377 .TP 3
179.378 -strip
179.379 -この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
179.380 +strip
179.381 +絮с罎冴翫絮с阪ゃ障羈: VM 綽絮сゃ鴻若若絎潟榊障
179.382 +.RE
179.383 +
179.384 .LP
179.385 .LP
179.386 -例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。
179.387 +箴: \f2\-\-class\-attribute=CompilationID=pass\fP 絮с鴻<ゃ荵∫障 若篁≪激с潟茵障
179.388 .LP
179.389 .RE
179.390 .LP
179.391 @@ -265,7 +313,7 @@
179.392
179.393 .LP
179.394 .LP
179.395 -コマンド行に、パックツールを初期化するための Java プロパティが含まれている設定ファイルを指定できます。
179.396 +潟潟茵若 Java c若障荐絎<ゃ絎с障
179.397 .LP
179.398 .RS 3
179.399
179.400 @@ -305,7 +353,7 @@
179.401
179.402 .LP
179.403 .LP
179.404 -最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
179.405 +絨<祉若吾阪障激с潟茲井絎激<祉若吾阪障
179.406 .LP
179.407 .RE
179.408 .LP
179.409 @@ -315,7 +363,7 @@
179.410
179.411 .LP
179.412 .LP
179.413 -メッセージを表示せずに動作します。
179.414 +<祉若吾茵腓冴篏障
179.415 .LP
179.416 .RE
179.417 .LP
179.418 @@ -325,7 +373,7 @@
179.419
179.420 .LP
179.421 .LP
179.422 -出力メッセージのログファイルを指定します。
179.423 +阪<祉若吾違<ゃ絎障
179.424 .LP
179.425 .RE
179.426 .LP
179.427 @@ -335,65 +383,65 @@
179.428
179.429 .LP
179.430 .LP
179.431 -\f2pack200\fP によって呼び出される Java 起動ツールにオプションを渡します。たとえば \f2\-J\-Xms48m\fP と指定した場合、起動メモリが 48M バイトに設定されます。\f2\-X\fP で始まってはいませんが、\f2pack200\fP の標準オプションではありません。慣習として、\f2\-J\fP には、Java で書かれたアプリケーションを実行する VM にオプションを渡す働きがあります。
179.432 +\f2pack200\fP c若喝冴 Java 莎桁若激с潟羝<障違\f2\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障激с潟 \f2\-X\fP у障c障\f2pack200\fP 罔羣激с潟с障\f2\-J\fP 篏帥cJava ц菴違≪宴若激с潟絎茵緇 VM 激с恰検頫障
179.433 .LP
179.434 .RE
179.435 .RE
179.436 -.SH 終了ステータス
179.437 +.SH "腟篋鴻若帥"
179.438 .LP
179.439
179.440 .LP
179.441 .LP
179.442 -次の終了値が返されます。
179.443 +罨<腟篋ゃ菴障
179.444 .LP
179.445 .RS 3
179.446
179.447 .LP
179.448 .LP
179.449 -\f2\ 0\fP "成功"
179.450 +\f2\ 0\fP ""
179.451 .LP
179.452 .LP
179.453 -\f2>0\fP "エラー"
179.454 +\f2>0\fP ""
179.455 .LP
179.456 .RE
179.457 -.SH 関連項目
179.458 +.SH "∫i"
179.459 .LP
179.460 .RS 3
179.461 .TP 2
179.462 -*
179.463 -unpack200 \- JAR アンパックツール
179.464 +o
179.465 +unpack200(1)
179.466 .TP 2
179.467 -*
179.468 -\f2unpack200(1)\fP、\f2jar(1)\fP、\f2jarsigner(1)\fP、\f2attributes(5)\fP のマニュアルページ
179.469 +o
179.470 +.na
179.471 +\f2Java SE ャ<潟\fP @
179.472 +.fi
179.473 +http://java.sun.com/javase/6/docs/index.html
179.474 .TP 2
179.475 -*
179.476 -Java SE のドキュメント
179.477 +o
179.478 +.na
179.479 +\f2Java ゃ \- Pack200\fP @
179.480 +.fi
179.481 +http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
179.482 .TP 2
179.483 -*
179.484 -.na
179.485 -\f2Java Deployment Guide \- Pack200\fP
179.486 -.fi
179.487 -(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html)
179.488 +o
179.489 +jar(1) \- Java Archive 若
179.490 .TP 2
179.491 -*
179.492 -\f2jar\fP \- Java アーカイブツール
179.493 +o
179.494 +jarsigner(1) \- JAR 臀峨恰荐若若
179.495 .TP 2
179.496 -*
179.497 -.na
179.498 -\f2jarsigner\fP \- JAR 署名および検証ツール
179.499 -.fi
179.500 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html)
179.501 +o
179.502 +\f2attributes(5)\fP ャ≪若
179.503 .RE
179.504
179.505 .LP
179.506 -.SH 注意事項
179.507 +.SH "羈鋋"
179.508 .LP
179.509
179.510 .LP
179.511 .LP
179.512 -このコマンドと \f2pack(1)\fP コマンドを混同しないでください。これらは別製品です。
179.513 +潟潟 \f2pack(1)\fP 羞桁сヨ遵с
179.514 .LP
179.515 .LP
179.516 -SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
179.517 +SDK 篁絮 Java SE API 篁罕檎荀ゃc翫篁罕
179.518 .LP
179.519 -
179.520 +
180.1 --- a/src/solaris/doc/sun/man/man1/ja/policytool.1 Tue May 12 15:21:55 2009 +0900
180.2 +++ b/src/solaris/doc/sun/man/man1/ja/policytool.1 Thu May 14 00:17:25 2009 -0700
180.3 @@ -1,4 +1,3 @@
180.4 -.'" t
180.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
180.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
180.7 ."
180.8 @@ -19,100 +18,91 @@
180.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
180.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
180.11 ." have any questions.
180.12 -." `
180.13 -.TH policytool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
180.14 -." Generated by html2roff
180.15 +."
180.16 +.TH policytool 1 "04 May 2009"
180.17 +." Generated from HTML by html2man (author: Eric Armstrong)
180.18
180.19 .LP
180.20 -.SH 名前
180.21 -policytool \- PolicyTool 管理 GUI ユーティリティ
180.22 +.SH ""
180.23 +policytool \- PolicyTool 膊∞ GUI 若cc
180.24 .LP
180.25 -\f3policytool\fP は、ユーティリティ GUI 経由で取得したユーザ入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
180.26 -.SH "形式"
180.27 +\f3policytool\fP 若cc GUI 腟宴у緇若吟弱ュ冴ャ若潟鴻激若<ゃ茯炊吾障
180.28 +.RS 3
180.29 +.TP 2
180.30 +o
180.31 +綵√
180.32 +.TP 2
180.33 +o
180.34 +茯
180.35 +.TP 2
180.36 +o
180.37 +激с
180.38 +.TP 2
180.39 +o
180.40 +∫i
180.41 +.RE
180.42 +
180.43 +.LP
180.44 +.SH "綵√"
180.45 .LP
180.46
180.47 .LP
180.48 +.RS 3
180.49 .TP 3
180.50 \
180.51 .TP 3
180.52 -policytool 管理者ユーティリティを実行します
180.53 +policytool 膊∞若cc若絎茵障
180.54 \f4policytool\fP
180.55 .TP 3
180.56 -policytool を実行し、指定されたポリシーファイルを読み込みます
180.57 -\f4policytool\fP\f2[\-file][\fP\f2filename\fP\f2]\fP
180.58 +policytool 絎茵絎激若<ゃ茯粋昭帥障
180.59 +\f4policytool\fP\f2 [\-file\ \fP\f2filename\fP\f2]\fP
180.60 .TP 3
180.61 \
180.62 .TP 3
180.63 -各要素は次のとおりです。
180.64 +荀膣罨<с
180.65 +.RS 3
180.66 .TP 3
180.67 file
180.68 -ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
180.69 +若激若<ゃ茯粋昭 \f2policytool\fP 腓冴障
180.70 .TP 3
180.71 - filename
180.72 -ファイル名
180.73 +filename
180.74 +<ゃ
180.75 +.RE
180.76 +.SH "茯"
180.77 .LP
180.78 -.SH "機能説明"
180.79 -.LP
180.80 -
180.81 -.LP
180.82 -.LP
180.83 -\f3policytool\fP は、システム管理者がローカルポリシーファイルの内容を管理することを可能にする管理者用の GUI です。ポリシーファイルは \f2.policy\fP を拡張子に持つプレーンテキストファイルであり、ドメイン別のリモート要求者をアクセス権オブジェクトにマッピングします。詳細については、
180.84 +\f3policytool\fP 若吟若若激若<ゃ絎鴻膊∞純 GUI с荅括完ゃ
180.85 +.na
180.86 +\f2激若<ゃ篏括∞若\fP @
180.87 +.fi
180.88 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlс
180.89 +.SH "激с"
180.90 +.RS 3
180.91 +.TP 3
180.92 +file
180.93 +\f2filename\fP 茯粋昭帥障
180.94 +.SH "∫i"
180.95 +.na
180.96 +\f2Default Policy Implementation and Syntax\fP @
180.97 .fi
180.98 http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
180.99 -の
180.100 +.br
180.101 .na
180.102 -「\f2Default Policy Implementation and Syntax\fP」を参照してください。
180.103 -.LP
180.104 -.SH "オプション"
180.105 -.LP
180.106 -
180.107 -.LP
180.108 -.TP 3
180.109 -file
180.110 -\f2filename\fP を読み込みます。
180.111 -.LP
180.112 -.SH "関連項目"
180.113 -.LP
180.114 -
180.115 -.LP
180.116 -.fi
180.117 -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
180.118 -の
180.119 -.na
180.120 -「\f2Default Policy Implementation and Syntax\fP」
180.121 -.br
180.122 -
180.123 -.LP
180.124 +\f2Policy Tool Users' Guide\fP @
180.125 .fi
180.126 http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
180.127 -の
180.128 +.br
180.129 .na
180.130 -「\f2Policy Tool Users' Guide\fP」
180.131 -.br
180.132 -
180.133 -.LP
180.134 +\f2Security Permissions\fP @
180.135 .fi
180.136 http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
180.137 -の
180.138 +.br
180.139 .na
180.140 -「\f2Security Permissions\fP」
180.141 -.br
180.142 -
180.143 -.LP
180.144 +\f2Security Overview\fP @
180.145 .fi
180.146 http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
180.147 -の
180.148 -.na
180.149 -「\f2Security Overview\fP」
180.150 .br
180.151 -
180.152 -.LP
180.153 -.fi
180.154 -http://java.sun.com/javase/6/docs/technotes/guides/security/arch.html
180.155 -の
180.156 -.na
180.157 -「\f2Security Architecture\fP」
180.158 -.br
180.159 +.RE
180.160 +.RE
180.161
180.162 .LP
180.163
181.1 --- a/src/solaris/doc/sun/man/man1/ja/rmic.1 Tue May 12 15:21:55 2009 +0900
181.2 +++ b/src/solaris/doc/sun/man/man1/ja/rmic.1 Thu May 14 00:17:25 2009 -0700
181.3 @@ -1,368 +1,270 @@
181.4 -'\" t
181.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
181.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
181.7 -.\"
181.8 -.\" This code is free software; you can redistribute it and/or modify it
181.9 -.\" under the terms of the GNU General Public License version 2 only, as
181.10 -.\" published by the Free Software Foundation.
181.11 -.\"
181.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
181.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
181.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
181.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
181.16 -.\" accompanied this code).
181.17 -.\"
181.18 -.\" You should have received a copy of the GNU General Public License version
181.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
181.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
181.21 -.\"
181.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
181.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
181.24 -.\" have any questions.
181.25 -.\"
181.26 -.TH rmic 1 "2004 年 6 月 22 日"
181.27 -.SH "名前"
181.28 -rmic \- Java RMI スタブコンパイラ
181.29 -.\"
181.30 -.\" This document was created by saving an HTML file as text
181.31 -.\" from the JavaSoft web site:
181.32 -.\"
181.33 -.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
181.34 -.\"
181.35 -.\" and adding appropriate troff macros. Because the JavaSoft web site
181.36 -.\" man pages can change without notice, it may be helpful to diff
181.37 -.\" files to identify changes other than new functionality.
181.38 -.\"
181.39 -.SH "形式"
181.40 -.B rmic
181.41 -[
181.42 -.BI options
181.43 -]
181.44 -.I package-qualified-class-names
181.45 -.SH "機能説明"
181.46 -.IX "Java RMI stub compiler" "" "Java RMI stub compiler \(em \fLrmic\fP"
181.47 -.IX "rmic" "" "\fLrmic\fP \(em Java RMI stub compiler"
181.48 -.B rmic
181.49 -コンパイラは、リモートオブジェクト用のスタブおよび
181.50 -スケルトンクラスファイル (JRMP プロトコル) とスタブ
181.51 -および Tie クラスファイル (IIOP プロトコル) を生成します。
181.52 -これらのクラスファイルは、リモートオブジェクト
181.53 -実装クラスである、コンパイルされた Java プログラミング言語
181.54 -クラスから生成されます。リモート実装クラスは、
181.55 -インタフェース \f3java.rmi.Remote\f1
181.56 -を実装するクラスです。
181.57 -.B rmic
181.58 -コマンドで指定されるクラスは、
181.59 -.BR javac (1)
181.60 -コマンドで正常にコンパイルされ、
181.61 -完全にパッケージ修飾されたクラスで
181.62 -なければなりません。
181.63 -次に示す例では、
181.64 -.B HelloImpl
181.65 -というクラスファイルに対して
181.66 -.B rmic
181.67 -を実行しています。
181.68 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
181.69 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
181.70 +."
181.71 +." This code is free software; you can redistribute it and/or modify it
181.72 +." under the terms of the GNU General Public License version 2 only, as
181.73 +." published by the Free Software Foundation.
181.74 +."
181.75 +." This code is distributed in the hope that it will be useful, but WITHOUT
181.76 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
181.77 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
181.78 +." version 2 for more details (a copy is included in the LICENSE file that
181.79 +." accompanied this code).
181.80 +."
181.81 +." You should have received a copy of the GNU General Public License version
181.82 +." 2 along with this work; if not, write to the Free Software Foundation,
181.83 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
181.84 +."
181.85 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
181.86 +." CA 95054 USA or visit www.sun.com if you need additional information or
181.87 +." have any questions.
181.88 +."
181.89 +.TH rmic 1 "04 May 2009"
181.90 +." Generated from HTML by html2man (author: Eric Armstrong)
181.91 +
181.92 .LP
181.93 -.RS
181.94 +.SH ""
181.95 +rmic \- Java RMI 潟潟ゃ
181.96 +.LP
181.97 +.RS 3
181.98 +
181.99 +.LP
181.100 +.LP
181.101 +\f3rmic\fP cJRMP 障 IIOP 潟篏睡≪若吾с鴻帥鴻宴潟 Tie 鴻障障OMG IDL 障
181.102 +.LP
181.103 +.RE
181.104 +.SH "綵√"
181.105 +.LP
181.106 +
181.107 +.LP
181.108 +.nf
181.109 +\f3
181.110 +.fl
181.111 +rmic [ \fP\f3options\fP\f3 ] \fP\f4package\-qualified\-class\-name(s)\fP\f3
181.112 +.fl
181.113 +\fP
181.114 +.fi
181.115 +
181.116 +.LP
181.117 +.SH "茯"
181.118 +.LP
181.119 +
181.120 +.LP
181.121 +.LP
181.122 +\f3rmic\fP 潟潟ゃc≪若吾с鴻帥鴻宴潟鴻<ゃ (JRMP 潟)潟鴻帥 Tie 鴻<ゃ腟水 (IIOP 潟) 障≪若吾с絎茖鴻с鴻<ゃJava 違潟域茯鴻潟潟ゃ障≪若絎茖鴻\f2java.rmi.Remote\fP ゃ潟帥с若鴻絎茖鴻с\f3rmic\fP 潟潟с劫鴻 \f3javac\fP 潟潟с潟潟ゃゅ宴若後絎綽荀障違鴻<ゃ \f2HelloImpl\fP \f3rmic\fP 絎茵罨<障
181.123 +.LP
181.124 +.nf
181.125 +\f3
181.126 +.fl
181.127 rmic hello.HelloImpl
181.128 +.fl
181.129 +\fP
181.130 +.fi
181.131 +
181.132 +.LP
181.133 +.LP
181.134 +\f2HelloImpl_Stub.class\fP <ゃ鴻宴若後篁 \f2hello\fP 泣c篏障
181.135 +.LP
181.136 +.LP
181.137 +≪若吾с鴻宴潟 JRMP 潟泣若弱眼潟cc若с絎≪若吾с絎茖若喝冴<純帥障
181.138 +.LP
181.139 +.LP
181.140 +≪若吾сTie鴻宴潟罕泣若弱眼潟cc若сIIOP 潟篏帥cゃ≪潟篆<障
181.141 +.LP
181.142 +.LP
181.143 +鴻帥≪若吾сゃ≪潟眼с篁gс 鴻帥≪若吾с<純若喝冴絎≪若吾с絽檎泣若若篆<綵劫蚊<障cゃ≪潟≪若吾с吾с絎若鴻帥吾с障
181.144 +.LP
181.145 +.LP
181.146 + \f3rmic\fP с1.2 JRMP 鴻帥潟若吾с潟篏睡鴻帥鴻障 \f2\-v1.2\fP 激с潟絎翫篏с(5.0 篁ュс \f2\-vcompat\fP 激с潟сc羈) IIOP 潟鴻帥 Tie 鴻 \f2\-iiop\fP 激с潟篏睡障
181.147 +.LP
181.148 +.LP
181.149 +鴻帥≪若ゃ潟帥с若鴻絎茖≪若吾с絎茖絮ゃ潟帥с若鴻絎茖障JRMP 鴻帥≪若吾с篏絎茖≪若ゃ潟帥с若鴻絎茖сゃ≪潟c鴻с Java 違潟域茯腟粋昭障羲膊絖篏睡с障IIOP 翫\f2PortableRemoteObject.narrow\fP <純篏帥違障
181.150 +.LP
181.151 +.SH "激с"
181.152 +.LP
181.153 +
181.154 +.LP
181.155 +.RS 3
181.156 +.TP 3
181.157 +\-bootclasspath path
181.158 +若鴻鴻<ゃ篏臀若若ゃ障
181.159 +.TP 3
181.160 +\-classpath path
181.161 +\f3rmic\fP 鴻「鴻絎障激с潟 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障
181.162 +.RS 3
181.163 +
181.164 +.LP
181.165 +.nf
181.166 +\f3
181.167 +.fl
181.168 +.:<your_path>
181.169 +.fl
181.170 +\fP
181.171 +.fi
181.172 +.RE
181.173 +箴腓冴障
181.174 +.RS 3
181.175 +
181.176 +.LP
181.177 +.nf
181.178 +\f3
181.179 +.fl
181.180 +.:/usr/local/java/classes
181.181 +.fl
181.182 +\fP
181.183 +.fi
181.184 +.RE
181.185 +.TP 3
181.186 +\-d directory
181.187 +拷絮ゃ阪c若絎障激с潟篏帥違鴻帥鴻宴潟 Tie <ゃ主c絎с障違罨<篏帥障
181.188 +.RS 3
181.189 +
181.190 +.LP
181.191 +.nf
181.192 +\f3
181.193 +.fl
181.194 +% rmic \-d /java/classes foo.MyClass
181.195 +.fl
181.196 +\fP
181.197 +.fi
181.198 +.RE
181.199 +\f2MyClass\fP 緇鴻帥鴻宴潟鴻 \f2/java/classes/foo\fP c臀障\f2\-d\fP 激с潟絎翫\f2\-d\ .\fP絎荀障帥若蚊鴻宴若檎絮ゃ憜c篏鴻帥Tie潟鴻宴潟<ゃc主障(篁ュ若吾с潟 \f3rmic\fP с\f2\-d\fP 絎翫宴若檎絮ゃ篏阪<ゃ鴻憜c贋・主)
181.200 +.br
181.201 +\
181.202 +.TP 3
181.203 +\-extdirs path
181.204 +ゃ潟鴻若≦宍罘純篏臀若若ゃ障
181.205 +.TP 3
181.206 +\-g
181.207 +絮紊違鴻井宴障с茵垽宴障
181.208 +.LP
181.209 +.TP 3
181.210 +\-idl
181.211 +\f2rmic\fP c絎鴻喝с鴻 OMG IDL 障IDL с違潟域茯箴絖絎hс吾с API 絎с障IDL <純潟若帥篁罕篏睡障 CORBA ゃ潟c潟違箴篁紙荐茯с<純潟若帥篏喝若喝冴茵с障荐茯Java C++ 障障荅括完
181.212 +.na
181.213 +\f2Java Language to IDL Mapping\fP @
181.214 +.fi
181.215 +http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) с
181.216 +.LP
181.217 +\f2\-idl\fP 激с潟篏帥祉激с潟絎с障
181.218 +.RS 3
181.219 +.TP 3
181.220 +\-always 障 \-alwaysgenerate
181.221 +√鴻帥Tie IDL ュ鴻違с綣桁句眼障
181.222 +.TP 3
181.223 +\-factory
181.224 + IDL factory 若若篏帥障
181.225 +.TP 3
181.226 +\-idlModule\ fromJavaPackage[.class]\ toIDLModule
181.227 +IDLEntity 宴若吾絎障箴腓冴障 \f2\-idlModule foo.bar my::real::idlmod\fP
181.228 +.TP 3
181.229 +\-idlFile\ fromJavaPackage[.class]\ toIDLFile
181.230 +IDLEntity <ゃ絎障箴腓冴障 \f2\-idlFile test.pkg.X TEST16.idl\fP\
181.231 .RE
181.232 .LP
181.233 -.B HelloImpl_Stub.class
181.234 -ファイルを (クラスのパッケージに対して指定された)
181.235 -.B hello
181.236 -サブディレクトリに作成します。
181.237 +.TP 3
181.238 +\-iiop
181.239 +\f2rmic\fP cJRMP 鴻帥鴻宴潟鴻篁cIIOP 鴻帥 Tie 鴻障鴻帥鴻≪若吾с若激сゃ≪潟泣若若若喝冴篆<篏帥障≪若ゃ潟帥с若鴻鴻帥鴻綽荀с 鴻帥鴻c≪若ゃ潟帥с若鴻絎茖障ゃ≪潟с≪若吾сс絎鴻帥с障帥ゃ鴻泣若弱眼х若若喝冴絎茖鴻c鴻篏帥障絎茖鴻帥ゃ鴻綽荀с
181.240 .LP
181.241 -JRMP プロトコルサーバ側エンティティである
181.242 -リモートオブジェクトのスケルトンには、
181.243 -リモートオブジェクト実装の呼び出しを
181.244 -ディスパッチするメソッドがあります。
181.245 +\f2\-iiop\fP 篏帥c \f2rmic\fP 若喝冴罨<遵荀靘羣鴻帥 Tie 障
181.246 +.RS 3
181.247 +
181.248 .LP
181.249 -リモートオブジェクトの Tie は、スケルトンに似た
181.250 -サーバ側エンティティですが、IIOP プロトコル
181.251 -を使用してクライアントと通信します。
181.252 -.LP
181.253 -スタブは、リモートオブジェクトのプロキシで、
181.254 -実際のリモートオブジェクト実装が存在するサーバに、
181.255 -リモートオブジェクトに対するメソッド呼び出しを転送します。
181.256 -クライアントのリモートオブジェクトへの参照は、
181.257 -実際にはローカルスタブへの参照です。
181.258 -.LP
181.259 -デフォルトでは、
181.260 -.B rmic
181.261 -は \-v1.2 オプションが
181.262 -指定された場合と同様に 1.2 JRMP スタブプロトコルを
181.263 -使用するスタブクラスを生成します (1.5 より前の
181.264 -リリースでは、\-vcompat オプションがデフォルト)。
181.265 -IIOP プロトコル用のスタブクラスおよび Tie クラスを
181.266 -生成するには、\-iiop オプションを使用します。
181.267 -.LP
181.268 -スタブは、リモートインタフェースのみを実装し、
181.269 -リモートオブジェクトによっても実装されるローカル
181.270 -インタフェースは実装しません。スタブはリモート
181.271 -オブジェクトとまったく同じリモートインタフェースの
181.272 -セットを実装するため、クライアントはキャストおよび
181.273 -型チェックに Java 言語の組み込み演算子を使用できます。
181.274 -IIOP の場合は、
181.275 -.B PortableRemoteObject.narrow
181.276 -メソッドを
181.277 -使用する必要があります。
181.278 -.SH オプション
181.279 -.if t .TP 20
181.280 -.if n .TP 15
181.281 -.BI \-bootclasspath " path"
181.282 -ブートストラップクラスファイルの位置をオーバーライドします。
181.283 -.if t .TP 20
181.284 -.if n .TP 15
181.285 -.BI \-classpath " path"
181.286 -.B rmic
181.287 -がクラスを探すのに用いるパスを
181.288 -.I path
181.289 -で指定します。この指定値は、デフォルトおよび
181.290 -.B CLASSPATH
181.291 -環境変数の設定値をオーバーライドします。
181.292 -複数のディレクトリを指定する場合はコロンで区切ります。
181.293 -したがって
181.294 -.I path
181.295 -の通常の形式は次のようになります。
181.296 -.sp 1n
181.297 -.ti +5n
181.298 -.BI .:< your_path >
181.299 -.sp 1n
181.300 -以下に例を示します。
181.301 -.sp 1n
181.302 -.ti +5n
181.303 -.B .:/usr/local/java/classes
181.304 -.if t .TP 20
181.305 -.if n .TP 15
181.306 -.BI \-d " directory"
181.307 -クラス階層のルートディレクトリを指定します。
181.308 -このオプションを使用して、スタブ、スケルトン、および Tie ファイルの出力先ディレクトリを指定できます。
181.309 -たとえば、次のコマンドを入力します。
181.310 -.LP
181.311 -.RS 5
181.312 -rmic \-d /java/classes foo.MyClass
181.313 +.nf
181.314 +\f3
181.315 +.fl
181.316 +_<implementationName>_stub.class
181.317 +.fl
181.318 +\fP
181.319 +.br
181.320 +\f3
181.321 +.fl
181.322 +_<interfaceName>_tie.class
181.323 +.fl
181.324 +\fP
181.325 +.fi
181.326 .RE
181.327 .LP
181.328 -この例では、MyClass から派生したスタブおよび
181.329 -スケルトンクラスをディレクトリ /java/classes/foo
181.330 -に配置します。\-d オプションが指定されていない場合、
181.331 -デフォルトの動作は「\-d .」が指定された場合と同様です。
181.332 -ターゲットクラスのパッケージ階層は、
181.333 -現在のディレクトリに作成され、スタブ/Tie/スケルトン
181.334 -ファイルはその階層内に配置されます。
181.335 -(以前の一部のバージョンの
181.336 -.B rmic
181.337 -では、
181.338 -\-d が指定されなかった場合、パッケージ階層は作成されず、
181.339 -すべての出力ファイル
181.340 -は、現在のディレクトリ内に直接配置されました。)
181.341 -.if t .TP 20
181.342 -.if n .TP 15
181.343 -.BI \-extdirs " path"
181.344 -インストールされている拡張機能の位置を上書きします。
181.345 -.if t .TP 20
181.346 -.if n .TP 15
181.347 -.B \-g
181.348 -ローカル変数を含む、すべてのデバッグ情報の
181.349 -生成を有効にします。デフォルトでは、
181.350 -行番号情報のみが生成されます。
181.351 -.if t .TP 20
181.352 -.if n .TP 15
181.353 -.B \-idl
181.354 -.B rmic
181.355 -によって、指定したクラスおよび参照されたクラスの
181.356 -.SM OMG IDL
181.357 -が生成されます。
181.358 -.SM IDL
181.359 -では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの
181.360 -.SM API
181.361 -を指定できます。
181.362 -.SM IDL
181.363 -は、
181.364 -.SM CORBA
181.365 -バインディングを提供する任意の言語 (Java、C++ など) を使用して、メソッドおよびデータの
181.366 -書き込みおよび呼び出しを行うときの仕様として使われます。
181.367 -.B \-idl
181.368 -オプションは、合わせて以下のオプションも指定できます。
181.369 -.RS
181.370 -.TP 5
181.371 -.BR \-always " または " \-alwaysgenerate
181.372 -既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的に生成し直します。
181.373 -.PD 0
181.374 -.TP
181.375 -.B \-factory
181.376 -生成された IDL で factory キーワードを使います。
181.377 -.TP
181.378 -.B \-idlModule fromJavaPackage[.class] toIDLModule
181.379 -.B IDLEntity
181.380 -パッケージのマッピングを指定します。次に例を示します。
181.381 -.sp 1n
181.382 -.in +5n
181.383 -.ft 3
181.384 +\f2\-iiop\fP 激с潟篏帥祉激с潟絎с障
181.385 +.RS 3
181.386 +.TP 3
181.387 +\-always 障 \-alwaysgenerate
181.388 +√鴻帥Tie IDL ュ鴻違с綣桁句眼障
181.389 +.TP 3
181.390 +\-nolocalstubs
181.391 +祉鴻ゃ≪潟泣若若絲障鴻帥篏障
181.392 +.TP 3
181.393 +\-noValueMethods
181.394 +\f2\-idl\fP 激с潟篏帥違障肴 IDL \f2valuetype\fP <純喝絖菴遵障<純喝絖\f2valuetype\fP 翫激с潟с \f2\-idl\fP 激с潟篏帥 \f2\-noValueMethods\fP 激с潟絎障
181.395 +.TP 3
181.396 +\-poa
181.397 +膓帥 \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP \f2org.omg.PortableServer.Servant\fP 紊障
181.398 +.LP
181.399 +.na
181.400 +\f2Portable Object Adapter\fP @
181.401 +.fi
181.402 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) \f2PortableServer\fP ≪吾ャ若ゃc \f2Servant\fP 絎臂障Java 違潟域茯с\f2Servant\fP Java \f2org.omg.PortableServer.Servant\fP 鴻潟違障 POA 泣若潟絎茖阪鴻紊違<純箴障 <純≪宴若激с潟違若喝冴сPOA 荳若喝冴翫c泣若潟篏九勝若吟若若若ゃ障OMG IDL to Java Language Mapping SpecificationCORBA V 2.3.1 ptc/00\-01\-08.pdf 羣障
181.403 +.RE
181.404 +.TP 3
181.405 +\-J
181.406 +\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝<障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
181.407 +.TP 3
181.408 +\-keep 障 \-keepgenerated
181.409 +鴻帥鴻宴潟障 Tie 鴻 \f2.java\fP 純若鴻<ゃ \f2.class\fP <ゃc罧障
181.410 +.TP 3
181.411 +\-nowarn
181.412 +茘障激с潟絎潟潟ゃ茘茵腓冴障
181.413 +.LP
181.414 +.TP 3
181.415 +\-vcompat
181.416 +1.1 1.2 筝≧鴻 JRMP 鴻帥潟若吾с潟篋с鴻帥潟鴻宴潟鴻篏障(5.0 篁ュ若鴻с激с潟)鴻帥鴻JDK 1.1 篁潟激潟若 1.1 鴻帥潟若吾с潟篏睡JDK 1.2 篁ラ篁潟激潟若 1.2 鴻帥潟若吾с潟篏睡障鴻宴潟鴻с1.1 1.2 筝≧鴻鴻帥潟若吾с潟泣若障鴻筝≧鴻篏≪若泣若泣ゃ冴紊с障
181.417 +.TP 3
181.418 +\-verbose
181.419 +潟潟ゃ潟若潟潟ゃ鴻若鴻<ゃゃ<祉若吾茵腓冴障
181.420 +.LP
181.421 +.TP 3
181.422 +\-v1.1
181.423 +1.1 JRMP 鴻帥潟若吾с潟帥鴻帥潟鴻宴潟鴻障激с潟篏睡сJDK 1.1 \f3rmic\fP 若х≪違若с (ゃ鴻若c潟違篏睡) √鴻帥鴻絲障翫篋с鴻帥鴻翫с
181.424 +.LP
181.425 +.TP 3
181.426 +\-v1.2
181.427 +() 1.2 JRMP 鴻帥潟若吾с潟帥鴻帥鴻障鴻宴潟鴻 1.2 鴻帥潟若吾с潟т戎с激с潟с鴻宴潟鴻障鴻帥鴻JDK 1.1 篁潟激潟若篏障
181.428 +.RE
181.429 +
181.430 +.LP
181.431 +.SH "医紊"
181.432 +.LP
181.433 +
181.434 +.LP
181.435 +.RS 3
181.436 +.TP 3
181.437 +CLASSPATH
181.438 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障罨<箴腓冴障
181.439 +.RS 3
181.440 +
181.441 +.LP
181.442 .nf
181.443 -\-idlModule foo.bar
181.444 -my::real::idlmod.
181.445 +\f3
181.446 +.fl
181.447 +.:/usr/local/java/classes
181.448 +.fl
181.449 +\fP
181.450 .fi
181.451 -.ft 1
181.452 -.in
181.453 -.sp 1n
181.454 -.TP
181.455 -.B \-idlFile fromJavaPackage[.class] toIDLFile
181.456 -.B IDLEntity
181.457 -ファイルのマッピングを指定します。次に例を示します。
181.458 -.sp 1n
181.459 -.ti +5n
181.460 -.B \-idlFile test.pkg.X TEST16.idl
181.461 .RE
181.462 -.PD
181.463 -.if t .TP 20
181.464 -.if n .TP 15
181.465 -.B \-iiop
181.466 -.B rmic
181.467 -は、
181.468 -.SM JRMP
181.469 -のスタブとスケルトンクラスの代わりに、
181.470 -.SM IIOP
181.471 -のスタブと Tie クラスを生成します。スタブクラスは、リモートオブジェクトの
181.472 -ローカルプロキシで、クライアントがサーバに呼び出しを送信するときに
181.473 -使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラス
181.474 -によってリモートインタフェースが実装されます。クライアントでリモートオブジェクト
181.475 -を参照すると、実際にはスタブを参照することになります。Tie クラスは、
181.476 -サーバ側で受信した呼び出しを処理し、その呼び出しを適切な実装クラスにディスパッチ
181.477 -するときに使われます。各実装クラスには、Tie クラスが必要です。
181.478 -.sp 1n
181.479 -.B \-iiop
181.480 -を指定して
181.481 -.B rmic
181.482 -を起動すると、次の命名規約に準拠したスタブと Tie が生成されます。
181.483 -.sp 1n
181.484 -.in +5n
181.485 -.ft 3
181.486 -.nf
181.487 -_<implementationName>_stub.class
181.488 -.sp 1n
181.489 -_<interfaceName>_tie.class
181.490 -.ft 1
181.491 +.RE
181.492 +
181.493 +.LP
181.494 +.SH "∫i"
181.495 +.LP
181.496 +
181.497 +.LP
181.498 +.LP
181.499 +java(1)javac(1)
181.500 +.na
181.501 +\f2CLASSPATH\fP @
181.502 .fi
181.503 -.in
181.504 -.sp 1n
181.505 -.B \-iiop
181.506 -オプションは、合わせて以下のオプションも指定できます。
181.507 -.sp 1n
181.508 -.ne 1
181.509 -.bp
181.510 -.RS
181.511 -.PD 0
181.512 -.TP 5
181.513 -.BR \-always " または " \-alwaysgenerate
181.514 -既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的
181.515 -に生成し直します。
181.516 -.TP
181.517 -.B \-nolocalstubs
181.518 -同じプロセスのクライアントとサーバに対して最適化されたスタブを作成しません。
181.519 -.TP
181.520 -.B \-noValueMethods
181.521 -.B \-idl
181.522 -オプションとともに使用する必要があります。発行された
181.523 -.SM IDL\s0
181.524 -に、valuetype メソッドおよび初期化子を追加しません。このメソッドおよび初期化子
181.525 -は、valuetype のオプションです。
181.526 -.B \-idl
181.527 -オプションを使うときは、
181.528 -.B \-noValueMethods
181.529 -オプションを指定しない限り生成されます。
181.530 -.TP
181.531 -.B \-poa
181.532 -.br
181.533 -継承を
181.534 -.BR org.omg.CORBA_2_3.portable.ObjectImpl から
181.535 -.BR org.omg.PortableServer.Servant\. へ変更します。
181.536 -.RS
181.537 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
181.538 .LP
181.539 -Portable Object Adapter (POA) の
181.540 -.BR PortableServer
181.541 -モジュールは、ネイティブ の servant 型を定義します。
181.542 -Java プログラミング言語では、servant 型は、Java の
181.543 -.BR org.omg.PortableServer.Servant
181.544 -クラスにマップされます。これはすべての POA サーバント実装の基底クラスとして
181.545 -機能し、アプリケーション開発者が呼び出せる多数のメソッドを提供します。また、
181.546 -POA 自体が読み出したり、サーバント動作を制御するためにユーザが上書きした
181.547 -りできるメソッドも提供します。CORBA V 2.3.1 の「OMG IDL to Java Language Mapping Specfication (ptc/00-01-08.pdf)」に基づいています。
181.548 -.RE
181.549 -.PD
181.550 -.RE
181.551 -.TP 20
181.552 -.if t .TP 20
181.553 -.if n .TP 15
181.554 -.B \-J
181.555 -任意の java オプションと
181.556 -併用した場合、
181.557 -\-J の後のオプション (
181.558 -.B \-J
181.559 -とオプションの間は空白文字をいれない)
181.560 -を java インタプリタに
181.561 -渡します。
181.562 -.if t .TP 20
181.563 -.if n .TP 15
181.564 -.B \-keepgenerated
181.565 -スタブ、スケルトンおよび tie クラス用に生成された .java ソースファイルを保持し、.class ファイルと同じディレクトリに書き込みます。
181.566 -.if t .TP 20
181.567 -.if n .TP 15
181.568 -.B \-nowarn
181.569 -警告をオフにします。このオプションを使用した場合、コンパイラは警告を出力しません。
181.570 -.if t .TP 20
181.571 -.if n .TP 15
181.572 -.B \-vcompat
181.573 -1.1 と 1.2 の両方の JRMP スタブプロトコル
181.574 -バージョンと互換性があるスタブおよび
181.575 -スケルトンクラスを生成します (1.5 より前の
181.576 -リリースでは、このオプションはデフォルト)。
181.577 -生成されたスタブクラスは、JDK 1.1 の仮想マシンに
181.578 -読み込まれる場合、1.1 のスタブプロトコルバージョンを
181.579 -使用し、1.2 以降の仮想マシンに読み込まれる場合は、
181.580 -1.2 のスタブプロトコルバージョンを使用します。
181.581 -生成されたスケルトンクラスは、1.1 と 1.2 の両方の
181.582 -スタブプロトコルバージョンをサポートします。
181.583 -生成されたクラスは、両方の操作モードをサポート
181.584 -するため、比較的サイズが大きくなります。
181.585 -.if t .TP 20
181.586 -.if n .TP 15
181.587 -.B \-verbose
181.588 -コンパイラとリンカに詳細情報を出力させます。具体的には、
181.589 -コンパイルされるクラスファイル、およびロードされる
181.590 -クラスファイルに関する情報が出力されます。
181.591 -.TP 15
181.592 -.B \-v1.1
181.593 -JDK 1.1 のスタブプロトコルバージョン
181.594 -専用のスタブおよびスケルトンを作成します。
181.595 -このオプションは、JDK 1.1 から
181.596 -.B rmic
181.597 -によって生成され、アップグレードできない
181.598 -(および動的クラスローディングが使用
181.599 -されていない) 既存の静的に配備された
181.600 -スタブクラスと直列化互換性のあるスタブ
181.601 -クラスを生成する場合にのみ使用します。
181.602 -.if t .TP 20
181.603 -.if n .TP 15
181.604 -.B \-v1.2
181.605 -(デフォルト) 1.2 JRMP のスタブプロトコル
181.606 -バージョン専用のスタブクラスを生成します。
181.607 -スケルトンクラスは 1.2 のスタブプロトコル
181.608 -バージョンで使用されないため、このオプション
181.609 -ではスケルトンクラスが生成されません。
181.610 -生成されたスタブクラスが JDK 1.1 の仮想マシンに
181.611 -読み込まれた場合は、機能しません。
181.612 -.SH 環境変数
181.613 -.if t .TP 20
181.614 -.if n .TP 15
181.615 -.B CLASSPATH
181.616 -ユーザ定義クラスへのパスをシステムに通知するために使用します。
181.617 -ディレクトリはコロンで
181.618 -区切ります。以下に例を示します。
181.619 -.sp 1n
181.620 -.ti +5n
181.621 -.B .:/usr/local/java/classes
181.622 -.SH 関連項目
181.623 -.BR java (1),
181.624 -.BR javac (1),
181.625 -.BR CLASSPATH
181.626 +
181.627 +.LP
181.628 +
182.1 --- a/src/solaris/doc/sun/man/man1/ja/rmid.1 Tue May 12 15:21:55 2009 +0900
182.2 +++ b/src/solaris/doc/sun/man/man1/ja/rmid.1 Thu May 14 00:17:25 2009 -0700
182.3 @@ -1,561 +1,358 @@
182.4 -'\" t
182.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
182.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
182.7 -.\"
182.8 -.\" This code is free software; you can redistribute it and/or modify it
182.9 -.\" under the terms of the GNU General Public License version 2 only, as
182.10 -.\" published by the Free Software Foundation.
182.11 -.\"
182.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
182.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
182.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
182.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
182.16 -.\" accompanied this code).
182.17 -.\"
182.18 -.\" You should have received a copy of the GNU General Public License version
182.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
182.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
182.21 -.\"
182.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
182.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
182.24 -.\" have any questions.
182.25 -.\"
182.26 -.TH rmid 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
182.27 -.SH "名前"
182.28 -rmid \- RMI 起動システムデーモン
182.29 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
182.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
182.31 +."
182.32 +." This code is free software; you can redistribute it and/or modify it
182.33 +." under the terms of the GNU General Public License version 2 only, as
182.34 +." published by the Free Software Foundation.
182.35 +."
182.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
182.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
182.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
182.39 +." version 2 for more details (a copy is included in the LICENSE file that
182.40 +." accompanied this code).
182.41 +."
182.42 +." You should have received a copy of the GNU General Public License version
182.43 +." 2 along with this work; if not, write to the Free Software Foundation,
182.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
182.45 +."
182.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
182.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
182.48 +." have any questions.
182.49 +."
182.50 +.TH rmid 1 "04 May 2009"
182.51 +." Generated from HTML by html2man (author: Eric Armstrong)
182.52 +
182.53 +.LP
182.54 +.SH ""
182.55 +rmid \- Java RMI 莎桁激鴻若≪
182.56 +.LP
182.57 +.RS 3
182.58 +
182.59 +.LP
182.60 +.LP
182.61 +\f3rmid\fP ц儀激鴻若≪潟紮吾с篁潟激 (VM) 脂蚊莎桁с障
182.62 +.LP
182.63 +.RE
182.64 +.SH "綵√"
182.65 .LP
182.66
182.67 .LP
182.68 -.LP
182.69 -\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
182.70 -.LP
182.71 -.SH "形式"
182.72 -.B rmid
182.73 -[
182.74 -.I options
182.75 -]
182.76 -.SH "機能説明"
182.77 -.IX "RMI activation system daemon" "" "RMI activation system daemon \(em \fLrmid\fP"
182.78 -.IX "rmid" "" "\fLrmid\fP \(em RMI activation system daemon"
182.79 -.B rmid
182.80 -ツールは、起動システムデーモンを開始します。起動可能なオブジェクトを起動
182.81 -システムに登録したり、Java VM でアクティブにしたりするには、あらかじめ起動
182.82 -システムデーモンを開始しておく必要があります。
182.83 -起動可能なリモートオブジェクト
182.84 -を使ったプログラムの作成方法についての詳細は、Java RMI の仕様
182.85 +.nf
182.86 +\f3
182.87 +.fl
182.88 +rmid [options]
182.89 +.fl
182.90 +\fP
182.91 .fi
182.92 - (http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html)
182.93 -および起動のチュートリアル
182.94 -.fi
182.95 - (http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.html)
182.96 -を参照してください。
182.97 -.LP
182.98 -起動システムデーモンは、次のようにセキュリティポリシーファイルを指定して
182.99 -.B rmid
182.100 -コマンドを実行することによって開始できます。
182.101 -.LP
182.102 -.ti +5n
182.103 -.B % rmid \-J\-Djava.security.policy=rmid.policy
182.104 -.LP
182.105 -注: Sun の
182.106 -.BR rmid
182.107 -実装を実行する場合、デフォルトではセキュリティポリシーファイルを指定する必要があります。そうすることで、起動グループ用の JVM の起動に、各
182.108 -.B ActivationGroupDesc
182.109 -内の情報を使用できるかどうかを
182.110 -.B rmid
182.111 -が確認できます。特に、
182.112 -.B CommandEnvironment
182.113 -により指定されるコマンドやオプション、および
182.114 -.B ActivationGroupDesc
182.115 -のコンストラクタに渡されるすべての
182.116 -.B プロパティ
182.117 -は、
182.118 -.BR rmid
182.119 -用のセキュリティポリシーファイルで明示的に許可することが必要になりました。
182.120 -.B sun.rmi.activation.execPolicy
182.121 -プロパティの値は、起動グループの JVM の起動に
182.122 -.B ActivationGroupDesc
182.123 -内の情報を使用できるかどうかの判断に
182.124 -.B rmid
182.125 -が使用するポリシーを定義します。
182.126 -.LP
182.127 -.B rmid
182.128 -をデフォルト設定で実行することにより、以下が行われます。
182.129 -.LP
182.130 -.RS
182.131 -.TP 2
182.132 -\(bu
182.133 -このコマンドはアクティベータを起動するとともにデフォルトポートの
182.134 -.BR 1098
182.135 -で内部レジストリを
182.136 -開始し、
182.137 -.LP
182.138 -.PD 0
182.139 -.TP
182.140 -\(bu
182.141 -.B ActivationSystem
182.142 -を
182.143 -.B java.rmi.activation.ActivationSystem
182.144 -という名前に内部レジストリ上でバインドします。
182.145
182.146 .LP
182.147 -.RE
182.148 -レジストリにほかのポートを指定するには、
182.149 -.BR rmid
182.150 -の起動時に
182.151 -.B -port
182.152 -オプションを指定しなければなりません。たとえば、次のようにします。
182.153 -
182.154 -.ti +5n
182.155 -.LP
182.156 -.B rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
182.157 -
182.158 -.LP
182.159 -このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート
182.160 -.B 1099
182.161 -でレジストリを開始します。
182.162 -
182.163 -.LP
182.164 -.SS inetd/xinetd からの rmid の起動
182.165 -
182.166 -コマンド行から
182.167 -.B rmid
182.168 -を起動しないで、
182.169 -inetd (Solaris) または xinetd (Linux) を設定し、
182.170 -.B rmid
182.171 -を必要に応じて起動することができます。
182.172 -
182.173 -.LP
182.174 -起動時に
182.175 -.B rmid
182.176 -は、System.inheritedChannel メソッドを呼び出して
182.177 -継承チャネル (inetd/xinetd からの継承) の
182.178 -取得を試みます。
182.179 -継承されたチャンネルが \f2null\fP であるか、\f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、\f2rmid\fP はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
182.180 -
182.181 -.LP
182.182 -.LP
182.183 -継承チャンネルが ServerSocketChannel
182.184 -インスタンスの場合、
182.185 -.B rmid
182.186 -は ServerSocketChannel から
182.187 -取得した java.net.ServerSocket を、
182.188 -エクスポートするリモートオブジェクト
182.189 -(java.rmi.activation.ActivationSystem が
182.190 -バインドされるレジストリと
182.191 -java.rmi.activation.Activator
182.192 -リモートオブジェクト) に対する要求を
182.193 -受け入れるサーバソケットとして使用します。
182.194 -.LP
182.195 -このモードでは、
182.196 -.B rmid
182.197 -の動作は、次のことを除いて、
182.198 -コマンド行から起動した場合と同じです。
182.199 -
182.200 -.TP 2
182.201 -\(bu System.err に表示される出力はファイルにリダイレクト
182.202 -されます。このファイルは、接頭辞「rmid-err」と接尾辞「tmp」を
182.203 -使用して java.io.tmpdir システムプロパティ
182.204 -(通常 /var/tmp または /tmp) で指定したディレクトリにあります。
182.205 -
182.206 -.TP 2
182.207 -\(bu \-port オプションは許可されていません。このオプションが
182.208 -指定されている場合、
182.209 -.B rmid
182.210 -はエラーメッセージを表示して
182.211 -終了します。
182.212 -
182.213 -.TP 2
182.214 -\(bu \-log オプションは必須です。このオプションが
182.215 -指定されていない場合、
182.216 -.B rmid
182.217 -はエラーメッセージを表示して
182.218 -終了します。
182.219 -
182.220 -.LP
182.221 -必要に応じて開始するサービスの設定方法についての詳細は、
182.222 -inetd (Solaris) または xinetd (Linux) のマニュアルページを
182.223 -参照してください。
182.224 -
182.225 -.SH "オプション"
182.226 -
182.227 -.TP
182.228 -.BI \-C someCommandLineOption
182.229 -.B rmid
182.230 -の子プロセス (起動グループ) が作成されたときに、各子プロセスにコマンド行引数
182.231 -として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム
182.232 -デーモンによって生成される各 Java Virtual Machine にプロパティを渡すことができます。
182.233 -
182.234 -.sp 1n
182.235 -.ti +5n
182.236 -.B rmid \-C\-Dsome.property=value
182.237 -
182.238 -.sp 1n
182.239 -コマンド行引数を子プロセスに渡す機能は、デバッグを行う際に便利です。
182.240 -たとえば、次のようなコマンドを実行できます。
182.241 -
182.242 -.sp 1n
182.243 -.ti +5n
182.244 -.B rmid \-C\-Djava.rmi.server.logCalls=true
182.245 -
182.246 -.sp 1n
182.247 -このコマンドによって、すべての子 JVM でサーバ呼び出しのログが残るようになります。
182.248 -
182.249 -.TP
182.250 -.BI \-J<someCommandLineOption>
182.251 -.B rmid
182.252 -を実行中の java インタプリタに渡すオプションを指定します。たとえば、
182.253 -.B rmid
182.254 -で
182.255 -.BR rmid.policy
182.256 -という名前のポリシーファイルを使用する場合、
182.257 -.BR rmid
182.258 -のコマンド行で
182.259 -.B \-J
182.260 -オプションを使って
182.261 -.B java.security.policy
182.262 -プロパティを定義します。次に例を示します。
182.263 -
182.264 -.sp 1n
182.265 -.ti +5n
182.266 -.B rmid \-J\-Djava.security.policy=rmid.policy
182.267 -
182.268 -.TP
182.269 -.BI \-J\-Dsun.rmi.activation.execPolicy=<policy>
182.270 -起動グループの実行対象となる JVM の起動に使用するコマンドおよびコマンド行オプションを検査するために、
182.271 -.B rmid
182.272 -が採用するポリシーを指定します。このオプションは、Sun の RMI 起動デーモン実装だけに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は
182.273 -.B \-J-Dsun.rmi.activation.execPolicy=default
182.274 -を指定した場合と同じになります。
182.275 -.IR policy
182.276 -に指定可能な値は、
182.277 -.BR default
182.278 -、
182.279 -.IR policyClassName
182.280 -、または none です。
182.281 -.BR
182.282 -
182.283 -.RS
182.284 -.TP 2
182.285 -\(bu
182.286 -.B default
182.287 -(または、このプロパティを指定しない場合)
182.288 -
182.289 -.LP
182.290 -デフォルトの
182.291 -.B execPolicy
182.292 -では、使用するセキュリティポリシーファイル内のコマンドおよびオプションを実行する権限が
182.293 -.B rmid
182.294 -に与えられる場合にのみ、
182.295 -.B rmid
182.296 -は特定のコマンド行オプションを指定してコマンドを実行できます。
182.297 -.BR default
182.298 -の実行ポリシーを使用できるのは、
182.299 -デフォルトの起動グループ実装だけです。
182.300 -.sp 1n
182.301 -
182.302 -.B rmid
182.303 -は、起動グループの JVM を起動する際、その登録された起動グループ記述子である
182.304 -.BR ActivationGroupDesc
182.305 -内の情報を使用します。グループ記述子では、オプションの
182.306 -.B ActivationGroupDesc.CommandEnvironment
182.307 -を指定します。これには、起動グループを開始する「コマンド」、およびコマンド行に追加する
182.308 -任意のコマンド行「オプション」が含まれます。デフォルトでは、
182.309 -.B rmid
182.310 -は
182.311 -.BR java.home
182.312 -にある
182.313 -.B java
182.314 -コマンドを使用します。グループ記述子には、次に示すように、オプションとしてコマンド行に
182.315 -追加される「プロパティ」オーバーライドも含まれます。
182.316 -
182.317 -.sp 1n
182.318 -.ti +5n
182.319 -.BI \-D<property>=<value>
182.320 -
182.321 -.sp 1n
182.322 -アクセス権
182.323 -.B com.sun.rmi.rmid.ExecPermission
182.324 -を使用すると、
182.325 -.B rmid
182.326 -に対し、グループ記述子の
182.327 -.B CommandEnvironment
182.328 -で指定されたコマンドを実行して起動グループを開始する権限を与えることができます。
182.329 -アクセス権
182.330 -.B com.sun.rmi.rmid.ExecOptionPermission
182.331 -を使用すると、起動グループを開始するときに、
182.332 -グループ記述子でプロパティオーバーライドとして指定されたコマンド行
182.333 -オプション、または
182.334 -.BR CommandEnvironment
182.335 -でオプションとして指定されたコマンド行オプションを
182.336 -.B rmid
182.337 -から使用できます。
182.338 -
182.339 -.sp 1n
182.340 -.B rmid
182.341 -にさまざまなコマンドおよびオプションを実行する権限を与える場合、アクセス権
182.342 -.B ExecPermission
182.343 -および
182.344 -.B ExecOptionPermission
182.345 -を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
182.346 -
182.347 -.TP
182.348 -.BI ExecPermission
182.349 -.B ExecPermission
182.350 -クラスは、起動グループを開始するために
182.351 -.B rmid
182.352 -が特定の「コマンド」を実行する権限を表します。
182.353 -.sp 1n
182.354 -.TP
182.355 -.B 構文
182.356 -.br
182.357 -.B ExecPermission
182.358 -の「名前」は、
182.359 -.B rmid
182.360 -に実行権限を与えるコマンドのパス名です。「/*」(「/」はファイル区切り文字、つまり
182.361 -.BR File.separatorChar
182.362 -) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを表します。「/-」
182.363 -で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ
182.364 -(再帰的に) を表します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、
182.365 -任意のファイルに一致します。
182.366 -.sp 1n
182.367 -
182.368 -.B 注:
182.369 -「*」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルを表し、
182.370 -「-」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルと、
182.371 -現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
182.372 -
182.373 -.TP
182.374 -.BI ExecOptionPermission
182.375 -.B ExecOptionPermission
182.376 -クラスは、起動グループの開始時に
182.377 -.B rmid
182.378 -が特定のコマンド行「オプション」を使用する権限を表します。
182.379 -.B ExecOptionPermission
182.380 -の「名前」は、コマンド行オプションの値です。
182.381 -.sp 1n
182.382 -.TP
182.383 -.B 構文
182.384 -.br
182.385 -オプションでは、制限付きワイルドカード指定がサポートされます。
182.386 -アスタリスクは、ワイルドカードマッチングを指定します。アスタリスクは、
182.387 -オプション名自体を表す (つまり、すべてのオプションに一致する) ために
182.388 -使用できます。また、「.」および「=」の次に指定する場合にのみ、
182.389 -オプション名の最後にアスタリスクを使用できます。
182.390 -.sp 1n
182.391 -
182.392 -例を示します。「*」、「-Dfoo.*」、「-Da.b.c=*」は有効です。「*foo」、「-Da*b」
182.393 -、「ab*」は無効です。
182.394 -
182.395 -.TP
182.396 -.BI rmid のポリシーファイル
182.397 -.B rmid
182.398 -にさまざまなコマンドおよびオプションを実行する権限を与える場合は、アクセス権
182.399 -.B ExecPermission
182.400 -および
182.401 -.B ExecOptionPermission
182.402 -を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
182.403 -これらのアクセス権を検査するのは
182.404 -.B rmid
182.405 -だけであるため、普遍的に許可しても安全です。
182.406 -
182.407 -.sp 1n
182.408 -.B rmid
182.409 -にさまざまな実行権限を許可するポリシーファイルの例を、次に示します。
182.410 -
182.411 -.sp 1n
182.412 -.ft 3
182.413 -.nf
182.414 -grant {
182.415 - permission com.sun.rmi.rmid.ExecPermission
182.416 - "/files/apps/java/jdk1.2.2/solaris/bin/java";
182.417 -
182.418 - permission com.sun.rmi.rmid.ExecPermission
182.419 - "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
182.420 -
182.421 - permission com.sun.rmi.rmid.ExecPermission
182.422 - "/files/apps/rmidcmds/*";
182.423 -
182.424 - permission com.sun.rmi.rmid.ExecOptionPermission
182.425 - "-Djava.security.policy=/files/policies/group.policy";
182.426 -
182.427 - permission com.sun.rmi.rmid.ExecOptionPermission
182.428 - "-Djava.security.debug=*";
182.429 -
182.430 - permission com.sun.rmi.rmid.ExecOptionPermission
182.431 - "-Dsun.rmi.*";
182.432 -};
182.433 -
182.434 -.fi
182.435 -.ft 1
182.436 -
182.437 -.sp 1n
182.438 -最初の 2 つのアクセス権は、
182.439 -.B rmid
182.440 -に対し、パス名により明示された 1.2.2 バージョンの
182.441 -.B java
182.442 -コマンドを実行する許可を与えます。デフォルトでは、
182.443 -.B java.home
182.444 -にある
182.445 -.B java
182.446 -コマンドのバージョン (
182.447 -.B rmid
182.448 -が使用するのと同じもの) が使用されるため、ポリシーファイルで指定する必要はありません。
182.449 -3 番目のアクセス権は、
182.450 -.B rmid
182.451 -に対し、ディレクトリ
182.452 -.BR /files/apps/rmidcmds
182.453 -内の任意のコマンドを実行する権限を与えます。
182.454 -
182.455 -.sp 1n
182.456 -4 番目に許可されたアクセス権
182.457 -.BR ExecOptionPermission
182.458 -は、
182.459 -.B rmid
182.460 -に対し、セキュリティポリシーファイルを
182.461 -.BR /files/policies/group.policy
182.462 -に定義する起動グループを開始する権限を与えます。次のアクセス権は、起動グループが
182.463 -.B java.security.debug
182.464 -プロパティを使用する権限を与えます。最後のアクセス権は、
182.465 -起動グループが
182.466 -.B sun.rmi
182.467 -プロパティ名階層内の任意のプロパティを使用する権限を与えます。
182.468 -
182.469 -.sp 1n
182.470 -ポリシーファイルを使って
182.471 -.B rmid
182.472 -を起動するには、
182.473 -.BR rmid
182.474 -のコマンド行で
182.475 -.B java.security.policy
182.476 -プロパティを指定する必要があります。次に例を示します。
182.477 -
182.478 -.sp 1n
182.479 -.ti +5n
182.480 -.B rmid \-J\-Djava.security.policy=rmid.policy
182.481 -
182.482 -.TP 2
182.483 -\(bu
182.484 -.I <policyClassName>
182.485 -
182.486 -.sp 1n
182.487 -デフォルトの動作では十分な柔軟性が得られない場合、管理者は
182.488 -.BR rmid
182.489 -の起動時に、
182.490 -.B checkExecCommand
182.491 -メソッドが実行されるクラスの名前を指定することにより、
182.492 -.BR rmid
182.493 -が実行するコマンドを検査できます。
182.494 -.sp 1n
182.495 -
182.496 -.IR policyClassName
182.497 -には、public で引数を必要としないコンストラクタとともに public クラスを指定します。また、次の
182.498 -.B checkExecCommand
182.499 -メソッド実装も指定します。
182.500 -
182.501 -.sp 1n
182.502 -.ft 3
182.503 -.nf
182.504 -.in +5n
182.505 -public void checkExecCommand(ActivationGroupDesc desc,
182.506 - String[] command)
182.507 - throws SecurityException;
182.508 -.in
182.509 -.fi
182.510 -.ft 1
182.511 -
182.512 -.sp 1n
182.513 -起動グループを開始する前に、
182.514 -.B rmid
182.515 -は、ポリシーの
182.516 -.BR checkExecCommand
182.517 -メソッドを呼び出して、起動グループの記述子および起動グループを開始する完全な
182.518 -コマンドを含む配列を渡します。
182.519 -.B checkExecCommand
182.520 -が
182.521 -.BR SecurityException
182.522 -をスローする場合、
182.523 -.B rmid
182.524 -は起動グループを開始せず、オブジェクトの起動を試みている呼び出し側に
182.525 -.B ActivationException
182.526 -がスローされます。
182.527 -
182.528 -.TP
182.529 -\(bu
182.530 -.B none
182.531 -
182.532 -.sp 1n
182.533 -.B sun.rmi.activation.execPolicy
182.534 -プロパティの値が「none」の場合、
182.535 -.B rmid
182.536 -は、起動グループの開始コマンドの検証を一切行いません。
182.537 -
182.538 -.TP
182.539 -
182.540 -.BI \-log " dir"
182.541 -起動システムデーモンがデータベースおよび関連情報を書き込むのに使う、
182.542 -ディレクトリの名前を指定します。デフォルトでは、
182.543 -.B rmid
182.544 -コマンドを実行したディレクトリに
182.545 -.B log
182.546 -というログディレクトリが作成されます。
182.547 -
182.548 -.TP
182.549 -.BI \-port " port"
182.550 -.BR rmid
182.551 -のレジストリが使うポートを指定します。起動システムデーモンは、
182.552 -.BR java.rmi.activation.ActivationSystem
182.553 -という名前で
182.554 -.BR ActivationSystem
182.555 -をレジストリにバインドします。したがって、ローカルマシンの
182.556 -.B ActivationSystem
182.557 -は、次のように
182.558 -.B Naming.lookup
182.559 -メソッドを呼び出すことによって取得できます。
182.560 -
182.561 -.LP
182.562 -.RS
182.563 -.ft 3
182.564 -.nf
182.565 -import java.rmi.*;
182.566 -import java.rmi.activation.*;
182.567 -
182.568 -ActivationSystem system;
182.569 -system = (ActivationSystem)
182.570 -Naming.lookup("//:port/java.rmi.activation.ActivationSystem");
182.571 -.fl
182.572 -.fi
182.573 -
182.574 -.RE
182.575 -.TP
182.576 -.BI \-stop
182.577 -.B -port
182.578 -オプションによって指定されたポートの、現在の
182.579 -.B rmid
182.580 -の呼び出しを停止します。ポートの指定がない場合は、ポート 1098 で実行されている
182.581 -.B rmid
182.582 -を停止します。
182.583 -.SH "環境変数"
182.584 -.TP 20
182.585 -.SB "CLASSPATH"
182.586 -ユーザ定義クラスへのパスをシステムに通知するために使用します。ディレクトリはコロンで
182.587 -区切ります。以下に例を示します。
182.588 -.RS
182.589 -.LP
182.590 -.ft 3
182.591 -
182.592 -.nf
182.593 -% .:/usr/local/java/classes
182.594 -
182.595 -.fi
182.596 -.ft 1
182.597 -.RE
182.598 -.SH "関連項目"
182.599 +.SH "茯"
182.600 .LP
182.601
182.602 .LP
182.603 .LP
182.604 -rmic、CLASSPATH、java
182.605 +\f3rmid\fP 若莎桁激鴻若≪潟紮障莎桁激鴻若≪潟紮с莎桁純吾с莎桁激鴻脂蚊VM ц儀с障莎桁純≪若吾с篏帥c違篏号荅括完
182.606 +.na
182.607 +\f2Java RMI 篁罕\fP @
182.608 +.fi
182.609 +http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html
182.610 +.na
182.611 +\f2莎桁ャ若≪\fP @
182.612 +.fi
182.613 +http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlс
182.614 +.LP
182.615 +.LP
182.616 +若≪潟莎桁罨<祉ャc若激若<ゃ絎 \f2rmid\fP 潟潟絎茵障
182.617 +.LP
182.618 +.nf
182.619 +\f3
182.620 +.fl
182.621 + rmid \-J\-Djava.security.policy=rmid.policy
182.622 +.fl
182.623 +\fP
182.624 +.fi
182.625 +
182.626 +.LP
182.627 +.LP
182.628 +\f3羈:\fP\f2rmid\fP Sun 絎茖絎茵翫с祉ャc若激若<ゃ絎綽荀障 莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡с \f2rmid\fP 罎荐若сс鴻\f2ActivationGroupDesc\fP 潟潟鴻帥羝< \f2CommandEnvironment\fP 篁紙 \f2Properties\fP c絎潟潟潟激с潟\f2rmid\fP 祉ャc若激若<ゃ筝ф腓榊荐怨綽荀障\f2sun.rmi.activation.execPolicy\fP c若ゃ莎桁違若 VM 莎桁 \f2ActivationGroupDesc\fP 宴篏睡сゆ \f2rmid\fP 篏睡激若羆阪障
182.629 +.LP
182.630 +.LP
182.631 +\f2rmid\fP 荐絎у茵罨<茵障
182.632 +.LP
182.633 +.RS 3
182.634 +.TP 2
182.635 +o
182.636 +≪c若帥莎桁若 1098 у吾鴻莎桁
182.637 +.TP 2
182.638 +o
182.639 +吾鴻筝с\f2ActivationSystem\fP \f2java.rmi.activation.ActivationSystem\fP ゃ潟
182.640 +.RE
182.641 +
182.642 +.LP
182.643 +.LP
182.644 +吾鴻祉若絎\f2rmid\fP 莎桁 \f2\-port\fP 激с潟絎違障罨<箴腓冴障
182.645 +.LP
182.646 +.nf
182.647 +\f3
182.648 +.fl
182.649 + rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
182.650 +.fl
182.651 +\fP
182.652 +.fi
182.653 +
182.654 +.LP
182.655 +.LP
182.656 +潟潟莎桁激鴻若≪潟紮吾鴻若 1099 с吾鴻紮障
182.657 +.LP
182.658 +.SS
182.659 +rmid inetd/xinetd 紮
182.660 +.LP
182.661 +.LP
182.662 +\f2rmid\fP 潟潟茵紮\f2inetd\fP (Solaris 翫)障 \f2xinetd\fP (Linux) 罕 \f2rmid\fP 綽荀綽紮号障
182.663 +.LP
182.664 +.LP
182.665 +\f2rmid\fP 紮\f2System.inheritedChannel\fP <純若喝冴膓帥c潟 (\f2inetd\fP/\f2xinetd\fP 膓) 緇障膓帥c潟 \f2null\fP с\f2java.nio.channels.ServerSocketChannel\fP ゃ潟鴻帥潟鴻сc翫\f2rmid\fP c潟 \f2inetd\fP/\f2xinetd\fP c莎桁сゆ菴違莎桁障
182.666 +.LP
182.667 +.LP
182.668 +膓帥c潟 \f2ServerSocketChannel\fP ゃ潟鴻帥潟鴻с翫鴻若≪若吾сゃ障 \f2java.rmi.activation.ActivationSystem\fP ゃ潟吾鴻 \f2java.rmi.activation.Activator\fP ≪若吾с絲障荀羆篆<泣若若純宴\f2ServerSocketChannel\fP 緇 \f2java.net.ServerSocket\fP \f2rmid\fP с篏睡障≪若с\f2rmid\fP 篏罨<ゃ 潟潟茵莎桁翫с
182.669 +.LP
182.670 +.RS 3
182.671 +.TP 2
182.672 +o
182.673 +\f2System.err\fP 絲障阪<ゃゃ<ゃ \f2java.io.tmpdir\fP 激鴻c若ф絎c (絽吾 \f2/var/tmp\fP 障 \f2/tmp\fP) <ゃ・莨 \f2rmid\-err\fP с・絨乗 \f2"tmp"\fP с
182.674 +.TP 2
182.675 +o
182.676 +\f2\-port\fP 激с潟激с潟絎\f2rmid\fP 若<祉若吾冴腟篋
182.677 +.TP 2
182.678 +o
182.679 +\f2\-log\fP 激с潟綽激с潟絎\f2rmid\fP 若<祉若吾冴腟篋
182.680 +.RE
182.681 +
182.682 +.LP
182.683 +.LP
182.684 +綽荀綽泣若鴻紮荐絎荅括完ゃ\f2inetd\fP (Solaris) 障 \f2xinetd\fP (Linux) ャ≪若吾с
182.685 +.LP
182.686 +.SH "激с"
182.687 +.LP
182.688 +
182.689 +.LP
182.690 +.RS 3
182.691 +.TP 3
182.692 +\-C<someCommandLineOption>
182.693 +\f2rmid\fP 絖祉 (莎桁違若) 篏絖祉鴻潟潟茵綣違羝<激с潟絎障違罨<絎莎桁激鴻若 潟c篁潟激潟c若羝<с障
182.694 +.nf
182.695 +\f3
182.696 +.fl
182.697 + rmid \-C\-Dsome.property=value
182.698 +.fl
182.699 +\fP
182.700 +.fi
182.701 +潟潟茵綣違絖祉鴻羝<罘純違茵翫箴水с違罨<潟潟絎茵с障
182.702 +.nf
182.703 +\f3
182.704 +.fl
182.705 + rmid \-C\-Djava.rmi.server.logCalls=true
182.706 +.fl
182.707 +\fP
182.708 +.fi
182.709 +潟潟鴻絖 VM с泣若弱若喝冴違篏障
182.710 +.LP
182.711 +.TP 3
182.712 +\-J<someCommandLineOption>
182.713 +\f2rmid\fP 絎茵 \f2java\fP ゃ潟帥帥羝<激с潟絎障違\f2rmid\fP \f2rmid.policy\fP 激若<ゃ篏睡絎\f2rmid\fP 潟潟茵 \f2\-J\fP 激с潟篏帥c\f2java.security.policy\fP c若絎臂障 罨<箴腓冴障
182.714 +.nf
182.715 +\f3
182.716 +.fl
182.717 + rmid \-J\-Djava.security.policy=rmid.policy
182.718 +.fl
182.719 +\fP
182.720 +.fi
182.721 +.TP 3
182.722 +\-J\-Dsun.rmi.activation.execPolicy=<policy>
182.723 +莎桁違若絎茵 VM 莎桁篏睡潟潟潟潟潟茵激с潟с\f2rmid\fP 。激若絎障激с潟Java RMI 莎桁若≪潟 Sun 絎茖絖羈潟潟茵c若絎翫腟 \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP 絎翫障\f2<policy>\fP 絎純ゃ\f2default\fP\f2<policyClassName>\fP障 \f2none\fP с ゃゃ茯障
182.724 +.LP
182.725 +.RS 3
182.726 +.TP 2
182.727 +o
182.728 +\f3default (障c若絎翫)\fP
182.729 +.LP
182.730 + \f2execPolicy\fP 翫\f2rmid\fP 絎茵с\f2rmid\fP 篏睡 祉ャc若激若<ゃ筝с絎茵罔 \f2rmid\fP 筝潟潟潟潟潟茵激с潟с絎茵激若т戎с莎桁違若絎茖с
182.731 +.LP
182.732 +\f2rmid\fP 莎桁違若 VM 莎桁違若ゃ脂蚊莎桁違若荐菴医с \f2ActivationGroupDesc\fP 宴篏睡障違若荐菴医\f2ActivationGroupDesc.CommandEnvironment\fP 絎障 (ュ) 莎桁違若紮潟潟潟潟茵菴遵с潟潟茵激с潟障障с\f2rmid\fP \f2java.home\fP \f2java\fP 潟潟篏睡障違若荐菴医激с潟潟潟茵菴遵c若若若ゃ障障 c若罨<絎臂障
182.733 +.nf
182.734 +\f3
182.735 +.fl
182.736 + \-D\fP\f4<property>\fP\f3=\fP\f4<value>\fP\f3
182.737 +.fl
182.738 +\fP
182.739 +.fi
182.740 +.LP
182.741 +≪祉号┤ \f2com.sun.rmi.rmid.ExecPermission\fP 篏睡違若荐菴医 \f2CommandEnvironment\fP ф絎潟潟絎茵莎桁違若紮罔\f2rmid\fP 絲障荐怨с障≪祉号┤ \f2com.sun.rmi.rmid.ExecOptionPermission\fP 篏睡違若荐菴医сc若若若ゃ絎潟潟茵激с潟障 \f2CommandEnvironment\fP с激с潟絎潟潟茵激с潟莎桁違若紮 \f2rmid\fP 篏睡с障
182.742 +.LP
182.743 +\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障
182.744 +.RS 3
182.745 +.TP 3
182.746 +ExecPermission
182.747 +\f2ExecPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟絎茵罔茵障
182.748 +.LP
182.749 +\f3罕\fP
182.750 +.br
182.751 +\f2ExecPermission\fP \f2rmid\fP 絎茵荐怨潟潟劫с/* (/<ゃ阪絖 \f2File.separatorChar\fP) х劫c障鴻<ゃ腓冴障/\-х劫c障鴻<ゃ泣c (絽亥) 腓冴障劫劫ャ若潟<<ALL FILES>>絎翫\f3篁紙\fP<ゃ腓冴障
182.752 +.LP
182.753 +\f3羈:\fP* 1 ゆ絎劫憜c鴻<ゃ茵障 障\- 1 ゆ絎劫憜c鴻<ゃ憜c障鴻<ゃ泣c (絽亥) 茵障
182.754 +.TP 3
182.755 +ExecOptionPermission
182.756 +\f2ExecOptionPermission\fP 鴻莎桁違若紮 \f2rmid\fP 劫潟潟茵激с潟篏睡с罔茵障\f2ExecOptionPermission\fP 潟潟茵激с潟ゃс
182.757 +.LP
182.758 +\f3罕\fP
182.759 +.br
182.760 +激с潟сゃ若絎泣若障≪鴻帥鴻ゃ若茵障 ≪鴻帥鴻激с喝篏睡с障 ゃ障篁紙激с潟茵с障 障激с喝絨障篏睡с障 .=翫≪鴻帥鴻絎綽荀障
182.761 +.LP
182.762 +箴腓冴障*\-Dfoo.*\-Da.b.c=*鴻с*foo\-Da*bab*≦鴻с
182.763 +.TP 3
182.764 +rmid 激若<ゃ
182.765 +\f2rmid\fP 障障潟潟潟激с潟絎茵罔荐怨翫≪祉号┤ \f2ExecPermission\fP \f2ExecOptionPermission\fP 羆荐怨綽荀障 ゃ障鴻潟若純若鴻絲障荐怨障≪祉号┤с \f2rmid\fP с≪祉号┤羆荐怨絎с
182.766 +.LP
182.767 +\f2rmid\fP 腮絎茵罔荐怨激若<ゃ箴罨<腓冴障
182.768 +.nf
182.769 +\f3
182.770 +.fl
182.771 +grant {
182.772 +.fl
182.773 + permission com.sun.rmi.rmid.ExecPermission
182.774 +.fl
182.775 + "/files/apps/java/jdk1.2.2/solaris/bin/java";
182.776 +.fl
182.777 +
182.778 +.fl
182.779 + permission com.sun.rmi.rmid.ExecPermission
182.780 +.fl
182.781 + "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
182.782 +.fl
182.783 +
182.784 +.fl
182.785 + permission com.sun.rmi.rmid.ExecPermission
182.786 +.fl
182.787 + "/files/apps/rmidcmds/*";
182.788 +.fl
182.789 +
182.790 +.fl
182.791 + permission com.sun.rmi.rmid.ExecOptionPermission
182.792 +.fl
182.793 + "\-Djava.security.policy=/files/policies/group.policy";
182.794 +.fl
182.795 +
182.796 +.fl
182.797 + permission com.sun.rmi.rmid.ExecOptionPermission
182.798 +.fl
182.799 + "\-Djava.security.debug=*";
182.800 +.fl
182.801 +
182.802 +.fl
182.803 + permission com.sun.rmi.rmid.ExecOptionPermission
182.804 +.fl
182.805 + "\-Dsun.rmi.*";
182.806 +.fl
182.807 +};
182.808 +.fl
182.809 +\fP
182.810 +.fi
182.811 + 2 ゃ篁筝≪祉号┤\f2rmid\fP 絲障劫腓榊絎 \f2java\fP 潟潟 \f2java_g\fP 潟潟 1.2.2 若吾с潟絎茵荐怨障с\f2java.home\fP 若吾с潟 \f2java\fP 潟潟 (\f2rmid\fP 篏睡若吾с) 篏睡潟潟激若<ゃф絎綽荀障3 ≪祉号┤\f2rmid\fP 絲障c \f2/files/apps/rmidcmds\fP 篁紙潟潟絎茵罔荐怨障
182.812 +.LP
182.813 +4 ≪祉号┤ \f2ExecOptionPermission\fP \f2rmid\fP 絲障祉ャc若激若<ゃ \f2/files/policies/group.policy\fP 絎臂莎桁違若紮荐怨障5 ≪祉号┤莎桁違若 \f2java.security.debug\fP c若篏睡荐怨障緇≪祉号┤莎桁違若 \f2sun.rmi\fP c弱絮ゅ篁紙c若篏睡荐怨障
182.814 +.LP
182.815 +激若<ゃ絎 \f2rmid\fP 莎桁\f2rmid\fP 潟潟茵 \f2java.security.policy\fP c若絎綽荀障 罨<箴腓冴障
182.816 +.RS 3
182.817 +
182.818 +.LP
182.819 +.LP
182.820 +\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
182.821 +.LP
182.822 +.RE
182.823 +.RE
182.824 +.TP 2
182.825 +o
182.826 +.LP
182.827 +.TP 2
182.828 +o
182.829 +\f4<policyClassName>\fP
182.830 +.LP
182.831 +篏с荵с緇翫膊∞\f2rmid\fP 莎桁\f2checkExecCommand\fP <純絮鴻絎rmid 絎茵潟潟сс障
182.832 +.LP
182.833 +\f2policyClassName\fP 綣違潟潟鴻帥<罨< \f2checkExecCommand\fP <純絎茖 public 鴻絎障
182.834 +.nf
182.835 +\f3
182.836 +.fl
182.837 + public void checkExecCommand(ActivationGroupDesc desc,
182.838 +.fl
182.839 + String[] command)
182.840 +.fl
182.841 + throws SecurityException;
182.842 +.fl
182.843 +\fP
182.844 +.fi
182.845 +莎桁違若紮\f2rmid\fP 激若 \f2checkExecCommand\fP <純若喝冴障莎桁違若荐菴医莎桁違若紮絎潟潟<純羝<障\f2checkExecCommand\fP \f2SecurityException\fP 鴻若\f2rmid\fP 莎桁違若紮吾с莎桁荅茵若喝冴眼 \f2ActivationException\fP 鴻若障
182.846 +.LP
182.847 +.TP 2
182.848 +o
182.849 +\f3none\fP
182.850 +.LP
182.851 +\f2sun.rmi.activation.execPolicy\fP c若ゃnone翫\f2rmid\fP 莎桁違若紮潟潟障c閌荐若障
182.852 +.RE
182.853 +.LP
182.854 +.TP 3
182.855 +\-log dir
182.856 +莎桁激鴻若≪潟若帥若鴻渇∫f宴吾莨若篏帥c絎障с\f2rmid\fP 潟潟絎茵c\f2log\fP 違c篏障
182.857 +.LP
182.858 +.TP 3
182.859 +\-port port
182.860 +\f2rmid\fP 吾鴻篏帥若絎障莎桁激鴻若≪潟吾鴻筝с\f2java.rmi.activation.ActivationSystem\fP \f2ActivationSystem\fP ゃ潟障c若激割 \f2ActivationSystem\fP 罨< \f2Naming.lookup\fP <純若喝冴c緇с障
182.861 +.nf
182.862 +\f3
182.863 +.fl
182.864 + import java.rmi.*;
182.865 +.fl
182.866 + import java.rmi.activation.*;
182.867 +.fl
182.868 +
182.869 +.fl
182.870 + ActivationSystem system; system = (ActivationSystem)
182.871 +.fl
182.872 + Naming.lookup("//:\fP\f4port\fP/java.rmi.activation.ActivationSystem");
182.873 +.fl
182.874 +.fi
182.875 +.TP 3
182.876 +\-stop
182.877 +\f2\-port\fP 激с潟c絎若憜 \f2rmid\fP 若喝冴罩≪障若絎翫若 1098 у茵 \f2rmid\fP 罩≪障
182.878 +.RE
182.879 +.SH "医紊"
182.880 +.LP
182.881 +
182.882 +.LP
182.883 +.RS 3
182.884 +.TP 3
182.885 +CLASSPATH
182.886 +若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障箴腓冴障
182.887 +.nf
182.888 +\f3
182.889 +.fl
182.890 + .:/usr/local/java/classes
182.891 +.fl
182.892 +\fP
182.893 +.fi
182.894 +.RE
182.895 +
182.896 +.LP
182.897 +.SH "∫i"
182.898 +.LP
182.899 +
182.900 +.LP
182.901 +.LP
182.902 +rmic(1)
182.903 +.na
182.904 +\f2CLASSPATH\fP @
182.905 +.fi
182.906 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathjava(1)
182.907 .LP
182.908
182.909 .LP
183.1 --- a/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Tue May 12 15:21:55 2009 +0900
183.2 +++ b/src/solaris/doc/sun/man/man1/ja/rmiregistry.1 Thu May 14 00:17:25 2009 -0700
183.3 @@ -1,106 +1,99 @@
183.4 -'\" t
183.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
183.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
183.7 -.\"
183.8 -.\" This code is free software; you can redistribute it and/or modify it
183.9 -.\" under the terms of the GNU General Public License version 2 only, as
183.10 -.\" published by the Free Software Foundation.
183.11 -.\"
183.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
183.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
183.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
183.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
183.16 -.\" accompanied this code).
183.17 -.\"
183.18 -.\" You should have received a copy of the GNU General Public License version
183.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
183.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
183.21 -.\"
183.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
183.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
183.24 -.\" have any questions.
183.25 -.\"
183.26 -.TH rmiregistry 1 "2004 年 6 月 22 日"
183.27 -.SH "名前"
183.28 -rmiregistry \- Java リモートオブジェクトレジストリ
183.29 -.\"
183.30 -.\" This document was created by saving an HTML file as text
183.31 -.\" from the JavaSoft web site:
183.32 -.\"
183.33 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
183.34 -.\"
183.35 -.\" and adding appropriate troff macros. Because the JavaSoft web site
183.36 -.\" man pages can change without notice, it may be helpful to diff
183.37 -.\" files to identify changes other than new functionality.
183.38 -.\"
183.39 -.SH "形式"
183.40 -.B rmiregistry
183.41 -[
183.42 -.I port
183.43 -]
183.44 -.SH "機能説明"
183.45 -.IX "Java remote object registry" "" "Java remote object registry \(em \fLrmiregistry\fP"
183.46 -.IX "rmiregistry" "" "\fLrmiregistry\fP \(em Java remote object registry"
183.47 -.B rmiregistry
183.48 -コマンドは、現在のホスト上の指定されたポートに、リモートオブジェクト
183.49 -レジストリを作成し起動します。
183.50 -ポート番号が省略された場合には、ポート
183.51 -1099
183.52 -が使用されます。
183.53 -.B rmiregistry
183.54 -はバックグラウンドで実行され、何も出力しません。
183.55 -以下に指定例を示します。
183.56 +." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
183.57 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
183.58 +."
183.59 +." This code is free software; you can redistribute it and/or modify it
183.60 +." under the terms of the GNU General Public License version 2 only, as
183.61 +." published by the Free Software Foundation.
183.62 +."
183.63 +." This code is distributed in the hope that it will be useful, but WITHOUT
183.64 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
183.65 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
183.66 +." version 2 for more details (a copy is included in the LICENSE file that
183.67 +." accompanied this code).
183.68 +."
183.69 +." You should have received a copy of the GNU General Public License version
183.70 +." 2 along with this work; if not, write to the Free Software Foundation,
183.71 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
183.72 +."
183.73 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
183.74 +." CA 95054 USA or visit www.sun.com if you need additional information or
183.75 +." have any questions.
183.76 +."
183.77 +.TH rmiregistry 1 "04 May 2009"
183.78 +." Generated from HTML by html2man (author: Eric Armstrong)
183.79 +
183.80 .LP
183.81 -.RS
183.82 -.B example% rmiregistry &
183.83 +.SH ""
183.84 +rmiregistry \- Java ≪若吾с吾鴻
183.85 +.LP
183.86 +.RS 3
183.87 +
183.88 +.LP
183.89 +.LP
183.90 +\f3rmiregistry\fP 潟潟憜鴻絎若筝≪若吾с吾鴻紮障
183.91 +.LP
183.92 .RE
183.93 +.SH "綵√"
183.94 .LP
183.95 -リモートオブジェクトレジストリはブートストラップネームサービスで、
183.96 -ホスト上の
183.97 -RMI
183.98 -サーバがリモートオブジェクトに名前をバインドするために使用します。
183.99 -名前がついたあとは、クライアント側でリモートオブジェクトを探して
183.100 -リモートメソッドを呼び出すことができます。
183.101 +
183.102 .LP
183.103 -レジストリは通常、アプリケーションがメソッドを呼び出す必要がある
183.104 -最初のリモートオブジェクトを指定するために使用されます。
183.105 -そのあと、そのオブジェクトを使って、アプリケーション固有の
183.106 -方法で他のオブジェクトを探すことが可能になります。
183.107 +.nf
183.108 +\f3
183.109 +.fl
183.110 +rmiregistry [\fP\f4port\fP\f3]
183.111 +.fl
183.112 +\fP
183.113 +.fi
183.114 +
183.115 .LP
183.116 -.B java.rmi.registry.LocateRegistry
183.117 -クラスのメソッドは、特定のホストまたは特定のホストとポート上で
183.118 -動作しているレジストリを得るために用いられます。
183.119 +.SH "茯"
183.120 .LP
183.121 -.B java.rmi.Naming
183.122 -クラスの
183.123 -URL
183.124 -用のメソッドはレジストリを操作するもので、
183.125 -リモートオブジェクトの探索、リモートオブジェクトへの
183.126 -名前
183.127 -(文字列)
183.128 -のバインド、新たな名前のバインド
183.129 -(以前のバインドを上書き)、
183.130 -バインドの取り消し、およびレジストリ中でバインドされている
183.131 -URL
183.132 -の一覧表示が可能です。
183.133 -.SH "オプション"
183.134 -以下のオプションが使用できます。
183.135 -.TP 15
183.136 -.BI \-J option
183.137 -java オプションと組み合わせて使います
183.138 -(
183.139 -.B \-J
183.140 -と java オプションの間にスペースは必要ありません)。
183.141 -.B \-J
183.142 -の後ろに続くオプションを java インタプリタに渡します。
183.143 -.SH "関連項目"
183.144 -次については、
183.145 -.BR java.sun.com
183.146 -を参照または検索してください。
183.147 -.TP 5
183.148 -.B java.rmi.Naming @
183.149 -http://java.sun.com/j2se/1.5/docs/api/java/rmi/Naming.html
183.150 -.TP 5
183.151 -.B java.rmi.registry.LocateRegistry @
183.152 -http://java.sun.com/j2se/1.5/docs/api/java/rmi/registry/LocateRegistry.html
183.153
183.154 +.LP
183.155 +.LP
183.156 +\f3rmiregistry\fP 潟潟憜鴻絎 \f2port\fP 筝≪若吾с吾鴻篏紮障\f2port\fP 絎ャ翫吾鴻若 1099 ч紮障\f3rmiregistry\fP 潟潟阪罘純障絽吾違潟у茵障箴腓冴障
183.157 +.LP
183.158 +.LP
183.159 +\f2rmiregistry&\fP
183.160 +.LP
183.161 +.LP
183.162 +≪若吾с吾鴻若鴻若泣若鴻с 筝鴻 RMI 泣若若≪若吾сゃ潟篏睡障罨<若潟≪若鴻ゃ≪潟≪若吾с罎膣≪≪若<純若喝冴茵障
183.163 +.LP
183.164 +.LP
183.165 +吾鴻筝≪若吾с篏臀絎障 с≪宴若激с潟<純若喝冴綽荀障篁cc吾с≪宴若激с恰絎泣若箴篁吾с「障
183.166 +.LP
183.167 +.LP
183.168 +\f2java.rmi.registry.LocateRegistry\fP 鴻<純若鴻障若鴻若у篏吾鴻緇篏睡障
183.169 +.LP
183.170 +.LP
183.171 +\f2java.rmi.Naming\fP 鴻 URL 若鴻<純吾鴻у篏篁紙鴻潟若鴻筝≪若吾с罎膣≪篏睡障≪若吾с膣 (絖) ゃ潟違ゃ潟 (ゃゃ潟若若ゃ) 障 障≪若吾с≪潟ゃ潟吾鴻ゃ潟 URL 阪障
183.172 +.LP
183.173 +.SH "激с"
183.174 +.LP
183.175 +
183.176 +.LP
183.177 +.RS 3
183.178 +.TP 3
183.179 +\-J
183.180 +\f2\-J\fP 緇膓激с潟 \f2java\fP ゃ潟帥帥綣羝<障 \f2java\fP 激с潟腟水篏帥障 (\f2\-J\fP \f2java\fP 激с潟鴻若鴻ャ)
183.181 +.RE
183.182 +
183.183 +.LP
183.184 +.SH "∫i"
183.185 +.LP
183.186 +
183.187 +.LP
183.188 +.LP
183.189 +java(1)
183.190 +.na
183.191 +\f2java.rmi.registry.LocateRegistry\fP @
183.192 +.fi
183.193 +http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html
183.194 +.na
183.195 +\f2java.rmi.Naming\fP @
183.196 +.fi
183.197 +http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
183.198 +.LP
183.199 +
183.200 +.LP
183.201 +
184.1 --- a/src/solaris/doc/sun/man/man1/ja/schemagen.1 Tue May 12 15:21:55 2009 +0900
184.2 +++ b/src/solaris/doc/sun/man/man1/ja/schemagen.1 Thu May 14 00:17:25 2009 -0700
184.3 @@ -1,5 +1,4 @@
184.4 -.'" t
184.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
184.6 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
184.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
184.8 ."
184.9 ." This code is free software; you can redistribute it and/or modify it
184.10 @@ -19,61 +18,44 @@
184.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
184.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
184.13 ." have any questions.
184.14 -." `
184.15 -.TH schemagen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
184.16 -." Generated by html2roff
184.17 +."
184.18 +.TH schemagen 1 "04 May 2009"
184.19 +." Generated from HTML by html2man (author: Eric Armstrong)
184.20
184.21 .LP
184.22 -.ad c
184.23 -.SH 名前
184.24 -XML バインドのための Java(TM) アーキテクチャ
184.25 +.SH ""
184.26 +schemagen \- XML ゃ潟 Java(TM) ≪若c若鴻若吾с若
184.27 +.LP
184.28 +.LP
184.29 +\f3篁罕若吾с:\fP 2.1
184.30 .br
184.31 -スキーマジェネレータ\f3仕様のバージョン:\fP 2.0
184.32 -.br
184.33 -\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
184.34 -.br
184.35 -.ad l
184.36 +\f3絎茖若吾с:\fP 2.1.3
184.37 .LP
184.38 .SS
184.39 -schemagen の起動
184.40 +schemagen 莎桁
184.41 .LP
184.42 .LP
184.43 -スキーマジェネレータは、ユーザーのプラットフォームの \f2bin\fP ディレクトリにある \f2schemagen\fP シェルスクリプトを使って起動できます。
184.44 +鴻若吾с若帥若吟若若 \f2bin\fP c \f2schemagen\fP 激с鴻篏帥c莎桁с障
184.45 .LP
184.46 .LP
184.47 -現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
184.48 +憜鴻若吾с若帥Java 純若鴻<ゃ鴻<ゃс障
184.49 .LP
184.50 .LP
184.51 -また、スキーマジェネレータを実行するための Ant タスクも用意されています。schemagen を Ant とともに使用するための手順を参照してください。
184.52 +障鴻若吾с若帥絎茵 Ant 帥鴻障
184.53 +.na
184.54 +\f2schemagen Ant 篏睡\fP @
184.55 +.fi
184.56 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlс
184.57 .LP
184.58 .RS 3
184.59
184.60 .LP
184.61 -\f3Solaris/Linux の場合\fP
184.62 -.LP
184.63 .nf
184.64 \f3
184.65 .fl
184.66 - % path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
184.67 +% schemagen.sh Foo.java Bar.java ...
184.68 .fl
184.69 - Note: Writing schema1.xsd
184.70 -.fl
184.71 -
184.72 -.fl
184.73 -\fP
184.74 -.fi
184.75 -
184.76 -.LP
184.77 -\f3WindowsNT/2000/XP の場合\fP
184.78 -.LP
184.79 -.nf
184.80 -\f3
184.81 -.fl
184.82 - > path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
184.83 -.fl
184.84 - Note: Writing schema1.xsd
184.85 -.fl
184.86 -
184.87 +羈: Writing schema1.xsd
184.88 .fl
184.89 \fP
184.90 .fi
184.91 @@ -81,43 +63,70 @@
184.92
184.93 .LP
184.94 .LP
184.95 -ユーザの Java ソース/クラスがほかのクラスを参照している場合、システムの CLASSPATH 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP オプションを使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
184.96 +若吟若 Java 純若/鴻祉鴻с翫激鴻 CLASSPATH 医紊亥宴с鴻≪祉鴻сc \f2\-classpath\fP/\f2\-cp\fP 激с潟篏帥c鴻若絎綽荀障鴻若若榊障
184.97 .LP
184.98 .RS 3
184.99
184.100 .LP
184.101 -\f3コマンド行オプション\fP
184.102 +\f3潟潟茵激с\fP
184.103 .LP
184.104 +.RS 3
184.105
184.106 .LP
184.107 .nf
184.108 \f3
184.109 .fl
184.110 -使用法: schemagen [\-options ...] <java files>
184.111 +篏睡号: schemagen [\-options ...] <java files>
184.112 .fl
184.113
184.114 .fl
184.115 -オプション:
184.116 +激с:
184.117 .fl
184.118 - \-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します
184.119 + \-d <path> : 祉泣 javac 鴻<ゃ臀贋絎障
184.120 .fl
184.121 - \-cp <path> : ユーザ指定ファイルの検索場所を指定します
184.122 + \-cp <path> : 若吟惹絎<ゃ罎膣√贋絎障
184.123 .fl
184.124 - \-classpath <path> : ユーザ指定ファイルの検索場所を指定します
184.125 + \-classpath <path> : 若吟惹絎<ゃ罎膣√贋絎障
184.126 .fl
184.127 - \-help : この使用方法に関するメッセージを表示します
184.128 -.fl
184.129 -
184.130 + \-help : 篏睡号≪<祉若吾茵腓冴障
184.131 .fl
184.132 \fP
184.133 .fi
184.134 +.RE
184.135
184.136 .LP
184.137 .RE
184.138 .SS
184.139 -生成されるリソースファイル
184.140 +純若鴻<ゃ
184.141 .LP
184.142 .LP
184.143 -現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、スキーマジェネレータの ant タスクを使用してください。
184.144 +憜鴻若吾с若帥膣Java 劫ус腥咲 1 ゃ鴻若<ゃ篏障鴻若<ゃ九勝号憝鴻с絖障
184.145 +.na
184.146 +\f2鴻若吾с若帥 Ant 帥鴻\fP @
184.147 +.fi
184.148 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html篏睡
184.149 +.LP
184.150 +.SH "∫i"
184.151 +.LP
184.152 +.RS 3
184.153 +.TP 2
184.154 +o
184.155 +鴻若吾с若帥絎茵 (schemagen):[
184.156 +.na
184.157 +\f2潟潟茵巡擦\fP @
184.158 +.fi
184.159 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html
184.160 +.na
184.161 +\f2SchemaGen Ant 篏睡\fP @
184.162 +.fi
184.163 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
184.164 +.TP 2
184.165 +o
184.166 +.na
184.167 +\f2XML ゃ潟 JavaTM ≪若c (JAXB)\fP @
184.168 +.fi
184.169 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
184.170 +.RE
184.171 +
184.172 .LP
184.173
185.1 --- a/src/solaris/doc/sun/man/man1/ja/serialver.1 Tue May 12 15:21:55 2009 +0900
185.2 +++ b/src/solaris/doc/sun/man/man1/ja/serialver.1 Thu May 14 00:17:25 2009 -0700
185.3 @@ -1,98 +1,98 @@
185.4 -'\" t
185.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
185.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
185.7 -.\"
185.8 -.\" This code is free software; you can redistribute it and/or modify it
185.9 -.\" under the terms of the GNU General Public License version 2 only, as
185.10 -.\" published by the Free Software Foundation.
185.11 -.\"
185.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
185.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
185.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
185.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
185.16 -.\" accompanied this code).
185.17 -.\"
185.18 -.\" You should have received a copy of the GNU General Public License version
185.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
185.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
185.21 -.\"
185.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
185.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
185.24 -.\" have any questions.
185.25 -.\"
185.26 -.TH serialver 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
185.27 -.SH "名前"
185.28 -serialver \- シリアルバージョンコマンド
185.29 -.\"
185.30 -.\" This document was created by saving an HTML file as text
185.31 -.\" from the JavaSoft web site:
185.32 -.\"
185.33 -.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
185.34 -.\"
185.35 -.\" and adding appropriate troff macros. Because the JavaSoft web site
185.36 -.\" man pages can change without notice, it may be helpful to diff
185.37 -.\" files to identify changes other than new functionality.
185.38 -.\"
185.39 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
185.40 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
185.41 +."
185.42 +." This code is free software; you can redistribute it and/or modify it
185.43 +." under the terms of the GNU General Public License version 2 only, as
185.44 +." published by the Free Software Foundation.
185.45 +."
185.46 +." This code is distributed in the hope that it will be useful, but WITHOUT
185.47 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
185.48 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
185.49 +." version 2 for more details (a copy is included in the LICENSE file that
185.50 +." accompanied this code).
185.51 +."
185.52 +." You should have received a copy of the GNU General Public License version
185.53 +." 2 along with this work; if not, write to the Free Software Foundation,
185.54 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
185.55 +."
185.56 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
185.57 +." CA 95054 USA or visit www.sun.com if you need additional information or
185.58 +." have any questions.
185.59 +."
185.60 +.TH serialver 1 "04 May 2009"
185.61 +." Generated from HTML by html2man (author: Eric Armstrong)
185.62 +
185.63 +.LP
185.64 +.SH ""
185.65 +serialver \- 激≪若吾с潟潟潟
185.66 +.LP
185.67 +.RS 3
185.68 +
185.69 +.LP
185.70 +.LP
185.71 +\f3serialver\fP 潟潟 \f2serialVersionUID\fP 菴障
185.72 +.LP
185.73 +.RE
185.74 +.SH "綵√"
185.75 .LP
185.76
185.77 .LP
185.78 +.nf
185.79 +\f3
185.80 +.fl
185.81 +\fP\f3serialver\fP [ options ] [ classnames ]
185.82 +.fl
185.83 +.fi
185.84 +
185.85 .LP
185.86 -\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
185.87 +.RS 3
185.88 +
185.89 .LP
185.90 -.SH "形式"
185.91 -.B serialver
185.92 -[
185.93 -.B options
185.94 -] [
185.95 -.I classnames
185.96 -]
185.97 -.TP
185.98 -.BI options
185.99 -このドキュメントで指定されているコマンド行オプション。
185.100 -.TP
185.101 -.BI classnames
185.102 -1 つまたは複数のクラス名。
185.103 -.SH "機能説明"
185.104 -.IX "serial version command" "" "serial version command \(em \fLserialver\fP"
185.105 -.IX "serialver" "" "\fLserialver\fP \(em serial version command"
185.106 -.B serialver
185.107 -は、指定された 1 個
185.108 -または複数個のクラスの
185.109 -.B シリアルバージョン UID
185.110 -を、展開しているクラスへコピーするのに適した形式で返します。
185.111 -引数なしで呼び出した場合、
185.112 -.B serialver
185.113 -は使用方法を説明する行を表示します。
185.114 -.SH "オプション"
185.115 -.TP 15
185.116 -.B \-classpath " <directories and zip/jar files separated by:>"
185.117 -アプリケーションのクラスおよびリソースの検索パスを設定します。
185.118 -.TP 15
185.119 -.B \-show
185.120 -単なるユーザインタフェースを表示します。
185.121 -ここで完全クラス名を入力し、
185.122 -Enter
185.123 -キーまたは
185.124 -Show
185.125 -ボタンを押すと、シリアルバージョン
185.126 -UID
185.127 -が表示されます。
185.128 -.TP 15
185.129 -.BI \-J "option"
185.130 -.I option
185.131 -を Java 仮想マシンに渡します。ここで、
185.132 -.I option
185.133 -は、Java アプリケーション起動プログラムの参照ページで
185.134 -説明されているオプションの 1 つです。たとえば、
185.135 -.I \-J-Xms48m
185.136 -は、起動時に使用するメモリを 48M バイトに設定します。
185.137 +.RS 3
185.138 +.TP 3
185.139 +options
185.140 +ャ<潟ц潟潟茵激с潟с
185.141 +.TP 3
185.142 +classnames
185.143 +1 や札筝劫с
185.144 +.RE
185.145 +
185.146 .LP
185.147 -.SH "注意"
185.148 +.RE
185.149 +.SH "茯"
185.150 .LP
185.151
185.152 .LP
185.153 .LP
185.154 -\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティマネージャの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティマネージャを設定できます。
185.155 +\f3serialver\fP 1 や札筝鴻 \f2serialVersionUID\fP 絮鴻吾潟若綵√ц障綣違絎у若喝冴篏睡号茵腓冴障
185.156 +.LP
185.157 +.SH "激с"
185.158 +.LP
185.159 +
185.160 +.LP
185.161 +.RS 3
185.162 +.TP 3
185.163 +\-classpath <: у阪c zip jar <ゃ>
185.164 +≪宴若激с潟鴻潟純若鴻罎膣≪鴻荐絎障
185.165 +.RE
185.166 +
185.167 +.LP
185.168 +.RS 3
185.169 +.TP 3
185.170 +\-show
185.171 +膂≦若吟若ゃ潟帥с若鴻茵腓冴障絎絎劫ュEnter 若 [Show] 帥潟若激≪若吾с UID 茵腓冴障
185.172 +.TP 3
185.173 +\-Joption
185.174 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障
185.175 +.RE
185.176 +
185.177 +.LP
185.178 +.SH "羈"
185.179 +.LP
185.180 +
185.181 +.LP
185.182 +.LP
185.183 +\f3serialver\fP 潟潟絎鴻篁潟激喝茯粋昭у障с祉ャc若若吾c若荐絎茵障篆♂若с鴻 \f3serialver\fP 絎茵翫罨<激с潟篏帥c祉ャc若若吾c若荐絎с障
185.184 .LP
185.185 .RS 3
185.186
185.187 @@ -102,7 +102,7 @@
185.188 .LP
185.189 .RE
185.190 .LP
185.191 -また、必要であれば、次のオプションを使ってセキュリティポリシーを指定できます。
185.192 +障綽荀с違罨<激с潟篏帥c祉ャc若激若絎с障
185.193 .LP
185.194 .RS 3
185.195
185.196 @@ -110,16 +110,16 @@
185.197 .LP
185.198 \f2\-J\-Djava.security.policy=<policy file>\fP
185.199 .LP
185.200 -.SH "関連項目"
185.201 +.RE
185.202 +.SH "∫i"
185.203 .LP
185.204
185.205 .LP
185.206 .LP
185.207 +.na
185.208 +\f2java.io.ObjectStreamClass\fP @
185.209 .fi
185.210 -http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
185.211 -の
185.212 -.na
185.213 -「\f2java.io.ObjectStreamClass\fP」
185.214 +http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
185.215 .LP
185.216
185.217 .LP
186.1 --- a/src/solaris/doc/sun/man/man1/ja/servertool.1 Tue May 12 15:21:55 2009 +0900
186.2 +++ b/src/solaris/doc/sun/man/man1/ja/servertool.1 Thu May 14 00:17:25 2009 -0700
186.3 @@ -1,224 +1,130 @@
186.4 -'\" t
186.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
186.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
186.7 -.\"
186.8 -.\" This code is free software; you can redistribute it and/or modify it
186.9 -.\" under the terms of the GNU General Public License version 2 only, as
186.10 -.\" published by the Free Software Foundation.
186.11 -.\"
186.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
186.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
186.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
186.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
186.16 -.\" accompanied this code).
186.17 -.\"
186.18 -.\" You should have received a copy of the GNU General Public License version
186.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
186.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
186.21 -.\"
186.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
186.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
186.24 -.\" have any questions.
186.25 -.\"
186.26 -.TH servertool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
186.27 -.SH "名前"
186.28 -servertool - Java(TM) IDL サーバツール
186.29 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
186.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
186.31 +."
186.32 +." This code is free software; you can redistribute it and/or modify it
186.33 +." under the terms of the GNU General Public License version 2 only, as
186.34 +." published by the Free Software Foundation.
186.35 +."
186.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
186.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
186.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
186.39 +." version 2 for more details (a copy is included in the LICENSE file that
186.40 +." accompanied this code).
186.41 +."
186.42 +." You should have received a copy of the GNU General Public License version
186.43 +." 2 along with this work; if not, write to the Free Software Foundation,
186.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
186.45 +."
186.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
186.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
186.48 +." have any questions.
186.49 +."
186.50 +.TH servertool 1 "04 May 2009"
186.51 +." Generated from HTML by html2man (author: Eric Armstrong)
186.52 +
186.53 .LP
186.54 -.B servertool
186.55 -は、アプリケーション開発者が持続サーバの登録、登録解除、起動、停止を行うためのコマンド行インタフェースを提供します。
186.56 -.SH "形式"
186.57 -.B servertool
186.58 -\-ORBInitialPort nameserverport options [ commands ]
186.59 +.SH ""
186.60 +servertool \- Java(TM) IDL 泣若若若
186.61 .LP
186.62 -.B servertool
186.63 -の起動時にコマンドを
186.64 -入力しなかった場合は、
186.65 -コマンド行ツールが
186.66 -.B servertool >
186.67 -プロンプトを表示します。
186.68 -.B servertool >
186.69 -プロンプトで
186.70 -コマンドを入力します。
186.71 +.RS 3
186.72 +
186.73 .LP
186.74 -.B servertool
186.75 -の起動時にコマンドを入力した場合は、
186.76 -Java IDL サーバツールが起動し、
186.77 -コマンドを実行して終了します。
186.78 -.LP
186.79 -\-ORBInitialPort nameserverport オプションは、必須です。
186.80 -nameserverport の値は、orbd を実行し、
186.81 -着信要求を待機しているポートを指定します。
186.82 -Solaris ソフトウェアを使用する場合は、
186.83 -スーパーユーザになって 1024 未満のポートでプロセスを開始する
186.84 -必要があります。このため、1024 以上のポート番号の
186.85 -使用を推奨します。
186.86 -.SH 機能説明
186.87 -.BR servertool
186.88 -はアプリケーション
186.89 -プログラマが、持続サーバの登録、登録解除、起動、停止を
186.90 -行うためのコマンド行インタフェースです。
186.91 -サーバに関するさまざまな統計情報を取得するために
186.92 -その他のコマンドが用意されています。
186.93 -.SH オプション
186.94 -.TP
186.95 -.BI \-ORBInitialHost " nameserverhost"
186.96 -ネームサーバを実行し、着信要求を待機している
186.97 -ホストマシンを指定します。このオプションを
186.98 -指定しない場合、nameserverhost はデフォルトの
186.99 -localhost になります。
186.100 -.B orbd
186.101 -と
186.102 -.B servertool
186.103 -が異なるマシンで実行されている場合は、orbd が
186.104 -実行されているホストの名前または IP アドレスを
186.105 -指定する必要があります。
186.106 -.TP
186.107 -.BI \-J option
186.108 -オプションを Java 仮想マシンに渡します。
186.109 -ここで option は、Java アプリケーション
186.110 -起動プログラム
186.111 -.fi
186.112 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html)
186.113 -のリファレンスページで説明されている
186.114 -オプションの 1 つです。
186.115 -たとえば、\-J-Xms48m は、
186.116 -起動メモリを 48M バイトに設定します。
186.117 -\-J が基本にする仮想マシンにオプションを
186.118 -渡すことは、共通の規約です。
186.119 -.SH コマンド
186.120 -.TP
186.121 -.B register \-server <server class name>
186.122 -.B \-classpath <classpath to server>
186.123 -[
186.124 -.B \-applicationName <application\ name>
186.125 -.B \-args <args to server>
186.126 -.B \-vmargs <flags to be passed
186.127 -.B to Java VM>
186.128 -]
186.129 -.RS
186.130 -.LP
186.131 -新しい持続サーバを Object Request Broker Daemon (ORBD) に登録します。
186.132 -まだ登録されていない場合は、サーバが登録され、有効化されます。
186.133 -このコマンドを使用すると、
186.134 -\-server オプションによって
186.135 -識別されるサーバのメインクラスでインストールメソッドが
186.136 -呼び出されます。インストールメソッドは、
186.137 -public static void install (org.omg.CORBA.ORB) で
186.138 -なければなりません。このインストールメソッドを
186.139 -オプションで使用すると、開発者は独自の
186.140 -サーバインストール動作 (データベーススキーマの作成など)
186.141 -を指定できます。
186.142 +\f3servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障
186.143 .RE
186.144 -.TP
186.145 -.B unregister \-serverid <server id >
186.146 -.B | \-applicationName <application\ name>
186.147 -.RS
186.148 -.LP
186.149 -サーバ ID またはアプリケーション名を使用して、
186.150 -ORBD からサーバを登録解除します。
186.151 -このコマンドを使用すると、\-server オプションによって
186.152 -識別されたサーバのメインクラスでアンインストール
186.153 -メソッドが呼び出されます。アンインストールメソッドは、
186.154 -public static void uninstall(org.omg.CORBA.ORB)
186.155 -でなければなりません。このアンインストールメソッドを
186.156 -オプションで使用すると、
186.157 -開発者は独自のサーバアンインストール動作
186.158 -(インストールメソッドの動作の取り消しなど)
186.159 -を指定できます。
186.160 -.RE
186.161 -.TP
186.162 -.B getserverid \-applicationName <application name>
186.163 -アプリケーションに対応するサーバ ID を返します。
186.164 -.TP
186.165 -.B list
186.166 -.br
186.167 -ORBD に登録されているすべての持続サーバに関する情報を
186.168 -一覧表示します。
186.169 -.TP
186.170 -.B listappnames
186.171 -ORBD に現在登録されているすべてのサーバのアプリケーション名を
186.172 -一覧表示します。
186.173 -.TP
186.174 -.B listactive
186.175 -ORBD によって起動され、稼動しているすべての
186.176 -持続サーバに関する情報を
186.177 -すべて一覧表示します。
186.178 -.TP 3
186.179 -locate \-serverid\ <server\ id\ >\ |
186.180 -\-applicationName\ <application\ name>
186.181 -[\-endpointType\ <endpointType>\ ]
186.182 -.RS
186.183 -.LP
186.184 -登録されているサーバによって作成されたすべての ORB の特定のタイプ
186.185 -のエンドポイント (ポート) を特定します。サーバがまだ稼動していな
186.186 -い場合は、起動されます。エンドポイントタイプが指定されないと、サ
186.187 -ーバ内の各 ORB に関連したプレーン/非保護の
186.188 -エンドポイントが返されます。
186.189 -.RE
186.190 -.TP 3
186.191 -locateperorb
186.192 -\-serverid\ <server\ id\ >\ |
186.193 -\-applicationName\ <application\ name>
186.194 -[\-orbid\ <ORB\ name>\ ]
186.195 -登録されているサーバの特定の ORB によって登録されたすべてのエンド
186.196 -ポイント (ポート) を特定します。サーバがまだ動作していない場合は、
186.197 -起動されます。
186.198 -.BR orbid
186.199 -が指定されないと、デフォルト値である "" が
186.200 -.BR orbid
186.201 -に割り当てられます。空の文字列の
186.202 -.BR orbid
186.203 -を使用して ORB が作成されると、それによって登録されているす
186.204 -べてのポートが返されます。
186.205 -.RE
186.206 -.TP
186.207 -.B orblist \-serverid <server id> |
186.208 -.B \-applicationName <application name> ]
186.209 -.RS
186.210 -.LP
186.211 -サーバで定義されている ORB の ORBId を一覧表示します。
186.212 -ORBId は、サーバによって作成された ORB の
186.213 -文字列名です。サーバがまだ稼動していない場合は、
186.214 -サーバを起動します。
186.215 -.RE
186.216 -.TP
186.217 -.B shutdown \-serverid <server id> |
186.218 -.B \-applicationName <application name> ]
186.219 -.RS
186.220 -.LP
186.221 -ORBD に登録されているアクティブなサーバを停止します。
186.222 -このコマンドの
186.223 -実行中に、
186.224 -サーバプロセスを適切に停止するために、
186.225 -\-serverid または \-applicationName パラメータで
186.226 -指定されたクラスで定義されている
186.227 -.BR shutdown()
186.228 -メソッドも呼び出されます。
186.229 -.RE
186.230 -.TP
186.231 -.B startup \-serverid <server id> |
186.232 -.B \-applicationName <application name>
186.233 -.RS
186.234 -.LP
186.235 -ORBD に登録されているサーバを起動します。
186.236 -サーバが稼動していな
186.237 -い場合、このコマンドはサーバを起動します。サーバが既に稼動して
186.238 -いる場合は、エラーメッセージがユーザに返されます。
186.239 -.RE
186.240 -.TP
186.241 -.B help
186.242 -.br
186.243 -このサーバツールを使用してサーバに対して実行できるすべての
186.244 -コマンドを一覧表示します。
186.245 -.TP
186.246 -.B quit
186.247 -.br
186.248 -このサーバツールを終了します。
186.249 -.RE
186.250 -.SS "関連項目"
186.251 +.SH "綵√"
186.252 .LP
186.253
186.254 .LP
186.255 -orbd
186.256 +.nf
186.257 +\f3
186.258 +.fl
186.259 +servertool \-ORBInitialPort \fP\f4nameserverport\fP\f3 \fP\f3options\fP\f3 [ \fP\f3commands\fP\f3 ]
186.260 +.fl
186.261 +\fP
186.262 +.fi
186.263 +
186.264 +.LP
186.265 +.LP
186.266 +潟潟ュ \f2servertool\fP 莎桁潟潟茵若 \f2servertool >\fP 潟茵腓冴障\f2servertool >\fP 潟潟潟ュ障
186.267 +.LP
186.268 +.LP
186.269 +潟潟ュ \f2servertool\fP 莎桁Java IDL 泣若若若莎桁潟潟絎茵腟篋障
186.270 +.LP
186.271 +.LP
186.272 +\f2\-ORBInitialPort\fP \f2nameserverport\fP 激с潟\f3綽\fPс\f2nameserverport\fP ゃ\f2orbd\fP 絎茵篆∴羆緇罘若絎綽荀障Solaris 純с≪篏睡1024 絨若с祉鴻紮翫root 若吟若綽荀障 \f2nameserverport\fP 1024 障 1024 紊с若篏睡с障
186.273 +.LP
186.274 +.SH "茯"
186.275 +.LP
186.276 +
186.277 +.LP
186.278 +.LP
186.279 +\f2servertool\fP ≪宴若激с潟違膓泣若若脂蚊脂画Вゃ莎桁喝罩≪茵潟潟茵ゃ潟帥с若鴻箴障祉泣若若≪障障腟沿宴緇潟潟箴障
186.280 +.LP
186.281 +.SH "激с"
186.282 +.LP
186.283 +
186.284 +.LP
186.285 +.RS 3
186.286 +.TP 3
186.287 +\-ORBInitialHost nameserverhost
186.288 +若泣若若絎茵篆∴羆緇罘鴻激潟絎障激с潟絎翫\f2nameserverhost\fP \f2localhost\fP 荐絎障\f2orbd\fP \f2servertool\fP 違激割у茵翫\f2orbd\fP 絎茵鴻 IP ≪鴻絎綽荀障
186.289 +.TP 3
186.290 +\-Joption
186.291 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
186.292 +.RE
186.293 +
186.294 +.LP
186.295 +.SH "潟潟"
186.296 +.LP
186.297 +
186.298 +.LP
186.299 +.RS 3
186.300 +.TP 3
186.301 +register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
186.302 +Object Request Broker Daemon (ORBD) 域膓泣若若脂蚊障泣若若脂蚊翫脂蚊莎桁障潟潟c\f2\-server\fP 激с潟цャ泣若若<ゃ潟劫сゃ潟鴻若<純若喝冴障ゃ潟鴻若<純\f2public static void install(org.omg.CORBA.ORB)\fP c綽荀障ゃ潟鴻若<純激с潟с若帥若鴻鴻若篏泣若若ゃ潟鴻若篏肴絎с障
186.303 +.TP 3
186.304 +unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
186.305 +泣若 ID 障≪宴若激с喝篏睡ORBD 泣若若脂蚊茹iゃ障潟潟c\f2\-server\fP 激с潟цャ泣若若<ゃ潟劫с≪潟ゃ潟鴻若<純若喝冴障≪潟ゃ潟鴻若<純\f2public static void uninstall(org.omg.CORBA.ORB)\fP c綽荀障≪潟ゃ潟鴻若<純激с潟сゃ潟鴻若<純篏羔泣若若≪潟ゃ潟鴻若篏肴絎с障
186.306 +.TP 3
186.307 +getserverid \-applicationName\ <application\ name>
186.308 +≪宴若激с潟∫d泣若 ID 菴障
186.309 +.TP 3
186.310 +list
186.311 +ORBD 脂蚊鴻膓泣若若≪宴筝荀ц;腓冴障
186.312 +.TP 3
186.313 +listappnames
186.314 +憜 ORBD 脂蚊鴻泣若若≪宴若激с喝筝荀ц;腓冴障
186.315 +.TP 3
186.316 +listactive
186.317 +ORDB c莎桁憜絎茵鴻膓泣若若≪宴筝荀ц;腓冴障
186.318 +.TP 3
186.319 +locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
186.320 +脂蚊泣若若т鴻 ORB 劫ゃ腴 (若) 罎冴障泣若若絎茵翫莎桁障腴鴻絎翫泣若若 ORB ∫d plain 障 non\-protected 腴鴻菴障
186.321 +.TP 3
186.322 +locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
186.323 +脂蚊泣若若劫 ORB х脂蚊腴 (若) 罎冴障泣若若絎茵翫莎桁障\f2orbid\fP 絎翫ゃ""\f2orbid\fP蚊綵障ORB 腥堺絖 \f2orbid\fP т翫脂蚊若鴻菴障
186.324 +.TP 3
186.325 +orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
186.326 +泣若寂絎臂 ORB ORBId 筝荀ц;腓冴障ORBId 泣若若т ORB 絖с泣若若絎茵翫莎桁障
186.327 +.TP 3
186.328 +shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
186.329 +ORBD 脂蚊≪c泣若若罩≪障潟潟絎茵筝\f2\-serverid\fP <若帥障 \f2\-applicationName\fP <若帥ф絎劫絎臂 \f2shutdown()\fP <純若喝冴泣若若祉鴻罩c罩≪障
186.330 +.TP 3
186.331 +startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
186.332 +ORBD 脂蚊泣若若莎桁障泣若若絎茵翫潟潟с泣若若莎桁障泣若若с絎茵翫若吟若若<祉若吾菴障
186.333 +.TP 3
186.334 +help
186.335 +泣若若泣若若若т戎с鴻潟潟茵腓冴障
186.336 +.TP 3
186.337 +quit
186.338 +泣若若若腟篋障
186.339 +.RE
186.340 +
186.341 +.LP
186.342 +.SH "∫i"
186.343 +.LP
186.344 +
186.345 +.LP
186.346 +orbd(1)
186.347 .LP
186.348
187.1 --- a/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Tue May 12 15:21:55 2009 +0900
187.2 +++ b/src/solaris/doc/sun/man/man1/ja/tnameserv.1 Thu May 14 00:17:25 2009 -0700
187.3 @@ -1,119 +1,80 @@
187.4 -'\" t
187.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
187.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
187.7 -.\"
187.8 -.\" This code is free software; you can redistribute it and/or modify it
187.9 -.\" under the terms of the GNU General Public License version 2 only, as
187.10 -.\" published by the Free Software Foundation.
187.11 -.\"
187.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
187.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
187.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
187.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
187.16 -.\" accompanied this code).
187.17 -.\"
187.18 -.\" You should have received a copy of the GNU General Public License version
187.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
187.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
187.21 -.\"
187.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
187.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
187.24 -.\" have any questions.
187.25 -.\"
187.26 -.TH tnameserv 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
187.27 -.SH "名前"
187.28 -Java IDL: 一時ネームサービス \- \f2tnameserv\fP
187.29 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
187.30 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
187.31 +."
187.32 +." This code is free software; you can redistribute it and/or modify it
187.33 +." under the terms of the GNU General Public License version 2 only, as
187.34 +." published by the Free Software Foundation.
187.35 +."
187.36 +." This code is distributed in the hope that it will be useful, but WITHOUT
187.37 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
187.38 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
187.39 +." version 2 for more details (a copy is included in the LICENSE file that
187.40 +." accompanied this code).
187.41 +."
187.42 +." You should have received a copy of the GNU General Public License version
187.43 +." 2 along with this work; if not, write to the Free Software Foundation,
187.44 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
187.45 +."
187.46 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
187.47 +." CA 95054 USA or visit www.sun.com if you need additional information or
187.48 +." have any questions.
187.49 +."
187.50 +.TH tnameserv 1 "04 May 2009"
187.51 +." Generated from HTML by html2man (author: Eric Armstrong)
187.52 +
187.53 +.LP
187.54 +.SH ""
187.55 +Java IDL:筝若泣若 \- \f2tnameserv\fP
187.56 .LP
187.57
187.58 .LP
187.59 .LP
187.60 -このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には ORBD (Object Request Broker Daemon) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD が使用されていますが、一時ネームサービスを使用する例の \f2orbd\fP はどれも、\f2tnameserv\fP で置き換えることができます。\f2orbd\fP ツールのドキュメントについては、そのマニュアルページか、
187.61 +ャ<潟сJava IDL 筝若泣若 \f2tnameserv\fP 篏睡号ゃ茯障Java IDL Object Request Broker Daemon (ORBD) 障障ORBD 若鴻泣若鴻筝若泣若鴻\f3膓\fP若泣若鴻潟泣若若若吾c若若≪潟祉鴻сJava IDL 鴻ャ若≪с ORBD 篏睡障筝若泣若鴻篏睡箴с\f2orbd\fP 篁c \f2tnameserv\fP 篏睡с障\f2orbd\fP 若荅括完ゃ\f2orbd\fP orbd(1)障
187.62 .na
187.63 -\f2Java IDL Naming Service Included with ORBD\fP
187.64 +\f2ORBD 障 Java IDL 若泣若\fP @
187.65 .fi
187.66 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) のトピックを参照してください。
187.67 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html≪с
187.68 .LP
187.69 .LP
187.70 -ここでは、次の項目について説明します。
187.71 +с篁ヤゃ茯障
187.72 .LP
187.73 .RS 3
187.74 .TP 2
187.75 o
187.76 -Java\ IDL 一時ネームサービス
187.77 +Java\ IDL 筝若泣若
187.78 .TP 2
187.79 o
187.80 -Java\ IDL 一時ネームサービスの起動
187.81 +Java\ IDL 筝若泣若鴻莎桁
187.82 .TP 2
187.83 o
187.84 -Java\ IDL 一時ネームサービスの停止
187.85 +Java\ IDL 筝若泣若鴻罩
187.86 .TP 2
187.87 o
187.88 -サンプルクライアント: 名前空間へのオブジェクトの追加
187.89 +泣潟ゃ≪潟:腥咲吾吾с菴遵
187.90 .TP 2
187.91 o
187.92 -サンプルクライアント: 名前空間のブラウズ
187.93 +泣潟ゃ≪潟:腥咲
187.94 .RE
187.95
187.96 .LP
187.97 -.SH "Java\ IDL 一時ネームサービス"
187.98 -.IX "Java IDL name server starter script" "" "Java IDL name server starter script \(em \fLtnameserv\fP"
187.99 -.IX "tnameserv" "" "\fLtnameserv\fP \(em Java IDL name server starter script"
187.100 -.SM CORBA
187.101 -の
187.102 -.SM COS
187.103 -(Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ
187.104 -構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供し
187.105 -ます。
187.106 -Java
187.107 -.SM IDL
187.108 -の一時ネームサービス、\f2tnameserv\fP は、
187.109 -.SM COS
187.110 -ネームサービスの仕様を単純な形で実装したものです。
187.111 +.SH "Java\ IDL 筝若泣若"
187.112 .LP
187.113 -オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前の組は、
187.114 -それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミ
187.115 -ングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体
187.116 -がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機
187.117 -能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納さ
187.118 -れます。名前空間において、初期ネーミングコンテキストは唯一の持続的バイン
187.119 -ディングです。それ以外のネーミングコンテキストは、Java
187.120 -.SM IDL
187.121 -のネームサーバープロセスが停止し、再起動されると失われます。
187.122 .LP
187.123 -アプレットまたはアプリケーションから
187.124 -.SM COS
187.125 -ネームサービスを使用するためには、その
187.126 -.SM ORB
187.127 -はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの
187.128 -文字列化された初期ネーミングコンテキストにアクセスできなければなりません。
187.129 -ネームサービスは、Java
187.130 -.SM IDL
187.131 -のネームサービスでもその他の
187.132 -.SM COS
187.133 -準拠のネームサービスでもかまいません。
187.134 +CORBA COS (Common Object Services) 若泣若鴻<ゃ激鴻<ゃ絲障c罕箴吾сс絲障惹c箴障Java IDL 筝若泣若鴻с \f2tnameserv\fP COS 若泣若鴻篁罕膣綵≪у茖с
187.135 .LP
187.136 -.SH "Java\ IDL 一時ネームサービスの起動"
187.137 .LP
187.138 +吾сс腥咲ф主吾сс≪若ゃ潟c潟違若違障若ゃ潟c潟違若潟違潟潟鴻腟粋昭с障若潟違潟潟鴻篏若ゃ潟c潟違с<ゃ激鴻泣c膩罘純<障鴻ゃ潟c潟違若潟違潟潟鴻主障腥咲若潟違潟潟鴻筝膓ゃ潟c潟違с 篁ュ若潟違潟潟鴻Java IDL 若潟違泣若鴻祉鴻罩≪莎桁紊宴障
187.139 .LP
187.140 -.IX "tnameserv" "Starting the Java IDL Name Server" "\fLtnameserv\fP \(em Java IDL name server starter script"
187.141 -Java
187.142 -.SM IDL
187.143 -ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に
187.144 -起動しておかなければなりません。
187.145 -Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するためのスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。
187.146 -バックグラウンドで
187.147 -動作するように、ネームサービスを起動してください。
187.148 .LP
187.149 -特に指定しない場合、Java
187.150 -.SM IDL
187.151 -ネームサービスは、
187.152 -.SM ORB
187.153 -の
187.154 -.I resolve_initial_references(\|)
187.155 -メソッドと
187.156 -.I list_initial_references(\|)
187.157 -メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
187.158 -次のようにします。
187.159 +≪障≪宴若激с潟 COS 若泣若鴻篏睡 ORB 若泣若鴻篏鴻若ャc若泣若鴻絖若潟違潟潟鴻≪祉鴻с違障若泣若鴻Java\ IDL 若泣若鴻с篁 COS 羣若泣若鴻с障障
187.160 +.LP
187.161 +.SH "Java\ IDL 筝若泣若鴻莎桁"
187.162 +.LP
187.163 +.LP
187.164 +Java\ IDL 若泣若鴻若泣若鴻篏睡≪宴若激с潟障≪莎桁違障Java\ IDL 茖遵ゃ潟鴻若Java IDL 若泣若鴻莎桁鴻 (Solaris: \f2tnameserv\fP) 絎茵純<ゃ (Windows NT: \f2tnameserv.exe\fP) 篏障違潟у篏若泣若鴻莎桁
187.165 +.LP
187.166 +.LP
187.167 +鴻絎翫Java IDL 若泣若鴻ORB \f2resolve_initial_references()\fP <純 \f2list_initial_references()\fP <純絎茖篏睡若鴻潟絲障若 900 у罘障
187.168 .LP
187.169 .nf
187.170 \f3
187.171 @@ -125,7 +86,7 @@
187.172
187.173 .LP
187.174 .LP
187.175 -ネームサーバーのポートを指定しなかった場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアを実行する場合、1024 よりも小さいポートでプロセスを起動するには root になる必要があります。このため、1024 かそれよりも大きいポート番号を使用することをお勧めします。1050 などの異なるポートを指定し、かつネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルから次のように入力します。
187.176 +若泣若若若絎翫с若 900 篏睡障Solaris 純с≪絎茵1024 絨若с祉鴻紮翫root 若吟若綽荀障 1024 障 1024 紊с若篏睡с障 1050 ャ若絎若泣若鴻違潟у茵UNIX 潟潟激сф<ュ障
187.177 .LP
187.178 .nf
187.179 \f3
187.180 @@ -137,7 +98,7 @@
187.181
187.182 .LP
187.183 .LP
187.184 -Windows の場合は、MS\-DOS システムプロンプトから次のように入力します。
187.185 +Windows MS\-DOS 激鴻潟с罨<ュ障
187.186 .LP
187.187 .nf
187.188 \f3
187.189 @@ -149,32 +110,32 @@
187.190
187.191 .LP
187.192 .LP
187.193 -ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティに新しいポート番号を設定します。
187.194 +若泣若若ゃ≪潟違若垩ャ綽荀障ORB 吾с篏 \f2org.omg.CORBA.ORBInitialPort\fP c若違若垩荐絎障
187.195 .LP
187.196 .SS
187.197 -異なるホスト上でのサーバーとクライアントの実行
187.198 +違激割сゃ≪潟泣若若絎茵
187.199 .LP
187.200 .LP
187.201 -Java IDL および RMI\-IIOP に関するチュートリアルの大部分では、ネームサービス、サーバー、クライアントのすべてが開発マシン上で実行されています。実際の配備では通常、ネームサービスとは異なるホストマシン上でクライアントとサーバーが実行されます。
187.202 +Java IDL RMI\-IIOP 祉ャ若≪с若泣若鴻泣若若潟ゃ≪潟鴻榊激割у茵障絎翫ゃ≪潟泣若若若泣若鴻違鴻筝у茵紊障
187.203 .LP
187.204 .LP
187.205 -クライアントとサーバーでネームサービスを検索するには、ネームサービスが実行されているポート番号とホストをそれらが知っている必要があります。そこで、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP と \f2org.omg.CORBA.ORBInitialHost\fP プロパティを、ネームサービスが実行されているマシン名とポート番号に設定します。この例については、
187.206 +ゃ≪潟泣若若若泣若鴻荀ゃゃ≪潟泣若若若泣若鴻絎茵若垩鴻茯茘綽荀障ゃ≪潟泣若若<ゃ \f2org.omg.CORBA.ORBInitialPort\fP c若 \f2org.omg.CORBA.ORBInitialHost\fP c若若泣若鴻絎茵若垩激潟荐絎障箴
187.207 .na
187.208 -「\f2The Hello World Example Using RMI\-IIOP\fP」
187.209 +\f2RMI\-IIOP 篏帥c Hello World 箴\fP @
187.210 .fi
187.211 -(http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html) を参照してください。また、コマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使ってネームサービスの検索場所をクライアントとサーバーに知らせることも可能です。
187.212 +http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html腓冴障潟潟茵激с \f2\-ORBInitialPort\fP \f2nameserverport#\fP \f2\-ORBInitialHost\fP \f2nameserverhostname\fP 篏睡ゃ≪潟泣若若絲障若泣若鴻「贋絎с障
187.213 .na
187.214 -「\f2Java IDL: Running the Hello World Example on TWO Machines\fP」
187.215 +\f2Java IDL: 2 伹激割у茵 Hello World 違\fP @
187.216 .fi
187.217 -(http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html) では、このコマンド行オプションを使う方法の 1 つが示されています。
187.218 +http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html 潟潟茵激с潟篏睡絎号腓冴障
187.219 .LP
187.220 .LP
187.221 -たとえば、一時ネームサービス \f2tnameserv\fP がホスト \f2nameserverhost\fP のポート 1050 上で、クライアントがホスト \f2clienthost\fP 上で、サーバーがホスト \f2serverhost\fP 上で、それぞれ実行されているとします。
187.222 +違筝若泣若 \f2tnameserv\fP 鴻 \f2nameserverhost\fP 若 1050 筝у茵障ゃ≪潟鴻 \f2clienthost\fP 筝у茵泣若若鴻 \f2serverhost\fP 筝у茵障
187.223 .LP
187.224 .RS 3
187.225 .TP 2
187.226 o
187.227 -ホスト \f2nameserverhost\fP 上の \f2tnameserv\fP を次のようにして起動します。
187.228 +罨<鴻 \f2nameserverhost\fP 筝 \f2tnameserv\fP 莎桁障
187.229 .nf
187.230 \f3
187.231 .fl
187.232 @@ -186,7 +147,7 @@
187.233 .fi
187.234 .TP 2
187.235 o
187.236 -\f2serverhost\fP 上のサーバーを次のようにして起動します。
187.237 +\f2serverhost\fP 筝с泣若若莎桁障
187.238 .nf
187.239 \f3
187.240 .fl
187.241 @@ -196,7 +157,7 @@
187.242 .fi
187.243 .TP 2
187.244 o
187.245 -\f2clienthost\fP 上のクライアントを次のようにして起動します。
187.246 +\f2clienthost\fP 筝сゃ≪潟莎桁障
187.247 .nf
187.248 \f3
187.249 .fl
187.250 @@ -208,48 +169,48 @@
187.251
187.252 .LP
187.253 .SS
187.254 -\-J オプション
187.255 +\-J 激с
187.256 .LP
187.257 -\f2tnameserv\fP で使用可能なコマンド行オプションは、次のとおりです。
187.258 +潟潟茵激с潟\f2tnameserve\fP 篏睡с障
187.259 .RS 3
187.260
187.261 .LP
187.262 +.RS 3
187.263 .TP 3
187.264 \-Joption
187.265 -\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、
187.266 -.na
187.267 -\f2Java アプリケーション起動ツール\fP
187.268 -.fi
187.269 -(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP とすると、起動時のメモリが 48M バイトに設定されます。\f3\-J\fP を使って実行元の仮想マシンにオプションを渡すことは、よく行われています。
187.270 +Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障\f3\-J\fP 篏帥c緇絎茵医激с潟羝<頫障
187.271 +.RE
187.272 +
187.273 .LP
187.274 -.SH "Java IDL 一時ネームサービスの停止"
187.275 +.RE
187.276 +.SH "Java\ IDL 筝若泣若鴻罩"
187.277 .LP
187.278 .LP
187.279 -Java\ IDL ネームサービスを停止するには、対応するオペレーティングシステムコマンドを使用します。たとえば、Unix プロセスの場合は \f2kill\fP を、Windows プロセスの場合は \f2Ctrl\-C\fP を、それぞれ使用します。ネームサービスは明示的にシャットダウンされるまで、呼び出しを待ち続けます。なお、ネームサービスを終了させると、Java\ IDL ネームサービスに登録されている名前は失われます。
187.280 +Java IDL 若泣若鴻罩≪Unix 翫\f2kill\fP 若c潟違激鴻潟潟篏帥Windows 翫\f2Ctrl\-C\fP 篏帥障若泣若鴻腓榊罩≪障с若喝冴緇罘倶膓障泣若鴻腟篋Java\ IDL 若泣若鴻脂蚊紊宴障
187.281 .LP
187.282 -.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
187.283 +.SH "泣潟ゃ≪潟:腥咲吾吾с菴遵"
187.284 .LP
187.285 .LP
187.286 -以下に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
187.287 +罨<腓冴泣潟違腥咲菴遵号腓冴с泣潟違障障倶у篏筝若泣若鴻ゃ≪潟с罨<膣若篏с
187.288 .LP
187.289 .nf
187.290 \f3
187.291 .fl
187.292 \fP\f3
187.293 .fl
187.294 - \fP\f4初期\fP\f3
187.295 + \fP\f4\fP\f3
187.296 .fl
187.297 - \fP\f4ネーミングコンテキスト\fP\f3
187.298 + \fP\f4若潟違潟潟鴻\fP\f3
187.299 .fl
187.300 - / \\
187.301 + / \\
187.302 .fl
187.303 - / \\
187.304 + / \\
187.305 .fl
187.306 plans \fP\f4Personal\fP\f3
187.307 .fl
187.308 - / \\
187.309 + / \\
187.310 .fl
187.311 - / \\
187.312 + / \\
187.313 .fl
187.314 calendar schedule\fP
187.315 .fl
187.316 @@ -257,7 +218,7 @@
187.317
187.318 .LP
187.319 .LP
187.320 -この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照が含まれるネーミングコンテキストです。
187.321 +箴с\f3plans\fP 吾сс\f3Personal\fP \f3calendar\fP \f3schedule\fP 2 ゃ吾сс若潟違潟潟鴻с
187.322 .LP
187.323 .nf
187.324 \f3
187.325 @@ -284,7 +245,7 @@
187.326 .fi
187.327
187.328 .LP
187.329 -前述の「Java IDL 一時ネームサービスの起動」では、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
187.330 +菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨<潟若с若垩ゃ≪潟違ャ障
187.331 .nf
187.332 \f3
187.333 .fl
187.334 @@ -300,7 +261,7 @@
187.335 .fi
187.336
187.337 .LP
187.338 -このコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この \f3objref\fP には、あとでさまざまな名前を割り当てて名前空間に追加します。
187.339 +罨<潟若с若潟違潟潟鴻緇 \f3ctx\fP 篁eャ障2 茵с\f3ctx\fP 若吾с \f3objref\fP 潟若障 \f3objref\fP с障障蚊綵腥咲菴遵障
187.340 .nf
187.341 \f3
187.342 .fl
187.343 @@ -316,7 +277,7 @@
187.344 .fi
187.345
187.346 .LP
187.347 -このコードでは、text 型の名前「plans」を作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fP を使用して初期ネーミングコンテキストの下に「plans」を追加しています。\f2rebind\fP メソッドを使用すれば、\f2bind\fP を使用した場合に発生する例外を発生させずに、このプログラムを何度も繰り返し実行できます。
187.348 +罨<潟若сtext plans 篏若吾ссゃ潟障緇\f2rebind\fP 篏睡若潟違潟潟鴻筝 "plans" 菴遵障\f2rebind\fP <純篏睡違\f2bind\fP 篏睡翫榊箴紊榊違篏綺膵違菴絎茵с障
187.349 .nf
187.350 \f3
187.351 .fl
187.352 @@ -334,7 +295,7 @@
187.353 .fi
187.354
187.355 .LP
187.356 -このコードでは、directory 型の「Personal」というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
187.357 +罨<潟若сdirectory Personal 若潟違潟潟鴻篏障腟緇吾с \f3ctx2\fP ゃ潟若潟違潟潟鴻菴遵障
187.358 .nf
187.359 \f3
187.360 .fl
187.361 @@ -352,7 +313,7 @@
187.362 .fi
187.363
187.364 .LP
187.365 -残りのコードでは、ダミーのオブジェクト参照を「schedule」と「calendar」という名前でネーミングコンテキスト「Personal」(\f3ctx2\fP) にバインドします。
187.366 +罧潟若с若吾сс schedule calendar с若潟違潟潟鴻 "Personal" (\f3ctx2\fP) ゃ潟障
187.367 .nf
187.368 \f3
187.369 .fl
187.370 @@ -392,10 +353,10 @@
187.371 .fi
187.372
187.373 .LP
187.374 -.SH "サンプルクライアント: 名前空間のブラウズ"
187.375 +.SH "泣潟ゃ≪潟:腥咲"
187.376 .LP
187.377 .LP
187.378 -次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
187.379 +罨<泣潟違с腥咲冴号腓冴障
187.380 .LP
187.381 .nf
187.382 \f3
187.383 @@ -422,7 +383,7 @@
187.384 .fi
187.385
187.386 .LP
187.387 -前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
187.388 +菴違Java IDL 筝若泣若鴻莎桁с若泣若若若 1050 篏睡莎桁障 罨<潟若с若垩ゃ≪潟違ャ障
187.389 .nf
187.390 \f3
187.391 .fl
187.392 @@ -442,7 +403,7 @@
187.393 .fi
187.394
187.395 .LP
187.396 -次のコードでは、初期ネーミングコンテキストを取得しています。
187.397 +罨<潟若с若潟違潟潟鴻緇障
187.398 .nf
187.399 \f3
187.400 .fl
187.401 @@ -456,7 +417,7 @@
187.402 .fi
187.403
187.404 .LP
187.405 -\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
187.406 +\f2list\fP <純若潟違潟潟鴻菴遵ゃ潟c潟違鴻障翫紊 1000 障сゃ潟c潟違若潟違潟潟鴻 BindingListHolder 菴障 罧ゃ潟c潟違BindingIteratorHolder 菴障
187.407 .nf
187.408 \f3
187.409 .fl
187.410 @@ -472,7 +433,7 @@
187.411 .fi
187.412
187.413 .LP
187.414 -このコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
187.415 +罨<潟若с菴 BindingListHolder ゃ潟c潟違緇障ゃ潟c潟違翫違腟篋障
187.416 .nf
187.417 \f3
187.418 .fl
187.419 @@ -486,7 +447,7 @@
187.420 .fi
187.421
187.422 .LP
187.423 -残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
187.424 +罧潟若сゃ潟c潟違絲障若茵阪障
187.425 .nf
187.426 \f3
187.427 .fl
187.428 @@ -540,4 +501,4 @@
187.429 .LP
187.430
187.431 .LP
187.432 -
187.433 +
188.1 --- a/src/solaris/doc/sun/man/man1/ja/unpack200.1 Tue May 12 15:21:55 2009 +0900
188.2 +++ b/src/solaris/doc/sun/man/man1/ja/unpack200.1 Thu May 14 00:17:25 2009 -0700
188.3 @@ -1,29 +1,54 @@
188.4 -'\" t
188.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
188.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
188.7 -.\"
188.8 -.\" This code is free software; you can redistribute it and/or modify it
188.9 -.\" under the terms of the GNU General Public License version 2 only, as
188.10 -.\" published by the Free Software Foundation.
188.11 -.\"
188.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
188.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
188.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
188.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
188.16 -.\" accompanied this code).
188.17 -.\"
188.18 -.\" You should have received a copy of the GNU General Public License version
188.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
188.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
188.21 -.\"
188.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
188.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
188.24 -.\" have any questions.
188.25 -.\"
188.26 -.TH unpack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
188.27 -.SH 名前
188.28 -unpack200 \- JAR アンパックツール
188.29 -.SH 形式
188.30 +." Copyright Sun Microsystems, Inc. All Rights Reserved.
188.31 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
188.32 +."
188.33 +." This code is free software; you can redistribute it and/or modify it
188.34 +." under the terms of the GNU General Public License version 2 only, as
188.35 +." published by the Free Software Foundation.
188.36 +."
188.37 +." This code is distributed in the hope that it will be useful, but WITHOUT
188.38 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
188.39 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
188.40 +." version 2 for more details (a copy is included in the LICENSE file that
188.41 +." accompanied this code).
188.42 +."
188.43 +." You should have received a copy of the GNU General Public License version
188.44 +." 2 along with this work; if not, write to the Free Software Foundation,
188.45 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
188.46 +."
188.47 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
188.48 +." CA 95054 USA or visit www.sun.com if you need additional information or
188.49 +." have any questions.
188.50 +."
188.51 +.TH unpack200 1 "04 May 2009"
188.52 +." Generated from HTML by html2man (author: Eric Armstrong)
188.53 +
188.54 +.LP
188.55 +.SH ""
188.56 +unpack200 \- JAR ≪潟若
188.57 +.LP
188.58 +.RS 3
188.59 +.TP 2
188.60 +o
188.61 +綵√
188.62 +.TP 2
188.63 +o
188.64 +茯
188.65 +.TP 2
188.66 +o
188.67 +激с
188.68 +.TP 2
188.69 +o
188.70 +腟篋鴻若帥
188.71 +.TP 2
188.72 +o
188.73 +∫i
188.74 +.TP 2
188.75 +o
188.76 +茯
188.77 +.RE
188.78 +
188.79 +.LP
188.80 +.SH "綵√"
188.81 .LP
188.82
188.83 .LP
188.84 @@ -31,39 +56,62 @@
188.85 \f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
188.86 .LP
188.87 .LP
188.88 -オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
188.89 -.TP
188.90 -.I input\-file
188.91 -入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
188.92 -.TP
188.93 -.I JAR\-file
188.94 -出力 JAR ファイル名。
188.95 -.SH 機能説明
188.96 -unpack200 ツールは pack200(1) で作成されたパックファイルを JAR ファイルに変換するネイティブ実装です。
188.97 -.TP
188.98 -一般的な使用方法:
188.99 +激с潟絎綺羆冴障障潟潟茵絎緇激с潟篁ュ絎鴻激с潟障
188.100 .LP
188.101 -.RS
188.102 -.ft 3
188.103 -.nf
188.104 -% unpack200 myarchive.pack.gz myarchive.jar
188.105 -.fi
188.106 -.ft 1
188.107 +.RS 3
188.108 +
188.109 +.LP
188.110 +.RS 3
188.111 +.TP 3
188.112 +input\-file
188.113 +ュ<ゃ ュ<ゃ絽吾pack200 gzip <ゃ pack200 <ゃс祉0 荐絎 pack200(1) 篏 JAR <ゃュ<ゃ篏睡с障 翫ュ<ゃ絎鴻 Pack200 若若阪 JAR <ゃ潟若障
188.114 +.TP 3
188.115 +JAR\-file
188.116 +阪 JAR <ゃ
188.117 +.RE
188.118 +
188.119 +.LP
188.120 +.RE
188.121 +.SH " 茯"
188.122 +.LP
188.123 +
188.124 +.LP
188.125 +.LP
188.126 +\f2unpack200\fP \f2pack200\fP(1) т<ゃ JAR <ゃ紊ゃc絎茖с筝篏睡号:
188.127 +.LP
188.128 +.RS 3
188.129 +
188.130 +.LP
188.131 +.LP
188.132 +\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
188.133 +.LP
188.134 .RE
188.135 .LP
188.136 -この例では、デフォルトの unpack200 設定で、myarchive.pack.gz から myarchive.jar が作成されます。
188.137 -.SH オプション
188.138 +箴с \f2unpack200\fP 荐絎с\f2myarchive.jar\fP \f2myarchive.pack.gz\fP 篏障
188.139 +.LP
188.140 +.SH "激с"
188.141 .LP
188.142 .SS
188.143 -標準オプション
188.144 -.TP
188.145 -.B \-Hvalue \--deflate-hint=value
188.146 -JAR ファイル内のすべてのエントリに true、false、keep としてデフレーションを設定します。デフォルトモードは keep です。true または false の場合、デフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
188.147 +罔羣激с
188.148 +.LP
188.149 +.RS 3
188.150 +
188.151 +.LP
188.152 +.LP
188.153 +\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
188.154 +.LP
188.155 +.RS 3
188.156 +
188.157 +.LP
188.158 +.LP
188.159 +JAR <ゃ鴻潟 \f2true\fP\f2false\fP\f2keep\fP 若激с潟荐絎障≪若 \f2keep\fP с\f2true\fP 障 \f2false\fP 翫篏若若ゃ阪 JAR <ゃ鴻潟若激с潟≪若荐絎障
188.160 .LP
188.161 .RE
188.162 +.RE
188.163 .SS
188.164 -非標準オプション
188.165 +罔羣激с
188.166 .LP
188.167 +.RS 3
188.168
188.169 .LP
188.170 .LP
188.171 @@ -73,7 +121,7 @@
188.172
188.173 .LP
188.174 .LP
188.175 -入力パックファイルを削除します。
188.176 +ュ<ゃゃ障
188.177 .LP
188.178 .RE
188.179 .LP
188.180 @@ -83,7 +131,7 @@
188.181
188.182 .LP
188.183 .LP
188.184 -最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
188.185 +絨<祉若吾阪障激с潟茲井絎激<祉若吾阪障
188.186 .LP
188.187 .RE
188.188 .LP
188.189 @@ -93,7 +141,7 @@
188.190
188.191 .LP
188.192 .LP
188.193 -メッセージを表示せずに動作します。
188.194 +<祉若吾茵腓冴篏障
188.195 .LP
188.196 .RE
188.197 .LP
188.198 @@ -103,51 +151,65 @@
188.199
188.200 .LP
188.201 .LP
188.202 -メッセージを出力するログファイルを指定します。
188.203 +阪<祉若吾違<ゃ絎障
188.204 .LP
188.205 .RE
188.206 -.SH 終了ステータス
188.207 -次の終了値が返されます。
188.208 -.TP
188.209 -.B 0 " 成功"
188.210 -.TP
188.211 -.B >0 " エラー"
188.212 -.SH 関連項目
188.213 +.RE
188.214 +.SH "腟篋鴻若帥"
188.215 +.LP
188.216 +
188.217 +.LP
188.218 +.LP
188.219 +罨<腟篋ゃ菴障
188.220 +.LP
188.221 +.RS 3
188.222 +
188.223 +.LP
188.224 +.LP
188.225 +\f2\ 0\fP " "
188.226 +.LP
188.227 +.LP
188.228 +\f2>0\fP " "
188.229 +.LP
188.230 +.RE
188.231 +.SH "∫i"
188.232 .LP
188.233 .RS 3
188.234 .TP 2
188.235 -*
188.236 -pack200 \- JAR パックツール
188.237 +o
188.238 +pack200(1)
188.239 .TP 2
188.240 -*
188.241 -\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP のマニュアルページ
188.242 +o
188.243 +.na
188.244 +\f2Java SE ャ<潟\fP @
188.245 +.fi
188.246 +http://java.sun.com/javase/6/docs/index.html
188.247 .TP 2
188.248 -*
188.249 -Java SE のドキュメント
188.250 -.TP 2
188.251 -*
188.252 +o
188.253 +.na
188.254 +\f2Java ゃ \- Pack200\fP @
188.255 .fi
188.256 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
188.257 -の
188.258 -.na
188.259 -「\f2Java Deployment Guide」 \- Pack200\fP
188.260 .TP 2
188.261 -*
188.262 -\f2jar\fP \- Java アーカイブツール
188.263 +o
188.264 +jar(1) \- Java Archive 若
188.265 .TP 2
188.266 -*
188.267 -.fi
188.268 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
188.269 -の
188.270 -.na
188.271 -「\f2jarsigner\fP」 \- JAR 署名ツール
188.272 +o
188.273 +jarsigner(1) \- JAR 臀峨恰荐若若
188.274 +.TP 2
188.275 +o
188.276 +\f2attributes(5)\fP ャ≪若
188.277 .RE
188.278
188.279 .LP
188.280 -.SH 注意事項
188.281 -このコマンドと unpack(1) コマンドを混同しないでください。これらは別製品です。
188.282 +.SH "羈鋋"
188.283 .LP
188.284 +
188.285 .LP
188.286 -ドキュメント間に矛盾がある場合、SDK に付属する Java SE API 仕様が最優先されます。
188.287 +.LP
188.288 +潟潟 \f2unpack(1)\fP 羞桁сヨ遵с
188.289 +.LP
188.290 +.LP
188.291 +SDK 篁絮 Java SE API 篁罕檎荀ゃc翫篁罕
188.292 .LP
188.293
189.1 --- a/src/solaris/doc/sun/man/man1/ja/wsgen.1 Tue May 12 15:21:55 2009 +0900
189.2 +++ b/src/solaris/doc/sun/man/man1/ja/wsgen.1 Thu May 14 00:17:25 2009 -0700
189.3 @@ -1,243 +1,663 @@
189.4 -'\" t
189.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
189.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
189.7 -.\"
189.8 -.\" This code is free software; you can redistribute it and/or modify it
189.9 -.\" under the terms of the GNU General Public License version 2 only, as
189.10 -.\" published by the Free Software Foundation.
189.11 -.\"
189.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
189.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
189.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
189.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
189.16 -.\" accompanied this code).
189.17 -.\"
189.18 -.\" You should have received a copy of the GNU General Public License version
189.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
189.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
189.21 -.\"
189.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
189.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
189.24 -.\" have any questions.
189.25 -.\" `
189.26 -.TH wsgen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
189.27 -." Generated by html2man
189.28 -
189.29 -.LP
189.30 -.SH 名前
189.31 -wsgen \- JAX\-WS 2.0 ベータ
189.32 -.LP
189.33 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
189.34 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
189.35 +."
189.36 +." This code is free software; you can redistribute it and/or modify it
189.37 +." under the terms of the GNU General Public License version 2 only, as
189.38 +." published by the Free Software Foundation.
189.39 +."
189.40 +." This code is distributed in the hope that it will be useful, but WITHOUT
189.41 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
189.42 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
189.43 +." version 2 for more details (a copy is included in the LICENSE file that
189.44 +." accompanied this code).
189.45 +."
189.46 +." You should have received a copy of the GNU General Public License version
189.47 +." 2 along with this work; if not, write to the Free Software Foundation,
189.48 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
189.49 +."
189.50 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
189.51 +." CA 95054 USA or visit www.sun.com if you need additional information or
189.52 +." have any questions.
189.53 +."
189.54 +.TH wsgen 1 "04 May 2009"
189.55 +." Generated from HTML by html2man (author: Eric Armstrong)
189.56 +.SH ""
189.57 +wsgen \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
189.58 .RS 3
189.59
189.60 .LP
189.61 .LP
189.62 -\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、サービスエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
189.63 +\f3篁罕若吾с:\fP 2.1
189.64 +.br
189.65 +\f3絎茖若吾с:\fP 2.1.1
189.66 +.LP
189.67 +.LP
189.68 +\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若c<障若Web 泣若鴻潟ゃ潟絎茖 (SEI) 茯水Web 泣若鴻若喝冴綽荀鴻≪若c<障
189.69 .LP
189.70 .RE
189.71 -.SH "形式"
189.72 +.SH "网荀"
189.73 .LP
189.74 +\f2wsgen\fP 若JAX\-WS Web 泣若鴻т戎 JAX\-WS 若帥≪若c<障若Web 泣若鴻潟ゃ潟鴻茯水Web 泣若鴻若喝冴綽荀鴻≪若c<障JAXWS 2.1.1 RI wsgen Ant 帥鴻障荅括完
189.75 +.na
189.76 +\f2Wsgen Ant 帥鴻\fP @
189.77 +.fi
189.78 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlс
189.79 +.LP
189.80 +.SH "wsgen 莎桁"
189.81 +.RS 3
189.82 +.TP 2
189.83 +o
189.84 +\f3Solaris/Linux\fP
189.85 +.RS 3
189.86 +.TP 2
189.87 +*
189.88 +\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
189.89 +.TP 2
189.90 +*
189.91 +\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
189.92 +.RE
189.93 +.TP 2
189.94 +o
189.95 +\f3Windows\fP
189.96 +.RS 3
189.97 +.TP 2
189.98 +*
189.99 +\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
189.100 +.TP 2
189.101 +*
189.102 +\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
189.103 +.RE
189.104 +.RE
189.105
189.106 .LP
189.107 +.SH "罕"
189.108 .nf
189.109 \f3
189.110 .fl
189.111 -wsgen [options] <SEI>
189.112 +wsgen [options] <SEI>\fP
189.113 +.br
189.114 +\f3
189.115 .fl
189.116 \fP
189.117 .fi
189.118 -
189.119 .LP
189.120 -.SH "オプション"
189.121 +罨<茵\f2wsgen\fP 激с潟腓冴障
189.122 +.br
189.123 .LP
189.124 -.LP
189.125 -次の表に、\f2wsgen\fP のオプションを示します。
189.126 -.LP
189.127 -.LP
189.128 -表 1\-1 wsgen のオプション
189.129 -.LP
189.130 -.LP
189.131 -.sp 1n
189.132 .TS
189.133 -center;
189.134 -cbp-1 cbp-1
189.135 -li l .
189.136 -オプション 詳細
189.137 -_
189.138 --classpath <path> 入力クラスファイルの検索場所を指定します
189.139 --cp <path> T{
189.140 --classpath <path> と同じ
189.141 -T}
189.142 --d <directory> 生成される出力ファイルを格納する場所を指定する
189.143 --extension T{
189.144 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
189.145 -T}
189.146 --help T{
189.147 -ヘルプを表示します
189.148 -T}
189.149 --keep T{
189.150 -生成されたファイルを保持します
189.151 -T}
189.152 --r <directory> T{
189.153 -常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
189.154 -T}
189.155 --s <directory> T{
189.156 -生成されるソースファイルを格納する場所を指定する
189.157 -T}
189.158 --verbose T{
189.159 -コンパイラが実行している処理に関するメッセージを出力します
189.160 -T}
189.161 --version T{
189.162 -バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
189.163 -T}
189.164 --wsdl[:protocol] T{
189.165 -wsgen はデフォルトでは WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は wsgen が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。protocol は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために使用されます。有効なプロトコルは次のとおりで す。 soap1.1 と Xsoap1.2。デフォルトは soap1.1 です。Xsoap1.2 は標準ではないた め、-extension オプションと組み合わせないと使用できません。
189.166 -T}
189.167 --servicename <name> T{
189.168 -常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:service の名前を指定するために使用します。例 : -servicename "{http://mynamespace/}MyService"
189.169 -T}
189.170 --portname <name> T{
189.171 -常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:port の名 前を指定するために使用します。例 : -portname "{http://mynamespace/}MyPort"
189.172 -T}
189.173 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
189.174 +.de 35
189.175 +.ps \n(.s
189.176 +.vs \n(.vu
189.177 +.in \n(.iu
189.178 +.if \n(.u .fi
189.179 +.if \n(.j .ad
189.180 +.if \n(.j=0 .na
189.181 +..
189.182 +.nf
189.183 +.nr #~ 0
189.184 +.if n .nr #~ 0.6n
189.185 +.ds #d .d
189.186 +.if \(ts\n(.z\(ts\(ts .ds #d nl
189.187 +.fc
189.188 +.nr 33 \n(.s
189.189 +.rm 80 81
189.190 +.nr 34 \n(.lu
189.191 +.eo
189.192 +.am 81
189.193 +.br
189.194 +.di a+
189.195 +.35
189.196 +.ft \n(.f
189.197 +.ll \n(34u*1u/3u
189.198 +.if \n(.l<\n(81 .ll \n(81u
189.199 +.in 0
189.200 +ュ鴻<ゃ罎膣√贋絎障
189.201 +.br
189.202 +.di
189.203 +.nr a| \n(dn
189.204 +.nr a- \n(dl
189.205 +..
189.206 +.ec \
189.207 +.eo
189.208 +.am 81
189.209 +.br
189.210 +.di b+
189.211 +.35
189.212 +.ft \n(.f
189.213 +.ll \n(34u*1u/3u
189.214 +.if \n(.l<\n(81 .ll \n(81u
189.215 +.in 0
189.216 +\f2\-classpath <path>\fP
189.217 +.br
189.218 +.di
189.219 +.nr b| \n(dn
189.220 +.nr b- \n(dl
189.221 +..
189.222 +.ec \
189.223 +.eo
189.224 +.am 81
189.225 +.br
189.226 +.di c+
189.227 +.35
189.228 +.ft \n(.f
189.229 +.ll \n(34u*1u/3u
189.230 +.if \n(.l<\n(81 .ll \n(81u
189.231 +.in 0
189.232 +阪<ゃ主贋絎
189.233 +.br
189.234 +.di
189.235 +.nr c| \n(dn
189.236 +.nr c- \n(dl
189.237 +..
189.238 +.ec \
189.239 +.eo
189.240 +.am 81
189.241 +.br
189.242 +.di d+
189.243 +.35
189.244 +.ft \n(.f
189.245 +.ll \n(34u*1u/3u
189.246 +.if \n(.l<\n(81 .ll \n(81u
189.247 +.in 0
189.248 +潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵с障
189.249 +.br
189.250 +.di
189.251 +.nr d| \n(dn
189.252 +.nr d- \n(dl
189.253 +..
189.254 +.ec \
189.255 +.eo
189.256 +.am 81
189.257 +.br
189.258 +.di e+
189.259 +.35
189.260 +.ft \n(.f
189.261 +.ll \n(34u*1u/3u
189.262 +.if \n(.l<\n(81 .ll \n(81u
189.263 +.in 0
189.264 +茵腓冴障
189.265 +.br
189.266 +.di
189.267 +.nr e| \n(dn
189.268 +.nr e- \n(dl
189.269 +..
189.270 +.ec \
189.271 +.eo
189.272 +.am 81
189.273 +.br
189.274 +.di f+
189.275 +.35
189.276 +.ft \n(.f
189.277 +.ll \n(34u*1u/3u
189.278 +.if \n(.l<\n(81 .ll \n(81u
189.279 +.in 0
189.280 +<ゃ篆障
189.281 +.br
189.282 +.di
189.283 +.nr f| \n(dn
189.284 +.nr f- \n(dl
189.285 +..
189.286 +.ec \
189.287 +.eo
189.288 +.am 81
189.289 +.br
189.290 +.di g+
189.291 +.35
189.292 +.ft \n(.f
189.293 +.ll \n(34u*1u/3u
189.294 +.if \n(.l<\n(81 .ll \n(81u
189.295 +.in 0
189.296 +絽吾 \-wsdl 激с潟腟水篏睡障WSDL 純若鴻<ゃ主贋絎障
189.297 +.br
189.298 +.di
189.299 +.nr g| \n(dn
189.300 +.nr g- \n(dl
189.301 +..
189.302 +.ec \
189.303 +.eo
189.304 +.am 81
189.305 +.br
189.306 +.di h+
189.307 +.35
189.308 +.ft \n(.f
189.309 +.ll \n(34u*1u/3u
189.310 +.if \n(.l<\n(81 .ll \n(81u
189.311 +.in 0
189.312 +純若鴻<ゃ主贋絎
189.313 +.br
189.314 +.di
189.315 +.nr h| \n(dn
189.316 +.nr h- \n(dl
189.317 +..
189.318 +.ec \
189.319 +.eo
189.320 +.am 81
189.321 +.br
189.322 +.di i+
189.323 +.35
189.324 +.ft \n(.f
189.325 +.ll \n(34u*1u/3u
189.326 +.if \n(.l<\n(81 .ll \n(81u
189.327 +.in 0
189.328 +潟潟ゃ絎茵≪<祉若吾阪障
189.329 +.br
189.330 +.di
189.331 +.nr i| \n(dn
189.332 +.nr i- \n(dl
189.333 +..
189.334 +.ec \
189.335 +.eo
189.336 +.am 81
189.337 +.br
189.338 +.di j+
189.339 +.35
189.340 +.ft \n(.f
189.341 +.ll \n(34u*1u/3u
189.342 +.if \n(.l<\n(81 .ll \n(81u
189.343 +.in 0
189.344 +若吾с恰宴阪障激с潟篏睡翫若吾с恰宴阪с絽吾絎茵障
189.345 +.br
189.346 +.di
189.347 +.nr j| \n(dn
189.348 +.nr j- \n(dl
189.349 +..
189.350 +.ec \
189.351 +.eo
189.352 +.am 81
189.353 +.br
189.354 +.di k+
189.355 +.35
189.356 +.ft \n(.f
189.357 +.ll \n(34u*1u/3u
189.358 +.if \n(.l<\n(81 .ll \n(81u
189.359 +.in 0
189.360 +\f2wsgen\fP с WSDL <ゃ障違ュ純с絎翫 \f2wsgen\fP WSDL <ゃ障違絽吾潟ゃ潟肴 WSDL сс篏睡障\f2protocol\fP ュ純с\f2wsdl:binding\fP т戎鴻潟絎篏睡障鴻潟罨<с\f2soap1.1\fP \f2Xsoap1.2\fP \f2soap1.1\fP с\f2Xsoap1.2\fP 罔羣с\f2\-extension\fP 激с潟腟水篏睡с障
189.361 +.br
189.362 +.di
189.363 +.nr k| \n(dn
189.364 +.nr k- \n(dl
189.365 +..
189.366 +.ec \
189.367 +.eo
189.368 +.am 81
189.369 +.br
189.370 +.di l+
189.371 +.35
189.372 +.ft \n(.f
189.373 +.ll \n(34u*1u/3u
189.374 +.if \n(.l<\n(81 .ll \n(81u
189.375 +.in 0
189.376 +絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:service\fP 絎篏睡障箴 : \f2\-servicename "{http://mynamespace/}MyService"\fP
189.377 +.br
189.378 +.di
189.379 +.nr l| \n(dn
189.380 +.nr l- \n(dl
189.381 +..
189.382 +.ec \
189.383 +.eo
189.384 +.am 81
189.385 +.br
189.386 +.di m+
189.387 +.35
189.388 +.ft \n(.f
189.389 +.ll \n(34u*1u/3u
189.390 +.if \n(.l<\n(81 .ll \n(81u
189.391 +.in 0
189.392 +絽吾 \f2\-wsdl\fP 激с潟腟水篏睡障WSDL х鴻 \f2wsdl:port\fP 絎篏睡障箴 : \f2\-portname "{http://mynamespace/}MyPort"\fP
189.393 +.br
189.394 +.br
189.395 +.di
189.396 +.nr m| \n(dn
189.397 +.nr m- \n(dl
189.398 +..
189.399 +.ec \
189.400 +.35
189.401 +.nf
189.402 +.ll \n(34u
189.403 +.nr 80 0
189.404 +.nr 38 \w\f3激с\fP
189.405 +.if \n(80<\n(38 .nr 80 \n(38
189.406 +.nr 38 \w\f4\-classpath <path>\fP
189.407 +.if \n(80<\n(38 .nr 80 \n(38
189.408 +.nr 38 \w\f4\-cp <path>\fP
189.409 +.if \n(80<\n(38 .nr 80 \n(38
189.410 +.nr 38 \w\f4\-d <directory>\fP
189.411 +.if \n(80<\n(38 .nr 80 \n(38
189.412 +.nr 38 \w\f4\-extension\fP
189.413 +.if \n(80<\n(38 .nr 80 \n(38
189.414 +.nr 38 \w\f4\-help\fP
189.415 +.if \n(80<\n(38 .nr 80 \n(38
189.416 +.nr 38 \w\f4\-keep\fP
189.417 +.if \n(80<\n(38 .nr 80 \n(38
189.418 +.nr 38 \w\f4\-r <directory>\fP
189.419 +.if \n(80<\n(38 .nr 80 \n(38
189.420 +.nr 38 \w\f4\-s <directory>\fP
189.421 +.if \n(80<\n(38 .nr 80 \n(38
189.422 +.nr 38 \w\f4\-verbose\fP
189.423 +.if \n(80<\n(38 .nr 80 \n(38
189.424 +.nr 38 \w\f4\-version\fP
189.425 +.if \n(80<\n(38 .nr 80 \n(38
189.426 +.nr 38 \w\f4\-wsdl[:protocol]\fP
189.427 +.if \n(80<\n(38 .nr 80 \n(38
189.428 +.nr 38 \w\f4\-servicename <name>\fP
189.429 +.if \n(80<\n(38 .nr 80 \n(38
189.430 +.nr 38 \w\f4\-portname <name>\fP
189.431 +.if \n(80<\n(38 .nr 80 \n(38
189.432 +.80
189.433 +.rm 80
189.434 +.nr 81 0
189.435 +.nr 38 \w\f3茯\fP
189.436 +.if \n(81<\n(38 .nr 81 \n(38
189.437 +.81
189.438 +.rm 81
189.439 +.nr 38 \n(a-
189.440 +.if \n(81<\n(38 .nr 81 \n(38
189.441 +.nr 38 \n(b-
189.442 +.if \n(81<\n(38 .nr 81 \n(38
189.443 +.nr 38 \n(c-
189.444 +.if \n(81<\n(38 .nr 81 \n(38
189.445 +.nr 38 \n(d-
189.446 +.if \n(81<\n(38 .nr 81 \n(38
189.447 +.nr 38 \n(e-
189.448 +.if \n(81<\n(38 .nr 81 \n(38
189.449 +.nr 38 \n(f-
189.450 +.if \n(81<\n(38 .nr 81 \n(38
189.451 +.nr 38 \n(g-
189.452 +.if \n(81<\n(38 .nr 81 \n(38
189.453 +.nr 38 \n(h-
189.454 +.if \n(81<\n(38 .nr 81 \n(38
189.455 +.nr 38 \n(i-
189.456 +.if \n(81<\n(38 .nr 81 \n(38
189.457 +.nr 38 \n(j-
189.458 +.if \n(81<\n(38 .nr 81 \n(38
189.459 +.nr 38 \n(k-
189.460 +.if \n(81<\n(38 .nr 81 \n(38
189.461 +.nr 38 \n(l-
189.462 +.if \n(81<\n(38 .nr 81 \n(38
189.463 +.nr 38 \n(m-
189.464 +.if \n(81<\n(38 .nr 81 \n(38
189.465 +.35
189.466 +.nf
189.467 +.ll \n(34u
189.468 +.nr 38 1n
189.469 +.nr 79 0
189.470 +.nr 40 \n(79+(0*\n(38)
189.471 +.nr 80 +\n(40
189.472 +.nr 41 \n(80+(3*\n(38)
189.473 +.nr 81 +\n(41
189.474 +.nr TW \n(81
189.475 +.if t .if \n(TW>\n(.li .tm Table at line 144 file Input is too wide - \n(TW units
189.476 +.fc
189.477 +.nr #T 0-1
189.478 +.nr #a 0-1
189.479 +.eo
189.480 +.de T#
189.481 +.ds #d .d
189.482 +.if \(ts\n(.z\(ts\(ts .ds #d nl
189.483 +.mk ##
189.484 +.nr ## -1v
189.485 +.ls 1
189.486 +.ls
189.487 +..
189.488 +.ec
189.489 +.ta \n(80u \n(81u
189.490 +.nr 31 \n(.f
189.491 +.nr 35 1m
189.492 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
189.493 +.ne \n(a|u+\n(.Vu
189.494 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
189.495 +.ta \n(80u \n(81u
189.496 +.nr 31 \n(.f
189.497 +.nr 35 1m
189.498 +\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
189.499 +.mk ##
189.500 +.nr 31 \n(##
189.501 +.sp |\n(##u-1v
189.502 +.nr 37 \n(41u
189.503 +.in +\n(37u
189.504 +.a+
189.505 +.in -\n(37u
189.506 +.mk 32
189.507 +.if \n(32>\n(31 .nr 31 \n(32
189.508 +.sp |\n(31u
189.509 +.ne \n(b|u+\n(.Vu
189.510 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
189.511 +.ta \n(80u \n(81u
189.512 +.nr 31 \n(.f
189.513 +.nr 35 1m
189.514 +\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
189.515 +.mk ##
189.516 +.nr 31 \n(##
189.517 +.sp |\n(##u-1v
189.518 +.nr 37 \n(41u
189.519 +.in +\n(37u
189.520 +.b+
189.521 +.in -\n(37u
189.522 +.mk 32
189.523 +.if \n(32>\n(31 .nr 31 \n(32
189.524 +.sp |\n(31u
189.525 +.ne \n(c|u+\n(.Vu
189.526 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
189.527 +.ta \n(80u \n(81u
189.528 +.nr 31 \n(.f
189.529 +.nr 35 1m
189.530 +\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
189.531 +.mk ##
189.532 +.nr 31 \n(##
189.533 +.sp |\n(##u-1v
189.534 +.nr 37 \n(41u
189.535 +.in +\n(37u
189.536 +.c+
189.537 +.in -\n(37u
189.538 +.mk 32
189.539 +.if \n(32>\n(31 .nr 31 \n(32
189.540 +.sp |\n(31u
189.541 +.ne \n(d|u+\n(.Vu
189.542 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
189.543 +.ta \n(80u \n(81u
189.544 +.nr 31 \n(.f
189.545 +.nr 35 1m
189.546 +\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
189.547 +.mk ##
189.548 +.nr 31 \n(##
189.549 +.sp |\n(##u-1v
189.550 +.nr 37 \n(41u
189.551 +.in +\n(37u
189.552 +.d+
189.553 +.in -\n(37u
189.554 +.mk 32
189.555 +.if \n(32>\n(31 .nr 31 \n(32
189.556 +.sp |\n(31u
189.557 +.ne \n(e|u+\n(.Vu
189.558 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
189.559 +.ta \n(80u \n(81u
189.560 +.nr 31 \n(.f
189.561 +.nr 35 1m
189.562 +\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'
189.563 +.mk ##
189.564 +.nr 31 \n(##
189.565 +.sp |\n(##u-1v
189.566 +.nr 37 \n(41u
189.567 +.in +\n(37u
189.568 +.e+
189.569 +.in -\n(37u
189.570 +.mk 32
189.571 +.if \n(32>\n(31 .nr 31 \n(32
189.572 +.sp |\n(31u
189.573 +.ne \n(f|u+\n(.Vu
189.574 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
189.575 +.ta \n(80u \n(81u
189.576 +.nr 31 \n(.f
189.577 +.nr 35 1m
189.578 +\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'
189.579 +.mk ##
189.580 +.nr 31 \n(##
189.581 +.sp |\n(##u-1v
189.582 +.nr 37 \n(41u
189.583 +.in +\n(37u
189.584 +.f+
189.585 +.in -\n(37u
189.586 +.mk 32
189.587 +.if \n(32>\n(31 .nr 31 \n(32
189.588 +.sp |\n(31u
189.589 +.ne \n(g|u+\n(.Vu
189.590 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
189.591 +.ta \n(80u \n(81u
189.592 +.nr 31 \n(.f
189.593 +.nr 35 1m
189.594 +\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
189.595 +.mk ##
189.596 +.nr 31 \n(##
189.597 +.sp |\n(##u-1v
189.598 +.nr 37 \n(41u
189.599 +.in +\n(37u
189.600 +.g+
189.601 +.in -\n(37u
189.602 +.mk 32
189.603 +.if \n(32>\n(31 .nr 31 \n(32
189.604 +.sp |\n(31u
189.605 +.ne \n(h|u+\n(.Vu
189.606 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
189.607 +.ta \n(80u \n(81u
189.608 +.nr 31 \n(.f
189.609 +.nr 35 1m
189.610 +\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
189.611 +.mk ##
189.612 +.nr 31 \n(##
189.613 +.sp |\n(##u-1v
189.614 +.nr 37 \n(41u
189.615 +.in +\n(37u
189.616 +.h+
189.617 +.in -\n(37u
189.618 +.mk 32
189.619 +.if \n(32>\n(31 .nr 31 \n(32
189.620 +.sp |\n(31u
189.621 +.ne \n(i|u+\n(.Vu
189.622 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
189.623 +.ta \n(80u \n(81u
189.624 +.nr 31 \n(.f
189.625 +.nr 35 1m
189.626 +\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
189.627 +.mk ##
189.628 +.nr 31 \n(##
189.629 +.sp |\n(##u-1v
189.630 +.nr 37 \n(41u
189.631 +.in +\n(37u
189.632 +.i+
189.633 +.in -\n(37u
189.634 +.mk 32
189.635 +.if \n(32>\n(31 .nr 31 \n(32
189.636 +.sp |\n(31u
189.637 +.ne \n(j|u+\n(.Vu
189.638 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
189.639 +.ta \n(80u \n(81u
189.640 +.nr 31 \n(.f
189.641 +.nr 35 1m
189.642 +\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
189.643 +.mk ##
189.644 +.nr 31 \n(##
189.645 +.sp |\n(##u-1v
189.646 +.nr 37 \n(41u
189.647 +.in +\n(37u
189.648 +.j+
189.649 +.in -\n(37u
189.650 +.mk 32
189.651 +.if \n(32>\n(31 .nr 31 \n(32
189.652 +.sp |\n(31u
189.653 +.ne \n(k|u+\n(.Vu
189.654 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
189.655 +.ta \n(80u \n(81u
189.656 +.nr 31 \n(.f
189.657 +.nr 35 1m
189.658 +\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
189.659 +.mk ##
189.660 +.nr 31 \n(##
189.661 +.sp |\n(##u-1v
189.662 +.nr 37 \n(41u
189.663 +.in +\n(37u
189.664 +.k+
189.665 +.in -\n(37u
189.666 +.mk 32
189.667 +.if \n(32>\n(31 .nr 31 \n(32
189.668 +.sp |\n(31u
189.669 +.ne \n(l|u+\n(.Vu
189.670 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
189.671 +.ta \n(80u \n(81u
189.672 +.nr 31 \n(.f
189.673 +.nr 35 1m
189.674 +\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
189.675 +.mk ##
189.676 +.nr 31 \n(##
189.677 +.sp |\n(##u-1v
189.678 +.nr 37 \n(41u
189.679 +.in +\n(37u
189.680 +.l+
189.681 +.in -\n(37u
189.682 +.mk 32
189.683 +.if \n(32>\n(31 .nr 31 \n(32
189.684 +.sp |\n(31u
189.685 +.ne \n(m|u+\n(.Vu
189.686 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
189.687 +.ta \n(80u \n(81u
189.688 +.nr 31 \n(.f
189.689 +.nr 35 1m
189.690 +\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
189.691 +.mk ##
189.692 +.nr 31 \n(##
189.693 +.sp |\n(##u-1v
189.694 +.nr 37 \n(41u
189.695 +.in +\n(37u
189.696 +.m+
189.697 +.in -\n(37u
189.698 +.mk 32
189.699 +.if \n(32>\n(31 .nr 31 \n(32
189.700 +.sp |\n(31u
189.701 +.fc
189.702 +.nr T. 1
189.703 +.T# 1
189.704 +.35
189.705 +.rm a+
189.706 +.rm b+
189.707 +.rm c+
189.708 +.rm d+
189.709 +.rm e+
189.710 +.rm f+
189.711 +.rm g+
189.712 +.rm h+
189.713 +.rm i+
189.714 +.rm j+
189.715 +.rm k+
189.716 +.rm l+
189.717 +.rm m+
189.718 .TE
189.719 .if \n-(b.=0 .nr c. \n(.c-\n(d.-57
189.720
189.721 .LP
189.722 -.SS
189.723 -Ant タスク
189.724 -.LP
189.725 -.LP
189.726 -\f2wsgen\fP ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
189.727 -.LP
189.728 +.SH "箴"
189.729 .nf
189.730 \f3
189.731 .fl
189.732 -
189.733 +\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
189.734 .fl
189.735 - <wsgen
189.736 -.fl
189.737 - sei="..."
189.738 -.fl
189.739 - destdir="directory for generated class files"
189.740 -.fl
189.741 - classpath="classpath" | cp="classpath"
189.742 -.fl
189.743 - resourcedestdir="directory for generated resource files such as WSDLs"
189.744 -.fl
189.745 - sourcedestdir="directory for generated source files"
189.746 -.fl
189.747 - keep="true|false"
189.748 -.fl
189.749 - verbose="true|false"
189.750 -.fl
189.751 - genwsdl="true|false"
189.752 -.fl
189.753 - protocol="soap1.1|Xsoap1.2"
189.754 -.fl
189.755 - servicename="..."
189.756 -.fl
189.757 - portname="...">
189.758 -.fl
189.759 - extension="true|false"
189.760 -.fl
189.761 - <classpath refid="..."/>
189.762 -.fl
189.763 - </wsgen>
189.764 -.fl
189.765 -\fP
189.766 .fi
189.767 -
189.768 .LP
189.769 -.LP
189.770 -.TS
189.771 -center;
189.772 -lbp-1 lbp-1 lbp-1
189.773 -li l l
189.774 -li l li .
189.775 -属性 説明 コマンド行
189.776 -_
189.777 -sei サービスエンドポイント実装クラスの名前 SEI
189.778 -destdir T{
189.779 -生成される出力クラスを格納する場所を指定します
189.780 -T} -d
189.781 -classpath 入力クラスファイルの検索場所を指定します -classpath
189.782 -cp -classpath と同じ -cp
189.783 -resourcedestdir T{
189.784 -常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
189.785 -T} -r
189.786 -sourcedestdir T{
189.787 -生成されるソースファイルを格納する場所を指定します
189.788 -T} -s
189.789 -keep 生成されたファイルを保持します -keep
189.790 -verbose T{
189.791 -コンパイラが実行している処理に関するメッセージを出力します
189.792 -T} -verbose
189.793 -genwsdl T{
189.794 -WSDL ファイルを生 成すべきかどうかを指定します
189.795 -T} -wsdl
189.796 -protocol T{
189.797 -genwsdl と組み合わせて使用します。wsdl:binding で使用するプロトコルを指定します。有効な値は「soap1.1」と「Xsoap1.2」で、デフォルトは「soap1.1」です。「Xsoap1.2」は標準ではないため、-extensions オプションと組み合わせないと使用できません
189.798 -T} -wsdl:soap11
189.799 -servicename T{
189.800 -genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:service の名前を指定するために使用します。例 : servicename="{http://mynamespace/}MyService"
189.801 -T} -servicename
189.802 -portname T{
189.803 -genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:portname の名前を指定するために使用します。例 : portname="{http://mynamespace/}MyPort"
189.804 -T} -servicename
189.805 -extension T{
189.806 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
189.807 -T} -extension
189.808 -.TE
189.809 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
189.810 -
189.811 -.LP
189.812 -.LP
189.813 -\f2classpath\fP 属性は、
189.814 -.na
189.815 -\f2Path\-like Structure\fP
189.816 -.fi
189.817 -(http://ant.apache.org/manual/using.html#path) であり、入れ子になった \f2<classpath>\fP 要素を使って設定することもできます。このタスクを使用するには、次の \f2<taskdef>\fP 要素をプロジェクトに追加しておく必要があります。
189.818 -.LP
189.819 +\f3stock\fP c @WebService 羈篁StockService 綽荀若鴻障
189.820 .nf
189.821 \f3
189.822 .fl
189.823 - <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">
189.824 +\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
189.825 .fl
189.826 - <classpath path="jaxws.classpath"/>
189.827 -.fl
189.828 - </taskdef>
189.829 -.fl
189.830 -\fP
189.831 .fi
189.832 -
189.833 .LP
189.834 -.LP
189.835 -ここで、\f2jaxws.classpath\fP は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された
189.836 -.na
189.837 -\f2Path\-like Structure\fP
189.838 -.fi
189.839 -(http://ant.apache.org/manual/using.html#path) への参照です。
189.840 -.LP
189.841 -.SH "例"
189.842 -.LP
189.843 -
189.844 -.LP
189.845 +SOAP 1.1 WSDL @WebService 羈篁 Java stock.StockService 鴻若障
189.846 .nf
189.847 \f3
189.848 .fl
189.849 -<wsgen
189.850 +\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
189.851 .fl
189.852 - resourcedestdir="${wsdl.dir}"
189.853 -.fl
189.854 - sei="fromjava.server.AddNumbersImpl">
189.855 -.fl
189.856 - <classpath refid="compile.classpath"/>
189.857 -.fl
189.858 -</wsgen>
189.859 -.fl
189.860 -\fP
189.861 .fi
189.862 -
189.863 .LP
189.864 -
189.865 +SOAP 1.2 WSDL 障
189.866 .LP
189.867 -
189.868 +泣若鴻 JAXWS 潟帥ゃc WSDL 堺 WSDL 綽荀障
190.1 --- a/src/solaris/doc/sun/man/man1/ja/wsimport.1 Tue May 12 15:21:55 2009 +0900
190.2 +++ b/src/solaris/doc/sun/man/man1/ja/wsimport.1 Thu May 14 00:17:25 2009 -0700
190.3 @@ -1,36 +1,84 @@
190.4 -'\" t
190.5 -.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
190.6 -.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
190.7 -.\"
190.8 -.\" This code is free software; you can redistribute it and/or modify it
190.9 -.\" under the terms of the GNU General Public License version 2 only, as
190.10 -.\" published by the Free Software Foundation.
190.11 -.\"
190.12 -.\" This code is distributed in the hope that it will be useful, but WITHOUT
190.13 -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
190.14 -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
190.15 -.\" version 2 for more details (a copy is included in the LICENSE file that
190.16 -.\" accompanied this code).
190.17 -.\"
190.18 -.\" You should have received a copy of the GNU General Public License version
190.19 -.\" 2 along with this work; if not, write to the Free Software Foundation,
190.20 -.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
190.21 -.\"
190.22 -.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
190.23 -.\" CA 95054 USA or visit www.sun.com if you need additional information or
190.24 -.\" have any questions.
190.25 -.\" `
190.26 -.TH wsimport 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
190.27 -." Generated by html2man
190.28 +." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
190.29 +." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
190.30 +."
190.31 +." This code is free software; you can redistribute it and/or modify it
190.32 +." under the terms of the GNU General Public License version 2 only, as
190.33 +." published by the Free Software Foundation.
190.34 +."
190.35 +." This code is distributed in the hope that it will be useful, but WITHOUT
190.36 +." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
190.37 +." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
190.38 +." version 2 for more details (a copy is included in the LICENSE file that
190.39 +." accompanied this code).
190.40 +."
190.41 +." You should have received a copy of the GNU General Public License version
190.42 +." 2 along with this work; if not, write to the Free Software Foundation,
190.43 +." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
190.44 +."
190.45 +." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
190.46 +." CA 95054 USA or visit www.sun.com if you need additional information or
190.47 +." have any questions.
190.48 +."
190.49 +.TH wsimport 1 "04 May 2009"
190.50 +." Generated from HTML by html2man (author: Eric Armstrong)
190.51 +.SH ""
190.52 +wsimport \- XML Web Services (JAX\-WS) 2.0 Java(TM) API
190.53 +.LP
190.54 +\f3篁罕若吾с:\fP 2.1
190.55 +.br
190.56 +\f3絎茖若吾с:\fP 2.1.1
190.57 +.br
190.58 +.SH "网荀"
190.59 +.LP
190.60 +\f2wsimport\fP 若罨< JAX\-WS 若帥≪若c<障
190.61 +.RS 3
190.62 +.TP 2
190.63 +o
190.64 +泣若鴻潟ゃ潟ゃ潟帥с若 (SEI)
190.65 +.TP 2
190.66 +o
190.67 +泣若
190.68 +.TP 2
190.69 +o
190.70 +wsdl:fault 箴紊 (絖翫)
190.71 +.TP 2
190.72 +o
190.73 +綽膈 wsdl:message 羇丞綽膈 Bean (絖翫)
190.74 +.TP 2
190.75 +o
190.76 +JAX\-B ゃ帥ゃ (鴻若 Java )
190.77 +.RE
190.78 +.LP
190.79 +≪若c<WSDL ャ<潟鴻若ャ<潟潟潟ゃ潟絎茖 WAR <ゃ宴若後с障障wsimport Ant 帥鴻障
190.80 +.na
190.81 +\f2Wsimport Ant 帥鴻\fP @
190.82 +.fi
190.83 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.htmlс
190.84 +.br
190.85
190.86 .LP
190.87 -.SH 名前
190.88 -wsimport \- JAX\-WS 2.0 ベータ
190.89 -.LP
190.90 -.SH "形式"
190.91 -.LP
190.92 +.SH "wsimport 莎桁"
190.93 +.RS 3
190.94 +.TP 2
190.95 +o
190.96 +\f3Solaris/Linux\fP
190.97 +.RS 3
190.98 +.TP 2
190.99 +*
190.100 +\f2/bin/wsimport.sh \-help\fP
190.101 +.RE
190.102 +.TP 2
190.103 +o
190.104 +\f3Windows\fP
190.105 +.RS 3
190.106 +.TP 2
190.107 +*
190.108 +\f2\\bin\\wsimport.bat \-help\fP
190.109 +.RE
190.110 +.RE
190.111
190.112 .LP
190.113 +.SH "罕"
190.114 .nf
190.115 \f3
190.116 .fl
190.117 @@ -38,277 +86,701 @@
190.118 .fl
190.119 \fP
190.120 .fi
190.121 -
190.122 .LP
190.123 -.SH "機能説明"
190.124 -.LP
190.125 -.LP
190.126 -\f2wsimport\fP ツールは、次のような JAX-WS ポータブルアーティファクトを生成します。
190.127 -.LP
190.128 -.RS 3
190.129 -.TP 2
190.130 -o
190.131 -サービスエンドポイントインタフェース (SEI)
190.132 -.TP 2
190.133 -o
190.134 -サービス
190.135 -.TP 2
190.136 -o
190.137 -wsdl:fault からマップされる例外クラス (存在する場合)
190.138 -.TP 2
190.139 -o
190.140 -応答 wsdl:message から派生する非同期応答 Bean (存在する場合)
190.141 -.TP 2
190.142 -o
190.143 -JAX-B が生成する値タイプ (スキーマの型からマップされた Java クラス)
190.144 -.RE
190.145 -
190.146 -.LP
190.147 -.LP
190.148 -これらのアーティファクトは、WSDL ドキュメント、スキーマドキュメント、およびエンドポイント実装とともに WAR ファイル内にパッケージ化して配備することができます。
190.149 -.br
190.150 -
190.151 -.LP
190.152 -.LP
190.153 -wsimport ツールを起動するには、コマンド行スクリプト wsimport.sh (Unix) または wsimport.bat (Windows) を使用します。WSDL をインポートおよびコンパイルするための Ant タスクも存在しています。詳しくは後述の説明を参照してください。
190.154 -.br
190.155 -
190.156 -.LP
190.157 -.SH "オプション"
190.158 -.LP
190.159 -.LP
190.160 -次の表に、\f2wsimport\fP のオプションを示します。
190.161 -.br
190.162 -
190.163 -.LP
190.164 -.LP
190.165 -表 1\-1 wsimport のオプション
190.166 -.LP
190.167 +罨<茵\f2wsimport\fP 激с潟腓冴障
190.168 .LP
190.169 .TS
190.170 -center;
190.171 -cbp-1 cbp-1
190.172 -li l.
190.173 -オプション 説明
190.174 -_
190.175 --d <directory> 生成される出力ファイルを格納する場所を指定します
190.176 --b <path> T{
190.177 -外部の JAX-WS または JAXB バインディングファイルを指定します (<file> ごとに -b が必要となる)
190.178 -T}
190.179 --catalog T{
190.180 -外部エンティティ参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。「XML Entity and URI Resolvers」ドキュメントをお読みになるか、wsimport_catalog サンプルを参照してください。
190.181 -T}
190.182 --extension T{
190.183 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
190.184 -T}
190.185 --help ヘルプを表示します
190.186 --httpproxy:<host>:<port> T{
190.187 -HTTP プロキシサーバーを指定します (デフォルトのポートは 8080)
190.188 -T}
190.189 --keep 生成されたファイルを保持します
190.190 --p T{
190.191 -このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべての WSDL/スキーマバインディングカスタマイズや、 仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます
190.192 -T}
190.193 --s <directory> T{
190.194 -生成されるソースファイルを格納する場所を指定します
190.195 -T}
190.196 --verbose T{
190.197 -コンパイラが実行している処理に関するメッセージを出力します
190.198 -T}
190.199 --version バージョン情報を出力します
190.200 --wsdllocation <location> T{
190.201 -@WebService.wsdlLocation と @WebServiceClient.wsdlLocation の値
190.202 -T}
190.203 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
190.204 +.de 35
190.205 +.ps \n(.s
190.206 +.vs \n(.vu
190.207 +.in \n(.iu
190.208 +.if \n(.u .fi
190.209 +.if \n(.j .ad
190.210 +.if \n(.j=0 .na
190.211 +..
190.212 +.nf
190.213 +.nr #~ 0
190.214 +.if n .nr #~ 0.6n
190.215 +.ds #d .d
190.216 +.if \(ts\n(.z\(ts\(ts .ds #d nl
190.217 +.fc
190.218 +.nr 33 \n(.s
190.219 +.rm 80 81
190.220 +.nr 34 \n(.lu
190.221 +.eo
190.222 +.am 81
190.223 +.br
190.224 +.di a+
190.225 +.35
190.226 +.ft \n(.f
190.227 +.ll \n(34u*1u/3u
190.228 +.if \n(.l<\n(81 .ll \n(81u
190.229 +.in 0
190.230 +阪<ゃ主贋絎障
190.231 +.br
190.232 +.di
190.233 +.nr a| \n(dn
190.234 +.nr a- \n(dl
190.235 +..
190.236 +.ec \
190.237 +.eo
190.238 +.am 81
190.239 +.br
190.240 +.di b+
190.241 +.35
190.242 +.ft \n(.f
190.243 +.ll \n(34u*1u/3u
190.244 +.if \n(.l<\n(81 .ll \n(81u
190.245 +.in 0
190.246 +紊 JAX\-WS 障 JAXB ゃ潟c潟違<ゃ絎障 (\f2<file>\fP \f2\-b\fP 綽荀)
190.247 +.br
190.248 +.di
190.249 +.nr b| \n(dn
190.250 +.nr b- \n(dl
190.251 +..
190.252 +.ec \
190.253 +.eo
190.254 +.am 81
190.255 +.br
190.256 +.di c+
190.257 +.35
190.258 +.ft \n(.f
190.259 +.ll \n(34u*1u/3u
190.260 +.if \n(.l<\n(81 .ll \n(81u
190.261 +.in 0
190.262 +激с潟 JAXB 鴻若潟潟ゃ羝<障
190.263 +.br
190.264 +.di
190.265 +.nr c| \n(dn
190.266 +.nr c- \n(dl
190.267 +..
190.268 +.ec \
190.269 +.eo
190.270 +.am 81
190.271 +.br
190.272 +.di d+
190.273 +.35
190.274 +.ft \n(.f
190.275 +.ll \n(34u*1u/3u
190.276 +.if \n(.l<\n(81 .ll \n(81u
190.277 +.in 0
190.278 +紊潟cc弱с茹f浦帥違<ゃ絎障 TR9401XCatalogOASIS XML Catalog 綵√泣若障
190.279 +.na
190.280 +\f2帥\fP @
190.281 +.fi
190.282 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.htmlャ<潟茯帥\f3帥\fP泣潟с
190.283 +.br
190.284 +.di
190.285 +.nr d| \n(dn
190.286 +.nr d- \n(dl
190.287 +..
190.288 +.ec \
190.289 +.eo
190.290 +.am 81
190.291 +.br
190.292 +.di e+
190.293 +.35
190.294 +.ft \n(.f
190.295 +.ll \n(34u*1u/3u
190.296 +.if \n(.l<\n(81 .ll \n(81u
190.297 +.in 0
190.298 +潟惹≦宍 (篁罕ц鎘罘) 荐怨障≦宍篏睡≪宴若激с潟腱紙с紊宴祉絎茖娯茵醇с障
190.299 +.br
190.300 +.di
190.301 +.nr e| \n(dn
190.302 +.nr e- \n(dl
190.303 +..
190.304 +.ec \
190.305 +.eo
190.306 +.am 81
190.307 +.br
190.308 +.di f+
190.309 +.35
190.310 +.ft \n(.f
190.311 +.ll \n(34u*1u/3u
190.312 +.if \n(.l<\n(81 .ll \n(81u
190.313 +.in 0
190.314 +茵腓冴障
190.315 +.br
190.316 +.di
190.317 +.nr f| \n(dn
190.318 +.nr f- \n(dl
190.319 +..
190.320 +.ec \
190.321 +.eo
190.322 +.am 80
190.323 +.br
190.324 +.di g+
190.325 +.35
190.326 +.ft \n(.f
190.327 +.ll \n(34u*1u/3u
190.328 +.if \n(.l<\n(80 .ll \n(80u
190.329 +.in 0
190.330 +\f3\-httpproxy:<host>:<port> \fP
190.331 +.br
190.332 +.di
190.333 +.nr g| \n(dn
190.334 +.nr g- \n(dl
190.335 +..
190.336 +.ec \
190.337 +.eo
190.338 +.am 81
190.339 +.br
190.340 +.di h+
190.341 +.35
190.342 +.ft \n(.f
190.343 +.ll \n(34u*1u/3u
190.344 +.if \n(.l<\n(81 .ll \n(81u
190.345 +.in 0
190.346 +HTTP 激泣若若絎障 (若 8080)
190.347 +.br
190.348 +.di
190.349 +.nr h| \n(dn
190.350 +.nr h- \n(dl
190.351 +..
190.352 +.ec \
190.353 +.eo
190.354 +.am 81
190.355 +.br
190.356 +.di i+
190.357 +.35
190.358 +.ft \n(.f
190.359 +.ll \n(34u*1u/3u
190.360 +.if \n(.l<\n(81 .ll \n(81u
190.361 +.in 0
190.362 +<ゃ篆障
190.363 +.br
190.364 +.di
190.365 +.nr i| \n(dn
190.366 +.nr i- \n(dl
190.367 +..
190.368 +.ec \
190.369 +.eo
190.370 +.am 81
190.371 +.br
190.372 +.di j+
190.373 +.35
190.374 +.ft \n(.f
190.375 +.ll \n(34u*1u/3u
190.376 +.if \n(.l<\n(81 .ll \n(81u
190.377 +.in 0
190.378 +潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻 WSDL/鴻若ゃ潟c潟違鴻帥ゃ冴 篁罕ц鎘宴若後≪眼冴障
190.379 +.br
190.380 +.di
190.381 +.nr j| \n(dn
190.382 +.nr j- \n(dl
190.383 +..
190.384 +.ec \
190.385 +.eo
190.386 +.am 81
190.387 +.br
190.388 +.di k+
190.389 +.35
190.390 +.ft \n(.f
190.391 +.ll \n(34u*1u/3u
190.392 +.if \n(.l<\n(81 .ll \n(81u
190.393 +.in 0
190.394 +純若鴻<ゃ主贋絎障
190.395 +.br
190.396 +.di
190.397 +.nr k| \n(dn
190.398 +.nr k- \n(dl
190.399 +..
190.400 +.ec \
190.401 +.eo
190.402 +.am 81
190.403 +.br
190.404 +.di l+
190.405 +.35
190.406 +.ft \n(.f
190.407 +.ll \n(34u*1u/3u
190.408 +.if \n(.l<\n(81 .ll \n(81u
190.409 +.in 0
190.410 +潟潟ゃ絎茵≪<祉若吾阪障
190.411 +.br
190.412 +.di
190.413 +.nr l| \n(dn
190.414 +.nr l- \n(dl
190.415 +..
190.416 +.ec \
190.417 +.eo
190.418 +.am 81
190.419 +.br
190.420 +.di m+
190.421 +.35
190.422 +.ft \n(.f
190.423 +.ll \n(34u*1u/3u
190.424 +.if \n(.l<\n(81 .ll \n(81u
190.425 +.in 0
190.426 +若吾с恰宴阪障
190.427 +.br
190.428 +.di
190.429 +.nr m| \n(dn
190.430 +.nr m- \n(dl
190.431 +..
190.432 +.ec \
190.433 +.eo
190.434 +.am 80
190.435 +.br
190.436 +.di n+
190.437 +.35
190.438 +.ft \n(.f
190.439 +.ll \n(34u*1u/3u
190.440 +.if \n(.l<\n(80 .ll \n(80u
190.441 +.in 0
190.442 +\f3\-wsdllocation <location>\fP
190.443 +.br
190.444 +.di
190.445 +.nr n| \n(dn
190.446 +.nr n- \n(dl
190.447 +..
190.448 +.ec \
190.449 +.eo
190.450 +.am 81
190.451 +.br
190.452 +.di o+
190.453 +.35
190.454 +.ft \n(.f
190.455 +.ll \n(34u*1u/3u
190.456 +.if \n(.l<\n(81 .ll \n(81u
190.457 +.in 0
190.458 +\f2@WebServiceClient.wsdlLocation\fP
190.459 +.br
190.460 +.di
190.461 +.nr o| \n(dn
190.462 +.nr o- \n(dl
190.463 +..
190.464 +.ec \
190.465 +.eo
190.466 +.am 81
190.467 +.br
190.468 +.di p+
190.469 +.35
190.470 +.ft \n(.f
190.471 +.ll \n(34u*1u/3u
190.472 +.if \n(.l<\n(81 .ll \n(81u
190.473 +.in 0
190.474 +絎 JAX\-WS 篁罕若吾с潟緇c潟若障若吾с 2.0 сJAX\-WS 2.0 篁罕羣潟若障
190.475 +.br
190.476 +.di
190.477 +.nr p| \n(dn
190.478 +.nr p- \n(dl
190.479 +..
190.480 +.ec \
190.481 +.eo
190.482 +.am 81
190.483 +.br
190.484 +.di q+
190.485 +.35
190.486 +.ft \n(.f
190.487 +.ll \n(34u*1u/3u
190.488 +.if \n(.l<\n(81 .ll \n(81u
190.489 +.in 0
190.490 +wsimport 阪吟障
190.491 +.br
190.492 +.di
190.493 +.nr q| \n(dn
190.494 +.nr q- \n(dl
190.495 +..
190.496 +.ec \
190.497 +.35
190.498 +.nf
190.499 +.ll \n(34u
190.500 +.nr 80 0
190.501 +.nr 38 \w\f3激с\fP
190.502 +.if \n(80<\n(38 .nr 80 \n(38
190.503 +.nr 38 \w\f3\-d <directory> \fP
190.504 +.if \n(80<\n(38 .nr 80 \n(38
190.505 +.nr 38 \w\f3\-b <path> \fP
190.506 +.if \n(80<\n(38 .nr 80 \n(38
190.507 +.nr 38 \w\f3\-B <jaxbOption>\fP
190.508 +.if \n(80<\n(38 .nr 80 \n(38
190.509 +.nr 38 \w\f3\-catalog\fP
190.510 +.if \n(80<\n(38 .nr 80 \n(38
190.511 +.nr 38 \w\f3\-extension \fP
190.512 +.if \n(80<\n(38 .nr 80 \n(38
190.513 +.nr 38 \w\f3\-help \fP
190.514 +.if \n(80<\n(38 .nr 80 \n(38
190.515 +.nr 38 \w\f3\-keep \fP
190.516 +.if \n(80<\n(38 .nr 80 \n(38
190.517 +.nr 38 \w\f3\-p \fP
190.518 +.if \n(80<\n(38 .nr 80 \n(38
190.519 +.nr 38 \w\f3\-s <directory> \fP
190.520 +.if \n(80<\n(38 .nr 80 \n(38
190.521 +.nr 38 \w\f3\-verbose \fP
190.522 +.if \n(80<\n(38 .nr 80 \n(38
190.523 +.nr 38 \w\f3\-version \fP
190.524 +.if \n(80<\n(38 .nr 80 \n(38
190.525 +.nr 38 \w\f3\-target \fP
190.526 +.if \n(80<\n(38 .nr 80 \n(38
190.527 +.nr 38 \w\f3\-quiet \fP
190.528 +.if \n(80<\n(38 .nr 80 \n(38
190.529 +.80
190.530 +.rm 80
190.531 +.nr 38 \n(g-
190.532 +.if \n(80<\n(38 .nr 80 \n(38
190.533 +.nr 38 \n(n-
190.534 +.if \n(80<\n(38 .nr 80 \n(38
190.535 +.nr 81 0
190.536 +.nr 38 \w\f3茯\fP
190.537 +.if \n(81<\n(38 .nr 81 \n(38
190.538 +.81
190.539 +.rm 81
190.540 +.nr 38 \n(a-
190.541 +.if \n(81<\n(38 .nr 81 \n(38
190.542 +.nr 38 \n(b-
190.543 +.if \n(81<\n(38 .nr 81 \n(38
190.544 +.nr 38 \n(c-
190.545 +.if \n(81<\n(38 .nr 81 \n(38
190.546 +.nr 38 \n(d-
190.547 +.if \n(81<\n(38 .nr 81 \n(38
190.548 +.nr 38 \n(e-
190.549 +.if \n(81<\n(38 .nr 81 \n(38
190.550 +.nr 38 \n(f-
190.551 +.if \n(81<\n(38 .nr 81 \n(38
190.552 +.nr 38 \n(h-
190.553 +.if \n(81<\n(38 .nr 81 \n(38
190.554 +.nr 38 \n(i-
190.555 +.if \n(81<\n(38 .nr 81 \n(38
190.556 +.nr 38 \n(j-
190.557 +.if \n(81<\n(38 .nr 81 \n(38
190.558 +.nr 38 \n(k-
190.559 +.if \n(81<\n(38 .nr 81 \n(38
190.560 +.nr 38 \n(l-
190.561 +.if \n(81<\n(38 .nr 81 \n(38
190.562 +.nr 38 \n(m-
190.563 +.if \n(81<\n(38 .nr 81 \n(38
190.564 +.nr 38 \n(o-
190.565 +.if \n(81<\n(38 .nr 81 \n(38
190.566 +.nr 38 \n(p-
190.567 +.if \n(81<\n(38 .nr 81 \n(38
190.568 +.nr 38 \n(q-
190.569 +.if \n(81<\n(38 .nr 81 \n(38
190.570 +.35
190.571 +.nf
190.572 +.ll \n(34u
190.573 +.nr 38 1n
190.574 +.nr 79 0
190.575 +.nr 40 \n(79+(0*\n(38)
190.576 +.nr 80 +\n(40
190.577 +.nr 41 \n(80+(3*\n(38)
190.578 +.nr 81 +\n(41
190.579 +.nr TW \n(81
190.580 +.if t .if \n(TW>\n(.li .tm Table at line 164 file Input is too wide - \n(TW units
190.581 +.fc
190.582 +.nr #T 0-1
190.583 +.nr #a 0-1
190.584 +.eo
190.585 +.de T#
190.586 +.ds #d .d
190.587 +.if \(ts\n(.z\(ts\(ts .ds #d nl
190.588 +.mk ##
190.589 +.nr ## -1v
190.590 +.ls 1
190.591 +.ls
190.592 +..
190.593 +.ec
190.594 +.ta \n(80u \n(81u
190.595 +.nr 31 \n(.f
190.596 +.nr 35 1m
190.597 +\&\h'|\n(40u'\f3激с\fP\h'|\n(41u'\f3茯\fP
190.598 +.ne \n(a|u+\n(.Vu
190.599 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
190.600 +.ta \n(80u \n(81u
190.601 +.nr 31 \n(.f
190.602 +.nr 35 1m
190.603 +\&\h'|\n(40u'\f3\-d <directory> \fP\h'|\n(41u'
190.604 +.mk ##
190.605 +.nr 31 \n(##
190.606 +.sp |\n(##u-1v
190.607 +.nr 37 \n(41u
190.608 +.in +\n(37u
190.609 +.a+
190.610 +.in -\n(37u
190.611 +.mk 32
190.612 +.if \n(32>\n(31 .nr 31 \n(32
190.613 +.sp |\n(31u
190.614 +.ne \n(b|u+\n(.Vu
190.615 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
190.616 +.ta \n(80u \n(81u
190.617 +.nr 31 \n(.f
190.618 +.nr 35 1m
190.619 +\&\h'|\n(40u'\f3\-b <path> \fP\h'|\n(41u'
190.620 +.mk ##
190.621 +.nr 31 \n(##
190.622 +.sp |\n(##u-1v
190.623 +.nr 37 \n(41u
190.624 +.in +\n(37u
190.625 +.b+
190.626 +.in -\n(37u
190.627 +.mk 32
190.628 +.if \n(32>\n(31 .nr 31 \n(32
190.629 +.sp |\n(31u
190.630 +.ne \n(c|u+\n(.Vu
190.631 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
190.632 +.ta \n(80u \n(81u
190.633 +.nr 31 \n(.f
190.634 +.nr 35 1m
190.635 +\&\h'|\n(40u'\f3\-B <jaxbOption>\fP\h'|\n(41u'
190.636 +.mk ##
190.637 +.nr 31 \n(##
190.638 +.sp |\n(##u-1v
190.639 +.nr 37 \n(41u
190.640 +.in +\n(37u
190.641 +.c+
190.642 +.in -\n(37u
190.643 +.mk 32
190.644 +.if \n(32>\n(31 .nr 31 \n(32
190.645 +.sp |\n(31u
190.646 +.ne \n(d|u+\n(.Vu
190.647 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
190.648 +.ta \n(80u \n(81u
190.649 +.nr 31 \n(.f
190.650 +.nr 35 1m
190.651 +\&\h'|\n(40u'\f3\-catalog\fP\h'|\n(41u'
190.652 +.mk ##
190.653 +.nr 31 \n(##
190.654 +.sp |\n(##u-1v
190.655 +.nr 37 \n(41u
190.656 +.in +\n(37u
190.657 +.d+
190.658 +.in -\n(37u
190.659 +.mk 32
190.660 +.if \n(32>\n(31 .nr 31 \n(32
190.661 +.sp |\n(31u
190.662 +.ne \n(e|u+\n(.Vu
190.663 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
190.664 +.ta \n(80u \n(81u
190.665 +.nr 31 \n(.f
190.666 +.nr 35 1m
190.667 +\&\h'|\n(40u'\f3\-extension \fP\h'|\n(41u'
190.668 +.mk ##
190.669 +.nr 31 \n(##
190.670 +.sp |\n(##u-1v
190.671 +.nr 37 \n(41u
190.672 +.in +\n(37u
190.673 +.e+
190.674 +.in -\n(37u
190.675 +.mk 32
190.676 +.if \n(32>\n(31 .nr 31 \n(32
190.677 +.sp |\n(31u
190.678 +.ne \n(f|u+\n(.Vu
190.679 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
190.680 +.ta \n(80u \n(81u
190.681 +.nr 31 \n(.f
190.682 +.nr 35 1m
190.683 +\&\h'|\n(40u'\f3\-help \fP\h'|\n(41u'
190.684 +.mk ##
190.685 +.nr 31 \n(##
190.686 +.sp |\n(##u-1v
190.687 +.nr 37 \n(41u
190.688 +.in +\n(37u
190.689 +.f+
190.690 +.in -\n(37u
190.691 +.mk 32
190.692 +.if \n(32>\n(31 .nr 31 \n(32
190.693 +.sp |\n(31u
190.694 +.ne \n(g|u+\n(.Vu
190.695 +.ne \n(h|u+\n(.Vu
190.696 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
190.697 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
190.698 +.ta \n(80u \n(81u
190.699 +.nr 31 \n(.f
190.700 +.nr 35 1m
190.701 +\&\h'|\n(40u'\h'|\n(41u'
190.702 +.mk ##
190.703 +.nr 31 \n(##
190.704 +.sp |\n(##u-1v
190.705 +.nr 37 \n(40u
190.706 +.in +\n(37u
190.707 +.g+
190.708 +.in -\n(37u
190.709 +.mk 32
190.710 +.if \n(32>\n(31 .nr 31 \n(32
190.711 +.sp |\n(##u-1v
190.712 +.nr 37 \n(41u
190.713 +.in +\n(37u
190.714 +.h+
190.715 +.in -\n(37u
190.716 +.mk 32
190.717 +.if \n(32>\n(31 .nr 31 \n(32
190.718 +.sp |\n(31u
190.719 +.ne \n(i|u+\n(.Vu
190.720 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
190.721 +.ta \n(80u \n(81u
190.722 +.nr 31 \n(.f
190.723 +.nr 35 1m
190.724 +\&\h'|\n(40u'\f3\-keep \fP\h'|\n(41u'
190.725 +.mk ##
190.726 +.nr 31 \n(##
190.727 +.sp |\n(##u-1v
190.728 +.nr 37 \n(41u
190.729 +.in +\n(37u
190.730 +.i+
190.731 +.in -\n(37u
190.732 +.mk 32
190.733 +.if \n(32>\n(31 .nr 31 \n(32
190.734 +.sp |\n(31u
190.735 +.ne \n(j|u+\n(.Vu
190.736 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
190.737 +.ta \n(80u \n(81u
190.738 +.nr 31 \n(.f
190.739 +.nr 35 1m
190.740 +\&\h'|\n(40u'\f3\-p \fP\h'|\n(41u'
190.741 +.mk ##
190.742 +.nr 31 \n(##
190.743 +.sp |\n(##u-1v
190.744 +.nr 37 \n(41u
190.745 +.in +\n(37u
190.746 +.j+
190.747 +.in -\n(37u
190.748 +.mk 32
190.749 +.if \n(32>\n(31 .nr 31 \n(32
190.750 +.sp |\n(31u
190.751 +.ne \n(k|u+\n(.Vu
190.752 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
190.753 +.ta \n(80u \n(81u
190.754 +.nr 31 \n(.f
190.755 +.nr 35 1m
190.756 +\&\h'|\n(40u'\f3\-s <directory> \fP\h'|\n(41u'
190.757 +.mk ##
190.758 +.nr 31 \n(##
190.759 +.sp |\n(##u-1v
190.760 +.nr 37 \n(41u
190.761 +.in +\n(37u
190.762 +.k+
190.763 +.in -\n(37u
190.764 +.mk 32
190.765 +.if \n(32>\n(31 .nr 31 \n(32
190.766 +.sp |\n(31u
190.767 +.ne \n(l|u+\n(.Vu
190.768 +.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
190.769 +.ta \n(80u \n(81u
190.770 +.nr 31 \n(.f
190.771 +.nr 35 1m
190.772 +\&\h'|\n(40u'\f3\-verbose \fP\h'|\n(41u'
190.773 +.mk ##
190.774 +.nr 31 \n(##
190.775 +.sp |\n(##u-1v
190.776 +.nr 37 \n(41u
190.777 +.in +\n(37u
190.778 +.l+
190.779 +.in -\n(37u
190.780 +.mk 32
190.781 +.if \n(32>\n(31 .nr 31 \n(32
190.782 +.sp |\n(31u
190.783 +.ne \n(m|u+\n(.Vu
190.784 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
190.785 +.ta \n(80u \n(81u
190.786 +.nr 31 \n(.f
190.787 +.nr 35 1m
190.788 +\&\h'|\n(40u'\f3\-version \fP\h'|\n(41u'
190.789 +.mk ##
190.790 +.nr 31 \n(##
190.791 +.sp |\n(##u-1v
190.792 +.nr 37 \n(41u
190.793 +.in +\n(37u
190.794 +.m+
190.795 +.in -\n(37u
190.796 +.mk 32
190.797 +.if \n(32>\n(31 .nr 31 \n(32
190.798 +.sp |\n(31u
190.799 +.ne \n(n|u+\n(.Vu
190.800 +.ne \n(o|u+\n(.Vu
190.801 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
190.802 +.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
190.803 +.ta \n(80u \n(81u
190.804 +.nr 31 \n(.f
190.805 +.nr 35 1m
190.806 +\&\h'|\n(40u'\h'|\n(41u'
190.807 +.mk ##
190.808 +.nr 31 \n(##
190.809 +.sp |\n(##u-1v
190.810 +.nr 37 \n(40u
190.811 +.in +\n(37u
190.812 +.n+
190.813 +.in -\n(37u
190.814 +.mk 32
190.815 +.if \n(32>\n(31 .nr 31 \n(32
190.816 +.sp |\n(##u-1v
190.817 +.nr 37 \n(41u
190.818 +.in +\n(37u
190.819 +.o+
190.820 +.in -\n(37u
190.821 +.mk 32
190.822 +.if \n(32>\n(31 .nr 31 \n(32
190.823 +.sp |\n(31u
190.824 +.ne \n(p|u+\n(.Vu
190.825 +.if (\n(p|+\n(#^-1v)>\n(#- .nr #- +(\n(p|+\n(#^-\n(#--1v)
190.826 +.ta \n(80u \n(81u
190.827 +.nr 31 \n(.f
190.828 +.nr 35 1m
190.829 +\&\h'|\n(40u'\f3\-target \fP\h'|\n(41u'
190.830 +.mk ##
190.831 +.nr 31 \n(##
190.832 +.sp |\n(##u-1v
190.833 +.nr 37 \n(41u
190.834 +.in +\n(37u
190.835 +.p+
190.836 +.in -\n(37u
190.837 +.mk 32
190.838 +.if \n(32>\n(31 .nr 31 \n(32
190.839 +.sp |\n(31u
190.840 +.ne \n(q|u+\n(.Vu
190.841 +.if (\n(q|+\n(#^-1v)>\n(#- .nr #- +(\n(q|+\n(#^-\n(#--1v)
190.842 +.ta \n(80u \n(81u
190.843 +.nr 31 \n(.f
190.844 +.nr 35 1m
190.845 +\&\h'|\n(40u'\f3\-quiet \fP\h'|\n(41u'
190.846 +.mk ##
190.847 +.nr 31 \n(##
190.848 +.sp |\n(##u-1v
190.849 +.nr 37 \n(41u
190.850 +.in +\n(37u
190.851 +.q+
190.852 +.in -\n(37u
190.853 +.mk 32
190.854 +.if \n(32>\n(31 .nr 31 \n(32
190.855 +.sp |\n(31u
190.856 +.fc
190.857 +.nr T. 1
190.858 +.T# 1
190.859 +.35
190.860 +.rm a+
190.861 +.rm b+
190.862 +.rm c+
190.863 +.rm d+
190.864 +.rm e+
190.865 +.rm f+
190.866 +.rm g+
190.867 +.rm h+
190.868 +.rm i+
190.869 +.rm j+
190.870 +.rm k+
190.871 +.rm l+
190.872 +.rm m+
190.873 +.rm n+
190.874 +.rm o+
190.875 +.rm p+
190.876 +.rm q+
190.877 .TE
190.878 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-54
190.879 -
190.880 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-72
190.881 .LP
190.882 +\f2\-b\fP 激с潟篏帥c茲違 JAX\-WS JAXB ゃ潟c潟違<ゃ絎с障 <ゃ篏帥c宴若後 Bean 障障鴻帥ゃ冴純с JAX\-WS JAXB ゃ潟c潟違<ゃ荅括完
190.883 +.na
190.884 +\f2鴻帥ゃ冴ャ≪\fP @
190.885 +.fi
190.886 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.htmlс
190.887 .LP
190.888 -\f2\-b\fP オプションを使って、複数の JAX-WS および JAXB バインディングファイルを指定できます。
190.889 -これらのファイルを使って、パッケージ名や Bean 名など、さまざまなカスタマイズが可能です。
190.890 -JAX-WS および JAXB バインディングファイルの詳細については、カスタマイズマニュアルを参照してください。
190.891 -.br
190.892 -
190.893 -.LP
190.894 -.SS
190.895 -Ant タスク
190.896 -.LP
190.897 -.LP
190.898 -\f2wsimport\fP ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
190.899 -.br
190.900 -
190.901 -.LP
190.902 +.SH "箴"
190.903 .nf
190.904 \f3
190.905 .fl
190.906 - <wsimport
190.907 +\fP\f3wsimport \-p stockquote http://stockquote.xyz/quote?wsdl\fP
190.908 .fl
190.909 - wsdl="..."
190.910 -.fl
190.911 - destdir="directory for generated class files"
190.912 -.fl
190.913 - sourcedestdir="directory for generated source files"
190.914 -.fl
190.915 - keep="true|false"
190.916 -.fl
190.917 - extension="true|false"
190.918 -.fl
190.919 - verbose="true|false"
190.920 -.fl
190.921 - version="true|false"
190.922 -.fl
190.923 - wsdlLocation="..."
190.924 -.fl
190.925 - catalog="catalog file"
190.926 -.fl
190.927 - package="package name"
190.928 -.fl
190.929 - <binding dir="..." includes="..." />
190.930 -.fl
190.931 - </wsimport>
190.932 -.fl
190.933 -\fP
190.934 .fi
190.935 -
190.936 .LP
190.937 -.LP
190.938 -.TS
190.939 -center;
190.940 -cbp-1 cbp-1 cbp-1
190.941 -li l l
190.942 -li l li.
190.943 -属性 説明 コマンド行
190.944 -_
190.945 -wsdl WSDL file WSDL
190.946 -destdir 生成される出力クラスを格納する場所を指定します -d
190.947 -sourcedestdir T{
190.948 -生成されたソースファイルの格納場所を指定します。このオプションの指定時には keep もオンになります。
190.949 -T} -s
190.950 -keep T{
190.951 -生成されたファイルを保持します。sourcedestdir オプション指定時にオンになります
190.952 -T} -keep
190.953 -verbose T{
190.954 -コンパイラが実行している処理に関するメッセージを出力します
190.955 -T} -verbose
190.956 -binding T{
190.957 -外部の JAX-WS または JAXB バインディングファイルを指定します
190.958 -T} -b
190.959 -extension T{
190.960 -ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
190.961 -T} -extension
190.962 -wsdllocation T{
190.963 -このオプション経由 で 渡 さ れたWSDL の URI は、生 成 された SEIおよびサービスインタフェース上の@WebService.wsdlLocationお よ び@WebServiceClient.wsdlLocation注釈要素の値を設定するために使用されます。
190.964 -T} -wsdllocation
190.965 -catalog T{
190.966 -外部エンティティ参照を解決するためのカタログファイルを指定します。TR9401、XCatalog、OASIS XML Catalog の各形式がサポートされています。さらに、Ant xmlcatalog タイプを使ってエンティティを解決することもできます。wsimport_catalog サンプルを参照してください。
190.967 -T} -catalog
190.968 -package ターゲットパッケージを指定します -p
190.969 -.TE
190.970 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
190.971 -
190.972 -.LP
190.973 -.LP
190.974 -\f2binding\fP 属性は、
190.975 -.na
190.976 -\f2Path\-like Structures\fP
190.977 -.fi
190.978 -(http://ant.apache.org/manual/using.html#path) であり、それぞれ入れ子になった \f2<binding>\fP 要素を使って設定することもできます。このタスクを使用するには、次の \f2<taskdef>\fP 要素をプロジェクトに追加しておく必要があります。
190.979 -.LP
190.980 -.nf
190.981 -\f3
190.982 -.fl
190.983 - <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">
190.984 -.fl
190.985 - <classpath path="jaxws.classpath"/>
190.986 -.fl
190.987 - </taskdef>
190.988 -.fl
190.989 -\fP
190.990 -.fi
190.991 -
190.992 -.LP
190.993 -.LP
190.994 -ここで、\f2jaxws.classpath\fP は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された
190.995 -.na
190.996 -\f2Path\-like Structure\fP
190.997 -.fi
190.998 -(http://ant.apache.org/manual/using.html#path) への参照です。
190.999 -.LP
190.1000 -.SH "例"
190.1001 -.LP
190.1002 -.nf
190.1003 -\f3
190.1004 -.fl
190.1005 - <wsimport
190.1006 -.fl
190.1007 - destdir="${build.classes.home}"
190.1008 -.fl
190.1009 - debug="true"
190.1010 -.fl
190.1011 - wsdl="AddNumbers.wsdl"
190.1012 -.fl
190.1013 - binding="custom.xml"/>
190.1014 -.fl
190.1015 -\fP
190.1016 -.fi
190.1017 -
190.1018 -.LP
190.1019 -.LP
190.1020 -上の例では、\f2AddNumbers.wsdl\fP のクライアント側アーティファクトを生成し、\f2custom.xml\fP カスタマイズファイルに基づいて \f2${build.classes.home}\fP ディレクトリ内に \f2.class\fP ファイルを格納しています。使用されるクラスパスは \f2xyz.jar\fP であり、デバッグ情報がオンの状態でコンパイルが実行されます。
190.1021 -.LP
190.1022 -.nf
190.1023 -\f3
190.1024 -.fl
190.1025 - <wsimport
190.1026 -.fl
190.1027 - keep="true"
190.1028 -.fl
190.1029 - sourcedestdir="${source.dir}"
190.1030 -.fl
190.1031 - destdir="${build.classes.home}"
190.1032 -.fl
190.1033 - wsdl="AddNumbers.wsdl">
190.1034 -.fl
190.1035 - <binding dir="${basedir}/etc" includes="custom.xml"/>
190.1036 -.fl
190.1037 - </wsimport>
190.1038 -.fl
190.1039 -\fP
190.1040 -.fi
190.1041 -
190.1042 -.LP
190.1043 -.LP
190.1044 -上の例では、\f2AddNumbers.wsdl\fP のポータブルアーティファクトを生成し、\f2${source.dir}\fP ディレクトリ内に \f2.java\fP ファイルを格納し、\f2${build.classes.home}\fP ディレクトリ内に \f2.class\fP ファイルを格納しています。
190.1045 -.LP
190.1046 -.SH "注意"
190.1047 -.LP
190.1048 -.LP
190.1049 -変更または削除された wsimport の Ant 属性の概要
190.1050 -.LP
190.1051 -\f3base\fP が \f3destdir\fP で置き換えられました
190.1052 +Java ≪若c<\f2http://stockquote.xyz/quote?wsdl\fP ゃ潟若с≪若c<潟潟ゃ障
190.1053 .br
190.1054 -
190.1055 -.LP
190.1056 -.br
190.1057 -
190.1058 -.LP
190.1059 -\f3sourceBase\fP が \f3sourcedestdir\fP で置き換えられました
190.1060 -.br
190.1061 -
190.1062 -.LP
190.1063 -.br
190.1064 -
190.1065 -.LP
190.1066 -\f3wsdlFile\fP が \f3wsdl\fP で置き換えられました
190.1067 -.br
190.1068 -.br
190.1069 -\f3httpProxy\fP が削除されました。代わりに、Ant の setproxy タスクを使ってプロキシ構成を行ってください。
190.1070 -.br
190.1071 -.br
190.1072 -\f3version\fP が削除されました
190.1073 -.br
190.1074 -
190.1075 -.LP
190.1076 -
190.1077 -.LP
190.1078
191.1 --- a/src/solaris/doc/sun/man/man1/ja/xjc.1 Tue May 12 15:21:55 2009 +0900
191.2 +++ b/src/solaris/doc/sun/man/man1/ja/xjc.1 Thu May 14 00:17:25 2009 -0700
191.3 @@ -1,4 +1,3 @@
191.4 -.'" t
191.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
191.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
191.7 ."
191.8 @@ -19,67 +18,43 @@
191.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
191.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
191.11 ." have any questions.
191.12 -." `
191.13 -.TH xjc 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
191.14 -." Generated by html2roff
191.15 +."
191.16 +.TH xjc 1 "04 May 2009"
191.17 +." Generated from HTML by html2man (author: Eric Armstrong)
191.18
191.19 .LP
191.20 .ad c
191.21 -.SH 名前
191.22 -XML バインドのための Java(TM) アーキテクチャ
191.23 +.SH ""
191.24 +xjc \- XML ゃ潟 Java(TM) ≪若c
191.25 .br
191.26 -バインドコンパイラ (xjc) \f3仕様のバージョン:\fP 2.0
191.27 +ゃ潟c潟違潟潟ゃ
191.28 +.LP
191.29 +\f3篁罕若吾с:\fP 2.1
191.30 .br
191.31 -\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
191.32 -.br
191.33 -JAXB 2.0: リリースノート | XJC | XJCTask | SchemaGen | schemagenTask | サンプルアプリケーション | Changelog
191.34 -.br
191.35 -JAXB 1.0.x: リリースノート | Changelog
191.36 -.br
191.37 -JAXB RI 拡張: 実行時プロパティ | XJC カスタマイズ | プラグイン開発
191.38 -.br
191.39 -JAXB RI スキーマ言語: W3C XML スキーマ | RELAX NG | DTD
191.40 -.br
191.41 -JAXB コミュニティ:
191.42 -.na
191.43 -\f2Java.net ホームページ\fP @
191.44 -.fi
191.45 -http://jaxb.dev.java.net | Developer interest list | FAQ
191.46 -.br
191.47 -.ad l
191.48 +\f3<潟劫茖 (RI) 若吾с:\fP 2.1.3 .ad l
191.49
191.50 .LP
191.51 -.SS
191.52 -xjc の起動
191.53 +.SH "xjc 莎桁"
191.54 .LP
191.55 .LP
191.56 -バインディングコンパイラを起動するには、使用するプラットフォームに応じた \f2bin\fP ディレクトリ内の \f2xjc\fP シェルスクリプトを使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。xjc を Ant とともに使用するための手順を参照してください。
191.57 +ゃ潟c潟違潟潟ゃ莎桁篏睡若綽 \f2bin\fP c \f2xjc\fP 激с鴻篏睡障障ゃ潟c潟違潟潟ゃ絎茵 Ant 帥鴻障
191.58 +.na
191.59 +\f2xjc Ant 篏睡\fP @
191.60 +.fi
191.61 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlс
191.62 .LP
191.63 .RS 3
191.64
191.65 .LP
191.66 -\f3Solaris/Linux の場合\fP
191.67 .LP
191.68 -
191.69 -.LP
191.70 -.LP
191.71 - \f2% /path/to/jaxb/bin/xjc.sh \-help\fP
191.72 -.LP
191.73 -\f3WindowsNT/2000/XP の場合\fP
191.74 -.LP
191.75 -
191.76 -.LP
191.77 -.LP
191.78 - \f2> c:\\path\\to\\jaxb\\bin\\xjc.bat \-help\fP
191.79 +\f2% xjc \-help\fP
191.80 .LP
191.81 .RE
191.82 +\f3阪\fP
191.83 +.LP
191.84 .RS 3
191.85
191.86 .LP
191.87 -\f3出力\fP
191.88 -.LP
191.89 -
191.90 -.LP
191.91 .nf
191.92 \f3
191.93 .fl
191.94 @@ -93,7 +68,9 @@
191.95 .fl
191.96 Compatibility Rules and App E.2 from the JAXB Spec
191.97 .fl
191.98 - \-b <file> : specify external bindings files (each <file> must have its own \-b)
191.99 + \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
191.100 +.fl
191.101 + If a directory is given, **/*.xjb is searched
191.102 .fl
191.103 \-d <dir> : generated files will go into this directory
191.104 .fl
191.105 @@ -113,6 +90,10 @@
191.106 .fl
191.107 \-npa : suppress generation of package level annotations (**/package\-info.java)
191.108 .fl
191.109 + \-no\-header : suppress generation of a file header with timestamp
191.110 +.fl
191.111 + \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
191.112 +.fl
191.113 \-xmlschema : treat input as W3C XML Schema (default)
191.114 .fl
191.115 \-relaxng : treat input as RELAX NG (experimental,unsupported)
191.116 @@ -133,49 +114,23 @@
191.117 .fl
191.118 \fP
191.119 .fi
191.120 +.RE
191.121
191.122 .LP
191.123 -.RE
191.124 -.RS 3
191.125 -
191.126 -.LP
191.127 -\f3jaxb\-xjc.jar JAR ファイルの実行\fP
191.128 +.SH "激с"
191.129 .LP
191.130
191.131 .LP
191.132 -.LP
191.133 -ほかの方法がすべて失敗した場合でも、\f2jaxb\-xjc.jar\fP ファイルの実行は行えるはずです。
191.134 -.LP
191.135 .RS 3
191.136 -
191.137 -.LP
191.138 -.TP 3
191.139 -Solaris/Linux の場合:
191.140 -\f2% java \-jar $JAXB_HOME/lib/jaxb\-xjc.jar \-help\fP
191.141 -.TP 3
191.142 -Windows の場合:
191.143 -\f2> java \-jar %JAXB_HOME%\\lib\\jaxb\-xjc.jar \-help\fP
191.144 -.LP
191.145 -.RE
191.146 -.LP
191.147 -これは「xjc.sh」や「xjc.bat」を実行するのと同じです。また、この場合、JVM パラメータを設定できます。
191.148 -.LP
191.149 -.RE
191.150 -.SS
191.151 -コマンド行オプションの概要
191.152 -.LP
191.153 -
191.154 -.LP
191.155 .TP 3
191.156 \-nv
191.157 -デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
191.158 +сXJC ゃ潟c潟違潟潟ゃ純若鴻鴻若ウ絲罎荐若絎茵障激с潟篏睡ウ絲鴻若罎荐若≦鴻障ゃ潟c潟違潟潟ゃ罎荐若筝絎茵с障 ウ絲с罎荐若絎茵с
191.159 .TP 3
191.160 \-extension
191.161 -デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
191.162 +сXJC ゃ潟c潟違潟潟ゃJAXB 篁罕Compatibility腴ц荀ウ絲綣桁吟障篁 E.2 JAXB v1.0 у泣若筝c W3C XML 鴻若罘純絎臂障 翫c鴻ゃф鴻\-extension≪若с罘純篏睡с障障ウ絲≪若с篁罕絎臂ゃ潟c潟違鴻帥ゃ冴帥篏睡с障\-extension鴻ゃ絎違JAXB Vendor Extension 篏睡с障
191.163 .TP 3
191.164 \-b <file>
191.165 -処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに\f2「\-b」\fPスイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる
191.166 -1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。
191.167 +紊ゃ潟c潟違<ゃ 1 ゃ障茲井絎障(ゃ潟c潟違<ゃ\f2\-b\fP鴻ゃ絎綽荀障)紊ゃ潟c潟違<ゃ罕絽吾荵с茲違鴻若鴻帥ゃ冴障 1 ゃゃ潟c潟違<ゃ篏睡鴻帥ゃ冴茲違ゃ潟c潟違<ゃ蚊с障 罨<箴腓冴障
191.168 .RS 3
191.169
191.170 .LP
191.171 @@ -183,142 +138,151 @@
191.172 .br
191.173 \f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
191.174 .RE
191.175 -また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
191.176 +障潟潟茵鴻若<ゃゃ潟c潟違<ゃ絎篁紙с
191.177 .TP 3
191.178 \-d <dir>
191.179 -デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
191.180 +сXJC ゃ潟c潟違潟潟ゃJava 潟潟潟鴻憜c障激с潟篏睡篁f水阪c絎с障阪c絖綽荀障 XJC ゃ潟c潟違潟潟ゃc篏障
191.181 .TP 3
191.182 \-p <pkg>
191.183 -このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
191.184 +潟潟茵激с括宴с帥若蚊宴若吾絎翫絎絎鴻宴若後絲障鴻ゃ潟c潟違鴻帥ゃ冴篁罕ц鎘宴若後≪眼冴障
191.185 .TP 3
191.186 \-httpproxy <proxy>
191.187 -HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
191.188 +HTTP/HTTPS 激絎障綵√ [user[:password]@]proxyHost[:proxyPort] с緇ャ \f2\-host\fP \f2\-port\fP 筝篏篋с<潟劫茖с泣若障ィ絅障激с潟ф絎鴻若\f2top\fP 潟潟篏睡若吟若祉若吟若茵腓冴с綣違с羈祉ャc若蕭罨< \f2\-httpproxyfile\fP 篏睡
191.189 .TP 3
191.190 \-httpproxyfile <file>
191.191 -HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
191.192 +HTTP/HTTPS 激<ゃ腟宴ф絎障綵√筝荐с<ゃ絎鴻若祉若吟若茵腓冴с障
191.193 .TP 3
191.194 \-classpath <arg>
191.195 -\f2<jxb:javaType>\fP および \f2<xjc:superClass>\fP カスタマイズが使用するクライアントアプリケーションのクラスファイルの検索場所を指定します。
191.196 +\f2<jxb:javaType>\fP \f2<xjc:superClass>\fP 鴻帥ゃ冴篏睡ゃ≪潟≪宴若激с潟鴻<ゃ罎膣√贋絎障
191.197 .TP 3
191.198 \-catalog <file>
191.199 -外部エンティティー参照を解決するカタログファイルを指定します。
191.200 -TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。
191.201 -詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、
191.202 -カタログリゾルバのサンプルアプリケーションを調べてください。
191.203 +紊潟cc弱с茹f浦帥違<ゃ絎障TR9401XCatalog OASIS XML Catalog 綵√泣若障荅括完XML Entity and URI Resolversャ<潟с\f2帥違障\fP泣潟≪宴若激с潟茯帥鴻
191.204 .TP 3
191.205 \-readOnly
191.206 -デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
191.207 +сXJC ゃ潟c潟違潟潟ゃ Java 純若鴻<ゃ吾莨若帥篆茘激障激с潟篏睡XJC ゃ潟c潟違潟潟ゃ Java 純若鴻綣桁句茯水絨障
191.208 .TP 3
191.209 \-npa
191.210 -パッケージレベルの注釈を
191.211 -.B **/package-info.java
191.212 -に生成することを抑制します。
191.213 -このスイッチを使用して生成するコードでは、これらの注釈が
191.214 -ほかの生成済みクラスに内部化されます。
191.215 +宴若吾羈 **/package\-info.java 吟障鴻ゃ篏睡潟若с羈祉羝帥鴻障
191.216 +.TP 3
191.217 +\-no\-header
191.218 +紊絨<≪帥ゃ鴻帥潟<ゃ若潟<潟吟障激с潟篏睡潟若障
191.219 +.TP 3
191.220 +\-target 2.0
191.221 + JAXB 2.1 罘純箴絖潟若障潟若 JAXB 2.0 潟帥ゃ (JavaSE 6 ) у茵с障
191.222 .TP 3
191.223 \-xmlschema
191.224 -入力スキーマを W3C XML スキーマ (デフォルト) と見なします。
191.225 -このスイッチを指定しなくても、入力スキーマは
191.226 -W3C XML スキーマと見なされます。
191.227 +ュ鴻若 W3C XML 鴻若 () 荀障鴻ゃ絎ュ鴻若 W3C XML 鴻若荀障
191.228 .TP 3
191.229 \-relaxng
191.230 -入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
191.231 +ュ鴻若 RELAX NG 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
191.232 .TP 3
191.233 \-relaxng\-compact
191.234 -入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
191.235 +ュ鴻若 RELAX NG х軒罕障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
191.236 .TP 3
191.237 \-dtd
191.238 -入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
191.239 +ュ鴻若 XML DTD 宴障 (荅薑泣若)RELAX NG 鴻若泣若 JAXB Vendor Extension 箴障
191.240 .TP 3
191.241 \-wsdl
191.242 -入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
191.243 +ュ WSDL 宴鴻若潟潟ゃ障 (荅薑泣若)
191.244 .TP 3
191.245 \-quiet
191.246 -進捗や警告など、コンパイラの出力を抑制します。
191.247 +我宴茘潟潟ゃ阪吟障
191.248 .TP 3
191.249 \-verbose
191.250 -情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
191.251 +宴<祉若吾阪劫主榊鴻帥若鴻茵腓冴罐泣激障
191.252 .TP 3
191.253 \-help
191.254 -コンパイラスイッチの概要を表示します。
191.255 +潟潟ゃ鴻ゃ网荀茵腓冴障
191.256 .TP 3
191.257 \-version
191.258 -コンパイラのバージョン情報を表示します。
191.259 +潟潟ゃ若吾с恰宴茵腓冴障
191.260 .TP 3
191.261 <schema file/URL/dir>
191.262 -コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
191.263 +潟潟ゃ絲乗院 1 ゃ障茲違鴻若<ゃ絎障若吟若c絎翫xjc c莎井祉цゃc鴻鴻若<ゃ潟潟ゃ障
191.264 +.RE
191.265 .SS
191.266 -非推奨コマンド行オプションおよび削除されたコマンド行オプションの概要
191.267 +ィ絅潟潟茵激с潟喝ゃ潟潟茵激с潟网荀
191.268 .LP
191.269 +.RS 3
191.270
191.271 .LP
191.272 +.RS 3
191.273 .TP 3
191.274 \-host & \-port
191.275 -これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
191.276 +激с潟ィ絅\f3\-httpproxy\fP 激с潟х舟障激с潟筝篏篋с腆坂у膓泣若障ャ<潟荐莠絨ャ若鴻уゃ醇с障
191.277 .TP 3
191.278 \-use\-runtime
191.279 -JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
191.280 +JAXB 2.0 篁罕хЩ罎с潟帥ゃ荀鎘JAXB RI **/impl/runtime 宴若吾綽荀障鴻ゃ筝荀ゃ障
191.281 .TP 3
191.282 \-source
191.283 -\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。我々は、JAXB 2.0 の今後のリリースからこのスイッチを削除することにしました。1.0.x コードを生成する必要がある場合には、1.0.x コードベースのインストールを使用してください。
191.284 +\-source 篋с鴻ゃJAXB 2.0 Early Access уャ障鴻ゃJAXB 2.0 篁緇若鴻ゃ障1.0.x 潟若綽荀翫1.0.x 潟若若鴻ゃ潟鴻若篏睡
191.285 .TP 3
191.286 \-Xlocator & \-Xsync\-methods
191.287 -これらのスイッチは現時点では無効化されています。この機能は将来、個別のダウンロードとして提供される予定です。
191.288 +鴻ゃ憝鴻с≦劫障罘純絨ャャ潟若箴篋絎с
191.289 +.RE
191.290 +
191.291 .LP
191.292 +.RE
191.293 .SS
191.294 -コンパイラの制限
191.295 +潟潟ゃ狗
191.296 .LP
191.297 .LP
191.298 -通常は、関連するスキーマは、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
191.299 +絽吾∫c鴻鴻若ゃ潟c潟違潟潟ゃ鴻ゃ絎 1 ゃ篏潟潟ゃc絎с
191.300 .LP
191.301 .LP
191.302 -.B xjc
191.303 -を実行するときは、次に示す制限に注意してください。
191.304 -これらの制限のほとんどは、
191.305 -.B xjc
191.306 -を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
191.307 +xjc 絎茵罨<腓冴狗羈狗祉xjc 篏綺若喝冴茲違鴻若潟潟ゃ翫翠障
191.308 .LP
191.309 .RS 3
191.310 .TP 2
191.311 -*
191.312 -複数のスキーマを同時にコンパイルする場合は、
191.313 -ターゲットの Java パッケージ名に次の優先順位の規則が
191.314 -適用されることに注意してください。
191.315 +o
191.316 +茲違鴻若潟潟ゃ翫帥若蚊 Java 宴若後罨<篏荀羈
191.317 .RS 3
191.318 .TP 3
191.319 1.
191.320 -「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
191.321 +\f2\-p\fP潟潟茵激с潟c障
191.322 .TP 3
191.323 2.
191.324 -<\f2jaxb:package\fP> のカスタマイズ
191.325 +<\f2jaxb:package\fP> 鴻帥ゃ
191.326 .TP 3
191.327 3.
191.328 -\f2targetNamespace\fP が宣言されている場合は、仕様に定義されている \f2targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
191.329 +\f2targetNamespace\fP 絎h翫篁罕絎臂 \f2targetNamespace\fP \-> Java 宴若後≪眼冴障
191.330 .TP 3
191.331 4.
191.332 -\f2targetNamespace\fP が宣言されていない場合は、"generated" という名前のハードコードされたパッケージを使用します。
191.333 +\f2targetNamespace\fP 絎h翫"generated" 若潟若宴若吾篏睡障
191.334 .RE
191.335 .TP 2
191.336 -*
191.337 -名前空間ごとに複数の
191.338 -.B <jaxb:schemaBindings>
191.339 -を持つことは不正です。このため、1 つのターゲット名前空間内の
191.340 -2 つのスキーマを、異なる Java パッケージにコンパイルすることはできません。
191.341 +o
191.342 +腥咲茲違 <\f2jaxb:schemaBindings\fP> ゃ筝罩cс 1 ゃ帥若蚊腥咲 2 ゃ鴻若違 Java 宴若吾潟潟ゃс障
191.343 .TP 2
191.344 -*
191.345 -1 つの Java パッケージにコンパイルされるすべてのスキーマは、
191.346 -XJC バインディングコンパイラに同時に送信する必要があります。
191.347 -個別にコンパイルすることはできず、 予期したとおりに動作しません。
191.348 +o
191.349 +1 ゃ Java 宴若吾潟潟ゃ鴻鴻若XJC ゃ潟c潟違潟潟ゃ篆<綽荀障 ャ潟潟ゃс篋篏障
191.350 .TP 2
191.351 -*
191.352 -複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
191.353 +o
191.354 +茲違鴻若<ゃ障荀膣臀違若潟潟ゃ綽荀障
191.355 .RE
191.356
191.357 .LP
191.358 +.SH "∫i"
191.359 +.LP
191.360 +.RS 3
191.361 +.TP 2
191.362 +o
191.363 +潟潟茵с潟潟若帥絎茵 (XJC):[
191.364 +.na
191.365 +\f2潟潟茵巡擦\fP @
191.366 +.fi
191.367 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html
191.368 +.na
191.369 +\f2xjc Ant 篏睡\fP @
191.370 +.fi
191.371 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
191.372 +.TP 2
191.373 +o
191.374 +.na
191.375 +\f2XML ゃ潟 JavaTM ≪若c (JAXB)\fP @
191.376 +.fi
191.377 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
191.378 +.RE
191.379
191.380 .LP
191.381 -$Revision: 1.4 $
191.382 -.br
191.383 -$Date: 2005/10/27 18:53:02 $
191.384 -.LP
191.385
192.1 --- a/src/solaris/doc/sun/man/man1/jar.1 Tue May 12 15:21:55 2009 +0900
192.2 +++ b/src/solaris/doc/sun/man/man1/jar.1 Thu May 14 00:17:25 2009 -0700
192.3 @@ -1,5 +1,4 @@
192.4 -.'" t
192.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
192.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
192.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
192.8 ."
192.9 ." This code is free software; you can redistribute it and/or modify it
192.10 @@ -19,15 +18,12 @@
192.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
192.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
192.13 ." have any questions.
192.14 -." `
192.15 -.TH jar 1 "05 Aug 2006"
192.16 -." Generated by html2roff
192.17 -.\\" Created by: Susan Keohan 30\-Oct\-1996
192.18 -.\\" Updated by: Beth Stearns 18\-Nov\-1996
192.19 -.\\" Updated by: Marianne Mueller 11\-Dec\-1996
192.20 -.\\" Updated by: Douglas Kramer 01\-Jul\-2003
192.21 +."
192.22 +.TH jar 1 "04 May 2009"
192.23 +." Generated from HTML by html2man (author: Eric Armstrong)
192.24 +
192.25 .LP
192.26 -.SH NAME
192.27 +.SH "Name"
192.28 jar\-The Java Archive Tool
192.29 .LP
192.30 \f3jar\fP combines multiple files into a single JAR archive file.
192.31 @@ -35,6 +31,7 @@
192.32 .LP
192.33
192.34 .LP
192.35 +.RS 3
192.36 .TP 3
192.37 Create jar file
192.38 \f4jar c\fP\f2[v0Mmfe] [\fP\f2manifest\fP\f2] [\fP\f2jarfile\fP\f2] [\fP\f2entrypoint\fP\f2] [\-C\fP \f2dir\fP\f2]\fP \f2inputfiles\fP \f2[\-J\fP\f2option\fP\f2]\fP
192.39 @@ -50,6 +47,8 @@
192.40 .TP 3
192.41 Add index to jar file
192.42 \f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
192.43 +.RE
192.44 +
192.45 .LP
192.46 .LP
192.47 where:
192.48 @@ -57,21 +56,20 @@
192.49 .RS 3
192.50
192.51 .LP
192.52 +.RS 3
192.53 .TP 3
192.54 cuxtiv0Mmfe
192.55 Options that control the \f2jar\fP command.
192.56 .TP 3
192.57 - jarfile
192.58 +jarfile
192.59 Jar file to be created (\f2c\fP), updated (\f2u\fP), extracted (\f2x\fP), or have its table of contents viewed (\f2t\fP). The \f2\-f\fP option and filename \f2jarfile\fP are a pair \-\- if either is present, they must both appear. Note that omitting \f2f\fP and \f2jarfile\fP accepts a "jar file" from standard input (for x and t) or sends the "jar file" to standard output (for c and u).
192.60 .TP 3
192.61 -
192.62 inputfiles
192.63 Files or directories, separated by spaces, to be combined into \f2jarfile\fP (for c and u), or to be extracted (for x) or listed (for t) from \f2jarfile\fP. All directories are processed recursively. The files are compressed unless option \f20\fP (zero) is used.
192.64 .TP 3
192.65 - manifest
192.66 +manifest
192.67 Pre\-existing manifest file whose \f2name\fP\f2:\fP \f2value\fP pairs are to be included in MANIFEST.MF in the jar file. The \f2\-m\fP option and filename \f2manifest\fP are a pair \-\- if either is present, they must both appear. The letters \f3m\fP, \f3f\fP and \f3e\fP must appear in the same order that \f2manifest\fP, \f2jarfile\fP, \f2entrypoint\fP appear.
192.68 .TP 3
192.69 -
192.70 entrypoint
192.71 The name of the class that set as the application entry point for stand\-alone applications bundled into executable jar file. The \f2\-e\fP option and entrypoint are a pair \-\- if either is present, they must both appear. The letters \f3m\fP, \f3f\fP and \f3e\fP must appear in the same order that \f2manifest\fP, \f2jarfile\fP, \f2entrypoint\fP appear.
192.72 .TP 3
192.73 @@ -80,6 +78,8 @@
192.74 .TP 3
192.75 \-Joption
192.76 Option to be passed into the Java runtime environment. (There must be no space between \f2\-J\fP and \f2option\fP).
192.77 +.RE
192.78 +
192.79 .LP
192.80 .RE
192.81 .SH "DESCRIPTION"
192.82 @@ -90,11 +90,7 @@
192.83 .na
192.84 \f2ZLIB\fP @
192.85 .fi
192.86 -http://www.gzip.org/zlib/ compression format. However, \f3jar\fP was designed mainly package java applets or applications into a single archive. When the components of an applet or application (files, images and sounds) are combined into a single archive, they can be downloaded by a java agent (like a browser) in a single HTTP transaction, rather than requiring a new connection for each piece. This dramatically improves download times. \f3jar\fP also compresses files and so further improves download time. In addition, it allows individual entries in a file to be signed by the applet author so that their origin can be authenticated. The syntax for the jar tool is almost identical to the syntax for the \f2tar\fP command. A \f3jar\fP archive can be used as a
192.87 -.na
192.88 -\f2class path\fP @
192.89 -.fi
192.90 -http://ccc.sfbay/4291383/attachment/classpath.html entry, whether or not it is compressed.
192.91 +http://www.gzip.org/zlib/ compression format. However, \f3jar\fP was designed mainly package java applets or applications into a single archive. When the components of an applet or application (files, images and sounds) are combined into a single archive, they can be downloaded by a java agent (like a browser) in a single HTTP transaction, rather than requiring a new connection for each piece. This dramatically improves download times. \f3jar\fP also compresses files and so further improves download time. In addition, it allows individual entries in a file to be signed by the applet author so that their origin can be authenticated. The syntax for the jar tool is almost identical to the syntax for the \f2tar\fP command. A \f3jar\fP archive can be used as a class path entry, whether or not it is compressed.
192.92 .LP
192.93 Typical usage to combine files into a jar file is:
192.94 .LP
192.95 @@ -115,7 +111,7 @@
192.96 .na
192.97 \f2JAR file specification\fP @
192.98 .fi
192.99 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Manifest for details explaining how the jar tool stores meta\-information in the manifest file.
192.100 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Manifest for details explaining how the jar tool stores meta\-information in the manifest file.
192.101 .LP
192.102 If a jar file should include \f2name\ :\ value\fP pairs contained in an existing manifest file, specify that file using the \f2\-m\fP option:
192.103 .LP
192.104 @@ -191,7 +187,7 @@
192.105 .na
192.106 \f2JarIndex\fP @
192.107 .fi
192.108 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Index, which allows application class loaders to load classes more efficiently from jar files. If an application or applet is bundled into multiple jar files,\ only the necessary jar files will be downloaded and opened to load classes. This performance optimization is enabled by running \f2jar\fP with the \f2\-i\fPoption. It will generate package location information for the specified main jar file and all the jar files it depends on, which need to be specified in the \f2Class\-Path\fP attribute of the main jar file's manifest.
192.109 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index, which allows application class loaders to load classes more efficiently from jar files. If an application or applet is bundled into multiple jar files,\ only the necessary jar files will be downloaded and opened to load classes. This performance optimization is enabled by running \f2jar\fP with the \f2\-i\fPoption. It will generate package location information for the specified main jar file and all the jar files it depends on, which need to be specified in the \f2Class\-Path\fP attribute of the main jar file's manifest.
192.110 .LP
192.111 .RS 3
192.112
192.113 @@ -239,6 +235,7 @@
192.114 .LP
192.115
192.116 .LP
192.117 +.RS 3
192.118 .TP 3
192.119 c
192.120 Creates a new archive file named \f2jarfile\fP (if \f2f\fP is specified) or to standard output (if \f2f\fP and \f2jarfile\fP are omitted). Add to it the files and directories specified by \f2inputfiles\fP.
192.121 @@ -324,6 +321,7 @@
192.122 \f2JAR Files\fP @
192.123 .fi
192.124 http://java.sun.com/docs/books/tutorial/jar/ trail in the Java Tutorial for examples of using the \f4\-m\fP option.
192.125 +.LP
192.126 .TP 3
192.127 e
192.128 Sets \f2entrypoint\fP as the application entry point for stand\-alone applications bundled into executable jar file. The use of this option creates or overrides the \f2Main\-Class\fP attribute value in the manifest file. This option can be used during creation of jar file or while updating the jar file. This option specifies the application entry point without editing or creating the manifest file.
192.129 @@ -432,11 +430,9 @@
192.130 .LP
192.131 .TP 3
192.132 \-Joption
192.133 -Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of the options described on the reference page for the
192.134 -.na
192.135 -\f2java application launcher\fP @
192.136 -.fi
192.137 -http://ccc.sfbay/4291383/attachment/java.html#options. For example, \f4\-J\-Xmx48M\fP sets the maximum memory to 48 megabytes. It is a common convention for \f2\-J\fP to pass options to the underlying runtime environment.
192.138 +Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f4\-J\-Xmx48M\fP sets the maximum memory to 48 megabytes. It is a common convention for \f2\-J\fP to pass options to the underlying runtime environment.
192.139 +.RE
192.140 +
192.141 .LP
192.142 .SH "COMMAND LINE ARGUMENT FILES"
192.143 .LP
192.144 @@ -444,7 +440,7 @@
192.145 .LP
192.146 To shorten or simplify the jar command line, you can specify one or more files that themselves contain arguments to the \f2jar\fP command (except \f2\-J\fP options). This enables you to create jar commands of any length, overcoming command line limits imposed by the operating system.
192.147 .LP
192.148 -An argument file can include options and filenames. The arguments within a file can be space–separated or newline\-separated. Filenames within an argument file are relative to the current directory, not relative to the location of the argument file. Wildcards (*) that might otherwise be expanded by the operating system shell are not expanded. Use of the \f2@\fP character to recursively interpret files is not supported. The \f2\-J\fP options are not supported because they are passed to the launcher, which does not support argument files.
192.149 +An argument file can include options and filenames. The arguments within a file can be space\-separated or newline\-separated. Filenames within an argument file are relative to the current directory, not relative to the location of the argument file. Wildcards (*) that might otherwise be expanded by the operating system shell are not expanded. Use of the \f2@\fP character to recursively interpret files is not supported. The \f2\-J\fP options are not supported because they are passed to the launcher, which does not support argument files.
192.150 .LP
192.151 .LP
192.152 When executing \f2jar\fP, pass in the path and name of each argument file with the \f2@\fP leading character. When \f2jar\fP encounters an argument beginning with the character \f2@\fP, it expands the contents of that file into the argument list.
192.153 @@ -674,21 +670,21 @@
192.154 .na
192.155 \f2The Jar Overview\fP @
192.156 .fi
192.157 -http://ccc.sfbay/guide/jar/jarGuide.html
192.158 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
192.159 .br
192.160
192.161 .LP
192.162 .na
192.163 \f2The Jar File Specification\fP @
192.164 .fi
192.165 -http://ccc.sfbay/guide/jar/jar.html
192.166 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
192.167 .br
192.168
192.169 .LP
192.170 .na
192.171 \f2The JarIndex Spec\fP @
192.172 .fi
192.173 -http://ccc.sfbay/guide/jar/jar.html#JAR%20Index
192.174 +http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
192.175 .br
192.176
192.177 .LP
192.178 @@ -699,9 +695,6 @@
192.179 .br
192.180
192.181 .LP
192.182 -.na
192.183 -\f2pack200 Reference Page\fP @
192.184 -.fi
192.185 -http://ccc.sfbay/4291383/share/pack200.html
192.186 +pack200(1)
192.187 .LP
192.188
193.1 --- a/src/solaris/doc/sun/man/man1/jarsigner.1 Tue May 12 15:21:55 2009 +0900
193.2 +++ b/src/solaris/doc/sun/man/man1/jarsigner.1 Thu May 14 00:17:25 2009 -0700
193.3 @@ -1,5 +1,4 @@
193.4 -.'" t
193.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
193.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
193.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
193.8 ."
193.9 ." This code is free software; you can redistribute it and/or modify it
193.10 @@ -19,12 +18,12 @@
193.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
193.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
193.13 ." have any questions.
193.14 -." `
193.15 -.TH jarsigner 1 "07 Aug 2006"
193.16 -." Generated by html2man
193.17 +."
193.18 +.TH jarsigner 1 "04 May 2009"
193.19 +." Generated from HTML by html2man (author: Eric Armstrong)
193.20
193.21 .LP
193.22 -.SH NAME
193.23 +.SH "Name"
193.24 jarsigner \- JAR Signing and Verification Tool
193.25 .LP
193.26 .RS 3
193.27 @@ -43,11 +42,14 @@
193.28 .fl
193.29 \fP\f3jarsigner\fP [ options ] jar\-file alias
193.30 .fl
193.31 -\f3jarsigner\fP \-verify [ options ] jar\-file
193.32 +\f3jarsigner\fP \-verify [ options ] jar\-file [alias...]
193.33 .fl
193.34 .fi
193.35
193.36 .LP
193.37 +.LP
193.38 +The jarsigner \-verify command can take zero or more keystore alias names after the jar filename. When specified, jarsigner will check that the certificate used to verify each signed entry in the jar file matches one of the keystore aliases. The aliases are defined in the keystore specified by \-keystore, or the default keystore.
193.39 +.LP
193.40 .SH "DESCRIPTION"
193.41 .LP
193.42
193.43 @@ -66,7 +68,7 @@
193.44
193.45 .LP
193.46 .LP
193.47 -The JAR feature enables the packaging of class files, images, sounds, and other digital data in a single file for faster and easier distribution. A tool named \f3jar\fP enables developers to produce JAR files. (Technically, any zip file can also be considered a JAR file, although when created by \f3jar\fP or processed by \f3jarsigner\fP, JAR files also contain a META\-INF/MANIFEST.MF file.)
193.48 +The JAR feature enables the packaging of class files, images, sounds, and other digital data in a single file for faster and easier distribution. A tool named jar(1) enables developers to produce JAR files. (Technically, any zip file can also be considered a JAR file, although when created by \f3jar\fP or processed by \f3jarsigner\fP, JAR files also contain a META\-INF/MANIFEST.MF file.)
193.49 .LP
193.50 .LP
193.51 A \f2digital signature\fP is a string of bits that is computed from some data (the data being "signed") and the private key of an entity (a person, company, etc.). Like a handwritten signature, a digital signature has many useful characteristics:
193.52 @@ -91,21 +93,969 @@
193.53 In order for an entity's signature to be generated for a file, the entity must first have a public/private key pair associated with it, and also one or more certificates authenticating its public key. A \f2certificate\fP is a digitally signed statement from one entity, saying that the public key of some other entity has a particular value.
193.54 .LP
193.55 .LP
193.56 -\f3jarsigner\fP uses key and certificate information from a \f2keystore\fP to generate digital signatures for JAR files. A keystore is a database of private keys and their associated X.509 certificate chains authenticating the corresponding public keys. The \f3keytool\fP utility is used to create and administer keystores.
193.57 +\f3jarsigner\fP uses key and certificate information from a \f2keystore\fP to generate digital signatures for JAR files. A keystore is a database of private keys and their associated X.509 certificate chains authenticating the corresponding public keys. The keytool(1) utility is used to create and administer keystores.
193.58 .LP
193.59 .LP
193.60 \f3jarsigner\fP uses an entity's private key to generate a signature. The signed JAR file contains, among other things, a copy of the certificate from the keystore for the public key corresponding to the private key used to sign the file. \f3jarsigner\fP can verify the digital signature of the signed JAR file using the certificate inside it (in its signature block file).
193.61 .LP
193.62 .LP
193.63 -Starting in J2SE 5.0, \f3jarsigner\fP can generate signatures that include a timestamp, thus enabling systems/deployer (including Java Plug\-in) to check whether the JAR file was signed while the signing certificate was still valid. In addition, APIs were added in J2SE 5.0 to allow applications to obtain the timestamp information.
193.64 +\f3jarsigner\fP can generate signatures that include a timestamp, thus enabling systems/deployer (including Java Plug\-in) to check whether the JAR file was signed while the signing certificate was still valid. In addition, APIs will allow applications to obtain the timestamp information.
193.65 .LP
193.66 .LP
193.67 -At this time, \f3jarsigner\fP can only sign JAR files created by the SDK \f3jar\fP tool or zip files. (JAR files are the same as zip files, except they also have a META\-INF/MANIFEST.MF file. Such a file will automatically be created when \f3jarsigner\fP signs a zip file.)
193.68 +At this time, \f3jarsigner\fP can only sign JAR files created by the SDK jar(1) tool or zip files. (JAR files are the same as zip files, except they also have a META\-INF/MANIFEST.MF file. Such a file will automatically be created when \f3jarsigner\fP signs a zip file.)
193.69 .LP
193.70 .LP
193.71 The default \f3jarsigner\fP behavior is to \f2sign\fP a JAR (or zip) file. Use the \f2\-verify\fP option to instead have it \f2verify\fP a signed JAR file.
193.72 .LP
193.73 .SS
193.74 +Keystore Aliases
193.75 +.LP
193.76 +.RS 3
193.77 +
193.78 +.LP
193.79 +.LP
193.80 +All keystore entities are accessed via unique \f2aliases\fP.
193.81 +.LP
193.82 +.LP
193.83 +When using \f3jarsigner\fP to sign a JAR file, you must specify the alias for the keystore entry containing the private key needed to generate the signature. For example, the following will sign the JAR file named "MyJARFile.jar", using the private key associated with the alias "duke" in the keystore named "mystore" in the "working" directory. Since no output file is specified, it overwrites MyJARFile.jar with the signed JAR file.
193.84 +.LP
193.85 +.nf
193.86 +\f3
193.87 +.fl
193.88 + jarsigner \-keystore /working/mystore \-storepass myspass
193.89 +.fl
193.90 + \-keypass dukekeypasswd MyJARFile.jar duke
193.91 +.fl
193.92 +\fP
193.93 +.fi
193.94 +
193.95 +.LP
193.96 +.LP
193.97 +Keystores are protected with a password, so the store password (in this case "myspass") must be specified. You will be prompted for it if you don't specify it on the command line. Similarly, private keys are protected in a keystore with a password, so the private key's password (in this case "dukekeypasswd") must be specified, and you will be prompted for it if you don't specify it on the command line and it isn't the same as the store password.
193.98 +.LP
193.99 +.RE
193.100 +.SS
193.101 +Keystore Location
193.102 +.LP
193.103 +.RS 3
193.104 +
193.105 +.LP
193.106 +.LP
193.107 +\f3jarsigner\fP has a \f2\-keystore\fP option for specifying the URL of the keystore to be used. The keystore is by default stored in a file named \f2.keystore\fP in the user's home directory, as determined by the \f2user.home\fP system property. On Solaris systems \f2user.home\fP defaults to the user's home directory.
193.108 +.LP
193.109 +.LP
193.110 +Note that the input stream from the \f2\-keystore\fP option is passed to the \f2KeyStore.load\fP method. If \f2NONE\fP is specified as the URL, then a null stream is passed to the \f2KeyStore.load\fP method. \f2NONE\fP should be specified if the \f2KeyStore\fP is not file\-based, for example, if it resides on a hardware token device.
193.111 +.LP
193.112 +.RE
193.113 +.SS
193.114 +Keystore Implementation
193.115 +.LP
193.116 +.RS 3
193.117 +
193.118 +.LP
193.119 +.LP
193.120 +The \f2KeyStore\fP class provided in the \f2java.security\fP package supplies well\-defined interfaces to access and modify the information in a keystore. It is possible for there to be multiple different concrete implementations, where each implementation is that for a particular \f2type\fP of keystore.
193.121 +.LP
193.122 +.LP
193.123 +Currently, there are two command\-line tools that make use of keystore implementations (\f3keytool\fP and \f3jarsigner\fP), and also a GUI\-based tool named \f3Policy Tool\fP. Since \f2KeyStore\fP is publicly available, Java 2 SDK users can write additional security applications that use it.
193.124 +.LP
193.125 +.LP
193.126 +There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
193.127 +.LP
193.128 +.LP
193.129 +Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a provider and supply a KeystoreSpi subclass implementation, as described in
193.130 +.na
193.131 +\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
193.132 +.fi
193.133 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html.
193.134 +.LP
193.135 +.LP
193.136 +Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
193.137 +.LP
193.138 +.LP
193.139 +\f3keytool\fP works on any file\-based keystore implementation. (It treats the keytore location that is passed to it at the command line as a filename and converts it to a FileInputStream, from which it loads the keystore information.) The \f3jarsigner\fP and \f3policytool\fP tools, on the other hand, can read a keystore from any location that can be specified using a URL.
193.140 +.LP
193.141 +.LP
193.142 +For \f3jarsigner\fP and \f3keytool\fP, you can specify a keystore type at the command line, via the \f2\-storetype\fP option. For \f3Policy Tool\fP, you can specify a keystore type via the "Change Keystore" command in the Edit menu.
193.143 +.LP
193.144 +.LP
193.145 +If you don't explicitly specify a keystore type, the tools choose a keystore implementation based simply on the value of the \f2keystore.type\fP property specified in the security properties file. The security properties file is called \f2java.security\fP, and it resides in the SDK security properties directory, \f2java.home\fP/lib/security, where \f2java.home\fP is the runtime environment's directory (the \f2jre\fP directory in the SDK or the top\-level directory of the Java 2 Runtime Environment).
193.146 +.LP
193.147 +.LP
193.148 +Each tool gets the \f2keystore.type\fP value and then examines all the currently\-installed providers until it finds one that implements keystores of that type. It then uses the keystore implementation from that provider.
193.149 +.LP
193.150 +.LP
193.151 +The \f2KeyStore\fP class defines a static method named \f2getDefaultType\fP that lets applications and applets retrieve the value of the \f2keystore.type\fP property. The following line of code creates an instance of the default keystore type (as specified in the \f2keystore.type\fP property):
193.152 +.LP
193.153 +.nf
193.154 +\f3
193.155 +.fl
193.156 + KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
193.157 +.fl
193.158 +\fP
193.159 +.fi
193.160 +
193.161 +.LP
193.162 +.LP
193.163 +The default keystore type is "jks" (the proprietary type of the keystore implementation provided by Sun). This is specified by the following line in the security properties file:
193.164 +.LP
193.165 +.nf
193.166 +\f3
193.167 +.fl
193.168 + keystore.type=jks
193.169 +.fl
193.170 +\fP
193.171 +.fi
193.172 +
193.173 +.LP
193.174 +.LP
193.175 +Note: Case doesn't matter in keystore type designations. For example, "JKS" would be considered the same as "jks".
193.176 +.LP
193.177 +.LP
193.178 +To have the tools utilize a keystore implementation other than the default, change that line to specify a different keystore type. For example, if you have a provider package that supplies a keystore implementation for a keystore type called "pkcs12", change the line to
193.179 +.LP
193.180 +.nf
193.181 +\f3
193.182 +.fl
193.183 + keystore.type=pkcs12
193.184 +.fl
193.185 +\fP
193.186 +.fi
193.187 +
193.188 +.LP
193.189 +.LP
193.190 +Note that if you us the PKCS#11 provider package, you should refer to the
193.191 +.na
193.192 +\f2KeyTool and JarSigner\fP @
193.193 +.fi
193.194 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner section of the Java PKCS#11 Reference Guide for details.
193.195 +.LP
193.196 +.RE
193.197 +.SS
193.198 +Supported Algorithms
193.199 +.LP
193.200 +.RS 3
193.201 +
193.202 +.LP
193.203 +.LP
193.204 +By default, \f3jarsigner\fP signs a JAR file using either
193.205 +.LP
193.206 +.RS 3
193.207 +.TP 2
193.208 +o
193.209 +DSA (Digital Signature Algorithm) with the SHA\-1 digest algorithm, or
193.210 +.TP 2
193.211 +o
193.212 +the RSA algorithm with the SHA\-1 digest algorithm.
193.213 +.RE
193.214 +
193.215 +.LP
193.216 +.LP
193.217 +That is, if the signer's public and private keys are DSA keys, \f3jarsigner\fP will sign the JAR file using the "SHA1withDSA" algorithm. If the signer's keys are RSA keys, \f3jarsigner\fP will attempt to sign the JAR file using the "SHA1withRSA" algorithm.
193.218 +.LP
193.219 +.LP
193.220 +These default signature algorithms can be overridden using the \f2\-sigalg\fP option.
193.221 +.LP
193.222 +.RE
193.223 +.SS
193.224 +The Signed JAR File
193.225 +.LP
193.226 +.RS 3
193.227 +
193.228 +.LP
193.229 +.LP
193.230 +When \f3jarsigner\fP is used to sign a JAR file, the output signed JAR file is exactly the same as the input JAR file, except that it has two additional files placed in the META\-INF directory:
193.231 +.LP
193.232 +.RS 3
193.233 +.TP 2
193.234 +o
193.235 +a signature file, with a .SF extension, and
193.236 +.TP 2
193.237 +o
193.238 +a signature block file, with a .DSA extension.
193.239 +.RE
193.240 +
193.241 +.LP
193.242 +.LP
193.243 +The base file names for these two files come from the value of the \f2\-sigFile\fP option. For example, if the option appears as
193.244 +.LP
193.245 +.nf
193.246 +\f3
193.247 +.fl
193.248 + \-sigFile MKSIGN
193.249 +.fl
193.250 +\fP
193.251 +.fi
193.252 +
193.253 +.LP
193.254 +.LP
193.255 +the files are named "MKSIGN.SF" and "MKSIGN.DSA".
193.256 +.LP
193.257 +.LP
193.258 +If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not allowed in a signature file name, each such character is converted to an underscore ("_") character in forming the file name. Legal characters include letters, digits, underscores, and hyphens.
193.259 +.LP
193.260 +\f3The Signature (.SF) File\fP
193.261 +.LP
193.262 +.RS 3
193.263 +
193.264 +.LP
193.265 +.LP
193.266 +A signature file (the .SF file) looks similar to the manifest file that is always included in a JAR file when \f3jarsigner\fP is used to sign the file. That is, for each source file included in the JAR file, the .SF file has three lines, just as in the manifest file, listing the following:
193.267 +.LP
193.268 +.RS 3
193.269 +.TP 2
193.270 +o
193.271 +the file name,
193.272 +.TP 2
193.273 +o
193.274 +the name of the digest algorithm used (SHA), and
193.275 +.TP 2
193.276 +o
193.277 +a SHA digest value.
193.278 +.RE
193.279 +
193.280 +.LP
193.281 +.LP
193.282 +In the manifest file, the SHA digest value for each source file is the digest (hash) of the binary data in the source file. In the .SF file, on the other hand, the digest value for a given source file is the hash of the three lines in the manifest file for the source file.
193.283 +.LP
193.284 +.LP
193.285 +The signature file also, by default, includes a header containing a hash of the whole manifest file. The presence of the header enables verification optimization, as described in JAR File Verification.
193.286 +.LP
193.287 +.RE
193.288 +\f3The Signature Block (.DSA) File\fP
193.289 +.LP
193.290 +.RS 3
193.291 +
193.292 +.LP
193.293 +.LP
193.294 +The .SF file is signed and the signature is placed in the .DSA file. The .DSA file also contains, encoded inside it, the certificate or certificate chain from the keystore which authenticates the public key corresponding to the private key used for signing.
193.295 +.LP
193.296 +.RE
193.297 +.RE
193.298 +.SS
193.299 +Signature Timestamp
193.300 +.LP
193.301 +.RS 3
193.302 +
193.303 +.LP
193.304 +.LP
193.305 +\f2jarsigner\fP tool can now generate and store a signature timestamp when signing a JAR file. In addition, \f2jarsigner\fP supports alternative signing mechanisms. This behavior is optional and is controlled by the user at the time of signing through these options:
193.306 +.LP
193.307 +.RS 3
193.308 +.TP 2
193.309 +o
193.310 +\f2\-tsa url\fP
193.311 +.TP 2
193.312 +o
193.313 +\f2\-tsacert alias\fP
193.314 +.TP 2
193.315 +o
193.316 +\f2\-altsigner class\fP
193.317 +.TP 2
193.318 +o
193.319 +\f2\-altsignerpath classpathlist\fP
193.320 +.RE
193.321 +
193.322 +.LP
193.323 +.LP
193.324 +Each of these options is detailed in the Options section below.
193.325 +.LP
193.326 +.RE
193.327 +.SS
193.328 +JAR File Verification
193.329 +.LP
193.330 +.RS 3
193.331 +
193.332 +.LP
193.333 +.LP
193.334 +A successful JAR file verification occurs if the signature(s) are valid, and none of the files that were in the JAR file when the signatures were generated have been changed since then. JAR file verification involves the following steps:
193.335 +.LP
193.336 +.RS 3
193.337 +.TP 3
193.338 +1.
193.339 +Verify the signature of the .SF file itself.
193.340 +.LP
193.341 +That is, the verification ensures that the signature stored in each signature block (.DSA) file was in fact generated using the private key corresponding to the public key whose certificate (or certificate chain) also appears in the .DSA file. It also ensures that the signature is a valid signature of the corresponding signature (.SF) file, and thus the .SF file has not been tampered with.
193.342 +.TP 3
193.343 +2.
193.344 +Verify the digest listed in each entry in the .SF file with each corresponding section in the manifest.
193.345 +.LP
193.346 +The .SF file by default includes a header containing a hash of the entire manifest file. When the header is present, then the verification can check to see whether or not the hash in the header indeed matches the hash of the manifest file. If that is the case, verification proceeds to the next step.
193.347 +.LP
193.348 +If that is not the case, a less optimized verification is required to ensure that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file (see The Signature (.SF) File).
193.349 +.LP
193.350 +One reason the hash of the manifest file that is stored in the .SF file header may not equal the hash of the current manifest file would be because one or more files were added to the JAR file (using the \f2jar\fP tool) after the signature (and thus the .SF file) was generated. When the \f2jar\fP tool is used to add files, the manifest file is changed (sections are added to it for the new files), but the .SF file is not. A verification is still considered successful if none of the files that were in the JAR file when the signature was generated have been changed since then, which is the case if the hashes in the non\-header sections of the .SF file equal the hashes of the corresponding sections in the manifest file.
193.351 +.TP 3
193.352 +3.
193.353 +Read each file in the JAR file that has an entry in the .SF file. While reading, compute the file's digest, and then compare the result with the digest for this file in the manifest section. The digests should be the same, or verification fails.
193.354 +.RE
193.355 +
193.356 +.LP
193.357 +.LP
193.358 +If any serious verification failures occur during the verification process, the process is stopped and a security exception is thrown. It is caught and displayed by \f3jarsigner\fP.
193.359 +.LP
193.360 +.RE
193.361 +.SS
193.362 +Multiple Signatures for a JAR File
193.363 +.LP
193.364 +.RS 3
193.365 +
193.366 +.LP
193.367 +.LP
193.368 +A JAR file can be signed by multiple people simply by running the \f3jarsigner\fP tool on the file multiple times, specifying the alias for a different person each time, as in:
193.369 +.LP
193.370 +.nf
193.371 +\f3
193.372 +.fl
193.373 + jarsigner myBundle.jar susan
193.374 +.fl
193.375 + jarsigner myBundle.jar kevin
193.376 +.fl
193.377 +\fP
193.378 +.fi
193.379 +
193.380 +.LP
193.381 +.LP
193.382 +When a JAR file is signed multiple times, there are multiple .SF and .DSA files in the resulting JAR file, one pair for each signature. Thus, in the example above, the output JAR file includes files with the following names:
193.383 +.LP
193.384 +.nf
193.385 +\f3
193.386 +.fl
193.387 + SUSAN.SF
193.388 +.fl
193.389 + SUSAN.DSA
193.390 +.fl
193.391 + KEVIN.SF
193.392 +.fl
193.393 + KEVIN.DSA
193.394 +.fl
193.395 +\fP
193.396 +.fi
193.397 +
193.398 +.LP
193.399 +.LP
193.400 +Note: It is also possible for a JAR file to have mixed signatures, some generated by the JDK 1.1 \f3javakey\fP tool and others by \f3jarsigner\fP. That is, \f3jarsigner\fP can be used to sign JAR files already previously signed using \f3javakey\fP.
193.401 +.LP
193.402 +.RE
193.403 +.SH "OPTIONS"
193.404 +.LP
193.405 +
193.406 +.LP
193.407 +.LP
193.408 +The various \f3jarsigner\fP options are listed and described below. Note:
193.409 +.LP
193.410 +.RS 3
193.411 +.TP 2
193.412 +o
193.413 +All option names are preceded by a minus sign (\-).
193.414 +.TP 2
193.415 +o
193.416 +The options may be provided in any order.
193.417 +.TP 2
193.418 +o
193.419 +Items in italics (option values) represent the actual values that must be supplied.
193.420 +.TP 2
193.421 +o
193.422 +The \f2\-keystore\fP, \f2\-storepass\fP, \f2\-keypass\fP, \f2\-sigfile\fP, \f2\-sigalg\fP, \f2\-digestalg\fP, and \f2\-signedjar\fP options are only relevant when signing a JAR file, not when verifying a signed JAR file. Similarly, an alias is only specified on the command line when signing a JAR file.
193.423 +.RE
193.424 +
193.425 +.LP
193.426 +.RS 3
193.427 +.TP 3
193.428 +\-keystore url
193.429 +Specifies the URL that tells the keystore location. This defaults to the file \f2.keystore\fP in the user's home directory, as determined by the "user.home" system property.
193.430 +.LP
193.431 +A keystore is required when signing, so you must explicitly specify one if the default keystore does not exist (or you want to use one other than the default).
193.432 +.LP
193.433 +A keystore is \f2not\fP required when verifying, but if one is specified, or the default exists, and the \f2\-verbose\fP option was also specified, additional information is output regarding whether or not any of the certificates used to verify the JAR file are contained in that keystore.
193.434 +.LP
193.435 +Note: the \f2\-keystore\fP argument can actually be a file name (and path) specification rather than a URL, in which case it will be treated the same as a "file:" URL. That is,
193.436 +.nf
193.437 +\f3
193.438 +.fl
193.439 + \-keystore \fP\f4filePathAndName\fP\f3
193.440 +.fl
193.441 +\fP
193.442 +.fi
193.443 +is treated as equivalent to
193.444 +.nf
193.445 +\f3
193.446 +.fl
193.447 + \-keystore file:\fP\f4filePathAndName\fP\f3
193.448 +.fl
193.449 +\fP
193.450 +.fi
193.451 +If the Sun PKCS#11 provider has been configured in the \f2java.security\fP security properties file (located in the JRE's \f2$JAVA_HOME/lib/security\fP directory), then keytool and jarsigner can operate on the PKCS#11 token by specifying these options:
193.452 +.RS 3
193.453 +.TP 2
193.454 +o
193.455 +\f2\-keystore NONE\fP
193.456 +.TP 2
193.457 +o
193.458 +\f2\-storetype PKCS11\fP
193.459 +.RE
193.460 +For example, this command lists the contents of the configured PKCS#11 token:
193.461 +.RS 3
193.462 +
193.463 +.LP
193.464 +.nf
193.465 +\f3
193.466 +.fl
193.467 + jarsigner \-keystore NONE \-storetype PKCS11 \-list
193.468 +.fl
193.469 +
193.470 +.fl
193.471 +\fP
193.472 +.fi
193.473 +.RE
193.474 +.TP 3
193.475 +\-storetype storetype
193.476 +Specifies the type of keystore to be instantiated. The default keystore type is the one that is specified as the value of the "keystore.type" property in the security properties file, which is returned by the static \f2getDefaultType\fP method in \f2java.security.KeyStore\fP.
193.477 +.LP
193.478 +The PIN for a PCKS#11 token can also be specified using the \f2\-storepass\fP option. If none has been specified, keytool and jarsigner will prompt for the token PIN. If the token has a protected authentication path (such as a dedicated PIN\-pad or a biometric reader), then the \f2\-protected\fP option must be specified and no password options can be specified.
193.479 +.TP 3
193.480 +\-storepass password
193.481 +Specifies the password which is required to access the keystore. This is only needed when signing (not verifying) a JAR file. In that case, if a \f2\-storepass\fP option is not provided at the command line, the user is prompted for the password.
193.482 +.LP
193.483 +Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system.
193.484 +.TP 3
193.485 +\-keypass password
193.486 +Specifies the password used to protect the private key of the keystore entry addressed by the alias specified on the command line. The password is required when using \f3jarsigner\fP to sign a JAR file. If no password is provided on the command line, and the required password is different from the store password, the user is prompted for it.
193.487 +.LP
193.488 +Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
193.489 +.TP 3
193.490 +\-sigfile file
193.491 +Specifies the base file name to be used for the generated .SF and .DSA files. For example, if \f2file\fP is "DUKESIGN", the generated .SF and .DSA files will be named "DUKESIGN.SF" and "DUKESIGN.DSA", and will be placed in the "META\-INF" directory of the signed JAR file.
193.492 +.LP
193.493 +The characters in \f2file\fP must come from the set "a\-zA\-Z0\-9_\-". That is, only letters, numbers, underscore, and hyphen characters are allowed. Note: All lowercase characters will be converted to uppercase for the .SF and .DSA file names.
193.494 +.LP
193.495 +If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not legal in a signature file name, each such character is converted to an underscore ("_") character in forming the file name.
193.496 +.TP 3
193.497 +\-sigalg algorithm
193.498 +.RS 3
193.499 +
193.500 +.LP
193.501 +Specifies the name of the signature algorithm to use to sign the JAR file.
193.502 +.LP
193.503 +See
193.504 +.na
193.505 +\f2Appendix A\fP @
193.506 +.fi
193.507 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA of the Java Cryptography Architecture for a list of standard signature algorithm names. This algorithm must be compatible with the private key used to sign the JAR file. If this option is not specified, SHA1withDSA or SHA1withRSA will be used depending on the type of private key. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
193.508 +.LP
193.509 +.RE
193.510 +.TP 3
193.511 +\-digestalg algorithm
193.512 +.RS 3
193.513 +Specifies the name of the message digest algorithm to use when digesting the entries of a jar file.
193.514 +.LP
193.515 +See
193.516 +.na
193.517 +\f2Appendix A\fP @
193.518 +.fi
193.519 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#AppA of the Java Cryptography Architecture for a list of standard message digest algorithm names. If this option is not specified, SHA\-1 will be used. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
193.520 +.LP
193.521 +.RE
193.522 +.TP 3
193.523 +\-signedjar file
193.524 +Specifies the name to be used for the signed JAR file.
193.525 +.LP
193.526 +If no name is specified on the command line, the name used is the same as the input JAR file name (the name of the JAR file to be signed); in other words, that file is overwritten with the signed JAR file.
193.527 +.TP 3
193.528 +\-verify
193.529 +If this appears on the command line, the specified JAR file will be verified, not signed. If the verification is successful, "jar verified" will be displayed. If you try to verify an unsigned JAR file, or a JAR file signed with an unsupported algorithm (e.g., RSA when you don't have an RSA provider installed), the following is displayed: "jar is unsigned. (signatures missing or not parsable)"
193.530 +.LP
193.531 +It is possible to verify JAR files signed using either \f3jarsigner\fP or the JDK 1.1 \f3javakey\fP tool, or both.
193.532 +.LP
193.533 +For further information on verification, see JAR File Verification.
193.534 +.TP 3
193.535 +\-certs
193.536 +If this appears on the command line, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file. This information includes
193.537 +.RS 3
193.538 +.TP 2
193.539 +o
193.540 +the name of the type of certificate (stored in the .DSA file) that certifies the signer's public key
193.541 +.TP 2
193.542 +o
193.543 +if the certificate is an X.509 certificate (more specifically, an instance of \f2java.security.cert.X509Certificate\fP): the distinguished name of the signer
193.544 +.RE
193.545 +.LP
193.546 +The keystore is also examined. If no keystore value is specified on the command line, the default keystore file (if any) will be checked. If the public key certificate for a signer matches an entry in the keystore, then the following information will also be displayed:
193.547 +.RS 3
193.548 +.TP 2
193.549 +o
193.550 +in parentheses, the alias name for the keystore entry for that signer. If the signer actually comes from a JDK 1.1 identity database instead of from a keystore, the alias name will appear in brackets instead of parentheses.
193.551 +.RE
193.552 +.TP 3
193.553 +\-certchain file
193.554 +Specifies the certificate chain to be used, if the certificate chain associated with the private key of the keystore entry, addressed by the alias specified on the command line, is not complete. This may happen if the keystore is located on a hardware token where there is not enough capacity to hold a complete certificate chain. The file can be a sequence of X.509 certificates concatenated together, or a single PKCS#7 formatted data block, either in binary encoding format or in printable encoding format (also known as BASE64 encoding) as defined by the Internet RFC 1421 standard.
193.555 +.TP 3
193.556 +\-verbose
193.557 +If this appears on the command line, it indicates "verbose" mode, which causes \f3jarsigner\fP to output extra information as to the progress of the JAR signing or verification.
193.558 +.TP 3
193.559 +\-internalsf
193.560 +In the past, the .DSA (signature block) file generated when a JAR file was signed used to include a complete encoded copy of the .SF file (signature file) also generated. This behavior has been changed. To reduce the overall size of the output JAR file, the .DSA file by default doesn't contain a copy of the .SF file anymore. But if \f2\-internalsf\fP appears on the command line, the old behavior is utilized. \f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
193.561 +.TP 3
193.562 +\-sectionsonly
193.563 +If this appears on the command line, the .SF file (signature file) generated when a JAR file is signed does \f2not\fP include a header containing a hash of the whole manifest file. It just contains information and hashes related to each individual source file included in the JAR file, as described in The Signature (.SF) File .
193.564 +.LP
193.565 +By default, this header is added, as an optimization. When the header is present, then whenever the JAR file is verified, the verification can first check to see whether or not the hash in the header indeed matches the hash of the whole manifest file. If so, verification proceeds to the next step. If not, it is necessary to do a less optimized verification that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file.
193.566 +.LP
193.567 +For further information, see JAR File Verification.
193.568 +.LP
193.569 +\f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
193.570 +.TP 3
193.571 +\-protected
193.572 +Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
193.573 +.RE
193.574 +.RS 3
193.575 +.TP 3
193.576 +\-provider provider\-class\-name
193.577 +Used to specify the name of cryptographic service provider's master class file when the service provider is not listed in the security properties file, \f2java.security\fP.
193.578 +.LP
193.579 +Used in conjunction with the \f2\-providerArg\fP \f2ConfigFilePath\fP option, keytool and jarsigner will install the provider dynamically (where \f2ConfigFilePath\fP is the path to the token configuration file). Here's an example of a command to list a PKCS#11 keystore when the Sun PKCS#11 provider has not been configured in the security properties file.
193.580 +.RS 3
193.581 +
193.582 +.LP
193.583 +.nf
193.584 +\f3
193.585 +.fl
193.586 +jarsigner \-keystore NONE \-storetype PKCS11 \\
193.587 +.fl
193.588 + \-providerClass sun.security.pkcs11.SunPKCS11 \\
193.589 +.fl
193.590 + \-providerArg /foo/bar/token.config \\
193.591 +.fl
193.592 + \-list
193.593 +.fl
193.594 +\fP
193.595 +.fi
193.596 +.RE
193.597 +.TP 3
193.598 +\-providerName providerName
193.599 +If more than one provider has been configured in the \f2java.security\fP security properties file, you can use the \f2\-providerName\fP option to target a specific provider instance. The argument to this option is the name of the provider.
193.600 +.LP
193.601 +For the Sun PKCS#11 provider, \f2providerName\fP is of the form \f2SunPKCS11\-\fP\f2TokenName\fP, where \f2TokenName\fP is the name suffix that the provider instance has been configured with, as detailed in the
193.602 +.na
193.603 +\f2configuration attributes table\fP @
193.604 +.fi
193.605 +http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#ATTRS. For example, the following command lists the contents of the PKCS#11 keystore provider instance with name suffix \f2SmartCard\fP:
193.606 +.RS 3
193.607 +
193.608 +.LP
193.609 +.nf
193.610 +\f3
193.611 +.fl
193.612 +jarsigner \-keystore NONE \-storetype PKCS11 \\
193.613 +.fl
193.614 + \-providerName SunPKCS11\-SmartCard \\
193.615 +.fl
193.616 + \-list
193.617 +.fl
193.618 +\fP
193.619 +.fi
193.620 +.RE
193.621 +.TP 3
193.622 +\-Jjavaoption
193.623 +Passes through the specified \f2javaoption\fP string directly to the Java interpreter. (\f3jarsigner\fP is actually a "wrapper" around the interpreter.) This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
193.624 +.LP
193.625 +.TP 3
193.626 +\-tsa url
193.627 +If \f2"\-tsa http://example.tsa.url"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The URL, \f2http://example.tsa.url\fP, identifies the location of the Time Stamping Authority (TSA). It overrides any URL found via the \f2\-tsacert\fP option. The \f2\-tsa\fP option does not require the TSA's public key certificate to be present in the keystore.
193.628 +.LP
193.629 +To generate the timestamp, \f2jarsigner\fP communicates with the TSA using the Time\-Stamp Protocol (TSP) defined in
193.630 +.na
193.631 +\f2RFC 3161\fP @
193.632 +.fi
193.633 +http://www.ietf.org/rfc/rfc3161.txt. If successful, the timestamp token returned by the TSA is stored along with the signature in the signature block file.
193.634 +.LP
193.635 +.TP 3
193.636 +\-tsacert alias
193.637 +If \f2"\-tsacert alias"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The \f2alias\fP identifies the TSA's public key certificate in the keystore that is currently in effect. The entry's certificate is examined for a Subject Information Access extension that contains a URL identifying the location of the TSA.
193.638 +.LP
193.639 +The TSA's public key certificate must be present in the keystore when using \f2\-tsacert\fP.
193.640 +.LP
193.641 +.TP 3
193.642 +\-altsigner class
193.643 +Specifies that an alternative signing mechanism be used. The fully\-qualified class name identifies a class file that extends the \f2com.sun.jarsigner.ContentSigner abstract class\fP. The path to this class file is defined by the \f2\-altsignerpath\fP option. If the \f2\-altsigner\fP option is used, \f2jarsigner\fP uses the signing mechanism provided by the specified class. Otherwise, \f2jarsigner\fP uses its default signing mechanism.
193.644 +.LP
193.645 +For example, to use the signing mechanism provided by a class named \f2com.sun.sun.jarsigner.AuthSigner\fP, use the \f2jarsigner\fP option \f2"\-altsigner com.sun.jarsigner.AuthSigner"\fP
193.646 +.LP
193.647 +.TP 3
193.648 +\-altsignerpath classpathlist
193.649 +Specifies the path to the class file (the class file name is specified with the \f2\-altsigner\fP option described above) and any JAR files it depends on. If the class file is in a JAR file, then this specifies the path to that JAR file, as shown in the example below.
193.650 +.LP
193.651 +An absolute path or a path relative to the current directory may be specified. If \f2classpathlist\fP contains multiple paths or JAR files, they should be separated with a colon (\f2:\fP) on Solaris and a semi\-colon (\f2;\fP) on Windows. This option is not necessary if the class is already in the search path.
193.652 +.LP
193.653 +Example of specifying the path to a jar file that contains the class file:
193.654 +.RS 3
193.655 +
193.656 +.LP
193.657 +.LP
193.658 +\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
193.659 +.LP
193.660 +.RE
193.661 +.LP
193.662 +Note that the JAR file name is included.
193.663 +.LP
193.664 +Example of specifying the path to the jar file that contains the class file:
193.665 +.RS 3
193.666 +.LP
193.667 +\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
193.668 +.LP
193.669 +.RE
193.670 +.LP
193.671 +Note that the JAR file name is omitted.
193.672 +.TP 3
193.673 +\-strict
193.674 +During the signing or verifying process, some warning messages may be shown. If this option appears on the command line, the exit code of the tool will reflect the warning messages that are found. Read the "WARNINGS" section for details.
193.675 +.TP 3
193.676 +\-verbose:sub\-options
193.677 +For the verifying process, the \f2\-verbose\fP option takes sub\-options to determine how much information will be shown. If \f2\-certs\fP is also specified, the default mode (or sub\-option all) displays each entry as it is being processed and following that, the certificate information for each signer of the JAR file. If \f2\-certs\fP and the \f2\-verbose:grouped\fP sub\-option are specified, entries with the same signer info are grouped and displayed together along with their certificate information. If \f2\-certs\fP and the \f2\-verbose:summary\fP sub\-option are specified, then entries with the same signer info are grouped and displayed together along with their certificate information but details about each entry are summarized and displayed as "one entry (and more)". See the examples section for more information.
193.678 +.RE
193.679 +.SH "EXAMPLES"
193.680 +.LP
193.681 +
193.682 +.LP
193.683 +.SS
193.684 +Signing a JAR File
193.685 +.LP
193.686 +.RS 3
193.687 +
193.688 +.LP
193.689 +.LP
193.690 +Suppose you have a JAR file named "bundle.jar" and you'd like to sign it using the private key of the user whose keystore alias is "jane" in the keystore named "mystore" in the "working" directory. Suppose the keystore password is "myspass" and the password for \f2jane\fP's private key is "j638klm". You can use the following to sign the JAR file and name the signed JAR file "sbundle.jar":
193.691 +.LP
193.692 +.nf
193.693 +\f3
193.694 +.fl
193.695 + jarsigner \-keystore /working/mystore \-storepass myspass
193.696 +.fl
193.697 + \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
193.698 +.fl
193.699 +\fP
193.700 +.fi
193.701 +
193.702 +.LP
193.703 +.LP
193.704 +Note that there is no \f2\-sigfile\fP specified in the command above, so the generated .SF and .DSA files to be placed in the signed JAR file will have default names based on the alias name. That is, they will be named \f2JANE.SF\fP and \f2JANE.DSA\fP.
193.705 +.LP
193.706 +.LP
193.707 +If you want to be prompted for the store password and the private key password, you could shorten the above command to
193.708 +.LP
193.709 +.nf
193.710 +\f3
193.711 +.fl
193.712 + jarsigner \-keystore /working/mystore
193.713 +.fl
193.714 + \-signedjar sbundle.jar bundle.jar jane
193.715 +.fl
193.716 +\fP
193.717 +.fi
193.718 +
193.719 +.LP
193.720 +.LP
193.721 +If the keystore to be used is the default keystore (the one named ".keystore" in your home directory), you don't need to specify a keystore, as in:
193.722 +.LP
193.723 +.nf
193.724 +\f3
193.725 +.fl
193.726 + jarsigner \-signedjar sbundle.jar bundle.jar jane
193.727 +.fl
193.728 +\fP
193.729 +.fi
193.730 +
193.731 +.LP
193.732 +.LP
193.733 +Finally, if you want the signed JAR file to simply overwrite the input JAR file (\f2bundle.jar\fP), you don't need to specify a \f2\-signedjar\fP option:
193.734 +.LP
193.735 +.nf
193.736 +\f3
193.737 +.fl
193.738 + jarsigner bundle.jar jane
193.739 +.fl
193.740 +\fP
193.741 +.fi
193.742 +.RE
193.743 +
193.744 +.LP
193.745 +.SS
193.746 +Verifying a Signed JAR File
193.747 +.LP
193.748 +.RS 3
193.749 +
193.750 +.LP
193.751 +.LP
193.752 +To verify a signed JAR file, that is, to verify that the signature is valid and the JAR file has not been tampered with, use a command such as the following:
193.753 +.LP
193.754 +.nf
193.755 +\f3
193.756 +.fl
193.757 + jarsigner \-verify sbundle.jar
193.758 +.fl
193.759 +\fP
193.760 +.fi
193.761 +
193.762 +.LP
193.763 +.LP
193.764 +If the verification is successful,
193.765 +.LP
193.766 +.nf
193.767 +\f3
193.768 +.fl
193.769 + jar verified.
193.770 +.fl
193.771 +\fP
193.772 +.fi
193.773 +
193.774 +.LP
193.775 +.LP
193.776 +is displayed. Otherwise, an error message appears.
193.777 +.LP
193.778 +.LP
193.779 +You can get more information if you use the \f2\-verbose\fP option. A sample use of \f3jarsigner\fP with the \f2\-verbose\fP option is shown below, along with sample output:
193.780 +.LP
193.781 +.nf
193.782 +\f3
193.783 +.fl
193.784 + jarsigner \-verify \-verbose sbundle.jar
193.785 +.fl
193.786 +
193.787 +.fl
193.788 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.789 +.fl
193.790 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.791 +.fl
193.792 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.793 +.fl
193.794 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
193.795 +.fl
193.796 + smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
193.797 +.fl
193.798 +
193.799 +.fl
193.800 + s = signature was verified
193.801 +.fl
193.802 + m = entry is listed in manifest
193.803 +.fl
193.804 + k = at least one certificate was found in keystore
193.805 +.fl
193.806 +
193.807 +.fl
193.808 + jar verified.
193.809 +.fl
193.810 +\fP
193.811 +.fi
193.812 +
193.813 +.LP
193.814 +.SS
193.815 +Verification with Certificate Information
193.816 +.LP
193.817 +.LP
193.818 +If you specify the \f2\-certs\fP option when verifying, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file, including the certificate type, the signer distinguished name information (iff it's an X.509 certificate), and, in parentheses, the keystore alias for the signer if the public key certificate in the JAR file matches that in a keystore entry. For example,
193.819 +.LP
193.820 +.nf
193.821 +\f3
193.822 +.fl
193.823 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
193.824 +.fl
193.825 +
193.826 +.fl
193.827 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.828 +.fl
193.829 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.830 +.fl
193.831 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.832 +.fl
193.833 + 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
193.834 +.fl
193.835 + 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
193.836 +.fl
193.837 + smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
193.838 +.fl
193.839 +
193.840 +.fl
193.841 + X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
193.842 +.fl
193.843 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
193.844 +.fl
193.845 +
193.846 +.fl
193.847 + s = signature was verified
193.848 +.fl
193.849 + m = entry is listed in manifest
193.850 +.fl
193.851 + k = at least one certificate was found in keystore
193.852 +.fl
193.853 +
193.854 +.fl
193.855 + jar verified.
193.856 +.fl
193.857 +\fP
193.858 +.fi
193.859 +
193.860 +.LP
193.861 +.LP
193.862 +If the certificate for a signer is not an X.509 certificate, there is no distinguished name information. In that case, just the certificate type and the alias are shown. For example, if the certificate is a PGP certificate, and the alias is "bob", you'd get
193.863 +.LP
193.864 +.nf
193.865 +\f3
193.866 +.fl
193.867 + PGP, (bob)
193.868 +.fl
193.869 +\fP
193.870 +.fi
193.871 +
193.872 +.LP
193.873 +.SS
193.874 +Verification of a JAR File that Includes Identity Database Signers
193.875 +.LP
193.876 +.LP
193.877 +If a JAR file has been signed using the JDK 1.1 \f3javakey\fP tool, and thus the signer is an alias in an identity database, the verification output includes an "i" symbol. If the JAR file has been signed by both an alias in an identity database and an alias in a keystore, both "k" and "i" appear.
193.878 +.LP
193.879 +.LP
193.880 +When the \f2\-certs\fP option is used, any identity database aliases are shown in square brackets rather than the parentheses used for keystore aliases. For example:
193.881 +.LP
193.882 +.nf
193.883 +\f3
193.884 +.fl
193.885 + jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
193.886 +.fl
193.887 +
193.888 +.fl
193.889 + 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.890 +.fl
193.891 + 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.892 +.fl
193.893 + 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.894 +.fl
193.895 + 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
193.896 +.fl
193.897 + 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
193.898 +.fl
193.899 + smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
193.900 +.fl
193.901 +
193.902 +.fl
193.903 + X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
193.904 +.fl
193.905 + X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
193.906 +.fl
193.907 +
193.908 +.fl
193.909 + s = signature was verified
193.910 +.fl
193.911 + m = entry is listed in manifest
193.912 +.fl
193.913 + k = at least one certificate was found in keystore
193.914 +.fl
193.915 + i = at least one certificate was found in identity scope
193.916 +.fl
193.917 +
193.918 +.fl
193.919 + jar verified.
193.920 +.fl
193.921 +\fP
193.922 +.fi
193.923 +
193.924 +.LP
193.925 +.LP
193.926 +Note that the alias "duke" is in brackets to denote that it is an identity database alias, not a keystore alias.
193.927 +.LP
193.928 +.RE
193.929 +.SH "WARNINGS"
193.930 +.LP
193.931 +
193.932 +.LP
193.933 +During the signing/verifying process, jarsigner may display various warnings. These warning codes are defined as follows:
193.934 +.nf
193.935 +\f3
193.936 +.fl
193.937 + hasExpiringCert 2
193.938 +.fl
193.939 + This jar contains entries whose signer certificate will expire within six months
193.940 +.fl
193.941 +
193.942 +.fl
193.943 + hasExpiredCert 4
193.944 +.fl
193.945 + This jar contains entries whose signer certificate has expired.
193.946 +.fl
193.947 +
193.948 +.fl
193.949 + notYetValidCert 4
193.950 +.fl
193.951 + This jar contains entries whose signer certificate is not yet valid.
193.952 +.fl
193.953 +
193.954 +.fl
193.955 + chainNotValidated 4
193.956 +.fl
193.957 + This jar contains entries whose certificate chain cannot be correctly validated.
193.958 +.fl
193.959 +
193.960 +.fl
193.961 + badKeyUsage 8
193.962 +.fl
193.963 + This jar contains entries whose signer certificate's KeyUsage extension doesn't allow code signing.
193.964 +.fl
193.965 +
193.966 +.fl
193.967 + badExtendedKeyUsage 8
193.968 +.fl
193.969 + This jar contains entries whose signer certificate's ExtendedKeyUsage extension
193.970 +.fl
193.971 + doesn't allow code signing.
193.972 +.fl
193.973 +
193.974 +.fl
193.975 + badNetscapeCertType 8
193.976 +.fl
193.977 + This jar contains entries whose signer certificate's NetscapeCertType extension
193.978 +.fl
193.979 + doesn't allow code signing.
193.980 +.fl
193.981 +
193.982 +.fl
193.983 + hasUnsignedEntry 16
193.984 +.fl
193.985 + This jar contains unsigned entries which have not been integrity\-checked.
193.986 +.fl
193.987 +
193.988 +.fl
193.989 + notSignedByAlias 32
193.990 +.fl
193.991 + This jar contains signed entries which are not signed by the specified alias(es)
193.992 +.fl
193.993 +
193.994 +.fl
193.995 + aliasNotInStore 32
193.996 +.fl
193.997 + This jar contains signed entries that are not signed by alias in this keystore
193.998 +.fl
193.999 +
193.1000 +.fl
193.1001 +\fP
193.1002 +.fi
193.1003 +
193.1004 +.LP
193.1005 +.LP
193.1006 +When the \f2\-strict\fP option is provided, an OR\-value of warnings detected will be returned as the exit code of the tool. For example, if a certificate used to sign an entry is expired and has a keyUsage extension that does not allow it to sign a file, an exit code 12 (=4+8) will be returned.
193.1007 +.LP
193.1008 +.LP
193.1009 +\f3Note\fP: Exit codes are reused because only 0\-255 is legal for Unix. In any case, if the signing/verifying process fails, the exit code
193.1010 +.LP
193.1011 +.nf
193.1012 +\f3
193.1013 +.fl
193.1014 +failure 1
193.1015 +.fl
193.1016 +\fP
193.1017 +.fi
193.1018 +
193.1019 +.LP
193.1020 +will be returned.
193.1021 +.SS
193.1022 Compatibility with JDK 1.1
193.1023 .LP
193.1024 .RS 3
193.1025 @@ -441,7 +1391,7 @@
193.1026 .nr 44 \n(83+(3*\n(38)
193.1027 .nr 84 +\n(44
193.1028 .nr TW \n(84
193.1029 -.if t .if \n(TW>\n(.li .tm Table at line 161 file Input is too wide - \n(TW units
193.1030 +.if t .if \n(TW>\n(.li .tm Table at line 1129 file Input is too wide - \n(TW units
193.1031 .fc
193.1032 .nr #T 0-1
193.1033 .nr #a 0-1
193.1034 @@ -640,854 +1590,6 @@
193.1035 .RE
193.1036
193.1037 .LP
193.1038 -.SS
193.1039 -Keystore Aliases
193.1040 -.LP
193.1041 -.RS 3
193.1042 -
193.1043 -.LP
193.1044 -.LP
193.1045 -All keystore entities are accessed via unique \f2aliases\fP.
193.1046 -.LP
193.1047 -.LP
193.1048 -When using \f3jarsigner\fP to sign a JAR file, you must specify the alias for the keystore entry containing the private key needed to generate the signature. For example, the following will sign the JAR file named "MyJARFile.jar", using the private key associated with the alias "duke" in the keystore named "mystore" in the "working" directory. Since no output file is specified, it overwrites MyJARFile.jar with the signed JAR file.
193.1049 -.LP
193.1050 -.nf
193.1051 -\f3
193.1052 -.fl
193.1053 - jarsigner \-keystore /working/mystore \-storepass myspass
193.1054 -.fl
193.1055 - \-keypass dukekeypasswd MyJARFile.jar duke
193.1056 -.fl
193.1057 -\fP
193.1058 -.fi
193.1059 -
193.1060 -.LP
193.1061 -.LP
193.1062 -Keystores are protected with a password, so the store password (in this case "myspass") must be specified. You will be prompted for it if you don't specify it on the command line. Similarly, private keys are protected in a keystore with a password, so the private key's password (in this case "dukekeypasswd") must be specified, and you will be prompted for it if you don't specify it on the command line and it isn't the same as the store password.
193.1063 -.LP
193.1064 -.RE
193.1065 -.SS
193.1066 -Keystore Location
193.1067 -.LP
193.1068 -.RS 3
193.1069 -
193.1070 -.LP
193.1071 -.LP
193.1072 -\f3jarsigner\fP has a \f2\-keystore\fP option for specifying the URL of the keystore to be used. The keystore is by default stored in a file named \f2.keystore\fP in the user's home directory, as determined by the \f2user.home\fP system property. On Solaris systems \f2user.home\fP defaults to the user's home directory.
193.1073 -.LP
193.1074 -.LP
193.1075 -Note that the input stream from the \f2\-keystore\fP option is passed to the \f2KeyStore.load\fP method. If \f2NONE\fP is specified as the URL, then a null stream is passed to the \f2KeyStore.load\fP method. \f2NONE\fP should be specified if the \f2KeyStore\fP is not file\-based, for example, if it resides on a hardware token device.
193.1076 -.LP
193.1077 -.RE
193.1078 -.SS
193.1079 -Keystore Implementation
193.1080 -.LP
193.1081 -.RS 3
193.1082 -
193.1083 -.LP
193.1084 -.LP
193.1085 -The \f2KeyStore\fP class provided in the \f2java.security\fP package supplies well\-defined interfaces to access and modify the information in a keystore. It is possible for there to be multiple different concrete implementations, where each implementation is that for a particular \f2type\fP of keystore.
193.1086 -.LP
193.1087 -.LP
193.1088 -Currently, there are two command\-line tools that make use of keystore implementations (\f3keytool\fP and \f3jarsigner\fP), and also a GUI\-based tool named \f3Policy Tool\fP. Since \f2KeyStore\fP is publicly available, Java 2 SDK users can write additional security applications that use it.
193.1089 -.LP
193.1090 -.LP
193.1091 -There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
193.1092 -.LP
193.1093 -.LP
193.1094 -Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a provider and supply a KeystoreSpi subclass implementation, as described in
193.1095 -.na
193.1096 -\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
193.1097 -.fi
193.1098 -http://java.sun.com/javase/6/docs/technotes/guides/security/HowToImplAProvider.html.
193.1099 -.LP
193.1100 -.LP
193.1101 -Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
193.1102 -.LP
193.1103 -.LP
193.1104 -\f3keytool\fP works on any file\-based keystore implementation. (It treats the keytore location that is passed to it at the command line as a filename and converts it to a FileInputStream, from which it loads the keystore information.) The \f3jarsigner\fP and \f3policytool\fP tools, on the other hand, can read a keystore from any location that can be specified using a URL.
193.1105 -.LP
193.1106 -.LP
193.1107 -For \f3jarsigner\fP and \f3keytool\fP, you can specify a keystore type at the command line, via the \f2\-storetype\fP option. For \f3Policy Tool\fP, you can specify a keystore type via the "Change Keystore" command in the Edit menu.
193.1108 -.LP
193.1109 -.LP
193.1110 -If you don't explicitly specify a keystore type, the tools choose a keystore implementation based simply on the value of the \f2keystore.type\fP property specified in the security properties file. The security properties file is called \f2java.security\fP, and it resides in the SDK security properties directory, \f2java.home\fP/lib/security, where \f2java.home\fP is the runtime environment's directory (the \f2jre\fP directory in the SDK or the top\-level directory of the Java 2 Runtime Environment).
193.1111 -.LP
193.1112 -.LP
193.1113 -Each tool gets the \f2keystore.type\fP value and then examines all the currently\-installed providers until it finds one that implements keystores of that type. It then uses the keystore implementation from that provider.
193.1114 -.LP
193.1115 -.LP
193.1116 -The \f2KeyStore\fP class defines a static method named \f2getDefaultType\fP that lets applications and applets retrieve the value of the \f2keystore.type\fP property. The following line of code creates an instance of the default keystore type (as specified in the \f2keystore.type\fP property):
193.1117 -.LP
193.1118 -.nf
193.1119 -\f3
193.1120 -.fl
193.1121 - KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
193.1122 -.fl
193.1123 -\fP
193.1124 -.fi
193.1125 -
193.1126 -.LP
193.1127 -.LP
193.1128 -The default keystore type is "jks" (the proprietary type of the keystore implementation provided by Sun). This is specified by the following line in the security properties file:
193.1129 -.LP
193.1130 -.nf
193.1131 -\f3
193.1132 -.fl
193.1133 - keystore.type=jks
193.1134 -.fl
193.1135 -\fP
193.1136 -.fi
193.1137 -
193.1138 -.LP
193.1139 -.LP
193.1140 -Note: Case doesn't matter in keystore type designations. For example, "JKS" would be considered the same as "jks".
193.1141 -.LP
193.1142 -.LP
193.1143 -To have the tools utilize a keystore implementation other than the default, change that line to specify a different keystore type. For example, if you have a provider package that supplies a keystore implementation for a keystore type called "pkcs12", change the line to
193.1144 -.LP
193.1145 -.nf
193.1146 -\f3
193.1147 -.fl
193.1148 - keystore.type=pkcs12
193.1149 -.fl
193.1150 -\fP
193.1151 -.fi
193.1152 -
193.1153 -.LP
193.1154 -.LP
193.1155 -Note that if you us the PKCS#11 provider package, you should refer to the
193.1156 -.na
193.1157 -\f2KeyTool and JarSigner\fP @
193.1158 -.fi
193.1159 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#keytooljarsigner section of the Java PKCS#11 Reference Guide for details.
193.1160 -.LP
193.1161 -.RE
193.1162 -.RE
193.1163 -.SS
193.1164 -Supported Algorithms
193.1165 -.LP
193.1166 -.RS 3
193.1167 -
193.1168 -.LP
193.1169 -.LP
193.1170 -By default, \f3jarsigner\fP signs a JAR file using either
193.1171 -.LP
193.1172 -.RS 3
193.1173 -.TP 2
193.1174 -o
193.1175 -DSA (Digital Signature Algorithm) with the SHA\-1 digest algorithm, or
193.1176 -.TP 2
193.1177 -o
193.1178 -the RSA algorithm with the MD5 digest algorithm.
193.1179 -.RE
193.1180 -
193.1181 -.LP
193.1182 -.LP
193.1183 -That is, if the signer's public and private keys are DSA keys, \f3jarsigner\fP will sign the JAR file using the "SHA1withDSA" algorithm. If the signer's keys are RSA keys, \f3jarsigner\fP will attempt to sign the JAR file using the "MD5withRSA" algorithm.
193.1184 -.LP
193.1185 -.LP
193.1186 -These default signature algorithms can be overridden using the \f2\-sigalg\fP option.
193.1187 -.LP
193.1188 -.RE
193.1189 -.SS
193.1190 -The Signed JAR File
193.1191 -.LP
193.1192 -.RS 3
193.1193 -
193.1194 -.LP
193.1195 -.LP
193.1196 -When \f3jarsigner\fP is used to sign a JAR file, the output signed JAR file is exactly the same as the input JAR file, except that it has two additional files placed in the META\-INF directory:
193.1197 -.LP
193.1198 -.RS 3
193.1199 -.TP 2
193.1200 -o
193.1201 -a signature file, with a .SF extension, and
193.1202 -.TP 2
193.1203 -o
193.1204 -a signature block file, with a .DSA extension.
193.1205 -.RE
193.1206 -
193.1207 -.LP
193.1208 -.LP
193.1209 -The base file names for these two files come from the value of the \f2\-sigFile\fP option. For example, if the option appears as
193.1210 -.LP
193.1211 -.nf
193.1212 -\f3
193.1213 -.fl
193.1214 - \-sigFile MKSIGN
193.1215 -.fl
193.1216 -\fP
193.1217 -.fi
193.1218 -
193.1219 -.LP
193.1220 -.LP
193.1221 -the files are named "MKSIGN.SF" and "MKSIGN.DSA".
193.1222 -.LP
193.1223 -.LP
193.1224 -If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not allowed in a signature file name, each such character is converted to an underscore ("_") character in forming the file name. Legal characters include letters, digits, underscores, and hyphens.
193.1225 -.LP
193.1226 -\f3The Signature (.SF) File\fP
193.1227 -.LP
193.1228 -.RS 3
193.1229 -
193.1230 -.LP
193.1231 -.LP
193.1232 -A signature file (the .SF file) looks similar to the manifest file that is always included in a JAR file when \f3jarsigner\fP is used to sign the file. That is, for each source file included in the JAR file, the .SF file has three lines, just as in the manifest file, listing the following:
193.1233 -.LP
193.1234 -.RS 3
193.1235 -.TP 2
193.1236 -o
193.1237 -the file name,
193.1238 -.TP 2
193.1239 -o
193.1240 -the name of the digest algorithm used (SHA), and
193.1241 -.TP 2
193.1242 -o
193.1243 -a SHA digest value.
193.1244 -.RE
193.1245 -
193.1246 -.LP
193.1247 -.LP
193.1248 -In the manifest file, the SHA digest value for each source file is the digest (hash) of the binary data in the source file. In the .SF file, on the other hand, the digest value for a given source file is the hash of the three lines in the manifest file for the source file.
193.1249 -.LP
193.1250 -.LP
193.1251 -The signature file also, by default, includes a header containing a hash of the whole manifest file. The presence of the header enables verification optimization, as described in JAR File Verification.
193.1252 -.LP
193.1253 -.RE
193.1254 -\f3The Signature Block (.DSA) File\fP
193.1255 -.LP
193.1256 -.RS 3
193.1257 -
193.1258 -.LP
193.1259 -.LP
193.1260 -The .SF file is signed and the signature is placed in the .DSA file. The .DSA file also contains, encoded inside it, the certificate or certificate chain from the keystore which authenticates the public key corresponding to the private key used for signing.
193.1261 -.LP
193.1262 -.RE
193.1263 -.RE
193.1264 -.SS
193.1265 -Signature Timestamp
193.1266 -.LP
193.1267 -.RS 3
193.1268 -
193.1269 -.LP
193.1270 -.LP
193.1271 -As of the J2SE 5.0 release, the \f2jarsigner\fP tool can now generate and store a signature timestamp when signing a JAR file. In addition, \f2jarsigner\fP supports alternative signing mechanisms. This behavior is optional and is controlled by the user at the time of signing through these options:
193.1272 -.LP
193.1273 -.RS 3
193.1274 -.TP 2
193.1275 -o
193.1276 -\f2\-tsa url\fP
193.1277 -.TP 2
193.1278 -o
193.1279 -\f2\-tsacert alias\fP
193.1280 -.TP 2
193.1281 -o
193.1282 -\f2\-altsigner class\fP
193.1283 -.TP 2
193.1284 -o
193.1285 -\f2\-altsignerpath classpathlist\fP
193.1286 -.RE
193.1287 -
193.1288 -.LP
193.1289 -.LP
193.1290 -Each of these options is detailed in the Options section below.
193.1291 -.LP
193.1292 -.RE
193.1293 -.SS
193.1294 -JAR File Verification
193.1295 -.LP
193.1296 -.RS 3
193.1297 -
193.1298 -.LP
193.1299 -.LP
193.1300 -A successful JAR file verification occurs if the signature(s) are valid, and none of the files that were in the JAR file when the signatures were generated have been changed since then. JAR file verification involves the following steps:
193.1301 -.LP
193.1302 -.RS 3
193.1303 -.TP 3
193.1304 -1.
193.1305 -Verify the signature of the .SF file itself.
193.1306 -.LP
193.1307 -That is, the verification ensures that the signature stored in each signature block (.DSA) file was in fact generated using the private key corresponding to the public key whose certificate (or certificate chain) also appears in the .DSA file. It also ensures that the signature is a valid signature of the corresponding signature (.SF) file, and thus the .SF file has not been tampered with.
193.1308 -.TP 3
193.1309 -2.
193.1310 -Verify the digest listed in each entry in the .SF file with each corresponding section in the manifest.
193.1311 -.LP
193.1312 -The .SF file by default includes a header containing a hash of the entire manifest file. When the header is present, then the verification can check to see whether or not the hash in the header indeed matches the hash of the manifest file. If that is the case, verification proceeds to the next step.
193.1313 -.LP
193.1314 -If that is not the case, a less optimized verification is required to ensure that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file (see The Signature (.SF) File).
193.1315 -.LP
193.1316 -One reason the hash of the manifest file that is stored in the .SF file header may not equal the hash of the current manifest file would be because one or more files were added to the JAR file (using the \f2jar\fP tool) after the signature (and thus the .SF file) was generated. When the \f2jar\fP tool is used to add files, the manifest file is changed (sections are added to it for the new files), but the .SF file is not. A verification is still considered successful if none of the files that were in the JAR file when the signature was generated have been changed since then, which is the case if the hashes in the non\-header sections of the .SF file equal the hashes of the corresponding sections in the manifest file.
193.1317 -.TP 3
193.1318 -3.
193.1319 -Read each file in the JAR file that has an entry in the .SF file. While reading, compute the file's digest, and then compare the result with the digest for this file in the manifest section. The digests should be the same, or verification fails.
193.1320 -.RE
193.1321 -
193.1322 -.LP
193.1323 -.LP
193.1324 -If any serious verification failures occur during the verification process, the process is stopped and a security exception is thrown. It is caught and displayed by \f3jarsigner\fP.
193.1325 -.LP
193.1326 -.RE
193.1327 -.SS
193.1328 -Multiple Signatures for a JAR File
193.1329 -.LP
193.1330 -.RS 3
193.1331 -
193.1332 -.LP
193.1333 -.LP
193.1334 -A JAR file can be signed by multiple people simply by running the \f3jarsigner\fP tool on the file multiple times, specifying the alias for a different person each time, as in:
193.1335 -.LP
193.1336 -.nf
193.1337 -\f3
193.1338 -.fl
193.1339 - jarsigner myBundle.jar susan
193.1340 -.fl
193.1341 - jarsigner myBundle.jar kevin
193.1342 -.fl
193.1343 -\fP
193.1344 -.fi
193.1345 -
193.1346 -.LP
193.1347 -.LP
193.1348 -When a JAR file is signed multiple times, there are multiple .SF and .DSA files in the resulting JAR file, one pair for each signature. Thus, in the example above, the output JAR file includes files with the following names:
193.1349 -.LP
193.1350 -.nf
193.1351 -\f3
193.1352 -.fl
193.1353 - SUSAN.SF
193.1354 -.fl
193.1355 - SUSAN.DSA
193.1356 -.fl
193.1357 - KEVIN.SF
193.1358 -.fl
193.1359 - KEVIN.DSA
193.1360 -.fl
193.1361 -\fP
193.1362 -.fi
193.1363 -
193.1364 -.LP
193.1365 -.LP
193.1366 -Note: It is also possible for a JAR file to have mixed signatures, some generated by the JDK 1.1 \f3javakey\fP tool and others by \f3jarsigner\fP. That is, \f3jarsigner\fP can be used to sign JAR files already previously signed using \f3javakey\fP.
193.1367 -.LP
193.1368 -.RE
193.1369 -.SH "OPTIONS"
193.1370 -.LP
193.1371 -
193.1372 -.LP
193.1373 -.LP
193.1374 -The various \f3jarsigner\fP options are listed and described below. Note:
193.1375 -.LP
193.1376 -.RS 3
193.1377 -.TP 2
193.1378 -o
193.1379 -All option names are preceded by a minus sign (\-).
193.1380 -.TP 2
193.1381 -o
193.1382 -The options may be provided in any order.
193.1383 -.TP 2
193.1384 -o
193.1385 -Items in italics (option values) represent the actual values that must be supplied.
193.1386 -.TP 2
193.1387 -o
193.1388 -The \f2\-keystore\fP, \f2\-storepass\fP, \f2\-keypass\fP, \f2\-sigfile\fP, \f2\-sigalg\fP, \f2\-digestalg\fP, and \f2\-signedjar\fP options are only relevant when signing a JAR file, not when verifying a signed JAR file. Similarly, an alias is only specified on the command line when signing a JAR file.
193.1389 -.RE
193.1390 -
193.1391 -.LP
193.1392 -.RS 3
193.1393 -.TP 3
193.1394 -\-keystore url
193.1395 -Specifies the URL that tells the keystore location. This defaults to the file \f2.keystore\fP in the user's home directory, as determined by the "user.home" system property.
193.1396 -.LP
193.1397 -A keystore is required when signing, so you must explicitly specify one if the default keystore does not exist (or you want to use one other than the default).
193.1398 -.LP
193.1399 -A keystore is \f2not\fP required when verifying, but if one is specified, or the default exists, and the \f2\-verbose\fP option was also specified, additional information is output regarding whether or not any of the certificates used to verify the JAR file are contained in that keystore.
193.1400 -.LP
193.1401 -Note: the \f2\-keystore\fP argument can actually be a file name (and path) specification rather than a URL, in which case it will be treated the same as a "file:" URL. That is,
193.1402 -.nf
193.1403 -\f3
193.1404 -.fl
193.1405 - \-keystore \fP\f4filePathAndName\fP\f3
193.1406 -.fl
193.1407 -\fP
193.1408 -.fi
193.1409 -is treated as equivalent to
193.1410 -.nf
193.1411 -\f3
193.1412 -.fl
193.1413 - \-keystore file:\fP\f4filePathAndName\fP\f3
193.1414 -.fl
193.1415 -\fP
193.1416 -.fi
193.1417 -If the Sun PKCS#11 provider has been configured in the \f2java.security\fP security properties file (located in the JRE's \f2$JAVA_HOME/lib/security\fP directory), then keytool and jarsigner can operate on the PKCS#11 token by specifying these options:
193.1418 -.RS 3
193.1419 -.TP 2
193.1420 -o
193.1421 -\f2\-keystore NONE\fP
193.1422 -.TP 2
193.1423 -o
193.1424 -\f2\-storetype PKCS11\fP
193.1425 -.RE
193.1426 -For example, this command lists the contents of the configured PKCS#11 token:
193.1427 -.RS 3
193.1428 -
193.1429 -.LP
193.1430 -.nf
193.1431 -\f3
193.1432 -.fl
193.1433 - jarsigner \-keystore NONE \-storetype PKCS11 \-list
193.1434 -.fl
193.1435 -
193.1436 -.fl
193.1437 -\fP
193.1438 -.fi
193.1439 -.RE
193.1440 -.TP 3
193.1441 -\-storetype storetype
193.1442 -Specifies the type of keystore to be instantiated. The default keystore type is the one that is specified as the value of the "keystore.type" property in the security properties file, which is returned by the static \f2getDefaultType\fP method in \f2java.security.KeyStore\fP.
193.1443 -.LP
193.1444 -The PIN for a PCKS#11 token can also be specified using the \f2\-storepass\fP option. If none has been specified, keytool and jarsigner will prompt for the token PIN. If the token has a protected authentication path (such as a dedicated PIN\-pad or a biometric reader), then the \f2\-protected\fP option must be specified and no password options can be specified.
193.1445 -.TP 3
193.1446 -\-storepass password
193.1447 -Specifies the password which is required to access the keystore. This is only needed when signing (not verifying) a JAR file. In that case, if a \f2\-storepass\fP option is not provided at the command line, the user is prompted for the password.
193.1448 -.LP
193.1449 -Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
193.1450 -.TP 3
193.1451 -\-keypass password
193.1452 -Specifies the password used to protect the private key of the keystore entry addressed by the alias specified on the command line. The password is required when using \f3jarsigner\fP to sign a JAR file. If no password is provided on the command line, and the required password is different from the store password, the user is prompted for it.
193.1453 -.LP
193.1454 -Note: The password shouldn't be specified on the command line or in a script unless it is for testing purposes, or you are on a secure system. Also, when typing in a password at the password prompt, the password is echoed (displayed exactly as typed), so be careful not to type it in front of anyone.
193.1455 -.TP 3
193.1456 -\-sigfile file
193.1457 -Specifies the base file name to be used for the generated .SF and .DSA files. For example, if \f2file\fP is "DUKESIGN", the generated .SF and .DSA files will be named "DUKESIGN.SF" and "DUKESIGN.DSA", and will be placed in the "META\-INF" directory of the signed JAR file.
193.1458 -.LP
193.1459 -The characters in \f2file\fP must come from the set "a\-zA\-Z0\-9_\-". That is, only letters, numbers, underscore, and hyphen characters are allowed. Note: All lowercase characters will be converted to uppercase for the .SF and .DSA file names.
193.1460 -.LP
193.1461 -If no \f2\-sigfile\fP option appears on the command line, the base file name for the .SF and .DSA files will be the first 8 characters of the alias name specified on the command line, all converted to upper case. If the alias name has fewer than 8 characters, the full alias name is used. If the alias name contains any characters that are not legal in a signature file name, each such character is converted to an underscore ("_") character in forming the file name.
193.1462 -.TP 3
193.1463 -\-sigalg algorithm
193.1464 -.RS 3
193.1465 -
193.1466 -.LP
193.1467 -Specifies the name of the signature algorithm to use to sign the JAR file.
193.1468 -.LP
193.1469 -See
193.1470 -.na
193.1471 -\f2Appendix A\fP @
193.1472 -.fi
193.1473 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa of the Java Cryptography Architecture for a list of standard signature algorithm names. This algorithm must be compatible with the private key used to sign the JAR file. If this option is not specified, SHA1withDSA or MD5withRSA will be used depending on the type of private key. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
193.1474 -.LP
193.1475 -.RE
193.1476 -.TP 3
193.1477 -\-digestalg algorithm
193.1478 -.RS 3
193.1479 -Specifies the name of the message digest algorithm to use when digesting the entries of a jar file.
193.1480 -.LP
193.1481 -See
193.1482 -.na
193.1483 -\f2Appendix A\fP @
193.1484 -.fi
193.1485 -http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/CryptoSpec.html#appa of the Java Cryptography Architecture for a list of standard message digest algorithm names. If this option is not specified, SHA\-1 will be used. There must either be a statically installed provider supplying an implementation of the specified algorithm or the user must specify one with the \f2\-providerClass\fP option, otherwise the command will not succeed.
193.1486 -.LP
193.1487 -.RE
193.1488 -.TP 3
193.1489 -\-signedjar file
193.1490 -Specifies the name to be used for the signed JAR file.
193.1491 -.LP
193.1492 -If no name is specified on the command line, the name used is the same as the input JAR file name (the name of the JAR file to be signed); in other words, that file is overwritten with the signed JAR file.
193.1493 -.TP 3
193.1494 -\-verify
193.1495 -If this appears on the command line, the specified JAR file will be verified, not signed. If the verification is successful, "jar verified" will be displayed. If you try to verify an unsigned JAR file, or a JAR file signed with an unsupported algorithm (e.g., RSA when you don't have an RSA provider installed), the following is displayed: "jar is unsigned. (signatures missing or not parsable)"
193.1496 -.LP
193.1497 -It is possible to verify JAR files signed using either \f3jarsigner\fP or the JDK 1.1 \f3javakey\fP tool, or both.
193.1498 -.LP
193.1499 -For further information on verification, see JAR File Verification.
193.1500 -.TP 3
193.1501 -\-certs
193.1502 -If this appears on the command line, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file. This information includes
193.1503 -.RS 3
193.1504 -.TP 2
193.1505 -o
193.1506 -the name of the type of certificate (stored in the .DSA file) that certifies the signer's public key
193.1507 -.TP 2
193.1508 -o
193.1509 -if the certificate is an X.509 certificate (more specifically, an instance of \f2java.security.cert.X509Certificate\fP): the distinguished name of the signer
193.1510 -.RE
193.1511 -.LP
193.1512 -The keystore is also examined. If no keystore value is specified on the command line, the default keystore file (if any) will be checked. If the public key certificate for a signer matches an entry in the keystore, then the following information will also be displayed:
193.1513 -.RS 3
193.1514 -.TP 2
193.1515 -o
193.1516 -in parentheses, the alias name for the keystore entry for that signer. If the signer actually comes from a JDK 1.1 identity database instead of from a keystore, the alias name will appear in brackets instead of parentheses.
193.1517 -.RE
193.1518 -.TP 3
193.1519 -\-verbose
193.1520 -If this appears on the command line, it indicates "verbose" mode, which causes \f3jarsigner\fP to output extra information as to the progress of the JAR signing or verification.
193.1521 -.TP 3
193.1522 -\-internalsf
193.1523 -In the past, the .DSA (signature block) file generated when a JAR file was signed used to include a complete encoded copy of the .SF file (signature file) also generated. This behavior has been changed. To reduce the overall size of the output JAR file, the .DSA file by default doesn't contain a copy of the .SF file anymore. But if \f2\-internalsf\fP appears on the command line, the old behavior is utilized. \f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
193.1524 -.TP 3
193.1525 -\-sectionsonly
193.1526 -If this appears on the command line, the .SF file (signature file) generated when a JAR file is signed does \f2not\fP include a header containing a hash of the whole manifest file. It just contains information and hashes related to each individual source file included in the JAR file, as described in The Signature (.SF) File .
193.1527 -.LP
193.1528 -By default, this header is added, as an optimization. When the header is present, then whenever the JAR file is verified, the verification can first check to see whether or not the hash in the header indeed matches the hash of the whole manifest file. If so, verification proceeds to the next step. If not, it is necessary to do a less optimized verification that the hash in each source file information section in the .SF file equals the hash of its corresponding section in the manifest file.
193.1529 -.LP
193.1530 -For further information, see JAR File Verification.
193.1531 -.LP
193.1532 -\f3This option is mainly useful for testing; in practice, it should not be used, since doing so eliminates a useful optimization.\fP
193.1533 -.TP 3
193.1534 -\-protected
193.1535 -Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
193.1536 -.RE
193.1537 -.RS 3
193.1538 -.TP 3
193.1539 -\-provider provider\-class\-name
193.1540 -Used to specify the name of cryptographic service provider's master class file when the service provider is not listed in the security properties file, \f2java.security\fP.
193.1541 -.LP
193.1542 -Used in conjunction with the \f2\-providerArg\fP \f2ConfigFilePath\fP option, keytool and jarsigner will install the provider dynamically (where \f2ConfigFilePath\fP is the path to the token configuration file). Here's an example of a command to list a PKCS#11 keystore when the Sun PKCS#11 provider has not been configured in the security properties file.
193.1543 -.RS 3
193.1544 -
193.1545 -.LP
193.1546 -.nf
193.1547 -\f3
193.1548 -.fl
193.1549 -jarsigner \-keystore NONE \-storetype PKCS11 \\
193.1550 -.fl
193.1551 - \-providerClass sun.security.pkcs11.SunPKCS11 \\
193.1552 -.fl
193.1553 - \-providerArg /foo/bar/token.config \\
193.1554 -.fl
193.1555 - \-list
193.1556 -.fl
193.1557 -\fP
193.1558 -.fi
193.1559 -.RE
193.1560 -.TP 3
193.1561 -\-providerName providerName
193.1562 -If more than one provider has been configured in the \f2java.security\fP security properties file, you can use the \f2\-providerName\fP option to target a specific provider instance. The argument to this option is the name of the provider.
193.1563 -.LP
193.1564 -For the Sun PKCS#11 provider, \f2providerName\fP is of the form \f2SunPKCS11\-\fP\f2TokenName\fP, where \f2TokenName\fP is the name suffix that the provider instance has been configured with, as detailed in the
193.1565 -.na
193.1566 -\f2configuration attributes table\fP @
193.1567 -.fi
193.1568 -http://java.sun.com/javase/6/docs/technotes/guides/security/p11guide.html#KeyToolJarSigner#ATTRS. For example, the following command lists the contents of the PKCS#11 keystore provider instance with name suffix \f2SmartCard\fP:
193.1569 -.RS 3
193.1570 -
193.1571 -.LP
193.1572 -.nf
193.1573 -\f3
193.1574 -.fl
193.1575 -jarsigner \-keystore NONE \-storetype PKCS11 \\
193.1576 -.fl
193.1577 - \-providerName SunPKCS11\-SmartCard \\
193.1578 -.fl
193.1579 - \-list
193.1580 -.fl
193.1581 -\fP
193.1582 -.fi
193.1583 -.RE
193.1584 -.TP 3
193.1585 -\-Jjavaoption
193.1586 -Passes through the specified \f2javaoption\fP string directly to the Java interpreter. (\f3jarsigner\fP is actually a "wrapper" around the interpreter.) This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
193.1587 -.LP
193.1588 -.TP 3
193.1589 -\-tsa url
193.1590 -If \f2"\-tsa http://example.tsa.url"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The URL, \f2http://example.tsa.url\fP, identifies the location of the Time Stamping Authority (TSA). It overrides any URL found via the \f2\-tsacert\fP option. The \f2\-tsa\fP option does not require the TSA's public key certificate to be present in the keystore.
193.1591 -.LP
193.1592 -To generate the timestamp, \f2jarsigner\fP communicates with the TSA using the Time\-Stamp Protocol (TSP) defined in
193.1593 -.na
193.1594 -\f2RFC 3161\fP @
193.1595 -.fi
193.1596 -http://www.ietf.org/rfc/rfc3161.txt. If successful, the timestamp token returned by the TSA is stored along with the signature in the signature block file.
193.1597 -.LP
193.1598 -.TP 3
193.1599 -\-tsacert alias
193.1600 -If \f2"\-tsacert alias"\fP appears on the command line when signing a JAR file then a timestamp is generated for the signature. The \f2alias\fP identifies the TSA's public key certificate in the keystore that is currently in effect. The entry's certificate is examined for a Subject Information Access extension that contains a URL identifying the location of the TSA.
193.1601 -.LP
193.1602 -The TSA's public key certificate must be present in the keystore when using \f2\-tsacert\fP.
193.1603 -.LP
193.1604 -.TP 3
193.1605 -\-altsigner class
193.1606 -Specifies that an alternative signing mechanism be used. The fully\-qualified class name identifies a class file that extends the \f2com.sun.jarsigner.ContentSigner abstract class\fP. The path to this class file is defined by the \f2\-altsignerpath\fP option. If the \f2\-altsigner\fP option is used, \f2jarsigner\fP uses the signing mechanism provided by the specified class. Otherwise, \f2jarsigner\fP uses its default signing mechanism.
193.1607 -.LP
193.1608 -For example, to use the signing mechanism provided by a class named \f2com.sun.sun.jarsigner.AuthSigner\fP, use the \f2jarsigner\fP option \f2"\-altsigner com.sun.jarsigner.AuthSigner"\fP
193.1609 -.LP
193.1610 -.TP 3
193.1611 -\-altsignerpath classpathlist
193.1612 -Specifies the path to the class file (the class file name is specified with the \f2\-altsigner\fP option described above) and any JAR files it depends on. If the class file is in a JAR file, then this specifies the path to that JAR file, as shown in the example below.
193.1613 -.LP
193.1614 -An absolute path or a path relative to the current directory may be specified. If \f2classpathlist\fP contains multiple paths or JAR files, they should be separated with a colon (\f2:\fP) on Solaris and a semi\-colon (\f2;\fP) on Windows. This option is not necessary if the class is already in the search path.
193.1615 -.LP
193.1616 -Example of specifying the path to a jar file that contains the class file:
193.1617 -.RS 3
193.1618 -
193.1619 -.LP
193.1620 -.LP
193.1621 -\f2\-altsignerpath /home/user/lib/authsigner.jar\fP
193.1622 -.LP
193.1623 -.RE
193.1624 -.LP
193.1625 -Note that the JAR file name is included.
193.1626 -.LP
193.1627 -Example of specifying the path to the jar file that contains the class file:
193.1628 -.RS 3
193.1629 -.LP
193.1630 -\f2\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP
193.1631 -.LP
193.1632 -.RE
193.1633 -.LP
193.1634 -Note that the JAR file name is omitted.
193.1635 -.RE
193.1636 -.SH "EXAMPLES"
193.1637 -.LP
193.1638 -
193.1639 -.LP
193.1640 -.SS
193.1641 -Signing a JAR File
193.1642 -.LP
193.1643 -.RS 3
193.1644 -
193.1645 -.LP
193.1646 -.LP
193.1647 -Suppose you have a JAR file named "bundle.jar" and you'd like to sign it using the private key of the user whose keystore alias is "jane" in the keystore named "mystore" in the "working" directory. Suppose the keystore password is "myspass" and the password for \f2jane\fP's private key is "j638klm". You can use the following to sign the JAR file and name the signed JAR file "sbundle.jar":
193.1648 -.LP
193.1649 -.nf
193.1650 -\f3
193.1651 -.fl
193.1652 - jarsigner \-keystore /working/mystore \-storepass myspass
193.1653 -.fl
193.1654 - \-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
193.1655 -.fl
193.1656 -\fP
193.1657 -.fi
193.1658 -
193.1659 -.LP
193.1660 -.LP
193.1661 -Note that there is no \f2\-sigfile\fP specified in the command above, so the generated .SF and .DSA files to be placed in the signed JAR file will have default names based on the alias name. That is, they will be named \f2JANE.SF\fP and \f2JANE.DSA\fP.
193.1662 -.LP
193.1663 -.LP
193.1664 -If you want to be prompted for the store password and the private key password, you could shorten the above command to
193.1665 -.LP
193.1666 -.nf
193.1667 -\f3
193.1668 -.fl
193.1669 - jarsigner \-keystore /working/mystore
193.1670 -.fl
193.1671 - \-signedjar sbundle.jar bundle.jar jane
193.1672 -.fl
193.1673 -\fP
193.1674 -.fi
193.1675 -
193.1676 -.LP
193.1677 -.LP
193.1678 -If the keystore to be used is the default keystore (the one named ".keystore" in your home directory), you don't need to specify a keystore, as in:
193.1679 -.LP
193.1680 -.nf
193.1681 -\f3
193.1682 -.fl
193.1683 - jarsigner \-signedjar sbundle.jar bundle.jar jane
193.1684 -.fl
193.1685 -\fP
193.1686 -.fi
193.1687 -
193.1688 -.LP
193.1689 -.LP
193.1690 -Finally, if you want the signed JAR file to simply overwrite the input JAR file (\f2bundle.jar\fP), you don't need to specify a \f2\-signedjar\fP option:
193.1691 -.LP
193.1692 -.nf
193.1693 -\f3
193.1694 -.fl
193.1695 - jarsigner bundle.jar jane
193.1696 -.fl
193.1697 -\fP
193.1698 -.fi
193.1699 -.RE
193.1700 -
193.1701 -.LP
193.1702 -.SS
193.1703 -Verifying a Signed JAR File
193.1704 -.LP
193.1705 -.RS 3
193.1706 -
193.1707 -.LP
193.1708 -.LP
193.1709 -To verify a signed JAR file, that is, to verify that the signature is valid and the JAR file has not been tampered with, use a command such as the following:
193.1710 -.LP
193.1711 -.nf
193.1712 -\f3
193.1713 -.fl
193.1714 - jarsigner \-verify sbundle.jar
193.1715 -.fl
193.1716 -\fP
193.1717 -.fi
193.1718 -
193.1719 -.LP
193.1720 -.LP
193.1721 -If the verification is successful,
193.1722 -.LP
193.1723 -.nf
193.1724 -\f3
193.1725 -.fl
193.1726 - jar verified.
193.1727 -.fl
193.1728 -\fP
193.1729 -.fi
193.1730 -
193.1731 -.LP
193.1732 -.LP
193.1733 -is displayed. Otherwise, an error message appears.
193.1734 -.LP
193.1735 -.LP
193.1736 -You can get more information if you use the \f2\-verbose\fP option. A sample use of \f3jarsigner\fP with the \f2\-verbose\fP option is shown below, along with sample output:
193.1737 -.LP
193.1738 -.nf
193.1739 -\f3
193.1740 -.fl
193.1741 - jarsigner \-verify \-verbose sbundle.jar
193.1742 -.fl
193.1743 -
193.1744 -.fl
193.1745 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.1746 -.fl
193.1747 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.1748 -.fl
193.1749 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.1750 -.fl
193.1751 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx.class
193.1752 -.fl
193.1753 - smk 849 Fri Sep 26 16:12:46 PDT 1997 test.class
193.1754 -.fl
193.1755 -
193.1756 -.fl
193.1757 - s = signature was verified
193.1758 -.fl
193.1759 - m = entry is listed in manifest
193.1760 -.fl
193.1761 - k = at least one certificate was found in keystore
193.1762 -.fl
193.1763 -
193.1764 -.fl
193.1765 - jar verified.
193.1766 -.fl
193.1767 -\fP
193.1768 -.fi
193.1769 -
193.1770 -.LP
193.1771 -.SS
193.1772 -Verification with Certificate Information
193.1773 -.LP
193.1774 -.LP
193.1775 -If you specify the \f2\-certs\fP option when verifying, along with the \f2\-verify\fP and \f2\-verbose\fP options, the output includes certificate information for each signer of the JAR file, including the certificate type, the signer distinguished name information (iff it's an X.509 certificate), and, in parentheses, the keystore alias for the signer if the public key certificate in the JAR file matches that in a keystore entry. For example,
193.1776 -.LP
193.1777 -.nf
193.1778 -\f3
193.1779 -.fl
193.1780 - jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest.jar
193.1781 -.fl
193.1782 -
193.1783 -.fl
193.1784 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.1785 -.fl
193.1786 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.1787 -.fl
193.1788 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.1789 -.fl
193.1790 - 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.SF
193.1791 -.fl
193.1792 - 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST.DSA
193.1793 -.fl
193.1794 - smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst.class
193.1795 -.fl
193.1796 -
193.1797 -.fl
193.1798 - X.509, CN=Test Group, OU=Java Software, O=Sun Microsystems, L=CUP, S=CA, C=US (javatest)
193.1799 -.fl
193.1800 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
193.1801 -.fl
193.1802 -
193.1803 -.fl
193.1804 - s = signature was verified
193.1805 -.fl
193.1806 - m = entry is listed in manifest
193.1807 -.fl
193.1808 - k = at least one certificate was found in keystore
193.1809 -.fl
193.1810 -
193.1811 -.fl
193.1812 - jar verified.
193.1813 -.fl
193.1814 -\fP
193.1815 -.fi
193.1816 -
193.1817 -.LP
193.1818 -.LP
193.1819 -If the certificate for a signer is not an X.509 certificate, there is no distinguished name information. In that case, just the certificate type and the alias are shown. For example, if the certificate is a PGP certificate, and the alias is "bob", you'd get
193.1820 -.LP
193.1821 -.nf
193.1822 -\f3
193.1823 -.fl
193.1824 - PGP, (bob)
193.1825 -.fl
193.1826 -\fP
193.1827 -.fi
193.1828 -
193.1829 -.LP
193.1830 -.SS
193.1831 -Verification of a JAR File that Includes Identity Database Signers
193.1832 -.LP
193.1833 -.LP
193.1834 -If a JAR file has been signed using the JDK 1.1 \f3javakey\fP tool, and thus the signer is an alias in an identity database, the verification output includes an "i" symbol. If the JAR file has been signed by both an alias in an identity database and an alias in a keystore, both "k" and "i" appear.
193.1835 -.LP
193.1836 -.LP
193.1837 -When the \f2\-certs\fP option is used, any identity database aliases are shown in square brackets rather than the parentheses used for keystore aliases. For example:
193.1838 -.LP
193.1839 -.nf
193.1840 -\f3
193.1841 -.fl
193.1842 - jarsigner \-keystore /working/mystore \-verify \-verbose \-certs writeFile.jar
193.1843 -.fl
193.1844 -
193.1845 -.fl
193.1846 - 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST.MF
193.1847 -.fl
193.1848 - 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.SF
193.1849 -.fl
193.1850 - 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE.DSA
193.1851 -.fl
193.1852 - 199 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.SF
193.1853 -.fl
193.1854 - 1013 Fri Sep 27 12:22:30 PDT 1997 META\-INF/DUKE.DSA
193.1855 -.fl
193.1856 - smki 2752 Fri Sep 26 16:12:30 PDT 1997 writeFile.html
193.1857 -.fl
193.1858 -
193.1859 -.fl
193.1860 - X.509, CN=Jane Smith, OU=Java Software, O=Sun, L=cup, S=ca, C=us (jane)
193.1861 -.fl
193.1862 - X.509, CN=Duke, OU=Java Software, O=Sun, L=cup, S=ca, C=us [duke]
193.1863 -.fl
193.1864 -
193.1865 -.fl
193.1866 - s = signature was verified
193.1867 -.fl
193.1868 - m = entry is listed in manifest
193.1869 -.fl
193.1870 - k = at least one certificate was found in keystore
193.1871 -.fl
193.1872 - i = at least one certificate was found in identity scope
193.1873 -.fl
193.1874 -
193.1875 -.fl
193.1876 - jar verified.
193.1877 -.fl
193.1878 -\fP
193.1879 -.fi
193.1880 -
193.1881 -.LP
193.1882 -.LP
193.1883 -Note that the alias "duke" is in brackets to denote that it is an identity database alias, not a keystore alias.
193.1884 -.LP
193.1885 -.RE
193.1886 .SH "SEE ALSO"
193.1887 .LP
193.1888
193.1889 @@ -1495,24 +1597,25 @@
193.1890 .RS 3
193.1891 .TP 2
193.1892 o
193.1893 -jar tool documentation
193.1894 +jar(1) tool documentation
193.1895 .TP 2
193.1896 o
193.1897 -keytool tool documentation
193.1898 +keytool(1) tool documentation
193.1899 .TP 2
193.1900 o
193.1901 the
193.1902 .na
193.1903 \f4Security\fP @
193.1904 .fi
193.1905 -http://java.sun.com/docs/books/tutorial/security1.2/index.html trail of the
193.1906 +http://java.sun.com/docs/books/tutorial/security/index.html trail of the
193.1907 .na
193.1908 \f4Java Tutorial\fP @
193.1909 .fi
193.1910 -http://java.sun.com/docs/books/tutorial/trailmap.html for examples of the use of the \f3jarsigner\fP tool
193.1911 +http://java.sun.com/docs/books/tutorial/index.html for examples of the use of the \f3jarsigner\fP tool
193.1912 .RE
193.1913
193.1914 .LP
193.1915
193.1916 .LP
193.1917 +.RE
193.1918
194.1 --- a/src/solaris/doc/sun/man/man1/java.1 Tue May 12 15:21:55 2009 +0900
194.2 +++ b/src/solaris/doc/sun/man/man1/java.1 Thu May 14 00:17:25 2009 -0700
194.3 @@ -1,5 +1,4 @@
194.4 -.'" t
194.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
194.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
194.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
194.8 ."
194.9 ." This code is free software; you can redistribute it and/or modify it
194.10 @@ -19,12 +18,12 @@
194.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
194.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
194.13 ." have any questions.
194.14 -." `
194.15 -.TH java 1 "07 Aug 2006"
194.16 -." Generated by html2man
194.17 +."
194.18 +.TH java 1 "04 May 2009"
194.19 +." Generated from HTML by html2man (author: Eric Armstrong)
194.20
194.21 .LP
194.22 -.SH NAME
194.23 +.SH "Name"
194.24 java \- the Java application launcher
194.25 .LP
194.26 .SH "SYNOPSIS"
194.27 @@ -104,13 +103,21 @@
194.28 .LP
194.29 Select the Java HotSpot Client VM. A 64\-bit capable jdk currently ignores this option and instead uses the Java Hotspot Server VM.
194.30 .LP
194.31 -For default VM selection, see Server\-Class Machine Detection
194.32 +For default VM selection, see
194.33 +.na
194.34 +\f2Server\-Class Machine Detection\fP @
194.35 +.fi
194.36 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
194.37 .TP 3
194.38 \-server
194.39 .LP
194.40 Select the Java HotSpot Server VM. On a 64\-bit capable jdk only the Java Hotspot Server VM is supported so the \-server option is implicit.
194.41 .LP
194.42 -For default VM selection, see Server\-Class Machine Detection
194.43 +For default VM selection, see
194.44 +.na
194.45 +\f2Server\-Class Machine Detection\fP @
194.46 +.fi
194.47 +http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
194.48 .TP 3
194.49 \-agentlib:libname[=options]
194.50 Load native agent library \f2libname\fP, e.g.
194.51 @@ -121,10 +128,18 @@
194.52 .LP
194.53 \-agentlib:hprof=help
194.54 .LP
194.55 -For more information, see JVMTI Agent Command Line Options.
194.56 +For more information, see
194.57 +.na
194.58 +\f2JVMTI Agent Command Line Options\fP @
194.59 +.fi
194.60 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
194.61 .TP 3
194.62 \-agentpath:pathname[=options]
194.63 -Load a native agent library by full pathname. For more information, see JVMTI Agent Command Line Options.
194.64 +Load a native agent library by full pathname. For more information, see
194.65 +.na
194.66 +\f2JVMTI Agent Command Line Options\fP @
194.67 +.fi
194.68 +http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
194.69 .TP 3
194.70 \-classpath classpath
194.71 .TP 3
194.72 @@ -138,7 +153,11 @@
194.73 .br
194.74 For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
194.75 .LP
194.76 -For more information on class paths, see Setting the Class Path.
194.77 +For more information on class paths, see
194.78 +.na
194.79 +\f2Setting the Class Path\fP @
194.80 +.fi
194.81 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath.
194.82 .TP 3
194.83 \-Dproperty=value
194.84 Set a system property value.
194.85 @@ -200,7 +219,7 @@
194.86 .LP
194.87 .TP 3
194.88 \-jar
194.89 -Execute a program encapsulated in a JAR file. The first argument is the name of a JAR file instead of a startup class name. In order for this option to work, the manifest of the JAR file must contain a line of the form \f3Main\-Class: \fP\f4classname\fP. Here, \f2classname\fP identifies the class having the \f2public\ static\ void\ main(String[]\ args)\fP method that serves as your application's starting point. See the Jar tool reference page and the Jar trail of the
194.90 +Execute a program encapsulated in a JAR file. The first argument is the name of a JAR file instead of a startup class name. In order for this option to work, the manifest of the JAR file must contain a line of the form \f3Main\-Class: \fP\f4classname\fP. Here, \f2classname\fP identifies the class having the \f2public\ static\ void\ main(String[]\ args)\fP method that serves as your application's starting point. See the jar(1) and the Jar trail of the
194.91 .na
194.92 \f2Java Tutorial\fP @
194.93 .fi
194.94 @@ -208,10 +227,18 @@
194.95 .LP
194.96 When you use this option, the JAR file is the source of all user classes, and other user class path settings are ignored.
194.97 .LP
194.98 -Note that JAR files that can be run with the "java \-jar" option can have their execute permissions set so they can be run without using "java \-jar". Refer to Java Archive (JAR) Files.
194.99 +Note that JAR files that can be run with the "java \-jar" option can have their execute permissions set so they can be run without using "java \-jar". Refer to
194.100 +.na
194.101 +\f2Java Archive (JAR) Files\fP @
194.102 +.fi
194.103 +http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html.
194.104 .TP 3
194.105 \-javaagent:jarpath[=options]
194.106 -Load a Java programming language agent, see java.lang.instrument.
194.107 +Load a Java programming language agent, see
194.108 +.na
194.109 +\f2java.lang.instrument\fP @
194.110 +.fi
194.111 +http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html.
194.112 .TP 3
194.113 \-verbose
194.114 .TP 3
194.115 @@ -234,11 +261,11 @@
194.116 .nf
194.117 \f3
194.118 .fl
194.119 -\-version:"1.5.0_04 1.5*&1.5.1_02+"
194.120 +\-version:"1.6.0_13 1.6*&1.6.0_10+"
194.121 .fl
194.122 \fP
194.123 .fi
194.124 -The meaning of the above is that the class or jar file requires either version 1.5.0_02, or a version with 1.5 as a version\-id prefix and that is not less than 1.5.1_02. The exact syntax and definition of version strings may be found in Appendix A of the Java Network Launching Protocol & API Specification (JSR\-56).
194.125 +The meaning of the above is that the class or jar file requires either version 1.6.0_13, or a version with 1.6 as a version\-id prefix and that is not less than 1.6.0_10.. The exact syntax and definition of version strings may be found in Appendix A of the Java Network Launching Protocol & API Specification (JSR\-56).
194.126 .LP
194.127 For jar files, the usual preference is to specify version requirements in the jar file manifest rather than on the command line.
194.128 .LP
194.129 @@ -344,7 +371,7 @@
194.130 On Solaris 7 and Solaris 8 SPARC platforms, the upper limit for this value is approximately 4000m minus overhead amounts. On Solaris 2.6 and x86 platforms, the upper limit is approximately 2000m minus overhead amounts. On Linux platforms, the upper limit is approximately 2000m minus overhead amounts.
194.131 .TP 3
194.132 \-Xprof
194.133 -Profiles the running program, and sends profiling data to standard output. This option is provided as a utility that is useful in program development and is not intended to be be used in production systems.
194.134 +Profiles the running program, and sends profiling data to standard output. This option is provided as a utility that is useful in program development and is not intended to be used in production systems.
194.135 .LP
194.136 .TP 3
194.137 \-Xrs
194.138 @@ -392,19 +419,19 @@
194.139 .nf
194.140 \f3
194.141 .fl
194.142 -"1.5.0_03+"
194.143 +"1.6.0_10+"
194.144 .fl
194.145 \fP
194.146 .fi
194.147 .LP
194.148 -Would utilize any version greater than 1.5.0_03. This is useful for a case where an interface was introduced (or a bug fixed) in the release specified.
194.149 +Would utilize any version greater than 1.6.0_10. This is useful for a case where an interface was introduced (or a bug fixed) in the release specified.
194.150 .TP 3
194.151 3.
194.152 A version greater than an arbitrarily precise version\-id, bounded by the upper bound of that release family. For example:
194.153 .nf
194.154 \f3
194.155 .fl
194.156 -"1.5.0_03+&1.5*"
194.157 +"1.6.0_10+&1.6*"
194.158 .fl
194.159 \fP
194.160 .fi
194.161 @@ -414,11 +441,11 @@
194.162 .nf
194.163 \f3
194.164 .fl
194.165 -"1.4.2_05+&1.4* 1.5+"
194.166 +"1.6.0_10+&1.6* 1.7+"
194.167 .fl
194.168 \fP
194.169 .fi
194.170 -Similar to item 2. this is useful when a change was introduced in a release (1.5) but also made available in updates to previous releases.
194.171 +Similar to item 2. this is useful when a change was introduced in a release (1.7) but also made available in updates to previous releases.
194.172 .RE
194.173
194.174 .LP
194.175 @@ -429,22 +456,28 @@
194.176 .RS 3
194.177 .TP 2
194.178 o
194.179 -javac \- the Java programming language compiler
194.180 +javac(1)
194.181 .TP 2
194.182 o
194.183 -jdb \- Java Application Debugger
194.184 +jdb(1)
194.185 .TP 2
194.186 o
194.187 -javah \- C Header and Stub File Generator
194.188 +javah(1)
194.189 .TP 2
194.190 o
194.191 -jar \- JAR Archive Tool
194.192 +jar(1)
194.193 .TP 2
194.194 o
194.195 -The Java Extensions Framework
194.196 +.na
194.197 +\f2The Java Extensions Framework\fP @
194.198 +.fi
194.199 +http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
194.200 .TP 2
194.201 o
194.202 -Security Features.
194.203 +.na
194.204 +\f2Security Features\fP @
194.205 +.fi
194.206 +http://java.sun.com/javase/6/docs/technotes/guides/security/index.html.
194.207 .TP 2
194.208 o
194.209 .na
195.1 --- a/src/solaris/doc/sun/man/man1/javac.1 Tue May 12 15:21:55 2009 +0900
195.2 +++ b/src/solaris/doc/sun/man/man1/javac.1 Thu May 14 00:17:25 2009 -0700
195.3 @@ -1,5 +1,4 @@
195.4 -.'" t
195.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
195.6 +." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
195.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
195.8 ."
195.9 ." This code is free software; you can redistribute it and/or modify it
195.10 @@ -19,12 +18,12 @@
195.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
195.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
195.13 ." have any questions.
195.14 -." `
195.15 -.TH javac 1 "07 Aug 2006"
195.16 -." Generated by html2man
195.17 +."
195.18 +.TH javac 1 "04 May 2009"
195.19 +." Generated from HTML by html2man (author: Eric Armstrong)
195.20
195.21 .LP
195.22 -.SH NAME
195.23 +.SH "Name"
195.24 javac \- Java programming language compiler
195.25 .LP
195.26 .SH "SYNOPSIS"
195.27 @@ -34,7 +33,9 @@
195.28 .nf
195.29 \f3
195.30 .fl
195.31 -\fP\f3javac\fP [ options ] [ sourcefiles ] [ @argfiles ]
195.32 + \fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]
195.33 +.fl
195.34 +
195.35 .fl
195.36 .fi
195.37
195.38 @@ -53,6 +54,9 @@
195.39 sourcefiles
195.40 One or more source files to be compiled (such as MyClass.java).
195.41 .TP 3
195.42 +classes
195.43 +One or more classes to be processed for annotations (such as MyPackage.MyClass).
195.44 +.TP 3
195.45 @argfiles
195.46 One or more files that lists options and source files. The \f2\-J\fP options are not allowed in these files.
195.47 .RE
195.48 @@ -64,10 +68,10 @@
195.49
195.50 .LP
195.51 .LP
195.52 -The \f3javac\fP tool reads class and interface definitions, written in the Java programming language, and compiles them into bytecode class files.
195.53 +The \f3javac\fP tool reads class and interface definitions, written in the Java programming language, and compiles them into bytecode class files. It can also process annotations in Java source files and classes.
195.54 .LP
195.55 .LP
195.56 -There are two ways to pass source code filenames to \f3javac\fP:
195.57 +There are two ways to pass source code file names to \f3javac\fP:
195.58 .LP
195.59 .RS 3
195.60 .TP 2
195.61 @@ -91,46 +95,6 @@
195.62 .LP
195.63 By default, the compiler puts each class file in the same directory as its source file. You can specify a separate destination directory with \f3\-d\fP (see Options, below).
195.64 .LP
195.65 -.SH "SEARCHING FOR TYPES"
195.66 -.LP
195.67 -
195.68 -.LP
195.69 -.LP
195.70 -When compiling a source file, the compiler often needs information about a type whose definition did not appear in the source files given on the command line. The compiler needs type information for every class or interface used, extended, or implemented in the source file. This includes classes and interfaces not explicitly mentioned in the source file but which provide information through inheritance.
195.71 -.LP
195.72 -.LP
195.73 -For example, when you subclass \f3java.applet.Applet\fP, you are also using \f3Applet's\fP ancestor classes: \f3java.awt.Panel\fP, \f3java.awt.Container\fP, \f3java.awt.Component\fP, and \f3java.lang.Object\fP.
195.74 -.LP
195.75 -.LP
195.76 -When the compiler needs type information, it looks for a source file or class file which defines the type. The compiler searches for class files first in the bootstrap and extension classes, then in the user class path (which by default is the current directory). The user class path is defined by setting the \f3CLASSPATH\fP environment variable or by using the \f3\-classpath\fP command line option. (For details, see Setting the Class Path).
195.77 -.LP
195.78 -.LP
195.79 -If you set the \-sourcepath option, the compiler searches the indicated path for source files; otherwise the compiler searches the user class path for both class files and source files.
195.80 -.LP
195.81 -.LP
195.82 -You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
195.83 -.LP
195.84 -.LP
195.85 -A successful type search may produce a class file, a source file, or both. Here is how \f3javac\fP handles each situation:
195.86 -.LP
195.87 -.RS 3
195.88 -.TP 2
195.89 -o
195.90 -\f2Search produces a class file but no source file:\fP \f3javac\fP uses the class file.
195.91 -.TP 2
195.92 -o
195.93 -\f2Search produces a source file but no class file:\fP \f3javac\fP compiles the source file and uses the resulting class file.
195.94 -.TP 2
195.95 -o
195.96 -\f2Search produces both a source file and a class file:\fP \f3javac\fP determines whether the class file is out of date. If the class file is out of date, \f3javac\fP recompiles the source file and uses the updated class file. Otherwise, \f3javac\fP just uses the class file.
195.97 -.LP
195.98 -\f3javac\fP considers a class file out of date only if it is older than the source file.
195.99 -.RE
195.100 -
195.101 -.LP
195.102 -.LP
195.103 -\f3Note:\fP \ \f3javac\fP can silently compile source files not mentioned on the command line. Use the \f3\-verbose\fP option to trace automatic compilation.
195.104 -.LP
195.105 .SH "OPTIONS"
195.106 .LP
195.107
195.108 @@ -146,15 +110,24 @@
195.109 .LP
195.110 .RS 3
195.111 .TP 3
195.112 -\-classpath classpath
195.113 -Set the user class path, overriding the user class path in the \f3CLASSPATH\fP environment variable. If neither \f3CLASSPATH\fP or \f3\-classpath\fP is specified, the user class path consists of the current directory. See Setting the Class Path for more details.
195.114 +\-Akey[=value]
195.115 +Options to pass to annotation processors. These are not interpreted by javac directly, but are made available for use by individual processors. \f2key\fP should be one or more identifiers separated by ".".
195.116 +.TP 3
195.117 +\-cp path or \-classpath path
195.118 +Specify where to find user class files, and (optionally) annotation processors and source files. This classpath overrides the user class path in the \f3CLASSPATH\fP environment variable. If neither \f3CLASSPATH\fP, \f3\-cp\fP nor \f3\-classpath\fP is specified, the user class path consists of the current directory. See
195.119 +.na
195.120 +\f2Setting the Class Path\fP @
195.121 +.fi
195.122 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath for more details.
195.123 .LP
195.124 -If the \f3\-sourcepath\fP option is not specified, the user class path is searched for both source files and class files.
195.125 +If the \f3\-sourcepath\fP option is not specified, the user class path is also searched for source files.
195.126 .LP
195.127 -As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
195.128 +If the \f3\-processorpath\fP option is not specified, the classpath is also searched for annotation processors.
195.129 +.LP
195.130 +As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP.
195.131 .br
195.132 .br
195.133 -For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
195.134 +For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. \f3Note:\fP \ Depending of the configuration of your command line environment, you may have to quote the wild card character, for example, \f2javac \-cp "*.jar" MyClass.java\fP.
195.135 .TP 3
195.136 \-Djava.ext.dirs=directories
195.137 Override the location of installed extensions.
195.138 @@ -163,17 +136,17 @@
195.139 Override the location of endorsed standards path.
195.140 .TP 3
195.141 \-d directory
195.142 -Set the destination directory for class files. The destination directory must already exist; javac will not create the destination directory. If a class is part of a package, \f3javac\fP puts the class file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-d /home/myclasses\fP and the class is called \f2com.mypackage.MyClass\fP, then the class file is called \f2/home/myclasses/com/mypackage/MyClass.class\fP.
195.143 +Set the destination directory for class files. The directory must already exist; \f3javac\fP will not create it. If a class is part of a package, \f3javac\fP puts the class file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-d /home/myclasses\fP and the class is called \f2com.mypackage.MyClass\fP, then the class file is called \f2/home/myclasses/com/mypackage/MyClass.class\fP.
195.144 .LP
195.145 -If \f3\-d\fP is not specified, \f3javac\fP puts the class file in the same directory as the source file.
195.146 +If \f3\-d\fP is not specified, \f3javac\fP puts each class files in the same directory as the source file from which it was generated.
195.147 .LP
195.148 \f3Note:\fP \ The directory specified by \f3\-d\fP is not automatically added to your user class path.
195.149 .TP 3
195.150 \-deprecation
195.151 -Show a description of each use or override of a deprecated member or class. Without \f3\-deprecation\fP, \f3javac\fP shows the names of source files that use or override deprecated members or classes. \f3\-deprecation\fP is shorthand for \f3\-Xlint:deprecation\fP.
195.152 +Show a description of each use or override of a deprecated member or class. Without \f3\-deprecation\fP, \f3javac\fP shows a summary of the source files that use or override deprecated members or classes. \f3\-deprecation\fP is shorthand for \f3\-Xlint:deprecation\fP.
195.153 .TP 3
195.154 \-encoding encoding
195.155 -Set the source file encoding name, such as \f2EUC\-JP and UTF\-8.\fP. If \f3\-encoding\fP is not specified, the platform default converter is used.
195.156 +Set the source file encoding name, such as \f2EUC\-JP and UTF\-8\fP. If \f3\-encoding\fP is not specified, the platform default converter is used.
195.157 .TP 3
195.158 \-g
195.159 Generate all debugging information, including local variables. By default, only line number and source file information is generated.
195.160 @@ -198,9 +171,23 @@
195.161 \-help
195.162 Print a synopsis of standard options.
195.163 .TP 3
195.164 +\-implicit:{class,none}
195.165 +Controls the generation of class files for implicitly loaded source files. To automatically generate class files, use \f3\-implicit:class\fP. To suppress class file generation, use \f3\-implicit:none\fP. If this option is not specified, the default is to automatically generate class files. In this case, the compiler will issue a warning if any such class files are generated when also doing annotation processing. The warning will not be issued if this option is set explicitly. See Searching For Types.
195.166 +.TP 3
195.167 \-nowarn
195.168 Disable warning messages. This has the same meaning as \f3\-Xlint:none\fP.
195.169 -.LP
195.170 +.TP 3
195.171 +\-proc: {none,only}
195.172 +Controls whether annotation processing and/or compilation is done. \f3\-proc:none\fP means that compilation takes place without annotation processing. \f3\-proc:only\fP means that only annotation processing is done, without any subsequent compilation.
195.173 +.TP 3
195.174 +\-processor class1[,class2,class3...]
195.175 +Names of the annotation processors to run. This bypasses the default discovery process.
195.176 +.TP 3
195.177 +\-processorpath path
195.178 +Specify where to find annotation processors; if this option is not used, the classpath will be searched for processors.
195.179 +.TP 3
195.180 +\-s dir
195.181 +Specify the directory where to place generated source files. The directory must already exist; \f3javac\fP will not create it. If a class is part of a package, the compiler puts the source file in a subdirectory reflecting the package name, creating directories as needed. For example, if you specify \f3\-s /home/mysrc\fP and the class is called \f2com.mypackage.MyClass\fP, then the source file will be placed in \f2/home/mysrc/com/mypackage/MyClass.java\fP.
195.182 .TP 3
195.183 \-source release
195.184 Specifies the version of source code accepted. The following values for \f2release\fP are allowed:
195.185 @@ -213,20 +200,34 @@
195.186 The compiler accepts code containing assertions, which were introduced in JDK 1.4.
195.187 .TP 3
195.188 1.5
195.189 -The compiler accepts code containing generics and other language features introduced in JDK 5. This is the default.
195.190 +The compiler accepts code containing generics and other language features introduced in JDK 5.
195.191 .TP 3
195.192 5
195.193 -Synonym for 1.5
195.194 +Synonym for 1.5.
195.195 +.TP 3
195.196 +1.6
195.197 +This is the default value. No language changes were introduced in Java SE 6. However, encoding errors in source files are now reported as errors, instead of warnings, as previously.
195.198 +.TP 3
195.199 +6
195.200 +Synonym for 1.6.
195.201 +.TP 3
195.202 +1.7
195.203 +The compiler accepts code with features introduced in JDK 7.
195.204 +.TP 3
195.205 +7
195.206 +Synonym for 1.7.
195.207 .RE
195.208 -\f3Note:\fP No language changes were introduced in JDK 6, so the values \f31.6\fP and \f36\fP are not valid.
195.209 .TP 3
195.210 \-sourcepath sourcepath
195.211 Specify the source code path to search for class or interface definitions. As with the user class path, source path entries are separated by colons (\f3:\fP) and can be directories, JAR archives, or ZIP archives. If packages are used, the local path name within the directory or archive must reflect the package name.
195.212 .LP
195.213 -\f3Note:\fP \ Classes found through the classpath are subject to automatic recompilation if their sources are found.
195.214 +\f3Note:\fP \ Classes found through the classpath may be subject to automatic recompilation if their sources are also found. See Searching For Types.
195.215 .TP 3
195.216 \-verbose
195.217 -Verbose output. This includes information about each class loaded and each source file compiled.
195.218 +Verbose output. This includes information about each class loaded and each source file compiled.
195.219 +.TP 3
195.220 +\-version
195.221 +Print version information.
195.222 .TP 3
195.223 \-X
195.224 Display information about non\-standard options and exit.
195.225 @@ -246,7 +247,7 @@
195.226 .RS 3
195.227 .TP 3
195.228 \-target version
195.229 -Generate class files that target a specified version of the VM. Class files will run on the specified target and on later versions, but not on earlier versions of the VM. Valid targets are \f31.1\fP \f31.2\fP \f31.3\fP \f31.4\fP \f31.5\fP (also \f35\fP) and \f31.6\fP (also \f36\fP).
195.230 +Generate class files that target a specified version of the VM. Class files will run on the specified target and on later versions, but not on earlier versions of the VM. Valid targets are \f31.1\fP \f31.2\fP \f31.3\fP \f31.4\fP \f31.5\fP (also \f35\fP) \f31.6\fP (also \f36\fP) and \f31.7\fP (also \f37\fP).
195.231 .LP
195.232 The default for \f3\-target\fP depends on the value of \f3\-source\fP:
195.233 .RS 3
195.234 @@ -255,7 +256,10 @@
195.235 If \-source is \f3not specified\fP, the value of \-target is \f31.6\fP
195.236 .TP 2
195.237 o
195.238 -If \-source is \f31.3\fP, the value of \-target is \f31.1\fP
195.239 +If \-source is \f31.2\fP, the value of \-target is \f31.4\fP
195.240 +.TP 2
195.241 +o
195.242 +If \-source is \f31.3\fP, the value of \-target is \f31.4\fP
195.243 .TP 2
195.244 o
195.245 For \f3all other values\fP of \-source, the value of \-target is the value of \f3\-source\fP.
195.246 @@ -293,8 +297,8 @@
195.247 \-Xlint:none
195.248 Disable all warnings not mandated by the Java Language Specification.
195.249 .TP 3
195.250 -\-Xlint:\-xxx
195.251 -Disable warning \f3xxx\fP, where \f3xxx\fP is one of the warning names supported for \f3\-Xlint:xxx\fP, below
195.252 +\-Xlint:\-name
195.253 +Disable warning \f2name\fP, where \f2name\fP is one of the warning names supported for \f3\-Xlint:\fP\f2name\fP, below.
195.254 .TP 3
195.255 \-Xlint:unchecked
195.256 Give more detail for unchecked conversion warnings that are mandated by the Java Language Specification.
195.257 @@ -309,7 +313,7 @@
195.258 Warn about \f2finally\fP clauses that cannot complete normally.
195.259 .TP 3
195.260 \-Xlint:fallthrough
195.261 -Check \f2switch\fP blocks for fall\-through cases and provide a warning message for any that are found. Fall\-through cases are cases in a \f2switch\fP block, other than the last case in the block, whose code does not include a \f2break\fP statement, allowing code execution to "fall through" from that case to the next case. For example, the code following the \f2case 1\fP label in this \f2switch\fP block does not contain a \f2break\fP statement:
195.262 +Check \f2switch\fP blocks for fall\-through cases and provide a warning message for any that are found. Fall\-through cases are cases in a \f2switch\fP block, other than the last case in the block, whose code does not include a \f2break\fP statement, allowing code execution to "fall through" from that case to the next case. For example, the code following the \f2case 1\fP label in this \f2switch\fP block does not end with a \f2break\fP statement:
195.263 .RS 3
195.264
195.265 .LP
195.266 @@ -330,12 +334,14 @@
195.267 .fl
195.268 }
195.269 .fl
195.270 +
195.271 +.fl
195.272 \fP
195.273 .fi
195.274 .RE
195.275 If the \f2\-Xlint:fallthrough\fP flag were used when compiling this code, the compiler would emit a warning about "possible fall\-through into case," along with the line number of the case in question.
195.276 .TP 3
195.277 -\-Xmaxerrors number
195.278 +\-Xmaxerrs number
195.279 Set the maximum number of errors to print.
195.280 .TP 3
195.281 \-Xmaxwarns number
195.282 @@ -343,6 +349,18 @@
195.283 .TP 3
195.284 \-Xstdout filename
195.285 Send compiler messages to the named file. By default, compiler messages go to \f2System.err\fP.
195.286 +.TP 3
195.287 +\-Xprefer:{newer,source}
195.288 +Specify which file to read when both a source file and class file are found for a type. (See Searching For Types). If \f2\-Xprefer:newer\fP is used, it reads the newer of the source or class file for a type (default). If the \f2\-Xprefer:source\fP option is used, it reads source file. Use \f2\-Xprefer:source\fP when you want to be sure that any annotation processors can access annotations declared with a retention policy of \f2SOURCE\fP.
195.289 +.TP 3
195.290 +\-Xprint
195.291 +Print out textual representation of specified types for debugging purposes; perform neither annotation processing nor compilation. The format of the output may change.
195.292 +.TP 3
195.293 +\-XprintProcessorInfo
195.294 +Print information about which annotations a processor is asked to process.
195.295 +.TP 3
195.296 +\-XprintRounds
195.297 +Print information about initial and subsequent annotation processing rounds.
195.298 .RE
195.299
195.300 .LP
195.301 @@ -388,7 +406,9 @@
195.302 .nf
195.303 \f3
195.304 .fl
195.305 - C:> \fP\f3javac @argfile\fP
195.306 + % \fP\f3javac @argfile\fP
195.307 +.fl
195.308 +
195.309 .fl
195.310 .fi
195.311
195.312 @@ -412,7 +432,9 @@
195.313 .fl
195.314 \-g
195.315 .fl
195.316 - \-sourcepath \\java\\pubs\\ws\\1.3\\src\\share\\classes
195.317 + \-sourcepath /java/pubs/ws/1.3/src/share/classes
195.318 +.fl
195.319 +
195.320 .fl
195.321 \fP
195.322 .fi
195.323 @@ -430,18 +452,22 @@
195.324 .fl
195.325 MyClass3.java
195.326 .fl
195.327 +
195.328 +.fl
195.329 \fP
195.330 .fi
195.331
195.332 .LP
195.333 .LP
195.334 -You would then run javac with:
195.335 +You would then run \f3javac\fP with:
195.336 .LP
195.337 .nf
195.338 \f3
195.339 .fl
195.340 % \fP\f3javac @options @classes\fP
195.341 .fl
195.342 +
195.343 +.fl
195.344 .fi
195.345
195.346 .LP
195.347 @@ -456,11 +482,119 @@
195.348 .fl
195.349 % \fP\f3javac @path1/options @path2/classes\fP
195.350 .fl
195.351 +
195.352 +.fl
195.353 .fi
195.354
195.355 .LP
195.356 +.SH "ANNOTATION PROCESSING"
195.357 +.LP
195.358 +
195.359 +.LP
195.360 +.LP
195.361 +\f3javac\fP provides direct support for annotation processing, superseding the need for the separate annotation processing tool, \f3apt\fP.
195.362 +.LP
195.363 +.LP
195.364 +The API for annotation processors is defined in the \f2javax.annotation.processing\fP and \f2javax.lang.model\fP packages and subpackages.
195.365 +.LP
195.366 +.SS
195.367 +Overview of annotation processing
195.368 +.LP
195.369 +.LP
195.370 +Unless annotation processing is disabled with the \f3\-proc:none\fP option, the compiler searches for any annotation processors that are available. The search path can be specified with the \f3\-processorpath\fP option; if it is not given, the user class path is used. Processors are located by means of service provider\-configuration files named
195.371 +.br
195.372 +\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
195.373 +.br
195.374 +on the search path. Such files should contain the names of any annotation processors to be used, listed one per line. Alternatively, processors can be specified explicitly, using the \f3\-processor\fP option.
195.375 +.LP
195.376 +.LP
195.377 +After scanning the source files and classes on the command line to determine what annotations are present, the compiler queries the processors to determine what annotations they process. When a match is found, the processor will be invoked. A processor may "claim" the annotations it processes, in which case no further attempt is made to find any processors for those annotations. Once all annotations have been claimed, the compiler does not look for additional processors.
195.378 +.LP
195.379 +.LP
195.380 +If any processors generate any new source files, another round of annotation processing will occur: any newly generated source files will be scanned, and the annotations processed as before. Any processors invoked on previous rounds will also be invoked on all subsequent rounds. This continues until no new source files are generated.
195.381 +.LP
195.382 +.LP
195.383 +After a round occurs where no new source files are generated, the annotation processors will be invoked one last time, to give them a chance to complete any work they may need to do. Finally, unless the \f3\-proc:only\fP option is used, the compiler will compile the original and all the generated source files.
195.384 +.LP
195.385 +.SS
195.386 +Implicitly loaded source files
195.387 +.LP
195.388 +.LP
195.389 +To compile a set of source files, the compiler may need to implicitly load additional source files. (See Searching For Types). Such files are currently not subject to annotation processing. By default, the compiler will give a warning if annotation processing has occurred and any implicitly loaded source files are compiled. See the \-implicit option for ways to suppress the warning.
195.390 +.LP
195.391 +.SH "SEARCHING FOR TYPES"
195.392 +.LP
195.393 +
195.394 +.LP
195.395 +.LP
195.396 +When compiling a source file, the compiler often needs information about a type whose definition did not appear in the source files given on the command line. The compiler needs type information for every class or interface used, extended, or implemented in the source file. This includes classes and interfaces not explicitly mentioned in the source file but which provide information through inheritance.
195.397 +.LP
195.398 +.LP
195.399 +For example, when you subclass \f3java.applet.Applet\fP, you are also using \f3Applet's\fP ancestor classes: \f3java.awt.Panel\fP, \f3java.awt.Container\fP, \f3java.awt.Component\fP, and \f3java.lang.Object\fP.
195.400 +.LP
195.401 +.LP
195.402 +When the compiler needs type information, it looks for a source file or class file which defines the type. The compiler searches for class files first in the bootstrap and extension classes, then in the user class path (which by default is the current directory). The user class path is defined by setting the \f3CLASSPATH\fP environment variable or by using the \f3\-classpath\fP command line option. (For details, see
195.403 +.na
195.404 +\f2Setting the Class Path\fP @
195.405 +.fi
195.406 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath).
195.407 +.LP
195.408 +.LP
195.409 +If you set the \-sourcepath option, the compiler searches the indicated path for source files; otherwise the compiler searches the user class path for both class files and source files.
195.410 +.LP
195.411 +.LP
195.412 +You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
195.413 +.LP
195.414 +.LP
195.415 +A successful type search may produce a class file, a source file, or both. If both are found, you can use the \-Xprefer option to instruct the compiler which to use. If \f3newer\fP is given, the compiler will use the newer of the two files. If \f3source\fP is given, it will use the source file. The default is \f3newer\fP.
195.416 +.LP
195.417 +.LP
195.418 +If a type search finds a source file for a required type, either by itself, or as a result of the setting for \f3\-Xprefer\fP, the compiler will read the source file to get the information it needs. In addition, it will by default compile the source file as well. You can use the \-implicit option to specify the behavior. If \f3none\fP is given, no class files will be generated for the source file. If \f3class\fP is given, class files will be generated for the source file.
195.419 +.LP
195.420 +.LP
195.421 +The compiler may not discover the need for some type information until after annotation processing is complete. If the type information is found in a source file and no \f3\-implicit\fP option is given, the compiler will give a warning that the file is being compiled without being subject to annotation processing. To disable the warning, either specify the file on the command line (so that it will be subject to annotation processing) or use the \f3\-implicit\fP option to specify whether or not class files should be generated for such source files.
195.422 +.LP
195.423 .SH "PROGRAMMATIC INTERFACE"
195.424 .LP
195.425 +
195.426 +.LP
195.427 +.LP
195.428 +\f3javac\fP supports the new Java Compiler API defined by the classes and interfaces in the \f2javax.tools\fP package.
195.429 +.LP
195.430 +.SS
195.431 +Example
195.432 +.LP
195.433 +.LP
195.434 +To perform a compilation using arguments as you would give on the command line, you can use the following:
195.435 +.LP
195.436 +.nf
195.437 +\f3
195.438 +.fl
195.439 +JavaCompiler javac = ToolProvider.getSystemJavaCompiler();
195.440 +.fl
195.441 +int rc = javac.run(null, null, null, args);
195.442 +.fl
195.443 +
195.444 +.fl
195.445 +\fP
195.446 +.fi
195.447 +
195.448 +.LP
195.449 +.LP
195.450 +This will write any diagnostics to the standard output stream, and return the exit code that \f3javac\fP would give when invoked from the command line.
195.451 +.LP
195.452 +.LP
195.453 +You can use other methods on the \f2javax.tools.JavaCompiler\fP interface to handle diagnostics, control where files are read from and written to, and so on.
195.454 +.LP
195.455 +.SS
195.456 +Old Interface
195.457 +.LP
195.458 +.RS 3
195.459 +
195.460 +.LP
195.461 +.LP
195.462 +\f3Note:\fP \ This API is retained for backwards compatibility only; all new code should use the Java Compiler API, described above.
195.463 +.LP
195.464 .LP
195.465 The \f2com.sun.tools.javac.Main\fP class provides two static methods to invoke the compiler from a program:
195.466 .LP
195.467 @@ -471,6 +605,8 @@
195.468 .fl
195.469 public static int compile(String[] args, PrintWriter out);
195.470 .fl
195.471 +
195.472 +.fl
195.473 \fP
195.474 .fi
195.475
195.476 @@ -482,11 +618,12 @@
195.477 The \f2out\fP parameter indicates where the compiler's diagnostic output is directed.
195.478 .LP
195.479 .LP
195.480 -The return value is equivalent to the exit value from javac.
195.481 +The return value is equivalent to the exit value from \f3javac\fP.
195.482 .LP
195.483 .LP
195.484 Note that all \f3other\fP classes and methods found in a package whose name starts with \f2com.sun.tools.javac\fP (informally known as sub\-packages of \f2com.sun.tools.javac\fP) are strictly internal and subject to change at any time.
195.485 .LP
195.486 +.RE
195.487 .SH "EXAMPLES"
195.488 .LP
195.489 .SS
195.490 @@ -546,6 +683,8 @@
195.491 .fl
195.492 Hello Everyone
195.493 .fl
195.494 +
195.495 +.fl
195.496 .fi
195.497 .RE
195.498
195.499 @@ -584,6 +723,8 @@
195.500 .fl
195.501
195.502 .fl
195.503 +
195.504 +.fl
195.505 .fi
195.506 .RE
195.507
195.508 @@ -610,6 +751,8 @@
195.509 .fl
195.510 % \f3javac greetings/Hi.java\fP
195.511 .fl
195.512 +
195.513 +.fl
195.514 .fi
195.515 .RE
195.516
195.517 @@ -625,6 +768,8 @@
195.518 .fl
195.519 % \fP\f3javac \-classpath /examples /examples/greetings/Hi.java\fP
195.520 .fl
195.521 +
195.522 +.fl
195.523 .fi
195.524 .RE
195.525
195.526 @@ -638,9 +783,11 @@
195.527 .nf
195.528 \f3
195.529 .fl
195.530 -% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
195.531 +% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
195.532 .fl
195.533 - /examples/greetings/Hi.java\fP
195.534 + /examples/greetings/Hi.java\fP
195.535 +.fl
195.536 +
195.537 .fl
195.538 .fi
195.539 .RE
195.540 @@ -657,6 +804,8 @@
195.541 .fl
195.542 % \fP\f3java \-classpath /examples:/lib/Banners.jar greetings.Hi\fP
195.543 .fl
195.544 +
195.545 +.fl
195.546 .fi
195.547 .RE
195.548
195.549 @@ -695,9 +844,9 @@
195.550 .fl
195.551 % \f3ls classes\fP
195.552 .fl
195.553 -% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
195.554 +% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
195.555 .fl
195.556 - src/farewells/GoodBye.java \-d classes\fP
195.557 + src/farewells/GoodBye.java \-d classes\fP
195.558 .fl
195.559 % \f3ls classes\fP
195.560 .fl
195.561 @@ -709,6 +858,8 @@
195.562 .fl
195.563
195.564 .fl
195.565 +
195.566 +.fl
195.567 .fi
195.568 .RE
195.569
195.570 @@ -724,7 +875,7 @@
195.571
195.572 .LP
195.573 .LP
195.574 -Here we use \f3javac\fP to compile code that will run on a 1.4 VM.
195.575 +Here we use \f3javac\fP to compile code that will run on a 1.7 VM.
195.576 .LP
195.577 .RS 3
195.578
195.579 @@ -732,19 +883,21 @@
195.580 .nf
195.581 \f3
195.582 .fl
195.583 -% \fP\f3javac \-target 1.4 \-bootclasspath jdk1.4.2/lib/classes.zip \\
195.584 +% \fP\f3javac \-target 1.7 \-bootclasspath jdk1.7.0/lib/rt.jar \\
195.585 .fl
195.586 - \-extdirs "" OldCode.java\fP
195.587 + \-extdirs "" OldCode.java\fP
195.588 +.fl
195.589 +
195.590 .fl
195.591 .fi
195.592 .RE
195.593
195.594 .LP
195.595 .LP
195.596 -The \f3\-target 1.4\fP option ensures that the generated class files will be compatible with 1.4 VMs. By default, \f3javac\fP compiles for JDK 6.
195.597 +The \f3\-target 1.7\fP option ensures that the generated class files will be compatible with 1.7 VMs. By default, \f3javac\fP compiles for JDK 6.
195.598 .LP
195.599 .LP
195.600 -The Java Platform JDK's \f3javac\fP would also by default compile against its own bootstrap classes, so we need to tell \f3javac\fP to compile against JDK 1.4 bootstrap classes instead. We do this with \f3\-bootclasspath\fP and \f3\-extdirs\fP. Failing to do this might allow compilation against a Java Platform API that would not be present on a 1.4 VM and would fail at runtime.
195.601 +The Java Platform JDK's \f3javac\fP would also by default compile against its own bootstrap classes, so we need to tell \f3javac\fP to compile against JDK 1.7 bootstrap classes instead. We do this with \f3\-bootclasspath\fP and \f3\-extdirs\fP. Failing to do this might allow compilation against a Java Platform API that would not be present on a 1.7 VM and would fail at runtime.
195.602 .LP
195.603 .RE
195.604 .SH "SEE ALSO"
195.605 @@ -754,22 +907,28 @@
195.606 .RS 3
195.607 .TP 2
195.608 o
195.609 -java \- the Java Application Launcher
195.610 +.na
195.611 +\f2The javac Guide\fP @
195.612 +.fi
195.613 +http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
195.614 .TP 2
195.615 o
195.616 -jdb \- Java Application Debugger
195.617 +java(1) \- the Java Application Launcher
195.618 .TP 2
195.619 o
195.620 -javah \- C Header and Stub File Generator
195.621 +jdb(1) \- Java Application Debugger
195.622 .TP 2
195.623 o
195.624 -javap \- Class File Disassembler
195.625 +javah(1) \- C Header and Stub File Generator
195.626 .TP 2
195.627 o
195.628 -javadoc \- API Documentation Generator
195.629 +javap(1) \- Class File Disassembler
195.630 .TP 2
195.631 o
195.632 -jar \- JAR Archive Tool
195.633 +javadoc(1) \- API Documentation Generator
195.634 +.TP 2
195.635 +o
195.636 +jar(1) \- JAR Archive Tool
195.637 .TP 2
195.638 o
195.639 .na
196.1 --- a/src/solaris/doc/sun/man/man1/javadoc.1 Tue May 12 15:21:55 2009 +0900
196.2 +++ b/src/solaris/doc/sun/man/man1/javadoc.1 Thu May 14 00:17:25 2009 -0700
196.3 @@ -1,5 +1,4 @@
196.4 -.'" t
196.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
196.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
196.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
196.8 ."
196.9 ." This code is free software; you can redistribute it and/or modify it
196.10 @@ -19,10 +18,10 @@
196.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
196.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
196.13 ." have any questions.
196.14 -." `
196.15 -.TH javadoc 1 "07 Aug 2006"
196.16 -." Generated by html2man
196.17 -.SH NAME
196.18 +."
196.19 +.TH javadoc 1 "04 May 2009"
196.20 +." Generated from HTML by html2man (author: Eric Armstrong)
196.21 +.SH "Name"
196.22 javadoc \- The Java API Documentation Generator
196.23 .RS 3
196.24
196.25 @@ -151,7 +150,11 @@
196.26 In many cases, the Javadoc tool allows you to generate documentation for source files whose code is incomplete or erroneous. This is a benefit that enables you to generate documentation before all debugging and troubleshooting is done. For example, according to the \f2Java Language Specification\fP, a class that contains an abstract method should itself be declared abstract. The Javadoc tool does not check for this, and would proceed without a warning, whereas the javac compiler stops on this error. The Javadoc tool does do some primitive checking of doc comments. Use the DocCheck doclet to check the doc comments more thoroughly.
196.27 .LP
196.28 .LP
196.29 -When the Javadoc tool builds its internal structure for the documentation, it loads all referenced classes. Because of this, the Javadoc tool must be able to find all referenced classes, whether bootstrap classes, extensions, or user classes. For more about this, see How Classes Are Found. Generally speaking, classes you create must either be loaded as an extension or in the Javadoc tool's class path.
196.30 +When the Javadoc tool builds its internal structure for the documentation, it loads all referenced classes. Because of this, the Javadoc tool must be able to find all referenced classes, whether bootstrap classes, extensions, or user classes. For more about this, see
196.31 +.na
196.32 +\f2How Classes Are Found\fP @
196.33 +.fi
196.34 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html. Generally speaking, classes you create must either be loaded as an extension or in the Javadoc tool's class path.
196.35 .LP
196.36 .SS
196.37 Javadoc Doclets
196.38 @@ -162,7 +165,10 @@
196.39 .RS 3
196.40 .TP 2
196.41 o
196.42 -Javadoc Doclets
196.43 +.na
196.44 +\f2Javadoc Doclets\fP @
196.45 +.fi
196.46 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
196.47 .TP 2
196.48 o
196.49 The \f2\-doclet\fP command\-line option
196.50 @@ -178,7 +184,10 @@
196.51 .RS 3
196.52 .TP 2
196.53 o
196.54 -Javadoc Enhancements for details about improvements added in Javadoc.
196.55 +.na
196.56 +\f2Javadoc Enhancements\fP @
196.57 +.fi
196.58 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html for details about improvements added in Javadoc.
196.59 .TP 2
196.60 o
196.61 .na
196.62 @@ -196,7 +205,7 @@
196.63 .na
196.64 \f2Requirements for Writing API Specifications\fP @
196.65 .fi
196.66 -http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Standard requirements used when writing the Java 2 Platform Specification. It can be useful whether you are writing API specifications in source file documentation comments or in other formats. It covers requirements for packages, classes, interfaces, fields and methods to satisfy testable assertions.
196.67 +http://java.sun.com/j2se/javadoc/writingapispecs/index.html \- Standard requirements used when writing the Java SE Platform Specification. It can be useful whether you are writing API specifications in source file documentation comments or in other formats. It covers requirements for packages, classes, interfaces, fields and methods to satisfy testable assertions.
196.68 .TP 2
196.69 o
196.70 .na
196.71 @@ -282,7 +291,7 @@
196.72 .RS 3
196.73 .TP 2
196.74 o
196.75 -\f2package\-info.java\fP \- Can contain a package declaration, package annotations, package comments and Javadoc tags. This file is new in JDK 5.0, and is preferred over package.html.
196.76 +\f2package\-info.java\fP \- Can contain a package declaration, package annotations, package comments and Javadoc tags. This file is generally preferred over package.html.
196.77 .TP 2
196.78 o
196.79 \f2package.html\fP \- Can contain only package comments and Javadoc tags, no package annotations.
196.80 @@ -293,7 +302,7 @@
196.81 A package may have a single \f2package.html\fP file or a single \f2package\-info.java\fP file but not both. Place either file in the package directory in the source tree along with your \f2.java\fP files.
196.82 .LP
196.83 .LP
196.84 -\f4package\-info.java\fP This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
196.85 +\f4package\-info.java\fP \- This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
196.86 .LP
196.87 .LP
196.88 File: \f2java/applet/package\-info.java\fP
196.89 @@ -386,7 +395,7 @@
196.90 .nr 40 \n(79+(0*\n(38)
196.91 .nr 80 +\n(40
196.92 .nr TW \n(80
196.93 -.if t .if \n(TW>\n(.li .tm Table at line 326 file Input is too wide - \n(TW units
196.94 +.if t .if \n(TW>\n(.li .tm Table at line 353 file Input is too wide - \n(TW units
196.95 .fc
196.96 .nr #T 0-1
196.97 .nr #a 0-1
196.98 @@ -520,7 +529,7 @@
196.99 .nr 40 \n(79+(0*\n(38)
196.100 .nr 80 +\n(40
196.101 .nr TW \n(80
196.102 -.if t .if \n(TW>\n(.li .tm Table at line 379 file Input is too wide - \n(TW units
196.103 +.if t .if \n(TW>\n(.li .tm Table at line 406 file Input is too wide - \n(TW units
196.104 .fc
196.105 .nr #T 0-1
196.106 .nr #a 0-1
196.107 @@ -578,10 +587,18 @@
196.108 Processes any package tags that are present.
196.109 .TP 2
196.110 o
196.111 -Inserts the processed text at the bottom of the package summary page it generates, as shown in Package Summary.
196.112 +Inserts the processed text at the bottom of the package summary page it generates, as shown in
196.113 +.na
196.114 +\f2Package Summary\fP @
196.115 +.fi
196.116 +http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html.
196.117 .TP 2
196.118 o
196.119 -Copies the first sentence of the package comment to the top of the package summary page. It also adds the package name and this first sentence to the list of packages on the overview page, as shown in Overview Summary. The end\-of\-sentence is determined by the same rules used for the end of the first sentence of class and member main descriptions.
196.120 +Copies the first sentence of the package comment to the top of the package summary page. It also adds the package name and this first sentence to the list of packages on the overview page, as shown in
196.121 +.na
196.122 +\f2Overview Summary\fP @
196.123 +.fi
196.124 +http://java.sun.com/javase/6/docs/api/overview\-summary.html. The end\-of\-sentence is determined by the same rules used for the end of the first sentence of class and member main descriptions.
196.125 .RE
196.126
196.127 .LP
196.128 @@ -612,7 +629,11 @@
196.129 Processes any overview tags that are present.
196.130 .TP 2
196.131 o
196.132 -Inserts the processed text at the bottom of the overview page it generates, as shown in Overview Summary.
196.133 +Inserts the processed text at the bottom of the overview page it generates, as shown in
196.134 +.na
196.135 +\f2Overview Summary\fP @
196.136 +.fi
196.137 +http://java.sun.com/javase/6/docs/api/overview\-summary.html.
196.138 .TP 2
196.139 o
196.140 Copies the first sentence of the overview comment to the top of the overview summary page.
196.141 @@ -905,7 +926,7 @@
196.142
196.143 .LP
196.144 .SS
196.145 -a name="generatedapideclarations"/> Generated API Declarations
196.146 +Generated API Declarations
196.147 .LP
196.148 .LP
196.149 The Javadoc tool generates a declaration at the start of each class, interface, field, constructor, and method description for that API item. For example, the declaration for the \f2Boolean\fP class is:
196.150 @@ -1330,7 +1351,7 @@
196.151 .nr 41 \n(80+(3*\n(38)
196.152 .nr 81 +\n(41
196.153 .nr TW \n(81
196.154 -.if t .if \n(TW>\n(.li .tm Table at line 1084 file Input is too wide - \n(TW units
196.155 +.if t .if \n(TW>\n(.li .tm Table at line 1123 file Input is too wide - \n(TW units
196.156 .fc
196.157 .nr #T 0-1
196.158 .nr #a 0-1
196.159 @@ -1453,19 +1474,30 @@
196.160
196.161 .LP
196.162 .LP
196.163 -Note: Starting with JDK 5.0, you can deprecate a program element using the @Deprecated annotation.
196.164 +Note: You can deprecate a program element using the
196.165 +.na
196.166 +\f2@Deprecated annotation\fP @
196.167 +.fi
196.168 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html.
196.169 .LP
196.170 .RE
196.171 -.LP
196.172 -Adds a comment indicating that this API should no longer be used (even though it may continue to work). The Javadoc tool moves the \f2deprecated\-text\fP ahead of the main description, placing it in italics and preceding it with a bold warning: "Deprecated". This tag is valid in all doc comments: overview, package, class, interface, constructor, method and field.
196.173 -.LP
196.174 -The first sentence of \f2deprecated\-text\fP should at least tell the user when the API was deprecated and what to use as a replacement. The Javadoc tool copies just the first sentence to the summary section and index. Subsequent sentences can also explain why it has been deprecated. You should include a \f2{@link}\fP tag (for Javadoc 1.2 or later) that points to the replacement API:
196.175 +.RE
196.176 +.RS 3
196.177 +
196.178 +.LP
196.179 +.LP
196.180 +Adds a comment indicating that this API should no longer be used (even though it may continue to work). The Javadoc tool moves the \f2deprecated\-text\fP ahead of the main description, placing it in italics and preceding it with a bold warning: "Deprecated". This tag is valid in all doc comments: overview, package, class, interface, constructor, method and field.
196.181 +.LP
196.182 +.LP
196.183 +The first sentence of \f2deprecated\-text\fP should at least tell the user when the API was deprecated and what to use as a replacement. The Javadoc tool copies just the first sentence to the summary section and index. Subsequent sentences can also explain why it has been deprecated. You should include a \f2{@link}\fP tag (for Javadoc 1.2 or later) that points to the replacement API:
196.184 +.LP
196.185 .LP
196.186 For more details, see
196.187 .na
196.188 \f2writing @deprecated tags\fP @
196.189 .fi
196.190 -http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
196.191 +http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
196.192 +.LP
196.193 .RS 3
196.194 .TP 2
196.195 o
196.196 @@ -1479,15 +1511,28 @@
196.197 .fl
196.198 */
196.199 .fl
196.200 +
196.201 +.fl
196.202 \fP
196.203 .fi
196.204 .TP 2
196.205 o
196.206 For Javadoc 1.1, the standard format is to create a \f2@see\fP tag (which cannot be in\-line) for each \f2@deprecated\fP tag.
196.207 .RE
196.208 -.LP
196.209 -For more about deprecation, see The @deprecated tag.
196.210 -.LP
196.211 +
196.212 +.LP
196.213 +.LP
196.214 +For more about deprecation, see
196.215 +.na
196.216 +\f2The @deprecated tag\fP @
196.217 +.fi
196.218 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.html.
196.219 +.LP
196.220 +.LP
196.221 +
196.222 +.LP
196.223 +.RE
196.224 +.RS 3
196.225 .TP 3
196.226 {@code\ text}
196.227 Equivalent to \f2<code>{@literal}</code>\fP.
196.228 @@ -1498,16 +1543,22 @@
196.229 .fl
196.230 \fP\f4{@code A<B>C}\fP\f3
196.231 .fl
196.232 +
196.233 +.fl
196.234 \fP
196.235 .fi
196.236 +.LP
196.237 displays in the generated HTML page unchanged, as:
196.238 .nf
196.239 \f3
196.240 .fl
196.241 \fP\f4A<B>C\fP\f3
196.242 .fl
196.243 +
196.244 +.fl
196.245 \fP
196.246 .fi
196.247 +.LP
196.248 The noteworthy point is that the \f2<B>\fP is not interpreted as bold and is in code font.
196.249 .LP
196.250 If you want the same functionality without the code font, use \f2{@literal}\fP.
196.251 @@ -1526,9 +1577,12 @@
196.252 .fl
196.253 javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
196.254 .fl
196.255 +
196.256 +.fl
196.257 \fP
196.258 .fi
196.259 -NOTE \- When using \f2{@docRoot}\fP this way in a make file, some makefile programs require special escaping for the brace {} characters. For example, the Inprise MAKE version 5.2 running on Windows requires double braces: \f2{{@docRoot}}\fP. It also requires double (rather than single) quotes to enclose arguments to options such as \f2\-bottom\fP (with the quotes around the \f2href\fP argument omitted).
196.260 +.LP
196.261 +NOTE \- When using \f2{@docRoot}\fP this way in a make file, some makefile programs require special escaping for the brace {} characters. For example, the Inprise MAKE version 5.2 running on Windows requires double braces: \f2{{@docRoot}}\fP. It also requires double (rather than single) quotes to enclose arguments to options such as \f2\-bottom\fP (with the quotes around the \f2href\fP argument omitted).
196.262 .TP 3
196.263 2.
196.264 In a doc comment:
196.265 @@ -1541,31 +1595,42 @@
196.266 .fl
196.267 */
196.268 .fl
196.269 +
196.270 +.fl
196.271 \fP
196.272 .fi
196.273 .RE
196.274 +.LP
196.275 The reason this tag is needed is because the generated docs are in hierarchical directories, as deep as the number of subpackages. This expression:
196.276 .nf
196.277 \f3
196.278 .fl
196.279 <a href="{@docRoot}/copyright.html">
196.280 .fl
196.281 +
196.282 +.fl
196.283 \fP
196.284 .fi
196.285 +.LP
196.286 would resolve to:
196.287 .nf
196.288 \f3
196.289 .fl
196.290 <a href="../../copyright.html"> for java/lang/Object.java
196.291 .fl
196.292 +
196.293 +.fl
196.294 \fP
196.295 .fi
196.296 +.LP
196.297 and
196.298 .nf
196.299 \f3
196.300 .fl
196.301 <a href="../../../copyright.html"> for java/lang/ref/Reference.java
196.302 .fl
196.303 +
196.304 +.fl
196.305 \fP
196.306 .fi
196.307 .LP
196.308 @@ -1603,24 +1668,33 @@
196.309 .fl
196.310 Use the {@link #getComponentAt(int, int) getComponentAt} method.
196.311 .fl
196.312 +
196.313 +.fl
196.314 \fP
196.315 .fi
196.316 +.LP
196.317 From this, the standard doclet would generate the following HTML (assuming it refers to another class in the same package):
196.318 .nf
196.319 \f3
196.320 .fl
196.321 Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method.
196.322 .fl
196.323 +
196.324 +.fl
196.325 \fP
196.326 .fi
196.327 +.LP
196.328 Which appears on the web page as:
196.329 .nf
196.330 \f3
196.331 .fl
196.332 Use the getComponentAt method.
196.333 .fl
196.334 +
196.335 +.fl
196.336 \fP
196.337 .fi
196.338 +.LP
196.339 You can extend \f2{@link}\fP to link to classes not being documented by using the \f2\-link\fP option.
196.340 .LP
196.341 For more details, see
196.342 @@ -1637,14 +1711,20 @@
196.343 .fl
196.344 Refer to {@linkplain add() the overridden method}.
196.345 .fl
196.346 +
196.347 +.fl
196.348 \fP
196.349 .fi
196.350 +.LP
196.351 This would display as:
196.352 .RS 3
196.353 +
196.354 +.LP
196.355 .LP
196.356 Refer to the overridden method.
196.357 .LP
196.358 .RE
196.359 +.LP
196.360 .TP 3
196.361 {@literal\ text}
196.362 Displays \f2text\fP without interpreting the text as HTML markup or nested javadoc tags. This enables you to use regular angle brackets (\f2<\fP and \f2>\fP) instead of the HTML entities (\f2<\fP and \f2>\fP) in doc comments, such as in parameter types (\f2<Object>\fP), inequalities (\f23 < 4\fP), or arrows (\f2<\-\fP). For example, the doc comment text:
196.363 @@ -1653,11 +1733,16 @@
196.364 .fl
196.365 \fP\f4{@literal A<B>C}\fP\f3
196.366 .fl
196.367 +
196.368 +.fl
196.369 \fP
196.370 .fi
196.371 +.LP
196.372 displays unchanged in the generated HTML page in your browser, as:
196.373 .LP
196.374 -\f2\ \ \ \ \ \fPA<B>C The noteworthy point is that the \f2<B>\fP is not interpreted as bold (and it is not in code font).
196.375 +\f2\ \ \ \ \ \fPA<B>C
196.376 +.LP
196.377 +The noteworthy point is that the \f2<B>\fP is not interpreted as bold (and it is not in code font).
196.378 .LP
196.379 If you want the same functionality but with the text in code font, use \f2{@code}\fP.
196.380 .LP
196.381 @@ -1681,6 +1766,8 @@
196.382 .fl
196.383 }
196.384 .fl
196.385 +
196.386 +.fl
196.387 \fP
196.388 .fi
196.389 .LP
196.390 @@ -1704,8 +1791,11 @@
196.391 .fl
196.392 }
196.393 .fl
196.394 +
196.395 +.fl
196.396 \fP
196.397 .fi
196.398 +.LP
196.399 For more details, see
196.400 .na
196.401 \f2writing @param tags\fP @
196.402 @@ -1734,15 +1824,26 @@
196.403 .fl
196.404 @see "The Java Programming Language"
196.405 .fl
196.406 +
196.407 +.fl
196.408 \fP
196.409 .fi
196.410 -This generates text such as:
196.411 +.LP
196.412 +This generates text such as:
196.413 +.RE
196.414 +.RE
196.415 +.RS 3
196.416 +.RS 3
196.417 +.RS 3
196.418 +
196.419 +.LP
196.420 .RS 3
196.421 .RS 3
196.422 .TP 3
196.423 See Also:
196.424 "The Java Programming Language"
196.425 .RE
196.426 +.RE
196.427
196.428 .LP
196.429 .RE
196.430 @@ -1979,7 +2080,7 @@
196.431 .nr 40 \n(79+(0*\n(38)
196.432 .nr 80 +\n(40
196.433 .nr TW \n(80
196.434 -.if t .if \n(TW>\n(.li .tm Table at line 1547 file Input is too wide - \n(TW units
196.435 +.if t .if \n(TW>\n(.li .tm Table at line 1666 file Input is too wide - \n(TW units
196.436 .fc
196.437 .nr #T 0-1
196.438 .nr #a 0-1
196.439 @@ -2325,7 +2426,7 @@
196.440 .nr 42 \n(81+(3*\n(38)
196.441 .nr 82 +\n(42
196.442 .nr TW \n(82
196.443 -.if t .if \n(TW>\n(.li .tm Table at line 1623 file Input is too wide - \n(TW units
196.444 +.if t .if \n(TW>\n(.li .tm Table at line 1742 file Input is too wide - \n(TW units
196.445 .fc
196.446 .nr #T 0-1
196.447 .nr #a 0-1
196.448 @@ -2500,6 +2601,14 @@
196.449 .fi
196.450 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@see.
196.451 .RE
196.452 +.RE
196.453 +.RS 3
196.454 +
196.455 +.LP
196.456 +.LP
196.457 +
196.458 +.LP
196.459 +.RS 3
196.460 .TP 3
196.461 @serial\ field\-description | include | exclude
196.462 Used in the doc comment for a default serializable field.
196.463 @@ -2522,7 +2631,11 @@
196.464 .LP
196.465 The tag @serial at a class level overrides @serial at a package level.
196.466 .LP
196.467 -For more information about how to use these tags, along with an example, see "Documenting Serializable Fields and Data for a Class," Section 1.6 of the \f2Java Object Serialization Specification\fP. Also see the
196.468 +For more information about how to use these tags, along with an example, see "
196.469 +.na
196.470 +\f2Documenting Serializable Fields and Data for a Class\fP @
196.471 +.fi
196.472 +http://java.sun.com/javase/6/docs/platform/serialization/spec/serial\-arch.html," Section 1.6 of the \f2Java Object Serialization Specification\fP. Also see the
196.473 .na
196.474 \f2Serialization FAQ\fP @
196.475 .fi
196.476 @@ -2550,8 +2663,11 @@
196.477 .fl
196.478 @since 1.5
196.479 .fl
196.480 +
196.481 +.fl
196.482 \fP
196.483 .fi
196.484 +.LP
196.485 For source code in the Java platform, this tag indicates the version of the Java platform API specification (not necessarily when it was added to the reference implementation). Multiple @since tags are allowed and are treated like multiple @author tags. You could use multiple tags if the prgram element is used by more than one API.
196.486 .LP
196.487 .TP 3
196.488 @@ -2582,8 +2698,11 @@
196.489 .fl
196.490 public static final String SCRIPT_START = "<script>"
196.491 .fl
196.492 +
196.493 +.fl
196.494 \fP
196.495 .fi
196.496 +.LP
196.497 When used with argument \f2package.class#field\fP in any doc comment, it displays the value of the specified constant:
196.498 .nf
196.499 \f3
196.500 @@ -2598,11 +2717,18 @@
196.501 .fl
196.502 }
196.503 .fl
196.504 +
196.505 +.fl
196.506 \fP
196.507 .fi
196.508 +.LP
196.509 The argument \f2package.class#field\fP takes a form identical to that of the @see argument, except that the member must be a static field.
196.510 .LP
196.511 -These values of these constants are also displayed on the Constant Field Values page.
196.512 +These values of these constants are also displayed on the
196.513 +.na
196.514 +\f2Constant Field Values\fP @
196.515 +.fi
196.516 +http://java.sun.com/javase/6/docs/api/constant\-values.html page.
196.517 .LP
196.518 .TP 3
196.519 @version\ version\-text
196.520 @@ -2616,6 +2742,9 @@
196.521 .fi
196.522 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@version.
196.523 .RE
196.524 +
196.525 +.LP
196.526 +.RE
196.527 .SS
196.528 Where Tags Can Be Used
196.529 .LP
196.530 @@ -2700,7 +2829,7 @@
196.531 .nr 40 \n(79+(0*\n(38)
196.532 .nr 80 +\n(40
196.533 .nr TW \n(80
196.534 -.if t .if \n(TW>\n(.li .tm Table at line 1816 file Input is too wide - \n(TW units
196.535 +.if t .if \n(TW>\n(.li .tm Table at line 1963 file Input is too wide - \n(TW units
196.536 .fc
196.537 .nr #T 0-1
196.538 .nr #a 0-1
196.539 @@ -2817,7 +2946,7 @@
196.540 .nr 40 \n(79+(0*\n(38)
196.541 .nr 80 +\n(40
196.542 .nr TW \n(80
196.543 -.if t .if \n(TW>\n(.li .tm Table at line 1848 file Input is too wide - \n(TW units
196.544 +.if t .if \n(TW>\n(.li .tm Table at line 1995 file Input is too wide - \n(TW units
196.545 .fc
196.546 .nr #T 0-1
196.547 .nr #a 0-1
196.548 @@ -2936,7 +3065,7 @@
196.549 .nr 40 \n(79+(0*\n(38)
196.550 .nr 80 +\n(40
196.551 .nr TW \n(80
196.552 -.if t .if \n(TW>\n(.li .tm Table at line 1882 file Input is too wide - \n(TW units
196.553 +.if t .if \n(TW>\n(.li .tm Table at line 2029 file Input is too wide - \n(TW units
196.554 .fc
196.555 .nr #T 0-1
196.556 .nr #a 0-1
196.557 @@ -3096,7 +3225,7 @@
196.558 .nr 40 \n(79+(0*\n(38)
196.559 .nr 80 +\n(40
196.560 .nr TW \n(80
196.561 -.if t .if \n(TW>\n(.li .tm Table at line 1957 file Input is too wide - \n(TW units
196.562 +.if t .if \n(TW>\n(.li .tm Table at line 2104 file Input is too wide - \n(TW units
196.563 .fc
196.564 .nr #T 0-1
196.565 .nr #a 0-1
196.566 @@ -3240,7 +3369,7 @@
196.567 .nr 40 \n(79+(0*\n(38)
196.568 .nr 80 +\n(40
196.569 .nr TW \n(80
196.570 -.if t .if \n(TW>\n(.li .tm Table at line 2016 file Input is too wide - \n(TW units
196.571 +.if t .if \n(TW>\n(.li .tm Table at line 2163 file Input is too wide - \n(TW units
196.572 .fc
196.573 .nr #T 0-1
196.574 .nr #a 0-1
196.575 @@ -3323,6 +3452,8 @@
196.576 .LP
196.577 .SH "OPTIONS"
196.578 .LP
196.579 +
196.580 +.LP
196.581 .LP
196.582 The javadoc tool uses doclets to determine its output. The Javadoc tool uses the default standard doclet unless a custom doclet is specified with the \-doclet option. The Javadoc tool provides a set of command\-line options that can be used with any doclet \-\- these options are described below under the sub\-heading Javadoc Options. The standard doclet provides an additional set of command\-line options that are described below under the sub\-heading Options Provided by the Standard Doclet. All option names are case\-insensitive, though their arguments can be case\-sensitive.
196.583 .LP
196.584 @@ -3543,7 +3674,7 @@
196.585 .nr 42 \n(81+(3*\n(38)
196.586 .nr 82 +\n(42
196.587 .nr TW \n(82
196.588 -.if t .if \n(TW>\n(.li .tm Table at line 2192 file Input is too wide - \n(TW units
196.589 +.if t .if \n(TW>\n(.li .tm Table at line 2341 file Input is too wide - \n(TW units
196.590 .fc
196.591 .nr #T 0-1
196.592 .nr #a 0-1
196.593 @@ -3655,11 +3786,11 @@
196.594 \fP
196.595 .fi
196.596 .LP
196.597 -For full, working examples of running a particular doclet, see
196.598 +For full, working examples of running a particular doclet, see the
196.599 .na
196.600 -\f2Running the MIF Doclet\fP @
196.601 +\f2MIF Doclet documentation\fP @
196.602 .fi
196.603 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
196.604 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
196.605 .LP
196.606 .TP 3
196.607 \-docletpath\ classpathlist
196.608 @@ -3681,11 +3812,11 @@
196.609 .fl
196.610 \fP
196.611 .fi
196.612 -For full, working examples of running a particular doclet, see
196.613 +For full, working examples of running a particular doclet, see the
196.614 .na
196.615 -\f2Running the MIF Doclet\fP @
196.616 +\f2MIF Doclet documentation\fP @
196.617 .fi
196.618 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
196.619 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
196.620 .LP
196.621 .TP 3
196.622 \-1.1
196.623 @@ -3806,7 +3937,7 @@
196.624 .nr 41 \n(80+(3*\n(38)
196.625 .nr 81 +\n(41
196.626 .nr TW \n(81
196.627 -.if t .if \n(TW>\n(.li .tm Table at line 2302 file Input is too wide - \n(TW units
196.628 +.if t .if \n(TW>\n(.li .tm Table at line 2451 file Input is too wide - \n(TW units
196.629 .fc
196.630 .nr #T 0-1
196.631 .nr #a 0-1
196.632 @@ -3913,7 +4044,11 @@
196.633 .LP
196.634 .TP 3
196.635 \-classpath\ classpathlist
196.636 -Specifies the paths where javadoc will look for referenced classes (\f2.class\fP files) \-\- these are the documented classes plus any classes referenced by those classes. The \f2classpathlist\fP can contain multiple paths by separating them with a colon (\f2:\fP). The Javadoc tool will search in all subdirectories of the specified paths. Follow the instructions in class path documentation for specifying \f2classpathlist\fP.
196.637 +Specifies the paths where javadoc will look for referenced classes (\f2.class\fP files) \-\- these are the documented classes plus any classes referenced by those classes. The \f2classpathlist\fP can contain multiple paths by separating them with a colon (\f2:\fP). The Javadoc tool will search in all subdirectories of the specified paths. Follow the instructions in
196.638 +.na
196.639 +\f2class path\fP @
196.640 +.fi
196.641 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general documentation for specifying \f2classpathlist\fP.
196.642 .LP
196.643 If \f2\-sourcepath\fP is omitted, the Javadoc tool uses \f2\-classpath\fP to find the source files as well as class files (for backward compatibility). Therefore, if you want to search for source and class files in separate paths, use both \f2\-sourcepath\fP and \f2\-classpath\fP.
196.644 .LP
196.645 @@ -3926,7 +4061,11 @@
196.646 .fi
196.647 As with other tools, if you do not specify \f2\-classpath\fP, the Javadoc tool uses the CLASSPATH environment variable, if it is set. If both are not set, the Javadoc tool searches for classes from the current directory.
196.648 .LP
196.649 -For an in\-depth description of how the Javadoc tool uses \f2\-classpath\fP to find user classes as it relates to extension classes and bootstrap classes, see How Classes Are Found.
196.650 +For an in\-depth description of how the Javadoc tool uses \f2\-classpath\fP to find user classes as it relates to extension classes and bootstrap classes, see
196.651 +.na
196.652 +\f2How Classes Are Found\fP @
196.653 +.fi
196.654 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html.
196.655 .LP
196.656 As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
196.657 .br
196.658 @@ -3961,7 +4100,11 @@
196.659 .LP
196.660 .TP 3
196.661 \-bootclasspath\ classpathlist
196.662 -Specifies the paths where the boot classes reside. These are nominally the Java platform classes. The bootclasspath is part of the search path the Javadoc tool will use to look up source and class files. See How Classes Are Found. for more details. Separate directories in \f2classpathlist\fP with colons (:).
196.663 +Specifies the paths where the boot classes reside. These are nominally the Java platform classes. The bootclasspath is part of the search path the Javadoc tool will use to look up source and class files. See
196.664 +.na
196.665 +\f2How Classes Are Found\fP @
196.666 +.fi
196.667 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles. for more details. Separate directories in \f2classpathlist\fP with colons (:).
196.668 .LP
196.669 .TP 3
196.670 \-extdirs\ dirlist
196.671 @@ -3977,7 +4120,11 @@
196.672 .LP
196.673 .TP 3
196.674 \-breakiterator\
196.675 -Uses the internationalized sentence boundary of \f2java.text.BreakIterator\fP to determine the end of the first sentence for English (all other locales already use \f2BreakIterator\fP), rather than an English language, locale\-specific algorithm. By \f2first sentence\fP, we mean the first sentence in the main description of a package, class or member. This sentence is copied to the package, class or member summary, and to the alphabetic index.
196.676 +Uses the internationalized sentence boundary of
196.677 +.na
196.678 +\f2java.text.BreakIterator\fP @
196.679 +.fi
196.680 +http://java.sun.com/javase/6/docs/api/java/text/BreakIterator.html to determine the end of the first sentence for English (all other locales already use \f2BreakIterator\fP), rather than an English language, locale\-specific algorithm. By \f2first sentence\fP, we mean the first sentence in the main description of a package, class or member. This sentence is copied to the package, class or member summary, and to the alphabetic index.
196.681 .LP
196.682 From JDK 1.2 forward, the BreakIterator class is already used to determine the end of sentence for all languages but English. Therefore, the \f2\-breakiterator\fP option has no effect except for English from 1.2 forward. English has its own default algorithm:
196.683 .RS 3
196.684 @@ -4055,7 +4202,7 @@
196.685 \-use
196.686 Includes one "Use" page for each documented class and package. The page describes what packages, classes, methods, constructors and fields use any API of the given class or package. Given class C, things that use class C would include subclasses of C, fields declared as C, methods that return C, and methods and constructors with parameters of type C.
196.687 .LP
196.688 -For example, let's look at what might appear on the "Use" page for String. The \f2getName()\fP method in the \f2java.awt.Font\fP class returns type \f2String\fP. Therefore, \f2getName()\fP uses \f2String\fP, and you will find that method on the "Use" page for \f2String\fP.
196.689 +For example, let us look at what might appear on the "Use" page for String. The \f2getName()\fP method in the \f2java.awt.Font\fP class returns type \f2String\fP. Therefore, \f2getName()\fP uses \f2String\fP, and you will find that method on the "Use" page for \f2String\fP.
196.690 .LP
196.691 Note that this documents only uses of the API, not the implementation. If a method uses \f2String\fP in its implementation but does not take a string as an argument or return a string, that is not considered a "use" of \f2String\fP.
196.692 .LP
196.693 @@ -4078,7 +4225,7 @@
196.694 .nf
196.695 \f3
196.696 .fl
196.697 - % \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
196.698 + % \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
196.699 .fl
196.700 .fi
196.701 .TP 3
196.702 @@ -4087,7 +4234,7 @@
196.703 .nf
196.704 \f3
196.705 .fl
196.706 - % \fP\f3javadoc \-doctitle "Java<sup><font size=\\"\-2\\">TM</font></sup>" com.mypackage\fP
196.707 + % \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
196.708 .fl
196.709 .fi
196.710 .TP 3
196.711 @@ -4161,18 +4308,18 @@
196.712 when using an absolute URL to the external API document, if your shell \f2does not allow\fP a program to open a connection to that URL for reading. This can occur if you are behind a firewall and the document you want to link to is on the other side.
196.713 .RE
196.714 .LP
196.715 -\f3Example using absolute links to the external docs\fP \- Let's say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java 2 Platform packages at
196.716 +\f3Example using absolute links to the external docs\fP \- Let us say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java Platform packages at
196.717 .na
196.718 -\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
196.719 +\f2http://java.sun.com/javase/6/docs/api/\fP @
196.720 .fi
196.721 -http://java.sun.com/j2se/1.5.0/docs/api, The following command generates documentation for the package \f2com.mypackage\fP with links to the Java 2 Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other options, such as \f2\-sourcepath\fP and \f2\-d\fP, are not shown.)
196.722 +http://java.sun.com/javase/6/docs/api. The following command generates documentation for the package \f2com.mypackage\fP with links to the Java SE Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other options, such as \f2\-sourcepath\fP and \f2\-d\fP, are not shown.)
196.723 .nf
196.724 \f3
196.725 .fl
196.726 - % \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
196.727 + % \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
196.728 .fl
196.729 .fi
196.730 -\f3Example using relative links to the external docs\fP \- Let's say you have two packages whose docs are generated in different runs of the Javadoc tool, and those docs are separated by a relative path. In this example, the packages are \f2com.apipackage\fP, an API, and \f2com.spipackage\fP, an SPI (Service Provide Interface). You want the documentation to reside in \f2docs/api/com/apipackage\fP and \f2docs/spi/com/spipackage\fP. Assuming the API package documentation is already generated, and that \f2docs\fP is the current directory, you would document the SPI package with links to the API documentation by running:
196.731 +\f3Example using relative links to the external docs\fP \- Let us say you have two packages whose docs are generated in different runs of the Javadoc tool, and those docs are separated by a relative path. In this example, the packages are \f2com.apipackage\fP, an API, and \f2com.spipackage\fP, an SPI (Service Provide Interface). You want the documentation to reside in \f2docs/api/com/apipackage\fP and \f2docs/spi/com/spipackage\fP. Assuming the API package documentation is already generated, and that \f2docs\fP is the current directory, you would document the SPI package with links to the API documentation by running:
196.732 .nf
196.733 \f3
196.734 .fl
196.735 @@ -4212,11 +4359,11 @@
196.736 .LP
196.737 \f3Package List\fP \- The \f2\-link\fP option requires that a file named \f2package\-list\fP, which is generated by the Javadoc tool, exist at the URL you specify with \f2\-link\fP. The \f2package\-list\fP file is a simple text file that lists the names of packages documented at that location. In the earlier example, the Javadoc tool looks for a file named \f2package\-list\fP at the given URL, reads in the package names and then links to those packages at that URL.
196.738 .LP
196.739 -For example, the package list for the Java 2 Platform 5.0 API is located at
196.740 +For example, the package list for the Java SE 6 API is located at
196.741 .na
196.742 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
196.743 +\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
196.744 .fi
196.745 -http://java.sun.com/j2se/1.5.0/docs/api/package\-list. and starts out as follows:
196.746 +http://java.sun.com/javase/6/docs/api/package\-list. and starts as follows:
196.747 .nf
196.748 \f3
196.749 .fl
196.750 @@ -4275,15 +4422,15 @@
196.751 .LP
196.752 You can specify multiple \f2\-linkoffline\fP options in a given javadoc run. (Prior to 1.2.2, it could be specified only once.)
196.753 .LP
196.754 -\f3Example using absolute links to the external docs\fP \- Let's say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java 2 Platform packages at \f2http://java.sun.com/j2se/1.5.0/docs/api\fP, but your shell does not have web access. You could open the \f2package\-list\fP file in a browser at
196.755 +\f3Example using absolute links to the external docs\fP \- Let us say you want to link to the \f2java.lang\fP, \f2java.io\fP and other Java SE Platform packages at \f2http://java.sun.com/javase/6/docs/api\fP, but your shell does not have web access. You could open the \f2package\-list\fP file in a browser at
196.756 .na
196.757 -\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
196.758 +\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
196.759 .fi
196.760 -http://java.sun.com/j2se/1.5.0/docs/api/package\-list, save it to a local directory, and point to this local copy with the second argument, \f2packagelistLoc\fP. In this example, the package list file has been saved to the current directory "\f2.\fP" . The following command generates documentation for the package \f2com.mypackage\fP with links to the Java 2 Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other necessary options, such as \f2\-sourcepath\fP, are not shown.)
196.761 +http://java.sun.com/javase/6/docs/api/package\-list, save it to a local directory, and point to this local copy with the second argument, \f2packagelistLoc\fP. In this example, the package list file has been saved to the current directory "\f2.\fP" . The following command generates documentation for the package \f2com.mypackage\fP with links to the Java SE Platform packages. The generated documentation will contain links to the \f2Object\fP class, for example, in the class trees. (Other necessary options, such as \f2\-sourcepath\fP, are not shown.)
196.762 .nf
196.763 \f3
196.764 .fl
196.765 -% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
196.766 +% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
196.767 .fl
196.768 .fi
196.769 .LP
196.770 @@ -4301,7 +4448,7 @@
196.771 .LP
196.772 \f3Updating docs\fP \- Another use for \f2\-linkoffline\fP option is useful if your project has dozens or hundreds of packages, if you have already run javadoc on the entire tree, and now, in a separate run, you want to quickly make some small changes and re\-run javadoc on just a small portion of the source tree. This is somewhat of a hack in that it works properly only if your changes are only to doc comments and not to declarations. If you were to add, remove or change any declarations from the source code, then broken links could show up in the index, package tree, inherited member lists, use page, and other places.
196.773 .LP
196.774 -First, you create a new destination directory (call it \f2update\fP) for this new small run. Let's say the original destination directory was named \f2html\fP. In the simplest example, cd to the parent of \f2html\fP. Set the first argument of \f2\-linkoffline\fP to the current directory "." and set the second argument to the relative path to \f2html\fP, where it can find \f2package\-list\fP, and pass in only the package names of the packages you want to update:
196.775 +First, you create a new destination directory (call it \f2update\fP) for this new small run. Let us say the original destination directory was named \f2html\fP. In the simplest example, cd to the parent of \f2html\fP. Set the first argument of \f2\-linkoffline\fP to the current directory "." and set the second argument to the relative path to \f2html\fP, where it can find \f2package\-list\fP, and pass in only the package names of the packages you want to update:
196.776 .nf
196.777 \f3
196.778 .fl
196.779 @@ -4525,7 +4672,7 @@
196.780 .br
196.781 \f4f\fP (fields)
196.782 .LP
196.783 -\f3Examples of single tags\fP \- An example of a tag option for a tag that that can be used anywhere in the source code is:
196.784 +\f3Examples of single tags\fP \- An example of a tag option for a tag that can be used anywhere in the source code is:
196.785 .nf
196.786 \f3
196.787 .fl
196.788 @@ -4633,7 +4780,10 @@
196.789 .RS 3
196.790 .TP 2
196.791 o
196.792 -Taglet Overview
196.793 +.na
196.794 +\f2Taglet Overview\fP @
196.795 +.fi
196.796 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
196.797 .RE
196.798 .LP
196.799 Taglets are useful for block or inline tags. They can have any number of arguments and implement custom behavior, such as making text bold, formatting bullets, writing out the text to a file, or starting other processes.
196.800 @@ -4711,7 +4861,7 @@
196.801 .nf
196.802 \f3
196.803 .fl
196.804 - <!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
196.805 + <!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
196.806 .fl
196.807 \fP
196.808 .fi
196.809 @@ -4722,6 +4872,8 @@
196.810 .RE
196.811 .SH "COMMAND LINE ARGUMENT FILES"
196.812 .LP
196.813 +
196.814 +.LP
196.815 .LP
196.816 To shorten or simplify the javadoc command line, you can specify one or more files that themselves contain arguments to the \f2javadoc\fP command (except \f2\-J\fP options). This enables you to create javadoc commands of any length on any operating system.
196.817 .LP
196.818 @@ -4769,19 +4921,19 @@
196.819 .fl
196.820 \-splitindex
196.821 .fl
196.822 - \-windowtitle 'Java 2 Platform v1.3 API Specification'
196.823 -.fl
196.824 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification'
196.825 -.fl
196.826 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
196.827 -.fl
196.828 - \-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
196.829 + \-windowtitle 'Java(TM) SE 7 API Specification'
196.830 +.fl
196.831 + \-doctitle 'Java(TM) SE 7 API Specification'
196.832 +.fl
196.833 + \-header '<b>Java(TM); SE 7'
196.834 +.fl
196.835 + \-bottom 'Copyright 1993\-2009 Sun Microsystems, Inc. All Rights Reserved.'
196.836 .fl
196.837 \-group "Core Packages" "java.*"
196.838 .fl
196.839 - \-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
196.840 -.fl
196.841 - \-sourcepath /java/pubs/ws/1.5/src/share/classes
196.842 + \-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
196.843 +.fl
196.844 + \-sourcepath /java/pubs/ws/1.7.0/src/share/classes
196.845 .fl
196.846 \fP
196.847 .fi
196.848 @@ -4871,25 +5023,38 @@
196.849 % \fP\f3javadoc @bottom @packages\fP
196.850 .fl
196.851 .fi
196.852 -.SH NAME
196.853 +
196.854 +.LP
196.855 +
196.856 +.LP
196.857 +.SH "Name"
196.858 Running
196.859 +.LP
196.860 .SH "RUNNING JAVADOC"
196.861 .LP
196.862 +
196.863 +.LP
196.864 .LP
196.865 \f3Version Numbers\fP \- The version number of javadoc can be determined using \f3javadoc \-J\-version\fP. The version number of the standard doclet appears in its output stream. It can be turned off with \f2\-quiet\fP.
196.866 .LP
196.867 .LP
196.868 -\f3Public programmatic interface\fP \- To invoke the Javadoc tool from within programs written in the Java language. This interface is in \f2com.sun.tools.javadoc.Main\fP (and javadoc is re\-entrant). For more details, see Standard Doclet.
196.869 -.LP
196.870 -.LP
196.871 -\f3Running Doclets\fP \- The instructions given below are for invoking the standard HTML doclet. To invoke a custom doclet, use the \-doclet and \-docletpath options. For full, working examples of running a particular doclet, see
196.872 +\f3Public programmatic interface\fP \- To invoke the Javadoc tool from within programs written in the Java language. This interface is in \f2com.sun.tools.javadoc.Main\fP (and javadoc is re\-entrant). For more details, see
196.873 .na
196.874 -\f2Running the MIF Doclet\fP @
196.875 +\f2Standard Doclet\fP @
196.876 .fi
196.877 -http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
196.878 +http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammatically.
196.879 +.LP
196.880 +.LP
196.881 +\f3Running Doclets\fP \- The instructions given below are for invoking the standard HTML doclet. To invoke a custom doclet, use the \-doclet and \-docletpath options. For full, working examples of running a particular doclet, see the
196.882 +.na
196.883 +\f2MIF Doclet documentation\fP @
196.884 +.fi
196.885 +http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
196.886 .LP
196.887 .SH "SIMPLE EXAMPLES"
196.888 .LP
196.889 +
196.890 +.LP
196.891 .LP
196.892 You can run javadoc on entire packages or individual source files. Each package name has a corresponding directory name. In the following examples, the source files are located at \f2/home/src/java/awt/*.java\fP. The destination directory is \f2/home/html\fP.
196.893 .LP
196.894 @@ -5012,8 +5177,10 @@
196.895 .LP
196.896 .SH "REAL WORLD EXAMPLE"
196.897 .LP
196.898 -.LP
196.899 -The Javadoc tool has many useful options, some of which are more commonly used than others. Here is effectively the command we use to run the Javadoc tool on the Java platform API. We use 180MB of memory to generate the documentation for the 1500 (approx.) public and protected classes in the Java 2 Platform, Standard Edition, v1.2.
196.900 +
196.901 +.LP
196.902 +.LP
196.903 +The Javadoc tool has many useful options, some of which are more commonly used than others. Here is effectively the command we use to run the Javadoc tool on the Java platform API. We use 180MB of memory to generate the documentation for the 1500 (approx.) public and protected classes in the Java SE Platform, Standard Edition, v1.2.
196.904 .LP
196.905 .LP
196.906 The same example is shown twice \-\- first as executed on the command line, then as executed from a makefile. It uses absolute paths in the option arguments, which enables the same \f2javadoc\fP command to be run from any directory.
196.907 @@ -5027,21 +5194,21 @@
196.908 .nf
196.909 \f3
196.910 .fl
196.911 -% javadoc \-sourcepath /java/jdk/src/share/classes \\
196.912 -.fl
196.913 - \-overview /java/jdk/src/share/classes/overview.html \\
196.914 -.fl
196.915 - \-d /java/jdk/build/api \\
196.916 -.fl
196.917 - \-use \\
196.918 -.fl
196.919 - \-splitIndex \\
196.920 -.fl
196.921 - \-windowtitle 'Java 2 Platform 5.0 API Specification' \\
196.922 -.fl
196.923 - \-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification' \\
196.924 -.fl
196.925 - \-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
196.926 +% javadoc \-sourcepath /java/jdk/src/share/classes \\
196.927 +.fl
196.928 + \-overview /java/jdk/src/share/classes/overview.html \\
196.929 +.fl
196.930 + \-d /java/jdk/build/api \\
196.931 +.fl
196.932 + \-use \\
196.933 +.fl
196.934 + \-splitIndex \\
196.935 +.fl
196.936 + \-windowtitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
196.937 +.fl
196.938 + \-doctitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
196.939 +.fl
196.940 + \-header '<b>Java(TM) SE </b><br><font size="\-1">7</font>' \\
196.941 .fl
196.942 \-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
196.943 .fl
196.944 @@ -5051,9 +5218,9 @@
196.945 .fl
196.946 901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
196.947 .fl
196.948 - \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
196.949 -.fl
196.950 - \-group "Extension Packages" "javax.*" \\
196.951 + \-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
196.952 +.fl
196.953 + \-group "Extension Packages" "javax.*" \\
196.954 .fl
196.955 \-J\-Xmx180m \\
196.956 .fl
196.957 @@ -5105,17 +5272,17 @@
196.958 .fl
196.959 java.lang java.lang.reflect \\ /* Sets packages to document */
196.960 .fl
196.961 - java.util java.io java.net \\
196.962 + java.util java.io java.net \\
196.963 .fl
196.964 java.applet
196.965 .fl
196.966
196.967 .fl
196.968 -WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
196.969 -.fl
196.970 -DOCTITLE = 'Java<sup><font size="\-2">TM</font></sup> 2 Platform v1.2 API Specification'
196.971 -.fl
196.972 -HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
196.973 +WINDOWTITLE = 'Java(TM) SE 7 API Specification'
196.974 +.fl
196.975 +DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
196.976 +.fl
196.977 +HEADER = '<b>Java(TM) SE 7</font>'
196.978 .fl
196.979 BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
196.980 .fl
196.981 @@ -5131,7 +5298,7 @@
196.982 .fl
196.983 GROUPEXT = '"Extension Packages" "javax.*"'
196.984 .fl
196.985 -SRCDIR = '/java/jdk/1.2/src/share/classes'
196.986 +SRCDIR = '/java/jdk/1.7.0/src/share/classes'
196.987 .fl
196.988 \fP
196.989 .fi
196.990 @@ -5158,6 +5325,8 @@
196.991 .LP
196.992 .SH "TROUBLESHOOTING"
196.993 .LP
196.994 +
196.995 +.LP
196.996 .SS
196.997 General Troubleshooting
196.998 .LP
196.999 @@ -5171,11 +5340,7 @@
196.1000 http://java.sun.com/j2se/javadoc/faq/index.html#B
196.1001 .TP 2
196.1002 o
196.1003 -\f3Bugs and Limitations\fP \- You can also see some bugs listed at
196.1004 -.na
196.1005 -\f2Important Bug Fixes and Changes\fP @
196.1006 -.fi
196.1007 -http://java.sun.com/j2se/1.5.0/fixedbugs/index.html.
196.1008 +\f3Bugs and Limitations\fP \- You can also see some bugs listed at Important Bug Fixes and Changes.
196.1009 .TP 2
196.1010 o
196.1011 \f3Version number\fP \- See version numbers.
196.1012 @@ -5200,6 +5365,8 @@
196.1013 .LP
196.1014 .SH "ENVIRONMENT"
196.1015 .LP
196.1016 +
196.1017 +.LP
196.1018 .RS 3
196.1019 .TP 3
196.1020 CLASSPATH
196.1021 @@ -5210,22 +5377,24 @@
196.1022 .LP
196.1023 .SH "SEE ALSO"
196.1024 .LP
196.1025 +
196.1026 +.LP
196.1027 .RS 3
196.1028 .TP 2
196.1029 o
196.1030 -javac
196.1031 +javac(1)
196.1032 .TP 2
196.1033 o
196.1034 -java
196.1035 +java(1)
196.1036 .TP 2
196.1037 o
196.1038 -jdb
196.1039 +jdb(1)
196.1040 .TP 2
196.1041 o
196.1042 -javah
196.1043 +javah(1)
196.1044 .TP 2
196.1045 o
196.1046 -javap
196.1047 +javap(1)
196.1048 .TP 2
196.1049 o
196.1050 .na
196.1051 @@ -5240,12 +5409,22 @@
196.1052 http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
196.1053 .TP 2
196.1054 o
196.1055 -Setting the Class Path
196.1056 +.na
196.1057 +\f2Setting the Class Path\fP @
196.1058 +.fi
196.1059 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
196.1060 .TP 2
196.1061 o
196.1062 -How Javac and Javadoc Find Classes (tools.jar)
196.1063 +.na
196.1064 +\f2How Javac and Javadoc Find Classes\fP @
196.1065 +.fi
196.1066 +http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
196.1067 .RE
196.1068
196.1069 .LP
196.1070 -.LP
196.1071 -Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
196.1072 +
196.1073 +.LP
196.1074 +.LP
196.1075 +Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
196.1076 +.LP
196.1077 +
197.1 --- a/src/solaris/doc/sun/man/man1/javah.1 Tue May 12 15:21:55 2009 +0900
197.2 +++ b/src/solaris/doc/sun/man/man1/javah.1 Thu May 14 00:17:25 2009 -0700
197.3 @@ -1,5 +1,4 @@
197.4 -.'" t
197.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
197.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
197.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
197.8 ."
197.9 ." This code is free software; you can redistribute it and/or modify it
197.10 @@ -19,19 +18,21 @@
197.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
197.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
197.13 ." have any questions.
197.14 -." `
197.15 -.TH javah 1 "05 Aug 2006"
197.16 -." Generated by html2roff
197.17 +."
197.18 +.TH javah 1 "04 May 2009"
197.19 +." Generated from HTML by html2man (author: Eric Armstrong)
197.20
197.21 .LP
197.22 -.SH NAME
197.23 +.SH "Name"
197.24 javah \- C Header and Stub File Generator
197.25 .LP
197.26 +.RS 3
197.27
197.28 .LP
197.29 .LP
197.30 \f3javah\fP produces C header files and C source files from a Java class. These files provide the connective glue that allow your Java and C code to interact.
197.31 .LP
197.32 +.RE
197.33 .SH "SYNOPSIS"
197.34 .LP
197.35
197.36 @@ -64,12 +65,13 @@
197.37 The new native method interface, Java Native Interface (JNI), does not require header information or stub files. \f3javah\fP can still be used to generate native method function proptotypes needed for JNI\-style native methods. \f3javah\fP produces JNI\-style output by default, and places the result in the .h file.
197.38 .LP
197.39 .LP
197.40 -\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like \f3jdb\fP.
197.41 +\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like jdb(1).
197.42 .LP
197.43 .SH "OPTIONS"
197.44 .LP
197.45
197.46 .LP
197.47 +.RS 3
197.48 .TP 3
197.49 \-o outputfile
197.50 Concatenates the resulting header or source files for all the classes listed on the command line into \f2outputfile\fP. Only one of \f3\-o\fP or \f3\-d\fP may be used.
197.51 @@ -113,7 +115,7 @@
197.52 As a special convenience, a class path element containing a basename of \f2*\fP is considered equivalent to specifying a list of all the files in the directory with the extension \f2.jar\fP or \f2.JAR\fP (a java program cannot tell the difference between the two invocations).
197.53 .br
197.54 .br
197.55 -For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
197.56 +For example, if directory \f2foo\fP contains \f2a.jar\fP and \f2b.JAR\fP, then the class path element \f2foo/*\fP is expanded to a \f2A.jar:b.JAR\fP, except that the order of jar files is unspecified. All jar files in the specified directory, even hidden ones, are included in the list. A classpath entry consisting simply of \f2*\fP expands to a list of all the jar files in the current directory. The \f2CLASSPATH\fP environment variable, where defined, will be similarly expanded. Any classpath wildcard expansion occurs before the Java virtual machine is started \-\- no Java program will ever see unexpanded wildcards except by querying the environment. For example; by invoking \f2System.getenv("CLASSPATH")\fP.
197.57 .TP 3
197.58 \-bootclasspath path
197.59 Specifies path from which to load bootstrap classes. By default, the bootstrap classes are the classes implementing the core Java 2 platform located in \f2jre/lib/rt.jar\fP and several other jar files.
197.60 @@ -125,12 +127,15 @@
197.61 Specifies that output files should always be written.
197.62 .TP 3
197.63 \-Joption
197.64 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
197.65 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
197.66 +.RE
197.67 +
197.68 .LP
197.69 .SH "ENVIRONMENT VARIABLES"
197.70 .LP
197.71
197.72 .LP
197.73 +.RS 3
197.74 .TP 3
197.75 CLASSPATH
197.76 Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example,
197.77 @@ -141,6 +146,7 @@
197.78 .fl
197.79 \fP
197.80 .fi
197.81 +.RE
197.82
197.83 .LP
197.84 .SH "SEE ALSO"
197.85 @@ -148,7 +154,7 @@
197.86
197.87 .LP
197.88 .LP
197.89 -javac, java, jdb, javap, javadoc
197.90 +javac(1), java(1), jdb(1), javap(1), javadoc(1)
197.91 .LP
197.92
197.93 .LP
198.1 --- a/src/solaris/doc/sun/man/man1/javap.1 Tue May 12 15:21:55 2009 +0900
198.2 +++ b/src/solaris/doc/sun/man/man1/javap.1 Thu May 14 00:17:25 2009 -0700
198.3 @@ -1,5 +1,4 @@
198.4 -.'" t
198.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
198.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
198.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
198.8 ."
198.9 ." This code is free software; you can redistribute it and/or modify it
198.10 @@ -19,19 +18,21 @@
198.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
198.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
198.13 ." have any questions.
198.14 -." `
198.15 -.TH javap 1 "05 Aug 2006"
198.16 -." Generated by html2roff
198.17 +."
198.18 +.TH javap 1 "04 May 2009"
198.19 +." Generated from HTML by html2man (author: Eric Armstrong)
198.20
198.21 .LP
198.22 -.SH NAME
198.23 +.SH "Name"
198.24 javap \- The Java Class File Disassembler
198.25 .LP
198.26 +.RS 3
198.27
198.28 .LP
198.29 .LP
198.30 Disassembles class files.
198.31 .LP
198.32 +.RE
198.33 .SH "SYNOPSIS"
198.34 .LP
198.35
198.36 @@ -251,6 +252,7 @@
198.37 .LP
198.38
198.39 .LP
198.40 +.RS 3
198.41 .TP 3
198.42 \-help
198.43 Prints out help message for \f3javap\fP.
198.44 @@ -258,9 +260,6 @@
198.45 \-l
198.46 Prints out line and local variable tables.
198.47 .TP 3
198.48 -\-b
198.49 -Ensures backward compatibility with \f3javap\fP in JDK 1.1.
198.50 -.TP 3
198.51 \-public
198.52 Shows only public classes and members.
198.53 .TP 3
198.54 @@ -325,11 +324,14 @@
198.55 .TP 3
198.56 \-extdirs dirs
198.57 Overrides location at which installed extensions are searched for. The default location for extensions is the value of \f2java.ext.dirs\fP.
198.58 +.RE
198.59 +
198.60 .LP
198.61 .SH "ENVIRONMENT VARIABLES"
198.62 .LP
198.63
198.64 .LP
198.65 +.RS 3
198.66 .TP 3
198.67 CLASSPATH
198.68 Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example, For example:
198.69 @@ -344,6 +346,7 @@
198.70 \fP
198.71 .fi
198.72 .RE
198.73 +.RE
198.74
198.75 .LP
198.76 .SH "SEE ALSO"
198.77 @@ -351,7 +354,7 @@
198.78
198.79 .LP
198.80 .LP
198.81 -javac, java, jdb, javah, javadoc
198.82 +javac(1), java(1), jdb(1), javah(1), javadoc(1)
198.83 .LP
198.84
198.85 .LP
199.1 --- a/src/solaris/doc/sun/man/man1/javaws.1 Tue May 12 15:21:55 2009 +0900
199.2 +++ b/src/solaris/doc/sun/man/man1/javaws.1 Thu May 14 00:17:25 2009 -0700
199.3 @@ -1,5 +1,4 @@
199.4 -.'" t
199.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
199.6 +." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
199.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
199.8 ."
199.9 ." This code is free software; you can redistribute it and/or modify it
199.10 @@ -19,14 +18,14 @@
199.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
199.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
199.13 ." have any questions.
199.14 -." `
199.15 -.TH javaws 1 "05 Aug 2006"
199.16 -." Generated by html2roff
199.17 +."
199.18 +.TH javaws 1 "04 May 2009"
199.19 +." Generated from HTML by html2man (author: Eric Armstrong)
199.20
199.21 .LP
199.22
199.23 .LP
199.24 -.SH NAME
199.25 +.SH "Name"
199.26 \f2javaws\fP Command Line
199.27 .LP
199.28
199.29 @@ -37,104 +36,93 @@
199.30 .SS
199.31 NAME
199.32 .LP
199.33 +.RS 3
199.34
199.35 .LP
199.36 .LP
199.37 \f2javaws\fP \- Java Web Start launcher command
199.38 .LP
199.39 +.RE
199.40 .SS
199.41 SYNOPSIS
199.42 .LP
199.43 -
199.44 -.LP
199.45 -.LP
199.46 -\f2javaws [ options ] [ URL ]\fP
199.47 -.LP
199.48 -.SS
199.49 -PARAMETERS
199.50 -.LP
199.51 -
199.52 -.LP
199.53 -.LP
199.54 -\f2options\fP
199.55 -.LP
199.56 .RS 3
199.57
199.58 .LP
199.59 .LP
199.60 -Command\-line options. Options may be in any order. For a discussion of the various options, see OPTIONS below.
199.61 +\f2javaws [run\-options] <jnlp>\fP
199.62 +.LP
199.63 +.LP
199.64 +\f2javaws [control\-options]\fP
199.65 .LP
199.66 .RE
199.67 -.LP
199.68 -\f2URL\fP
199.69 +.SS
199.70 +PARAMETERS
199.71 .LP
199.72 .RS 3
199.73
199.74 .LP
199.75 .LP
199.76 -Uniform Resource Locator (\f2URL\fP) of the JNLP (Java Net\-work Launching Protocol) file.
199.77 +\f2[run\-options]\fP
199.78 .LP
199.79 +.RS 3
199.80 +
199.81 +.LP
199.82 +.LP
199.83 +Command\-line run\-options. run\-options may be in any order. For a discussion of the various run\-options, see RUN\-OPTIONS below.
199.84 +.LP
199.85 +.RE
199.86 +.LP
199.87 +\f2<jnlp>\fP
199.88 +.LP
199.89 +.RS 3
199.90 +
199.91 +.LP
199.92 +.LP
199.93 +This can be either the path of, or the Uniform Resource Locater (URL) of the JNLP (Java Network Launching Protocol) file.
199.94 +.LP
199.95 +.RE
199.96 +.LP
199.97 +\f2[control\-options]\fP
199.98 +.LP
199.99 +.RS 3
199.100 +
199.101 +.LP
199.102 +.LP
199.103 +Command\-line control\-options. control\-options may be in any order. For a discussion of the various control\-options, see CONTROL\-OPTIONS below.
199.104 +.LP
199.105 +.RE
199.106 .RE
199.107 .SS
199.108 DESCRIPTION
199.109 .LP
199.110 +.RS 3
199.111
199.112 .LP
199.113 .LP
199.114 The \f2javaws\fP command launches Java Web Start, which is the reference implementation of the Java Network Launching Protocol (JNLP). Java Web Start launches Java applications/applets hosted on a network.
199.115 .LP
199.116 .LP
199.117 -Without any options \f2javaws\fP will launch the Java JNLP Application Manager, from which users can launch applications/applet or configure Java Web Start.
199.118 +If a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
199.119 .LP
199.120 .LP
199.121 -If a \f2URL\fP for a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
199.122 +The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release.
199.123 .LP
199.124 +.RE
199.125 .SS
199.126 -OPTIONS
199.127 +RUN\-OPTIONS
199.128 .LP
199.129 +.RS 3
199.130
199.131 .LP
199.132 .LP
199.133 -The \f2javaws\fP launcher has a set of options that are supported in the current release. However, the options may be removed in a future release. All \f2\-X\fP options are non\-standard and subject to change.
199.134 -.LP
199.135 -.LP
199.136 \f2\-offline\fP
199.137 .LP
199.138 .RS 3
199.139
199.140 .LP
199.141 .LP
199.142 -Runs Java Web Start in offline mode.
199.143 -.LP
199.144 -.RE
199.145 -.LP
199.146 -\f2\-uninstall <URL>\fP
199.147 -.LP
199.148 -.RS 3
199.149 -
199.150 -.LP
199.151 -.LP
199.152 -Removes a specific application/applet from the user's cache, as indicated by the URL for the JNLP file. If \f2<URL>\fP is not specified, the entire cache is removed. Java Web Start will exit after the command is completed.
199.153 -.LP
199.154 -.RE
199.155 -.LP
199.156 -\f2\-updateVersions\fP
199.157 -.LP
199.158 -.RS 3
199.159 -
199.160 -.LP
199.161 -.LP
199.162 -Updates the Java Web Start configuration file based on the current machine's settings. Java Web Start will exit after the command is completed.
199.163 -.LP
199.164 -.RE
199.165 -.LP
199.166 -\f2\-Xclearcache\fP
199.167 -.LP
199.168 -.RS 3
199.169 -
199.170 -.LP
199.171 -.LP
199.172 -Clears the user's cache. Java Web Start will exit after the command is completed.
199.173 +run Java Web Start in offline mode.
199.174 .LP
199.175 .RE
199.176 .LP
199.177 @@ -144,67 +132,7 @@
199.178
199.179 .LP
199.180 .LP
199.181 -Disables the display of the initial splash screen.
199.182 -.LP
199.183 -.RE
199.184 -.LP
199.185 -\f2\-import\fP
199.186 -.LP
199.187 -.RS 3
199.188 -
199.189 -.LP
199.190 -.LP
199.191 -Imports the application specified by URL into the user's cache but does not run it.
199.192 -.LP
199.193 -.RE
199.194 -.LP
199.195 -\f2\-silent\fP
199.196 -.LP
199.197 -.RS 3
199.198 -
199.199 -.LP
199.200 -.LP
199.201 -When used with the \f2\-import\fP option, imports in silent mode; i.e., there will be no UI pop up. The process exit code will be either 0 if successful or 1 if not.
199.202 -.LP
199.203 -.RE
199.204 -.LP
199.205 -\f2\-codebase <url>\fP
199.206 -.LP
199.207 -.RS 3
199.208 -
199.209 -.LP
199.210 -.LP
199.211 -Replaces the codebase with \f2<url>\fP in the jnlp file specified when importing the resources. \f2<url>\fP must be a valid \f2URL\fP.
199.212 -.LP
199.213 -.RE
199.214 -.LP
199.215 -\f2\-system\fP
199.216 -.LP
199.217 -.RS 3
199.218 -
199.219 -.LP
199.220 -.LP
199.221 -Uses the system cache instead of the user cache.
199.222 -.LP
199.223 -.RE
199.224 -.LP
199.225 -\f2\-shortcut\fP
199.226 -.LP
199.227 -.RS 3
199.228 -
199.229 -.LP
199.230 -.LP
199.231 -Allows the creation of shortcuts during silent import.
199.232 -.LP
199.233 -.RE
199.234 -.LP
199.235 -\f2\-association\fP
199.236 -.LP
199.237 -.RS 3
199.238 -
199.239 -.LP
199.240 -.LP
199.241 -Allows the creation of associations during silent import.
199.242 +disable the display of the initial splash screen.
199.243 .LP
199.244 .RE
199.245 .LP
199.246 @@ -234,17 +162,64 @@
199.247
199.248 .LP
199.249 .LP
199.250 -Runs in online mode (default behavior).
199.251 +run in online mode (default behavior).
199.252 .LP
199.253 .RE
199.254 .LP
199.255 +\f2\-wait\fP
199.256 +.LP
199.257 +.RS 3
199.258 +
199.259 +.LP
199.260 +.LP
199.261 +If specified, the \f2javaws\fP process will not exit until the application exits.
199.262 +.LP
199.263 +.RE
199.264 +.LP
199.265 +\f2\-verbose\fP
199.266 +.LP
199.267 +.RS 3
199.268 +
199.269 +.LP
199.270 +.LP
199.271 +display additional output.
199.272 +.LP
199.273 +.RE
199.274 +.LP
199.275 +\f2\-J<option>\fP
199.276 +.LP
199.277 +.RS 3
199.278 +
199.279 +.LP
199.280 +.LP
199.281 +supply options to the vm.
199.282 +.LP
199.283 +.RE
199.284 +.LP
199.285 +\f2\-system\fP
199.286 +.LP
199.287 +.RS 3
199.288 +
199.289 +.LP
199.290 +.LP
199.291 +run the application from the system cache only.
199.292 +.LP
199.293 +.RE
199.294 +.RE
199.295 +.SS
199.296 +CONTROL\-OPTIONS
199.297 +.LP
199.298 +.RS 3
199.299 +
199.300 +.LP
199.301 +.LP
199.302 \f2\-viewer\fP
199.303 .LP
199.304 .RS 3
199.305
199.306 .LP
199.307 .LP
199.308 -Runs the Java Application Cache Viewer (default if no URL is specified).
199.309 +show the Cache Viewer in the java control panel
199.310 .LP
199.311 .RE
199.312 .LP
199.313 @@ -254,7 +229,7 @@
199.314
199.315 .LP
199.316 .LP
199.317 -Clears the specified deployment property.
199.318 +clear the specified deployment property.
199.319 .LP
199.320 .RE
199.321 .LP
199.322 @@ -264,25 +239,96 @@
199.323
199.324 .LP
199.325 .LP
199.326 -Sets the specified deployment property to the specified value.
199.327 +set the specified deployment property to the specified value.
199.328 .LP
199.329 .RE
199.330 .LP
199.331 -\f2\-wait\fP
199.332 +\f2\-uninstall\fP
199.333 .LP
199.334 .RS 3
199.335
199.336 .LP
199.337 .LP
199.338 -If specified, the \f2javaws\fP process will not exit until the application exits.
199.339 +remove all applications from the cache.
199.340 .LP
199.341 .RE
199.342 .LP
199.343 -\
199.344 +\f2\-uninstall <jnlp>\fP
199.345 .LP
199.346 +.RS 3
199.347 +
199.348 +.LP
199.349 +.LP
199.350 +remove the application from the cache.
199.351 +.LP
199.352 +.RE
199.353 +.LP
199.354 +\f2\-import [import\-options] <jnlp>\fP
199.355 +.LP
199.356 +.RS 3
199.357 +
199.358 +.LP
199.359 +.LP
199.360 +import the application to the cache.
199.361 +.LP
199.362 +.RE
199.363 +\f3IMPORT\-OPTIONS\fP
199.364 +.LP
199.365 +.LP
199.366 +\f2\-silent\fP
199.367 +.LP
199.368 +.RS 3
199.369 +
199.370 +.LP
199.371 +.LP
199.372 +import silently (with no user interface).
199.373 +.LP
199.374 +.RE
199.375 +.LP
199.376 +\f2\-system\fP
199.377 +.LP
199.378 +.RS 3
199.379 +
199.380 +.LP
199.381 +.LP
199.382 +import application to the system cache.
199.383 +.LP
199.384 +.RE
199.385 +.LP
199.386 +\f2\-codebase <url>\fP
199.387 +.LP
199.388 +.RS 3
199.389 +
199.390 +.LP
199.391 +.LP
199.392 +retrieve resources from the given codebase.
199.393 +.LP
199.394 +.RE
199.395 +.LP
199.396 +\f2\-shortcut\fP
199.397 +.LP
199.398 +.RS 3
199.399 +
199.400 +.LP
199.401 +.LP
199.402 +install shortcuts as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
199.403 +.LP
199.404 +.RE
199.405 +.LP
199.406 +\f2\-association\fP
199.407 +.LP
199.408 +.RS 3
199.409 +
199.410 +.LP
199.411 +.LP
199.412 +install associations as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
199.413 +.LP
199.414 +.RE
199.415 +.RE
199.416 .SS
199.417 FILES
199.418 .LP
199.419 +.RS 3
199.420
199.421 .LP
199.422 .LP
199.423 @@ -292,15 +338,17 @@
199.424 .fi
199.425 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
199.426 .LP
199.427 +.RE
199.428 .SS
199.429 MORE INFORMATION
199.430 .LP
199.431 +.RS 3
199.432
199.433 .LP
199.434 .LP
199.435 For more information about Java Web Start, see
199.436 .na
199.437 -\f2Java Web Start version 1.5.0\fP @
199.438 +\f2Java Web Start\fP @
199.439 .fi
199.440 http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
199.441 .LP
199.442 @@ -311,4 +359,7 @@
199.443 \
199.444 .LP
199.445 .RE
199.446 +.RE
199.447 +
199.448 +.LP
199.449
200.1 --- a/src/solaris/doc/sun/man/man1/jconsole.1 Tue May 12 15:21:55 2009 +0900
200.2 +++ b/src/solaris/doc/sun/man/man1/jconsole.1 Thu May 14 00:17:25 2009 -0700
200.3 @@ -1,4 +1,3 @@
200.4 -.'" t
200.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
200.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
200.7 ."
200.8 @@ -19,12 +18,12 @@
200.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
200.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
200.11 ." have any questions.
200.12 -." `
200.13 -.TH jconsole 1 "07 Aug 2006"
200.14 -." Generated by html2man
200.15 +."
200.16 +.TH jconsole 1 "04 May 2009"
200.17 +." Generated from HTML by html2man (author: Eric Armstrong)
200.18
200.19 .LP
200.20 -.SH NAME
200.21 +.SH "Name"
200.22 jconsole \- Java Monitoring and Management Console
200.23 .LP
200.24 .SH "SYNOPSIS"
200.25 @@ -53,11 +52,23 @@
200.26 .TP 3
200.27 connection = pid | host:port | jmxUrl
200.28 .RS 3
200.29 -\f2pid\fP\ \ \ Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See JMX Monitoring and Management for details.
200.30 +\f2pid\fP\ \ \ Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See
200.31 +.na
200.32 +\f2JMX Monitoring and Management\fP @
200.33 +.fi
200.34 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
200.35 .br
200.36 -\f2host\fP:\f2port\fP\ \ Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See JMX Monitoring and Management for details.
200.37 +\f2host\fP:\f2port\fP\ \ Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See
200.38 +.na
200.39 +\f2JMX Monitoring and Management\fP @
200.40 +.fi
200.41 +http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
200.42 .br
200.43 -\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in JMXServiceURL.
200.44 +\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in
200.45 +.na
200.46 +\f2JMXServiceURL\fP @
200.47 +.fi
200.48 +http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html.
200.49 .RE
200.50 .RE
200.51
200.52 @@ -95,7 +106,11 @@
200.53 \fP
200.54 .fi
200.55 .LP
200.56 -containing one line for each plugin specifying the fully qualified class name of the class implementing the com.sun.tools.jconsole.JConsolePlugin class.
200.57 +containing one line for each plugin specifying the fully qualified class name of the class implementing the
200.58 +.na
200.59 +\f2com.sun.tools.jconsole.JConsolePlugin\fP @
200.60 +.fi
200.61 +http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
200.62 .TP 3
200.63 \-version\
200.64 Output version information and exit.
200.65 @@ -113,10 +128,16 @@
200.66 .RS 3
200.67 .TP 2
200.68 o
200.69 -Using JConsole
200.70 +.na
200.71 +\f2Using JConsole\fP @
200.72 +.fi
200.73 +http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
200.74 .TP 2
200.75 o
200.76 -Monitoring and Management for Java Platform
200.77 +.na
200.78 +\f2Monitoring and Management for Java Platform\fP @
200.79 +.fi
200.80 +http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
200.81 .RE
200.82
200.83 .LP
201.1 --- a/src/solaris/doc/sun/man/man1/jdb.1 Tue May 12 15:21:55 2009 +0900
201.2 +++ b/src/solaris/doc/sun/man/man1/jdb.1 Thu May 14 00:17:25 2009 -0700
201.3 @@ -1,5 +1,4 @@
201.4 -.'" t
201.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
201.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
201.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
201.8 ."
201.9 ." This code is free software; you can redistribute it and/or modify it
201.10 @@ -19,19 +18,21 @@
201.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
201.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
201.13 ." have any questions.
201.14 -." `
201.15 -.TH jdb 1 "05 Aug 2006"
201.16 -." Generated by html2roff
201.17 +."
201.18 +.TH jdb 1 "04 May 2009"
201.19 +." Generated from HTML by html2man (author: Eric Armstrong)
201.20
201.21 .LP
201.22 -.SH NAME
201.23 +.SH "Name"
201.24 jdb \- The Java Debugger
201.25 .LP
201.26 +.RS 3
201.27
201.28 .LP
201.29 .LP
201.30 \f3jdb\fP helps you find and fix bugs in Java language programs.
201.31 .LP
201.32 +.RE
201.33 .SH "SYNOPSIS"
201.34 .LP
201.35
201.36 @@ -47,6 +48,7 @@
201.37 .RS 3
201.38
201.39 .LP
201.40 +.RS 3
201.41 .TP 3
201.42 options
201.43 Command\-line options, as specified below.
201.44 @@ -56,6 +58,8 @@
201.45 .TP 3
201.46 arguments
201.47 Arguments passed to the \f2main()\fP method of \f2class\fP.
201.48 +.RE
201.49 +
201.50 .LP
201.51 .RE
201.52 .SH "DESCRIPTION"
201.53 @@ -72,6 +76,7 @@
201.54 .SS
201.55 Starting a jdb Session
201.56 .LP
201.57 +.RS 3
201.58
201.59 .LP
201.60 .LP
201.61 @@ -133,11 +138,11 @@
201.62 .na
201.63 \f2documentation\fP @
201.64 .fi
201.65 -http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see
201.66 +http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection options. For information on starting a J2SE 1.4.2 or early VM for use with \f3jdb\fP see the
201.67 .na
201.68 \f21.4.2 documentation\fP @
201.69 .fi
201.70 -http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
201.71 +http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.html
201.72 .LP
201.73 .SS
201.74 Basic jdb Commands
201.75 @@ -148,6 +153,7 @@
201.76 .RS 3
201.77
201.78 .LP
201.79 +.RS 3
201.80 .TP 3
201.81 help, or ?
201.82 The most important \f3jdb\fP command, \f2help\fP displays the list of recognized commands with a brief description.
201.83 @@ -161,24 +167,24 @@
201.84 print
201.85 Displays Java objects and primitive values. For variables or fields of primitive types, the actual value is printed. For objects, a short description is printed. See the \f2dump\fP command below for getting more information about an object.
201.86 .LP
201.87 -\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac\fP\f2 \fP\f2\-g\fP option.
201.88 +\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP option.
201.89 .LP
201.90 \f2print\fP supports many simple Java expressions including those with method invocations, for example:
201.91 .RS 3
201.92 .TP 2
201.93 -*
201.94 +o
201.95 \f2print MyClass.myStaticField\fP
201.96 .TP 2
201.97 -*
201.98 +o
201.99 \f2print myObj.myInstanceField\fP
201.100 .TP 2
201.101 -*
201.102 +o
201.103 \f2print i + j + k\fP \f2(i, j, k are primities and either fields or local variables)\fP
201.104 .TP 2
201.105 -*
201.106 +o
201.107 \f2print myObj.myMethod()\fP \f2(if myMethod returns a non\-null)\fP
201.108 .TP 2
201.109 -*
201.110 +o
201.111 \f2print new java.lang.String("Hello").length()\fP
201.112 .RE
201.113 .TP 3
201.114 @@ -209,11 +215,14 @@
201.115 \f2where\fP with no arguments dumps the stack of the current thread. \f2where all\fP dumps the stack of all threads in the current thread group. \f2where\fP \f2threadindex\fP dumps the stack of the specified thread.
201.116 .LP
201.117 If the current thread is suspended (either through an event such as a breakpoint or through the \f2suspend\fP command), local variables and fields can be displayed with the \f2print\fP and \f2dump\fP commands. The \f2up\fP and \f2down\fP commands select which stack frame is current.
201.118 +.RE
201.119 +
201.120 .LP
201.121 .RE
201.122 .SS
201.123 Breakpoints
201.124 .LP
201.125 +.RS 3
201.126
201.127 .LP
201.128 .LP
201.129 @@ -221,16 +230,16 @@
201.130 .LP
201.131 .RS 3
201.132 .TP 2
201.133 -*
201.134 +o
201.135 \f2stop at MyClass:22\fP \f2(sets a breakpoint at the first instruction for line 22 of the source file containing MyClass)\fP
201.136 .TP 2
201.137 -*
201.138 +o
201.139 \f2stop in java.lang.String.length\fP \f2(sets a breakpoint at the beginnig of the method \fP\f2java.lang.String.length\fP)
201.140 .TP 2
201.141 -*
201.142 +o
201.143 \f2stop in MyClass.<init>\fP \f2(<init> identifies the MyClass constructor)\fP
201.144 .TP 2
201.145 -*
201.146 +o
201.147 \f2stop in MyClass.<clinit>\fP \f2(<clinit> identifies the static initialization code for MyClass)\fP
201.148 .RE
201.149
201.150 @@ -241,17 +250,21 @@
201.151 .LP
201.152 The \f2clear\fP command removes breakpoints using a syntax as in "\f2clear\ MyClass:45\fP". Using the \f2clear\fP or command with no argument displays a list of all breakpoints currently set. The \f2cont\fP command continues execution.
201.153 .LP
201.154 +.RE
201.155 .SS
201.156 Stepping
201.157 .LP
201.158 +.RS 3
201.159
201.160 .LP
201.161 .LP
201.162 The \f2step\fP commands advances execution to the next line whether it is in the current stack frame or a called method. The \f2next\fP command advances execution to the next line in the current stack frame.
201.163 .LP
201.164 +.RE
201.165 .SS
201.166 Exceptions
201.167 .LP
201.168 +.RS 3
201.169
201.170 .LP
201.171 .LP
201.172 @@ -266,6 +279,8 @@
201.173 .LP
201.174 \f2NOTE: The \fP\f2ignore\fP command does not cause the debugged VM to ignore specific exceptions, only the debugger.
201.175 .LP
201.176 +.RE
201.177 +.RE
201.178 .SH "Command Line Options"
201.179 .LP
201.180
201.181 @@ -276,6 +291,7 @@
201.182 .LP
201.183 The following additional options are accepted by \f3jdb\fP:
201.184 .LP
201.185 +.RS 3
201.186 .TP 3
201.187 \-help
201.188 Displays a help message.
201.189 @@ -298,8 +314,7 @@
201.190 \-listconnectors
201.191 List the connectors available in this VM
201.192 .TP 3
201.193 -\-connect
201.194 -<connector\-name>:<name1>=<value1>,...
201.195 +\-connect <connector\-name>:<name1>=<value1>,...
201.196 Connects to target VM using named connector with listed argument values.
201.197 .TP 3
201.198 \-dbgtrace [flags]
201.199 @@ -313,6 +328,8 @@
201.200 .TP 3
201.201 \-Joption
201.202 Pass \f2option\fP to the Java virtual machine used to run jdb. (Options for the application Java virtual machine are passed to the \f3run\fP command.) For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
201.203 +.RE
201.204 +
201.205 .LP
201.206 .LP
201.207 Other options are supported for alternate mechanisms for connecting the debugger and the VM it is to debug. The Java Platform Debugger Architecture has additional
201.208 @@ -324,6 +341,7 @@
201.209 .SS
201.210 Options Forwarded to Debuggee Process
201.211 .LP
201.212 +.RS 3
201.213 .TP 3
201.214 \-v \-verbose[:class|gc|jni]
201.215 Turns on verbose mode.
201.216 @@ -331,19 +349,20 @@
201.217 \-D<name>=<value>
201.218 Sets a system property.
201.219 .TP 3
201.220 -\-classpath <directories separated by
201.221 -":">
201.222 +\-classpath <directories separated by ":">
201.223 Lists directories in which to look for classes.
201.224 .TP 3
201.225 \-X<option>
201.226 Non\-standard target VM option
201.227 +.RE
201.228 +
201.229 .LP
201.230 .SH "SEE ALSO"
201.231 .LP
201.232
201.233 .LP
201.234 .LP
201.235 -javac, java, javah, javap, javadoc.
201.236 +javac(1), java(1), javah(1), javap(1), javadoc(1).
201.237 .LP
201.238
201.239 .LP
202.1 --- a/src/solaris/doc/sun/man/man1/jhat.1 Tue May 12 15:21:55 2009 +0900
202.2 +++ b/src/solaris/doc/sun/man/man1/jhat.1 Thu May 14 00:17:25 2009 -0700
202.3 @@ -1,4 +1,3 @@
202.4 -.'" t
202.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
202.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
202.7 ."
202.8 @@ -19,12 +18,12 @@
202.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
202.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
202.11 ." have any questions.
202.12 -." `
202.13 -.TH jhat 1 "05 Aug 2006"
202.14 -." Generated by html2roff
202.15 +."
202.16 +.TH jhat 1 "04 May 2009"
202.17 +." Generated from HTML by html2man (author: Eric Armstrong)
202.18
202.19 .LP
202.20 -.SH NAME
202.21 +.SH "Name"
202.22 jhat \- Java Heap Analysis Tool
202.23 .LP
202.24 .SH "SYNOPSIS"
202.25 @@ -45,16 +44,15 @@
202.26 .LP
202.27
202.28 .LP
202.29 +.RS 3
202.30 .TP 3
202.31 options
202.32 Options, if used, should follow immediately after the command name.
202.33 +.br
202.34 .TP 3
202.35 heap\-dump\-file
202.36 Java binary heap dump file to be browsed. For a dump file that contains multiple heap dumps, you may specify which dump in the file by appending "#<number> to the file name, i.e. "foo.hprof#3".
202.37 -.LP
202.38 -.SH "DESCRIPTION"
202.39 -.LP
202.40 -
202.41 +.SH "DESCRIPTION"
202.42 .LP
202.43 .LP
202.44 The \f3jhat\fP command parses a java heap dump file and launches a webserver. jhat enables you to browse heap dumps using your favorite webbrowser. jhat supports pre\-designed queries (such as 'show all instances of a known class "Foo"') as well as \f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) \- a SQL\-like query language to query heap dumps. Help on OQL is available from the OQL help page shown by jhat. With the default port, OQL help is available at http://localhost:7000/oqlhelp/
202.45 @@ -64,20 +62,20 @@
202.46 .LP
202.47 .RS 3
202.48 .TP 2
202.49 -*
202.50 -Use jmap \-dump option to obtain a heap dump at runtime;
202.51 +o
202.52 +Use jmap(1) \-dump option to obtain a heap dump at runtime;
202.53 .TP 2
202.54 -*
202.55 -Use jconsole option to obtain a heap dump via
202.56 +o
202.57 +Use jconsole(1) option to obtain a heap dump via
202.58 .na
202.59 \f2HotSpotDiagnosticMXBean\fP @
202.60 .fi
202.61 -http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html at runtime;
202.62 +http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html at runtime;
202.63 .TP 2
202.64 -*
202.65 +o
202.66 Heap dump will be generated when OutOfMemoryError is thrown by specifying \-XX:+HeapDumpOnOutOfMemoryError VM option;
202.67 .TP 2
202.68 -*
202.69 +o
202.70 Use
202.71 .na
202.72 \f2hprof\fP @
202.73 @@ -89,10 +87,8 @@
202.74 .LP
202.75 \f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
202.76 .LP
202.77 -.SH "OPTIONS"
202.78 -.LP
202.79 -
202.80 -.LP
202.81 +.SH "OPTIONS"
202.82 +.RS 3
202.83 .TP 3
202.84 \-stack false/true
202.85 Turn off tracking object allocation call stack. Note that if allocation site information is not available in the heap dump, you have to set this flag to false. Default is true.
202.86 @@ -123,25 +119,23 @@
202.87 .TP 3
202.88 \-J<flag>\
202.89 Pass <flag> to the Java virtual machine on which jhat is run. For example, \-J\-Xmx512m to use a maximum heap size of 512MB.
202.90 +.RE
202.91 +
202.92 .LP
202.93 -.SH "SEE ALSO"
202.94 -.LP
202.95 +.SH "SEE ALSO"
202.96 .RS 3
202.97 .TP 2
202.98 -*
202.99 -jmap \- Java Memory Map
202.100 +o
202.101 +jmap(1)
202.102 .TP 2
202.103 -*
202.104 -jconsole \- Java Monitoring and Management Console
202.105 +o
202.106 +jconsole(1)
202.107 .TP 2
202.108 -*
202.109 +o
202.110 .na
202.111 \f2hprof \- Heap and CPU profiling tool\fP @
202.112 .fi
202.113 http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
202.114 .RE
202.115 -
202.116 -.LP
202.117 -
202.118 -.LP
202.119 +.RE
202.120
203.1 --- a/src/solaris/doc/sun/man/man1/jinfo.1 Tue May 12 15:21:55 2009 +0900
203.2 +++ b/src/solaris/doc/sun/man/man1/jinfo.1 Thu May 14 00:17:25 2009 -0700
203.3 @@ -1,4 +1,3 @@
203.4 -.'" t
203.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
203.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
203.7 ."
203.8 @@ -19,12 +18,12 @@
203.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
203.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
203.11 ." have any questions.
203.12 -." `
203.13 -.TH jinfo 1 "05 Aug 2006"
203.14 -." Generated by html2roff
203.15 +."
203.16 +.TH jinfo 1 "04 May 2009"
203.17 +." Generated from HTML by html2man (author: Eric Armstrong)
203.18
203.19 .LP
203.20 -.SH NAME
203.21 +.SH "Name"
203.22 jinfo \- Configuration Info
203.23 .LP
203.24 .SH "SYNOPSIS"
203.25 @@ -47,24 +46,37 @@
203.26 .LP
203.27
203.28 .LP
203.29 +.RS 3
203.30 .TP 3
203.31 option
203.32 Options are mutually exclusive. Option, if used, should follow immediately after the command name.
203.33 +.RS 3
203.34 .TP 3
203.35 pid
203.36 -process id for which the configuration info is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
203.37 +process id for which the configuration info is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
203.38 +.RE
203.39 +.RS 3
203.40 .TP 3
203.41 executable
203.42 -Java executable from which the core dump was produced.
203.43 +Java executable from which the core dump was produced.
203.44 +.RE
203.45 +.RS 3
203.46 .TP 3
203.47 core
203.48 -core file for which the configuration info is to be printed.
203.49 +core file for which the configuration info is to be printed.
203.50 +.RE
203.51 +.RS 3
203.52 .TP 3
203.53 remote\-hostname\-or\-IP
203.54 -remote debug server's (see jsadebugd) hostname or IP address.
203.55 +remote debug server's (see jsadebugd(1)) hostname or IP address.
203.56 +.RE
203.57 +.RS 3
203.58 .TP 3
203.59 server\-id
203.60 -optional unique id, if multiple debug servers are running on the same remote host.
203.61 +optional unique id, if multiple debug servers are running on the same remote host.
203.62 +.RE
203.63 +.RE
203.64 +
203.65 .LP
203.66 .SH "DESCRIPTION"
203.67 .LP
203.68 @@ -81,12 +93,16 @@
203.69 jinfo \-J\-d64 \-sysprops pid
203.70 .RE
203.71 .LP
203.72 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. On Windows, jinfo only supports the \-flag option of a running process.\fP
203.73 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' need to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
203.74 +.LP
203.75 +.LP
203.76 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
203.77 .LP
203.78 .SH "OPTIONS"
203.79 .LP
203.80
203.81 .LP
203.82 +.RS 3
203.83 .TP 3
203.84 <no option>
203.85 prints both command line flags as well as System properties name, value pairs.
203.86 @@ -117,16 +133,18 @@
203.87 .TP 3
203.88 \-help
203.89 prints a help message
203.90 +.RE
203.91 +
203.92 .LP
203.93 .SH "SEE ALSO"
203.94 .LP
203.95 .RS 3
203.96 .TP 2
203.97 -*
203.98 -jps
203.99 +o
203.100 +jps(1)
203.101 .TP 2
203.102 -*
203.103 -jsadebugd
203.104 +o
203.105 +jsadebugd(1)
203.106 .RE
203.107
203.108 .LP
204.1 --- a/src/solaris/doc/sun/man/man1/jmap.1 Tue May 12 15:21:55 2009 +0900
204.2 +++ b/src/solaris/doc/sun/man/man1/jmap.1 Thu May 14 00:17:25 2009 -0700
204.3 @@ -1,4 +1,3 @@
204.4 -.'" t
204.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
204.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
204.7 ."
204.8 @@ -19,12 +18,12 @@
204.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
204.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
204.11 ." have any questions.
204.12 -." `
204.13 -.TH jmap 1 "05 Aug 2006"
204.14 -." Generated by html2roff
204.15 +."
204.16 +.TH jmap 1 "04 May 2009"
204.17 +." Generated from HTML by html2man (author: Eric Armstrong)
204.18
204.19 .LP
204.20 -.SH NAME
204.21 +.SH "Name"
204.22 jmap \- Memory Map
204.23 .LP
204.24 .SH "SYNOPSIS"
204.25 @@ -47,25 +46,31 @@
204.26 .LP
204.27
204.28 .LP
204.29 +.RS 3
204.30 .TP 3
204.31 option
204.32 Options are mutually exclusive. Option, if used, should follow immediately after the command name.
204.33 .TP 3
204.34 pid
204.35 -process id for which the memory map is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
204.36 +process id for which the memory map is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
204.37 +.br
204.38 .TP 3
204.39 executable
204.40 Java executable from which the core dump was produced.
204.41 +.br
204.42 .TP 3
204.43 core
204.44 core file for which the memory map is to be printed.
204.45 +.br
204.46 .TP 3
204.47 remote\-hostname\-or\-IP
204.48 -remote debug server's (see jsadebugd) hostname or IP address.
204.49 +remote debug server's (see jsadebugd(1)) hostname or IP address.
204.50 +.br
204.51 .TP 3
204.52 server\-id
204.53 optional unique id, if multiple debug servers are running on the same remote host.
204.54 .br
204.55 +.RE
204.56
204.57 .LP
204.58 .SH "DESCRIPTION"
204.59 @@ -88,76 +93,78 @@
204.60 .RE
204.61
204.62 .LP
204.63 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK.\fP
204.64 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
204.65 +.LP
204.66 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
204.67 +.LP
204.68 .br
204.69
204.70 .LP
204.71 -The only forms of jmap available on the Windows platform are
204.72 -.RS 3
204.73 -
204.74 -.LP
204.75 -jmap \-dump:<\f2dump\-options\fP> pid
204.76 -.RE
204.77 -and
204.78 -.RS 3
204.79 -
204.80 -.LP
204.81 -jmap \-histo[:live] pid
204.82 -.RE
204.83 .SH "OPTIONS"
204.84 .LP
204.85
204.86 .LP
204.87 +.RS 3
204.88 .TP 3
204.89 -<no
204.90 -option>
204.91 -When no option is used jmap prints shared object mappings. For each shared object loaded in the target VM, start address, the size of the mapping, and the full path of the shared object file are printed. This is similar to the Solaris \f3pmap\fP utility.
204.92 +<no option>
204.93 +When no option is used \f3jmap\fP prints shared object mappings. For each shared object loaded in the target VM, start address, the size of the mapping, and the full path of the shared object file are printed. This is similar to the Solaris \f3pmap\fP utility.
204.94 +.br
204.95 .TP 3
204.96 \-dump:[live,]format=b,file=<filename>
204.97 -Dumps the Java heap in hprof binary format to filename. The \f2live\fP suboption is optional. If specified, only the live objects in the heap are dumped. To browse the heap dump, you can use jhat (Java Heap Analysis Tool) to read the generated file.
204.98 +Dumps the Java heap in hprof binary format to filename. The \f2live\fP suboption is optional. If specified, only the live objects in the heap are dumped. To browse the heap dump, you can use jhat(1) (Java Heap Analysis Tool) to read the generated file.
204.99 +.br
204.100 .TP 3
204.101 \-finalizerinfo
204.102 Prints information on objects awaiting finalization.
204.103 +.br
204.104 .TP 3
204.105 \-heap
204.106 Prints a heap summary. GC algorithm used, heap configuration and generation wise heap usage are printed.
204.107 +.br
204.108 .TP 3
204.109 \-histo[:live]
204.110 Prints a histogram of the heap. For each Java class, number of objects, memory size in bytes, and fully qualified class names are printed. VM internal class names are printed with '*' prefix. If the \f2live\fP suboption is specified, only live objects are counted.
204.111 +.br
204.112 .TP 3
204.113 \-permstat
204.114 Prints class loader wise statistics of permanent generation of Java heap. For each class loader, its name, liveness, address, parent class loader, and the number and size of classes it has loaded are printed. In addition, the number and size of interned Strings are printed.
204.115 +.br
204.116 .TP 3
204.117 \-F
204.118 Force. Use with jmap \-dump or jmap \-histo option if the pid does not respond. The \f2live\fP suboption is not supported in this mode.
204.119 +.br
204.120 .TP 3
204.121 \-h
204.122 Prints a help message.
204.123 .br
204.124 +.br
204.125 .TP 3
204.126 \-help
204.127 Prints a help message.
204.128 .br
204.129 +.br
204.130 .TP 3
204.131 \-J<flag>
204.132 Passes <flag> to the Java virtual machine on which jmap is run.
204.133 +.br
204.134 +.RE
204.135
204.136 .LP
204.137 .SH "SEE ALSO"
204.138 .LP
204.139 .RS 3
204.140 .TP 2
204.141 -*
204.142 -pmap (1)
204.143 +o
204.144 +pmap(1)
204.145 .TP 2
204.146 -*
204.147 -jhat
204.148 +o
204.149 +jhat(1)
204.150 .TP 2
204.151 -*
204.152 -jps
204.153 +o
204.154 +jps(1)
204.155 .TP 2
204.156 -*
204.157 -jsadebugd
204.158 +o
204.159 +jsadebugd(1)
204.160 .RE
204.161
204.162 .LP
205.1 --- a/src/solaris/doc/sun/man/man1/jps.1 Tue May 12 15:21:55 2009 +0900
205.2 +++ b/src/solaris/doc/sun/man/man1/jps.1 Thu May 14 00:17:25 2009 -0700
205.3 @@ -1,5 +1,4 @@
205.4 -.'" t
205.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
205.6 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
205.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
205.8 ."
205.9 ." This code is free software; you can redistribute it and/or modify it
205.10 @@ -19,12 +18,12 @@
205.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
205.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
205.13 ." have any questions.
205.14 -." `
205.15 -.TH jps 1 "06 Aug 2006"
205.16 -." Generated by html2man
205.17 +."
205.18 +.TH jps 1 "04 May 2009"
205.19 +." Generated from HTML by html2man (author: Eric Armstrong)
205.20
205.21 .LP
205.22 -.SH NAME
205.23 +.SH "Name"
205.24 jps \- Java Virtual Machine Process Status Tool
205.25 .LP
205.26 .SH "SYNOPSIS"
205.27 @@ -45,12 +44,15 @@
205.28 .LP
205.29
205.30 .LP
205.31 +.RS 3
205.32 .TP 3
205.33 options
205.34 Command\-line options.
205.35 .TP 3
205.36 hostid
205.37 The host identifier of the host for which the process report should be generated. The \f2hostid\fP may include optional components that indicate the communications protocol, port number, and other implementation specific data.
205.38 +.RE
205.39 +
205.40 .LP
205.41 .SH "DESCRIPTION"
205.42 .LP
205.43 @@ -81,6 +83,7 @@
205.44 .LP
205.45 The \f3jps\fP command supports a number of options that modify the output of the command. These options are subject to change or removal in the future.
205.46 .LP
205.47 +.RS 3
205.48 .TP 3
205.49 \-q
205.50 Suppress the output of the class name, JAR file name, and arguments passed to the \f2main\fP method, producing only a list of local VM identifiers.
205.51 @@ -99,6 +102,8 @@
205.52 .TP 3
205.53 \-Joption
205.54 Pass \f2option\fP to the \f3java\fP launcher called by \f3jps\fP. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying VM executing applications written in Java.
205.55 +.RE
205.56 +
205.57 .LP
205.58 .SS
205.59 HOST IDENTIFIER
205.60 @@ -120,6 +125,7 @@
205.61 .fi
205.62
205.63 .LP
205.64 +.RS 3
205.65 .TP 3
205.66 protocol
205.67 The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific, optimized, local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
205.68 @@ -131,7 +137,9 @@
205.69 The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
205.70 .TP 3
205.71 servername
205.72 -The treatment of this parameter depends on the implementation. For the optimized, local protocol, this field is ignored. For the \f3rmi\fP protocol, this parameter is a string representing the name of the RMI remote object on the remote host. See the \f3\-n\fP option for the \f3jstatd\fP command.
205.73 +The treatment of this parameter depends on the implementation. For the optimized, local protocol, this field is ignored. For the \f3rmi\fP protocol, this parameter is a string representing the name of the RMI remote object on the remote host. See the \f3\-n\fP option for the jstatd(1) command.
205.74 +.RE
205.75 +
205.76 .LP
205.77 .RE
205.78 .SH "OUTPUT FORMAT"
205.79 @@ -205,7 +213,7 @@
205.80 .br
205.81
205.82 .fl
205.83 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
205.84 +3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
205.85 .br
205.86
205.87 .fl
205.88 @@ -229,7 +237,7 @@
205.89 .br
205.90
205.91 .fl
205.92 -3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
205.93 +3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
205.94 .br
205.95
205.96 .fl
205.97 @@ -243,16 +251,16 @@
205.98 .RS 3
205.99 .TP 2
205.100 o
205.101 -java \- the Java Application Launcher
205.102 +java(1) \- the Java Application Launcher
205.103 .TP 2
205.104 o
205.105 -jstat \- the Java virtual machine Statistics Monitoring Tool
205.106 +jstat(1) \- the Java virtual machine Statistics Monitoring Tool
205.107 .TP 2
205.108 o
205.109 -jstatd \- the jstat daemon
205.110 +jstatd(1) \- the jstat daemon
205.111 .TP 2
205.112 o
205.113 -rmiregistry \- the Java Remote Object Registry
205.114 +rmiregistry(1) \- the Java Remote Object Registry
205.115 .RE
205.116
205.117 .LP
206.1 --- a/src/solaris/doc/sun/man/man1/jrunscript.1 Tue May 12 15:21:55 2009 +0900
206.2 +++ b/src/solaris/doc/sun/man/man1/jrunscript.1 Thu May 14 00:17:25 2009 -0700
206.3 @@ -1,4 +1,3 @@
206.4 -.'" t
206.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
206.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
206.7 ."
206.8 @@ -19,12 +18,12 @@
206.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
206.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
206.11 ." have any questions.
206.12 -." `
206.13 -.TH jrunscript 1 "06 Aug 2006"
206.14 -." Generated by html2man
206.15 +."
206.16 +.TH jrunscript 1 "04 May 2009"
206.17 +." Generated from HTML by html2man (author: Eric Armstrong)
206.18
206.19 .LP
206.20 -.SH NAME
206.21 +.SH "Name"
206.22 jrunscript \- command line script shell
206.23 .LP
206.24 .SH "SYNOPSIS"
206.25 @@ -43,12 +42,15 @@
206.26 .LP
206.27
206.28 .LP
206.29 +.RS 3
206.30 .TP 3
206.31 options
206.32 Options, if used, should follow immediately after the command name.
206.33 .TP 3
206.34 arguments
206.35 Arguments, if used, should follow immediately after options or command name.
206.36 +.RE
206.37 +
206.38 .LP
206.39 .SH "DESCRIPTION"
206.40 .LP
206.41 @@ -64,6 +66,7 @@
206.42 .LP
206.43
206.44 .LP
206.45 +.RS 3
206.46 .TP 3
206.47 \-classpath path
206.48 Specify where to find the user's .class files that are accessed by the script.
206.49 @@ -100,6 +103,8 @@
206.50 .TP 3
206.51 \-q\
206.52 List all script engines available and exit.
206.53 +.RE
206.54 +
206.55 .LP
206.56 .SH "ARGUMENTS"
206.57 .LP
207.1 --- a/src/solaris/doc/sun/man/man1/jsadebugd.1 Tue May 12 15:21:55 2009 +0900
207.2 +++ b/src/solaris/doc/sun/man/man1/jsadebugd.1 Thu May 14 00:17:25 2009 -0700
207.3 @@ -1,5 +1,4 @@
207.4 -.'" t
207.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
207.6 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
207.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
207.8 ."
207.9 ." This code is free software; you can redistribute it and/or modify it
207.10 @@ -19,12 +18,12 @@
207.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
207.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
207.13 ." have any questions.
207.14 -." `
207.15 -.TH jsadebugd 1 "05 Aug 2006"
207.16 -." Generated by html2roff
207.17 +."
207.18 +.TH jsadebugd 1 "04 May 2009"
207.19 +." Generated from HTML by html2man (author: Eric Armstrong)
207.20
207.21 .LP
207.22 -.SH NAME
207.23 +.SH "Name"
207.24 jsadebugd \- Serviceability Agent Debug Daemon
207.25 .LP
207.26 .SH "SYNOPSIS"
207.27 @@ -45,30 +44,49 @@
207.28 .LP
207.29
207.30 .LP
207.31 +.RS 3
207.32 .TP 3
207.33 pid
207.34 -process id of the process to which the debug server should attach. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used. At most one instance of the debug server may be attached to a single process.
207.35 +process id of the process to which the debug server should attach. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used. At most one instance of the debug server may be attached to a single process.
207.36 +.RE
207.37 +
207.38 .LP
207.39 +.RS 3
207.40 .TP 3
207.41 executable
207.42 +.RE
207.43 +
207.44 .LP
207.45 +.RS 3
207.46 .TP 3
207.47 Java executable from which the core dump was produced
207.48 +.RE
207.49 +
207.50 .LP
207.51 +.RS 3
207.52 .TP 3
207.53 core
207.54 Core file to which the debug server should attach.
207.55 +.RE
207.56 +
207.57 .LP
207.58 +.RS 3
207.59 .TP 3
207.60 server\-id
207.61 Optional unique id, needed if multiple debug servers are started on the same machine. This ID must be used by remote clients to identify the particular debug server to attach. Within a single machine, this ID must be unique.
207.62 +.RE
207.63 +
207.64 .LP
207.65 .SH "DESCRIPTION"
207.66 .LP
207.67
207.68 .LP
207.69 .LP
207.70 -\f3jsadebugd\fP attaches to a Java process or core file and acts as a debug server. Remote clients such as jstack, jmap, and jinfo can attach to the server using Java Remote Method Invocation (RMI). Before starting \f2jsadebugd\fP, rmiregistry must be started with:
207.71 +\f3jsadebugd\fP attaches to a Java process or core file and acts as a debug server. Remote clients such as jstack(1), jmap(1), and jinfo(1) can attach to the server using Java Remote Method Invocation (RMI). Before starting \f2jsadebugd\fP,
207.72 +.na
207.73 +\f2rmiregistry\fP @
207.74 +.fi
207.75 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi must be started with:
207.76 .LP
207.77 .RS 3
207.78
207.79 @@ -87,26 +105,32 @@
207.80 where \f2$JAVA_HOME\fP is the JDK installation directory. If rmiregistry was not started, jsadebugd will start an rmiregistry in a standard (1099) port internally. Debug server may be stopped by sending SIGINT (pressing Ctrl\-C) to it.
207.81 .LP
207.82 .LP
207.83 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. jsadebugd is not currently available on Windows platforms.\fP
207.84 +\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
207.85 +.LP
207.86 +.LP
207.87 +\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
207.88 .LP
207.89 .SH "SEE ALSO"
207.90 .LP
207.91 .RS 3
207.92 .TP 2
207.93 -*
207.94 -jinfo
207.95 +o
207.96 +jinfo(1)
207.97 .TP 2
207.98 -*
207.99 -jmap
207.100 +o
207.101 +jmap(1)
207.102 .TP 2
207.103 -*
207.104 -jps
207.105 +o
207.106 +jps(1)
207.107 .TP 2
207.108 -*
207.109 -jstack
207.110 +o
207.111 +jstack(1)
207.112 .TP 2
207.113 -*
207.114 -rmiregistry
207.115 +o
207.116 +.na
207.117 +\f2rmiregistry\fP @
207.118 +.fi
207.119 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
207.120 .RE
207.121
207.122 .LP
208.1 --- a/src/solaris/doc/sun/man/man1/jstack.1 Tue May 12 15:21:55 2009 +0900
208.2 +++ b/src/solaris/doc/sun/man/man1/jstack.1 Thu May 14 00:17:25 2009 -0700
208.3 @@ -1,5 +1,4 @@
208.4 -.'" t
208.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
208.6 +." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
208.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
208.8 ."
208.9 ." This code is free software; you can redistribute it and/or modify it
208.10 @@ -19,12 +18,12 @@
208.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
208.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
208.13 ." have any questions.
208.14 -." `
208.15 -.TH jstack 1 "07 Aug 2006"
208.16 -." Generated by html2man
208.17 +."
208.18 +.TH jstack 1 "04 May 2009"
208.19 +." Generated from HTML by html2man (author: Eric Armstrong)
208.20
208.21 .LP
208.22 -.SH NAME
208.23 +.SH "Name"
208.24 jstack \- Stack Trace
208.25 .br
208.26
208.27 @@ -55,7 +54,7 @@
208.28 .RS 3
208.29 .TP 3
208.30 pid
208.31 -process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
208.32 +process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
208.33 .RE
208.34
208.35 .LP
208.36 @@ -70,7 +69,7 @@
208.37 .br
208.38 .TP 3
208.39 remote\-hostname\-or\-IP
208.40 -remote debug server's (see jsadebugd) hostname or IP address.
208.41 +remote debug server's (see jsadebugd(1)) hostname or IP address.
208.42 .br
208.43 .TP 3
208.44 server\-id
208.45 @@ -101,15 +100,10 @@
208.46
208.47 .LP
208.48 .LP
208.49 -\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. The only form of jstack that is available on Windows platforms is\fP
208.50 +\f3NOTE\fP \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \f2PATH\fP environment variable should contain the location of \f2jvm.dll\fP used by the target process or the location from which the Crash Dump file was produced.
208.51 .LP
208.52 -.nf
208.53 -\f3
208.54 -.fl
208.55 -\fP\f3 jstack pid \fP
208.56 -.fl
208.57 -.fi
208.58 -
208.59 +.LP
208.60 +For example, \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
208.61 .LP
208.62 .SH "OPTIONS"
208.63 .LP
208.64 @@ -118,7 +112,14 @@
208.65 .RS 3
208.66 .TP 3
208.67 \-F
208.68 -Forces a stack dump when 'jstack pid' does not respond.
208.69 +Force a stack dump when 'jstack [\-l] pid' does not respond.
208.70 +.TP 3
208.71 +\-l
208.72 +Long listing. Prints additional information about locks such as list of owned java.util.concurrent
208.73 +.na
208.74 +\f2ownable synchronizers\fP @
208.75 +.fi
208.76 +http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html.
208.77 .TP 3
208.78 \-m
208.79 prints mixed mode (both Java and native C/C++ frames) stack trace.
208.80 @@ -145,10 +146,10 @@
208.81 c++filt(1)
208.82 .TP 2
208.83 o
208.84 -jps
208.85 +jps(1)
208.86 .TP 2
208.87 o
208.88 -jsadebugd
208.89 +jsadebugd(1)
208.90 .RE
208.91
208.92 .LP
209.1 --- a/src/solaris/doc/sun/man/man1/jstat.1 Tue May 12 15:21:55 2009 +0900
209.2 +++ b/src/solaris/doc/sun/man/man1/jstat.1 Thu May 14 00:17:25 2009 -0700
209.3 @@ -1,5 +1,4 @@
209.4 -.'" t
209.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
209.6 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
209.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
209.8 ."
209.9 ." This code is free software; you can redistribute it and/or modify it
209.10 @@ -19,25 +18,39 @@
209.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
209.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
209.13 ." have any questions.
209.14 -." `
209.15 -.TH jstat 1 "06 Aug 2006"
209.16 -." Generated by html2man
209.17 -.SH NAME
209.18 +."
209.19 +.TH jstat 1 "04 May 2009"
209.20 +." Generated from HTML by html2man (author: Eric Armstrong)
209.21 +
209.22 +.LP
209.23 +.SH "Name"
209.24 jstat \- Java Virtual Machine Statistics Monitoring Tool
209.25 +.LP
209.26 .SH "SYNOPSIS"
209.27 +.LP
209.28 +
209.29 +.LP
209.30 .nf
209.31 -\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP\f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
209.32 +\f3
209.33 +.fl
209.34 +\fP\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP \f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
209.35 .fl
209.36 .fi
209.37 +
209.38 +.LP
209.39 .SH "PARAMETERS"
209.40 +.LP
209.41 +
209.42 +.LP
209.43 +.RS 3
209.44 .TP 3
209.45 -generalOption
209.46 -A single general command\-line option (\-help, \-options, or \-version)
209.47 +generalOption
209.48 +A single general command\-line option (\-help, \-options, or \-version)
209.49 .TP 3
209.50 -outputOptions
209.51 -One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
209.52 +outputOptions
209.53 +One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
209.54 .TP 3
209.55 -vmid
209.56 +vmid
209.57 Virtual machine identifier, a string indicating the target Java virtual machine (JVM). The general syntax is
209.58 .nf
209.59 \f3
209.60 @@ -45,82 +58,124 @@
209.61 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
209.62 .fl
209.63 .fi
209.64 -The syntax of the vmid string largely corresponds to the syntax of a URI. The \f2vmid\fP can vary from a simple integer representing a local JVM to a more complex construction specifying a communications protocol, port number, and other implementation\-specific values. See Virtual Machine Identifier for details.
209.65 +The syntax of the vmid string largely corresponds to the syntax of a URI. The \f2vmid\fP can vary from a simple integer representing a local JVM to a more complex construction specifying a communications protocol, port number, and other implementation\-specific values. See Virtual Machine Identifier for details.
209.66 .TP 3
209.67 -interval[s|ms]
209.68 -Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds.\ Must be a positive integer.\ If specified, \f3jstat\fP will produce its output at each interval.
209.69 +interval[s|ms]
209.70 +Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds.\ Must be a positive integer.\ If specified, \f3jstat\fP will produce its output at each interval.
209.71 .TP 3
209.72 -count
209.73 -Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated.\ Must be a positive integer.
209.74 +count
209.75 +Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated.\ Must be a positive integer.
209.76 +.RE
209.77 +
209.78 +.LP
209.79 .SH "DESCRIPTION"
209.80 .LP
209.81 +
209.82 +.LP
209.83 +.LP
209.84 The \f3jstat\fP tool displays performance statistics for an instrumented HotSpot Java virtual machine (JVM). The target JVM is identified by its virtual machine identifier, or \f2vmid\fP option described below.
209.85 .LP
209.86 +.LP
209.87 \f3NOTE\fP: This utility is unsupported and may not be available in future versions of the JDK. It is not currently available on Windows 98 and Windows ME. platforms.
209.88 .br
209.89 +
209.90 +.LP
209.91 .SS
209.92 VIRTUAL MACHINE IDENTIFIER
209.93 .LP
209.94 +.RS 3
209.95 +
209.96 +.LP
209.97 +.LP
209.98 The syntax of the \f2vmid\fP string largely corresponds to the syntax of a URI:
209.99 +.LP
209.100 .nf
209.101 \f3
209.102 .fl
209.103 [\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP][:\f2port\fP][/\f2servername\fP]
209.104 .fl
209.105 .fi
209.106 +
209.107 +.LP
209.108 +.RS 3
209.109 .TP 3
209.110 -protocol
209.111 -The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific optimized local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
209.112 +protocol
209.113 +The communications protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is not specified, the default protocol is a platform specific optimized local protocol. If the \f2protocol\fP is omitted and a \f2hostname\fP is specified, then the default protocol is \f3rmi\fP.
209.114 .TP 3
209.115 -lvmid
209.116 -The local virtual machine identifier for the target JVM. The \f2lvmid\fP is a platform\-specific value that uniquely identifies a JVM on a system. The \f2lvmid\fP is the only required component of a virtual machine identifier. The \f2lvmid\fP is typically, but not necessarily, the operating system's process identifier for the target JVM process. You can use the \f3jps\fP command to determine the \f2lvmid\fP. Also, you can determine \f2lvmid\fP on Unix platforms with the \f3ps\fP command, and on Windows with the Windows Task Manager.
209.117 +lvmid
209.118 +The local virtual machine identifier for the target JVM. The \f2lvmid\fP is a platform\-specific value that uniquely identifies a JVM on a system. The \f2lvmid\fP is the only required component of a virtual machine identifier. The \f2lvmid\fP is typically, but not necessarily, the operating system's process identifier for the target JVM process. You can use the jps(1) command to determine the \f2lvmid\fP. Also, you can determine \f2lvmid\fP on Unix platforms with the \f3ps\fP command, and on Windows with the Windows Task Manager.
209.119 .TP 3
209.120 -hostname
209.121 -A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
209.122 +hostname
209.123 +A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
209.124 .TP 3
209.125 -port
209.126 -The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol, the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
209.127 +port
209.128 +The default port for communicating with the remote server. If the \f2hostname\fP is omitted or the \f2protocol\fP specifies an optimized, local protocol, then \f2port\fP is ignored. Otherwise, treatment of the \f2port\fP parameter is implementation specific. For the default \f3rmi\fP protocol, the \f2port\fP indicates the port number for the rmiregistry on the remote host. If \f2port\fP is omitted, and \f2protocol\fP indicates \f3rmi\fP, then the default rmiregistry port (1099) is used.
209.129 .TP 3
209.130 -servername
209.131 -The treatment of this parameter depends on implementation. For the optimized local protocol, this field is ignored. For the \f3rmi\fP protocol, it represents the name of the RMI remote object on the remote host.
209.132 +servername
209.133 +The treatment of this parameter depends on implementation. For the optimized local protocol, this field is ignored. For the \f3rmi\fP protocol, it represents the name of the RMI remote object on the remote host.
209.134 +.RE
209.135 +
209.136 +.LP
209.137 +.RE
209.138 .SH "OPTIONS"
209.139 .LP
209.140 +
209.141 +.LP
209.142 +.LP
209.143 The \f3jstat\fP command supports two types of options, general options and output options. General options cause \f3jstat\fP to display simple usage and version information. Output options determine the content and format of the statistical output.
209.144 .br
209.145 +
209.146 +.LP
209.147 .LP
209.148 \f3NOTE\fP: All options, and their functionality are subject to change or removal in future releases.
209.149 +.LP
209.150 .SS
209.151 -GENERAL
209.152 -OPTIONS
209.153 +GENERAL OPTIONS
209.154 +.LP
209.155 .LP
209.156 If you specify one of the general options, you cannot specify any other option or parameter.
209.157 +.LP
209.158 +.RS 3
209.159 .TP 3
209.160 -\-help
209.161 -Display help message.
209.162 +\-help
209.163 +Display help message.
209.164 .TP 3
209.165 -\-version
209.166 -Display version information.
209.167 +\-version
209.168 +Display version information.
209.169 .TP 3
209.170 -\-options
209.171 -Display list of statistics options. See the Output Options section below.
209.172 +\-options
209.173 +Display list of statistics options. See the Output Options section below.
209.174 +.RE
209.175 +
209.176 +.LP
209.177 .SS
209.178 -OUTPUT
209.179 -OPTIONS
209.180 +OUTPUT OPTIONS
209.181 +.LP
209.182 +.RS 3
209.183 +
209.184 +.LP
209.185 .LP
209.186 If you do not specify a general option, then you can specify output options. Output options determine the content and format of \f3jstat\fP's output, and consist of a single \f2statOption\fP, plus any of the other output options (\-h, \-t, and \-J).\ The \f2statOption\fP must come first.
209.187 .LP
209.188 +.LP
209.189 Output is formatted as a table, with columns are separated by spaces. A header row with titles describes the columns.\ Use the \f3\-h\fP option to set the frequency at which the header is displayed.\ Column header names are generally consistent between the different options. In general, if two options provide a column with the same name, then the data source for the two columns are the same.
209.190 .LP
209.191 +.LP
209.192 Use the \f3\-t\fP option to display a time stamp column, labeled \f2Timestamp\fP as the first column of output. The \f2Timestamp\fP column contains the elapsed time, in seconds, since startup of the target JVM. The resolution of the time stamp is dependent on various factors and is subject to variation due to delayed thread scheduling on heavily loaded systems.
209.193 .LP
209.194 +.LP
209.195 Use the \f2interval\fP and \f2count\fP parameters to determine how frequently and how many times, respectively, \f3jstat\fP displays its output.
209.196 .LP
209.197 +.LP
209.198 \f3NOTE\fP: You are advised not to write scripts to parse \f3jstat's\fP output since the format may change in future releases. If you choose to write scripts that parse \f3jstat\fP output, expect to modify them for future releases of this tool.
209.199 +.LP
209.200 +.RS 3
209.201 .TP 3
209.202 -\-statOption
209.203 +\-statOption
209.204 Determines the statistics information that \f3jstat\fP displays. The following table lists the available options.\ Use the \f3\-options\fP general option to display the list of options for a particular platform installation.
209.205 .br
209.206 .br
209.207 +.LP
209.208 .TS
209.209 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.210 .de 35
209.211 @@ -403,7 +458,7 @@
209.212 .nr 41 \n(80+(3*\n(38)
209.213 .nr 81 +\n(41
209.214 .nr TW \n(81
209.215 -.if t .if \n(TW>\n(.li .tm Table at line 158 file Input is too wide - \n(TW units
209.216 +.if t .if \n(TW>\n(.li .tm Table at line 231 file Input is too wide - \n(TW units
209.217 .fc
209.218 .nr #T 0-1
209.219 .nr #a 0-1
209.220 @@ -632,39 +687,33 @@
209.221 .TE
209.222 .if \n-(b.=0 .nr c. \n(.c-\n(d.-52
209.223 .TP 3
209.224 -\-hn
209.225 -Display a column header every \f2n\fP samples (output rows), where \f2n\fP is a positive integer. Default value is 0, which displays the column header above the first row of data.
209.226 +\-h n
209.227 +Display a column header every \f2n\fP samples (output rows), where \f2n\fP is a positive integer. Default value is 0, which displays the column header above the first row of data.
209.228 .TP 3
209.229 -\-tn
209.230 -Display a timestamp column as the first column of output. The timestamp is the the time since the start time of the target JVM.
209.231 +\-t n
209.232 +Display a timestamp column as the first column of output. The timestamp is the time since the start time of the target JVM.
209.233 .TP 3
209.234 -\-JjavaOption
209.235 -Pass \f2javaOption\fP to the \f3java\fP application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. For a complete list of options, see the following documents:
209.236 -.RS 3
209.237 -.TP 2
209.238 -*
209.239 -.na
209.240 -\f2java \- the Java application launcher (Solaris)\fP @
209.241 -.fi
209.242 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html
209.243 -.TP 2
209.244 -*
209.245 -.na
209.246 -\f2java \- the Java application launcher (Linux)\fP @
209.247 -.fi
209.248 -http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html
209.249 -.TP 2
209.250 -*
209.251 -java \- the Java application launcher (Windows)
209.252 +\-JjavaOption
209.253 +Pass \f2javaOption\fP to the \f3java\fP application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. For a complete list of options, see java(1)
209.254 +.RE
209.255 +
209.256 +.LP
209.257 .RE
209.258 .SS
209.259 -STATOPTIONS AND
209.260 -OUTPUT
209.261 +STATOPTIONS AND OUTPUT
209.262 +.LP
209.263 +.RS 3
209.264 +
209.265 +.LP
209.266 .LP
209.267 The following tables summarize the columns that \f3jstat\fP outputs for each \f2statOption\fP.
209.268 .br
209.269 +
209.270 +.LP
209.271 .SS
209.272 \-class Option
209.273 +.LP
209.274 +.LP
209.275 .TS
209.276 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.277 .de 35
209.278 @@ -777,7 +826,7 @@
209.279 .nr 41 \n(80+(3*\n(38)
209.280 .nr 81 +\n(41
209.281 .nr TW \n(81
209.282 -.if t .if \n(TW>\n(.li .tm Table at line 214 file Input is too wide - \n(TW units
209.283 +.if t .if \n(TW>\n(.li .tm Table at line 281 file Input is too wide - \n(TW units
209.284 .fc
209.285 .nr #T 0-1
209.286 .nr #a 0-1
209.287 @@ -864,9 +913,12 @@
209.288 .rm c+
209.289 .TE
209.290 .if \n-(b.=0 .nr c. \n(.c-\n(d.-21
209.291 +
209.292 +.LP
209.293 .SS
209.294 -\-compiler
209.295 -Option
209.296 +\-compiler Option
209.297 +.LP
209.298 +.LP
209.299 .TS
209.300 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.301 .de 35
209.302 @@ -1031,7 +1083,7 @@
209.303 .nr 41 \n(80+(3*\n(38)
209.304 .nr 81 +\n(41
209.305 .nr TW \n(81
209.306 -.if t .if \n(TW>\n(.li .tm Table at line 247 file Input is too wide - \n(TW units
209.307 +.if t .if \n(TW>\n(.li .tm Table at line 317 file Input is too wide - \n(TW units
209.308 .fc
209.309 .nr #T 0-1
209.310 .nr #a 0-1
209.311 @@ -1161,8 +1213,12 @@
209.312 .rm f+
209.313 .TE
209.314 .if \n-(b.=0 .nr c. \n(.c-\n(d.-29
209.315 +
209.316 +.LP
209.317 .SS
209.318 \-gc Option
209.319 +.LP
209.320 +.LP
209.321 .TS
209.322 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.323 .de 35
209.324 @@ -1491,7 +1547,7 @@
209.325 .nr 41 \n(80+(3*\n(38)
209.326 .nr 81 +\n(41
209.327 .nr TW \n(81
209.328 -.if t .if \n(TW>\n(.li .tm Table at line 313 file Input is too wide - \n(TW units
209.329 +.if t .if \n(TW>\n(.li .tm Table at line 387 file Input is too wide - \n(TW units
209.330 .fc
209.331 .nr #T 0-1
209.332 .nr #a 0-1
209.333 @@ -1761,8 +1817,12 @@
209.334 .rm n+
209.335 .TE
209.336 .if \n-(b.=0 .nr c. \n(.c-\n(d.-63
209.337 +
209.338 +.LP
209.339 .SS
209.340 \-gccapacity Option
209.341 +.LP
209.342 +.LP
209.343 .TS
209.344 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.345 .de 35
209.346 @@ -2111,7 +2171,7 @@
209.347 .nr 41 \n(80+(3*\n(38)
209.348 .nr 81 +\n(41
209.349 .nr TW \n(81
209.350 -.if t .if \n(TW>\n(.li .tm Table at line 383 file Input is too wide - \n(TW units
209.351 +.if t .if \n(TW>\n(.li .tm Table at line 461 file Input is too wide - \n(TW units
209.352 .fc
209.353 .nr #T 0-1
209.354 .nr #a 0-1
209.355 @@ -2398,11 +2458,15 @@
209.356 .rm o+
209.357 .TE
209.358 .if \n-(b.=0 .nr c. \n(.c-\n(d.-67
209.359 +
209.360 +.LP
209.361 .SS
209.362 -\-gccause
209.363 -Option
209.364 +\-gccause Option
209.365 +.LP
209.366 .LP
209.367 This option displays the same summary of garbage collection statistics as the \f3\-gcutil\fP option, but includes the causes of the last garbage collection event and (if applicable) the current garbage collection event. In addition to the columns listed for \f3\-gcutil\fP, this option adds the following columns:
209.368 +.LP
209.369 +.LP
209.370 .TS
209.371 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.372 .de 35
209.373 @@ -2487,7 +2551,7 @@
209.374 .nr 41 \n(80+(3*\n(38)
209.375 .nr 81 +\n(41
209.376 .nr TW \n(81
209.377 -.if t .if \n(TW>\n(.li .tm Table at line 402 file Input is too wide - \n(TW units
209.378 +.if t .if \n(TW>\n(.li .tm Table at line 484 file Input is too wide - \n(TW units
209.379 .fc
209.380 .nr #T 0-1
209.381 .nr #a 0-1
209.382 @@ -2549,8 +2613,12 @@
209.383 .rm b+
209.384 .TE
209.385 .if \n-(b.=0 .nr c. \n(.c-\n(d.-13
209.386 +
209.387 +.LP
209.388 .SS
209.389 \-gcnew Option
209.390 +.LP
209.391 +.LP
209.392 .TS
209.393 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.394 .de 35
209.395 @@ -2799,7 +2867,7 @@
209.396 .nr 41 \n(80+(3*\n(38)
209.397 .nr 81 +\n(41
209.398 .nr TW \n(81
209.399 -.if t .if \n(TW>\n(.li .tm Table at line 452 file Input is too wide - \n(TW units
209.400 +.if t .if \n(TW>\n(.li .tm Table at line 538 file Input is too wide - \n(TW units
209.401 .fc
209.402 .nr #T 0-1
209.403 .nr #a 0-1
209.404 @@ -3001,8 +3069,12 @@
209.405 .rm j+
209.406 .TE
209.407 .if \n-(b.=0 .nr c. \n(.c-\n(d.-47
209.408 +
209.409 +.LP
209.410 .SS
209.411 \-gcnewcapacity Option
209.412 +.LP
209.413 +.LP
209.414 .TS
209.415 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.416 .de 35
209.417 @@ -3250,7 +3322,7 @@
209.418 .nr 41 \n(80+(3*\n(38)
209.419 .nr 81 +\n(41
209.420 .nr TW \n(81
209.421 -.if t .if \n(TW>\n(.li .tm Table at line 504 file Input is too wide - \n(TW units
209.422 +.if t .if \n(TW>\n(.li .tm Table at line 594 file Input is too wide - \n(TW units
209.423 .fc
209.424 .nr #T 0-1
209.425 .nr #a 0-1
209.426 @@ -3452,8 +3524,12 @@
209.427 .rm j+
209.428 .TE
209.429 .if \n-(b.=0 .nr c. \n(.c-\n(d.-49
209.430 +
209.431 +.LP
209.432 .SS
209.433 \-gcold Option
209.434 +.LP
209.435 +.LP
209.436 .TS
209.437 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.438 .de 35
209.439 @@ -3642,7 +3718,7 @@
209.440 .nr 41 \n(80+(3*\n(38)
209.441 .nr 81 +\n(41
209.442 .nr TW \n(81
209.443 -.if t .if \n(TW>\n(.li .tm Table at line 542 file Input is too wide - \n(TW units
209.444 +.if t .if \n(TW>\n(.li .tm Table at line 636 file Input is too wide - \n(TW units
209.445 .fc
209.446 .nr #T 0-1
209.447 .nr #a 0-1
209.448 @@ -3793,8 +3869,12 @@
209.449 .rm g+
209.450 .TE
209.451 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
209.452 +
209.453 +.LP
209.454 .SS
209.455 \-gcoldcapacity Option
209.456 +.LP
209.457 +.LP
209.458 .TS
209.459 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.460 .de 35
209.461 @@ -3983,7 +4063,7 @@
209.462 .nr 41 \n(80+(3*\n(38)
209.463 .nr 81 +\n(41
209.464 .nr TW \n(81
209.465 -.if t .if \n(TW>\n(.li .tm Table at line 580 file Input is too wide - \n(TW units
209.466 +.if t .if \n(TW>\n(.li .tm Table at line 678 file Input is too wide - \n(TW units
209.467 .fc
209.468 .nr #T 0-1
209.469 .nr #a 0-1
209.470 @@ -4134,8 +4214,12 @@
209.471 .rm g+
209.472 .TE
209.473 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
209.474 +
209.475 +.LP
209.476 .SS
209.477 \-gcpermcapacity Option
209.478 +.LP
209.479 +.LP
209.480 .TS
209.481 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.482 .de 35
209.483 @@ -4324,7 +4408,7 @@
209.484 .nr 41 \n(80+(3*\n(38)
209.485 .nr 81 +\n(41
209.486 .nr TW \n(81
209.487 -.if t .if \n(TW>\n(.li .tm Table at line 618 file Input is too wide - \n(TW units
209.488 +.if t .if \n(TW>\n(.li .tm Table at line 720 file Input is too wide - \n(TW units
209.489 .fc
209.490 .nr #T 0-1
209.491 .nr #a 0-1
209.492 @@ -4475,9 +4559,12 @@
209.493 .rm g+
209.494 .TE
209.495 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
209.496 +
209.497 +.LP
209.498 .SS
209.499 -\-gcutil
209.500 -Option
209.501 +\-gcutil Option
209.502 +.LP
209.503 +.LP
209.504 .TS
209.505 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.506 .de 35
209.507 @@ -4706,7 +4793,7 @@
209.508 .nr 41 \n(80+(3*\n(38)
209.509 .nr 81 +\n(41
209.510 .nr TW \n(81
209.511 -.if t .if \n(TW>\n(.li .tm Table at line 665 file Input is too wide - \n(TW units
209.512 +.if t .if \n(TW>\n(.li .tm Table at line 770 file Input is too wide - \n(TW units
209.513 .fc
209.514 .nr #T 0-1
209.515 .nr #a 0-1
209.516 @@ -4891,8 +4978,12 @@
209.517 .rm i+
209.518 .TE
209.519 .if \n-(b.=0 .nr c. \n(.c-\n(d.-43
209.520 +
209.521 +.LP
209.522 .SS
209.523 \-printcompilation Option
209.524 +.LP
209.525 +.LP
209.526 .TS
209.527 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
209.528 .de 35
209.529 @@ -5001,7 +5092,7 @@
209.530 .nr 41 \n(80+(3*\n(38)
209.531 .nr 81 +\n(41
209.532 .nr TW \n(81
209.533 -.if t .if \n(TW>\n(.li .tm Table at line 687 file Input is too wide - \n(TW units
209.534 +.if t .if \n(TW>\n(.li .tm Table at line 796 file Input is too wide - \n(TW units
209.535 .fc
209.536 .nr #T 0-1
209.537 .nr #a 0-1
209.538 @@ -5084,16 +5175,26 @@
209.539 .rm c+
209.540 .TE
209.541 .if \n-(b.=0 .nr c. \n(.c-\n(d.-19
209.542 +
209.543 +.LP
209.544 .SS
209.545 +
209.546 +.LP
209.547 .SH ""
209.548 .LP
209.549 +.LP
209.550 This section presents some examples of monitoring a local JVM with a \f2lvmid\fP of 21891.
209.551 +.LP
209.552 .SS
209.553 Using the gcutil option
209.554 .LP
209.555 +.LP
209.556 This example attaches to \f2lvmid\fP 21891 and takes 7 samples at 250 millisecond intervals and displays the output as specified by the \f3\-gcutil\fP option.
209.557 +.LP
209.558 .nf
209.559 -\f3jstat \-gcutil 21891 250 7\fP
209.560 +\f3
209.561 +.fl
209.562 +\fP\f3jstat \-gcutil 21891 250 7\fP
209.563 .br
209.564
209.565 .fl
209.566 @@ -5127,16 +5228,24 @@
209.567 .fl
209.568 0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
209.569 .br
209.570 +
209.571 +.fl
209.572 .fi
209.573 +
209.574 +.LP
209.575 .LP
209.576 The output of this example shows that a young generation collection occurred between the 3rd and 4th sample. The collection took 0.001 seconds and promoted objects from the eden space (E) to the old space (O), resulting in an increase of old space utilization from 9.49% to 9.51%. Before the collection, the survivor space was 12.44% utilized, but after this collection it is only 7.74% utilized.
209.577 +.LP
209.578 .SS
209.579 -Repeating the column header
209.580 -string
209.581 +Repeating the column header string
209.582 +.LP
209.583 .LP
209.584 This example attaches to \f2lvmid\fP 21891 and takes samples at 250 millisecond intervals and displays the output as specified by \f3\-gcutil\fP option. In addition, it uses the \f3\-h3\fP option to output the column header after every 3 lines of data.
209.585 +.LP
209.586 .nf
209.587 -\f3jstat \-gcnew \-h3 21891 250\fP
209.588 +\f3
209.589 +.fl
209.590 +\fP\f3jstat \-gcnew \-h3 21891 250\fP
209.591 .br
209.592
209.593 .fl
209.594 @@ -5178,18 +5287,27 @@
209.595 .fl
209.596 64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
209.597 .br
209.598 +
209.599 +.fl
209.600 .fi
209.601 +
209.602 +.LP
209.603 .LP
209.604 In addition to showing the repeating header string, this example shows that between the 2nd and 3rd samples, a young GC occurred. Its duration was 0.001 seconds. The collection found enough live data that the survivor space 0 utilization (S0U) would would have exceeded the desired survivor Size (DSS). As a result, objects were promoted to the old generation (not visible in this output), and the tenuring threshold (TT) was lowered from 31 to 2.
209.605 .LP
209.606 +.LP
209.607 Another collection occurs between the 5th and 6th samples. This collection found very few survivors and returned the tenuring threshold to 31.
209.608 +.LP
209.609 .SS
209.610 -Including a
209.611 -time stamp for each sample
209.612 +Including a time stamp for each sample
209.613 +.LP
209.614 .LP
209.615 This example attaches to \f2lvmid\fP 21891 and takes 3 samples at 250 millisecond intervals. The \f3\-t\fP option is used to generate a time stamp for each sample in the first column.
209.616 +.LP
209.617 .nf
209.618 -\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
209.619 +\f3
209.620 +.fl
209.621 +\fP\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
209.622 .br
209.623
209.624 .fl
209.625 @@ -5207,37 +5325,56 @@
209.626 .fl
209.627 150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
209.628 .br
209.629 +
209.630 +.fl
209.631 .fi
209.632 +
209.633 +.LP
209.634 .LP
209.635 The \f2Timestamp\fP column reports the elapsed time in seconds since the start of the target JVM. In addition, the \f3\-gcoldcapacity\fP output shows the old generation capacity (OGC) and the old space capacity (OC) increasing as the heap expands to meet allocation and/or promotion demands. The old generation capacity (OGC) has grown to from 11696 KB to 13820 KB after the 81st Full GC (FGC). The maximum capacity of the generation (and space) is 60544 KB (OGCMX), so it still has room to expand.
209.636 +.LP
209.637 .SS
209.638 -Monitor
209.639 -instrumentation for a remote JVM
209.640 +Monitor instrumentation for a remote JVM
209.641 +.LP
209.642 .LP
209.643 This example attaches to \f2lvmid\fP 40496 on the system named \f2remote.domain\fP using the \f3\-gcutil\fP option, with samples taken every second indefinitely.
209.644 +.LP
209.645 .nf
209.646 -\f3jstat \-gcutil 40496@remote.domain 1000\fP
209.647 +\f3
209.648 +.fl
209.649 +\fP\f3jstat \-gcutil 40496@remote.domain 1000\fP
209.650 .br
209.651
209.652 .fl
209.653 ... \f2output omitted\fP
209.654 .br
209.655 +
209.656 +.fl
209.657 .fi
209.658 +
209.659 +.LP
209.660 .LP
209.661 The \f2lvmid\fP is combined with the name of the remote host to construct a \f2vmid\fP of \f240496@remote.domain\fP. This \f2vmid\fP results in the use of the \f3rmi\fP protocol to communicate to the default \f3jstatd\fP server on the remote host. The \f3jstatd\fP server is located using the \f3rmiregistry\fP on \f2remote.domain\fP that is bound to the default \f3rmiregistry\fP port (port 1099).
209.662 +.LP
209.663 +.RE
209.664 .SH "SEE ALSO"
209.665 +.LP
209.666 .RS 3
209.667 .TP 2
209.668 -*
209.669 -java \- the Java Application Launcher
209.670 +o
209.671 +java(1) \- the Java Application Launcher
209.672 .TP 2
209.673 -*
209.674 -jps \- the Java Process Status Application
209.675 +o
209.676 +jps(1) \- the Java Process Status Application
209.677 .TP 2
209.678 -*
209.679 -jstatd \- the jvmstat daemon
209.680 +o
209.681 +jstatd(1) \- the jvmstat daemon
209.682 .TP 2
209.683 -*
209.684 -rmiregistry \- the Java Remote Object Registry
209.685 +o
209.686 +rmiregistry(1) \- the Java Remote Object Registry
209.687 .RE
209.688 +
209.689 +.LP
209.690 +
209.691 +.LP
209.692
210.1 --- a/src/solaris/doc/sun/man/man1/jstatd.1 Tue May 12 15:21:55 2009 +0900
210.2 +++ b/src/solaris/doc/sun/man/man1/jstatd.1 Thu May 14 00:17:25 2009 -0700
210.3 @@ -1,5 +1,4 @@
210.4 -.'" t
210.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
210.6 +." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
210.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
210.8 ."
210.9 ." This code is free software; you can redistribute it and/or modify it
210.10 @@ -19,12 +18,12 @@
210.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
210.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
210.13 ." have any questions.
210.14 -." `
210.15 -.TH jstatd 1 "05 Aug 2006"
210.16 -." Generated by html2roff
210.17 +."
210.18 +.TH jstatd 1 "04 May 2009"
210.19 +." Generated from HTML by html2man (author: Eric Armstrong)
210.20
210.21 .LP
210.22 -.SH NAME
210.23 +.SH "Name"
210.24 jstatd \- Virtual Machine jstat Daemon
210.25 .LP
210.26 .SH "SYNOPSIS"
210.27 @@ -46,9 +45,12 @@
210.28 .LP
210.29
210.30 .LP
210.31 +.RS 3
210.32 .TP 3
210.33 options
210.34 Command\-line options. The options may be in any order. If there are redundant or contradictory options, the last option specified will take precedence.
210.35 +.RE
210.36 +
210.37 .LP
210.38 .SH "DESCRIPTION"
210.39 .LP
210.40 @@ -70,6 +72,7 @@
210.41 .LP
210.42 The \f3jstatd\fP command supports the following options:
210.43 .LP
210.44 +.RS 3
210.45 .TP 3
210.46 \-nr
210.47 Do not attempt to create an internal RMI registry within the \f2jstatd\fP process when an existing RMI registry is not found.
210.48 @@ -78,10 +81,12 @@
210.49 Port number where the RMI registry is expected to be found, or, if not found, created if \f2\-nr\fP is not specified.
210.50 .TP 3
210.51 \-n\ rminame
210.52 -Name to which the remote RMI object is bound in the RMI registry. The default name is \f2JStatRemoteHost\fP. If multiple \f3jstatd\fP servers are started on the same host, the name of the exported RMI object for each server can be made unique by by specifying this option. However, doing so will require that the unique server name be included in the monitoring client's \f2hostid\fP and \f2vmid\fP strings.
210.53 +Name to which the remote RMI object is bound in the RMI registry. The default name is \f2JStatRemoteHost\fP. If multiple \f3jstatd\fP servers are started on the same host, the name of the exported RMI object for each server can be made unique by specifying this option. However, doing so will require that the unique server name be included in the monitoring client's \f2hostid\fP and \f2vmid\fP strings.
210.54 .TP 3
210.55 \-Joption
210.56 Pass \f2option\fP to the \f3java\fP launcher called by \f3javac\fP. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying VM executing applications written in Java.
210.57 +.RE
210.58 +
210.59 .LP
210.60 .SH "SECURITY"
210.61 .LP
210.62 @@ -139,8 +144,7 @@
210.63 .LP
210.64 For sites with more restrictive security practices, it is possible to use a custom policy file to limit access to specific trusted hosts or networks, though such techniques are subject to IP addreess spoofing attacks. If your security concerns cannot be addressed with a customized policy file, then the safest action is to not run the \f3jstatd\fP server and use the \f3jstat\fP and \f3jps\fP tools locally.
210.65 .LP
210.66 -.SH "REMOTE
210.67 -INTERFACE"
210.68 +.SH "REMOTE INTERFACE"
210.69 .LP
210.70
210.71 .LP
210.72 @@ -155,8 +159,7 @@
210.73 Here are some examples of starting \f3jstatd\fP. Note that the \f3jstatd\fP scripts automatically start the server in the background.
210.74 .LP
210.75 .SS
210.76 -Using Internal RMI
210.77 -Registry
210.78 +Using Internal RMI Registry
210.79 .LP
210.80 .LP
210.81 This example demonstrates starting \f3jstatd\fP with an internal RMI registry. This example assumes that no other server is bound to the default RMI Registry port (port 1099).
210.82 @@ -171,8 +174,7 @@
210.83
210.84 .LP
210.85 .SS
210.86 -Using
210.87 -External RMI Registry
210.88 +Using External RMI Registry
210.89 .LP
210.90 .LP
210.91 This example demonstrates starting \f3jstatd\fP with a external RMI registry.
210.92 @@ -217,8 +219,7 @@
210.93
210.94 .LP
210.95 .SS
210.96 -Inhibiting creation of an in\-process RMI
210.97 -registry
210.98 +Inhibiting creation of an in\-process RMI registry
210.99 .LP
210.100 .LP
210.101 This example demonstrates starting \f3jstatd\fP such that it will not create a RMI registry if one is not found. This example assumes an RMI registry is already running. If it is not, an appropriate error message is emitted.
210.102 @@ -233,8 +234,7 @@
210.103
210.104 .LP
210.105 .SS
210.106 -Enabling RMI
210.107 -logging capabilities.
210.108 +Enabling RMI logging capabilities.
210.109 .LP
210.110 .LP
210.111 This example demonstrates starting \f3jstatd\fP with RMI logging capabilities enabled. This technique is useful as a troubleshooting aid or for monitoring server activities.
210.112 @@ -252,17 +252,20 @@
210.113 .LP
210.114 .RS 3
210.115 .TP 2
210.116 -*
210.117 -java \- the Java Application Launcher
210.118 +o
210.119 +java(1) \- the Java Application Launcher
210.120 .TP 2
210.121 -*
210.122 -jps \- the Java Process Status Application
210.123 +o
210.124 +jps(1) \- the Java Process Status Application
210.125 .TP 2
210.126 -*
210.127 -jstat \- the Java Virtual Machine Statistics Monitoring Tool
210.128 +o
210.129 +jstat(1) \- the Java Virtual Machine Statistics Monitoring Tool
210.130 .TP 2
210.131 -*
210.132 -rmiregistry \- the Java Remote Object Registry
210.133 +o
210.134 +.na
210.135 +\f2rmiregistry\fP @
210.136 +.fi
210.137 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- the Java Remote Object Registry
210.138 .RE
210.139
210.140 .LP
211.1 --- a/src/solaris/doc/sun/man/man1/keytool.1 Tue May 12 15:21:55 2009 +0900
211.2 +++ b/src/solaris/doc/sun/man/man1/keytool.1 Thu May 14 00:17:25 2009 -0700
211.3 @@ -1,5 +1,4 @@
211.4 -.'" t
211.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
211.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
211.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
211.8 ."
211.9 ." This code is free software; you can redistribute it and/or modify it
211.10 @@ -19,12 +18,12 @@
211.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
211.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
211.13 ." have any questions.
211.14 -." `
211.15 -.TH keytool 1 "07 Aug 2006"
211.16 -." Generated by html2man
211.17 +."
211.18 +.TH keytool 1 "04 May 2009"
211.19 +." Generated from HTML by html2man (author: Eric Armstrong)
211.20
211.21 .LP
211.22 -.SH NAME
211.23 +.SH "Name"
211.24 keytool \- Key and Certificate Management Tool
211.25 .LP
211.26 .RS 3
211.27 @@ -163,17 +162,19 @@
211.28 .fl
211.29
211.30 .fl
211.31 -\-keystore \fP\f4the file named \fP\f4.keystore\fP\f3 in the user's home directory\fP\f3
211.32 +\-keystore the file named \fP\f4.keystore\fP\f3 in the user's home directory
211.33 .fl
211.34
211.35 .fl
211.36 -\-storetype \fP\f4the value of the "keystore.type" property in the security properties file,
211.37 +\-storetype the value of the "keystore.type" property in the security properties file,
211.38 .fl
211.39 - which is returned by the static \fP\f4getDefaultType\fP\f3 method in \fP\f4java.security.KeyStore\fP\f3
211.40 + which is returned by the static \fP\f4getDefaultType\fP\f3 method in
211.41 +.fl
211.42 + \fP\f4java.security.KeyStore\fP\f3
211.43 .fl
211.44
211.45 .fl
211.46 -\-file \fP\f4stdin if reading, stdout if writing\fP\f3
211.47 +\-file stdin if reading, stdout if writing
211.48 .fl
211.49
211.50 .fl
211.51 @@ -185,7 +186,7 @@
211.52 .fi
211.53
211.54 .LP
211.55 -In generating a public/private key pair, the signature algorithm (\f2\-sigalg\fP option) is derived from the algorithm of the underlying private key: If the underlying private key is of type "DSA", the \f2\-sigalg\fP option defaults to "SHA1withDSA", and if the underlying private key is of type "RSA", \f2\-sigalg\fP defaults to "MD5withRSA". Please consult the
211.56 +In generating a public/private key pair, the signature algorithm (\f2\-sigalg\fP option) is derived from the algorithm of the underlying private key: If the underlying private key is of type "DSA", the \f2\-sigalg\fP option defaults to "SHA1withDSA", and if the underlying private key is of type "RSA", \f2\-sigalg\fP defaults to "SHA1withRSA". Please consult the
211.57 .na
211.58 \f2Java Cryptography Architecture API Specification & Reference\fP @
211.59 .fi
211.60 @@ -197,7 +198,7 @@
211.61 .RS 3
211.62
211.63 .LP
211.64 -The \f2\-v\fP option can appear for all commands except \f2\-help\fP. If it appears, it signifies "verbose" mode; more information will be output.
211.65 +The \f2\-v\fP option can appear for all commands except \f2\-help\fP. If it appears, it signifies "verbose" mode; more information will be provided in the output.
211.66 .LP
211.67 There is also a \f2\-J\fP\f2javaoption\fP option that may appear for any command. If it appears, the specified \f2javaoption\fP string is passed through directly to the Java interpreter. This option should not contain any spaces. It is useful for adjusting the execution environment or memory usage. For a list of possible interpreter options, type \f2java \-h\fP or \f2java \-X\fP at the command line.
211.68 .LP
211.69 @@ -234,9 +235,437 @@
211.70 .TP 3
211.71 \-protected
211.72 Either \f2true\fP or \f2false\fP. This value should be specified as \f2true\fP if a password must be given via a protected authentication path such as a dedicated PIN reader.
211.73 -.RE
211.74 +.LP
211.75 +Note: Since there are two keystores involved in \f2\-importkeystore\fP command, two options, namely, \f2\-srcprotected\fP and \f2\-destprotected\fP are provided for the source keystore and the destination keystore respectively.
211.76 +.TP 3
211.77 +\-ext {name{:critical}{=value}}
211.78 +Denotes an X.509 certificate extension. The option can be used in \f2\-genkeypair\fP and \f2\-gencert\fP to embed extensions into the certificate generated, or in \f2\-certreq\fP to show what extensions are requested in the certificate request. The option can appear multiple times. name can be a supported extension name (see below) or an arbitrary OID number. value, if provided, denotes the parameter for the extension; if omitted, denotes the default value (if defined) of the extension or the extension requires no parameter. The \f2":critical"\fP modifier, if provided, means the extension's isCritical attribute is true; otherwise, false.
211.79 +.RS 3
211.80
211.81 .LP
211.82 +.LP
211.83 +Currently keytool supports these named extensions (case\-insensitive):
211.84 +.LP
211.85 +.LP
211.86 +.TS
211.87 +.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
211.88 +.de 35
211.89 +.ps \n(.s
211.90 +.vs \n(.vu
211.91 +.in \n(.iu
211.92 +.if \n(.u .fi
211.93 +.if \n(.j .ad
211.94 +.if \n(.j=0 .na
211.95 +..
211.96 +.nf
211.97 +.nr #~ 0
211.98 +.if n .nr #~ 0.6n
211.99 +.ds #d .d
211.100 +.if \(ts\n(.z\(ts\(ts .ds #d nl
211.101 +.fc
211.102 +.nr 33 \n(.s
211.103 +.rm 80 81
211.104 +.nr 34 \n(.lu
211.105 +.eo
211.106 +.am 81
211.107 +.br
211.108 +.di a+
211.109 +.35
211.110 +.ft \n(.f
211.111 +.ll \n(34u*1u/3u
211.112 +.if \n(.l<\n(81 .ll \n(81u
211.113 +.in 0
211.114 +The full form: "ca:{true|false}[,pathlen:<len>]"; or, <len>, a shorthand for "ca:true,pathlen:<len>"; or omitted, means "ca:true"
211.115 +.br
211.116 +.di
211.117 +.nr a| \n(dn
211.118 +.nr a- \n(dl
211.119 +..
211.120 +.ec \
211.121 +.eo
211.122 +.am 81
211.123 +.br
211.124 +.di b+
211.125 +.35
211.126 +.ft \n(.f
211.127 +.ll \n(34u*1u/3u
211.128 +.if \n(.l<\n(81 .ll \n(81u
211.129 +.in 0
211.130 +usage(,usage)*, usage can be one of digitalSignature, nonRepudiation (contentCommitment), keyEncipherment, dataEncipherment, keyAgreement, keyCertSign, cRLSign, encipherOnly, decipherOnly. Usage can be abbreviated with the first few letters (say, dig for digitalSignature) or in camel\-case style (say, dS for digitalSignature, cRLS for cRLSign), as long as no ambiguity is found. Usage is case\-insensitive.
211.131 +.br
211.132 +.di
211.133 +.nr b| \n(dn
211.134 +.nr b- \n(dl
211.135 +..
211.136 +.ec \
211.137 +.eo
211.138 +.am 81
211.139 +.br
211.140 +.di c+
211.141 +.35
211.142 +.ft \n(.f
211.143 +.ll \n(34u*1u/3u
211.144 +.if \n(.l<\n(81 .ll \n(81u
211.145 +.in 0
211.146 +usage(,usage)*, usage can be one of anyExtendedKeyUsage, serverAuth, clientAuth, codeSigning, emailProtection, timeStamping, OCSPSigning, or any OID string. Named usage can be abbreviated with the first few letters or in camel\-case style, as long as no ambiguity is found. Usage is case\-insensitive.
211.147 +.br
211.148 +.di
211.149 +.nr c| \n(dn
211.150 +.nr c- \n(dl
211.151 +..
211.152 +.ec \
211.153 +.eo
211.154 +.am 80
211.155 +.br
211.156 +.di d+
211.157 +.35
211.158 +.ft \n(.f
211.159 +.ll \n(34u*1u/3u
211.160 +.if \n(.l<\n(80 .ll \n(80u
211.161 +.in 0
211.162 +SAN or SubjectAlternativeName
211.163 +.br
211.164 +.di
211.165 +.nr d| \n(dn
211.166 +.nr d- \n(dl
211.167 +..
211.168 +.ec \
211.169 +.eo
211.170 +.am 81
211.171 +.br
211.172 +.di e+
211.173 +.35
211.174 +.ft \n(.f
211.175 +.ll \n(34u*1u/3u
211.176 +.if \n(.l<\n(81 .ll \n(81u
211.177 +.in 0
211.178 +type:value(,type:value)*, type can be EMAIL, URI, DNS, IP, or OID, value is the string format value for the type.
211.179 +.br
211.180 +.di
211.181 +.nr e| \n(dn
211.182 +.nr e- \n(dl
211.183 +..
211.184 +.ec \
211.185 +.eo
211.186 +.am 80
211.187 +.br
211.188 +.di f+
211.189 +.35
211.190 +.ft \n(.f
211.191 +.ll \n(34u*1u/3u
211.192 +.if \n(.l<\n(80 .ll \n(80u
211.193 +.in 0
211.194 +IAN or IssuerAlternativeName
211.195 +.br
211.196 +.di
211.197 +.nr f| \n(dn
211.198 +.nr f- \n(dl
211.199 +..
211.200 +.ec \
211.201 +.eo
211.202 +.am 81
211.203 +.br
211.204 +.di g+
211.205 +.35
211.206 +.ft \n(.f
211.207 +.ll \n(34u*1u/3u
211.208 +.if \n(.l<\n(81 .ll \n(81u
211.209 +.in 0
211.210 +same as SubjectAlternativeName
211.211 +.br
211.212 +.di
211.213 +.nr g| \n(dn
211.214 +.nr g- \n(dl
211.215 +..
211.216 +.ec \
211.217 +.eo
211.218 +.am 81
211.219 +.br
211.220 +.di h+
211.221 +.35
211.222 +.ft \n(.f
211.223 +.ll \n(34u*1u/3u
211.224 +.if \n(.l<\n(81 .ll \n(81u
211.225 +.in 0
211.226 +method:location\-type:location\-value (,method:location\-type:location\-value)*, method can be "timeStamping", "caRepository" or any OID. location\-type and location\-value can be any type:value supported by the SubjectAlternativeName extension.
211.227 +.br
211.228 +.di
211.229 +.nr h| \n(dn
211.230 +.nr h- \n(dl
211.231 +..
211.232 +.ec \
211.233 +.eo
211.234 +.am 80
211.235 +.br
211.236 +.di i+
211.237 +.35
211.238 +.ft \n(.f
211.239 +.ll \n(34u*1u/3u
211.240 +.if \n(.l<\n(80 .ll \n(80u
211.241 +.in 0
211.242 +AIA or AuthorityInfoAccess
211.243 +.br
211.244 +.di
211.245 +.nr i| \n(dn
211.246 +.nr i- \n(dl
211.247 +..
211.248 +.ec \
211.249 +.eo
211.250 +.am 81
211.251 +.br
211.252 +.di j+
211.253 +.35
211.254 +.ft \n(.f
211.255 +.ll \n(34u*1u/3u
211.256 +.if \n(.l<\n(81 .ll \n(81u
211.257 +.in 0
211.258 +same as SubjectInfoAccess. method can be "ocsp","caIssuers" or any OID.
211.259 +.br
211.260 +.di
211.261 +.nr j| \n(dn
211.262 +.nr j- \n(dl
211.263 +..
211.264 +.ec \
211.265 +.35
211.266 +.nf
211.267 +.ll \n(34u
211.268 +.nr 80 0
211.269 +.nr 38 \w\f3Name\fP
211.270 +.if \n(80<\n(38 .nr 80 \n(38
211.271 +.nr 38 \wBC or BasicConstraints
211.272 +.if \n(80<\n(38 .nr 80 \n(38
211.273 +.nr 38 \wKU or KeyUsage
211.274 +.if \n(80<\n(38 .nr 80 \n(38
211.275 +.nr 38 \wEKU or ExtendedkeyUsage
211.276 +.if \n(80<\n(38 .nr 80 \n(38
211.277 +.nr 38 \wSIA or SubjectInfoAccess
211.278 +.if \n(80<\n(38 .nr 80 \n(38
211.279 +.80
211.280 +.rm 80
211.281 +.nr 38 \n(d-
211.282 +.if \n(80<\n(38 .nr 80 \n(38
211.283 +.nr 38 \n(f-
211.284 +.if \n(80<\n(38 .nr 80 \n(38
211.285 +.nr 38 \n(i-
211.286 +.if \n(80<\n(38 .nr 80 \n(38
211.287 +.nr 81 0
211.288 +.nr 38 \w\f3Value\fP
211.289 +.if \n(81<\n(38 .nr 81 \n(38
211.290 +.81
211.291 +.rm 81
211.292 +.nr 38 \n(a-
211.293 +.if \n(81<\n(38 .nr 81 \n(38
211.294 +.nr 38 \n(b-
211.295 +.if \n(81<\n(38 .nr 81 \n(38
211.296 +.nr 38 \n(c-
211.297 +.if \n(81<\n(38 .nr 81 \n(38
211.298 +.nr 38 \n(e-
211.299 +.if \n(81<\n(38 .nr 81 \n(38
211.300 +.nr 38 \n(g-
211.301 +.if \n(81<\n(38 .nr 81 \n(38
211.302 +.nr 38 \n(h-
211.303 +.if \n(81<\n(38 .nr 81 \n(38
211.304 +.nr 38 \n(j-
211.305 +.if \n(81<\n(38 .nr 81 \n(38
211.306 +.35
211.307 +.nf
211.308 +.ll \n(34u
211.309 +.nr 38 1n
211.310 +.nr 79 0
211.311 +.nr 40 \n(79+(0*\n(38)
211.312 +.nr 80 +\n(40
211.313 +.nr 41 \n(80+(3*\n(38)
211.314 +.nr 81 +\n(41
211.315 +.nr TW \n(81
211.316 +.if t .if \n(TW>\n(.li .tm Table at line 288 file Input is too wide - \n(TW units
211.317 +.fc
211.318 +.nr #T 0-1
211.319 +.nr #a 0-1
211.320 +.eo
211.321 +.de T#
211.322 +.ds #d .d
211.323 +.if \(ts\n(.z\(ts\(ts .ds #d nl
211.324 +.mk ##
211.325 +.nr ## -1v
211.326 +.ls 1
211.327 +.ls
211.328 +..
211.329 +.ec
211.330 +.ta \n(80u \n(81u
211.331 +.nr 31 \n(.f
211.332 +.nr 35 1m
211.333 +\&\h'|\n(40u'\f3Name\fP\h'|\n(41u'\f3Value\fP
211.334 +.ne \n(a|u+\n(.Vu
211.335 +.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
211.336 +.ta \n(80u \n(81u
211.337 +.nr 31 \n(.f
211.338 +.nr 35 1m
211.339 +\&\h'|\n(40u'BC or BasicConstraints\h'|\n(41u'
211.340 +.mk ##
211.341 +.nr 31 \n(##
211.342 +.sp |\n(##u-1v
211.343 +.nr 37 \n(41u
211.344 +.in +\n(37u
211.345 +.a+
211.346 +.in -\n(37u
211.347 +.mk 32
211.348 +.if \n(32>\n(31 .nr 31 \n(32
211.349 +.sp |\n(31u
211.350 +.ne \n(b|u+\n(.Vu
211.351 +.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
211.352 +.ta \n(80u \n(81u
211.353 +.nr 31 \n(.f
211.354 +.nr 35 1m
211.355 +\&\h'|\n(40u'KU or KeyUsage\h'|\n(41u'
211.356 +.mk ##
211.357 +.nr 31 \n(##
211.358 +.sp |\n(##u-1v
211.359 +.nr 37 \n(41u
211.360 +.in +\n(37u
211.361 +.b+
211.362 +.in -\n(37u
211.363 +.mk 32
211.364 +.if \n(32>\n(31 .nr 31 \n(32
211.365 +.sp |\n(31u
211.366 +.ne \n(c|u+\n(.Vu
211.367 +.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
211.368 +.ta \n(80u \n(81u
211.369 +.nr 31 \n(.f
211.370 +.nr 35 1m
211.371 +\&\h'|\n(40u'EKU or ExtendedkeyUsage\h'|\n(41u'
211.372 +.mk ##
211.373 +.nr 31 \n(##
211.374 +.sp |\n(##u-1v
211.375 +.nr 37 \n(41u
211.376 +.in +\n(37u
211.377 +.c+
211.378 +.in -\n(37u
211.379 +.mk 32
211.380 +.if \n(32>\n(31 .nr 31 \n(32
211.381 +.sp |\n(31u
211.382 +.ne \n(d|u+\n(.Vu
211.383 +.ne \n(e|u+\n(.Vu
211.384 +.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
211.385 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
211.386 +.ta \n(80u \n(81u
211.387 +.nr 31 \n(.f
211.388 +.nr 35 1m
211.389 +\&\h'|\n(40u'\h'|\n(41u'
211.390 +.mk ##
211.391 +.nr 31 \n(##
211.392 +.sp |\n(##u-1v
211.393 +.nr 37 \n(40u
211.394 +.in +\n(37u
211.395 +.d+
211.396 +.in -\n(37u
211.397 +.mk 32
211.398 +.if \n(32>\n(31 .nr 31 \n(32
211.399 +.sp |\n(##u-1v
211.400 +.nr 37 \n(41u
211.401 +.in +\n(37u
211.402 +.e+
211.403 +.in -\n(37u
211.404 +.mk 32
211.405 +.if \n(32>\n(31 .nr 31 \n(32
211.406 +.sp |\n(31u
211.407 +.ne \n(f|u+\n(.Vu
211.408 +.ne \n(g|u+\n(.Vu
211.409 +.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
211.410 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
211.411 +.ta \n(80u \n(81u
211.412 +.nr 31 \n(.f
211.413 +.nr 35 1m
211.414 +\&\h'|\n(40u'\h'|\n(41u'
211.415 +.mk ##
211.416 +.nr 31 \n(##
211.417 +.sp |\n(##u-1v
211.418 +.nr 37 \n(40u
211.419 +.in +\n(37u
211.420 +.f+
211.421 +.in -\n(37u
211.422 +.mk 32
211.423 +.if \n(32>\n(31 .nr 31 \n(32
211.424 +.sp |\n(##u-1v
211.425 +.nr 37 \n(41u
211.426 +.in +\n(37u
211.427 +.g+
211.428 +.in -\n(37u
211.429 +.mk 32
211.430 +.if \n(32>\n(31 .nr 31 \n(32
211.431 +.sp |\n(31u
211.432 +.ne \n(h|u+\n(.Vu
211.433 +.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
211.434 +.ta \n(80u \n(81u
211.435 +.nr 31 \n(.f
211.436 +.nr 35 1m
211.437 +\&\h'|\n(40u'SIA or SubjectInfoAccess\h'|\n(41u'
211.438 +.mk ##
211.439 +.nr 31 \n(##
211.440 +.sp |\n(##u-1v
211.441 +.nr 37 \n(41u
211.442 +.in +\n(37u
211.443 +.h+
211.444 +.in -\n(37u
211.445 +.mk 32
211.446 +.if \n(32>\n(31 .nr 31 \n(32
211.447 +.sp |\n(31u
211.448 +.ne \n(i|u+\n(.Vu
211.449 +.ne \n(j|u+\n(.Vu
211.450 +.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
211.451 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
211.452 +.ta \n(80u \n(81u
211.453 +.nr 31 \n(.f
211.454 +.nr 35 1m
211.455 +\&\h'|\n(40u'\h'|\n(41u'
211.456 +.mk ##
211.457 +.nr 31 \n(##
211.458 +.sp |\n(##u-1v
211.459 +.nr 37 \n(40u
211.460 +.in +\n(37u
211.461 +.i+
211.462 +.in -\n(37u
211.463 +.mk 32
211.464 +.if \n(32>\n(31 .nr 31 \n(32
211.465 +.sp |\n(##u-1v
211.466 +.nr 37 \n(41u
211.467 +.in +\n(37u
211.468 +.j+
211.469 +.in -\n(37u
211.470 +.mk 32
211.471 +.if \n(32>\n(31 .nr 31 \n(32
211.472 +.sp |\n(31u
211.473 +.fc
211.474 +.nr T. 1
211.475 +.T# 1
211.476 +.35
211.477 +.rm a+
211.478 +.rm b+
211.479 +.rm c+
211.480 +.rm d+
211.481 +.rm e+
211.482 +.rm f+
211.483 +.rm g+
211.484 +.rm h+
211.485 +.rm i+
211.486 +.rm j+
211.487 +.TE
211.488 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-38
211.489 +
211.490 +.LP
211.491 +.LP
211.492 +For name as OID, value is the HEX dumped DER encoding of the extnValue for the extension excluding the OCTET STRING type and length bytes. Any extra character other than standard HEX numbers (0\-9, a\-f, A\-F) are ignored in the HEX string. Therefore, both \f2"01:02:03:04"\fP and \f2"01020304"\fP are accepted as identical values. If there's no value, the extension has an empty value field then.
211.493 +.LP
211.494 +.LP
211.495 +A special name \f2"honored"\fP, used in \-gencert only, denotes how the extensions included in the certificate request should be honored. The value for this name is a comma\-seperated list of \f2"all"\fP (all requested extensions are honored), \f2"name{:[critical|non\-critical]}"\fP (the named extension is honored, but using a different isCritical attribute) and \f2"\-name"\fP (used with all, denotes an exception). Requested extensions are not honored by default.
211.496 +.LP
211.497 +.LP
211.498 +If, besides the \-ext honored option, another named or OID \-ext option is provided, this extension will be added to those already honored. However, if this name (or OID) also appears in the honored value, its value and criticality overrides the one in the request.
211.499 +.LP
211.500 +.LP
211.501 +The subjectKeyIdentifier extension is always created. For non self\-signed certificates, the authorityKeyIdentifier is always created.
211.502 +.LP
211.503 +.RE
211.504 +.RE
211.505 .RE
211.506 .SH "COMMANDS"
211.507 .LP
211.508 @@ -250,7 +679,15 @@
211.509 .LP
211.510 .RS 3
211.511 .TP 3
211.512 -\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
211.513 +\-gencert {\-infile infile} {\-outfile outfile} {\-ext ext}* {\-rfc} {\-alias alias} {\-sigalg sigalg} {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] [\-keypass keypass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
211.514 +.LP
211.515 +Generates a certificate as a response to a certificate request file (which can be created by the \f2keytool \-certreq\fP command). The command reads the request from infile (if omitted, from the standard input), signs it using alias's private key, and output the X.509 certificate into outfile (if omitted, to the standard output). If \f2\-rfc\fP is specified, output format is BASE64\-encoded PEM; otherwise, a binary DER is created.
211.516 +.LP
211.517 +\f2sigalg\fP specifies the algorithm that should be used to sign the certificate. valDays tells the number of days for which the certificate should be considered valid.
211.518 +.LP
211.519 +\f2ext\fP shows what X.509 extensions will be embedded in the certificate. Read Common Options for the grammar of \f2\-ext\fP.
211.520 +.TP 3
211.521 +\-genkeypair {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} {\-sigalg sigalg} [\-dname dname] [\-keypass keypass] {\-startdate value} {\-validity valDays} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
211.522 .LP
211.523 Generates a key pair (a public key and associated private key). Wraps the public key into an X.509 v3 self\-signed certificate, which is stored as a single\-element certificate chain. This certificate chain and the private key are stored in a new keystore entry identified by \f2alias\fP.
211.524 .LP
211.525 @@ -260,9 +697,60 @@
211.526 .LP
211.527 \f2keypass\fP is a password used to protect the private key of the generated key pair. If no password is provided, the user is prompted for it. If you press RETURN at the prompt, the key password is set to the same password as that used for the keystore. \f2keypass\fP must be at least 6 characters long.
211.528 .LP
211.529 -\f2valDays\fP tells the number of days for which the certificate should be considered valid.
211.530 +\f2startdate\fP specifies the issue time of the certificate, also known as the "Not Before" value of the X.509 certificate's Validity field.
211.531 +.RS 3
211.532 +
211.533 .LP
211.534 -This command was named \f2\-genkey\fP in previous releases. This old name is still supported in this release and will be supported in future releases, but for clarify the new name, \f2\-genkeypair\fP, is preferred going forward.
211.535 +.LP
211.536 +The option value can be set in one of these two forms:
211.537 +.LP
211.538 +.RS 3
211.539 +.TP 3
211.540 +1.
211.541 +.LP
211.542 +([+\-]\f2nnn\fP[ymdHMS])+
211.543 +.TP 3
211.544 +2.
211.545 +.LP
211.546 +[yyyy/mm/dd] [HH:MM:SS]
211.547 +.RE
211.548 +
211.549 +.LP
211.550 +.LP
211.551 +With the first form, the issue time is shifted by the specified value from the current time. The value is a concatenation of a sequence of sub values. Inside each sub value, the plus sign ("+") means shifting forward, and the minus sign ("\-") means shifting backward. The time to be shifted is \f2nnn\fP units of years, months, days, hours, minutes, or seconds (denoted by a single character of "y", "m", "d", "H", "M", or "S" respectively). The exact value of the issue time is calculated using the \f2java.util.GregorianCalendar.add(int field, int amount)\fP method on each sub value, from left to right. For example, by specifying \f2"\-startdate \-1y+1m\-1d"\fP, the issue time will be:
211.552 +.LP
211.553 +.RS 3
211.554 +
211.555 +.LP
211.556 +.nf
211.557 +\f3
211.558 +.fl
211.559 + Calendar c = new GregorianCalendar();
211.560 +.fl
211.561 + c.add(Calendar.YEAR, \-1);
211.562 +.fl
211.563 + c.add(Calendar.MONTH, 1);
211.564 +.fl
211.565 + c.add(Calendar.DATE, \-1);
211.566 +.fl
211.567 + return c.getTime()
211.568 +.fl
211.569 +\fP
211.570 +.fi
211.571 +.RE
211.572 +
211.573 +.LP
211.574 +.LP
211.575 +With the second form, the user sets the exact issue time in two parts, year/month/day and hour:minute:second (using the local timezone). The user may provide only one part, which means the other part is the same as the current date (or time). User must provide the exact number of digits as shown in the format definition (padding with 0 if shorter). When both the date and time are provided, there is one (and only one) space character between the two parts. The hour should always be provided in 24 hour format.
211.576 +.LP
211.577 +.LP
211.578 +When the option is not provided, the start date is the current time. The option can be provided at most once.
211.579 +.LP
211.580 +.RE
211.581 +.LP
211.582 +\f2valDays\fP specifies the number of days (starting at the date specified by \f2\-startdate\fP, or the current date if \f2\-startdate\fP is not specified) for which the certificate should be considered valid.
211.583 +.LP
211.584 +This command was named \f2\-genkey\fP in previous releases. This old name is still supported in this release and will be supported in future releases, but for clarity the new name, \f2\-genkeypair\fP, is preferred going forward.
211.585 .TP 3
211.586 \-genseckey {\-alias alias} {\-keyalg keyalg} {\-keysize keysize} [\-keypass keypass] {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
211.587 .LP
211.588 @@ -272,7 +760,7 @@
211.589 .TP 3
211.590 \-importcert {\-alias alias} {\-file cert_file} [\-keypass keypass] {\-noprompt} {\-trustcacerts} {\-storetype storetype} {\-keystore keystore} [\-storepass storepass] {\-providerName provider_name} {\-providerClass provider_class_name {\-providerArg provider_arg}} {\-v} {\-protected} {\-Jjavaoption}
211.591 .LP
211.592 -Reads the certificate or certificate chain (where the latter is supplied in a PKCS#7 formatted reply) from the file \f2cert_file\fP, and stores it in the keystore entry identified by \f2alias\fP. If no file is given, the certificate or PKCS#7 reply is read from stdin.
211.593 +Reads the certificate or certificate chain (where the latter is supplied in a PKCS#7 formatted reply or a sequence of X.509 certificates) from the file \f2cert_file\fP, and stores it in the keystore entry identified by \f2alias\fP. If no file is given, the certificate or certificate chain is read from stdin.
211.594 .LP
211.595 \f3keytool\fP can import X.509 v1, v2, and v3 certificates, and PKCS#7 formatted certificate chains consisting of certificates of that type. The data to be imported must be provided either in binary encoding format, or in printable encoding format (also known as Base64 encoding) as defined by the Internet RFC 1421 standard. In the latter case, the encoding must be bounded at the beginning by a string that starts with "\-\-\-\-\-BEGIN", and bounded at the end by a string that starts with "\-\-\-\-\-END".
211.596 .LP
211.597 @@ -297,8 +785,6 @@
211.598 .RE
211.599 \f3Importing a New Trusted Certificate\fP
211.600 .RS 3
211.601 -
211.602 -.LP
211.603 .LP
211.604 Before adding the certificate to the keystore, \f3keytool\fP tries to verify it by attempting to construct a chain of trust from that certificate to a self\-signed certificate (belonging to a root CA), using trusted certificates that are already available in the keystore.
211.605 .LP
211.606 @@ -323,7 +809,7 @@
211.607 \f3If the reply is a single X.509 certificate\fP, \f3keytool\fP attempts to establish a trust chain, starting at the certificate reply and ending at a self\-signed certificate (belonging to a root CA). The certificate reply and the hierarchy of certificates used to authenticate the certificate reply form the new certificate chain of \f2alias\fP. If a trust chain cannot be established, the certificate reply is not imported. In this case, \f3keytool\fP does not print out the certificate and prompt the user to verify it, because it is very hard (if not impossible) for a user to determine the authenticity of the certificate reply.
211.608 .TP 2
211.609 o
211.610 -\f3If the reply is a PKCS#7 formatted certificate chain\fP, the chain is first ordered (with the user certificate first and the self\-signed root CA certificate last), before \f3keytool\fP attempts to match the root CA certificate provided in the reply with any of the trusted certificates in the keystore or the "cacerts" keystore file (if the \f2\-trustcacerts\fP option was specified). If no match can be found, the information of the root CA certificate is printed out, and the user is prompted to verify it, e.g., by comparing the displayed certificate fingerprints with the fingerprints obtained from some other (trusted) source of information, which might be the root CA itself. The user then has the option of aborting the import operation. If the \f2\-noprompt\fP option is given, however, there will be no interaction with the user.
211.611 +\f3If the reply is a PKCS#7 formatted certificate chain or a sequence of X.509 certificates\fP, the chain is ordered with the user certificate first followed by zero or more CA certificates. If the chain ends with a self\-signed root CA certificate and \f2\-trustcacerts\fP option was specified, \f3keytool\fP will attempt to match it with any of the trusted certificates in the keystore or the "cacerts" keystore file. If the chain does not end with a self\-signed root CA certificate and the \f2\-trustcacerts\fP option was specified, \f3keytool\fP will try to find one from the trusted certificates in the keystore or the "cacerts" keystore file and add it to the end of the chain. If the certificate is not found and \f2\-noprompt\fP option is not specified, the information of the last certificate in the chain is printed out, and the user is prompted to verify it.
211.612 .RE
211.613
211.614 .LP
211.615 @@ -345,6 +831,10 @@
211.616 If the destination alias already exists in the destination keystore, the user is prompted to either overwrite the entry, or to create a new entry under a different alias name.
211.617 .LP
211.618 Note that if \f2\-noprompt\fP is provided, the user will not be prompted for a new destination alias. Existing entries will automatically be overwritten with the destination alias name. Finally, entries that can not be imported are automatically skipped and a warning is output.
211.619 +.TP 3
211.620 +\-printcertreq {\-file file}
211.621 +.LP
211.622 +Prints the content of a PKCS #10 format certificate request, which can be generated by the keytool \-certreq command. The command reads the request from file; if omitted, from the standard input.
211.623 .RE
211.624 .RE
211.625 .SS
211.626 @@ -396,16 +886,20 @@
211.627 .LP
211.628 Prints (to stdout) the contents of the keystore entry identified by \f2alias\fP. If no alias is specified, the contents of the entire keystore are printed.
211.629 .LP
211.630 -This command by default prints the MD5 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, with additional information such as the owner, issuer, serial number, and any extensions. If the \f2\-rfc\fP option is specified, certificate contents are printed using the printable encoding format, as defined by the Internet RFC 1421 standard
211.631 +This command by default prints the SHA1 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, with additional information such as the owner, issuer, serial number, and any extensions. If the \f2\-rfc\fP option is specified, certificate contents are printed using the printable encoding format, as defined by the Internet RFC 1421 standard
211.632 .LP
211.633 You cannot specify both \f2\-v\fP and \f2\-rfc\fP.
211.634 .TP 3
211.635 -\-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
211.636 +\-printcert {\-file cert_file | \-sslserver host[:port]} {\-rfc} {\-v} {\-Jjavaoption}
211.637 .LP
211.638 .LP
211.639 -Internet RFC 1421 standard.
211.640 +If \f2\-rfc\fP is specified, keytool prints the certificate in PEM mode as defined by the Internet RFC 1421 standard.
211.641 .LP
211.642 -Note: This option can be used independently of a keystore.
211.643 +If the certificate is read from a file or stdin, it may be either binary encoded or in printable encoding format, as defined by the Internet RFC 1421 standard
211.644 +.LP
211.645 +If the SSL server is behind a firewall, \f2\-J\-Dhttps.proxyHost=proxyhost\fP and \f2\-J\-Dhttps.proxyPort=proxyport\fP can be specified on the command line for proxy tunneling. See the JSSE Reference Guide for more information.
211.646 +.LP
211.647 +\f3Note\fP: This option can be used independently of a keystore.
211.648 .RE
211.649
211.650 .LP
211.651 @@ -604,11 +1098,7 @@
211.652 .RS 3
211.653
211.654 .LP
211.655 -Suppose you have used the
211.656 -.na
211.657 -\f2jarsigner\fP @
211.658 -.fi
211.659 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html tool to sign a Java ARchive (JAR) file. Clients that want to use the file will want to authenticate your signature.
211.660 +Suppose you have used the jarsigner(1) tool to sign a Java ARchive (JAR) file. Clients that want to use the file will want to authenticate your signature.
211.661 .LP
211.662 One way they can do this is by first importing your public key certificate into their keystore as a "trusted" entry. You can export the certificate and supply it to your clients. As an example, you can copy your certificate to a file named \f2MJ.cer\fP via the following, assuming the entry is aliased by "mykey":
211.663 .LP
211.664 @@ -675,6 +1165,45 @@
211.665 .RE
211.666
211.667 .LP
211.668 +.SS
211.669 +Generating Certificates for a typical SSL Server
211.670 +.LP
211.671 +.RS 3
211.672 +
211.673 +.LP
211.674 +.LP
211.675 +Keytool commands to generate keypairs and certificates for three entities, namely, Root CA (root), Intermadiate CA (ca), and SSL server (server) are as follows:
211.676 +.LP
211.677 +.nf
211.678 +\f3
211.679 +.fl
211.680 +keytool \-keystore root.jks \-genkeypair \-alias root \-ext bc:c
211.681 +.fl
211.682 +keytool \-keystore ca.jks \-alias ca
211.683 +.fl
211.684 +keytool \-keystore server.jks \-alias server
211.685 +.fl
211.686 +
211.687 +.fl
211.688 +keytool \-keystore root.jks \-alias root \-exportcert > root.pem
211.689 +.fl
211.690 +
211.691 +.fl
211.692 +keytool \-keystore ca.jks \-certreq \-alias ca | keytool \-keystore root.jks \-gencert \-alias root \-ext BC=0 > ca.pem
211.693 +.fl
211.694 +keytool \-keystore ca.jks \-importcert \-alias ca \-file ca.pem
211.695 +.fl
211.696 +
211.697 +.fl
211.698 +keytool \-keystore server.jks \-certreq \-alias server | keytool \-keystore ca.jks \-gencert \-alias ca \-ext ku:c=dig,kE >server.pem
211.699 +.fl
211.700 +cat root.pem ca.pem server.pem | keytool \-keystore server.jks \-importcert \-alias server
211.701 +.fl
211.702 +\fP
211.703 +.fi
211.704 +.RE
211.705 +
211.706 +.LP
211.707 .SH "TERMINOLOGY and WARNINGS"
211.708 .LP
211.709
211.710 @@ -757,7 +1286,11 @@
211.711 There is a built\-in default implementation, provided by Sun Microsystems. It implements the keystore as a file, utilizing a proprietary keystore type (format) named "JKS". It protects each private key with its individual password, and also protects the integrity of the entire keystore with a (possibly different) password.
211.712 .LP
211.713 .LP
211.714 -Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a "provider" and supply a KeystoreSpi subclass implementation, as described in How to Implement a Provider for the Java Cryptography Architecture.
211.715 +Keystore implementations are provider\-based. More specifically, the application interfaces supplied by \f2KeyStore\fP are implemented in terms of a "Service Provider Interface" (SPI). That is, there is a corresponding abstract \f2KeystoreSpi\fP class, also in the \f2java.security\fP package, which defines the Service Provider Interface methods that "providers" must implement. (The term "provider" refers to a package or a set of packages that supply a concrete implementation of a subset of services that can be accessed by the Java Security API.) Thus, to provide a keystore implementation, clients must implement a "provider" and supply a KeystoreSpi subclass implementation, as described in
211.716 +.na
211.717 +\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
211.718 +.fi
211.719 +http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html.
211.720 .LP
211.721 .LP
211.722 Applications can choose different \f2types\fP of keystore implementations from different providers, using the "getInstance" factory method supplied in the \f2KeyStore\fP class. A keystore type defines the storage and data format of the keystore information, and the algorithms used to protect private/secret keys in the keystore and the integrity of the keystore itself. Keystore implementations of different types are not compatible.
211.723 @@ -1130,13 +1663,6 @@
211.724 OU=CyberTrust, O=Baltimore, C=IE
211.725 .TP 2
211.726 *
211.727 -\f3Alias\fP: gtecybertrustca
211.728 -.br
211.729 -\f3Owner DN\fP: CN=GTE CyberTrust Root,
211.730 -.br
211.731 -O=GTE Corporation, C=US
211.732 -.TP 2
211.733 -*
211.734 \f3Alias\fP: gtecybertrust5ca
211.735 .br
211.736 \f3Owner DN\fP: CN=GTE CyberTrust Root 5,
211.737 @@ -1368,7 +1894,7 @@
211.738 The \f2\-exportcert\fP command by default outputs a certificate in binary encoding, but will instead output a certificate in the printable encoding format, if the \f2\-rfc\fP option is specified.
211.739 .LP
211.740 .LP
211.741 -The \f2\-list\fP command by default prints the MD5 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, while if the \f2\-rfc\fP option is specified, the certificate is output in the printable encoding format.
211.742 +The \f2\-list\fP command by default prints the SHA1 fingerprint of a certificate. If the \f2\-v\fP option is specified, the certificate is printed in human\-readable format, while if the \f2\-rfc\fP option is specified, the certificate is output in the printable encoding format.
211.743 .LP
211.744 .LP
211.745 In its printable encoding format, the encoded certificate is bounded at the beginning by
211.746 @@ -1575,18 +2101,15 @@
211.747 .RS 3
211.748 .TP 2
211.749 o
211.750 -.na
211.751 -\f2jar\fP @
211.752 -.fi
211.753 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jar.html tool documentation
211.754 +.LP
211.755 +jar(1) tool documentation
211.756 .TP 2
211.757 o
211.758 -.na
211.759 -\f2jarsigner\fP @
211.760 -.fi
211.761 -http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html tool documentation
211.762 +.LP
211.763 +jarsigner(1) tool documentation
211.764 .TP 2
211.765 o
211.766 +.LP
211.767 the
211.768 .na
211.769 \f4Security\fP @
211.770 @@ -1595,7 +2118,7 @@
211.771 .na
211.772 \f4Java Tutorial\fP @
211.773 .fi
211.774 -http://java.sun.com/docs/books/tutorial/trailmap.html for examples of the use of \f3keytool\fP
211.775 +http://java.sun.com/docs/books/tutorial for examples of the use of \f3keytool\fP
211.776 .RE
211.777
211.778 .LP
212.1 --- a/src/solaris/doc/sun/man/man1/native2ascii.1 Tue May 12 15:21:55 2009 +0900
212.2 +++ b/src/solaris/doc/sun/man/man1/native2ascii.1 Thu May 14 00:17:25 2009 -0700
212.3 @@ -1,5 +1,4 @@
212.4 -.'" t
212.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
212.6 +." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
212.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
212.8 ."
212.9 ." This code is free software; you can redistribute it and/or modify it
212.10 @@ -19,19 +18,21 @@
212.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
212.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
212.13 ." have any questions.
212.14 -." `
212.15 -.TH native2ascii 1 "05 Aug 2006"
212.16 -." Generated by html2roff
212.17 -.\\" Created by: Doug Kramer, 19\-Aug\-1996
212.18 +."
212.19 +.TH native2ascii 1 "04 May 2009"
212.20 +." Generated from HTML by html2man (author: Eric Armstrong)
212.21 +
212.22 .LP
212.23 -.SH NAME
212.24 +.SH "Name"
212.25 native2ascii \- Native\-to\-ASCII Converter
212.26 .LP
212.27 +.RS 3
212.28
212.29 .LP
212.30 .LP
212.31 Converts a file with native\-encoded characters (characters which are non\-Latin 1 and non\-Unicode) to one with Unicode\-encoded characters.
212.32 .LP
212.33 +.RE
212.34 .SH "SYNOPSIS"
212.35 .LP
212.36
212.37 @@ -58,6 +59,7 @@
212.38 .LP
212.39
212.40 .LP
212.41 +.RS 3
212.42 .TP 3
212.43 \-reverse
212.44 Perform the reverse operation: convert a file with Latin\-1 and/or Unicode encoded characters to one with native\-encoded characters.
212.45 @@ -72,7 +74,9 @@
212.46 http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.html document.
212.47 .TP 3
212.48 \-Joption
212.49 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
212.50 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
212.51 +.RE
212.52 +
212.53 .LP
212.54
212.55 .LP
213.1 --- a/src/solaris/doc/sun/man/man1/orbd.1 Tue May 12 15:21:55 2009 +0900
213.2 +++ b/src/solaris/doc/sun/man/man1/orbd.1 Thu May 14 00:17:25 2009 -0700
213.3 @@ -1,5 +1,4 @@
213.4 -.'" t
213.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
213.6 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
213.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
213.8 ."
213.9 ." This code is free software; you can redistribute it and/or modify it
213.10 @@ -19,12 +18,12 @@
213.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
213.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
213.13 ." have any questions.
213.14 -." `
213.15 -.TH orbd 1 "07 Aug 2006"
213.16 -." Generated by html2man
213.17 +."
213.18 +.TH orbd 1 "04 May 2009"
213.19 +." Generated from HTML by html2man (author: Eric Armstrong)
213.20
213.21 .LP
213.22 -.SH NAME
213.23 +.SH "Name"
213.24 orbd \- The Object Request Broker Daemon
213.25 .LP
213.26 .RS 3
213.27 @@ -34,7 +33,11 @@
213.28 \f3orbd\fP is used to enable clients to transparently locate and invoke persistent objects on servers in the CORBA environment.
213.29 .LP
213.30 .LP
213.31 -\f3See also:\fP \f2Naming Service\fP
213.32 +\f3See also:\fP
213.33 +.na
213.34 +\f2Naming Service\fP @
213.35 +.fi
213.36 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
213.37 .LP
213.38 .RE
213.39 .SH "SYNOPSIS"
213.40 @@ -68,10 +71,14 @@
213.41
213.42 .LP
213.43 .LP
213.44 -To access ORBD's Server Manager, the server must be started using \f2servertool\fP, which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. For more information on the Server Manager, see the section in this document titled \f2Server Manager\fP.
213.45 +To access ORBD's Server Manager, the server must be started using servertool(1), which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. For more information on the Server Manager, see the section in this document titled \f2Server Manager\fP.
213.46 .LP
213.47 .LP
213.48 -When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to \f2Naming Service\fP.
213.49 +When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to
213.50 +.na
213.51 +\f2Naming Service\fP @
213.52 +.fi
213.53 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
213.54 .LP
213.55 .SH "OPTIONS"
213.56 .LP
213.57 @@ -122,7 +129,7 @@
213.58 .RS 3
213.59 .TP 3
213.60 \-Joption
213.61 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
213.62 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
213.63 .TP 3
213.64
213.65 .RE
213.66 @@ -131,7 +138,15 @@
213.67 .SH "Starting and Stopping the Naming Service"
213.68 .LP
213.69 .LP
213.70 -A Naming Service is a CORBA service that allows CORBA objects to be named by means of binding a name to an object reference. The name binding may be stored in the naming service, and a client may supply the name to obtain the desired object reference.
213.71 +A Naming Service is a CORBA service that allows
213.72 +.na
213.73 +\f2CORBA objects\fP @
213.74 +.fi
213.75 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object to be named by means of binding a name to an object reference. The
213.76 +.na
213.77 +\f2name binding\fP @
213.78 +.fi
213.79 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding may be stored in the naming service, and a client may supply the name to obtain the desired object reference.
213.80 .LP
213.81 .LP
213.82 Prior to running a client or a server, you will start ORBD. ORBD includes a persistent Naming Service and a transient Naming Service, both of which are an implementation of the COS Naming Service.
213.83 @@ -206,18 +221,26 @@
213.84 To stop the naming service, use the relevant operating system command, such as \f2pkill orbd\fP on Solaris, or \f2Ctrl+C\fP in the DOS window in which \f2orbd\fP is running. Note that names registered with the naming service may disappear when the service is terminated if the naming service is transient. The Java IDL naming service will run until it is explicitly stopped.
213.85 .LP
213.86 .LP
213.87 -For more information on the Naming Service included with ORBD, see \f2Naming Service\fP.
213.88 +For more information on the Naming Service included with ORBD, see
213.89 +.na
213.90 +\f2Naming Service\fP @
213.91 +.fi
213.92 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
213.93 .LP
213.94 .SH "Server Manager"
213.95 .LP
213.96 .LP
213.97 -To access ORBD's Server Manager and run a persistent server, the server must be started using \f2servertool\fP, which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. When a server is started using \f2servertool\fP, it must be started on the same host and port on which \f2orbd\fP is executing. If the server is run on a different port, the information stored in the database for local contexts will be invalid and the service will not work properly.
213.98 +To access ORBD's Server Manager and run a persistent server, the server must be started using servertool(1), which is a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server. When a server is started using \f2servertool\fP, it must be started on the same host and port on which \f2orbd\fP is executing. If the server is run on a different port, the information stored in the database for local contexts will be invalid and the service will not work properly.
213.99 .LP
213.100 .SS
213.101 Server Manager: an Example
213.102 .LP
213.103 .LP
213.104 -Using the sample tutorial for our demonstration, you would run the \f2idlj\fP compiler and \f2javac\fP compiler as shown in the tutorial. To run the Server Manager, follow these steps for running the application:
213.105 +Using the
213.106 +.na
213.107 +\f2sample tutorial\fP @
213.108 +.fi
213.109 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html for our demonstration, you would run the \f2idlj\fP compiler and \f2javac\fP compiler as shown in the tutorial. To run the Server Manager, follow these steps for running the application:
213.110 .LP
213.111 .LP
213.112 Start \f2orbd\fP.
213.113 @@ -337,11 +360,14 @@
213.114 .RS 3
213.115 .TP 2
213.116 o
213.117 -Naming Service
213.118 +.na
213.119 +\f2Naming Service\fP @
213.120 +.fi
213.121 +http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
213.122 .br
213.123 .TP 2
213.124 o
213.125 -servertool
213.126 +servertool(1)
213.127 .RE
213.128
213.129 .LP
214.1 --- a/src/solaris/doc/sun/man/man1/pack200.1 Tue May 12 15:21:55 2009 +0900
214.2 +++ b/src/solaris/doc/sun/man/man1/pack200.1 Thu May 14 00:17:25 2009 -0700
214.3 @@ -1,5 +1,4 @@
214.4 -.'" t
214.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
214.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
214.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
214.8 ."
214.9 ." This code is free software; you can redistribute it and/or modify it
214.10 @@ -19,12 +18,12 @@
214.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
214.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
214.13 ." have any questions.
214.14 -." `
214.15 -.TH pack200 1 "05 Aug 2006"
214.16 -." Generated by html2roff
214.17 +."
214.18 +.TH pack200 1 "04 May 2009"
214.19 +." Generated from HTML by html2man (author: Eric Armstrong)
214.20
214.21 .LP
214.22 -.SH NAME
214.23 +.SH "Name"
214.24 pack200 \- JAR Packing tool
214.25 .LP
214.26 .SH "SYNOPSIS"
214.27 @@ -40,6 +39,7 @@
214.28 .RS 3
214.29
214.30 .LP
214.31 +.RS 3
214.32 .TP 3
214.33 options
214.34 Command\-line options.
214.35 @@ -49,6 +49,8 @@
214.36 .TP 3
214.37 JAR\-file
214.38 Name of the input file.
214.39 +.RE
214.40 +
214.41 .LP
214.42 .RE
214.43 .SH "DESCRIPTION"
214.44 @@ -64,11 +66,13 @@
214.45 .SS
214.46 Typical usage:
214.47 .LP
214.48 +.RS 3
214.49
214.50 .LP
214.51 .LP
214.52 \f2% pack200 myarchive.pack.gz myarchive.jar\fP
214.53 .LP
214.54 +.RE
214.55 .LP
214.56 In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
214.57 .LP
214.58 @@ -176,15 +180,21 @@
214.59 .LP
214.60 Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
214.61 .LP
214.62 +.RS 3
214.63 .TP 3
214.64 true
214.65 .TP 3
214.66 false
214.67 In either case, the packer will set the deflation hint accordingly in the output archive, and will not transmit the individual deflation hints of archive elements.
214.68 +.RE
214.69 +
214.70 .LP
214.71 +.RS 3
214.72 .TP 3
214.73 keep
214.74 Preserve deflation hints observed in the input JAR. (This is the default.)
214.75 +.RE
214.76 +
214.77 .LP
214.78 .RE
214.79 .LP
214.80 @@ -196,12 +206,15 @@
214.81 .LP
214.82 The possible values are:
214.83 .LP
214.84 +.RS 3
214.85 .TP 3
214.86 latest
214.87 The packer will attempt to determine the latest modification time, among all the available entries in the original archive, or the latest modification time of all the available entries in that segment. This single value will be transmitted as part of the segment and applied to all the entries in each segment. This can marginally decrease the transmitted size of the archive at the expense of setting all installed files to a single date.
214.88 .TP 3
214.89 keep
214.90 Preserves modification times observed in the input JAR. (This is the default.)
214.91 +.RE
214.92 +
214.93 .LP
214.94 .RE
214.95 .LP
214.96 @@ -223,6 +236,7 @@
214.97 .LP
214.98 Overrides the default behavior; i.e., the classfile containing the unknown attribute will be passed through with the specified action. The possible values for actions are:
214.99 .LP
214.100 +.RS 3
214.101 .TP 3
214.102 error
214.103 The \f2pack200\fP operation as a whole will fail with a suitable explanation.
214.104 @@ -232,16 +246,18 @@
214.105 .TP 3
214.106 pass
214.107 Upon encountering this attribute, the entire class will be transmitted as though it is a resource.
214.108 +.RE
214.109 +
214.110 .LP
214.111 .RE
214.112 .LP
214.113 \f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
214.114 .br
214.115 - \f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
214.116 +\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
214.117 .br
214.118 - \f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
214.119 +\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
214.120 .br
214.121 - \f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
214.122 +\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
214.123 .LP
214.124 .RS 3
214.125
214.126 @@ -249,6 +265,7 @@
214.127 .LP
214.128 With the above four options, the attribute layout can be specified for a class entity, such as Class attribute, Field attribute, Method attribute, and Code attribute. The attribute\-name is the name of the attribute for which the layout or action is being defined. The possible values for action are:
214.129 .LP
214.130 +.RS 3
214.131 .TP 3
214.132 some\-layout\-string
214.133 The layout language is defined in the JSR 200 specification.
214.134 @@ -260,6 +277,8 @@
214.135 .TP 3
214.136 strip
214.137 Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures.
214.138 +.RE
214.139 +
214.140 .LP
214.141 .LP
214.142 Example: \f2\-\-class\-attribute=CompilationID=pass\fP will cause the class file containing this attribute to be passed through without further action by the packer.
214.143 @@ -367,29 +386,29 @@
214.144 .LP
214.145 .RS 3
214.146 .TP 2
214.147 -*
214.148 -unpack200 \- JAR Unpacking Tool
214.149 +o
214.150 +unpack200(1)
214.151 .TP 2
214.152 -*
214.153 -\f2unpack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
214.154 +o
214.155 +.na
214.156 +\f2Java SE Documentation\fP @
214.157 +.fi
214.158 +http://java.sun.com/javase/6/docs/index.html
214.159 .TP 2
214.160 -*
214.161 -Java SE Documentation
214.162 -.TP 2
214.163 -*
214.164 +o
214.165 .na
214.166 \f2Java Deployment Guide \- Pack200\fP @
214.167 .fi
214.168 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
214.169 .TP 2
214.170 -*
214.171 -\f2jar\fP \- Java Archive Tool
214.172 +o
214.173 +jar(1) \- Java Archive Tool
214.174 .TP 2
214.175 -*
214.176 -.na
214.177 -\f2jarsigner\fP \- JAR Signer tool @
214.178 -.fi
214.179 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
214.180 +o
214.181 +jarsigner(1) \- JAR Signer tool
214.182 +.TP 2
214.183 +o
214.184 +\f2attributes(5)\fP man page
214.185 .RE
214.186
214.187 .LP
214.188 @@ -401,6 +420,8 @@
214.189 This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
214.190 .LP
214.191 .LP
214.192 -The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
214.193 +The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
214.194 +.LP
214.195 +
214.196 .LP
214.197
215.1 --- a/src/solaris/doc/sun/man/man1/policytool.1 Tue May 12 15:21:55 2009 +0900
215.2 +++ b/src/solaris/doc/sun/man/man1/policytool.1 Thu May 14 00:17:25 2009 -0700
215.3 @@ -1,4 +1,3 @@
215.4 -.'" t
215.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
215.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
215.7 ."
215.8 @@ -19,12 +18,12 @@
215.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
215.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
215.11 ." have any questions.
215.12 -." `
215.13 -.TH policytool 1 "07 Aug 2006"
215.14 -." Generated by html2man
215.15 +."
215.16 +.TH policytool 1 "04 May 2009"
215.17 +." Generated from HTML by html2man (author: Eric Armstrong)
215.18
215.19 .LP
215.20 -.SH NAME
215.21 +.SH "Name"
215.22 policytool \- PolicyTool Administration GUI Utility
215.23 .LP
215.24 \f3policytool\fP reads and writes a plain text policy file based on user input via the utility GUI.
215.25 @@ -53,20 +52,14 @@
215.26 filename
215.27 The file name
215.28 .RE
215.29 -.RE
215.30 -
215.31 -.LP
215.32 -.SH "DESCRIPTION"
215.33 -.LP
215.34 +.SH "DESCRIPTION"
215.35 .LP
215.36 \f3policytool\fP is a GUI that allows users to create and manage policy files. For details, see
215.37 .na
215.38 \f2the Policytool Users Guide\fP @
215.39 .fi
215.40 -http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
215.41 -.LP
215.42 -.SH "OPTIONS"
215.43 -.LP
215.44 +http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
215.45 +.SH "OPTIONS"
215.46 .RS 3
215.47 .TP 3
215.48 file
215.49 @@ -93,6 +86,9 @@
215.50 http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
215.51 .br
215.52 .RE
215.53 +.RE
215.54 +
215.55 +.LP
215.56
215.57 .LP
215.58
216.1 --- a/src/solaris/doc/sun/man/man1/rmic.1 Tue May 12 15:21:55 2009 +0900
216.2 +++ b/src/solaris/doc/sun/man/man1/rmic.1 Thu May 14 00:17:25 2009 -0700
216.3 @@ -1,5 +1,4 @@
216.4 -.'" t
216.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
216.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
216.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
216.8 ."
216.9 ." This code is free software; you can redistribute it and/or modify it
216.10 @@ -19,19 +18,21 @@
216.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
216.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
216.13 ." have any questions.
216.14 -." `
216.15 -.TH rmic 1 "05 Aug 2006"
216.16 -." Generated by html2roff
216.17 +."
216.18 +.TH rmic 1 "04 May 2009"
216.19 +." Generated from HTML by html2man (author: Eric Armstrong)
216.20
216.21 .LP
216.22 -.SH NAME
216.23 +.SH "Name"
216.24 rmic \- The Java RMI Compiler
216.25 .LP
216.26 +.RS 3
216.27
216.28 .LP
216.29 .LP
216.30 \f3rmic\fP generates stub, skeleton, and tie classes for remote objects using either the JRMP or IIOP protocols. Also generates OMG IDL.
216.31 .LP
216.32 +.RE
216.33 .SH "SYNOPSIS"
216.34 .LP
216.35
216.36 @@ -83,6 +84,7 @@
216.37 .LP
216.38
216.39 .LP
216.40 +.RS 3
216.41 .TP 3
216.42 \-bootclasspath path
216.43 Overrides location of bootstrap class files
216.44 @@ -135,6 +137,7 @@
216.45 .TP 3
216.46 \-g
216.47 Enables generation of all debugging information, including local variables. By default, only line number information is generated.
216.48 +.LP
216.49 .TP 3
216.50 \-idl
216.51 Causes \f2rmic\fP to generate OMG IDL for the classes specified and any classes referenced. IDL provides a purely declarative, programming language\-independent way of specifying an object's API. The IDL is used as a specification for methods and data that can be written in and invoked from any language that provides CORBA bindings. This includes Java and C++ among others. See the
216.52 @@ -144,6 +147,7 @@
216.53 http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) document for a complete description.
216.54 .LP
216.55 When the \f2\-idl\fP option is used, other options also include:
216.56 +.RS 3
216.57 .TP 3
216.58 \-always or \-alwaysgenerate
216.59 Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
216.60 @@ -151,13 +155,12 @@
216.61 \-factory
216.62 Uses factory keyword in generated IDL.
216.63 .TP 3
216.64 -\-idlModule\ fromJavaPackage[.class]\
216.65 -toIDLModule
216.66 +\-idlModule\ fromJavaPackage[.class]\ toIDLModule
216.67 Specifies IDLEntity package mapping. For example:\ \f2\-idlModule foo.bar my::real::idlmod\fP.
216.68 .TP 3
216.69 -\-idlFile\ fromJavaPackage[.class]\
216.70 -toIDLFile
216.71 -Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
216.72 +\-idlFile\ fromJavaPackage[.class]\ toIDLFile
216.73 +Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
216.74 +.RE
216.75 .LP
216.76 .TP 3
216.77 \-iiop
216.78 @@ -183,6 +186,7 @@
216.79 .RE
216.80 .LP
216.81 When the \f2\-iiop\fP option is used, other options also include:
216.82 +.RS 3
216.83 .TP 3
216.84 \-always or \-alwaysgenerate
216.85 Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
216.86 @@ -200,7 +204,8 @@
216.87 .na
216.88 \f2Portable Object Adapter\fP @
216.89 .fi
216.90 -http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
216.91 +http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) defines the native \f2Servant\fP type. In the Java programming language, the \f2Servant\fP type is mapped to the Java \f2org.omg.PortableServer.Servant\fP class. It serves as the base class for all POA servant implementations and provides a number of methods that may be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. Based on the OMG IDL to Java Language Mapping Specification, CORBA V 2.3.1 ptc/00\-01\-08.pdf.
216.92 +.RE
216.93 .TP 3
216.94 \-J
216.95 Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
216.96 @@ -210,23 +215,29 @@
216.97 .TP 3
216.98 \-nowarn
216.99 Turns off warnings. If used the compiler does not print out any warnings.
216.100 +.LP
216.101 .TP 3
216.102 \-vcompat
216.103 Generates stub and skeleton classes compatible with both the 1.1 and 1.2 JRMP stub protocol versions. (This option was the default in releases prior to 5.0.) The generated stub classes will use the 1.1 stub protocol version when loaded in a JDK 1.1 virtual machine and will use the 1.2 stub protocol version when loaded into a 1.2 (or later) virtual machine. The generated skeleton classes will support both 1.1 and 1.2 stub protocol versions. The generated classes are relatively large in order to support both modes of operation.
216.104 .TP 3
216.105 \-verbose
216.106 Causes the compiler and linker to print out messages about what classes are being compiled and what class files are being loaded.
216.107 +.LP
216.108 .TP 3
216.109 \-v1.1
216.110 Generates stub and skeleton classes for the 1.1 JRMP stub protocol version only. Note that this option is only useful for generating stub classes that are serialization\-compatible with pre\-existing, statically\-deployed stub classes that were generated by the \f3rmic\fP tool from JDK 1.1 and that cannot be upgraded (and dynamic class loading is not being used).
216.111 +.LP
216.112 .TP 3
216.113 \-v1.2
216.114 (default) Generates stub classes for the 1.2 JRMP stub protocol version only. No skeleton classes are generated with this option because skeleton classes are not used with the 1.2 stub protocol version. The generated stub classes will not work if they are loaded into a JDK 1.1 virtual machine.
216.115 +.RE
216.116 +
216.117 .LP
216.118 .SH "ENVIRONMENT VARIABLES"
216.119 .LP
216.120
216.121 .LP
216.122 +.RS 3
216.123 .TP 3
216.124 CLASSPATH
216.125 Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example,
216.126 @@ -241,6 +252,7 @@
216.127 \fP
216.128 .fi
216.129 .RE
216.130 +.RE
216.131
216.132 .LP
216.133 .SH "SEE ALSO"
216.134 @@ -248,7 +260,11 @@
216.135
216.136 .LP
216.137 .LP
216.138 -java, javac, CLASSPATH
216.139 +java(1), javac(1),
216.140 +.na
216.141 +\f2CLASSPATH\fP @
216.142 +.fi
216.143 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
216.144 .LP
216.145
216.146 .LP
217.1 --- a/src/solaris/doc/sun/man/man1/rmid.1 Tue May 12 15:21:55 2009 +0900
217.2 +++ b/src/solaris/doc/sun/man/man1/rmid.1 Thu May 14 00:17:25 2009 -0700
217.3 @@ -1,5 +1,4 @@
217.4 -.'" t
217.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
217.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
217.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
217.8 ."
217.9 ." This code is free software; you can redistribute it and/or modify it
217.10 @@ -19,20 +18,21 @@
217.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
217.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
217.13 ." have any questions.
217.14 -." `
217.15 -.TH rmid 1 "05 Aug 2006"
217.16 -." Generated by html2roff
217.17 -.\\" Changed by: Ann Wollrath \- JavaSoft East, 2\-Mar\-2000
217.18 -.\\" Changed by: Jen McGinn \- Jini Technology Software, 6\-Mar\-2000
217.19 +."
217.20 +.TH rmid 1 "04 May 2009"
217.21 +." Generated from HTML by html2man (author: Eric Armstrong)
217.22 +
217.23 .LP
217.24 -.SH NAME
217.25 +.SH "Name"
217.26 rmid \- The Java RMI Activation System Daemon
217.27 .LP
217.28 +.RS 3
217.29
217.30 .LP
217.31 .LP
217.32 \f3rmid\fP starts the activation system daemon that allows objects to be registered and activated in a virtual machine (VM).
217.33 .LP
217.34 +.RE
217.35 .SH "SYNOPSIS"
217.36 .LP
217.37
217.38 @@ -55,7 +55,7 @@
217.39 .na
217.40 \f2Java RMI Specification\fP @
217.41 .fi
217.42 -http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html and
217.43 +http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html and
217.44 .na
217.45 \f2Activation tutorials\fP @
217.46 .fi
217.47 @@ -81,10 +81,10 @@
217.48 .LP
217.49 .RS 3
217.50 .TP 2
217.51 -*
217.52 +o
217.53 starts the Activator and an internal registry on the default port, 1098, and
217.54 .TP 2
217.55 -*
217.56 +o
217.57 binds an \f2ActivationSystem\fP to the name \f2java.rmi.activation.ActivationSystem\fP in this internal registry.
217.58 .RE
217.59
217.60 @@ -105,8 +105,7 @@
217.61 starts the activation system daemon and a registry on the registry's default port, 1099.
217.62 .LP
217.63 .SS
217.64 -Starting rmid from
217.65 -inetd/xinetd
217.66 +Starting rmid from inetd/xinetd
217.67 .LP
217.68 .LP
217.69 An alternative to starting \f2rmid\fP from the command line is to configure \f2inetd\fP (Solaris) or \f2xinetd\fP (Linux) to start \f2rmid\fP on demand.
217.70 @@ -119,13 +118,13 @@
217.71 .LP
217.72 .RS 3
217.73 .TP 2
217.74 -*
217.75 +o
217.76 Output printed to \f2System.err\fP is redirected to a file. This file is located in the directory specified by the \f2java.io.tmpdir\fP system property (typically \f2/var/tmp\fP or \f2/tmp\fP) with the prefix \f2"rmid\-err"\fP and the suffix \f2"tmp"\fP.
217.77 .TP 2
217.78 -*
217.79 +o
217.80 The \f2\-port\fP option is disallowed. If this option is specified, \f2rmid\fP will exit with an error message.
217.81 .TP 2
217.82 -*
217.83 +o
217.84 The \f2\-log\fP option is required. If this option is not specified, \f2rmid\fP will exit with an error message.
217.85 .RE
217.86
217.87 @@ -137,6 +136,7 @@
217.88 .LP
217.89
217.90 .LP
217.91 +.RS 3
217.92 .TP 3
217.93 \-C<someCommandLineOption>
217.94 Specifies an option that is passed as a command\-line argument to each child process (activation group) of \f2rmid\fP when that process is created. For example, you could pass a property to each virtual machine spawned by the activation system daemon:
217.95 @@ -168,13 +168,12 @@
217.96 \fP
217.97 .fi
217.98 .TP 3
217.99 -
217.100 \-J\-Dsun.rmi.activation.execPolicy=<policy>
217.101 Specifies the policy that \f2rmid\fP employs to check commands and command\-line options used to launch the VM in which an activation group runs. Please note that this option exists only in Sun's implementation of the Java RMI activation daemon. If this property is not specified on the command line, the result is the same as if \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP were specified. The possible values of \f2<policy>\fP can be \f2default\fP, \f2<policyClassName>\fP, or \f2none\fP:
217.102 .LP
217.103 .RS 3
217.104 .TP 2
217.105 -*
217.106 +o
217.107 \f3default (or if this property is \fP\f4unspecified\fP\f3)\fP
217.108 .LP
217.109 The default \f2execPolicy\fP allows \f2rmid\fP to execute commands with specific command\-line options only if \f2rmid\fP has been granted permission to execute those commands and options in the security policy file that \f2rmid\fP uses. Only the default activation group implementation can be used with the \f2default\fP execution policy.
217.110 @@ -190,7 +189,8 @@
217.111 .LP
217.112 The permission \f2com.sun.rmi.rmid.ExecPermission\fP is used to grant \f2rmid\fP permission to execute a command, specified in the group descriptor's \f2CommandEnvironment\fP to launch an activation group. The permission \f2com.sun.rmi.rmid.ExecOptionPermission\fP is used to allow \f2rmid\fP to use command\-line options, specified as properties overrides in the group descriptor or as options in the \f2CommandEnvironment\fP, when launching the activation group.
217.113 .LP
217.114 -When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources).
217.115 +When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources).
217.116 +.RS 3
217.117 .TP 3
217.118 ExecPermission
217.119 The \f2ExecPermission\fP class represents permission for \f2rmid\fP to execute a specific \f2command\fP to launch an activation group.
217.120 @@ -210,8 +210,7 @@
217.121 .LP
217.122 For example: "*" or "\-Dfoo.*" or "\-Da.b.c=*" is valid, "*foo" or "\-Da*b" or "ab*" is not.
217.123 .TP 3
217.124 -Policy file for
217.125 -rmid
217.126 +Policy file for rmid
217.127 When granting \f2rmid\fP permission to execute various commands and options, the permissions \f2ExecPermission\fP and \f2ExecOptionPermission\fP need to be granted universally (i.e., granted to all code sources). It is safe to grant these permissions universally because only \f2rmid\fP checks these permissions.
217.128 .LP
217.129 An example policy file that grants various execute permissions to \f2rmid\fP is:
217.130 @@ -222,13 +221,7 @@
217.131 .fl
217.132 permission com.sun.rmi.rmid.ExecPermission
217.133 .fl
217.134 - "/files/apps/java/jdk1.2.2/solaris/bin/java";
217.135 -.fl
217.136 -
217.137 -.fl
217.138 - permission com.sun.rmi.rmid.ExecPermission
217.139 -.fl
217.140 - "/files/apps/java/jdk1.2.2/solaris/bin/java_g";
217.141 + "/files/apps/java/jdk1.7.0/solaris/bin/java";
217.142 .fl
217.143
217.144 .fl
217.145 @@ -258,9 +251,9 @@
217.146 .fl
217.147 \fP
217.148 .fi
217.149 -The first two permissions granted allow \f2rmid\fP to execute the 1.2.2 version of the \f2java\fP and \f2java_g\fP commands, specified by their explicit path names. Note that by default, the version of the \f2java\fP command found in \f2java.home\fP is used (the same one that \f2rmid\fP uses), and does not need to be specified in the policy file. The third permission allows \f2rmid\fP to execute any command in the directory \f2/files/apps/rmidcmds\fP.
217.150 +The first permission granted allow \f2rmid\fP to execute the 1.7.0 version of the \f2java\fP command, specified by its explicit path name. Note that by default, the version of the \f2java\fP command found in \f2java.home\fP is used (the same one that \f2rmid\fP uses), and does not need to be specified in the policy file. The second permission allows \f2rmid\fP to execute any command in the directory \f2/files/apps/rmidcmds\fP.
217.151 .LP
217.152 -The fourth permission granted, an \f2ExecOptionPermission\fP, allows \f2rmid\fP to launch an activation group that defines the security policy file to be \f2/files/policies/group.policy\fP. The next permission allows the \f2java.security.debug\fP property to be used by an activation group. The last permission allows any property in the \f2sun.rmi\fP property name hierarchy to be used by activation groups.
217.153 +The third permission granted, an \f2ExecOptionPermission\fP, allows \f2rmid\fP to launch an activation group that defines the security policy file to be \f2/files/policies/group.policy\fP. The next permission allows the \f2java.security.debug\fP property to be used by an activation group. The last permission allows any property in the \f2sun.rmi\fP property name hierarchy to be used by activation groups.
217.154 .LP
217.155 To start \f2rmid\fP with a policy file, the \f2java.security.policy\fP property needs to be specified on \f2rmid\fP's command line, for example:
217.156 .RS 3
217.157 @@ -270,10 +263,12 @@
217.158 \f2rmid \-J\-Djava.security.policy=rmid.policy\fP
217.159 .LP
217.160 .RE
217.161 +.RE
217.162 .TP 2
217.163 -*
217.164 +o
217.165 +.LP
217.166 .TP 2
217.167 -*
217.168 +o
217.169 \f4<policyClassName>\fP
217.170 .LP
217.171 If the default behavior is not flexible enough, an administrator can provide, when starting \f2rmid\fP, the name of a class whose \f2checkExecCommand\fP method is executed in order to check commands to be executed by rmid.
217.172 @@ -293,14 +288,16 @@
217.173 Before launching an activation group, \f2rmid\fP calls the policy's \f2checkExecCommand\fP method, passing it the activation group descriptor and an array containing the complete command to launch the activation group. If the \f2checkExecCommand\fP throws a \f2SecurityException\fP, \f2rmid\fP will not launch the activation group and an \f2ActivationException\fP will be thrown to the caller attempting to activate the object.
217.174 .LP
217.175 .TP 2
217.176 -*
217.177 +o
217.178 \f3none\fP
217.179 .LP
217.180 If the \f2sun.rmi.activation.execPolicy\fP property value is "none", then \f2rmid\fP will not perform any validation of commands to launch activation groups.
217.181 .RE
217.182 +.LP
217.183 .TP 3
217.184 \-log dir
217.185 Specifies the name of the directory the activation system daemon uses to write its database and associated information. The log directory defaults to creating a directory, \f2log\fP, in the directory in which the \f2rmid\fP command was executed.
217.186 +.LP
217.187 .TP 3
217.188 \-port port
217.189 Specifies the port \f2rmid\fP's registry uses. The activation system daemon binds the \f2ActivationSystem\fP, with the name \f2java.rmi.activation.ActivationSystem\fP, in this registry. Thus, the \f2ActivationSystem\fP on the local machine can be obtained using the following \f2Naming.lookup\fP method call:
217.190 @@ -320,11 +317,13 @@
217.191 .fi
217.192 .TP 3
217.193 \-stop
217.194 -Stops the current invocation of \f2rmid\fP, for a port specified by the \f2\-port\fP option. If no port is specified, it will stop the \f2rmid\fP running on port 1098.
217.195 +Stops the current invocation of \f2rmid\fP, for a port specified by the \f2\-port\fP option. If no port is specified, it will stop the \f2rmid\fP running on port 1098.
217.196 +.RE
217.197 .SH "ENVIRONMENT VARIABLES"
217.198 .LP
217.199
217.200 .LP
217.201 +.RS 3
217.202 .TP 3
217.203 CLASSPATH
217.204 Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example:
217.205 @@ -335,6 +334,7 @@
217.206 .fl
217.207 \fP
217.208 .fi
217.209 +.RE
217.210
217.211 .LP
217.212 .SH "SEE ALSO"
217.213 @@ -342,7 +342,11 @@
217.214
217.215 .LP
217.216 .LP
217.217 -rmic, CLASSPATH, java
217.218 +rmic(1),
217.219 +.na
217.220 +\f2CLASSPATH\fP @
217.221 +.fi
217.222 +http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath, java(1)
217.223 .LP
217.224
217.225 .LP
218.1 --- a/src/solaris/doc/sun/man/man1/rmiregistry.1 Tue May 12 15:21:55 2009 +0900
218.2 +++ b/src/solaris/doc/sun/man/man1/rmiregistry.1 Thu May 14 00:17:25 2009 -0700
218.3 @@ -1,5 +1,4 @@
218.4 -.'" t
218.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
218.6 +." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
218.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
218.8 ."
218.9 ." This code is free software; you can redistribute it and/or modify it
218.10 @@ -19,19 +18,21 @@
218.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
218.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
218.13 ." have any questions.
218.14 -." `
218.15 -.TH rmiregistry 1 "05 Aug 2006"
218.16 -." Generated by html2roff
218.17 +."
218.18 +.TH rmiregistry 1 "04 May 2009"
218.19 +." Generated from HTML by html2man (author: Eric Armstrong)
218.20
218.21 .LP
218.22 -.SH NAME
218.23 +.SH "Name"
218.24 rmiregistry \- The Java Remote Object Registry
218.25 .LP
218.26 +.RS 3
218.27
218.28 .LP
218.29 .LP
218.30 The \f3rmiregistry\fP command starts a remote object registry on the specified port on the current host.
218.31 .LP
218.32 +.RE
218.33 .SH "SYNOPSIS"
218.34 .LP
218.35
218.36 @@ -71,24 +72,27 @@
218.37 .LP
218.38
218.39 .LP
218.40 +.RS 3
218.41 .TP 3
218.42 \-J
218.43 Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
218.44 +.RE
218.45 +
218.46 .LP
218.47 .SH "SEE ALSO"
218.48 .LP
218.49
218.50 .LP
218.51 .LP
218.52 -java,
218.53 +java(1),
218.54 .na
218.55 \f2java.rmi.registry.LocateRegistry\fP @
218.56 .fi
218.57 -http://java.sun.com/javase/6/docs/api/java/rmi/registry/locateregistry.html and
218.58 +http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html and
218.59 .na
218.60 \f2java.rmi.Naming\fP @
218.61 .fi
218.62 -http://java.sun.com/javase/6/docs/api/java/rmi/naming.html
218.63 +http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
218.64 .LP
218.65
218.66 .LP
219.1 --- a/src/solaris/doc/sun/man/man1/schemagen.1 Tue May 12 15:21:55 2009 +0900
219.2 +++ b/src/solaris/doc/sun/man/man1/schemagen.1 Thu May 14 00:17:25 2009 -0700
219.3 @@ -1,5 +1,4 @@
219.4 -.'" t
219.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
219.6 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
219.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
219.8 ."
219.9 ." This code is free software; you can redistribute it and/or modify it
219.10 @@ -19,19 +18,18 @@
219.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
219.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
219.13 ." have any questions.
219.14 -." `
219.15 -.TH schemagen 1 "07 Aug 2006"
219.16 -." Generated by html2man
219.17 +."
219.18 +.TH schemagen 1 "04 May 2009"
219.19 +." Generated from HTML by html2man (author: Eric Armstrong)
219.20
219.21 .LP
219.22 -.ad c
219.23 -.SH NAME
219.24 -schemagen \- Java(TM) Architecture for XML Binding Schema Generator \f3Specification Version:\fP 2.0
219.25 +.SH "Name"
219.26 +schemagen \- Java(TM) Architecture for XML Binding Schema Generator
219.27 +.LP
219.28 +.LP
219.29 +\f3Specification Version:\fP 2.1
219.30 .br
219.31 -\f3Reference Implementation (RI) Version:\fP 2.0 ea3
219.32 -.br
219.33 -.ad l
219.34 -
219.35 +\f3Implementation Version:\fP 2.1.3
219.36 .LP
219.37 .SS
219.38 Launching schemagen
219.39 @@ -43,36 +41,21 @@
219.40 The current schema generator can process either Java source files or class files.
219.41 .LP
219.42 .LP
219.43 -We also provide an Ant task to run the schema generator \- see the instructions for using schemagen with Ant.
219.44 +We also provide an Ant task to run the schema generator \- see the instructions for
219.45 +.na
219.46 +\f2using schemagen with Ant\fP @
219.47 +.fi
219.48 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
219.49 .LP
219.50 .RS 3
219.51
219.52 .LP
219.53 -\f3For Solaris/Linux\fP
219.54 -.LP
219.55 .nf
219.56 \f3
219.57 .fl
219.58 - % path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
219.59 +% schemagen.sh Foo.java Bar.java ...
219.60 .fl
219.61 - Note: Writing schema1.xsd
219.62 -.fl
219.63 -
219.64 -.fl
219.65 -\fP
219.66 -.fi
219.67 -
219.68 -.LP
219.69 -\f3For WindowsNT/2000/XP\fP
219.70 -.LP
219.71 -.nf
219.72 -\f3
219.73 -.fl
219.74 - > path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
219.75 -.fl
219.76 - Note: Writing schema1.xsd
219.77 -.fl
219.78 -
219.79 +Note: Writing schema1.xsd
219.80 .fl
219.81 \fP
219.82 .fi
219.83 @@ -107,8 +90,6 @@
219.84 .fl
219.85 \-help : Display this usage message
219.86 .fl
219.87 -
219.88 -.fl
219.89 \fP
219.90 .fi
219.91 .RE
219.92 @@ -119,145 +100,35 @@
219.93 Generated Resource Files
219.94 .LP
219.95 .LP
219.96 -The current schema generator simply creates a schema file for each namespace referenced in your Java classes. There is no way to control the name of the generated schema files at this time. For that purpose, use the schema generator ant task.
219.97 +The current schema generator simply creates a schema file for each namespace referenced in your Java classes. There is no way to control the name of the generated schema files at this time. For that purpose, use
219.98 +.na
219.99 +\f2the schema generator ant task\fP @
219.100 +.fi
219.101 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
219.102 .LP
219.103 .SH "See Also"
219.104 .LP
219.105 .RS 3
219.106 .TP 2
219.107 o
219.108 -JAXB 2.0:
219.109 -.RS 3
219.110 -.TP 2
219.111 -*
219.112 +Running the schema generator (schemagen): [
219.113 .na
219.114 -\f2Release Notes\fP @
219.115 +\f2command\-line instructions\fP @
219.116 .fi
219.117 -http://java.sun.com/webservices/docs/2.0/jaxb/ReleaseNotes.html
219.118 -.TP 2
219.119 -*
219.120 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html,
219.121 .na
219.122 -\f2XJC\fP @
219.123 +\f2using the SchemaGen Ant task\fP @
219.124 .fi
219.125 -http://java.sun.com/webservices/docs/2.0/jaxb/xjc.html
219.126 -.TP 2
219.127 -*
219.128 -.na
219.129 -\f2XJCTask\fP @
219.130 -.fi
219.131 -http://java.sun.com/webservices/docs/2.0/jaxb/xjcTask.html
219.132 -.TP 2
219.133 -*
219.134 -.na
219.135 -\f2SchemaGen\fP @
219.136 -.fi
219.137 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagen.html
219.138 -.TP 2
219.139 -*
219.140 -.na
219.141 -\f2schemagenTask\fP @
219.142 -.fi
219.143 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagenTask.html
219.144 -.TP 2
219.145 -*
219.146 -.na
219.147 -\f2Sample Apps\fP @
219.148 -.fi
219.149 -http://java.sun.com/webservices/docs/2.0/jaxb/samples.html
219.150 -.TP 2
219.151 -*
219.152 -.na
219.153 -\f2Changelog\fP @
219.154 -.fi
219.155 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog2.html
219.156 -.RE
219.157 +https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
219.158 .TP 2
219.159 o
219.160 -JAXB 1.0.x:
219.161 -.RS 3
219.162 -.TP 2
219.163 -*
219.164 .na
219.165 -\f2Release Notes\fP @
219.166 +\f2Java Architecture for XML Binding (JAXB)\fP @
219.167 .fi
219.168 -http://java.sun.com/webservices/docs/2.0/jaxb/jaxb\-1_0.html
219.169 -.TP 2
219.170 -*
219.171 -.na
219.172 -\f2Changelog\fP @
219.173 -.fi
219.174 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog.html
219.175 -.RE
219.176 -.TP 2
219.177 -o
219.178 -JAXB RI Extensions:
219.179 -.RS 3
219.180 -.TP 2
219.181 -*
219.182 -.na
219.183 -\f2Runtime Properties\fP @
219.184 -.fi
219.185 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorProperties.html
219.186 -.TP 2
219.187 -*
219.188 -.na
219.189 -\f2XJC Customizations\fP @
219.190 -.fi
219.191 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorCustomizations.html
219.192 -.TP 2
219.193 -*
219.194 -.na
219.195 -\f2Develop Plugins\fP @
219.196 -.fi
219.197 -http://java.sun.com/webservices/docs/2.0/jaxb/developPlugins.html
219.198 -.RE
219.199 -.TP 2
219.200 -o
219.201 -JAXB RI Schema Languages:
219.202 -.RS 3
219.203 -.TP 2
219.204 -*
219.205 -.na
219.206 -\f2W3C XML Schema\fP @
219.207 -.fi
219.208 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#xschema
219.209 -.TP 2
219.210 -*
219.211 -.na
219.212 -\f2RELAX NG\fP @
219.213 -.fi
219.214 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#relaxng
219.215 -.TP 2
219.216 -*
219.217 -.na
219.218 -\f2DTD\fP @
219.219 -.fi
219.220 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#dtd
219.221 -.RE
219.222 -.TP 2
219.223 -o
219.224 -JAXB Community:
219.225 -.RS 3
219.226 -.TP 2
219.227 -*
219.228 -.na
219.229 -\f2Java.net Homepage\fP @
219.230 -.fi
219.231 -http://jaxb.dev.java.net
219.232 -.TP 2
219.233 -*
219.234 -.na
219.235 -\f2Developer interest list\fP @
219.236 -.fi
219.237 -https://jaxb.dev.java.net/servlets/ProjectMailingListList
219.238 -.TP 2
219.239 -*
219.240 -.na
219.241 -\f2FAQ\fP @
219.242 -.fi
219.243 -https://jaxb.dev.java.net/faq/index.html
219.244 -.RE
219.245 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
219.246 .RE
219.247
219.248 .LP
219.249 +
219.250 +.LP
219.251
220.1 --- a/src/solaris/doc/sun/man/man1/serialver.1 Tue May 12 15:21:55 2009 +0900
220.2 +++ b/src/solaris/doc/sun/man/man1/serialver.1 Thu May 14 00:17:25 2009 -0700
220.3 @@ -1,5 +1,4 @@
220.4 -.'" t
220.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
220.6 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
220.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
220.8 ."
220.9 ." This code is free software; you can redistribute it and/or modify it
220.10 @@ -19,19 +18,21 @@
220.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
220.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
220.13 ." have any questions.
220.14 -." `
220.15 -.TH serialver 1 "05 Aug 2006"
220.16 -." Generated by html2roff
220.17 +."
220.18 +.TH serialver 1 "04 May 2009"
220.19 +." Generated from HTML by html2man (author: Eric Armstrong)
220.20
220.21 .LP
220.22 -.SH NAME
220.23 +.SH "Name"
220.24 serialver \- The Serial Version Command
220.25 .LP
220.26 +.RS 3
220.27
220.28 .LP
220.29 .LP
220.30 The \f3serialver\fP command returns the \f2serialVersionUID\fP.
220.31 .LP
220.32 +.RE
220.33 .SH "SYNOPSIS"
220.34 .LP
220.35
220.36 @@ -47,12 +48,15 @@
220.37 .RS 3
220.38
220.39 .LP
220.40 +.RS 3
220.41 .TP 3
220.42 options
220.43 Command\-line options, as specified in this document.
220.44 .TP 3
220.45 classnames
220.46 One or more class names
220.47 +.RE
220.48 +
220.49 .LP
220.50 .RE
220.51 .SH "DESCRIPTION"
220.52 @@ -66,17 +70,22 @@
220.53 .LP
220.54
220.55 .LP
220.56 +.RS 3
220.57 .TP 3
220.58 -\-classpath <directories and zip/jar files separated
220.59 -by :>
220.60 +\-classpath <directories and zip/jar files separated by :>
220.61 Set search path for application classes and resources.
220.62 +.RE
220.63 +
220.64 .LP
220.65 +.RS 3
220.66 .TP 3
220.67 \-show
220.68 Displays a simple user interface. Enter the full class name and press either the Enter key or the Show button to display the serialVersionUID.
220.69 .TP 3
220.70 \-Joption
220.71 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java application launcher. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
220.72 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes.
220.73 +.RE
220.74 +
220.75 .LP
220.76 .SH "NOTES"
220.77 .LP
220.78 @@ -110,7 +119,7 @@
220.79 .na
220.80 \f2java.io.ObjectStreamClass\fP @
220.81 .fi
220.82 -http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
220.83 +http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
220.84 .LP
220.85
220.86 .LP
221.1 --- a/src/solaris/doc/sun/man/man1/servertool.1 Tue May 12 15:21:55 2009 +0900
221.2 +++ b/src/solaris/doc/sun/man/man1/servertool.1 Thu May 14 00:17:25 2009 -0700
221.3 @@ -1,5 +1,4 @@
221.4 -.'" t
221.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
221.6 +." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
221.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
221.8 ."
221.9 ." This code is free software; you can redistribute it and/or modify it
221.10 @@ -19,17 +18,19 @@
221.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
221.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
221.13 ." have any questions.
221.14 -." `
221.15 -.TH servertool 1 "05 Aug 2006"
221.16 -." Generated by html2roff
221.17 +."
221.18 +.TH servertool 1 "04 May 2009"
221.19 +." Generated from HTML by html2man (author: Eric Armstrong)
221.20
221.21 .LP
221.22 -.SH NAME
221.23 +.SH "Name"
221.24 servertool \- The Java(TM) IDL Server Tool
221.25 .LP
221.26 +.RS 3
221.27
221.28 .LP
221.29 -\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
221.30 +\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
221.31 +.RE
221.32 .SH "SYNOPSIS"
221.33 .LP
221.34
221.35 @@ -63,37 +64,29 @@
221.36 .LP
221.37
221.38 .LP
221.39 +.RS 3
221.40 .TP 3
221.41 \-ORBInitialHost nameserverhost
221.42 Specifies the host machine on which the name server is running and listening for incoming requests. The \f2nameserverhost\fP defaults to \f2localhost\fP if this option is not specified. If \f2orbd\fP and \f2servertool\fP are running on different machines, you must specify the name or IP address of the host on which \f2orbd\fP is running.
221.43 .TP 3
221.44 \-Joption
221.45 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
221.46 -.na
221.47 -\f2java a pplication launcher\fP @
221.48 -.fi
221.49 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
221.50 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
221.51 +.RE
221.52 +
221.53 .LP
221.54 .SH "COMMANDS"
221.55 .LP
221.56
221.57 .LP
221.58 +.RS 3
221.59 .TP 3
221.60 -register \-server\ <server\ class\ name>
221.61 -\ \-classpath\ <classpath\ to\ server>
221.62 -[\ \-applicationName\ <application\ name>
221.63 -\-args\ <args\ to\ server>
221.64 -\-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM>
221.65 -\ ]
221.66 +register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
221.67 Register a new persistent server with the Object Request Broker Daemon (ORBD). If the server is not already registered, it is registered and activated. This command causes an install method to be invoked in the main class of the server identified by the \f2\-server\fP option. The install method must be \f2public static void install(org.omg.CORBA.ORB)\fP. The install method is optional and enables the developer to provide their own server installation behavior (for example, creating database schema).
221.68 .TP 3
221.69 -unregister
221.70 -\-serverid\ <server\ id\ >\ |
221.71 -\-applicationName\ <application\ name>
221.72 +unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
221.73 Unregister a server from the ORBD by using either its server id or its application name. This command causes an uninstall method to be invoked in the main class of the server identified by the \f2\-server\fP option. The uninstall method must be \f2public static void uninstall(org.omg.CORBA.ORB)\fP. The uninstall method is optional and enables the developer to provide their own server uninstall behavior (for example, undoing the behavior of the install method).
221.74 .TP 3
221.75 -getserverid
221.76 -\-applicationName\ <application\ name>
221.77 +getserverid \-applicationName\ <application\ name>
221.78 Return the server id that corresponds with an application.
221.79 .TP 3
221.80 list
221.81 @@ -105,27 +98,19 @@
221.82 listactive
221.83 List information about all persistent servers that have been launched by the ORBD and are currently running.
221.84 .TP 3
221.85 -locate \-serverid\ <server\ id\ >\ |
221.86 -\-applicationName\ <application\ name>
221.87 -[\-endpointType\ <endpointType>\ ]
221.88 +locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
221.89 Locate the endpoints (ports) of a specific type for all ORBs created by a registered server. If a server is not already running, it is activated. If an endpoint type is not specified, then the plain/non\-protected endpoint associated with each ORB in a server is returned.
221.90 .TP 3
221.91 -locateperorb
221.92 -\-serverid\ <server\ id\ >\ |
221.93 -\-applicationName\ <application\ name>
221.94 -[\-orbid\ <ORB\ name>\ ]
221.95 +locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
221.96 Locate all the endpoints (ports) registered by a specific ORB of registered server. If a server is not already running, then it is activated. If an \f2orbid\fP is not specified, the default value of "" is assigned to the \f2orbid\fP. If any ORBs are created with an \f2orbid\fP of empty string, all ports registered by it are returned.
221.97 .TP 3
221.98 -orblist \-serverid\ <server\ id\ >\ |
221.99 -\-applicationName\ <application\ name>
221.100 +orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
221.101 Lists the ORBId of the ORBs defined on a server. An ORBId is the string name for the ORB created by the server. If the server is not already running, it is activated.
221.102 .TP 3
221.103 -shutdown \-serverid\ <server\ id\ >\ |
221.104 -\-applicationName\ <application\ name>
221.105 +shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
221.106 Shutdown an active server that is registered with ORBD. During execution of this command, the \f2shutdown()\fP method defined in the class specified by either the \f2\-serverid\fP or \f2\-applicationName\fP parameter is also invoked to shutdown the server process appropriately.
221.107 .TP 3
221.108 -startup \-serverid\ <server\ id\ >\ |
221.109 -\-applicationName\ <application\ name>
221.110 +startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
221.111 Startup or activate a server that is registered with ORBD. If the server is not running, this command launches the server. If the server is already running, an error message is returned to the user.
221.112 .TP 3
221.113 help
221.114 @@ -133,11 +118,13 @@
221.115 .TP 3
221.116 quit
221.117 Exit the server tool.
221.118 +.RE
221.119 +
221.120 .LP
221.121 .SH "SEE ALSO"
221.122 .LP
221.123
221.124 .LP
221.125 -orbd
221.126 +orbd(1)
221.127 .LP
221.128
222.1 --- a/src/solaris/doc/sun/man/man1/tnameserv.1 Tue May 12 15:21:55 2009 +0900
222.2 +++ b/src/solaris/doc/sun/man/man1/tnameserv.1 Thu May 14 00:17:25 2009 -0700
222.3 @@ -1,4 +1,3 @@
222.4 -.'" t
222.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
222.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
222.7 ."
222.8 @@ -19,18 +18,18 @@
222.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
222.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
222.11 ." have any questions.
222.12 -." `
222.13 -.TH tnameserv 1 "06 Aug 2006"
222.14 -." Generated by html2man
222.15 +."
222.16 +.TH tnameserv 1 "04 May 2009"
222.17 +." Generated from HTML by html2man (author: Eric Armstrong)
222.18
222.19 .LP
222.20 -.SH NAME
222.21 +.SH "Name"
222.22 Java IDL: Transient Naming Service \- \f2tnameserv\fP
222.23 .LP
222.24
222.25 .LP
222.26 .LP
222.27 -This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its man page or the
222.28 +This document discusses using the Java IDL Transient Naming Service, \f2tnameserv\fP. Java IDL also includes the Object Request Broker Daemon (ORBD). ORBD is a daemon process containing a Bootstrap Service, a Transient Naming Service, a \f3Persistent\fP Naming Service, and a Server Manager. The Java IDL tutorials all use ORBD, however, you can substitute \f2tnameserv\fP for \f2orbd\fP in any of the examples that use a Transient Naming Service. For documentation on the \f2orbd\fP tool, link to its orbd(1) or the
222.29 .na
222.30 \f2Java IDL Naming Service Included with ORBD\fP @
222.31 .fi
222.32 @@ -176,13 +175,12 @@
222.33 .RS 3
222.34
222.35 .LP
222.36 +.RS 3
222.37 .TP 3
222.38 \-Joption
222.39 -Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
222.40 -.na
222.41 -\f2java application launcher\fP @
222.42 -.fi
222.43 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
222.44 +Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
222.45 +.RE
222.46 +
222.47 .LP
222.48 .RE
222.49 .SH "Stopping the Java\ IDL Transient Naming Service"
222.50 @@ -204,15 +202,15 @@
222.51 .fl
222.52 \fP\f4Naming Context\fP\f3
222.53 .fl
222.54 - / \\
222.55 + / \\
222.56 .fl
222.57 - / \\
222.58 + / \\
222.59 .fl
222.60 plans \fP\f4Personal\fP\f3
222.61 .fl
222.62 - / \\
222.63 + / \\
222.64 .fl
222.65 - / \\
222.66 + / \\
222.67 .fl
222.68 calendar schedule\fP
222.69 .fl
223.1 --- a/src/solaris/doc/sun/man/man1/unpack200.1 Tue May 12 15:21:55 2009 +0900
223.2 +++ b/src/solaris/doc/sun/man/man1/unpack200.1 Thu May 14 00:17:25 2009 -0700
223.3 @@ -1,5 +1,4 @@
223.4 -.'" t
223.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
223.6 +." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
223.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
223.8 ."
223.9 ." This code is free software; you can redistribute it and/or modify it
223.10 @@ -19,12 +18,12 @@
223.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
223.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
223.13 ." have any questions.
223.14 -." `
223.15 -.TH unpack200 1 "05 Aug 2006"
223.16 -." Generated by html2roff
223.17 +."
223.18 +.TH unpack200 1 "04 May 2009"
223.19 +." Generated from HTML by html2man (author: Eric Armstrong)
223.20
223.21 .LP
223.22 -.SH NAME
223.23 +.SH "Name"
223.24 unpack200 \- JAR Unpacking tool
223.25 .LP
223.26 .SH "SYNOPSIS"
223.27 @@ -40,12 +39,15 @@
223.28 .RS 3
223.29
223.30 .LP
223.31 +.RS 3
223.32 .TP 3
223.33 input\-file
223.34 Name of the input file, which can be a pack200 gzip file or a pack200 file. The input could also be JAR file produced by pack200(1) with an effort of 0. In this case the contents of the input file will be copied to the output JAR file with the Pack200 marker.
223.35 .TP 3
223.36 JAR\-file
223.37 Name of the output JAR file.
223.38 +.RE
223.39 +
223.40 .LP
223.41 .RE
223.42 .SH "DESCRIPTION"
223.43 @@ -70,6 +72,7 @@
223.44 .SS
223.45 Standard Options
223.46 .LP
223.47 +.RS 3
223.48
223.49 .LP
223.50 .LP
223.51 @@ -82,9 +85,11 @@
223.52 Sets the deflation to be \f2true\fP, \f2false\fP, or \f2keep\fP on all entries within a JAR file. The default mode is \f2keep\fP. If \f2true\fP or \f2false\fP, overrides the default behavior and sets the deflation mode on all entries within the output JAR file.
223.53 .LP
223.54 .RE
223.55 +.RE
223.56 .SS
223.57 Non\-Standard Options
223.58 .LP
223.59 +.RS 3
223.60
223.61 .LP
223.62 .LP
223.63 @@ -127,6 +132,7 @@
223.64 Specifies a log file to output messages.
223.65 .LP
223.66 .RE
223.67 +.RE
223.68 .SH "EXIT STATUS"
223.69 .LP
223.70
223.71 @@ -148,29 +154,29 @@
223.72 .LP
223.73 .RS 3
223.74 .TP 2
223.75 -*
223.76 -pack200 \- JAR Packing Tool
223.77 +o
223.78 +pack200(1)
223.79 .TP 2
223.80 -*
223.81 -\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
223.82 +o
223.83 +.na
223.84 +\f2Java SE Documentation\fP @
223.85 +.fi
223.86 +http://java.sun.com/javase/6/docs/index.html
223.87 .TP 2
223.88 -*
223.89 -Java SE Documentation
223.90 -.TP 2
223.91 -*
223.92 +o
223.93 .na
223.94 \f2Java Deployment Guide \- Pack200\fP @
223.95 .fi
223.96 http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
223.97 .TP 2
223.98 -*
223.99 -\f2jar\fP \- Java Archive Tool
223.100 +o
223.101 +jar(1) \- Java Archive Tool
223.102 .TP 2
223.103 -*
223.104 -.na
223.105 -\f2jarsigner\fP \- JAR Signer tool @
223.106 -.fi
223.107 -http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
223.108 +o
223.109 +jarsigner(1) \- JAR Signer tool
223.110 +.TP 2
223.111 +o
223.112 +\f2attributes(5)\fP man page
223.113 .RE
223.114
223.115 .LP
223.116 @@ -182,6 +188,8 @@
223.117 This command should not be confused with \f2unpack(1)\fP. They are distinctly separate products.
223.118 .LP
223.119 .LP
223.120 -The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
223.121 +The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
223.122 +.LP
223.123 +
223.124 .LP
223.125
224.1 --- a/src/solaris/doc/sun/man/man1/wsgen.1 Tue May 12 15:21:55 2009 +0900
224.2 +++ b/src/solaris/doc/sun/man/man1/wsgen.1 Thu May 14 00:17:25 2009 -0700
224.3 @@ -1,4 +1,3 @@
224.4 -.'" t
224.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
224.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
224.7 ."
224.8 @@ -19,44 +18,71 @@
224.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
224.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
224.11 ." have any questions.
224.12 -." `
224.13 -.TH wsgen 1 "07 Aug 2006"
224.14 -." Generated by html2man
224.15 -
224.16 -.LP
224.17 -.SH NAME
224.18 -wsgen \- JAX\-WS 2.0 Beta
224.19 -.LP
224.20 +."
224.21 +.TH wsgen 1 "04 May 2009"
224.22 +." Generated from HTML by html2man (author: Eric Armstrong)
224.23 +.SH "Name"
224.24 +wsgen \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
224.25 .RS 3
224.26
224.27 .LP
224.28 .LP
224.29 -The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation.
224.30 +\f3Specification Version:\fP 2.1
224.31 +.br
224.32 +\f3Implementation Version:\fP 2.1.1
224.33 +.LP
224.34 +.LP
224.35 +The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint implementation class (SEI) and generates all the required artifacts for web service deployment, and invocation
224.36 .LP
224.37 .RE
224.38 -.SH "SYNOPSIS"
224.39 +.SH "Overview"
224.40 .LP
224.41 +The \f2wsgen\fP tool generates JAX\-WS portable artifacts used in JAX\-WS web services. The tool reads a web service endpoint class and generates all the required artifacts for web service deployment, and invocation. JAXWS 2.1.1 RI also provides a wsgen ant task, see
224.42 +.na
224.43 +\f2Wsgen ant task\fP @
224.44 +.fi
224.45 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.html for details.
224.46 +.LP
224.47 +.SH "Launching wsgen"
224.48 +.RS 3
224.49 +.TP 2
224.50 +o
224.51 +\f3Solaris/Linux\fP
224.52 +.RS 3
224.53 +.TP 2
224.54 +*
224.55 +\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
224.56 +.TP 2
224.57 +*
224.58 +\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
224.59 +.RE
224.60 +.TP 2
224.61 +o
224.62 +\f3Windows\fP
224.63 +.RS 3
224.64 +.TP 2
224.65 +*
224.66 +\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
224.67 +.TP 2
224.68 +*
224.69 +\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
224.70 +.RE
224.71 +.RE
224.72
224.73 .LP
224.74 +.SH "Syntax"
224.75 .nf
224.76 \f3
224.77 .fl
224.78 -wsgen [options] <SEI>
224.79 +wsgen [options] <SEI>\fP
224.80 +.br
224.81 +\f3
224.82 .fl
224.83 \fP
224.84 .fi
224.85 -
224.86 -.LP
224.87 -.SH "OPTIONS"
224.88 -.LP
224.89 .LP
224.90 The following table lists the \f2wsgen\fP options.
224.91 .br
224.92 -
224.93 -.LP
224.94 -.LP
224.95 -Table 1\-1 wsgen Options
224.96 -.LP
224.97 .LP
224.98 .TS
224.99 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
224.100 @@ -206,16 +232,15 @@
224.101 ..
224.102 .ec \
224.103 .eo
224.104 -.am 80
224.105 +.am 81
224.106 .br
224.107 .di i+
224.108 .35
224.109 .ft \n(.f
224.110 .ll \n(34u*1u/3u
224.111 -.if \n(.l<\n(80 .ll \n(80u
224.112 +.if \n(.l<\n(81 .ll \n(81u
224.113 .in 0
224.114 -\f2\-wsdl[:protocol]\fP
224.115 -.br
224.116 +By default \f2wsgen\fP does not generate a WSDL file. This flag is optional and will cause \f2wsgen\fP to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy. The \f2protocol\fP is optional and is used to specify what protocol should be used in the \f2wsdl:binding\fP. Valid protocols include: \f2soap1.1\fP and \f2Xsoap1.2\fP. The default is \f2soap1.1\fP. \f2Xsoap1.2\fP is not standard and can only be used in conjunction with the \f2\-extension\fP option.
224.117 .br
224.118 .di
224.119 .nr i| \n(dn
224.120 @@ -231,8 +256,7 @@
224.121 .ll \n(34u*1u/3u
224.122 .if \n(.l<\n(81 .ll \n(81u
224.123 .in 0
224.124 -By default \f2wsgen\fP does not generate a WSDL file.\ This flag is optional and will cause \f2wsgen\fP to generate a WSDL file and is usually only used so that the developer can look at the WSDL before the endpoint is deploy.\ The \f2protocol\fP is optional and is used to specify what protocol should be used in the \f2wsdl:binding\fP. Valid protocols include:\ \f2soap1.1\fP and \f2Xsoap1.2\fP.\ The default is \f2soap1.1\fP.\ \f2Xsoap1.2\fP is not standard and can only be used in conjunction with the \f2\-extension\fP option.
224.125 -.br
224.126 +Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:service\fP name to be generated in the WSDL. Example, \f2\-servicename "{http://mynamespace/}MyService"\fP
224.127 .br
224.128 .di
224.129 .nr j| \n(dn
224.130 @@ -248,64 +272,48 @@
224.131 .ll \n(34u*1u/3u
224.132 .if \n(.l<\n(81 .ll \n(81u
224.133 .in 0
224.134 -Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:service\fP name to be generated in the WSDL. Example, \f2\-servicename "{http://mynamespace/}MyService"\fP
224.135 +Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:port\fP name to be generated in the WSDL. Example, \f2\-portname "{http://mynamespace/}MyPort"\fP
224.136 +.br
224.137 .br
224.138 .di
224.139 .nr k| \n(dn
224.140 .nr k- \n(dl
224.141 ..
224.142 .ec \
224.143 -.eo
224.144 -.am 81
224.145 -.br
224.146 -.di l+
224.147 -.35
224.148 -.ft \n(.f
224.149 -.ll \n(34u*1u/3u
224.150 -.if \n(.l<\n(81 .ll \n(81u
224.151 -.in 0
224.152 -Used only in conjunction with the \f2\-wsdl\fP option. Used to specify a particular \f2wsdl:port\fP name to be generated in the WSDL. Example, \f2\-portname "{http://mynamespace/}MyPort"\fP
224.153 -.br
224.154 -.br
224.155 -.di
224.156 -.nr l| \n(dn
224.157 -.nr l- \n(dl
224.158 -..
224.159 -.ec \
224.160 .35
224.161 .nf
224.162 .ll \n(34u
224.163 .nr 80 0
224.164 .nr 38 \w\f3Option\fP
224.165 .if \n(80<\n(38 .nr 80 \n(38
224.166 -.nr 38 \w\f2\-classpath <path>\fP
224.167 +.nr 38 \w\f4\-classpath <path>\fP
224.168 .if \n(80<\n(38 .nr 80 \n(38
224.169 -.nr 38 \w\f2\-cp <path>\fP
224.170 +.nr 38 \w\f4\-cp <path>\fP
224.171 .if \n(80<\n(38 .nr 80 \n(38
224.172 -.nr 38 \w\f2\-d <directory>\fP
224.173 +.nr 38 \w\f4\-d <directory>\fP
224.174 .if \n(80<\n(38 .nr 80 \n(38
224.175 -.nr 38 \w\f2\-extension\fP
224.176 +.nr 38 \w\f4\-extension\fP
224.177 .if \n(80<\n(38 .nr 80 \n(38
224.178 -.nr 38 \w\f2\-help\fP
224.179 +.nr 38 \w\f4\-help\fP
224.180 .if \n(80<\n(38 .nr 80 \n(38
224.181 -.nr 38 \w\f2\-keep\fP
224.182 +.nr 38 \w\f4\-keep\fP
224.183 .if \n(80<\n(38 .nr 80 \n(38
224.184 -.nr 38 \w\f2\-r <directory>\fP
224.185 +.nr 38 \w\f4\-r <directory>\fP
224.186 .if \n(80<\n(38 .nr 80 \n(38
224.187 -.nr 38 \w\f2\-s <directory>\fP
224.188 +.nr 38 \w\f4\-s <directory>\fP
224.189 .if \n(80<\n(38 .nr 80 \n(38
224.190 -.nr 38 \w\f2\-verbose\fP
224.191 +.nr 38 \w\f4\-verbose\fP
224.192 .if \n(80<\n(38 .nr 80 \n(38
224.193 -.nr 38 \w\f2\-version\fP
224.194 +.nr 38 \w\f4\-version\fP
224.195 .if \n(80<\n(38 .nr 80 \n(38
224.196 -.nr 38 \w\f2\-servicename <name>\fP
224.197 +.nr 38 \w\f4\-wsdl[:protocol]\fP
224.198 .if \n(80<\n(38 .nr 80 \n(38
224.199 -.nr 38 \w\f2\-portname <name>\fP
224.200 +.nr 38 \w\f4\-servicename <name>\fP
224.201 +.if \n(80<\n(38 .nr 80 \n(38
224.202 +.nr 38 \w\f4\-portname <name>\fP
224.203 .if \n(80<\n(38 .nr 80 \n(38
224.204 .80
224.205 .rm 80
224.206 -.nr 38 \n(i-
224.207 -.if \n(80<\n(38 .nr 80 \n(38
224.208 .nr 81 0
224.209 .nr 38 \w\f3Description\fP
224.210 .if \n(81<\n(38 .nr 81 \n(38
224.211 @@ -331,12 +339,12 @@
224.212 .if \n(81<\n(38 .nr 81 \n(38
224.213 .nr 38 \n(h-
224.214 .if \n(81<\n(38 .nr 81 \n(38
224.215 +.nr 38 \n(i-
224.216 +.if \n(81<\n(38 .nr 81 \n(38
224.217 .nr 38 \n(j-
224.218 .if \n(81<\n(38 .nr 81 \n(38
224.219 .nr 38 \n(k-
224.220 .if \n(81<\n(38 .nr 81 \n(38
224.221 -.nr 38 \n(l-
224.222 -.if \n(81<\n(38 .nr 81 \n(38
224.223 .35
224.224 .nf
224.225 .ll \n(34u
224.226 @@ -347,7 +355,7 @@
224.227 .nr 41 \n(80+(3*\n(38)
224.228 .nr 81 +\n(41
224.229 .nr TW \n(81
224.230 -.if t .if \n(TW>\n(.li .tm Table at line 100 file Input is too wide - \n(TW units
224.231 +.if t .if \n(TW>\n(.li .tm Table at line 140 file Input is too wide - \n(TW units
224.232 .fc
224.233 .nr #T 0-1
224.234 .nr #a 0-1
224.235 @@ -370,7 +378,7 @@
224.236 .ta \n(80u \n(81u
224.237 .nr 31 \n(.f
224.238 .nr 35 1m
224.239 -\&\h'|\n(40u'\f2\-classpath <path>\fP\h'|\n(41u'
224.240 +\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
224.241 .mk ##
224.242 .nr 31 \n(##
224.243 .sp |\n(##u-1v
224.244 @@ -386,7 +394,7 @@
224.245 .ta \n(80u \n(81u
224.246 .nr 31 \n(.f
224.247 .nr 35 1m
224.248 -\&\h'|\n(40u'\f2\-cp <path>\fP\h'|\n(41u'
224.249 +\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
224.250 .mk ##
224.251 .nr 31 \n(##
224.252 .sp |\n(##u-1v
224.253 @@ -402,7 +410,7 @@
224.254 .ta \n(80u \n(81u
224.255 .nr 31 \n(.f
224.256 .nr 35 1m
224.257 -\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
224.258 +\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
224.259 .mk ##
224.260 .nr 31 \n(##
224.261 .sp |\n(##u-1v
224.262 @@ -418,7 +426,7 @@
224.263 .ta \n(80u \n(81u
224.264 .nr 31 \n(.f
224.265 .nr 35 1m
224.266 -\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
224.267 +\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
224.268 .mk ##
224.269 .nr 31 \n(##
224.270 .sp |\n(##u-1v
224.271 @@ -432,17 +440,17 @@
224.272 .ta \n(80u \n(81u
224.273 .nr 31 \n(.f
224.274 .nr 35 1m
224.275 -\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
224.276 +\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'Display help
224.277 .ta \n(80u \n(81u
224.278 .nr 31 \n(.f
224.279 .nr 35 1m
224.280 -\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
224.281 +\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'Keep generated files
224.282 .ne \n(e|u+\n(.Vu
224.283 .if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
224.284 .ta \n(80u \n(81u
224.285 .nr 31 \n(.f
224.286 .nr 35 1m
224.287 -\&\h'|\n(40u'\f2\-r <directory>\fP\h'|\n(41u'
224.288 +\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
224.289 .mk ##
224.290 .nr 31 \n(##
224.291 .sp |\n(##u-1v
224.292 @@ -458,7 +466,7 @@
224.293 .ta \n(80u \n(81u
224.294 .nr 31 \n(.f
224.295 .nr 35 1m
224.296 -\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
224.297 +\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
224.298 .mk ##
224.299 .nr 31 \n(##
224.300 .sp |\n(##u-1v
224.301 @@ -474,7 +482,7 @@
224.302 .ta \n(80u \n(81u
224.303 .nr 31 \n(.f
224.304 .nr 35 1m
224.305 -\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
224.306 +\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
224.307 .mk ##
224.308 .nr 31 \n(##
224.309 .sp |\n(##u-1v
224.310 @@ -490,7 +498,7 @@
224.311 .ta \n(80u \n(81u
224.312 .nr 31 \n(.f
224.313 .nr 35 1m
224.314 -\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
224.315 +\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
224.316 .mk ##
224.317 .nr 31 \n(##
224.318 .sp |\n(##u-1v
224.319 @@ -502,22 +510,29 @@
224.320 .if \n(32>\n(31 .nr 31 \n(32
224.321 .sp |\n(31u
224.322 .ne \n(i|u+\n(.Vu
224.323 -.ne \n(j|u+\n(.Vu
224.324 .if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
224.325 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
224.326 .ta \n(80u \n(81u
224.327 .nr 31 \n(.f
224.328 .nr 35 1m
224.329 -\&\h'|\n(40u'\h'|\n(41u'
224.330 +\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
224.331 .mk ##
224.332 .nr 31 \n(##
224.333 .sp |\n(##u-1v
224.334 -.nr 37 \n(40u
224.335 +.nr 37 \n(41u
224.336 .in +\n(37u
224.337 .i+
224.338 .in -\n(37u
224.339 .mk 32
224.340 .if \n(32>\n(31 .nr 31 \n(32
224.341 +.sp |\n(31u
224.342 +.ne \n(j|u+\n(.Vu
224.343 +.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
224.344 +.ta \n(80u \n(81u
224.345 +.nr 31 \n(.f
224.346 +.nr 35 1m
224.347 +\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
224.348 +.mk ##
224.349 +.nr 31 \n(##
224.350 .sp |\n(##u-1v
224.351 .nr 37 \n(41u
224.352 .in +\n(37u
224.353 @@ -531,7 +546,7 @@
224.354 .ta \n(80u \n(81u
224.355 .nr 31 \n(.f
224.356 .nr 35 1m
224.357 -\&\h'|\n(40u'\f2\-servicename <name>\fP\h'|\n(41u'
224.358 +\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
224.359 .mk ##
224.360 .nr 31 \n(##
224.361 .sp |\n(##u-1v
224.362 @@ -542,22 +557,6 @@
224.363 .mk 32
224.364 .if \n(32>\n(31 .nr 31 \n(32
224.365 .sp |\n(31u
224.366 -.ne \n(l|u+\n(.Vu
224.367 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
224.368 -.ta \n(80u \n(81u
224.369 -.nr 31 \n(.f
224.370 -.nr 35 1m
224.371 -\&\h'|\n(40u'\f2\-portname <name>\fP\h'|\n(41u'
224.372 -.mk ##
224.373 -.nr 31 \n(##
224.374 -.sp |\n(##u-1v
224.375 -.nr 37 \n(41u
224.376 -.in +\n(37u
224.377 -.l+
224.378 -.in -\n(37u
224.379 -.mk 32
224.380 -.if \n(32>\n(31 .nr 31 \n(32
224.381 -.sp |\n(31u
224.382 .fc
224.383 .nr T. 1
224.384 .T# 1
224.385 @@ -573,688 +572,34 @@
224.386 .rm i+
224.387 .rm j+
224.388 .rm k+
224.389 -.rm l+
224.390 .TE
224.391 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
224.392 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-53
224.393
224.394 .LP
224.395 -.SS
224.396 -Ant task
224.397 -.LP
224.398 -.LP
224.399 -An Ant task for the \f2wsgen\fP tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
224.400 -.LP
224.401 +.SH "Example"
224.402 .nf
224.403 \f3
224.404 .fl
224.405 -
224.406 +\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
224.407 .fl
224.408 - <wsgen
224.409 -.fl
224.410 - sei="..."
224.411 -.fl
224.412 - destdir="directory for generated class files"
224.413 -.fl
224.414 - classpath="classpath" | cp="classpath"
224.415 -.fl
224.416 - resourcedestdir="directory for generated resource files such as WSDLs"
224.417 -.fl
224.418 - sourcedestdir="directory for generated source files"
224.419 -.fl
224.420 - keep="true|false"
224.421 -.fl
224.422 - verbose="true|false"
224.423 -.fl
224.424 - genwsdl="true|false"
224.425 -.fl
224.426 - protocol="soap1.1|Xsoap1.2"
224.427 -.fl
224.428 - servicename="..."
224.429 -.fl
224.430 - portname="...">
224.431 -.fl
224.432 - extension="true|false"
224.433 -.fl
224.434 - <classpath refid="..."/>
224.435 -.fl
224.436 - </wsgen>
224.437 -.fl
224.438 -\fP
224.439 .fi
224.440 -
224.441 .LP
224.442 -.LP
224.443 -.TS
224.444 -.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
224.445 -.de 35
224.446 -.ps \n(.s
224.447 -.vs \n(.vu
224.448 -.in \n(.iu
224.449 -.if \n(.u .fi
224.450 -.if \n(.j .ad
224.451 -.if \n(.j=0 .na
224.452 -..
224.453 -.nf
224.454 -.nr #~ 0
224.455 -.if n .nr #~ 0.6n
224.456 -.ds #d .d
224.457 -.if \(ts\n(.z\(ts\(ts .ds #d nl
224.458 -.fc
224.459 -.nr 33 \n(.s
224.460 -.rm 80 81 82
224.461 -.nr 34 \n(.lu
224.462 -.eo
224.463 -.am 81
224.464 -.br
224.465 -.di a+
224.466 -.35
224.467 -.ft \n(.f
224.468 -.ll \n(34u*1u/4u
224.469 -.if \n(.l<\n(81 .ll \n(81u
224.470 -.in 0
224.471 -Name of the service endpoint implementation class
224.472 -.br
224.473 -.di
224.474 -.nr a| \n(dn
224.475 -.nr a- \n(dl
224.476 -..
224.477 -.ec \
224.478 -.eo
224.479 -.am 81
224.480 -.br
224.481 -.di b+
224.482 -.35
224.483 -.ft \n(.f
224.484 -.ll \n(34u*1u/4u
224.485 -.if \n(.l<\n(81 .ll \n(81u
224.486 -.in 0
224.487 -Specify where to place output generated classes
224.488 -.br
224.489 -.di
224.490 -.nr b| \n(dn
224.491 -.nr b- \n(dl
224.492 -..
224.493 -.ec \
224.494 -.eo
224.495 -.am 81
224.496 -.br
224.497 -.di c+
224.498 -.35
224.499 -.ft \n(.f
224.500 -.ll \n(34u*1u/4u
224.501 -.if \n(.l<\n(81 .ll \n(81u
224.502 -.in 0
224.503 -Specify where to find input class files
224.504 -.br
224.505 -.di
224.506 -.nr c| \n(dn
224.507 -.nr c- \n(dl
224.508 -..
224.509 -.ec \
224.510 -.eo
224.511 -.am 81
224.512 -.br
224.513 -.di d+
224.514 -.35
224.515 -.ft \n(.f
224.516 -.ll \n(34u*1u/4u
224.517 -.if \n(.l<\n(81 .ll \n(81u
224.518 -.in 0
224.519 -Used only in conjunction with the \-wsdl option. Specify where to place generated resource files such as WSDLs
224.520 -.br
224.521 -.di
224.522 -.nr d| \n(dn
224.523 -.nr d- \n(dl
224.524 -..
224.525 -.ec \
224.526 -.eo
224.527 -.am 81
224.528 -.br
224.529 -.di e+
224.530 -.35
224.531 -.ft \n(.f
224.532 -.ll \n(34u*1u/4u
224.533 -.if \n(.l<\n(81 .ll \n(81u
224.534 -.in 0
224.535 -Specify where to place generated source files
224.536 -.br
224.537 -.di
224.538 -.nr e| \n(dn
224.539 -.nr e- \n(dl
224.540 -..
224.541 -.ec \
224.542 -.eo
224.543 -.am 81
224.544 -.br
224.545 -.di f+
224.546 -.35
224.547 -.ft \n(.f
224.548 -.ll \n(34u*1u/4u
224.549 -.if \n(.l<\n(81 .ll \n(81u
224.550 -.in 0
224.551 -Output messages about what the compiler is doing
224.552 -.br
224.553 -.di
224.554 -.nr f| \n(dn
224.555 -.nr f- \n(dl
224.556 -..
224.557 -.ec \
224.558 -.eo
224.559 -.am 81
224.560 -.br
224.561 -.di g+
224.562 -.35
224.563 -.ft \n(.f
224.564 -.ll \n(34u*1u/4u
224.565 -.if \n(.l<\n(81 .ll \n(81u
224.566 -.in 0
224.567 -Specify that a WSDL file should be generated
224.568 -.br
224.569 -.di
224.570 -.nr g| \n(dn
224.571 -.nr g- \n(dl
224.572 -..
224.573 -.ec \
224.574 -.eo
224.575 -.am 81
224.576 -.br
224.577 -.di h+
224.578 -.35
224.579 -.ft \n(.f
224.580 -.ll \n(34u*1u/4u
224.581 -.if \n(.l<\n(81 .ll \n(81u
224.582 -.in 0
224.583 -Used in conjunction with \f2genwsdl\fP to specify the protocol to use in the \f2wsdl:binding\fP.\ Value values are \f2"soap1.1"\fP or \f2"Xsoap1.2"\fP, default is \f2"soap1.1".\fP\f2"Xsoap1.2"\fP is not standard and can only be used in conjunction with the \-extensions option
224.584 -.br
224.585 -.br
224.586 -.di
224.587 -.nr h| \n(dn
224.588 -.nr h- \n(dl
224.589 -..
224.590 -.ec \
224.591 -.eo
224.592 -.am 82
224.593 -.br
224.594 -.di i+
224.595 -.35
224.596 -.ft \n(.f
224.597 -.ll \n(34u*1u/4u
224.598 -.if \n(.l<\n(82 .ll \n(82u
224.599 -.in 0
224.600 -\f2\-wsdl:soap11\fP
224.601 -.br
224.602 -.br
224.603 -.di
224.604 -.nr i| \n(dn
224.605 -.nr i- \n(dl
224.606 -..
224.607 -.ec \
224.608 -.eo
224.609 -.am 81
224.610 -.br
224.611 -.di j+
224.612 -.35
224.613 -.ft \n(.f
224.614 -.ll \n(34u*1u/4u
224.615 -.if \n(.l<\n(81 .ll \n(81u
224.616 -.in 0
224.617 -Used in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:service\fP name for the generated WSDL.Example, \f2servicename="{http://mynamespace/}MyService"\fP
224.618 -.br
224.619 -.br
224.620 -.di
224.621 -.nr j| \n(dn
224.622 -.nr j- \n(dl
224.623 -..
224.624 -.ec \
224.625 -.eo
224.626 -.am 81
224.627 -.br
224.628 -.di k+
224.629 -.35
224.630 -.ft \n(.f
224.631 -.ll \n(34u*1u/4u
224.632 -.if \n(.l<\n(81 .ll \n(81u
224.633 -.in 0
224.634 -Used in conjunction with the genwsdl option. Used to specify a particular \f2wsdl:portmame\fP name for the generated WSDL. Example, \f2portname="{http://mynamespace/}MyPort"\fP
224.635 -.br
224.636 -.br
224.637 -.di
224.638 -.nr k| \n(dn
224.639 -.nr k- \n(dl
224.640 -..
224.641 -.ec \
224.642 -.eo
224.643 -.am 81
224.644 -.br
224.645 -.di l+
224.646 -.35
224.647 -.ft \n(.f
224.648 -.ll \n(34u*1u/4u
224.649 -.if \n(.l<\n(81 .ll \n(81u
224.650 -.in 0
224.651 -allow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
224.652 -.br
224.653 -.di
224.654 -.nr l| \n(dn
224.655 -.nr l- \n(dl
224.656 -..
224.657 -.ec \
224.658 -.35
224.659 -.nf
224.660 -.ll \n(34u
224.661 -.nr 80 0
224.662 -.nr 38 \w\f3Attribute\fP
224.663 -.if \n(80<\n(38 .nr 80 \n(38
224.664 -.nr 38 \w\f2sei\fP
224.665 -.if \n(80<\n(38 .nr 80 \n(38
224.666 -.nr 38 \w\f2destdir\fP
224.667 -.if \n(80<\n(38 .nr 80 \n(38
224.668 -.nr 38 \w\f2classpath\fP
224.669 -.if \n(80<\n(38 .nr 80 \n(38
224.670 -.nr 38 \w\f2cp\fP
224.671 -.if \n(80<\n(38 .nr 80 \n(38
224.672 -.nr 38 \w\f2resourcedestdir\fP
224.673 -.if \n(80<\n(38 .nr 80 \n(38
224.674 -.nr 38 \w\f2sourcedestdir\fP
224.675 -.if \n(80<\n(38 .nr 80 \n(38
224.676 -.nr 38 \w\f2keep\fP
224.677 -.if \n(80<\n(38 .nr 80 \n(38
224.678 -.nr 38 \w\f2verbose\fP
224.679 -.if \n(80<\n(38 .nr 80 \n(38
224.680 -.nr 38 \w\f2genwsdl\fP
224.681 -.if \n(80<\n(38 .nr 80 \n(38
224.682 -.nr 38 \w\f2protocol\fP
224.683 -.if \n(80<\n(38 .nr 80 \n(38
224.684 -.nr 38 \w\f2servicename\fP
224.685 -.if \n(80<\n(38 .nr 80 \n(38
224.686 -.nr 38 \w\f2portname\fP
224.687 -.if \n(80<\n(38 .nr 80 \n(38
224.688 -.nr 38 \w\f2extension\fP
224.689 -.if \n(80<\n(38 .nr 80 \n(38
224.690 -.80
224.691 -.rm 80
224.692 -.nr 81 0
224.693 -.nr 38 \w\f3Description\fP
224.694 -.if \n(81<\n(38 .nr 81 \n(38
224.695 -.nr 38 \wSame as \f2\-classpath\fP
224.696 -.if \n(81<\n(38 .nr 81 \n(38
224.697 -.nr 38 \wKeep generated files
224.698 -.if \n(81<\n(38 .nr 81 \n(38
224.699 -.81
224.700 -.rm 81
224.701 -.nr 38 \n(a-
224.702 -.if \n(81<\n(38 .nr 81 \n(38
224.703 -.nr 38 \n(b-
224.704 -.if \n(81<\n(38 .nr 81 \n(38
224.705 -.nr 38 \n(c-
224.706 -.if \n(81<\n(38 .nr 81 \n(38
224.707 -.nr 38 \n(d-
224.708 -.if \n(81<\n(38 .nr 81 \n(38
224.709 -.nr 38 \n(e-
224.710 -.if \n(81<\n(38 .nr 81 \n(38
224.711 -.nr 38 \n(f-
224.712 -.if \n(81<\n(38 .nr 81 \n(38
224.713 -.nr 38 \n(g-
224.714 -.if \n(81<\n(38 .nr 81 \n(38
224.715 -.nr 38 \n(h-
224.716 -.if \n(81<\n(38 .nr 81 \n(38
224.717 -.nr 38 \n(j-
224.718 -.if \n(81<\n(38 .nr 81 \n(38
224.719 -.nr 38 \n(k-
224.720 -.if \n(81<\n(38 .nr 81 \n(38
224.721 -.nr 38 \n(l-
224.722 -.if \n(81<\n(38 .nr 81 \n(38
224.723 -.nr 82 0
224.724 -.nr 38 \w\f3Command line\fP
224.725 -.if \n(82<\n(38 .nr 82 \n(38
224.726 -.nr 38 \wSEI
224.727 -.if \n(82<\n(38 .nr 82 \n(38
224.728 -.nr 38 \w\f2\-d\fP
224.729 -.if \n(82<\n(38 .nr 82 \n(38
224.730 -.nr 38 \w\f2\-classpath\fP
224.731 -.if \n(82<\n(38 .nr 82 \n(38
224.732 -.nr 38 \w\f2\-cp\fP
224.733 -.if \n(82<\n(38 .nr 82 \n(38
224.734 -.nr 38 \w\f2\-r\fP
224.735 -.if \n(82<\n(38 .nr 82 \n(38
224.736 -.nr 38 \w\f2\-s\fP
224.737 -.if \n(82<\n(38 .nr 82 \n(38
224.738 -.nr 38 \w\f2\-keep\fP
224.739 -.if \n(82<\n(38 .nr 82 \n(38
224.740 -.nr 38 \w\f2\-verbose\fP
224.741 -.if \n(82<\n(38 .nr 82 \n(38
224.742 -.nr 38 \w\f2\-wsdl\fP
224.743 -.if \n(82<\n(38 .nr 82 \n(38
224.744 -.nr 38 \w\f2\-servicename\fP
224.745 -.if \n(82<\n(38 .nr 82 \n(38
224.746 -.nr 38 \w\f2\-servicename\fP
224.747 -.if \n(82<\n(38 .nr 82 \n(38
224.748 -.nr 38 \w\f2\-extension\fP
224.749 -.if \n(82<\n(38 .nr 82 \n(38
224.750 -.82
224.751 -.rm 82
224.752 -.nr 38 \n(i-
224.753 -.if \n(82<\n(38 .nr 82 \n(38
224.754 -.35
224.755 -.nf
224.756 -.ll \n(34u
224.757 -.nr 38 1n
224.758 -.nr 79 0
224.759 -.nr 40 \n(79+(0*\n(38)
224.760 -.nr 80 +\n(40
224.761 -.nr 41 \n(80+(3*\n(38)
224.762 -.nr 81 +\n(41
224.763 -.nr 42 \n(81+(3*\n(38)
224.764 -.nr 82 +\n(42
224.765 -.nr TW \n(82
224.766 -.if t .if \n(TW>\n(.li .tm Table at line 217 file Input is too wide - \n(TW units
224.767 -.fc
224.768 -.nr #T 0-1
224.769 -.nr #a 0-1
224.770 -.eo
224.771 -.de T#
224.772 -.ds #d .d
224.773 -.if \(ts\n(.z\(ts\(ts .ds #d nl
224.774 -.mk ##
224.775 -.nr ## -1v
224.776 -.ls 1
224.777 -.ls
224.778 -..
224.779 -.ec
224.780 -.ta \n(80u \n(81u \n(82u
224.781 -.nr 31 \n(.f
224.782 -.nr 35 1m
224.783 -\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
224.784 -.ne \n(a|u+\n(.Vu
224.785 -.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
224.786 -.ta \n(80u \n(81u \n(82u
224.787 -.nr 31 \n(.f
224.788 -.nr 35 1m
224.789 -\&\h'|\n(40u'\f2sei\fP\h'|\n(41u'\h'|\n(42u'SEI
224.790 -.mk ##
224.791 -.nr 31 \n(##
224.792 -.sp |\n(##u-1v
224.793 -.nr 37 \n(41u
224.794 -.in +\n(37u
224.795 -.a+
224.796 -.in -\n(37u
224.797 -.mk 32
224.798 -.if \n(32>\n(31 .nr 31 \n(32
224.799 -.sp |\n(31u
224.800 -.ne \n(b|u+\n(.Vu
224.801 -.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
224.802 -.ta \n(80u \n(81u \n(82u
224.803 -.nr 31 \n(.f
224.804 -.nr 35 1m
224.805 -\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
224.806 -.mk ##
224.807 -.nr 31 \n(##
224.808 -.sp |\n(##u-1v
224.809 -.nr 37 \n(41u
224.810 -.in +\n(37u
224.811 -.b+
224.812 -.in -\n(37u
224.813 -.mk 32
224.814 -.if \n(32>\n(31 .nr 31 \n(32
224.815 -.sp |\n(31u
224.816 -.ne \n(c|u+\n(.Vu
224.817 -.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
224.818 -.ta \n(80u \n(81u \n(82u
224.819 -.nr 31 \n(.f
224.820 -.nr 35 1m
224.821 -\&\h'|\n(40u'\f2classpath\fP\h'|\n(41u'\h'|\n(42u'\f2\-classpath\fP
224.822 -.mk ##
224.823 -.nr 31 \n(##
224.824 -.sp |\n(##u-1v
224.825 -.nr 37 \n(41u
224.826 -.in +\n(37u
224.827 -.c+
224.828 -.in -\n(37u
224.829 -.mk 32
224.830 -.if \n(32>\n(31 .nr 31 \n(32
224.831 -.sp |\n(31u
224.832 -.ta \n(80u \n(81u \n(82u
224.833 -.nr 31 \n(.f
224.834 -.nr 35 1m
224.835 -\&\h'|\n(40u'\f2cp\fP\h'|\n(41u'Same as \f2\-classpath\fP\h'|\n(42u'\f2\-cp\fP
224.836 -.ne \n(d|u+\n(.Vu
224.837 -.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
224.838 -.ta \n(80u \n(81u \n(82u
224.839 -.nr 31 \n(.f
224.840 -.nr 35 1m
224.841 -\&\h'|\n(40u'\f2resourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-r\fP
224.842 -.mk ##
224.843 -.nr 31 \n(##
224.844 -.sp |\n(##u-1v
224.845 -.nr 37 \n(41u
224.846 -.in +\n(37u
224.847 -.d+
224.848 -.in -\n(37u
224.849 -.mk 32
224.850 -.if \n(32>\n(31 .nr 31 \n(32
224.851 -.sp |\n(31u
224.852 -.ne \n(e|u+\n(.Vu
224.853 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
224.854 -.ta \n(80u \n(81u \n(82u
224.855 -.nr 31 \n(.f
224.856 -.nr 35 1m
224.857 -\&\h'|\n(40u'\f2sourcedestdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
224.858 -.mk ##
224.859 -.nr 31 \n(##
224.860 -.sp |\n(##u-1v
224.861 -.nr 37 \n(41u
224.862 -.in +\n(37u
224.863 -.e+
224.864 -.in -\n(37u
224.865 -.mk 32
224.866 -.if \n(32>\n(31 .nr 31 \n(32
224.867 -.sp |\n(31u
224.868 -.ta \n(80u \n(81u \n(82u
224.869 -.nr 31 \n(.f
224.870 -.nr 35 1m
224.871 -\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'Keep generated files\h'|\n(42u'\f2\-keep\fP
224.872 -.ne \n(f|u+\n(.Vu
224.873 -.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
224.874 -.ta \n(80u \n(81u \n(82u
224.875 -.nr 31 \n(.f
224.876 -.nr 35 1m
224.877 -\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
224.878 -.mk ##
224.879 -.nr 31 \n(##
224.880 -.sp |\n(##u-1v
224.881 -.nr 37 \n(41u
224.882 -.in +\n(37u
224.883 -.f+
224.884 -.in -\n(37u
224.885 -.mk 32
224.886 -.if \n(32>\n(31 .nr 31 \n(32
224.887 -.sp |\n(31u
224.888 -.ta \n(80u \n(81u \n(82u
224.889 -.nr 31 \n(.f
224.890 -.nr 35 1m
224.891 -\&\h'|\n(40u'\f2genwsdl\fP\h'|\n(41u'\h'|\n(42u'
224.892 -.br
224.893 -.ne \n(g|u+\n(.Vu
224.894 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
224.895 -.ta \n(80u \n(81u \n(82u
224.896 -.nr 31 \n(.f
224.897 -.nr 35 1m
224.898 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-wsdl\fP
224.899 -.mk ##
224.900 -.nr 31 \n(##
224.901 -.sp |\n(##u-1v
224.902 -.nr 37 \n(41u
224.903 -.in +\n(37u
224.904 -.g+
224.905 -.in -\n(37u
224.906 -.mk 32
224.907 -.if \n(32>\n(31 .nr 31 \n(32
224.908 -.sp |\n(31u
224.909 -.ta \n(80u \n(81u \n(82u
224.910 -.nr 31 \n(.f
224.911 -.nr 35 1m
224.912 -\&\h'|\n(40u'\f2protocol\fP\h'|\n(41u'\h'|\n(42u'
224.913 -.br
224.914 -.ne \n(h|u+\n(.Vu
224.915 -.ne \n(i|u+\n(.Vu
224.916 -.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
224.917 -.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
224.918 -.ta \n(80u \n(81u \n(82u
224.919 -.nr 31 \n(.f
224.920 -.nr 35 1m
224.921 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
224.922 -.mk ##
224.923 -.nr 31 \n(##
224.924 -.sp |\n(##u-1v
224.925 -.nr 37 \n(41u
224.926 -.in +\n(37u
224.927 -.h+
224.928 -.in -\n(37u
224.929 -.mk 32
224.930 -.if \n(32>\n(31 .nr 31 \n(32
224.931 -.sp |\n(##u-1v
224.932 -.nr 37 \n(42u
224.933 -.in +\n(37u
224.934 -.i+
224.935 -.in -\n(37u
224.936 -.mk 32
224.937 -.if \n(32>\n(31 .nr 31 \n(32
224.938 -.sp |\n(31u
224.939 -.ta \n(80u \n(81u \n(82u
224.940 -.nr 31 \n(.f
224.941 -.nr 35 1m
224.942 -\&\h'|\n(40u'\f2servicename\fP\h'|\n(41u'\h'|\n(42u'
224.943 -.br
224.944 -.ne \n(j|u+\n(.Vu
224.945 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
224.946 -.ta \n(80u \n(81u \n(82u
224.947 -.nr 31 \n(.f
224.948 -.nr 35 1m
224.949 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
224.950 -.mk ##
224.951 -.nr 31 \n(##
224.952 -.sp |\n(##u-1v
224.953 -.nr 37 \n(41u
224.954 -.in +\n(37u
224.955 -.j+
224.956 -.in -\n(37u
224.957 -.mk 32
224.958 -.if \n(32>\n(31 .nr 31 \n(32
224.959 -.sp |\n(31u
224.960 -.ta \n(80u \n(81u \n(82u
224.961 -.nr 31 \n(.f
224.962 -.nr 35 1m
224.963 -\&\h'|\n(40u'\f2portname\fP\h'|\n(41u'\h'|\n(42u'
224.964 -.br
224.965 -.ne \n(k|u+\n(.Vu
224.966 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
224.967 -.ta \n(80u \n(81u \n(82u
224.968 -.nr 31 \n(.f
224.969 -.nr 35 1m
224.970 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-servicename\fP
224.971 -.mk ##
224.972 -.nr 31 \n(##
224.973 -.sp |\n(##u-1v
224.974 -.nr 37 \n(41u
224.975 -.in +\n(37u
224.976 -.k+
224.977 -.in -\n(37u
224.978 -.mk 32
224.979 -.if \n(32>\n(31 .nr 31 \n(32
224.980 -.sp |\n(31u
224.981 -.ta \n(80u \n(81u \n(82u
224.982 -.nr 31 \n(.f
224.983 -.nr 35 1m
224.984 -\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
224.985 -.br
224.986 -.ne \n(l|u+\n(.Vu
224.987 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
224.988 -.ta \n(80u \n(81u \n(82u
224.989 -.nr 31 \n(.f
224.990 -.nr 35 1m
224.991 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
224.992 -.mk ##
224.993 -.nr 31 \n(##
224.994 -.sp |\n(##u-1v
224.995 -.nr 37 \n(41u
224.996 -.in +\n(37u
224.997 -.l+
224.998 -.in -\n(37u
224.999 -.mk 32
224.1000 -.if \n(32>\n(31 .nr 31 \n(32
224.1001 -.sp |\n(31u
224.1002 -.fc
224.1003 -.nr T. 1
224.1004 -.T# 1
224.1005 -.35
224.1006 -.rm a+
224.1007 -.rm b+
224.1008 -.rm c+
224.1009 -.rm d+
224.1010 -.rm e+
224.1011 -.rm f+
224.1012 -.rm g+
224.1013 -.rm h+
224.1014 -.rm i+
224.1015 -.rm j+
224.1016 -.rm k+
224.1017 -.rm l+
224.1018 -.TE
224.1019 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
224.1020 -
224.1021 -.LP
224.1022 -.LP
224.1023 -The \f2classpath\fP attribute is a
224.1024 -.na
224.1025 -\f2path\-like structure\fP @
224.1026 -.fi
224.1027 -http://ant.apache.org/manual/using.html#path and can also be set via nested \f2<classpath>\fP elements. Before this task can be used, a \f2<taskdef>\fP element needs to be added to the project as given below:
224.1028 -.LP
224.1029 +This will generate the wrapper classes needed for StockService annotated with @WebService annotation inside \f3stock\fPdirectory.
224.1030 .nf
224.1031 \f3
224.1032 .fl
224.1033 - <taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">\fP
224.1034 -.br
224.1035 -\f3
224.1036 +\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
224.1037 .fl
224.1038 - <classpath path="jaxws.classpath"/>\fP
224.1039 -.br
224.1040 -\f3
224.1041 -.fl
224.1042 - </taskdef>
224.1043 -.fl
224.1044 -\fP
224.1045 .fi
224.1046 -
224.1047 .LP
224.1048 -.LP
224.1049 -where \f2jaxws.classpath\fP is a reference to a
224.1050 -.na
224.1051 -\f2path\-like structure\fP @
224.1052 -.fi
224.1053 -http://ant.apache.org/manual/using.html#path, defined elsewhere in the build environment, and contains the list of classes required by the JAX\-WS tools.
224.1054 -.LP
224.1055 -.SH "Example"
224.1056 -.LP
224.1057 -
224.1058 -.LP
224.1059 +This will generate a SOAP 1.1 WSDL and schema for your Java class stock.StockService annotated with @WebService annotation.
224.1060 .nf
224.1061 \f3
224.1062 .fl
224.1063 -<wsgen
224.1064 +\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
224.1065 .fl
224.1066 - resourcedestdir="${wsdl.dir}"
224.1067 -.fl
224.1068 - sei="fromjava.server.AddNumbersImpl">
224.1069 -.fl
224.1070 - <classpath refid="compile.classpath"/>
224.1071 -.fl
224.1072 -</wsgen>
224.1073 -.fl
224.1074 -\fP
224.1075 .fi
224.1076 -
224.1077 .LP
224.1078 -
224.1079 +Will generate a SOAP 1.2 WSDL.
224.1080 .LP
224.1081 -
224.1082 +Note that you do not have to generate WSDL at the development time as JAXWS runtime will automatically generate a WSDL for you when you deploy your service.
225.1 --- a/src/solaris/doc/sun/man/man1/wsimport.1 Tue May 12 15:21:55 2009 +0900
225.2 +++ b/src/solaris/doc/sun/man/man1/wsimport.1 Thu May 14 00:17:25 2009 -0700
225.3 @@ -1,4 +1,3 @@
225.4 -.'" t
225.5 ." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
225.6 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
225.7 ."
225.8 @@ -19,32 +18,19 @@
225.9 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
225.10 ." CA 95054 USA or visit www.sun.com if you need additional information or
225.11 ." have any questions.
225.12 -." `
225.13 -.TH wsimport 1 "07 Aug 2006"
225.14 -." Generated by html2man
225.15 -
225.16 +."
225.17 +.TH wsimport 1 "04 May 2009"
225.18 +." Generated from HTML by html2man (author: Eric Armstrong)
225.19 +.SH "Name"
225.20 +wsimport \- Java(TM) API for XML Web Services (JAX\-WS) 2.0
225.21 .LP
225.22 -.SH NAME
225.23 -wsimport \- JAX\-WS 2.0 Beta
225.24 -.LP
225.25 -.SH "SYNOPSIS"
225.26 -.LP
225.27 -
225.28 -.LP
225.29 -.nf
225.30 -\f3
225.31 -.fl
225.32 -wsimport [options] <wsdl>
225.33 -.fl
225.34 -\fP
225.35 -.fi
225.36 -
225.37 -.LP
225.38 -.SH "DESCRIPTION"
225.39 -.LP
225.40 +\f3Specification Version:\fP 2.1
225.41 +.br
225.42 +\f3Implementation Version:\fP 2.1.1
225.43 +.br
225.44 +.SH "Overview"
225.45 .LP
225.46 The \f2wsimport\fP tool generates JAX\-WS portable artifacts, such as:
225.47 -.LP
225.48 .RS 3
225.49 .TP 2
225.50 o
225.51 @@ -62,28 +48,46 @@
225.52 o
225.53 JAXB generated value types (mapped java classes from schema types)
225.54 .RE
225.55 -
225.56 .LP
225.57 -.LP
225.58 -These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed.
225.59 +These artifacts can be packaged in a WAR file with the WSDL and schema documents along with the endpoint implementation to be deployed. also provides wsimport ant task, see
225.60 +.na
225.61 +\f2Wsimport ant task\fP @
225.62 +.fi
225.63 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsimportant.html.
225.64 .br
225.65
225.66 .LP
225.67 -.LP
225.68 -wsimport tool can be launched using the command line script wsimport.sh (Unix) or wsimport.bat(windows). There is also and ant task to import and compile the wsdl, see the details below.
225.69 -.br
225.70 +.SH "Launching wsimport"
225.71 +.RS 3
225.72 +.TP 2
225.73 +o
225.74 +\f3Solaris/Linux\fP
225.75 +.RS 3
225.76 +.TP 2
225.77 +*
225.78 +\f2/bin/wsimport.sh \-help\fP
225.79 +.RE
225.80 +.TP 2
225.81 +o
225.82 +\f3Windows\fP
225.83 +.RS 3
225.84 +.TP 2
225.85 +*
225.86 +\f2\\bin\\wsimport.bat \-help\fP
225.87 +.RE
225.88 +.RE
225.89
225.90 .LP
225.91 -.SH "OPTIONS"
225.92 -.LP
225.93 +.SH "Syntax"
225.94 +.nf
225.95 +\f3
225.96 +.fl
225.97 +wsimport [options] <wsdl>
225.98 +.fl
225.99 +\fP
225.100 +.fi
225.101 .LP
225.102 The following table lists the \f2wsimport\fP options.
225.103 -.br
225.104 -
225.105 -.LP
225.106 -.LP
225.107 -Table 1\-1 wsimport Options
225.108 -.LP
225.109 .LP
225.110 .TS
225.111 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
225.112 @@ -145,7 +149,7 @@
225.113 .ll \n(34u*1u/3u
225.114 .if \n(.l<\n(81 .ll \n(81u
225.115 .in 0
225.116 -Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the XML Entity and URI Resolvers document or see \f3wsimport_catalog\fP sample.
225.117 +Pass this option to JAXB schema compiler
225.118 .br
225.119 .di
225.120 .nr c| \n(dn
225.121 @@ -161,7 +165,11 @@
225.122 .ll \n(34u*1u/3u
225.123 .if \n(.l<\n(81 .ll \n(81u
225.124 .in 0
225.125 -allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
225.126 +Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Please read the documentation of
225.127 +.na
225.128 +\f2catalog\fP @
225.129 +.fi
225.130 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/catalog\-support.html and see \f3catalog\fP sample.
225.131 .br
225.132 .di
225.133 .nr d| \n(dn
225.134 @@ -169,15 +177,15 @@
225.135 ..
225.136 .ec \
225.137 .eo
225.138 -.am 80
225.139 +.am 81
225.140 .br
225.141 .di e+
225.142 .35
225.143 .ft \n(.f
225.144 .ll \n(34u*1u/3u
225.145 -.if \n(.l<\n(80 .ll \n(80u
225.146 +.if \n(.l<\n(81 .ll \n(81u
225.147 .in 0
225.148 -\f2\-httpproxy:<host>:<port>\fP
225.149 +Allow vendor extensions (functionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
225.150 .br
225.151 .di
225.152 .nr e| \n(dn
225.153 @@ -185,15 +193,15 @@
225.154 ..
225.155 .ec \
225.156 .eo
225.157 -.am 81
225.158 +.am 80
225.159 .br
225.160 .di f+
225.161 .35
225.162 .ft \n(.f
225.163 .ll \n(34u*1u/3u
225.164 -.if \n(.l<\n(81 .ll \n(81u
225.165 +.if \n(.l<\n(80 .ll \n(80u
225.166 .in 0
225.167 -Specify an HTTP proxy server (port defaults to 8080)
225.168 +\f3\-httpproxy:<host>:<port> \fP
225.169 .br
225.170 .di
225.171 .nr f| \n(dn
225.172 @@ -209,7 +217,7 @@
225.173 .ll \n(34u*1u/3u
225.174 .if \n(.l<\n(81 .ll \n(81u
225.175 .in 0
225.176 -Specifying a target package via this command\-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification
225.177 +Specify an HTTP proxy server (port defaults to 8080)
225.178 .br
225.179 .di
225.180 .nr g| \n(dn
225.181 @@ -225,7 +233,7 @@
225.182 .ll \n(34u*1u/3u
225.183 .if \n(.l<\n(81 .ll \n(81u
225.184 .in 0
225.185 -Specify where to place generated source files
225.186 +Specifying a target package via this command\-line option, overrides any wsdl and schema binding customization for package name and the default package name algorithm defined in the specification
225.187 .br
225.188 .di
225.189 .nr h| \n(dn
225.190 @@ -241,7 +249,7 @@
225.191 .ll \n(34u*1u/3u
225.192 .if \n(.l<\n(81 .ll \n(81u
225.193 .in 0
225.194 -Output messages about what the compiler is doing
225.195 +Specify where to place generated source files
225.196 .br
225.197 .di
225.198 .nr i| \n(dn
225.199 @@ -257,7 +265,7 @@
225.200 .ll \n(34u*1u/3u
225.201 .if \n(.l<\n(81 .ll \n(81u
225.202 .in 0
225.203 -Print version information
225.204 +Output messages about what the compiler is doing
225.205 .br
225.206 .di
225.207 .nr j| \n(dn
225.208 @@ -265,16 +273,15 @@
225.209 ..
225.210 .ec \
225.211 .eo
225.212 -.am 80
225.213 +.am 81
225.214 .br
225.215 .di k+
225.216 .35
225.217 .ft \n(.f
225.218 .ll \n(34u*1u/3u
225.219 -.if \n(.l<\n(80 .ll \n(80u
225.220 +.if \n(.l<\n(81 .ll \n(81u
225.221 .in 0
225.222 -\f2\-wsdllocation <location>\fP
225.223 -.br
225.224 +Print version information
225.225 .br
225.226 .di
225.227 .nr k| \n(dn
225.228 @@ -282,53 +289,90 @@
225.229 ..
225.230 .ec \
225.231 .eo
225.232 -.am 81
225.233 +.am 80
225.234 .br
225.235 .di l+
225.236 .35
225.237 .ft \n(.f
225.238 .ll \n(34u*1u/3u
225.239 -.if \n(.l<\n(81 .ll \n(81u
225.240 +.if \n(.l<\n(80 .ll \n(80u
225.241 .in 0
225.242 -\f2@WebService.wsdlLocation\fP and \f2@WebServiceClient.wsdlLocation\fP value
225.243 -.br
225.244 +\f3\-wsdllocation <location>\fP
225.245 .br
225.246 .di
225.247 .nr l| \n(dn
225.248 .nr l- \n(dl
225.249 ..
225.250 .ec \
225.251 +.eo
225.252 +.am 81
225.253 +.br
225.254 +.di m+
225.255 +.35
225.256 +.ft \n(.f
225.257 +.ll \n(34u*1u/3u
225.258 +.if \n(.l<\n(81 .ll \n(81u
225.259 +.in 0
225.260 +\f2@WebServiceClient.wsdlLocation\fP value
225.261 +.br
225.262 +.di
225.263 +.nr m| \n(dn
225.264 +.nr m- \n(dl
225.265 +..
225.266 +.ec \
225.267 +.eo
225.268 +.am 81
225.269 +.br
225.270 +.di n+
225.271 +.35
225.272 +.ft \n(.f
225.273 +.ll \n(34u*1u/3u
225.274 +.if \n(.l<\n(81 .ll \n(81u
225.275 +.in 0
225.276 +Generate code as per the given JAX\-WS specification version. version 2.0 will generate compliant code for JAX\-WS 2.0 spec.
225.277 +.br
225.278 +.di
225.279 +.nr n| \n(dn
225.280 +.nr n- \n(dl
225.281 +..
225.282 +.ec \
225.283 .35
225.284 .nf
225.285 .ll \n(34u
225.286 .nr 80 0
225.287 .nr 38 \w\f3Option\fP
225.288 .if \n(80<\n(38 .nr 80 \n(38
225.289 -.nr 38 \w\f2\-d <directory>\fP
225.290 +.nr 38 \w\f3\-d <directory> \fP
225.291 .if \n(80<\n(38 .nr 80 \n(38
225.292 -.nr 38 \w\f2\-b <path>\fP
225.293 +.nr 38 \w\f3\-b <path> \fP
225.294 .if \n(80<\n(38 .nr 80 \n(38
225.295 -.nr 38 \w\-catalog
225.296 +.nr 38 \w\f3\-B <jaxbOption>\fP
225.297 .if \n(80<\n(38 .nr 80 \n(38
225.298 -.nr 38 \w\f2\-extension\fP
225.299 +.nr 38 \w\f3\-catalog\fP
225.300 .if \n(80<\n(38 .nr 80 \n(38
225.301 -.nr 38 \w\f2\-help\fP
225.302 +.nr 38 \w\f3\-extension \fP
225.303 .if \n(80<\n(38 .nr 80 \n(38
225.304 -.nr 38 \w\f2\-keep\fP
225.305 +.nr 38 \w\f3\-help \fP
225.306 .if \n(80<\n(38 .nr 80 \n(38
225.307 -.nr 38 \w\f2\-p\fP
225.308 +.nr 38 \w\f3\-keep \fP
225.309 .if \n(80<\n(38 .nr 80 \n(38
225.310 -.nr 38 \w\f2\-s <directory>\fP
225.311 +.nr 38 \w\f3\-p \fP
225.312 .if \n(80<\n(38 .nr 80 \n(38
225.313 -.nr 38 \w\f2\-verbose\fP
225.314 +.nr 38 \w\f3\-s <directory> \fP
225.315 .if \n(80<\n(38 .nr 80 \n(38
225.316 -.nr 38 \w\f2\-version\fP
225.317 +.nr 38 \w\f3\-verbose \fP
225.318 +.if \n(80<\n(38 .nr 80 \n(38
225.319 +.nr 38 \w\f3\-version \fP
225.320 +.if \n(80<\n(38 .nr 80 \n(38
225.321 +.nr 38 \w\f3\-target \fP
225.322 +.if \n(80<\n(38 .nr 80 \n(38
225.323 +.nr 38 \w\f3\-quiet \fP
225.324 .if \n(80<\n(38 .nr 80 \n(38
225.325 .80
225.326 .rm 80
225.327 -.nr 38 \n(e-
225.328 +.nr 38 \n(f-
225.329 .if \n(80<\n(38 .nr 80 \n(38
225.330 -.nr 38 \n(k-
225.331 +.nr 38 \n(l-
225.332 .if \n(80<\n(38 .nr 80 \n(38
225.333 .nr 81 0
225.334 .nr 38 \w\f3Description\fP
225.335 @@ -337,6 +381,8 @@
225.336 .if \n(81<\n(38 .nr 81 \n(38
225.337 .nr 38 \wKeep generated files
225.338 .if \n(81<\n(38 .nr 81 \n(38
225.339 +.nr 38 \wSuppress wsimport output
225.340 +.if \n(81<\n(38 .nr 81 \n(38
225.341 .81
225.342 .rm 81
225.343 .nr 38 \n(a-
225.344 @@ -347,7 +393,7 @@
225.345 .if \n(81<\n(38 .nr 81 \n(38
225.346 .nr 38 \n(d-
225.347 .if \n(81<\n(38 .nr 81 \n(38
225.348 -.nr 38 \n(f-
225.349 +.nr 38 \n(e-
225.350 .if \n(81<\n(38 .nr 81 \n(38
225.351 .nr 38 \n(g-
225.352 .if \n(81<\n(38 .nr 81 \n(38
225.353 @@ -357,7 +403,11 @@
225.354 .if \n(81<\n(38 .nr 81 \n(38
225.355 .nr 38 \n(j-
225.356 .if \n(81<\n(38 .nr 81 \n(38
225.357 -.nr 38 \n(l-
225.358 +.nr 38 \n(k-
225.359 +.if \n(81<\n(38 .nr 81 \n(38
225.360 +.nr 38 \n(m-
225.361 +.if \n(81<\n(38 .nr 81 \n(38
225.362 +.nr 38 \n(n-
225.363 .if \n(81<\n(38 .nr 81 \n(38
225.364 .35
225.365 .nf
225.366 @@ -369,7 +419,7 @@
225.367 .nr 41 \n(80+(3*\n(38)
225.368 .nr 81 +\n(41
225.369 .nr TW \n(81
225.370 -.if t .if \n(TW>\n(.li .tm Table at line 124 file Input is too wide - \n(TW units
225.371 +.if t .if \n(TW>\n(.li .tm Table at line 158 file Input is too wide - \n(TW units
225.372 .fc
225.373 .nr #T 0-1
225.374 .nr #a 0-1
225.375 @@ -392,7 +442,7 @@
225.376 .ta \n(80u \n(81u
225.377 .nr 31 \n(.f
225.378 .nr 35 1m
225.379 -\&\h'|\n(40u'\f2\-d <directory>\fP\h'|\n(41u'
225.380 +\&\h'|\n(40u'\f3\-d <directory> \fP\h'|\n(41u'
225.381 .mk ##
225.382 .nr 31 \n(##
225.383 .sp |\n(##u-1v
225.384 @@ -408,7 +458,7 @@
225.385 .ta \n(80u \n(81u
225.386 .nr 31 \n(.f
225.387 .nr 35 1m
225.388 -\&\h'|\n(40u'\f2\-b <path>\fP\h'|\n(41u'
225.389 +\&\h'|\n(40u'\f3\-b <path> \fP\h'|\n(41u'
225.390 .mk ##
225.391 .nr 31 \n(##
225.392 .sp |\n(##u-1v
225.393 @@ -424,7 +474,7 @@
225.394 .ta \n(80u \n(81u
225.395 .nr 31 \n(.f
225.396 .nr 35 1m
225.397 -\&\h'|\n(40u'\-catalog\h'|\n(41u'
225.398 +\&\h'|\n(40u'\f3\-B <jaxbOption>\fP\h'|\n(41u'
225.399 .mk ##
225.400 .nr 31 \n(##
225.401 .sp |\n(##u-1v
225.402 @@ -440,7 +490,7 @@
225.403 .ta \n(80u \n(81u
225.404 .nr 31 \n(.f
225.405 .nr 35 1m
225.406 -\&\h'|\n(40u'\f2\-extension\fP\h'|\n(41u'
225.407 +\&\h'|\n(40u'\f3\-catalog\fP\h'|\n(41u'
225.408 .mk ##
225.409 .nr 31 \n(##
225.410 .sp |\n(##u-1v
225.411 @@ -451,14 +501,30 @@
225.412 .mk 32
225.413 .if \n(32>\n(31 .nr 31 \n(32
225.414 .sp |\n(31u
225.415 +.ne \n(e|u+\n(.Vu
225.416 +.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
225.417 .ta \n(80u \n(81u
225.418 .nr 31 \n(.f
225.419 .nr 35 1m
225.420 -\&\h'|\n(40u'\f2\-help\fP\h'|\n(41u'Display help
225.421 -.ne \n(e|u+\n(.Vu
225.422 +\&\h'|\n(40u'\f3\-extension \fP\h'|\n(41u'
225.423 +.mk ##
225.424 +.nr 31 \n(##
225.425 +.sp |\n(##u-1v
225.426 +.nr 37 \n(41u
225.427 +.in +\n(37u
225.428 +.e+
225.429 +.in -\n(37u
225.430 +.mk 32
225.431 +.if \n(32>\n(31 .nr 31 \n(32
225.432 +.sp |\n(31u
225.433 +.ta \n(80u \n(81u
225.434 +.nr 31 \n(.f
225.435 +.nr 35 1m
225.436 +\&\h'|\n(40u'\f3\-help \fP\h'|\n(41u'Display help
225.437 .ne \n(f|u+\n(.Vu
225.438 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
225.439 +.ne \n(g|u+\n(.Vu
225.440 .if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
225.441 +.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
225.442 .ta \n(80u \n(81u
225.443 .nr 31 \n(.f
225.444 .nr 35 1m
225.445 @@ -468,30 +534,10 @@
225.446 .sp |\n(##u-1v
225.447 .nr 37 \n(40u
225.448 .in +\n(37u
225.449 -.e+
225.450 -.in -\n(37u
225.451 -.mk 32
225.452 -.if \n(32>\n(31 .nr 31 \n(32
225.453 -.sp |\n(##u-1v
225.454 -.nr 37 \n(41u
225.455 -.in +\n(37u
225.456 .f+
225.457 .in -\n(37u
225.458 .mk 32
225.459 .if \n(32>\n(31 .nr 31 \n(32
225.460 -.sp |\n(31u
225.461 -.ta \n(80u \n(81u
225.462 -.nr 31 \n(.f
225.463 -.nr 35 1m
225.464 -\&\h'|\n(40u'\f2\-keep\fP\h'|\n(41u'Keep generated files
225.465 -.ne \n(g|u+\n(.Vu
225.466 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
225.467 -.ta \n(80u \n(81u
225.468 -.nr 31 \n(.f
225.469 -.nr 35 1m
225.470 -\&\h'|\n(40u'\f2\-p\fP\h'|\n(41u'
225.471 -.mk ##
225.472 -.nr 31 \n(##
225.473 .sp |\n(##u-1v
225.474 .nr 37 \n(41u
225.475 .in +\n(37u
225.476 @@ -500,12 +546,16 @@
225.477 .mk 32
225.478 .if \n(32>\n(31 .nr 31 \n(32
225.479 .sp |\n(31u
225.480 +.ta \n(80u \n(81u
225.481 +.nr 31 \n(.f
225.482 +.nr 35 1m
225.483 +\&\h'|\n(40u'\f3\-keep \fP\h'|\n(41u'Keep generated files
225.484 .ne \n(h|u+\n(.Vu
225.485 .if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
225.486 .ta \n(80u \n(81u
225.487 .nr 31 \n(.f
225.488 .nr 35 1m
225.489 -\&\h'|\n(40u'\f2\-s <directory>\fP\h'|\n(41u'
225.490 +\&\h'|\n(40u'\f3\-p \fP\h'|\n(41u'
225.491 .mk ##
225.492 .nr 31 \n(##
225.493 .sp |\n(##u-1v
225.494 @@ -521,7 +571,7 @@
225.495 .ta \n(80u \n(81u
225.496 .nr 31 \n(.f
225.497 .nr 35 1m
225.498 -\&\h'|\n(40u'\f2\-verbose\fP\h'|\n(41u'
225.499 +\&\h'|\n(40u'\f3\-s <directory> \fP\h'|\n(41u'
225.500 .mk ##
225.501 .nr 31 \n(##
225.502 .sp |\n(##u-1v
225.503 @@ -537,7 +587,7 @@
225.504 .ta \n(80u \n(81u
225.505 .nr 31 \n(.f
225.506 .nr 35 1m
225.507 -\&\h'|\n(40u'\f2\-version\fP\h'|\n(41u'
225.508 +\&\h'|\n(40u'\f3\-verbose \fP\h'|\n(41u'
225.509 .mk ##
225.510 .nr 31 \n(##
225.511 .sp |\n(##u-1v
225.512 @@ -549,9 +599,25 @@
225.513 .if \n(32>\n(31 .nr 31 \n(32
225.514 .sp |\n(31u
225.515 .ne \n(k|u+\n(.Vu
225.516 +.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
225.517 +.ta \n(80u \n(81u
225.518 +.nr 31 \n(.f
225.519 +.nr 35 1m
225.520 +\&\h'|\n(40u'\f3\-version \fP\h'|\n(41u'
225.521 +.mk ##
225.522 +.nr 31 \n(##
225.523 +.sp |\n(##u-1v
225.524 +.nr 37 \n(41u
225.525 +.in +\n(37u
225.526 +.k+
225.527 +.in -\n(37u
225.528 +.mk 32
225.529 +.if \n(32>\n(31 .nr 31 \n(32
225.530 +.sp |\n(31u
225.531 .ne \n(l|u+\n(.Vu
225.532 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
225.533 +.ne \n(m|u+\n(.Vu
225.534 .if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
225.535 +.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
225.536 .ta \n(80u \n(81u
225.537 .nr 31 \n(.f
225.538 .nr 35 1m
225.539 @@ -561,690 +627,38 @@
225.540 .sp |\n(##u-1v
225.541 .nr 37 \n(40u
225.542 .in +\n(37u
225.543 -.k+
225.544 +.l+
225.545 .in -\n(37u
225.546 .mk 32
225.547 .if \n(32>\n(31 .nr 31 \n(32
225.548 .sp |\n(##u-1v
225.549 .nr 37 \n(41u
225.550 .in +\n(37u
225.551 -.l+
225.552 +.m+
225.553 .in -\n(37u
225.554 .mk 32
225.555 .if \n(32>\n(31 .nr 31 \n(32
225.556 .sp |\n(31u
225.557 -.fc
225.558 -.nr T. 1
225.559 -.T# 1
225.560 -.35
225.561 -.rm a+
225.562 -.rm b+
225.563 -.rm c+
225.564 -.rm d+
225.565 -.rm e+
225.566 -.rm f+
225.567 -.rm g+
225.568 -.rm h+
225.569 -.rm i+
225.570 -.rm j+
225.571 -.rm k+
225.572 -.rm l+
225.573 -.TE
225.574 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-54
225.575 -
225.576 -.LP
225.577 -.LP
225.578 -Multiple JAX\-WS and JAXB binding files can be specified using \f2\-b\fP option and they can be used to customize various things like package names, bean names, etc. More information on JAX\-WS and JAXB binding files can be found in the customization documentation.
225.579 -.br
225.580 -
225.581 -.LP
225.582 -.SS
225.583 -Ant task
225.584 -.LP
225.585 -.LP
225.586 -An Ant task for the \f2wsimport\fP tool is provided along with the tool. The attributes and elements supported by the Ant task are listed below:
225.587 -.br
225.588 -
225.589 -.LP
225.590 -.nf
225.591 -\f3
225.592 -.fl
225.593 - <wsimport \fP
225.594 -.br
225.595 -\f3
225.596 -.fl
225.597 - wsdl="..." \fP
225.598 -.br
225.599 -\f3
225.600 -.fl
225.601 - destdir="directory for generated class files"\fP
225.602 -.br
225.603 -\f3
225.604 -.fl
225.605 - sourcedestdir="directory for generated source files"\fP
225.606 -.br
225.607 -\f3
225.608 -.fl
225.609 - keep="true|false"\fP
225.610 -.br
225.611 -\f3
225.612 -.fl
225.613 - extension="true|false"\fP
225.614 -.br
225.615 -\f3
225.616 -.fl
225.617 - verbose="true|false"\fP
225.618 -.br
225.619 -\f3
225.620 -.fl
225.621 - version="true|false"\fP
225.622 -.br
225.623 -\f3
225.624 -.fl
225.625 - wsdlLocation="..."\fP
225.626 -.br
225.627 -\f3
225.628 -.fl
225.629 - catalog="catalog file"\fP
225.630 -.br
225.631 -\f3
225.632 -.fl
225.633 - package="package name"\fP
225.634 -.br
225.635 -\f3
225.636 -.fl
225.637 - <binding dir="..." includes="..." />\fP
225.638 -.br
225.639 -\f3
225.640 -.fl
225.641 - </wsimport>
225.642 -.fl
225.643 -\fP
225.644 -.fi
225.645 -
225.646 -.LP
225.647 -.LP
225.648 -.TS
225.649 -.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
225.650 -.de 35
225.651 -.ps \n(.s
225.652 -.vs \n(.vu
225.653 -.in \n(.iu
225.654 -.if \n(.u .fi
225.655 -.if \n(.j .ad
225.656 -.if \n(.j=0 .na
225.657 -..
225.658 -.nf
225.659 -.nr #~ 0
225.660 -.if n .nr #~ 0.6n
225.661 -.ds #d .d
225.662 -.if \(ts\n(.z\(ts\(ts .ds #d nl
225.663 -.fc
225.664 -.nr 33 \n(.s
225.665 -.rm 80 81 82
225.666 -.nr 34 \n(.lu
225.667 -.eo
225.668 -.am 81
225.669 -.br
225.670 -.di a+
225.671 -.35
225.672 -.ft \n(.f
225.673 -.ll \n(34u*1u/4u
225.674 -.if \n(.l<\n(81 .ll \n(81u
225.675 -.in 0
225.676 -Specify where to place output generated classes
225.677 -.br
225.678 -.di
225.679 -.nr a| \n(dn
225.680 -.nr a- \n(dl
225.681 -..
225.682 -.ec \
225.683 -.eo
225.684 -.am 81
225.685 -.br
225.686 -.di b+
225.687 -.35
225.688 -.ft \n(.f
225.689 -.ll \n(34u*1u/4u
225.690 -.if \n(.l<\n(81 .ll \n(81u
225.691 -.in 0
225.692 -Specify where to place generated source files, keep is turned on with this option
225.693 -.br
225.694 -.di
225.695 -.nr b| \n(dn
225.696 -.nr b- \n(dl
225.697 -..
225.698 -.ec \
225.699 -.eo
225.700 -.am 81
225.701 -.br
225.702 -.di c+
225.703 -.35
225.704 -.ft \n(.f
225.705 -.ll \n(34u*1u/4u
225.706 -.if \n(.l<\n(81 .ll \n(81u
225.707 -.in 0
225.708 -Keep generated files, tunred on with sourcedestdir option
225.709 -.br
225.710 -.di
225.711 -.nr c| \n(dn
225.712 -.nr c- \n(dl
225.713 -..
225.714 -.ec \
225.715 -.eo
225.716 -.am 81
225.717 -.br
225.718 -.di d+
225.719 -.35
225.720 -.ft \n(.f
225.721 -.ll \n(34u*1u/4u
225.722 -.if \n(.l<\n(81 .ll \n(81u
225.723 -.in 0
225.724 -Output messages about what the compiler is doing
225.725 -.br
225.726 -.di
225.727 -.nr d| \n(dn
225.728 -.nr d- \n(dl
225.729 -..
225.730 -.ec \
225.731 -.eo
225.732 -.am 81
225.733 -.br
225.734 -.di e+
225.735 -.35
225.736 -.ft \n(.f
225.737 -.ll \n(34u*1u/4u
225.738 -.if \n(.l<\n(81 .ll \n(81u
225.739 -.in 0
225.740 -Specify external JAX\-WS or JAXB binding files
225.741 -.br
225.742 -.di
225.743 -.nr e| \n(dn
225.744 -.nr e- \n(dl
225.745 -..
225.746 -.ec \
225.747 -.eo
225.748 -.am 81
225.749 -.br
225.750 -.di f+
225.751 -.35
225.752 -.ft \n(.f
225.753 -.ll \n(34u*1u/4u
225.754 -.if \n(.l<\n(81 .ll \n(81u
225.755 -.in 0
225.756 -allow vendor extentions (funcionality not specified by the specification). Use of extensions may result in applications that are not portable or may not interoperate with other implementations
225.757 -.br
225.758 -.di
225.759 -.nr f| \n(dn
225.760 -.nr f- \n(dl
225.761 -..
225.762 -.ec \
225.763 -.eo
225.764 -.am 80
225.765 -.br
225.766 -.di g+
225.767 -.35
225.768 -.ft \n(.f
225.769 -.ll \n(34u*1u/4u
225.770 -.if \n(.l<\n(80 .ll \n(80u
225.771 -.in 0
225.772 -\f2wsdllocation\fP
225.773 -.br
225.774 -.br
225.775 -.di
225.776 -.nr g| \n(dn
225.777 -.nr g- \n(dl
225.778 -..
225.779 -.ec \
225.780 -.eo
225.781 -.am 81
225.782 -.br
225.783 -.di h+
225.784 -.35
225.785 -.ft \n(.f
225.786 -.ll \n(34u*1u/4u
225.787 -.if \n(.l<\n(81 .ll \n(81u
225.788 -.in 0
225.789 -The wsdl URI passed thru this option will be used to set the value of \f2@WebService.wsdlLocation\fP and \f2@WebServiceClient.wsdlLocation\fP annotation elements on the generated SEI and Service interface
225.790 -.br
225.791 -.br
225.792 -.di
225.793 -.nr h| \n(dn
225.794 -.nr h- \n(dl
225.795 -..
225.796 -.ec \
225.797 -.eo
225.798 -.am 82
225.799 -.br
225.800 -.di i+
225.801 -.35
225.802 -.ft \n(.f
225.803 -.ll \n(34u*1u/4u
225.804 -.if \n(.l<\n(82 .ll \n(82u
225.805 -.in 0
225.806 -\f2\-wsdllocation\fP
225.807 -.br
225.808 -.br
225.809 -.di
225.810 -.nr i| \n(dn
225.811 -.nr i- \n(dl
225.812 -..
225.813 -.ec \
225.814 -.eo
225.815 -.am 80
225.816 -.br
225.817 -.di j+
225.818 -.35
225.819 -.ft \n(.f
225.820 -.ll \n(34u*1u/4u
225.821 -.if \n(.l<\n(80 .ll \n(80u
225.822 -.in 0
225.823 -\f2catalog\fP
225.824 -.br
225.825 -.br
225.826 -.di
225.827 -.nr j| \n(dn
225.828 -.nr j- \n(dl
225.829 -..
225.830 -.ec \
225.831 -.eo
225.832 -.am 81
225.833 -.br
225.834 -.di k+
225.835 -.35
225.836 -.ft \n(.f
225.837 -.ll \n(34u*1u/4u
225.838 -.if \n(.l<\n(81 .ll \n(81u
225.839 -.in 0
225.840 -Specify catalog file to resolve external entity references, it supports TR9401, XCatalog, and OASIS XML Catalog format. Additionally, ant xmlcatalog type can be used to resolve entities, see wsimport_catalog sample.
225.841 -.br
225.842 -.di
225.843 -.nr k| \n(dn
225.844 -.nr k- \n(dl
225.845 -..
225.846 -.ec \
225.847 -.eo
225.848 -.am 82
225.849 -.br
225.850 -.di l+
225.851 -.35
225.852 -.ft \n(.f
225.853 -.ll \n(34u*1u/4u
225.854 -.if \n(.l<\n(82 .ll \n(82u
225.855 -.in 0
225.856 -\f2\-catalog\fP
225.857 -.br
225.858 -.br
225.859 -.di
225.860 -.nr l| \n(dn
225.861 -.nr l- \n(dl
225.862 -..
225.863 -.ec \
225.864 -.eo
225.865 -.am 80
225.866 -.br
225.867 -.di m+
225.868 -.35
225.869 -.ft \n(.f
225.870 -.ll \n(34u*1u/4u
225.871 -.if \n(.l<\n(80 .ll \n(80u
225.872 -.in 0
225.873 -\f2package\fP
225.874 -.br
225.875 -.br
225.876 -.di
225.877 -.nr m| \n(dn
225.878 -.nr m- \n(dl
225.879 -..
225.880 -.ec \
225.881 -.eo
225.882 -.am 81
225.883 -.br
225.884 -.di n+
225.885 -.35
225.886 -.ft \n(.f
225.887 -.ll \n(34u*1u/4u
225.888 -.if \n(.l<\n(81 .ll \n(81u
225.889 -.in 0
225.890 -Specifies the target package
225.891 -.br
225.892 -.di
225.893 -.nr n| \n(dn
225.894 -.nr n- \n(dl
225.895 -..
225.896 -.ec \
225.897 -.eo
225.898 -.am 82
225.899 -.br
225.900 -.di o+
225.901 -.35
225.902 -.ft \n(.f
225.903 -.ll \n(34u*1u/4u
225.904 -.if \n(.l<\n(82 .ll \n(82u
225.905 -.in 0
225.906 -\f2\-p\fP
225.907 -.br
225.908 -.br
225.909 -.di
225.910 -.nr o| \n(dn
225.911 -.nr o- \n(dl
225.912 -..
225.913 -.ec \
225.914 -.35
225.915 -.nf
225.916 -.ll \n(34u
225.917 -.nr 80 0
225.918 -.nr 38 \w\f3Attribute\fP
225.919 -.if \n(80<\n(38 .nr 80 \n(38
225.920 -.nr 38 \w\f2wsdl\fP
225.921 -.if \n(80<\n(38 .nr 80 \n(38
225.922 -.nr 38 \w\f2destdir\fP
225.923 -.if \n(80<\n(38 .nr 80 \n(38
225.924 -.nr 38 \wsourcedestdir
225.925 -.if \n(80<\n(38 .nr 80 \n(38
225.926 -.nr 38 \w\f2keep\fP
225.927 -.if \n(80<\n(38 .nr 80 \n(38
225.928 -.nr 38 \w\f2verbose\fP
225.929 -.if \n(80<\n(38 .nr 80 \n(38
225.930 -.nr 38 \w\f2binding\fP
225.931 -.if \n(80<\n(38 .nr 80 \n(38
225.932 -.nr 38 \w\f2extension\fP
225.933 -.if \n(80<\n(38 .nr 80 \n(38
225.934 -.80
225.935 -.rm 80
225.936 -.nr 38 \n(g-
225.937 -.if \n(80<\n(38 .nr 80 \n(38
225.938 -.nr 38 \n(j-
225.939 -.if \n(80<\n(38 .nr 80 \n(38
225.940 -.nr 38 \n(m-
225.941 -.if \n(80<\n(38 .nr 80 \n(38
225.942 -.nr 81 0
225.943 -.nr 38 \w\f3Description\fP
225.944 -.if \n(81<\n(38 .nr 81 \n(38
225.945 -.nr 38 \wWSDL file
225.946 -.if \n(81<\n(38 .nr 81 \n(38
225.947 -.81
225.948 -.rm 81
225.949 -.nr 38 \n(a-
225.950 -.if \n(81<\n(38 .nr 81 \n(38
225.951 -.nr 38 \n(b-
225.952 -.if \n(81<\n(38 .nr 81 \n(38
225.953 -.nr 38 \n(c-
225.954 -.if \n(81<\n(38 .nr 81 \n(38
225.955 -.nr 38 \n(d-
225.956 -.if \n(81<\n(38 .nr 81 \n(38
225.957 -.nr 38 \n(e-
225.958 -.if \n(81<\n(38 .nr 81 \n(38
225.959 -.nr 38 \n(f-
225.960 -.if \n(81<\n(38 .nr 81 \n(38
225.961 -.nr 38 \n(h-
225.962 -.if \n(81<\n(38 .nr 81 \n(38
225.963 -.nr 38 \n(k-
225.964 -.if \n(81<\n(38 .nr 81 \n(38
225.965 -.nr 38 \n(n-
225.966 -.if \n(81<\n(38 .nr 81 \n(38
225.967 -.nr 82 0
225.968 -.nr 38 \w\f3Command line\fP
225.969 -.if \n(82<\n(38 .nr 82 \n(38
225.970 -.nr 38 \wWSDL
225.971 -.if \n(82<\n(38 .nr 82 \n(38
225.972 -.nr 38 \w\f2\-d\fP
225.973 -.if \n(82<\n(38 .nr 82 \n(38
225.974 -.nr 38 \w\f2\-s\fP
225.975 -.if \n(82<\n(38 .nr 82 \n(38
225.976 -.nr 38 \w\f2\-keep\fP
225.977 -.if \n(82<\n(38 .nr 82 \n(38
225.978 -.nr 38 \w\f2\-verbose\fP
225.979 -.if \n(82<\n(38 .nr 82 \n(38
225.980 -.nr 38 \w\f2\-b\fP
225.981 -.if \n(82<\n(38 .nr 82 \n(38
225.982 -.nr 38 \w\f2\-extension\fP
225.983 -.if \n(82<\n(38 .nr 82 \n(38
225.984 -.82
225.985 -.rm 82
225.986 -.nr 38 \n(i-
225.987 -.if \n(82<\n(38 .nr 82 \n(38
225.988 -.nr 38 \n(l-
225.989 -.if \n(82<\n(38 .nr 82 \n(38
225.990 -.nr 38 \n(o-
225.991 -.if \n(82<\n(38 .nr 82 \n(38
225.992 -.35
225.993 -.nf
225.994 -.ll \n(34u
225.995 -.nr 38 1n
225.996 -.nr 79 0
225.997 -.nr 40 \n(79+(0*\n(38)
225.998 -.nr 80 +\n(40
225.999 -.nr 41 \n(80+(3*\n(38)
225.1000 -.nr 81 +\n(41
225.1001 -.nr 42 \n(81+(3*\n(38)
225.1002 -.nr 82 +\n(42
225.1003 -.nr TW \n(82
225.1004 -.if t .if \n(TW>\n(.li .tm Table at line 261 file Input is too wide - \n(TW units
225.1005 -.fc
225.1006 -.nr #T 0-1
225.1007 -.nr #a 0-1
225.1008 -.eo
225.1009 -.de T#
225.1010 -.ds #d .d
225.1011 -.if \(ts\n(.z\(ts\(ts .ds #d nl
225.1012 -.mk ##
225.1013 -.nr ## -1v
225.1014 -.ls 1
225.1015 -.ls
225.1016 -..
225.1017 -.ec
225.1018 -.ta \n(80u \n(81u \n(82u
225.1019 +.ne \n(n|u+\n(.Vu
225.1020 +.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
225.1021 +.ta \n(80u \n(81u
225.1022 .nr 31 \n(.f
225.1023 .nr 35 1m
225.1024 -\&\h'|\n(40u'\f3Attribute\fP\h'|\n(41u'\f3Description\fP\h'|\n(42u'\f3Command line\fP
225.1025 -.ta \n(80u \n(81u \n(82u
225.1026 -.nr 31 \n(.f
225.1027 -.nr 35 1m
225.1028 -\&\h'|\n(40u'\f2wsdl\fP\h'|\n(41u'WSDL file\h'|\n(42u'WSDL
225.1029 -.ne \n(a|u+\n(.Vu
225.1030 -.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
225.1031 -.ta \n(80u \n(81u \n(82u
225.1032 -.nr 31 \n(.f
225.1033 -.nr 35 1m
225.1034 -\&\h'|\n(40u'\f2destdir\fP\h'|\n(41u'\h'|\n(42u'\f2\-d\fP
225.1035 +\&\h'|\n(40u'\f3\-target \fP\h'|\n(41u'
225.1036 .mk ##
225.1037 .nr 31 \n(##
225.1038 .sp |\n(##u-1v
225.1039 .nr 37 \n(41u
225.1040 .in +\n(37u
225.1041 -.a+
225.1042 -.in -\n(37u
225.1043 -.mk 32
225.1044 -.if \n(32>\n(31 .nr 31 \n(32
225.1045 -.sp |\n(31u
225.1046 -.ne \n(b|u+\n(.Vu
225.1047 -.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
225.1048 -.ta \n(80u \n(81u \n(82u
225.1049 -.nr 31 \n(.f
225.1050 -.nr 35 1m
225.1051 -\&\h'|\n(40u'sourcedestdir\h'|\n(41u'\h'|\n(42u'\f2\-s\fP
225.1052 -.mk ##
225.1053 -.nr 31 \n(##
225.1054 -.sp |\n(##u-1v
225.1055 -.nr 37 \n(41u
225.1056 -.in +\n(37u
225.1057 -.b+
225.1058 -.in -\n(37u
225.1059 -.mk 32
225.1060 -.if \n(32>\n(31 .nr 31 \n(32
225.1061 -.sp |\n(31u
225.1062 -.ne \n(c|u+\n(.Vu
225.1063 -.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
225.1064 -.ta \n(80u \n(81u \n(82u
225.1065 -.nr 31 \n(.f
225.1066 -.nr 35 1m
225.1067 -\&\h'|\n(40u'\f2keep\fP\h'|\n(41u'\h'|\n(42u'\f2\-keep\fP
225.1068 -.mk ##
225.1069 -.nr 31 \n(##
225.1070 -.sp |\n(##u-1v
225.1071 -.nr 37 \n(41u
225.1072 -.in +\n(37u
225.1073 -.c+
225.1074 -.in -\n(37u
225.1075 -.mk 32
225.1076 -.if \n(32>\n(31 .nr 31 \n(32
225.1077 -.sp |\n(31u
225.1078 -.ne \n(d|u+\n(.Vu
225.1079 -.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
225.1080 -.ta \n(80u \n(81u \n(82u
225.1081 -.nr 31 \n(.f
225.1082 -.nr 35 1m
225.1083 -\&\h'|\n(40u'\f2verbose\fP\h'|\n(41u'\h'|\n(42u'\f2\-verbose\fP
225.1084 -.mk ##
225.1085 -.nr 31 \n(##
225.1086 -.sp |\n(##u-1v
225.1087 -.nr 37 \n(41u
225.1088 -.in +\n(37u
225.1089 -.d+
225.1090 -.in -\n(37u
225.1091 -.mk 32
225.1092 -.if \n(32>\n(31 .nr 31 \n(32
225.1093 -.sp |\n(31u
225.1094 -.ne \n(e|u+\n(.Vu
225.1095 -.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
225.1096 -.ta \n(80u \n(81u \n(82u
225.1097 -.nr 31 \n(.f
225.1098 -.nr 35 1m
225.1099 -\&\h'|\n(40u'\f2binding\fP\h'|\n(41u'\h'|\n(42u'\f2\-b\fP
225.1100 -.mk ##
225.1101 -.nr 31 \n(##
225.1102 -.sp |\n(##u-1v
225.1103 -.nr 37 \n(41u
225.1104 -.in +\n(37u
225.1105 -.e+
225.1106 -.in -\n(37u
225.1107 -.mk 32
225.1108 -.if \n(32>\n(31 .nr 31 \n(32
225.1109 -.sp |\n(31u
225.1110 -.ta \n(80u \n(81u \n(82u
225.1111 -.nr 31 \n(.f
225.1112 -.nr 35 1m
225.1113 -\&\h'|\n(40u'\f2extension\fP\h'|\n(41u'\h'|\n(42u'
225.1114 -.br
225.1115 -.ne \n(f|u+\n(.Vu
225.1116 -.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
225.1117 -.ta \n(80u \n(81u \n(82u
225.1118 -.nr 31 \n(.f
225.1119 -.nr 35 1m
225.1120 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'\f2\-extension\fP
225.1121 -.mk ##
225.1122 -.nr 31 \n(##
225.1123 -.sp |\n(##u-1v
225.1124 -.nr 37 \n(41u
225.1125 -.in +\n(37u
225.1126 -.f+
225.1127 -.in -\n(37u
225.1128 -.mk 32
225.1129 -.if \n(32>\n(31 .nr 31 \n(32
225.1130 -.sp |\n(31u
225.1131 -.ne \n(g|u+\n(.Vu
225.1132 -.ne \n(h|u+\n(.Vu
225.1133 -.ne \n(i|u+\n(.Vu
225.1134 -.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
225.1135 -.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
225.1136 -.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
225.1137 -.ta \n(80u \n(81u \n(82u
225.1138 -.nr 31 \n(.f
225.1139 -.nr 35 1m
225.1140 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
225.1141 -.mk ##
225.1142 -.nr 31 \n(##
225.1143 -.sp |\n(##u-1v
225.1144 -.nr 37 \n(40u
225.1145 -.in +\n(37u
225.1146 -.g+
225.1147 -.in -\n(37u
225.1148 -.mk 32
225.1149 -.if \n(32>\n(31 .nr 31 \n(32
225.1150 -.sp |\n(##u-1v
225.1151 -.nr 37 \n(41u
225.1152 -.in +\n(37u
225.1153 -.h+
225.1154 -.in -\n(37u
225.1155 -.mk 32
225.1156 -.if \n(32>\n(31 .nr 31 \n(32
225.1157 -.sp |\n(##u-1v
225.1158 -.nr 37 \n(42u
225.1159 -.in +\n(37u
225.1160 -.i+
225.1161 -.in -\n(37u
225.1162 -.mk 32
225.1163 -.if \n(32>\n(31 .nr 31 \n(32
225.1164 -.sp |\n(31u
225.1165 -.ne \n(j|u+\n(.Vu
225.1166 -.ne \n(k|u+\n(.Vu
225.1167 -.ne \n(l|u+\n(.Vu
225.1168 -.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
225.1169 -.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
225.1170 -.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
225.1171 -.ta \n(80u \n(81u \n(82u
225.1172 -.nr 31 \n(.f
225.1173 -.nr 35 1m
225.1174 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
225.1175 -.mk ##
225.1176 -.nr 31 \n(##
225.1177 -.sp |\n(##u-1v
225.1178 -.nr 37 \n(40u
225.1179 -.in +\n(37u
225.1180 -.j+
225.1181 -.in -\n(37u
225.1182 -.mk 32
225.1183 -.if \n(32>\n(31 .nr 31 \n(32
225.1184 -.sp |\n(##u-1v
225.1185 -.nr 37 \n(41u
225.1186 -.in +\n(37u
225.1187 -.k+
225.1188 -.in -\n(37u
225.1189 -.mk 32
225.1190 -.if \n(32>\n(31 .nr 31 \n(32
225.1191 -.sp |\n(##u-1v
225.1192 -.nr 37 \n(42u
225.1193 -.in +\n(37u
225.1194 -.l+
225.1195 -.in -\n(37u
225.1196 -.mk 32
225.1197 -.if \n(32>\n(31 .nr 31 \n(32
225.1198 -.sp |\n(31u
225.1199 -.ne \n(m|u+\n(.Vu
225.1200 -.ne \n(n|u+\n(.Vu
225.1201 -.ne \n(o|u+\n(.Vu
225.1202 -.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
225.1203 -.if (\n(n|+\n(#^-1v)>\n(#- .nr #- +(\n(n|+\n(#^-\n(#--1v)
225.1204 -.if (\n(o|+\n(#^-1v)>\n(#- .nr #- +(\n(o|+\n(#^-\n(#--1v)
225.1205 -.ta \n(80u \n(81u \n(82u
225.1206 -.nr 31 \n(.f
225.1207 -.nr 35 1m
225.1208 -\&\h'|\n(40u'\h'|\n(41u'\h'|\n(42u'
225.1209 -.mk ##
225.1210 -.nr 31 \n(##
225.1211 -.sp |\n(##u-1v
225.1212 -.nr 37 \n(40u
225.1213 -.in +\n(37u
225.1214 -.m+
225.1215 -.in -\n(37u
225.1216 -.mk 32
225.1217 -.if \n(32>\n(31 .nr 31 \n(32
225.1218 -.sp |\n(##u-1v
225.1219 -.nr 37 \n(41u
225.1220 -.in +\n(37u
225.1221 .n+
225.1222 .in -\n(37u
225.1223 .mk 32
225.1224 .if \n(32>\n(31 .nr 31 \n(32
225.1225 -.sp |\n(##u-1v
225.1226 -.nr 37 \n(42u
225.1227 -.in +\n(37u
225.1228 -.o+
225.1229 -.in -\n(37u
225.1230 -.mk 32
225.1231 -.if \n(32>\n(31 .nr 31 \n(32
225.1232 .sp |\n(31u
225.1233 +.ta \n(80u \n(81u
225.1234 +.nr 31 \n(.f
225.1235 +.nr 35 1m
225.1236 +\&\h'|\n(40u'\f3\-quiet \fP\h'|\n(41u'Suppress wsimport output
225.1237 .fc
225.1238 .nr T. 1
225.1239 .T# 1
225.1240 @@ -1263,137 +677,23 @@
225.1241 .rm l+
225.1242 .rm m+
225.1243 .rm n+
225.1244 -.rm o+
225.1245 .TE
225.1246 -.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
225.1247 -
225.1248 +.if \n-(b.=0 .nr c. \n(.c-\n(d.-66
225.1249 .LP
225.1250 +Multiple JAX\-WS and JAXB binding files can be specified using \f2\-b\fP option and they can be used to customize various things like package names, bean names, etc. More information on JAX\-WS and JAXB binding files can be found in the
225.1251 +.na
225.1252 +\f2customization documentation\fP @
225.1253 +.fi
225.1254 +https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.html.
225.1255 .LP
225.1256 -The \f2binding\fP attributes is like a
225.1257 -.na
225.1258 -\f2path\-like structure\fP @
225.1259 -.fi
225.1260 -http://ant.apache.org/manual/using.html#path and can also be set via nested \f2<binding>\fP elements, respectively. Before this task can be used, a \f2<taskdef>\fP element needs to be added to the project as given below:
225.1261 -.LP
225.1262 +.SH "Example"
225.1263 .nf
225.1264 \f3
225.1265 .fl
225.1266 - <taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">\fP
225.1267 +\fP\f3wsimport \-p stockquote http://stockquote.xyz/quote?wsdl\fP
225.1268 +.fl
225.1269 +.fi
225.1270 +.LP
225.1271 +This will generate the Java artifacts and compile them by importing the \f2http://stockquote.xyz/quote?wsdl\fP.
225.1272 .br
225.1273 -\f3
225.1274 -.fl
225.1275 - <classpath path="jaxws.classpath"/>\fP
225.1276 -.br
225.1277 -\f3
225.1278 -.fl
225.1279 - </taskdef>
225.1280 -.fl
225.1281 -\fP
225.1282 -.fi
225.1283 -
225.1284 -.LP
225.1285 -.LP
225.1286 -where \f2jaxws.classpath\fP is a reference to a
225.1287 -.na
225.1288 -\f2path\-like structure\fP @
225.1289 -.fi
225.1290 -http://ant.apache.org/manual/using.html#path, defined elsewhere in the build environment, and contains the list of classes required by the JAX\-WS tools.
225.1291 -.LP
225.1292 -.SH "Examples"
225.1293 -.LP
225.1294 -.nf
225.1295 -\f3
225.1296 -.fl
225.1297 - <wsimport\fP
225.1298 -.br
225.1299 -\f3
225.1300 -.fl
225.1301 - \fP\f4destdir\fP\f3="${build.classes.home}"\fP
225.1302 -.br
225.1303 -\f3
225.1304 -.fl
225.1305 - debug="true"\fP
225.1306 -.br
225.1307 -\f3
225.1308 -.fl
225.1309 - wsdl="AddNumbers.wsdl"\fP
225.1310 -.br
225.1311 -\f3
225.1312 -.fl
225.1313 - binding="custom.xml"/>
225.1314 -.fl
225.1315 -\fP
225.1316 -.fi
225.1317 -
225.1318 -.LP
225.1319 -.LP
225.1320 -The above example generates client\-side artifacts for \f2AddNumbers.wsdl\fP, stores \f2.class\fP files in the \f2${build.classes.home}\fP directory using the \f2custom.xml\fP customization file. The classpath used is \f2xyz.jar\fP and compiles with debug information on.
225.1321 -.LP
225.1322 -.nf
225.1323 -\f3
225.1324 -.fl
225.1325 - <wsimport\fP
225.1326 -.br
225.1327 -\f3
225.1328 -.fl
225.1329 - keep="true"\fP
225.1330 -.br
225.1331 -\f3
225.1332 -.fl
225.1333 - sourcedestdir="${source.dir}"\fP
225.1334 -.br
225.1335 -\f3
225.1336 -.fl
225.1337 - \fP\f4destdir\fP\f3="${build.classes.home}"\fP
225.1338 -.br
225.1339 -\f3
225.1340 -.fl
225.1341 - wsdl="AddNumbers.wsdl">\fP
225.1342 -.br
225.1343 -\f3
225.1344 -.fl
225.1345 - <binding dir="${basedir}/etc" includes="custom.xml"/>\fP
225.1346 -.br
225.1347 -\f3
225.1348 -.fl
225.1349 - </wsimport>
225.1350 -.fl
225.1351 -\fP
225.1352 -.fi
225.1353 -
225.1354 -.LP
225.1355 -.LP
225.1356 -The above example generates portable artifacts for \f2AddNumbers.wsdl\fP, stores \f2.java\fP files in the \f2${source.dir}\fP directory, stores \f2.class\fP files in the \f2${build.classes.home}\fP directory.
225.1357 -.LP
225.1358 -.SH "Notes"
225.1359 -.LP
225.1360 -.LP
225.1361 -Summary of Changed and Removed wsimport ant attributes:
225.1362 -.LP
225.1363 -\f3base\fP replaced by \f3destdir\fP
225.1364 -.br
225.1365 -
225.1366 -.LP
225.1367 -.br
225.1368 -
225.1369 -.LP
225.1370 -\f3sourceBase\fP is replaced by \f3sourcedestdir\fP
225.1371 -.br
225.1372 -
225.1373 -.LP
225.1374 -.br
225.1375 -
225.1376 -.LP
225.1377 -\f3wsdlFile\fP is replaced by \f3wsdl\fP
225.1378 -.br
225.1379 -.br
225.1380 -\f3httpProxy\fP is removed. Use ant's setproxy task instead for proxy configuration.
225.1381 -.br
225.1382 -.br
225.1383 -\f3version\fP is removed
225.1384 -.br
225.1385 -
225.1386 -.LP
225.1387 -
225.1388 -.LP
225.1389
226.1 --- a/src/solaris/doc/sun/man/man1/xjc.1 Tue May 12 15:21:55 2009 +0900
226.2 +++ b/src/solaris/doc/sun/man/man1/xjc.1 Thu May 14 00:17:25 2009 -0700
226.3 @@ -1,5 +1,4 @@
226.4 -.'" t
226.5 -." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
226.6 +." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
226.7 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
226.8 ."
226.9 ." This code is free software; you can redistribute it and/or modify it
226.10 @@ -19,52 +18,38 @@
226.11 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
226.12 ." CA 95054 USA or visit www.sun.com if you need additional information or
226.13 ." have any questions.
226.14 -." `
226.15 -.TH xjc 1 "07 Aug 2006"
226.16 -." Generated by html2man
226.17 +."
226.18 +.TH xjc 1 "04 May 2009"
226.19 +." Generated from HTML by html2man (author: Eric Armstrong)
226.20
226.21 .LP
226.22 .ad c
226.23 -.SH NAME
226.24 +.SH "Name"
226.25 xjc \- Java(TM) Architecture for XML Binding
226.26 .br
226.27 -Binding Compiler \f3Specification Version:\fP 2.0
226.28 +Binding Compiler
226.29 +.LP
226.30 +\f3Specification Version:\fP 2.1
226.31 .br
226.32 -\f3Reference Implementation (RI) Version:\fP 2.0 ea3
226.33 -.br
226.34 -.ad l
226.35 +\f3Reference Implementation (RI) Version:\fP 2.1.3 .ad l
226.36
226.37 .LP
226.38 .SH "Launching xjc"
226.39 .LP
226.40 .LP
226.41 -The binding compiler can be launched using the appropriate \f2xjc\fP shell script in the \f2bin\fP directory for your platform. We also provide an Ant task to run the binding complier \- see the instructions for using xjc with Ant.
226.42 +The binding compiler can be launched using the appropriate \f2xjc\fP shell script in the \f2bin\fP directory for your platform. We also provide an Ant task to run the binding complier \- see the instructions for
226.43 +.na
226.44 +\f2using the XJC Ant task\fP @
226.45 +.fi
226.46 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html.
226.47 .LP
226.48 .RS 3
226.49
226.50 .LP
226.51 -\f3For Solaris/Linux\fP
226.52 .LP
226.53 -.RS 3
226.54 -
226.55 -.LP
226.56 -.LP
226.57 -\f2% /path/to/jaxb/bin/xjc.sh \-help\fP
226.58 +\f2% xjc \-help\fP
226.59 .LP
226.60 .RE
226.61 -\f3For WindowsNT/2000/XP\fP
226.62 -.LP
226.63 -.RS 3
226.64 -
226.65 -.LP
226.66 -.LP
226.67 -\f2> c:\\path\\to\\jaxb\\bin\\xjc.bat \-help\fP
226.68 -.LP
226.69 -.RE
226.70 -.RE
226.71 -.RS 3
226.72 -
226.73 -.LP
226.74 \f3Output\fP
226.75 .LP
226.76 .RS 3
226.77 @@ -83,7 +68,9 @@
226.78 .fl
226.79 Compatibility Rules and App E.2 from the JAXB Spec
226.80 .fl
226.81 - \-b <file> : specify external bindings files (each <file> must have its own \-b)
226.82 + \-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
226.83 +.fl
226.84 + If a directory is given, **/*.xjb is searched
226.85 .fl
226.86 \-d <dir> : generated files will go into this directory
226.87 .fl
226.88 @@ -103,6 +90,10 @@
226.89 .fl
226.90 \-npa : suppress generation of package level annotations (**/package\-info.java)
226.91 .fl
226.92 + \-no\-header : suppress generation of a file header with timestamp
226.93 +.fl
226.94 + \-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
226.95 +.fl
226.96 \-xmlschema : treat input as W3C XML Schema (default)
226.97 .fl
226.98 \-relaxng : treat input as RELAX NG (experimental,unsupported)
226.99 @@ -126,37 +117,6 @@
226.100 .RE
226.101
226.102 .LP
226.103 -.RE
226.104 -.RS 3
226.105 -
226.106 -.LP
226.107 -\f3Execute the jaxb\-xjc.jar JAR File\fP
226.108 -.LP
226.109 -.RS 3
226.110 -
226.111 -.LP
226.112 -.LP
226.113 -If all else fails, you should be able to execute the \f2jaxb\-xjc.jar\fP file:
226.114 -.LP
226.115 -.RS 3
226.116 -
226.117 -.LP
226.118 -.RS 3
226.119 -.TP 3
226.120 -For Solaris/Linux:
226.121 -\f2% java \-jar $JAXB_HOME/lib/jaxb\-xjc.jar \-help\fP
226.122 -.TP 3
226.123 -For Windows:
226.124 -\f2> java \-jar %JAXB_HOME%\\lib\\jaxb\-xjc.jar \-help\fP
226.125 -.RE
226.126 -
226.127 -.LP
226.128 -.RE
226.129 -.LP
226.130 -This is equivalent of running "xjc.sh" or "xjc.bat", and it allows you to set the JVM parameters.
226.131 -.LP
226.132 -.RE
226.133 -.RE
226.134 .SH "OPTIONS"
226.135 .LP
226.136
226.137 @@ -167,10 +127,10 @@
226.138 By default, the XJC binding compiler performs strict validation of the source schema before processing it. Use this option to disable strict schema validation. This does not mean that the binding compiler will not perform any validation, it simply means that it will perform less\-strict validation.
226.139 .TP 3
226.140 \-extension
226.141 -By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions.
226.142 +By default, the XJC binding compiler strictly enforces the rules outlined in the Compatibility chapter of the JAXB Specification. Appendix E.2 defines a set of W3C XML Schema features that are not completely supported by JAXB v1.0. In some cases, you may be allowed to use them in the "\-extension" mode enabled by this switch. In the default (strict) mode, you are also limited to using only the binding customizations defined in the specification. By using the "\-extension" switch, you will be allowed to use the JAXB Vendor Extensions
226.143 .TP 3
226.144 \-b <file>
226.145 -Specify one or more external binding files to process. (Each binding file must have it's own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files:
226.146 +Specify one or more external binding files to process. (Each binding file must have its own \f2"\-b"\fP switch.) The syntax of the external binding files is extremely flexible. You may have a single binding file that contains customizations for multiple schemas or you can break the customizations into multiple bindings files:
226.147 .RS 3
226.148
226.149 .LP
226.150 @@ -204,8 +164,14 @@
226.151 \-npa
226.152 Supress the generation of package level annotations into **/package\-info.java. Using this switch causes the generated code to internalize those annotations into the other generated classes.
226.153 .TP 3
226.154 +\-no\-header
226.155 +Supress the generation of a file header comment that includes some note and timestamp. Using this makes the generated code more diff\-friendly.
226.156 +.TP 3
226.157 +\-target 2.0
226.158 +Avoid generating code that relies on any JAXB 2.1 features. This will allow the generated code to run with JAXB 2.0 runtime (such as JavaSE 6.)
226.159 +.TP 3
226.160 \-xmlschema
226.161 -treat input schemas as W3C XML Schema (default). If you do not specify this switch, your input schemas will be treated as W3C XML Schema.
226.162 +Treat input schemas as W3C XML Schema (default). If you do not specify this switch, your input schemas will be treated as W3C XML Schema.
226.163 .TP 3
226.164 \-relaxng
226.165 Treat input schemas as RELAX NG (experimental, unsupported). Support for RELAX NG schemas is provided as a JAXB Vendor Extension.
226.166 @@ -220,10 +186,10 @@
226.167 Treat input as WSDL and compile schemas inside it (experimental,unsupported).
226.168 .TP 3
226.169 \-quiet
226.170 -Suppress compiler output, such as progress information and warnings..
226.171 +Suppress compiler output, such as progress information and warnings.
226.172 .TP 3
226.173 \-verbose
226.174 -Be extra verbose, such as printing informational messages or displaying stack traces upon some errors..
226.175 +Be extra verbose, such as printing informational messages or displaying stack traces upon some errors.
226.176 .TP 3
226.177 \-help
226.178 Display a brief summary of the compiler switches.
226.179 @@ -301,138 +267,24 @@
226.180 .RS 3
226.181 .TP 2
226.182 o
226.183 -JAXB 2.0:
226.184 -.RS 3
226.185 -.TP 2
226.186 -*
226.187 +Running the binding compiler (XJC): [
226.188 .na
226.189 -\f2Release Notes\fP @
226.190 +\f2command\-line instructions\fP @
226.191 .fi
226.192 -http://java.sun.com/webservices/docs/2.0/jaxb/ReleaseNotes.html
226.193 -.TP 2
226.194 -*
226.195 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html,
226.196 .na
226.197 -\f2XJC\fP @
226.198 +\f2using the XJC Ant task\fP @
226.199 .fi
226.200 -http://java.sun.com/webservices/docs/2.0/jaxb/xjc.html
226.201 -.TP 2
226.202 -*
226.203 -.na
226.204 -\f2XJCTask\fP @
226.205 -.fi
226.206 -http://java.sun.com/webservices/docs/2.0/jaxb/xjcTask.html
226.207 -.TP 2
226.208 -*
226.209 -.na
226.210 -\f2SchemaGen\fP @
226.211 -.fi
226.212 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagen.html
226.213 -.TP 2
226.214 -*
226.215 -.na
226.216 -\f2schemagenTask\fP @
226.217 -.fi
226.218 -http://java.sun.com/webservices/docs/2.0/jaxb/schemagenTask.html
226.219 -.TP 2
226.220 -*
226.221 -.na
226.222 -\f2Sample Apps\fP @
226.223 -.fi
226.224 -http://java.sun.com/webservices/docs/2.0/jaxb/samples.html
226.225 -.TP 2
226.226 -*
226.227 -.na
226.228 -\f2Changelog\fP @
226.229 -.fi
226.230 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog2.html
226.231 -.RE
226.232 +https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
226.233 .TP 2
226.234 o
226.235 -JAXB 1.0.x:
226.236 -.RS 3
226.237 -.TP 2
226.238 -*
226.239 .na
226.240 -\f2Release Notes\fP @
226.241 +\f2Java Architecture for XML Binding (JAXB)\fP @
226.242 .fi
226.243 -http://java.sun.com/webservices/docs/2.0/jaxb/jaxb\-1_0.html
226.244 -.TP 2
226.245 -*
226.246 -.na
226.247 -\f2Changelog\fP @
226.248 -.fi
226.249 -http://java.sun.com/webservices/docs/2.0/jaxb/changelog.html
226.250 -.RE
226.251 -.TP 2
226.252 -o
226.253 -JAXB RI Extensions:
226.254 -.RS 3
226.255 -.TP 2
226.256 -*
226.257 -.na
226.258 -\f2Runtime Properties\fP @
226.259 -.fi
226.260 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorProperties.html
226.261 -.TP 2
226.262 -*
226.263 -.na
226.264 -\f2XJC Customizations\fP @
226.265 -.fi
226.266 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorCustomizations.html
226.267 -.TP 2
226.268 -*
226.269 -.na
226.270 -\f2Develop Plugins\fP @
226.271 -.fi
226.272 -http://java.sun.com/webservices/docs/2.0/jaxb/developPlugins.html
226.273 -.RE
226.274 -.TP 2
226.275 -o
226.276 -JAXB RI Schema Languages:
226.277 -.RS 3
226.278 -.TP 2
226.279 -*
226.280 -.na
226.281 -\f2W3C XML Schema\fP @
226.282 -.fi
226.283 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#xschema
226.284 -.TP 2
226.285 -*
226.286 -.na
226.287 -\f2RELAX NG\fP @
226.288 -.fi
226.289 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#relaxng
226.290 -.TP 2
226.291 -*
226.292 -.na
226.293 -\f2DTD\fP @
226.294 -.fi
226.295 -http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#dtd
226.296 -.RE
226.297 -.TP 2
226.298 -o
226.299 -JAXB Community:
226.300 -.RS 3
226.301 -.TP 2
226.302 -*
226.303 -.na
226.304 -\f2Java.net Homepage\fP @
226.305 -.fi
226.306 -http://jaxb.dev.java.net
226.307 -.TP 2
226.308 -*
226.309 -.na
226.310 -\f2Developer interest list\fP @
226.311 -.fi
226.312 -https://jaxb.dev.java.net/servlets/ProjectMailingListList
226.313 -.TP 2
226.314 -*
226.315 -.na
226.316 -\f2FAQ\fP @
226.317 -.fi
226.318 -https://jaxb.dev.java.net/faq/index.html
226.319 -.RE
226.320 +http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
226.321 .RE
226.322
226.323 .LP
226.324 +
226.325 +.LP
226.326
227.1 --- a/src/windows/classes/sun/nio/ch/WindowsAsynchronousSocketChannelImpl.java Tue May 12 15:21:55 2009 +0900
227.2 +++ b/src/windows/classes/sun/nio/ch/WindowsAsynchronousSocketChannelImpl.java Thu May 14 00:17:25 2009 -0700
227.3 @@ -475,49 +475,40 @@
227.4 // get an OVERLAPPED structure (from the cache or allocate)
227.5 overlapped = ioCache.add(result);
227.6
227.7 - // synchronize on result to allow this thread handle the case
227.8 - // where the read completes immediately.
227.9 - synchronized (result) {
227.10 - int n = read0(handle, numBufs, readBufferArray, overlapped);
227.11 - if (n == IOStatus.UNAVAILABLE) {
227.12 - // I/O is pending
227.13 - pending = true;
227.14 - return;
227.15 + // initiate read
227.16 + int n = read0(handle, numBufs, readBufferArray, overlapped);
227.17 + if (n == IOStatus.UNAVAILABLE) {
227.18 + // I/O is pending
227.19 + pending = true;
227.20 + return;
227.21 + }
227.22 + if (n == IOStatus.EOF) {
227.23 + // input shutdown
227.24 + enableReading();
227.25 + if (scatteringRead) {
227.26 + result.setResult((V)Long.valueOf(-1L));
227.27 + } else {
227.28 + result.setResult((V)Integer.valueOf(-1));
227.29 }
227.30 - // read completed immediately:
227.31 - // 1. update buffer position
227.32 - // 2. reset read flag
227.33 - // 3. release waiters
227.34 - if (n == 0) {
227.35 - n = -1;
227.36 - } else {
227.37 - updateBuffers(n);
227.38 - }
227.39 - enableReading();
227.40 -
227.41 - if (scatteringRead) {
227.42 - result.setResult((V)Long.valueOf(n));
227.43 - } else {
227.44 - result.setResult((V)Integer.valueOf(n));
227.45 - }
227.46 + } else {
227.47 + throw new InternalError("Read completed immediately");
227.48 }
227.49 } catch (Throwable x) {
227.50 - // failed to initiate read:
227.51 - // 1. reset read flag
227.52 - // 2. free resources
227.53 - // 3. release waiters
227.54 + // failed to initiate read
227.55 + // reset read flag before releasing waiters
227.56 enableReading();
227.57 - if (overlapped != 0L)
227.58 - ioCache.remove(overlapped);
227.59 if (x instanceof ClosedChannelException)
227.60 x = new AsynchronousCloseException();
227.61 if (!(x instanceof IOException))
227.62 x = new IOException(x);
227.63 result.setFailure(x);
227.64 } finally {
227.65 - if (prepared && !pending) {
227.66 - // return direct buffer(s) to cache if substituted
227.67 - releaseBuffers();
227.68 + // release resources if I/O not pending
227.69 + if (!pending) {
227.70 + if (overlapped != 0L)
227.71 + ioCache.remove(overlapped);
227.72 + if (prepared)
227.73 + releaseBuffers();
227.74 }
227.75 end();
227.76 }
227.77 @@ -721,7 +712,6 @@
227.78 @Override
227.79 @SuppressWarnings("unchecked")
227.80 public void run() {
227.81 - int n = -1;
227.82 long overlapped = 0L;
227.83 boolean prepared = false;
227.84 boolean pending = false;
227.85 @@ -736,56 +726,34 @@
227.86
227.87 // get an OVERLAPPED structure (from the cache or allocate)
227.88 overlapped = ioCache.add(result);
227.89 -
227.90 - // synchronize on result to allow this thread handle the case
227.91 - // where the read completes immediately.
227.92 - synchronized (result) {
227.93 - n = write0(handle, numBufs, writeBufferArray, overlapped);
227.94 - if (n == IOStatus.UNAVAILABLE) {
227.95 - // I/O is pending
227.96 - pending = true;
227.97 - return;
227.98 - }
227.99 -
227.100 - enableWriting();
227.101 -
227.102 - if (n == IOStatus.EOF) {
227.103 - // special case for shutdown output
227.104 - shutdown = true;
227.105 - throw new ClosedChannelException();
227.106 - }
227.107 -
227.108 - // write completed immediately:
227.109 - // 1. enable writing
227.110 - // 2. update buffer position
227.111 - // 3. release waiters
227.112 - updateBuffers(n);
227.113 -
227.114 - // result is a Long or Integer
227.115 - if (gatheringWrite) {
227.116 - result.setResult((V)Long.valueOf(n));
227.117 - } else {
227.118 - result.setResult((V)Integer.valueOf(n));
227.119 - }
227.120 + int n = write0(handle, numBufs, writeBufferArray, overlapped);
227.121 + if (n == IOStatus.UNAVAILABLE) {
227.122 + // I/O is pending
227.123 + pending = true;
227.124 + return;
227.125 }
227.126 + if (n == IOStatus.EOF) {
227.127 + // special case for shutdown output
227.128 + shutdown = true;
227.129 + throw new ClosedChannelException();
227.130 + }
227.131 + // write completed immediately
227.132 + throw new InternalError("Write completed immediately");
227.133 } catch (Throwable x) {
227.134 + // write failed. Enable writing before releasing waiters.
227.135 enableWriting();
227.136 -
227.137 - // failed to initiate read:
227.138 if (!shutdown && (x instanceof ClosedChannelException))
227.139 x = new AsynchronousCloseException();
227.140 if (!(x instanceof IOException))
227.141 x = new IOException(x);
227.142 result.setFailure(x);
227.143 -
227.144 - // release resources
227.145 - if (overlapped != 0L)
227.146 - ioCache.remove(overlapped);
227.147 -
227.148 } finally {
227.149 - if (prepared && !pending) {
227.150 - // return direct buffer(s) to cache if substituted
227.151 - releaseBuffers();
227.152 + // release resources if I/O not pending
227.153 + if (!pending) {
227.154 + if (overlapped != 0L)
227.155 + ioCache.remove(overlapped);
227.156 + if (prepared)
227.157 + releaseBuffers();
227.158 }
227.159 end();
227.160 }
228.1 --- a/src/windows/native/sun/nio/ch/WindowsAsynchronousSocketChannelImpl.c Tue May 12 15:21:55 2009 +0900
228.2 +++ b/src/windows/native/sun/nio/ch/WindowsAsynchronousSocketChannelImpl.c Thu May 14 00:17:25 2009 -0700
228.3 @@ -157,14 +157,13 @@
228.4 WSABUF* lpWsaBuf = (WSABUF*) jlong_to_ptr(address);
228.5 OVERLAPPED* lpOverlapped = (OVERLAPPED*) jlong_to_ptr(ov);
228.6 BOOL res;
228.7 - DWORD nread = 0;
228.8 DWORD flags = 0;
228.9
228.10 ZeroMemory((PVOID)lpOverlapped, sizeof(OVERLAPPED));
228.11 res = WSARecv(s,
228.12 lpWsaBuf,
228.13 (DWORD)count,
228.14 - &nread,
228.15 + NULL,
228.16 &flags,
228.17 lpOverlapped,
228.18 NULL);
228.19 @@ -175,17 +174,12 @@
228.20 return IOS_UNAVAILABLE;
228.21 }
228.22 if (error == WSAESHUTDOWN) {
228.23 - return 0; // input shutdown
228.24 + return IOS_EOF; // input shutdown
228.25 }
228.26 JNU_ThrowIOExceptionWithLastError(env, "WSARecv failed");
228.27 return IOS_THROWN;
228.28 }
228.29 - if (nread == 0) {
228.30 - // Handle graceful close or bytes not yet available cases
228.31 - // via completion port notification.
228.32 - return IOS_UNAVAILABLE;
228.33 - }
228.34 - return (jint)nread;
228.35 + return IOS_UNAVAILABLE;
228.36 }
228.37
228.38 JNIEXPORT jint JNICALL
228.39 @@ -196,13 +190,12 @@
228.40 WSABUF* lpWsaBuf = (WSABUF*) jlong_to_ptr(address);
228.41 OVERLAPPED* lpOverlapped = (OVERLAPPED*) jlong_to_ptr(ov);
228.42 BOOL res;
228.43 - DWORD nwritten;
228.44
228.45 ZeroMemory((PVOID)lpOverlapped, sizeof(OVERLAPPED));
228.46 res = WSASend(s,
228.47 lpWsaBuf,
228.48 (DWORD)count,
228.49 - &nwritten,
228.50 + NULL,
228.51 0,
228.52 lpOverlapped,
228.53 NULL);
228.54 @@ -218,5 +211,5 @@
228.55 JNU_ThrowIOExceptionWithLastError(env, "WSASend failed");
228.56 return IOS_THROWN;
228.57 }
228.58 - return (jint)nwritten;
228.59 + return IOS_UNAVAILABLE;
228.60 }
229.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
229.2 +++ b/test/java/awt/FullScreen/TranslucentWindow/TranslucentWindow.java Thu May 14 00:17:25 2009 -0700
229.3 @@ -0,0 +1,83 @@
229.4 +/*
229.5 + * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
229.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
229.7 + *
229.8 + * This code is free software; you can redistribute it and/or modify it
229.9 + * under the terms of the GNU General Public License version 2 only, as
229.10 + * published by the Free Software Foundation.
229.11 + *
229.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
229.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
229.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
229.15 + * version 2 for more details (a copy is included in the LICENSE file that
229.16 + * accompanied this code).
229.17 + *
229.18 + * You should have received a copy of the GNU General Public License version
229.19 + * 2 along with this work; if not, write to the Free Software Foundation,
229.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
229.21 + *
229.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
229.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
229.24 + * have any questions.
229.25 + */
229.26 +
229.27 +/*
229.28 + * @test
229.29 + * @bug 6837004
229.30 + * @summary Checks that non-opaque window can be made a fullscreen window
229.31 + * @author Artem Ananiev
229.32 + * @run main TranslucentWindow
229.33 + */
229.34 +
229.35 +import java.awt.*;
229.36 +import java.awt.geom.*;
229.37 +
229.38 +import static java.awt.GraphicsDevice.WindowTranslucency.*;
229.39 +
229.40 +import sun.awt.SunToolkit;
229.41 +
229.42 +public class TranslucentWindow {
229.43 + public static void main(String args[]) {
229.44 + GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
229.45 + GraphicsDevice gd = ge.getDefaultScreenDevice();
229.46 +
229.47 + Frame f = new Frame("Test frame");
229.48 + f.setBounds(100, 100, 320, 240);
229.49 +
229.50 + // First, check it can be made fullscreen window without any effects applied
229.51 + gd.setFullScreenWindow(f);
229.52 + ((SunToolkit)Toolkit.getDefaultToolkit()).realSync();
229.53 +
229.54 + gd.setFullScreenWindow(null);
229.55 + ((SunToolkit)Toolkit.getDefaultToolkit()).realSync();
229.56 +
229.57 + // Second, check if it applying any effects doesn't prevent the window
229.58 + // from going into the fullscreen mode
229.59 + if (gd.isWindowTranslucencySupported(PERPIXEL_TRANSPARENT)) {
229.60 + f.setShape(new Ellipse2D.Float(0, 0, f.getWidth(), f.getHeight()));
229.61 + }
229.62 + if (gd.isWindowTranslucencySupported(TRANSLUCENT)) {
229.63 + f.setOpacity(0.5f);
229.64 + }
229.65 + if (gd.isWindowTranslucencySupported(PERPIXEL_TRANSLUCENT)) {
229.66 + f.setBackground(new Color(0, 0, 0, 128));
229.67 + }
229.68 + gd.setFullScreenWindow(f);
229.69 + ((SunToolkit)Toolkit.getDefaultToolkit()).realSync();
229.70 +
229.71 + // Third, make sure all the effects are unset when entering the fullscreen mode
229.72 + if (f.getShape() != null) {
229.73 + throw new RuntimeException("Test FAILED: fullscreen window shape is not null");
229.74 + }
229.75 + if (Math.abs(f.getOpacity() - 1.0f) > 1e-4) {
229.76 + throw new RuntimeException("Test FAILED: fullscreen window opacity is not 1.0f");
229.77 + }
229.78 + Color bgColor = f.getBackground();
229.79 + if ((bgColor != null) && (bgColor.getAlpha() != 255)) {
229.80 + throw new RuntimeException("Test FAILED: fullscreen window background color is not opaque");
229.81 + }
229.82 +
229.83 + f.dispose();
229.84 + System.out.println("Test PASSED");
229.85 + }
229.86 +}
230.1 --- a/test/java/awt/PrintJob/EdgeTest/EdgeTest.java Tue May 12 15:21:55 2009 +0900
230.2 +++ b/test/java/awt/PrintJob/EdgeTest/EdgeTest.java Thu May 14 00:17:25 2009 -0700
230.3 @@ -27,6 +27,7 @@
230.4 * @summary Verifies that (0, 0) is the upper-left corner of the page, not
230.5 * the upper-left corner adjusted for the margins.
230.6 * @author dpm
230.7 + * @run main/manual EdgeTest
230.8 */
230.9
230.10 import java.awt.*;
230.11 @@ -43,7 +44,9 @@
230.12 }
230.13 );
230.14 f.setVisible(true);
230.15 - PrintJob pj = getToolkit().getPrintJob(f, "EdgeTest", null);
230.16 + JobAttributes job = new JobAttributes();
230.17 + job.setDialog(JobAttributes.DialogType.NONE);
230.18 + PrintJob pj = getToolkit().getPrintJob(f, "EdgeTest", job, null);
230.19 if (pj != null) {
230.20 Graphics g = pj.getGraphics();
230.21 Dimension d = pj.getPageDimension();
231.1 --- a/test/java/awt/PrintJob/MultipleEnd/MultipleEnd.java Tue May 12 15:21:55 2009 +0900
231.2 +++ b/test/java/awt/PrintJob/MultipleEnd/MultipleEnd.java Thu May 14 00:17:25 2009 -0700
231.3 @@ -44,7 +44,10 @@
231.4 public MultipleEndFrame() {
231.5 super("MultipleEnd");
231.6 setVisible(true);
231.7 - PrintJob pj = getToolkit().getPrintJob(this, "MuiltipleEnd", null);
231.8 +
231.9 + JobAttributes job = new JobAttributes();
231.10 + job.setDialog(JobAttributes.DialogType.NONE);
231.11 + PrintJob pj = getToolkit().getPrintJob(this, "MultipleEnd", job, null);
231.12 if (pj != null) {
231.13 pj.end();
231.14 pj.end();
232.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
232.2 +++ b/test/java/awt/print/PrinterJob/Collate2DPrintingTest.java Thu May 14 00:17:25 2009 -0700
232.3 @@ -0,0 +1,252 @@
232.4 +/*
232.5 + * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
232.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
232.7 + *
232.8 + * This code is free software; you can redistribute it and/or modify it
232.9 + * under the terms of the GNU General Public License version 2 only, as
232.10 + * published by the Free Software Foundation.
232.11 + *
232.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
232.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
232.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
232.15 + * version 2 for more details (a copy is included in the LICENSE file that
232.16 + * accompanied this code).
232.17 + *
232.18 + * You should have received a copy of the GNU General Public License version
232.19 + * 2 along with this work; if not, write to the Free Software Foundation,
232.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
232.21 + *
232.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
232.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
232.24 + * have any questions.
232.25 + */
232.26 +
232.27 +/**
232.28 + * @test
232.29 + * @bug 6362683
232.30 + * @summary Collation should work.
232.31 + * @run main/manual Collate2DPrintingTest
232.32 + */
232.33 +import java.awt.*;
232.34 +import java.awt.event.*;
232.35 +import java.awt.print.*;
232.36 +import javax.print.attribute.standard.*;
232.37 +import javax.print.attribute.*;
232.38 +import javax.print.*;
232.39 +import java.io.*;
232.40 +
232.41 +public class Collate2DPrintingTest
232.42 + extends Frame implements Doc, Printable, ActionListener {
232.43 +
232.44 + Button print2D = new Button("2D Print");
232.45 + Button printMerlin = new Button("PrintService");
232.46 + PrinterJob pj = PrinterJob.getPrinterJob();
232.47 + PrintService defService = null;
232.48 + HashPrintRequestAttributeSet prSet = new HashPrintRequestAttributeSet();
232.49 +
232.50 + public Collate2DPrintingTest() {
232.51 +
232.52 + Panel butPanel = new Panel();
232.53 + butPanel.add(print2D);
232.54 + butPanel.add(printMerlin);
232.55 + print2D.addActionListener(this);
232.56 + printMerlin.addActionListener(this);
232.57 + addWindowListener (new WindowAdapter() {
232.58 + public void windowClosing (WindowEvent e) {
232.59 + dispose();
232.60 + }
232.61 + });
232.62 + add("South", butPanel);
232.63 +
232.64 + defService = PrintServiceLookup.lookupDefaultPrintService();
232.65 + PrintService[] pservice;
232.66 + if (defService == null) {
232.67 + pservice = PrintServiceLookup.lookupPrintServices(null, null);
232.68 + if (pservice.length == 0) {
232.69 + throw new RuntimeException("No printer found. TEST ABORTED");
232.70 + }
232.71 + defService = pservice[0];
232.72 + }
232.73 + prSet.add(SheetCollate.COLLATED);
232.74 + prSet.add(new Copies(2));
232.75 + pj.setPrintable(Collate2DPrintingTest.this);
232.76 + setSize(300, 200);
232.77 + setVisible(true);
232.78 + }
232.79 +
232.80 +
232.81 + public int print(Graphics g, PageFormat pf, int pageIndex)
232.82 + throws PrinterException {
232.83 + g.drawString("Page: " + pageIndex, 100, 100);
232.84 + if (pageIndex == 2) {
232.85 + return Printable.NO_SUCH_PAGE;
232.86 + } else {
232.87 + return Printable.PAGE_EXISTS;
232.88 + }
232.89 + }
232.90 +
232.91 + public void actionPerformed (ActionEvent ae) {
232.92 + try {
232.93 + if (ae.getSource() == print2D) {
232.94 + if (pj.printDialog(prSet)) {
232.95 + pj.print(prSet);
232.96 + }
232.97 + } else {
232.98 + DocPrintJob pj = defService.createPrintJob();
232.99 + pj.print(this, prSet);
232.100 + }
232.101 + System.out.println ("DONE");
232.102 + } catch (Exception e) {
232.103 + e.printStackTrace();
232.104 + }
232.105 + }
232.106 +
232.107 + public DocAttributeSet getAttributes() {
232.108 + return null;
232.109 + }
232.110 +
232.111 + public DocFlavor getDocFlavor() {
232.112 + DocFlavor flavor = DocFlavor.SERVICE_FORMATTED.PRINTABLE;
232.113 + return flavor;
232.114 + }
232.115 +
232.116 + public Object getPrintData() {
232.117 + return this;
232.118 + }
232.119 +
232.120 + public Reader getReaderForText() {
232.121 + return null;
232.122 + }
232.123 +
232.124 + public InputStream getStreamForBytes() {
232.125 + return null;
232.126 + }
232.127 +
232.128 + public static void main( String[] args) {
232.129 +
232.130 + String[] instructions =
232.131 + {
232.132 + "You must have a printer available to perform this test",
232.133 + "The print result should be collated."
232.134 + };
232.135 + Sysout.createDialog( );
232.136 + Sysout.printInstructions( instructions );
232.137 +
232.138 + new Collate2DPrintingTest();
232.139 + }
232.140 +}
232.141 +
232.142 +
232.143 +class Sysout {
232.144 + private static TestDialog dialog;
232.145 +
232.146 + public static void createDialogWithInstructions( String[] instructions )
232.147 + {
232.148 + dialog = new TestDialog( new Frame(), "Instructions" );
232.149 + dialog.printInstructions( instructions );
232.150 + dialog.setVisible(true);
232.151 + println( "Any messages for the tester will display here." );
232.152 + }
232.153 +
232.154 + public static void createDialog( )
232.155 + {
232.156 + dialog = new TestDialog( new Frame(), "Instructions" );
232.157 + String[] defInstr = { "Instructions will appear here. ", "" } ;
232.158 + dialog.printInstructions( defInstr );
232.159 + dialog.setVisible(true);
232.160 + println( "Any messages for the tester will display here." );
232.161 + }
232.162 +
232.163 +
232.164 + public static void printInstructions( String[] instructions )
232.165 + {
232.166 + dialog.printInstructions( instructions );
232.167 + }
232.168 +
232.169 +
232.170 + public static void println( String messageIn )
232.171 + {
232.172 + dialog.displayMessage( messageIn );
232.173 + }
232.174 +
232.175 +}// Sysout class
232.176 +
232.177 +/**
232.178 + This is part of the standard test machinery. It provides a place for the
232.179 + test instructions to be displayed, and a place for interactive messages
232.180 + to the user to be displayed.
232.181 + To have the test instructions displayed, see Sysout.
232.182 + To have a message to the user be displayed, see Sysout.
232.183 + Do not call anything in this dialog directly.
232.184 + */
232.185 +class TestDialog extends Dialog {
232.186 +
232.187 + TextArea instructionsText;
232.188 + TextArea messageText;
232.189 + int maxStringLength = 80;
232.190 +
232.191 + //DO NOT call this directly, go through Sysout
232.192 + public TestDialog( Frame frame, String name )
232.193 + {
232.194 + super( frame, name );
232.195 + int scrollBoth = TextArea.SCROLLBARS_BOTH;
232.196 + instructionsText = new TextArea( "", 15, maxStringLength, scrollBoth );
232.197 + add( "North", instructionsText );
232.198 +
232.199 + messageText = new TextArea( "", 5, maxStringLength, scrollBoth );
232.200 + add("Center", messageText);
232.201 +
232.202 + pack();
232.203 +
232.204 + setVisible(true);
232.205 + }// TestDialog()
232.206 +
232.207 + //DO NOT call this directly, go through Sysout
232.208 + public void printInstructions( String[] instructions )
232.209 + {
232.210 + //Clear out any current instructions
232.211 + instructionsText.setText( "" );
232.212 +
232.213 + //Go down array of instruction strings
232.214 +
232.215 + String printStr, remainingStr;
232.216 + for( int i=0; i < instructions.length; i++ )
232.217 + {
232.218 + //chop up each into pieces maxSringLength long
232.219 + remainingStr = instructions[ i ];
232.220 + while( remainingStr.length() > 0 )
232.221 + {
232.222 + //if longer than max then chop off first max chars to print
232.223 + if( remainingStr.length() >= maxStringLength )
232.224 + {
232.225 + //Try to chop on a word boundary
232.226 + int posOfSpace = remainingStr.
232.227 + lastIndexOf( ' ', maxStringLength - 1 );
232.228 +
232.229 + if( posOfSpace <= 0 ) posOfSpace = maxStringLength - 1;
232.230 +
232.231 + printStr = remainingStr.substring( 0, posOfSpace + 1 );
232.232 + remainingStr = remainingStr.substring( posOfSpace + 1 );
232.233 + }
232.234 + //else just print
232.235 + else
232.236 + {
232.237 + printStr = remainingStr;
232.238 + remainingStr = "";
232.239 + }
232.240 +
232.241 + instructionsText.append( printStr + "\n" );
232.242 +
232.243 + }// while
232.244 +
232.245 + }// for
232.246 +
232.247 + }//printInstructions()
232.248 +
232.249 + //DO NOT call this directly, go through Sysout
232.250 + public void displayMessage( String messageIn )
232.251 + {
232.252 + messageText.append( messageIn + "\n" );
232.253 + }
232.254 +
232.255 + }// TestDialog class
233.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
233.2 +++ b/test/java/awt/print/PrinterJob/PrtException.java Thu May 14 00:17:25 2009 -0700
233.3 @@ -0,0 +1,78 @@
233.4 +/*
233.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
233.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
233.7 + *
233.8 + * This code is free software; you can redistribute it and/or modify it
233.9 + * under the terms of the GNU General Public License version 2 only, as
233.10 + * published by the Free Software Foundation.
233.11 + *
233.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
233.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
233.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
233.15 + * version 2 for more details (a copy is included in the LICENSE file that
233.16 + * accompanied this code).
233.17 + *
233.18 + * You should have received a copy of the GNU General Public License version
233.19 + * 2 along with this work; if not, write to the Free Software Foundation,
233.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
233.21 + *
233.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
233.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
233.24 + * have any questions.
233.25 + */
233.26 +/*
233.27 + @test
233.28 + @bug 4429544
233.29 + @summary This test should not throw a printer exception. Test has been modified to correspond with the behavior of 1.5 and above.
233.30 + @run main PrtException
233.31 +*/
233.32 +
233.33 +import java.awt.*;
233.34 +import java.awt.print.*;
233.35 +import javax.print.*;
233.36 +
233.37 +public class PrtException implements Printable {
233.38 + PrinterJob pj;
233.39 +
233.40 + public PrtException() {
233.41 +
233.42 + try{
233.43 + PrintService[] svc;
233.44 + PrintService defService = PrintServiceLookup.lookupDefaultPrintService();
233.45 + if (defService == null) {
233.46 + svc = PrintServiceLookup.lookupPrintServices(DocFlavor.SERVICE_FORMATTED.PRINTABLE, null);
233.47 + if (svc.length == 0) {
233.48 + throw new RuntimeException("Printer is required for this test. TEST ABORTED");
233.49 + }
233.50 + defService = svc[0];
233.51 + }
233.52 +
233.53 + System.out.println("PrintService found : "+defService);
233.54 + pj = PrinterJob.getPrinterJob();;
233.55 + pj.setPrintService(defService);
233.56 + //pj.setPrintable(this); // commenting this line should not result in PrinterException
233.57 + pj.print();
233.58 + } catch(PrinterException e ) {
233.59 + e.printStackTrace();
233.60 + throw new RuntimeException(" PrinterException should not be thrown. TEST FAILED");
233.61 + }
233.62 + System.out.println("TEST PASSED");
233.63 + }
233.64 +
233.65 +
233.66 + public int print(Graphics g,PageFormat pf,int pageIndex) {
233.67 + Graphics2D g2= (Graphics2D)g;
233.68 + if(pageIndex>=1){
233.69 + return Printable.NO_SUCH_PAGE;
233.70 + }
233.71 + g2.translate(pf.getImageableX(), pf.getImageableY());
233.72 + g2.setColor(Color.black);
233.73 + g2.drawString("Hello world.", 10, 10);
233.74 +
233.75 + return Printable.PAGE_EXISTS;
233.76 + }
233.77 +
233.78 + public static void main(String arg[]) {
233.79 + PrtException sp = new PrtException();
233.80 + }
233.81 +}
234.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
234.2 +++ b/test/java/lang/Runtime/shutdown/ShutdownHooks.java Thu May 14 00:17:25 2009 -0700
234.3 @@ -0,0 +1,69 @@
234.4 +/*
234.5 + * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
234.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
234.7 + *
234.8 + * This code is free software; you can redistribute it and/or modify it
234.9 + * under the terms of the GNU General Public License version 2 only, as
234.10 + * published by the Free Software Foundation.
234.11 + *
234.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
234.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
234.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
234.15 + * version 2 for more details (a copy is included in the LICENSE file that
234.16 + * accompanied this code).
234.17 + *
234.18 + * You should have received a copy of the GNU General Public License version
234.19 + * 2 along with this work; if not, write to the Free Software Foundation,
234.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
234.21 + *
234.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
234.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
234.24 + * have any questions.
234.25 + */
234.26 +
234.27 +/*
234.28 + * @bug 6829503
234.29 + * @summary 1) Test Console and DeleteOnExitHook can be initialized
234.30 + * while shutdown is in progress
234.31 + * 2) Test if files that are added by the application shutdown
234.32 + * hook are deleted on exit during shutdown
234.33 + */
234.34 +import java.io.*;
234.35 +public class ShutdownHooks {
234.36 + private static File file;
234.37 + public static void main(String[] args) throws Exception {
234.38 + if (args.length != 2) {
234.39 + throw new IllegalArgumentException("Usage: ShutdownHooks <dir> <filename>");
234.40 + }
234.41 +
234.42 + // Add a shutdown hook
234.43 + Runtime.getRuntime().addShutdownHook(new Cleaner());
234.44 +
234.45 + File dir = new File(args[0]);
234.46 + file = new File(dir, args[1]);
234.47 + // write to file
234.48 + System.out.println("writing to "+ file);
234.49 + PrintWriter pw = new PrintWriter(file);
234.50 + pw.println("Shutdown begins");
234.51 + pw.close();
234.52 + }
234.53 +
234.54 + public static class Cleaner extends Thread {
234.55 + public void run() {
234.56 + // register the Console's shutdown hook while the application
234.57 + // shutdown hook is running
234.58 + Console cons = System.console();
234.59 + // register the DeleteOnExitHook while the application
234.60 + // shutdown hook is running
234.61 + file.deleteOnExit();
234.62 + try {
234.63 + PrintWriter pw = new PrintWriter(file);
234.64 + pw.println("file is being deleted");
234.65 + pw.close();
234.66 + } catch (FileNotFoundException e) {
234.67 + throw new RuntimeException(e);
234.68 + }
234.69 + }
234.70 + }
234.71 +
234.72 +}
235.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
235.2 +++ b/test/java/lang/Runtime/shutdown/ShutdownHooks.sh Thu May 14 00:17:25 2009 -0700
235.3 @@ -0,0 +1,57 @@
235.4 +#!/bin/sh
235.5 +
235.6 +#
235.7 +# Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
235.8 +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
235.9 +#
235.10 +# This code is free software; you can redistribute it and/or modify it
235.11 +# under the terms of the GNU General Public License version 2 only, as
235.12 +# published by the Free Software Foundation.
235.13 +#
235.14 +# This code is distributed in the hope that it will be useful, but WITHOUT
235.15 +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
235.16 +# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
235.17 +# version 2 for more details (a copy is included in the LICENSE file that
235.18 +# accompanied this code).
235.19 +#
235.20 +# You should have received a copy of the GNU General Public License version
235.21 +# 2 along with this work; if not, write to the Free Software Foundation,
235.22 +# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
235.23 +#
235.24 +# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
235.25 +# CA 95054 USA or visit www.sun.com if you need additional information or
235.26 +# have any questions.
235.27 +#
235.28 +
235.29 +
235.30 +# @test
235.31 +# @bug 6829503
235.32 +# @summary 1) Test Console and DeleteOnExitHook can be initialized
235.33 +# while shutdown is in progress
235.34 +# 2) Test if files that are added by the application shutdown
235.35 +# hook are deleted on exit during shutdown
235.36 +#
235.37 +# @build ShutdownHooks
235.38 +# @run shell ShutdownHooks.sh
235.39 +
235.40 +if [ "${TESTJAVA}" = "" ]
235.41 +then
235.42 + echo "TESTJAVA not set. Test cannot execute. Failed."
235.43 + exit 1
235.44 +fi
235.45 +
235.46 +FILENAME=fileToBeDeleted
235.47 +rm -f ${TESTCLASSES}/${FILENAME}
235.48 +
235.49 +# create the file to be deleted on exit
235.50 +echo "testing shutdown" > ${TESTCLASSES}/${FILENAME}
235.51 +
235.52 +${TESTJAVA}/bin/java ${TESTVMOPTS} -classpath ${TESTCLASSES} ShutdownHooks ${TESTCLASSES} $FILENAME
235.53 +if [ $? != 0 ] ; then
235.54 + echo "Test Failed"; exit 1
235.55 +fi
235.56 +
235.57 +if [ -f ${TESTCLASSES}/${FILENAME} ]; then
235.58 + echo "Test Failed: ${TESTCLASSES}/${FILENAME} not deleted"; exit 2
235.59 +fi
235.60 +echo "ShutdownHooks test passed.";
236.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
236.2 +++ b/test/java/nio/channels/AsynchronousSocketChannel/StressLoopback.java Thu May 14 00:17:25 2009 -0700
236.3 @@ -0,0 +1,183 @@
236.4 +/*
236.5 + * Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
236.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
236.7 + *
236.8 + * This code is free software; you can redistribute it and/or modify it
236.9 + * under the terms of the GNU General Public License version 2 only, as
236.10 + * published by the Free Software Foundation.
236.11 + *
236.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
236.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
236.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
236.15 + * version 2 for more details (a copy is included in the LICENSE file that
236.16 + * accompanied this code).
236.17 + *
236.18 + * You should have received a copy of the GNU General Public License version
236.19 + * 2 along with this work; if not, write to the Free Software Foundation,
236.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
236.21 + *
236.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
236.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
236.24 + * have any questions.
236.25 + */
236.26 +
236.27 +/* @test
236.28 + * @bug 6834246
236.29 + * @summary Stress test connections through the loopback interface
236.30 + */
236.31 +
236.32 +import java.nio.ByteBuffer;
236.33 +import java.net.*;
236.34 +import java.nio.channels.*;
236.35 +import java.util.Random;
236.36 +import java.io.IOException;
236.37 +
236.38 +public class StressLoopback {
236.39 + static final Random rand = new Random();
236.40 +
236.41 + public static void main(String[] args) throws Exception {
236.42 + // setup listener
236.43 + AsynchronousServerSocketChannel listener =
236.44 + AsynchronousServerSocketChannel.open().bind(new InetSocketAddress(0));
236.45 + int port =((InetSocketAddress)(listener.getLocalAddress())).getPort();
236.46 + InetAddress lh = InetAddress.getLocalHost();
236.47 + SocketAddress remote = new InetSocketAddress(lh, port);
236.48 +
236.49 + // create sources and sinks
236.50 + int count = 2 + rand.nextInt(9);
236.51 + Source[] source = new Source[count];
236.52 + Sink[] sink = new Sink[count];
236.53 + for (int i=0; i<count; i++) {
236.54 + AsynchronousSocketChannel ch = AsynchronousSocketChannel.open();
236.55 + ch.connect(remote).get();
236.56 + source[i] = new Source(ch);
236.57 + sink[i] = new Sink(listener.accept().get());
236.58 + }
236.59 +
236.60 + // start the sinks and sources
236.61 + for (int i=0; i<count; i++) {
236.62 + sink[i].start();
236.63 + source[i].start();
236.64 + }
236.65 +
236.66 + // let the test run for a while
236.67 + Thread.sleep(20*1000);
236.68 +
236.69 + // wait until everyone is done
236.70 + boolean failed = false;
236.71 + long total = 0L;
236.72 + for (int i=0; i<count; i++) {
236.73 + long nwrote = source[i].finish();
236.74 + long nread = sink[i].finish();
236.75 + if (nread != nwrote)
236.76 + failed = true;
236.77 + System.out.format("%d -> %d (%s)\n",
236.78 + nwrote, nread, (failed) ? "FAIL" : "PASS");
236.79 + total += nwrote;
236.80 + }
236.81 + if (failed)
236.82 + throw new RuntimeException("Test failed - see log for details");
236.83 + System.out.format("Total sent %d MB\n", total / (1024L * 1024L));
236.84 + }
236.85 +
236.86 + /**
236.87 + * Writes bytes to a channel until "done". When done the channel is closed.
236.88 + */
236.89 + static class Source {
236.90 + private final AsynchronousByteChannel channel;
236.91 + private final ByteBuffer sentBuffer;
236.92 + private volatile long bytesSent;
236.93 + private volatile boolean finished;
236.94 +
236.95 + Source(AsynchronousByteChannel channel) {
236.96 + this.channel = channel;
236.97 + int size = 1024 + rand.nextInt(10000);
236.98 + this.sentBuffer = (rand.nextBoolean()) ?
236.99 + ByteBuffer.allocateDirect(size) : ByteBuffer.allocate(size);
236.100 + }
236.101 +
236.102 + void start() {
236.103 + sentBuffer.position(0);
236.104 + sentBuffer.limit(sentBuffer.capacity());
236.105 + channel.write(sentBuffer, null, new CompletionHandler<Integer,Void> () {
236.106 + public void completed(Integer nwrote, Void att) {
236.107 + bytesSent += nwrote;
236.108 + if (finished) {
236.109 + closeUnchecked(channel);
236.110 + } else {
236.111 + sentBuffer.position(0);
236.112 + sentBuffer.limit(sentBuffer.capacity());
236.113 + channel.write(sentBuffer, null, this);
236.114 + }
236.115 + }
236.116 + public void failed(Throwable exc, Void att) {
236.117 + exc.printStackTrace();
236.118 + closeUnchecked(channel);
236.119 + }
236.120 + public void cancelled(Void att) {
236.121 + }
236.122 + });
236.123 + }
236.124 +
236.125 + long finish() {
236.126 + finished = true;
236.127 + waitUntilClosed(channel);
236.128 + return bytesSent;
236.129 + }
236.130 + }
236.131 +
236.132 + /**
236.133 + * Read bytes from a channel until EOF is received.
236.134 + */
236.135 + static class Sink {
236.136 + private final AsynchronousByteChannel channel;
236.137 + private final ByteBuffer readBuffer;
236.138 + private volatile long bytesRead;
236.139 +
236.140 + Sink(AsynchronousByteChannel channel) {
236.141 + this.channel = channel;
236.142 + int size = 1024 + rand.nextInt(10000);
236.143 + this.readBuffer = (rand.nextBoolean()) ?
236.144 + ByteBuffer.allocateDirect(size) : ByteBuffer.allocate(size);
236.145 + }
236.146 +
236.147 + void start() {
236.148 + channel.read(readBuffer, null, new CompletionHandler<Integer,Void> () {
236.149 + public void completed(Integer nread, Void att) {
236.150 + if (nread < 0) {
236.151 + closeUnchecked(channel);
236.152 + } else {
236.153 + bytesRead += nread;
236.154 + readBuffer.clear();
236.155 + channel.read(readBuffer, null, this);
236.156 + }
236.157 + }
236.158 + public void failed(Throwable exc, Void att) {
236.159 + exc.printStackTrace();
236.160 + closeUnchecked(channel);
236.161 + }
236.162 + public void cancelled(Void att) {
236.163 + }
236.164 + });
236.165 + }
236.166 +
236.167 + long finish() {
236.168 + waitUntilClosed(channel);
236.169 + return bytesRead;
236.170 + }
236.171 + }
236.172 +
236.173 + static void waitUntilClosed(Channel c) {
236.174 + while (c.isOpen()) {
236.175 + try {
236.176 + Thread.sleep(100);
236.177 + } catch (InterruptedException ignore) { }
236.178 + }
236.179 + }
236.180 +
236.181 + static void closeUnchecked(Channel c) {
236.182 + try {
236.183 + c.close();
236.184 + } catch (IOException ignore) { }
236.185 + }
236.186 +}
237.1 --- a/test/javax/print/CheckDupFlavor.java Tue May 12 15:21:55 2009 +0900
237.2 +++ b/test/javax/print/CheckDupFlavor.java Thu May 14 00:17:25 2009 -0700
237.3 @@ -1,5 +1,5 @@
237.4 /*
237.5 - * Copyright 2004-2008 Sun Microsystems, Inc. All Rights Reserved.
237.6 + * Copyright 2004-2009 Sun Microsystems, Inc. All Rights Reserved.
237.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
237.8 *
237.9 * This code is free software; you can redistribute it and/or modify it
237.10 @@ -35,17 +35,19 @@
237.11
237.12 public class CheckDupFlavor {
237.13 public static void main(String[] args){
237.14 - PrintService pservice =
237.15 - PrintServiceLookup.lookupDefaultPrintService();
237.16 -
237.17 - if (pservice == null) {
237.18 - System.out.println("No default PrintService found. Test ABORTED.");
237.19 - return;
237.20 + PrintService defService = PrintServiceLookup.lookupDefaultPrintService();
237.21 + PrintService[] pservice;
237.22 + if (defService == null) {
237.23 + pservice = PrintServiceLookup.lookupPrintServices(null, null);
237.24 + if (pservice.length == 0) {
237.25 + throw new RuntimeException("No printer found. TEST ABORTED");
237.26 + }
237.27 + defService = pservice[0];
237.28 }
237.29
237.30 - System.out.println("Default service = "+pservice);
237.31 + System.out.println("PrintService = "+defService);
237.32
237.33 - DocFlavor[] flavors = pservice.getSupportedDocFlavors();
237.34 + DocFlavor[] flavors = defService.getSupportedDocFlavors();
237.35 if (flavors==null) {
237.36 System.out.println("No flavors supported. Test PASSED.");
237.37 return;
237.38 @@ -54,13 +56,13 @@
237.39
237.40 ArrayList flavorList = new ArrayList();
237.41 for (int i=0; i<flavors.length; i++) {
237.42 - if (flavors[i] == null) {
237.43 - throw new RuntimeException("Null flavor. Test FAILED.");
237.44 - } else if (flavorList.contains(flavors[i])) {
237.45 - throw new RuntimeException("\n\tDuplicate flavor found : "+flavors[i]+" : Test FAILED.");
237.46 - } else {
237.47 - flavorList.add(flavors[i]);
237.48 - }
237.49 + if (flavors[i] == null) {
237.50 + throw new RuntimeException("Null flavor. Test FAILED.");
237.51 + } else if (flavorList.contains(flavors[i])) {
237.52 + throw new RuntimeException("\n\tDuplicate flavor found : "+flavors[i]+" : Test FAILED.");
237.53 + } else {
237.54 + flavorList.add(flavors[i]);
237.55 + }
237.56 }
237.57 System.out.println("No duplicate found. Test PASSED.");
237.58 }
238.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
238.2 +++ b/test/javax/print/LookupServices.java Thu May 14 00:17:25 2009 -0700
238.3 @@ -0,0 +1,50 @@
238.4 +/*
238.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
238.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
238.7 + *
238.8 + * This code is free software; you can redistribute it and/or modify it
238.9 + * under the terms of the GNU General Public License version 2 only, as
238.10 + * published by the Free Software Foundation.
238.11 + *
238.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
238.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
238.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
238.15 + * version 2 for more details (a copy is included in the LICENSE file that
238.16 + * accompanied this code).
238.17 + *
238.18 + * You should have received a copy of the GNU General Public License version
238.19 + * 2 along with this work; if not, write to the Free Software Foundation,
238.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
238.21 + *
238.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
238.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
238.24 + * have any questions.
238.25 + */
238.26 +
238.27 +/*
238.28 + * @test
238.29 + * @bug 4510477 6520186
238.30 + * @summary No crash with HP OfficeJet 600 installed.
238.31 + * @run main LookupServices
238.32 +*/
238.33 +
238.34 +import javax.print.attribute.*;
238.35 +import javax.print.*;
238.36 +
238.37 +public class LookupServices {
238.38 + public static void main (String [] args) {
238.39 +
238.40 + DocFlavor flavor = DocFlavor.INPUT_STREAM.GIF;
238.41 + HashPrintRequestAttributeSet prSet = null;
238.42 +
238.43 + PrintService[] serv = PrintServiceLookup.lookupPrintServices(flavor, null);
238.44 + System.out.println("default "+PrintServiceLookup.lookupDefaultPrintService());
238.45 + if (serv.length==0) {
238.46 + System.out.println("no PrintService supports GIF");
238.47 + return;
238.48 + }
238.49 +
238.50 + System.out.println("Selected print service: "+ serv[0]);
238.51 + }
238.52 +
238.53 +}
239.1 --- a/test/javax/print/TestRaceCond.java Tue May 12 15:21:55 2009 +0900
239.2 +++ b/test/javax/print/TestRaceCond.java Thu May 14 00:17:25 2009 -0700
239.3 @@ -43,6 +43,10 @@
239.4 PrintService[] pservs = PrintServiceLookup.lookupPrintServices(null, null);
239.5 PrintService pserv2 = PrintServiceLookup.lookupDefaultPrintService();
239.6
239.7 + if ((pserv1 == null) || (pserv2==null)) {
239.8 + return;
239.9 + }
239.10 +
239.11 if (pserv1.hashCode() != pserv2.hashCode()) {
239.12 throw new RuntimeException("Different hashCodes for equal print "
239.13 + "services: " + pserv1.hashCode() + " "
240.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
240.2 +++ b/test/javax/print/attribute/Chroma.java Thu May 14 00:17:25 2009 -0700
240.3 @@ -0,0 +1,66 @@
240.4 +/*
240.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
240.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
240.7 + *
240.8 + * This code is free software; you can redistribute it and/or modify it
240.9 + * under the terms of the GNU General Public License version 2 only, as
240.10 + * published by the Free Software Foundation.
240.11 + *
240.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
240.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
240.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
240.15 + * version 2 for more details (a copy is included in the LICENSE file that
240.16 + * accompanied this code).
240.17 + *
240.18 + * You should have received a copy of the GNU General Public License version
240.19 + * 2 along with this work; if not, write to the Free Software Foundation,
240.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
240.21 + *
240.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
240.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
240.24 + * have any questions.
240.25 + */
240.26 +/*
240.27 + * @test 1.3 01/05/11
240.28 + * @bug 4456750
240.29 + * @summary Test for supported chromaticity values with null DocFlavor.
240.30 + * No exception should be thrown.
240.31 + * @run main Chroma
240.32 +*/
240.33 +
240.34 +// Chroma.java
240.35 +import java.io.*;
240.36 +
240.37 +import javax.print.*;
240.38 +import javax.print.attribute.*;
240.39 +import javax.print.attribute.standard.*;
240.40 +
240.41 +public class Chroma {
240.42 +
240.43 + public static void main(String args[]) {
240.44 +
240.45 + StreamPrintServiceFactory []fact =
240.46 + StreamPrintServiceFactory.lookupStreamPrintServiceFactories(
240.47 + DocFlavor.SERVICE_FORMATTED.PRINTABLE,
240.48 + DocFlavor.BYTE_ARRAY.POSTSCRIPT.getMimeType());
240.49 +
240.50 + if (fact.length != 0) {
240.51 + OutputStream out = new ByteArrayOutputStream();
240.52 + StreamPrintService sps = fact[0].getPrintService(out);
240.53 + checkChroma(sps);
240.54 + }
240.55 +
240.56 + PrintService defSvc = PrintServiceLookup.lookupDefaultPrintService();
240.57 + if (defSvc != null) {
240.58 + checkChroma(defSvc);
240.59 + }
240.60 +
240.61 + }
240.62 +
240.63 + static void checkChroma(PrintService svc) {
240.64 + if (svc.isAttributeCategorySupported(Chromaticity.class)) {
240.65 + svc.getSupportedAttributeValues(Chromaticity.class,null,null);
240.66 + }
240.67 + }
240.68 +
240.69 +}
241.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
241.2 +++ b/test/javax/print/attribute/ChromaticityValues.java Thu May 14 00:17:25 2009 -0700
241.3 @@ -0,0 +1,97 @@
241.4 +/*
241.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
241.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
241.7 + *
241.8 + * This code is free software; you can redistribute it and/or modify it
241.9 + * under the terms of the GNU General Public License version 2 only, as
241.10 + * published by the Free Software Foundation.
241.11 + *
241.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
241.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
241.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
241.15 + * version 2 for more details (a copy is included in the LICENSE file that
241.16 + * accompanied this code).
241.17 + *
241.18 + * You should have received a copy of the GNU General Public License version
241.19 + * 2 along with this work; if not, write to the Free Software Foundation,
241.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
241.21 + *
241.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
241.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
241.24 + * have any questions.
241.25 + */
241.26 +/*
241.27 + * @test
241.28 + * @bug 4446106
241.29 + * @summary Test for chromaticity values.
241.30 + * @run main ChromaticityValues
241.31 +*/
241.32 +
241.33 +
241.34 +
241.35 +import javax.print.*;
241.36 +import javax.print.attribute.*;
241.37 +import javax.print.attribute.standard.*;
241.38 +import java.util.ArrayList;
241.39 +
241.40 +public class ChromaticityValues {
241.41 +
241.42 + public static void main(String args[]) {
241.43 + System.out.println("=======================================================================");
241.44 + System.out.println("INSTRUCTIONS: This test is only for WINDOWS platform. ");
241.45 + System.out.println("You should have a printer configured as your default printer in your system.");
241.46 + System.out.println("=======================================================================");
241.47 +
241.48 + String os=System.getProperty("os.name").toLowerCase();
241.49 +
241.50 + if (!(os.indexOf("win")>=0)) {
241.51 + System.out.println("Not a Windows System. TEST ABORTED");
241.52 + return;
241.53 + }
241.54 +
241.55 + PrintService pservice = PrintServiceLookup.lookupDefaultPrintService();
241.56 + if (pservice == null) {
241.57 + throw new RuntimeException("A printer is required for this test.");
241.58 + }
241.59 +
241.60 + System.out.println("Default Service is "+pservice);
241.61 + ColorSupported psa = (ColorSupported)pservice.getAttribute(ColorSupported.class);
241.62 + ArrayList cValues = new ArrayList();
241.63 +
241.64 + if (pservice.isAttributeCategorySupported(Chromaticity.class)) {
241.65 + Chromaticity[] values =(Chromaticity[])
241.66 + (pservice.getSupportedAttributeValues(Chromaticity.class, DocFlavor.SERVICE_FORMATTED.PAGEABLE, null));
241.67 + if ((values != null) && (values.length > 0)) {
241.68 + for (int i=0; i<values.length; i++) {
241.69 + cValues.add(values[i]);
241.70 + }
241.71 + } else {
241.72 + System.out.println("Chromaticity value is unknown. TEST ABORTED");
241.73 + return;
241.74 + }
241.75 +
241.76 + } else {
241.77 + System.out.println("Chromaticity is not supported. TEST ABORTED");
241.78 + return;
241.79 +
241.80 + }
241.81 +
241.82 + if (psa != null) {
241.83 + if (psa.equals(ColorSupported.SUPPORTED)) {
241.84 + if (cValues.size() < 2) {
241.85 + throw new RuntimeException("ColorSupported is supported, values for Chromaticity should be monochrome and color.");
241.86 + }
241.87 + } else {
241.88 + if ((cValues.size() != 1) ||
241.89 + (!cValues.contains(Chromaticity.MONOCHROME))) {
241.90 + throw new RuntimeException("ColorSupported is not supported, values for Chromaticity should only be monochrome.");
241.91 + }
241.92 + }
241.93 + } else { // ColorSupported unknown
241.94 + if (!cValues.contains(Chromaticity.COLOR)) {
241.95 + throw new RuntimeException("ColorSupported is unknown, values for Chromaticity should at least include color.");
241.96 + }
241.97 +
241.98 + }
241.99 + }
241.100 +}
242.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
242.2 +++ b/test/javax/print/attribute/GetCopiesSupported.java Thu May 14 00:17:25 2009 -0700
242.3 @@ -0,0 +1,57 @@
242.4 +/*
242.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
242.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
242.7 + *
242.8 + * This code is free software; you can redistribute it and/or modify it
242.9 + * under the terms of the GNU General Public License version 2 only, as
242.10 + * published by the Free Software Foundation.
242.11 + *
242.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
242.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
242.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
242.15 + * version 2 for more details (a copy is included in the LICENSE file that
242.16 + * accompanied this code).
242.17 + *
242.18 + * You should have received a copy of the GNU General Public License version
242.19 + * 2 along with this work; if not, write to the Free Software Foundation,
242.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
242.21 + *
242.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
242.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
242.24 + * have any questions.
242.25 + */
242.26 +/*
242.27 + @test
242.28 + @bug 4463280
242.29 + @summary No ClassCastException should occur.
242.30 + @run main GetCopiesSupported
242.31 +*/
242.32 +
242.33 +import javax.print.*;
242.34 +import javax.print.attribute.*;
242.35 +import javax.print.attribute.standard.*;
242.36 +
242.37 +public class GetCopiesSupported {
242.38 +
242.39 + public static void main(String args[]) {
242.40 + PrintService service = PrintServiceLookup.lookupDefaultPrintService();
242.41 + PrintService[] pservice;
242.42 + if (service == null) {
242.43 + pservice = PrintServiceLookup.lookupPrintServices(null, null);
242.44 + if (pservice.length == 0) {
242.45 + throw new RuntimeException("No printer found. TEST ABORTED");
242.46 + }
242.47 + service = pservice[0];
242.48 + }
242.49 +
242.50 + if (service != null) {
242.51 + CopiesSupported c = (CopiesSupported)
242.52 + service.getSupportedAttributeValues(Copies.class,
242.53 + null, null);
242.54 +
242.55 + System.out.println("CopiesSupported : "+c);
242.56 + }
242.57 + }
242.58 +
242.59 +
242.60 +}
243.1 --- a/test/javax/print/attribute/PSCopiesFlavorTest.java Tue May 12 15:21:55 2009 +0900
243.2 +++ b/test/javax/print/attribute/PSCopiesFlavorTest.java Thu May 14 00:17:25 2009 -0700
243.3 @@ -1,5 +1,5 @@
243.4 /*
243.5 - * Copyright 2007 Sun Microsystems, Inc. All Rights Reserved.
243.6 + * Copyright 2007-2009 Sun Microsystems, Inc. All Rights Reserved.
243.7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
243.8 *
243.9 * This code is free software; you can redistribute it and/or modify it
243.10 @@ -37,26 +37,26 @@
243.11 public static void main(String args[]) {
243.12
243.13 DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
243.14 - PrintService ps = PrintServiceLookup.lookupDefaultPrintService();
243.15 - if (!(ps.isDocFlavorSupported(flavor))) {
243.16 - System.out.println("unsupported flavor :" + flavor);
243.17 - return;
243.18 + PrintService[] ps = PrintServiceLookup.lookupPrintServices(flavor, null);
243.19 + if (ps.length > 0) {
243.20 + System.out.println("found PrintService: "+ps[0]);
243.21 + Copies c = new Copies(1);
243.22 + PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
243.23 + aset.add(c);
243.24 + boolean suppVal = ps[0].isAttributeValueSupported(c, flavor, null);
243.25 + AttributeSet us = ps[0].getUnsupportedAttributes(flavor, aset);
243.26 + if (suppVal || us == null) {
243.27 + throw new RuntimeException("Copies should be unsupported value");
243.28 + }
243.29 +
243.30 + Object value = ps[0].getSupportedAttributeValues(Copies.class,
243.31 + flavor, null);
243.32 +
243.33 + //Copies Supported
243.34 + if(value instanceof CopiesSupported) {
243.35 + throw new RuntimeException("Copies should have no supported values.");
243.36 + }
243.37 }
243.38 - Copies c = new Copies(1);
243.39 - PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
243.40 - aset.add(c);
243.41 - boolean suppVal = ps.isAttributeValueSupported(c, flavor, null);
243.42 - AttributeSet us = ps.getUnsupportedAttributes(flavor, aset);
243.43 - if (suppVal || us == null) {
243.44 - throw new RuntimeException("Copies should be unsupported value");
243.45 - }
243.46 -
243.47 - Object value = ps.getSupportedAttributeValues(Copies.class, flavor, null);
243.48 -
243.49 - //Copies Supported
243.50 - if(value instanceof CopiesSupported) {
243.51 - throw new RuntimeException("Copies should have no supported values.");
243.52 - }
243.53
243.54 }
243.55 }
244.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
244.2 +++ b/test/javax/print/attribute/SidesPageRangesTest.java Thu May 14 00:17:25 2009 -0700
244.3 @@ -0,0 +1,122 @@
244.4 +/*
244.5 + * Copyright 2003-2009 Sun Microsystems, Inc. All Rights Reserved.
244.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
244.7 + *
244.8 + * This code is free software; you can redistribute it and/or modify it
244.9 + * under the terms of the GNU General Public License version 2 only, as
244.10 + * published by the Free Software Foundation.
244.11 + *
244.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
244.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
244.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
244.15 + * version 2 for more details (a copy is included in the LICENSE file that
244.16 + * accompanied this code).
244.17 + *
244.18 + * You should have received a copy of the GNU General Public License version
244.19 + * 2 along with this work; if not, write to the Free Software Foundation,
244.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
244.21 + *
244.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
244.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
244.24 + * have any questions.
244.25 + */
244.26 +/*
244.27 + * @test
244.28 + * @bug 4903366
244.29 + * @summary No crash should occur.
244.30 + * @run main SidesPageRangesTest
244.31 +*/
244.32 +import java.awt.*;
244.33 +import javax.print.*;
244.34 +import javax.print.attribute.standard.*;
244.35 +import javax.print.attribute.*;
244.36 +import java.io.*;
244.37 +import java.util.Locale;
244.38 +import java.net.URL;
244.39 +
244.40 +public class SidesPageRangesTest {
244.41 + /**
244.42 + * Constructor
244.43 + */
244.44 + public SidesPageRangesTest() {
244.45 + super();
244.46 + }
244.47 + /**
244.48 + * Starts the application.
244.49 + */
244.50 + public static void main(java.lang.String[] args) {
244.51 + SidesPageRangesTest pd = new SidesPageRangesTest();
244.52 + PrintService defService = null;
244.53 + DocFlavor flavors[] = null;
244.54 + PrintService[] pservice;
244.55 + defService = PrintServiceLookup.lookupDefaultPrintService();
244.56 + if (defService == null) {
244.57 + pservice = PrintServiceLookup.lookupPrintServices(null, null);
244.58 + if (pservice.length == 0) {
244.59 + throw new RuntimeException("Printer is required for this test. TEST ABORTED");
244.60 + }
244.61 + defService = pservice[0];
244.62 + }
244.63 + System.out.println("Default Print Service "+defService);
244.64 +
244.65 +
244.66 + if (defService.isAttributeCategorySupported(PageRanges.class)) {
244.67 + System.out.println("\nPageRanges Attribute category is supported");
244.68 + } else {
244.69 + System.out.println("\nPageRanges Attribute category is not supported. terminating...");
244.70 + System.exit(1);
244.71 + }
244.72 +
244.73 + flavors = defService.getSupportedDocFlavors();
244.74 + System.out.println("\nGetting Supported values for PageRanges for each supported DocFlavor");
244.75 + System.out.println("===============================================================\n");
244.76 + for (int y = 0; y < flavors.length; y ++) {
244.77 + System.out.println("\n\n");
244.78 +
244.79 + System.out.println("Doc Flavor: "+flavors[y]);
244.80 + System.out.println("-----------------------------");
244.81 +
244.82 + Object vals = defService.getSupportedAttributeValues(PageRanges.class, flavors[y], null);
244.83 + if (vals == null) {
244.84 + System.out.println("No supported values for PageRanges for this doc flavor. ");
244.85 + }
244.86 +
244.87 + PageRanges[] pr = null;
244.88 + if (vals instanceof PageRanges[]) {
244.89 + pr = (PageRanges[]) vals;
244.90 + for (int x = 0; x < pr.length; x ++) {
244.91 + System.out.println("\nSupported Value "+pr[x]);
244.92 + System.out.println("is "+pr[x]+" value supported? "+defService.isAttributeValueSupported(pr[x], flavors[y], null));
244.93 +
244.94 + if (!defService.isAttributeValueSupported(pr[x], flavors[y], null)) {
244.95 + throw new RuntimeException("PageRanges contradicts getSupportedAttributeValues");
244.96 + }
244.97 + }
244.98 + } else if (vals instanceof PageRanges) {
244.99 + System.out.println(vals);
244.100 + System.out.println("is "+vals+" value supported? "+defService.isAttributeValueSupported((javax.print.attribute.Attribute)vals, flavors[y], null));
244.101 + if (!defService.isAttributeValueSupported((javax.print.attribute.Attribute)vals, flavors[y], null)) {
244.102 + throw new RuntimeException("PageRanges contradicts getSupportedAttributeValues");
244.103 + }
244.104 + }
244.105 +
244.106 + // SIDES test
244.107 + vals = defService.getSupportedAttributeValues(Sides.class, flavors[y], null);
244.108 + if (vals == null) {
244.109 + System.out.println("No supported values for Sides for this doc flavor. ");
244.110 + }
244.111 +
244.112 + Sides[] s = null;
244.113 + if (vals instanceof Sides[]) {
244.114 + s = (Sides[]) vals;
244.115 + for (int x = 0; x < s.length; x ++) {
244.116 + System.out.println("\nSupported Value "+s[x]);
244.117 + System.out.println("is "+s[x]+" value supported? "+defService.isAttributeValueSupported(s[x], flavors[y], null));
244.118 + if (!defService.isAttributeValueSupported(s[x], flavors[y], null)) {
244.119 + throw new RuntimeException("Sides contradicts getSupportedAttributeValues");
244.120 + }
244.121 + }
244.122 + }
244.123 + }
244.124 + }
244.125 +}
245.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
245.2 +++ b/test/javax/print/attribute/SupportedPrintableAreas.java Thu May 14 00:17:25 2009 -0700
245.3 @@ -0,0 +1,83 @@
245.4 +/*
245.5 + * Copyright 2003-2009 Sun Microsystems, Inc. All Rights Reserved.
245.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
245.7 + *
245.8 + * This code is free software; you can redistribute it and/or modify it
245.9 + * under the terms of the GNU General Public License version 2 only, as
245.10 + * published by the Free Software Foundation.
245.11 + *
245.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
245.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
245.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
245.15 + * version 2 for more details (a copy is included in the LICENSE file that
245.16 + * accompanied this code).
245.17 + *
245.18 + * You should have received a copy of the GNU General Public License version
245.19 + * 2 along with this work; if not, write to the Free Software Foundation,
245.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
245.21 + *
245.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
245.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
245.24 + * have any questions.
245.25 + */
245.26 +
245.27 +/*
245.28 + * @test
245.29 + * @bug 4762773 6289206 6324049 6362765
245.30 + * @summary Tests that get non-null return list of printable areas.
245.31 + * @run main SupportedPrintableAreas
245.32 + */
245.33 +
245.34 +
245.35 +import javax.print.*;
245.36 +import javax.print.event.*;
245.37 +import javax.print.attribute.*;
245.38 +import javax.print.attribute.standard.*;
245.39 +
245.40 +public class SupportedPrintableAreas {
245.41 +
245.42 + public static void main(String[] args) {
245.43 + PrintService[] svc;
245.44 + PrintService printer = PrintServiceLookup.lookupDefaultPrintService();
245.45 + if (printer == null) {
245.46 + svc = PrintServiceLookup.lookupPrintServices(DocFlavor.SERVICE_FORMATTED.PRINTABLE, null);
245.47 + if (svc.length == 0) {
245.48 + throw new RuntimeException("Printer is required for this test. TEST ABORTED");
245.49 + }
245.50 + printer = svc[0];
245.51 + }
245.52 + System.out.println("PrintService found : "+printer);
245.53 +
245.54 + if (!printer.isAttributeCategorySupported(MediaPrintableArea.class)) {
245.55 + return;
245.56 + }
245.57 + Object value = printer.getSupportedAttributeValues(
245.58 + MediaPrintableArea.class, null, null);
245.59 + if (!value.getClass().isArray()) {
245.60 + throw new RuntimeException("unexpected value");
245.61 + }
245.62 +
245.63 + PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
245.64 + value = printer.getSupportedAttributeValues(
245.65 + MediaPrintableArea.class, null, aset);
245.66 + if (!value.getClass().isArray()) {
245.67 + throw new RuntimeException("unexpected value");
245.68 + }
245.69 +
245.70 + Media media = (Media)printer.getDefaultAttributeValue(Media.class);
245.71 + aset.add(media);
245.72 + value = printer.getSupportedAttributeValues(
245.73 + MediaPrintableArea.class, null, aset);
245.74 + if (!value.getClass().isArray()) {
245.75 + throw new RuntimeException("unexpected value");
245.76 + }
245.77 +
245.78 + // test for 6289206
245.79 + aset.add(MediaTray.MANUAL);
245.80 + value = printer.getSupportedAttributeValues(
245.81 + MediaPrintableArea.class, null, aset);
245.82 + if ((value != null) && !value.getClass().isArray()) {
245.83 + throw new RuntimeException("unexpected value");
245.84 + }
245.85 + }
245.86 +}
246.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
246.2 +++ b/test/javax/print/attribute/autosense/PrintAutoSenseData.java Thu May 14 00:17:25 2009 -0700
246.3 @@ -0,0 +1,152 @@
246.4 +/*
246.5 + * Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
246.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
246.7 + *
246.8 + * This code is free software; you can redistribute it and/or modify it
246.9 + * under the terms of the GNU General Public License version 2 only, as
246.10 + * published by the Free Software Foundation.
246.11 + *
246.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
246.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
246.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
246.15 + * version 2 for more details (a copy is included in the LICENSE file that
246.16 + * accompanied this code).
246.17 + *
246.18 + * You should have received a copy of the GNU General Public License version
246.19 + * 2 along with this work; if not, write to the Free Software Foundation,
246.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
246.21 + *
246.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
246.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
246.24 + * have any questions.
246.25 + */
246.26 +
246.27 +/*
246.28 + * @test
246.29 + * @bug 4468109
246.30 + * @summary Test for printing AUTOSENSE DocFlavor. No exception should be thrown.
246.31 + * @run main PrintAutoSenseData
246.32 +*/
246.33 +
246.34 +import java.io.*;
246.35 +import javax.print.*;
246.36 +import javax.print.attribute.*;
246.37 +import javax.print.attribute.standard.*;
246.38 +import java.net.URL;
246.39 +
246.40 +public class PrintAutoSenseData
246.41 +{
246.42 + private DocFlavor flavor = DocFlavor.URL.AUTOSENSE; //represents the docflavor.
246.43 + private PrintService[] service = PrintServiceLookup.lookupPrintServices(flavor, null);
246.44 +
246.45 +
246.46 + public PrintAutoSenseData()
246.47 + {
246.48 + if (service.length == 0)
246.49 + {
246.50 + System.out.println("No print service available...");
246.51 + return;
246.52 + }
246.53 +
246.54 + System.out.println("selected PrintService: " + this.service[0]);
246.55 + if (service[0].isDocFlavorSupported(flavor)) {
246.56 + System.out.println("DocFlavor.URL.AUTOSENSE supported");
246.57 + } else {
246.58 + System.out.println("DocFlavor.URL.AUTOSENSE not supported. Testing aborted !!");
246.59 + return;
246.60 + }
246.61 +
246.62 + DocPrintJob job = service[0].createPrintJob();
246.63 + this.print();
246.64 + }
246.65 +
246.66 + // The print method prints sample file with DocFlavor.URL.AUTOSENSE.
246.67 + void print()
246.68 + {
246.69 + String fileName = "./sample.txt";
246.70 + DocPrintJob job = service[0].createPrintJob();
246.71 +
246.72 + // The representation class is a URL.
246.73 + System.out.println("printing " + fileName + " using doc flavor: " + this.flavor);
246.74 + System.out.println("Rep. class name: " + this.flavor.getRepresentationClassName() + " MimeType: " + this.flavor.getMimeType());
246.75 +
246.76 + Doc doc = new URLDoc(fileName, this.flavor);
246.77 + HashPrintRequestAttributeSet prSet =
246.78 + new HashPrintRequestAttributeSet();
246.79 + prSet.add(new Destination(new File("./dest.prn").toURI()));
246.80 + //print the document.
246.81 + try {
246.82 + job.print(doc, prSet);
246.83 + } catch ( Exception e ) {
246.84 + e.printStackTrace();
246.85 + }
246.86 + }
246.87 +
246.88 + public static void main(String[] args) {
246.89 + new PrintAutoSenseData();
246.90 + }
246.91 +
246.92 +}
246.93 +
246.94 +/* This class is for reading autosense data with URL representation class */
246.95 +
246.96 +class URLDoc implements Doc
246.97 +{
246.98 + protected String fileName = null;
246.99 + protected DocFlavor flavor = null;
246.100 + protected Object printData = null;
246.101 + protected InputStream instream = null;
246.102 +
246.103 + public URLDoc(String filename, DocFlavor docFlavor)
246.104 + {
246.105 + this.fileName = filename;
246.106 + this.flavor = docFlavor;
246.107 + }
246.108 +
246.109 + public DocFlavor getDocFlavor() {
246.110 + return DocFlavor.URL.AUTOSENSE;
246.111 + }
246.112 +
246.113 + public DocAttributeSet getAttributes()
246.114 + {
246.115 + HashDocAttributeSet hset = new HashDocAttributeSet();
246.116 + return hset;
246.117 + }
246.118 +
246.119 + public Object getPrintData()
246.120 + {
246.121 + if ( this.printData == null )
246.122 + {
246.123 + this.printData = URLDoc.class.getResource(this.fileName);
246.124 + System.out.println("getPrintData(): " + this.printData);
246.125 + }
246.126 + return this.printData;
246.127 + }
246.128 +
246.129 + public Reader getReaderForText()
246.130 + {
246.131 + return null;
246.132 + }
246.133 +
246.134 + public InputStream getStreamForBytes()
246.135 + {
246.136 + System.out.println("getStreamForBytes(): " + this.printData);
246.137 + try
246.138 + {
246.139 + if ( (this.printData != null) && (this.printData instanceof URL) )
246.140 + {
246.141 + this.instream = ((URL)this.printData).openStream();
246.142 + }
246.143 + if (this.instream == null)
246.144 + {
246.145 + URL url = URLDoc.class.getResource(this.fileName);
246.146 + this.instream = url.openStream();
246.147 + }
246.148 + }
246.149 + catch ( IOException ie )
246.150 + {
246.151 + System.out.println("URLDoc: exception: " + ie.toString());
246.152 + }
246.153 + return this.instream;
246.154 + }
246.155 +}
247.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
247.2 +++ b/test/sun/pisces/StrokeShapeTest.java Thu May 14 00:17:25 2009 -0700
247.3 @@ -0,0 +1,71 @@
247.4 +/*
247.5 + * Copyright 2009 Sun Microsystems, Inc. All Rights Reserved.
247.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
247.7 + *
247.8 + * This code is free software; you can redistribute it and/or modify it
247.9 + * under the terms of the GNU General Public License version 2 only, as
247.10 + * published by the Free Software Foundation.
247.11 + *
247.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
247.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
247.14 + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
247.15 + * version 2 for more details (a copy is included in the LICENSE file that
247.16 + * accompanied this code).
247.17 + *
247.18 + * You should have received a copy of the GNU General Public License version
247.19 + * 2 along with this work; if not, write to the Free Software Foundation,
247.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
247.21 + *
247.22 + * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
247.23 + * CA 95054 USA or visit www.sun.com if you need additional information or
247.24 + * have any questions.
247.25 + */
247.26 +import java.awt.*;
247.27 +import java.awt.geom.Ellipse2D;
247.28 +import java.awt.geom.GeneralPath;
247.29 +import java.awt.image.BufferedImage;
247.30 +import java.io.File;
247.31 +
247.32 +import javax.imageio.ImageIO;
247.33 +
247.34 +/**
247.35 + * @author chrisn@google.com (Chris Nokleberg)
247.36 + * @author yamauchi@google.com (Hiroshi Yamauchi)
247.37 + */
247.38 +public class StrokeShapeTest {
247.39 + public static void main(String[] args) throws Exception {
247.40 + BufferedImage image = new BufferedImage(200, 200, BufferedImage.TYPE_INT_RGB);
247.41 + Graphics2D g = image.createGraphics();
247.42 + g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
247.43 + g.setPaint(Color.WHITE);
247.44 + g.fill(new Rectangle(image.getWidth(), image.getHeight()));
247.45 + g.translate(25, 100);
247.46 +
247.47 + Stroke stroke = new BasicStroke(200, BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND);
247.48 + Shape shape = new Polygon(new int[] {0, 1500, 0}, new int[] {750, 0, -750}, 3);
247.49 +
247.50 + g.scale(.1, .1);
247.51 + g.setPaint(Color.BLACK);
247.52 + g.setStroke(stroke);
247.53 + g.draw(shape);
247.54 + g.setPaint(Color.RED);
247.55 + g.fill(stroke.createStrokedShape(shape));
247.56 +
247.57 + // To visually check it
247.58 + //ImageIO.write(image, "PNG", new File(args[0]));
247.59 +
247.60 + boolean blackPixelFound = false;
247.61 + outer:
247.62 + for (int x = 0; x < 200; ++x) {
247.63 + for (int y = 0; y < 200; ++y) {
247.64 + if (image.getRGB(x, y) == Color.BLACK.getRGB()) {
247.65 + blackPixelFound = true;
247.66 + break outer;
247.67 + }
247.68 + }
247.69 + }
247.70 + if (blackPixelFound) {
247.71 + throw new RuntimeException("The shape hasn't been filled in red.");
247.72 + }
247.73 + }
247.74 +}