提交 e3d8c4a4 编写于 作者: L lana

Merge

......@@ -116,3 +116,4 @@ aa13e7702cd9d8aca9aa38f1227f966990866944 jdk7-b136
d80954a89b49fda47c0c5cace65a17f5a758b8bd jdk7-b139
9315c733fb17ddfb9fb44be7e0ffea37bf3c727d jdk7-b140
63eeefe118da18c75ba3d36266768cd1ccaaca6b jdk7-b141
312612e89ece62633f4809706dec00bcd5fe7c2d jdk7-b142
......@@ -85,8 +85,8 @@ ifdef OPENJDK
else
# make/closed/common/Defs.gmk for closed location of SHARE_JDK_DOC_SRC
IMAGE_DOCLIST_JDK = COPYRIGHT README.html THIRDPARTYLICENSEREADME.txt
IMAGE_DOCLIST_JRE = COPYRIGHT Welcome.html THIRDPARTYLICENSEREADME.txt
IMAGE_DOCLIST_JDK = COPYRIGHT README.html LICENSE THIRDPARTYLICENSEREADME.txt
IMAGE_DOCLIST_JRE = COPYRIGHT Welcome.html LICENSE THIRDPARTYLICENSEREADME.txt
ifeq ($(PLATFORM), windows)
IMAGE_DOCLIST_JRE += README.txt
else
......
......@@ -63,6 +63,20 @@ else # PLATFORM (i.e. solaris & linux)
FILES_c += UnixOperatingSystem_md.c
FILES_export += com/sun/management/UnixOperatingSystem.java
ifeq ($(PLATFORM),solaris)
FILES_c += SolarisOperatingSystem.c
OTHER_LDLIBS += -lkstat
endif # PLATFORM solaris
ifeq ($(PLATFORM),linux)
FILES_c += LinuxOperatingSystem.c
endif # PLATFORM linux
endif # PLATFORM
#
......
......@@ -32,7 +32,9 @@ SUNWprivate_1.1 {
Java_com_sun_management_UnixOperatingSystem_getFreeSwapSpaceSize;
Java_com_sun_management_UnixOperatingSystem_getMaxFileDescriptorCount;
Java_com_sun_management_UnixOperatingSystem_getOpenFileDescriptorCount;
Java_com_sun_management_UnixOperatingSystem_getProcessCpuLoad;
Java_com_sun_management_UnixOperatingSystem_getProcessCpuTime;
Java_com_sun_management_UnixOperatingSystem_getSystemCpuLoad;
Java_com_sun_management_UnixOperatingSystem_getTotalPhysicalMemorySize;
Java_com_sun_management_UnixOperatingSystem_getTotalSwapSpaceSize;
Java_com_sun_management_UnixOperatingSystem_initialize;
......
." Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. 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,43 +19,33 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH appletviewer 1 "02 Jun 2010"
.TH appletviewer 1 "10 May 2011"
.LP
.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
.LP
.LP
\f4appletviewer\fP \f2[\fP \f2options\fP \f2] \fP\f2urls\fP ...
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
The \f3appletviewer\fP command connects to the documents or resources designated by \f2urls\fP and displays each applet referenced by the documents in its own window. Note: if the documents referred to by \f2urls\fP do not reference any applets with the \f2OBJECT\fP, \f2EMBED\fP, or \f2APPLET\fP tag, then \f3appletviewer\fP does nothing. For details on the HTML tags that \f3appletviewer\fP supports, see
.na
\f2AppletViewer Tags\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/tools/appletviewertags.html.
http://download.oracle.com/javase/7/docs/technotes/tools/appletviewertags.html.
.LP
.LP
\f3Note:\fP The \f3appletviewer\fP requires encoded URLs according to the escaping mechanism defined in RFC2396. Only encoded URLs are supported. However, file names must be unencoded, as specified in RFC2396.
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH apt 1 "02 Jun 2010"
.TH apt 1 "10 May 2011"
.LP
.SH "NAME"
......@@ -50,21 +50,17 @@ One or more files that list source files or other options
.SH "DESCRIPTION"
.LP
.LP
The tool \f2apt\fP, annotation processing tool, includes a set of new reflective APIs and supporting infrastructure to process program annotations. The \f2apt\fP reflective APIs provide a build\-time, source\-based, read\-only view of program structure. These reflective APIs are designed to cleanly model the Java(TM) programming language's type system after the addition of generics. First, \f2apt\fP runs annotation processors that can produce new source code and other files. Next, \f2apt\fP can cause compilation of both original and generated source files, easing development. The reflective APIs and other APIs used to interact with the tool are subpackages of \f2com.sun.mirror\fP.
\f3Note\fP: The \f2apt\fP tool and its associated API contained in the package \f2com.sun.mirror\fP have been deprecated since JDK 7 and are planned to be removed in the next major JDK release. Use the options available in the \f2javac(1)\fP tool and the APIs contained in the packages \f2javax.annotation.processing\fP and \f2javax.lang.model\fP to process annotations.
.LP
.LP
The tool \f2apt\fP, annotation processing tool, includes reflective APIs and supporting infrastructure to process program annotations. The \f2apt\fP reflective APIs provide a build\-time, source\-based, read\-only view of program structure. These reflective APIs are designed to cleanly model the Java(TM) programming language's type system after the addition of generics. First, \f2apt\fP runs annotation processors that can produce new source code and other files. Next, \f2apt\fP can cause compilation of both original and generated source files, easing development. The reflective APIs and other APIs used to interact with the tool are subpackages of \f2com.sun.mirror\fP.
.LP
.LP
A fuller discussion of how the tool operates as well as instructions for developing with \f2apt\fP are in
.na
\f4Getting Started with \fP\f4apt\fP. @
.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(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
http://download.oracle.com/javase/7/docs/technotes/guides/apt/GettingStarted.html
.LP
.SH "OPTIONS"
.LP
......@@ -90,6 +86,12 @@ 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
.TP 3
\-version
Print version information.
.TP 3
\-X
Display information about non\-standard options.
.RE
.LP
......@@ -109,10 +111,35 @@ Specify where to find user class files and annotation processor factories. If \f
.LP
Consult the javac(1) man page for information on \f2javac\fP options.
.LP
.SS
Non\-Standard Options
.LP
.RS 3
.TP 3
\-XListAnnotationTypes
List found annotation types.
.TP 3
\-XListDeclarations
List specified and included declarations.
.TP 3
\-XPrintAptRounds
Print information about initial and recursive \f2apt\fP rounds.
.TP 3
\-XPrintFactoryInfo
Print information about which annotations a factory is asked to process.
.TP 3
\-XclassesAsDecls
Treat both class and source files as declarations to process.
.RE
.LP
.LP
\f3Note\fP: Because these options are non\-standard, they are subject to change without notice.
.LP
.SH "NOTES"
.LP
.LP
The functionality of \f2apt\fP has been subsumed by the standard annotation\-processing infrastructure now offered by \f2javac\fP. Support for \f2apt\fP and its associated APIs may be discontinued in some future JDK release.
The \f2apt\fP tool and its associated API contained in the package \f2com.sun.mirror\fP have been deprecated since JDK 7 and are planned to be removed in the next major JDK release. Use the options available in the \f2javac(1)\fP tool and the APIs contained in the packages \f2javax.annotation.processing\fP and \f2javax.lang.model\fP to process annotations.
.LP
.SH "SEE ALSO"
.LP
......
." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. 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,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH extcheck 1 "02 Jun 2010"
.TH extcheck 1 "10 May 2011"
.LP
.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
.LP
.nf
\f3
......@@ -46,8 +40,6 @@ extcheck [ \-verbose ] targetfile.jar
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
The \f3extcheck\fP utility checks a specified Jar file for title and version conflicts with any extensions installed in the Java(TM) SDK. Before installing an extension, you can use this utility to see if the same or a more recent version of the extension is already installed.
......@@ -62,8 +54,6 @@ If no conflict is detected, the return code is \f20\fP.
If the manifest of any jar file in the extensions directory has the same \f2Specification\-title\fP and the same or a newer \f2Specification\-version\fP number, a non\-zero error code is returned. A non\-zero error code is also returned if \f2targetfile.jar\fP does not have the \f2Specification\-title\fP or \f2Specification\-version\fP attributes in its manifest.
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
......@@ -76,8 +66,6 @@ Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
jar(1)
......
此差异已折叠。
." Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH appletviewer 1 "14 Apr 2011"
.TH appletviewer 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH apt 1 "14 Apr 2011"
.TH apt 1 "07 May 2011"
.LP
.SH "NAME"
......@@ -50,7 +50,10 @@ sourcefiles
.SH "説明"
.LP
.LP
注釈処理ツール \f2apt\fP は、新しいリフレクト API とサポートインフラストラクチャーから構成され、プログラム注釈を処理します。\f2apt\fP リフレクト API は、 構築時のソースベースで、プログラム構造に関する読み取り専用ビューを提供します。これらのリフレクト API は、総称を追加した後に、Java(TM) プログラミング言語の型システムを正しくモデル化するように設計されています。最初に、\f2apt\fP は、新しいソースコードと他のファイルを作成する注釈プロセッサを実行します。次に、\f2apt\fP は、元のソースファイルと生成したソースファイルの両方をコンパイルするため、開発が楽になります。ツールとのインタフェースに使用されるリフレクト API などの API は、\f2com.sun.mirror\fP のサブパッケージです。
\f3注\fP: \f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください。
.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 を使用した開発方法については、
......@@ -58,13 +61,6 @@ sourcefiles
\f4「apt 入門」\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/apt/GettingStarted.htmlを参照してください。
.LP
.RS 3
.TP 3
注:
\f2apt\fP の機能は、\f2javac(1)\fP ツールの一部となった注釈処理インフラストラクチャーに組み込まれ、すべての Java コンパイラで使用できるように標準化されました。この新しいインフラストラクチャーは、言語モデルおよび Java プラットフォームの一部となった注釈処理 API に依存します。注釈プロセッサの開発は、新しい API および \f2javac\fP ツールに基づいて行うようお勧めします。
.RE
.LP
.SH "オプション"
.LP
......@@ -143,7 +139,7 @@ javac
.SH "注"
.LP
.LP
\f2apt\fP の機能は、\f2javac\fP により提供される標準注釈処理インフラストラクチャーに組み込まれました。今後の JDK リリースでは、\f2apt\fP および関連する API のサポートが中止する可能性があります
\f2apt\fP ツールと、パッケージ \f2com.sun.mirror\fP に含まれているそれに関連した API は、JDK 7 以降非推奨になっており、JDK の次のメジャーリリースで削除される予定です。\f2javac(1)\fP ツールで利用可能なオプションと、パッケージ \f2javax.annotation.processing\fP および \f2javax.lang.model\fP に含まれている API を使用して、注釈を処理してください
.LP
.SH "関連項目"
.LP
......
." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH extcheck 1 "14 Apr 2011"
.TH extcheck 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH idlj 1 "14 Apr 2011"
.TH idlj 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jar 1 "14 Apr 2011"
.TH jar 1 "07 May 2011"
.LP
.SH "名前"
......
......@@ -19,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jarsigner 1 "14 Apr 2011"
.TH jarsigner 1 "07 May 2011"
.LP
.SH "名前"
......@@ -110,16 +110,16 @@ o
.nf
\f3
.fl
jarsigner \-keystore /working/mystore \-storepass myspass
jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3
.fl
\-keypass dukekeypasswd MyJARFile.jar duke
\-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 MyJARFile.jar duke
.fl
\fP
.fi
.LP
.LP
キーストアはパスワードで保護されているので、ストアのパスワード (上の例では mypass) を指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワード (上の例では dukekeypasswd) を指定する必要があります。 コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。
キーストアはパスワードで保護されているので、ストアのパスワードを指定する必要があります。コマンド行でストアのパスワードを指定しないと、パスワードの入力を求められます。同様に、非公開鍵もキーストア内でパスワードによって保護されているため、非公開鍵のパスワードを指定する必要があります。コマンド行で非公開鍵のパスワードを指定していない、また、指定したパスワートが保存されているパスワードと違っている場合には、非公開鍵のパスワードの入力を求められます。
.LP
.SS
キーストアの場所
......@@ -500,7 +500,7 @@ o
.LP
\f2file\fP に使用できる文字は「a\-zA\-Z0\-9_\-」です。つまり、文字、数字、下線、およびハイフンだけを使用できます。注: .SF および .DSA のファイル名では、小文字はすべて大文字に変換されます。
.LP
\-sigfile \f2オプション\fP を指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
\-sigfile \f2\-sigfile\fP オプションを指定しなかった場合、.SF ファイルと .DSA ファイルのベースファイル名は、コマンド行で指定された別名の先頭の 8 文字をすべて大文字に変換したものになります。別名が 8 文字未満の場合は、別名がそのまま使われます。別名の中に、署名ファイル名に使用できない文字が含まれている場合は、該当する文字を下線 (_) に置き換えてファイル名が作成されます。
.TP 3
\-sigalg algorithm
JAR ファイルの署名に使用する署名アルゴリズムの名前を指定します。
......@@ -609,7 +609,7 @@ jarsigner \-keystore NONE \-storetype PKCS11 \\
\fP
.fi
.TP 3
\-Jjavaoption
できますjavaoption
指定された \f2javaoption\fP 文字列を Java インタプリタに直接渡します。\f3jarsigner\fP は、実際には Java インタプリタに対する「ラッパー」です。このオプションには、空白を含めることはできません。このオプションは、実行環境またはメモリー使用を調整する場合に便利です。使用可能なインタプリタオプションの一覧を表示するには、 \f2java \-h\fP または \f2java \-X\fP とコマンド行から入力します。
.LP
.TP 3
......@@ -676,14 +676,14 @@ JAR
JAR ファイルの署名
.LP
.LP
bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。キーストアは、mystore という名前で、C ドライブの working ディレクトリにあり、キーストアのパスワードは mypass、\f2jane\fP の非公開鍵のパスワードは j638klm とします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
bundle.jar という名前の JAR ファイルがあるとします。このファイルに、キーストアの別名が jane であるユーザーの非公開鍵を使って、署名を付けるとします。この場合、次のコマンドを実行すると、JAR ファイルに署名を付けて sbundle.jar という署名付き JAR ファイルを作成できます。
.LP
.nf
\f3
.fl
jarsigner \-keystore /working/mystore \-storepass myspass
jarsigner \-keystore /working/mystore \-storepass \fP\f4<キーストアのパスワード>\fP\f3
.fl
\-keypass j638klm \-signedjar sbundle.jar bundle.jar jane
\-keypass \fP\f4<非公開鍵のパスワード>\fP\f3 \-signedjar sbundle.jar bundle.jar jane
.fl
\fP
.fi
......@@ -800,7 +800,7 @@ bundle.jar
証明書情報を使った検証
.LP
.LP
検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。次に例を示します。
検証時に \-verify と \-verbose オプションに加えて \f2\-certs\fP オプションを指定した場合は、 および JAR ファイルの各署名者の証明書情報も出力されます。これには、証明書タイプ、署名者識別名情報 (X.509 証明書の場合のみ)、および JAR ファイルの公開鍵の証明書がキーストアエントリの証明書に一致した場合には、括弧で囲まれた署名者のキーストア別名が含まれます。たとえば、
.LP
.nf
\f3
......@@ -862,7 +862,7 @@ bundle.jar
JAR ファイルが、JDK 1.1 の \f3javakey\fP ツールを使って署名されている場合、署名者はアイデンティティーデータベース内の別名です。この場合、検証の出力には i という記号が含まれます。JAR ファイルが、アイデンティティーデータベース内の別名とキーストア内の別名の両方によって署名されている場合は、k と i の両方が表示されます。
.LP
.LP
\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。たとえば、
\f2\-certs\fP オプションを指定した場合、キーストアの別名は括弧で囲まれるのに対し、アイデンティティーデータベース内の別名は角括弧で囲まれて表示されます。次に例を示します。
.LP
.nf
\f3
......@@ -978,7 +978,7 @@ JAR
.fl
この JAR には、このキーストアの別名によって署名されていない署名付きエントリが含まれています
.fl
.fl
\fP
.fi
......@@ -993,7 +993,7 @@ JAR
.nf
\f3
.fl
failure 1
failure 1
.fl
\fP
.fi
......@@ -1649,7 +1649,7 @@ o
.na
\f4jarsigner\fP\f2 ツールの使用例については、\fP @
.fi
http://download.oracle.com/javase/tutorial/index.html
http://download.oracle.com/javase/tutorial/security/index.html
.na
\f2「Java チュートリアル」\fP\f4の\fP @
.fi
......
......@@ -19,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH java 1 "14 Apr 2011"
.TH java 1 "07 May 2011"
.LP
.SH "名前"
......
......@@ -19,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javac 1 "14 Apr 2011"
.TH javac 1 "07 May 2011"
.LP
.SH "名前"
......@@ -136,10 +136,6 @@ o
\f3\-sourcepath\fP オプションが指定されていない場合は、ソースファイルもユーザークラスパスから検索されます。
.LP
\f3\-processorpath\fP オプションが指定されていない場合は、注釈プロセッサもユーザークラスパスから検索されます。
.LP
便宜上、 \f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます。
.LP
たとえば、ディレクトリ \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
インストール型拡張機能の位置をオーバーライドします。
......@@ -315,7 +311,7 @@ o
推奨されるすべての警告を有効にします。このリリースでは、利用可能なすべての警告を有効にすることが推奨されています。
.TP 3
\-Xlint:none
Java 言語仕様では指定されていないすべての警告を無効にします。
すべての警告を無効にします。
.TP 3
\-Xlint:name
警告 \f2name\fP を有効にします。このオプションで有効にできる警告のリストについては、「\-Xlint オプションを使って有効または無効にできる警告」を参照してください。
......@@ -617,7 +613,7 @@ warning: [processing] No processor claimed any of these annotations: Anno
この問題を解決するには、クラス \f2AnnosWithoutProcessors\fP で定義および使用される注釈の名前を \f2Anno\fP から \f2NotAnno\fP に変更します。
.TP 3
rawtypes
raw 型に対する未検査操作について警告します。特にこのオプションは、型引数を持たないパラメータ化された型を使用するユーザーに対して警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。
raw 型に対する未検査操作について警告します。次の文では、 \f2rawtypes\fP 警告が生成されます。
.nf
\f3
.fl
......
此差异已折叠。
." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javah 1 "14 Apr 2011"
.TH javah 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javap 1 "14 Apr 2011"
.TH javap 1 "07 May 2011"
.LP
.SH "名前"
......@@ -33,7 +33,7 @@ javap \- Java
.nf
\f3
.fl
javap [ \fP\f3options\fP\f3 ] class. . .
javap [ \fP\f3options\fP\f3 ] classes
.fl
\fP
.fi
......@@ -42,7 +42,20 @@ javap [ \fP\f3options\fP\f3 ] class. . .
.SH "説明"
.LP
.LP
\f3javap\fP コマンドは、クラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。たとえば、次のクラス宣言をコンパイルするとします。
\f3javap\fP コマンドは、1 つまたは複数のクラスファイルを逆アセンブルします。その出力は指定するオプションにより異なります。オプションを指定しない場合、\f3javap\fP は、そのパッケージ、渡されたクラスの protected および public のフィールドとメソッドを出力します。\f3javap\fP はその出力を標準出力に表示します。
.LP
.RS 3
.TP 3
options
コマンド行オプション。
.TP 3
classes
注釈の処理対象となる 1 つ以上のクラス \f2DocFooter.class\fP など) のリスト (空白区切り)。クラスパスで見つかるクラスは、ファイル名 ( \f2/home/user/myproject/src/DocFooter.class\fP など) または URL ( \f2file:///home/user/myproject/src/DocFooter.class\fP など) で指定できます。
.RE
.LP
.LP
たとえば、次のクラス宣言をコンパイルするとします。
.LP
.nf
\f3
......@@ -88,24 +101,24 @@ public class DocFooter extends Applet {
.LP
.LP
\f3javap DocFooter\fP がもたらす出力は次のようになります。
\f3javap DocFooter.class\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
.fl
Compiled from DocFooter.java
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
java.lang.String date;
.fl
java.lang.String email;
java.lang.String email;
.fl
public DocFooter();
public DocFooter();
.fl
public void init();
public void init();
.fl
public void paint(java.awt.Graphics);
public void paint(java.awt.Graphics);
.fl
}
.fl
......@@ -114,114 +127,116 @@ public class DocFooter extends java.applet.Applet {
.LP
.LP
\f3javap \-c DocFooter\fP がもたらす出力は次のようになります。
\f3javap \-c DocFooter.class\fP がもたらす出力は次のようになります。
.LP
.nf
\f3
.fl
Compiled from DocFooter.java
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
.fl
java.lang.String email;
.fl
public DocFooter();
.fl
public void init();
java.lang.String date;
.fl
public void paint(java.awt.Graphics);
.fl
}
java.lang.String email;
.fl
.fl
Method DocFooter()
public DocFooter();
.fl
Code:
.fl
0 aload_0
0: aload_0
.fl
1 invokespecial #1 <Method java.applet.Applet()>
1: invokespecial #1 // Method java/applet/Applet."<init>":()V
.fl
4 return
4: return
.fl
.fl
Method void init()
public void init();
.fl
0 aload_0
Code:
.fl
1 sipush 500
0: aload_0
.fl
4 bipush 100
1: sipush 500
.fl
6 invokevirtual #2 <Method void resize(int, int)>
4: bipush 100
.fl
9 aload_0
6: invokevirtual #2 // Method resize:(II)V
.fl
10 aload_0
9: aload_0
.fl
11 ldc #3 <String "LAST_UPDATED">
10: aload_0
.fl
13 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
11: ldc #3 // String LAST_UPDATED
.fl
16 putfield #5 <Field java.lang.String date>
13: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
19 aload_0
16: putfield #5 // Field date:Ljava/lang/String;
.fl
20 aload_0
19: aload_0
.fl
21 ldc #6 <String "EMAIL">
20: aload_0
.fl
23 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
21: ldc #6 // String EMAIL
.fl
26 putfield #7 <Field java.lang.String email>
23: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
29 return
26: putfield #7 // Field email:Ljava/lang/String;
.fl
29: return
.fl
.fl
Method void paint(java.awt.Graphics)
public void paint(java.awt.Graphics);
.fl
Code:
.fl
0 aload_1
0: aload_1
.fl
1 new #8 <Class java.lang.StringBuffer>
1: new #8 // class java/lang/StringBuilder
.fl
4 dup
4: dup
.fl
5 invokespecial #9 <Method java.lang.StringBuffer()>
5: invokespecial #9 // Method java/lang/StringBuilder."<init>":()V
.fl
8 aload_0
8: aload_0
.fl
9 getfield #5 <Field java.lang.String date>
9: getfield #5 // Field date:Ljava/lang/String;
.fl
12 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
12: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
15 ldc #11 <String " by ">
15: ldc #11 // String by
.fl
17 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
17: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
20 invokevirtual #12 <Method java.lang.String toString()>
20: invokevirtual #12 // Method java/lang/StringBuilder.toString:()Ljava/lang/String;
.fl
23 bipush 100
23: bipush 100
.fl
25 bipush 15
25: bipush 15
.fl
27 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
27: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
30 aload_1
30: aload_1
.fl
31 aload_0
31: aload_0
.fl
32 getfield #7 <Field java.lang.String email>
32: getfield #7 // Field email:Ljava/lang/String;
.fl
35 sipush 290
35: sipush 290
.fl
38 bipush 15
38: bipush 15
.fl
40 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
40: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
43 return
43: return
.fl
}
.fl
\fP
.fi
......@@ -284,22 +299,7 @@ http://java.sun.com/docs/books/vmspec/
メソッドのスタックサイズ、および \f2locals\fP と \f2args\fP の数を出力します。
.TP 3
\-classpath path
\f3javap\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
\f3javap\fP がクラスを探すために使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。
.TP 3
\-bootclasspath path
ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
......@@ -308,22 +308,6 @@ http://java.sun.com/docs/books/vmspec/
インストールされた拡張機能を検索する場所をオーバーライドします。拡張機能は、デフォルトでは \f2java.ext.dirs\fP にあります。
.RE
.LP
.SH "環境変数"
.LP
.RS 3
.TP 3
CLASSPATH
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.RE
.LP
.SH "関連項目"
.LP
......
." Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2003, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javaws 1 "14 Apr 2011"
.TH javaws 1 "07 May 2011"
.LP
.SH "名前"
......@@ -81,7 +81,7 @@ Java Web Start
\f2\-Xnosplash\fP
.LP
.LP
最初のスプラッシュ画面の表示を無効にします
初期スプラッシュ画面を表示しません
.LP
.LP
\f2\-open <arguments>\fP
......@@ -99,7 +99,7 @@ Java Web Start
\f2\-online\fP
.LP
.LP
オンラインモードで実行します (デフォルトの動作)。
オンラインモードを使用します (デフォルトの動作)。
.LP
.LP
\f2\-wait\fP
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jconsole 1 "14 Apr 2011"
.TH jconsole 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jdb 1 "14 Apr 2011"
.TH jdb 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2006, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jhat 1 "14 Apr 2011"
.TH jhat 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jinfo 1 "14 Apr 2011"
.TH jinfo 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jmap 1 "14 Apr 2011"
.TH jmap 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jps 1 "14 Apr 2011"
.TH jps 1 "07 May 2011"
.LP
.SH "名前"
......
......@@ -19,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jrunscript 1 "14 Apr 2011"
.TH jrunscript 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jsadebugd 1 "14 Apr 2011"
.TH jsadebugd 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jstack 1 "14 Apr 2011"
.TH jstack 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jstat 1 "14 Apr 2011"
.TH jstat 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jstatd 1 "14 Apr 2011"
.TH jstatd 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2008, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jvisualvm 1 "14 Apr 2011"
.TH jvisualvm 1 "07 May 2011"
.LP
.SH "名前"
......@@ -110,7 +110,7 @@ o
.na
\f2Java VisualVM 開発者のサイト\fP @
.fi
https://visualvm.dev.java.net
http://visualvm.java.net
.TP 2
o
.na
......
." Copyright (c) 1998-2010 keytool tool, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1998-2011 keytool tool, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH keytool 1 "14 Apr 2011"
.TH keytool 1 "07 May 2011"
.LP
.SH "名前"
......@@ -1087,9 +1087,9 @@ http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.ht
.fl
keytool \-genkeypair \-dname "cn=Mark Jones, ou=Java, o=Oracle, c=US"
.fl
\-alias business \-keypass kpi135 \-keystore /working/mykeystore
\-alias business \-keypass \fP\f4<非公開鍵の新しいパスワード>\fP\f3 \-keystore /working/mykeystore
.fl
\-storepass ab987c \-validity 180
\-storepass \fP\f4<キーストアの新しいパスワード>\fP\f3 \-validity 180
.fl
\fP
.fi
......@@ -1099,10 +1099,10 @@ http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.ht
注: このコマンドは 1 行に入力しなければなりません。例で複数行に入力しているのは読みやすくするためです。
.LP
.LP
この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアにパスワード ab987c を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
この例では、working ディレクトリに mykeystore という名前のキーストアを作成し (キーストアはまだ存在していないと仮定する)、作成したキーストアに、\f2<キーストアの新しいパスワード>\fP で指定したパスワード を割り当てます。生成する公開鍵と非公開鍵のペアに対応するエンティティーの「識別名」は、通称が「Mark Jones」、組織単位が「Java」、組織が「Oracle」、2 文字の国番号が「US」です。公開鍵と非公開鍵のサイズはどちらも 1024 ビットで、鍵の作成にはデフォルトの DSA 鍵生成アルゴリズムを使用します。
.LP
.LP
このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵にはパスワード「kpi135」が割り当てられます。
このコマンドは、公開鍵と識別名情報を含む自己署名証明書 (デフォルトの SHA1withDSA 署名アルゴリズムを使用) を作成します。証明書の有効期間は 180 日です。 証明書は、別名「business」で特定されるキーストアエントリ内の非公開鍵に関連付けられます。非公開鍵には、\f2<非公開鍵の新しいパスワード>\fP で指定したパスワードが割り当てられます。
.LP
.LP
オプションのデフォルト値を使う場合は、上に示したコマンドを大幅に短くすることができます。実際には、オプションを 1 つも指定せずにコマンドを実行することも可能です。 デフォルト値を持つオプションでは、オプションを指定しなければデフォルト値が使われ、必要な値については入力を求められます。たとえば、単に次のように入力することもできます。
......@@ -1120,7 +1120,7 @@ http://java.sun.com/javase/6/docs/technotes/guides/security/jsse/JSSERefGuide.ht
この場合は、mykey という別名でキーストアエントリが作成され、新しく生成された鍵のペア、および 90 日間有効な証明書がこのエントリに格納されます。このエントリは、ホームディレクトリ内の .keystore という名前のキーストアに置かれます。このキーストアがまだ存在していない場合は、作成されます。識別名情報、キーストアのパスワード、および非公開鍵のパスワードについては、入力を求められます。
.LP
.LP
以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、非公開鍵のパスワードには kpi135 と指定)。
以下では、オプションを指定しないで \f2\-genkeypair\fP コマンドを実行したものとして例を示します。情報の入力を求められた場合は、最初に示した \f2\-genkeypair\fP コマンドの値を入力したものとします (たとえば、識別名には cn=Mark Jones, ou=Java, o=Oracle, c=US と指定)。
.LP
.SS
証明書発行局に対する署名付き証明書の要求
......@@ -1240,14 +1240,14 @@ CA
.fl
\-srcstoretype JKS \-deststoretype PKCS11
.fl
\-srcstorepass changeit \-deststorepass topsecret
\-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3
.fl
\fP
.fi
.LP
.LP
また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。そうすれば、プロンプトのまったく表示されない \f3keytool\fP コマンドを発行できます。これは、\f3keytool\fP コマンドをスクリプトファイルに含める際に非常に便利です。次に例を示します。
また、importkeystore コマンドを使えば、あるソースキーストア内の単一のエントリをターゲットキーストアにインポートすることもできます。この場合、上記の例で示したオプションに加え、インポート対象となる別名を指定する必要があります。srcalias オプションを指定する場合には、ターゲット別名もコマンド行から指定できるほか、秘密/非公開鍵の保護用パスワードやターゲット保護用パスワードも指定できます。その方法を示すコマンドを次に示します。
.LP
.nf
\f3
......@@ -1258,11 +1258,11 @@ CA
.fl
\-srcstoretype JKS \-deststoretype PKCS11
.fl
\-srcstorepass changeit \-deststorepass topsecret
\-srcstorepass \fP\f4<ソースキーストアのパスワード>\fP\f3 \-deststorepass \fP\f4<ターゲットキーストアのパスワード>\fP\f3
.fl
\-srcalias myprivatekey \-destalias myoldprivatekey
.fl
\-srckeypass oldkeypass \-destkeypass mynewkeypass
\-srckeypass \fP\f4<ソースエントリのパスワード>\fP\f3 \-destkeypass \fP\f4<ターゲットエントリのパスワード>\fP\f3
.fl
\-noprompt
.fl
......@@ -1711,7 +1711,7 @@ CN=Steve Meier, OU=Java, O=Oracle, C=US
重要: 信頼できる証明書として証明書をインポートする前に、証明書の内容を慎重に調べてください。
.LP
.LP
まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
まず、証明書の内容を表示し (\-printcert コマンドを使用するか、または \-noprompt オプションを指定しないで \-importcert コマンドを使用)、 コマンドを使用し、 表示された証明書のフィンガープリントが、期待されるフィンガープリントと一致するかどうかを確認します。たとえば、あるユーザーから証明書が送られてきて、この証明書を /tmp/cert という名前でファイルに格納しているとします。 この場合は、信頼できる証明書のリストにこの証明書を追加する前に、 \f2\-printcert\fP コマンドを実行してフィンガープリントを表示できます。たとえば、次のようにします。
.LP
.nf
\f3
......@@ -1744,7 +1744,7 @@ CN=Steve Meier, OU=Java, O=Oracle, C=US
次に、証明書を送信した人物に連絡し、この人物が提示したフィンガープリントと、上のコマンドで表示されたフィンガープリントとを比較します。フィンガープリントが一致すれば、送信途中でほかの何者か (攻撃者など) による証明書のすり替えが行われていないことを確認できます。送信途中でこの種の攻撃が行われていた場合、チェックを行わずに証明書をインポートすると、攻撃者によって署名されたすべてのもの (攻撃的意図を持つクラスファイルを含んだ JAR ファイルなど) を信頼することになります。
.LP
.LP
注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
注: 証明書をインポートする前に必ず \f2\-printcert\fP コマンドを実行しなければならないわけではありません。キーストア内の信頼できる証明書のリストに証明書を追加する前に \f2\-importcert\fP コマンドを実行すると、証明書の情報が表示され、確認を求めるメッセージが表示されます。インポート操作は、この時点で中止できます。ただし、確認メッセージが表示されるのは、\-importcert コマンドを \-noprompt オプションを指定せずに実行した場合だけです。 コマンドを使用し、 \f2\-noprompt\fP オプションが指定されている場合、ユーザーとの対話は行われません。
.LP
.SS
パスワードに関する注意事項
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH native2ascii 1 "14 Apr 2011"
.TH native2ascii 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH orbd 1 "14 Apr 2011"
.TH orbd 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH pack200 1 "14 Apr 2011"
.TH pack200 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH policytool 1 "14 Apr 2011"
.TH policytool 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH rmic 1 "14 Apr 2011"
.TH rmic 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1998, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1998, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH rmid 1 "14 Apr 2011"
.TH rmid 1 "07 May 2011"
.LP
.SH "名前"
......@@ -121,7 +121,7 @@ o
.LP
.LP
必要に応じてサービスを開始するように設定する詳細については、 \f2inetd\fP (Solaris) または \f2xinetd\fP (Linux) のマニュアルページを参照してください。
必要に応じてサービスを開始するように設定する詳細については、 \f2inetd\fP (Solaris の場合)、または \f2xinetd\fP (Linux) のマニュアルページを参照してください。
.LP
.SH "オプション"
.LP
......@@ -239,7 +239,7 @@ grant {
.fl
\fP
.fi
最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンド ( \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
最初に付与されているアクセス権は、 \f2rmid\fP に対し、パス名により明示的に指定される \f2java\fP コマンドの 1.7.0 バージョンの実行を許可します。デフォルトでは、java.home にあるバージョンの \f2java\fP コマンドを使用します。 \f2rmid\fP が使用するのと同じバージョン) が使用されるため、そのコマンドは、ポリシーファイルで指定する必要はありません。2 番目のアクセス権は、 \f2rmid\fP に対して、ディレクトリ \f2/files/apps/rmidcmds\fP 内の任意のコマンドの実行権限を許可します。
.LP
3 番目に付与されているアクセス権 \f2ExecOptionPermission\fP は、 \f2rmid\fP に対して、セキュリティーポリシーファイルを \f2/files/policies/group.policy\fP として定義している起動グループの開始を許可します。次のアクセス権は、起動グループが \f2java.security.debug\fP プロパティーを使用することを許可しています。最後のアクセス権は、起動グループが \f2sun.rmi\fP というプロパティー名の階層内の任意のプロパティーを使用することを許可しています。
.LP
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH rmiregistry 1 "14 Apr 2011"
.TH rmiregistry 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH schemagen 1 "14 Apr 2011"
.TH schemagen 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH serialver 1 "14 Apr 2011"
.TH serialver 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2001, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH servertool 1 "14 Apr 2011"
.TH servertool 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1999, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH tnameserv 1 "14 Apr 2011"
.TH tnameserv 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH unpack200 1 "14 Apr 2011"
.TH unpack200 1 "07 May 2011"
.LP
.SH "名前"
......
." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH wsgen 1 "14 Apr 2011"
.TH wsgen 1 "07 May 2011"
.SH "名前"
wsgen \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
......
." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH wsimport 1 "14 Apr 2011"
.TH wsimport 1 "07 May 2011"
.SH "名前"
wsimport \- XML Web Services (JAX\-WS) 2.0 のための Java(TM) API
.LP
......@@ -818,7 +818,7 @@ https://jax\-ws.dev.java.net/nonav/2.1.1/docs/customizations.html
.ll \n(34u*1u/3u
.if \n(.l<\n(81 .ll \n(81u
.in 0
認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://username:password@example.org/stock?wsdl
認証情報を含むファイルを指定する WSDL URI です。この URI の形式は次のとおりです http://\f2<ユーザー名>\fP:\f2<パスワード>\fP@\f2<ホスト名>\fP/\f2<Web サービス名>\fP?wsdl
.br
.di
.nr b| \n(dn
......@@ -1057,10 +1057,10 @@ W3C \f2EndpointReferenceType\fP
.nf
\f3
.fl
\fP\f3wsimport \-p stockquote http://stockquote.xyz/quote?wsdl\fP
\fP\f3wsimport \-p stockquote http://stockquote.example.com/quote?wsdl\fP
.fl
.fi
.LP
Java アーティファクトを生成し、 \f2http://stockquote.xyz/quote?wsdl\fP をインポートすることで、それらのアーティファクトをコンパイルします。
Java アーティファクトを生成し、 \f2http://stockquote.example.com/quote?wsdl\fP をインポートしてその Java アーティファクトをコンパイルします
.br
." Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2005, 2011, Oracle and/or its affiliates. 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,7 +19,7 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH xjc 1 "14 Apr 2011"
.TH xjc 1 "07 May 2011"
.LP
.ad c
......
." Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1997, 2011, Oracle and/or its affiliates. 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,16 +19,14 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jar 1 "02 Jun 2010"
.TH jar 1 "10 May 2011"
.LP
.SH "Name"
jar\-The Java Archive Tool
.LP
\f3jar\fP combines multiple files into a single JAR archive file.
\f3jar\fP combines multiple files into a single JAR archive file.
.SH "SYNOPSIS"
.LP
.LP
.RS 3
.TP 3
......@@ -51,9 +49,6 @@ Add index to jar file
.LP
.LP
where:
.LP
.RS 3
.LP
.RS 3
.TP 3
......@@ -80,10 +75,7 @@ Option to be passed into the Java runtime environment. (There must be no space b
.RE
.LP
.RE
.SH "DESCRIPTION"
.LP
.LP
The \f3jar\fP tool combines multiple files into a single JAR archive file. \f3jar\fP is a general\-purpose archiving and compression tool, based on ZIP and the
.na
......@@ -92,9 +84,6 @@ The \f3jar\fP tool combines multiple files into a single JAR archive file. \f3ja
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
.RS 3
.LP
.nf
\f3
......@@ -103,19 +92,15 @@ Typical usage to combine files into a jar file is:
.fl
\fP
.fi
.RE
.LP
In this example, all the class files in the current directory are placed into the file named \f2myFile.jar\fP. The jar tool automatically generates a manifest file entry named \f2META\-INF/MANIFEST.MF\fP. It is always the first entry in the jar file. The manifest file declares meta\-information about the archive, and stores that data as \f2name\ :\ value\fP pairs. Refer to the
.na
\f2JAR file specification\fP @
.fi
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.
http://download.oracle.com/javase/7/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
.RS 3
.LP
.nf
\f3
......@@ -124,7 +109,6 @@ If a jar file should include \f2name\ :\ value\fP pairs contained in an existing
.fl
\fP
.fi
.RE
.LP
An existing manifest file must end with a new line character.\ \f3jar\fP does not parse the last line of a manifest file if it does not end with a new line character.
......@@ -135,9 +119,6 @@ An existing manifest file must end with a new line character.\ \f3jar\fP does n
.LP
\f3Note:\ \fP A jar command that specifies \f2cfm\fP on the command line instead of \f2cmf\fP (the order of the m and \-f options are reversed), the \f3jar\fP command line must specify the name of the jar archive first, followed by the name of the manifest file:
.RS 3
.LP
.nf
\f3
.fl
......@@ -145,15 +126,11 @@ An existing manifest file must end with a new line character.\ \f3jar\fP does n
.fl
\fP
.fi
.RE
.LP
The manifest is in a text format inspired by RFC822 ASCII format, so it is easy to view and process manifest\-file contents.
.LP
To extract the files from a jar file, use \f2x\fP:
.LP
.RS 3
.LP
.nf
\f3
......@@ -162,14 +139,10 @@ To extract the files from a jar file, use \f2x\fP:
.fl
\fP
.fi
.RE
.LP
.LP
To extract individual files from a jar file, supply their filenames:
.LP
.RS 3
.LP
.nf
\f3
......@@ -178,7 +151,6 @@ To extract individual files from a jar file, supply their filenames:
.fl
\fP
.fi
.RE
.LP
.LP
......@@ -186,10 +158,7 @@ Beginning with version 1.3 of the JDK, the \f2jar\fP utility supports
.na
\f2JarIndex\fP @
.fi
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
http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR_Index, 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
.nf
\f3
......@@ -198,7 +167,6 @@ http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index, whi
.fl
\fP
.fi
.RE
.LP
.LP
......@@ -209,9 +177,6 @@ The application class loader uses the information stored in this file for effici
.br
.br
To copy directories, first compress files in \f2dir1\fP to \f2stdout\fP, then extract from \f2stdin\fP to \f2dir2\fP (omitting the \f2\-f\fP option from both \f2jar\fP commands):
.LP
.RS 3
.LP
.nf
\f3
......@@ -220,7 +185,6 @@ To copy directories, first compress files in \f2dir1\fP to \f2stdout\fP, then ex
.fl
\fP
.fi
.RE
.LP
.LP
......@@ -228,11 +192,9 @@ To review command samples which use \f2jar\fP to opeate on jar files and jar fil
.na
\f2Java Tutorial\fP @
.fi
http://java.sun.com/docs/books/tutorial/jar.
http://download.oracle.com/javase/tutorial/deployment/jar.
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
......@@ -241,9 +203,6 @@ Creates a new archive file named \f2jarfile\fP (if \f2f\fP is specified) or to s
.TP 3
u
Updates an existing file \f2jarfile\fP (when \f2f\fP is specified) by adding to it files and directories specified by \f2inputfiles\fP. For example:
.RS 3
.LP
.nf
\f3
.fl
......@@ -251,11 +210,7 @@ jar uf foo.jar foo.class
.fl
\fP
.fi
.RE
would add the file \f2foo.class\fP to the existing jar file \f2foo.jar\fP. The \f2\-u\fP option can also update the manifest entry, as given by this example:
.RS 3
.LP
.nf
\f3
.fl
......@@ -263,7 +218,6 @@ jar umf manifest foo.jar
.fl
\fP
.fi
.RE
updates the \f2foo.jar\fP manifest with the \f2name : value\fP pairs in \f2manifest\fP.
.TP 3
x
......@@ -274,9 +228,6 @@ Lists the table of contents from \f2jarfile\fP (if \f2f\fP is specified) or stan
.TP 3
i
Generate index information for the specified \f2jarfile\fP and its dependent jar files. For example:
.RS 3
.LP
.nf
\f3
.fl
......@@ -284,9 +235,8 @@ jar i foo.jar
.fl
\fP
.fi
.RE
.LP
would generate an \f2INDEX.LIST\fP file in \f2foo.jar\fP which contains location information for each package in \f2foo.jar\fP and all the jar files specified in the \f2Class\-Path\fP attribute of \f2foo.jar\fP. See the index example.
would generate an \f2INDEX.LIST\fP file in \f2foo.jar\fP which contains location information for each package in \f2foo.jar\fP and all the jar files specified in the \f2Class\-Path\fP attribute of \f2foo.jar\fP. See the index example.
.TP 3
f
Specifies the file \f2jarfile\fP to be created (\f2c\fP), updated (\f2u\fP), extracted (\f2x\fP), indexed (\f2i\fP), or viewed (\f2t\fP). The \f2\-f\fP option and filename \f2jarfile\fP are a pair \-\- if present, they must both appear. Omitting \f2f\fP and \f2jarfile\fP accepts a jar file name from \f2stdin\fP(for x and t) or sends jar file to \f2stdout\fP (for c and u).
......@@ -301,12 +251,10 @@ M
Do not create a manifest file entry (for c and u), or delete a manifest file entry if one exists (for u).
.TP 3
m
Includes \f2name : value\fP attribute pairs from the specified manifest file \f2manifest\fP in the file at \f2META\-INF/MANIFEST.MF\fP. \f2jar\fP adds a \f2name\ :\ value\fP pair unless an entry already exists with the same name, in which case \f2jar\fP updates its value.
.LP
Includes \f2name : value\fP attribute pairs from the specified manifest file \f2manifest\fP in the file at \f2META\-INF/MANIFEST.MF\fP. \f2jar\fP adds a \f2name\ :\ value\fP pair unless an entry already exists with the same name, in which case \f2jar\fP updates its value.
.br
.br
On the command line, the letters \f3m\fP and \f3f\fP must appear in the same order that \f2manifest\fP and \f2jarfile\fP appear. Example use:
.RS 3
.LP
.nf
\f3
.fl
......@@ -314,22 +262,18 @@ jar cmf myManifestFile myFile.jar *.class
.fl
\fP
.fi
.RE
You can add special\-purpose \f2name\ :\ value\fP attribute pairs to the manifest that aren't contained in the default manifest. For example, you can add attributes specifying vendor information, version information, package sealing, or to make JAR\-bundled applications executable. See the
.na
\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
http://download.oracle.com/javase/tutorial/deployment/jar/ trail in the Java Tutorial for examples of using the \f4\-m\fP option.
.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.
.br
.br
.br
For example, this command creates \f2Main.jar\fP where the \f2Main\-Class\fP attribute value in the manifest is set to \f2Main\fP:
.RS 3
.LP
.nf
\f3
.fl
......@@ -337,12 +281,7 @@ jar cfe Main.jar Main Main.class
.fl
\fP
.fi
.RE
.LP
The java runtime can directly invoke this application by running the following command:
.RS 3
.LP
.nf
\f3
.fl
......@@ -350,11 +289,7 @@ java \-jar Main.jar
.fl
\fP
.fi
.RE
If the entrypoint class name is in a package it may use either a dot (".") or slash ("/") character as the delimiter. For example, if \f2Main.class\fP is in a package called \f2foo\fP the entry point can be specified in the following ways:
.RS 3
.LP
.nf
\f3
.fl
......@@ -362,11 +297,7 @@ jar \-cfe Main.jar foo/Main foo/Main.class
.fl
\fP
.fi
.RE
or
.RS 3
.LP
.nf
\f3
.fl
......@@ -374,18 +305,13 @@ jar \-cfe Main.jar foo.Main foo/Main.class
.fl
\fP
.fi
.RE
\f3Note:\ \fP specifying both \f2\-m\fP and \f2\-e\fP options together when the given manifest also contains the \f2Main\-Class\fP attribute results in an ambigous \f2Main.class\fP specification, leading to an error and the jar creation or update operation is aborted.
.LP
\f3Note:\ \fP specifying both \f2\-m\fP and \f2\-e\fP options together when the given manifest also contains the \f2Main\-Class\fP attribute results in an ambigous \f2Main.class\fP specification, leading to an error and the jar creation or update operation is aborted.
.TP 3
\-C \ dir
\-C\ dir
Temporarily changes directories (\f2cd\fP\ \f2dir\fP) during execution of the \f2jar\fP command while processing the following \f2inputfiles\fP argument. Its operation is intended to be similar to the \f2\-C\fP option of the UNIX \f2tar\fP utility.
.br
.br
For example, this command changes to the \f2classes\fP directory and adds the \f2bar.class\fP from that directory to \f2foo.jar\fP:
.RS 3
.LP
.nf
\f3
.fl
......@@ -393,11 +319,7 @@ jar uf foo.jar \-C classes bar.class
.fl
\fP
.fi
.RE
This command changes to the \f2classes\fP directory and adds to \f2foo.jar\fP all files within the \f2classes\fP directory (without creating a classes directory in the jar file), then changes back to the original directory before changing to the \f2bin\fP directory to add \f2xyz.class\fP to \f2foo.jar\fP.
.RS 3
.LP
.nf
\f3
.fl
......@@ -405,11 +327,7 @@ jar uf foo.jar \-C classes . \-C bin xyz.class
.fl
\fP
.fi
.RE
If \f2classes\fP holds files \f2bar1\fP and \f2bar2\fP, then here's what the jar file will contain using \f2jar tf foo.jar\fP:
.RS 3
.LP
.nf
\f3
.fl
......@@ -425,7 +343,6 @@ xyz.class
.fl
\fP
.fi
.RE
.LP
.TP 3
\-Joption
......@@ -434,8 +351,6 @@ Pass \f2option\fP to the Java runtime environment, where \f2option\fP is one of
.LP
.SH "COMMAND LINE ARGUMENT FILES"
.LP
.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
......@@ -446,9 +361,6 @@ When executing \f2jar\fP, pass in the path and name of each argument file with t
.br
.br
The example below, \f2classes.list\fP holds the names of files output by a \f2find\fP command:
.LP
.RS 3
.LP
.nf
\f3
......@@ -456,14 +368,10 @@ The example below, \f2classes.list\fP holds the names of files output by a \f2fi
% find \fP\f3.\fP \-name '*.class' \-print > classes.list
.fl
.fi
.RE
.LP
.LP
You can then execute the \f2jar\fP command on \f2Classes.list\fP by passing it to \f2jar\fP using argfile syntax:
.LP
.RS 3
.LP
.nf
\f3
......@@ -472,13 +380,9 @@ You can then execute the \f2jar\fP command on \f2Classes.list\fP by passing it t
.fl
\fP
.fi
.RE
.LP
An argument file can specify a path, but any filenames inside the argument file that have relative paths are relative to the current working directory, not to the path passed in. Here is an example:
.RS 3
.LP
.nf
\f3
.fl
......@@ -486,20 +390,14 @@ An argument file can specify a path, but any filenames inside the argument file
.fl
\fP
.fi
.RE
.LP
.LP
.LP
.SH "EXAMPLES"
.LP
.LP
To add all the files in a particular directory to an archive (overwriting contents if the archive already exists). Enumerating verbosely (with the \f2\-v\fP option) will tell you more information about the files in the archive, such as their size and last modified date.
.RS 3
.LP
.nf
\f3
.fl
......@@ -535,13 +433,9 @@ adding: spacemusic.au(in = 3079) (out= 73)(deflated 97%)
.fl
\fP
.fi
.RE
.LP
If you already have separate subdirectories for images, audio files and classes, you can combine them into a single jar file:
.RS 3
.LP
.nf
\f3
.fl
......@@ -585,13 +479,9 @@ audio/ bundle.jar classes/ images/
.fl
\fP
.fi
.RE
.LP
To see the entry names in the jarfile, use the \f2t\fP option:
.RS 3
.LP
.nf
\f3
.fl
......@@ -619,7 +509,6 @@ images/at_work.gif
.fl
\fP
.fi
.RE
.LP
.LP
......@@ -629,9 +518,6 @@ To add an index file to the jar file for speeding up class loading, use the \f2i
Example:
.br
.LP
.RS 3
.LP
If you split the inter\-dependent classes for a stock trade application into three jar files: \f2main.jar\fP, \f2buy.jar\fP, and \f2sell.jar\fP.
.br
......@@ -660,38 +546,34 @@ then you can use the \f2\-i\fP option to speed up the class loading time for you
.fi
.LP
An \f2INDEX.LIST\fP file is inserted to the \f2META\-INF\fP directory. This enables the application class loader to download the specified jar files when it is searching for classes or resources.
.RE
An \f2INDEX.LIST\fP file is inserted to the \f2META\-INF\fP directory. This enables the application class loader to download the specified jar files when it is searching for classes or resources.
.SH "SEE ALSO"
.LP
.LP
.na
\f2The Jar Overview\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jarGuide.html
.br
http://download.oracle.com/javase/7/docs/technotes/guides/jar/jarGuide.html
.LP
.LP
.na
\f2The Jar File Specification\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html
.br
http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html
.LP
.LP
.na
\f2The JarIndex Spec\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jar/jar.html#JAR%20Index
.br
http://download.oracle.com/javase/7/docs/technotes/guides/jar/jar.html#JAR_Index
.LP
.LP
.na
\f2Jar Tutorial\fP @
.fi
http://java.sun.com/docs/books/tutorial/jar on the Java Software web site.
.br
http://download.oracle.com/javase/tutorial/deployment/jar/index.html
.LP
.LP
pack200(1)
.LP
pack200(1)
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. 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,37 +19,27 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javah 1 "02 Jun 2010"
.TH javah 1 "10 May 2011"
.LP
.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
.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 "DESCRIPTION"
.LP
.LP
.LP
\f3javah\fP generates C header and source files that are needed to implement native methods. The generated header and source files are used by C programs to reference an object's instance variables from native source code. The .h file contains a struct definition whose layout parallels the layout of the corresponding class. The fields in the struct correspond to instance variables in the class.
......@@ -63,12 +53,7 @@ By default \f3javah\fP creates a header file for each class listed on the comman
.LP
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 jdb(1).
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
......@@ -110,11 +95,10 @@ For example:
.fl
\fP
.fi
.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
.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.
......@@ -131,8 +115,6 @@ Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the
.LP
.SH "ENVIRONMENT VARIABLES"
.LP
.LP
.RS 3
.TP 3
......@@ -149,8 +131,6 @@ Used to provide the system a path to user\-defined classes. Directories are sepa
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
javac(1), java(1), jdb(1), javap(1), javadoc(1)
......
." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1994, 2011, Oracle and/or its affiliates. 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,41 +19,43 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH javap 1 "02 Jun 2010"
.TH javap 1 "10 May 2011"
.LP
.SH "Name"
javap \- The Java Class File Disassembler
.LP
.RS 3
.LP
.LP
Disassembles class files.
.LP
.RE
.SH "SYNOPSIS"
.LP
.LP
.nf
\f3
.fl
javap [ \fP\f3options\fP\f3 ] class. . .
javap [ \fP\f3options\fP\f3 ] classes
.fl
\fP
.fi
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
The \f3javap\fP command disassembles a class file. Its output depends on the options used. If no options are used, \f3javap\fP prints out the package, protected, and public fields and methods of the classes passed to it. \f3javap\fP prints its output to stdout. For example, compile the following class declaration:
The \f3javap\fP command disassembles one or more class files. Its output depends on the options used. If no options are used, \f3javap\fP prints out the package, protected, and public fields and methods of the classes passed to it. \f3javap\fP prints its output to stdout.
.LP
.RS 3
.TP 3
options
Command\-line options.
.TP 3
classes
List of one or more classes (separated by spaces) to be processed for annotations (such as \f2DocFooter.class\fP). You may specify a class that can be found in the class path, by its file name (for example, \f2/home/user/myproject/src/DocFooter.class\fP), or with a URL (for example, \f2file:///home/user/myproject/src/DocFooter.class\fP).
.RE
.LP
.LP
For example, compile the following class declaration:
.LP
.nf
\f3
......@@ -96,166 +98,160 @@ public class DocFooter extends Applet {
.fl
\fP
.fi
.RE
.LP
.LP
The output from \f3javap DocFooter\fP yields:
.LP
.RS 3
The output from \f3javap DocFooter.class\fP yields:
.LP
.nf
\f3
.fl
Compiled from DocFooter.java
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
java.lang.String date;
.fl
java.lang.String email;
java.lang.String email;
.fl
public DocFooter();
public DocFooter();
.fl
public void init();
public void init();
.fl
public void paint(java.awt.Graphics);
public void paint(java.awt.Graphics);
.fl
}
.fl
\fP
.fi
.RE
.LP
.LP
The output from \f3javap \-c DocFooter\fP yields:
.LP
.RS 3
The output from \f3javap \-c DocFooter.class\fP yields:
.LP
.nf
\f3
.fl
Compiled from DocFooter.java
Compiled from "DocFooter.java"
.fl
public class DocFooter extends java.applet.Applet {
.fl
java.lang.String date;
.fl
java.lang.String email;
.fl
public DocFooter();
.fl
public void init();
java.lang.String date;
.fl
public void paint(java.awt.Graphics);
.fl
}
java.lang.String email;
.fl
.fl
Method DocFooter()
public DocFooter();
.fl
0 aload_0
Code:
.fl
1 invokespecial #1 <Method java.applet.Applet()>
0: aload_0
.fl
4 return
1: invokespecial #1 // Method java/applet/Applet."<init>":()V
.fl
4: return
.fl
.fl
Method void init()
public void init();
.fl
Code:
.fl
0 aload_0
0: aload_0
.fl
1 sipush 500
1: sipush 500
.fl
4 bipush 100
4: bipush 100
.fl
6 invokevirtual #2 <Method void resize(int, int)>
6: invokevirtual #2 // Method resize:(II)V
.fl
9 aload_0
9: aload_0
.fl
10 aload_0
10: aload_0
.fl
11 ldc #3 <String "LAST_UPDATED">
11: ldc #3 // String LAST_UPDATED
.fl
13 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
13: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
16 putfield #5 <Field java.lang.String date>
16: putfield #5 // Field date:Ljava/lang/String;
.fl
19 aload_0
19: aload_0
.fl
20 aload_0
20: aload_0
.fl
21 ldc #6 <String "EMAIL">
21: ldc #6 // String EMAIL
.fl
23 invokevirtual #4 <Method java.lang.String getParameter(java.lang.String)>
23: invokevirtual #4 // Method getParameter:(Ljava/lang/String;)Ljava/lang/String;
.fl
26 putfield #7 <Field java.lang.String email>
26: putfield #7 // Field email:Ljava/lang/String;
.fl
29 return
29: return
.fl
.fl
Method void paint(java.awt.Graphics)
public void paint(java.awt.Graphics);
.fl
0 aload_1
Code:
.fl
1 new #8 <Class java.lang.StringBuffer>
0: aload_1
.fl
4 dup
1: new #8 // class java/lang/StringBuilder
.fl
5 invokespecial #9 <Method java.lang.StringBuffer()>
4: dup
.fl
8 aload_0
5: invokespecial #9 // Method java/lang/StringBuilder."<init>":()V
.fl
9 getfield #5 <Field java.lang.String date>
8: aload_0
.fl
12 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
9: getfield #5 // Field date:Ljava/lang/String;
.fl
15 ldc #11 <String " by ">
12: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
17 invokevirtual #10 <Method java.lang.StringBuffer append(java.lang.String)>
15: ldc #11 // String by
.fl
20 invokevirtual #12 <Method java.lang.String toString()>
17: invokevirtual #10 // Method java/lang/StringBuilder.append:(Ljava/lang/String;)Ljava/lang/StringBuilder;
.fl
23 bipush 100
20: invokevirtual #12 // Method java/lang/StringBuilder.toString:()Ljava/lang/String;
.fl
25 bipush 15
23: bipush 100
.fl
27 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
25: bipush 15
.fl
30 aload_1
27: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
31 aload_0
30: aload_1
.fl
32 getfield #7 <Field java.lang.String email>
31: aload_0
.fl
35 sipush 290
32: getfield #7 // Field email:Ljava/lang/String;
.fl
38 bipush 15
35: sipush 290
.fl
40 invokevirtual #13 <Method void drawString(java.lang.String, int, int)>
38: bipush 15
.fl
43 return
40: invokevirtual #13 // Method java/awt/Graphics.drawString:(Ljava/lang/String;II)V
.fl
43: return
.fl
}
.fl
\fP
.fi
.RE
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
\-help
\-help \-\-help \-?
Prints out help message for \f3javap\fP.
.TP 3
\-version
Prints out version information.
.TP 3
\-l
Prints out line and local variable tables.
.TP 3
......@@ -268,14 +264,11 @@ Shows only protected and public classes and members.
\-package
Shows only package, protected, and public classes and members. This is the default.
.TP 3
\-private
\-private \-p
Shows all classes and members.
.TP 3
\-Jflag
Pass \f2flag\fP directly to the runtime system. Some examples:
.RS 3
.LP
.nf
\f3
.fl
......@@ -285,11 +278,16 @@ javap \-J\-Djava.security.manager \-J\-Djava.security.policy=MyPolicy MyClassNam
.fl
\fP
.fi
.RE
.TP 3
\-s
Prints internal type signatures.
.TP 3
\-sysinfo
Shows system information (path, size, date, MD5 hash) of the class being processed.
.TP 3
\-constants
Shows static final constants.
.TP 3
\-c
Prints out disassembled code, i.e., the instructions that comprise the Java bytecodes, for each of the methods in the class. These are documented in the
.na
......@@ -301,22 +299,7 @@ http://java.sun.com/docs/books/vmspec/.
Prints stack size, number of \f2locals\fP and \f2args\fP for methods.
.TP 3
\-classpath path
Specifies the path \f3javap\fP uses to look up classes. Overrides the default or the CLASSPATH environment variable if it is set. Directories are separated by colons. Thus the general format for \f2path\fP is:
.nf
\f3
.fl
.:<your_path>
.fl
\fP
.fi
For example:
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
Specifies the path \f3javap\fP uses to look up classes. Overrides the default or the CLASSPATH environment variable if it is set.
.TP 3
\-bootclasspath path
Specifies path from which to load bootstrap classes. By default, the bootstrap classes are the classes implementing the core Java platform located in \f2jre/lib/rt.jar\fP and several other jar files.
......@@ -325,32 +308,8 @@ Specifies path from which to load bootstrap classes. By default, the bootstrap c
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:
.RS 3
.LP
.nf
\f3
.fl
.:/home/avh/classes:/usr/local/java/classes
.fl
\fP
.fi
.RE
.RE
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
javac(1), java(1), jdb(1), javah(1), javadoc(1)
......
此差异已折叠。
." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 2004, 2011, Oracle and/or its affiliates. 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,15 +19,13 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jconsole 1 "02 Jun 2010"
.TH jconsole 1 "10 May 2011"
.LP
.SH "Name"
jconsole \- Java Monitoring and Management Console
.LP
.SH "SYNOPSIS"
.LP
.LP
.nf
\f3
......@@ -40,41 +38,40 @@ jconsole \- Java Monitoring and Management Console
.LP
.SH "PARAMETERS"
.LP
.LP
.RS 3
.TP 3
options
Options, if used, should follow immediately after the command name.
.br
.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
.TP 2
o
\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
http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
.TP 2
o
\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
http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
.TP 2
o
\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.
http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.html.
.RE
.RE
.LP
.SH "DESCRIPTION"
.LP
.LP
.LP
The \f3jconsole\fP command launches a graphical console tool that enables you to monitor and manage Java applications and virtual machines on a local or remote machine.
......@@ -83,18 +80,16 @@ The \f3jconsole\fP command launches a graphical console tool that enables you to
On Windows, \f3jconsole\fP does not associate with a console window. It will, however, display a dialog box with error information if the \f3jconsole\fP command fails for some reason.
.LP
.SH "OPTIONS"
.LP
.LP
.RS 3
.TP 3
\-interval=n
Set the update interval to \f2n\fP seconds (default is 4 seconds).
.TP 3
\-notile\
\-notile
Do not tile windows initially (for two or more connections).
.TP 3
\-pluginpath\ plugins
\-pluginpath plugins
Specify a list of directories or JAR files which are searched for JConsole plugins. The \f2plugins\fP path should contain a provider\-configuration file named:
.br
.nf
......@@ -104,20 +99,19 @@ Specify a list of directories or JAR files which are searched for JConsole plugi
.fl
\fP
.fi
.LP
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.
http://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
.TP 3
\-version\
\-version
Output version information and exit.
.TP 3
\-help\
\-help
Output help message and exit.
.TP 3
\-J<flag>\
\-J<flag>
Pass <flag> to the Java virtual machine on which jconsole is run.
.RE
......@@ -130,13 +124,13 @@ o
.na
\f2Using JConsole\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/jconsole.html
http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html
.TP 2
o
.na
\f2Monitoring and Management for Java Platform\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/management/index.html
http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html
.RE
.LP
......
." Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
." Copyright (c) 1995, 2011, Oracle and/or its affiliates. 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,22 +19,16 @@
." or visit www.oracle.com if you need additional information or have any
." questions.
."
.TH jdb 1 "02 Jun 2010"
.TH jdb 1 "10 May 2011"
.LP
.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
.LP
.nf
\f3
......@@ -43,9 +37,6 @@ jdb \- The Java Debugger
.fl
.fi
.LP
.RS 3
.LP
.RS 3
.TP 3
......@@ -60,23 +51,17 @@ Arguments passed to the \f2main()\fP method of \f2class\fP.
.RE
.LP
.RE
.SH "DESCRIPTION"
.LP
.LP
.LP
The Java Debugger, \f3jdb\fP, is a simple command\-line debugger for Java classes. It is a demonstration of the
.na
\f2Java Platform Debugger Architecture\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/index.html that provides inspection and debugging of a local or remote Java Virtual Machine.
http://download.oracle.com/javase/7/docs/technotes/guides/jpda/index.html that provides inspection and debugging of a local or remote Java Virtual Machine.
.LP
.SS
Starting a jdb Session
.LP
.RS 3
.LP
.LP
There are many ways to start a jdb session. The most frequently used way is to have \f3jdb\fP launch a new Java Virtual Machine (VM) with the main class of the application to be debugged. This is done by substituting the command \f3jdb\fP for \f3java\fP in the command line. For example, if your application's main class is MyClass, you use the following command to debug it under JDB:
......@@ -137,7 +122,7 @@ 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 the
http://download.oracle.com/javase/7/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
......@@ -148,9 +133,6 @@ Basic jdb Commands
.LP
.LP
The following is a list of the basic \f3jdb\fP commands. The Java debugger supports other commands which you can list using \f3jdb\fP's \f2help\fP command.
.LP
.RS 3
.LP
.RS 3
.TP 3
......@@ -164,10 +146,12 @@ cont
Continues execution of the debugged application after a breakpoint, exception, or step.
.TP 3
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(1)\fP\f2 \fP\f2\-g\fP option.
.LP
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.
.br
.br
\f2NOTE: To display local variables, the containing class must have been compiled with the \fP\f2javac(1)\fP\f2 \fP\f2\-g\fP option.
.br
.br
\f2print\fP supports many simple Java expressions including those with method invocations, for example:
.RS 3
.TP 2
......@@ -188,15 +172,13 @@ o
.RE
.TP 3
dump
For primitive values, this command is identical to \f2print\fP. For objects, it prints the current value of each field defined in the object. Static and instance fields are included.
.LP
The \f2dump\fP command supports the same set of expressions as the \f2print\fP command.
For primitive values, this command is identical to \f2print\fP. For objects, it prints the current value of each field defined in the object. Static and instance fields are included.
.br
.br
The \f2dump\fP command supports the same set of expressions as the \f2print\fP command.
.TP 3
threads
List the threads that are currently running. For each thread, its name and current status are printed, as well as an index that can be used for other commands, for example:
.RS 3
.LP
.nf
\f3
.fl
......@@ -204,25 +186,21 @@ List the threads that are currently running. For each thread, its name and curre
.fl
\fP
.fi
.RE
In this example, the thread index is 4, the thread is an instance of java.lang.Thread, the thread name is "main", and it is currently running,
.TP 3
thread
Select a thread to be the current thread. Many \f3jdb\fP commands are based on the setting of the current thread. The thread is specified with the thread index described in the \f2threads\fP command above.
.TP 3
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.
\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.
.br
.br
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
Breakpoints can be set in \f3jdb\fP at line numbers or at the first instruction of a method, for example:
......@@ -249,22 +227,14 @@ 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
When an exception occurs for which there isn't a catch statement anywhere in the throwing thread's call stack, the VM normally prints an exception trace and exits. When running under \f3jdb\fP, however, control returns to \f3jdb\fP at the offending throw. You can then use \f3jdb\fP to diagnose the cause of the exception.
......@@ -278,11 +248,7 @@ 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
.LP
.LP
When you use \f3jdb\fP in place of the Java application launcher on the command line, \f3jdb\fP accepts many of the same options as the java command, including \f2\-D\fP, \f2\-classpath\fP, and \f2\-X<option>\fP.
......@@ -335,7 +301,7 @@ Other options are supported for alternate mechanisms for connecting the debugger
.na
\f2documentation\fP @
.fi
http://java.sun.com/javase/6/docs/technotes/guides/jpda/conninv.html on these connection alternatives.
http://download.oracle.com/javase/7/docs/technotes/guides/jpda/conninv.html on these connection alternatives.
.LP
.SS
Options Forwarded to Debuggee Process
......@@ -357,8 +323,6 @@ Non\-standard target VM option
.LP
.SH "SEE ALSO"
.LP
.LP
.LP
javac(1), java(1), javah(1), javap(1), javadoc(1).
......
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
......@@ -131,7 +131,7 @@ progressMonitor=monitor de progreso
# accessible states
#
managesDescendants=gestiona descendientes
indeterminate=indeterminado
indeterminate=indeterminada
truncated=truncado
# new for J2SE 1.6.0
......
......@@ -92,4 +92,39 @@ public interface OperatingSystemMXBean extends
* @return the total amount of physical memory in bytes.
*/
public long getTotalPhysicalMemorySize();
/**
* Returns the "recent cpu usage" for the whole system. This value is a
* double in the [0.0,1.0] interval. A value of 0.0 means that all CPUs
* were idle during the recent period of time observed, while a value
* of 1.0 means that all CPUs were actively running 100% of the time
* during the recent period being observed. All values betweens 0.0 and
* 1.0 are possible depending of the activities going on in the system.
* If the system recent cpu usage is not available, the method returns a
* negative value.
*
* @return the "recent cpu usage" for the whole system; a negative
* value if not available.
* @since 1.7
*/
public double getSystemCpuLoad();
/**
* Returns the "recent cpu usage" for the Java Virtual Machine process.
* This value is a double in the [0.0,1.0] interval. A value of 0.0 means
* that none of the CPUs were running threads from the JVM process during
* the recent period of time observed, while a value of 1.0 means that all
* CPUs were actively running threads from the JVM 100% of the time
* during the recent period being observed. Threads from the JVM include
* the application threads as well as the JVM internal threads. All values
* betweens 0.0 and 1.0 are possible depending of the activities going on
* in the JVM process and the whole system. If the Java Virtual Machine
* recent CPU usage is not available, the method returns a negative value.
*
* @return the "recent cpu usage" for the Java Virtual Machine process;
* a negative value if not available.
* @since 1.7
*/
public double getProcessCpuLoad();
}
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册