stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge

Browse Source
This commit is contained in:
J. Duke 2017-07-05 16:52:46 +02:00
commit 6ed538c2f9
258 changed files with 59222 additions and 35340 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.hgtags-top-repo
View File

@ -31,3 +31,4 @@ c235f4a8559d196879c56af80159f67ee5d0e720 jdk7-b53
2ef382b1bbd58a68e668391c6145a4b2066c5b96 jdk7-b54
aea0ace7a1e43619800931d42bbf69c579361c2d jdk7-b55
ba12117a5e6c918578d6b2a8c693232a33289024 jdk7-b56
ffd09e767dfa6d21466183a400f72cf62d53297f jdk7-b57

1
corba/.hgtags
View File

@ -31,3 +31,4 @@ bec82237d694f9802b820fa11bbb4f7fa9bf8e77 jdk7-b52
8130ac858d6789d5853d23044ba4a992afda574a jdk7-b54
7a869f16ba83060c34b77620406cfa89d1cd7084 jdk7-b55
553a664b807bb3a3c93f3b5a3c20ff0a90e08371 jdk7-b56
972c6157fae57850694675da82fd58a17930db0a jdk7-b57

2
corba/make/com/sun/corba/se/sources/Makefile
View File

@ -46,6 +46,8 @@ CORBA_JMK_DIRECTORY=$(TOPDIR)/make/com/sun/corba/minclude/
include $(CORBA_JMK_DIRECTORY)com_sun_corba_se_PortableActivationIDL.jmk
include $(CORBA_JMK_DIRECTORY)com_sun_corba_se_impl_logging.jmk
FILES_java += com/sun/corba/se/org/omg/CORBA/ORB.java
#
# Dirs
#

4
corba/src/share/classes/com/sun/corba/se/impl/presentation/rmi/IDLNameTranslatorImpl.java
View File

@ -202,6 +202,10 @@ public class IDLNameTranslatorImpl implements IDLNameTranslator {
private IDLNameTranslatorImpl(Class[] interfaces)
{
SecurityManager s = System.getSecurityManager();
if (s != null) {
s.checkPermission(new DynamicAccessPermission("access"));
}
try {
IDLTypesUtil idlTypesUtil = new IDLTypesUtil();
for (int ctr=0; ctr<interfaces.length; ctr++)

30
corba/src/share/classes/com/sun/tools/corba/se/idl/first.set
View File

@ -1,11 +1,35 @@
/*
* Copyright 1999 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*/
/*
* COMPONENT_NAME: idl.parser
*
*
* ORIGINS: 27
*
* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM
* 5639-D57, (C) COPYRIGHT International Business Machines Corp., 1997, 1998
*
*
*/
CORBA IDL

30
corba/src/share/classes/com/sun/tools/corba/se/idl/follow.set
View File

@ -1,11 +1,35 @@
/*
* Copyright 1999 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*/
/*
* COMPONENT_NAME: idl.parser
*
*
* ORIGINS: 27
*
* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM
* 5639-D57, (C) COPYRIGHT International Business Machines Corp., 1997, 1998
*
*
*/
CORBA IDL

54
corba/src/share/classes/com/sun/tools/corba/se/idl/grammar.idl
View File

@ -1,14 +1,38 @@
/*
* COMPONENT_NAME: idl.parser
*
* ORIGINS: 27
* Copyright 1999 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM
* 5639-D57, (C) COPYRIGHT International Business Machines Corp., 1997, 1998
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*/
CORBA 2.3 IDL
/*
* COMPONENT_NAME: idl.parser
*
* ORIGINS: 27
*
* 5639-D57, (C) COPYRIGHT International Business Machines Corp., 1997, 1998
*
*/
CORBA 2.3 IDL
---------------
(1) <specification> <definition><specification'>
@ -83,7 +107,7 @@ CORBA 2.3 IDL
(16) <vad> e
<export> <vad>
(17) <value_dcl> <value_header> "{" <value_element> <ve> "}"
(17) <ve> e
@ -91,9 +115,9 @@ CORBA 2.3 IDL
(18) <value_header> "custom" "valuetype" <id> <value_inheritance_spec>
"valuetype" <id> <value_inheritance_spec>
"custom" "valuetype" <id>
"valuetype" <id>
"custom" "valuetype" <id>
"valuetype" <id>
(19) <value_inheritance_spec> <opt_inherits> <opt_supports>
(19) <opt_inherits> e
@ -107,7 +131,7 @@ CORBA 2.3 IDL
"supports" <interface_name> <interface_name_list>
(19) <interface_name_list> e
"," <interface_name> <interface_name_list>
"," <interface_name> <interface_name_list>
(20) <value_name> <scoped_name>
@ -121,7 +145,7 @@ CORBA 2.3 IDL
(23) <init_dcl> "factory" <id> "(" ")"
"factory" <id> "(" <init_param_dcls> ")"
(24) <init_param_dcls> <init_param_decl>
(24) <init_param_dcls> <init_param_decl>
<init_param_decl> "," <init_param_dcls>
(25) <init_param_dcl> <init_param_attribute> <param_type_spec> <simple_declarator>
@ -349,7 +373,7 @@ CORBA 2.3 IDL
(87) <op_dcl''> e
<context_expr>
<raises_expr>
<raises_expr>
<raises_expr> <context_expr>
(88) <op_attribute> "oneway"
@ -386,7 +410,7 @@ CORBA 2.3 IDL
<wide_string_type>
<scoped_name>
(96) <fixed_pt_type> "fixed" "<" <positive_int_const> "," <positive_int_const> ">"
(96) <fixed_pt_type> "fixed" "<" <positive_int_const> "," <positive_int_const> ">"
(97) <fixed_pt_const_type> "fixed"

54
corba/src/share/classes/com/sun/tools/corba/se/idl/grammar3.idl
View File

@ -1,11 +1,35 @@
/*
* Copyright 1999 Sun Microsystems, Inc. All Rights Reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Sun designates this
* particular file as subject to the "Classpath" exception as provided
* by Sun in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
* CA 95054 USA or visit www.sun.com if you need additional information or
* have any questions.
*/
/*
* COMPONENT_NAME: idl.parser
*
*
* ORIGINS: 27
*
* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM
* 5639-D57, (C) COPYRIGHT International Business Machines Corp., 1997, 1998
*
*
*/
(1) <specification> <imports> <definition> <specification'> // CORBA3
@ -98,7 +122,7 @@
(16) <vad> e
<export> <vad>
(17) <value_dcl> <value_header> "{" <value_element> <ve> "}"
(17) <ve> e
@ -106,9 +130,9 @@
(18) <value_header> "custom" "valuetype" <id> <value_inheritance_spec>
"valuetype" <id> <value_inheritance_spec>
"custom" "valuetype" <id>
"valuetype" <id>
"custom" "valuetype" <id>
"valuetype" <id>
(19) <value_inheritance_spec> <opt_inherits> <opt_supports>
(19) <opt_inherits> e
@ -122,7 +146,7 @@
"supports" <interface_name> <interface_name_list>
(19) <interface_name_list> e
"," <interface_name> <interface_name_list>
"," <interface_name> <interface_name_list>
(20) <value_name> <scoped_name>
@ -136,7 +160,7 @@
(23) <init_dcl> "factory" <id> "(" ")"
"factory" <id> "(" <init_param_dcls> ")"
(24) <init_param_dcls> <init_param_dcl>
(24) <init_param_dcls> <init_param_dcl>
<init_param_dcl> "," <init_param_dcls>
(25) <init_param_dcl> <init_param_attribute> <param_type_spec> <simple_declarator>
@ -351,7 +375,7 @@
(85) <readonly_attr_spec> <readonly_attr_header> <readonly_attr_declarator> // CORBA3
(85) <readonly_attr_header> "readonly" "attribute" <param_type_spec> // CORBA3
(85) <readonly_attr_declarator> <simple_declarator> <get_excep_expr> // CORBA3
<simple_declarator> <sds> // CORBA3
@ -389,7 +413,7 @@
(87) <op_dcl''> e
<context_expr>
<raises_expr>
<raises_expr>
<raises_expr> <context_expr>
(88) <op_attribute> "oneway"
@ -426,7 +450,7 @@
<wide_string_type>
<scoped_name>
(96) <fixed_pt_type> "fixed" "<" <positive_int_const> "," <positive_int_const> ">"
(96) <fixed_pt_type> "fixed" "<" <positive_int_const> "," <positive_int_const> ">"
(97) <fixed_pt_const_type> "fixed"
@ -450,7 +474,7 @@
(204) <snames> e
"," <scoped_name> <snames>
(205) <component_inheritance_spec> ":" <scoped_name>
(206) <component_body> <component_export> <ces>
@ -458,8 +482,8 @@
(206) <ces> e
<component_export> <ces>
(207) <component_export> <provides_dcl> ";"
<uses_dcl> ";"
(207) <component_export> <provides_dcl> ";"
<uses_dcl> ";"
<emits_dcl> ";"
<publishes_dcl> ";"
<consumes_dcl> ";"

25
corba/src/share/classes/com/sun/tools/corba/se/idl/idl.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 1999-2004 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.parser
#

25
corba/src/share/classes/com/sun/tools/corba/se/idl/idl_ja.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 1999-2005 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.parser
#

25
corba/src/share/classes/com/sun/tools/corba/se/idl/idl_zh_CN.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 2005 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.parser
#

25
corba/src/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/toJavaPortable.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 1999-2004 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.toJava
#

25
corba/src/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/toJavaPortable_ja.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 2001-2005 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.toJava
#

25
corba/src/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/toJavaPortable_zh_CN.prp
View File

@ -1,3 +1,28 @@
#
# Copyright 2005 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
#
# COMPONENT_NAME: idl.toJava
#

1
hotspot/.hgtags
View File

@ -31,3 +31,4 @@ dae503d9f04c1a11e182dbf7f770509c28dc0609 jdk7-b50
fafab5d5349c7c066d677538db67a1ee0fb33bd2 jdk7-b54
f8e839c086152da70d6ec5913ba6f9f509282e8d jdk7-b55
a3fd9e40ff2e854f6169eb6d09d491a28634d04f jdk7-b56
f4cbf78110c726919f46b59a3b054c54c7e889b4 jdk7-b57

1
jdk/.hgtags
View File

@ -31,3 +31,4 @@ a2033addca678f9e4c0d92ffa1e389171cc9321d jdk7-b53
d1c43d1f5676a24ba86221ac7cad5694f3a9afda jdk7-b54
522bb5aa17e0c0cff00b1ed7d1b51bc4db2cfef9 jdk7-b55
7fd3bc37afe36f8f6165ba679db1229716db822a jdk7-b56
d5a1223e961891564de25c39fba6f2442d0fb045 jdk7-b57

3
jdk/make/docs/CORE_PKGS.gmk
View File

@ -1,5 +1,5 @@
#
# Copyright 2001-2009 Sun Microsystems, Inc. All Rights Reserved.
# Copyright 2001-2008 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
@ -55,6 +55,7 @@ EXCLUDE_PKGS = \
# This is a list of regular expressions. So foo.* matches "foo" and "foo.bar".
#
ACTIVE_JSR_PKGS= \
java.dyn \
java.sql \
javax.activation \
javax.annotation.* \

4
jdk/make/java/Makefile
View File

@ -1,5 +1,5 @@
#
# Copyright 1995-2006 Sun Microsystems, Inc. All Rights Reserved.
# Copyright 1995-2009 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
@ -39,7 +39,7 @@ SUBDIRS += hpi version jvm redist verify fdlibm java sun_nio jli main zip
# Others
# Note: java_crw_demo java_hprof_demo are demos but must be delivered built in sdk
SUBDIRS += security npt java_crw_demo java_hprof_demo \
math awt util text applet net nio \
math awt util text applet net nio dyn \
sql rmi jar beans logging management instrument

44
jdk/make/java/dyn/Makefile Normal file
View File

@ -0,0 +1,44 @@
#
# Copyright 2008-2009 Sun Microsystems, Inc. All Rights Reserved.
# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
# This code is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 2 only, as
# published by the Free Software Foundation. Sun designates this
# particular file as subject to the "Classpath" exception as provided
# by Sun in the LICENSE file that accompanied this code.
#
# This code is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
# version 2 for more details (a copy is included in the LICENSE file that
# accompanied this code).
#
# You should have received a copy of the GNU General Public License version
# 2 along with this work; if not, write to the Free Software Foundation,
# Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
#
# Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
# CA 95054 USA or visit www.sun.com if you need additional information or
# have any questions.
#
BUILDDIR = ../..
PACKAGE = java.dyn
PRODUCT = java
include $(BUILDDIR)/common/Defs.gmk
AUTO_FILES_JAVA_DIRS = java/dyn sun/dyn
# The sources built here use new language syntax to generate
# method handle calls. Let's be sure we are using that format.
#LANGUAGE_VERSION = -source 7
#CLASS_VERSION = -target 7
# Actually, it will be less disruptive to compile with the same
# -target option as the rest of the system, and just turn on
# the specific compiler option we need here:
OTHER_JAVACFLAGS = -XDinvokedynamic
include $(BUILDDIR)/common/Classes.gmk

1
jdk/make/sun/awt/FILES_c_unix.gmk
View File

@ -125,7 +125,6 @@ FILES_2D_c = \
FourByteAbgrPre.c \
BufferedMaskBlit.c \
BufferedRenderPipe.c \
RenderBuffer.c \
ShapeSpanIterator.c \
SpanClipRenderer.c \
awt_ImageRep.c \

1
jdk/make/sun/awt/FILES_c_windows.gmk
View File

@ -70,7 +70,6 @@ FILES_c = \
FourByteAbgrPre.c \
BufferedMaskBlit.c \
BufferedRenderPipe.c \
RenderBuffer.c \
ShapeSpanIterator.c \
SpanClipRenderer.c \
SurfaceData.c \

1
jdk/make/sun/awt/mapfile-vers
View File

@ -65,7 +65,6 @@ SUNWprivate_1.1 {
Java_sun_awt_image_ShortComponentRaster_initIDs;
Java_sun_java2d_pipe_BufferedMaskBlit_enqueueTile;
Java_sun_java2d_pipe_BufferedRenderPipe_fillSpans;
Java_sun_java2d_pipe_RenderBuffer_copyFromArray;
Java_sun_java2d_pipe_SpanClipRenderer_eraseTile;
Java_sun_java2d_pipe_SpanClipRenderer_fillTile;
Java_sun_java2d_pipe_ShapeSpanIterator_addSegment;

1
jdk/make/sun/awt/mapfile-vers-linux
View File

@ -117,7 +117,6 @@ SUNWprivate_1.1 {
Java_sun_java2d_loops_MaskBlit_MaskBlit;
Java_sun_java2d_loops_MaskFill_MaskFill;
Java_sun_java2d_pipe_BufferedRenderPipe_fillSpans;
Java_sun_java2d_pipe_RenderBuffer_copyFromArray;
Java_sun_java2d_pipe_SpanClipRenderer_initIDs;
sun_awt_image_GifImageDecoder_initIDs;

20
jdk/src/linux/doc/man/appletviewer.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,20 +18,21 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH appletviewer 1 "05 Aug 2006"
." Generated by html2roff
."
.TH appletviewer 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
appletviewer \- The Java Applet Viewer
.LP
.RS 3
.LP
.LP
The \f3appletviewer\fP command allows you to run applets outside of a web browser.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -59,15 +58,18 @@ http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.html.
.LP
.LP
.RS 3
.TP 3
\-debug
Starts the applet viewer in the Java debugger, \f3jdb\fP, thus allowing you to debug the applets in the document.
Starts the applet viewer in the Java debugger, jdb(1), thus allowing you to debug the applets in the document.
.TP 3
\-encoding \ \ encoding name
Specify the input HTML file encoding name.
.TP 3
\-Jjavaoption
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.
.RE
.LP
.LP

51
jdk/src/linux/doc/man/apt.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,10 +18,9 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH apt 1 "05 Aug 2006"
." Generated by html2roff
."
.TH apt 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "NAME"
@ -41,12 +38,15 @@
.LP
Options may be in any order. For a discussion of parameters which apply to a specific option, see OPTIONS below.
.LP
.RS 3
.TP 3
sourcefiles
Zero or more source files to be processed.
.TP 3
@files
One or more files that list source files or other options
.RE
.LP
.SH "DESCRIPTION"
.LP
@ -60,19 +60,19 @@ A fuller discussion of how the tool operates as well as instructions for develop
.fi
http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
.LP
.RS 3
.TP 3
Note:
\f2The functionality of \fP\f2apt\fP has been subsumed by the annotation\-processing infrastructure that is now part of the \f2javac\fP tool [
.na
\f2Solaris and Linux\fP @
.fi
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.
\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.
.RE
.LP
.SH "OPTIONS"
.LP
.SS
apt specific options
.LP
.RS 3
.TP 3
\-s dir
Specify the directory root under which processor\-generated source files will be placed; files are placed in subdirectories based on package namespace.
@ -91,17 +91,21 @@ Specify where to find annotation processor factories; if this option is used, th
.TP 3
\-factory classname
Name of annotation processor factory to use; bypasses default discovery process
.RE
.LP
.SS
Options shared with javac
.LP
.RS 3
.TP 3
\-d dir
Specify where to place processor and javac generated class files
.TP 3
\-cp path or \-classpath
path
\-cp path or \-classpath path
Specify where to find user class files and annotation processor factories. If \f2\-factorypath\fP is given, the classpath is not searched for factories.
.RE
.LP
.LP
Consult the javac(1) man page for information on \f2javac\fP options.
@ -115,24 +119,11 @@ The functionality of \f2apt\fP has been subsumed by the standard annotation\-pro
.LP
.RS 3
.TP 2
*
javac: [
.na
\f2Solaris and Linux\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [Windows]
.TP 2
*
java: [
.na
\f2Solaris\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
.na
\f2Linux\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html] [Windows]
o
javac(1), java(1)
.RE
.LP
.LP

20
jdk/src/linux/doc/man/extcheck.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH extcheck 1 "05 Aug 2006"
." Generated by html2roff
.TH extcheck 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
extcheck \- A utility to detect jar conflicts
.LP
.RS 3
.LP
.LP
\f3extcheck\fP detects version conflicts between a target jar file and currently installed extension jar files.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -67,19 +66,22 @@ If the manifest of any jar file in the extensions directory has the same \f2Spec
.LP
.LP
.RS 3
.TP 3
\-verbose
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.
.TP 3
\-Joption
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.
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.
.RE
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
jar
jar(1)
.LP
.LP

33
jdk/src/linux/doc/man/idlj.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH idlj 1 "07 Aug 2006"
." Generated by html2man
.TH idlj 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
idlj \- The IDL\-to\-Java Compiler
.LP
.RS 3
@ -54,7 +51,11 @@ where \f2idl\-file\fP is the name of a file containing Interface Definition Lang
.LP
.LP
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.
The IDL\-to\-Java Compiler generates the Java bindings for a given IDL file.\ For binding details, see the
.na
\f2OMG IDL to Java Language Language Mapping Specification\fP @
.fi
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.
.SS
Emitting Client and Server Bindings
.LP
@ -78,10 +79,18 @@ There are two possible server\-side models: the Inheritance Model and the Tie De
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.
.LP
.LP
\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.
\f2MyPOA.java\fP is a stream\-based skeleton that extends
.na
\f2org.omg.PortableServer.Servant\fP @
.fi
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.
.LP
.LP
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.
The \f2PortableServer\fP module for the
.na
\f2Portable Object Adapter (POA)\fP @
.fi
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.
.LP
.LP
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:
@ -203,7 +212,11 @@ If \f2My.idl\fP also included \f2Another.idl\fP that resided in \f2/moreIncludes
.LP
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
.LP
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.
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
.na
\f2Setting the Classpath\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general.
.RE
.SS
Emitting Bindings for Include Files

45
jdk/src/linux/doc/man/ja/appletviewer.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,55 +18,58 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH appletviewer 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
."
.TH appletviewer 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH 名前
appletviewer \- Java アプレットビューア
.SH "名前"
appletviewer \- Java アプレットビューア
.LP
.RS 3
.LP
.LP
\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
\f3appletviewer\fP コマンドは Web ブラウザの外でアプレットを実行させます。
.LP
.SH "形式"
.RE
.SH "形式"
.LP
.LP
.LP
\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
.LP
.SH "機能説明"
.SH "説明"
.LP
.LP
.LP
\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注:\f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
.fi
http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.html
の
\f3appletviewer\fP コマンドは \f2urls\fP に指定されたドキュメントあるいはリソースと接続して、そのドキュメントが参照するそれぞれのアプレットを独自のウィンドウで表示します。注: \f2urls\fP によって参照されたドキュメントが、\f2OBJECT\fP、\f2EMBED\fP、または \f2APPLET\fP タグでどのアプレットも参照していない場合、\f3appletviewer\fP は何も行いません。\f3appletviewer\fP でサポートされる HTML タグの詳細については、
.na
「\f2AppletViewer Tags\fP」を参照してください。
\f2「アプレットビューアのタグ」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.htmlを参照してください。
.LP
.LP
\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
\f3注:\fP \f3appletviewer\fP は、RFC2396 で規定されたエスケープ機構に従って符号化された URL を必要とします。サポートされるのは、符号化された URL だけです。ただし、ファイル名については、RFC2396 に指定された方法で符号化を解除しておく必要があります。
.LP
.SH "オプション"
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-debug
Java デバッガ \f3jdb\fP でアプレットビューアを開始します。 これにより、ドキュメント中のアプレットをデバッグすることができます。
Java デバッガ jdb(1) でアプレットビューアを開始します。 これにより、ドキュメント中のアプレットをデバッグすることができます。
.TP 3
\-encoding \ \ encoding name
入力 HTML ファイルのエンコーディング名を指定します。
入力 HTML ファイルのエンコーディング名を指定します。
.TP 3
\-Jjavaoption
文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数に空白文字を含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリの利用に有効です。
文字列 \f2javaoption\fP は、appletviewer を実行する Java インタプリタに 1 つの引数として渡されます。引数にスペースを含めてはいけません。複数の引数は、各引数のすべてを接頭辞 \f3\-J\fP で始めることにより区分する必要があります。これは、コンパイラの実行環境、またはメモリーの利用に有効です。
.RE
.LP
.LP

275
jdk/src/linux/doc/man/ja/apt.1
View File

@ -1,179 +1,126 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.\"
.TH apt 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
apt \- 注釈処理ツール
.\"
.SH "形式"
.B apt
.BI [\-classpath " classpath"]
.BI [\-sourcepath " sourcepath"]
.BI [\-d " directory"]
.BI [\-s " directory"]
.BI [\-factorypath " path"]
.BI [\-factory " class"]
.B [\-print]
.B [\-nocompile]
.B [\-Akey[=val] ...]
.BI [javac option]
.BI sourcefiles
.BI [@files]
.SH "パラメータ"
オプションは任意の順序で使用できます。特定のオプションに適用される
パラメータについては、後述の「オプション」を参照してください。
.if t .TP 20
.if n .TP 15
.I sourcefiles
処理される 0 個以上のソースファイル。
.if t .TP 20
.if n .TP 15
.I @files
ソースファイルまたはその他のオプションをリストする 1 個以上のファイル。
.SH "機能説明"
注釈処理ツール
.B apt
には、プログラム注釈を処理するための一連の
新しいリフレクション API とインフラストラクチャサポートが含まれています。
.B apt
のリフレクション API では、プログラム構造のビューが、
ビルド時のソースベースの読み取り専用として用意されています。
これらのリフレクション API は、総称型の追加後に、
Java(TM) プログラミング言語の型システムを
わかりやすくモデル化できるように設計されました。
はじめに、
.B apt
は注釈プロセッサを実行します。この注釈プロセッサでは、
新規のソースコードおよびその他のファイルを生成します。
次に、オリジナルのソースファイルと生成したソースファイルの両方をコンパイルし、
開発を容易にします。ツールと対話するためのリフレクション API と
その他の API は、
.B com.sun.mirror
のサブパッケージです。
." Copyright Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH apt 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.B apt
によるツールの操作方法と開発手順についての詳細は、
http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.html
の「Getting Started with apt」を参照してください。
.SH "NAME"
.LP
.LP
\f2apt\fP \- 注釈処理ツール
.LP
.SH "形式"
.LP
.LP
\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]
.LP
.SH "パラメータ"
.LP
.LP
オプションは順不同です。特定のオプションに適用されるパラメータについては、下記の「オプション」を参照してください。
.LP
.RS 3
.TP 3
注:
\f2apt\fP\f2 の機能\fPは標準の注釈処理インフラストラクチャに組み込まれました。この標準のインフラストラクチャは、今では \f2javac\fP ツール [
sourcefiles
ゼロ、1 つ、または複数の処理対象のソースファイル
.TP 3
@files
ソースファイルまたは他のオプションを一覧表示する 1 つまたは複数のファイル
.RE
.LP
.SH "説明"
.LP
.LP
注釈処理ツール \f2apt\fP は、新しいリフレクト API とサポートインフラストラクチャーから構成され、プログラム注釈を処理します。\f2apt\fP リフレクト API は、 構築時のソースベースで、プログラム構造に関する読み取り専用ビューを提供します。これらのリフレクト API は、総称を追加した後に、Java(TM) プログラミング言語の型システムを正しくモデル化するように設計されています。最初に、\f2apt\fP は、新しいソースコードと他のファイルを作成する注釈プロセッサを実行します。次に、\f2apt\fP は、元のソースファイルと生成したソースファイルの両方をコンパイルするため、開発が楽になります。ツールとのインタフェースに使用されるリフレクト API などの API は、\f2com.sun.mirror\fP のサブパッケージです。
.LP
.LP
ツールの機能に関する詳細と、\f2apt\fP を使用した開発方法については、
.na
\f2Solaris と Linux\fP の場合:
\f4「\fP\f4apt\fP\f3 入門」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html] [
.na
\f2Windows\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html] の一部となり、すべての Java コンパイラで使用できるように標準化されています。この新しいインフラストラクチャは、Java プラットフォームの一部となった言語モデルと注釈処理 API に依存しています。新しい注釈プロセッサの開発は、この新しい API と \f2javac\fP ツールに基づいて行うことをお勧めします。
http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。
.LP
.SH "オプション"
.SS apt 固有のオプション
.if t .TP 20
.if n .TP 15
.BI \-s " dir"
プロセッサが生成するソースファイルが配置されるディレクトリルートを
指定します。ファイルはパッケージのネームスペースに従って、
サブディレクトリに配置されます。
.if t .TP 20
.if n .TP 15
.BI \-nocompile
ソースファイルをクラスファイルにコンパイルしません。
.if t .TP 20
.if n .TP 15
.BI \-print
指定した型のテキスト表現を出力します。
注釈処理やコンパイルは実行しません。
.if t .TP 20
.if n .TP 15
.BI \-A[key[=val]]
注釈プロセッサに渡されるオプション。
.B apt
は、これらのオプションを直接解釈しませんが、個別のプロセッサ
によって使用可能になります。
.if t .TP 20
.if n .TP 15
.BI \-factorypath " path"
注釈プロセッサファクトリを検索する場所を指定します。
このオプションを使用する場合、ファクトリの検索に
クラスパスは使用されません。
.if t .TP 20
.if n .TP 15
.BI \-factory " classname"
使用する注釈プロセッサファクトリの名前。
デフォルトの検出処理はバイパスされます。
.SS javac と共有されるオプション
.if t .TP 20
.if n .TP 15
.BI \-d " dir"
プロセッサおよび
.B javac
が生成したクラスファイルを配置する場所を指定します。
.if t .TP 20
.if n .TP 15
.BI \-cp " path " \fLまたは\fP \fL\-classpath " path"
ユーザクラスファイルおよび注釈プロセッサファクトリを検索する場所を
指定します。
.B \-factorypath
を指定した場合、ファクトリの検索にクラスパスは使用されません。
.RS 3
.TP 3
注:
\f2apt\fP の機能は、\f2javac(1)\fP ツールの一部となった注釈処理インフラストラクチャーに組み込まれ、すべての Java コンパイラで使用できるように標準化されました。この新しいインフラストラクチャーは、言語モデルおよび Java プラットフォームの一部となった注釈処理 API に依存します。注釈プロセッサの開発は、新しい API および \f2javac\fP ツールに基づいて行うようお勧めします。
.RE
.LP
javac のオプションについては、
.BR javac(1)
のマニュアルページを参照してください。
.SH 注意事項
.SH "オプション"
.LP
\f2apt\fP の機能は、\f2javac\fP が提供するようになった標準の注釈処理インフラストラクチャに組み込まれました。\f2apt\fP とその関連 API のサポートは、JDK の将来のリリースで打ち切られる可能性があります。
.SS
apt 固有のオプション
.LP
.SH "関連項目"
.RS 3
.TP 3
\-s dir
プロセッサの生成するソースファイルを置くディレクトリルートを指定します。 ファイルは、パッケージの名前空間に基づいてサブディレクトリに置かれます。
.TP 3
\-nocompile
ソースファイルをクラスファイルにコンパイルしません。
.TP 3
\-print
指定したタイプのテキスト表現を出力します。 注釈処理またはコンパイルは行いません。
.TP 3
\-A[key[=val]]
注釈プロセッサへ渡すオプションです。 このオプションは、\f2apt\fP が直接解釈するのではなく、それぞれのプロセッサによって使用できるように変えられます。
.TP 3
\-factorypath path
注釈プロセッサファクトリを検索する場所を指定します。 このオプションを使用する場合、クラスパスのファクトリは検索されません。
.TP 3
\-factory classname
使用する注釈プロセッサファクトリの名前です。 デフォルトの検出プロセスを省略します。
.RE
.LP
.SS
javac と共用するオプション
.LP
.RS 3
.TP 3
\-d dir
プロセッサと javac 生成のクラスファイルを置く場所を指定します。
.TP 3
\-cp path or \-classpath path
ユーザークラスファイルと注釈プロセッサファクトリを検索する場所を指定します。\f2\-factorypath\fP が指定されている場合、クラスパスのファクトリは検索されません。
.RE
.LP
.LP
\f2javac\fP オプションの詳細については、javac(1) のマニュアルページを参照してください。
.LP
.SH "注"
.LP
.LP
\f2apt\fP の機能は、\f2javac\fP により提供される標準注釈処理インフラストラクチャーに組み込まれました。今後の JDK リリースでは、\f2apt\fP および関連する API のサポートが中止する可能性があります。
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
*
javac: [
.na
\f2Solaris と Linux\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/javac.html]
[ \f2Windows\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/windows/javac.html]
.TP 2
*
java: [
.na
\f2Solaris\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html] [
.na
\f2Linux\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html]
[ \f2Windows\fP の場合:
.fi
http://java.sun.com/javase/6/docs/technotes/tools/windows/java.html]
o
javac(1), java(1)
.RE
.LP

181
jdk/src/linux/doc/man/ja/extcheck.1
View File

@ -1,109 +1,88 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\" `
'\"macro stdmacro
.TH extcheck 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
extcheck \- jar の競合検出ユーティリティ
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH extcheck 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
extcheck \- jar の競合検出ユーティリティー
.LP
.RS 3
.LP
.LP
\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
extcheck [ \-verbose ] targetfile.jar
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3extcheck\fP は、ターゲットの jar ファイルと現在インストールされている拡張機能の jar ファイル間のバージョンの競合を検出します。
\f3extcheck\fP ユーティリティーは、指定された Jar ファイルのタイトルおよびバージョンが Java(TM) 2 SDK にインストールされている拡張機能と競合していないかをチェックします。拡張機能をインストールする前に、このユーティリティーを使って、バージョンが同じか、より新しい拡張機能がすでにインストールされていないかどうかを調べることができます。
.LP
.SH "形式"
.B extcheck
[
.B \-verbose
]
.B targetfile.jar
.SH "機能説明"
.IX "jar conflict detection utility" "" "jar conflict detection utility \(em \fLextcheck\fP"
.IX "extcheck" "" "\fLextcheck\fP \(em jar conflict detection utility"
.B extcheck
ユーティリティは、指定された
.B jar
ファイルのタイトルおよびバージョンが Java(TM) SDK
ソフトウェアにインストールされている拡張機能と競合していないかを
検査します。
拡張機能をインストールする前に、このユーティリティを使って、
バージョンが同じか、
より新しい拡張機能がすでにインストールされていないかどうかを調べる
ことができます。
.LP
.B extcheck
ユーティリティは、
.I targetfile.jar
ファイルのマニフェスト内のヘッダ
.I Specification-title
および
.I Specification-version
を、拡張機能ディレクトリ内に現在インストールされているすべての jar
ファイル内の対応するヘッダと比較します。
デフォルトでは、拡張機能ディレクトリは、
.I jre/lib/ext
です。
.B extcheck
ユーティリティは、
.I java.lang.Package.isCompatibleWith
メソッドと同様の方法でバージョン番号を比較します。
\f3extcheck\fP ユーティリティーは、\f2targetfile.jar\fP ファイルのマニフェスト内のヘッダー \f2Specification\-title\fP および \f2Specification\-version\fP を、拡張機能ディレクトリ内に現在インストールされているすべての Jar ファイル内の対応するヘッダーと比較します。デフォルトでは、拡張機能ディレクトリは、\f2jre/lib/ext\fP です。\f3extcheck\fP ユーティリティーは、\f2java.lang.Package.isCompatibleWith\fP メソッドと同様の方法でバージョン番号を比較します。
.LP
競合が検出されない場合、リターンコードは
.I 0 です。
.LP
拡張機能ディレクトリ内の
.B jar
ファイルのマニフェストに、同一の
.I Specification-title、
および同一またはより新しい
.I Specification-version
番号がある場合、ゼロでないエラー
コードが返されます。
.I targetfile.jar
のマニフェストに
.I Specification-title
または
.I Specification-version
属性がない場合も、ゼロでないエラーコードが返されます。
.SH "オプション"
以下のオプションが指定できます。
.TP 15
.B -verbose
拡張機能ディレクトリ内の
.B jar
ファイルを、検査時に一覧表示します。また、ターゲット
.B jar
ファイルのマニフェストの属性、および競合する
.B jar
ファイルについても報告します。
.TP 15
.BI \-J "option"
.I option
を Java 仮想マシンに渡します。ここで、
.I option
は、Java アプリケーション起動プログラム java(1) のマニュアルページで
説明されているオプションの 1 つです。たとえば、-J-Xms48m
は、起動時に使用するメモリを 48M バイトに設定します。
.SH "関連項目"
.BR jar (1)
競合が検出されない場合のリターンコードは \f20\fP です。
.LP
.LP
拡張機能ディレクトリ内のいずれかの jar ファイルのマニフェストに、同一の \f2Specification\-title\fP、および同一またはより新しい \f2Specification\-version\fP 番号がある場合は、ゼロでないエラーコードが返されます。\f2targetfile.jar\fP のマニフェストに \f2Specification\-title\fP または \f2Specification\-version\fP 属性がない場合も、ゼロでないエラーコードが返されます。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-verbose
拡張機能ディレクトリ内の Jar ファイルを、チェック時に一覧表示します。また、ターゲット jar ファイルのマニフェストの属性、および競合する jar ファイルについても報告します。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
jar(1)
.LP
.LP

1110
jdk/src/linux/doc/man/ja/idlj.1
View File

File diff suppressed because it is too large Load Diff

1155
jdk/src/linux/doc/man/ja/jar.1
View File

File diff suppressed because it is too large Load Diff

2431
jdk/src/linux/doc/man/ja/jarsigner.1
View File

File diff suppressed because it is too large Load Diff

1094
jdk/src/linux/doc/man/ja/java.1
View File

File diff suppressed because it is too large Load Diff

386
jdk/src/linux/doc/man/ja/javac.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,15 +19,45 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH javac 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2man
.TH javac 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH 名前
javac \- Java プログラミング言語コンパイラ
.SH "名前"
javac \- Java プログラミング言語コンパイラ
.LP
.SH "形式"
.RS 3
.TP 2
o
形式
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
コマンド行引数ファイル
.TP 2
o
注釈処理
.TP 2
o
型の検索
.TP 2
o
プログラマティックインタフェース
.TP 2
o
例
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
@ -44,7 +72,7 @@ javac \- Java
.LP
.LP
引数は順不同です。
引数は順不同です。
.LP
.RS 3
@ -52,61 +80,61 @@ javac \- Java
.RS 3
.TP 3
options
コマンド行オプション
コマンド行オプション。
.TP 3
sourcefiles
コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
コンパイルされる 1 つ以上のソースファイル (MyClass.java など)
.TP 3
classes
注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)。
注釈の処理対象となる 1 つ以上のクラス (MyPackage.MyClass など)
.TP 3
@argfiles
オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では、\f2\-J\fP オプションは指定できません。
オプションとソースファイルを列挙した 1 つ以上のファイル。このファイルの中では、\f2\-J\fP オプションは指定できません。
.RE
.LP
.RE
.SH "機能説明"
.SH "説明"
.LP
.LP
.LP
\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
\f3javac\fP ツールは、Java プログラミング言語で記述されたクラスとインタフェースの定義を読み取り、バイトコードのクラスファイルにコンパイルします。また、Java ソースファイルおよびクラス内の注釈の処理も行います。
.LP
.LP
ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
ソースコードのファイル名を \f3javac\fP に渡すには、次の 2 つの方法があります。
.LP
.RS 3
.TP 2
o
ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
ソースファイルの数が少ない場合は、ファイル名をコマンド行で直接指定します。
.TP 2
o
ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
ソースファイルの数が多い場合は、ファイル名を空白または改行で区切って、1 つのファイルに列挙します。次に、このリストファイル名の先頭に \f3@\fP を付けて、\f3javac\fP のコマンド行で指定します。
.RE
.LP
.LP
ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、\f2MyClass\fP という名前のクラスは、\f2MyClass.class\fP という名前のソースファイルに記述します。このソースファイルは、MyClass.class という名前のバイトコードクラスファイルにコンパイルされます。
ソースコードのファイル名は \f2.java\fP 拡張子を、クラスのファイル名は \f2.class\fP 拡張子を持っていなければなりません。 また、ソースファイルとクラスファイルのどちらも、該当するクラスに対応するルート名を持っていなければなりません。たとえば、\f2MyClass\fP という名前のクラスは、\f2MyClass.java\fP という名前のソースファイルに記述します。 このソースファイルは、\f2MyClass.class\fP という名前のバイトコードクラスファイルにコンパイルされます。
.LP
.LP
内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、\f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
内部クラスが定義されていると、追加のクラスファイルが生成されます。これらのクラスファイルの名前は、\f2MyClass$MyInnerClass.class\fP のように、外部クラス名と内部クラス名を組み合わせたものになります。
.LP
.LP
ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、\f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
ソースファイルは、パッケージツリーを反映したディレクトリツリーに配置する必要があります。たとえば、すべてのソースファイルを \f3/workspace\fP に置いている場合、\f2com.mysoft.mypack.MyClass\fP のソースコードは \f3/workspace/com/mysoft/mypack/MyClass.java\fP にある必要があります。
.LP
.LP
デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとの「オプション」を参照)。
デフォルトでは、コンパイラは、各クラスファイルを対応するソースファイルと同じディレクトリに置きます。別の出力先ディレクトリを指定するには、\f3\-d\fP を使用します (このあとのオプションを参照)。
.LP
.SH "オプション"
.SH "オプション"
.LP
.LP
.LP
コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
コンパイラには、現在の開発環境でサポートされており、将来のリリースでもサポートされる標準オプションのセットがあります。これ以外の非標準オプションは、現在の仮想マシンおよびコンパイラの実装に固有のオプションで、将来に変更される可能性があります。非標準オプションは、\f3\-X\fP で始まります。
.LP
.SS
標準オプション
標準オプション
.LP
.RS 3
@ -114,162 +142,162 @@ o
.RS 3
.TP 3
\-Akey[=value]
注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。\f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
注釈プロセッサに渡されるオプション。これらは、javac によって直接解釈されず、個々のプロセッサによって使用されます。 \f2key\fP には、1 つまたは複数の識別子を「.」で区切ったものを指定してください。
.TP 3
\-cp path または \-classpath path
ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、
\-cp path または \-classpath path
ユーザーのクラスファイルおよび (場合によっては) 注釈プロセッサやソースファイルの検索場所を指定します。このクラスパスは \f3CLASSPATH\fP 環境変数のユーザークラスパスをオーバーライドします。\f3CLASSPATH\fP、\f3\-cp\fP、\f3\-classpath\fP のいずれも指定されていない場合、ユーザークラスパスは、現在のディレクトリになります。詳細は、
.na
「\f2Setting the Class Path\fP」
\f2「クラスパスの設定」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。
.LP
\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
.LP
\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもクラスパス内で検索されます。
\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。
.LP
便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じであるとみなされます。
便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます。
.br
.br
たとえば、ディレクトリ \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 などのように、ワイルドカード文字を引用符で囲まなければならない場合があります。
たとえば、ディレクトリ \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 などのように、ワイルドカード文字を引用符で囲まなければならない場合があります。
.TP 3
\-Djava.ext.dirs=directories
インストール型拡張機能の位置をオーバーライドします。
インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-Djava.endorsed.dirs=directories
承認された標準パスの位置をオーバーライドします。
承認された標準パスの位置をオーバーライドします。
.TP 3
\-d directory
クラスファイルの出力先ディレクトリを設定します。このディレクトリはあらかじめ用意されている必要があります。\f3javac\fP はディレクトリの作成を行いません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
クラスファイルの出力先ディレクトリを設定します。そのディレクトリはすでに存在している必要があります。 \f3javac\fP はディレクトリを作成しません。クラスがパッケージの一部である場合、\f3javac\fP は、必要に応じてディレクトリを作成し、パッケージ名を反映したサブディレクトリにクラスファイルを置きます。たとえば、\f3\-d /home/myclasses\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP である場合、クラスファイルは \f2/home/myclasses/com/mypackage/MyClass.class\fP になります。
.LP
\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
\f3\-d\fP が指定されなかった場合、\f3javac\fP は各クラスファイルを、その生成元となるソースファイルと同じディレクトリ内に格納します。
.LP
\f3注:\fP \ \f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
\f3注:\fP\f3\-d\fP で指定したディレクトリはユーザークラスパスに自動的には追加されません。
.TP 3
\-deprecation
推奨されないメンバやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
推奨されないメンバーやクラスが、使用またはオーバーライドされるたびに説明を表示します。\f3\-deprecation\fP が指定されていない場合、\f3javac\fP は、推奨されないメンバーやクラスを使用またはオーバーライドしているソースファイルの要約を表示します。\f3\-deprecation\fP は \f3\-Xlint:deprecation\fP の省略表記です。
.TP 3
\-encoding encoding
ソースファイルのエンコーディング名 (\f2EUC\-JP や UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
ソースファイルのエンコーディング名 (\f2EUC\-JP\fP や \f2UTF\-8\fP など) を指定します。\f3\-encoding\fP が指定されていない場合は、プラットフォームのデフォルトコンバータが使われます。
.TP 3
\-g
局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号およびソースファイル情報だけが生成されます。
.TP 3
\-g:none
デバッグ情報を生成しません。
デバッグ情報を生成しません。
.TP 3
\-g:{keyword list}
コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
コンマで区切られたキーワードリストにより指定された、特定の種類のデバッグ情報だけを生成します。次のキーワードが有効です。
.RS 3
.TP 3
source
ソースファイルのデバッグ情報
ソースファイルのデバッグ情報
.TP 3
lines
行番号のデバッグ情報
行番号のデバッグ情報
.TP 3
vars
局所変数のデバッグ情報
局所変数のデバッグ情報
.RE
.TP 3
\-help
標準オプションの形式を表示します。
標準オプションの形式を表示します。
.TP 3
\-implicit:{class,none}
暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。このオプションが明示的に設定された場合には、警告は発行されません。「型の検索」を参照してください。
暗黙的にロードされたソースファイルに対するクラスファイルの生成を制御します。クラスファイルを自動生成するには、\f3\-implicit:class\fP を使用します。クラスファイルの生成を抑制するには、\f3\-implicit:none\fP を使用します。 このオプションが指定されなかった場合のデフォルト動作は、クラスファイルの自動生成になります。その場合、そのようなクラスファイルが生成された時に注釈処理も実行されると、コンパイラから警告が発行されます。 このオプションが明示的に設定された場合には、警告は発行されません。 「型の検索」を参照してください。
.TP 3
\-nowarn
警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
警告メッセージを無効にします。これは \f3\-Xlint:none\fP と同じ意味です。
.TP 3
\-proc: {none,only}
注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
注釈処理、コンパイル、その両方、のいずれを実行するかを制御します。\f3\-proc:none\fP は、注釈処理なしでコンパイルが実行されることを意味します。\f3\-proc:only\fP は、注釈処理だけが実行され、後続のコンパイルはまったく実行されないことを意味します。
.TP 3
\-processor class1[,class2,class3...]
実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
実行する注釈プロセッサの名前。これを指定した場合、デフォルトの検索処理は省略されます。
.TP 3
\-processorpath path
注釈プロセッサの検索場所を指定します。このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
注釈プロセッサの検索場所を指定します。 このオプションを使用しなかった場合、クラスパス内でプロセッサの検索が行われます。
.TP 3
\-s dir
生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。\f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
生成されたソースファイルの格納先となるディレクトリを指定します。そのディレクトリはすでに存在している必要があります。 \f3javac\fP は作成しません。クラスがパッケージの一部になっていた場合、コンパイラはそのソースファイルを、パッケージ名を反映したサブディレクトリ内に格納します。 その際、必要に応じてディレクトリを作成します。たとえば、ユーザーが \f3\-s /home/mysrc\fP と指定し、クラスの名前が \f2com.mypackage.MyClass\fP であった場合、そのソースファイルは \f2/home/mysrc/com/mypackage/MyClass.java\fP 内に格納されます。
.TP 3
\-source release
受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
受け付けるソースコードのバージョンを指定します。\f2release\fP には次の値を指定できます。
.RS 3
.TP 3
1.3
このコンパイラでは、JDK 1.3 以降に導入されたアサーション、汎用機能、または他の言語機能をサポート\f2しません\fP。
このコンパイラでは、JDK 1.3 以降に導入されたアサーション、総称、または他の言語機能をサポートしません。
.TP 3
1.4
JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
JDK 1.4 で導入された、アサーションを含むコードを受け付けます。
.TP 3
1.5
JDK 5 で導入された汎用機能および他の言語機能を含んだコードを受け付けます。
JDK 5 で導入された総称および他の言語機能を含んだコードを受け付けます。
.TP 3
5
1.5 と同義です。
1.5 と同義です。
.TP 3
1.6
これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
これがデフォルト値です。Java SE 6 では言語に対する変更は導入されませんでしたが、ソースファイル内のエンコーディングエラーが、以前のような「警告」ではなく、「エラー」として報告されるようになりました。
.TP 3
6
1.6 と同義です。
1.6 と同義です。
.RE
.TP 3
\-sourcepath sourcepath
クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。 ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
クラスまたはインタフェースの定義を検索するソースコードパスを指定します。ユーザークラスパスと同様に、ソースパスの複数のエントリはコロン (\f3:\fP) で区切ります。 ソースパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。パッケージを使っている場合は、ディレクトリまたはアーカイブ内のローカルパス名がパッケージ名を反映していなければなりません。
.LP
\f3注:\fP \ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
\f3注:\fP\ クラスパスからクラスだけでなくそのソースも見つかった場合、そのクラスは自動再コンパイルの対象になることがあります。「型の検索」を参照してください。
.TP 3
\-verbose
詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
詳細な出力を表示します。ロードされるクラスおよびコンパイルされるソースファイルごとの情報が出力されます。
.TP 3
\-X
非標準オプションに関する情報を表示して終了します。
非標準オプションに関する情報を表示して終了します。
.RE
.LP
.RE
.SS
クロスコンパイルオプション
クロスコンパイルオプション
.LP
.RS 3
.LP
.LP
デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「\f2クロスコンパイル\fP」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。このあとの「クロスコンパイルの例」を参照してください。
デフォルトでは、クラスのコンパイルは、\f3javac\fP が添付されているプラットフォームのブートストラップクラスおよび拡張機能クラスに対して行われます。ただし、\f3javac\fP は、異なる Java プラットフォームに実装されたブートストラップクラスおよび拡張機能クラスに対してコンパイルを行う「クロスコンパイル」もサポートしています。クロスコンパイルを行う場合は、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使うことが重要です。 このあとの「クロスコンパイルの例」を参照してください。
.LP
.RS 3
.TP 3
\-target version
指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、および \f31.6\fP (\f36\fP も可) です。
指定されたバージョンの VM をターゲットにしたクラスファイルを生成します。このクラスファイルは、指定されたターゲット以降のバージョンでは動作しますが、それより前のバージョンの VM では動作しません。有効なターゲットは、\f31.1\fP、\f31.2\fP、\f31.3\fP、\f31.4\fP、\f31.5\fP (\f35\fP も可)、および \f31.6\fP (\f36\fP も可) です。
.LP
\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
\f3\-target\fP のデフォルトは、次のように \f3\-source\fP の値によって決まります。
.RS 3
.TP 2
o
\-source が\f3指定されなかった\fP場合、\-target の値は \f31.6\fP になります。
\-source が\f3指定されなかった\fP場合、\-target の値は \f31.6\fP になります。
.TP 2
o
\-source が \f31.2\fP の場合、\-target の値は \f31.4\fP になります。
\-source が\f31.2\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
\-source が \f31.3\fP の場合、\-target の値は \f31.4\fP になります。
\-source が\f31.3\fP の場合、\-target の値は \f31.4\fP になります。
.TP 2
o
\-source が\f3それ以外の値の場合はすべて\fP、\-target の値は \f3\-source\fP の値になります。
\-source が\f3それ以外の値の場合はすべて\fP、\\\-target の値は \f3\-source\fP の値になります。
.RE
.TP 3
\-bootclasspath bootclasspath
指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
指定された一連のブートクラスに対してクロスコンパイルを行います。ユーザークラスパスと同様に、ブートクラスパスの複数のエントリはコロン (\f3:\fP) で区切ります。 ブートクラスパスのエントリには、ディレクトリ、JAR アーカイブ、または ZIP アーカイブを指定できます。
.TP 3
\-extdirs directories
指定された拡張機能ディレクトリに対してクロスコンパイルを行います。\f2directories\fP には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。
指定された拡張機能ディレクトリに対してクロスコンパイルを行います。\f2directories\fP には、コロンで区切ったディレクトリのリストを指定します。指定したディレクトリ内の各 JAR アーカイブから、クラスファイルが検索されます。
.RE
.LP
.RE
.SS
非標準オプション
非標準オプション
.LP
.RS 3
@ -277,37 +305,37 @@ o
.RS 3
.TP 3
\-Xbootclasspath/p:path
ブートストラップクラスパスの前に追加します。
ブートストラップクラスパスの前に追加します。
.TP 3
\-Xbootclasspath/a:path
ブートストラップクラスパスの後ろに追加します。
ブートストラップクラスパスの後ろに追加します。
.TP 3
\-Xbootclasspath/:path
ブートストラップクラスファイルの位置をオーバーライドします。
ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-Xlint
推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告が推奨されています。
推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告が推奨されています。
.TP 3
\-Xlint:none
Java 言語仕様では指定されていないすべての警告を無効にします。
Java 言語仕様では指定されていないすべての警告を無効にします。
.TP 3
\-Xlint:\-name
警告 \f2name\fP を無効にします。ただし、\f2name\fP は、\f3\-Xlint:\fP\f2name\fP に使用できる警告名のいずれかになります。この警告名は次のとおりです。
警告 \f2name\fP を無効にします。 ただし、\f2name\fP は、\f3\-Xlint:\fP\f2name\fP に使用できる警告名のいずれかになります。 この警告名は次のとおりです。
.TP 3
\-Xlint:unchecked
Java 言語仕様で指定されている未検査変換警告の詳細を示します。
Java 言語仕様で指定されている未検査変換警告の詳細を示します。
.TP 3
\-Xlint:path
存在しないパス (classpath、sourcepath など) ディレクトリについて警告します。
存在しないパス (classpath、sourcepath など) ディレクトリについて警告します。
.TP 3
\-Xlint:serial
\f2serialVersionUID\fP 定義が直列化可能クラスにないことを警告します。
\f2serialVersionUID\fP 定義が直列化可能クラスにないことを警告します。
.TP 3
\-Xlint:finally
正常に完了できない \f2finally\fP 節について警告します。
正常に完了できない \f2finally\fP 節について警告します。
.TP 3
\-Xlint:fallthrough
fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。このコードには \f2break\fP 文は含まれません。コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
fall\-through ケースの \f2switch\fP ブロックをチェックし、検出されたものに対して警告メッセージを表示します。Fall\-through ケースは、\f2switch\fP ブロック内の最後のケースを除くケースです。 このコードには \f2break\fP 文は含まれません。 コードの実行をそのケースから次のケースへ移動します。たとえば、この \f2switch\fP ブロック内の \f2case 1\fP ラベルに続くコードは、\f2break\fP 文で終わっていません。
.RS 3
.LP
@ -333,34 +361,34 @@ case 2:
\fP
.fi
.RE
このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
このコードのコンパイル時に \f2\-Xlint:fallthrough\fP フラグが使用されていた場合、コンパイラは 当該ケースの行番号とともに、fall\-through ケースの可能性があることを示す警告を発行します。
.TP 3
\-Xmaxerrors number
印刷するエラーの最大数を設定します。
\-Xmaxerrs number
印刷するエラーの最大数を設定します。
.TP 3
\-Xmaxwarns number
印刷する警告の最大数を設定します。
印刷する警告の最大数を設定します。
.TP 3
\-Xstdout filename
コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
コンパイラのメッセージを、指定されたファイルに送ります。デフォルトでは、コンパイラのメッセージは \f2System.err\fP に送られます。
.TP 3
\-Xprefer:{newer,source}
ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fP オプションを使用した場合、ソースファイルが読み取られます。\f2SOURCE\fP の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにしたい場合は、\f2\-Xprefer:source\fP を使用してください。
ある型に対してソースファイルとクラスファイルの両方が見つかった場合、そのどちらのファイルを読み取るべきかを指定します (「型の検索」を参照)。\f2\-Xprefer:newer\fP を使用した場合、ある型に対するソースファイルとクラスファイルの新しい方が読み取られます (デフォルト)。\f2\-Xprefer:source\fPオプションを使用した場合、ソースファイルが読み取られます。\f2SOURCE\fP の保存ポリシーを使って宣言された注釈に任意の注釈プロセッサがアクセスできるようにしたい場合は、\f2\-Xprefer:source\fPを使用してください。
.TP 3
\-Xprint
指定された型のテキスト表現をデバッグ目的で出力します。注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
指定された型のテキスト表現をデバッグ目的で出力します。 注釈処理、コンパイルのどちらも実行しません。出力形式は変更される可能性があります。
.TP 3
\-XprintProcessorInfo
ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
ある特定のプロセッサが処理を依頼されている注釈に関する情報を出力します。
.TP 3
\-XprintRounds
初回および後続の注釈処理ラウンドに関する情報を出力します。
初回および後続の注釈処理ラウンドに関する情報を出力します。
.RE
.LP
.RE
.SS
\-J オプション
\-J オプション
.LP
.RS 3
@ -368,34 +396,34 @@ case 2:
.RS 3
.TP 3
\-Joption
\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリは 48M バイトに設定されます。このオプションは \f3\-X\fP で始まっていませんが、\f3javac\fP の「標準オプション」ではありません。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。このオプションは \f3\-X\fP で始まっていませんが、\f3javac\fP の「標準オプション」ではありません。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.LP
\f3注:\fP \ \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものでは\f2ありません\fP。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
\f3注:\fP \ \f3CLASSPATH\fP、\f3\-classpath\fP、\f3\-bootclasspath\fP、および \f3\-extdirs\fP は、\f3javac\fP を実行するために使うクラスを指定するものではありません。このような方法でコンパイラの実装を操作することは、通常は無意味であり、常に危険を伴います。このような方法を使う必要がある場合は、\f3\-J\fP オプションを使って、必要なオプションを背後の \f3java\fP 起動ツールに渡してください。
.RE
.LP
.RE
.SH "コマンド行引数ファイル"
.SH "コマンド行引数ファイル"
.LP
.LP
.LP
javac のコマンド行を短くしたり簡潔にしたりするために、\f2javac\fP コマンドに対する引数 (\f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
\f2javac\fP のコマンド行を短くしたり簡潔にしたりするために、\f2javac\fP コマンドに対する引数 (\f2\-J\fP オプションを除く) を含む 1 つ以上のファイルを指定することができます。この方法を使うと、どのオペレーティングシステム上でも、任意の長さの javac コマンドを作成できます。
.LP
.LP
引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
引数ファイルには、javac のオプションとソースファイル名を自由に組み合わせて記述できます。ファイル内の各引数は、スペースまたは改行で区切ります。ファイル名に空白が含まれている場合は、そのファイル名全体を二重引用符で囲みます。
.LP
.LP
引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、\f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
引数ファイル内のファイル名は、現在のディレクトリから見た相対パスになります。引数ファイルの位置から見た相対パスではありません。引数ファイル内のファイル名リストでは、ワイルドカード (*) は使用できません。たとえば、\f2*.java\fP とは指定できません。引数ファイル内の引数で \f2@\fP 文字を使用して、複数のファイルを再帰的に解釈することはサポートされていません。また、\f2\-J\fP オプションもサポートされていません。 このオプションは起動ツールに渡されますが、起動ツールでは引数ファイルをサポートしていないからです。
.LP
.LP
javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
javac を実行するときに、各引数ファイルのパスとファイル名の先頭に \f2@\fP 文字を付けて渡します。javac は、\f2@\fP 文字で始まる引数を見つけると、そのファイルの内容を展開して引数リストに挿入します。
.LP
.SS
例 \- 引数ファイルを 1 つ指定
引数ファイルを 1 つ指定する例
.LP
.LP
\f2argfile\fP という名前の引数ファイルにすべての javac 引数を格納する場合は、次のように指定します。
\f2argfile\fP という名前の引数ファイルにすべての javac 引数を格納する場合は、次のように指定します。
.LP
.nf
\f3
@ -408,16 +436,16 @@ javac
.LP
.LP
この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
この引数ファイルには、次の例で示されている 2 つのファイルの内容を両方とも入れることができます。
.LP
.SS
例 \- 引数ファイルを 2 つ指定
引数ファイルを 2 つ指定する例
.LP
.LP
たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
たとえば、javac オプション用に 1 ファイル、ソースファイル名用に 1 ファイルというように、2 つの引数ファイルを作成することもできます。なお、このあとのリストでは、行の継続文字を使用していません。
.LP
.LP
以下の内容を含む \f2options\fP という名前のファイルを作成します。
以下の内容を含む \f2options\fP という名前のファイルを作成します。
.LP
.nf
\f3
@ -435,7 +463,7 @@ javac
.LP
.LP
以下の内容を含む \f2classes\fP という名前のファイルを作成します。
以下の内容を含む \f2classes\fP という名前のファイルを作成します。
.LP
.nf
\f3
@ -453,7 +481,7 @@ javac
.LP
.LP
次のコマンドを使用して \f3javac\fP を実行します。
次のコマンドを使用して \f3javac\fP を実行します。
.LP
.nf
\f3
@ -466,10 +494,10 @@ javac
.LP
.SS
例 \- パス付きの引数ファイル
パス付きの引数ファイルの例
.LP
.LP
引数ファイルには、パスを指定できます。ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。つまり、下の例の場合は、\f2path1\fP や \f2path2\fP から見た相対パスではありません。
引数ファイルには、パスを指定できます。 ただし、そのファイル内に指定されたファイル名は、現在の作業ディレクトリから見た相対パスになります。 つまり、下の例の場合は、\f2path1\fP や \f2path2\fP から見た相対パスではありません。
.LP
.nf
\f3
@ -481,81 +509,85 @@ javac
.fi
.LP
.SH "注釈処理"
.SH "注釈処理"
.LP
.LP
.LP
\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
\f3javac\fP が注釈処理を直接サポートしているため、独立した注釈処理ツールである \f3apt\fP を使用する必要がなくなりました。
.LP
.LP
注釈処理の API は、\f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
注釈処理の API は、\f2javax.annotation.processing\fP および \f2javax.lang.model\fP パッケージとそのサブパッケージ内に定義されています。
.LP
.SS
注釈処理の概要
注釈処理の概要
.LP
.LP
\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の \f2META_INF/services/javax.annotation.processing.Processor\fP という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
\f3\-proc:none\fP オプションによって注釈処理が無効化されないかぎり、コンパイラは使用可能なすべての注釈プロセッサを検索します。検索パスは \f3\-processorpath\fP オプションを使って指定できます。 検索パスを指定しなかった場合は、ユーザークラスパスが使用されます。プロセッサの検索は、検索パス上の
.br
\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
.br
という名前のサービスプロバイダ構成ファイルに基づいて行われます。このようなファイルには、使用するすべての注釈プロセッサの名前を、1 行に 1 つずつ含めてください。また、別の方法として、\f3\-processor\fP オプションを使ってプロセッサを明示的に指定することもできます。
.LP
.LP
コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがどの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。 その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
コンパイラは、コマンド行のソースファイルやクラスを走査することで、どのような注釈が存在しているかを確認し終わると、プロセッサに対して問い合わせを行い、それらのプロセッサがの注釈を処理できるのかを確認します。一致するものが見つかった場合、そのプロセッサが呼び出されます。各プロセッサは、自身が処理する注釈を「要求」できます。 その場合、それらの注釈に対する別のプロセッサを見つける試みは行われません。すべての注釈が要求されてしまうと、コンパイラはそれ以上プロセッサの検索を行いません。
.LP
.LP
いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
いずれかのプロセッサによって新しいソースファイルが生成されると、注釈処理の 2 回目のラウンドが開始されます。新しく生成されたすべてのソースファイルが走査され、前回と同様に注釈が処理されます。以前のラウンドで呼び出されたプロセッサはすべて、後続のどのラウンドでも呼び出されます。これが、新しいソースファイルが生成されなくなるまで続きます。
.LP
.LP
あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
あるラウンドで新しいソースファイルが生成されなかった場合、注釈プロセッサがあと 1 回だけ呼び出され、必要な処理を実行する機会が与えられます。 最後に、\f3\-proc:only\fP オプションが使用されないかぎり、コンパイラは、元のソースファイルと生成されたすべてのソースファイルをコンパイルします。
.LP
.SS
暗黙的にロードされたソースファイル
暗黙的にロードされたソースファイル
.LP
.LP
コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードしなければならない場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
コンパイラは、一連のソースファイルをコンパイルする際に、別のソースファイルを暗黙的にロードしなければならない場合があります (「型の検索」を参照)。そのようなファイルは、現時点では注釈処理の対象になりません。デフォルトでは、注釈処理が実行され、かつ暗黙的にロードされたソースファイルが 1 つでもコンパイルされた場合にコンパイラは警告を発行します。この警告を抑制する方法については、\-implicit オプションを参照してください。
.LP
.SH "型の検索"
.SH "型の検索"
.LP
.LP
.LP
ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
ソースファイルをコンパイルする場合、コマンド行で指定したソースファイルに型の定義が見つからないとき、コンパイラは通常、その型に関する情報を必要とします。コンパイラは、ソースファイルで使われているクラスまたはインタフェース、拡張されているクラスまたはインタフェース、あるいは実装されているクラスまたはインタフェースすべてについて、型の情報を必要とします。これには、ソースファイルで明示的には言及されていなくても、継承を通じて情報を提供するクラスとインタフェースも含まれます。
.LP
.LP
たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、アプレットの祖先のクラス (\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP) を使用していることになります。
たとえば、\f3java.applet.Applet\fP をサブクラスにした場合、\f3アプレットの\fP祖先のクラス（\f3java.awt.Panel\fP、\f3java.awt.Container\fP、\f3java.awt.Component\fP、\f3java.lang.Object\fP）を使用していることになります。
.LP
.LP
コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、
コンパイラは、型の情報が必要になると、その型を定義しているソースファイルまたはクラスファイルを探します。まず、ブートストラップクラスと拡張機能クラスを検索し、続いてユーザークラスパス (デフォルトではカレントディレクトリ) を検索します。ユーザークラスパスは、\f3CLASSPATH\fP 環境変数を設定して定義するか、または \f3\-classpath\fP コマンド行オプションを使って設定します。詳細は、
.na
「\f2Setting the Class Path\fP」
\f2「クラスパスの設定」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath) を参照してください。
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpathを参照してください。
.LP
.LP
\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
\-sourcepath オプションが指定されている場合、コンパイラは、指定されたパスからソースファイルを検索します。 それ以外の場合は、ユーザークラスパスからクラスファイルとソースファイルの両方を検索します。
.LP
.LP
\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。このあとの「クロスコンパイルオプション」を参照してください。
\f3\-bootclasspath\fP オプションと \f3\-extdirs\fP オプションを使うと、別のブートストラップクラスや拡張機能クラスを指定できます。 このあとの「クロスコンパイルオプション」を参照してください。
.LP
.LP
型の検索に成功した場合の結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
型の検索に成功したときに得られる結果は、クラスファイル、ソースファイル、またはその両方である場合があります。両方が見つかった場合、そのどちらを使用すべきかを \-Xprefer オプションでコンパイラに指示できます。\f3newer\fP が指定された場合、コンパイラは 2 つのファイルの新しい方を使用します。\f3source\fP が指定された場合、コンパイラはソースファイルを使用します。デフォルトは \f3newer\fP です。
.LP
.LP
型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
型の検索自体によって、または \f3\-Xprefer\fP が設定された結果として必要な型のソースファイルが見つかった場合、コンパイラはそのソースファイルを読み取り、必要な情報を取得します。さらに、コンパイラはデフォルトで、そのソースファイルのコンパイルも行います。\-implicit オプションを使えばその動作を指定できます。\f3none\fP を指定した場合、そのソースファイルのクラスファイルは生成されません。\f3class\fP を指定した場合、そのソースファイルのクラスファイルが生成されます。
.LP
.LP
コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識する場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
コンパイラは、注釈処理の完了後に、ある型情報の必要性を認識しない場合があります。その型情報があるソースファイル内に見つかり、かつ \f3\-implicit\fP オプションが指定されていない場合は、そのファイルが注釈処理の対象とならずにコンパイルされることを、コンパイラがユーザーに警告します。この警告を無効にするには、(そのファイルが注釈処理の対象となるように) そのファイルをコマンド行に指定するか、あるいはそのようなソースファイルに対してクラスファイルを生成すべきかどうかを \f3\-implicit\fP オプションを使って指定します。
.LP
.SH "プログラマティックインタフェース"
.SH "プログラマティックインタフェース"
.LP
.LP
.LP
\f3javac\fP は、\f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
\f3javac\fP は、\f2javax.tools\fP パッケージ内のクラスとインタフェースによって定義される新しい Java Compiler API をサポートします。
.LP
.SS
例
例
.LP
.LP
コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
コマンド行から指定された引数を使ってコンパイルを実行するには、次のようなコードを使用します。
.LP
.nf
\f3
@ -571,22 +603,22 @@ int rc = javac.run(null, null, null, args);
.LP
.LP
この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
この場合、標準出力ストリームにすべての診断メッセージが書き出され、コマンド行から呼び出された \f3javac\fP が返すのと同じ終了コードが返されます。
.LP
.LP
\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
\f2javax.tools.JavaCompiler\fP インタフェース上のほかのメソッドを使えば、診断メッセージの処理やファイルの読み取り元/書き込み先の制御などを行えます。
.LP
.SS
旧式のインタフェース
旧式のインタフェース
.LP
.RS 3
.LP
.LP
\f3注:\fP \ この API は、下位互換性を確保するためだけに残されています。新しいコードでは、必ず前述の Java Compiler API を使用してください。
\f3注:\fP \ この API は、下位互換性を確保するためだけに残されています。 新しいコードでは、必ず前述の Java Compiler API を使用してください。
.LP
.LP
\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。それらを次に示します。
\f2com.sun.tools.javac.Main\fP クラスには、プログラム内からコンパイラを呼び出すための static メソッドが 2 つ用意されています。 それらを次に示します。
.LP
.nf
\f3
@ -602,28 +634,28 @@ public static int compile(String[] args, PrintWriter out);
.LP
.LP
\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。その概要については、前出の「形式」節を参照してください。
\f2args\fP パラメータは、javac プログラムに通常渡される任意のコマンド行引数を表しています。 その概要については、前出の「形式」節を参照してください。
.LP
.LP
\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
\f2out\fP パラメータは、コンパイラの診断メッセージの出力先を示します。
.LP
.LP
戻り値は、\f3javac\fP の終了値と同じです。
戻り値は、\f3javac\fP の終了値と同じです。
.LP
.LP
名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれる\f3その他の\fPクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
名前が \f2com.sun.tools.javac\fP で始まるパッケージ (非公式には \f2com.sun.tools.javac\fP のサブパッケージとして知られる) に含まれる\f3その他の\fPクラスやメソッドは、どれも完全に内部用であり、いつでも変更される可能性があります。
.LP
.RE
.SH "例"
.SH "例"
.LP
.SS
簡単なプログラムのコンパイル
簡単なプログラムのコンパイル
.LP
.RS 3
.LP
.LP
\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。\f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
\f2Hello.java\fP というソースファイルで、\f3greetings.Hello\fP という名前のクラスを定義しているとします。\f2greetings\fP ディレクトリは、ソースファイルとクラスファイルの両方があるパッケージディレクトリで、現在のディレクトリのすぐ下にあります。このため、この例では、デフォルトのユーザークラスパスを使用できます。また、\f3\-d\fP を使って別の出力先ディレクトリを指定する必要もありません。
.LP
.RS 3
@ -681,13 +713,13 @@ Hello Everyone
.LP
.RE
.SS
複数のソースファイルのコンパイル
複数のソースファイルのコンパイル
.LP
.RS 3
.LP
.LP
次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
次の例では、パッケージ \f2greetings\fP 内のすべてのソースファイルをコンパイルします。
.LP
.RS 3
@ -721,13 +753,13 @@ Aloha.java GutenTag.java Hello.java Hi.java
.LP
.RE
.SS
ユーザークラスパスの指定
ユーザークラスパスの指定
.LP
.RS 3
.LP
.LP
上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
上の例のソースファイルのうち 1 つを変更し、変更後のファイルを再コンパイルするとします。
.LP
.RS 3
@ -748,7 +780,7 @@ Aloha.java GutenTag.java Hello.java Hi.java
.LP
.LP
\f2greetings.Hi\fP は、\f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
\f2greetings.Hi\fP は、\f2greetings\fP パッケージ内のほかのクラスを参照しているため、コンパイラはこれらのクラスを探す必要があります。上の例では、デフォルトのユーザークラスパスが、パッケージディレクトリを含むディレクトリと同じであるため、コンパイルは正常に実行されます。ただし、現在どのディレクトリにいるかに関係なく、このファイルを再コンパイルする場合は、ユーザークラスパスに \f2/examples\fP を追加する必要があります。ユーザークラスパスにエントリを追加するには、\f3CLASSPATH\fP を設定する方法もありますが、ここでは \f3\-classpath\fP オプションを使うことにします。
.LP
.RS 3
@ -765,7 +797,7 @@ Aloha.java GutenTag.java Hello.java Hi.java
.LP
.LP
再度 \f2greetings.Hi\fp を変更してバナーユーティリティを使うようにした場合は、このバナーユーティリティもユーザークラスパスを通じてアクセスできるようになっている必要があります。
再度 \f2greetings.Hi\fP を変更してバナーユーティリティーを使うようにした場合は、このバナーユーティリティーもユーザークラスパスを通じてアクセスできるようになっている必要があります。
.LP
.RS 3
@ -784,7 +816,7 @@ Aloha.java GutenTag.java Hello.java Hi.java
.LP
.LP
\f2greetings\fP 内のクラスを実行するには、\f2greetings\fP と、\f2greetings\fP が使うクラスの両方にアクセスできる必要があります。
\f2greetings\fP 内のクラスを実行するには、\f2greetings\fP と、\f2greetings\fP が使うクラスの両方にアクセスできる必要があります。
.LP
.RS 3
@ -802,13 +834,13 @@ Aloha.java GutenTag.java Hello.java Hi.java
.LP
.RE
.SS
ソースファイルとクラスファイルの分離
ソースファイルとクラスファイルの分離
.LP
.RS 3
.LP
.LP
特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
特に大規模プロジェクトの場合は、ソースファイルとクラスファイルを別々のディレクトリに置くと便利なことがあります。クラスファイルの出力先を別に指定するには、\f3\-d\fP を使います。ソースファイルはユーザークラスパスにはないので、\f3\-sourcepath\fP を使って、コンパイラがソースファイルを見つけることができるようにします。
.LP
.RS 3
@ -855,17 +887,17 @@ Base.class GoodBye.class
.LP
.LP
\f3注:\fP \ コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
\f3注:\fP \ コマンド行では \f2src/farewells/Base.java\fP を指定していませんが、このファイルもコンパイラによってコンパイルされています。自動コンパイルを監視するには、\f3\-verbose\fP オプションを使います。
.LP
.RE
.SS
クロスコンパイルの例
クロスコンパイルの例
.LP
.RS 3
.LP
.LP
ここでは、javac を使って、1.5 VM 上で実行するコードをコンパイルします。
ここでは、\f3javac\fP を使って、1.5 VM 上で実行するコードをコンパイルします。
.LP
.RS 3
@ -884,13 +916,13 @@ Base.class GoodBye.class
.LP
.LP
\f3\-target 1.5\fP オプションにより、1.5 VM と互換性のあるクラスファイルが生成されます。デフォルトでは、\f3javac\fP は JDK 6 用にコンパイルします。
\f3\-target 1.5\fP オプションにより、1.5 VM と互換性のあるクラスファイルが生成されます。デフォルトでは、\f3javac\fP は JDK 6 用にコンパイルします。
.LP
.LP
Java プラットフォーム JDK の \f3javac\fP は、デフォルトではそれ自身のブートストラップクラスに対してコンパイルを行うので、代わりに JDK 1.5 のブートストラップクラスに対してコンパイルを行うように \f3javac\fP を設定する必要があります。これは、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使って指定します。この指定を行わないと、1.5 VM には存在しない Java プラットフォーム API に対応したコンパイルが行われるため、プログラムの実行時に失敗するでしょう。
Java プラットフォーム JDK の \f3javac\fP は、デフォルトでは、Java 2 SDK のブートストラップクラスに対してコンパイルを行うので、Java 2 SDK ではなく JDK 1.5 のブートストラップクラスに対してコンパイルを行うように指定する必要があります。これは、\f3\-bootclasspath\fP および \f3\-extdirs\fP を使って指定します。この指定を行わないと、1.5 VM には存在しない Java 2 プラットフォーム API に対応したコンパイルが行われるため、プログラムの実行時に障害が発生することがあります。
.LP
.RE
.SH "関連項目"
.SH "関連項目"
.LP
.LP
@ -898,33 +930,33 @@ Java
.TP 2
o
.na
「\f2The javac Guide\fP」
\f2「The javac Guide」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html)
http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
.TP 2
o
java(1) \- Java アプリケーション起動プログラム
「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
jdb(1) \- Java デバッガ
「jdb(1) \- Java デバッガ」
.TP 2
o
javah(1) \- C 言語のヘッダとスタブファイルのジェネレータ
「javah(1) \- C ヘッダーとスタブファイルジェネレータ」
.TP 2
o
javap(1) \- Java クラスファイル逆アセンブラ
「javap(1) \- クラスファイル逆アセンブラ」
.TP 2
o
javadoc(1) \- Java API ドキュメントジェネレータ
「javadoc(1) \- Java API ドキュメントジェネレータ」
.TP 2
o
jar(1) \- JAR アーカイブツール
「jar(1) \- JAR アーカイブツール」
.TP 2
o
.na
「\f2The Java Extensions Framework\fP」
\f2「Java 拡張機能フレームワーク」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html)
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.RE
.LP

9341
jdk/src/linux/doc/man/ja/javadoc.1
View File

File diff suppressed because it is too large Load Diff

341
jdk/src/linux/doc/man/ja/javah.1
View File

@ -1,227 +1,160 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
'\"macro stdmacro
.TH javah 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
javah \- C 言語のヘッダとスタブファイルのジェネレータ
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH javah 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
javah \- C ヘッダーとスタブファイルジェネレータ
.LP
.RS 3
.LP
.LP
\f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
.fl
javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3javah\fP は、Java クラスから C ヘッダファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
\f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。
.LP
.SH "形式"
.B javah
[
.B options
]
.I fully-qualified-classname . . .
.br
.B javah_g
[
.B options
]
.I fully-qualified-classname . . .
.SH "機能説明"
.IX "stub file generator" "" "stub file generator \(em \fLjavah\fP"
.IX "C header and stub file generator" "" "C header and stub file generator \(em \fLjavah\fP"
.IX "javah" "" "\fLjavah\fP \(em C header and stub file generator"
.B javah
コマンドは、ネイティブメソッドを実装するのに必要な
C
言語のヘッダおよびソースファイルを生成します。
C
のプログラムは、
生成されたヘッダとソースファイルを使って、
ネイティブソースコードからオブジェクトのインスタンス
変数を参照できます。
.B .h
ファイルは、対応するクラスに合ったレイアウトの
構造体定義を含んでいます。
構造体に含まれるフィールドは、クラス内のインスタンス変数に
対応しています。
.LP
ヘッダファイル名およびヘッダファイル中で定義される構造体名は、
クラス名から派生します。
.B javah
に渡されるクラスがパッケージ内部にあれば、
そのパッケージ名がファイル名および構造体名の先頭に付加されます。
名前の間は下線
(_)
で区切られます。
ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。
.LP
デフォルトでは、
.B javah
はコマンド行で指定された個々のクラスに対して
ヘッダファイルを作成し、現在のディレクトリに出力します。
.B \-stubs
オプションを指定するとソースファイルが生成されます。
.B \-o
オプションを指定すると、指定した全クラスに対する出力ファイル
を連結して
1
個のファイルとして生成します。
.LP
新しいネイティブメソッドインタフェースの
Java Native Interface (JNI)
は、ヘッダ情報やスタブファイルを必要としません。
ただし
.B javah
コマンドは現在も JNI 形式のネイティブメソッドに必要な
ネイティブメソッド関数プロトタイプを生成できます。
.B javah
はデフォルトで JNI 形式で出力し、その結果を
.B .h
ファイルに格納します。
デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。
.LP
.B javah_g
は非最適化バージョンの
.B javah
で、
.B jdb
などのデバッガ用の使用に適しています。
.SH "オプション"
.TP 15
.BI \-o " outputfile"
コマンド行で指定したすべてのクラスに対する結果のヘッダファイルまたは
ソースファイルを連結し、
.BR outputfile
に格納します。
.B \-o
オプションまたは
.B \-d
オプションだけを使用できます。
.TP 15
.BI \-d " directory"
.B javah
がヘッダファイルまたはスタブファイルを書き出す
ディレクトリを指定します。
.TP 15
.B \-stubs
Java オブジェクトファイルから C 言語の宣言を生成します。
.TP 15
.B \-verbose
詳細情報の出力を要求します。
.B javah
は、生成されたファイルの状態に関するメッセージを
.B stdout
に書き出します。
.TP 15
.B \-help
.B javah
の使用法についてヘルプメッセージを出力します。
.TP 15
.B \-version
javah バージョン情報を出力します。
.TP 15
.B \-jni
JNI 形式のネイティブなメソッド関数のプロトタイプが入った出力ファイルを
作成します。これはデフォルトの出力であるため、
-B \-jni
は省略可能です。
.TP 15
.BI \-classpath " path"
.B javah
がクラスを検索するために用いるパスを
.I path
で指定します。この指定値は、デフォルトおよび
.B CLASSPATH
環境変数の設定値をオーバーライドします。
複数のディレクトリを指定する場合はコロンで区切ります。
したがって
.I path
の通常の形式は次のようになります。
.RS 20
.sp 1n
.LP
.BI .:< your_path >
.sp 1n
.RE
.RS 15
新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。 現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。 デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。
.LP
パスの指定例：
.RE
.RS 20
.sp 1n
.LP
.B .:/home/avh/classes:/usr/local/java/classes
.sp 1n
.RE
\f3javah_g\fP は、jdb(1) のようなデバッガに適した、\f3javah\fP の最適化されていないバージョンです。
.LP
便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-o outputfile
コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して \f2outputfile\fP に格納します。\f3\-o\fP または \f3\-d\fP のどちらか一方だけが使われます。
.TP 3
\-d directory
\f3javah\fP がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。\f3\-d\fP または \f3\-o\fP のどちらか一方だけが使われます。
.TP 3
\-stubs
\f3javah\fP が、Java オブジェクトファイルから C 宣言を生成します。
.TP 3
\-verbose
詳細出力を指定し、作成ファイルの状態に関するメッセージを、\f3javah\fP が標準出力に出力します。
.TP 3
\-help
\f3javah\fP の使用法についてのヘルプメッセージを出力します。
.TP 3
\-version
\f3javah\fP のバージョン情報を出力します。
.TP 3
\-jni
JNI 形式のネイティブファイル機能プロトタイプを含む出力ファイルを、\f3javah\fP が作成します。これは標準出力であるため、\f3\-jni\fP の使用はオプションです。
.TP 3
\-classpath path
クラスを探すために \f3javah\fP が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
.:<your_path>
.fl
\fP
.fi
例を示します。
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.LP
便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
.br
.br
たとえば、ディレクトリ \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 プログラムは認識しません。
.TP 15
.BI \-bootclasspath " path"
bootstrap クラスをロードするパスを指定します。デフォルトでは、bootstrap
クラスはコアとなる Java 2 プラットフォームを実装するクラスで、
.B jre/lib/rt.jar
および他の重要な jar ファイルに含まれています。
.TP 15
.B \-old
古い JDK 1.0 形式のヘッダファイルを生成します。
.TP 15
.B \-force
常に出力ファイルに書き込むことを指定します。
.TP 15
.BI \-J "option"
.I option
を Java 仮想マシンに渡します。ここで、
.I option
は、Java アプリケーション起動プログラムの参照ページで
説明されているオプションの 1 つです。たとえば、
.I \-J-Xms48m
は、起動時に使用するメモリを 48M バイトに設定します。
.SH "環境変数"
.TP 15
.B CLASSPATH
ユーザ定義クラスへのパスをシステムに通知するために使用します。
複数のディレクトリを指定する場合はコロンで区切ります。
以下に例を示します。
.RS 10
.sp 1n
.LP
.B .:/home/avh/classes:/usr/local/java/classes
たとえば、ディレクトリ \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 プログラムが展開されていないワイルドカードを認識することはありません。
.TP 3
\-bootclasspath path
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-old
古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
.TP 3
\-force
出力ファイルが常に書き込まれるように指定します。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.SH "関連項目"
.LP
.SH "環境変数"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割されています。
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
javac、java、jdb、javap、javadoc
javac(1)、java(1)、jdb(1)、javap(1)、javadoc(1)
.LP
.LP

280
jdk/src/linux/doc/man/ja/javap.1
View File

@ -1,117 +1,137 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
'\"macro stdmacro
.TH javap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
javap \- Java クラスファイル逆アセンブラ
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH javap 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
javap \- Java クラスファイル逆アセンブラ
.LP
.RS 3
.LP
.LP
クラスファイルを逆アセンブルします。
クラスファイルを逆アセンブルします。
.LP
.RE
.SH "形式"
.LP
.LP
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
.SH "形式"
.B javap
[
.B options
]
.IR class .\|.\|.
.SH "機能説明"
.IX "Java class file disassembler" "" "Java class file disassembler \(em \fLjavap\fP"
.IX "javap" "" "\fLjavap\fP \(em Java class file disassembler"
.B javap
コマンドは、
Java クラスファイルを逆アセンブルします。
出力内容はオプションで指定します。
オプションを
1
つも指定しないと、
.B javap
は渡されたクラスの
.BR package、
.BR protected、
および
.B public
フィールドとメソッドを出力します。
.B javap
コマンドの出力先は
.B stdout
です。たとえば、以下のクラス宣言をコンパイルします。
.RS
.nf
\f3
.fl
javap [ \fP\f3options\fP\f3 ] class. . .
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3javap\fP コマンドは、クラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。 \f3javap\fP はその出力を標準出力に表示します。たとえば、次のクラス宣言をコンパイルするとします。
.LP
.RS 3
.LP
.nf
\f3
.fl
import java.awt.*;
.fl
import java.applet.*;
.fl
.fl
public class DocFooter extends Applet {
String date;
String email;
.fl
String date;
.fl
String email;
.fl
public void init() {
resize(500,100);
date = getParameter("LAST_UPDATED");
email = getParameter("EMAIL");
}
.fl
public void init() {
.fl
resize(500,100);
.fl
date = getParameter("LAST_UPDATED");
.fl
email = getParameter("EMAIL");
.fl
}
.fl
public void paint(Graphics g) {
g.drawString(date + " by ",100, 15);
g.drawString(email,290,15);
}
.fl
public void paint(Graphics g) {
.fl
g.drawString(date + " by ",100, 15);
.fl
g.drawString(email,290,15);
.fl
}
.fl
}
\f1
.fl
\fP
.fi
.RE
.LP
.LP
\f3javap DocFooter\fP がもたらす出力は次のようになります。
.LP
.RS 3
.LP
この場合、
.B javap DocFooter
を実行すると以下の出力が得られます。
.RS
\f3
.nf
\f3
.fl
Compiled from DocFooter.java
.fl
public class DocFooter extends java.applet.Applet {
java.lang.String date;
java.lang.String email;
public void init();
public void paint(java.awt.Graphics);
public DocFooter();
.fl
java.lang.String date;
.fl
java.lang.String email;
.fl
public DocFooter();
.fl
public void init();
.fl
public void paint(java.awt.Graphics);
.fl
}
\f1
.fl
\fP
.fi
.RE
.LP
\f3javap \-c DocFooter\fP を実行すると以下の出力が得られます。
.LP
\f3javap \-c DocFooter\fP がもたらす出力は次のようになります。
.LP
.RS 3
@ -228,34 +248,35 @@ Method void paint(java.awt.Graphics)
.RE
.LP
.SH "オプション"
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-help
\f3javap\fP のヘルプメッセージを出力します。
\f3javap\fP のヘルプメッセージを出力します。
.TP 3
\-l
行番号と局所変数テーブルを表示します。
行番号と局所変数テーブルを表示します。
.TP 3
\-b
JDK 1.1 の \f3javap\fP との下位互換性を保証します。
JDK 1.1 の \f3javap\fP との下位互換性を保証します。
.TP 3
\-public
public クラスおよびメンバだけを表示します。
public クラスおよびメンバーだけを表示します。
.TP 3
\-protected
protected および public のクラスとメンバだけを表示します。
protected および public のクラスとメンバーだけを表示します。
.TP 3
\-package
package、protected、および public のクラスとメンバだけを表示します。これはデフォルトの設定です。
package、protected、および public のクラスとメンバーだけを表示します。これはデフォルトの設定です。
.TP 3
\-private
すべてのクラスとメンバを表示します。
すべてのクラスとメンバーを表示します。
.TP 3
\-Jflag
ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
ランタイムシステムに直接 \f2flag\fP を渡します。使用例を次に示します。
.RS 3
.LP
@ -271,21 +292,20 @@ javap \-J\-Djava.security.manager \-J\-Djava.security.policy=MyPolicy MyClassNam
.RE
.TP 3
\-s
内部の型シグニチャーを出力します。
内部の型シグニチャーを出力します。
.TP 3
\-c
クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
.fi
http://java.sun.com/docs/books/vmspec/
の
クラスの各メソッドのために逆アセンブルされるコード、すなわち Java バイトコードから成る命令を表示します。これらは
.na
「\f2Java Virtual Machine Specification\fP」にドキュメント化されています。
\f2「Java Virtual Machine Specification」\fP @
.fi
http://java.sun.com/docs/books/vmspec/にドキュメント化されています。
.TP 3
\-verbose
メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
.TP 3
\-classpath path
\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.nf
\f3
.fl
@ -293,7 +313,7 @@ http://java.sun.com/docs/books/vmspec/
.fl
\fP
.fi
次に例を示します。
例を示します。
.nf
\f3
.fl
@ -303,27 +323,41 @@ http://java.sun.com/docs/books/vmspec/
.fi
.TP 3
\-bootclasspath path
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java プラットフォームを実装するクラスです。
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
.TP 3
\-extdirs dirs
インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
.LP
.SH "環境変数"
.TP 15
.B CLASSPATH
ユーザ定義クラスへのパスをシステムに通知するために使用します。
複数のディレクトリを指定する場合はコロンで区切ります。
以下に例を示します。
.sp 1n
.RS 10
.B .:/home/avh/classes:/usr/local/java/classes
インストールされた拡張機能を検索する場所をオーバーライドします。The default location for extensions is the value of \f2java.ext.dirs\fP.
.RE
.SH "関連項目"
.LP
.SH "環境変数"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。 次に例を示します。
.RS 3
.LP
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.RE
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
javac、java、jdb、javah、javadoc
javac(1)、 java(1)、jdb(1)、javah(1)、javadoc(1)
.LP
.LP

193
jdk/src/linux/doc/man/ja/javaws.1
View File

@ -1,31 +1,51 @@
'\" t
.\"
.\" Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.TH javaws 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
\fBjavaws \fP- Java Web Start 起動コマンド
\fB
.SH 形式
." Copyright Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH javaws 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.LP
.SH "名前"
\f2javaws\fP コマンド行
.LP
.LP
.LP
\
.LP
.SS
NAME
.LP
.RS 3
.LP
.LP
\f2javaws\fP \- Java Web Start 起動コマンド
.LP
.RE
.SS
形式
.LP
.RS 3
.LP
@ -36,21 +56,20 @@
\f2javaws [control\-options]\fP
.LP
.RE
.SS
パラメータ
.SS
パラメータ
.LP
.RS 3
.LP
.LP
[run\-options]
\f2[run\-options]\fP
.LP
.RS 3
.LP
.LP
コマンド行実行オプション。
実行オプションの順序は任意です。個々の実行オプションについては、後述の「実行オプション」節を参照してください。
コマンド行実行オプション。 実行オプションは任意の順序で指定できます。各種オプションについては、下の 「実行オプション」を参照してください。
.LP
.RE
.LP
@ -60,7 +79,7 @@
.LP
.LP
パスまたは JNLP (Java Network Launching Protocol) ファイルの URL (Uniform Resource Locater) を指定できます。
JNLP (Java Network Launching Protocol) ファイルのパスまたは URL (Uniform Resource Locator) のどちらかです。
.LP
.RE
.LP
@ -70,28 +89,28 @@
.LP
.LP
コマンド行制御オプション。制御オプションの順序は任意です。個々の制御オプションについては、後述の「制御オプション」節を参照してください。
コマンド行制御オプション。 制御オプションは任意の順序で指定できます。各種オプションについては、下の 「制御オプション」を参照してください。
.LP
.RE
.RE
.SS
機能説明
.SS
説明
.LP
.RS 3
.LP
.LP
\fBjavaws\fP コマンドにより JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動できます。Java Web Start はネットワーク上に置かれる Java アプリケーションまたはアプレットを起動します。
\f2javaws\fP コマンドは、JNLP (Java Network Launching Protocol) のリファレンス実装である Java Web Start を起動します。Java Web Start は、ネットワーク上で動作する Java アプリケーションまたはアプレットを起動します。
.LP
.LP
JNLP ファイルを指定すると、\fBjavaws\fP は JNLP ファイルに指定されている Java アプリケーションまたはアプレットを起動します。
JNLP ファイルを指定すると、\f2javaws\fP は JNLP ファイルに指定された Java アプリケーションまたはアプレットを起動します。
.LP
.LP
現在のリリースでサポートされている \f2javaws\fP 起動ツールの一連のオプションは、将来のリリースで削除される可能性があります。
\f2javaws\fP 起動ツールには、現在のリリースでサポートされている 1 組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
.LP
.RE
.SS
実行オプション
.SS
実行オプション
.LP
.RS 3
@ -103,7 +122,7 @@ JNLP
.LP
.LP
Java Web Start をオフラインモードで実行します。
Java Web Start をオフラインモードで実行します。
.LP
.RE
.LP
@ -113,7 +132,7 @@ Java Web Start
.LP
.LP
初期スプラッシュ画面の表示を無効にします。
最初のスプラッシュ画面の表示を無効にします。
.LP
.RE
.LP
@ -123,8 +142,7 @@ Java Web Start
.LP
.LP
jnlp ファイルの引数を \f2\-open <arguments> と置き換えます。
\fP.
このオプションを指定すると、JNLP ファイル内の引数が \f2\-open <arguments>\fP に置き換わります。
.LP
.RE
.LP
@ -134,7 +152,7 @@ jnlp
.LP
.LP
jnlp ファイルの引数を \f2\-print <arguments>\fP と置き換えます。
このオプションを指定すると、JNLP ファイル内の引数が \f2\-print <arguments>\fP に置き換わります。
.LP
.RE
.LP
@ -144,7 +162,7 @@ jnlp
.LP
.LP
オンラインモードで実行します (デフォルトの動作)。
オンラインモードで実行します (デフォルトの動作)。
.LP
.RE
.LP
@ -154,7 +172,7 @@ jnlp
.LP
.LP
アプリケーションが終了するまで \f2javaws\fP プロセスは終了しません。
このオプションを指定すると、アプリケーションが終了するまで \f2javaws\fP プロセスは終了しません。
.LP
.RE
.LP
@ -164,7 +182,7 @@ jnlp
.LP
.LP
追加の出力を表示します。
追加の出力を表示します。
.LP
.RE
.LP
@ -174,7 +192,7 @@ jnlp
.LP
.LP
vm にオプションを補います。
vm にオプションを補います。
.LP
.RE
.LP
@ -184,12 +202,12 @@ vm
.LP
.LP
アプリケーションをシステムキャッシュからのみ実行します。
アプリケーションをシステムキャッシュからのみ実行します。
.LP
.RE
.RE
.SS
制御オプション
.SS
制御オプション
.LP
.RS 3
@ -201,7 +219,7 @@ vm
.LP
.LP
Java コントロールパネルでキャッシュビューアを表示します。
Java コントロールパネルでキャッシュビューアを表示します。
.LP
.RE
.LP
@ -211,7 +229,7 @@ Java
.LP
.LP
指定された配備プロパティをクリアします。
指定された配備プロパティーをクリアします。
.LP
.RE
.LP
@ -221,7 +239,7 @@ Java
.LP
.LP
指定された配備プロパティを指定された値に設定します。
指定された配備プロパティーを指定された値に設定します。
.LP
.RE
.LP
@ -231,7 +249,7 @@ Java
.LP
.LP
キャッシュからすべてのアプリケーションを削除します。
キャッシュからすべてのアプリケーションを削除します。
.LP
.RE
.LP
@ -241,7 +259,7 @@ Java
.LP
.LP
キャッシュからアプリケーションを削除します。
キャッシュからアプリケーションを削除します。
.LP
.RE
.LP
@ -251,10 +269,10 @@ Java
.LP
.LP
キャッシュにアプリケーションをインポートします。
キャッシュにアプリケーションをインポートします。
.LP
.RE
インポートオプション
\f3インポートオプション\fP
.LP
.LP
\f2\-silent\fP
@ -263,7 +281,7 @@ Java
.LP
.LP
サイレントモードでインポートします (UI は表示されません)。
サイレントモードでインポートします (UI は表示されません)。
.LP
.RE
.LP
@ -273,7 +291,7 @@ Java
.LP
.LP
システムキャッシュにアプリケーションをインポートします。
システムキャッシュにアプリケーションをインポートします。
.LP
.RE
.LP
@ -283,7 +301,7 @@ Java
.LP
.LP
任意の codebase からリソースを取得します。
任意の codebase からリソースを取得します。
.LP
.RE
.LP
@ -293,7 +311,7 @@ Java
.LP
.LP
ユーザ許容プロンプトのようにショートカットをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
ユーザー許容プロンプトのようにショートカットをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
.LP
.RE
.LP
@ -303,20 +321,43 @@ Java
.LP
.LP
ユーザ許容プロンプトのように関連付けをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
ユーザー許容プロンプトのように関連付けをインストールします。このオプションは、\f2\-silent\fP オプションと一緒に使用しないと効果がありません。
.LP
.RE
.RE
.SS
.SH ファイル
.SS
ファイル
.LP
ユーザキャッシュ、システムキャッシュ、および deployment.properties ファイルの詳細は、
.RS 3
.LP
.LP
ユーザーキャッシュ、システムキャッシュ、および deployment.properties ファイルについては、
.na
「\f2System\- and User\-Level Properties\fP」
\f2システムレベルおよびユーザーレベルのプロパティー\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html)
を参照してください。
.SH 詳細情報
Java Web Start の詳細は、
http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html
を参照してください。
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.htmlを参照してください。
.LP
.RE
.SS
詳細情報
.LP
.RS 3
.LP
.LP
Java Web Start の詳細は、
.na
\f2「Java Web Start」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.htmlを参照してください。
.LP
.RS 3
.LP
.LP
\
.LP
.RE
.RE

184
jdk/src/linux/doc/man/ja/jconsole.1
View File

@ -1,31 +1,51 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH "jconsole" 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jconsole \- Java 監視/管理コンソール
.SH 形式
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jconsole 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
jconsole \- Java 監視および管理コンソール
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
@ -39,49 +59,63 @@ jconsole \- Java
.fi
.LP
.SH "パラメータ"
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.br
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.TP
connection = pid | host:port | jmxUrl
.LP
\f2pid\fP\ \ \ ローカルの Java VM のプロセス ID。この Java VM は、jconsole を実行しているユーザ ID と同じユーザ ID で実行されている必要があります。詳細については、
.RS 3
\f2pid\fP\ \ \ ローカルの Java VM のプロセス ID。Java VM は、jconsole を実行しているユーザー ID と同じユーザー ID を使用して実行する必要があります。詳細については、
.na
「\f2JMX Monitoring and Management\fP」
\f2「JMX 監視および管理」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
.LP
\f2host\fP:\f2port\fP\ \ Java VM が実行されているホストシステムの名前と、その Java VM の起動時にシステムプロパティ \f2com.sun.management.jmxremote.port\fP に指定されたポート番号。詳細については、
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
.br
\f2host\fP:\f2port\fP\ \ Java VM が実行しているホストシステムの名前と、JVM を起動したときにシステムプロパティー \f2com.sun.management.jmxremote.port\fP で指定したポート番号。詳細については、
.na
「\f2JMX Monitoring and Management\fP」
\f2「JMX 監視および管理」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html) を参照してください。
.LP
\f2jmxUrl\fP\ \ 接続先の JMX エージェントのアドレス。これについては、
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.htmlを参照してください。
.br
\f2jmxUrl\fP 接続先の JMX エージェントのアドレス。 これについては、
.na
「\f2JMXServiceURL\fP」
\f2JMXServiceURL\fP @
.fi
(http://java.sun.com/javase/6/docs/api/javax/management/remote/jmxserviceurl.html) を参照してください。
.LP
.SH 機能説明
http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html を参照してください。
.RE
.RE
.B jconsole
コマンドは、ローカルまたはリモートマシン上の Java アプリケーションと仮想マシンを監視および管理するためのグラフィカルコンソールツールを起動します。
.LP
.SH オプション
.TP 15
.B \-interval=n
更新間隔を n 秒に設定します。(デフォルトは 4 秒)
.TP
.B \-notile
初期状態でウィンドウを並べて表示しません。(接続が 2 つ以上ある場合)
.SH " 説明"
.LP
.LP
.LP
\f3jconsole\fP コマンドは、ローカルマシンまたはリモートマシン上の Java アプリケーションと仮想マシンの監視と管理を行うグラフィカルコンソールツールを起動します。
.LP
.LP
Windows 上では、\f3jconsole\fP はコンソールウィンドウと関連付けられていません。ただし、なんらかの理由で \f3jconsole\fP コマンドが失敗すると、エラー情報を示すダイアログボックスが表示されます。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-interval=n
更新間隔を \f2n\fP 秒に設定します (デフォルトは 4 秒)。
.TP 3
\-notile\
最初にウィンドウをタイリングしません (複数の接続のため)。
.TP 3
\-pluginpath\ plugins
JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
JConsole プラグインの検索先となるディレクトリまたは JAR ファイルのリストを指定します。\f2plugins\fP パスには、次の名前のプロバイダ構成ファイルを含めてください。
.br
.nf
\f3
@ -91,38 +125,38 @@ JConsole
\fP
.fi
.LP
これには、
これには、
.na
\f2com.sun.tools.jconsole.JConsolePlugin\fP
\f2com.sun.tools.jconsole.JConsolePlugin\fP @
.fi
(http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/jconsoleplugin.html) クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
.TP
.B \-version
バージョン情報を出力して終了します。
.TP
.B \-help
ヘルプメッセージを出力して終了します。
http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html クラスを実装するクラスの完全修飾クラス名を指定する行が、プラグインごとに 1 行ずつ含まれています。
.TP 3
\-version\
バージョン情報を出力して終了します。
.TP 3
\-help\
ヘルプメッセージを出力して終了します。
.TP 3
\-J<flag>\
jconsole が実行されている Java 仮想マシンに <flag> を渡します。
jconsole が実行されている Java 仮想マシンに <flag> を渡します。
.RE
.LP
.SH "関連項目"
.SH "関連項目"
.LP
.RS 3
.TP 2
*
o
.na
\f2jconsole の使用\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
の
.na
「\f2Using JConsole\fP」
.TP 2
*
o
.na
\f2「Java プラットフォームの監視および管理」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
の
.na
「\f2Monitoring and Management for Java Platform\fP」
.RE
.LP

779
jdk/src/linux/doc/man/ja/jdb.1
View File

@ -1,109 +1,101 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/j2se/1.4/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
.TH jdb 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
jdb \- Java デバッガ
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jdb 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
jdb \- Java デバッガ
.LP
.RS 3
.LP
.LP
\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jdb\fP [ options ] [ class ] [ arguments ]
.fl
.fi
.LP
.RS 3
.LP
.RS 3
.TP 3
options
次に示すコマンド行オプション
.TP 3
class
デバッグを開始するクラスの名前
.TP 3
arguments
\f2class\fP の \f2main()\fP メソッドに渡す引数
.RE
.LP
.RE
.SH " 説明"
.LP
.LP
.LP
\f3jdb\fP は、Java 言語プログラムのバグを見つけて修正するために使用するツールです。
.LP
.SH "形式"
.B jdb
[
.I options
] [
.I class
] [
.I arguments
]
.LP
.TP 15
.I options
以下に指定するコマンド行オプション
.TP
.I class
デバッグを開始するクラス名
.TP
.I arguments
クラスの
.B main(\|)
メソッドに渡される引数
.SH "機能説明"
.IX "Java debugger" "" "Java debugger \(em \fLjdb\fP"
.IX "jdb" "" "\fLjdb\fP \(em Java debugger"
Java デバッガの
.BR jdb
は、
Java
クラス用の単純なコマンド行デバッガです。
Java デバッガ \f3jdb\fP は、Java クラス用の簡単なコマンド行デバッガです。
.na
「\f2Java Platform Debugger Architecture\fP」
\f2Java Platform Debugger Architecture\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html)
を画面に表示しながら実行し、ローカルまたはリモートの Java 仮想マシン
の検査とデバッグを行うことができます。
.SS "jdb セッションの開始"
.IX "jdb" "Starting a jdb Session" "\fLjdb\fP \(em Java debugger"
jdb セッションを開始するにはさまざまな方法があります。 もっとも頻繁に使
われるのは、アプリケーションのメインクラスをデバッグして、
.B jdb
から新しく Java 仮想マシン (VM) を起動する方法です。 コマンド行で、
.BR java (1)
の代わりに
.B jdb
コマンドを入力します。たとえば、アプリケーションのメインクラスが
.BR MyClass
の場合は、次のコマンドを使用して jdb 環境でデバッグします。
http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html を視覚的に実行し、ローカルまたはリモートの Java Virtual Machine の検査とデバッグを行うことができます。
.LP
.RS
.B % jdb MyClass
.RE
.SS
jdb セッションの開始
.LP
このようにして起動すると、
.B jdb
は 2 つ目の Java VM を呼び出し、指定されたパラメータを渡し、
指定されたクラスをロードします。そのあと、
クラスの最初の命令を実行する前に VM を停止させます。
.RS 3
.LP
.B jdb
のもう 1 つの使用方法は、すでに起動している Java VM に
.B jdb
を接続することです。
jdb が接続する VM を、その実行中に起動するための構文を次に示します。 これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
.LP
jdb セッションを開始するにはさまざまな方法があります。もっとも頻繁に使われるのは、デバッグするアプリケーションのメインクラスを使用して、\f3jdb\fP から新しい Java 仮想マシン (VM) を起動する方法です。コマンド行で、 \f3java\fP の代わりに \f3jdb\fP コマンドを入力します。たとえば、アプリケーションのメインクラスが MyClass の場合は、JDB 環境でデバッグするときに次のコマンドを使用します。
.LP
.nf
\f3
.fl
% jdb MyClass
.fl
\fP
.fi
.LP
.LP
この方法で起動すると、\f3jdb\fP は、指定されたパラメータを使って 2 つ目の Java VM を呼び出します。 次に、指定されたクラスをロードして、クラスの最初の命令を実行する前に VM を停止させます。
.LP
.LP
\f3jdb\fP のもう 1 つの使用方法は、すでに起動している Java VM に jdb を接続することです。jdb が接続する VM を、その実行中に起動するための構文を次に示します。これは、インプロセスデバッグ用ライブラリをロードし、接続の種類を指定します。
.LP
.nf
\f3
@ -115,11 +107,7 @@ jdb
.LP
.LP
たとえば、次のコマンドは
.B MyClass
アプリケーションを実行し、後で
.B jdb
を接続できるようにします。
たとえば、次のコマンドは、MyClass アプリケーションを実行して、\f3jdb\fP があとでそのアプリケーションに接続できるようにします。
.LP
.nf
\f3
@ -131,375 +119,250 @@ jdb
.LP
.LP
次のコマンドで
.B jdb
を VM に接続できます。
次のコマンドを使用して、\f3jdb\fP を VM に接続できます。
.LP
.RS
.B % jdb \-attach 8000
.RE
.LP
このとき、
.B jdb
は新しい VM を起動するのではなく、既存の VM に接続するので、
.B jdb
コマンド行で
.B MyClass
を指定しないことに注意してください。
.LP
これ以外にもデバッガ (jdb) を VM に接続する方法はたくさんあり、
.BR jdb
はそのすべての方法をサポートしています。
このような接続オプションについては、
.nf
\f3
.fl
% jdb \-attach 8000
.fl
\fP
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
で Java Platform Debugger Architecture のマニュアルを参照してください。
\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
.fi
http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
の 1.4.2 のドキュメントを参照してください。
.SS " jdb 基本コマンド"
.IX "jdb" "Basic jdb Commands" "\fLjdb\fP \(em Java debugger"
以下に
.B jdb
基本コマンドの一覧を示します。
Java
デバッガで使用可能なその他のコマンドは、
.B help
コマンドで表示できます。
.TP 15
.B help または ?
.BR jdb
のコマンドの中でもっとも重要なのが、この
.B help
コマンドです。利用可能なコマンドの一覧を、
各コマンドの簡単な説明つきで表示します。
.TP 15
.B run
.BR jdb
を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、
デバッグするアプリケーションの実行を開始します。このコマンドは、
デバッグするアプリケーションを
.B jdb
から起動するときにだけ使用できます。
既存の VM に接続する場合とは異なります。
.TP
.B cont
ブレークポイント、例外、またはステップ実行のあとで、デバッグ中の
アプリケーションの実行を継続します。
.TP 15
.B print
Java オブジェクトおよびプリミティブ値を表示します。 プリミティブ型の変数
またはフィールドの場合には、実際の値を出力します。 オブジェクトの場合
には、短い説明を出力します。 オブジェクトについては、以降の
.B dump
コマンドの説明を参照してください。
.sp 1n
.LP
注: 局所
(スタック)
変数をブラウズするには、そのクラスが
.B javac \-g
オプションでコンパイルされている必要があります。
.sp 1n
.LP
.B print
は、メソッドの呼び出しを含む多数の簡単な Java 式をサポートします。
次に例を示します。
.RS
.TP 3
\(bu
.B print MyClass.myStaticField
.PD 0
.TP
\(bu
.B print myObj.myInstanceField
.TP
\(bu
\f3print\f1 \f2i\f1 \f3+\f1 \f2j\f1 \f3+\f1 \f2k\f1 (
.IR i、
.IR j 、
および
.I k
はプリミティブであり、フィールドまたは局所変数のいずれか)
.TP
\(bu
\f3print myObj.myMethod(\|)\f1 (
.B myMethod
が null 以外を返す場合)
.TP
\(bu
.B print new java.lang.String("Hello").length(\|)
.RE
.PD
.TP
.B dump
プリミティブ値の場合には、このコマンドは
.BR print
と同じです。オブジェクトの場合には、オブジェクト内に定義されている
各フィールドの現在の値を出力します。 static フィールドと instance
フィールドを出力します。
.sp 1n
.LP
.B dump
コマンドは、
.B print
コマンドと同じ式をサポートします。
.TP
.B threads
現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、
およびほかのコマンドに使用できるインデックスを出力します。次に例を
示します。
.sp 1n
.RS 20
.LP
.B 4. (java.lang.Thread)0x1 main running
.RE
.RS
.sp 1n
.LP
この例では、スレッドインデックスは
.BR 4
であり、スレッドは
.BR java.lang.Thread
のインスタンスです。スレッドの名前は「
.BR main
」であり、現在実行中です。
.RE
.TP 15
.B thread
現在のスレッドを選択します。 多くの
.B jdb
コマンドは、現在のスレッドの設定に基づいて実行されます。 スレッドは、
.B threads
コマンドで説明するスレッドインデックスとともに指定します。
.TP 15
.B where
引数のない
.B where
コマンドは、現在のスレッド
(
.B thread
コマンドで設定)
のスタックをダンプします。
.B where all
と指定すると、現在のスレッドグループにある全スレッドの
スタックをダンプします。
.BI where " threadindex"
と指定すると、
.I threadindex
が示すスレッドのスタックだけをダンプします。
.sp 1n
.LP
現在のスレッドが (ブレークポイントなどのイベントや
.B suspend
コマンドで) 中断している場合、
.B print
コマンドや
.B dump
コマンドを使用すれば、局所変数やフィールドを表示できます。
どのスタックフレームを現在のフレームにするかは、
.B up
および
.B down
コマンドで選択できます。
.SS "ブレークポイント用コマンド"
.IX "jdb" "Breakpoints" "\fLjdb\fP \(em Java debugger"
.B jdb
では、ブレークポイントを行番号で、
またはメソッドの最初の命令で
設定できます。次に例を示します。
.TP 25
.B stop at MyClass:22
.BR MyClass
が含まれるソースファイルの
.B 22
行目の最初の命令にブレークポイントを設定する
.TP
.B stop in java.lang.String.length
.BR java.lang.String.length
メソッドの最初にブレークポイントを設定する
.TP
.BI "stop in MyClass." init
.I init
は
.B MyClass
コンストラクタを識別する
.TP
.BI "stop in MyClass." clinit
.I clinit
は
.BR MyClass
の静的な初期化コードを識別する
.LP
メソッドがオーバーロードされる場合には、メソッドの引数の型も指定して、
ブレークポイントに対して適切なメソッドが選択されるようにしなければなりませ
ん。 たとえば、次のように指定します。
.LP
.RS 15
.B MyClass.myMethod(int,java.lang.String)
.RE
.LP
または
.LP
.RS 15
.B MyClass.myMethod()
.RE
.LP
.B clear
コマンドは、「
.BR clear MyClass:45
」のような構文を使用してブレークポイントを削除します。
引数を指定しないで
.B clear
コマンドを使用すると、現在設定されてい
るすべてのブレークポイントが表示されます。
.B cont
コマンドで実行が継続します。
.SS "コマンドのステップ実行"
.IX "jdb" "Stepping" "\fLjdb\fP \(em Java debugger"
.B step
コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、
次の行を実行します。
.B next
コマンドは、現在のスタックフレームの次の行を
実行します。
.SS "例外処理用コマンド"
.IX "jdb" "Exceptions" "\fLjdb\fP \(em Java debugger"
スローしているスレッドの呼び出しスタック上のどこにも catch 文がないような
例外が発生すると、VM は通常、例外トレースを出力して終了します。 ただし、
.BR jdb
環境で実行している場合は、このような例外が発生すると
.B jdb
に制御が戻ります。 次に、
.BR jdb
を使用して例外の原因を診断します。
.TP 15
.B catch
デバッグ中のアプリケーションは他の例外がスローされたところで停止します。
次に例を示します。
.LP
.RS 20
.B catch java.io.FileNotFoundException
.RE
.sp 1n
.RS 15
または
.RE
.LP
.RS 20
.B catch mypackage.BigTroubleException
.RE
.sp 1n
.RS 15
例外が指定したクラス (または、サブクラス) のインスタンスである場合、
アプリケーションはスローされたところで停止します。
.RE
.TP 15
.B ignore
以前の
.B catch
コマンドの効果を無効にします。なお、この指定によって例外を無視するのは
デバッガだけであり、デバッグされた VM は無視しません。
.SH "コマンド行オプション"
コマンド行で Java アプリケーション起動ツールの代わりに
.B jdb
を使用する場合、
.B jdb
は、
.BR \-D、
.BR \-classpath、
.BI \-X option\f1
など、
.BR java (1)
コマンドと同じオプションを多数使用できます。
.LP
.B jdb
は、そのほかに次のオプションも使用できます。
.TP 3
.BI \-help
ヘルプメッセージを表示します。
.TP 3
.BI \-sourcepath " dir1\f1:\f2dir2\f1:..."
指定されたパスで、ソースファイルを検索します。 このオプションが
指定されていない場合は、デフォルトパスの「.」を検索します。
.TP
.BI \-attach " address"
デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続
します。
.TP
.BI \-listen " address"
実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
.TP
.BI \-listenany
実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
.TP
.B \-launch
デバッグするアプリケーションを
.BR jdb
の起動後ただちに起動します。 このオプションを使用すると、
.B run
コマンドを使用する必要はありません。 デバッグするアプリケーションは、
起動後、最初のアプリケーションクラスがロードされる直前に停止します。
その時点で、必要なブレークポイントを設定できます。
実行を継続するには
.B cont
コマンドを使用します。
.TP 3
\-listconnectors
この VM で利用できるコネクタを一覧表示します。
.TP 3
\-connect
<connector\-name>:<name1>=<value1>,...
一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
.TP 3
\-dbgtrace [flags]
jdb のデバッグ情報を出力します。
.TP 3
\-tclient
Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
.TP 3
\-tserver
Java HotSpot(tm) VM (サーバ) 内でアプリケーションを実行します。
.TP
.BI \-J "option"
jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される。)
たとえば、
.I \-J-Xms48m
は、起動時に使用するメモリを 48M バイトに設定します。
.LP
これ以外にも、デバッガをデバッグされる VM に接続するための代替機構
用のオプションがサポートされています。
このような接続の代替機構については、
.LP
この場合、\f3jdb\fP は新しい VM を起動する代わりに既存の VM に接続されるため、\f3jdb\fP コマンド行には「MyClass」は指定しません。
.LP
.LP
デバッガを VM に接続するにはほかにもさまざまな方法があり、すべて \f3jdb\fP でサポートされています。接続オプションについては、Java Platform Debugger Architecture の
.na
\f2ドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html
の Java Platform Debugger Architecture のマニュアルを参照してください。
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。\f3jdb\fP で使用するために J2SE 1.4.2 以前の VM を起動する方法については、
.na
\f21.4.2 のドキュメント\fP @
.fi
http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.htmlを参照してください。
.LP
.SS
デバッグ対象のプロセスに転送されるオプション
基本 jdb コマンド
.LP
.TP 3
\-v \-verbose[:class|gc|jni]
冗長モードにします。
.TP 3
\-D<name>=<value>
システムプロパティを設定します。
.TP 3
\-classpath <directories separated by
":">
クラスを検索するディレクトリを一覧表示します。
.TP 3
\-X<option>
非標準ターゲット VM オプションです。
.LP
.SH "関連項目"
基本的な \f3jdb\fP コマンドの一覧を示します。Java デバッガがサポートするコマンドはこれ以外にもあり、それらは \f3jdb\fP の \f2help\fP コマンドを使用して表示できます。
.LP
.RS 3
.LP
.RS 3
.TP 3
help または ?
もっとも重要な \f3jdb\fP コマンド \f2help\fP は、認識されたコマンドのリストに簡潔な説明を付けて表示します。
.TP 3
run
\f3jdb\fP を起動して必要なブレークポイントを設定したあとに、このコマンドを使用して、デバッグするアプリケーションの実行を開始できます。このコマンドは、既存の VM に接続している場合とは異なり、デバッグするアプリケーションが \f3jdb\fP から起動したときにだけ使用できます。
.TP 3
cont
ブレークポイント、例外、またはステップ実行のあとで、デバッグするアプリケーションの実行を継続します。
.TP 3
print
Java オブジェクトおよびプリミティブ値を表示します。プリミティブ型の変数またはフィールドの場合には、実際の値が出力されます。オブジェクトの場合には、短い説明が出力されます。オブジェクトについては、以降の \f2dump\fP コマンドの説明を参照してください。
.LP
\f2注:局所変数を表示するには、その変数を含むクラスが \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP オプションでコンパイルされていなければなりません。
.LP
\f2print\fP では、メソッドの呼び出しを含む多数の簡単な Java 式がサポートされています。 次に例を示します。
.RS 3
.TP 2
o
\f2print MyClass.myStaticField\fP
.TP 2
o
\f2print myObj.myInstanceField\fP
.TP 2
o
\f2print i + j + k\fP (i、j、および k はプリミティブであり、フィールドまたは局所変数のいずれか)
.TP 2
o
\f2print myObj.myMethod()\fP (myMethod が null 以外を返す場合)
.TP 2
o
\f2print new java.lang.String("Hello").length()\fP
.RE
.TP 3
dump
プリミティブ値の場合には、このコマンドは \f2print\fP と同じです。オブジェクトの場合には、オブジェクト内に定義されている各フィールドの現在の値が出力されます。static フィールドと instance フィールドが出力されます。
.LP
\f2dump\fP コマンドでは、\f2print\fP コマンドと同じ式がサポートされます。
.TP 3
threads
現在実行中のスレッドを一覧表示します。スレッドごとに、名前と現在の状態、およびほかのコマンドに使用できるインデックスが出力されます。 次に例を示します。
.RS 3
.LP
.nf
\f3
.fl
4. (java.lang.Thread)0x1 main running
.fl
\fP
.fi
.RE
この例では、スレッドインデックスは 4 であり、スレッドは java.lang.Thread のインスタンスです。 スレッドの名前は「main」であり、現在実行中です。
.TP 3
thread
現在のスレッドにするスレッドを選択します。多くの \f3jdb\fP コマンドは、現在のスレッドの設定に基づいて実行されます。スレッドは、\f2threads\fP コマンドで説明したスレッドインデックスとともに指定します。
.TP 3
where
引数を指定しないで \f2where\fP を実行すると、現在のスレッドのスタックがダンプされます。 \f2where all\fP コマンドは、現在のスレッドグループにあるスレッドのスタックを、すべてダンプします。 \f2where\fP \f2threadindex\fP は、指定されたスレッドのスタックをダンプします。
.LP
現在のスレッドが (ブレークポイントか \f2suspend\fP コマンドによって) 中断している場合は、局所変数とフィールドは \f2print\fP コマンドと \f2dump\fP コマンドで表示できます。\f2up\fP コマンドと \f2down\fP コマンドで、どのスタックフレームをカレントにするかを選ぶことができます。
.RE
.LP
.RE
.SS
ブレークポイント
.LP
.RS 3
.LP
.LP
ブレークポイントは、行番号またはメソッドの最初の命令で \f3jdb\fP に設定できます。 次に例を示します。
.LP
.RS 3
.TP 2
o
\f2stop at MyClass:22\fP (MyClass が含まれるソースファイルの 22 行目の最初の命令にブレークポイントを設定)
.TP 2
o
\f2stop in java.lang.String.length\fP (\f2java.lang.String.length\fP メソッドの最初にブレークポイントを設定)
.TP 2
o
\f2stop in MyClass.<init>\fP (<init> は MyClass コンストラクタを識別)
.TP 2
o
\f2stop in MyClass.<clinit>\fP (<clinit> は MyClass の静的初期化コードを識別)
.RE
.LP
.LP
メソッドがオーバーロードされている場合には、メソッドの引数の型も指定して、ブレークポイントに対して適切なメソッドが選択されるようにしなければなりません。たとえば、「\f2MyClass.myMethod(int,java.lang.String)\fP」または「\f2MyClass.myMethod()\fP」と指定します。
.LP
.LP
\f2clear\fP コマンドは、「\f2clear\ MyClass:45\fP」のような構文を使用してブレークポイントを削除します。\f2clear\fP を使用するか、引数を指定しないでコマンドを使用すると、現在設定されているすべてのブレークポイントが表示されます。\f2cont\fP コマンドは実行を継続します。
.LP
.RE
.SS
ステップ実行
.LP
.RS 3
.LP
.LP
\f2step\fP コマンドは、現在のスタックフレームまたは呼び出されたメソッド内で、次の行を実行します。\f2next\fP コマンドは、現在のスタックフレームの次の行を実行します。
.LP
.RE
.SS
例外
.LP
.RS 3
.LP
.LP
スローしているスレッドの呼び出しスタック上のどこにも catch 文がない場合に例外が発生すると、VM は通常、例外トレースを出力して終了します。ただし、\f3jdb\fP 環境で実行している場合は、例外が発生すると \f3jdb\fP に制御が戻ります。次に、\f3jdb\fP を使用して例外の原因を診断します。
.LP
.LP
たとえば、「\f2catch java.io.FileNotFoundException\fP」または「\f2catch mypackage.BigTroubleException\fP」のように \f2catch\fP コマンドを使用すると、デバッグされたアプリケーションは、ほかの例外がスローされたときに停止します。例外が特定のクラス (またはサブクラス) のインスタンスの場合は、アプリケーションは例外がスローされた場所で停止します。
.LP
.LP
\f2ignore\fP コマンドを使うと、以前の \f2catch\fP コマンドの効果が無効になります。
.LP
.LP
\f2注:\fP\f2ignore\fP コマンドでは、デバッグされる VM は例外を無視せず、デバッガだけが例外を無視します。
.LP
.RE
.RE
.SH "コマンド行オプション"
.LP
.LP
.LP
javac、java、javah、javap、javadoc
コマンド行で Java アプリケーション起動ツールの代わりに \f3jdb\fP を使用する場合、\f3jdb\fP は、\f2\-D\fP、\f2\-classpath\fP、\f2\-X<option>\fP など、java コマンドと同じ数のオプションを受け入れます。
.LP
.LP
\f3jdb\fP は、そのほかに次のオプションを受け入れます。
.LP
.RS 3
.TP 3
\-help
ヘルプメッセージを表示します。
.TP 3
\-sourcepath <dir1:dir2:...>
指定されたパスを使用して、ソースファイルを検索します。このオプションが指定されていない場合は、デフォルトパスの「.」が使われます。
.TP 3
\-attach <address>
デフォルトの接続機構を使用して、すでに実行中の VM にデバッガを接続します。
.TP 3
\-listen <address>
実行中の VM が標準のコネクタを使って指定されたアドレスに接続するのを待機します。
.TP 3
\-listenany
実行中の VM が標準のコネクタを使って利用可能な任意のアドレスに接続するのを待機します。
.TP 3
\-launch
デバッグするアプリケーションを jdb の起動後ただちに起動します。このオプションによって、\f2run\fP コマンドを使用する必要がなくなります。デバッグするアプリケーションは、起動後、初期アプリケーションクラスがロードされる直前に停止します。その時点で、必要なブレークポイントを設定し、\f2cont\fP を使用して実行を継続できます。
.TP 3
\-listconnectors
この VM で利用できるコネクタを一覧表示します。
.TP 3
\-connect <connector\-name>:<name1>=<value1>,...
一覧表示された引数の値と指定のコネクタを使ってターゲット VM に接続します。
.TP 3
\-dbgtrace [flags]
jdb のデバッグ情報を出力します。
.TP 3
\-tclient
Java HotSpot(tm) VM (クライアント) 内でアプリケーションを実行します。
.TP 3
\-tserver
Java HotSpot(tm) VM (サーバー) 内でアプリケーションを実行します。
.TP 3
\-Joption
jdb の実行に使用される Java 仮想マシンに \f2option\fP を渡します。(アプリケーション Java 仮想マシンに対するオプションは、\f3run\fP コマンドに渡される)。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.LP
デバッガとデバッグを行う VM を接続するための代替機構に対して、その他のオプションがサポートされています。その他の接続オプションについては、Java Platform Debugger Architecture の
.na
\f2ドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.htmlを参照してください。
.LP
.SS
デバッグ対象のプロセスに転送されるオプション
.LP
.RS 3
.TP 3
\-v \-verbose[:class|gc|jni]
冗長モードにします。
.TP 3
\-D<name>=<value>
システムプロパティーを設定します。
.TP 3
\-classpath <directories separated by ":">
クラスを検索するディレクトリを一覧表示します。
.TP 3
\-X<option>
非標準ターゲット VM オプションです。
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
javac(1)、java(1)、javah(1)、javap(1)、javadoc(1)
.LP
.LP

136
jdk/src/linux/doc/man/ja/jhat.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,16 +18,34 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jhat 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
."
.TH jhat 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH 名前
jhat \- Java ヒープ解析ツール
.SH "名前"
jhat \- Java ヒープ解析ツール
.LP
.SH "形式"
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
@ -43,107 +59,101 @@ jhat \- Java
.fi
.LP
.SH "パラメータ"
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
オプションを使用する場合、コマンド名の直後に記述してください。
.br
.TP 3
heap\-dump\-file
ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
.LP
.SH "説明"
.LP
ブラウズ対象となる Java バイナリヒープダンプファイル。複数のヒープダンプを含むダンプファイルの場合、「foo.hprof#3」のようにファイル名の後に「#<number>」を付加することで、ファイル内の特定のダンプを指定できます。
.SH "説明"
.LP
.LP
\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/ で利用可能です。
\f3jhat\fP コマンドは、java ヒープダンプファイルを解析し、Web サーバーを起動します。 jhat を使えば、お好みの Web ブラウザを使ってヒープダンプをブラウズできます。 jhat は、「ある既知のクラス「Foo」のすべてのインスタンスを表示する」といった、事前に設計されたクエリのほか、\f3OQL\fP (\f3O\fPbject \f3Q\fPuery \f3L\fPanguage) もサポートします。OQL のヘルプには、jhat によって表示される OQL ヘルプページからアクセスできます。デフォルトポートを使用する場合、OQL のヘルプは http://localhost:7000/oqlhelp/ で利用可能です。
.LP
.LP
Java のヒープダンプを生成するには、いくつかの方法があります。
Java のヒープダンプを生成するには、いくつかの方法があります。
.LP
.RS 3
.TP 2
*
jmap の \-dump オプションを使って実行時にヒープダンプを取得する。
o
jmap(1) の \-dump オプションを使って実行時にヒープダンプを取得する。
.TP 2
*
jconsole のオプションを使って
o
jconsole(1) のオプションを使って
.na
\f2HotSpotDiagnosticMXBean\fP
\f2HotSpotDiagnosticMXBean\fP @
.fi
(http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html) 経由で実行時にヒープダンプを取得する。
http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html 経由で実行時にヒープダンプを取得する。
.TP 2
*
\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
o
\-XX:+HeapDumpOnOutOfMemoryError VM オプションを指定すると、OutOfMemoryError のスロー時にヒープダンプが生成される。
.TP 2
*
o
.na
\f2hprof\fP
\f2hprof\fP @
.fi
(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html) を使用する。
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html を使用する。
.RE
.LP
.LP
\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
.LP
.SH "オプション"
.LP
\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
.SH "オプション"
.RS 3
.TP 3
\-stack false/true
オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
オブジェクト割り当て呼び出しスタックの追跡を無効にします。ヒープダンプ内で割り当てサイト情報が使用できない場合、このフラグを false に設定する必要があります。デフォルトは true です。
.TP 3
\-refs false/true
オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。つまり、参照者または受信参照) が計算されます。
オブジェクトへの参照の追跡を無効にします。デフォルトは true です。デフォルトでは、ヒープ内のすべてのオブジェクトについて、バックポインタ (指定されたオブジェクトをポイントしているオブジェクト。 参照者または受信参照とも呼ばれる) が計算されます。
.TP 3
\-port port\-number
jhat の HTTP サーバのポートを設定します。デフォルトは 7000 です。
jhat の HTTP サーバーのポートを設定します。デフォルトは 7000 です。
.TP 3
\-exclude exclude\-file
「到達可能なオブジェクト」のクエリから除外すべきデータメンバの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
「到達可能なオブジェクト」のクエリから除外すべきデータメンバーの一覧を含むファイルを指定します。たとえば、このファイルに \f2java.lang.String.value\fP が含まれていた場合、特定のオブジェクト「o」から到達可能なオブジェクトのリストを計算する際に、\f2java.lang.String.value\fP フィールドに関連する参照パスが考慮されなくなります。
.TP 3
\-baseline baseline\-dump\-file
ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
ベースラインとなるヒープダンプを指定します。両方のヒープダンプ内で同じオブジェクト ID を持つオブジェクトは「新規ではない」としてマークされます。その他のオブジェクトは「新規」としてマークされます。これは、異なる 2 つのヒープダンプを比較する際に役立ちます。
.TP 3
\-debug int
このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
このツールのデバッグレベルを設定します。0 は「デバッグ出力なし」を意味します。より大きな値を設定すると、より冗長なモードになります。
.TP 3
\-version\
バージョン番号を報告したあと、終了します。
バージョン番号を報告したあと、終了します。
.TP 3
\-h\
ヘルプメッセージを出力したあと、終了します。
ヘルプメッセージを出力して終了します。
.TP 3
\-help\
ヘルプメッセージを出力したあと、終了します。
ヘルプメッセージを出力して終了します。
.TP 3
\-J<flag>\
jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
*
jmap \- Java メモリマップ
.TP 2
*
jconsole \- Java 監視および管理コンソール
.TP 2
*
.na
\f2hprof \- ヒープおよび CPU プロファイリングツール\fP
.fi
(http://java.sun.com/developer/technicalArticles/Programming/HPROF.html)
jhat が実行されている Java 仮想マシンに <flag> を渡します。たとえば、512M バイトの最大ヒープサイズを使用するには、\-J\-Xmx512m とします。
.RE
.LP
.LP
.SH "関連項目"
.RS 3
.TP 2
o
jmap(1)
.TP 2
o
jconsole(1)
.TP 2
o
.na
\f2hprof \- ヒープおよび CPU プロファイリングツール\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE
.RE

210
jdk/src/linux/doc/man/ja/jinfo.1
View File

@ -1,72 +1,108 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jinfo 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jinfo \- 構成情報
.\"
.SH 形式
.B jinfo
.BI [ option ] " pid"
.br
.B jinfo
.BI [ option ] " executable core"
.br
.B jinfo
.BI [ option ] " [server-id@]remote-hostname-or-IP"
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jinfo 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH パラメータ
.SH "名前"
jinfo \- 構成情報
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jinfo\fP [ option ] pid
.fl
\f3jinfo\fP [ option ] executable core
.fl
\f3jinfo\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi
.LP
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
option
オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
option
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
.RS 3
.TP 3
pid
構成情報を出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
.B jps
を使用します。
pid
出力する構成情報のプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
.RS 3
.TP 3
executable
コアダンプが生成された Java 実行可能ファイル。
コアダンプの作成元の Java 実行可能ファイルです。
.RE
.RS 3
.TP 3
core
構成情報を出力するコアファイル。
出力する構成情報のコアファイル。
.RE
.RS 3
.TP 3
remote\-hostname\-or\-IP
リモートデバッグサーバ (
.B jsadebugd
を参照) のホスト名または IP アドレス。
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.RE
.RS 3
.TP 3
server\-id
同じリモートホスト上で複数のデバッグサーバが実行している場合の、オプションの一意 ID。
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.RE
.RE
.LP
.SH 機能説明
.B jinfo
は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバの Java 構成情報を出力します。構成情報には、Java システムプロパティと Java 仮想マシンコマンド行フラグが含まれます。
指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.SH "説明"
.LP
.LP
.LP
\f3jinfo\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーの Java 構成情報を出力します。構成情報は、Java システムプロパティーと Java 仮想マシンのコマンド行フラグから構成されます。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。 次に例を示します。
.br
.LP
@ -76,51 +112,55 @@ server\-id
jinfo \-J\-d64 \-sysprops pid
.RE
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
Windows 上の jinfo でサポートされているのは、実行中のプロセスの \-flag オプションだけです。
\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。Windows 上の jinfo でサポートされているのは、実行中のプロセスの \-flag オプションだけです。\fP
.LP
.SH オプション
.if t .TP 20
.if n .TP 15
.B " <no option>"
コマンド行フラグとシステムプロパティと値のペアの両方を出力します。
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
<オプションなし>
コマンド行フラグを、システムプロパティー名と値のペアとともに出力します。
.br
.TP 3
\-flag name
指定されたコマンド行フラグの名前と値を出力します。
指定されたコマンド行フラグの名前と値を出力します。
.br
.TP 3
\-flag [+|\-]name
指定されたブール型のコマンド行フラグを有効または無効にします。
指定されたブール型のコマンド行フラグを有効または無効にします。
.br
.TP 3
\-flag name=value
指定されたコマンド行フラグを指定された値に設定します。
.if t .TP 20
.if n .TP 15
.B \-flags
JVM に渡されるコマンド行フラグをペアで出力します。
.if t .TP 20
.if n .TP 15
.B \-sysprops
Java システムプロパティを名前と値のペアとして出力します。
.if t .TP 20
.if n .TP 15
.B \-h
ヘルプメッセージを出力します。
.if t .TP 20
.if n .TP 15
.B \-help
ヘルプメッセージを出力します。
.SH 関連項目
指定されたコマンド行フラグを指定された値に設定します。
.br
.TP 3
\-flags
JVM に渡されるコマンド行フラグをペアで出力します。
.br
.TP 3
\-sysprops
Java システムプロパティーを名前と値のペアとして出力します。
.br
.TP 3
\-h
ヘルプメッセージを出力します。
.TP 3
\-help
ヘルプメッセージを出力します。
.RE
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
*
jps
o
jps(1)
.TP 2
*
jsadebugd
o
jsadebugd(1)
.RE
.LP

261
jdk/src/linux/doc/man/ja/jmap.1
View File

@ -1,73 +1,103 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jmap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jmap \- メモリマップ
.\"
.SH 形式
.B jmap
.BI [ option ] " pid"
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jmap 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
jmap \- メモリーマップ
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jmap\fP [ option ] pid
.fl
\f3jmap\fP [ option ] executable core
.fl
\f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi
.LP
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
option
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。
.TP 3
pid
印刷するメモリーマップのプロセス ID。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.br
.B jmap
.BI [ option ] " executable core"
.TP 3
executable
コアダンプの作成元の Java 実行可能ファイルです。
.br
.B jmap
.BI [ option ] " [server-id@]remote-hostname-or-IP"
.SH パラメータ
.if t .TP 20
.if n .TP 15
.BI option
オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
.if t .TP 20
.if n .TP 15
.I pid
メモリマップを表示するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
.B jps
を使用します。
.if t .TP 20
.if n .TP 15
.I executable
コアダンプが生成された Java 実行可能ファイル。
.if t .TP 20
.if n .TP 15
.I core
メモリマップを表示するコアファイル。
.if t .TP 20
.if n .TP 15
.I remote-hostname-or-IP
リモートデバッグサーバ (
.B jsadebugd
を参照) のホスト名または IP アドレス。
.if t .TP 20
.if n .TP 15
.I server-id
同じリモートホスト上で複数のデバッグサーバが実行している場合、オプションの一意 ID。
.SH 機能説明
.B jmap
は、指定されたプロセスまたはコアファイルまたはリモートデバッグサーバの、共有オブジェクトメモリマップまたはヒープメモリの詳細を表示します。
指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.TP 3
core
印刷するメモリーマップのコアファイル。
.br
.TP 3
remote\-hostname\-or\-IP
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.br
.RE
.LP
.SH " 説明"
.LP
.LP
.LP
\f3jmap\fP は、指定されたプロセスやコアファイルまたはリモートデバッグサーバーの、共用オブジェクトメモリーマップまたはヒープメモリーの詳細を印刷します。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。 次に例を示します。
.LP
.RS 3
@ -82,82 +112,87 @@ jmap \-J\-d64 \-heap pid
.RE
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。\fP
.br
.LP
Windows プラットフォーム上で使用可能な唯一の jmap 形式は、次のとおりです。
Windows プラットフォーム上で使用可能な唯一の jmap 形式は、次のとおりです。
.RS 3
.LP
jmap \-dump:<\f2dump\-options\fP> pid
.RE
および
および
.RS 3
.LP
jmap \-histo[:live] pid
.RE
.SH オプション
.if t .TP 20
.if n .TP 15
.BI " <no option>"
オプションが使用されなかった場合、
.B jmap
は共有オブジェクトマッピングを表示します。ターゲット VM に読み込まれた各共有オブジェクトについて、開始アドレス、マッピングのサイズ、および共有オブジェクトファイルのフルパスが表示されます。これは、Solaris の
.B pmap
ユーティリティと同様です。
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
<オプションなし>
オプションを使用しない場合、\f3jmap\fP は共用オブジェクトマッピングを印刷します。ターゲット VM にロードされた共用オブジェクトごとに、開始アドレス、マッピングのサイズ、および共用オブジェクトファイルのフルパスが印刷されます。これは、Solaris \f3pmap\fP ユーティリティーと類似しています。
.br
.TP 3
\-dump:[live,]format=b,file=<filename>
Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat (Java Heap Analysis Tool) を使って読み取ります。
Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat(1) (Java Heap Analysis Tool) を使って読み取ります。
.br
.TP 3
\-finalizerinfo
ファイナライズを待っているオブジェクトに関する情報を出力します。
.if t .TP 20
.if n .TP 15
.B \-heap
ヒープのサマリを表示します。使用された GC アルゴリズム、ヒープ構成、および生成規模のヒープ使用率が表示されます。
.if t .TP 20
.if n .TP 15
.B \-histo[:live]
ヒープのヒストグラムを表示します。各 Java クラスについて、オブジェクト数、メモリサイズ（バイト数）、および完全修飾クラス名が表示されます。VM 内部クラス名の前には '*' が表示されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
.if t .TP 20
.if n .TP 15
.B \-permstat
Java ヒープの永続的生成のクラスローダ規模の統計を表示します。各クラスローダについて、名前、活動性、アドレス、親クラスローダ、および読み込まれたクラスのサイズが表示されます。
さらに、intern された文字列の数とサイズも出力されます。
ファイナライズを待っているオブジェクトに関する情報を出力します。
.br
.TP 3
\-heap
ヒープサマリーを印刷します。使用される GC アルゴリズム、ヒープ構成、および世代ごとのヒープ使用率が印刷されます。
.br
.TP 3
\-histo[:live]
ヒープのヒストグラムを印刷します。Java クラスごとに、オブジェクトの数、バイト単位でのメモリーサイズ、および完全修飾クラス名が印刷されます。VM 内部クラス名は、「*」の接頭辞を付けて印刷されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
.br
.TP 3
\-permstat
Permanent 世代の Java ヒープの、クラスローダー関連の統計データを印刷します。クラスローダーごとに、その名前、状態、アドレス、親クラスローダー、およびクラスローダーがロードしたクラスの数とサイズが印刷されます。さらに、intern された文字列の数とサイズも出力されます。
.br
.TP 3
\-F
強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
.if t .TP 20
.if n .TP 15
.B \-h
ヘルプメッセージを表示します。
.if t .TP 20
.if n .TP 15
.B \-help
ヘルプメッセージを表示します。
強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
.br
.TP 3
\-h
ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-J<flag>
jmap が実行されている Java 仮想マシンに <flag> を渡します。
jmap が実行されている Java 仮想マシンに <flag> を渡します。
.br
.RE
.LP
.SH 関連項目
.SH "関連項目"
.LP
.RS 3
.TP 2
*
o
pmap (1)
.TP 2
*
jhat
o
jhat(1)
.TP 2
*
jps
o
jps(1)
.TP 2
*
jsadebugd
o
jsadebugd(1)
.RE
.LP

478
jdk/src/linux/doc/man/ja/jps.1
View File

@ -1,204 +1,294 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jps 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jps \- Java 仮想マシンプロセスステータスツール
.\"
.SH 形式
.B jps
.BI [ options ]
.BI [ hostid ]
." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jps 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH パラメータ
.if t .TP 20
.if n .TP 15
.I options
コマンド行オプション。
.if t .TP 20
.if n .TP 15
.I hostid
プロセスレポートを生成するホストのホスト識別子。
.I hostid
には、通信プロトコル、ポート番号、およびその他固有の実装データを示すオプションコンポーネントを含めることができます。
.SH 機能説明
.B jps
ツールは、ターゲットシステム上の計測機構付き HotSpot Java 仮想マシン (JVM) をリストします。このツールは、アクセス権がある JVM 上の情報だけを報告します。
.LP
ホスト ID を指定せずに
.B jps
が実行された場合は、ローカルホスト上の計測機構付き JVM を探します。ホスト ID が指定された場合は、指定されたホスト上の JVM を、指定されたプロトコルとポートを使用して探します。
.B jstatd
プロセスがターゲットホスト上で稼動していることが前提となります。
.LP
.B jps
コマンドは、ターゲットシステム上で見つかった計測機構付き JVM のそれぞれについて、ローカル VM 識別子 (lvmid) を報告します。lvmid は、一般に、オペレーティングシステムの JVM プロセスのプロセス識別子ですが、必ずしもそうとは限りません。オプションが指定されなかった場合、
.B jps
は各 Java アプリケーションの lvmid の後に短い形式のアプリケーションのクラス名または jar ファイル名を続けてリストします。短い形式のクラス名または JAR ファイル名では、クラスのパッケージ情報や JAR ファイルのパス情報は省かれます。
.LP
.B jps
コマンドは java 起動ツールを使用して、クラス名と main メソッドに渡された引数を探します。ターゲット JVM がカスタム起動ツールで起動された場合、クラス名 (または JAR ファイル名) と main メソッドに渡された引数は入手できません。この場合、
.B jps
コマンドは、クラス名または JAR ファイル名と main メソッドの引数として、Unknown という文字列を出力します。
.LP
.B jps
コマンドによって生成される JVM のリストは、コマンドを実行した主体に許可されているアクセス権によって制限されることがあります。このコマンドは、オペレーティングシステム固有のアクセス制御機構に従って、主体がアクセス権を持っている JVM だけをリストします。
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現在、Windows 98 および Windows ME プラットフォームでは使用できません。
.SH オプション
.B jps
コマンドは、コマンド出力を変更する多数のオプションをサポートしています。これらのオプションは、将来、変更または削除されることがあります。
.if t .TP 20
.if n .TP 15
.BI \-q
クラス名、JAR ファイル名、および main メソッドに渡された引数の出力を抑制して、ローカル VM 識別子のリストだけを生成します。
.if t .TP 20
.if n .TP 15
.BI \-m
main メソッドに渡された引数を出力します。埋め込み JVM の場合、出力は NULL になることがあります。
.if t .TP 20
.if n .TP 15
.BI \-l
アプリケーションの main クラスのフルパッケージ名、またはアプリケーションの JAR ファイルのフルパス名を出力します。
.if t .TP 20
.if n .TP 15
.BI \-v
JVM に渡された引数を出力します。
.if t .TP 20
.if n .TP 15
.BI \-V
フラグファイル (.hotspotrc ファイル、または -XX:Flags=<filename> 引数によって指定されたファイル) を通じて JVM に渡された引数を出力します。
.if t .TP 20
.if n .TP 15
.BI \-J "option"
.B jps
によって呼び出された java 起動ツールにオプションを渡します。
たとえば、-J-Xms48m は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、\-J の一般的規則です。
.SH ホスト識別子
ホスト識別子 (hostid) は、ターゲットシステムを示す文字列です。hostid 文字列の構文は、URI の構文とほぼ同じです。
.LP
.RS
.ft 3
.nf
[protocol:][[//]hostname][:port][/servername]
.fi
.ft 1
.RE
.if t .TP 20
.if n .TP 15
.B protocol
通信プロトコル。protocol が省かれ、hostname が指定されなかった場合、デフォルトのプロトコルは、プラットフォームに固有の最適化されたローカルプロトコルです。protocol が省かれ、hostname が指定された場合、デフォルトのプロトコルは rmi です。
.if t .TP 20
.if n .TP 15
.I hostname
ターゲットホストを示すホスト名または IP アドレス。hostname が省かれた場合、ターゲットホストはローカルホストです。
.if t .TP 20
.if n .TP 15
.I port
リモートサーバーと通信するためのデフォルトポート。hostname が省かれるか、protocol が最適化されたローカルプロトコルを指定している場合、port は無視されます。そうでない場合、port パラメータの扱いは、実装に固有です。デフォルトの rmi プロトコルの場合、port はリモートホスト上の rmiregistry のポート番号を示します。port が省かれ、protocol が rmi を示す場合は、デフォルトの rmiregistry ポート (1099) が使用されます。
.if t .TP 20
.if n .TP 15
.I servername
このパラメータの取り扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。rmi プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を表す文字列です。
.B jstatd
コマンドの \-n オプションを参照してください。
.SH 出力形式
jps コマンドの出力は、次のパターンに従います。
.LP
.RS
.ft 3
.nf
lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]
.fi
.ft 1
.RE
.LP
出力トークンはすべて、空白で区切られます。埋め込まれた空白を含む arg があると、引数を実際の位置パラメータにマップするときにあいまいさが生じます。
.LP
注 - 将来のリリースで形式が変更される可能性があるので、
.B jps
の出力を解析するスクリプトは書かない方がよいでしょう。jps 出力を解析するスクリプトを書く場合は、このツールの将来のリリースでは修正が必要になることを予想しておいてください。
.SH 使用例
このセクションでは、
.B jps
コマンドの例を示します。
.LP
ローカルホスト上の計測機構付き JVM をリストする:
.LP
.RS
.ft 3
.nf
jps
18027 Java2Demo.JAR
18032 jps
18005 jstat
.fi
.ft 1
.RE
.TP
リモートホスト上の計測機構付き JVM をリストする:
.LP
この例では、jstat サーバーとその内部 RMI レジストリまたは個別の外部 rmiregistry プロセスがリモートホストのデフォルトポート (ポート 1099) で実行していることを前提としています。また、ローカルホストはリモートホストにアクセスするための適切なアクセス権を持っているものとします。また、この例には、長い形式のクラス名または JAR ファイル名を出力するための -l オプションが含まれています。
.LP
.RS
.ft 3
.nf
jps -l remote.domain
3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
2857 sun.tools.jstatd.jstatd
.fi
.ft 1
.RE
.LP
RMI レジストリ用にデフォルト以外のポートを使用するリモートホスト上の計測機構付き Java 仮想マシンをリストする:
.LP
この例では、jstatd サーバーがリモートホスト上で実行していて、内部 RMI レジストリがポート 2002 にバインドされていることを前提としています。また、この例では、リストされる各 Java アプリケーションの main メソッドに渡された引数を含めるために、-m オプションを使用しています。
.LP
.RS
.ft 3
.nf
jps -m remote.domain:2002
3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
3102 sun.tools.jstatd.jstatd -p 2002
.fi
.ft 1
.RE
.SH 関連項目
.SH "名前"
jps \- Java 仮想マシンプロセスステータスツール
.LP
.RS 3
.TP 2
*
java \- Java アプリケーション起動プログラム
o
形式
.TP 2
*
jstat \- Java 仮想マシン統計監視ツール
o
パラメータ
.TP 2
*
jstatd \- 仮想マシン jstat デーモン
o
説明
.TP 2
*
rmiregistry \- Java リモートオブジェクトレジストリ
o
オプション
.TP 2
o
ホスト識別子
.TP 2
o
出力形式
.TP 2
o
例
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jps\fP [ \f2options\fP ] [ \f2hostid\fP ]
.br
.fl
.fi
.LP
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
options
コマンド行オプション。
.TP 3
hostid
プロセスレポートを生成するホストのホスト識別子。\f2hostid\fP には、通信プロトコル、ポート番号、実装に固有な他のデータを指定したオプションコンポーネントを含めることができます。
.RE
.LP
.SH " 説明"
.LP
.LP
.LP
\f3jps\fP ツールは、ターゲットシステム上で計測された HotSpot Java 仮想マシン (JVM) を一覧表示します。このツールで表示できるレポート情報は、アクセス権を持った JVM に関するものに限定されます。
.LP
.LP
\f2hostid\fP を指定せずに \f3jps\fP を実行した場合、ローカルホストで計測された JVM が検索されます。\f2hostid\fP を指定して起動した場合、指定されたプロトコルとポートを使用して、指定されたホスト上の JVM を検索します。\f3jstatd\fP プロセスがターゲットホスト上で実行されていると想定されます。
.LP
.LP
\f3jps\fP コマンドは、ターゲットシステムで計測された各 JVM について、ローカル VM 識別子、つまり \f2lvmid\fP をレポートします。\f3lvmid\fP は、必須ではありませんが、一般的には JVM プロセスに対するオペレーティングシステムのプロセス識別子です。オプションを指定しない場合、\f3jps\fP によって、各 Java アプリケーションの \f2lvmid\fP が一覧表示され、それぞれにアプリケーションのクラス名または JAR ファイル名が簡単な形式で示されます。この簡単な形式のクラス名と JAR ファイル名では、クラスのパッケージ情報または JAR ファイルパス情報が省略されています。
.LP
.LP
\f3jps\fP コマンドは、\f3Java\fP 起動ツールを使用して、\f2main\fP メソッドに渡されるクラス名と引数を検索します。独自の起動ツールを使用してターゲット JVM を起動した場合は、\f2main\fP メソッドに渡されるクラス名 (または JAR ファイル名) と引数は利用できません。この場合、\f3jps\fP コマンドは、main メソッドへ渡されるクラス名 (または JAR ファイル名) と引数に対して、文字列 \f2Unknown\fP を出力します。
.LP
.LP
\f3jps\fP コマンドで生成される JVM のリストは、このコマンドを実行する主体に与えられたアクセス権に基づき、制限される場合があります。このコマンドは、オペレーティングシステム独自のアクセス制御機構による決定に基づいて、主体にアクセス権が与えられている JVM だけを一覧表示します。
.LP
.LP
\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
.SH "オプション"
.LP
.LP
.LP
\f3jps\fP コマンドでは、コマンドの出力を変更するオプションが多数サポートされています。将来、これらのオプションは、変更または廃止される可能性があります。
.LP
.RS 3
.TP 3
\-q
ローカル VM 識別子のリストだけを生成するように、\f2main\fP メソッドに渡されるクラス名、JAR ファイル名、および引数の出力を制御します。
.TP 3
\-m
main メソッドに渡される引数を出力します。この出力は、組み込まれている JVM に対して null になることもあります。
.TP 3
\-l
アプリケーションの主要なクラスのフルパッケージ名、またはアプリケーションの JAR ファイルへのフルパス名を出力します。
.TP 3
\-v
JVM に渡される引数を出力します。
.TP 3
\-V
フラグファイル (.hotspotrc ファイルまたは \-XX:Flags=<\f2filename\fP> の引数で指定されたファイル) を通じて JVM に渡される引数を出力します。
.TP 3
\-Joption
\f3jps\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
.SS
ホスト識別子
.LP
.RS 3
.LP
.LP
ホスト識別子、つまり \f2hostid\fP は、ターゲットシステムを示す文字列です。\f2hostid\fP 文字列の構文の大部分は、URI の構文に対応しています。
.LP
.nf
\f3
.fl
[\fP\f4protocol\fP\f3:][[//]\fP\f4hostname\fP\f3][:\fP\f4port\fP\f3][/\fP\f4servername\fP\f3]\fP
.br
\f3
.fl
\fP
.fi
.LP
.RS 3
.TP 3
protocol
通信プロトコルです。\f2protocol\fP が省略され、\f2hostname\fP が指定されていない場合、デフォルトのプロトコルが、プラットフォーム固有の最適化されたローカルプロトコルになります。\f2protocol\fP が省略され、\f2hostname\fP が指定されている場合は、デフォルトプロトコルは \f3rmi\fP になります。
.TP 3
hostname
ターゲットホストを示すホスト名または IP アドレスです。\f2hostname\fP が省略されている場合は、ターゲットホストはローカルホストになります。
.TP 3
port
リモートサーバーと通信するためのデフォルトポートです。\f2hostname\fP が省略されているか、\f2protocol\fP で最適化されたローカルプロトコルが指定されている場合、\f2port\fP は無視されます。そうでなければ、\f2port\fP パラメータの扱いは、実装によって異なります。デフォルトの \f3rmi\fP プロトコルの場合、\f2port\fP は、リモートホスト上の rmiregistry のポート番号を示します。\f2port\fP が省略され、\f2protocol\fP で \f3rmi\fP が指定されている場合、デフォルトの rmiregistry ポート (1099) が使用されます。
.TP 3
servername
このパラメータの扱いは、実装によって異なります。最適化されたローカルプロトコルの場合、このフィールドは無視されます。\f3rmi\fP プロトコルの場合、このパラメータは、リモートホスト上の RMI リモートオブジェクトの名前を示す文字列になります。jstatd(1) コマンドについては、\f3\-n\fP オプションを参照してください。
.RE
.LP
.RE
.SH "出力形式"
.LP
.LP
.LP
\f3jps\fP コマンドの出力は、次のパターンに従います。
.LP
.nf
\f3
.fl
\fP\f4lvmid\fP\f3 [ [ \fP\f4classname\fP\f3 | \fP\f4JARfilename\fP\f3 | "Unknown"] [ \fP\f4arg\fP\f3* ] [ \fP\f4jvmarg\fP\f3* ] ]\fP
.br
\f3
.fl
\fP
.fi
.LP
.LP
すべての出力トークンは空白で区切ります。\f2arg\fP の中で空白を使用すると、実際の定位置パラメータに引数をマッピングしようとするときに、あいまいになります。
.br
.br
\f3注\fP: 将来のリリースでこの形式は変更される可能性があるため、\f3jps\fP 出力を解析するスクリプトは作成しないことをお勧めします。\f3jps\fP 出力を解析するスクリプトを作成すると、このツールの将来のリリースで、作成したスクリプトを変更する必要が予測されます。
.br
.LP
.SH "例"
.LP
.LP
.LP
この節では、\f3jps\fP コマンドの例を示します。
.LP
.LP
ローカルホスト上で計測された JVM を一覧表示する場合:
.LP
.nf
\f3
.fl
\fP\f3jps\fP
.br
.fl
18027 Java2Demo.JAR
.br
.fl
18032 jps
.br
.fl
18005 jstat
.br
.fl
.fi
.LP
.LP
リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
この例では、\f3jstat\fP サーバーと、その内部 RMI レジストリまたは別の外部 \f3rmiregistry\fP プロセスのいずれかとが、リモートホストのデフォルトポート (ポート 1099) で実行されていると想定しています。また、ローカルホストが、リモートホストへの有効なアクセス権を持っていることも想定しています。この例には、\f2\-l\fP オプションも含まれ、クラス名または JAR ファイル名を詳細な形式で出力します。
.LP
.nf
\f3
.fl
\fP\f3jps \-l remote.domain\fP
.br
.fl
3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
2857 sun.tools.jstatd.jstatd
.br
.fl
.fi
.LP
.LP
RMI レジストリにデフォルトではないポートを使用して、リモートホスト上で計測された JVM を一覧表示する場合:
.LP
.LP
この例では、内部 RMI レジストリがポート 2002 にバインドされた \f3jstatd\fP サーバーが、リモートホスト上で実行していると想定しています。また、\f2\-m\fP オプションを使用して、一覧表示されたそれぞれの Java アプリケーションの \f2main\fP メソッドに渡される引数を組み込んでいます。
.LP
.nf
\f3
.fl
\fP\f3jps \-m remote.domain:2002\fP
.br
.fl
3002 /opt/jdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
3102 sun.tools.jstatd.jstatd \-p 2002
.fl
.fi
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
「jstatd(1) \- 仮想マシン jstat デーモン」
.TP 2
o
「rmiregistry(1) \- Java リモートオブジェクトレジストリ」
.RE
.LP

324
jdk/src/linux/doc/man/ja/jrunscript.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -21,15 +19,39 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jrunscript 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
.TH jrunscript 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH 名前
jrunscript \- コマンド行スクリプトシェル
.SH "名前"
jrunscript \- コマンド行スクリプトシェル
.LP
.SH "形式"
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
引数
.TP 2
o
例
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
@ -37,149 +59,167 @@ jrunscript \-
\f3
.fl
\fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
.fl
.fl
.fi
.LP
.SH "パラメータ"
.SH "パラメータ"
.LP
.LP
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
arguments
引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
.LP
.SH "説明"
.LP
.LP
.LP
\f3jrunscript\fP はコマンド行スクリプトシェルです。jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
.LP
.LP
\f3注:\fP このツールは試験的なものであり、JDK の将来のバージョンでは使用できない可能性があります。
.LP
.SH "オプション"
.LP
.LP
.TP 3
\-classpath path
スクリプトからのアクセス対象となるユーザの .class ファイルの検索場所を指定します。
.TP 3
\-cp path
\-classpath \f2path\fP と同義です。
.TP 3
\-Dname=value
Java のシステムプロパティを設定します。
.TP 3
\-J<flag>
jrunscript が実行されている Java 仮想マシンに、直接 <flag> を渡します。
.TP 3
\-l language
指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。それには、\-cp、\-classpath のいずれかのオプションを使用します。
.TP 3
\-e script
指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
.TP 3
\-encoding encoding
スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
.TP 3
\-f script\-file
指定されたスクリプトファイルを評価します (バッチモード)。
.TP 3
\-f \-
標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
.TP 3
\-help\
ヘルプメッセージを出力したあと、終了します。
.TP 3
\-?\
ヘルプメッセージを出力したあと、終了します。
.TP 3
\-q\
利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
.LP
.SH "引数"
.LP
.LP
[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ \f3\-e\fP、\f3\-f\fP のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
.LP
.SH "例"
.LP
\f3インラインスクリプトの実行\fP
.LP
.nf
\f3
.fl
jrunscript \-e "print('hello world')"
.fl
jrunscript \-e "cat('http://java.sun.com')"
.fl
\fP
.fi
.LP
\f3指定された言語を使用し、指定されたスクリプトファイルを評価する\fP
.LP
.nf
\f3
.fl
jrunscript \-l js \-f test.js
.fl
\fP
.fi
.LP
\f3対話型モード\fP
.LP
.nf
\f3
.fl
jrunscript
.fl
js>print('hello world');
.fl
hello world
.fl
js>34 + 55
.fl
89
.fl
js> thread(function() { print('hello world'); }
.fl
hello world
.fl
js>
.fl
\fP
.fi
.LP
\f3スクリプト引数を指定してスクリプトファイルを実行する\fP
.LP
.nf
\f3
.fl
jrunscript test.js arg1 arg2 arg3
.fl
\fP
.fi
.LP
test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
.SH "関連項目"
.LP
.LP
JavaScript が使用される場合、jrunscript は、最初のユーザ定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
.LP
.RS 3
.TP 3
options
オプションを使用する場合、コマンド名の直後に記述してください。
.TP 3
arguments
引数を使用する場合、オプションまたはコマンド名の直後に記述してください。
.RE
.LP
.SH " 説明"
.LP
.LP
.LP
\f3jrunscript\fP はコマンド行スクリプトシェルです。 jrunscript は、対話型 (読み取り \- 評価 \- 出力) モードとバッチ (\-f オプション) モードの両方のスクリプト実行をサポートします。これはスクリプト言語に依存しないシェルです。デフォルトの使用言語は JavaScript ですが、\-l オプションを使えばほかの言語も指定できます。jrunscript は、Java とスクリプト言語との通信によって「探求的なプログラミング」スタイルをサポートします。
.LP
.LP
\f3注:\fP このツールは\f3試験的なもの\fPであり、将来の JDK のバージョンでは\f3利用できなくなる\fP可能性があります。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-classpath path
スクリプトからのアクセス対象となるユーザーの .class ファイルの検索場所を指定します。
.TP 3
\-cp path
\-classpath \f2path\fP と同義です。
.TP 3
\-Dname=value
Java のシステムプロパティーを設定します。
.TP 3
\-J<flag>
jrunscript が実行されている Java 仮想マシンに <flag> を渡します。
.TP 3
\-l language
指定されたスクリプト言語を使用します。デフォルトでは JavaScript が使用されます。ほかのスクリプト言語を使用するには、対応するスクリプトエンジンの JAR ファイルも指定する必要があります。 それには、\-cp、\-classpath のいずれかのオプションを使用します。
.TP 3
\-e script
指定されたスクリプトを評価します。このオプションを使えば、コマンド行にすべてが指定された「1 行」スクリプトを実行できます。
.TP 3
\-encoding encoding
スクリプトファイルの読み取り時に使用する文字エンコーディングを指定します。
.TP 3
\-f script\-file
指定されたスクリプトファイルを評価します (バッチモード)。
.TP 3
\-f \-
標準入力からスクリプトを読み取り、それを評価します (対話型モード)。
.TP 3
\-help\
ヘルプメッセージを出力して終了します。
.TP 3
\-?\
ヘルプメッセージを出力して終了します。
.TP 3
\-q\
利用可能なすべてのスクリプトエンジンを一覧表示したあと、終了します。
.RE
.LP
.SH "引数"
.LP
.LP
[arguments...] が存在していて、かつ \f3\-e\fP、\f3\-f\fP のいずれのオプションも使用されなかった場合、最初の引数がスクリプトファイルとなり、他の引数が存在する場合はスクリプト引数として渡されます。[arguments..] が使用され、かつ \f3\-e\fP、\f3\-f\fP のいずれかのオプションが使用された場合、すべての [arguments..] がスクリプト引数として渡されます。[arguments..]、\f3\-e\fP、\f3\-f\fP がどれも存在しなかった場合は、対話型モードが使用されます。スクリプトからスクリプト引数を使用するには、「arguments」という名前の String 配列型のエンジン変数を使用します。
.LP
.SH "例"
.LP
\f3インラインスクリプトの実行\fP
.LP
.RS 3
.LP
.nf
\f3
.fl
jrunscript \-e "print('hello world')"
.fl
jrunscript \-e "cat('http://java.sun.com')"
.fl
\fP
.fi
.RE
.LP
\f3指定された言語を使用し、指定されたスクリプトファイルを評価する\fP
.LP
.RS 3
.LP
.nf
\f3
.fl
jrunscript \-l js \-f test.js
.fl
\fP
.fi
.RE
.LP
\f3対話型モード\fP
.LP
.RS 3
.LP
.nf
\f3
.fl
jrunscript
.fl
js>print('hello world');
.fl
hello world
.fl
js>34 + 55
.fl
89
.fl
js> thread(function() { print('hello world'); }
.fl
hello world
.fl
js>
.fl
\fP
.fi
.RE
.LP
\f3スクリプト引数を指定してスクリプトファイルを実行する\fP
.LP
.RS 3
.LP
.nf
\f3
.fl
jrunscript test.js arg1 arg2 arg3
.fl
\fP
.fi
.RE
.LP
test.js が実行対象となるスクリプトファイルであり、arg1、arg2、および arg3 はスクリプト引数としてスクリプトに渡されます。スクリプトは「arguments」配列を使ってこれらにアクセスできます。
.SH "関連項目"
.LP
.LP
JavaScript が使用される場合、jrunscript は、最初のユーザー定義スクリプトを評価する前に、いくつかの組み込み関数や組み込みオブジェクトを初期化します。これらの JavaScript 組み込み機能については、jsdocs を参照してください。
.LP
.LP

234
jdk/src/linux/doc/man/ja/jsadebugd.1
View File

@ -1,107 +1,149 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jsadebugd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jsadebugd \- サービスエージェントデバッグデーモン
.\"
.SH 形式
.B jsadebugd
.I pid [ server-id ]
.br
.B jsadebugd
.I executable core [ server-id ]
.SH パラメータ
.if t .TP 20
.if n .TP 15
.I pid
デバッグサーバがアタッチするプロセスのプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
.B jps
を使用します。1 つのプロセスにアタッチできるのは、1 つのデバッグサーバだけです。
.if t .TP 20
.if n .TP 15
.I executable
コアダンプが生成された Java 実行可能ファイル。
.if t .TP 20
.if n .TP 15
.I core
デバッグサーバがアタッチするコアファイル。
.if t .TP 20
.if n .TP 15
.I server-id
同じマシン上で複数のデバッグサーバを起動する場合に必要な、オプションの一意 ID。リモートクライアントがアタッチする特定のデバッグサーバを識別するには、この ID を使用する必要があります。1 つのマシン内で、この ID は一意でなければなりません。
.SH 機能説明
.B jsadebugd
は、Java プロセスまたはコアファイルにアタッチして、デバッグサーバとして機能します。
.B jstack
、
.B jmap
、
.B jinfo
などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用してサーバにアタッチできます。
.B jsadebugd
を起動する前に、次のように指定して
.B rmiregistry
を起動する必要があります。
." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jsadebugd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.RS
.ft 3
.nf
rmiregistry -J-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar
.fi
.ft 1
.RE
.LP
$JAVA_HOME は、JDK のインストールディレクトリです。
.B rmiregistry
が起動していなかった場合、
.B jsadebugd
は標準 (1099) ポートで内部的に
.B rmiregistry
を起動します。デバッグサーバを停止するには、SIGINT を送信します (Ctrl-C を押す) 。
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
.B jsadebugd
は、現時点では、Windows プラットフォームでは使用できません。
.SH 関連項目
.SH "名前"
jsadebugd \- サービスアビリティーエージェントデバッグデーモン
.LP
.RS 3
.TP 2
*
jinfo
o
形式
.TP 2
*
jmap
o
パラメータ
.TP 2
*
jps
o
説明
.TP 2
*
jstack
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jsadebugd\fP pid [ server\-id ]
.fl
\f3jsadebugd\fP executable core [ server\-id ]
.fl
.fi
.LP
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
pid
デバッグサーバーが接続するプロセスのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。単一のプロセスに接続できるデバッグサーバーのインスタンスは、1 つに制限されます。
.RE
.LP
.RS 3
.TP 3
executable
.RE
.LP
.RS 3
.TP 3
コアダンプの作成元になる Java 実行可能ファイルです。
.RE
.LP
.RS 3
.TP 3
core
デバッグサーバーを接続するコアファイルです。
.RE
.LP
.RS 3
.TP 3
server\-id
複数のデバッグサーバーが同一のマシン上で実行している場合に必要になる、オプション固有の ID です。この ID は、リモートクライアントが、接続先のデバッグサーバーを特定するために使用する必要があります。この ID は、単一のマシン内で一意でなければなりません。
.RE
.LP
.SH "説明"
.LP
.LP
.LP
\f3jsadebugd\fP は、Java プロセスまたはコアファイルに接続し、デバッグサーバーとして機能します。jstack(1)、jmap(1)、および jinfo(1) などのリモートクライアントは、Java Remote Method Invocation (RMI) を使用しているサーバーに接続できます。\f2jsadebugd\fP を起動する前に、次のように指定して
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi を起動する必要があります。
.LP
.RS 3
.LP
.nf
\f3
.fl
\fP\f4rmiregistry \-J\-Xbootclasspath/p:$JAVA_HOME/lib/sajdi.jar\fP\f3
.fl
\fP
.fi
.RE
.LP
.LP
ここで、\f2$JAVA_HOME\fP は、JDK のインストールディレクトリです。rmiregistry が起動していない場合、jsadebugd は標準 (1099) ポートの rmiregistry を内部で起動します。デバッグサーバーは、SIGINT を送信する (Ctrl+C を押す) ことにより停止できます。
.LP
.LP
\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。 jsadebugd は、現時点では、Windows プラットフォームでは使用できません。\fP
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
*
rmiregistry
o
jinfo(1)
.TP 2
o
jmap(1)
.TP 2
o
jps(1)
.TP 2
o
jstack(1)
.TP 2
o
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
.RE
.LP

272
jdk/src/linux/doc/man/ja/jstack.1
View File

@ -1,75 +1,112 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jstack 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jstack \- スタックトレース
.\"
.SH 形式
.B jstack
.BI [ option ] " pid"
.br
.B jstack
.BI [ option ] " executable core"
." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jstack 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
jstack \- スタックトレース
.br
.B jstack
.BI [ option ] " [server-id@]remote-hostname-or-IP"
.SH パラメータ
オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
「オプション」を参照してください。
.if t .TP 20
.if n .TP 15
.I pid
スタックトレースを出力するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
.B jps
を使用します。
.if t .TP 20
.if n .TP 15
.I executable
コアダンプが生成された Java 実行可能ファイル。
.if t .TP 20
.if n .TP 15
.I core
スタックトレースを出力するコアファイル。
.if t .TP 20
.if n .TP 15
.BI remote-hostname-or-IP
リモートデバッグサーバー (
.B jsadebugd
を参照) のホスト名または IP アドレス。
.if t .TP 20
.if n .TP 15
.I server-id
同じリモートホスト上で複数のデバッグサーバーが動作している場合の、オプションの一意 ID。
.SH 機能説明
.B jstack
は、指定された Java プロセスまたはコアファイルまたはリモートデバッグサーバーの Java スレッドの Java スタックトレースを出力します。それぞれの Java フレームについて、完全なクラス名、メソッド名、'bci' (バイトコードインデックス) 、および行番号 (入手可能な場合) が出力されます。
.B \-m
オプションを指定した場合、
.B jstack
は、すべてのスレッドの Java とネイティブの両方のフレームを 'pc' (プログラムカウンタ) とともに出力します。それぞれのネイティブフレームについて、'pc' に最も近いネイティブシンボル (入手可能な場合) が出力されます。C++ の符号化された (mangled) 名前は復号化 (demangled) されません。C++ 名を復号化するには、このコマンドの出力を c++filt にパイプで渡します。
指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
パラメータ
.br
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.TP 2
o
既知のバグ
.br
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3jstack\fP [ option ] pid
.fl
\f3jstack\fP [ option ] executable core
.fl
\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
.fl
.fi
.LP
.SH "パラメータ"
.LP
.LP
.LP
各オプションは互いに排他的です。オプションを使用する場合、コマンド名の直後に記述します。オプションを参照してください。
.LP
.RS 3
.TP 3
pid
印刷するスタックトレースのプロセス ID です。プロセスは Java プロセスである必要があります。マシン上で実行している Java プロセスの一覧を取得するには、jps(1) を使用します。
.RE
.LP
.RS 3
.TP 3
executable
コアダンプの作成元の Java 実行可能ファイルです。
.br
.TP 3
core
印刷するスタックトレースのコアファイルです。
.br
.TP 3
remote\-hostname\-or\-IP
リモートデバッグサーバー (jsadebugd(1) を参照) のホスト名または IP アドレスです。
.br
.TP 3
server\-id
複数のデバッグサーバーが同一のリモートホストで実行している場合の、オプション固有の ID です。
.RE
.LP
.SH "説明"
.LP
.LP
.LP
\f3jstack\fP は、指定された Java プロセスやコアファイルまたはリモートデバッグサーバーに対する Java スレッドの Java スタックトレースを印刷します。Java フレームごとに、フルクラス名、メソッド名、「bci」(バイトコードインデックス)、および行番号 (利用可能な場合) が印刷されます。\-m オプションを使用すると、jstack は、すべてのスレッドの Java フレームとネイティブフレームの両方を、「pc」(プログラムカウンタ) とともに印刷します。ネイティブフレームごとに、「pc」にもっとも近いネイティブシンボル (利用可能な場合) が印刷されます。C++ 分解名は分解解除されません。C++ 名を分解解除するには、このコマンドの出力を \f3c++filt\fP にパイプします。指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。 次に例を示します。
.br
.LP
@ -86,57 +123,72 @@ jstack \-J\-d64 \-m pid
.RE
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
Windows プラットフォーム上で使用可能な唯一の jstack 形式は、次のとおりです。
.LP
\f3注 \- このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。Windows プラットフォーム上で使用可能な唯一の jstack 形式は、次のとおりです。\fP
.LP
.nf
\f3
.fl
\fP\f3 jstack pid \fP
\fP\f3 jstack [\-l] pid \fP
.fl
.fi
.LP
.SH オプション
.SH "オプション"
.LP
.LP
.TP 3
\-F
「jstack pid」が応答しない場合にスタックダンプを強制します。
.TP 3
\-m
混合モード (Java とネイティブの両方の C/C++ フレーム) のスタックトレースを出力します。
.TP 3
\-h
ヘルプメッセージを出力します。
.br
.br
.TP 3
\-help
ヘルプメッセージを出力します。
.br
.LP
.SH 関連項目
.LP
.RS 3
.TP 2
*
pstack(1)
.TP 2
*
c++filt(1)
.TP 2
*
jps
.TP 2
*
jsadebugd
.TP 3
\-F
「jstack [\-l] pid」が応答しない場合にスタックダンプを強制します。
.TP 3
\-l
長形式のリスト。所有 java.util.concurrent の
.na
\f2所有できるシンクロナイザ\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.htmlの一覧など、ロックについての追加情報を印刷します。
.TP 3
\-m
混合モード (Java およびネイティブ C/C++ フレームの両方) のスタックトレースを印刷します。
.TP 3
\-h
ヘルプメッセージを印刷します。
.br
.br
.TP 3
\-help
ヘルプメッセージを印刷します。
.br
.RE
.LP
.SH 既知の問題
混合モードのスタックトレース (
.B \-m
オプション) は、リモートデバッグサーバーでは機能しません。
.SH "関連項目"
.LP
.RS 3
.TP 2
o
pstack(1)
.TP 2
o
c++filt(1)
.TP 2
o
jps(1)
.TP 2
o
jsadebugd(1)
.RE
.LP
.SH "既知のバグ"
.LP
.LP
.LP
混合モードのスタックトレース (\-m オプション使用) は、リモートデバッグサーバーでは機能しません。
.LP
.LP

5976
jdk/src/linux/doc/man/ja/jstat.1
View File

File diff suppressed because it is too large Load Diff

526
jdk/src/linux/doc/man/ja/jstatd.1
View File

@ -1,248 +1,300 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH jstatd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
jstatd \- 仮想マシン jstat デーモン
.\"
.SH 形式
.B jstatd
.BI [ options ]
.SH パラメータ
.if t .TP 20
.if n .TP 15
.BI options
コマンド行オプション。オプションは任意の順序で指定できます。冗長または矛盾するオプションがあった場合は、最後に指定されたオプションが優先されます。
.SH 機能説明
.B jstatd
ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) の作成と終了を監視する RMI サーバーアプリケーションであり、リモート監視ツールがローカルホスト上で実行している JVM にアタッチするためのインタフェースを備えています。
.LP
jstatd サーバーが機能するためには、ローカルホスト上に RMI レジストリが存在する必要があります。jstatd サーバーは、デフォルトポートまたは
.BI \-p " port"
オプションによって示されたポート上の RMI レジストリへのアタッチを試みます。RMI レジストリが見つからなかった場合は、
.BI \-p " port"
オプションによって示されたポートにバインドされた jstatd アプリケーション内で作成され、
.BI \-p " port"
が省かれた場合はデフォルトの RMI レジストリにバインドされた jstatd アプリケーション内で作成されます。内部 RMI レジストリの作成は、
.B \-nr
オプションを指定することによって禁止できます。
.LP
注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
.SH オプション
.B jstatd
コマンドは、以下のオプションをサポートします。
.if t .TP 20
.if n .TP 15
.BI \-nr
既存の RMI レジストリが見つからないときに、
.B jstatd
プロセス内での内部 RMI レジストリの作成を試みません。
.if t .TP 20
.if n .TP 15
.BI \-p " port"
RMI レジストリを探すポート番号。または、RMI レジストリが見つからず、
.B \-nr
が指定されなかった場合に、RMI レジストリが作成されるポート番号。
.if t .TP 20
.if n .TP 15
.BI \-n " rminame"
RMI レジストリでリモート RMI オブジェクトがバインドされる名前。デフォルトの名前は、JStatRemoteHost です。同じホスト上で複数の
.B jstatd
サーバーが起動している場合、各サーバーのエクスポート RMI オブジェクトの名前を一意にするには、このオプションを指定します。ただし、そのためには、監視クライアントの hostid および vmid 文字列に一意のサーバー名が含まれている必要があります。
.if t .TP 20
.if n .TP 15
.BI \-J option
.I option
を
.B javac
によって呼び出された java 起動ツールに渡します。たとえば、
.B \-J-Xms48m
は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、
.B \-J
の一般的規則です。
.SH セキュリティ
." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH jstatd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.B jstatd
サーバーは、適切なネイティブアクセス権を持っている JVM だけを監視できます。
このため、jstatd プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。
UNIX(TM) ベースのシステムの root ユーザーなど、一部のユーザー資格には、
そのシステム上の任意の JVM によってエクスポートされた計測機構への
アクセス権が割り当てられています。
このような資格で実行中の jstatd プロセスは、そのシステム上の任意の JVM を監視できますが、
これに伴うセキュリティ上の問題も考慮する必要があります。
.LP
jstatd サーバーは、リモートクライアントの認証は行いません。
つまり、jstatd サーバープロセスを実行すると、
jstatd プロセスがアクセス権を持つすべての JVM から
エクスポートされる計測機構が、ネットワーク上の任意のユーザーに公開されます。
計測機構が公開されると、環境によっては望ましくない場合があります。
特に運用環境や安全性の低いネットワークでは、
jstatd プロセスを開始する前に
ローカルセキュリティポリシーを検討する必要があります。
.LP
.B jstatd
サーバーは、他にセキュリティマネージャがインストールされていない場合は、RMISecurityPolicy のインスタンスをインストールするので、セキュリティポリシーファイルを指定する必要があります。
ポリシーファイルは、デフォルトのポリシー実装のポリシーファイル構文
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html)
に従う必要があります。
.LP
次のポリシーファイルでは、
.B jstatd
サーバーはセキュリティ例外を起こさずに実行できます。このポリシーは、
すべてのコードベースへのすべてのアクセス権を許可するよりは自由度が低いですが、
.B jstatd
サーバーの実行に必要な最小限度のアクセス権を許可するポリシーよりは自由度が高いです。
.LP
.RS
.ft 3
.nf
grant codebase "file:${java.home}/../lib/tools.jar" {
permission java.security.AllPermission;
};
.fi
.ft 1
.RE
.LP
このポリシーを使用するには、テキストを jstatd.all.policy という名前のファイルにコピーしたあと、次のようにして
.B jstatd
サーバーを実行します。
.LP
.RS
.ft 3
.nf
jstatd -J-Djava.security.policy=jstatd.all.policy
.fi
.ft 1
.RE
.LP
より厳格なセキュリティを採用しているサイトでは、
カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークに
アクセスを制限できます。ただし、この方法を使用しても、
IP アドレスのスプーフィング攻撃にさらされます。
カスタムポリシーファイルを使用することでセキュリティの問題に対応できない場合には、
jstatd サーバーを実行せずに、
jstat および jps ツールをローカルで使用するのが最も安全です。
.SH リモートインタフェース
.B jstatd
プロセスによってエクスポートされるインタフェースはプロプライエタリであり、変更が保証されています。ユーザーおよび開発者は、このインタフェースに書き込まないようにしてください。
.SH 使用例
.B jstatd
の起動例をいくつか示します。これらの
.B jstatd
スクリプトは、バックグラウンドで自動的にサーバーを起動します。
.SS 内部 RMI レジストリの使用
この例は、内部 RMI レジストリを使用した
.B jstatd
の起動を示しています。この例では、他のサーバーがデフォルトの RMI レジストリポート (ポート 1099) にバインドされていないことを前提としています。
.LP
.RS
.ft 3
.nf
jstatd -J-Djava.security.policy=all.policy
.fi
.ft 1
.RE
.SS 外部 RMI レジストリの使用
この例は、外部 RMI レジストリを使用した
.B jstatd
の起動を示しています。
.LP
.RS
.ft 3
.nf
rmiregistry&
jstatd -J-Djava.security.policy=all.policy
.fi
.ft 1
.RE
.LP
この例は、ポート 2020 上の外部 RMI レジストリサーバーを使用した
.B jstatd
の起動を示しています。
.LP
.RS
.ft 3
.nf
rmiregistry 2020&
jstatd -J-Djava.security.policy=all.policy -p 2020
.fi
.ft 1
.RE
.LP
この例は、ポート 2020 上の、AlternateJstatdServerName という名前にバインドされた外部 RMI レジストリを使用した
.B jstatd
の起動を示しています。
.LP
.RS
.ft 3
.nf
rmiregistry 2020&
jstatd -J-Djava.security.policy=all.policy -p 2020 -n AlternateJstatdServerName
.fi
.ft 1
.RE
.SS プロセス内 RMI レジストリの作成の禁止
この例は、RMI レジストリが見つからない場合も RMI レジストリを作成しないように
.B jstatd
を起動する例を示しています。この例では、RMI がすでに実行していることを前提としています。実行していなかった場合は、適切なエラーメッセージが表示されます。
.LP
.RS
.ft 3
.nf
jstatd -J-Djava.security.policy=all.policy -nr
.fi
.ft 1
.RE
.SS RMI ロギング機能の有効化
この例は、RMI ロギング機能を有効にして
.B jstatd
を起動する例を示しています。この方法は、障害追跡やサーバー活動の監視に役立ちます。
.LP
.RS
.ft 3
.nf
jstatd -J-Djava.security.policy=all.policy -J-Djava.rmi.server.logCalls=true
.fi
.ft 1
.RE
.LP
.SH 関連項目
.SH "名前"
jstatd \- 仮想マシン jstat デーモン
.LP
.RS 3
.TP 2
*
java \- Java アプリケーション起動プログラム
o
形式
.TP 2
*
jps \- Java 仮想マシンプロセスステータスツール
o
パラメータ
.TP 2
*
jstat \- Java 仮想マシン統計監視ツール
o
説明
.TP 2
*
rmiregistry \- Java リモートオブジェクトレジストリ
o
オプション
.TP 2
o
セキュリティー
.TP 2
o
リモートインタフェース
.TP 2
o
例
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.nf
\f3
.fl
jstatd [ \fP\f4options\fP\f3 ]\fP
.br
\f3
.fl
\fP
.fi
.LP
.SH "パラメータ"
.LP
.LP
.RS 3
.TP 3
options
コマンド行オプション。オプションは任意の順序で指定できます。重複または矛盾するオプションがある場合、最後に指定したオプションが優先されます。
.RE
.LP
.SH " 説明"
.LP
.LP
.LP
\f3jstatd\fP ツールは、計測された HotSpot Java 仮想マシン (JVM) の作成と終了を監視し、ローカルシステム上で実行している Java 仮想マシンに、リモート監視ツールが接続できるようにするためのインタフェースを提供する RMI サーバーアプリケーションです。
.LP
.LP
\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 オプションを指定することによって禁止することができます。
.LP
.LP
\f3注:\fP このユーティリティーはサポート対象外であり、将来の JDK のバージョンでは利用できなくなる可能性があります。現在、Windows 98 および Windows Me プラットフォームでは使用できません。
.LP
.SH "オプション"
.LP
.LP
.LP
\f3jstatd\fP コマンドは次のオプションをサポートしています。
.LP
.RS 3
.TP 3
\-nr
既存の RMI レジストリが見つからない場合、\f2jstatd\fP プロセス内に内部 RMI レジストリを作成しないようにします。
.TP 3
\-p\ port
RMI レジストリがあると予想されるポート番号です。 見つからない場合は、\f2\-nr\fP が指定されていなければ作成されます。
.TP 3
\-n\ rminame
RMI レジストリにおいて、リモート RMI オブジェクトがバインドされる名前です。デフォルト名は \f2JStatRemoteHost\fP です。複数の \f3jstatd\fP サーバーが同じホスト上で起動している場合、各サーバーのエクスポートした RMI オブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、監視クライアントの \f2hostid\fP および \f2vmid\fP 文字列に、その一意のサーバー名を含める必要があります。
.TP 3
\-Joption
\f3javac\fP が呼び出す \f3java\fP 起動ツールに、\f2option\fP を渡します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.RE
.LP
.SH "セキュリティー"
.LP
.LP
.LP
\f3jstatd\fP サーバーは、有効なネイティブアクセス権を持つ JVM だけを監視できます。したがって、\f3jstatd\fP プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。一部のユーザー資格は、Unix(TM) ベースのシステムにおける \f2root\fP ユーザーのように、システム上の任意の JVM によってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格で実行している \f3jstatd\fP プロセスは、システム上のすべての JVM を監視できますが、セキュリティー上の別の問題が起こります。
.LP
.LP
\f3jstatd\fP サーバーは、リモートクライアントの認証を一切与えません。そのため、\f3jstatd\fP サーバープロセスを実行すると、\f3jstatd\fP プロセスがアクセス権を持つすべての JVM によるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境的に望ましくない場合があります。 特に実稼働環境または安全でないネットワークでは、\f3jstatd\fP プロセスを起動する前に、ローカルセキュリティーポリシーを検討する必要があります。
.LP
.LP
\f3jstatd\fP サーバーは、他のセキュリティーマネージャーがインストールされていない場合には、RMISecurityPolicy のインスタンスをインストールします。 そのため、セキュリティーポリシーファイルを指定する必要があります。ポリシーファイルは、デフォルトポリシー実装の
.na
\f2ポリシーファイルの構文\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.htmlに準拠する必要があります。
.LP
.LP
次のポリシーファイルの場合、\f3jstatd\fP サーバーは一切のセキュリティー例外を使用せずに実行できます。このポリシーは、すべてのコードベースへのあらゆるアクセス権を認めるポリシーよりも自由度は低いですが、\f3jstatd\fP サーバーを実行するために最低限必要なアクセス権しか認めないポリシーよりも自由度は高くなっています。
.LP
.nf
\f3
.fl
grant codebase "file:${java.home}/../lib/tools.jar" {\fP
.br
\f3
.fl
permission java.security.AllPermission;\fP
.br
\f3
.fl
};\fP
.br
\f3
.fl
\fP
.fi
.LP
.LP
このポリシーを使用するには、このテキストを \f2jstatd.all.policy\fP というファイルにコピーし、次のように \f3jstatd\fP サーバーを実行します。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=jstatd.all.policy\fP
.br
\f3
.fl
\fP
.fi
.LP
.LP
より厳しいセキュリティーを実施するサイトの場合、カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。 ただし、このような方法は、IP アドレスの盗聴攻撃を受けやすくなります。セキュリティーの問題について、カスタマイズしたポリシーファイルでも対処できない場合は、\f3jstatd\fP サーバーを実行せずに、\f3jstat\fP と \f3jps\fP ツールをローカルで使用することがもっとも安全な方法になります。
.LP
.SH "リモートインタフェース"
.LP
.LP
.LP
\f3jstatd\fP プロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書き込みを行わないでください。
.LP
.SH "例"
.LP
.LP
.LP
次に \f3jstatd\fP を起動する例を紹介します。\f3jstatd\fP スクリプトによって、サーバーはバックグラウンドで自動的に起動します。
.LP
.SS
内部 RMI レジストリの使用
.LP
.LP
この例は、内部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。この例では、デフォルトの RMI レジストリポート (ポート 1099) には、他のサーバーはバインドされていないと想定しています。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=all.policy
.fl
\fP
.fi
.LP
.SS
外部 RMI レジストリの使用
.LP
.LP
この例は、外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry&
.fl
jstatd \-J\-Djava.security.policy=all.policy
.fl
\fP
.fi
.LP
.LP
この例は、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry 2020&
.fl
jstatd \-J\-Djava.security.policy=all.policy \-p 2020
.fl
\fP
.fi
.LP
.LP
この例は、AlternateJstatdServerName の名前にバインドされた、ポート 2020 の外部 RMI レジストリを使用した \f3jstatd\fP の起動を表しています。
.LP
.nf
\f3
.fl
rmiregistry 2020&
.fl
jstatd \-J\-Djava.security.policy=all.policy \-p 2020 \-n AlternateJstatdServerName
.fl
\fP
.fi
.LP
.SS
インプロセス RMI レジストリの作成の禁止
.LP
.LP
この例は、RMI レジストリが見つからない場合に RMI レジストリを作成しない \f3jstatd\fP の起動を表しています。この例では、RMI レジストリがすでに実行していると想定しています。実行していない場合は、該当するエラーメッセージが表示されます。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=all.policy \-nr
.fl
\fP
.fi
.LP
.SS
RMI ログ機能の有効化
.LP
.LP
この例は、RMI ログ機能を有効にした \f3jstatd\fP の起動を表しています。この方法は、トラブルシューティングまたはサーバー活動の監視に役立ちます。
.LP
.nf
\f3
.fl
jstatd \-J\-Djava.security.policy=all.policy \-J\-Djava.rmi.server.logCalls=true
.fl
\fP
.fi
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
「java(1) \- Java アプリケーション起動ツール」
.TP 2
o
「jps(1) \- Java 仮想マシンプロセスステータスツール」
.TP 2
o
「jstat(1) \- Java 仮想マシン統計データ監視ツール」
.TP 2
o
「
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- Java リモートオブジェクトレジストリ」
.RE
.LP

865
jdk/src/linux/doc/man/ja/keytool.1
View File

File diff suppressed because it is too large Load Diff

184
jdk/src/linux/doc/man/ja/native2ascii.1
View File

@ -1,103 +1,83 @@
'\" t
.\"
.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH native2ascii 1 "2004 年 6 月 22 日"
.SH "名前"
native2ascii \- ネイティブコードから ASCII への変換
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
.SH "形式"
.B native2ascii
[
.B options
]
.if n .ti +5n
[
.IR inputfile " [" outputfile "]]"
.SH "機能説明"
.IX "native to ASCII converter" "" "native to ASCII converter \(em \fLnative2ascii\fP"
.IX "native2ascii" "" "\fLnative2ascii\fP \(em native to ASCII converter"
Java コンパイラなどの
Java
ツールが処理できるファイルは、
Latin-1
文字もしくは\^
Unicode
でエンコードされた文字
(\\udddd)
からなるファイルだけです。
.B native2ascii
は、他の文字コードのファイルを
Latin-1
または
Unicode
エンコーディングのファイルに変換します。
.LP
.I outputfile
引数を省略すると、出力先は標準出力となります。
また、
.I inputfile
引数を省略すると、入力元は標準入力となります。
.SH "オプション"
以下のオプションが使用できます。
.TP 5
.B \-encoding \f2encoding_name\f1
変換処理で用いるエンコーディング名を指定します。
デフォルトのエンコーディング名は、システムプロパティの
\f3file.encoding\f1
から得られます。
.I encoding_name
文字列は、ドキュメント「サポートされているエンコーディング」の、
サポートされるエンコーディングの表で最初の列にある文字列の 1 つでなければ
なりません。
.br
http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
.\" http://java.sun.com/j2se/1.5/docs/guide/intl/encoding.doc.html
.TP 5
.B \-reverse
逆の変換処理を行います。つまり
Latin-1
または
Unicode
でエンコーディングされている文字を、ネイティブコードに変換します。
.TP 15
.BI \-J "option"
.I option
を Java 仮想マシンに渡します。ここで、
.I option
は、Java アプリケーション起動プログラム java(1) のマニュアルページで
説明されているオプションの 1 つです。たとえば、
.I \-J-Xms48m
は、起動時に使用するメモリを 48M バイトに設定します。
.B \-J
が基本となる仮想マシンにオプションを渡すことは、共通の規約です。
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH native2ascii 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
native2ascii \- ネイティブ \- ASCII コンバータ
.LP
.RS 3
.LP
.LP
ネイティブコード (Latin 1 および Unicode 以外) のファイルを Unicode コードに変換します。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f4native2ascii\fP\f2 [options] [inputfile [outputfile]]\fP
.fl
.fi
.LP
.SH "説明"
.LP
.LP
.LP
Java コンパイラおよびその他の Java ツールは、Latin\-1 または Unicode コード (\\udddd 表記) 文字を含んだファイルだけを処理することができます。 \f2native2ascii\fP は、これら以外の文字コードのファイルを Latin\-1 または Unicode コードのファイルに変換します。
.LP
.LP
\f2outputfile\fP を省略した場合、標準出力に出力されます。さらに、\f2inputfile\fP を省略した場合、標準入力から入力されます。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-reverse
逆の処理を行います。つまり、Latin\-1 または Unicode コードのファイルをネイティブコードに変換します。
.br
.br
.TP 3
\-encoding encoding_name
変換処理で使用するコードの名前を指定します。デフォルトのコードは、システムプロパティーの \f2file.encoding\fP から取得されます。\f2encoding_name\fP 文字列は、
.na
\f4「サポートされているエンコーディング」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.htmlドキュメントに示されている、サポートされるエンコーディングの表の最初の列から取得される必要があります。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.LP

352
jdk/src/linux/doc/man/ja/orbd.1
View File

@ -1,42 +1,46 @@
'\" t
.\"
.\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH orbd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
orbd - Object Request Broker デーモン
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH orbd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.B orbd
は、クライアントが CORBA 環境内のサーバー上に存在する
持続オブジェクトを透過的に特定して呼び出す場合に使用します。
.SH "名前"
orbd \- The Object Request Broker Daemon
.LP
\f3関連項目:\fP
.RS 3
.LP
.LP
\f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。
.LP
.LP
\f3関連項目:\fP
.na
\f2「Naming Service」\fP
\f2ネームサービス\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.LP
.SH "形式"
.RE
.SH "形式"
.LP
.LP
@ -49,86 +53,118 @@ orbd <\fP\f3options\fP\f3>
.fi
.LP
.SH "機能説明"
\f3orbd\fP ツールを含むサーバーマネージャは、クライアントが CORBA 環境内のサーバー上に存在する持続オブジェクトを透過的に特定して呼び出す場合に使用します。持続サーバーは、ネームサービス内の持続オブジェクト参照を発行する一方で、オブジェクト参照内にサーバーのポート番号ではなく ORBD のポート番号を組み込みます。持続オブジェクト参照のためにオブジェクト参照内に ORBD ポート番号を組み込むと、以下の利点が得られます。
.SH "説明"
.LP
.LP
.LP
\f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。
.LP
.RS 3
.TP 2
*
ネームサービス内のオブジェクト参照は、サーバーのライフサイクルとは無関係に維持されます。たとえば、オブジェクト参照はサーバーの最初のインストール時にネームサービス内でサーバーによって発行され、その後は何度サーバーの起動または停止が行われても ORBD は常に呼び出し側のクライアントに正しいオブジェクト参照を返します。
o
ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。
.TP 2
*
クライアントはネームサービス内でオブジェクト参照を 1 度確認する必要があり、サーバーのライフサイクルが原因で起きる変更に関係なくこの参照を繰り返し使用できます。
o
クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる
.RE
.LP
.LP
ORBD のサーバーマネージャにアクセスするには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2サーバーマネージャ\fPの詳細については、このドキュメントの「サーバーマネージャ」の節を参照してください。
ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。 servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの\f2「サーバーマネージャー」\fPを参照してください。
.LP
.LP
\f2orbd\fP の起動時にはネームサービスも起動されます。ネームサービスの詳細については、
\f2orbd\fP を起動すると、ネームサービスも起動されます。ネームサービスについては、
.na
「\f2Naming Service\fP」
\f2「ネームサービス」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
.SH "オプション"
.LP
.SS
必須オプション
.LP
.RS 3
.TP 3
\-ORBInitialPort nameserverport
ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアの使用時は、1024 より小さいポートでプロセスを開始する場合、root ユーザーになる必要があります。 このため、1024 または 1024 より大きいポートを使用することをお勧めします。 (必須)
.RE
.LP
.SH 必須オプション
.LP
.LP
.SS
その他のオプション
.LP
.RS 3
.TP 3
\-ORBInitialPort nameserverport
ネームサーバーを起動するポートを指定します。起動後に \f2orbd\fP はこのポートで着信要求を待機します。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。 (必須)
.LP
.SH その他のオプション
.LP
\-port port
ORBD を起動するポートを指定します。 ORBD は、このポートで、持続オブジェクトに対する要求を受け取ります。このポートのデフォルト値は 1049 です。 このポート番号は持続 Interoperable Object References (IOR) のポートフィールドに追加されます。(省略可)
.RE
.LP
.RS 3
.TP 3
\-port port
ORBD を開始する起動ポートを指定します。ORBD はこのポートで、持続オブジェクトの要求を受け付けます。このポートのデフォルト値は 1049 です。このポート番号は、持続 Interoperable Object References (IOR) のポートフィールドに追加されます。(省略可能)
\-defaultdb directory
ORBD 持続格納ディレクトリ \f2orb.db\fP が作成されるベースディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」となります。(省略可)
.RE
.LP
.RS 3
.TP 3
\-defaultdb directory
ORBD 持続ストレージディレクトリである \f2orb.db\fP が作成されるベースを指定します。このオプションが指定されない場合、デフォルト値は "./orb.db" です。(省略可能)
.TP 3
\-serverPollingTime milliseconds
\f2servertool\fP 経由で登録された持続サーバーの健全性を ORBD が検査する頻度を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
\-serverPollingTime milliseconds
\f2servertool\fP を使用して登録された持続サーバーが正常に動作していることを ORBD が確認する回数を指定します。デフォルト値は 1,000 ミリ秒です。 「ミリ秒」の指定値は有効な整数値である必要があります。(省略可)
.RE
.LP
.RS 3
.TP 3
\-serverStartupDelay milliseconds
\f2servertool\fP 経由で登録された持続サーバーが再起動されてから ORBD がロケーション転送例外を送信するまでの、ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒 (1 秒) です。\f2milliseconds\fP に指定される値は、有効な正の整数でなければなりません (省略可能)。
.TP 3
\-Joption
\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、「\f2Java アプリケーション起動プログラム\fP」
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP は、起動時に使用するメモリを 48M バイトに設定します。\f3\-J\fP が基本にする仮想マシンにオプションを渡すことは、共通の規約です。
.LP
.SH ネームサービスの起動と停止
.LP
.LP
ネームサービスは、名前をオブジェクト参照にバインドすることによって、「\f2CORBA objects\fP」
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20object) を指定できるようにする CORBA サービスです。「\f2name binding\fP」
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20binding) は、ネーミングサービスに保存できます。クライアントは名前を指定して、目的のオブジェクト参照を取得できます。
.LP
.LP
クライアントまたはサーバーを実行する前に、ORBD を開始します。ORBD には、持続ネーミングサービスと一時ネーミングサービスが含まれています。これらは両方とも COS ネーミングサービスの実装です。
.LP
.RS 3
.TP 2
*
\f4持続\fP\f3ネーミングサービス\fPは、ネーミングコンテキストに持続性を提供します。つまり、この情報はサービスの停止と起動の間で持続し、サービスに障害が発生した場合に回復可能です。ORBD が再起動されると、持続ネーミングサービスはネーミングコンテキストグラフを復元するため、すべてのクライアントとサーバーの名前のバインディングは損傷を受けません (持続する)。
.TP 2
*
以前のバージョンとの互換性のため、\f2tnameserv\fP (以前のバージョンの JDK と一緒に出荷された\f4一時\fP\f3ネーミングサービス\fP) もこのリリースの J2SE に含まれています。一時ネーミングサービスが実行されている限り、ネーミングコンテキストは保持されます。サービスが中断された場合、ネーミングコンテキストグラフは失われます。
\f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。 「ミリ秒」の指定値は有効な整数値である必要があります。(省略可)
.RE
.LP
.RS 3
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.TP 3
.RE
.LP
\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP に必須のコマンド行引数で、ネーミングサービスが実行されるポート番号の設定に使用されます。以下の説明は、Java\ IDL Object Request Broker Daemon にポート 1050 を使用できると仮定しています。Solaris ソフトウェアを使用する場合は、スーパーユーザーになって 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。必要な場合は、別のポートを使用することもできます。
.SH "ネームサービスの起動と停止"
.LP
.LP
UNIX コマンドシェルから \f2orbd\fP を起動するには、次のように入力します。
ネームサービスは、
.na
\f2CORBA オブジェクト\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にする CORBA サービスです。 ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。
.na
\f2「ネームバインディング」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingはネームサービスに格納され、クライアントは名前を与えて目的のオブジェクト参照を取得できます。
.LP
.LP
ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。 これらはどちらも COS ネームサービスの実装です。
.LP
.LP
\f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。
.LP
.LP
\
.LP
.LP
下位互換性のため、旧バージョンの JDK に同梱されていた\f3一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。
.LP
.LP
\f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、Java\ IDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアの使用時は、1024 より小さいポートでプロセスを開始する場合は、root ユーザーになる必要があります。 このため、1024 または 1024 より大きいポートを使用することをお勧めします。
.LP
.LP
UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.nf
\f3
@ -140,7 +176,7 @@ UNIX
.LP
.LP
MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@ -152,7 +188,7 @@ MS\-DOS
.LP
.LP
ORBD の実行後に、サーバーおよびクライアントアプリケーションを実行できます。クライアントおよびサーバーアプリケーションを実行する場合は、ネーミングサービスが実行されているポート番号 (および該当する場合は、マシン名) をアプリケーションに認識させる必要があります。これを実行する方法の 1 つとして、次のコードをアプリケーションに追加することができます。
これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。
.LP
.nf
\f3
@ -170,7 +206,7 @@ ORBD
.LP
.LP
この例では、ネーミングサービスはホスト「MyHost」のポート 1050 で実行されています。また、サーバーまたはクライアントアプリケーションの実行時にコマンド行からポート番号またはマシン名を指定することもできます。たとえば、「HelloApplication」を次のコマンド行で起動します。
この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。
.LP
.nf
\f3
@ -182,31 +218,39 @@ ORBD
.LP
.LP
ネーミングサービスを停止するには、該当するオペレーティングシステムコマンドを使用します (Solaris での \f2pkill orbd\fP、または \f2orbd\fP が実行されている DOS ウィンドウでの \f2Ctrl+C\fP など)。一時ネームサービスの場合、サービスが終了すると、ネーミングサービスに登録されている名前が消失する可能性があります。Java IDL ネーミングサービスは明示的に停止されるまで実行します。
ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。 たとえば、Solaris では \f2pkill orbd\fP を使用し、\f2orbd\fP が実行されている DOS ウィンドウでは \f2Ctrl+C\fP キーを使用します。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。
.LP
ORBD に含まれているネーミングサービスの詳細については、「\f2Naming Service\fP」
.LP
ORDB に含まれるネームサービスの詳細については、
.na
\f2「ネームサービス」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) を参照してください。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。
.LP
.SH サーバーマネージャ
.SH "サーバーマネージャー"
.LP
.LP
ORBD のサーバーマネージャにアクセスして持続サーバーを実行するには、\f2servertool\fP を使用してサーバーを起動する必要があります。\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、停止を行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合、\f2orbd\fP と同じホストおよびポートで起動する必要があります。異なるポートでサーバーが起動された場合、ローカルコンテキストのデータベースに格納されている情報は無効になり、サービスは正常に機能しなくなります。
ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。 servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。servertool を使用してサーバーを起動する場合は、\f2orbd\fP が実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカルコンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
.LP
.SS
サーバーマネージャ: 例
.SS
サーバーマネージャー:例
.LP
.LP
デモ用のサンプルチュートリアル
デモ用の
.na
\f2サンプルチュートリアル\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.html) を使って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラをチュートリアルで示されているように実行します。サーバーマネージャを実行するには、以下の手順に従ってアプリケーションを実行します。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラを実行します。サーバーマネージャーを実行するには、次の手順に従ってアプリケーションを実行します。
.LP
.RS 3
.TP 3
1.
orbd を起動します。
.LP
\f2orbd\fP を UNIX コマンドシェルから起動するには、次のように入力します。
\f2orbd\fP を起動します。
.LP
.LP
UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。
.LP
.LP
\
.LP
.nf
\f3
.fl
@ -214,8 +258,11 @@ orbd
.fl
\fP
.fi
.LP
.LP
Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
MS\-DOS システムプロンプト (Windows) から起動するには、次のように入力します。
.nf
\f3
.fl
@ -223,13 +270,17 @@ MS\-DOS
.fl
\fP
.fi
.LP
\f21050\fP は、ネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必須のコマンド行引数です。Solaris ソフトウェアを使用する場合は、ルートから 1024 未満のポートでプロセスを開始する必要があります。このため、1024 以上のポート番号の使用を推奨します。
.TP 3
2.
\f2servertool\fP を起動します。
.LP
Hello サーバーを起動するには、次のように入力します。
\f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアの使用時は、1024 より小さいポートでプロセスを開始する場合は、root ユーザーになる必要があります。 このため、1024 または 1024 より大きいポートを使用することをお勧めします。
.LP
.LP
\f2servertool\fP を起動します。
.LP
.LP
Hello サーバーを起動するには、次のように入力します。
.LP
.nf
\f3
.fl
@ -237,26 +288,43 @@ Hello
.fl
\fP
.fi
.LP
ネームサーバー (\f2orbd\fP) のポートが前の手順で使用したポート (たとえば、\f2\-ORBInitialPort 1050\fP) と同じであることを確認してください。\f2servertool\fP は、ネームサーバーと同じポートで起動する必要があります。
.LP
\f2servertool\fP コマンド行インタフェースが表示されます。
.TP 3
3.
Hello サーバーを \f2servertool\fP プロンプトから起動します。
前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。 たとえば \f2\-ORBInitialPort 1050\fP のようになります。\f2servertool\fP は、ネームサーバーと同じポート上で起動する必要があります。
.LP
.LP
\f2servertool\fP コマンド行インタフェースが表示されます。
.LP
.LP
.LP
.LP
\f2servertool\fP プロンプトから Hello サーバーを起動します。
.LP
.nf
\f3
.fl
servertool > register \-server HelloServer \-classpath .
\-applicationName HelloServerApName
servertool > register \-server HelloServer \-classpath . \-applicationName
.fl
HelloServerApName
.fl
\fP
.fi
.LP
.LP
\f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。
.LP
.LP
.LP
.LP
別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。
.LP
.LP
\
.LP
\f2servertool\fP は、このサーバーを登録し、それに「HelloServerApName」という名前を割り当て、そのサーバー ID と登録されているすべてのサーバーの一覧を表示します。
.TP 3
4.
クライアントアプリケーションを別のターミナルウィンドウまたはプロンプトから実行します。
.nf
\f3
.fl
@ -264,32 +332,42 @@ Hello
.fl
\fP
.fi
.LP
この例の場合、ネームサーバーは Hello クライアントと同じホストで実行されているので、\f2\-ORBInitialHost localhost\fP を省くことができます。ネームサーバーが別のホストで実行されている場合は、\f2\-ORBInitialHost\fP \f2nameserverhost\fP を使用して IDL ネームサーバーが実行されているホストを指定します。
.LP
前の手順と同様に、ネームサーバー (\f2orbd\fP) のポート (たとえば、\f2\-ORBInitialPort 1050\fP) を指定します。
.TP 3
5.
サーバーマネージャの実験が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を必ず停止 (終了) してください。
.LP
\f2orbd\fP を DOS プロンプトから停止するには、サーバーが実行されているウィンドウを選択し、\f2Ctrl+C\fP を押して停止します。\f2orbd\fP を UNIX シェルから停止するには、プロセスを検索して終了します。サーバーは、明示的に停止されるまで起動を引き続き待機します。
.LP
\f2servertool\fP を停止するには、\f2quit\fP と入力し、キーボードの \f2Enter\fP キーを押します。
.RE
.LP
.SH 関連項目
.LP
この例の \f2\-ORBInitialHost localhost\fP は省略することができます。 ネームサーバーが Hello クライアントとして同一ホスト上で動作しているからです。ネームサーバーが別のホストで動作している場合は、IDL ネームサーバーが動作しているホストを \f2\-ORBInitialHost\fP \f2nameserverhost\fP で指定します。
.LP
.LP
前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。 たとえば \f2\-ORBInitialPort 1050\fP のようになります。
.LP
.LP
\
.LP
.LP
\
.LP
.LP
サーバーマネージャーの操作が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を停止するか終了してください。
.LP
.LP
DOS プロンプトで \f2orbd\fP をシャットダウンするには、サーバーを実行しているウィンドウを選択して \f2Ctrl+C\fP と入力します。UNIX シェルで \f2orbd\fP をシャットダウンするには、プロセスを検出して終了 (kill) します。サーバーを明示的に停止するまでは、呼び出し待機状態が続きます。
.LP
.LP
\f2servertool\fP をシャットダウンするには、\f2quit\fP と入力し、キーボードの \f2Enter\fP キーを押します。
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
*
「\f2Naming Service\fP」
o
.na
\f2ネームサービス\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html)
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.br
.TP 2
*
servertool
o
servertool(1)
.RE
.LP

310
jdk/src/linux/doc/man/ja/pack200.1
View File

@ -1,92 +1,121 @@
'\t" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH pack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
pack200 \- JAR パックツール
.SH 形式
.B pack200
[
.I options
]
.I output\-file
.I JAR\-file
.SH
オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
." Copyright Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH pack200 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
pack200 \- JAR パックツール
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
終了ステータス
.TP 2
o
関連項目
.TP 2
o
説明
.RE
.LP
.SH "形式"
.LP
.LP
.LP
\f4pack200\fP\f2 [ \fP\f2options\fP ] \f2output\-file\fP \f2JAR\-file\fP
.LP
.LP
オプションの指定順序に決まりはありません。コマンド行または properties ファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS 3
.JP
.LP
.RS 3
.TP 3
options
コマンド行オプション。
コマンド行オプション。
.TP 3
output\-file
出力ファイルの名前。
output\-file
出力ファイルの名前。
.TP 3
JAR\-file
入力ファイルの名前。
JAR\-file
入力ファイルの名前。
.RE
.LP
.RE
.SH 機能説明
.SH " 説明"
.LP
.LP
.LP
\f2pack200\fP ツールは、Java \f2gzip\fP 圧縮ツールを使って JAR ファイルを圧縮 \f2pack200\fP ファイルに変換する Java アプリケーションです。\f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
.LP
\f2pack200\fP ツールは、Java \f2gzip\fP 圧縮プログラムを使用して、JAR ファイルを \f2pack200\fP 圧縮ファイルに変換する Java アプリケーションです。\f2pack200\fP ファイルは高圧縮のファイルで、帯域幅の節約やダウンロード時間の短縮や直接配備することができます。
.LP
.LP
\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
.LP
.SS
一般的な使用方法:
.LP
.RS 3
.LP
\f2pack200\fP ツールには、圧縮エンジンの設定や微調整を行うオプションが用意されています。
.TP
一般的な使用方法:
.LP
.ft 3
.nf
\f2% pack200 myarchive.pack.gz myarchive.jar\fP
.fi
.ft 1
.LP
この例では、デフォルトの \f2pack200\fP 設定で、\f2myarchive.pack.gz\fP が作成されます。
.RE
.LP
.SH オプション
この例では、デフォルトの \f2pack200\fP 設定で、\f2myarchive.pack.gz\fP が作成されます。
.LP
.SH "オプション"
.LP
.LP
.LP
.LP
\f4\-r \-\-repack\fP
.LP
.RS 3
.LP
.LP
\f2myarchive.jar\fP ファイルのパックまたはアンパックにより、JAR ファイルを作成します。作成されたファイルは、\f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
\f2myarchive.jar\fP ファイルをパックした後にアンパックすることにより、JAR ファイルを生成します。生成されたファイルは、\f2jarsigner(1)\fP ツールの入力ファイルとして使用できます。
.LP
.RS 3
.LP
.LP
\f2% pack200 \-\-repack myarchive\-packed.jar myarchive.jar\fP
\f2% pack200 \-\-repack myarchive\-packer.jar myarchive.jar\fP
.LP
.LP
\f2% pack200 \-\-repack myarchive.jar\fP
@ -100,7 +129,7 @@ JAR\-file
.LP
.LP
\f2pack200\fP ファイルを作成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
\f2pack200\fP ファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。 また、ターゲットシステムでは、対応する圧縮解除ツールを使用する必要があります。
.LP
.RS 3
@ -111,13 +140,13 @@ JAR\-file
.RE
.RE
.LP
\f4\-G \-\-strip-debug\fP
\f4\-G \-\-strip\-debug\fP
.LP
.RS 3
.LP
.LP
出力からデバッグ用の属性を削除します。対象となる属性には、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、および \f2LocalVariableTypeTable\fP などがあります。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
出力からデバッグ用の属性を削除します。対象となる属性には、\f2SourceFile\fP、\f2LineNumberTable\fP、\f2LocalVariableTable\fP、および \f2LocalVariableTypeTable\fP などがあります。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
.LP
.RE
.LP
@ -127,7 +156,7 @@ JAR\-file
.LP
.LP
パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
パックツールは、すべての要素を並べ替えて転送します。また、JAR ディレクトリ名を削除します。このため、ダウンロードのサイズは小さくなりますが、インデックスをはじめとする JAR ファイルの最適化機能は正常に動作しなくなることがあります。
.LP
.RE
.LP
@ -137,16 +166,18 @@ JAR\-file
.LP
.LP
各アーカイブセグメントの予測ターゲットサイズ N (バイト) を指定します。N バイト以上を必要とする単一の入力ファイルには、独立したアーカイブセグメントが割り当てられます。たとえば、これは特殊な例ですが、値が \f2-1\fP の場合、すべての入力ファイルを含む単一の巨大なセグメントが生成されます。一方、値が \f20\fP の場合、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントのサイズが大きければ大きいほど断片化は起こりにくく、圧縮率も高くなります。しかし、こうしたセグメントを処理するためには、大量のメモリが必要になります。
この値は、各アーカイブセグメントの予想ターゲットサイズ N (バイト単位) です。N バイト以上を必要とする単一の入力ファイルには、
.br
独立したアーカイブセグメントが割り当てられます。たとえば、これは特殊な例ですが、値が \f2\-1\fP の場合、すべての入力ファイルを含む単一の巨大なセグメントが生成されます。 一方、値が \f20\fP の場合、クラスごとにセグメントが 1 つずつ生成されます。アーカイブセグメントのサイズが大きければ大きいほど断片化は起こりにくく、圧縮率も高くなります。しかし、こうしたセグメントを処理するためには、大量のメモリーが必要になります。
.LP
.LP
各セグメントのサイズは、セグメント内で転送される入力ファイルのサイズと、このファイルの名前のサイズ、およびその他の転送プロパティによって予測されます。
各セグメントのサイズは、セグメント内で転送される入力ファイルのサイズと、このファイルの名前のサイズ、およびその他の転送プロパティーによって予測されます。
.LP
.LP
デフォルトのサイズは \f21000000\fP (百万バイト) です。これは、標準サイズの入力 JAR ファイルを単一セグメント内で転送できるサイズです。パックツールおよびアンパックツールのメモリ要件には制限が課されます。
デフォルトのサイズは \f21000000\fP (100 万バイト) です。これは、標準サイズの入力 JAR ファイルを単一セグメント内で転送できるサイズです。パックツールおよびアンパックツールのメモリー要件には制限が課されます。
.LP
.LP
この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
この制限が課されていない 10M バイトの JAR パックファイルは通常、元の 10% 程度のサイズにパックされます。 しかし、パックツールでより大きな Java ヒープ (セグメントの制限の約 10 倍) を必要とする場合もあります。
.LP
.RE
.LP
@ -156,11 +187,10 @@ JAR\-file
.LP
.LP
単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合、圧縮速度は速くても圧縮率はそれほど高くありません。レベル \f29\fP の場合、圧縮速度は遅くても圧縮率は高くなります。
特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべてのアンパックツールはこの特殊な処理をアーカイブ全体のパススルーとして理解する必要があります。
単一の 10 進数値を指定した場合、パックツールは、指定された圧縮率でアーカイブを圧縮します。レベル \f21\fP の場合、圧縮速度は速くても圧縮率はそれほど高くありません。 レベル \f29\fP の場合、圧縮速度は遅くても圧縮率は高くなります。特殊な値 \f20\fP を指定した場合は、元の JAR ファイルを圧縮なしで直接コピーします。JSR 200 標準では、すべてのアンパックツールはこの特殊な処理をアーカイブ全体のパススルーとして理解する必要があります。
.LP
.LP
デフォルト値は \f25\fP です。この場合、標準的な時間で、適度な圧縮が行われます。
デフォルト値は \f25\fP です。 この場合、標準的な時間で、適度な圧縮が行われます。
.LP
.RE
.LP
@ -170,33 +200,43 @@ JAR\-file
.LP
.LP
デフォルト値を上書きし、入力情報を保存します。転送されるアーカイブのサイズは大きくなります。可能な値:
デフォルト値を上書きし、入力情報を保持します。 転送されるアーカイブのサイズは大きくなります。可能な値:
.LP
.RS 3
.TP 3
true
true
.TP 3
false
どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーションヒントは転送しません。
false
どちらの場合でも、パックツールはデフレーションヒントを出力アーカイブに設定します。 アーカイブ要素の個々のデフレーションヒントは転送しません。
.RE
.LP
.RS 3
.TP 3
keep
入力 JAR 内のデフレーションヒントを保存します (デフォルト)。
.in
.TP
keep
入力 JAR 内のデフレーションヒントを保持します (デフォルト)。
.RE
.LP
.RE
.LP
\f4\-mvalue \-\-modification\-time=\fP\f2value\fP
.LP
.RS 3
.LP
.LP
可能な値:
可能な値:
.LP
.RS 3
.TP 3
latest
パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
latest
パックツールは、元のアーカイブの全エントリの最終更新時刻か、そのセグメントのすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストールファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
.TP 3
keep
入力 JAR 内の更新時刻を保存します (デフォルト)。
keep
入力 JAR 内の更新時刻を保持します (デフォルト)。
.RE
.LP
.RE
.LP
@ -206,7 +246,7 @@ keep
.LP
.LP
ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。パス名の変換は行われません。システムファイルの区切り文字が JAR ファイルの区切り文字 "\f2/\fP" で置き換えられるだけです。ファイル名は、JAR ファイル内の文字列と完全に一致していなければなりません。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰り返し使用して、複数のファイルを指定できます。パス名の変換は行われません。 システムファイルの区切り文字が JAR ファイルの区切り文字「\f2/\fP」で置き換えられるだけです。ファイル名は、JAR ファイル内の文字列と完全に一致していなければなりません。file にディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
.LP
.RE
.LP
@ -216,48 +256,54 @@ keep
.LP
.LP
デフォルトの動作を無効にします。たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
デフォルトの動作を無効にします。 たとえば、不明な属性を含むクラスファイルを指定したアクションで転送します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
error
\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
error
\f2pack200\fP の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
属性はドロップされます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
strip
属性はドロップされます。注: VM 必須属性を削除すると、クラスローダーの障害が発生することがあります。
.TP 3
pass
この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
pass
この属性が検出された場合、クラス全体が 1 つのリソースとして転送されます。
.RE
.LP
.RE
.LP
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
.LP
.RS 3
.LP
.LP
これら 4 つのオプションでは、クラスエンティティに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
これら 4 つのオプションでは、クラスエンティティーに Class 属性、Field 属性、Method 属性、Code 属性などの属性のレイアウトを指定できます。attribute\-name には、これからレイアウトまたはアクションを定義する属性の名前を指定します。アクションとして指定可能な値:
.LP
.RS 3
.TP 3
(一部のレイアウト文字列)
レイアウト言語は、JSR 200 仕様に定義されています。
(一部のレイアウト文字列)
レイアウト言語は、JSR 200 仕様に定義されています。
.LP
例: \f2\-\-class\-attribute=SourceFile=RUH\fP
例: \f2\-\-class\-attribute=SourceFile=RUH\fP
.TP 3
error
この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
error
この属性が検出された場合、pack200 の操作に失敗し、適切な解説が表示されます。
.TP 3
strip
この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除するとクラスローダの障害が発生することがあります。
strip
この属性が検出された場合、属性は出力から削除されます。注: VM 必須属性を削除すると、クラスローダーの障害が発生することがあります。
.RE
.LP
.LP
例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。パックツールは、その他のアクションを行いません。
例: \f2\-\-class\-attribute=CompilationID=pass\fP というこの属性を含むクラスファイルを転送します。 パックツールは、その他のアクションを行いません。
.LP
.RE
.LP
@ -267,7 +313,7 @@ strip
.LP
.LP
コマンド行に、パックツールを初期化するための Java プロパティが含まれている設定ファイルを指定できます。
コマンド行に、パックツールを初期化するための Java プロパティーが含まれている設定ファイルを指定できます。
.LP
.RS 3
@ -307,7 +353,7 @@ strip
.LP
.LP
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
.RE
.LP
@ -317,7 +363,7 @@ strip
.LP
.LP
メッセージを表示せずに動作します。
メッセージを表示せずに動作します。
.LP
.RE
.LP
@ -327,7 +373,7 @@ strip
.LP
.LP
出力メッセージのログファイルを指定します。
出力メッセージのログファイルを指定します。
.LP
.RE
.LP
@ -337,65 +383,65 @@ strip
.LP
.LP
\f2pack200\fP によって呼び出される Java 起動ツールにオプションを渡します。たとえば \f2\-J\-Xms48m\fP と指定した場合、起動メモリが 48M バイトに設定されます。\f2\-X\fP で始まってはいませんが、\f2pack200\fP の標準オプションではありません。慣習として、\f2\-J\fP には、Java で書かれたアプリケーションを実行する VM にオプションを渡す働きがあります。
\f2pack200\fP によって呼び出される Java 起動ツールにオプションを渡します。たとえば、\f2\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。このオプションは \f2\-X\fP で始まっていませんが、\f2pack200\fP の標準オプションではありません。\f2\-J\fP を使って、Java で記述されたアプリケーションを実行する背後の VM にオプション渡すことは、よく行われています。
.LP
.RE
.RE
.SH 終了ステータス
.SH "終了ステータス"
.LP
.LP
.LP
次の終了値が返されます。
次の終了値が返されます。
.LP
.RS 3
.LP
.LP
\f2\ 0\fP "成功"
\f2\ 0\fP "成功"
.LP
.LP
\f2>0\fP "エラー"
\f2>0\fP "エラー"
.LP
.RE
.SH 関連項目
.SH "関連項目"
.LP
.RS 3
.TP 2
*
unpack200 \- JAR アンパックツール
o
unpack200(1)
.TP 2
*
\f2unpack200(1)\fP、\f2jar(1)\fP、\f2jarsigner(1)\fP、\f2attributes(5)\fP のマニュアルページ
.TP 2
*
Java SE のドキュメント
.TP 2
*
o
.na
\f2Java Deployment Guide \- Pack200\fP
\f2Java SE のドキュメント\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html)
http://java.sun.com/javase/6/docs/index.html
.TP 2
*
\f2jar\fP \- Java アーカイブツール
.TP 2
*
o
.na
\f2jarsigner\fP \- JAR 署名および検証ツール
\f2「Java 配備ガイド \- Pack200」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html)
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
o
jar(1) \- Java Archive ツール」
.TP 2
o
「jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
\f2attributes(5)\fP のマニュアルページ
.RE
.LP
.SH 注意事項
.SH "注意事項"
.LP
.LP
.LP
このコマンドと \f2pack(1)\fP コマンドを混同しないでください。これらは別製品です。
このコマンドと \f2pack(1)\fP を混同しないでください。これらは別製品です。
.LP
.LP
SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP

116
jdk/src/linux/doc/man/ja/policytool.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,100 +19,90 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH policytool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
.TH policytool 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH 名前
policytool \- PolicyTool 管理 GUI ユーティリティ
.SH "名前"
policytool \- PolicyTool 管理 GUI ユーティリティー
.LP
\f3policytool\fP は、ユーティリティ GUI 経由で取得したユーザ入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
.SH "形式"
\f3policytool\fP は、ユーティリティー GUI 経由で取得したユーザー入力に基づいて、プレーンテキストのポリシーファイルを読み書きします。
.RS 3
.TP 2
o
形式
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
関連項目
.RE
.LP
.SH "形式"
.LP
.LP
.RS 3
.TP 3
\
.TP 3
policytool 管理者ユーティリティを実行します
policytool 管理者ユーティリティーを実行します
\f4policytool\fP
.TP 3
policytool を実行し、指定されたポリシーファイルを読み込みます
\f4policytool\fP\f2[\-file][\fP\f2filename\fP\f2]\fP
policytool を実行し、指定されたポリシーファイルを読み込みます
\f4policytool\fP\f2 [\-file\ \fP\f2filename\fP\f2]\fP
.TP 3
\
.TP 3
各要素は次のとおりです。
各要素は次のとおりです。
.RS 3
.TP 3
file
ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
ローカルポリシーファイルを読み込むように \f2policytool\fP に指示します
.TP 3
filename
ファイル名
filename
ファイル名
.RE
.SH "説明"
.LP
.SH "機能説明"
.LP
.LP
.LP
\f3policytool\fP は、システム管理者がローカルポリシーファイルの内容を管理することを可能にする管理者用の GUI です。ポリシーファイルは \f2.policy\fP を拡張子に持つプレーンテキストファイルであり、ドメイン別のリモート要求者をアクセス権オブジェクトにマッピングします。詳細については、
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
の
\f3policytool\fP は、ユーザーがローカルポリシーファイルの内容を管理することを可能にする GUI です。詳細については、
.na
「\f2Default Policy Implementation and Syntax\fP」を参照してください。
.LP
.SH "オプション"
.LP
.LP
\f2「ポリシーファイル作成および管理ツール」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.htmlを参照してください。
.SH "オプション"
.RS 3
.TP 3
file
\f2filename\fP を読み込みます。
.LP
.SH "関連項目"
.LP
.LP
\f2filename\fP を読み込みます。
.SH "関連項目"
.na
\f2「Default Policy Implementation and Syntax」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html
の
.na
「\f2Default Policy Implementation and Syntax\fP」
.br
.LP
.na
\f2「Policy Tool Users' Guide」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html
の
.na
「\f2Policy Tool Users' Guide\fP」
.br
.LP
.na
\f2「Security Permissions」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
の
.na
「\f2Security Permissions\fP」
.br
.LP
.na
\f2「Security Overview」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
の
.na
「\f2Security Overview\fP」
.br
.LP
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/arch.html
の
.na
「\f2Security Architecture\fP」
.br
.RE
.RE
.LP

622
jdk/src/linux/doc/man/ja/rmic.1
View File

@ -1,370 +1,270 @@
'\" t
.\"
.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH rmic 1 "2004 年 6 月 22 日"
.SH "名前"
rmic \- Java RMI スタブコンパイラ
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
.SH "形式"
.B rmic
[
.BI options
]
.I package-qualified-class-names
.SH "機能説明"
.IX "Java RMI stub compiler" "" "Java RMI stub compiler \(em \fLrmic\fP"
.IX "rmic" "" "\fLrmic\fP \(em Java RMI stub compiler"
.B rmic
コンパイラは、リモートオブジェクト用のスタブおよび
スケルトンクラスファイル (JRMP プロトコル) とスタブ
および Tie クラスファイル (IIOP プロトコル) を生成します。
これらのクラスファイルは、リモートオブジェクト
実装クラスである、コンパイルされた Java プログラミング言語
クラスから生成されます。リモート実装クラスは、
インタフェース \f3java.rmi.Remote\f1
を実装するクラスです。
.B rmic
コマンドで指定されるクラスは、
.BR javac (1)
コマンドで正常にコンパイルされ、
完全にパッケージ修飾されたクラスで
なければなりません。
次に示す例では、
.B HelloImpl
というクラスファイルに対して
.B rmic
を実行しています。
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH rmic 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.RS
.SH "名前"
rmic \- Java RMI コンパイラ
.LP
.RS 3
.LP
.LP
\f3rmic\fP によって、JRMP または IIOP プロトコルを使用するリモートオブジェクトのスタブ、スケルトン、および Tie クラスが生成されます。また、OMG IDL も生成されます。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
rmic [ \fP\f3options\fP\f3 ] \fP\f4package\-qualified\-class\-name(s)\fP\f3
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3rmic\fP コンパイラによって、リモートオブジェクトの、スタブ、スケルトンクラスファイル (JRMP プロトコル)、およびスタブと Tie クラスファイルの組み合わせ (IIOP プロトコル) が生成されます。リモートオブジェクトの実装クラスであるこれらのクラスファイルは、Java プログラミング言語のクラスをコンパイルしたときに生成されます。リモート実装クラスは、\f2java.rmi.Remote\fP インタフェースを実装するクラスです。\f3rmic\fP コマンドでのクラス名は、そのクラスが \f3javac\fP コマンドでコンパイルが成功していて、かつ完全なパッケージ名が指定されている必要があります。たとえば、クラスファイル名 \f2HelloImpl\fP で \f3rmic\fP を実行するには、次のようにします。
.LP
.nf
\f3
.fl
rmic hello.HelloImpl
.RE
.LP
.B HelloImpl_Stub.class
ファイルを (クラスのパッケージに対して指定された)
.B hello
サブディレクトリに作成します。
.LP
JRMP プロトコルサーバ側エンティティである
リモートオブジェクトのスケルトンには、
リモートオブジェクト実装の呼び出しを
ディスパッチするメソッドがあります。
.LP
リモートオブジェクトの Tie は、スケルトンに似た
サーバ側エンティティですが、IIOP プロトコル
を使用してクライアントと通信します。
.LP
スタブは、リモートオブジェクトのプロキシで、
実際のリモートオブジェクト実装が存在するサーバに、
リモートオブジェクトに対するメソッド呼び出しを転送します。
クライアントのリモートオブジェクトへの参照は、
実際にはローカルスタブへの参照です。
.LP
デフォルトでは、
.B rmic
は \-v1.2 オプションが
指定された場合と同様に 1.2 JRMP スタブプロトコルを
使用するスタブクラスを生成します (1.5 より前の
リリースでは、\-vcompat オプションがデフォルト)。
IIOP プロトコル用のスタブクラスおよび Tie クラスを
生成するには、\-iiop オプションを使用します。
.LP
スタブは、リモートインタフェースのみを実装し、
リモートオブジェクトによっても実装されるローカル
インタフェースは実装しません。スタブはリモート
オブジェクトとまったく同じリモートインタフェースの
セットを実装するため、クライアントはキャストおよび
型チェックに Java 言語の組み込み演算子を使用できます。
IIOP の場合は、
.B PortableRemoteObject.narrow
メソッドを
使用する必要があります。
.SH オプション
.if t .TP 20
.if n .TP 15
.BI \-bootclasspath " path"
ブートストラップクラスファイルの位置をオーバーライドします。
.if t .TP 20
.if n .TP 15
.BI \-classpath " path"
.B rmic
がクラスを探すのに用いるパスを
.I path
で指定します。この指定値は、デフォルトおよび
.B CLASSPATH
環境変数の設定値をオーバーライドします。
複数のディレクトリを指定する場合はコロンで区切ります。
したがって
.I path
の通常の形式は次のようになります。
.sp 1n
.ti +5n
.BI .:< your_path >
.sp 1n
以下に例を示します。
.sp 1n
.ti +5n
.B .:/usr/local/java/classes
.if t .TP 20
.if n .TP 15
.BI \-d " directory"
クラス階層のルートディレクトリを指定します。
このオプションを使用して、スタブ、スケルトン、および Tie ファイルの出力先ディレクトリを指定できます。
たとえば、次のコマンドを入力します。
.LP
.RS 5
rmic \-d /java/classes foo.MyClass
.RE
.LP
この例では、MyClass から派生したスタブおよび
スケルトンクラスをディレクトリ /java/classes/foo
に配置します。\-d オプションが指定されていない場合、
デフォルトの動作は「\-d .」が指定された場合と同様です。
ターゲットクラスのパッケージ階層は、
現在のディレクトリに作成され、スタブ/Tie/スケルトン
ファイルはその階層内に配置されます。
(以前の一部のバージョンの
.B rmic
では、
\-d が指定されなかった場合、パッケージ階層は作成されず、
すべての出力ファイル
は、現在のディレクトリ内に直接配置されました。)
.if t .TP 20
.if n .TP 15
.BI \-extdirs " path"
インストールされている拡張機能の位置を上書きします。
.if t .TP 20
.if n .TP 15
.B \-g
ローカル変数を含む、すべてのデバッグ情報の
生成を有効にします。デフォルトでは、
行番号情報のみが生成されます。
.if t .TP 20
.if n .TP 15
.B \-idl
.B rmic
によって、指定したクラスおよび参照されたクラスの
.SM OMG IDL
が生成されます。
.SM IDL
では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの
.SM API
を指定できます。
.SM IDL
は、
.SM CORBA
バインディングを提供する任意の言語 (Java、C++ など) を使用して、メソッドおよびデータの
書き込みおよび呼び出しを行うときの仕様として使われます。
.B \-idl
オプションは、合わせて以下のオプションも指定できます。
.RS
.TP 5
.BR \-always " または " \-alwaysgenerate
既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的に生成し直します。
.PD 0
.TP
.B \-factory
生成された IDL で factory キーワードを使います。
.TP
.B \-idlModule fromJavaPackage[.class] toIDLModule
.B IDLEntity
パッケージのマッピングを指定します。次に例を示します。
.sp 1n
.in +5n
.ft 3
.nf
\-idlModule foo.bar
my::real::idlmod.
.fl
\fP
.fi
.ft 1
.in
.sp 1n
.TP
.B \-idlFile fromJavaPackage[.class] toIDLFile
.B IDLEntity
ファイルのマッピングを指定します。次に例を示します。
.sp 1n
.ti +5n
.B \-idlFile test.pkg.X TEST16.idl
.RE
.PD
.if t .TP 20
.if n .TP 15
.B \-iiop
.B rmic
は、
.SM JRMP
のスタブとスケルトンクラスの代わりに、
.SM IIOP
のスタブと Tie クラスを生成します。スタブクラスは、リモートオブジェクトの
ローカルプロキシで、クライアントがサーバに呼び出しを送信するときに
使われます。各リモートインタフェースにはスタブクラスが必要です。スタブクラス
によってリモートインタフェースが実装されます。クライアントでリモートオブジェクト
を参照すると、実際にはスタブを参照することになります。Tie クラスは、
サーバ側で受信した呼び出しを処理し、その呼び出しを適切な実装クラスにディスパッチ
するときに使われます。各実装クラスには、Tie クラスが必要です。
.sp 1n
.B \-iiop
を指定して
.B rmic
を起動すると、次の命名規約に準拠したスタブと Tie が生成されます。
.sp 1n
.in +5n
.ft 3
.LP
.LP
\f2HelloImpl_Stub.class\fP ファイルが、クラスのパッケージ名が付いた \f2hello\fP サブディレクトリに作成されます。
.LP
.LP
リモートオブジェクトの「スケルトン」は JRMP プロトコルサーバー側のエンティティーで、実際のリモートオブジェクト実装を呼び出すメソッドを含みます。
.LP
.LP
リモートオブジェクトの「Tie」は、スケルトンと同様にサーバー側のエンティティーですが、IIOP プロトコルを使ってクライアントと通信します。
.LP
.LP
「スタブ」とは、リモートオブジェクトのクライアント側での代理です。 スタブは、リモートオブジェクトのメソッド呼び出しを、実物のリモートオブジェクトが常駐するサーバーと通信する役割を持ちます。したがって、クライアントのリモートオブジェクトへの参照は、実際はローカルスタブへの参照となります。
.LP
.LP
デフォルトで \f3rmic\fP では、1.2 JRMP スタブプロトコルバージョンだけを使用するスタブクラスを生成します。 これは、\f2\-v1.2\fP オプションを指定した場合と同じ動作です。(5.0 以前では \f2\-vcompat\fP オプションがデフォルトであったことに注意。) IIOP プロトコル用のスタブおよび Tie クラスを生成するには \f2\-iiop\fP オプションを使用します。
.LP
.LP
スタブはリモートインタフェースだけを実装し、リモートオブジェクトが実装する局所インタフェースは実装していません。JRMP スタブはリモートオブジェクト自体が実装するリモートインタフェースと同じものを実装しているので、クライアントは、キャストや型チェックに Java プログラミング言語に組み込まれた演算子を使用することができます。IIOP の場合は、\f2PortableRemoteObject.narrow\fP メソッドを使わなければなりません。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-bootclasspath path
ブートストラップクラスファイルの位置をオーバーライドします。
.TP 3
\-classpath path
\f3rmic\fP がクラスを探すためのパスを指定します。このオプションは、デフォルトや CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
.RS 3
.LP
.nf
_<implementationName>_stub.class
.sp 1n
_<interfaceName>_tie.class
.ft 1
\f3
.fl
.:<your_path>
.fl
\fP
.fi
.in
.sp 1n
.B \-iiop
オプションは、合わせて以下のオプションも指定できます。
.sp 1n
.ne 1
.bp
.RS
.PD 0
.TP 5
.BR \-always " または " \-alwaysgenerate
既存のスタブ、Tie、および \s-1IDL\s0 が入力クラスより新しいときでも、強制的
に生成し直します。
.TP
.B \-nolocalstubs
同じプロセスのクライアントとサーバに対して最適化されたスタブを作成しません。
.TP
.B \-noValueMethods
.B \-idl
オプションとともに使用する必要があります。発行された
.SM IDL\s0
に、valuetype メソッドおよび初期化子を追加しません。このメソッドおよび初期化子
は、valuetype のオプションです。
.B \-idl
オプションを使うときは、
.B \-noValueMethods
オプションを指定しない限り生成されます。
.TP
.B \-poa
.RE
例を示します。
.RS 3
.LP
.nf
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.RE
.TP 3
\-d directory
生成されたクラス階層の出力先ディレクトリのルートを指定します。このオプションを使えば、スタブ、スケルトン、および Tie ファイルを格納するディレクトリを指定できます。たとえば、次のようにして使います。
.RS 3
.LP
.nf
\f3
.fl
% rmic \-d /java/classes foo.MyClass
.fl
\fP
.fi
.RE
\f2MyClass\fP から取得したスタブとスケルトンクラスを \f2/java/classes/foo\fP ディレクトリに置きます。\f2\-d\fP オプションが指定されていない場合は、\f2「\-d\ .」\fPが指定されていると見なされます。ターゲットクラスのパッケージ階層が現在のディレクトリに作成され、スタブ、Tie、およびスケルトンファイルがそのディレクトリに格納されます。(以前のバージョンの \f3rmic\fP では、\f2\-d\fP が指定されていない場合は、パッケージ階層は作成されず、出力ファイルはすべて現在のディレクトリに直接格納されていた)。
.br
継承を
.BR org.omg.CORBA_2_3.portable.ObjectImpl から
.BR org.omg.PortableServer.Servant\. へ変更します。
.RS
\
.TP 3
\-extdirs path
インストール型拡張機能の位置をオーバーライドします。
.TP 3
\-g
局所変数を含むすべてのデバッグ情報を生成します。デフォルトでは、行番号情報だけが生成されます。
.LP
Portable Object Adapter (POA) の
.BR PortableServer
モジュールは、ネイティブ の servant 型を定義します。
Java プログラミング言語では、servant 型は、Java の
.BR org.omg.PortableServer.Servant
クラスにマップされます。これはすべての POA サーバント実装の基底クラスとして
機能し、アプリケーション開発者が呼び出せる多数のメソッドを提供します。また、
POA 自体が読み出したり、サーバント動作を制御するためにユーザが上書きした
りできるメソッドも提供します。CORBA V 2.3.1 の「OMG IDL to Java Language Mapping Specfication (ptc/00-01-08.pdf)」に基づいています。
.TP 3
\-idl
\f2rmic\fP によって、指定したクラスおよび参照されたクラスの OMG IDL が生成されます。IDL では、プログラミング言語に依存せずに、宣言するだけでオブジェクトの API を指定することができます。IDL は、メソッドおよびデータの仕様として使用します。 CORBA バインディングを提供する任意の言語で、メソッドおよびデータの作成および呼び出しを行うことができます。これらの言語には、Java および C++ が含まれています。詳細は、
.na
\f2Java Language to IDL Mapping\fP @
.fi
http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) を参照してください。
.LP
\f2\-idl\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
\-always または \-alwaysgenerate
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-factory
生成された IDL で factory キーワードを使います。
.TP 3
\-idlModule\ fromJavaPackage[.class]\ toIDLModule
IDLEntity パッケージのマップを指定します。例を示します。 \f2\-idlModule foo.bar my::real::idlmod\fP
.TP 3
\-idlFile\ fromJavaPackage[.class]\ toIDLFile
IDLEntity ファイルのマップを指定します。例を示します。 \f2\-idlFile test.pkg.X TEST16.idl\fP\
.RE
.PD
.LP
.TP 3
\-iiop
\f2rmic\fP によって、JRMP のスタブとスケルトンクラスの代わりに、IIOP のスタブと Tie クラスが生成されます。スタブクラスは、リモートオブジェクトのローカルプロキシで、クライアントからサーバーに呼び出しを送信するときに使われます。各リモートインタフェースにはスタブクラスが必要です。 スタブクラスによってリモートインタフェースが実装されます。クライアントでリモートオブジェクトを参照するときは、実際にはスタブを参照することになります。タイクラスは、サーバー側で着呼を処理し、その呼び出しを適切な実装クラスにディスパッチするときに使われます。各実装クラスには、タイクラスが必要です。
.LP
\f2\-iiop\fP を使って \f2rmic\fP を呼び出すと、次の命名規約に準拠したスタブと Tie が生成されます。
.RS 3
.LP
.nf
\f3
.fl
_<implementationName>_stub.class
.fl
\fP
.br
\f3
.fl
_<interfaceName>_tie.class
.fl
\fP
.fi
.RE
.TP 20
.if t .TP 20
.if n .TP 15
.B \-J
任意の java オプションと
併用した場合、
\-J の後のオプション (
.B \-J
とオプションの間は空白文字をいれない)
を java インタプリタに
渡します。
.if t .TP 20
.if n .TP 15
.B \-keepgenerated
スタブ、スケルトンおよび tie クラス用に生成された .java ソースファイルを保持し、.class ファイルと同じディレクトリに書き込みます。
.if t .TP 20
.if n .TP 15
.B \-nowarn
警告をオフにします。このオプションを使用した場合、コンパイラは警告を出力しません。
.if t .TP 20
.if n .TP 15
.B \-vcompat
1.1 と 1.2 の両方の JRMP スタブプロトコル
バージョンと互換性があるスタブおよび
スケルトンクラスを生成します (1.5 より前の
リリースでは、このオプションはデフォルト)。
生成されたスタブクラスは、JDK 1.1 の仮想マシンに
読み込まれる場合、1.1 のスタブプロトコルバージョンを
使用し、1.2 以降の仮想マシンに読み込まれる場合は、
1.2 のスタブプロトコルバージョンを使用します。
生成されたスケルトンクラスは、1.1 と 1.2 の両方の
スタブプロトコルバージョンをサポートします。
生成されたクラスは、両方の操作モードをサポート
するため、比較的サイズが大きくなります。
.if t .TP 20
.if n .TP 15
.B \-verbose
コンパイラとリンカに詳細情報を出力させます。具体的には、
コンパイルされるクラスファイル、およびロードされる
クラスファイルに関する情報が出力されます。
.TP 15
.B \-v1.1
JDK 1.1 のスタブプロトコルバージョン
専用のスタブおよびスケルトンを作成します。
このオプションは、JDK 1.1 から
.B rmic
によって生成され、アップグレードできない
(および動的クラスローディングが使用
されていない) 既存の静的に配備された
スタブクラスと直列化互換性のあるスタブ
クラスを生成する場合にのみ使用します。
.if t .TP 20
.if n .TP 15
.B \-v1.2
(デフォルト) 1.2 JRMP のスタブプロトコル
バージョン専用のスタブクラスを生成します。
スケルトンクラスは 1.2 のスタブプロトコル
バージョンで使用されないため、このオプション
ではスケルトンクラスが生成されません。
生成されたスタブクラスが JDK 1.1 の仮想マシンに
読み込まれた場合は、機能しません。
.SH 環境変数
.if t .TP 20
.if n .TP 15
.B CLASSPATH
ユーザ定義クラスへのパスをシステムに通知するために使用します。
ディレクトリはコロンで
区切ります。以下に例を示します。
.sp 1n
.ti +5n
.B .:/usr/local/java/classes
.SH 関連項目
.BR java (1),
.BR javac (1),
.BR CLASSPATH
.LP
\f2\-iiop\fP オプションを使うときは、ほかのオプションも指定できます。
.RS 3
.TP 3
\-always または \-alwaysgenerate
既存のスタブ、Tie、および IDL が入力クラスより新しいときでも、強制的に生成し直します。
.TP 3
\-nolocalstubs
同じプロセスのクライアントとサーバーに対して最適化されたスタブを作成しません。
.TP 3
\-noValueMethods
\f2\-idl\fP オプションとともに使われなければなりません。発行された IDL に、\f2valuetype\fP メソッドおよび初期化子を追加しません。このメソッドおよび初期化子は、\f2valuetype\fP の場合はオプションです。 \f2\-idl\fP オプションを使うときは、 \f2\-noValueMethods\fP オプションを指定しない限り生成されます。
.TP 3
\-poa
継承が \f2org.omg.CORBA_2_3.portable.ObjectImpl\fP から \f2org.omg.PortableServer.Servant\fP に変わります。
.LP
.na
\f2Portable Object Adapter\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/POA.html (POA) の \f2PortableServer\fP モジュールは、ネイティブの \f2Servant\fP 型を定義します。Java プログラミング言語では、\f2Servant\fP 型は、Java の \f2org.omg.PortableServer.Servant\fP クラスにマッピングされています。これはあらゆる POA サーバント実装の基底クラスとなり多数のメソッドを提供します。 これらのメソッドはアプリケーションプログラマが呼び出すだけではなく、POA 自身からも呼び出され、場合によってはサーバントの動作を制御するためにユーザーがオーバーライドすることもあります。OMG IDL to Java Language Mapping Specification、CORBA V 2.3.1 ptc/00\-01\-08.pdf に準拠しています。
.RE
.TP 3
\-J
\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\f2\-J\fP と \f2java\fP オプションの間にスペースは入れない)。
.TP 3
\-keep または \-keepgenerated
スタブ、スケルトン、または Tie クラスのための \f2.java\fP ソースファイルを \f2.class\fP ファイルと同じディレクトリに残します。
.TP 3
\-nowarn
警告をオフにします。このオプションを指定すると、コンパイラは警告を表示しません。
.LP
.TP 3
\-vcompat
1.1 と 1.2 の両方の JRMP スタブプロトコルバージョンと互換性のあるスタブおよびスケルトンクラスを作成します。(5.0 以前のリリースではこのオプションはデフォルト。)生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされると 1.1 スタブプロトコルバージョンを使用し、JDK 1.2 以降の仮想マシンにロードされると 1.2 スタブプロトコルバージョンを使用します。生成されたスケルトンクラスでは、1.1 と 1.2 の両方のスタブプロトコルバージョンをサポートします。生成されたクラスは両方の操作モードをサポートするために、サイズが大きくなります。
.TP 3
\-verbose
コンパイラやリンカーが、コンパイルされているクラスやロードされているクラスファイルについてのメッセージを表示するようにします。
.LP
.TP 3
\-v1.1
1.1 JRMP スタブプロトコルバージョンのみのスタブおよびスケルトンクラスを生成します。このオプションが使用できるのは、JDK 1.1 から \f3rmic\fP ツールで生成され、アップグレードできない (さらにダイナミッククラスローディングを使用していない) 、既存の静的配備されたスタブクラスに対し、直列化互換性のあるスタブクラスを生成場合だけです。
.LP
.TP 3
\-v1.2
(デフォルト) 1.2 JRMP スタブプロトコルバージョンのみのスタブクラスを生成します。スケルトンクラスは 1.2 スタブプロトコルバージョンで使用できないため、このオプションではスケルトンクラスは生成されません。生成されたスタブクラスは、JDK 1.1 仮想マシンにロードされても動作しません。
.RE
.LP
.SH "環境変数"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.RS 3
.LP
.nf
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.RE
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
java(1)、javac(1)、
.na
\f2CLASSPATH\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
.LP
.LP

835
jdk/src/linux/doc/man/ja/rmid.1
View File

@ -1,563 +1,358 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH rmid 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
rmid \- RMI 起動システムデーモン
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH rmid 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
rmid \- Java RMI 起動システムデーモン
.LP
.RS 3
.LP
.LP
\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
.LP
.SH "形式"
.B rmid
[
.I options
]
.SH "機能説明"
.IX "RMI activation system daemon" "" "RMI activation system daemon \(em \fLrmid\fP"
.IX "rmid" "" "\fLrmid\fP \(em RMI activation system daemon"
.B rmid
ツールは、起動システムデーモンを開始します。起動可能なオブジェクトを起動
システムに登録したり、Java VM でアクティブにしたりするには、あらかじめ起動
システムデーモンを開始しておく必要があります。
起動可能なリモートオブジェクト
を使ったプログラムの作成方法についての詳細は、Java RMI の仕様
.fi
(http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html)
および起動のチュートリアル
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.html)
を参照してください。
.LP
起動システムデーモンは、次のようにセキュリティポリシーファイルを指定して
.B rmid
コマンドを実行することによって開始できます。
.LP
.ti +5n
.B % rmid \-J\-Djava.security.policy=rmid.policy
.LP
注: Sun の
.BR rmid
実装を実行する場合、デフォルトではセキュリティポリシーファイルを指定する必要があります。そうすることで、起動グループ用の JVM の起動に、各
.B ActivationGroupDesc
内の情報を使用できるかどうかを
.B rmid
が確認できます。特に、
.B CommandEnvironment
により指定されるコマンドやオプション、および
.B ActivationGroupDesc
のコンストラクタに渡されるすべての
.B プロパティ
は、
.BR rmid
用のセキュリティポリシーファイルで明示的に許可することが必要になりました。
.B sun.rmi.activation.execPolicy
プロパティの値は、起動グループの JVM の起動に
.B ActivationGroupDesc
内の情報を使用できるかどうかの判断に
.B rmid
が使用するポリシーを定義します。
.LP
.B rmid
をデフォルト設定で実行することにより、以下が行われます。
.LP
.RS
.TP 2
\(bu
このコマンドはアクティベータを起動するとともにデフォルトポートの
.BR 1098
で内部レジストリを
開始し、
.LP
.PD 0
.TP
\(bu
.B ActivationSystem
を
.B java.rmi.activation.ActivationSystem
という名前に内部レジストリ上でバインドします。
\f3rmid\fP で起動システムデーモンを開始すると、オブジェクトを仮想マシン (VM) に登録して起動できるようになります。
.LP
.RE
レジストリにほかのポートを指定するには、
.BR rmid
の起動時に
.B -port
オプションを指定しなければなりません。たとえば、次のようにします。
.ti +5n
.SH "形式"
.LP
.B rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
.LP
このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート
.B 1099
でレジストリを開始します。
.LP
.SS inetd/xinetd からの rmid の起動
コマンド行から
.B rmid
を起動しないで、
inetd (Solaris) または xinetd (Linux) を設定し、
.B rmid
を必要に応じて起動することができます。
.LP
起動時に
.B rmid
は、System.inheritedChannel メソッドを呼び出して
継承チャネル (inetd/xinetd からの継承) の
取得を試みます。
継承されたチャンネルが \f2null\fP であるか、\f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、\f2rmid\fP はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
.LP
.LP
継承チャンネルが ServerSocketChannel
インスタンスの場合、
.B rmid
は ServerSocketChannel から
取得した java.net.ServerSocket を、
エクスポートするリモートオブジェクト
(java.rmi.activation.ActivationSystem が
バインドされるレジストリと
java.rmi.activation.Activator
リモートオブジェクト) に対する要求を
受け入れるサーバソケットとして使用します。
.LP
このモードでは、
.B rmid
の動作は、次のことを除いて、
コマンド行から起動した場合と同じです。
.TP 2
\(bu System.err に表示される出力はファイルにリダイレクト
されます。このファイルは、接頭辞「rmid-err」と接尾辞「tmp」を
使用して java.io.tmpdir システムプロパティ
(通常 /var/tmp または /tmp) で指定したディレクトリにあります。
.TP 2
\(bu \-port オプションは許可されていません。このオプションが
指定されている場合、
.B rmid
はエラーメッセージを表示して
終了します。
.TP 2
\(bu \-log オプションは必須です。このオプションが
指定されていない場合、
.B rmid
はエラーメッセージを表示して
終了します。
.LP
必要に応じて開始するサービスの設定方法についての詳細は、
inetd (Solaris) または xinetd (Linux) のマニュアルページを
参照してください。
.SH "オプション"
.TP
.BI \-C someCommandLineOption
.B rmid
の子プロセス (起動グループ) が作成されたときに、各子プロセスにコマンド行引数
として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム
デーモンによって生成される各 Java Virtual Machine にプロパティを渡すことができます。
.sp 1n
.ti +5n
.B rmid \-C\-Dsome.property=value
.sp 1n
コマンド行引数を子プロセスに渡す機能は、デバッグを行う際に便利です。
たとえば、次のようなコマンドを実行できます。
.sp 1n
.ti +5n
.B rmid \-C\-Djava.rmi.server.logCalls=true
.sp 1n
このコマンドによって、すべての子 JVM でサーバ呼び出しのログが残るようになります。
.TP
.BI \-J<someCommandLineOption>
.B rmid
を実行中の java インタプリタに渡すオプションを指定します。たとえば、
.B rmid
で
.BR rmid.policy
という名前のポリシーファイルを使用する場合、
.BR rmid
のコマンド行で
.B \-J
オプションを使って
.B java.security.policy
プロパティを定義します。次に例を示します。
.sp 1n
.ti +5n
.B rmid \-J\-Djava.security.policy=rmid.policy
.TP
.BI \-J\-Dsun.rmi.activation.execPolicy=<policy>
起動グループの実行対象となる JVM の起動に使用するコマンドおよびコマンド行オプションを検査するために、
.B rmid
が採用するポリシーを指定します。このオプションは、Sun の RMI 起動デーモン実装だけに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は
.B \-J-Dsun.rmi.activation.execPolicy=default
を指定した場合と同じになります。
.IR policy
に指定可能な値は、
.BR default
、
.IR policyClassName
、または none です。
.BR
.RS
.TP 2
\(bu
.B default
(または、このプロパティを指定しない場合)
.LP
デフォルトの
.B execPolicy
では、使用するセキュリティポリシーファイル内のコマンドおよびオプションを実行する権限が
.B rmid
に与えられる場合にのみ、
.B rmid
は特定のコマンド行オプションを指定してコマンドを実行できます。
.BR default
の実行ポリシーを使用できるのは、
デフォルトの起動グループ実装だけです。
.sp 1n
.B rmid
は、起動グループの JVM を起動する際、その登録された起動グループ記述子である
.BR ActivationGroupDesc
内の情報を使用します。グループ記述子では、オプションの
.B ActivationGroupDesc.CommandEnvironment
を指定します。これには、起動グループを開始する「コマンド」、およびコマンド行に追加する
任意のコマンド行「オプション」が含まれます。デフォルトでは、
.B rmid
は
.BR java.home
にある
.B java
コマンドを使用します。グループ記述子には、次に示すように、オプションとしてコマンド行に
追加される「プロパティ」オーバーライドも含まれます。
.sp 1n
.ti +5n
.BI \-D<property>=<value>
.sp 1n
アクセス権
.B com.sun.rmi.rmid.ExecPermission
を使用すると、
.B rmid
に対し、グループ記述子の
.B CommandEnvironment
で指定されたコマンドを実行して起動グループを開始する権限を与えることができます。
アクセス権
.B com.sun.rmi.rmid.ExecOptionPermission
を使用すると、起動グループを開始するときに、
グループ記述子でプロパティオーバーライドとして指定されたコマンド行
オプション、または
.BR CommandEnvironment
でオプションとして指定されたコマンド行オプションを
.B rmid
から使用できます。
.sp 1n
.B rmid
にさまざまなコマンドおよびオプションを実行する権限を与える場合、アクセス権
.B ExecPermission
および
.B ExecOptionPermission
を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
.TP
.BI ExecPermission
.B ExecPermission
クラスは、起動グループを開始するために
.B rmid
が特定の「コマンド」を実行する権限を表します。
.sp 1n
.TP
.B 構文
.br
.B ExecPermission
の「名前」は、
.B rmid
に実行権限を与えるコマンドのパス名です。「/*」(「/」はファイル区切り文字、つまり
.BR File.separatorChar
) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを表します。「/-」
で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ
(再帰的に) を表します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、
任意のファイルに一致します。
.sp 1n
.B 注:
「*」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルを表し、
「-」が 1 つだけ指定されたパス名は、現在のディレクトリ内のすべてのファイルと、
現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
.TP
.BI ExecOptionPermission
.B ExecOptionPermission
クラスは、起動グループの開始時に
.B rmid
が特定のコマンド行「オプション」を使用する権限を表します。
.B ExecOptionPermission
の「名前」は、コマンド行オプションの値です。
.sp 1n
.TP
.B 構文
.br
オプションでは、制限付きワイルドカード指定がサポートされます。
アスタリスクは、ワイルドカードマッチングを指定します。アスタリスクは、
オプション名自体を表す (つまり、すべてのオプションに一致する) ために
使用できます。また、「.」および「=」の次に指定する場合にのみ、
オプション名の最後にアスタリスクを使用できます。
.sp 1n
例を示します。「*」、「-Dfoo.*」、「-Da.b.c=*」は有効です。「*foo」、「-Da*b」
、「ab*」は無効です。
.TP
.BI rmid のポリシーファイル
.B rmid
にさまざまなコマンドおよびオプションを実行する権限を与える場合は、アクセス権
.B ExecPermission
および
.B ExecOptionPermission
を普遍的に (つまり、すべてのコードソースに対して) 許可する必要があります。
これらのアクセス権を検査するのは
.B rmid
だけであるため、普遍的に許可しても安全です。
.sp 1n
.B rmid
にさまざまな実行権限を許可するポリシーファイルの例を、次に示します。
.sp 1n
.ft 3
.nf
\f3
.fl
rmid [options]
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3rmid\fP ツールは、起動システムデーモンを開始します。起動システムデーモンを開始してからでないと、起動可能オブジェクトを起動システムに登録したり、VM 内で起動したりすることができません。起動可能なリモートオブジェクトを使ったプログラムの作成方法の詳細は、
.na
\f2「Java RMI 仕様」\fP @
.fi
http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.htmlおよび
.na
\f2「起動のチュートリアル」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/rmi/activation/overview.htmlを参照してくだ さい。
.LP
.LP
デーモンを起動するには、次のように、セキュリティーポリシーファイルを指定して \f2rmid\fP コマンドを実行します。
.LP
.nf
\f3
.fl
rmid \-J\-Djava.security.policy=rmid.policy
.fl
\fP
.fi
.LP
.LP
\f3注:\fP\f2rmid\fP の Sun の 実装を実行する場合、デフォルトでは、セキュリティーポリシーファイルを指定する必要があります。 それは、起動グループ用に VM を起動するために各 \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを \f2rmid\fP が検証できるようにするためです。特に、\f2ActivationGroupDesc\fP のコンストラクタに渡される \f2CommandEnvironment\fP や任意の \f2Properties\fP によって指定されるコマンドおよびオプションは、\f2rmid\fP のセキュリティーポリシーファイルの中で明示的に許可することが必要になりました。\f2sun.rmi.activation.execPolicy\fP プロパティーの値は、起動グループ用に VM を起動するために \f2ActivationGroupDesc\fP 内の情報を使用できるかどうかを判断するときに \f2rmid\fP が使用するポリシーを決定します。
.LP
.LP
\f2rmid\fP をデフォルト設定で実行すると、次のような処理が行われます。
.LP
.RS 3
.TP 2
o
アクティベータを起動し、デフォルトポート 1098 で内部レジストリを起動する
.TP 2
o
この内部レジストリの中で、\f2ActivationSystem\fP を \f2java.rmi.activation.ActivationSystem\fP という名前にバインドする
.RE
.LP
.LP
レジストリにほかのポートを指定するには、\f2rmid\fP の起動時に \f2\-port\fP オプションを指定しなければなりません。次に例を示します。
.LP
.nf
\f3
.fl
rmid \-J\-Djava.security.policy=rmid.policy \-port 1099
.fl
\fP
.fi
.LP
.LP
このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート 1099 でレジストリを開始します。
.LP
.SS
rmid を inetd/xinetd から開始する
.LP
.LP
\f2rmid\fP をコマンド行から開始するには、\f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux) を構成して \f2rmid\fP を必要に応じて開始する方法もあります。
.LP
.LP
\f2rmid\fP を開始すると、\f2System.inheritedChannel\fP メソッドを呼び出して、継承されたチャンネル (\f2inetd\fP/\f2xinetd\fP から継承) を取得しようとします。継承されたチャンネルが \f2null\fP であるか、\f2java.nio.channels.ServerSocketChannel\fP のインスタンスでなかった場合、\f2rmid\fP はそのチャンネルは \f2inetd\fP/\f2xinetd\fP によって起動されたものではないと判断し、前述のように起動します。
.LP
.LP
継承されたチャンネルが \f2ServerSocketChannel\fP インスタンスである場合は、エクスポートするリモートオブジェクト、つまり \f2java.rmi.activation.ActivationSystem\fP がバインドされているレジストリと \f2java.rmi.activation.Activator\fP リモートオブジェクトに対する要求を受信するサーバーソケットとして、\f2ServerSocketChannel\fP から取得した \f2java.net.ServerSocket\fP を \f2rmid\fP では使用します。このモードでは、\f2rmid\fP の動作は、次のことを除いて、 コマンド行から起動した場合と同じです。
.LP
.RS 3
.TP 2
o
\f2System.err\fP に対する出力は、ファイルにリダイレクトされる。このファイルは \f2java.io.tmpdir\fP システムプロパティーで指定されるディレクトリ (通常は \f2/var/tmp\fP または \f2/tmp\fP) にある。 ファイル名の接頭辞は \f2rmid\-err\fP で、接尾辞は \f2"tmp"\fP である
.TP 2
o
\f2\-port\fP オプションは拒否される。このオプションを指定すると、\f2rmid\fP はエラーメッセージを出して終了する
.TP 2
o
\f2\-log\fP オプションは必須。このオプションを指定しないと、\f2rmid\fP はエラーメッセージを出して終了する
.RE
.LP
.LP
必要に応じてサービスを開始するように設定する詳細については、\f2inetd\fP (Solaris) または \f2xinetd\fP (Linux) のマニュアルページを参照してください。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-C<someCommandLineOption>
\f2rmid\fP の子プロセス (起動グループ) が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモ ンによって生成される各仮想マシンにプロパティーを渡すことができます。
.nf
\f3
.fl
rmid \-C\-Dsome.property=value
.fl
\fP
.fi
コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。
.nf
\f3
.fl
rmid \-C\-Djava.rmi.server.logCalls=true
.fl
\fP
.fi
このコマンドにより、すべての子 VM でサーバー呼び出しのログが作成されるようになります。
.LP
.TP 3
\-J<someCommandLineOption>
\f2rmid\fP を実行している \f2java\fP インタプリタに渡すオプションを指定します。たとえば、\f2rmid\fP が \f2rmid.policy\fP という名前のポリシーファイルを使用するように指定するには、\f2rmid\fP のコマンド行で \f2\-J\fP オプションを使って、\f2java.security.policy\fP プロパティーを定義します。 次に例を示します。
.nf
\f3
.fl
rmid \-J\-Djava.security.policy=rmid.policy
.fl
\fP
.fi
.TP 3
\-J\-Dsun.rmi.activation.execPolicy=<policy>
起動グループが実行されることになる VM の起動に使用するコマンドおよびコマンド行オプションをチェックするために、\f2rmid\fP が採用するポリシーを指定します。このオプションは、Java RMI 起動デーモンの Sun の実装だけに存在することに注意してください。コマンド行にこのプロパティーを指定しない場合、結果は \f2\-J\-Dsun.rmi.activation.execPolicy=default\fP を指定した場合と同じになります。\f2<policy>\fP に指定可能な値は、\f2default\fP、\f2<policyClassName>\fP、または \f2none\fP です。 それぞれの値について、このあと説明します。
.LP
.RS 3
.TP 2
o
\f3default (または、このプロパティーが「指定されていない」場合)\fP
.LP
デフォルトの \f2execPolicy\fP の場合、\f2rmid\fP が実行できるのは、\f2rmid\fP が使用する セキュリティーポリシーファイルの中で、実行する権限が \f2rmid\fP に与えられているコマンドおよびコマンド行オプションだけです。「デフォルト」の実行ポリシーで使用できるのは、デフォルトの起動グループ実装だけです。
.LP
\f2rmid\fP は、起動グループ用の VM を起動するときに、そのグループについて登録された起動グループ記述子である \f2ActivationGroupDesc\fP 内の情報を使用します。グループ記述子は、\f2ActivationGroupDesc.CommandEnvironment\fP を指定します (省略可能)。 これには、起動グループを開始する「コマンド」と、そのコマンド行に追加できるコマンド行「オプション」が含まれています。デフォルトでは、\f2rmid\fP は、\f2java.home\fP にある \f2java\fP コマンドを使用します。グループ記述子には、オプションとしてコマンド行に追加される「プロパティー」オーバーライドも含まれています。 このプロパティーは、次のように定義します。
.nf
\f3
.fl
\-D\fP\f4<property>\fP\f3=\fP\f4<value>\fP\f3
.fl
\fP
.fi
.LP
アクセス権 \f2com.sun.rmi.rmid.ExecPermission\fP を使用すると、グループ記述子の \f2CommandEnvironment\fP で指定されたコマンドを実行して起動グループを開始する権限を、\f2rmid\fP に対して許可することができます。アクセス権 \f2com.sun.rmi.rmid.ExecOptionPermission\fP を使用すると、グループ記述子でプロパティーオーバーライドとして指定されたコマンド行オプション、または \f2CommandEnvironment\fP でオプションとして指定されたコマンド行オプションを、起動グループを開始するときに \f2rmid\fP が使用できるようになります。
.LP
\f2rmid\fP にさまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。 つまり、すべてのコードソースに対して許可します。
.RS 3
.TP 3
ExecPermission
\f2ExecPermission\fP クラスは、起動グループを開始するために \f2rmid\fP が特定の「コマンド」を実行する権限を表します。
.LP
\f3構文\fP
.br
\f2ExecPermission\fP の「名前」は、\f2rmid\fP に実行を許可するコマンドのパス名です。「/*」 (「/」はファイル区切り文字 \f2File.separatorChar\fP) で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。「/\-」で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を示します。パス名に特別なトークン「<<ALL FILES>>」を指定した場合は、\f3任意の\fPファイルを示します。
.LP
\f3注:\fP「*」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルを表します。 また、「\-」を 1 つ指定しただけのパス名は、現在のディレクトリ内のすべてのファイルと、現在のディレクトリに含まれるすべてのファイルとサブディレクトリ (再帰的に) を表します。
.TP 3
ExecOptionPermission
\f2ExecOptionPermission\fP クラスは、起動グループを開始するときに \f2rmid\fP が特定のコマンド行「オプション」を使用できる権限を表します。\f2ExecOptionPermission\fP の「名前」は、コマンド行オプションの値です。
.LP
\f3構文\fP
.br
オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカードマッチを表します。 アスタリスクは、オプション名そのものとして使用できます。 つまり、任意のオプションを表すことができます。 また、オプション名の末尾に使用することもできます。 ただし、「.」か「=」の直後にアスタリスクを指定する必要があります。
.LP
例を示します。「*」、「\-Dfoo.*」、「\-Da.b.c=*」は有効ですが、「*foo」、「\-Da*b」、「ab*」は無効です。
.TP 3
rmid のポリシーファイル
\f2rmid\fP にさまざまなコマンドおよびオプションを実行する権限を許可する場合は、アクセス権 \f2ExecPermission\fP および \f2ExecOptionPermission\fP を汎用的に許可する必要があります。 つまり、すべてのコードソースに対して許可します。これらのアクセス権をチェックするのは \f2rmid\fP だけなので、これらのアクセス権を汎用的に許可しても安全です。
.LP
\f2rmid\fP に各種の実行権限を許可するポリシーファイルの例を、次に示します。
.nf
\f3
.fl
grant {
.fl
permission com.sun.rmi.rmid.ExecPermission
"/files/apps/java/jdk1.2.2/solaris/bin/java";
.fl
"/files/apps/java/jdk1.2.2/solaris/bin/java";
.fl
.fl
permission com.sun.rmi.rmid.ExecPermission
"/files/apps/java/jdk1.2.2/solaris/bin/java_g";
.fl
"/files/apps/java/jdk1.2.2/solaris/bin/java_g";
.fl
.fl
permission com.sun.rmi.rmid.ExecPermission
"/files/apps/rmidcmds/*";
.fl
"/files/apps/rmidcmds/*";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
"-Djava.security.policy=/files/policies/group.policy";
.fl
"\-Djava.security.policy=/files/policies/group.policy";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
"-Djava.security.debug=*";
.fl
"\-Djava.security.debug=*";
.fl
.fl
permission com.sun.rmi.rmid.ExecOptionPermission
"-Dsun.rmi.*";
.fl
"\-Dsun.rmi.*";
.fl
};
.fl
\fP
.fi
.ft 1
.sp 1n
最初の 2 つのアクセス権は、
.B rmid
に対し、パス名により明示された 1.2.2 バージョンの
.B java
コマンドを実行する許可を与えます。デフォルトでは、
.B java.home
にある
.B java
コマンドのバージョン (
.B rmid
が使用するのと同じもの) が使用されるため、ポリシーファイルで指定する必要はありません。
3 番目のアクセス権は、
.B rmid
に対し、ディレクトリ
.BR /files/apps/rmidcmds
内の任意のコマンドを実行する権限を与えます。
.sp 1n
4 番目に許可されたアクセス権
.BR ExecOptionPermission
は、
.B rmid
に対し、セキュリティポリシーファイルを
.BR /files/policies/group.policy
に定義する起動グループを開始する権限を与えます。次のアクセス権は、起動グループが
.B java.security.debug
プロパティを使用する権限を与えます。最後のアクセス権は、
起動グループが
.B sun.rmi
プロパティ名階層内の任意のプロパティを使用する権限を与えます。
.sp 1n
ポリシーファイルを使って
.B rmid
を起動するには、
.BR rmid
のコマンド行で
.B java.security.policy
プロパティを指定する必要があります。次に例を示します。
.sp 1n
.ti +5n
.B rmid \-J\-Djava.security.policy=rmid.policy
.TP 2
\(bu
.I <policyClassName>
.sp 1n
デフォルトの動作では十分な柔軟性が得られない場合、管理者は
.BR rmid
の起動時に、
.B checkExecCommand
メソッドが実行されるクラスの名前を指定することにより、
.BR rmid
が実行するコマンドを検査できます。
.sp 1n
.IR policyClassName
には、public で引数を必要としないコンストラクタとともに public クラスを指定します。また、次の
.B checkExecCommand
メソッド実装も指定します。
.sp 1n
.ft 3
.nf
.in +5n
public void checkExecCommand(ActivationGroupDesc desc,
String[] command)
throws SecurityException;
.in
.fi
.ft 1
.sp 1n
起動グループを開始する前に、
.B rmid
は、ポリシーの
.BR checkExecCommand
メソッドを呼び出して、起動グループの記述子および起動グループを開始する完全な
コマンドを含む配列を渡します。
.B checkExecCommand
が
.BR SecurityException
をスローする場合、
.B rmid
は起動グループを開始せず、オブジェクトの起動を試みている呼び出し側に
.B ActivationException
がスローされます。
.TP
\(bu
.B none
.sp 1n
.B sun.rmi.activation.execPolicy
プロパティの値が「none」の場合、
.B rmid
は、起動グループの開始コマンドの検証を一切行いません。
.TP
.BI \-log " dir"
起動システムデーモンがデータベースおよび関連情報を書き込むのに使う、
ディレクトリの名前を指定します。デフォルトでは、
.B rmid
コマンドを実行したディレクトリに
.B log
というログディレクトリが作成されます。
.TP
.BI \-port " port"
.BR rmid
のレジストリが使うポートを指定します。起動システムデーモンは、
.BR java.rmi.activation.ActivationSystem
という名前で
.BR ActivationSystem
をレジストリにバインドします。したがって、ローカルマシンの
.B ActivationSystem
は、次のように
.B Naming.lookup
メソッドを呼び出すことによって取得できます。
最初の 2 つの付与されているアクセス権は、\f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドおよび \f2java_g\fP コマンドの 1.2.2 バージョンの実行を許可します。デフォルトでは、\f2java.home\fP にあるバージョンの \f2java\fP コマンド (\f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。3 番目のアクセス権は、\f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
.LP
4 番目のアクセス権 \f2ExecOptionPermission\fP は、\f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。5 番目のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。
.LP
ポリシーファイルを指定して \f2rmid\fP を起動するには、\f2rmid\fP のコマンド行で \f2java.security.policy\fP プロパティーを指定する必要があります。 次に例を示します。
.RS 3
.LP
.RS
.ft 3
.LP
\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
.LP
.RE
.RE
.TP 2
o
.LP
.TP 2
o
\f4<policyClassName>\fP
.LP
デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\f2rmid\fP の起動時に、\f2checkExecCommand\fP メソッドが所属するクラスの名前を指定して、rmid が実行するコマンドをチェックすることができます。
.LP
\f2policyClassName\fP には、引数なしのコンストラクタを持ち、次のような \f2checkExecCommand\fP メソッドを実装している public クラスを指定します。
.nf
import java.rmi.*;
import java.rmi.activation.*;
\f3
.fl
public void checkExecCommand(ActivationGroupDesc desc,
.fl
String[] command)
.fl
throws SecurityException;
.fl
\fP
.fi
起動グループを開始する前に、\f2rmid\fP は、ポリシーの \f2checkExecCommand\fP メソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\f2checkExecCommand\fP が \f2SecurityException\fP をスローすると、\f2rmid\fP はその起動グループを開始せず、オブジェクトの起動を試行している呼び出し側には \f2ActivationException\fP がスローされます。
.LP
.TP 2
o
\f3none\fP
.LP
\f2sun.rmi.activation.execPolicy\fP プロパティーの値が「none」の場合、\f2rmid\fP は、起動グループを開始するコマンドをまったく検証しません。
.RE
.LP
.TP 3
\-log dir
起動システムデーモンがデータベースおよび関連情報を書き込むのに使うディレクトリの名前を指定します。デフォルトでは、\f2rmid\fP コマンドを実行したディレクトリに、\f2log\fP というログディレクトリが作成されます。
.LP
.TP 3
\-port port
\f2rmid\fP のレジストリが使うポートを指定します。起動システムデーモンは、このレジストリの中で、\f2java.rmi.activation.ActivationSystem\fP という名前で\f2ActivationSystem\fP をバインドします。したがって、ローカルマシン上の \f2ActivationSystem\fP は、次のように \f2Naming.lookup\fP メソッドを呼び出すことによって取得できます。
.nf
\f3
.fl
import java.rmi.*;
.fl
import java.rmi.activation.*;
.fl
ActivationSystem system;
system = (ActivationSystem)
Naming.lookup("//:port/java.rmi.activation.ActivationSystem");
.fl
ActivationSystem system; system = (ActivationSystem)
.fl
Naming.lookup("//:\fP\f4port\fP/java.rmi.activation.ActivationSystem");
.fl
.fi
.TP 3
\-stop
\f2\-port\fP オプションによって指定されたポートの、現在の \f2rmid\fP 呼び出しを停止します。ポートが指定されていない場合は、ポート 1098 で実行されている \f2rmid\fP を停止します。
.RE
.TP
.BI \-stop
.B -port
オプションによって指定されたポートの、現在の
.B rmid
の呼び出しを停止します。ポートの指定がない場合は、ポート 1098 で実行されている
.B rmid
を停止します。
.SH "環境変数"
.TP 20
.SB "CLASSPATH"
ユーザ定義クラスへのパスをシステムに通知するために使用します。ディレクトリはコロンで
区切ります。以下に例を示します。
.RS
.SH "環境変数"
.LP
.ft 3
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。例を示します。
.nf
% .:/usr/local/java/classes
\f3
.fl
.:/usr/local/java/classes
.fl
\fP
.fi
.ft 1
.RE
.SH "関連項目"
.LP
.SH "関連項目"
.LP
.LP
.LP
rmic、CLASSPATH、java
rmic(1)、
.na
\f2CLASSPATH\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath、java(1)
.LP
.LP

205
jdk/src/linux/doc/man/ja/rmiregistry.1
View File

@ -1,108 +1,99 @@
'\" t
.\"
.\" Copyright 2000-2004 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH rmiregistry 1 "2004 年 6 月 22 日"
.SH "名前"
rmiregistry \- Java リモートオブジェクトレジストリ
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
.SH "形式"
.B rmiregistry
[
.I port
]
.SH "機能説明"
.IX "Java remote object registry" "" "Java remote object registry \(em \fLrmiregistry\fP"
.IX "rmiregistry" "" "\fLrmiregistry\fP \(em Java remote object registry"
.B rmiregistry
コマンドは、現在のホスト上の指定されたポートに、リモートオブジェクト
レジストリを作成し起動します。
ポート番号が省略された場合には、ポート
1099
が使用されます。
.B rmiregistry
はバックグラウンドで実行され、何も出力しません。
以下に指定例を示します。
.LP
.RS
.B example% rmiregistry &
.RE
.LP
リモートオブジェクトレジストリはブートストラップネームサービスで、
ホスト上の
RMI
サーバがリモートオブジェクトに名前をバインドするために使用します。
名前がついたあとは、クライアント側でリモートオブジェクトを探して
リモートメソッドを呼び出すことができます。
.LP
レジストリは通常、アプリケーションがメソッドを呼び出す必要がある
最初のリモートオブジェクトを指定するために使用されます。
そのあと、そのオブジェクトを使って、アプリケーション固有の
方法で他のオブジェクトを探すことが可能になります。
.LP
.B java.rmi.registry.LocateRegistry
クラスのメソッドは、特定のホストまたは特定のホストとポート上で
動作しているレジストリを得るために用いられます。
.LP
.B java.rmi.Naming
クラスの
URL
用のメソッドはレジストリを操作するもので、
リモートオブジェクトの探索、リモートオブジェクトへの
名前
(文字列)
のバインド、新たな名前のバインド
(以前のバインドを上書き)、
バインドの取り消し、およびレジストリ中でバインドされている
URL
の一覧表示が可能です。
.SH "オプション"
以下のオプションが使用できます。
.TP 15
.BI \-J option
java オプションと組み合わせて使います
(
.B \-J
と java オプションの間にスペースは必要ありません)。
.B \-J
の後ろに続くオプションを java インタプリタに渡します。
.SH "関連項目"
次については、
.BR java.sun.com
を参照または検索してください。
.TP 5
.B java.rmi.Naming @
http://java.sun.com/j2se/1.5/docs/api/java/rmi/Naming.html
.TP 5
.B java.rmi.registry.LocateRegistry @
http://java.sun.com/j2se/1.5/docs/api/java/rmi/registry/LocateRegistry.html
." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH rmiregistry 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
rmiregistry \- Java リモートオブジェクトレジストリ
.LP
.RS 3
.LP
.LP
\f3rmiregistry\fP コマンドは、現在のホストの指定したポート上にリモートオブジェクトレジストリを開始します。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
rmiregistry [\fP\f4port\fP\f3]
.fl
\fP
.fi
.LP
.SH "説明"
.LP
.LP
.LP
\f3rmiregistry\fP コマンドは、現在のホストの指定 \f2port\fP 上にリモートオブジェクトレジストリを作成し、開始します。\f2port\fP の指定を省略した場合、レジストリはポート 1099 で開始します。\f3rmiregistry\fP コマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。例を示します。
.LP
.LP
\f2rmiregistry&\fP
.LP
.LP
リモートオブジェクトレジストリは、ブートストラップのネームサービスです。 同一ホストの RMI サーバーが、リモートオブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモートホストのクライアントはリモートオブジェクトを検索し、リモートメソッドの呼び出しを行います。
.LP
.LP
レジストリは、一般的に、最初のリモートオブジェクトの位置を指定します。 そこで、アプリケーションはメソッドを呼び出す必要があります。代わって、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
.LP
.LP
\f2java.rmi.registry.LocateRegistry\fP クラスのメソッドは、ローカルホスト、またはローカルホストとポートで動作するレジストリを取得するために使用されます。
.LP
.LP
\f2java.rmi.Naming\fP クラスの URL ベースのメソッドは、レジストリで動作し、任意のホストおよびローカルホスト上のリモートオブジェクトの検索に使用されます。リモートオブジェクトに単純な (文字列) 名前をバインドしたり、新しい名前をリバインド (古いバインドにオーバーライド) します。 またリモートオブジェクトをアンバインドしたり、レジストリにバインドされた URL を出力します。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-J
\f2\-J\fP の後ろに続くオプションを \f2java\fP インタプリタに引き渡します。 \f2java\fP オプションと組み合わせて使います (\f2\-J\fP と \f2java\fP オプションの間にスペースは入れない)。
.RE
.LP
.SH "関連項目"
.LP
.LP
.LP
java(1)、
.na
\f2java.rmi.registry.LocateRegistry\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html、および
.na
\f2java.rmi.Naming\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
.LP
.LP

111
jdk/src/linux/doc/man/ja/schemagen.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,62 +18,44 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH schemagen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
."
.TH schemagen 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.ad c
.SH 名前
XML バインドのための Java(TM) アーキテクチャ
.SH "名前"
schemagen \- XML バインドのための Java(TM) アーキテクチャースキーマジェネレータ
.LP
.LP
\f3仕様バージョン:\fP 2.1
.br
スキーマジェネレータ\f3仕様のバージョン:\fP 2.0
.br
\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
.br
.ad l
\f3実装バージョン:\fP 2.1.3
.LP
.SS
schemagen の起動
schemagen の起動
.LP
.LP
スキーマジェネレータは、ユーザーのプラットフォームの \f2bin\fP ディレクトリにある \f2schemagen\fP シェルスクリプトを使って起動できます。
スキーマジェネレータは、ユーザーのプラットフォームの \f2bin\fP ディレクトリにある \f2schemagen\fP シェルスクリプトを使って起動できます。
.LP
.LP
現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
現在のスキーマジェネレータは、Java ソースファイルとクラスファイルのいずれも処理できます。
.LP
.LP
また、スキーマジェネレータを実行するための Ant タスクも用意されています。schemagen を Ant とともに使用するための手順を参照してください。
また、スキーマジェネレータを実行するための Ant タスクも用意されています。
.na
\f2schemagen を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlための手順を参照してください。
.LP
.RS 3
.LP
\f3Solaris/Linux の場合\fP
.LP
.nf
\f3
.fl
% path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
% schemagen.sh Foo.java Bar.java ...
.fl
Note: Writing schema1.xsd
.fl
.fl
\fP
.fi
.LP
\f3WindowsNT/2000/XP の場合\fP
.LP
.nf
\f3
.fl
> path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
.fl
Note: Writing schema1.xsd
.fl
注: Writing schema1.xsd
.fl
\fP
.fi
@ -83,43 +63,70 @@ schemagen
.LP
.LP
ユーザの Java ソース/クラスがほかのクラスを参照している場合、システムの CLASSPATH 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP オプションを使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
ユーザーの Java ソース/クラスがほかのクラスを参照している場合、システムの CLASSPATH 環境変数経由でそれらのクラスにアクセスできるようになっているか、あるいは \f2\-classpath\fP/\f2\-cp\fP オプションを使ってそれらのクラスをツールに指定する必要があります。そうしないと、スキーマの生成時にエラーが発生します。
.LP
.RS 3
.LP
\f3コマンド行オプション\fP
\f3コマンド行オプション\fP
.LP
.RS 3
.LP
.nf
\f3
.fl
使用法: schemagen [\-options ...] <java files>
使用方法: schemagen [\-options ...] <java files>
.fl
.fl
オプション:
オプション:
.fl
\-d <path> : プロセッサおよび javac によって生成されるクラスファイルの格納場所を指定します
\-d <path> : プロセッサと javac 生成のクラスファイルを置く場所を指定します。
.fl
\-cp <path> : ユーザ指定ファイルの検索場所を指定します
\-cp <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
\-classpath <path> : ユーザ指定ファイルの検索場所を指定します
\-classpath <path> : ユーザー指定ファイルの検索場所を指定します。
.fl
\-help : この使用方法に関するメッセージを表示します
.fl
\-help : この使用方法に関するメッセージを表示します。
.fl
\fP
.fi
.RE
.LP
.RE
.SS
生成されるリソースファイル
生成されるリソースファイル
.LP
.LP
現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、スキーマジェネレータの ant タスクを使用してください。
現在のスキーマジェネレータは単純に、Java クラス内で参照されている名前空間ごとに 1 つのスキーマファイルを作成します。生成されるスキーマファイルの名前を制御する方法は、現時点では存在しません。そうした目的には、
.na
\f2スキーマジェネレータの Ant タスク\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.htmlを使用してください。
.LP
.SH "関連項目"
.LP
.RS 3
.TP 2
o
スキーマジェネレータの実行 (schemagen):[
.na
\f2コマンド行の命令\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html、
.na
\f2SchemaGen を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
.TP 2
o
.na
\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
.LP

184
jdk/src/linux/doc/man/ja/serialver.1
View File

@ -1,100 +1,98 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH serialver 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
serialver \- シリアルバージョンコマンド
.\"
.\" This document was created by saving an HTML file as text
.\" from the JavaSoft web site:
.\"
.\" http://java.sun.com/j2se/1.5/docs/tooldocs/tools.html
.\"
.\" and adding appropriate troff macros. Because the JavaSoft web site
.\" man pages can change without notice, it may be helpful to diff
.\" files to identify changes other than new functionality.
.\"
." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH serialver 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
serialver \- シリアルバージョンコマンド
.LP
.RS 3
.LP
.LP
\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
.LP
.RE
.SH "形式"
.LP
.LP
.nf
\f3
.fl
\fP\f3serialver\fP [ options ] [ classnames ]
.fl
.fi
.LP
.RS 3
.LP
.RS 3
.TP 3
options
このドキュメントで説明されているコマンド行オプションです。
.TP 3
classnames
1 つ以上のクラス名です。
.RE
.LP
.RE
.SH "説明"
.LP
.LP
.LP
\f3serialver\fP コマンドは \f2serialVersionUID\fP を返します。
\f3serialver\fP は、1 つ以上のクラスの \f2serialVersionUID\fP を、展開しているクラスへコピーするのに適した形式で返します。引数を指定しないで呼び出すと、使用方法が表示されます。
.LP
.SH "形式"
.B serialver
[
.B options
] [
.I classnames
]
.TP
.BI options
このドキュメントで指定されているコマンド行オプション。
.TP
.BI classnames
1 つまたは複数のクラス名。
.SH "機能説明"
.IX "serial version command" "" "serial version command \(em \fLserialver\fP"
.IX "serialver" "" "\fLserialver\fP \(em serial version command"
.B serialver
は、指定された 1 個
または複数個のクラスの
.B シリアルバージョン UID
を、展開しているクラスへコピーするのに適した形式で返します。
引数なしで呼び出した場合、
.B serialver
は使用方法を説明する行を表示します。
.SH "オプション"
.TP 15
.B \-classpath " <directories and zip/jar files separated by:>"
アプリケーションのクラスおよびリソースの検索パスを設定します。
.TP 15
.B \-show
単なるユーザインタフェースを表示します。
ここで完全クラス名を入力し、
Enter
キーまたは
Show
ボタンを押すと、シリアルバージョン
UID
が表示されます。
.TP 15
.BI \-J "option"
.I option
を Java 仮想マシンに渡します。ここで、
.I option
は、Java アプリケーション起動プログラムの参照ページで
説明されているオプションの 1 つです。たとえば、
.I \-J-Xms48m
は、起動時に使用するメモリを 48M バイトに設定します。
.SH "オプション"
.LP
.SH "注意"
.LP
.RS 3
.TP 3
\-classpath <: で区切られたディレクトリと zip や jar ファイル>
アプリケーションのクラスおよびリソースの検索パスを設定します。
.RE
.LP
.RS 3
.TP 3
\-show
簡単なユーザーインタフェースを表示します。完全指定のクラス名を入力して、Enter キーか [Show] ボタンを押し、シリアルバージョン UID を表示します。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
.RE
.LP
.SH "注"
.LP
.LP
.LP
\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティマネージャの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティマネージャを設定できます。
\f3serialver\fP コマンドは、指定されたクラスをその仮想マシン内に読み込んで初期化しますが、デフォルトではセキュリティーマネージャーの設定は行いません。信頼できないクラスとともに \f3serialver\fP を実行する場合には、次のオプションを使ってセキュリティーマネージャーを設定できます。
.LP
.RS 3
@ -104,7 +102,7 @@ UID
.LP
.RE
.LP
また、必要であれば、次のオプションを使ってセキュリティポリシーを指定できます。
また、必要であれば、次のオプションを使ってセキュリティーポリシーを指定できます。
.LP
.RS 3
@ -112,16 +110,16 @@ UID
.LP
\f2\-J\-Djava.security.policy=<policy file>\fP
.LP
.SH "関連項目"
.RE
.SH "関連項目"
.LP
.LP
.LP
.fi
http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
の
.na
「\f2java.io.ObjectStreamClass\fP」
\f2java.io.ObjectStreamClass\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
.LP
.LP

338
jdk/src/linux/doc/man/ja/servertool.1
View File

@ -1,226 +1,130 @@
'\" t
.\"
.\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH servertool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
servertool - Java(TM) IDL サーバツール
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH servertool 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.B servertool
は、アプリケーション開発者が持続サーバの登録、登録解除、起動、停止を行うためのコマンド行インタフェースを提供します。
.SH "形式"
.B servertool
\-ORBInitialPort nameserverport options [ commands ]
.SH "名前"
servertool \- Java(TM) IDL サーバーツール
.LP
.B servertool
の起動時にコマンドを
入力しなかった場合は、
コマンド行ツールが
.B servertool >
プロンプトを表示します。
.B servertool >
プロンプトで
コマンドを入力します。
.RS 3
.LP
.B servertool
の起動時にコマンドを入力した場合は、
Java IDL サーバツールが起動し、
コマンドを実行して終了します。
.LP
\-ORBInitialPort nameserverport オプションは、必須です。
nameserverport の値は、orbd を実行し、
着信要求を待機しているポートを指定します。
Solaris ソフトウェアを使用する場合は、
スーパーユーザになって 1024 未満のポートでプロセスを開始する
必要があります。このため、1024 以上のポート番号の
使用を推奨します。
.SH 機能説明
.BR servertool
はアプリケーション
プログラマが、持続サーバの登録、登録解除、起動、停止を
行うためのコマンド行インタフェースです。
サーバに関するさまざまな統計情報を取得するために
その他のコマンドが用意されています。
.SH オプション
.TP
.BI \-ORBInitialHost " nameserverhost"
ネームサーバを実行し、着信要求を待機している
ホストマシンを指定します。このオプションを
指定しない場合、nameserverhost はデフォルトの
localhost になります。
.B orbd
と
.B servertool
が異なるマシンで実行されている場合は、orbd が
実行されているホストの名前または IP アドレスを
指定する必要があります。
.TP
.BI \-J option
オプションを Java 仮想マシンに渡します。
ここで option は、Java アプリケーション
起動プログラム
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html)
のリファレンスページで説明されている
オプションの 1 つです。
たとえば、\-J-Xms48m は、
起動メモリを 48M バイトに設定します。
\-J が基本にする仮想マシンにオプションを
渡すことは、共通の規約です。
.SH コマンド
.TP
.B register \-server <server class name>
.B \-classpath <classpath to server>
[
.B \-applicationName <application\ name>
.B \-args <args to server>
.B \-vmargs <flags to be passed
.B to Java VM>
]
.RS
.LP
新しい持続サーバを Object Request Broker Daemon (ORBD) に登録します。
まだ登録されていない場合は、サーバが登録され、有効化されます。
このコマンドを使用すると、
\-server オプションによって
識別されるサーバのメインクラスでインストールメソッドが
呼び出されます。インストールメソッドは、
public static void install (org.omg.CORBA.ORB) で
なければなりません。このインストールメソッドを
オプションで使用すると、開発者は独自の
サーバインストール動作 (データベーススキーマの作成など)
を指定できます。
\f3servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。
.RE
.TP
.B unregister \-serverid <server id >
.B | \-applicationName <application\ name>
.RS
.LP
サーバ ID またはアプリケーション名を使用して、
ORBD からサーバを登録解除します。
このコマンドを使用すると、\-server オプションによって
識別されたサーバのメインクラスでアンインストール
メソッドが呼び出されます。アンインストールメソッドは、
public static void uninstall(org.omg.CORBA.ORB)
でなければなりません。このアンインストールメソッドを
オプションで使用すると、
開発者は独自のサーバアンインストール動作
(インストールメソッドの動作の取り消しなど)
を指定できます。
.RE
.TP
.B getserverid \-applicationName <application name>
アプリケーションに対応するサーバ ID を返します。
.TP
.B list
.br
ORBD に登録されているすべての持続サーバに関する情報を
一覧表示します。
.TP
.B listappnames
ORBD に現在登録されているすべてのサーバのアプリケーション名を
一覧表示します。
.TP
.B listactive
ORBD によって起動され、稼動しているすべての
持続サーバに関する情報を
すべて一覧表示します。
.TP 3
locate \-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
[\-endpointType\ <endpointType>\ ]
.RS
.LP
登録されているサーバによって作成されたすべての ORB の特定のタイプ
のエンドポイント (ポート) を特定します。サーバがまだ稼動していな
い場合は、起動されます。エンドポイントタイプが指定されないと、サ
ーバ内の各 ORB に関連したプレーン/非保護の
エンドポイントが返されます。
.RE
.TP 3
locateperorb
\-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
[\-orbid\ <ORB\ name>\ ]
登録されているサーバの特定の ORB によって登録されたすべてのエンド
ポイント (ポート) を特定します。サーバがまだ動作していない場合は、
起動されます。
.BR orbid
が指定されないと、デフォルト値である "" が
.BR orbid
に割り当てられます。空の文字列の
.BR orbid
を使用して ORB が作成されると、それによって登録されているす
べてのポートが返されます。
.RE
.TP
.B orblist \-serverid <server id> |
.B \-applicationName <application name> ]
.RS
.LP
サーバで定義されている ORB の ORBId を一覧表示します。
ORBId は、サーバによって作成された ORB の
文字列名です。サーバがまだ稼動していない場合は、
サーバを起動します。
.RE
.TP
.B shutdown \-serverid <server id> |
.B \-applicationName <application name> ]
.RS
.LP
ORBD に登録されているアクティブなサーバを停止します。
このコマンドの
実行中に、
サーバプロセスを適切に停止するために、
\-serverid または \-applicationName パラメータで
指定されたクラスで定義されている
.BR shutdown()
メソッドも呼び出されます。
.RE
.TP
.B startup \-serverid <server id> |
.B \-applicationName <application name>
.RS
.LP
ORBD に登録されているサーバを起動します。
サーバが稼動していな
い場合、このコマンドはサーバを起動します。サーバが既に稼動して
いる場合は、エラーメッセージがユーザに返されます。
.RE
.TP
.B help
.br
このサーバツールを使用してサーバに対して実行できるすべての
コマンドを一覧表示します。
.TP
.B quit
.br
このサーバツールを終了します。
.RE
.SS "関連項目"
.SH "形式"
.LP
.LP
orbd
.nf
\f3
.fl
servertool \-ORBInitialPort \fP\f4nameserverport\fP\f3 \fP\f3options\fP\f3 [ \fP\f3commands\fP\f3 ]
.fl
\fP
.fi
.LP
.LP
コマンドを入力しないで \f2servertool\fP を起動すると、コマンド行ツールとして \f2servertool >\fP プロンプトが表示されます。\f2servertool >\fP プロンプトにコマンドを入力します。
.LP
.LP
コマンドを入力して \f2servertool\fP を起動すると、Java IDL サーバーツールが起動し、コマンドを実行して終了します。
.LP
.LP
\f2\-ORBInitialPort\fP \f2nameserverport\fP オプションは\f3必須\fPです。\f2nameserverport\fP の値には、\f2orbd\fP が実行され、着信要求を待機しているポートを指定する必要があります。Solaris ソフトウェアの使用時は、1024 より小さいポートでプロセスを開始する場合は、root ユーザーになる必要があります。 このため、\f2nameserverport\fP として 1024 または 1024 より大きいポートを使用することをお勧めします。
.LP
.SH "説明"
.LP
.LP
.LP
\f2servertool\fP はアプリケーションプログラマが、持続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。
.LP
.SH "オプション"
.LP
.LP
.RS 3
.TP 3
\-ORBInitialHost nameserverhost
ネームサーバーが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、\f2nameserverhost\fP はデフォルトで \f2localhost\fP に設定されます。\f2orbd\fP と \f2servertool\fP が異なるマシン上で実行されている場合は、\f2orbd\fP が実行されているホストの名前と IP アドレスを指定する必要があります。
.TP 3
\-Joption
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
.SH "コマンド"
.LP
.LP
.RS 3
.TP 3
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
Object Request Broker Daemon (ORBD) に新規持続サーバーを登録します。サーバーが未登録の場合、登録して起動します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でインストールメソッドが呼び出されます。このインストールメソッドは、\f2public static void install(org.omg.CORBA.ORB)\fP になっている必要があります。インストールメソッドは、オプションであり、データベーススキーマの作成などの独自のサーバーインストール動作を開発者が指定できます。
.TP 3
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
サーバー ID またはアプリケーション名を使用して、ORBD のサーバーの登録を解除します。このコマンドによって、\f2\-server\fP オプションで識別されるサーバーのメインクラス内でアンインストールメソッドが呼び出されます。このアンインストールメソッドは、\f2public static void uninstall(org.omg.CORBA.ORB)\fP になっている必要があります。アンインストールメソッドは、オプションであり、インストールメソッドの動作の取り消しなどの独自のサーバーアンインストール動作を開発者が指定できます。
.TP 3
getserverid \-applicationName\ <application\ name>
アプリケーションに関連付けられているサーバー ID を返します。
.TP 3
list
ORBD に登録されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
listappnames
現在 ORBD に登録されているすべてのサーバーのアプリケーション名を一覧表示します。
.TP 3
listactive
ORDB によって起動され、現在実行されているすべての持続サーバーに関する情報を一覧表示します。
.TP 3
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
登録されたサーバーで作成したすべての ORB の特定の型について端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。端点の型が指定されていない場合、サーバーの ORB ごとに関連付けられている plain 型 または non\-protected 型の端点が返されます。
.TP 3
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
登録されたサーバーの特定の ORB で登録された端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。\f2orbid\fP が指定されていない場合は、デフォルト値の「""」が\f2orbid\fPに割り当てられます。ORB が空文字列の \f2orbid\fP で作成されている場合、登録したポートがすべて返されます。
.TP 3
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
サーバー上に定義された ORB の ORBId を一覧表示します。ORBId はサーバーで作成された ORB の文字列名です。サーバーが実行されていない場合、起動されます。
.TP 3
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
ORBD に登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\f2\-serverid\fP パラメータまたは \f2\-applicationName\fP パラメータで指定されたクラス内に定義された \f2shutdown()\fP メソッドも呼び出されてサーバープロセスを正しく停止します。
.TP 3
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
ORBD に登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーを起動します。サーバーがすでに実行されている場合は、ユーザーにエラーメッセージが返されます。
.TP 3
help
サーバーがサーバーツールで使用できるすべてのコマンドを表示します。
.TP 3
quit
サーバーツールを終了します。
.RE
.LP
.SH "関連項目"
.LP
.LP
orbd(1)
.LP

233
jdk/src/linux/doc/man/ja/tnameserv.1
View File

@ -1,121 +1,80 @@
'\" t
.\"
.\" Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH tnameserv 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH "名前"
Java IDL: 一時ネームサービス \- \f2tnameserv\fP
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH tnameserv 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
Java IDL:一時ネームサービス \- \f2tnameserv\fP
.LP
.LP
.LP
このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には ORBD (Object Request Broker Daemon) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD が使用されていますが、一時ネームサービスを使用する例の \f2orbd\fP はどれも、\f2tnameserv\fP で置き換えることができます。\f2orbd\fP ツールのドキュメントについては、そのマニュアルページか、
このドキュメントでは、Java IDL 一時ネームサービス \f2tnameserv\fP の使用方法について説明します。Java IDL には、Object Request Broker Daemon (ORBD) も含まれています。ORBD は、ブートストラップサービス、一時ネームサービス、\f3持続\fPネームサービス、およびサーバーマネージャーを含むデーモンプロセスです。Java IDL のすべてのチュートリアルでは ORBD を使用していますが、一時ネームサービスを使用する例では、\f2orbd\fP の代わりに \f2tnameserv\fP を使用できます。\f2orbd\fP ツールの詳細については、\f2orbd\fP の orbd(1)または
.na
\f2Java IDL Naming Service Included with ORBD\fP
\f2ORBD に含まれる Java IDL ネームサービス\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html) のトピックを参照してください。
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlに関するトピックを参照してください。
.LP
.LP
ここでは、次の項目について説明します。
ここでは、以下の項目について説明します。
.LP
.RS 3
.TP 2
o
Java\ IDL 一時ネームサービス
Java\ IDL 一時ネームサービス
.TP 2
o
Java\ IDL 一時ネームサービスの起動
Java\ IDL 一時ネームサービスの起動
.TP 2
o
Java\ IDL 一時ネームサービスの停止
Java\ IDL 一時ネームサービスの停止
.TP 2
o
サンプルクライアント: 名前空間へのオブジェクトの追加
サンプルクライアント:名前空間へのオブジェクトの追加
.TP 2
o
サンプルクライアント: 名前空間のブラウズ
サンプルクライアント:名前空間のブラウズ
.RE
.LP
.SH "Java\ IDL 一時ネームサービス"
.IX "Java IDL name server starter script" "" "Java IDL name server starter script \(em \fLtnameserv\fP"
.IX "tnameserv" "" "\fLtnameserv\fP \(em Java IDL name server starter script"
.SM CORBA
の
.SM COS
(Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ
構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供し
ます。
Java
.SM IDL
の一時ネームサービス、\f2tnameserv\fP は、
.SM COS
ネームサービスの仕様を単純な形で実装したものです。
.LP
オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前の組は、
それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミ
ングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体
がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機
能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納さ
れます。名前空間において、初期ネーミングコンテキストは唯一の持続的バイン
ディングです。それ以外のネーミングコンテキストは、Java
.SM IDL
のネームサーバープロセスが停止し、再起動されると失われます。
.LP
アプレットまたはアプリケーションから
.SM COS
ネームサービスを使用するためには、その
.SM ORB
はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの
文字列化された初期ネーミングコンテキストにアクセスできなければなりません。
ネームサービスは、Java
.SM IDL
のネームサービスでもその他の
.SM COS
準拠のネームサービスでもかまいません。
.LP
.SH "Java\ IDL 一時ネームサービスの起動"
.SH "Java\ IDL 一時ネームサービス"
.LP
.LP
.IX "tnameserv" "Starting the Java IDL Name Server" "\fLtnameserv\fP \(em Java IDL name server starter script"
Java
.SM IDL
ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に
起動しておかなければなりません。
Java\ IDL 製品をインストールすると、Java\ IDL ネームサービスを起動するためのスクリプト (Solaris: \f2tnameserv\fP) または実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。
バックグラウンドで
動作するように、ネームサービスを起動してください。
CORBA の COS (Common Object Services) ネームサービスは、ファイルシステムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDL の一時ネームサービスである \f2tnameserv\fP は、COS ネームサービスの仕様を単純な形で実装したものです。
.LP
特に指定しない場合、Java
.SM IDL
ネームサービスは、
.SM ORB
の
.I resolve_initial_references(\|)
メソッドと
.I list_initial_references(\|)
メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
次のようにします。
.LP
オブジェクト参照は名前空間に名前で格納され、オブジェクト参照と名前のペアは、それぞれ「ネームバインディング」と呼ばれます。ネームバインディングは「ネーミングコンテキスト」に組み込むことができます。ネーミングコンテキストはそれ自体がネームバインディングであり、ファイルシステムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは「初期ネーミングコンテキスト」に格納されます。名前空間において、初期ネーミングコンテキストは唯一の持続的バインディングです。 それ以外のネーミングコンテキストは、Java IDL のネーミングサービスプロセスが停止し、再起動されると失われます。
.LP
.LP
アプレットまたはアプリケーションから COS ネームサービスを使用するためには、その ORB はネームサービスが動作しているホストのポートを知っているか、そのネームサービスの文字列化された初期ネーミングコンテキストにアクセスできなければなりません。ネームサービスは、Java\ IDL のネームサービスでもその他の COS 準拠のネームサービスでもかまいません。
.LP
.SH "Java\ IDL 一時ネームサービスの起動"
.LP
.LP
Java\ IDL ネームサービスは、ネームサービスを使用するアプリケーションまたはアプレットより前に起動しておかなければなりません。Java\ IDL 製品をインストールすると、Java IDL ネームサービスを起動するスクリプト (Solaris: \f2tnameserv\fP) か、実行可能ファイル (Windows NT: \f2tnameserv.exe\fP) が作成されます。バックグラウンドで動作するように、ネームサービスを起動してください。
.LP
.LP
特に指定しない場合、Java IDL ネームサービスは、ORB の \f2resolve_initial_references()\fP メソッドと \f2list_initial_references()\fP メソッドの実装に使用するブートストラッププロトコルに対してポート 900 で待機します。
.LP
.nf
\f3
@ -127,7 +86,7 @@ Java\ IDL
.LP
.LP
ネームサーバーのポートを指定しなかった場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアを実行する場合、1024 よりも小さいポートでプロセスを起動するには root になる必要があります。このため、1024 かそれよりも大きいポート番号を使用することをお勧めします。1050 などの異なるポートを指定し、かつネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルから次のように入力します。
ネームサーバーポートを指定しない場合、デフォルトでポート 900 が使用されます。Solaris ソフトウェアの実行時は、1024 より小さいポートでプロセスを開始する場合、root ユーザーになる必要があります。 このため、1024 または 1024 より大きいポートを使用することをお勧めします。 1050 のように別のポートを指定し、ネームサービスをバックグラウンドで実行するには、UNIX コマンドシェルで次のように入力します。
.LP
.nf
\f3
@ -139,7 +98,7 @@ Java\ IDL
.LP
.LP
Windows の場合は、MS\-DOS システムプロンプトから次のように入力します。
Windows の MS\-DOS システムプロンプトでは、次のように入力します。
.LP
.nf
\f3
@ -151,32 +110,32 @@ Windows
.LP
.LP
ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティに新しいポート番号を設定します。
ネームサーバーのクライアントには、新しいポート番号を知らせる必要があります。このため、ORB オブジェクトの作成時に \f2org.omg.CORBA.ORBInitialPort\fP プロパティーに新しいポート番号を設定します。
.LP
.SS
異なるホスト上でのサーバーとクライアントの実行
異なるマシン上でのクライアントとサーバーの実行
.LP
.LP
Java IDL および RMI\-IIOP に関するチュートリアルの大部分では、ネームサービス、サーバー、クライアントのすべてが開発マシン上で実行されています。実際の配備では通常、ネームサービスとは異なるホストマシン上でクライアントとサーバーが実行されます。
Java IDL と RMI\-IIOP のほとんどのチュートリアルでは、ネームサービス、サーバー、およびクライアントはすべて開発用のマシン上で実行されます。実際に配備する場合には、クライアントとサーバーを、ネームサービスとは異なるホスト上で実行することが多くなります。
.LP
.LP
クライアントとサーバーでネームサービスを検索するには、ネームサービスが実行されているポート番号とホストをそれらが知っている必要があります。そこで、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP と \f2org.omg.CORBA.ORBInitialHost\fP プロパティを、ネームサービスが実行されているマシン名とポート番号に設定します。この例については、
クライアントとサーバーがネームサービスを見つけるには、クライアントとサーバーが、ネームサービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の \f2org.omg.CORBA.ORBInitialPort\fP プロパティーと \f2org.omg.CORBA.ORBInitialHost\fP プロパティーをネームサービスが実行されているポートの番号とマシンの名前に設定します。この例は、
.na
「\f2The Hello World Example Using RMI\-IIOP\fP」
\f2「RMI\-IIOP を使った Hello World の例」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.html) を参照してください。また、コマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使ってネームサービスの検索場所をクライアントとサーバーに知らせることも可能です。
http://java.sun.com/javase/6/docs/technotes/guides/rmi\-iiop/rmiiiopexample.htmlに示されています。コマンド行オプション \f2\-ORBInitialPort\fP \f2nameserverport#\fP と \f2\-ORBInitialHost\fP \f2nameserverhostname\fP を使用して、クライアントとサーバーに対してネームサービスを探す場所を指定することもできます。
.na
「\f2Java IDL: Running the Hello World Example on TWO Machines\fP」
\f2「Java IDL: 2 台のマシン上で実行する Hello World プログラム」\fP @
.fi
(http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html) では、このコマンド行オプションを使う方法の 1 つが示されています。
http://java.sun.com/javase/6/docs/technotes/guides/idl/tutorial/jidl2machines.html には、コマンド行オプションを使用して指定する方法が示されています。
.LP
.LP
たとえば、一時ネームサービス \f2tnameserv\fP がホスト \f2nameserverhost\fP のポート 1050 上で、クライアントがホスト \f2clienthost\fP 上で、サーバーがホスト \f2serverhost\fP 上で、それぞれ実行されているとします。
たとえば、一時ネームサービス \f2tnameserv\fP が、ホスト \f2nameserverhost\fP のポート 1050 上で実行されているとします。さらに、クライアントがホスト \f2clienthost\fP 上で実行され、サーバーはホスト \f2serverhost\fP 上で実行されているとします。
.LP
.RS 3
.TP 2
o
ホスト \f2nameserverhost\fP 上の \f2tnameserv\fP を次のようにして起動します。
次のように、ホスト \f2nameserverhost\fP 上で \f2tnameserv\fP を起動します。
.nf
\f3
.fl
@ -188,7 +147,7 @@ o
.fi
.TP 2
o
\f2serverhost\fP 上のサーバーを次のようにして起動します。
\f2serverhost\fP 上でサーバーを起動します。
.nf
\f3
.fl
@ -198,7 +157,7 @@ o
.fi
.TP 2
o
\f2clienthost\fP 上のクライアントを次のようにして起動します。
\f2clienthost\fP 上でクライアントを起動します。
.nf
\f3
.fl
@ -210,48 +169,48 @@ o
.LP
.SS
\-J オプション
\-J オプション
.LP
\f2tnameserv\fP で使用可能なコマンド行オプションは、次のとおりです。
このコマンド行オプションは、\f2tnameserve\fP とともに使用できます。
.RS 3
.LP
.RS 3
.TP 3
\-Joption
\f2option\fP を Java 仮想マシンに渡します。ここで、\f2option\fP は、
.na
\f2Java アプリケーション起動ツール\fP
.fi
(http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) のリファレンスページで説明されているオプションの 1 つです。たとえば、\f3\-J\-Xms48m\fP とすると、起動時のメモリが 48M バイトに設定されます。\f3\-J\fP を使って実行元の仮想マシンにオプションを渡すことは、よく行われています。
Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。
.RE
.LP
.SH "Java IDL 一時ネームサービスの停止"
.RE
.SH "Java\ IDL 一時ネームサービスの停止"
.LP
.LP
Java\ IDL ネームサービスを停止するには、対応するオペレーティングシステムコマンドを使用します。たとえば、Unix プロセスの場合は \f2kill\fP を、Windows プロセスの場合は \f2Ctrl\-C\fP を、それぞれ使用します。ネームサービスは明示的にシャットダウンされるまで、呼び出しを待ち続けます。なお、ネームサービスを終了させると、Java\ IDL ネームサービスに登録されている名前は失われます。
Java IDL ネームサービスを停止するには、Unix の場合は、\f2kill\fP などのオペレーティングシステムのコマンドを使い、Windows の場合は、\f2Ctrl\-C\fP を使います。ネームサービスを明示的に停止するまでは、呼び出し待機状態が続きます。なお、サービスを終了させると、Java\ IDL ネームサービスに登録されている名前は失われます。
.LP
.SH "サンプルクライアント: 名前空間へのオブジェクトの追加"
.SH "サンプルクライアント:名前空間へのオブジェクトの追加"
.LP
.LP
以下に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
次に示すサンプルプログラムは、名前を名前空間に追加する方法を示すものです。このサンプルプログラムは、このままの状態で完全に動作する一時ネームサービスクライアントで、次のような単純なツリーを作成するものです。
.LP
.nf
\f3
.fl
\fP\f3
.fl
\fP\f4初期\fP\f3
\fP\f4初期\fP\f3
.fl
\fP\f4ネーミングコンテキスト\fP\f3
\fP\f4ネーミングコンテキスト\fP\f3
.fl
/ \\
/ \\
.fl
/ \\
/ \\
.fl
plans \fP\f4Personal\fP\f3
.fl
/ \\
/ \\
.fl
/ \\
/ \\
.fl
calendar schedule\fP
.fl
@ -259,7 +218,7 @@ Java\ IDL
.LP
.LP
この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照が含まれるネーミングコンテキストです。
この例で、\f3plans\fP はオブジェクト参照、\f3Personal\fP は \f3calendar\fP と \f3schedule\fP の 2 つのオブジェクト参照を含むネーミングコンテキストです。
.LP
.nf
\f3
@ -286,7 +245,7 @@ public class NameClient
.fi
.LP
前述の「Java IDL 一時ネームサービスの起動」では、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。 次のコードで、このポート番号をクライアントプログラムに知らせます。
.nf
\f3
.fl
@ -302,7 +261,7 @@ public class NameClient
.fi
.LP
このコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。この \f3objref\fP には、あとでさまざまな名前を割り当てて名前空間に追加します。
次のコードでは、初期ネーミングコンテキストを取得し、それを \f3ctx\fP に代入します。2 行目では、\f3ctx\fP をダミーのオブジェクト参照 \f3objref\fP にコピーします。 この \f3objref\fP には、あとでさまざまな名前を割り当てて名前空間に追加します。
.nf
\f3
.fl
@ -318,7 +277,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
このコードでは、text 型の名前「plans」を作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fP を使用して初期ネーミングコンテキストの下に「plans」を追加しています。\f2rebind\fP メソッドを使用すれば、\f2bind\fP を使用した場合に発生する例外を発生させずに、このプログラムを何度も繰り返し実行できます。
次のコードでは、text 型の名前 plans を作成し、それをダミーのオブジェクト参照にバインドします。その後、\f2rebind\fP を使用して初期ネーミングコンテキストの下に "plans" を追加しています。\f2rebind\fP メソッドを使用すれば、\f2bind\fP を使用した場合に発生する例外を発生させずに、このプログラムを何度も繰り返し実行できます。
.nf
\f3
.fl
@ -336,7 +295,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
このコードでは、directory 型の「Personal」というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
次のコードでは、directory 型の Personal というネーミングコンテキストを作成します。その結果得られるオブジェクト参照 \f3ctx2\fP をこの名前にバインドし、初期ネーミングコンテキストに追加します。
.nf
\f3
.fl
@ -354,7 +313,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
残りのコードでは、ダミーのオブジェクト参照を「schedule」と「calendar」という名前でネーミングコンテキスト「Personal」(\f3ctx2\fP) にバインドします。
残りのコードでは、ダミーのオブジェクト参照を schedule と calendar という名前でネーミングコンテキスト "Personal" (\f3ctx2\fP) にバインドします。
.nf
\f3
.fl
@ -394,10 +353,10 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
.SH "サンプルクライアント: 名前空間のブラウズ"
.SH "サンプルクライアント:名前空間のブラウズ"
.LP
.LP
次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
次のサンプルプログラムでは、名前空間をブラウズする方法を示します。
.LP
.nf
\f3
@ -424,7 +383,7 @@ public class NameClientList
.fi
.LP
前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。次のコードで、このポート番号をクライアントプログラムに知らせます。
前述の「Java IDL 一時ネームサービスの起動」で、ネームサーバーはポート 1050 を使用して起動しました。 次のコードで、このポート番号をクライアントプログラムに知らせます。
.nf
\f3
.fl
@ -444,7 +403,7 @@ public class NameClientList
.fi
.LP
次のコードでは、初期ネーミングコンテキストを取得しています。
次のコードでは、初期ネーミングコンテキストを取得しています。
.nf
\f3
.fl
@ -458,7 +417,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。残りのバインディングは、BindingIteratorHolder に返されます。
\f2list\fP メソッドは、ネーミングコンテキストに追加されているバインディングをリストします。この場合、最大 1000 個までのバインディングが初期ネーミングコンテキストから BindingListHolder に返されます。 残りのバインディングは、BindingIteratorHolder に返されます。
.nf
\f3
.fl
@ -474,7 +433,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
このコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
次のコードでは、返された BindingListHolder からバインディングの配列を取得します。バインディングがない場合は、プログラムは終了します。
.nf
\f3
.fl
@ -488,7 +447,7 @@ NamingContextHelper.narrow(orb.resolve_initial_references("NameService"));
.fi
.LP
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
.nf
\f3
.fl
@ -542,4 +501,4 @@ bindings[i].binding_name[lastIx].id);
.LP
.LP

238
jdk/src/linux/doc/man/ja/unpack200.1
View File

@ -1,31 +1,54 @@
'\" t
.\"
.\" Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\"
.TH unpack200 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
.SH 名前
unpack200 \- JAR アンパックツール
.SH 形式
." Copyright Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH unpack200 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "名前"
unpack200 \- JAR アンパックツール
.LP
.RS 3
.TP 2
o
形式
.TP 2
o
説明
.TP 2
o
オプション
.TP 2
o
終了ステータス
.TP 2
o
関連項目
.TP 2
o
説明
.RE
.LP
.SH "形式"
.LP
.LP
@ -33,40 +56,63 @@ unpack200 \- JAR
\f4unpack200\fP\f2 [ \fP\f2options\fP ] \f2input\-file\fP \f2JAR\-file\fP
.LP
.LP
オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.TP
.I input\-file
入力ファイルの名前。入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
.TP
.I JAR\-file
出力 JAR ファイル名。
.SH 機能説明
unpack200 ツールは pack200(1) で作成されたパックファイルを JAR ファイルに変換するネイティブ実装です。
.TP
一般的な使用方法:
オプションの指定順序に決まりはありません。コマンド行に指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
.LP
.RS
.ft 3
.nf
% unpack200 myarchive.pack.gz myarchive.jar
.fi
.ft 1
.RS 3
.LP
.RS 3
.TP 3
input\-file
入力ファイルの名前。 入力ファイルは通常、pack200 gzip ファイルか pack200 ファイルです。このほかに、0 を設定すれば pack200(1) から作成された JAR ファイルも入力ファイルとして使用できます。 この場合、入力ファイルの内容が Pack200 マーカーとともに出力 JAR ファイルにコピーされます。
.TP 3
JAR\-file
出力 JAR ファイル名。
.RE
.LP
この例では、デフォルトの unpack200 設定で、myarchive.pack.gz から myarchive.jar が作成されます。
.SH オプション
.LP
.SS
標準オプション
.TP
.B \-Hvalue \--deflate-hint=value
JAR ファイル内のすべてのエントリに true、false、keep としてデフレーションを設定します。デフォルトモードは keep です。true または false の場合、デフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
.LP
.RE
.SS
非標準オプション
.SH " 説明"
.LP
.LP
.LP
\f2unpack200\fP は、\f2pack200\fP(1) で作成されたパックファイルを JAR ファイルに変換するネイティブ実装です。一般的な使用方法:
.LP
.RS 3
.LP
.LP
\f2% unpack200 myarchive.pack.gz myarchive.jar\fP
.LP
.RE
.LP
この例では、デフォルトの \f2unpack200\fP 設定で、\f2myarchive.jar\fP から \f2myarchive.pack.gz\fP が作成されます。
.LP
.SH "オプション"
.LP
.SS
標準オプション
.LP
.RS 3
.LP
.LP
\f4\-Hvalue \-\-deflate\-hint=\fP\f2value\fP
.LP
.RS 3
.LP
.LP
JAR ファイル内のすべてのエントリに \f2true\fP、\f2false\fP、\f2keep\fP としてデフレーションを設定します。デフォルトモードは \f2keep\fP です。\f2true\fP または \f2false\fP の場合、デフォルトの動作をオーバーライドして、出力 JAR ファイル内のすべてのエントリのデフレーションモードを設定します。
.LP
.RE
.RE
.SS
非標準オプション
.LP
.RS 3
.LP
.LP
\f4\-r \-\-remove\-pack\-file\fP
@ -75,7 +121,7 @@ JAR
.LP
.LP
入力パックファイルを削除します。
入力パックファイルを削除します。
.LP
.RE
.LP
@ -85,7 +131,7 @@ JAR
.LP
.LP
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが出力されます。
.LP
.RE
.LP
@ -95,7 +141,7 @@ JAR
.LP
.LP
メッセージを表示せずに動作します。
メッセージを表示せずに動作します。
.LP
.RE
.LP
@ -105,51 +151,65 @@ JAR
.LP
.LP
メッセージを出力するログファイルを指定します。
出力メッセージのログファイルを指定します。
.LP
.RE
.SH 終了ステータス
次の終了値が返されます。
.TP
.B 0 " 成功"
.TP
.B >0 " エラー"
.SH 関連項目
.RE
.SH "終了ステータス"
.LP
.LP
.LP
次の終了値が返されます。
.LP
.RS 3
.LP
.LP
\f2\ 0\fP " 成功"
.LP
.LP
\f2>0\fP " エラー"
.LP
.RE
.SH "関連項目"
.LP
.RS 3
.TP 2
*
pack200 \- JAR パックツール
o
pack200(1)
.TP 2
*
\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP のマニュアルページ
o
.na
\f2Java SE のドキュメント\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
*
Java SE のドキュメント
.TP 2
*
o
.na
\f2「Java 配備ガイド \- Pack200」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
の
.na
「\f2Java Deployment Guide」 \- Pack200\fP
.TP 2
*
\f2jar\fP \- Java アーカイブツール
o
jar(1) \- Java Archive ツール」
.TP 2
*
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
の
.na
「\f2jarsigner\fP」 \- JAR 署名ツール
o
「jarsigner(1) \- JAR 署名および検証ツール」
.TP 2
o
\f2attributes(5)\fP のマニュアルページ
.RE
.LP
.SH 注意事項
このコマンドと unpack(1) コマンドを混同しないでください。これらは別製品です。
.SH "注意事項"
.LP
.LP
.LP
ドキュメント間に矛盾がある場合、SDK に付属する Java SE API 仕様が最優先されます。
このコマンドと \f2unpack(1)\fP を混同しないでください。これらは別製品です。
.LP
.LP
SDK に付属する Java SE API 仕様との相違が見つかった場合には、仕様を優先してください。
.LP

826
jdk/src/linux/doc/man/ja/wsgen.1
View File

@ -1,245 +1,663 @@
'\" t
.\"
.\" Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
.\" CA 95054 USA or visit www.sun.com if you need additional information or
.\" have any questions.
.\"
.\" `
.TH wsgen 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2man
.LP
.SH 名前
wsgen \- JAX\-WS 2.0 ベータ
.LP
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
." under the terms of the GNU General Public License version 2 only, as
." published by the Free Software Foundation.
."
." This code is distributed in the hope that it will be useful, but WITHOUT
." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
." version 2 for more details (a copy is included in the LICENSE file that
." accompanied this code).
."
." You should have received a copy of the GNU General Public License version
." 2 along with this work; if not, write to the Free Software Foundation,
." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
."
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
.TH wsgen 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.SH "名前"
wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.RS 3
.LP
.LP
\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、サービスエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
\f3仕様バージョン:\fP 2.1
.br
\f3実装バージョン:\fP 2.1.1
.LP
.LP
\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイント実装クラス (SEI) を読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。
.LP
.RE
.SH "形式"
.SH "概要"
.LP
\f2wsgen\fP ツールは、JAX\-WS Web サービスで使用される JAX\-WS ポータブルアーティファクトを生成します。このツールは、Web サービスのエンドポイントクラスを読み取り、Web サービスの配備と呼び出しに必要なすべてのアーティファクトを生成します。JAXWS 2.1.1 RI には wsgen Ant タスクも用意されています。詳細は、
.na
\f2Wsgen Ant タスク\fP @
.fi
https://jax\-ws.dev.java.net/nonav/2.1.1/docs/wsgenant.htmlを参照してください。
.LP
.SH "wsgen の起動"
.RS 3
.TP 2
o
\f3Solaris/Linux\fP
.RS 3
.TP 2
*
\f2export JAXWS_HOME=/pathto/jaxws\-ri\fP
.TP 2
*
\f2$JAXWS_HOME/bin/wsgen.sh \-help\fP
.RE
.TP 2
o
\f3Windows\fP
.RS 3
.TP 2
*
\f2set JAXWS_HOME=c:\\pathto\\jaxws\-ri\fP
.TP 2
*
\f2%JAXWS_HOME%\\bin\\wsgen.bat \-help\fP
.RE
.RE
.LP
.SH "構文"
.nf
\f3
.fl
wsgen [options] <SEI>
wsgen [options] <SEI>\fP
.br
\f3
.fl
\fP
.fi
.LP
.SH "オプション"
次の表に、\f2wsgen\fP のオプションを示します。
.br
.LP
.LP
次の表に、\f2wsgen\fP のオプションを示します。
.LP
.LP
表 1\-1 wsgen のオプション
.LP
.LP
.sp 1n
.TS
center;
cbp-1 cbp-1
li l .
オプション 詳細
_
-classpath <path> 入力クラスファイルの検索場所を指定します
-cp <path> T{
-classpath <path> と同じ
T}
-d <directory> 生成される出力ファイルを格納する場所を指定する
-extension T{
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
T}
-help T{
ヘルプを表示します
T}
-keep T{
生成されたファイルを保持します
T}
-r <directory> T{
常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
T}
-s <directory> T{
生成されるソースファイルを格納する場所を指定する
T}
-verbose T{
コンパイラが実行している処理に関するメッセージを出力します
T}
-version T{
バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
T}
-wsdl[:protocol] T{
wsgen はデフォルトでは WSDL ファイルを生成しません。このフラグは省略可能ですが、指定した場合は wsgen が WSDL ファイルを生成するようになります。このフラグは通常、エンドポイントの配備前に開発者が WSDL を参照できるようにするためだけに使用されます。protocol は省略可能であり、wsdl:binding で使用すべきプロトコルを指定するために使用されます。有効なプロトコルは次のとおりで す。 soap1.1 と Xsoap1.2。デフォルトは soap1.1 です。Xsoap1.2 は標準ではないた め、-extension オプションと組み合わせないと使用できません。
T}
-servicename <name> T{
常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:service の名前を指定するために使用します。例 : -servicename "{http://mynamespace/}MyService"
T}
-portname <name> T{
常に -wsdl オプションと組み合わせて使用します。WSDL 内で生成されるべき wsdl:port の名 前を指定するために使用します。例 : -portname "{http://mynamespace/}MyPort"
T}
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
.ps \n(.s
.vs \n(.vu
.in \n(.iu
.if \n(.u .fi
.if \n(.j .ad
.if \n(.j=0 .na
..
.nf
.nr #~ 0
.if n .nr #~ 0.6n
.ds #d .d
.if \(ts\n(.z\(ts\(ts .ds #d nl
.fc
.nr 33 \n(.s
.rm 80 81
.nr 34 \n(.lu
.eo
.am 81
.br
.di a+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
入力クラスファイルの検索場所を指定します
.br
.di
.nr a| \n(dn
.nr a- \n(dl
..
.ec \
.eo
.am 81
.br
.di b+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
\f2\-classpath <path>\fP と同じ
.br
.di
.nr b| \n(dn
.nr b- \n(dl
..
.ec \
.eo
.am 81
.br
.di c+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
生成される出力ファイルを格納する場所を指定する
.br
.di
.nr c| \n(dn
.nr c- \n(dl
..
.ec \
.eo
.am 81
.br
.di d+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可性があります
.br
.di
.nr d| \n(dn
.nr d- \n(dl
..
.ec \
.eo
.am 81
.br
.di e+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
ヘルプを表示します
.br
.di
.nr e| \n(dn
.nr e- \n(dl
..
.ec \
.eo
.am 81
.br
.di f+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
生成されたファイルを保持します
.br
.di
.nr f| \n(dn
.nr f- \n(dl
..
.ec \
.eo
.am 81
.br
.di g+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \-wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
.br
.di
.nr g| \n(dn
.nr g- \n(dl
..
.ec \
.eo
.am 81
.br
.di h+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
生成されるソースファイルを格納する場所を指定する
.br
.di
.nr h| \n(dn
.nr h- \n(dl
..
.ec \
.eo
.am 81
.br
.di i+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
コンパイラが実行している処理に関するメッセージを出力します
.br
.di
.nr i| \n(dn
.nr i- \n(dl
..
.ec \
.eo
.am 81
.br
.di j+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
バージョン情報を出力します。このオプションを使用した場合、バージョン情報が出力されるだけです。通常の処理は実行されません。
.br
.di
.nr j| \n(dn
.nr j- \n(dl
..
.ec \
.eo
.am 81
.br
.di k+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
\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 オプションと組み合わせないと使用できません。
.br
.di
.nr k| \n(dn
.nr k- \n(dl
..
.ec \
.eo
.am 81
.br
.di l+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:service\fP の名前を指定するために使用します。例 : \f2\-servicename "{http://mynamespace/}MyService"\fP
.br
.di
.nr l| \n(dn
.nr l- \n(dl
..
.ec \
.eo
.am 81
.br
.di m+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
常に \f2\-wsdl\fP オプションと組み合わせて使用します。WSDL 内で生成されるべき \f2wsdl:port\fP の名前を指定するために使用します。例 : \f2\-portname "{http://mynamespace/}MyPort"\fP
.br
.br
.di
.nr m| \n(dn
.nr m- \n(dl
..
.ec \
.35
.nf
.ll \n(34u
.nr 80 0
.nr 38 \w\f3オプション\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-classpath <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-cp <path>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-d <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-extension\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-help\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-keep\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-r <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-s <directory>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-verbose\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-version\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-wsdl[:protocol]\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-servicename <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \w\f4\-portname <name>\fP
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 81 0
.nr 38 \w\f3説明\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
.nr 38 \n(a-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(b-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(c-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(d-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(e-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(f-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(g-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(i-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(k-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(l-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(m-
.if \n(81<\n(38 .nr 81 \n(38
.35
.nf
.ll \n(34u
.nr 38 1n
.nr 79 0
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 144 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
.eo
.de T#
.ds #d .d
.if \(ts\n(.z\(ts\(ts .ds #d nl
.mk ##
.nr ## -1v
.ls 1
.ls
..
.ec
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f3オプション\fP\h'|\n(41u'\f3説明\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-classpath <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.a+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(b|u+\n(.Vu
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-cp <path>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.b+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(c|u+\n(.Vu
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-d <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.c+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(d|u+\n(.Vu
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-extension\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.d+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(e|u+\n(.Vu
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-help\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.e+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(f|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-keep\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.f+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(g|u+\n(.Vu
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-r <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.g+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(h|u+\n(.Vu
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-s <directory>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.h+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(i|u+\n(.Vu
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-verbose\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.i+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(j|u+\n(.Vu
.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-version\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.j+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(k|u+\n(.Vu
.if (\n(k|+\n(#^-1v)>\n(#- .nr #- +(\n(k|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-wsdl[:protocol]\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.k+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(l|u+\n(.Vu
.if (\n(l|+\n(#^-1v)>\n(#- .nr #- +(\n(l|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-servicename <name>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.l+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(m|u+\n(.Vu
.if (\n(m|+\n(#^-1v)>\n(#- .nr #- +(\n(m|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f4\-portname <name>\fP\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.m+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.fc
.nr T. 1
.T# 1
.35
.rm a+
.rm b+
.rm c+
.rm d+
.rm e+
.rm f+
.rm g+
.rm h+
.rm i+
.rm j+
.rm k+
.rm l+
.rm m+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-57
.LP
.SS
Ant タスク
.LP
.LP
\f2wsgen\fP ツールには、このツール用の Ant タスクが付属しています。この Ant タスクがサポートする属性や要素を、次に示します。
.LP
.SH "例"
.nf
\f3
.fl
\fP\f3wsgen \-d stock \-cp myclasspath stock.StockService\fP
.fl
<wsgen
.fl
sei="..."
.fl
destdir="directory for generated class files"
.fl
classpath="classpath" | cp="classpath"
.fl
resourcedestdir="directory for generated resource files such as WSDLs"
.fl
sourcedestdir="directory for generated source files"
.fl
keep="true|false"
.fl
verbose="true|false"
.fl
genwsdl="true|false"
.fl
protocol="soap1.1|Xsoap1.2"
.fl
servicename="..."
.fl
portname="...">
.fl
extension="true|false"
.fl
<classpath refid="..."/>
.fl
</wsgen>
.fl
\fP
.fi
.LP
.LP
.TS
center;
lbp-1 lbp-1 lbp-1
li l l
li l li .
属性 説明 コマンド行
_
sei サービスエンドポイント実装クラスの名前 SEI
destdir T{
生成される出力クラスを格納する場所を指定します
T} -d
classpath 入力クラスファイルの検索場所を指定します -classpath
cp -classpath と同じ -cp
resourcedestdir T{
常に -wsdl オプションと組み合わせて使用します。WSDL などの生成されたリソースファイルの格納場所を指定します
T} -r
sourcedestdir T{
生成されるソースファイルを格納する場所を指定します
T} -s
keep 生成されたファイルを保持します -keep
verbose T{
コンパイラが実行している処理に関するメッセージを出力します
T} -verbose
genwsdl T{
WSDL ファイルを生 成すべきかどうかを指定します
T} -wsdl
protocol T{
genwsdl と組み合わせて使用します。wsdl:binding で使用するプロトコルを指定します。有効な値は「soap1.1」と「Xsoap1.2」で、デフォルトは「soap1.1」です。「Xsoap1.2」は標準ではないため、-extensions オプションと組み合わせないと使用できません
T} -wsdl:soap11
servicename T{
genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:service の名前を指定するために使用します。例 : servicename="{http://mynamespace/}MyService"
T} -servicename
portname T{
genwsdl オプションと組み合わせて使用します。生成される WSDL の wsdl:portname の名前を指定するために使用します。例 : portname="{http://mynamespace/}MyPort"
T} -servicename
extension T{
ベンダー拡張 (仕様で規定されていない機能) を許可します。拡張を使用すると、アプリケーションの移植性が失われたり、ほかの実装との相互運用が行えなくなる可能性があります
T} -extension
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-68
.LP
.LP
\f2classpath\fP 属性は、
.na
\f2Path\-like Structure\fP
.fi
(http://ant.apache.org/manual/using.html#path) であり、入れ子になった \f2<classpath>\fP 要素を使って設定することもできます。このタスクを使用するには、次の \f2<taskdef>\fP 要素をプロジェクトに追加しておく必要があります。
.LP
\f3stock\fP ディレクトリ内に @WebService 注釈が付けられた、StockService に必要なラッパークラスが生成されます。
.nf
\f3
.fl
<taskdef name="wsgen" classname="com.sun.tools.ws.ant.WsGen">
\fP\f3wsgen \-wsdl \-d stock \-cp myclasspath stock.StockService\fP
.fl
<classpath path="jaxws.classpath"/>
.fl
</taskdef>
.fl
\fP
.fi
.LP
.LP
ここで、\f2jaxws.classpath\fP は、JAX\-WS ツールが必要とするクラスのリストを含む、ビルド環境内の別の場所に定義された
.na
\f2Path\-like Structure\fP
.fi
(http://ant.apache.org/manual/using.html#path) への参照です。
.LP
.SH "例"
.LP
.LP
SOAP 1.1 WSDL と、@WebService 注釈が付けられた Java クラス stock.StockService のスキーマが生成されます。
.nf
\f3
.fl
<wsgen
\fP\f3wsgen \-wsdl:Xsoap1.2 \-d stock \-cp myclasspath stock.StockService\fP
.fl
resourcedestdir="${wsdl.dir}"
.fl
sei="fromjava.server.AddNumbersImpl">
.fl
<classpath refid="compile.classpath"/>
.fl
</wsgen>
.fl
\fP
.fi
.LP
SOAP 1.2 WSDL が生成されます。
.LP
サービスを配備するときに JAXWS ランタイムによって自動的に WSDL が生成されるため、開発時に WSDL を生成する必要はありません。

1042
jdk/src/linux/doc/man/ja/wsimport.1
View File

File diff suppressed because it is too large Load Diff

240
jdk/src/linux/doc/man/ja/xjc.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,67 +18,42 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH xjc 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
." Generated by html2roff
."
.TH xjc 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.ad c
.SH 名前
XML バインドのための Java(TM) アーキテクチャ
.SH "名前"
xjc \- XML バインドのための Java(TM) アーキテクチャー
.br
バインドコンパイラ (xjc) \f3仕様のバージョン:\fP 2.0
バインディングコンパイラ
.LP
\f3仕様バージョン:\fP 2.1
.br
\f3リファレンス実装 (Reference Implementation、RI) のバージョン:\fP 2.0 ea3
.br
JAXB 2.0: リリースノート | XJC | XJCTask | SchemaGen | schemagenTask | サンプルアプリケーション | Changelog
.br
JAXB 1.0.x: リリースノート | Changelog
.br
JAXB RI 拡張: 実行時プロパティ | XJC カスタマイズ | プラグイン開発
.br
JAXB RI スキーマ言語: W3C XML スキーマ | RELAX NG | DTD
.br
JAXB コミュニティ:
.na
\f2Java.net ホームページ\fP @
.fi
http://jaxb.dev.java.net | Developer interest list | FAQ
.br
.ad l
\f3リファレンス実装 (RI) バージョン:\fP 2.1.3 .ad l
.LP
.SS
xjc の起動
.SH "xjc の起動"
.LP
.LP
バインディングコンパイラを起動するには、使用するプラットフォームに応じた \f2bin\fP ディレクトリ内の \f2xjc\fP シェルスクリプトを使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。xjc を Ant とともに使用するための手順を参照してください。
バインディングコンパイラを起動するには、使用するプラットフォームに応じた \f2bin\fP ディレクトリ内の \f2xjc\fP シェルスクリプトを使用します。また、バインディングコンパイラを実行するための Ant タスクも用意されています。
.na
\f2xjc を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.htmlための手順を参照してください。
.LP
.RS 3
.LP
\f3Solaris/Linux の場合\fP
.LP
.LP
.LP
\f2% /path/to/jaxb/bin/xjc.sh \-help\fP
.LP
\f3WindowsNT/2000/XP の場合\fP
.LP
.LP
.LP
\f2> c:\\path\\to\\jaxb\\bin\\xjc.bat \-help\fP
\f2% xjc \-help\fP
.LP
.RE
\f3出力\fP
.LP
.RS 3
.LP
\f3出力\fP
.LP
.LP
.nf
\f3
@ -95,7 +68,9 @@ Options:
.fl
Compatibility Rules and App E.2 from the JAXB Spec
.fl
\-b <file> : specify external bindings files (each <file> must have its own \-b)
\-b <file/dir> : specify external bindings files (each <file> must have its own \-b)
.fl
If a directory is given, **/*.xjb is searched
.fl
\-d <dir> : generated files will go into this directory
.fl
@ -114,6 +89,10 @@ Options:
\-readOnly : generated files will be in read\-only mode
.fl
\-npa : suppress generation of package level annotations (**/package\-info.java)
.fl
\-no\-header : suppress generation of a file header with timestamp
.fl
\-target 2.0 : behave like XJC 2.0 and generate code that doesnt use any 2.1 features.
.fl
\-xmlschema : treat input as W3C XML Schema (default)
.fl
@ -135,49 +114,23 @@ Options:
.fl
\fP
.fi
.LP
.RE
.RS 3
.LP
\f3jaxb\-xjc.jar JAR ファイルの実行\fP
.SH "オプション"
.LP
.LP
.LP
ほかの方法がすべて失敗した場合でも、\f2jaxb\-xjc.jar\fP ファイルの実行は行えるはずです。
.LP
.RS 3
.LP
.TP 3
Solaris/Linux の場合:
\f2% java \-jar $JAXB_HOME/lib/jaxb\-xjc.jar \-help\fP
.TP 3
Windows の場合:
\f2> java \-jar %JAXB_HOME%\\lib\\jaxb\-xjc.jar \-help\fP
.LP
.RE
.LP
これは「xjc.sh」や「xjc.bat」を実行するのと同じです。また、この場合、JVM パラメータを設定できます。
.LP
.RE
.SS
コマンド行オプションの概要
.LP
.LP
.TP 3
\-nv
デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。より厳密でない検証を実行するということです。
デフォルトでは、XJC バインディングコンパイラは、ソーススキーマを処理する前に厳密な検証を実行します。このオプションを使用すると、厳密なスキーマ検証を無効にします。これは、バインディングコンパイラが検証を一切実行しないということではありません。 より厳密でない検証を実行するということです。
.TP 3
\-extension
デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
デフォルトでは、XJC バインディングコンパイラは、JAXB 仕様の「Compatibility」の章で説明されている規則を厳密に強制します。付録 E.2 には、JAXB v1.0 で完全にはサポートされていない一連の W3C XML スキーマ機能が定義されています。 場合によっては、このスイッチで有効になる「\-extension」モードでそれらの機能が使用できるかもしれません。また、デフォルトの厳密なモードでは、仕様に定義されているバインディングカスタマイズのみが使用できます。「\-extension」スイッチを指定すれば、JAXB Vendor Extension を使用できます。
.TP 3
\-b <file>
処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに\f2「\-b」\fPスイッチを指定する必要があります。) 外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる
1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。次に例を示します。
処理する外部バインディングファイルを 1 つまたは複数指定します。(バインディングファイルごとに「\f2\-b\fP」スイッチを指定する必要があります。)外部バインディングファイルの構文は非常に柔軟です。複数のスキーマのカスタマイズが含まれる 1 つのバインディングファイルを使用したり、それらのカスタマイズを複数のバインディングファイルに分割したりできます。 次に例を示します。
.RS 3
.LP
@ -185,142 +138,151 @@ Windows
.br
\f2xjc schema1.xsd schema2.xsd schema3.xsd \-b bindings1.xjb \-b bindings2.xjb \-b bindings3.xjb\fP
.RE
また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
また、コマンド行にスキーマファイルとバインディングファイルを指定する順番は任意です。
.TP 3
\-d <dir>
デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
デフォルトでは、XJC バインディングコンパイラは、Java コンテンツクラスを現在のディレクトリに生成します。このオプションを使用すると、代替出力ディレクトリを指定できます。出力ディレクトリはあらかじめ存在している必要があります。 XJC バインディングコンパイラは、このディレクトリを自動的に作成しません。
.TP 3
\-p <pkg>
このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
このコマンド行オプション経由でターゲットパッケージを指定した場合、その指定内容は、パッケージ名に対するすべてのバインディングカスタマイズや、仕様で規定されているデフォルトのパッケージ名アルゴリズムよりも優先されます。
.TP 3
\-httpproxy <proxy>
HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
HTTP/HTTPS プロキシを指定します。形式は [user[:password]@]proxyHost[:proxyPort] です。従来の \f2\-host\fP および \f2\-port\fP は、下位互換性のためにリファレンス実装でもサポートされていますが、推奨されなくなりました。このオプションで指定されたパスワードは、\f2top\fP コマンドを使用するユーザーなど、ほかのユーザーが表示できる引数であることに注意してください。セキュリティーを高めるには、次の \f2\-httpproxyfile\fP を使用してください。
.TP 3
\-httpproxyfile <file>
HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
HTTP/HTTPS プロキシをファイル経由で指定します。形式は上記と同じですが、このファイル内に指定されたパスワードをほかのユーザーが表示することはできません。
.TP 3
\-classpath <arg>
\f2<jxb:javaType>\fP および \f2<xjc:superClass>\fP カスタマイズが使用するクライアントアプリケーションのクラスファイルの検索場所を指定します。
\f2<jxb:javaType>\fP および \f2<xjc:superClass>\fP カスタマイズが使用するクライアントアプリケーションのクラスファイルの検索場所を指定します。
.TP 3
\-catalog <file>
外部エンティティー参照を解決するカタログファイルを指定します。
TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。
詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、
カタログリゾルバのサンプルアプリケーションを調べてください。
外部エンティティー参照を解決するカタログファイルを指定します。TR9401、XCatalog、および OASIS XML Catalog 形式がサポートされます。詳細は、『XML Entity and URI Resolvers』ドキュメントを参照するか、\f2カタログリゾルバ\fPのサンプルアプリケーションを調べてください。
.TP 3
\-readOnly
デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
デフォルトでは、XJC バインディングコンパイラは、生成する Java ソースファイルを書き込みから保護しません。このオプションを使用すると、XJC バインディングコンパイラは生成される Java ソースを強制的に読み取り専用にします。
.TP 3
\-npa
パッケージレベルの注釈を
.B **/package-info.java
に生成することを抑制します。
このスイッチを使用して生成するコードでは、これらの注釈が
ほかの生成済みクラスに内部化されます。
パッケージレベルの注釈を **/package\-info.java に生成することを抑制します。このスイッチを使用して生成するコードでは、これらの注釈がほかの生成済みクラスに内部化されます。
.TP 3
\-no\-header
多少のメモとタイムスタンプを含むファイルヘッダーコメントの生成を抑制します。このオプションを使用すると、生成されたコードがわかりにくくなります。
.TP 3
\-target 2.0
なんらかの JAXB 2.1 機能に依存するコードを生成しないようにします。これにより、生成されたコードを JAXB 2.0 ランタイム (JavaSE 6 など) で実行できます。
.TP 3
\-xmlschema
入力スキーマを W3C XML スキーマ (デフォルト) と見なします。
このスイッチを指定しなくても、入力スキーマは
W3C XML スキーマと見なされます。
入力スキーマを W3C XML スキーマ (デフォルト) と見なします。このスイッチを指定しなくても、入力スキーマは W3C XML スキーマと見なされます。
.TP 3
\-relaxng
入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
入力スキーマを RELAX NG として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-relaxng\-compact
入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
入力スキーマを RELAX NG 圧縮構文として処理します (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-dtd
入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
入力スキーマを XML DTD として扱います (試験的、未サポート)。RELAX NG スキーマのサポートは JAXB Vendor Extension として提供されています。
.TP 3
\-wsdl
入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
入力を WSDL として扱い、その内部のスキーマをコンパイルします (試験的、未サポート)。
.TP 3
\-quiet
進捗や警告など、コンパイラの出力を抑制します。
進捗情報や警告など、コンパイラの出力を抑制します。
.TP 3
\-verbose
情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
情報メッセージを出力したり特定のエラー発生時にスタックトレースを表示したりするなど、極めて冗長になります。
.TP 3
\-help
コンパイラスイッチの概要を表示します。
コンパイラスイッチの概要を表示します。
.TP 3
\-version
コンパイラのバージョン情報を表示します。
コンパイラのバージョン情報を表示します。
.TP 3
<schema file/URL/dir>
コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
コンパイル対象となる 1 つまたは複数のスキーマファイルを指定します。ユーザーがディレクトリを指定した場合、xjc はそのディレクトリを走査し、そこで見つかったすべてのスキーマファイルをコンパイルします。
.RE
.SS
非推奨コマンド行オプションおよび削除されたコマンド行オプションの概要
非推奨コマンド行オプションおよび削除されたコマンド行オプションの概要
.LP
.RS 3
.LP
.RS 3
.TP 3
\-host & \-port
これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
これらのオプションは非推奨となり、\f3\-httpproxy\fP オプションで置き換えられました。これらのオプションは、下位互換性を確保する目的で引き続きサポートされますが、ドキュメントには記載されず、将来のリリースで削除される可能性もあります。
.TP 3
\-use\-runtime
JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
JAXB 2.0 仕様で移植性のあるランタイムが規定されたため、JAXB RI が **/impl/runtime パッケージを生成する必要がなくなりました。このため、このスイッチは不要となり、削除されました。
.TP 3
\-source
\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。我々は、JAXB 2.0 の今後のリリースからこのスイッチを削除することにしました。1.0.x コードを生成する必要がある場合には、1.0.x コードベースのインストールを使用してください。
\-source 互換性スイッチは、JAXB 2.0 の最初の Early Access 版で導入されました。このスイッチは、JAXB 2.0 の今後のリリースから削除されることになりました。1.0.x コードを生成する必要がある場合には、1.0.x コードベースのインストールを使用してください。
.TP 3
\-Xlocator & \-Xsync\-methods
これらのスイッチは現時点では無効化されています。この機能は将来、個別のダウンロードとして提供される予定です。
これらのスイッチは現時点では無効化されています。この機能は将来、個別のダウンロードとして提供される予定です。
.RE
.LP
.RE
.SS
コンパイラの制限
コンパイラの制限
.LP
.LP
通常は、関連するスキーマは、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
通常は、関連するすべてのスキーマを、同じバインディングコンパイラスイッチを指定して 1 つの単位としてコンパイルするのがもっとも安全です。
.LP
.LP
.B xjc
を実行するときは、次に示す制限に注意してください。
これらの制限のほとんどは、
.B xjc
を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
xjc を実行するときは、次に示す制限に注意してください。これらの制限のほとんどは、xjc を何度か呼び出して複数のスキーマをコンパイルする場合にのみ適用されます。
.LP
.RS 3
.TP 2
*
複数のスキーマを同時にコンパイルする場合は、
ターゲットの Java パッケージ名に次の優先順位の規則が
適用されることに注意してください。
o
複数のスキーマを同時にコンパイルする場合は、ターゲットの Java パッケージ名に次の優先順位の規則が適用されることに注意してください。
.RS 3
.TP 3
1.
「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
「\f2\-p\fP」コマンド行オプションがもっとも優先されます。
.TP 3
2.
<\f2jaxb:package\fP> のカスタマイズ
<\f2jaxb:package\fP> のカスタマイズ
.TP 3
3.
\f2targetNamespace\fP が宣言されている場合は、仕様に定義されている \f2targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
\f2targetNamespace\fP が宣言されている場合は、仕様に定義されている \f2targetNamespace\fP \-> Java パッケージ名のアルゴリズムを適用します。
.TP 3
4.
\f2targetNamespace\fP が宣言されていない場合は、"generated" という名前のハードコードされたパッケージを使用します。
\f2targetNamespace\fP が宣言されていない場合は、"generated" という名前のハードコードされたパッケージを使用します。
.RE
.TP 2
*
名前空間ごとに複数の
.B <jaxb:schemaBindings>
を持つことは不正です。このため、1 つのターゲット名前空間内の
2 つのスキーマを、異なる Java パッケージにコンパイルすることはできません。
o
名前空間ごとに複数の <\f2jaxb:schemaBindings\fP> を持つことは不正です。 このため、1 つのターゲット名前空間内の 2 つのスキーマを、異なる Java パッケージにコンパイルすることはできません。
.TP 2
*
1 つの Java パッケージにコンパイルされるすべてのスキーマは、
XJC バインディングコンパイラに同時に送信する必要があります。
個別にコンパイルすることはできず、 予期したとおりに動作しません。
o
1 つの Java パッケージにコンパイルされるすべてのスキーマは、XJC バインディングコンパイラに同時に送信する必要があります。 個別にコンパイルすることはできず、予期したとおりに動作しません。
.TP 2
*
複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
o
複数のスキーマファイルにまたがる要素置換グループは、同時にコンパイルする必要があります。
.RE
.LP
.SH "関連項目"
.LP
$Revision: 1.4 $
.br
$Date: 2005/10/27 18:53:02 $
.RS 3
.TP 2
o
コマンド行でのコンバータの実行 (XJC):[
.na
\f2コマンド行の命令\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjc.html、
.na
\f2xjc を Ant とともに使用する\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/xjcTask.html]
.TP 2
o
.na
\f2XML バインドのための JavaTM アーキテクチャー (JAXB)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
.LP

61
jdk/src/linux/doc/man/jar.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,15 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jar 1 "05 Aug 2006"
." Generated by html2roff
.\\" Created by: Susan Keohan 30\-Oct\-1996
.\\" Updated by: Beth Stearns 18\-Nov\-1996
.\\" Updated by: Marianne Mueller 11\-Dec\-1996
.\\" Updated by: Douglas Kramer 01\-Jul\-2003
.TH jar 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jar\-The Java Archive Tool
.LP
\f3jar\fP combines multiple files into a single JAR archive file.
@ -37,6 +31,7 @@ jar\-The Java Archive Tool
.LP
.LP
.RS 3
.TP 3
Create jar file
\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
@ -52,6 +47,8 @@ List table of contents of jar file
.TP 3
Add index to jar file
\f4jar i\fP \f2jarfile\fP \f2[\-J\fP\f2option\fP\f2]\fP
.RE
.LP
.LP
where:
@ -59,21 +56,20 @@ where:
.RS 3
.LP
.RS 3
.TP 3
cuxtiv0Mmfe
Options that control the \f2jar\fP command.
.TP 3
jarfile
jarfile
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).
.TP 3
inputfiles
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.
.TP 3
manifest
manifest
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.
.TP 3
entrypoint
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.
.TP 3
@ -82,6 +78,8 @@ Temporarily changes directories to \f2dir\fP while processing the following \f2i
.TP 3
\-Joption
Option to be passed into the Java runtime environment. (There must be no space between \f2\-J\fP and \f2option\fP).
.RE
.LP
.RE
.SH "DESCRIPTION"
@ -92,11 +90,7 @@ The \f3jar\fP tool combines multiple files into a single JAR archive file. \f3ja
.na
\f2ZLIB\fP @
.fi
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
.na
\f2class path\fP @
.fi
http://ccc.sfbay/4291383/attachment/classpath.html entry, whether or not it is compressed.
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.
.LP
Typical usage to combine files into a jar file is:
.LP
@ -117,7 +111,7 @@ In this example, all the class files in the current directory are placed into th
.na
\f2JAR file specification\fP @
.fi
http://ccc.sfbay/guide/jar/jar.html#JAR%20Manifest for details explaining how the jar tool stores meta\-information in the manifest file.
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.
.LP
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:
.LP
@ -193,7 +187,7 @@ Beginning with version 1.3 of the Java 2 SDK, the \f2jar\fP utility supports
.na
\f2JarIndex\fP @
.fi
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.
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.
.LP
.RS 3
@ -241,6 +235,7 @@ http://java.sun.com/docs/books/tutorial/jar.
.LP
.LP
.RS 3
.TP 3
c
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.
@ -326,6 +321,7 @@ You can add special\-purpose \f2name\ :\ value\fP attribute pairs to the manifes
\f2JAR Files\fP @
.fi
http://java.sun.com/docs/books/tutorial/jar/ trail in the Java Tutorial for examples of using the \f4\-m\fP option.
.LP
.TP 3
e
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.
@ -434,11 +430,9 @@ xyz.class
.LP
.TP 3
\-Joption
Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of the options described on the reference page for the
.na
\f2java application launcher\fP @
.fi
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.
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.
.RE
.LP
.SH "COMMAND LINE ARGUMENT FILES"
.LP
@ -446,7 +440,7 @@ http://ccc.sfbay/4291383/attachment/java.html#options. For example, \f4\-J\-Xmx4
.LP
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.
.LP
An argument file can include options and filenames. The arguments within a file can be space&ndash;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.
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.
.LP
.LP
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.
@ -676,21 +670,21 @@ An \f2INDEX.LIST\fP file is inserted to the \f2META\-INF\fP directory. This enab
.na
\f2The Jar Overview\fP @
.fi
http://ccc.sfbay/guide/jar/jarGuide.html
http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
.br
.LP
.na
\f2The Jar File Specification\fP @
.fi
http://ccc.sfbay/guide/jar/jar.html
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
.br
.LP
.na
\f2The JarIndex Spec\fP @
.fi
http://ccc.sfbay/guide/jar/jar.html#JAR%20Index
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
.br
.LP
@ -701,9 +695,6 @@ http://java.sun.com/docs/books/tutorial/jar on the Java Software web site.
.br
.LP
.na
\f2pack200 Reference Page\fP @
.fi
http://ccc.sfbay/4291383/share/pack200.html
pack200(1)
.LP

1831
jdk/src/linux/doc/man/jarsigner.1
View File

File diff suppressed because it is too large Load Diff

90
jdk/src/linux/doc/man/java.1
View File

@ -1,5 +1,4 @@
.'" t
." ." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -19,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH java 1 "07 Aug 2006"
." Generated by html2man
."
.TH java 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
java \- the Java application launcher
.LP
.SH "SYNOPSIS"
@ -105,13 +103,21 @@ The launcher has a set of standard options that are supported on the current run
.LP
Select the Java HotSpot Client VM. A 64\-bit capable jdk currently ignores this option and instead uses the Java Hotspot Server VM.
.LP
For default VM selection, see Server\-Class Machine Detection
For default VM selection, see
.na
\f2Server\-Class Machine Detection\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
.TP 3
\-server
.LP
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.
.LP
For default VM selection, see Server\-Class Machine Detection
For default VM selection, see
.na
\f2Server\-Class Machine Detection\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/vm/server\-class.html
.TP 3
\-agentlib:libname[=options]
Load native agent library \f2libname\fP, e.g.
@ -122,10 +128,18 @@ Load native agent library \f2libname\fP, e.g.
.LP
\-agentlib:hprof=help
.LP
For more information, see JVMTI Agent Command Line Options.
For more information, see
.na
\f2JVMTI Agent Command Line Options\fP @
.fi
http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
.TP 3
\-agentpath:pathname[=options]
Load a native agent library by full pathname. For more information, see JVMTI Agent Command Line Options.
Load a native agent library by full pathname. For more information, see
.na
\f2JVMTI Agent Command Line Options\fP @
.fi
http://java.sun.com/javase/6/docs/platform/jvmti/jvmti.html#starting.
.TP 3
\-classpath classpath
.TP 3
@ -139,7 +153,11 @@ As a special convenience, a class path element containing a basename of \f2*\fP
.br
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.
.LP
For more information on class paths, see Setting the Class Path.
For more information on class paths, see
.na
\f2Setting the Class Path\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath.
.TP 3
\-Dproperty=value
Set a system property value.
@ -201,7 +219,7 @@ Disables asserts in all system classes.
.LP
.TP 3
\-jar
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
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
.na
\f2Java Tutorial\fP @
.fi
@ -209,10 +227,18 @@ http://java.sun.com/docs/books/tutorial/jar for information about working with J
.LP
When you use this option, the JAR file is the source of all user classes, and other user class path settings are ignored.
.LP
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.
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
.na
\f2Java Archive (JAR) Files\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/index.html.
.TP 3
\-javaagent:jarpath[=options]
Load a Java programming language agent, see java.lang.instrument.
Load a Java programming language agent, see
.na
\f2java.lang.instrument\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/lang/instrument/package\-summary.html.
.TP 3
\-verbose
.TP 3
@ -235,11 +261,11 @@ Specifies that the version specified by \f2release\fP is required by the class o
.nf
\f3
.fl
\-version:"1.5.0_04 1.5*&1.5.1_02+"
\-version:"1.6.0_13 1.6*&1.6.0_10+"
.fl
\fP
.fi
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).
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).
.LP
For jar files, the usual preference is to specify version requirements in the jar file manifest rather than on the command line.
.LP
@ -345,7 +371,7 @@ Examples:
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.
.TP 3
\-Xprof
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.
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.
.LP
.TP 3
\-Xrs
@ -393,19 +419,19 @@ Any version greater than an arbitrarily precise version\-id. For example:
.nf
\f3
.fl
"1.5.0_03+"
"1.6.0_10+"
.fl
\fP
.fi
.LP
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.
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.
.TP 3
3.
A version greater than an arbitrarily precise version\-id, bounded by the upper bound of that release family. For example:
.nf
\f3
.fl
"1.5.0_03+&1.5*"
"1.6.0_10+&1.6*"
.fl
\fP
.fi
@ -415,11 +441,11 @@ A version greater than an arbitrarily precise version\-id, bounded by the upper
.nf
\f3
.fl
"1.4.2_05+&1.4* 1.5+"
"1.6.0_10+&1.6* 1.7+"
.fl
\fP
.fi
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.
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.
.RE
.LP
@ -430,22 +456,28 @@ Similar to item 2. this is useful when a change was introduced in a release (1.5
.RS 3
.TP 2
o
javac \- the Java programming language compiler
javac(1)
.TP 2
o
jdb \- Java Application Debugger
jdb(1)
.TP 2
o
javah \- C Header and Stub File Generator
javah(1)
.TP 2
o
jar \- JAR Archive Tool
jar(1)
.TP 2
o
The Java Extensions Framework
.na
\f2The Java Extensions Framework\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html
.TP 2
o
Security Features.
.na
\f2Security Features\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/index.html.
.TP 2
o
.na

337
jdk/src/linux/doc/man/javac.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH javac 1 "07 Aug 2006"
." Generated by html2man
."
.TH javac 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
javac \- Java programming language compiler
.LP
.SH "SYNOPSIS"
@ -36,7 +33,9 @@ javac \- Java programming language compiler
.nf
\f3
.fl
\fP\f3javac\fP [ options ] [ sourcefiles ] [ @argfiles ]
\fP\f3javac\fP [ options ] [ sourcefiles ] [ classes ] [ @argfiles ]
.fl
.fl
.fi
@ -55,6 +54,9 @@ Command\-line options.
sourcefiles
One or more source files to be compiled (such as MyClass.java).
.TP 3
classes
One or more classes to be processed for annotations (such as MyPackage.MyClass).
.TP 3
@argfiles
One or more files that lists options and source files. The \f2\-J\fP options are not allowed in these files.
.RE
@ -66,10 +68,10 @@ One or more files that lists options and source files. The \f2\-J\fP options are
.LP
.LP
The \f3javac\fP tool reads class and interface definitions, written in the Java programming language, and compiles them into bytecode class files.
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.
.LP
.LP
There are two ways to pass source code filenames to \f3javac\fP:
There are two ways to pass source code file names to \f3javac\fP:
.LP
.RS 3
.TP 2
@ -93,46 +95,6 @@ You should arrange source files in a directory tree that reflects their package
.LP
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).
.LP
.SH "SEARCHING FOR TYPES"
.LP
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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).
.LP
.LP
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.
.LP
.LP
You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
.LP
.LP
A successful type search may produce a class file, a source file, or both. Here is how \f3javac\fP handles each situation:
.LP
.RS 3
.TP 2
o
\f2Search produces a class file but no source file:\fP \f3javac\fP uses the class file.
.TP 2
o
\f2Search produces a source file but no class file:\fP \f3javac\fP compiles the source file and uses the resulting class file.
.TP 2
o
\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.
.LP
\f3javac\fP considers a class file out of date only if it is older than the source file.
.RE
.LP
.LP
\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.
.LP
.SH "OPTIONS"
.LP
@ -148,15 +110,24 @@ Standard Options
.LP
.RS 3
.TP 3
\-classpath classpath
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.
\-Akey[=value]
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 ".".
.TP 3
\-cp path or \-classpath path
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
.na
\f2Setting the Class Path\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath for more details.
.LP
If the \f3\-sourcepath\fP option is not specified, the user class path is searched for both source files and class files.
If the \f3\-sourcepath\fP option is not specified, the user class path is also searched for source files.
.LP
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).
If the \f3\-processorpath\fP option is not specified, the classpath is also searched for annotation processors.
.LP
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.
.br
.br
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.
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.
.TP 3
\-Djava.ext.dirs=directories
Override the location of installed extensions.
@ -165,17 +136,17 @@ Override the location of installed extensions.
Override the location of endorsed standards path.
.TP 3
\-d directory
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.
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.
.LP
If \f3\-d\fP is not specified, \f3javac\fP puts the class file in the same directory as the source file.
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.
.LP
\f3Note:\fP \ The directory specified by \f3\-d\fP is not automatically added to your user class path.
.TP 3
\-deprecation
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.
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.
.TP 3
\-encoding encoding
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.
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.
.TP 3
\-g
Generate all debugging information, including local variables. By default, only line number and source file information is generated.
@ -200,9 +171,23 @@ Local variable debugging information
\-help
Print a synopsis of standard options.
.TP 3
\-implicit:{class,none}
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.
.TP 3
\-nowarn
Disable warning messages. This has the same meaning as \f3\-Xlint:none\fP.
.LP
.TP 3
\-proc: {none,only}
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.
.TP 3
\-processor class1[,class2,class3...]
Names of the annotation processors to run. This bypasses the default discovery process.
.TP 3
\-processorpath path
Specify where to find annotation processors; if this option is not used, the classpath will be searched for processors.
.TP 3
\-s dir
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.
.TP 3
\-source release
Specifies the version of source code accepted. The following values for \f2release\fP are allowed:
@ -215,20 +200,34 @@ The compiler does \f2not\fP support assertions, generics, or other language feat
The compiler accepts code containing assertions, which were introduced in JDK 1.4.
.TP 3
1.5
The compiler accepts code containing generics and other language features introduced in JDK 5. This is the default.
The compiler accepts code containing generics and other language features introduced in JDK 5.
.TP 3
5
Synonym for 1.5
Synonym for 1.5.
.TP 3
1.6
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.
.TP 3
6
Synonym for 1.6.
.TP 3
1.7
The compiler accepts code with features introduced in JDK 7.
.TP 3
7
Synonym for 1.7.
.RE
\f3Note:\fP No language changes were introduced in JDK 6, so the values \f31.6\fP and \f36\fP are not valid.
.TP 3
\-sourcepath sourcepath
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.
.LP
\f3Note:\fP \ Classes found through the classpath are subject to automatic recompilation if their sources are found.
\f3Note:\fP \ Classes found through the classpath may be subject to automatic recompilation if their sources are also found. See Searching For Types.
.TP 3
\-verbose
Verbose output. This includes information about each class loaded and each source file compiled.
Verbose output. This includes information about each class loaded and each source file compiled.
.TP 3
\-version
Print version information.
.TP 3
\-X
Display information about non\-standard options and exit.
@ -248,7 +247,7 @@ By default, classes are compiled against the bootstrap and extension classes of
.RS 3
.TP 3
\-target version
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).
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).
.LP
The default for \f3\-target\fP depends on the value of \f3\-source\fP:
.RS 3
@ -257,7 +256,10 @@ o
If \-source is \f3not specified\fP, the value of \-target is \f31.6\fP
.TP 2
o
If \-source is \f31.3\fP, the value of \-target is \f31.1\fP
If \-source is \f31.2\fP, the value of \-target is \f31.4\fP
.TP 2
o
If \-source is \f31.3\fP, the value of \-target is \f31.4\fP
.TP 2
o
For \f3all other values\fP of \-source, the value of \-target is the value of \f3\-source\fP.
@ -295,8 +297,8 @@ Enable all recommended warnings. In this release, all available warnings are rec
\-Xlint:none
Disable all warnings not mandated by the Java Language Specification.
.TP 3
\-Xlint:\-xxx
Disable warning \f3xxx\fP, where \f3xxx\fP is one of the warning names supported for \f3\-Xlint:xxx\fP, below
\-Xlint:\-name
Disable warning \f2name\fP, where \f2name\fP is one of the warning names supported for \f3\-Xlint:\fP\f2name\fP, below.
.TP 3
\-Xlint:unchecked
Give more detail for unchecked conversion warnings that are mandated by the Java Language Specification.
@ -311,7 +313,7 @@ Warn about missing \f2serialVersionUID\fP definitions on serializable classes.
Warn about \f2finally\fP clauses that cannot complete normally.
.TP 3
\-Xlint:fallthrough
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:
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:
.RS 3
.LP
@ -331,13 +333,15 @@ case 2:
System.out.println("2");
.fl
}
.fl
.fl
\fP
.fi
.RE
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.
.TP 3
\-Xmaxerrors number
\-Xmaxerrs number
Set the maximum number of errors to print.
.TP 3
\-Xmaxwarns number
@ -345,6 +349,18 @@ Set the maximum number of warnings to print.
.TP 3
\-Xstdout filename
Send compiler messages to the named file. By default, compiler messages go to \f2System.err\fP.
.TP 3
\-Xprefer:{newer,source}
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.
.TP 3
\-Xprint
Print out textual representation of specified types for debugging purposes; perform neither annotation processing nor compilation. The format of the output may change.
.TP 3
\-XprintProcessorInfo
Print information about which annotations a processor is asked to process.
.TP 3
\-XprintRounds
Print information about initial and subsequent annotation processing rounds.
.RE
.LP
@ -390,7 +406,9 @@ You could use a single argument file named "\f2argfile\fP" to hold all javac arg
.nf
\f3
.fl
C:> \fP\f3javac @argfile\fP
% \fP\f3javac @argfile\fP
.fl
.fl
.fi
@ -414,7 +432,9 @@ Create a file named "\f2options\fP" containing:
.fl
\-g
.fl
\-sourcepath \\java\\pubs\\ws\\1.3\\src\\share\\classes
\-sourcepath /java/pubs/ws/1.3/src/share/classes
.fl
.fl
\fP
.fi
@ -432,18 +452,22 @@ Create a file named "\f2classes\fP" containing:
.fl
MyClass3.java
.fl
.fl
\fP
.fi
.LP
.LP
You would then run javac with:
You would then run \f3javac\fP with:
.LP
.nf
\f3
.fl
% \fP\f3javac @options @classes\fP
.fl
.fl
.fi
.LP
@ -458,11 +482,119 @@ The argument files can have paths, but any filenames inside the files are relati
.fl
% \fP\f3javac @path1/options @path2/classes\fP
.fl
.fl
.fi
.LP
.SH "ANNOTATION PROCESSING"
.LP
.LP
.LP
\f3javac\fP provides direct support for annotation processing, superseding the need for the separate annotation processing tool, \f3apt\fP.
.LP
.LP
The API for annotation processors is defined in the \f2javax.annotation.processing\fP and \f2javax.lang.model\fP packages and subpackages.
.LP
.SS
Overview of annotation processing
.LP
.LP
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
.br
\f2\ META\-INF/services/javax.annotation.processing.Processor\fP
.br
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.
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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.
.LP
.SS
Implicitly loaded source files
.LP
.LP
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.
.LP
.SH "SEARCHING FOR TYPES"
.LP
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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
.na
\f2Setting the Class Path\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath).
.LP
.LP
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.
.LP
.LP
You can specify different bootstrap or extension classes with the \f3\-bootclasspath\fP and \f3\-extdirs\fP options; see Cross\-Compilation Options below.
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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.
.LP
.SH "PROGRAMMATIC INTERFACE"
.LP
.LP
.LP
\f3javac\fP supports the new Java Compiler API defined by the classes and interfaces in the \f2javax.tools\fP package.
.LP
.SS
Example
.LP
.LP
To perform a compilation using arguments as you would give on the command line, you can use the following:
.LP
.nf
\f3
.fl
JavaCompiler javac = ToolProvider.getSystemJavaCompiler();
.fl
int rc = javac.run(null, null, null, args);
.fl
.fl
\fP
.fi
.LP
.LP
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.
.LP
.LP
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.
.LP
.SS
Old Interface
.LP
.RS 3
.LP
.LP
\f3Note:\fP \ This API is retained for backwards compatibility only; all new code should use the Java Compiler API, described above.
.LP
.LP
The \f2com.sun.tools.javac.Main\fP class provides two static methods to invoke the compiler from a program:
.LP
@ -472,6 +604,8 @@ The \f2com.sun.tools.javac.Main\fP class provides two static methods to invoke t
public static int compile(String[] args);
.fl
public static int compile(String[] args, PrintWriter out);
.fl
.fl
\fP
.fi
@ -484,11 +618,12 @@ The \f2args\fP parameter represents any of the command line arguments that would
The \f2out\fP parameter indicates where the compiler's diagnostic output is directed.
.LP
.LP
The return value is equivalent to the exit value from javac.
The return value is equivalent to the exit value from \f3javac\fP.
.LP
.LP
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.
.LP
.RE
.SH "EXAMPLES"
.LP
.SS
@ -547,6 +682,8 @@ Hello World
Hello Universe
.fl
Hello Everyone
.fl
.fl
.fi
.RE
@ -585,6 +722,8 @@ Aloha.class GutenTag.class Hello.class Hi.class
Aloha.java GutenTag.java Hello.java Hi.java
.fl
.fl
.fl
.fi
.RE
@ -611,6 +750,8 @@ Having changed one of the source files in the previous example, we recompile it:
/examples
.fl
% \f3javac greetings/Hi.java\fP
.fl
.fl
.fi
.RE
@ -626,6 +767,8 @@ Since \f2greetings.Hi\fP refers to other classes in the \f2greetings\fP package,
\f3
.fl
% \fP\f3javac \-classpath /examples /examples/greetings/Hi.java\fP
.fl
.fl
.fi
.RE
@ -640,9 +783,11 @@ If we change \f2greetings.Hi\fP again, to use a banner utility, that utility als
.nf
\f3
.fl
% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
% \fP\f3javac \-classpath /examples:/lib/Banners.jar \\
.fl
/examples/greetings/Hi.java\fP
/examples/greetings/Hi.java\fP
.fl
.fl
.fi
.RE
@ -658,6 +803,8 @@ To execute a class in \f2greetings\fP, we need access both to \f2greetings\fP an
\f3
.fl
% \fP\f3java \-classpath /examples:/lib/Banners.jar greetings.Hi\fP
.fl
.fl
.fi
.RE
@ -697,9 +844,9 @@ Banners.jar
.fl
% \f3ls classes\fP
.fl
% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
% \f3javac \-sourcepath src \-classpath classes:lib/Banners.jar \\
.fl
src/farewells/GoodBye.java \-d classes\fP
src/farewells/GoodBye.java \-d classes\fP
.fl
% \f3ls classes\fP
.fl
@ -710,6 +857,8 @@ farewells/
Base.class GoodBye.class
.fl
.fl
.fl
.fi
.RE
@ -726,7 +875,7 @@ Cross\-Compilation Example
.LP
.LP
Here we use \f3javac\fP to compile code that will run on a 1.4 VM.
Here we use \f3javac\fP to compile code that will run on a 1.7 VM.
.LP
.RS 3
@ -734,19 +883,21 @@ Here we use \f3javac\fP to compile code that will run on a 1.4 VM.
.nf
\f3
.fl
% \fP\f3javac \-target 1.4 \-bootclasspath jdk1.4.2/lib/classes.zip \\
% \fP\f3javac \-target 1.7 \-bootclasspath jdk1.7.0/lib/rt.jar \\
.fl
\-extdirs "" OldCode.java\fP
\-extdirs "" OldCode.java\fP
.fl
.fl
.fi
.RE
.LP
.LP
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.
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.
.LP
.LP
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.
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.
.LP
.RE
.SH "SEE ALSO"
@ -756,22 +907,28 @@ The Java Platform JDK's \f3javac\fP would also by default compile against its ow
.RS 3
.TP 2
o
java \- the Java Application Launcher
.na
\f2The javac Guide\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javac/index.html
.TP 2
o
jdb \- Java Application Debugger
java(1) \- the Java Application Launcher
.TP 2
o
javah \- C Header and Stub File Generator
jdb(1) \- Java Application Debugger
.TP 2
o
javap \- Class File Disassembler
javah(1) \- C Header and Stub File Generator
.TP 2
o
javadoc \- API Documentation Generator
javap(1) \- Class File Disassembler
.TP 2
o
jar \- JAR Archive Tool
javadoc(1) \- API Documentation Generator
.TP 2
o
jar(1) \- JAR Archive Tool
.TP 2
o
.na

397
jdk/src/linux/doc/man/javadoc.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,10 +19,9 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH javadoc 1 "07 Aug 2006"
." Generated by html2man
.SH NAME
.TH javadoc 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.SH "Name"
javadoc \- The Java API Documentation Generator
.RS 3
@ -153,7 +150,11 @@ http://java.sun.com/docs/books/jls/second_edition/html/names.doc.html#36154 (sec
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.
.LP
.LP
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.
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
.na
\f2How Classes Are Found\fP @
.fi
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.
.LP
.SS
Javadoc Doclets
@ -164,7 +165,10 @@ You can customize the content and format of the Javadoc tool's output by using d
.RS 3
.TP 2
o
Javadoc Doclets
.na
\f2Javadoc Doclets\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html
.TP 2
o
The \f2\-doclet\fP command\-line option
@ -180,7 +184,10 @@ Related Documentation and Doclets
.RS 3
.TP 2
o
Javadoc Enhancements for details about improvements added in Javadoc.
.na
\f2Javadoc Enhancements\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/index.html for details about improvements added in Javadoc.
.TP 2
o
.na
@ -198,7 +205,7 @@ o
.na
\f2Requirements for Writing API Specifications\fP @
.fi
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.
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.
.TP 2
o
.na
@ -284,7 +291,7 @@ To create a package comment file, you have a choice of two files to place your c
.RS 3
.TP 2
o
\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.
\f2package\-info.java\fP \- Can contain a package declaration, package annotations, package comments and Javadoc tags. This file is generally preferred over package.html.
.TP 2
o
\f2package.html\fP \- Can contain only package comments and Javadoc tags, no package annotations.
@ -295,7 +302,7 @@ o
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.
.LP
.LP
\f4package\-info.java\fP This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
\f4package\-info.java\fP \- This file can contain a package comment of the following structure \-\- the comment is placed before the package declaration:
.LP
.LP
File: \f2java/applet/package\-info.java\fP
@ -388,7 +395,7 @@ package java.lang.applet;
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 326 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 353 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -522,7 +529,7 @@ initialize, start, and stop the applet.
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 379 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 406 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -580,10 +587,18 @@ o
Processes any package tags that are present.
.TP 2
o
Inserts the processed text at the bottom of the package summary page it generates, as shown in Package Summary.
Inserts the processed text at the bottom of the package summary page it generates, as shown in
.na
\f2Package Summary\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/applet/package\-summary.html.
.TP 2
o
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.
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
.na
\f2Overview Summary\fP @
.fi
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.
.RE
.LP
@ -614,7 +629,11 @@ o
Processes any overview tags that are present.
.TP 2
o
Inserts the processed text at the bottom of the overview page it generates, as shown in Overview Summary.
Inserts the processed text at the bottom of the overview page it generates, as shown in
.na
\f2Overview Summary\fP @
.fi
http://java.sun.com/javase/6/docs/api/overview\-summary.html.
.TP 2
o
Copies the first sentence of the overview comment to the top of the overview summary page.
@ -907,7 +926,7 @@ NOTE \- Directories are shown in \f3bold\fP. The asterisks (\f2*\fP) indicate th
.LP
.SS
a name="generatedapideclarations"/> Generated API Declarations
Generated API Declarations
.LP
.LP
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:
@ -1332,7 +1351,7 @@ The current tags are:
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 1084 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 1123 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -1455,19 +1474,30 @@ http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@author.
.LP
.LP
Note: Starting with JDK 5.0, you can deprecate a program element using the @Deprecated annotation.
Note: You can deprecate a program element using the
.na
\f2@Deprecated annotation\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/deprecation.html.
.LP
.RE
.RE
.RS 3
.LP
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.
.LP
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:
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.
.LP
.LP
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:
.LP
.LP
For more details, see
.na
\f2writing @deprecated tags\fP @
.fi
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@deprecated.
.LP
.RS 3
.TP 2
o
@ -1481,15 +1511,28 @@ For Javadoc 1.2 and later, use a \f2{@link}\fP tag. This creates the link in\-li
.fl
*/
.fl
.fl
\fP
.fi
.TP 2
o
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.
.RE
.LP
For more about deprecation, see The @deprecated tag.
.LP
For more about deprecation, see
.na
\f2The @deprecated tag\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/deprecation/index.html.
.LP
.LP
.LP
.RE
.RS 3
.TP 3
{@code\ text}
Equivalent to \f2<code>{@literal}</code>\fP.
@ -1500,16 +1543,22 @@ Displays \f2text\fP in \f2code\fP font without interpreting the text as HTML mar
.fl
\fP\f4{@code A<B>C}\fP\f3
.fl
.fl
\fP
.fi
.LP
displays in the generated HTML page unchanged, as:
.nf
\f3
.fl
\fP\f4A<B>C\fP\f3
.fl
.fl
\fP
.fi
.LP
The noteworthy point is that the \f2<B>\fP is not interpreted as bold and is in code font.
.LP
If you want the same functionality without the code font, use \f2{@literal}\fP.
@ -1528,9 +1577,12 @@ On the command line, where the header/footer/bottom are defined:
.fl
javadoc \-bottom '<a href="{@docRoot}/copyright.html">Copyright</a>'
.fl
.fl
\fP
.fi
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).
.LP
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).
.TP 3
2.
In a doc comment:
@ -1543,31 +1595,42 @@ In a doc comment:
.fl
*/
.fl
.fl
\fP
.fi
.RE
.LP
The reason this tag is needed is because the generated docs are in hierarchical directories, as deep as the number of subpackages. This expression:
.nf
\f3
.fl
<a href="{@docRoot}/copyright.html">
.fl
.fl
\fP
.fi
.LP
would resolve to:
.nf
\f3
.fl
<a href="../../copyright.html"> for java/lang/Object.java
.fl
.fl
\fP
.fi
.LP
and
.nf
\f3
.fl
<a href="../../../copyright.html"> for java/lang/ref/Reference.java
.fl
.fl
\fP
.fi
.LP
@ -1604,25 +1667,34 @@ For example, here is a comment that refers to the \f2getComponentAt(int, int)\fP
\f3
.fl
Use the {@link #getComponentAt(int, int) getComponentAt} method.
.fl
.fl
\fP
.fi
.LP
From this, the standard doclet would generate the following HTML (assuming it refers to another class in the same package):
.nf
\f3
.fl
Use the <a href="Component.html#getComponentAt(int, int)">getComponentAt</a> method.
.fl
.fl
\fP
.fi
.LP
Which appears on the web page as:
.nf
\f3
.fl
Use the getComponentAt method.
.fl
.fl
\fP
.fi
.LP
You can extend \f2{@link}\fP to link to classes not being documented by using the \f2\-link\fP option.
.LP
For more details, see
@ -1639,14 +1711,20 @@ Identical to \f2{@link}\fP, except the link's label is displayed in plain text t
.fl
Refer to {@linkplain add() the overridden method}.
.fl
.fl
\fP
.fi
.LP
This would display as:
.RS 3
.LP
.LP
Refer to the overridden method.
.LP
.RE
.LP
.TP 3
{@literal\ text}
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:
@ -1655,11 +1733,16 @@ Displays \f2text\fP without interpreting the text as HTML markup or nested javad
.fl
\fP\f4{@literal A<B>C}\fP\f3
.fl
.fl
\fP
.fi
.LP
displays unchanged in the generated HTML page in your browser, as:
.LP
\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).
\f2\ \ \ \ \ \fPA<B>C
.LP
The noteworthy point is that the \f2<B>\fP is not interpreted as bold (and it is not in code font).
.LP
If you want the same functionality but with the text in code font, use \f2{@code}\fP.
.LP
@ -1683,6 +1766,8 @@ Example of a type parameter of a class:
.fl
}
.fl
.fl
\fP
.fi
.LP
@ -1706,8 +1791,11 @@ Example of a type parameter of a method:
.fl
}
.fl
.fl
\fP
.fi
.LP
For more details, see
.na
\f2writing @param tags\fP @
@ -1736,15 +1824,26 @@ Adds a text entry for \f2string\fP. No link is generated. The \f2string\fP is a
.fl
@see "The Java Programming Language"
.fl
.fl
\fP
.fi
This generates text such as:
.LP
This generates text such as:
.RE
.RE
.RS 3
.RS 3
.RS 3
.LP
.RS 3
.RS 3
.TP 3
See Also:
"The Java Programming Language"
.RE
.RE
.LP
.RE
@ -1981,7 +2080,7 @@ Of course the advantage of providing shorter, "partially\-qualified" names is th
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 1547 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 1666 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2327,7 +2426,7 @@ Use \-noqualifier to globally remove the package names.
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
.if t .if \n(TW>\n(.li .tm Table at line 1623 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 1742 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2502,6 +2601,14 @@ For more details, see
.fi
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@see.
.RE
.RE
.RS 3
.LP
.LP
.LP
.RS 3
.TP 3
@serial\ field\-description | include | exclude
Used in the doc comment for a default serializable field.
@ -2524,7 +2631,11 @@ Examples: The \f2javax.swing\fP package is marked \f2@serial exclude\fP (in \f2p
.LP
The tag @serial at a class level overrides @serial at a package level.
.LP
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
For more information about how to use these tags, along with an example, see "
.na
\f2Documenting Serializable Fields and Data for a Class\fP @
.fi
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
.na
\f2Serialization FAQ\fP @
.fi
@ -2552,8 +2663,11 @@ Adds a "Since" heading with the specified \f2since\-text\fP to the generated doc
.fl
@since 1.5
.fl
.fl
\fP
.fi
.LP
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.
.LP
.TP 3
@ -2584,8 +2698,11 @@ When \f2{@value}\fP is used (without any argument) in the doc comment of a stati
.fl
public static final String SCRIPT_START = "<script>"
.fl
.fl
\fP
.fi
.LP
When used with argument \f2package.class#field\fP in any doc comment, it displays the value of the specified constant:
.nf
\f3
@ -2600,11 +2717,18 @@ When used with argument \f2package.class#field\fP in any doc comment, it display
.fl
}
.fl
.fl
\fP
.fi
.LP
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.
.LP
These values of these constants are also displayed on the Constant Field Values page.
These values of these constants are also displayed on the
.na
\f2Constant Field Values\fP @
.fi
http://java.sun.com/javase/6/docs/api/constant\-values.html page.
.LP
.TP 3
@version\ version\-text
@ -2618,6 +2742,9 @@ For more details, see
.fi
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html#@version.
.RE
.LP
.RE
.SS
Where Tags Can Be Used
.LP
@ -2702,7 +2829,7 @@ Overview tags are tags that can appear in the documentation comment for the over
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 1816 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 1963 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2819,7 +2946,7 @@ Package tags are tags that can appear in the documentation comment for a package
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 1848 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 1995 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2938,7 +3065,7 @@ The following are tags that can appear in the documentation comment for a class
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 1882 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 2029 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3098,7 +3225,7 @@ The following are the tags that can appear in the documentation comment for a fi
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 1957 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 2104 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3242,7 +3369,7 @@ The following are the tags that can appear in the documentation comment for a co
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr TW \n(80
.if t .if \n(TW>\n(.li .tm Table at line 2016 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 2163 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3324,6 +3451,8 @@ The following are the tags that can appear in the documentation comment for a co
.LP
.SH "OPTIONS"
.LP
.LP
.LP
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.
@ -3545,7 +3674,7 @@ The options are:
.nr 42 \n(81+(3*\n(38)
.nr 82 +\n(42
.nr TW \n(82
.if t .if \n(TW>\n(.li .tm Table at line 2192 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 2341 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3657,11 +3786,11 @@ For example, to call the MIF doclet, use:
\fP
.fi
.LP
For full, working examples of running a particular doclet, see
For full, working examples of running a particular doclet, see the
.na
\f2Running the MIF Doclet\fP @
\f2MIF Doclet documentation\fP @
.fi
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
.LP
.TP 3
\-docletpath\ classpathlist
@ -3683,11 +3812,11 @@ Example of path to starting doclet class file. Notice the class filename is omit
.fl
\fP
.fi
For full, working examples of running a particular doclet, see
For full, working examples of running a particular doclet, see the
.na
\f2Running the MIF Doclet\fP @
\f2MIF Doclet documentation\fP @
.fi
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
.LP
.TP 3
\-1.1
@ -3808,7 +3937,7 @@ javadoc does \f2not\fP support assertions, generics, or other language features
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 2302 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 2451 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3915,7 +4044,11 @@ To point to two source paths:
.LP
.TP 3
\-classpath\ classpathlist
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.
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
.na
\f2class path\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general documentation for specifying \f2classpathlist\fP.
.LP
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.
.LP
@ -3928,7 +4061,11 @@ For example, if you want to document \f2com.mypackage\fP, whose source files res
.fi
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.
.LP
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.
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
.na
\f2How Classes Are Found\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html.
.LP
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).
.br
@ -3963,7 +4100,11 @@ would include \f2java.io\fP, \f2java.util\fP, and \f2java.math\fP (among others)
.LP
.TP 3
\-bootclasspath\ classpathlist
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 (:).
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
.na
\f2How Classes Are Found\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles. for more details. Separate directories in \f2classpathlist\fP with colons (:).
.LP
.TP 3
\-extdirs\ dirlist
@ -3979,7 +4120,11 @@ Shuts off non\-error and non\-warning messages, leaving only the warnings and er
.LP
.TP 3
\-breakiterator\
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.
Uses the internationalized sentence boundary of
.na
\f2java.text.BreakIterator\fP @
.fi
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.
.LP
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:
.RS 3
@ -4057,7 +4202,7 @@ For example, the following generates the documentation for the package \f2com.my
\-use
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.
.LP
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.
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.
.LP
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.
.LP
@ -4080,7 +4225,7 @@ Specifies the title to be placed in the HTML <title> tag. This appears in the wi
.nf
\f3
.fl
% \fP\f3javadoc \-windowtitle "Java 2 Platform" com.mypackage\fP
% \fP\f3javadoc \-windowtitle "Java SE Platform" com.mypackage\fP
.fl
.fi
.TP 3
@ -4089,7 +4234,7 @@ Specifies the title to be placed near the top of the overview summary file. The
.nf
\f3
.fl
% \fP\f3javadoc \-doctitle "Java<sup><font size=\\"\-2\\">TM</font></sup>" com.mypackage\fP
% \fP\f3javadoc \-doctitle "Java(TM)" com.mypackage\fP
.fl
.fi
.TP 3
@ -4163,18 +4308,18 @@ o
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.
.RE
.LP
\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
\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
.na
\f2http://java.sun.com/j2se/1.5.0/docs/api\fP @
\f2http://java.sun.com/javase/6/docs/api/\fP @
.fi
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.)
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.)
.nf
\f3
.fl
% \fP\f3javadoc \-link http://java.sun.com/j2se/1.5.0/docs/api com.mypackage\fP
% \fP\f3javadoc \-link http://java.sun.com/javase/6/docs/api com.mypackage\fP
.fl
.fi
\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:
\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:
.nf
\f3
.fl
@ -4214,11 +4359,11 @@ An important corollary is that when you use the \f2\-link\fP option, there may b
.LP
\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.
.LP
For example, the package list for the Java 2 Platform 5.0 API is located at
For example, the package list for the Java SE 6 API is located at
.na
\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
http://java.sun.com/j2se/1.5.0/docs/api/package\-list. and starts out as follows:
http://java.sun.com/javase/6/docs/api/package\-list. and starts as follows:
.nf
\f3
.fl
@ -4277,15 +4422,15 @@ o
.LP
You can specify multiple \f2\-linkoffline\fP options in a given javadoc run. (Prior to 1.2.2, it could be specified only once.)
.LP
\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
\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
.na
\f2http://java.sun.com/j2se/1.5.0/docs/api/package\-list\fP @
\f2http://java.sun.com/javase/6/docs/api/package\-list\fP @
.fi
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.)
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.)
.nf
\f3
.fl
% \fP\f3javadoc \-linkoffline http://java.sun.com/j2se/1.5.0/docs/api . com.mypackage\fP
% \fP\f3javadoc \-linkoffline http://java.sun.com/javase/6/docs/api . com.mypackage\fP
.fl
.fi
.LP
@ -4303,7 +4448,7 @@ http://java.sun.com/j2se/1.5.0/docs/api/package\-list, save it to a local direct
.LP
\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.
.LP
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:
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:
.nf
\f3
.fl
@ -4527,7 +4672,7 @@ The \f2\-tag\fP option outputs the tag's heading \f2taghead\fP in bold, followed
.br
\f4f\fP (fields)
.LP
\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:
\f3Examples of single tags\fP \- An example of a tag option for a tag that can be used anywhere in the source code is:
.nf
\f3
.fl
@ -4635,7 +4780,10 @@ Specifies the class file that starts the taglet used in generating the documenta
.RS 3
.TP 2
o
Taglet Overview
.na
\f2Taglet Overview\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/taglet/overview.html
.RE
.LP
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.
@ -4713,7 +4861,7 @@ Suppresses the timestamp, which is hidden in an HTML comment in the generated HT
.nf
\f3
.fl
<!\-\- Generated by javadoc (build 1.5.0\-internal) on Tue Jun 22 09:57:24 PDT 2004 \-\->
<!\-\- Generated by javadoc (build 1.5.0_01) on Thu Apr 02 14:04:52 IST 2009 \-\->
.fl
\fP
.fi
@ -4723,6 +4871,8 @@ Suppresses the timestamp, which is hidden in an HTML comment in the generated HT
Suppress the entire comment body, including the main description and all tags, generating only declarations. This option enables re\-using source files originally intended for a different purpose, to produce skeleton HTML documentation at the early stages of a new project.
.RE
.SH "COMMAND LINE ARGUMENT FILES"
.LP
.LP
.LP
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.
@ -4771,19 +4921,19 @@ Create a file named "\f2options\fP" containing:
.fl
\-splitindex
.fl
\-windowtitle 'Java 2 Platform v1.3 API Specification'
\-windowtitle 'Java(TM) SE 7 API Specification'
.fl
\-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification'
\-doctitle 'Java(TM) SE 7 API Specification'
.fl
\-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>'
\-header '<b>Java(TM); SE 7'
.fl
\-bottom 'Copyright 1993\-2000 Sun Microsystems, Inc. All Rights Reserved.'
\-bottom 'Copyright 1993\-2009 Sun Microsystems, Inc. All Rights Reserved.'
.fl
\-group "Core Packages" "java.*"
.fl
\-overview /java/pubs/ws/1.5/src/share/classes/overview\-core.html
\-overview /java/pubs/ws/1.7.0/src/share/classes/overview\-core.html
.fl
\-sourcepath /java/pubs/ws/1.5/src/share/classes
\-sourcepath /java/pubs/ws/1.7.0/src/share/classes
.fl
\fP
.fi
@ -4873,24 +5023,37 @@ Or you could include the \f2\-bottom\fP option at the start of the argument file
% \fP\f3javadoc @bottom @packages\fP
.fl
.fi
.SH NAME
.LP
.LP
.SH "Name"
Running
.LP
.SH "RUNNING JAVADOC"
.LP
.LP
.LP
\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.
.LP
.LP
\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.
.LP
.LP
\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
\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
.na
\f2Running the MIF Doclet\fP @
\f2Standard Doclet\fP @
.fi
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html#runningmifdoclet.
http://java.sun.com/javase/6/docs/technotes/guides/javadoc/standard\-doclet.html#runningprogrammatically.
.LP
.LP
\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
.na
\f2MIF Doclet documentation\fP @
.fi
http://java.sun.com/j2se/javadoc/mifdoclet/docs/mifdoclet.html.
.LP
.SH "SIMPLE EXAMPLES"
.LP
.LP
.LP
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.
@ -5014,8 +5177,10 @@ This example generates HTML\-formatted documentation for the package \f2java.awt
.LP
.SH "REAL WORLD EXAMPLE"
.LP
.LP
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.
.LP
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.
.LP
.LP
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.
@ -5029,21 +5194,21 @@ This command line example is over 900 characters, which is too long for some she
.nf
\f3
.fl
% javadoc \-sourcepath /java/jdk/src/share/classes \\
% javadoc \-sourcepath /java/jdk/src/share/classes \\
.fl
\-overview /java/jdk/src/share/classes/overview.html \\
\-overview /java/jdk/src/share/classes/overview.html \\
.fl
\-d /java/jdk/build/api \\
\-d /java/jdk/build/api \\
.fl
\-use \\
\-use \\
.fl
\-splitIndex \\
\-splitIndex \\
.fl
\-windowtitle 'Java 2 Platform 5.0 API Specification' \\
\-windowtitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
.fl
\-doctitle 'Java<sup><font size="\-2">TM</font></sup> 2 Platform 5.0 API Specification' \\
\-doctitle 'Java(TM) Platform, Standard Edition 7 API Specification' \\
.fl
\-header '<b>Java 2 Platform </b><br><font size="\-1">5.0</font>' \\
\-header '<b>Java(TM) SE </b><br><font size="\-1">7</font>' \\
.fl
\-bottom '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
.fl
@ -5053,9 +5218,9 @@ Inc. in the US and other countries.<br>Copyright 1993\-1999 Sun Microsystems, In
.fl
901 San Antonio Road,<br>Palo Alto, California, 94303, U.S.A. All Rights Reserved.</font>' \\
.fl
\-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
\-group "Core Packages" "java.*:com.sun.java.*:org.omg.*" \\
.fl
\-group "Extension Packages" "javax.*" \\
\-group "Extension Packages" "javax.*" \\
.fl
\-J\-Xmx180m \\
.fl
@ -5107,17 +5272,17 @@ javadoc \-\fP\f3sourcepath\fP\f3 $(SRCDIR) \\ /* Sets path for so
.fl
java.lang java.lang.reflect \\ /* Sets packages to document */
.fl
java.util java.io java.net \\
java.util java.io java.net \\
.fl
java.applet
.fl
.fl
WINDOWTITLE = 'Java 2 Platform v1.2 API Specification'
WINDOWTITLE = 'Java(TM) SE 7 API Specification'
.fl
DOCTITLE = 'Java<sup><font size="\-2">TM</font></sup> 2 Platform v1.2 API Specification'
DOCTITLE = 'Java(TM) Platform Standard Edition 7 API Specification'
.fl
HEADER = '<b>Java 2 Platform </b><br><font size="\-1">v1.2</font>'
HEADER = '<b>Java(TM) SE 7</font>'
.fl
BOTTOM = '<font size="\-1"><a href="http://java.sun.com/cgi\-bin/bugreport.cgi">Submit
.fl
@ -5133,7 +5298,7 @@ GROUPCORE = '"Core Packages" "java.*:com.sun.java.*:org.omg.*"'
.fl
GROUPEXT = '"Extension Packages" "javax.*"'
.fl
SRCDIR = '/java/jdk/1.2/src/share/classes'
SRCDIR = '/java/jdk/1.7.0/src/share/classes'
.fl
\fP
.fi
@ -5159,6 +5324,8 @@ Other important options you might want to use but not needed in this example are
.LP
.SH "TROUBLESHOOTING"
.LP
.LP
.SS
General Troubleshooting
@ -5173,11 +5340,7 @@ o
http://java.sun.com/j2se/javadoc/faq/index.html#B
.TP 2
o
\f3Bugs and Limitations\fP \- You can also see some bugs listed at
.na
\f2Important Bug Fixes and Changes\fP @
.fi
http://java.sun.com/j2se/1.5.0/fixedbugs/index.html.
\f3Bugs and Limitations\fP \- You can also see some bugs listed at Important Bug Fixes and Changes.
.TP 2
o
\f3Version number\fP \- See version numbers.
@ -5201,6 +5364,8 @@ o
.LP
.SH "ENVIRONMENT"
.LP
.LP
.RS 3
.TP 3
@ -5211,23 +5376,25 @@ Environment variable that provides the path which javadoc uses to find user clas
.LP
.SH "SEE ALSO"
.LP
.LP
.RS 3
.TP 2
o
javac
javac(1)
.TP 2
o
java
java(1)
.TP 2
o
jdb
jdb(1)
.TP 2
o
javah
javah(1)
.TP 2
o
javap
javap(1)
.TP 2
o
.na
@ -5242,12 +5409,22 @@ o
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
.TP 2
o
Setting the Class Path
.na
\f2Setting the Class Path\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#general
.TP 2
o
How Javac and Javadoc Find Classes (tools.jar)
.na
\f2How Javac and Javadoc Find Classes\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/findingclasses.html#srcfiles (tools.jar)
.RE
.LP
.LP
Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
.LP
Javadoc is a trademark of Sun Microsystems, Inc. (The \f2javadoc\fP command itself does not require the trademark symbol.)
.LP

28
jdk/src/linux/doc/man/javah.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,20 +18,21 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
." .
." `
.TH javah 1 "05 Aug 2006"
." Generated by html2roff
."
.TH javah 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
javah \- C Header and Stub File Generator
.LP
.RS 3
.LP
.LP
\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.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -66,12 +65,13 @@ By default \f3javah\fP creates a header file for each class listed on the comman
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.
.LP
.LP
\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like \f3jdb\fP.
\f3javah_g\fP is a non\-optimized version of \f3javah\fP suitable for use with debuggers like jdb(1).
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
\-o outputfile
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.
@ -115,7 +115,7 @@ For example:
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).
.br
.br
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.
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.
.TP 3
\-bootclasspath path
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.
@ -127,12 +127,15 @@ Specifies that old JDK1.0\-style header files should be generated.
Specifies that output files should always be written.
.TP 3
\-Joption
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.
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.
.RE
.LP
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example,
@ -143,6 +146,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.fl
\fP
.fi
.RE
.LP
.SH "SEE ALSO"
@ -150,7 +154,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.LP
.LP
javac, java, jdb, javap, javadoc
javac(1), java(1), jdb(1), javap(1), javadoc(1)
.LP
.LP

23
jdk/src/linux/doc/man/javap.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH javap 1 "05 Aug 2006"
." Generated by html2roff
.TH javap 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
javap \- The Java Class File Disassembler
.LP
.RS 3
.LP
.LP
Disassembles class files.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -253,6 +252,7 @@ Method void paint(java.awt.Graphics)
.LP
.LP
.RS 3
.TP 3
\-help
Prints out help message for \f3javap\fP.
@ -260,9 +260,6 @@ Prints out help message for \f3javap\fP.
\-l
Prints out line and local variable tables.
.TP 3
\-b
Ensures backward compatibility with \f3javap\fP in JDK 1.1.
.TP 3
\-public
Shows only public classes and members.
.TP 3
@ -327,11 +324,14 @@ Specifies path from which to load bootstrap classes. By default, the bootstrap c
.TP 3
\-extdirs dirs
Overrides location at which installed extensions are searched for. The default location for extensions is the value of \f2java.ext.dirs\fP.
.RE
.LP
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
Used to provide the system a path to user\-defined classes. Directories are separated by colons, for example, For example:
@ -346,6 +346,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
\fP
.fi
.RE
.RE
.LP
.SH "SEE ALSO"
@ -353,7 +354,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.LP
.LP
javac, java, jdb, javah, javadoc
javac(1), java(1), jdb(1), javah(1), javadoc(1)
.LP
.LP

335
jdk/src/linux/doc/man/javaws.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,15 +18,14 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH javaws 1 "05 Aug 2006"
." Generated by html2roff
."
.TH javaws 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.LP
.SH NAME
.SH "Name"
\f2javaws\fP Command Line
.LP
@ -39,65 +36,84 @@
.SS
NAME
.LP
.RS 3
.LP
.LP
\f2javaws\fP \- Java Web Start launcher command
.LP
.RE
.SS
SYNOPSIS
.LP
.RS 3
.LP
.LP
\f2javaws [ options ] [ URL ]\fP
\f2javaws [run\-options] <jnlp>\fP
.LP
.LP
\f2javaws [control\-options]\fP
.LP
.RE
.SS
PARAMETERS
.LP
.RS 3
.LP
.LP
\f2options\fP
\f2[run\-options]\fP
.LP
.RS 3
.LP
.LP
Command\-line options. Options may be in any order. For a discussion of the various options, see OPTIONS below.
Command\-line run\-options. run\-options may be in any order. For a discussion of the various run\-options, see RUN\-OPTIONS below.
.LP
.RE
.LP
\f2URL\fP
\f2<jnlp>\fP
.LP
.RS 3
.LP
.LP
Uniform Resource Locator (\f2URL\fP) of the JNLP (Java Net\-work Launching Protocol) file.
This can be either the path of, or the Uniform Resource Locater (URL) of the JNLP (Java Network Launching Protocol) file.
.LP
.RE
.LP
\f2[control\-options]\fP
.LP
.RS 3
.LP
.LP
Command\-line control\-options. control\-options may be in any order. For a discussion of the various control\-options, see CONTROL\-OPTIONS below.
.LP
.RE
.RE
.SS
DESCRIPTION
.LP
.RS 3
.LP
.LP
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.
.LP
.LP
Without any options \f2javaws\fP will launch the Java JNLP Application Manager, from which users can launch applications/applet or configure Java Web Start.
If a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
.LP
.LP
If a \f2URL\fP for a JNLP file is specified, \f2javaws\fP will launch the Java application/applet specified in the JNLP file.
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.
.LP
.RE
.SS
OPTIONS
RUN\-OPTIONS
.LP
.RS 3
.LP
.LP
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.
.LP
.LP
\f2\-offline\fP
@ -106,37 +122,7 @@ The \f2javaws\fP launcher has a set of options that are supported in the current
.LP
.LP
Runs Java Web Start in offline mode.
.LP
.RE
.LP
\f2\-uninstall <URL>\fP
.LP
.RS 3
.LP
.LP
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.
.LP
.RE
.LP
\f2\-updateVersions\fP
.LP
.RS 3
.LP
.LP
Updates the Java Web Start configuration file based on the current machine's settings. Java Web Start will exit after the command is completed.
.LP
.RE
.LP
\f2\-Xclearcache\fP
.LP
.RS 3
.LP
.LP
Clears the user's cache. Java Web Start will exit after the command is completed.
run Java Web Start in offline mode.
.LP
.RE
.LP
@ -146,67 +132,7 @@ Clears the user's cache. Java Web Start will exit after the command is completed
.LP
.LP
Disables the display of the initial splash screen.
.LP
.RE
.LP
\f2\-import\fP
.LP
.RS 3
.LP
.LP
Imports the application specified by URL into the user's cache but does not run it.
.LP
.RE
.LP
\f2\-silent\fP
.LP
.RS 3
.LP
.LP
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.
.LP
.RE
.LP
\f2\-codebase <url>\fP
.LP
.RS 3
.LP
.LP
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.
.LP
.RE
.LP
\f2\-system\fP
.LP
.RS 3
.LP
.LP
Uses the system cache instead of the user cache.
.LP
.RE
.LP
\f2\-shortcut\fP
.LP
.RS 3
.LP
.LP
Allows the creation of shortcuts during silent import.
.LP
.RE
.LP
\f2\-association\fP
.LP
.RS 3
.LP
.LP
Allows the creation of associations during silent import.
disable the display of the initial splash screen.
.LP
.RE
.LP
@ -236,37 +162,7 @@ If specified, replaces the arguments in the jnlp file with \f2\-print <arguments
.LP
.LP
Runs in online mode (default behavior).
.LP
.RE
.LP
\f2\-viewer\fP
.LP
.RS 3
.LP
.LP
Runs the Java Application Cache Viewer (default if no URL is specified).
.LP
.RE
.LP
\f2\-userConfig <property name>\fP
.LP
.RS 3
.LP
.LP
Clears the specified deployment property.
.LP
.RE
.LP
\f2\-userConfig <property name> <property value>\fP
.LP
.RS 3
.LP
.LP
Sets the specified deployment property to the specified value.
run in online mode (default behavior).
.LP
.RE
.LP
@ -280,11 +176,159 @@ If specified, the \f2javaws\fP process will not exit until the application exits
.LP
.RE
.LP
\
\f2\-verbose\fP
.LP
.RS 3
.LP
.LP
display additional output.
.LP
.RE
.LP
\f2\-J<option>\fP
.LP
.RS 3
.LP
.LP
supply options to the vm.
.LP
.RE
.LP
\f2\-system\fP
.LP
.RS 3
.LP
.LP
run the application from the system cache only.
.LP
.RE
.RE
.SS
CONTROL\-OPTIONS
.LP
.RS 3
.LP
.LP
\f2\-viewer\fP
.LP
.RS 3
.LP
.LP
show the Cache Viewer in the java control panel
.LP
.RE
.LP
\f2\-userConfig <property name>\fP
.LP
.RS 3
.LP
.LP
clear the specified deployment property.
.LP
.RE
.LP
\f2\-userConfig <property name> <property value>\fP
.LP
.RS 3
.LP
.LP
set the specified deployment property to the specified value.
.LP
.RE
.LP
\f2\-uninstall\fP
.LP
.RS 3
.LP
.LP
remove all applications from the cache.
.LP
.RE
.LP
\f2\-uninstall <jnlp>\fP
.LP
.RS 3
.LP
.LP
remove the application from the cache.
.LP
.RE
.LP
\f2\-import [import\-options] <jnlp>\fP
.LP
.RS 3
.LP
.LP
import the application to the cache.
.LP
.RE
\f3IMPORT\-OPTIONS\fP
.LP
.LP
\f2\-silent\fP
.LP
.RS 3
.LP
.LP
import silently (with no user interface).
.LP
.RE
.LP
\f2\-system\fP
.LP
.RS 3
.LP
.LP
import application to the system cache.
.LP
.RE
.LP
\f2\-codebase <url>\fP
.LP
.RS 3
.LP
.LP
retrieve resources from the given codebase.
.LP
.RE
.LP
\f2\-shortcut\fP
.LP
.RS 3
.LP
.LP
install shortcuts as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
.LP
.RE
.LP
\f2\-association\fP
.LP
.RS 3
.LP
.LP
install associations as if user allowed prompt. This option has no effect unless \f2\-silent\fP option is also used.
.LP
.RE
.RE
.SS
FILES
.LP
.RS 3
.LP
.LP
@ -294,15 +338,17 @@ For information about the user and system cache and deployment.properties files,
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/properties.html.
.LP
.RE
.SS
MORE INFORMATION
.LP
.RS 3
.LP
.LP
For more information about Java Web Start, see
.na
\f2Java Web Start version 1.5.0\fP @
\f2Java Web Start\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
.LP
@ -313,4 +359,7 @@ http://java.sun.com/javase/6/docs/technotes/guides/javaws/index.html.
\
.LP
.RE
.RE
.LP

47
jdk/src/linux/doc/man/jconsole.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jconsole 1 "07 Aug 2006"
." Generated by html2man
."
.TH jconsole 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jconsole \- Java Monitoring and Management Console
.LP
.SH "SYNOPSIS"
@ -55,11 +52,23 @@ Options, if used, should follow immediately after the command name.
.TP 3
connection = pid | host:port | jmxUrl
.RS 3
\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.
\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
.na
\f2JMX Monitoring and Management\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
.br
\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.
\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
.na
\f2JMX Monitoring and Management\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html for details.
.br
\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in JMXServiceURL.
\f2jmxUrl\fP\ \ Address of the JMX agent to be connected to as described in
.na
\f2JMXServiceURL\fP @
.fi
http://java.sun.com/javase/6/docs/api/javax/management/remote/JMXServiceURL.html.
.RE
.RE
@ -97,7 +106,11 @@ Specify a list of directories or JAR files which are searched for JConsole plugi
\fP
.fi
.LP
containing one line for each plugin specifying the fully qualified class name of the class implementing the com.sun.tools.jconsole.JConsolePlugin class.
containing one line for each plugin specifying the fully qualified class name of the class implementing the
.na
\f2com.sun.tools.jconsole.JConsolePlugin\fP @
.fi
http://java.sun.com/javase/6/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
.TP 3
\-version\
Output version information and exit.
@ -115,10 +128,16 @@ Pass <flag> to the Java virtual machine on which jconsole is run.
.RS 3
.TP 2
o
Using JConsole
.na
\f2Using JConsole\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
.TP 2
o
Monitoring and Management for Java Platform
.na
\f2Monitoring and Management for Java Platform\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
.RE
.LP

67
jdk/src/linux/doc/man/jdb.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,20 +18,21 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jdb 1 "05 Aug 2006"
." Generated by html2roff
."
.TH jdb 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jdb \- The Java Debugger
.LP
.RS 3
.LP
.LP
\f3jdb\fP helps you find and fix bugs in Java language programs.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -49,6 +48,7 @@ jdb \- The Java Debugger
.RS 3
.LP
.RS 3
.TP 3
options
Command\-line options, as specified below.
@ -58,6 +58,8 @@ Name of the class to begin debugging.
.TP 3
arguments
Arguments passed to the \f2main()\fP method of \f2class\fP.
.RE
.LP
.RE
.SH "DESCRIPTION"
@ -74,6 +76,7 @@ http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html that provides
.SS
Starting a jdb Session
.LP
.RS 3
.LP
.LP
@ -135,11 +138,11 @@ There are many other ways to connect the debugger to a VM, and all of them are s
.na
\f2documentation\fP @
.fi
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
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
.na
\f21.4.2 documentation\fP @
.fi
http://java.sun.com/j2se/1.4.2/docs/technotes/guides/jpda/conninv.html
http://java.sun.com/j2se/1.4.2/docs/guide/jpda/conninv.html
.LP
.SS
Basic jdb Commands
@ -150,6 +153,7 @@ The following is a list of the basic \f3jdb\fP commands. The Java debugger suppo
.RS 3
.LP
.RS 3
.TP 3
help, or ?
The most important \f3jdb\fP command, \f2help\fP displays the list of recognized commands with a brief description.
@ -163,24 +167,24 @@ Continues execution of the debugged application after a breakpoint, exception, o
print
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.
.LP
\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac\fP\f2 \fP\f2\-g\fP option.
\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP option.
.LP
\f2print\fP supports many simple Java expressions including those with method invocations, for example:
.RS 3
.TP 2
*
o
\f2print MyClass.myStaticField\fP
.TP 2
*
o
\f2print myObj.myInstanceField\fP
.TP 2
*
o
\f2print i + j + k\fP \f2(i, j, k are primities and either fields or local variables)\fP
.TP 2
*
o
\f2print myObj.myMethod()\fP \f2(if myMethod returns a non\-null)\fP
.TP 2
*
o
\f2print new java.lang.String("Hello").length()\fP
.RE
.TP 3
@ -211,11 +215,14 @@ where
\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.
.LP
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.
.RE
.LP
.RE
.SS
Breakpoints
.LP
.RS 3
.LP
.LP
@ -223,16 +230,16 @@ Breakpoints can be set in \f3jdb\fP at line numbers or at the first instruction
.LP
.RS 3
.TP 2
*
o
\f2stop at MyClass:22\fP \f2(sets a breakpoint at the first instruction for line 22 of the source file containing MyClass)\fP
.TP 2
*
o
\f2stop in java.lang.String.length\fP \f2(sets a breakpoint at the beginnig of the method \fP\f2java.lang.String.length\fP)
.TP 2
*
o
\f2stop in MyClass.<init>\fP \f2(<init> identifies the MyClass constructor)\fP
.TP 2
*
o
\f2stop in MyClass.<clinit>\fP \f2(<clinit> identifies the static initialization code for MyClass)\fP
.RE
@ -243,17 +250,21 @@ If a method is overloaded, you must also specify its argument types so that the
.LP
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.
.LP
.RE
.SS
Stepping
.LP
.RS 3
.LP
.LP
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.
.LP
.RE
.SS
Exceptions
.LP
.RS 3
.LP
.LP
@ -268,6 +279,8 @@ The \f2ignore\fP command negates the effect of a previous \f2catch\fP command.
.LP
\f2NOTE: The \fP\f2ignore\fP command does not cause the debugged VM to ignore specific exceptions, only the debugger.
.LP
.RE
.RE
.SH "Command Line Options"
.LP
@ -278,6 +291,7 @@ When you use \f3jdb\fP in place of the Java application launcher on the command
.LP
The following additional options are accepted by \f3jdb\fP:
.LP
.RS 3
.TP 3
\-help
Displays a help message.
@ -300,8 +314,7 @@ Launches the debugged application immediately upon startup of jdb. This option r
\-listconnectors
List the connectors available in this VM
.TP 3
\-connect
<connector\-name>:<name1>=<value1>,...
\-connect <connector\-name>:<name1>=<value1>,...
Connects to target VM using named connector with listed argument values.
.TP 3
\-dbgtrace [flags]
@ -315,6 +328,8 @@ Runs the application in the Java HotSpot(tm) VM (Server).
.TP 3
\-Joption
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.
.RE
.LP
.LP
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
@ -326,6 +341,7 @@ http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these co
.SS
Options Forwarded to Debuggee Process
.LP
.RS 3
.TP 3
\-v \-verbose[:class|gc|jni]
Turns on verbose mode.
@ -333,19 +349,20 @@ Turns on verbose mode.
\-D<name>=<value>
Sets a system property.
.TP 3
\-classpath <directories separated by
":">
\-classpath <directories separated by ":">
Lists directories in which to look for classes.
.TP 3
\-X<option>
Non\-standard target VM option
.RE
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
javac, java, javah, javap, javadoc.
javac(1), java(1), javah(1), javap(1), javadoc(1).
.LP
.LP

56
jdk/src/linux/doc/man/jhat.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jhat 1 "05 Aug 2006"
." Generated by html2roff
.TH jhat 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jhat \- Java Heap Analysis Tool
.LP
.SH "SYNOPSIS"
@ -47,16 +44,15 @@ jhat \- Java Heap Analysis Tool
.LP
.LP
.RS 3
.TP 3
options
Options, if used, should follow immediately after the command name.
.br
.TP 3
heap\-dump\-file
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".
.LP
.SH "DESCRIPTION"
.LP
.SH "DESCRIPTION"
.LP
.LP
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/
@ -66,20 +62,20 @@ There are several ways to generate a java heap dump:
.LP
.RS 3
.TP 2
*
Use jmap \-dump option to obtain a heap dump at runtime;
o
Use jmap(1) \-dump option to obtain a heap dump at runtime;
.TP 2
*
Use jconsole option to obtain a heap dump via
o
Use jconsole(1) option to obtain a heap dump via
.na
\f2HotSpotDiagnosticMXBean\fP @
.fi
http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticsMXBean.html at runtime;
http://java.sun.com/javase/6/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean.html at runtime;
.TP 2
*
o
Heap dump will be generated when OutOfMemoryError is thrown by specifying \-XX:+HeapDumpOnOutOfMemoryError VM option;
.TP 2
*
o
Use
.na
\f2hprof\fP @
@ -91,10 +87,8 @@ http://java.sun.com/developer/technicalArticles/Programming/HPROF.html.
.LP
\f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
.LP
.SH "OPTIONS"
.LP
.LP
.SH "OPTIONS"
.RS 3
.TP 3
\-stack false/true
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.
@ -125,25 +119,23 @@ Output help message and exit.
.TP 3
\-J<flag>\
Pass <flag> to the Java virtual machine on which jhat is run. For example, \-J\-Xmx512m to use a maximum heap size of 512MB.
.RE
.LP
.SH "SEE ALSO"
.LP
.SH "SEE ALSO"
.RS 3
.TP 2
*
jmap \- Java Memory Map
o
jmap(1)
.TP 2
*
jconsole \- Java Monitoring and Management Console
o
jconsole(1)
.TP 2
*
o
.na
\f2hprof \- Heap and CPU profiling tool\fP @
.fi
http://java.sun.com/developer/technicalArticles/Programming/HPROF.html
.RE
.LP
.LP
.RE

50
jdk/src/linux/doc/man/jinfo.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jinfo 1 "05 Aug 2006"
." Generated by html2roff
.TH jinfo 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jinfo \- Configuration Info
.LP
.SH "SYNOPSIS"
@ -49,24 +46,37 @@ jinfo \- Configuration Info
.LP
.LP
.RS 3
.TP 3
option
Options are mutually exclusive. Option, if used, should follow immediately after the command name.
.RS 3
.TP 3
pid
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.
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.
.RE
.RS 3
.TP 3
executable
Java executable from which the core dump was produced.
Java executable from which the core dump was produced.
.RE
.RS 3
.TP 3
core
core file for which the configuration info is to be printed.
core file for which the configuration info is to be printed.
.RE
.RS 3
.TP 3
remote\-hostname\-or\-IP
remote debug server's (see jsadebugd) hostname or IP address.
remote debug server's (see jsadebugd(1)) hostname or IP address.
.RE
.RS 3
.TP 3
server\-id
optional unique id, if multiple debug servers are running on the same remote host.
optional unique id, if multiple debug servers are running on the same remote host.
.RE
.RE
.LP
.SH "DESCRIPTION"
.LP
@ -83,12 +93,16 @@ optional unique id, if multiple debug servers are running on the same remote hos
jinfo \-J\-d64 \-sysprops pid
.RE
.LP
\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
\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
.LP
.LP
\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
<no option>
prints both command line flags as well as System properties name, value pairs.
@ -119,16 +133,18 @@ prints a help message
.TP 3
\-help
prints a help message
.RE
.LP
.SH "SEE ALSO"
.LP
.RS 3
.TP 2
*
jps
o
jps(1)
.TP 2
*
jsadebugd
o
jsadebugd(1)
.RE
.LP

73
jdk/src/linux/doc/man/jmap.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jmap 1 "05 Aug 2006"
." Generated by html2roff
.TH jmap 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jmap \- Memory Map
.LP
.SH "SYNOPSIS"
@ -49,25 +46,31 @@ jmap \- Memory Map
.LP
.LP
.RS 3
.TP 3
option
Options are mutually exclusive. Option, if used, should follow immediately after the command name.
.TP 3
pid
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.
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.
.br
.TP 3
executable
Java executable from which the core dump was produced.
.br
.TP 3
core
core file for which the memory map is to be printed.
.br
.TP 3
remote\-hostname\-or\-IP
remote debug server's (see jsadebugd) hostname or IP address.
remote debug server's (see jsadebugd(1)) hostname or IP address.
.br
.TP 3
server\-id
optional unique id, if multiple debug servers are running on the same remote host.
.br
.RE
.LP
.SH "DESCRIPTION"
@ -90,76 +93,78 @@ jmap \-J\-d64 \-heap pid
.RE
.LP
\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK.\fP
\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
.LP
\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.br
.LP
The only forms of jmap available on the Windows platform are
.RS 3
.LP
jmap \-dump:<\f2dump\-options\fP> pid
.RE
and
.RS 3
.LP
jmap \-histo[:live] pid
.RE
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
<no
option>
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.
<no option>
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.
.br
.TP 3
\-dump:[live,]format=b,file=<filename>
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.
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.
.br
.TP 3
\-finalizerinfo
Prints information on objects awaiting finalization.
.br
.TP 3
\-heap
Prints a heap summary. GC algorithm used, heap configuration and generation wise heap usage are printed.
.br
.TP 3
\-histo[:live]
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.
.br
.TP 3
\-permstat
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.
.br
.TP 3
\-F
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.
.br
.TP 3
\-h
Prints a help message.
.br
.br
.TP 3
\-help
Prints a help message.
.br
.br
.TP 3
\-J<flag>
Passes <flag> to the Java virtual machine on which jmap is run.
.br
.RE
.LP
.SH "SEE ALSO"
.LP
.RS 3
.TP 2
*
pmap (1)
o
pmap(1)
.TP 2
*
jhat
o
jhat(1)
.TP 2
*
jps
o
jps(1)
.TP 2
*
jsadebugd
o
jsadebugd(1)
.RE
.LP

34
jdk/src/linux/doc/man/jps.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jps 1 "06 Aug 2006"
." Generated by html2man
.TH jps 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jps \- Java Virtual Machine Process Status Tool
.LP
.SH "SYNOPSIS"
@ -47,12 +44,15 @@ jps \- Java Virtual Machine Process Status Tool
.LP
.LP
.RS 3
.TP 3
options
Command\-line options.
.TP 3
hostid
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.
.RE
.LP
.SH "DESCRIPTION"
.LP
@ -83,6 +83,7 @@ The list of JVMs produced by the \f3jps\fP command may be limited by the permiss
.LP
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.
.LP
.RS 3
.TP 3
\-q
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.
@ -101,6 +102,8 @@ Output the arguments passed to the JVM through the flags file (the .hotspotrc fi
.TP 3
\-Joption
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.
.RE
.LP
.SS
HOST IDENTIFIER
@ -122,6 +125,7 @@ The host identifier, or \f2hostid\fP is a string that indicates the target syste
.fi
.LP
.RS 3
.TP 3
protocol
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.
@ -133,7 +137,9 @@ port
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.
.TP 3
servername
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.
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.
.RE
.LP
.RE
.SH "OUTPUT FORMAT"
@ -207,7 +213,7 @@ This example assumes that the \f3jstat\fP server and either the its internal RMI
.br
.fl
3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@ -231,7 +237,7 @@ This example assumes that the \f3jstatd\fP server, with an internal RMI registry
.br
.fl
3002 /opt/j2sdk1.5.0/demo/jfc/Java2D/Java2Demo.JAR
3002 /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
.br
.fl
@ -245,16 +251,16 @@ This example assumes that the \f3jstatd\fP server, with an internal RMI registry
.RS 3
.TP 2
o
java \- the Java Application Launcher
java(1) \- the Java Application Launcher
.TP 2
o
jstat \- the Java virtual machine Statistics Monitoring Tool
jstat(1) \- the Java virtual machine Statistics Monitoring Tool
.TP 2
o
jstatd \- the jstat daemon
jstatd(1) \- the jstat daemon
.TP 2
o
rmiregistry \- the Java Remote Object Registry
rmiregistry(1) \- the Java Remote Object Registry
.RE
.LP

17
jdk/src/linux/doc/man/jrunscript.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jrunscript 1 "06 Aug 2006"
." Generated by html2man
."
.TH jrunscript 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jrunscript \- command line script shell
.LP
.SH "SYNOPSIS"
@ -45,12 +42,15 @@ jrunscript \- command line script shell
.LP
.LP
.RS 3
.TP 3
options
Options, if used, should follow immediately after the command name.
.TP 3
arguments
Arguments, if used, should follow immediately after options or command name.
.RE
.LP
.SH "DESCRIPTION"
.LP
@ -66,6 +66,7 @@ Arguments, if used, should follow immediately after options or command name.
.LP
.LP
.RS 3
.TP 3
\-classpath path
Specify where to find the user's .class files that are accessed by the script.
@ -102,6 +103,8 @@ Output help message and exit.
.TP 3
\-q\
List all script engines available and exit.
.RE
.LP
.SH "ARGUMENTS"
.LP

62
jdk/src/linux/doc/man/jsadebugd.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jsadebugd 1 "05 Aug 2006"
." Generated by html2roff
.TH jsadebugd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jsadebugd \- Serviceability Agent Debug Daemon
.LP
.SH "SYNOPSIS"
@ -47,30 +44,49 @@ jsadebugd \- Serviceability Agent Debug Daemon
.LP
.LP
.RS 3
.TP 3
pid
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.
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.
.RE
.LP
.RS 3
.TP 3
executable
.RE
.LP
.RS 3
.TP 3
Java executable from which the core dump was produced
.RE
.LP
.RS 3
.TP 3
core
Core file to which the debug server should attach.
.RE
.LP
.RS 3
.TP 3
server\-id
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.
.RE
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
\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:
\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,
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi must be started with:
.LP
.RS 3
@ -89,26 +105,32 @@ Optional unique id, needed if multiple debug servers are started on the same mac
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.
.LP
.LP
\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
\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
.LP
.LP
\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "SEE ALSO"
.LP
.RS 3
.TP 2
*
jinfo
o
jinfo(1)
.TP 2
*
jmap
o
jmap(1)
.TP 2
*
jps
o
jps(1)
.TP 2
*
jstack
o
jstack(1)
.TP 2
*
rmiregistry
o
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi
.RE
.LP

39
jdk/src/linux/doc/man/jstack.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jstack 1 "07 Aug 2006"
." Generated by html2man
.TH jstack 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jstack \- Stack Trace
.br
@ -57,7 +54,7 @@ Options are mutually exclusive. Option, if used, should follow immediately after
.RS 3
.TP 3
pid
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.
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.
.RE
.LP
@ -72,7 +69,7 @@ core file for which the stack trace is to be printed.
.br
.TP 3
remote\-hostname\-or\-IP
remote debug server's (see jsadebugd) hostname or IP address.
remote debug server's (see jsadebugd(1)) hostname or IP address.
.br
.TP 3
server\-id
@ -103,15 +100,10 @@ jstack \-J\-d64 \-m pid
.LP
.LP
\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
\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.
.LP
.nf
\f3
.fl
\fP\f3 jstack pid \fP
.fl
.fi
.LP
For example, \f2set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
.LP
.SH "OPTIONS"
.LP
@ -120,7 +112,14 @@ jstack \-J\-d64 \-m pid
.RS 3
.TP 3
\-F
Forces a stack dump when 'jstack pid' does not respond.
Force a stack dump when 'jstack [\-l] pid' does not respond.
.TP 3
\-l
Long listing. Prints additional information about locks such as list of owned java.util.concurrent
.na
\f2ownable synchronizers\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html.
.TP 3
\-m
prints mixed mode (both Java and native C/C++ frames) stack trace.
@ -147,10 +146,10 @@ o
c++filt(1)
.TP 2
o
jps
jps(1)
.TP 2
o
jsadebugd
jsadebugd(1)
.RE
.LP

335
jdk/src/linux/doc/man/jstat.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,25 +19,38 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jstat 1 "06 Aug 2006"
." Generated by html2man
.SH NAME
.TH jstat 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH "Name"
jstat \- Java Virtual Machine Statistics Monitoring Tool
.LP
.SH "SYNOPSIS"
.LP
.LP
.nf
\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP\f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
\f3
.fl
\fP\f3jstat\fP [ \f2generalOption\fP | \f2outputOptions\fP \f2vmid\fP [\f2interval\fP[s|ms] [\f2count\fP]] ]
.fl
.fi
.LP
.SH "PARAMETERS"
.LP
.LP
.RS 3
.TP 3
generalOption
A single general command\-line option (\-help, \-options, or \-version)
generalOption
A single general command\-line option (\-help, \-options, or \-version)
.TP 3
outputOptions
One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
outputOptions
One or more output options, consisting of a single \f2statOption\fP, plus any of the \-t, \-h, and \-J options.
.TP 3
vmid
vmid
Virtual machine identifier, a string indicating the target Java virtual machine (JVM). The general syntax is
.nf
\f3
@ -47,82 +58,124 @@ Virtual machine identifier, a string indicating the target Java virtual machine
[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP[:\f2port\fP]/\f2servername\fP]
.fl
.fi
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.
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.
.TP 3
interval[s|ms]
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.
interval[s|ms]
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.
.TP 3
count
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.
count
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.
.RE
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
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.
.LP
.LP
\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.
.br
.LP
.SS
VIRTUAL MACHINE IDENTIFIER
.LP
.RS 3
.LP
.LP
The syntax of the \f2vmid\fP string largely corresponds to the syntax of a URI:
.LP
.nf
\f3
.fl
[\fP\f4protocol\fP\f3:][//]\fP\f4lvmid\fP[@\f2hostname\fP][:\f2port\fP][/\f2servername\fP]
.fl
.fi
.LP
.RS 3
.TP 3
protocol
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.
protocol
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.
.TP 3
lvmid
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.
lvmid
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.
.TP 3
hostname
A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
hostname
A hostname or IP address indicating the target host. If \f2hostname\fP is omitted, then the target host is the local host.
.TP 3
port
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.
port
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.
.TP 3
servername
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.
servername
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.
.RE
.LP
.RE
.SH "OPTIONS"
.LP
.LP
.LP
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.
.br
.LP
.LP
\f3NOTE\fP: All options, and their functionality are subject to change or removal in future releases.
.LP
.SS
GENERAL
OPTIONS
GENERAL OPTIONS
.LP
.LP
If you specify one of the general options, you cannot specify any other option or parameter.
.LP
.RS 3
.TP 3
\-help
Display help message.
\-help
Display help message.
.TP 3
\-version
Display version information.
\-version
Display version information.
.TP 3
\-options
Display list of statistics options. See the Output Options section below.
\-options
Display list of statistics options. See the Output Options section below.
.RE
.LP
.SS
OUTPUT
OPTIONS
OUTPUT OPTIONS
.LP
.RS 3
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
Use the \f2interval\fP and \f2count\fP parameters to determine how frequently and how many times, respectively, \f3jstat\fP displays its output.
.LP
.LP
\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.
.LP
.RS 3
.TP 3
\-statOption
\-statOption
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.
.br
.br
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -405,7 +458,7 @@ HotSpot compilation method statistics.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 158 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 231 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -634,39 +687,33 @@ HotSpot compilation method statistics.
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-52
.TP 3
\-hn
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.
\-h n
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.
.TP 3
\-tn
Display a timestamp column as the first column of output. The timestamp is the the time since the start time of the target JVM.
\-t n
Display a timestamp column as the first column of output. The timestamp is the time since the start time of the target JVM.
.TP 3
\-JjavaOption
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:
.RS 3
.TP 2
*
.na
\f2java \- the Java application launcher (Solaris)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html
.TP 2
*
.na
\f2java \- the Java application launcher (Linux)\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/linux/java.html
.TP 2
*
java \- the Java application launcher (Windows)
\-JjavaOption
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)
.RE
.LP
.RE
.SS
STATOPTIONS AND
OUTPUT
STATOPTIONS AND OUTPUT
.LP
.RS 3
.LP
.LP
The following tables summarize the columns that \f3jstat\fP outputs for each \f2statOption\fP.
.br
.LP
.SS
\-class Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -779,7 +826,7 @@ Time spent performing class load and unload operations.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 214 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 281 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -866,9 +913,12 @@ Time spent performing class load and unload operations.
.rm c+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-21
.LP
.SS
\-compiler
Option
\-compiler Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -1033,7 +1083,7 @@ Class name and method for the last failed compilation.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 247 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 317 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -1163,8 +1213,12 @@ Class name and method for the last failed compilation.
.rm f+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-29
.LP
.SS
\-gc Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -1493,7 +1547,7 @@ Total garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 313 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 387 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -1763,8 +1817,12 @@ Total garbage collection time.
.rm n+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-63
.LP
.SS
\-gccapacity Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -2113,7 +2171,7 @@ Number of Young generation GC Events.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 383 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 461 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2400,11 +2458,15 @@ Number of Young generation GC Events.
.rm o+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-67
.LP
.SS
\-gccause
Option
\-gccause Option
.LP
.LP
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:
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -2489,7 +2551,7 @@ Cause of current Garbage Collection.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 402 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 484 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -2551,8 +2613,12 @@ Cause of current Garbage Collection.
.rm b+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-13
.LP
.SS
\-gcnew Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -2801,7 +2867,7 @@ Young generation garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 452 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 538 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3003,8 +3069,12 @@ Young generation garbage collection time.
.rm j+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
.LP
.SS
\-gcnewcapacity Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -3252,7 +3322,7 @@ Number of young generation GC events.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 504 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 594 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3454,8 +3524,12 @@ Number of young generation GC events.
.rm j+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
.LP
.SS
\-gcold Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -3644,7 +3718,7 @@ Total garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 542 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 636 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -3795,8 +3869,12 @@ Total garbage collection time.
.rm g+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
.LP
.SS
\-gcoldcapacity Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -3985,7 +4063,7 @@ Total garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 580 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 678 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -4136,8 +4214,12 @@ Total garbage collection time.
.rm g+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
.LP
.SS
\-gcpermcapacity Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -4326,7 +4408,7 @@ Total garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 618 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 720 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -4477,9 +4559,12 @@ Total garbage collection time.
.rm g+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-35
.LP
.SS
\-gcutil
Option
\-gcutil Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -4708,7 +4793,7 @@ Total garbage collection time.
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 665 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 770 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -4893,8 +4978,12 @@ Total garbage collection time.
.rm i+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-43
.LP
.SS
\-printcompilation Option
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
@ -5003,7 +5092,7 @@ Class name and method name identifying the compiled method. Class name uses "/"
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 687 file Input is too wide - \n(TW units
.if t .if \n(TW>\n(.li .tm Table at line 796 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
@ -5086,16 +5175,26 @@ Class name and method name identifying the compiled method. Class name uses "/"
.rm c+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-19
.LP
.SS
.LP
.SH ""
.LP
.LP
This section presents some examples of monitoring a local JVM with a \f2lvmid\fP of 21891.
.LP
.SS
Using the gcutil option
.LP
.LP
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.
.LP
.nf
\f3jstat \-gcutil 21891 250 7\fP
\f3
.fl
\fP\f3jstat \-gcutil 21891 250 7\fP
.br
.fl
@ -5129,16 +5228,24 @@ This example attaches to \f2lvmid\fP 21891 and takes 7 samples at 250 millisecon
.fl
0.00 7.74 58.11 9.51 96.71 79 0.177 5 0.495 0.673
.br
.fl
.fi
.LP
.LP
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.
.LP
.SS
Repeating the column header
string
Repeating the column header string
.LP
.LP
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.
.LP
.nf
\f3jstat \-gcnew \-h3 21891 250\fP
\f3
.fl
\fP\f3jstat \-gcnew \-h3 21891 250\fP
.br
.fl
@ -5180,18 +5287,27 @@ This example attaches to \f2lvmid\fP 21891 and takes samples at 250 millisecond
.fl
64.0 64.0 0.0 19.0 31 31 32.0 512.0 306.7 251 0.204
.br
.fl
.fi
.LP
.LP
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.
.LP
.LP
Another collection occurs between the 5th and 6th samples. This collection found very few survivors and returned the tenuring threshold to 31.
.LP
.SS
Including a
time stamp for each sample
Including a time stamp for each sample
.LP
.LP
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.
.LP
.nf
\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
\f3
.fl
\fP\f3jstat \-gcoldcapacity \-t 21891 250 3\fP
.br
.fl
@ -5209,37 +5325,56 @@ Timestamp OGCMN OGCMX OGC OC YGC FGC
.fl
150.7 1408.0 60544.0 13820.0 13820.0 194 81 2.938 3.863
.br
.fl
.fi
.LP
.LP
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.
.LP
.SS
Monitor
instrumentation for a remote JVM
Monitor instrumentation for a remote JVM
.LP
.LP
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.
.LP
.nf
\f3jstat \-gcutil 40496@remote.domain 1000\fP
\f3
.fl
\fP\f3jstat \-gcutil 40496@remote.domain 1000\fP
.br
.fl
... \f2output omitted\fP
.br
.fl
.fi
.LP
.LP
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).
.LP
.RE
.SH "SEE ALSO"
.LP
.RS 3
.TP 2
*
java \- the Java Application Launcher
o
java(1) \- the Java Application Launcher
.TP 2
*
jps \- the Java Process Status Application
o
jps(1) \- the Java Process Status Application
.TP 2
*
jstatd \- the jvmstat daemon
o
jstatd(1) \- the jvmstat daemon
.TP 2
*
rmiregistry \- the Java Remote Object Registry
o
rmiregistry(1) \- the Java Remote Object Registry
.RE
.LP
.LP

55
jdk/src/linux/doc/man/jstatd.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH jstatd 1 "05 Aug 2006"
." Generated by html2roff
."
.TH jstatd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
jstatd \- Virtual Machine jstat Daemon
.LP
.SH "SYNOPSIS"
@ -48,9 +45,12 @@ jstatd [ \fP\f4options\fP\f3 ]\fP
.LP
.LP
.RS 3
.TP 3
options
Command\-line options. The options may be in any order. If there are redundant or contradictory options, the last option specified will take precedence.
.RE
.LP
.SH "DESCRIPTION"
.LP
@ -72,6 +72,7 @@ The \f3jstatd\fP server requires the presence of an RMI registry on the local ho
.LP
The \f3jstatd\fP command supports the following options:
.LP
.RS 3
.TP 3
\-nr
Do not attempt to create an internal RMI registry within the \f2jstatd\fP process when an existing RMI registry is not found.
@ -80,10 +81,12 @@ Do not attempt to create an internal RMI registry within the \f2jstatd\fP proces
Port number where the RMI registry is expected to be found, or, if not found, created if \f2\-nr\fP is not specified.
.TP 3
\-n\ rminame
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.
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.
.TP 3
\-Joption
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.
.RE
.LP
.SH "SECURITY"
.LP
@ -141,8 +144,7 @@ jstatd \-J\-Djava.security.policy=jstatd.all.policy\fP
.LP
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.
.LP
.SH "REMOTE
INTERFACE"
.SH "REMOTE INTERFACE"
.LP
.LP
@ -157,8 +159,7 @@ The interface exported by the \f3jstatd\fP process is proprietary and is guarant
Here are some examples of starting \f3jstatd\fP. Note that the \f3jstatd\fP scripts automatically start the server in the background.
.LP
.SS
Using Internal RMI
Registry
Using Internal RMI Registry
.LP
.LP
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).
@ -173,8 +174,7 @@ jstatd \-J\-Djava.security.policy=all.policy
.LP
.SS
Using
External RMI Registry
Using External RMI Registry
.LP
.LP
This example demonstrates starting \f3jstatd\fP with a external RMI registry.
@ -219,8 +219,7 @@ jstatd \-J\-Djava.security.policy=all.policy \-p 2020 \-n AlternateJstatdServerN
.LP
.SS
Inhibiting creation of an in\-process RMI
registry
Inhibiting creation of an in\-process RMI registry
.LP
.LP
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.
@ -235,8 +234,7 @@ jstatd \-J\-Djava.security.policy=all.policy \-nr
.LP
.SS
Enabling RMI
logging capabilities.
Enabling RMI logging capabilities.
.LP
.LP
This example demonstrates starting \f3jstatd\fP with RMI logging capabilities enabled. This technique is useful as a troubleshooting aid or for monitoring server activities.
@ -254,17 +252,20 @@ jstatd \-J\-Djava.security.policy=all.policy \-J\-Djava.rmi.server.logCalls=true
.LP
.RS 3
.TP 2
*
java \- the Java Application Launcher
o
java(1) \- the Java Application Launcher
.TP 2
*
jps \- the Java Process Status Application
o
jps(1) \- the Java Process Status Application
.TP 2
*
jstat \- the Java Virtual Machine Statistics Monitoring Tool
o
jstat(1) \- the Java Virtual Machine Statistics Monitoring Tool
.TP 2
*
rmiregistry \- the Java Remote Object Registry
o
.na
\f2rmiregistry\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#rmi \- the Java Remote Object Registry
.RE
.LP

619
jdk/src/linux/doc/man/keytool.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH keytool 1 "07 Aug 2006"
." Generated by html2man
."
.TH keytool 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
keytool \- Key and Certificate Management Tool
.LP
.RS 3
@ -165,17 +162,19 @@ Below are the defaults for various option values.
.fl
.fl
\-keystore \fP\f4the file named \fP\f4.keystore\fP\f3 in the user's home directory\fP\f3
\-keystore the file named \fP\f4.keystore\fP\f3 in the user's home directory
.fl
.fl
\-storetype \fP\f4the value of the "keystore.type" property in the security properties file,
\-storetype the value of the "keystore.type" property in the security properties file,
.fl
which is returned by the static \fP\f4getDefaultType\fP\f3 method in \fP\f4java.security.KeyStore\fP\f3
which is returned by the static \fP\f4getDefaultType\fP\f3 method in
.fl
\fP\f4java.security.KeyStore\fP\f3
.fl
.fl
\-file \fP\f4stdin if reading, stdout if writing\fP\f3
\-file stdin if reading, stdout if writing
.fl
.fl
@ -187,7 +186,7 @@ Below are the defaults for various option values.
.fi
.LP
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
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
.na
\f2Java Cryptography Architecture API Specification & Reference\fP @
.fi
@ -199,7 +198,7 @@ Common Options
.RS 3
.LP
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.
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.
.LP
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.
.LP
@ -236,9 +235,437 @@ Used in conjunction with \f2\-providerClass\fP. Represents an optional string in
.TP 3
\-protected
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.
.RE
.LP
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.
.TP 3
\-ext {name{:critical}{=value}}
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.
.RS 3
.LP
.LP
Currently keytool supports these named extensions (case\-insensitive):
.LP
.LP
.TS
.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
.de 35
.ps \n(.s
.vs \n(.vu
.in \n(.iu
.if \n(.u .fi
.if \n(.j .ad
.if \n(.j=0 .na
..
.nf
.nr #~ 0
.if n .nr #~ 0.6n
.ds #d .d
.if \(ts\n(.z\(ts\(ts .ds #d nl
.fc
.nr 33 \n(.s
.rm 80 81
.nr 34 \n(.lu
.eo
.am 81
.br
.di a+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
The full form: "ca:{true|false}[,pathlen:<len>]"; or, <len>, a shorthand for "ca:true,pathlen:<len>"; or omitted, means "ca:true"
.br
.di
.nr a| \n(dn
.nr a- \n(dl
..
.ec \
.eo
.am 81
.br
.di b+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
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.
.br
.di
.nr b| \n(dn
.nr b- \n(dl
..
.ec \
.eo
.am 81
.br
.di c+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
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.
.br
.di
.nr c| \n(dn
.nr c- \n(dl
..
.ec \
.eo
.am 80
.br
.di d+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(80 .ll \n(80u
.in 0
SAN or SubjectAlternativeName
.br
.di
.nr d| \n(dn
.nr d- \n(dl
..
.ec \
.eo
.am 81
.br
.di e+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
type:value(,type:value)*, type can be EMAIL, URI, DNS, IP, or OID, value is the string format value for the type.
.br
.di
.nr e| \n(dn
.nr e- \n(dl
..
.ec \
.eo
.am 80
.br
.di f+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(80 .ll \n(80u
.in 0
IAN or IssuerAlternativeName
.br
.di
.nr f| \n(dn
.nr f- \n(dl
..
.ec \
.eo
.am 81
.br
.di g+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
same as SubjectAlternativeName
.br
.di
.nr g| \n(dn
.nr g- \n(dl
..
.ec \
.eo
.am 81
.br
.di h+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
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.
.br
.di
.nr h| \n(dn
.nr h- \n(dl
..
.ec \
.eo
.am 80
.br
.di i+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(80 .ll \n(80u
.in 0
AIA or AuthorityInfoAccess
.br
.di
.nr i| \n(dn
.nr i- \n(dl
..
.ec \
.eo
.am 81
.br
.di j+
.35
.ft \n(.f
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
same as SubjectInfoAccess. method can be "ocsp","caIssuers" or any OID.
.br
.di
.nr j| \n(dn
.nr j- \n(dl
..
.ec \
.35
.nf
.ll \n(34u
.nr 80 0
.nr 38 \w\f3Name\fP
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wBC or BasicConstraints
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wKU or KeyUsage
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wEKU or ExtendedkeyUsage
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \wSIA or SubjectInfoAccess
.if \n(80<\n(38 .nr 80 \n(38
.80
.rm 80
.nr 38 \n(d-
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(f-
.if \n(80<\n(38 .nr 80 \n(38
.nr 38 \n(i-
.if \n(80<\n(38 .nr 80 \n(38
.nr 81 0
.nr 38 \w\f3Value\fP
.if \n(81<\n(38 .nr 81 \n(38
.81
.rm 81
.nr 38 \n(a-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(b-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(c-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(e-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(g-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(h-
.if \n(81<\n(38 .nr 81 \n(38
.nr 38 \n(j-
.if \n(81<\n(38 .nr 81 \n(38
.35
.nf
.ll \n(34u
.nr 38 1n
.nr 79 0
.nr 40 \n(79+(0*\n(38)
.nr 80 +\n(40
.nr 41 \n(80+(3*\n(38)
.nr 81 +\n(41
.nr TW \n(81
.if t .if \n(TW>\n(.li .tm Table at line 288 file Input is too wide - \n(TW units
.fc  
.nr #T 0-1
.nr #a 0-1
.eo
.de T#
.ds #d .d
.if \(ts\n(.z\(ts\(ts .ds #d nl
.mk ##
.nr ## -1v
.ls 1
.ls
..
.ec
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\f3Name\fP\h'|\n(41u'\f3Value\fP
.ne \n(a|u+\n(.Vu
.if (\n(a|+\n(#^-1v)>\n(#- .nr #- +(\n(a|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'BC or BasicConstraints\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.a+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(b|u+\n(.Vu
.if (\n(b|+\n(#^-1v)>\n(#- .nr #- +(\n(b|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'KU or KeyUsage\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.b+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(c|u+\n(.Vu
.if (\n(c|+\n(#^-1v)>\n(#- .nr #- +(\n(c|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'EKU or ExtendedkeyUsage\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.c+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(d|u+\n(.Vu
.ne \n(e|u+\n(.Vu
.if (\n(d|+\n(#^-1v)>\n(#- .nr #- +(\n(d|+\n(#^-\n(#--1v)
.if (\n(e|+\n(#^-1v)>\n(#- .nr #- +(\n(e|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(40u
.in +\n(37u
.d+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.e+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(f|u+\n(.Vu
.ne \n(g|u+\n(.Vu
.if (\n(f|+\n(#^-1v)>\n(#- .nr #- +(\n(f|+\n(#^-\n(#--1v)
.if (\n(g|+\n(#^-1v)>\n(#- .nr #- +(\n(g|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(40u
.in +\n(37u
.f+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.g+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(h|u+\n(.Vu
.if (\n(h|+\n(#^-1v)>\n(#- .nr #- +(\n(h|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'SIA or SubjectInfoAccess\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.h+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.ne \n(i|u+\n(.Vu
.ne \n(j|u+\n(.Vu
.if (\n(i|+\n(#^-1v)>\n(#- .nr #- +(\n(i|+\n(#^-\n(#--1v)
.if (\n(j|+\n(#^-1v)>\n(#- .nr #- +(\n(j|+\n(#^-\n(#--1v)
.ta \n(80u \n(81u
.nr 31 \n(.f
.nr 35 1m
\&\h'|\n(40u'\h'|\n(41u'
.mk ##
.nr 31 \n(##
.sp |\n(##u-1v
.nr 37 \n(40u
.in +\n(37u
.i+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(##u-1v
.nr 37 \n(41u
.in +\n(37u
.j+
.in -\n(37u
.mk 32
.if \n(32>\n(31 .nr 31 \n(32
.sp |\n(31u
.fc
.nr T. 1
.T# 1
.35
.rm a+
.rm b+
.rm c+
.rm d+
.rm e+
.rm f+
.rm g+
.rm h+
.rm i+
.rm j+
.TE
.if \n-(b.=0 .nr c. \n(.c-\n(d.-38
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
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.
.LP
.LP
The subjectKeyIdentifier extension is always created. For non self\-signed certificates, the authorityKeyIdentifier is always created.
.LP
.RE
.RE
.RE
.SH "COMMANDS"
.LP
@ -252,7 +679,15 @@ Creating or Adding Data to the Keystore
.LP
.RS 3
.TP 3
\-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}
\-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}
.LP
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.
.LP
\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.
.LP
\f2ext\fP shows what X.509 extensions will be embedded in the certificate. Read Common Options for the grammar of \f2\-ext\fP.
.TP 3
\-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}
.LP
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.
.LP
@ -262,9 +697,60 @@ Generates a key pair (a public key and associated private key). Wraps the public
.LP
\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.
.LP
\f2valDays\fP tells the number of days for which the certificate should be considered valid.
\f2startdate\fP specifies the issue time of the certificate, also known as the "Not Before" value of the X.509 certificate's Validity field.
.RS 3
.LP
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.
.LP
The option value can be set in one of these two forms:
.LP
.RS 3
.TP 3
1.
.LP
([+\-]\f2nnn\fP[ymdHMS])+
.TP 3
2.
.LP
[yyyy/mm/dd] [HH:MM:SS]
.RE
.LP
.LP
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:
.LP
.RS 3
.LP
.nf
\f3
.fl
Calendar c = new GregorianCalendar();
.fl
c.add(Calendar.YEAR, \-1);
.fl
c.add(Calendar.MONTH, 1);
.fl
c.add(Calendar.DATE, \-1);
.fl
return c.getTime()
.fl
\fP
.fi
.RE
.LP
.LP
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.
.LP
.LP
When the option is not provided, the start date is the current time. The option can be provided at most once.
.LP
.RE
.LP
\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.
.LP
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.
.TP 3
\-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}
.LP
@ -274,7 +760,7 @@ Generates a secret key and stores it in a new \f2KeyStore.SecretKeyEntry\fP iden
.TP 3
\-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}
.LP
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.
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.
.LP
\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".
.LP
@ -299,8 +785,6 @@ Which type of import is intended is indicated by the value of the \f2\-alias\fP
.RE
\f3Importing a New Trusted Certificate\fP
.RS 3
.LP
.LP
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.
.LP
@ -325,7 +809,7 @@ o
\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.
.TP 2
o
\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.
\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.
.RE
.LP
@ -347,6 +831,10 @@ If the \f2srcalias\fP option is not provided, then all entries in the source key
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.
.LP
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.
.TP 3
\-printcertreq {\-file file}
.LP
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.
.RE
.RE
.SS
@ -398,16 +886,20 @@ Displaying Data
.LP
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.
.LP
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
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
.LP
You cannot specify both \f2\-v\fP and \f2\-rfc\fP.
.TP 3
\-printcert {\-file cert_file} {\-v} {\-Jjavaoption}
\-printcert {\-file cert_file | \-sslserver host[:port]} {\-rfc} {\-v} {\-Jjavaoption}
.LP
.LP
Internet RFC 1421 standard.
If \f2\-rfc\fP is specified, keytool prints the certificate in PEM mode as defined by the Internet RFC 1421 standard.
.LP
Note: This option can be used independently of a keystore.
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
.LP
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.
.LP
\f3Note\fP: This option can be used independently of a keystore.
.RE
.LP
@ -606,11 +1098,7 @@ Exporting a Certificate Authenticating Your Public Key
.RS 3
.LP
Suppose you have used the
.na
\f2jarsigner\fP @
.fi
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.
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.
.LP
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":
.LP
@ -676,6 +1164,45 @@ keytool \-importkeystore
.fi
.RE
.LP
.SS
Generating Certificates for a typical SSL Server
.LP
.RS 3
.LP
.LP
Keytool commands to generate keypairs and certificates for three entities, namely, Root CA (root), Intermadiate CA (ca), and SSL server (server) are as follows:
.LP
.nf
\f3
.fl
keytool \-keystore root.jks \-genkeypair \-alias root \-ext bc:c
.fl
keytool \-keystore ca.jks \-alias ca
.fl
keytool \-keystore server.jks \-alias server
.fl
.fl
keytool \-keystore root.jks \-alias root \-exportcert > root.pem
.fl
.fl
keytool \-keystore ca.jks \-certreq \-alias ca | keytool \-keystore root.jks \-gencert \-alias root \-ext BC=0 > ca.pem
.fl
keytool \-keystore ca.jks \-importcert \-alias ca \-file ca.pem
.fl
.fl
keytool \-keystore server.jks \-certreq \-alias server | keytool \-keystore ca.jks \-gencert \-alias ca \-ext ku:c=dig,kE >server.pem
.fl
cat root.pem ca.pem server.pem | keytool \-keystore server.jks \-importcert \-alias server
.fl
\fP
.fi
.RE
.LP
.SH "TERMINOLOGY and WARNINGS"
.LP
@ -759,7 +1286,11 @@ Currently, two command\-line tools (\f3keytool\fP and \f3jarsigner\fP) and a GUI
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.
.LP
.LP
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.
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
.na
\f2How to Implement a Provider for the Java Cryptography Architecture\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/crypto/HowToImplAProvider.html.
.LP
.LP
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.
@ -1132,13 +1663,6 @@ OU="GTE CyberTrust Solutions, Inc.", O=GTE Corporation, C=US
OU=CyberTrust, O=Baltimore, C=IE
.TP 2
*
\f3Alias\fP: gtecybertrustca
.br
\f3Owner DN\fP: CN=GTE CyberTrust Root,
.br
O=GTE Corporation, C=US
.TP 2
*
\f3Alias\fP: gtecybertrust5ca
.br
\f3Owner DN\fP: CN=GTE CyberTrust Root 5,
@ -1370,7 +1894,7 @@ Certificates read by the \f2\-importcert\fP and \f2\-printcert\fP commands can b
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.
.LP
.LP
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.
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.
.LP
.LP
In its printable encoding format, the encoded certificate is bounded at the beginning by
@ -1577,18 +2101,15 @@ If you don't specify a required password option on a command line, you will be p
.RS 3
.TP 2
o
.na
\f2jar\fP @
.fi
http://java.sun.com/javase/6/docs/tooldocs/solaris/jar.html tool documentation
.LP
jar(1) tool documentation
.TP 2
o
.na
\f2jarsigner\fP @
.fi
http://java.sun.com/javase/6/docs/tooldocs/solaris/jarsigner.html tool documentation
.LP
jarsigner(1) tool documentation
.TP 2
o
.LP
the
.na
\f4Security\fP @
@ -1597,7 +2118,7 @@ http://java.sun.com/docs/books/tutorial/security/index.html trail of the
.na
\f4Java Tutorial\fP @
.fi
http://java.sun.com/docs/books/tutorial/trailmap.html for examples of the use of \f3keytool\fP
http://java.sun.com/docs/books/tutorial for examples of the use of \f3keytool\fP
.RE
.LP

20
jdk/src/linux/doc/man/native2ascii.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2002-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH native2ascii 1 "05 Aug 2006"
." Generated by html2roff
.\\" Created by: Doug Kramer, 19\-Aug\-1996
.TH native2ascii 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
native2ascii \- Native\-to\-ASCII Converter
.LP
.RS 3
.LP
.LP
Converts a file with native\-encoded characters (characters which are non\-Latin 1 and non\-Unicode) to one with Unicode\-encoded characters.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -60,6 +59,7 @@ If \f2outputfile\fP is omitted, standard output is used for output. If, in addit
.LP
.LP
.RS 3
.TP 3
\-reverse
Perform the reverse operation: convert a file with Latin\-1 and/or Unicode encoded characters to one with native\-encoded characters.
@ -74,7 +74,9 @@ Specify the encoding name which is used by the conversion procedure. The default
http://java.sun.com/javase/6/docs/technotes/guides/intl/encoding.doc.html document.
.TP 3
\-Joption
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.
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.
.RE
.LP
.LP

58
jdk/src/linux/doc/man/orbd.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH orbd 1 "07 Aug 2006"
." Generated by html2man
."
.TH orbd 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
orbd \- The Object Request Broker Daemon
.LP
.RS 3
@ -36,7 +33,11 @@ orbd \- The Object Request Broker Daemon
\f3orbd\fP is used to enable clients to transparently locate and invoke persistent objects on servers in the CORBA environment.
.LP
.LP
\f3See also:\fP \f2Naming Service\fP
\f3See also:\fP
.na
\f2Naming Service\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.LP
.RE
.SH "SYNOPSIS"
@ -70,10 +71,14 @@ The client needs to lookup the object reference in the Naming Service only once,
.LP
.LP
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.
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.
.LP
.LP
When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to \f2Naming Service\fP.
When \f2orbd\fP starts up, it also starts a naming service. For more information on the naming service, link to
.na
\f2Naming Service\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
.LP
.SH "OPTIONS"
.LP
@ -124,7 +129,7 @@ Specifies how long ORBD waits before sending a location forward exception after
.RS 3
.TP 3
\-Joption
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.
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.
.TP 3
.RE
@ -133,7 +138,15 @@ Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the
.SH "Starting and Stopping the Naming Service"
.LP
.LP
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.
A Naming Service is a CORBA service that allows
.na
\f2CORBA objects\fP @
.fi
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
.na
\f2name binding\fP @
.fi
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.
.LP
.LP
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.
@ -208,18 +221,26 @@ In this example, the Naming Service is running on port 1050 on host "MyHost". An
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.
.LP
.LP
For more information on the Naming Service included with ORBD, see \f2Naming Service\fP.
For more information on the Naming Service included with ORBD, see
.na
\f2Naming Service\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html.
.LP
.SH "Server Manager"
.LP
.LP
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.
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.
.LP
.SS
Server Manager: an Example
.LP
.LP
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:
Using the
.na
\f2sample tutorial\fP @
.fi
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:
.LP
.LP
Start \f2orbd\fP.
@ -339,11 +360,14 @@ To shut down the \f2servertool\fP, type \f2quit\fP and press the \f2Enter\fP key
.RS 3
.TP 2
o
Naming Service
.na
\f2Naming Service\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html
.br
.TP 2
o
servertool
servertool(1)
.RE
.LP

71
jdk/src/linux/doc/man/pack200.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH pack200 1 "05 Aug 2006"
." Generated by html2roff
."
.TH pack200 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
pack200 \- JAR Packing tool
.LP
.SH "SYNOPSIS"
@ -42,6 +39,7 @@ Options may be in any order. The last option on the command line or in a propert
.RS 3
.LP
.RS 3
.TP 3
options
Command\-line options.
@ -51,6 +49,8 @@ Name of the output file.
.TP 3
JAR\-file
Name of the input file.
.RE
.LP
.RE
.SH "DESCRIPTION"
@ -66,11 +66,13 @@ The \f2pack200\fP tool uses several options to fine\-tune and set the compressio
.SS
Typical usage:
.LP
.RS 3
.LP
.LP
\f2% pack200 myarchive.pack.gz myarchive.jar\fP
.LP
.RE
.LP
In this example, \f2myarchive.pack.gz\fP is produced using the default \f2pack200\fP settings.
.LP
@ -178,15 +180,21 @@ The default is \f25\fP, investing a modest amount of time to produce reasonable
.LP
Overrides the default, which preserves the input information, but may cause the transmitted archive to be larger. The possible values are:
.LP
.RS 3
.TP 3
true
.TP 3
false
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.
.RE
.LP
.RS 3
.TP 3
keep
Preserve deflation hints observed in the input JAR. (This is the default.)
.RE
.LP
.RE
.LP
@ -198,12 +206,15 @@ Preserve deflation hints observed in the input JAR. (This is the default.)
.LP
The possible values are:
.LP
.RS 3
.TP 3
latest
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.
.TP 3
keep
Preserves modification times observed in the input JAR. (This is the default.)
.RE
.LP
.RE
.LP
@ -225,6 +236,7 @@ Indicates that a file should be passed through bytewise with no compression. By
.LP
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:
.LP
.RS 3
.TP 3
error
The \f2pack200\fP operation as a whole will fail with a suitable explanation.
@ -234,16 +246,18 @@ The attribute will be dropped. Note: Removing the required VM attributes may cau
.TP 3
pass
Upon encountering this attribute, the entire class will be transmitted as though it is a resource.
.RE
.LP
.RE
.LP
\f4\-Cattribute\-name=\fP\f2layout\fP \f3\-\-class\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Fattribute\-name=\fP\f2layout\fP \f3\-\-field\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Mattribute\-name=\fP\f2layout\fP \f3\-\-method\-attribute=\fP\f2attribute\-name=action\fP
.br
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
\f4\-Dattribute\-name=\fP\f2layout\fP \f3\-\-code\-attribute=\fP\f2attribute\-name=action\fP
.LP
.RS 3
@ -251,6 +265,7 @@ Upon encountering this attribute, the entire class will be transmitted as though
.LP
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:
.LP
.RS 3
.TP 3
some\-layout\-string
The layout language is defined in the JSR 200 specification.
@ -262,6 +277,8 @@ Upon encountering this attribute, the pack200 operation will fail with a suitabl
.TP 3
strip
Upon encountering this attribute, the attribute will be removed from the output. Note: removing VM\-required attributes may cause Class Loader failures.
.RE
.LP
.LP
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.
@ -369,29 +386,29 @@ The following exit values are returned:
.LP
.RS 3
.TP 2
*
unpack200 \- JAR Unpacking Tool
o
unpack200(1)
.TP 2
*
\f2unpack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
o
.na
\f2Java SE Documentation\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
*
Java SE Documentation
.TP 2
*
o
.na
\f2Java Deployment Guide \- Pack200\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
*
\f2jar\fP \- Java Archive Tool
o
jar(1) \- Java Archive Tool
.TP 2
*
.na
\f2jarsigner\fP \- JAR Signer tool @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
o
jarsigner(1) \- JAR Signer tool
.TP 2
o
\f2attributes(5)\fP man page
.RE
.LP
@ -403,6 +420,8 @@ http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
This command should not be confused with \f2pack(1)\fP. They are distinctly separate products.
.LP
.LP
The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
.LP
.LP

26
jdk/src/linux/doc/man/policytool.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,12 +19,11 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH policytool 1 "07 Aug 2006"
." Generated by html2man
.TH policytool 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
policytool \- PolicyTool Administration GUI Utility
.LP
\f3policytool\fP reads and writes a plain text policy file based on user input via the utility GUI.
@ -55,20 +52,14 @@ directs \f2policytool\fP to load a local policy file
filename
The file name
.RE
.RE
.LP
.SH "DESCRIPTION"
.LP
.SH "DESCRIPTION"
.LP
\f3policytool\fP is a GUI that allows users to create and manage policy files. For details, see
.na
\f2the Policytool Users Guide\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
.LP
.SH "OPTIONS"
.LP
http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyGuide.html.
.SH "OPTIONS"
.RS 3
.TP 3
file
@ -95,6 +86,9 @@ http://java.sun.com/javase/6/docs/technotes/guides/security/permissions.html
http://java.sun.com/javase/6/docs/technotes/guides/security/overview/jsoverview.html
.br
.RE
.RE
.LP
.LP

42
jdk/src/linux/doc/man/rmic.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH rmic 1 "05 Aug 2006"
." Generated by html2roff
.TH rmic 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
rmic \- The Java RMI Compiler
.LP
.RS 3
.LP
.LP
\f3rmic\fP generates stub, skeleton, and tie classes for remote objects using either the JRMP or IIOP protocols. Also generates OMG IDL.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -85,6 +84,7 @@ A stub implements only the remote interfaces, not any local interfaces that the
.LP
.LP
.RS 3
.TP 3
\-bootclasspath path
Overrides location of bootstrap class files
@ -137,6 +137,7 @@ Overrides location of installed extensions
.TP 3
\-g
Enables generation of all debugging information, including local variables. By default, only line number information is generated.
.LP
.TP 3
\-idl
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
@ -146,6 +147,7 @@ Causes \f2rmic\fP to generate OMG IDL for the classes specified and any classes
http://www.omg.org/technology/documents/formal/java_language_mapping_to_omg_idl.htm (OMG) document for a complete description.
.LP
When the \f2\-idl\fP option is used, other options also include:
.RS 3
.TP 3
\-always or \-alwaysgenerate
Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
@ -153,13 +155,12 @@ Forces re\-generation even when existing stubs/ties/IDL are newer than the input
\-factory
Uses factory keyword in generated IDL.
.TP 3
\-idlModule\ fromJavaPackage[.class]\
toIDLModule
\-idlModule\ fromJavaPackage[.class]\ toIDLModule
Specifies IDLEntity package mapping. For example:\ \f2\-idlModule foo.bar my::real::idlmod\fP.
.TP 3
\-idlFile\ fromJavaPackage[.class]\
toIDLFile
Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
\-idlFile\ fromJavaPackage[.class]\ toIDLFile
Specifies IDLEntity file mapping. For example:\ \f2\-idlFile test.pkg.X TEST16.idl\fP.\
.RE
.LP
.TP 3
\-iiop
@ -185,6 +186,7 @@ _<interfaceName>_tie.class
.RE
.LP
When the \f2\-iiop\fP option is used, other options also include:
.RS 3
.TP 3
\-always or \-alwaysgenerate
Forces re\-generation even when existing stubs/ties/IDL are newer than the input class.
@ -202,7 +204,8 @@ The \f2PortableServer\fP module for the
.na
\f2Portable Object Adapter\fP @
.fi
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.
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.
.RE
.TP 3
\-J
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.
@ -212,23 +215,29 @@ Retains the generated \f2.java\fP source files for the stub, skeleton, and/or ti
.TP 3
\-nowarn
Turns off warnings. If used the compiler does not print out any warnings.
.LP
.TP 3
\-vcompat
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.
.TP 3
\-verbose
Causes the compiler and linker to print out messages about what classes are being compiled and what class files are being loaded.
.LP
.TP 3
\-v1.1
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).
.LP
.TP 3
\-v1.2
(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.
.RE
.LP
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example,
@ -243,6 +252,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
\fP
.fi
.RE
.RE
.LP
.SH "SEE ALSO"
@ -250,7 +260,11 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.LP
.LP
java, javac, CLASSPATH
java(1), javac(1),
.na
\f2CLASSPATH\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath
.LP
.LP

76
jdk/src/linux/doc/man/rmid.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -20,21 +18,21 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH rmid 1 "05 Aug 2006"
." Generated by html2roff
.\\" Changed by: Ann Wollrath \- JavaSoft East, 2\-Mar\-2000
.\\" Changed by: Jen McGinn \- Jini Technology Software, 6\-Mar\-2000
."
.TH rmid 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
rmid \- The Java RMI Activation System Daemon
.LP
.RS 3
.LP
.LP
\f3rmid\fP starts the activation system daemon that allows objects to be registered and activated in a virtual machine (VM).
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -57,7 +55,7 @@ The \f3rmid\fP tool starts the activation system daemon. The activation system d
.na
\f2Java RMI Specification\fP @
.fi
http://java.sun.com/javase/6/docs/platform/rmi/spec/rmitoc.html and
http://java.sun.com/javase/6/docs/platform/rmi/spec/rmiTOC.html and
.na
\f2Activation tutorials\fP @
.fi
@ -83,10 +81,10 @@ Executing \f2rmid\fP by default
.LP
.RS 3
.TP 2
*
o
starts the Activator and an internal registry on the default port, 1098, and
.TP 2
*
o
binds an \f2ActivationSystem\fP to the name \f2java.rmi.activation.ActivationSystem\fP in this internal registry.
.RE
@ -107,8 +105,7 @@ To specify an alternate port for the registry, you must specify the \f2\-port\fP
starts the activation system daemon and a registry on the registry's default port, 1099.
.LP
.SS
Starting rmid from
inetd/xinetd
Starting rmid from inetd/xinetd
.LP
.LP
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.
@ -121,13 +118,13 @@ If the inherited channel is a \f2ServerSocketChannel\fP instance, then \f2rmid\f
.LP
.RS 3
.TP 2
*
o
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.
.TP 2
*
o
The \f2\-port\fP option is disallowed. If this option is specified, \f2rmid\fP will exit with an error message.
.TP 2
*
o
The \f2\-log\fP option is required. If this option is not specified, \f2rmid\fP will exit with an error message.
.RE
@ -139,6 +136,7 @@ See the man pages for \f2inetd\fP (Solaris) or \f2xinetd\fP (Linux) for details
.LP
.LP
.RS 3
.TP 3
\-C<someCommandLineOption>
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:
@ -170,13 +168,12 @@ Specifies an option that is passed to the \f2java\fP interpreter running \f2rmid
\fP
.fi
.TP 3
\-J\-Dsun.rmi.activation.execPolicy=<policy>
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:
.LP
.RS 3
.TP 2
*
o
\f3default (or if this property is \fP\f4unspecified\fP\f3)\fP
.LP
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.
@ -192,7 +189,8 @@ The default \f2execPolicy\fP allows \f2rmid\fP to execute commands with specific
.LP
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.
.LP
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).
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).
.RS 3
.TP 3
ExecPermission
The \f2ExecPermission\fP class represents permission for \f2rmid\fP to execute a specific \f2command\fP to launch an activation group.
@ -212,8 +210,7 @@ Options support a limited wildcard scheme. An asterisk signifies a wildcard matc
.LP
For example: "*" or "\-Dfoo.*" or "\-Da.b.c=*" is valid, "*foo" or "\-Da*b" or "ab*" is not.
.TP 3
Policy file for
rmid
Policy file for rmid
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.
.LP
An example policy file that grants various execute permissions to \f2rmid\fP is:
@ -224,13 +221,7 @@ grant {
.fl
permission com.sun.rmi.rmid.ExecPermission
.fl
"/files/apps/java/jdk1.2.2/solaris/bin/java";
.fl
.fl
permission com.sun.rmi.rmid.ExecPermission
.fl
"/files/apps/java/jdk1.2.2/solaris/bin/java_g";
"/files/apps/java/jdk1.7.0/solaris/bin/java";
.fl
.fl
@ -260,9 +251,9 @@ grant {
.fl
\fP
.fi
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.
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.
.LP
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.
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.
.LP
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:
.RS 3
@ -272,10 +263,12 @@ To start \f2rmid\fP with a policy file, the \f2java.security.policy\fP property
\f2rmid \-J\-Djava.security.policy=rmid.policy\fP
.LP
.RE
.RE
.TP 2
*
o
.LP
.TP 2
*
o
\f4<policyClassName>\fP
.LP
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.
@ -295,14 +288,16 @@ The \f2policyClassName\fP specifies a public class with a public, no\-argument c
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.
.LP
.TP 2
*
o
\f3none\fP
.LP
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.
.RE
.LP
.TP 3
\-log dir
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.
.LP
.TP 3
\-port port
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:
@ -322,11 +317,13 @@ Specifies the port \f2rmid\fP's registry uses. The activation system daemon bind
.fi
.TP 3
\-stop
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.
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.
.RE
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
.RS 3
.TP 3
CLASSPATH
Used to provide the system a path to user\-defined classes. Directories are separated by colons. For example:
@ -337,6 +334,7 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.fl
\fP
.fi
.RE
.LP
.SH "SEE ALSO"
@ -344,7 +342,11 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.LP
.LP
rmic, CLASSPATH, java
rmic(1),
.na
\f2CLASSPATH\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/index.html#classpath, java(1)
.LP
.LP

22
jdk/src/linux/doc/man/rmiregistry.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH rmiregistry 1 "05 Aug 2006"
." Generated by html2roff
.TH rmiregistry 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
rmiregistry \- The Java Remote Object Registry
.LP
.RS 3
.LP
.LP
The \f3rmiregistry\fP command starts a remote object registry on the specified port on the current host.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -73,24 +72,27 @@ The URL\-based methods of the \f2java.rmi.Naming\fP class operate on a registry
.LP
.LP
.RS 3
.TP 3
\-J
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.
.RE
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
java,
java(1),
.na
\f2java.rmi.registry.LocateRegistry\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/rmi/registry/locateregistry.html and
http://java.sun.com/javase/6/docs/api/java/rmi/registry/LocateRegistry.html and
.na
\f2java.rmi.Naming\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/rmi/naming.html
http://java.sun.com/javase/6/docs/api/java/rmi/Naming.html
.LP
.LP

191
jdk/src/linux/doc/man/schemagen.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,20 +18,18 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH schemagen 1 "07 Aug 2006"
." Generated by html2man
."
.TH schemagen 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.ad c
.SH NAME
schemagen \- Java(TM) Architecture for XML Binding Schema Generator \f3Specification Version:\fP 2.0
.SH "Name"
schemagen \- Java(TM) Architecture for XML Binding Schema Generator
.LP
.LP
\f3Specification Version:\fP 2.1
.br
\f3Reference Implementation (RI) Version:\fP 2.0 ea3
.br
.ad l
\f3Implementation Version:\fP 2.1.3
.LP
.SS
Launching schemagen
@ -45,36 +41,21 @@ The schema generator can be launched using the appropriate \f2schemagen\fP shell
The current schema generator can process either Java source files or class files.
.LP
.LP
We also provide an Ant task to run the schema generator \- see the instructions for using schemagen with Ant.
We also provide an Ant task to run the schema generator \- see the instructions for
.na
\f2using schemagen with Ant\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
.LP
.RS 3
.LP
\f3For Solaris/Linux\fP
.LP
.nf
\f3
.fl
% path/to/jaxb/bin/schemagen.sh Foo.java Bar.java ...
% schemagen.sh Foo.java Bar.java ...
.fl
Note: Writing schema1.xsd
.fl
.fl
\fP
.fi
.LP
\f3For WindowsNT/2000/XP\fP
.LP
.nf
\f3
.fl
> path\\to\\jaxb\\bin\\schemagen.bat Foo.java Bar.java ...
.fl
Note: Writing schema1.xsd
.fl
Note: Writing schema1.xsd
.fl
\fP
.fi
@ -109,8 +90,6 @@ Options:
.fl
\-help : Display this usage message
.fl
.fl
\fP
.fi
.RE
@ -121,145 +100,35 @@ Options:
Generated Resource Files
.LP
.LP
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.
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
.na
\f2the schema generator ant task\fP @
.fi
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html.
.LP
.SH "See Also"
.LP
.RS 3
.TP 2
o
JAXB 2.0:
.RS 3
.TP 2
*
Running the schema generator (schemagen): [
.na
\f2Release Notes\fP @
\f2command\-line instructions\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/ReleaseNotes.html
.TP 2
*
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagen.html,
.na
\f2XJC\fP @
\f2using the SchemaGen Ant task\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/xjc.html
.TP 2
*
.na
\f2XJCTask\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/xjcTask.html
.TP 2
*
.na
\f2SchemaGen\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/schemagen.html
.TP 2
*
.na
\f2schemagenTask\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/schemagenTask.html
.TP 2
*
.na
\f2Sample Apps\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/samples.html
.TP 2
*
.na
\f2Changelog\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/changelog2.html
.RE
https://jaxb.dev.java.net/nonav/2.1.3/docs/schemagenTask.html]
.TP 2
o
JAXB 1.0.x:
.RS 3
.TP 2
*
.na
\f2Release Notes\fP @
\f2Java Architecture for XML Binding (JAXB)\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/jaxb\-1_0.html
.TP 2
*
.na
\f2Changelog\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/changelog.html
.RE
.TP 2
o
JAXB RI Extensions:
.RS 3
.TP 2
*
.na
\f2Runtime Properties\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/vendorProperties.html
.TP 2
*
.na
\f2XJC Customizations\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/vendorCustomizations.html
.TP 2
*
.na
\f2Develop Plugins\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/developPlugins.html
.RE
.TP 2
o
JAXB RI Schema Languages:
.RS 3
.TP 2
*
.na
\f2W3C XML Schema\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#xschema
.TP 2
*
.na
\f2RELAX NG\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#relaxng
.TP 2
*
.na
\f2DTD\fP @
.fi
http://java.sun.com/webservices/docs/2.0/jaxb/vendorSchemaLangs.html#dtd
.RE
.TP 2
o
JAXB Community:
.RS 3
.TP 2
*
.na
\f2Java.net Homepage\fP @
.fi
http://jaxb.dev.java.net
.TP 2
*
.na
\f2Developer interest list\fP @
.fi
https://jaxb.dev.java.net/servlets/ProjectMailingListList
.TP 2
*
.na
\f2FAQ\fP @
.fi
https://jaxb.dev.java.net/faq/index.html
.RE
http://java.sun.com/javase/6/docs/technotes/guides/xml/jaxb/index.html
.RE
.LP
.LP

29
jdk/src/linux/doc/man/serialver.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,19 +19,20 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH serialver 1 "05 Aug 2006"
." Generated by html2roff
.TH serialver 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
serialver \- The Serial Version Command
.LP
.RS 3
.LP
.LP
The \f3serialver\fP command returns the \f2serialVersionUID\fP.
.LP
.RE
.SH "SYNOPSIS"
.LP
@ -49,12 +48,15 @@ The \f3serialver\fP command returns the \f2serialVersionUID\fP.
.RS 3
.LP
.RS 3
.TP 3
options
Command\-line options, as specified in this document.
.TP 3
classnames
One or more class names
.RE
.LP
.RE
.SH "DESCRIPTION"
@ -68,17 +70,22 @@ One or more class names
.LP
.LP
.RS 3
.TP 3
\-classpath <directories and zip/jar files separated
by :>
\-classpath <directories and zip/jar files separated by :>
Set search path for application classes and resources.
.RE
.LP
.RS 3
.TP 3
\-show
Displays a simple user interface. Enter the full class name and press either the Enter key or the Show button to display the serialVersionUID.
.TP 3
\-Joption
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.
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.
.RE
.LP
.SH "NOTES"
.LP
@ -112,7 +119,7 @@ and, if necessary, a security policy can be specified with the following option:
.na
\f2java.io.ObjectStreamClass\fP @
.fi
http://java.sun.com/javase/6/docs/api/java/io/objectstreamclass.html
http://java.sun.com/javase/6/docs/api/java/io/ObjectStreamClass.html
.LP
.LP

59
jdk/src/linux/doc/man/servertool.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -21,17 +19,18 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH servertool 1 "05 Aug 2006"
." Generated by html2roff
.TH servertool 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
servertool \- The Java(TM) IDL Server Tool
.LP
.RS 3
.LP
\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
.RE
.SH "SYNOPSIS"
.LP
@ -65,37 +64,29 @@ The \f2servertool\fP provides the command\-line interface for the application pr
.LP
.LP
.RS 3
.TP 3
\-ORBInitialHost nameserverhost
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.
.TP 3
\-Joption
Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
.na
\f2java a pplication launcher\fP @
.fi
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.
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.
.RE
.LP
.SH "COMMANDS"
.LP
.LP
.RS 3
.TP 3
register \-server\ <server\ class\ name>
\ \-classpath\ <classpath\ to\ server>
[\ \-applicationName\ <application\ name>
\-args\ <args\ to\ server>
\-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM>
\ ]
register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
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).
.TP 3
unregister
\-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
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).
.TP 3
getserverid
\-applicationName\ <application\ name>
getserverid \-applicationName\ <application\ name>
Return the server id that corresponds with an application.
.TP 3
list
@ -107,27 +98,19 @@ List the application names for all servers currently registered with the ORBD.
listactive
List information about all persistent servers that have been launched by the ORBD and are currently running.
.TP 3
locate \-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
[\-endpointType\ <endpointType>\ ]
locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
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.
.TP 3
locateperorb
\-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
[\-orbid\ <ORB\ name>\ ]
locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
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.
.TP 3
orblist \-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
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.
.TP 3
shutdown \-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
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.
.TP 3
startup \-serverid\ <server\ id\ >\ |
\-applicationName\ <application\ name>
startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
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.
.TP 3
help
@ -135,11 +118,13 @@ List all the commands available to the server through the server tool.
.TP 3
quit
Exit the server tool.
.RE
.LP
.SH "SEE ALSO"
.LP
.LP
orbd
orbd(1)
.LP

30
jdk/src/linux/doc/man/tnameserv.1
View File

@ -1,6 +1,4 @@
.'" t
."
." Copyright 2000-2006 Sun Microsystems, Inc. All Rights Reserved.
." Copyright 2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
." This code is free software; you can redistribute it and/or modify it
@ -21,18 +19,17 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH tnameserv 1 "06 Aug 2006"
." Generated by html2man
.TH tnameserv 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
Java IDL: Transient Naming Service \- \f2tnameserv\fP
.LP
.LP
.LP
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
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
.na
\f2Java IDL Naming Service Included with ORBD\fP @
.fi
@ -178,13 +175,12 @@ This command\-line option is available for use with \f2tnameserve\fP:
.RS 3
.LP
.RS 3
.TP 3
\-Joption
Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
.na
\f2java application launcher\fP @
.fi
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.
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.
.RE
.LP
.RE
.SH "Stopping the Java\ IDL Transient Naming Service"
@ -206,15 +202,15 @@ The following sample program illustrates how to add names to the namespace. It i
.fl
\fP\f4Naming Context\fP\f3
.fl
/ \\
/ \\
.fl
/ \\
/ \\
.fl
plans \fP\f4Personal\fP\f3
.fl
/ \\
/ \\
.fl
/ \\
/ \\
.fl
calendar schedule\fP
.fl

52
jdk/src/linux/doc/man/unpack200.1
View File

@ -1,5 +1,3 @@
.'" t
."
." Copyright 2004-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@ -20,13 +18,12 @@
." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
." `
.TH unpack200 1 "05 Aug 2006"
." Generated by html2roff
."
.TH unpack200 1 "04 May 2009"
." Generated from HTML by html2man (author: Eric Armstrong)
.LP
.SH NAME
.SH "Name"
unpack200 \- JAR Unpacking tool
.LP
.SH "SYNOPSIS"
@ -42,12 +39,15 @@ Options may be in any order. The last option on the command line supersedes all
.RS 3
.LP
.RS 3
.TP 3
input\-file
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.
.TP 3
JAR\-file
Name of the output JAR file.
.RE
.LP
.RE
.SH "DESCRIPTION"
@ -72,6 +72,7 @@ In this example, the \f2myarchive.jar\fP is produced from \f2myarchive.pack.gz\f
.SS
Standard Options
.LP
.RS 3
.LP
.LP
@ -84,9 +85,11 @@ Standard Options
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.
.LP
.RE
.RE
.SS
Non\-Standard Options
.LP
.RS 3
.LP
.LP
@ -129,6 +132,7 @@ Specifies quiet operation with no messages.
Specifies a log file to output messages.
.LP
.RE
.RE
.SH "EXIT STATUS"
.LP
@ -150,29 +154,29 @@ The following exit values are returned:
.LP
.RS 3
.TP 2
*
pack200 \- JAR Packing Tool
o
pack200(1)
.TP 2
*
\f2pack200(1)\fP, \f2jar(1)\fP, \f2jarsigner(1)\fP, \f2attributes(5)\fP man pages
o
.na
\f2Java SE Documentation\fP @
.fi
http://java.sun.com/javase/6/docs/index.html
.TP 2
*
Java SE Documentation
.TP 2
*
o
.na
\f2Java Deployment Guide \- Pack200\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/deployment/deployment\-guide/pack200.html
.TP 2
*
\f2jar\fP \- Java Archive Tool
o
jar(1) \- Java Archive Tool
.TP 2
*
.na
\f2jarsigner\fP \- JAR Signer tool @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
o
jarsigner(1) \- JAR Signer tool
.TP 2
o
\f2attributes(5)\fP man page
.RE
.LP
@ -184,6 +188,8 @@ http://java.sun.com/javase/6/docs/technotes/tools/solaris/jarsigner.html
This command should not be confused with \f2unpack(1)\fP. They are distinctly separate products.
.LP
.LP
The Java SE API Specification provided with the SDK is the superseding authority, in case of discrepancies.
The Java SE API Specification provided with the JDK is the superseding authority, in case of discrepancies.
.LP
.LP

881
jdk/src/linux/doc/man/wsgen.1
View File

File diff suppressed because it is too large Load Diff

1072
jdk/src/linux/doc/man/wsimport.1
View File

File diff suppressed because it is too large Load Diff

Some files were not shown because too many files have changed in this diff Show More