mirror of
https://github.com/Tooloop/Tooloop-Packages.git
synced 2026-04-27 20:41:37 +02:00
change folder structure and control files to newest concept
This commit is contained in:
Daniel Stock
@@ -0,0 +1 @@
|
||||
ja_JP.UTF-8
|
||||
+3117
File diff suppressed because it is too large
Load Diff
+215
@@ -0,0 +1,215 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: javaws
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Java Web Startツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "javaws" "1" "2013年11月21日" "JDK 8" "Java Web Startツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
javaws \- Java Web Startを起動します。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjavaws\fR [ \fIrun\-options\fR ] \fIjnlp\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjavaws\fR [ \fIcontrol\-options\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIrun\-options\fR
|
||||
.RS 4
|
||||
コマンド行\fB実行オプション\fR。\fB実行オプション\fRは任意の順序で指定できます。実行オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\fIjnlp\fR
|
||||
.RS 4
|
||||
JNLP (Java Network Launching Protocol)ファイルのパスまたはURL (Uniform Resource Locator)のどちらか。
|
||||
.RE
|
||||
.PP
|
||||
\fI制御オプション\fR
|
||||
.RS 4
|
||||
コマンド行\fB制御オプション\fR。\fB制御オプション\fRは任意の順序で指定できます。制御オプションを参照してください。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fB注意:\fR
|
||||
\fBjavaws\fRコマンドは、Oracle Solarisでは使用できません。
|
||||
.PP
|
||||
\fBjavaws\fRコマンドは、JNLPのリファレンス実装であるJava Web Startを起動します。Java Web Startは、ネットワーク上で動作するJavaアプリケーションおよびアプレットを起動します。
|
||||
.PP
|
||||
JNLPファイルが指定されると、\fBjavaws\fRコマンドはJNLPファイルで指定したJavaアプリケーションまたはアプレットを起動します。
|
||||
.PP
|
||||
\fBjavaws\fR起動ツールには、現在のリリースでサポートされている1組のオプションがあります。ただし、これらのオプションは将来のリリースでは削除される可能性があります。
|
||||
.SH "実行オプション"
|
||||
.PP
|
||||
\-offline
|
||||
.RS 4
|
||||
Java Web Startをオフライン・モードで実行します。
|
||||
.RE
|
||||
.PP
|
||||
\-Xnosplash
|
||||
.RS 4
|
||||
初期スプラッシュ画面を表示しません。
|
||||
.RE
|
||||
.PP
|
||||
\-open \fIarguments\fR
|
||||
.RS 4
|
||||
このオプションを指定すると、JNLPファイル内の引数が\fB\-open\fR
|
||||
\fBarguments\fRに置き換わります。
|
||||
.RE
|
||||
.PP
|
||||
\-print \fIarguments\fR
|
||||
.RS 4
|
||||
このオプションを指定すると、JNLPファイル内の引数が\fB\-print\fR
|
||||
\fBarguments\fRに置き換わります。
|
||||
.RE
|
||||
.PP
|
||||
\-online
|
||||
.RS 4
|
||||
オンライン・モードを使用します。これは、デフォルトの動作です。
|
||||
.RE
|
||||
.PP
|
||||
\-wait
|
||||
.RS 4
|
||||
\fBjavaws\fRプロセスは、アプリケーションが終了するまで終了しません。Windowsプラットフォーム上では、このオプションは説明したとおりに機能しません。
|
||||
.RE
|
||||
.PP
|
||||
\-verbose
|
||||
.RS 4
|
||||
追加の出力を表示します。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
Java Virtual Machineにoptionを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\-system
|
||||
.RS 4
|
||||
アプリケーションをシステム・キャッシュのみから実行します。
|
||||
.RE
|
||||
.SH "制御オプション"
|
||||
.PP
|
||||
\-viewer
|
||||
.RS 4
|
||||
Javaコントロール・パネルでキャッシュ・ビューアを表示します。
|
||||
.RE
|
||||
.PP
|
||||
\-clearcache
|
||||
.RS 4
|
||||
インストールされていないすべてのアプリケーションをキャッシュから削除します。
|
||||
.RE
|
||||
.PP
|
||||
\-userConfig \fIproperty\-name\fR
|
||||
.RS 4
|
||||
指定されたデプロイメント・プロパティをクリアします。
|
||||
.RE
|
||||
.PP
|
||||
\-userConfig \fIproperty\-name property\-value\fR
|
||||
.RS 4
|
||||
指定されたデプロイメント・プロパティを指定された値に設定します。
|
||||
.RE
|
||||
.PP
|
||||
\-uninstall
|
||||
.RS 4
|
||||
キャッシュからすべてのアプリケーションを削除します。
|
||||
.RE
|
||||
.PP
|
||||
\-uninstall \fIjnlp\fR
|
||||
.RS 4
|
||||
キャッシュからアプリケーションを削除します。
|
||||
.RE
|
||||
.PP
|
||||
\-print \fIimport\-options \fRjnlp
|
||||
.RS 4
|
||||
キャッシュにアプリケーションをインポートします。
|
||||
.RE
|
||||
.SH "インポート・オプション"
|
||||
.PP
|
||||
\-silent
|
||||
.RS 4
|
||||
サイレント・モードでインポートします(ユーザー・インタフェースは表示されません)。
|
||||
.RE
|
||||
.PP
|
||||
\-system
|
||||
.RS 4
|
||||
システム・キャッシュにアプリケーションをインポートします。
|
||||
.RE
|
||||
.PP
|
||||
\-codebase \fIurl\fR
|
||||
.RS 4
|
||||
指定したコードベースからリソースを取得します。
|
||||
.RE
|
||||
.PP
|
||||
\-shortcut
|
||||
.RS 4
|
||||
ユーザーがプロンプトを受け入れればショートカットをインストールします。このオプションは、
|
||||
\fB\-silent\fRオプションも使用しないと効果がありません。
|
||||
.RE
|
||||
.PP
|
||||
\-association
|
||||
.RS 4
|
||||
ユーザーがプロンプトを受け入れればアソシエーションをインストールします。このオプションは、
|
||||
\fB\-silent\fRオプションも使用しないと効果がありません。
|
||||
.RE
|
||||
.PP
|
||||
\fB注意:\fR\fBjavaws \-shortcut \-uninstall\fR
|
||||
.SH "ファイル"
|
||||
.PP
|
||||
ユーザーおよびシステム・キャッシュならびにdeployment\&.propertiesファイルの詳細は、デプロイメント構成ファイルおよびプロパティ
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jweb/jcp/properties\&.html)を参照してください
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
Java Web Start
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javaws/index\&.html)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+415
@@ -0,0 +1,415 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: jjs
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2015年3月3日
|
||||
.\" SectDesc: 基本ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "jjs" "1" "2015年3月3日" "JDK 8" "基本ツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
jjs \- Nashornエンジンを呼び出します。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB\fBjjs\fR\fR\fB [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIscript\-files\fR\fR\fB] [\-\- \fR\fB\fIarguments\fR\fR\fB]\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
空白文字で区切られた、\fBjjs\fRコマンドの1つ以上のオプション。詳細は、オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\fIscript\-files\fR
|
||||
.RS 4
|
||||
空白文字で区切られた、Nashornを使用して解釈する1つ以上のスクリプト・ファイル。ファイルが指定されない場合は、対話型シェルが起動されます。
|
||||
.RE
|
||||
.PP
|
||||
\fIarguments\fR
|
||||
.RS 4
|
||||
二重ハイフン・マーカー(\fB\-\-\fR)の後のすべての値が、引数としてスクリプトまたは対話型シェルに渡されます。これらの値には\fBarguments\fRプロパティを使用してアクセスできます(Example 3を参照してください)。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBjjs\fRコマンド行ツールを使用してNashornエンジンを呼び出します。これを使用して、1つまたは複数のスクリプト・ファイルを解釈したり、対話型シェルを実行することができます。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\fBjjs\fRコマンドのオプションはスクリプトがNashornによって解釈される条件を制御します。
|
||||
.PP
|
||||
\-ccs=\fIsize\fR
|
||||
.br
|
||||
\-\-class\-cache\-size=\fIsize\fR
|
||||
.RS 4
|
||||
クラス・キャッシュ・サイズをバイト単位で設定します。キロバイト(KB)を示すために\fBk\fRまたは\fBK\fRの文字を追加し、メガバイト(MB)を示すために\fBm\fRまたは\fBM\fRの文字を追加し、ギガバイト(GB)を示すために\fBg\fRまたは\fBG\fRを追加します。デフォルトでは、クラス・キャッシュ・サイズは50バイトに設定されます。次の例は、1024バイト(1 KB)に設定する方法を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB\-css=100\fR
|
||||
\fB\-css=1k\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-co
|
||||
.br
|
||||
\-\-compile\-only
|
||||
.RS 4
|
||||
スクリプトを実行せずにコンパイルします。
|
||||
.RE
|
||||
.PP
|
||||
\-cp \fIpath\fR
|
||||
.br
|
||||
\-classpath \fIpath\fR
|
||||
.RS 4
|
||||
サポートするクラスへのパスを指定します。複数のパスを設定するには、このオプションを繰り返すか、または各パスをコロン(:)で区切ります。
|
||||
.RE
|
||||
.PP
|
||||
\-D\fIname\fR=\fIvalue\fR
|
||||
.RS 4
|
||||
プロパティ名に値を割り当てることで、スクリプトに渡すシステム・プロパティを設定します。次の例で、対話型モードでNashornを呼び出して、\fBmyValue\fRを\fBmyKey\fRという名前のプロパティに割り当てる方法を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs \-DmyKey=myValue\fR\fR
|
||||
\fBjjs> \fR\fB\fBjava\&.lang\&.System\&.getProperty("myKey")\fR\fR
|
||||
\fBmyValue\fR
|
||||
\fBjjs>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
このオプションを繰り返し使用すると、複数のプロパティを設定できます。
|
||||
.RE
|
||||
.PP
|
||||
\-d=\fIpath\fR
|
||||
.br
|
||||
\-\-dump\-debug\-dir=\fIpath\fR
|
||||
.RS 4
|
||||
クラス・ファイルをダンプするディレクトリへのパスを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-debug\-lines
|
||||
.RS 4
|
||||
クラス・ファイル内の行番号表を生成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-debug\-lines=false\fRを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-debug\-locals
|
||||
.RS 4
|
||||
クラス・ファイル内のローカル変数を生成します。
|
||||
.RE
|
||||
.PP
|
||||
\-doe
|
||||
.br
|
||||
\-\-dump\-on\-error
|
||||
.RS 4
|
||||
エラーが発生したときに、フル・スタック・トレースを提供します。デフォルトでは、簡単なエラー・メッセージのみが出力されます。
|
||||
.RE
|
||||
.PP
|
||||
\-\-early\-lvalue\-error
|
||||
.RS 4
|
||||
無効な左辺値式が早期エラーとして(つまり、コードが解析されるときに)報告されます。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-early\-lvalue\-error=false\fRを指定します。無効な場合、無効な左辺値式はコードが実行されるまで報告されません。
|
||||
.RE
|
||||
.PP
|
||||
\-\-empty\-statements
|
||||
.RS 4
|
||||
空の文をJavaの抽象構文ツリーに保存します。
|
||||
.RE
|
||||
.PP
|
||||
\-fv
|
||||
.br
|
||||
\-\-fullversion
|
||||
.RS 4
|
||||
完全なNashornバージョン文字列を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-function\-statement\-error
|
||||
.RS 4
|
||||
関数の宣言が文として使用されるとエラー・メッセージが出力されます。
|
||||
.RE
|
||||
.PP
|
||||
\-\-function\-statement\-warning
|
||||
.RS 4
|
||||
関数の宣言が文として使用されると警告メッセージが出力されます。
|
||||
.RE
|
||||
.PP
|
||||
\-fx
|
||||
.RS 4
|
||||
スクリプトをJavaFXアプリケーションとして起動します。
|
||||
.RE
|
||||
.PP
|
||||
\-h
|
||||
.br
|
||||
\-help
|
||||
.RS 4
|
||||
オプションのリストとその説明を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
指定した\fBjava\fR起動オプションをJVMに渡します。次の例で、対話型モードでNashornを呼び出して、JVMによって使用される最大メモリーを4 GBに設定する方法を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs \-J\-Xmx4g\fR\fR
|
||||
\fBjjs> \fR\fB\fBjava\&.lang\&.Runtime\&.getRuntime()\&.maxMemory()\fR\fR
|
||||
\fB3817799680\fR
|
||||
\fBjjs>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
このオプションを繰り返し使用すると、複数の\fBjava\fRコマンド・オプションを渡すことができます。
|
||||
.RE
|
||||
.PP
|
||||
\-\-language=[es5]
|
||||
.RS 4
|
||||
ECMAScript言語バージョンを指定します。デフォルトのバージョンはES5です。
|
||||
.RE
|
||||
.PP
|
||||
\-\-lazy\-compilation
|
||||
.RS 4
|
||||
レイジー・コード生成戦略(つまり、スクリプト全体が一度にコンパイルされない)を有効にします。このオプションは試験的なものです。
|
||||
.RE
|
||||
.PP
|
||||
\-\-loader\-per\-compile
|
||||
.RS 4
|
||||
コンパイルごとに新しいクラス・ローダーを作成します。デフォルトでは、このオプションは有効になっています。無効にするには\fB\-\-loader\-per\-compile=false\fRを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-log=\fIsubsystem\fR:\fIlevel\fR
|
||||
.RS 4
|
||||
指定されたサブシステムに対して、特定のレベルでロギングを実行します。カンマで区切って複数のサブシステムのロギング・レベルを指定できます。次に例を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB\-\-log=fields:finest,codegen:info\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-\-optimistic\-types=[true|false]
|
||||
.RS 4
|
||||
再コンパイルの最適化を解除してオプティミスティック・タイプ仮定を有効または無効にします。オプティミスティック・タイプを使用した実行によって最終的な速度が向上しますが、ウォームアップ時間が増える場合があります。
|
||||
.RE
|
||||
.PP
|
||||
\-\-package=\fIname\fR
|
||||
.RS 4
|
||||
生成されたクラス・ファイルを追加するパッケージを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-parse\-only
|
||||
.RS 4
|
||||
コンパイルせずにコードを解析します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-ast
|
||||
.RS 4
|
||||
抽象構文ツリーを出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-code
|
||||
.RS 4
|
||||
バイトコードを出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-lower\-ast
|
||||
.RS 4
|
||||
掘り下げた抽象構文ツリーを出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-lower\-parse
|
||||
.RS 4
|
||||
掘り下げた解析ツリーを出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-no\-newline
|
||||
.RS 4
|
||||
その他の\fB\-\-print*\fRオプションで強制的に1行で出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-parse
|
||||
.RS 4
|
||||
解析ツリーを出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-\-print\-symbols
|
||||
.RS 4
|
||||
記号表を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-pcs
|
||||
.br
|
||||
\-\-profile\-callsites
|
||||
.RS 4
|
||||
呼び出しサイトのプロファイル・データをダンプします。
|
||||
.RE
|
||||
.PP
|
||||
\-scripting
|
||||
.RS 4
|
||||
シェルのスクリプト機能を有効にします。
|
||||
.RE
|
||||
.PP
|
||||
\-\-stderr=\fIfilename\fR|\fIstream\fR|\fItty\fR
|
||||
.RS 4
|
||||
標準エラー・ストリームを指定したファイル、ストリーム(たとえば\fBstdout\fR)に、またはテキスト端末にリダイレクトします。
|
||||
.RE
|
||||
.PP
|
||||
\-\-stdout=\fIfilename\fR|\fIstream\fR|\fItty\fR
|
||||
.RS 4
|
||||
標準出力ストリームを指定したファイル、ストリーム(たとえば\fBstderr\fR)に、またはテキスト端末にリダイレクトします。
|
||||
.RE
|
||||
.PP
|
||||
\-strict
|
||||
.RS 4
|
||||
標準(ECMAScript Edition 5\&.1)への準拠を強化するstrictモードを有効にし、これにより共通のコーディング・エラーを簡単に検出できるようになります。
|
||||
.RE
|
||||
.PP
|
||||
\-t=\fIzone\fR
|
||||
.br
|
||||
\-timezone=\fIzone\fR
|
||||
.RS 4
|
||||
スクリプトの実行に対し指定したタイムゾーンを設定します。OSで設定されたタイムゾーンをオーバーライドし、\fBDate\fRオブジェクトで使用されます。
|
||||
.RE
|
||||
.PP
|
||||
\-tcs=\fIparameter\fR
|
||||
.br
|
||||
\-\-trace\-callsites=\fIparameter\fR
|
||||
.RS 4
|
||||
呼出しサイトのトレースのモードを有効にします。使用可能なパラメータは、次のとおりです。
|
||||
.PP
|
||||
miss
|
||||
.RS 4
|
||||
呼出しサイトのミスをトレースします。
|
||||
.RE
|
||||
.PP
|
||||
enterexit
|
||||
.RS 4
|
||||
呼出しサイトへの出入りをトレースします。
|
||||
.RE
|
||||
.PP
|
||||
objects
|
||||
.RS 4
|
||||
オブジェクトのプロパティを出力します。
|
||||
.RE
|
||||
.RE
|
||||
.PP
|
||||
\-\-verify\-code
|
||||
.RS 4
|
||||
バイトコードを実行する前に検証します。
|
||||
.RE
|
||||
.PP
|
||||
\-v
|
||||
.br
|
||||
\-version
|
||||
.RS 4
|
||||
Nashornバージョン文字列を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-xhelp
|
||||
.RS 4
|
||||
コマンドライン・オプションの拡張ヘルプを出力します。
|
||||
.RE
|
||||
.SH "例"
|
||||
.PP
|
||||
\fB例 1 \fRNashornを使用したスクリプトの実行
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjjs script\&.js\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\fB例 2 \fR対話型モードでのNashornの実行
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs\fR\fR
|
||||
\fBjjs> \fR\fB\fBprintln("Hello, World!")\fR\fR
|
||||
\fBHello, World!\fR
|
||||
\fBjjs> \fR\fB\fBquit()\fR\fR
|
||||
\fB>>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\fB例 3 \fRNashornへの引数の渡し
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs \-\- a b c\fR\fR
|
||||
\fBjjs> \fR\fB\fBarguments\&.join(", ")\fR\fR
|
||||
\fBa, b, c\fR
|
||||
\fBjjs>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.PP
|
||||
\fBjrunscript\fR
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+2229
File diff suppressed because it is too large
Load Diff
+266
@@ -0,0 +1,266 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: orbd
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Java IDLおよびRMI-IIOPツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "orbd" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
orbd \- CORBA環境のサーバーにある永続オブジェクトをクライアントから検索して呼び出せるようにします。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBorbd\fR [ \fIoptions\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
コマンド行オプション。オプションを参照してください。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
ネーミング・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーミング・サービスのサーバーによってネーミング・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDが正しいオブジェクト参照を返します。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。
|
||||
.RE
|
||||
.PP
|
||||
ORBDのサーバー・マネージャにアクセスするには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。
|
||||
.PP
|
||||
\fBorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-ORBInitialPort \fInameserverport\fR
|
||||
.RS 4
|
||||
必須。ネーム・サーバーを起動するポートの番号を指定します。\fBorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。
|
||||
.RE
|
||||
.SS "必須でないオプション"
|
||||
.PP
|
||||
\-port \fIport\fR
|
||||
.RS 4
|
||||
ORBDを起動するポートを指定します。このポートで、永続オブジェクトに対するリクエストをORBDが受け取ります。このポートのデフォルト値は1049です。このポート番号は、永続Interoperable Object References (IOR)のポート・フィールドに追加されます。
|
||||
.RE
|
||||
.PP
|
||||
\-defaultdb \fIdirectory\fR
|
||||
.RS 4
|
||||
ORBD永続格納ディレクトリ\fBorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fB\&./orb\&.db\fRになります。
|
||||
.RE
|
||||
.PP
|
||||
\-serverPollingTime \fImilliseconds\fR
|
||||
.RS 4
|
||||
\fBservertool\fRを使用して登録された永続サーバーが正常に動作していることをORBDが確認する間隔を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。
|
||||
.RE
|
||||
.PP
|
||||
\-serverStartupDelay milliseconds
|
||||
.RS 4
|
||||
\fBservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fBmilliseconds\fRに指定する値は、有効な正の整数にする必要があります。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
|
||||
.RE
|
||||
.SS "ネーミング・サービスの起動と停止"
|
||||
.PP
|
||||
ネーミング・サービスは、CORBAオブジェクトにネーミングを可能にするCORBAサービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。ネーム・バインディングをネーミング・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。
|
||||
.PP
|
||||
クライアントまたはサーバーを実行する前に、ORBDを起動します。ORBDには、永続ネーミング・サービスおよび一時ネーミング・サービスが組み込まれています。これらはどちらもCOSネーミング・サービスの実装です。
|
||||
.PP
|
||||
永続ネーミング・サービスは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーミング・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。
|
||||
.PP
|
||||
後方互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fBtnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。
|
||||
.PP
|
||||
\fB\-ORBInitialPort\fR引数は、\fBorbd\fRの必須のコマンド行引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。
|
||||
.PP
|
||||
Solaris、LinuxまたはOS Xコマンド・シェルから\fBorbd\fRを開始するには、次のように入力します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBorbd \-ORBInitialPort 1050&\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBstart orbd \-ORBInitialPort 1050\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーミング・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBProperties props = new Properties();\fR
|
||||
\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR
|
||||
\fBprops\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");\fR
|
||||
\fBORB orb = ORB\&.init(args, props);\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
この例では、ネーミング・サービスは、ホスト\fBMyHost\fRのポート1050上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、\fBHelloApplication\fRを起動できます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjava HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fBpkill\fR
|
||||
\fBorbd\fRを実行したり、\fBorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。
|
||||
.PP
|
||||
ORBDに付属するネーミング・サービスの詳細は、
|
||||
http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの「Naming Service」を参照してください
|
||||
.SH "サーバー・マネージャ"
|
||||
.PP
|
||||
ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fBservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンド行インタフェースです。\fBservertool\fRを使用してサーバーを起動する場合は、\fBorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。
|
||||
.PP
|
||||
http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.htmlの
|
||||
「Java IDL: The "Hello World" Example」を参照してください
|
||||
.PP
|
||||
この例では、チュートリアルの手順に従って\fBidlj\fRコンパイラと\fBjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。
|
||||
.PP
|
||||
\fBorbd\fRを起動します。
|
||||
.PP
|
||||
Solaris、LinuxまたはOS Xコマンド・シェルで、次のように入力します:
|
||||
\fBorbd \-ORBInitialPort 1050\fR
|
||||
.PP
|
||||
MS\-DOSシステム・プロンプト(Windows)で次のように入力します:
|
||||
\fBs\fR\fBtart orbd \-ORBInitialPort 105\fR\fB0\fR
|
||||
.PP
|
||||
ポート1050はネーム・サーバーを実行するポートです。\fB\-ORBInitialPort\fRオプションは必須コマンド行引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。
|
||||
.PP
|
||||
\fBservertool\fRを起動します:
|
||||
\fBservertool \-ORBInitialPort 1050\fR。
|
||||
.PP
|
||||
前回の手順とネーム・サーバー(\fBorbd\fR)のポートが同じであることを確認します。たとえば\fB\-ORBInitialPort 1050\&.\fRのようになります。\fBservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。
|
||||
.PP
|
||||
\fBservertool\fRコマンドライン・インタフェースで、\fBservertool\fRプロンプトから\fBHello\fRサーバーを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBservertool > register \-server HelloServer \-classpath \&. \-applicationName\fR
|
||||
\fB HelloServerApName\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBservertool\fRによってサーバーが登録されて、\fBHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjava HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
この例の\fB\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fBHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fBORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fBorbd\fR)ポートを指定します(例:
|
||||
\fB\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fBorbd\fR)と\fBservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fBorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。
|
||||
.PP
|
||||
Oracle Solarisから\fBorbd\fRをシャットダウンするには、プロセスを検索して、\fBkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fBservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
servertool(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの
|
||||
「Naming Service」
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+354
@@ -0,0 +1,354 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: pack200
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Javaデプロイメント・ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "pack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
pack200 \- WebデプロイメントのためにJARファイルをpack200圧縮ファイルにパッケージします。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
オプションは任意の順序で指定できます。コマンド行またはpropertiesファイルに指定された最後のオプションが、それ以前に指定されたすべてのオプションより優先されます。
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
コマンド行オプション。オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\fIoutput\-file\fR
|
||||
.RS 4
|
||||
出力ファイルの名前。
|
||||
.RE
|
||||
.PP
|
||||
\fIJAR\-file\fR
|
||||
.RS 4
|
||||
入力ファイルの名前。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBpack200\fRコマンドは、Java gzipコンプレッサを使用してJARファイルをpack200圧縮ファイルに変換するJavaアプリケーションです。pack200ファイルは高圧縮のファイルで、直接デプロイでき、帯域幅の節約やダウンロード時間の短縮が可能です。
|
||||
.PP
|
||||
\fBpack200\fRコマンドには、圧縮エンジンの設定や微調整を行うオプションがあります。一般的な使用方法を次の例に示します。\fBmyarchive\&.pack\&.gz\fRがデフォルトの\fBpack200\fRコマンド設定で作成されます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-r
|
||||
.br
|
||||
\-\-repack
|
||||
.RS 4
|
||||
JARファイルをパックした後アンパックして、JARファイルを生成します。生成されたファイルは\fBjarsigner\fR(1)ツールの入力ファイルとして使用できます。次の例では、myarchive\&.jarファイルをパックした後、アンパックします。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar\fR
|
||||
\fBpack200 \-\-repack myarchive\&.jar\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
次の例では、入力ファイル内のファイルの順序を保持します。
|
||||
.RE
|
||||
.PP
|
||||
\-g
|
||||
.br
|
||||
\-\-no\-gzip
|
||||
.RS 4
|
||||
\fBpack200\fRファイルを生成します。このオプションを指定するときは、適切な圧縮ツールを使用する必要があります。また、ターゲット・システムでは、対応する圧縮解除ツールを使用する必要があります。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-G
|
||||
.br
|
||||
\-\-strip\-debug
|
||||
.RS 4
|
||||
出力からデバッグ属性を削除します。これには、\fBSourceFile\fR、\fBLineNumberTable\fR、\fBLocalVariableTable\fR、\fBLocalVariableTypeTable\fRが含まれます。これらの属性を削除すれば、ダウンロードとインストールのサイズは小さくなりますが、デバッガの機能は制限されます。
|
||||
.RE
|
||||
.PP
|
||||
\-\-keep\-file\-order
|
||||
.RS 4
|
||||
入力ファイル内のファイルの順序を保持します。これは、デフォルトの動作です。
|
||||
.RE
|
||||
.PP
|
||||
\-O
|
||||
.br
|
||||
\-\-no\-keep\-file\-order
|
||||
.RS 4
|
||||
パック・ツールは、すべての要素を並べ替えて送信します。パック・ツールは、JARディレクトリ名を削除してダウンロード・サイズを削減することもできます。ただし、インデックスなど、特定のJARファイルの最適化機能が正常に動作しなくなることがあります。
|
||||
.RE
|
||||
.PP
|
||||
\-S\fIvalue\fR
|
||||
.br
|
||||
\-\-segment\-limit=\fIvalue\fR
|
||||
.RS 4
|
||||
この値は、各アーカイブ・セグメントの予想ターゲット・サイズ\fIN\fR
|
||||
(バイト単位)です。単一の入力ファイルの必要サイズが\fIN\fRバイトを超えると、独立したセグメントが割り当てられます。特殊なケースとして、値が\fB\-1\fRの場合は、すべての入力ファイルを含む大きな単一のセグメントが生成され、値が0の場合は、クラスごとにセグメントが1つずつ生成されます。アーカイブ・セグメントが大きくなると、断片化が少なくなり圧縮率が高くなりますが、その処理には多くのメモリーが必要です。
|
||||
.sp
|
||||
各セグメントのサイズは、セグメントに変換されるそれぞれの入力ファイルのサイズのほか、その名前と他の送信されるプロパティのサイズを計算して推測されます。
|
||||
.sp
|
||||
デフォルトは\-1です。つまり、パック・ツールは単一のセグメント出力ファイルを作成します。極端に大きな出力ファイルが生成される場合には、入力ファイルをセグメント化(分割)してより小さなJARにすることを強くお薦めします。
|
||||
.sp
|
||||
この制限が課されていない10 MBのJARパック・ファイルは通常、約10%小さくパックされます。しかし、パック・ツールでより大きなJavaヒープ(セグメントの制限の約10倍)を必要とする場合もあります。
|
||||
.RE
|
||||
.PP
|
||||
\-E\fIvalue\fR
|
||||
.br
|
||||
\-\-effort=\fIvalue\fR
|
||||
.RS 4
|
||||
単一の10進数値を指定した場合、パック・ツールは、指定された圧縮率でアーカイブを圧縮します。レベル1の場合は、比較的短い圧縮時間で多少大きめのファイルが生成されますが、レベル9の場合は、非常に長い時間がかかるものの、より圧縮率の高いファイルが生成されます。特殊な値0を指定した場合は、\fBpack200\fRコマンドは元のJARファイルを圧縮なしで直接コピーします。JSR 200標準では、すべての解凍プログラムが、この特別な場合をアーカイブ全体のパススルーと解釈するように規定しています。
|
||||
.sp
|
||||
デフォルトは5です。この場合、標準的な時間で適切な圧縮が行われます。
|
||||
.RE
|
||||
.PP
|
||||
\-H\fIvalue\fR
|
||||
.br
|
||||
\-\-deflate\-hint=\fIvalue\fR
|
||||
.RS 4
|
||||
入力情報を保存するというデフォルト値をオーバーライドします。転送されるアーカイブのサイズは大きくなる場合があります。指定可能な値は、\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRです。
|
||||
.sp
|
||||
\fBvalue\fRが\fBtrue\fRまたはfalseの場合、\fBpacker200\fRコマンドは指定に従ってデフレーション・ヒントを出力アーカイブに設定します。アーカイブ要素の個々のデフレーション・ヒントは転送されません。
|
||||
.sp
|
||||
\fBkeep\fR値は、入力JARで確認されたデフレーション・ヒントを保持します。これがデフォルトです。
|
||||
.RE
|
||||
.PP
|
||||
\-m\fIvalue\fR
|
||||
.br
|
||||
\-\-modification\-time=\fIvalue\fR
|
||||
.RS 4
|
||||
指定可能な値は\fBlatest\fRと\fBkeep\fRです。
|
||||
.sp
|
||||
値が最新の場合、パック・ツールは、元のアーカイブの使用可能なすべてのエントリのうちの最終更新時刻か、そのセグメントの使用可能なすべてのエントリの最終更新時刻を特定しようとします。この単一の値はセグメントの一部として転送され、各セグメントの全エントリに適用されます。この場合、すべてのインストール・ファイルに単一の日付が設定されるという問題はありますが、アーカイブの転送サイズを少し小さくすることができます。
|
||||
.sp
|
||||
値が\fBkeep\fRの場合、入力JARで確認された変更時間が保持されます。これがデフォルトです。
|
||||
.RE
|
||||
.PP
|
||||
\-P\fIfile\fR
|
||||
.br
|
||||
\-\-pass\-file=\fIfile\fR
|
||||
.RS 4
|
||||
ファイルを圧縮せず、バイト単位で転送するように指定します。このオプションを繰返し使用して、複数のファイルを指定できます。システム・ファイル・セパレータがJARファイル・セパレータのスラッシュ(/)に置き換えられる点を除き、パス名の変換は行われません。結果として得られるファイル名は、文字列として正確にJARファイルでの出現と一致している必要があります。\fBfile\fRにディレクトリ名を指定した場合、そのディレクトリ内のすべてのファイルが転送されます。
|
||||
.RE
|
||||
.PP
|
||||
\-U\fIaction\fR
|
||||
.br
|
||||
\-\-unknown\-attribute=\fIaction\fR
|
||||
.RS 4
|
||||
デフォルトの動作をオーバーライドします。つまり、不明な属性を含むクラス・ファイルが、指定した\fBaction\fRによって渡されます。アクションとして指定可能な値は、\fBerror\fR、\fBstrip\fRまたは\fBpass\fRです。
|
||||
.sp
|
||||
値が\fBerror\fRの場合、\fBpack200\fRコマンド操作全体が失敗して適切な説明が表示されます。
|
||||
.sp
|
||||
値が\fBstrip\fRの場合、属性は削除されます。Java Virtual Machine (JVM)必須属性を削除すると、クラス・ローダーの障害が発生することがあります。
|
||||
.sp
|
||||
値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。
|
||||
.RE
|
||||
.PP
|
||||
\-C\fIattribute\-name\fR=\fIlayout\fR
|
||||
.br
|
||||
\-\-class\-attribute=\fIattribute\-name\fR=\fIaction\fR
|
||||
.RS 4
|
||||
次のオプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\-F\fIattribute\-name\fR=\fIlayout\fR
|
||||
.br
|
||||
\-\-field\-attribute=\fIattribute\-name\fR=\fIaction\fR
|
||||
.RS 4
|
||||
次のオプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\-M\fIattribute\-name\fR=\fIlayout\fR
|
||||
.br
|
||||
\-\-method\-attribute=\fIattribute\-name\fR=\fIaction\fR
|
||||
.RS 4
|
||||
次のオプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\-D\fIattribute\-name\fR=\fIlayout\fR
|
||||
.br
|
||||
\-\-code\-attribute=\fIattribute\-name\fR=\fIaction\fR
|
||||
.RS 4
|
||||
前述の4つのオプションでは、クラス・エンティティに\fBclass\-attribute\fR、\fBfield\-attribute\fR、\fBmethod\-attribute\fRおよび\fBcode\-attribute\fRなどの属性のレイアウトを指定できます。\fIattribute\-name\fRには、これからレイアウトまたはアクションを定義する属性の名前を指定します。\fIaction\fRとして指定可能な値は、\fBsome\-layout\-string\fR、\fBerror\fR、\fBstrip\fR、\fBpass\fRです。
|
||||
.sp
|
||||
\fBsome\-layout\-string\fR: レイアウト言語はJSR 200仕様で定義されています。例:
|
||||
\fB\-\-class\-attribute=SourceFile=RUH\fR。
|
||||
.sp
|
||||
値が\fBerror\fRの場合、\fBpack200\fR操作が失敗して説明が表示されます。
|
||||
.sp
|
||||
値が\fBstrip\fRの場合、属性が出力から削除されます。VM必須属性を削除するとクラス・ローダーの障害が発生することがあります。たとえば、\fB\-\-class\-attribute=CompilationID=pass\fRというこの属性を含むクラス・ファイルを転送します。パック・ツールは、その他のアクションを行いません。
|
||||
.sp
|
||||
値が\fBpass\fRの場合、クラス全体が1つのリソースとして転送されます。
|
||||
.RE
|
||||
.PP
|
||||
\-f \fIpack\&.properties\fR
|
||||
.br
|
||||
\-\-config\-file=\fIpack\&.properties\fR
|
||||
.RS 4
|
||||
コマンド行に、パック・ツールを初期化するためのJavaプロパティが含まれている構成ファイルを指定できます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar\fR
|
||||
\fBmore pack\&.properties\fR
|
||||
\fB# Generic properties for the packer\&.\fR
|
||||
\fBmodification\&.time=latest\fR
|
||||
\fBdeflate\&.hint=false\fR
|
||||
\fBkeep\&.file\&.order=false\fR
|
||||
\fB# This option will cause the files bearing new attributes to\fR
|
||||
\fB# be reported as an error rather than passed uncompressed\&.\fR
|
||||
\fBunknown\&.attribute=error\fR
|
||||
\fB# Change the segment limit to be unlimited\&.\fR
|
||||
\fBsegment\&.limit=\-1\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-v
|
||||
.br
|
||||
\-\-verbose
|
||||
.RS 4
|
||||
最小限のメッセージを出力します。このオプションを複数指定すると、より長いメッセージが作成されます。
|
||||
.RE
|
||||
.PP
|
||||
\-q
|
||||
.br
|
||||
\-\-quiet
|
||||
.RS 4
|
||||
メッセージを表示せずに動作するように指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-l\fIfilename\fR
|
||||
.br
|
||||
\-\-log\-file=\fIfilename\fR
|
||||
.RS 4
|
||||
出力メッセージのログ・ファイルを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-?
|
||||
.br
|
||||
\-h
|
||||
.br
|
||||
\-\-help
|
||||
.RS 4
|
||||
このコマンドに関するヘルプ情報を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-V
|
||||
.br
|
||||
\-\-version
|
||||
.RS 4
|
||||
このコマンドに関するバージョン情報を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
指定されたオプションをJava Virtual Machineに渡します。詳細は、java(1)コマンドのリファレンス・ページを参照してください。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。
|
||||
.RE
|
||||
.SH "終了ステータス"
|
||||
.PP
|
||||
次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。
|
||||
.SH "注意"
|
||||
.PP
|
||||
このコマンドと\fBpack\fR(1)を混同しないでください。\fBpack\fRおよび\fBpack200\fRコマンドは、別々の製品です。
|
||||
.PP
|
||||
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
unpack200(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jar(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jarsigner(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+158
@@ -0,0 +1,158 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: policytool
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2015年3月3日
|
||||
.\" SectDesc: セキュリティ・ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "policytool" "1" "2015年3月3日" "JDK 8" "セキュリティ・ツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
policytool \- ユーティリティGUI経由で取得したユーザー入力に基づいて、プレーン・テキストのポリシー・ファイルを読み書きします。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpolicytool\fR [ \fB\-file\fR ] [ \fIfilename\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\-file
|
||||
.RS 4
|
||||
ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。
|
||||
.RE
|
||||
.PP
|
||||
\fIfilename\fR
|
||||
.RS 4
|
||||
ロードするファイルの名前。
|
||||
.RE
|
||||
.PP
|
||||
\fB例\fR:
|
||||
.PP
|
||||
ポリシー・ツール管理ユーティリティを実行します:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpolicytool\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBpolicytool\fRコマンドを実行し、指定されたファイルをロードします:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBpolicytool \-file \fR\fB\fImypolicyfile\fR\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBpolicytool\fRコマンドは、管理者のGUIを呼び出します。これにより、システム管理者はローカル・ポリシー・ファイルの内容を管理できるようになります。ポリシー・ファイルは\fB\&.policy\fR拡張子を持つプレーンテキスト・ファイルで、ドメイン別にリモート・リクエスタを権限オブジェクトにマップします。詳細は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある
|
||||
「Default Policy Implementation and Policy File Syntax」を参照してください
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-file
|
||||
.RS 4
|
||||
ポリシー・ファイルを読み込むように\fBpolicytool\fRに指示します。
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Default Policy Implementation and Policy File Syntax」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.html)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Policy File Creation and Management」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyGuide\&.html)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Permissions in Java SE Development Kit (JDK)」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/permissions\&.html)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Java Security Overview」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/overview/jsoverview\&.html)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Java Cryptography Architecture (JCA) Reference Guide」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+354
@@ -0,0 +1,354 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: rmid
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Remote Method Invocation (RMI)ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "rmid" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
rmid \- 起動システム・デーモンを開始すると、オブジェクトをJava Virtual Machine(VM)に登録してアクティブ化できるようになります。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid\fR [\fIoptions\fR]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
コマンド行オプション。オプションを参照してください。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBrmid\fRコマンドは、起動システム・デーモンを開始します。起動システム・デーモンを開始してからでないと、アクティブ化可能オブジェクトをアクティブ化システムに登録したり、JVM内でアクティブ化したりすることができません。アクティブ化可能なオブジェクトを使用するプログラムの作成方法の詳細は、\fIアクティブ化の使用\fRに関するチュートリアル(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html)を参照してください
|
||||
.PP
|
||||
\fBrmid\fRコマンドを実行し、次のようにセキュリティ・ポリシー・ファイルを指定して、デーモンを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBrmid\fRコマンドのOracleの実装を実行する場合、デフォルトでは、セキュリティ・ポリシー・ファイルを指定する必要があります。それは、\fBrmid\fRコマンドが起動グループ用にJVMを起動するために各\fBActivationGroupDesc\fR内の情報を使用できるかどうかを検証できるようにするためです特に、\fBActivationGroupDesc\fRコンストラクタに渡される\fBCommandEnvironment\fRや任意のプロパティによって指定されるコマンドおよびオプションは、\fBrmid\fRコマンドのセキュリティ・ポリシー・ファイルの中で明示的に許可することが必要になりました。\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値は、起動グループ用にJVMを起動するために\fBActivationGroupDesc\fR内の情報を使用できるかどうかを判断するときに\fBrmid\fRコマンドが使用するポリシーを決定します。詳細は、\-J\-Dsun\&.rmi\&.activation\&.execPolicy=policyオプションの説明を参照してください。
|
||||
.PP
|
||||
\fBrmid\fRコマンドを実行すると、デフォルト・ポート1098でアクティベータと内部レジストリが起動され、\fBActivationSystem\fRがこの内部レジストリ内の名前\fBjava\&.rmi\&.activation\&.ActivationSystem\fRにバインドされます。
|
||||
.PP
|
||||
レジストリに他のポートを指定するには、\fBrmid\fRコマンドの実行時に\fB\-port\fRオプションを指定する必要があります。たとえば、次のコマンドは、レジストリのデフォルト・ポート1099で、起動システム・デーモンとレジストリを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "必要に応じてRMIDを開始"
|
||||
.PP
|
||||
\fBrmid\fRをコマンドラインから開始するには、\fBinetd\fR(Oracle Solarisの場合)、または\fBxinetd\fR(Linuxの場合)を構成して\fBrmid\fRを必要に応じて開始する方法もあります。
|
||||
.PP
|
||||
RMIDを開始すると、\fBSystem\&.inheritedChannel\fRメソッドを呼び出して、継承されたチャンネル(\fBinetd\fR/\fBxinetd\fRから継承)を取得しようとします。継承されたチャンネルがnullであるか、\fBjava\&.nio\&.channels\&.ServerSocketChannel\fRのインスタンスでなかった場合、RMIDはそのチャンネルは\fBinetd\fR/\fBxinetd\fRによって起動されたものではないと判断し、前述のように起動します。
|
||||
.PP
|
||||
継承されたチャンネルが\fBServerSocketChannel\fRインスタンスである場合は、RMIDはエクスポートするリモート・オブジェクト、つまり\fBjava\&.rmi\&.activation\&.ActivationSystem\fRがバインドされているレジストリと\fBjava\&.rmi\&.activation\&.Activator\fRリモート・オブジェクトに対するリクエストを受信するサーバー・ソケットとして、\fBServerSocketChannel\fRから取得した\fBjava\&.net\&.ServerSocket\fRを使用します。このモードでは、RMIDの動作は、次のことを除いて、コマンドラインから起動した場合と同じです。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fBSystem\&.err\fRに対する出力は、ファイルにリダイレクトされる。このファイルは\fBjava\&.io\&.tmpdir\fRシステム・プロパティで指定されるディレクトリ(通常は\fB/var/tmp\fRまたは\fB/tmp\fR)にある。ファイル名の接頭辞は\fBrmid\-err\fRで、接尾辞は\fBtmp\fRである。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fB\-port\fRオプションは使用できません。このオプションが指定されている場合、RMIDはエラー・メッセージが表示されて終了します。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fB\-log\fRオプションは必須。このオプションが指定されていない場合、RMIDはエラー・メッセージが表示されて終了します。
|
||||
.RE
|
||||
.PP
|
||||
必要に応じてサービスを開始するように構成する方法の詳細は、\fBinetd\fR
|
||||
(Oracle Solarisの場合)、または\fBxinetd\fR
|
||||
(Linux)のマニュアル・ページを参照してください。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-C\fIオプション\fR
|
||||
.RS 4
|
||||
\fBrmid\fRコマンドの子プロセス(起動グループ)が作成されたときに、それぞれの子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システム・デーモンによって生成される各仮想マシンにプロパティを渡すことができます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid \-C\-Dsome\&.property=value\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のコマンドでは、すべての子JVMでserver\-callロギングが可能です。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid \-C\-Djava\&.rmi\&.server\&.logCalls=true\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
RMIDを実行しているJavaインタプリタに渡すオプションを指定します。たとえば、\fBrmid\fRコマンドが\fBrmid\&.policy\fRという名前のポリシー・ファイルを使用するように指定するには、\fBrmid\fRのコマンド行で\fB\-J\fRオプションを使用して、\fBjava\&.security\&.policy\fRプロパティを定義します。次に例を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmid \-J\-Djava\&.security\&.policy\-rmid\&.policy\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-J\-Dsun\&.rmi\&.activation\&.execPolicy=\fIpolicy\fR
|
||||
.RS 4
|
||||
起動グループが実行されることになるJVMの起動に使用するコマンドおよびコマンド行オプションをチェックするために、RMIDが採用するポリシーを指定します。このオプションは、Java RMI起動デーモンのOracleの実装のみに存在することに注意してください。コマンド行にこのプロパティを指定しない場合、結果は\fB\-J\-Dsun\&.rmi\&.activation\&.execPolicy=default\fRを指定した場合と同じになります。\fBpolicy\fRに指定可能な値は、\fBdefault\fR、\fBpolicyClassName\fRまたは\fBnone\fRです。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
デフォルト
|
||||
.sp
|
||||
\fBdefault\fRまたは未指定値の\fBexecPolicy\fRの場合、\fBrmid\fRコマンドが実行できるのは、\fBrmid\fRコマンドが使用するセキュリティ・ポリシー・ファイルの中で、実行する権限が\fBrmid\fRに与えられているコマンドおよびコマンド行オプションのみです。デフォルトの実行ポリシーで使用できるのは、デフォルトの起動グループ実装のみです。
|
||||
.sp
|
||||
\fBrmid\fRコマンドは、起動グループ用のJVMを起動するときに、そのグループについて登録された起動グループ記述子である\fBActivationGroupDesc\fR内の情報を使用します。グループ記述子は、\fBActivationGroupDesc\&.CommandEnvironment\fRを指定します(省略可能)。これには、起動グループを開始するコマンドと、そのコマンド行に追加できるコマンド行オプションが含まれています。デフォルトでは、\fBrmid\fRコマンドは\fBjava\&.home\fRにある\fBjava\fRコマンドを使用します。グループ記述子には、コマンド行にオプションとして追加されるプロパティ・オーバーライドも含まれます(\fB\-D<property>=<value>\fRとして定義されます)。\fBcom\&.sun\&.rmi\&.rmid\&.ExecPermission\fR権限は\fBrmid\fRコマンドに、起動グループを開始するためにグループ記述子の\fBCommandEnvironment\fRで指定されたコマンドを実行する権限を付与します。\fBcom\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR権限は起動グループの開始時に、グループ記述子でプロパティ・オーバーライドとして、または\fBCommandEnvironment\fRでオプションとして指定されたコマンド行オプションを、\fBrmid\fRコマンドが使用することを許可します。\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を付与する場合、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります。
|
||||
.sp
|
||||
\fBExecPermission\fR
|
||||
.sp
|
||||
\fBExecPermission\fRクラスは、起動グループを開始するために\fBrmid\fRコマンドが特定のコマンドを実行する権限を表します。
|
||||
.sp
|
||||
\fB構文\fR:
|
||||
\fBExecPermission\fRの名前は、\fBrmid\fRコマンドに実行を許可するコマンドのパス名です。スラッシュ(/)およびアスタリスク(*)で終わるパス名は、そのディレクトリに含まれるすべてのファイルを示します。スラッシュはファイル区切り文字\fBFile\&.separatorChar\fRです。スラッシュ(/)およびマイナス符号(\-)で終わるパス名は、そのディレクトリに含まれるすべてのファイルとサブディレクトリ(再帰的に)を示します。特殊なトークン\fB<<ALL FILES>>\fRで構成されるパス名は、どのファイルとも一致します。
|
||||
.sp
|
||||
パス名にアスタリスク(*)を指定した場合は、現在のディレクトリ内のすべてのファイルを示します。パス名にマイナス符号(\-)を指定した場合は、現在のディレクトリ内のすべてのファイルおよび(再帰的に)現在のディレクトリに含まれるすべてのファイルとサブディレクトリを示します。
|
||||
.sp
|
||||
\fBExecOptionPermission\fR
|
||||
.sp
|
||||
\fBExecOptionPermission\fRクラスは、起動グループを開始するときに\fBrmid\fRコマンドで特定のコマンド行オプションを使用できる権限を表します。\fBExecOptionPermission\fRの名前は、コマンド行オプションの値です。
|
||||
.sp
|
||||
\fB構文\fR: オプションでは、ワイルドカードが限定的にサポートされます。アスタリスクは、ワイルドカード・マッチを表します。アスタリスク(*)は、オプション名そのものとして使用できます。つまり、任意のオプションを表すことができます。また、オプション名の末尾に使用することもできます。ただし、ドット(\&.)か等号(=)の直後にアスタリスク(*)を指定する必要があります。
|
||||
.sp
|
||||
例:
|
||||
\fB*\fRや\fB\-Dmydir\&.*\fRや\fB\-Da\&.b\&.c=*\fRは有効ですが、\fB*mydir\fRや\fB\-Da*b\fRや\fBab*\fRは無効です。
|
||||
.sp
|
||||
\fBrmidのポリシー・ファイル\fR
|
||||
.sp
|
||||
\fBrmid\fRコマンドに様々なコマンドおよびオプションを実行する権限を許可する場合は、権限\fBExecPermission\fRおよび\fBExecOptionPermission\fRをすべてのコード・ソースに付与する必要があります(汎用的に)。これらの権限をチェックするのは\fBrmid\fRコマンドのみなので、これらの権限を汎用的に付与しても安全です。
|
||||
.sp
|
||||
\fBrmid\fRコマンドに各種の実行権限を付与するポリシー・ファイルの例を、次に示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBgrant {\fR
|
||||
\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR
|
||||
\fB "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java";\fR
|
||||
\fB \fR
|
||||
\fB permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR
|
||||
\fB "/files/apps/rmidcmds/*";\fR
|
||||
\fB \fR
|
||||
\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR
|
||||
\fB "\-Djava\&.security\&.policy=/files/policies/group\&.policy";\fR
|
||||
\fB \fR
|
||||
\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR
|
||||
\fB "\-Djava\&.security\&.debug=*";\fR
|
||||
\fB \fR
|
||||
\fB permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR
|
||||
\fB "\-Dsun\&.rmi\&.*";\fR
|
||||
\fB};\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
最初に付与されている権限は、\fBrmid\fRコマンドに対し、パス名により明示的に指定される\fBjava\fRコマンドの1\&.7\&.0リリースの実行を許可します。デフォルトでは、\fBjava\&.home\fRにあるバージョンの\fBjava\fRコマンドを使用します。\fBrmid\fRコマンドが使用するのと同じバージョンが使用されるため、そのコマンドは、ポリシー・ファイルで指定する必要はありません。2番目の権限は、\fBrmid\fRコマンドに対して、ディレクトリ\fB/files/apps/rmidcmds\fR内の任意のコマンドの実行権限を許可します。
|
||||
.sp
|
||||
3番目に付与されている権限\fBExecOptionPermission\fRは、\fBrmid\fRコマンドに対して、セキュリティ・ポリシー・ファイルを\fB/files/policies/group\&.policy\fRとして定義している起動グループの開始を許可します。次の権限は、起動グループが\fBjava\&.security\&.debug property\fRを使用することを許可しています。最後の権限は、起動グループが\fBsun\&.rmi property\fR名の階層内の任意のプロパティを使用することを許可しています。
|
||||
.sp
|
||||
ポリシー・ファイルを指定して\fBrmid\fRコマンドを起動するには、\fBrmid\fRのコマンド行で\fBjava\&.security\&.policy\fRプロパティを指定する必要があります。次に例を示します。
|
||||
.sp
|
||||
\fBrmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fR\&.
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
<policyClassName>
|
||||
.sp
|
||||
デフォルトの動作では十分な柔軟性が得られない場合、管理者は、\fBrmid\fRの起動時に、\fBcheckExecCommand\fRメソッドが所属するクラスの名前を指定して、\fBrmid\fRコマンドが実行するコマンドをチェックすることができます。
|
||||
.sp
|
||||
\fBpolicyClassName\fRには、引数なしのコンストラクタを持ち、次のような\fBcheckExecCommand\fRメソッドを実装しているpublicクラスを指定します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB public void checkExecCommand(ActivationGroupDesc desc, String[] command)\fR
|
||||
\fB throws SecurityException;\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
起動グループを開始する前に、\fBrmid\fRコマンドは、ポリシーの\fBcheckExecCommand\fRメソッドを呼び出します。このとき、起動グループの記述子と、起動グループを開始するための完全なコマンドを含む配列をそのメソッドに渡します。\fBcheckExecCommand\fRが\fBSecurityException\fRをスローすると、\fBrmid\fRコマンドはその起動グループを開始せず、オブジェクトの起動を試行している呼出し側には\fBActivationException\fRがスローされます。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
none
|
||||
.sp
|
||||
\fBsun\&.rmi\&.activation\&.execPolicy\fRプロパティの値が\fBnone\fRの場合、\fBrmid\fRコマンドは、起動グループを開始するコマンドをまったく検証しません。
|
||||
.RE
|
||||
.RE
|
||||
.PP
|
||||
\-log \fIdir\fR
|
||||
.RS 4
|
||||
起動システム・デーモンがデータベースおよび関連情報を書き込むのに使用するディレクトリの名前を指定します。デフォルトでは、\fBrmid\fRコマンドを実行したディレクトリに、logというログ・ディレクトリが作成されます。
|
||||
.RE
|
||||
.PP
|
||||
\-port \fIport\fR
|
||||
.RS 4
|
||||
レジストリが使用するポートを指定します。起動システム・デーモンは、このレジストリの中で、\fBjava\&.rmi\&.activation\&.ActivationSystem\fRという名前で\fBActivationSystem\fRをバインドします。ローカル・マシン上の\fBActivationSystem\fRは、次のように\fBNaming\&.lookup\fRメソッドを呼び出すことによって取得できます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBimport java\&.rmi\&.*; \fR
|
||||
\fB import java\&.rmi\&.activation\&.*;\fR
|
||||
\fB \fR
|
||||
\fB ActivationSystem system; system = (ActivationSystem)\fR
|
||||
\fB Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem");\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\-stop
|
||||
.RS 4
|
||||
\fB\-port\fRオプションによって指定されたポートの、現在の\fBrmid\fRコマンドの呼出しを停止します。ポートが指定されていない場合は、このオプションはポート1098で実行されている\fBrmid\fRの呼出しを停止します。
|
||||
.RE
|
||||
.SH "環境変数"
|
||||
.PP
|
||||
CLASSPATH
|
||||
.RS 4
|
||||
ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで区切られます。例:
|
||||
\fB\&.:/usr/local/java/classes\fR
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
java(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
クラス・パスの設定
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+116
@@ -0,0 +1,116 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: rmiregistry
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Remote Method Invocation (RMI)ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "rmiregistry" "1" "2013年11月21日" "JDK 8" "Remote Method Invocation (RMI)"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
rmiregistry \- 現在のホストの指定したポート上にリモート・オブジェクト・レジストリを開始します。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmiregistry\fR [ \fIport\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIport\fR
|
||||
.RS 4
|
||||
リモート・オブジェクト・レジストリを開始する現在のホスト上の\fBport\fRの数。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBrmiregistry\fRコマンドは、現在のホストの指定したポート上にリモート・オブジェクト・レジストリを作成し、開始します。portの指定を省略した場合、レジストリはポート1099で開始します。\fBrmiregistry\fRコマンドに、出力機能はありません。通常、これはバックグラウンドで実行されます。次に例を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBrmiregistry &\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
リモート・オブジェクト・レジストリは、ブートストラップのネーム・サービスです。同一ホストのRMIサーバーが、リモート・オブジェクトを名前にバインドするために使用されます。次に、ローカルおよびリモート・ホストのクライアントはリモート・オブジェクトを検索し、リモート・メソッドの呼出しを行います。
|
||||
.PP
|
||||
レジストリは、一般的に、最初のリモート・オブジェクトの位置を指定します。そこで、アプリケーションはメソッドを呼び出す必要があります。その後、そのオブジェクトはアプリケーション指定のサポートを提供し、他のオブジェクトを探します。
|
||||
.PP
|
||||
\fBjava\&.rmi\&.registry\&.LocateRegistry\fRクラスのメソッドは、ローカル・ホスト、またはローカル・ホストとポートで動作するレジストリを取得するために使用されます。
|
||||
.PP
|
||||
\fBjava\&.rmi\&.Naming\fRクラスのURLベース・メソッドはレジストリに対して操作を実行し、任意のホストおよびローカル・ホストでのリモート・オブジェクトの検索に使用できます。単純名(文字列)をリモート・オブジェクトにバインドし、新しい名前をリモート・オブジェクトに再バインドし(古いバインドをオーバーライド)、リモート・オブジェクトをアンバインドし、レジストリにバインドされているURLをリスト表示します。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-J
|
||||
.RS 4
|
||||
Javaオプションとともに使用して、\fB\-J\fRの後ろに続くオプションをJavaインタプリタに引き渡します(\fB\-J\fRとオプションの間にスペースは入れません)。
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
java(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fB「java\&.rmi\&.registry\&.LocateRegistry」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fB「java\&.rmi\&.Naming class description」\fR(http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+182
@@ -0,0 +1,182 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: servertool
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Java IDLおよびRMI-IIOPツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "servertool" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
servertool \- 開発者が永続サーバーを登録、登録解除、起動、停止するための使いやすいユーザー・インタフェースを提供します。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
コマンド行オプション。オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
commands
|
||||
.RS 4
|
||||
コマンド行コマンド。コマンドを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\fBservertool\fR\fBservertool >\fR\fBservertool >\fR
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBservertool\fRコマンドは、開発者が永続サーバーを登録、登録解除、起動、停止するためのコマンド行インタフェースを提供します。コマンド行コマンドを使用すると、サーバーに関する様々な統計情報を取得できます。コマンドを参照してください。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-ORBInitialHost \fInameserverhost\fR
|
||||
.RS 4
|
||||
このオプションは必須です。ネーム・サーバーが実行され、着信リクエストをリスニングするホスト・マシンを指定します。\fBnameserverhost\fR値は、\fBorb\fRが実行され、リクエストをリスニングしているポートを指定する必要があります。このオプションを指定しない場合、値はデフォルトで\fBlocalhost\fRに設定されます。\fBorbd\fRと\fBservertool\fRが異なるマシン上で実行されている場合は、\fBorbd\fRが実行されているホストの名前またはIPアドレスを指定する必要があります。
|
||||
.sp
|
||||
\fB注意:\fR
|
||||
Oracle Solarisでは、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。\fBnameserverport\fR値には、1024以上のポート番号を使用することをお薦めします。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
|
||||
.RE
|
||||
.SH "コマンド"
|
||||
.PP
|
||||
\fBservertool\fRコマンドは、コマンド行コマンドを使用して、または使用せずに起動できます。
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fBservertool\fRの起動時にコマンドを指定しなかった場合、コマンド行ツールにコマンド入力を求める\fBservertool\fRプロンプトが表示されます:
|
||||
\fBservertool >\fR。
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
\fBservertool\fRの起動時にコマンドを指定した場合、Java IDL Server Toolが起動してコマンドを実行し、終了します。
|
||||
.RE
|
||||
.PP
|
||||
register \-server \fIserver\-class\-name\fR \-classpath \fIclasspath\-to\-server\fR [ \-applicationName \fIapplication\-name\fR \-args \fIargs\-to\-server\fR \-vmargs \fIflags\-for\-JVM\fR ]
|
||||
.RS 4
|
||||
Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録してアクティブ化します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、\fBpublic static void install(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。インストール・メソッドはオプションであり、開発者はデータベース・スキーマの作成など独自のサーバー・インストール動作を指定できます。
|
||||
.RE
|
||||
.PP
|
||||
unregister \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR
|
||||
.RS 4
|
||||
サーバーIDまたはアプリケーション名で、サーバーをORBDから登録解除します。このコマンドによって、\fB\-server\fRオプションで識別されるサーバーの\fBメイン\fR・クラス内でアンインストール・メソッドが呼び出されます。
|
||||
\fBuninstall\fRメソッドは、\fBpublic static void uninstall(org\&.omg\&.CORBA\&.ORB)\fRになっている必要があります。\fBuninstall\fRメソッドはオプションであり、開発者は\fBinstall\fRメソッドの動作の取消など、独自のサーバー・アンインストール動作を指定できます。
|
||||
.RE
|
||||
.PP
|
||||
getserverid \-applicationName \fIapplication\-name\fR
|
||||
.RS 4
|
||||
\fBapplication\-name\fR値に対応するサーバーIDを返します。
|
||||
.RE
|
||||
.PP
|
||||
list
|
||||
.RS 4
|
||||
ORBDに登録されているすべての永続サーバーに関する情報を一覧表示します。
|
||||
.RE
|
||||
.PP
|
||||
listappnames
|
||||
.RS 4
|
||||
現在ORBDに登録されているすべてのサーバーのアプリケーション名を一覧表示します。
|
||||
.RE
|
||||
.PP
|
||||
listactive
|
||||
.RS 4
|
||||
ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。
|
||||
.RE
|
||||
.PP
|
||||
locate \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-endpointType \fIendpointType\fR ]
|
||||
.RS 4
|
||||
登録されたサーバーで作成したすべてのORBの特定のタイプについてエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBendpointType\fR値が指定されていない場合、サーバーのORBごとに関連付けられているplainタイプまたはnon\-protectedタイプのエンドポイントが返されます。
|
||||
.RE
|
||||
.PP
|
||||
locateperorb \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR [ \-orbid \fIORB\-name\fR ]
|
||||
.RS 4
|
||||
登録されたサーバーの特定のObject Request Broker (ORB)で登録されたエンドポイント(ポート)を検出します。サーバーが実行されていない場合、アクティブ化されます。\fBorbid\fRが指定されていない場合、デフォルト値の\fB""\fRが\fBorbid\fRに割り当てられます。ORBが空文字列の\fBorbid\fRで作成されている場合、登録したポートがすべて返されます。
|
||||
.RE
|
||||
.PP
|
||||
orblist \-serverid \fIserver\-id\fR | \-applicationName \fIapplication\-name\fR
|
||||
.RS 4
|
||||
サーバー上に定義されたORBの\fBORBId\fRを一覧表示します。\fBORBId\fRはサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、アクティブ化されます。
|
||||
.RE
|
||||
.PP
|
||||
shutdown \-serverid \fIserver\-id\fR | \-applicationName application\-name
|
||||
.RS 4
|
||||
ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、\fB\-serverid\fRパラメータまたは\fB\-applicationName\fRパラメータで指定されたクラス内に定義された\fBshutdown\fRメソッドも呼び出されてサーバー・プロセスを停止します。
|
||||
.RE
|
||||
.PP
|
||||
startup \-serverid \fIserver\-id\fR | \-applicationName application\-name
|
||||
.RS 4
|
||||
ORBDに登録されたサーバーを起動またはアクティブ化します。サーバーが実行されていない場合、このコマンドがサーバーを起動します。サーバーがすでに実行されている場合は、エラー・メッセージが表示されます。
|
||||
.RE
|
||||
.PP
|
||||
help
|
||||
.RS 4
|
||||
\fBservertool\fRコマンドを介してサーバーが利用できるすべてのコマンドをリストします。
|
||||
.RE
|
||||
.PP
|
||||
quit
|
||||
.RS 4
|
||||
\fBservertool\fRコマンドを終了します。
|
||||
.RE
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
orbd(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+427
@@ -0,0 +1,427 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1999, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: tnameserv
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Java IDLおよびRMI-IIOPツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "tnameserv" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
tnameserv \- インタフェース定義言語(IDL)。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBtnameserve\fR \fB\-ORBInitialPort\fR [ \fInameserverport\fR ]
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\-ORBInitialPort \fInameserverport\fR
|
||||
.RS 4
|
||||
ネーミング・サービスがORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references\fRメソッドの実装に使用するブートストラップ・プロトコルをリスニングする初期ポートです。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
Java IDLには、Object Request Broker Daemon (ORBD)が含まれます。ORBDは、ブートストラップ・サービス、一時ネーミング・サービス、永続ネーミング・サービスおよびサーバー・マネージャを含むデーモン・プロセスです。Java IDLのすべてのチュートリアルではORBDを使用していますが、一時ネーミング・サービスを使用する例では、\fBorbd\fRのかわりに\fBtnameserv\fRを使用できます。
|
||||
.PP
|
||||
orbd(1)http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html
|
||||
にあるまたは「Naming Service」を参照してください。
|
||||
.PP
|
||||
CORBAのCOS (Common Object Services)ネーミング・サービスは、ファイル・システムがファイルに対してディレクトリ構造を提供しているのと同じように、オブジェクト参照に対してツリー構造のディレクトリを提供します。Java IDLの一時ネーム・サービスである\fBtnameserv\fRは、COSネーム・サービスの仕様を単純な形で実装したものです。
|
||||
.PP
|
||||
オブジェクト参照はネームスペースに名前で格納され、オブジェクト参照と名前のペアは、それぞれネーム・バインディングと呼ばれます。ネーム・バインディングはネーミング・コンテキストに組み込むことができます。ネーミング・コンテキストはネーム・バインディングであり、ファイル・システムのサブディレクトリと同じ編成機能を持ちます。すべてのバインディングは初期ネーミング・コンテキストの下に格納されます。初期ネーミング・コンテキストは、ネームスペースの唯一の永続バインディングです。Java IDLネーミング・サービス・プロセスを停止して再起動すると、残りのネームスペースは失われます。
|
||||
.PP
|
||||
アプレットまたはアプリケーションからCOSネーミング・サービスを使用するためには、そのORBがネーミング・サービスが動作しているホストのポートを知っているか、そのネーミング・サービスの初期ネーミング・コンテキスト文字列にアクセスできる必要があります。ネーム・サービスは、Java IDLのネーム・サービスでもその他のCOS準拠のネーム・サービスでもかまいません。
|
||||
.SS "ネーミング・サービスの起動"
|
||||
.PP
|
||||
Java IDLネーム・サービスは、ネーム・サービスを使用するアプリケーションまたはアプレットより前に起動しておく必要があります。Java IDL製品をインストールすると、Java IDLネーミング・サービスを起動するスクリプト(Oracle Solaris:
|
||||
\fBtnameserv\fR)または実行可能ファイル(Windows:
|
||||
\fBtnameserv\&.exe\fR)が作成されます。バックグラウンドで動作するように、ネーム・サービスを起動してください。
|
||||
.PP
|
||||
特に指定しない場合、Java IDLネーミング・サービスは、ORBの\fBresolve_initial_references\fRメソッドと\fBlist_initial_references methods\fRメソッドの実装に使用するブートストラップ・プロトコルに対してポート900でリスニングします。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBtnameserv \-ORBInitialPort nameserverport&\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
ネーム・サーバー・ポートを指定しない場合、デフォルトでポート900が使用されます。Oracle Solarisソフトウェアの実行時、1024より小さいポートでプロセスを開始する場合は、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。1050のように別のポートを指定し、ネーム・サービスをバックグラウンドで実行するには、Solaris、LinuxまたはOS Xコマンド・シェルで次のように入力します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBtnameserv \-ORBInitialPort 1050&\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBstart tnameserv \-ORBInitialPort 1050\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
ネーム・サーバーのクライアントには、新しいポート番号を知らせる必要があります。これを行うには、ORBオブジェクトの作成時に\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティに新しいポート番号を設定します。
|
||||
.SS "異なるホスト上でのサーバーとクライアントの実行"
|
||||
.PP
|
||||
Java IDLとRMI\-IIOPのほとんどのチュートリアルでは、ネーミング・サービス、サーバーおよびクライアントはすべて開発用のマシン上で実行されます。実際にデプロイメントする場合には、クライアントとサーバーを、ネーミング・サービスとは異なるホスト・マシン上で実行することが多くなります。
|
||||
.PP
|
||||
クライアントとサーバーがネーム・サービスを見つけるには、クライアントとサーバーが、ネーム・サービスが実行されているポートの番号とホストを認識している必要があります。そのためには、クライアントとサーバーのファイル内の\fBorg\&.omg\&.CORBA\&.ORBInitialPort\fRプロパティと\fBorg\&.omg\&.CORBA\&.ORBInitialHost\fRプロパティをネーム・サービスが実行されているポートの番号とマシンの名前に設定します。この例は、「Getting Started Using RMI\-IIOP」
|
||||
(http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi\-iiop/rmiiiopexample\&.html)に示されています
|
||||
.PP
|
||||
コマンド行オプション\fB\-ORBInitialPort nameserverport#\fRと\fB\-ORBInitialHost nameserverhostname\fRを使用して、クライアントとサーバーに対してネーミング・サービスを探す場所を指定することもできます。コマンド行オプションを使用してこれを行う方法の1つの例は、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.htmlの「Java IDL: The Hello World Example on Two Machines」
|
||||
を参照してください
|
||||
.PP
|
||||
たとえば、一時ネーム・サービス\fBtnameserv\fRが、ホスト\fBnameserverhost\fRのポート1050上で実行されているとします。さらに、クライアントがホスト\fBclienthost\fR上で実行され、サーバーはホスト\fBserverhost\fR上で実行されているとします。
|
||||
.PP
|
||||
ホスト\fBnameserverhost\fR上で\fBtnameserv\fRを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBtnameserv \-ORBInitialPort 1050\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBserverhost\fR上でサーバーを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjava Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
|
||||
\fBclienthost\fR上でクライアントを起動します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjava Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SS "ネーミング・サービスの停止"
|
||||
.PP
|
||||
Java IDLネーミング・サービスを停止するには、Solaris、LinuxまたはOS Xの場合は、\fBkill\fRなどのオペレーティング・システムのコマンドを使用し、Windowsの場合は、\fB[Ctrl]+[C]\fRキーを使用します。ネーミング・サービスを明示的に停止するまでは、呼出し待機状態が続きます。サービスを終了させると、Java IDLネーム・サービスに登録されている名前は失われます。
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
Java Virtual Machineに\fBoption\fRを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
|
||||
.RE
|
||||
.SH "例"
|
||||
.SS "ネームスペースへのオブジェクトの追加"
|
||||
.PP
|
||||
次の例では、ネームスペースに名前を追加する方法を示します。このサンプル・プログラムは、このままの状態で完全に動作する一時ネーム・サービス・クライアントで、次のような単純なツリーを作成するものです。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBInitial Naming Context\fR
|
||||
\fB plans\fR
|
||||
\fB Personal\fR
|
||||
\fB calendar\fR
|
||||
\fB schedule\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
この例で、\fBplans\fRはオブジェクト参照、\fBPersonal\fRは\fBcalendar\fRと\fBschedule\fRの2つのオブジェクト参照を含むネーミング・コンテキストです。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBimport java\&.util\&.Properties;\fR
|
||||
\fBimport org\&.omg\&.CORBA\&.*;\fR
|
||||
\fBimport org\&.omg\&.CosNaming\&.*;\fR
|
||||
\fB \fR
|
||||
\fBpublic class NameClient {\fR
|
||||
|
||||
\fB public static void main(String args[]) {\fR
|
||||
|
||||
\fB try {\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB Properties props = new Properties();\fR
|
||||
\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR
|
||||
\fB ORB orb = ORB\&.init(args, props);\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
次のコードでは、初期ネーミング・コンテキストを取得し、それを\fBctx\fRに代入します。2行目では、\fBctx\fRをダミーのオブジェクト参照\fBobjref\fRにコピーします。このobjrefには、あとで様々な名前を割り当ててネームスペースに追加します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB NamingContext ctx =\fR
|
||||
\fB NamingContextHelper\&.narrow(\fR
|
||||
\fB orb\&.resolve_initial_references("NameService"));\fR
|
||||
\fB NamingContext objref = ctx;\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
次のコードでは、\fBtext\fRタイプの名前\fBplans\fRを作成し、それをダミーのオブジェクト参照にバインドします。その後、\fBrebind\fRメソッドを使用して初期ネーミング・コンテキストの下に\fBplans\fRを追加しています。\fBrebind\fRメソッドを使用すれば、\fBbind\fRメソッドを使用した場合に発生する例外を発生させずに、このプログラムを何度も繰返し実行できます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB NameComponent nc1 = new NameComponent("plans", "text");\fR
|
||||
\fB NameComponent[] name1 = {nc1};\fR
|
||||
\fB ctx\&.rebind(name1, objref);\fR
|
||||
\fB System\&.out\&.println("plans rebind successful!");\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
次のコードでは、\fBdirectory\fRタイプの\fBPersonal\fRというネーミング・コンテキストを作成します。その結果得られるオブジェクト参照\fBctx2\fRを\fBname\fRにバインドし、初期ネーミング・コンテキストに追加します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB NameComponent nc2 = new NameComponent("Personal", "directory");\fR
|
||||
\fB NameComponent[] name2 = {nc2};\fR
|
||||
\fB NamingContext ctx2 = ctx\&.bind_new_context(name2);\fR
|
||||
\fB System\&.out\&.println("new naming context added\&.\&.");\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
残りのコードでは、ダミーのオブジェクト参照を\fBschedule\fRと\fBcalendar\fRという名前でネーミング・コンテキスト\fBPersonal\fR(\fBctx2\fR)にバインドします。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB NameComponent nc3 = new NameComponent("schedule", "text");\fR
|
||||
\fB NameComponent[] name3 = {nc3};\fR
|
||||
\fB ctx2\&.rebind(name3, objref);\fR
|
||||
\fB System\&.out\&.println("schedule rebind successful!");\fR
|
||||
\fB \fR
|
||||
\fB NameComponent nc4 = new NameComponent("calender", "text");\fR
|
||||
\fB NameComponent[] name4 = {nc4};\fR
|
||||
\fB ctx2\&.rebind(name4, objref);\fR
|
||||
\fB System\&.out\&.println("calender rebind successful!");\fR
|
||||
\fB } catch (Exception e) {\fR
|
||||
\fB e\&.printStackTrace(System\&.err);\fR
|
||||
\fB }\fR
|
||||
\fB }\fR
|
||||
\fB}\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SS "ネームスペースの参照"
|
||||
.PP
|
||||
次のサンプル・プログラムでは、ネームスペースをブラウズする方法を示します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBimport java\&.util\&.Properties;\fR
|
||||
\fBimport org\&.omg\&.CORBA\&.*;\fR
|
||||
\fBimport org\&.omg\&.CosNaming\&.*;\fR
|
||||
\fB \fR
|
||||
\fBpublic class NameClientList {\fR
|
||||
|
||||
\fB public static void main(String args[]) {\fR
|
||||
|
||||
\fB try {\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
ネーミング・サービスの起動で、\fBnameserver\fRはポート1050で起動されました。次のコードで、このポート番号をクライアント・システムに知らせます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB Properties props = new Properties();\fR
|
||||
\fB props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fR
|
||||
\fB ORB orb = ORB\&.init(args, props);\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
次のコードでは、初期ネーミング・コンテキストを取得しています。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB NamingContext nc =\fR
|
||||
\fB NamingContextHelper\&.narrow(\fR
|
||||
\fB orb\&.resolve_initial_references("NameService"));\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fBlist\fRメソッドは、ネーミング・コンテキストのバインディングをリストします。この場合、最大1000個までのバインディングが初期ネーミング・コンテキストから\fBBindingListHolder\fRに返されます。残りのバインディングは、\fBBindingIteratorHolder\fRに返されます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB BindingListHolder bl = new BindingListHolder();\fR
|
||||
\fB BindingIteratorHolder blIt= new BindingIteratorHolder();\fR
|
||||
\fB nc\&.list(1000, bl, blIt);\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
次のコードでは、返された\fBBindingListHolder\fRからバインディングの配列を取得します。バインディングがない場合は、プログラムが終了します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB Binding bindings[] = bl\&.value;\fR
|
||||
\fB if (bindings\&.length == 0) return;\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
残りのコードでは、バインディングに対してループ処理を行い、名前を出力します。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB for (int i=0; i < bindings\&.length; i++) {\fR
|
||||
\fB \fR
|
||||
\fB // get the object reference for each binding\fR
|
||||
\fB org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);\fR
|
||||
\fB String objStr = orb\&.object_to_string(obj);\fR
|
||||
\fB int lastIx = bindings[i]\&.binding_name\&.length\-1;\fR
|
||||
\fB \fR
|
||||
\fB // check to see if this is a naming context\fR
|
||||
\fB if (bindings[i]\&.binding_type == BindingType\&.ncontext) {\fR
|
||||
\fB System\&.out\&.println("Context: " +\fR
|
||||
\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR
|
||||
\fB } else {\fR
|
||||
\fB System\&.out\&.println("Object: " +\fR
|
||||
\fB bindings[i]\&.binding_name[lastIx]\&.id);\fR
|
||||
\fB }\fR
|
||||
\fB }\fR
|
||||
\fB } catch (Exception e) {\fR
|
||||
\fB e\&.printStackTrace(System\&.err)\fR
|
||||
\fB }\fR
|
||||
\fB }\fR
|
||||
\fB}\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
orbd(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
+186
@@ -0,0 +1,186 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: unpack200
|
||||
.\" Language: Japanese
|
||||
.\" Date: 2013年11月21日
|
||||
.\" SectDesc: Javaデプロイメント・ツール
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: 汎用
|
||||
.\" Part Number: E58104-01
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "unpack200" "1" "2013年11月21日" "JDK 8" "Javaデプロイメント・ツール"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "名前"
|
||||
unpack200 \- \fBpack200\fR(1)で作成されたパック・ファイルを、WebデプロイメントのためにJARファイルに変換します。
|
||||
.SH "概要"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
コマンド行オプション。オプションを参照してください。
|
||||
.RE
|
||||
.PP
|
||||
\fIinput\-file\fR
|
||||
.RS 4
|
||||
入力ファイルの名前。pack200 gzipファイルかpack200ファイルを指定できます。入力ファイルには、\fBpack200\fR(1)で作成されたJARファイルを指定することもできます(手間は\fB0\fRです)。この場合、入力ファイルの内容はPack2000マーカーで出力JARファイルにコピーされます。
|
||||
.RE
|
||||
.PP
|
||||
\fIJAR\-file\fR
|
||||
.RS 4
|
||||
出力JARファイル名。
|
||||
.RE
|
||||
.SH "説明"
|
||||
.PP
|
||||
\fBunpack200\fRコマンドは、\fBpack200\fR\fB(1)\fRで作成されたパック・ファイルをJARファイルに変換するネイティブ実装です。一般的な使用方法は次のとおりです。次の例では、デフォルトの\fBunpack200\fRコマンド設定で、\fBmyarchive\&.jar\fRファイルが\fBmyarchive\&.pack\&.gz\fRから作成されます。
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBunpack200 myarchive\&.pack\&.gz myarchive\&.jar\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "オプション"
|
||||
.PP
|
||||
\-Hvalue \-\-deflate\-hint=\fIvalue\fR
|
||||
.RS 4
|
||||
JARファイル内のすべてのエントリに\fBtrue\fR、\fBfalse\fRまたは\fBkeep\fRのデフレーションを設定します。デフォルト・モードは\fBkeep\fRです。値が\fBtrue\fRまたは\fBfalse\fR場合、\fB\-\-deflate=hint\fRオプションはデフォルトの動作をオーバーライドして、出力JARファイル内のすべてのエントリのデフレーション・モードが設定されます。
|
||||
.RE
|
||||
.PP
|
||||
\-r \-\-remove\-pack\-file
|
||||
.RS 4
|
||||
入力パック・ファイルを削除します。
|
||||
.RE
|
||||
.PP
|
||||
\-v \-\-verbose
|
||||
.RS 4
|
||||
最小限のメッセージが表示されます。このオプションの複数の仕様には、より詳細なメッセージが表示されます。
|
||||
.RE
|
||||
.PP
|
||||
\-q \-\-quiet
|
||||
.RS 4
|
||||
メッセージを表示せずに動作するように指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-lfilename \-\-log\-file=\fIfilename\fR
|
||||
.RS 4
|
||||
出力メッセージが記録されるログ・ファイルを指定します。
|
||||
.RE
|
||||
.PP
|
||||
\-? \-h \-\-help
|
||||
.RS 4
|
||||
\fBunpack200\fRコマンドに関するヘルプ情報を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-V \-\-version
|
||||
.RS 4
|
||||
\fBunpack200\fRコマンドに関するバージョン情報を出力します。
|
||||
.RE
|
||||
.PP
|
||||
\-J\fIoption\fR
|
||||
.RS 4
|
||||
Java Virtual Machineにoptionを渡します。\fBoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。
|
||||
.RE
|
||||
.SH "注意"
|
||||
.PP
|
||||
このコマンドと\fBunpack\fRコマンドを混同しないでください。これらは別製品です。
|
||||
.PP
|
||||
JDKに付属するJava SE API仕様との相違が見つかった場合には、仕様を優先してください。
|
||||
.SH "終了ステータス"
|
||||
.PP
|
||||
次の終了値が返されます: 正常終了の場合は0、エラーが発生した場合は0より大きい値。
|
||||
.SH "関連項目"
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
pack200(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jar(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
jarsigner(1)
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Compression Formats for Network Deployment」
|
||||
|
||||
http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/jweb/networking/compression_formats\&.html
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
「Java SE Technical Documentation」
|
||||
(http://docs\&.oracle\&.com/javase/)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,157 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java Web Start Tools
|
||||
.\" Title: javaws.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH javaws 1 "21 November 2013" "JDK 8" "Java Web Start Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
javaws \- Starts Java Web Start\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBjavaws\fR [ \fIrun\-options\fR ] \fIjnlp\fR
|
||||
.fi
|
||||
.nf
|
||||
|
||||
\fBjavaws\fR [ \fIcontrol\-options\fR ]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIrun-options\fR
|
||||
Command-line \f3run-options\fR\&. The \f3run-options\fR can be in any order\&. See Run-Options\&.
|
||||
.TP
|
||||
\fIjnlp\fR
|
||||
Either the path of or the Uniform Resource Locator (URL) of the Java Network Launching Protocol (JNLP) file\&.
|
||||
.TP
|
||||
\fIcontrol-options\fR
|
||||
Command-line \f3control-options\fR\&. The \f3control-options\fR can be in any order\&. See Control-Options\&.
|
||||
.SH DESCRIPTION
|
||||
\fINote:\fR The \f3javaws\fR command is not available on Oracle Solaris\&.
|
||||
.PP
|
||||
The \f3javaws\fR command starts Java Web Start, which is the reference implementation of the JNLP\&. Java Web Start starts Java applications and applets hosted on a network\&.
|
||||
.PP
|
||||
If a JNLP file is specified, then the \f3javaws\fR command starts the Java application or applet specified in the JNLP file\&.
|
||||
.PP
|
||||
The \f3javaws\fR launcher has a set of options that are supported in the current release\&. However, the options may be removed in a future release\&.
|
||||
.SH RUN-OPTIONS
|
||||
.TP
|
||||
-offline
|
||||
.br
|
||||
Runs Java Web Start in offline mode\&.
|
||||
.TP
|
||||
-Xnosplash
|
||||
.br
|
||||
Does not display the initial splash screen\&.
|
||||
.TP
|
||||
-open \fIarguments\fR
|
||||
.br
|
||||
When specified, this option replaces the arguments in the JNLP file with \f3-open\fR\f3arguments\fR\&.
|
||||
.TP
|
||||
-print \fIarguments\fR
|
||||
.br
|
||||
When specified, this option replaces the arguments in the JNLP file with \f3-print\fR\f3arguments\fR\&.
|
||||
.TP
|
||||
-online
|
||||
.br
|
||||
Uses online mode\&. This is the default behavior\&.
|
||||
.TP
|
||||
-wait
|
||||
.br
|
||||
The \f3javaws\fR process does not exit until the application exits\&. This option does not function as described on Windows platforms\&.
|
||||
.TP
|
||||
-verbose
|
||||
.br
|
||||
Displays additional output\&.
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes option to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
|
||||
.TP
|
||||
-system
|
||||
.br
|
||||
Runs the application from the system cache only\&.
|
||||
.SH CONTROL-OPTIONS
|
||||
.TP
|
||||
-viewer
|
||||
.br
|
||||
Shows the cache viewer in the Java Control Panel\&.
|
||||
.TP
|
||||
-clearcache
|
||||
.br
|
||||
Removes all non-installed applications from the cache\&.
|
||||
.TP
|
||||
-userConfig \fIproperty-name\fR
|
||||
.br
|
||||
Clears the specified deployment property\&.
|
||||
.TP
|
||||
-userConfig \fIproperty-name property-value\fR
|
||||
.br
|
||||
Sets the specified deployment property to the specified value\&.
|
||||
.TP
|
||||
-uninstall
|
||||
.br
|
||||
Removes all applications from the cache\&.
|
||||
.TP
|
||||
-uninstall \fIjnlp\fR
|
||||
.br
|
||||
Removes the application from the cache\&.
|
||||
.TP
|
||||
-print \fIimport-options\fRjnlp
|
||||
.br
|
||||
Imports the application to the cache\&.
|
||||
.SH IMPORT-OPTIONS
|
||||
.TP
|
||||
-silent
|
||||
.br
|
||||
Imports silently (with no user interface)\&.
|
||||
.TP
|
||||
-system
|
||||
.br
|
||||
Imports application to the system cache\&.
|
||||
.TP
|
||||
-codebase \fIurl\fR
|
||||
.br
|
||||
Retrieves resources from the specified codebase\&.
|
||||
.TP
|
||||
-shortcut
|
||||
.br
|
||||
Installs shortcuts if the user allows a prompt\&. This option has no effect unless the \f3-silent\fR option is also used\&.
|
||||
.TP
|
||||
-association
|
||||
.br
|
||||
Installs associations if the user allows a prompt\&. This option has no effect unless the \f3-silent\fR option is also used\&.
|
||||
.SH FILES
|
||||
For information about the user and system cache and deployment\&.properties files, see Deployment Configuration File and Properties at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment-guide/properties\&.html
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Java Web Start at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/javaws/index\&.html
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,228 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1994, 2015, Oracle and/or its affiliates. All rights reserved.
|
||||
.\"
|
||||
.\" Title: jjs
|
||||
.\" Language: English
|
||||
.\" Date: 03 March 2015
|
||||
.\" SectDesc: Basic Tools
|
||||
.\" Software: JDK 8
|
||||
.\" Arch: generic
|
||||
.\" Part Number: E38209-04
|
||||
.\" Doc ID: JSSOR
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH "jjs" "1" "03 March 2015" "JDK 8" "Basic Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
jjs \- Invokes the Nashorn engine\&.
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB\fBjjs\fR\fR\fB [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIscript\-files\fR\fR\fB] [\-\- \fR\fB\fIarguments\fR\fR\fB]\fR
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.PP
|
||||
\fIoptions\fR
|
||||
.RS 4
|
||||
One or more options of the
|
||||
\fBjjs\fR
|
||||
command, separated by spaces\&. For more information, see Options\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIscript\-files\fR
|
||||
.RS 4
|
||||
One or more script files which you want to interpret using Nashorn, separated by spaces\&. If no files are specified, an interactive shell is started\&.
|
||||
.RE
|
||||
.PP
|
||||
\fIarguments\fR
|
||||
.RS 4
|
||||
All values after the double hyphen marker (\fB\-\-\fR) are passed through to the script or the interactive shell as arguments\&. These values can be accessed by using the
|
||||
\fBarguments\fR
|
||||
property (see Example 3)\&.
|
||||
.RE
|
||||
.SH "DESCRIPTION"
|
||||
.PP
|
||||
The
|
||||
\fBjjs\fR
|
||||
command\-line tool is used to invoke the Nashorn engine\&. You can use it to interpret one or several script files, or to run an interactive shell\&.
|
||||
.SH "OPTIONS"
|
||||
.PP
|
||||
The options of the
|
||||
\fBjjs\fR
|
||||
command control the conditions under which scripts are interpreted by Nashorn\&.
|
||||
.PP
|
||||
\-cp \fIpath\fR
|
||||
.br
|
||||
\-classpath \fIpath\fR
|
||||
.RS 4
|
||||
Specifies the path to the supporting class files To set multiple paths, the option can be repeated, or you can separate each path with a colon (:)\&.
|
||||
.RE
|
||||
.PP
|
||||
\-D\fIname\fR=\fIvalue\fR
|
||||
.RS 4
|
||||
Sets a system property to be passed to the script by assigning a value to a property name\&. The following example shows how to invoke Nashorn in interactive mode and assign
|
||||
\fBmyValue\fR
|
||||
to the property named
|
||||
\fBmyKey\fR:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs \-DmyKey=myValue\fR\fR
|
||||
\fBjjs> \fR\fB\fBjava\&.lang\&.System\&.getProperty("myKey")\fR\fR
|
||||
\fBmyValue\fR
|
||||
\fBjjs>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
This option can be repeated to set multiple properties\&.
|
||||
.RE
|
||||
.PP
|
||||
\-doe
|
||||
.br
|
||||
\-\-dump\-on\-error
|
||||
.RS 4
|
||||
Provides a full stack trace when an error occurs\&. By default, only a brief error message is printed\&.
|
||||
.RE
|
||||
.PP
|
||||
\-fv
|
||||
.br
|
||||
\-\-fullversion
|
||||
.RS 4
|
||||
Prints the full Nashorn version string\&.
|
||||
.RE
|
||||
.PP
|
||||
\-fx
|
||||
.RS 4
|
||||
Launches the script as a JavaFX application\&.
|
||||
.RE
|
||||
.PP
|
||||
\-h
|
||||
.br
|
||||
\-help
|
||||
.RS 4
|
||||
Prints the list of options and their descriptions\&.
|
||||
.RE
|
||||
.PP
|
||||
\-\-language=[es5]
|
||||
.RS 4
|
||||
Specifies the ECMAScript language version\&. The default version is ES5\&.
|
||||
.RE
|
||||
.PP
|
||||
\-ot
|
||||
.br
|
||||
\-\-optimistic\-types=[true|false]
|
||||
.RS 4
|
||||
Enables or disables optimistic type assumptions with deoptimizing recompilation\&. Running with optimistic types will yield higher final speed, but may increase warmup time\&.
|
||||
.RE
|
||||
.PP
|
||||
\-scripting
|
||||
.RS 4
|
||||
Enables shell scripting features\&.
|
||||
.RE
|
||||
.PP
|
||||
\-strict
|
||||
.RS 4
|
||||
Enables strict mode, which enforces stronger adherence to the standard (ECMAScript Edition 5\&.1), making it easier to detect common coding errors\&.
|
||||
.RE
|
||||
.PP
|
||||
\-t=\fIzone\fR
|
||||
.br
|
||||
\-timezone=\fIzone\fR
|
||||
.RS 4
|
||||
Sets the specified time zone for script execution\&. It overrides the time zone set in the OS and used by the
|
||||
\fBDate\fR
|
||||
object\&.
|
||||
.RE
|
||||
.PP
|
||||
\-v
|
||||
.br
|
||||
\-version
|
||||
.RS 4
|
||||
Prints the Nashorn version string\&.
|
||||
.RE
|
||||
.SH "EXAMPLES"
|
||||
.PP
|
||||
\fBExample 1 \fRRunning a Script with Nashorn
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fBjjs script\&.js\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\fBExample 2 \fRRunning Nashorn in Interactive Mode
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs\fR\fR
|
||||
\fBjjs> \fR\fB\fBprintln("Hello, World!")\fR\fR
|
||||
\fBHello, World!\fR
|
||||
\fBjjs> \fR\fB\fBquit()\fR\fR
|
||||
\fB>>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.PP
|
||||
\fBExample 3 \fRPassing Arguments to Nashorn
|
||||
.RS 4
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
\fB>> \fR\fB\fBjjs \-\- a b c\fR\fR
|
||||
\fBjjs> \fR\fB\fBarguments\&.join(", ")\fR\fR
|
||||
\fBa, b, c\fR
|
||||
\fBjjs>\fR
|
||||
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.RE
|
||||
.SH "SEE ALSO"
|
||||
.PP
|
||||
\fBjrunscript\fR
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,193 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java IDL and RMI-IIOP Tools
|
||||
.\" Title: orbd.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH orbd 1 "21 November 2013" "JDK 8" "Java IDL and RMI-IIOP Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
orbd \- Enables clients to locate and call persistent objects on servers in the CORBA environment\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBorbd\fR [ \fIoptions\fR ]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIoptions\fR
|
||||
Command-line options\&. See Options\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3orbd\fR command enables clients to transparently locate and call persistent objects on servers in the CORBA environment\&. The Server Manager included with the orbd tool is used to enable clients to transparently locate and call persistent objects on servers in the CORBA environment\&. The persistent servers, while publishing the persistent object references in the naming service, include the port number of the ORBD in the object reference instead of the port number of the server\&. The inclusion of an ORBD port number in the object reference for persistent object references has the following advantages:
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
The object reference in the naming service remains independent of the server life cycle\&. For example, the object reference could be published by the server in the Naming Service when it is first installed, and then, independent of how many times the server is started or shut down, the ORBD returns the correct object reference to the calling client\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
The client needs to look up the object reference in the naming service only once, and can keep reusing this reference independent of the changes introduced due to server life cycle\&.
|
||||
.PP
|
||||
To access the ORBD Server Manager, the server must be started using \f3servertool\fR, which is a command-line interface for application programmers to register, unregister, start up, and shut down a persistent server\&. For more information on the Server Manager, see Server Manager\&.
|
||||
.PP
|
||||
When \f3orbd\fR starts, it also starts a naming service\&. For more information about the naming service\&. See Start and Stop the Naming Service\&.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-ORBInitialPort \fInameserverport\fR
|
||||
.br
|
||||
Required\&. Specifies the port on which the name server should be started\&. After it is started, \f3orbd\fR listens for incoming requests on this port\&. On Oracle Solaris software, you must become the root user to start a process on a port below 1024\&. For this reason, Oracle recommends that you use a port number above or equal to 1024\&.
|
||||
.SS NONREQUIRED\ OPTIONS
|
||||
.TP
|
||||
-port \fIport\fR
|
||||
.br
|
||||
Specifies the activation port where ORBD should be started, and where ORBD will be accepting requests for persistent objects\&. The default value for this port is 1049\&. This port number is added to the port field of the persistent Interoperable Object References (IOR)\&.
|
||||
.TP
|
||||
-defaultdb \fIdirectory\fR
|
||||
.br
|
||||
Specifies the base where the ORBD persistent storage directory, \f3orb\&.db\fR, is created\&. If this option is not specified, then the default value is \f3\&./orb\&.db\fR\&.
|
||||
.TP
|
||||
-serverPollingTime \fImilliseconds\fR
|
||||
.br
|
||||
Specifies how often ORBD checks for the health of persistent servers registered through \f3servertool\fR\&. The default value is 1000 ms\&. The value specified for \f3milliseconds\fR must be a valid positive integer\&.
|
||||
.TP
|
||||
-serverStartupDelay milliseconds
|
||||
.br
|
||||
Specifies how long ORBD waits before sending a location forward exception after a persistent server that is registered through \f3servertool\fR is restarted\&. The default value is 1000 ms\&. The value specified for \f3milliseconds\fR must be a valid positive integer\&.
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes \f3option\fR to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
|
||||
.SS START\ AND\ STOP\ THE\ NAMING\ SERVICE
|
||||
A naming service is a CORBA service that allows CORBA objects to be named by means of binding a name to an object reference\&. The name binding can be stored in the naming service, and a client can supply the name to obtain the desired object reference\&.
|
||||
.PP
|
||||
Before running a client or a server, you will start ORBD\&. ORBD includes a persistent naming service and a transient naming service, both of which are an implementation of the COS Naming Service\&.
|
||||
.PP
|
||||
The Persistent Naming Service provides persistence for naming contexts\&. This means that this information is persistent across service shutdowns and startups, and is recoverable in the event of a service failure\&. If ORBD is restarted, then the Persistent Naming Service restores the naming context graph, so that the binding of all clients\&' and servers\&' names remains intact (persistent)\&.
|
||||
.PP
|
||||
For backward compatibility, \f3tnameserv\fR, a Transient Naming Service that shipped with earlier releases of the JDK, is also included in this release of Java SE\&. A transient naming service retains naming contexts as long as it is running\&. If there is a service interruption, then the naming context graph is lost\&.
|
||||
.PP
|
||||
The \f3-ORBInitialPort\fR argument is a required command-line argument for \f3orbd\fR, and is used to set the port number on which the naming service runs\&. The following instructions assume you can use port 1050 for the Java IDL Object Request Broker Daemon\&. When using Oracle Solaris software, you must become a root user to start a process on a port lower than 1024\&. For this reason, it is recommended that you use a port number above or equal to 1024\&. You can substitute a different port when necessary\&.
|
||||
.PP
|
||||
To start \f3orbd\fR from a UNIX command shell, enter:
|
||||
.sp
|
||||
.nf
|
||||
\f3orbd \-ORBInitialPort 1050&\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
From an MS-DOS system prompt (Windows), enter:
|
||||
.sp
|
||||
.nf
|
||||
\f3start orbd \-ORBInitialPort 1050\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
Now that ORBD is running, you can run your server and client applications\&. When running the client and server applications, they must be made aware of the port number (and machine name, when applicable) where the Naming Service is running\&. One way to do this is to add the following code to your application:
|
||||
.sp
|
||||
.nf
|
||||
\f3Properties props = new Properties();\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3ORB orb = ORB\&.init(args, props);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
In this example, the naming service is running on port 1050 on host \f3MyHost\fR\&. Another way is to specify the port number and/or machine name when running the server or client application from the command line\&. For example, you would start your \f3HelloApplication\fR with the following command line:
|
||||
.sp
|
||||
.nf
|
||||
\f3java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
To stop the naming service, use the relevant operating system command, such as \f3pkill\fR\f3orbd\fR on Oracle Solaris, or \fICtrl+C\fR in the DOS window in which \f3orbd\fR is running\&. Note that names registered with the naming service can disappear when the service is terminated because of a transient naming service\&. The Java IDL naming service will run until it is explicitly stopped\&.
|
||||
.PP
|
||||
For more information about the naming service included with ORBD, see Naming Service at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html
|
||||
.SH SERVER\ MANAGER
|
||||
To access the ORBD Server Manager and run a persistent server, the server must be started with \f3servertool\fR, which is a command-line interface for application programmers to register, unregister, start up, and shut down a persistent server\&. When a server is started using \f3servertool\fR, it must be started on the same host and port on which \f3orbd\fR is executing\&. If the server is run on a different port, then the information stored in the database for local contexts will be invalid and the service will not work properly\&.
|
||||
.PP
|
||||
See Java IDL: The "Hello World" Example at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.html
|
||||
.PP
|
||||
In this example, you run the \f3idlj\fR compiler and \f3javac\fR compiler as shown in the tutorial\&. To run the ORBD Server Manager, follow these steps for running the application:
|
||||
.PP
|
||||
Start \f3orbd\fR\&.
|
||||
.PP
|
||||
UNIX command shell, enter: \f3orbd -ORBInitialPort 1050\fR\&.
|
||||
.PP
|
||||
MS-DOS system prompt (Windows), enter: \f3s\fR\f3tart orbd -ORBInitialPort 105\fR\f30\fR\&.
|
||||
.PP
|
||||
Port 1050 is the port on which you want the name server to run\&. The \f3-ORBInitialPort\fR option is a required command-line argument\&. When using Oracle Solaris software, you must become a root user to start a process on a port below 1024\&. For this reason, it is recommended that you use a port number above or equal to 1024\&.
|
||||
.PP
|
||||
Start the \f3servertool\fR: \f3servertool -ORBInitialPort 1050\fR\&.
|
||||
.PP
|
||||
Make sure the name server (\f3orbd\fR) port is the same as in the previous step, for example, \f3-ORBInitialPort 1050\&.\fR The \f3servertool\fR must be started on the same port as the name server\&.
|
||||
.PP
|
||||
In the \f3servertool\fR command line interface, start the \f3Hello\fR server from the \f3servertool\fR prompt:
|
||||
.sp
|
||||
.nf
|
||||
\f3servertool > register \-server HelloServer \-classpath \&. \-applicationName\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 HelloServerApName\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
The \f3servertool\fR registers the server, assigns it the name \f3HelloServerApName\fR, and displays its server ID with a listing of all registered servers\&.Run the client application from another terminal window or prompt:
|
||||
.sp
|
||||
.nf
|
||||
\f3java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
For this example, you can omit \f3-ORBInitialHost localhost\fR because the name server is running on the same host as the \f3Hello\fR client\&. If the name server is running on a different host, then use the -\f3ORBInitialHost nameserverhost\fR option to specify the host on which the IDL name server is running\&.Specify the name server (\f3orbd\fR) port as done in the previous step, for example, \f3-ORBInitialPort 1050\fR\&. When you finish experimenting with the ORBD Server Manager, be sure to shut down or terminate the name server (\f3orbd\fR) and \f3servertool\fR\&. To shut down \f3orbd\fR from am MS-DOS prompt, select the window that is running the server and enter \fICtrl+C\fR to shut it down\&.
|
||||
.PP
|
||||
To shut down \f3orbd\fR from an Oracle Solaris shell, find the process, and terminate with the \f3kill\fR command\&. The server continues to wait for invocations until it is explicitly stopped\&. To shut down the \f3servertool\fR, type \fIquit\fR and press the \fIEnter\fR key\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
servertool(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Naming Service at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,270 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java Deployment Tools
|
||||
.\" Title: pack200.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH pack200 1 "21 November 2013" "JDK 8" "Java Deployment Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
pack200 \- Packages a JAR file into a compressed pack200 file for web deployment\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBpack200\fR [\fIoptions\fR] \fIoutput\-file\fR \fIJAR\-file\fR
|
||||
.fi
|
||||
.sp
|
||||
Options can be in any order\&. The last option on the command line or in a properties file supersedes all previously specified options\&.
|
||||
.TP
|
||||
\fIoptions\fR
|
||||
The command-line options\&. See Options\&.
|
||||
.TP
|
||||
\fIoutput-file\fR
|
||||
Name of the output file\&.
|
||||
.TP
|
||||
\fIJAR-file\fR
|
||||
Name of the input file\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3pack200\fR command is a Java application that transforms a JAR file into a compressed pack200 file with the Java gzip compressor\&. The pack200 files are highly compressed files that can be directly deployed to save bandwidth and reduce download time\&.
|
||||
.PP
|
||||
The \f3pack200\fR command has several options to fine-tune and set the compression engine\&. The typical usage is shown in the following example, where \f3myarchive\&.pack\&.gz\fR is produced with the default \f3pack200\fR command settings:
|
||||
.sp
|
||||
.nf
|
||||
\f3pack200 myarchive\&.pack\&.gz myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-r, --repack
|
||||
.br
|
||||
Produces a JAR file by packing and unpacking a JAR file\&. The resulting file can be used as an input to the \f3jarsigner\fR(1) tool\&. The following example packs and unpacks the myarchive\&.jar file:
|
||||
.sp
|
||||
.nf
|
||||
\f3pack200 \-\-repack myarchive\-packer\&.jar myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3pack200 \-\-repack myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
|
||||
The following example preserves the order of files in the input file\&.
|
||||
.TP
|
||||
-g, --no-gzip
|
||||
.br
|
||||
Produces a \f3pack200\fR file\&. With this option, a suitable compressor must be used, and the target system must use a corresponding decompresser\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3pack200 \-\-no\-gzip myarchive\&.pack myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
.TP
|
||||
-G, --strip-debug
|
||||
.br
|
||||
Strips debugging attributes from the output\&. These include \f3SourceFile\fR, \f3LineNumberTable\fR, \f3LocalVariableTable\fR and \f3LocalVariableTypeTable\fR\&. Removing these attributes reduces the size of both downloads and installations, but reduces the usefulness of debuggers\&.
|
||||
.TP
|
||||
--keep-file-order
|
||||
.br
|
||||
Preserve the order of files in the input file\&. This is the default behavior\&.
|
||||
.TP
|
||||
-O, --no-keep-file-order
|
||||
.br
|
||||
The packer reorders and transmits all elements\&. The packer can also remove JAR directory names to reduce the download size\&. However, certain JAR file optimizations, such as indexing, might not work correctly\&.
|
||||
.TP
|
||||
-S\fIvalue\fR , --segment-limit=\fIvalue\fR
|
||||
.br
|
||||
The value is the estimated target size \fIN\fR (in bytes) of each archive segment\&. If a single input file requires more than \fIN\fR bytes, then its own archive segment is provided\&. As a special case, a value of \f3-1\fR produces a single large segment with all input files, while a value of 0 produces one segment for each class\&. Larger archive segments result in less fragmentation and better compression, but processing them requires more memory\&.
|
||||
|
||||
The size of each segment is estimated by counting the size of each input file to be transmitted in the segment with the size of its name and other transmitted properties\&.
|
||||
|
||||
The default is -1, which means that the packer creates a single segment output file\&. In cases where extremely large output files are generated, users are strongly encouraged to use segmenting or break up the input file into smaller JARs\&.
|
||||
|
||||
A 10 MB JAR packed without this limit typically packs about 10 percent smaller, but the packer might require a larger Java heap (about 10 times the segment limit)\&.
|
||||
.TP
|
||||
-E\fIvalue\fR , --effort=\fIvalue\fR
|
||||
.br
|
||||
If the value is set to a single decimal digit, then the packer uses the indicated amount of effort in compressing the archive\&. Level 1 might produce somewhat larger size and faster compression speed, while level 9 takes much longer, but can produce better compression\&. The special value 0 instructs the \f3pack200\fR command to copy through the original JAR file directly with no compression\&. The JSR 200 standard requires any unpacker to understand this special case as a pass-through of the entire archive\&.
|
||||
|
||||
The default is 5, to invest a modest amount of time to produce reasonable compression\&.
|
||||
.TP
|
||||
-H\fIvalue\fR , --deflate-hint=\fIvalue\fR
|
||||
.br
|
||||
Overrides the default, which preserves the input information, but can cause the transmitted archive to be larger\&. The possible values are: \f3true\fR, \f3false\fR, or \f3keep\fR\&.
|
||||
|
||||
If the \f3value\fR is \f3true\fR or false, then the \f3packer200\fR command sets the deflation hint accordingly in the output archive and does not transmit the individual deflation hints of archive elements\&.
|
||||
|
||||
The \f3keep\fR value preserves deflation hints observed in the input JAR\&. This is the default\&.
|
||||
.TP
|
||||
-m\fIvalue\fR , --modification-time=\fIvalue\fR
|
||||
.br
|
||||
The possible values are \f3latest\fR and \f3keep\fR\&.
|
||||
|
||||
If the value is latest, then the packer attempts to determine the latest modification time, among all the available entries in the original archive, or the latest modification time of all the available entries in that segment\&. This single value is transmitted as part of the segment and applied to all the entries in each segment\&. This can marginally decrease the transmitted size of the archive at the expense of setting all installed files to a single date\&.
|
||||
|
||||
If the value is \f3keep\fR, then modification times observed in the input JAR are preserved\&. This is the default\&.
|
||||
.TP
|
||||
-P\fIfile\fR , --pass-file=\fIfile\fR
|
||||
.br
|
||||
Indicates that a file should be passed through bytewise with no compression\&. By repeating the option, multiple files can be specified\&. There is no pathname transformation, except that the system file separator is replaced by the JAR file separator forward slash (/)\&. The resulting file names must match exactly as strings with their occurrences in the JAR file\&. If \f3file\fR is a directory name, then all files under that directory are passed\&.
|
||||
.TP
|
||||
-U\fIaction\fR , --unknown-attribute=\fIaction\fR
|
||||
.br
|
||||
Overrides the default behavior, which means that the class file that contains the unknown attribute is passed through with the specified \f3action\fR\&. The possible values for actions are \f3error\fR, \f3strip\fR, or \f3pass\fR\&.
|
||||
|
||||
If the value is \f3error\fR, then the entire \f3pack200\fR command operation fails with a suitable explanation\&.
|
||||
|
||||
If the value is \f3strip\fR, then the attribute is dropped\&. Removing the required Java Virtual Machine (JVM) attributes can cause class loader failures\&.
|
||||
|
||||
If the value is \f3pass\fR, then the entire class is transmitted as though it is a resource\&.
|
||||
.TP
|
||||
.nf
|
||||
-C\fIattribute-name\fR=\fIlayout\fR , --class-attribute=\fIattribute-name\fR=\fIaction\fR
|
||||
.br
|
||||
.fi
|
||||
See next option\&.
|
||||
.TP
|
||||
.nf
|
||||
-F\fIattribute-name\fR=\fIlayout\fR , --field-attribute=\fIattribute-name\fR=\fIaction\fR
|
||||
.br
|
||||
.fi
|
||||
See next option\&.
|
||||
.TP
|
||||
.nf
|
||||
-M\fIattribute-name\fR=\fIlayout\fR , --method-attribute=\fIattribute-name\fR=\fIaction\fR
|
||||
.br
|
||||
.fi
|
||||
See next option\&.
|
||||
.TP
|
||||
.nf
|
||||
-D\fIattribute-name\fR=\fIlayout\fR , --code-attribute=\fIattribute-name\fR=\fIaction\fR
|
||||
.br
|
||||
.fi
|
||||
With the previous four options, the attribute layout can be specified for a class entity, such as \f3class-attribute\fR, \f3field-attribute\fR, \f3method-attribute\fR, and \f3code-attribute\fR\&. The \fIattribute-name\fR is the name of the attribute for which the layout or action is being defined\&. The possible values for \fIaction\fR are \f3some-layout-string\fR, \f3error\fR, \f3strip\fR, \f3pass\fR\&.
|
||||
|
||||
\f3some-layout-string\fR: The layout language is defined in the JSR 200 specification, for example: \f3--class-attribute=SourceFile=RUH\fR\&.
|
||||
|
||||
If the value is \f3error\fR, then the \f3pack200\fR operation fails with an explanation\&.
|
||||
|
||||
If the value is \f3strip\fR, then the attribute is removed from the output\&. Removing JVM-required attributes can cause class loader failures\&. For example, \f3--class-attribute=CompilationID=pass\fR causes the class file that contains this attribute to be passed through without further action by the packer\&.
|
||||
|
||||
If the value is \f3pass\fR, then the entire class is transmitted as though it is a resource\&.
|
||||
.TP
|
||||
-f \fIpack\&.properties\fR , --config-file=\fIpack\&.properties\fR
|
||||
.br
|
||||
A configuration file, containing Java properties to initialize the packer, can be specified on the command line\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3pack200 \-f pack\&.properties myarchive\&.pack\&.gz myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3more pack\&.properties\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3# Generic properties for the packer\&.\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3modification\&.time=latest\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3deflate\&.hint=false\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3keep\&.file\&.order=false\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3# This option will cause the files bearing new attributes to\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3# be reported as an error rather than passed uncompressed\&.\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3unknown\&.attribute=error\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3# Change the segment limit to be unlimited\&.\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3segment\&.limit=\-1\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
.TP
|
||||
-v, --verbose
|
||||
.br
|
||||
Outputs minimal messages\&. Multiple specification of this option will create more verbose messages\&.
|
||||
.TP
|
||||
-q, --quiet
|
||||
.br
|
||||
Specifies quiet operation with no messages\&.
|
||||
.TP
|
||||
-l\fIfilename\fR , --log-file=\fIfilename\fR
|
||||
.br
|
||||
Specifies a log file to output messages\&.
|
||||
.TP
|
||||
-?, -h, --help
|
||||
.br
|
||||
Prints help information about this command\&.
|
||||
.TP
|
||||
-V, --version
|
||||
.br
|
||||
Prints version information about this command\&.
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes the specified option to the Java Virtual Machine\&. For more information, see the reference page for the java(1) command\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&.
|
||||
.SH EXIT\ STATUS
|
||||
The following exit values are returned: 0 for successful completion and a number greater than 0 when an error occurs\&.
|
||||
.SH NOTES
|
||||
This command should not be confused with \f3pack\fR(1)\&. The \f3pack\fR and \f3pack200\fR commands are separate products\&.
|
||||
.PP
|
||||
The Java SE API Specification provided with the JDK is the superseding authority, when there are discrepancies\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
unpack200(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
jar(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
jarsigner(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,94 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 03 March 2015
|
||||
.\" SectDesc: Security Tools
|
||||
.\" Title: policytool.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH policytool 1 "03 March 2015" "JDK 8" "Security Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
policytool \- Reads and writes a plain text policy file based on user input through the utility GUI\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBpolicytool\fR [ \fB\-file\fR ] [ \fIfilename\fR ]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
-file
|
||||
.br
|
||||
Directs the \f3policytool\fR command to load a policy file\&.
|
||||
.TP
|
||||
\fIfilename\fR
|
||||
The name of the file to be loaded\&.
|
||||
.PP
|
||||
\fIExamples\fR:
|
||||
.PP
|
||||
Run the policy tool administrator utility:
|
||||
.sp
|
||||
.nf
|
||||
\f3policytool\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
Run the \f3policytool\fR command and load the specified file:
|
||||
.sp
|
||||
.nf
|
||||
\f3policytool \-file \fImypolicyfile\fR\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SH DESCRIPTION
|
||||
The \f3policytool\fR command calls an administrator\&'s GUI that enables system administrators to manage the contents of local policy files\&. A policy file is a plain-text file with a \f3\&.policy\fR extension, that maps remote requestors by domain, to permission objects\&. For details, see Default Policy Implementation and Policy File Syntax at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.html
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-file
|
||||
.br
|
||||
Directs the \f3policytool\fR command to load a policy file\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Default Policy Implementation and Policy File Syntax at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Policy File Creation and Management at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyGuide\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Permissions in Java SE Development Kit (JDK) at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/permissions\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Java Security Overview at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/overview/jsoverview\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Java Cryptography Architecture (JCA) Reference Guide at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/crypto/CryptoSpec\&.html
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,294 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Remote Method Invocation (RMI) Tools
|
||||
.\" Title: rmid.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH rmid 1 "21 November 2013" "JDK 8" "Remote Method Invocation (RMI) Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
rmid \- Starts the activation system daemon that enables objects to be registered and activated in a Java Virtual Machine (JVM)\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBrmid\fR [\fIoptions\fR]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIoptions\fR
|
||||
The command-line options\&. See Options\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3rmid\fR command starts the activation system daemon\&. The activation system daemon must be started before activatable objects can be either registered with the activation system or activated in a JVM\&. For details on how to write programs that use activatable objects, the \fIUsing Activation\fR tutorial at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi/activation/overview\&.html
|
||||
.PP
|
||||
Start the daemon by executing the \f3rmid\fR command and specifying a security policy file, as follows:
|
||||
.sp
|
||||
.nf
|
||||
\f3rmid \-J\-Djava\&.security\&.policy=rmid\&.policy\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
When you run Oracle\(cqs implementation of the \f3rmid\fR command, by default you must specify a security policy file so that the \f3rmid\fR command can verify whether or not the information in each \f3ActivationGroupDesc\fR is allowed to be used to start a JVM for an activation group\&. Specifically, the command and options specified by the \f3CommandEnvironment\fR and any properties passed to an \f3ActivationGroupDesc\fR constructor must now be explicitly allowed in the security policy file for the \f3rmid\fR command\&. The value of the \f3sun\&.rmi\&.activation\&.execPolicy\fR property dictates the policy that the \f3rmid\fR command uses to determine whether or not the information in an \f3ActivationGroupDesc\fR can be used to start a JVM for an activation group\&. For more information see the description of the -J-Dsun\&.rmi\&.activation\&.execPolicy=policy option\&.
|
||||
.PP
|
||||
Executing the \f3rmid\fR command starts the Activator and an internal registry on the default port1098 and binds an \f3ActivationSystem\fR to the name \f3java\&.rmi\&.activation\&.ActivationSystem\fR in this internal registry\&.
|
||||
.PP
|
||||
To specify an alternate port for the registry, you must specify the \f3-port\fR option when you execute the \f3rmid\fR command\&. For example, the following command starts the activation system daemon and a registry on the registry\&'s default port, 1099\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3rmid \-J\-Djava\&.security\&.policy=rmid\&.policy \-port 1099\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SH START\ RMID\ ON\ DEMAND
|
||||
An alternative to starting \f3rmid\fR from the command line is to configure \f3inetd\fR (Oracle Solaris) or \f3xinetd\fR (Linux) to start \f3rmid\fR on demand\&.
|
||||
.PP
|
||||
When RMID starts, it attempts to obtain an inherited channel (inherited from \f3inetd\fR/\f3xinetd\fR) by calling the \f3System\&.inheritedChannel\fR method\&. If the inherited channel is null or not an instance of \f3java\&.nio\&.channels\&.ServerSocketChannel\fR, then RMID assumes that it was not started by \f3inetd\fR/\f3xinetd\fR, and it starts as previously described\&.
|
||||
.PP
|
||||
If the inherited channel is a \f3ServerSocketChannel\fR instance, then RMID uses the \f3java\&.net\&.ServerSocket\fR obtained from the \f3ServerSocketChannel\fR as the server socket that accepts requests for the remote objects it exports: The registry in which the \f3java\&.rmi\&.activation\&.ActivationSystem\fR is bound and the \f3java\&.rmi\&.activation\&.Activator\fR remote object\&. In this mode, RMID behaves the same as when it is started from the command line, except in the following cases:
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Output printed to \f3System\&.err\fR is redirected to a file\&. This file is located in the directory specified by the \f3java\&.io\&.tmpdir\fR system property (typically \f3/var/tmp\fR or \f3/tmp\fR) with the prefix \f3rmid-err\fR and the suffix \f3tmp\fR\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
The \f3-port\fR option is not allowed\&. If this option is specified, then RMID exits with an error message\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
The \f3-log\fR option is required\&. If this option is not specified, then RMID exits with an error message
|
||||
.PP
|
||||
See the man pages for \f3inetd\fR (Oracle Solaris) or \f3xinetd\fR (Linux) for details on how to configure services to be started on demand\&.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-C\fIoption\fR
|
||||
.br
|
||||
Specifies an option that is passed as a command-line argument to each child process (activation group) of the \f3rmid\fR command when that process is created\&. For example, you could pass a property to each virtual machine spawned by the activation system daemon:
|
||||
.sp
|
||||
.nf
|
||||
\f3rmid \-C\-Dsome\&.property=value\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
|
||||
This ability to pass command-line arguments to child processes can be useful for debugging\&. For example, the following command enables server-call logging in all child JVMs\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3rmid \-C\-Djava\&.rmi\&.server\&.logCalls=true\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Specifies an option that is passed to the Java interpreter running RMID\&. For example, to specify that the \f3rmid\fR command use a policy file named \f3rmid\&.policy\fR, the \f3-J\fR option can be used to define the \f3java\&.security\&.policy\fR property on the \f3rmid\fR command line, for example:
|
||||
.sp
|
||||
.nf
|
||||
\f3rmid \-J\-Djava\&.security\&.policy\-rmid\&.policy\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
.TP
|
||||
-J-Dsun\&.rmi\&.activation\&.execPolicy=\fIpolicy\fR
|
||||
.br
|
||||
Specifies the policy that RMID employs to check commands and command-line options used to start the JVM in which an activation group runs\&. Please note that this option exists only in Oracle\&'s implementation of the Java RMI activation daemon\&. If this property is not specified on the command line, then the result is the same as though \f3-J-Dsun\&.rmi\&.activation\&.execPolicy=default\fR were specified\&. The possible values of \f3policy\fR can be \f3default\fR, \f3policyClassName\fR, or \f3none\fR\&.
|
||||
.RS
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
default
|
||||
|
||||
The \f3default\fR or unspecified value \f3execPolicy\fR allows the \f3rmid\fR command to execute commands with specific command-line options only when the \f3rmid\fR command was granted permission to execute those commands and options in the security policy file that the \f3rmid\fR command uses\&. Only the default activation group implementation can be used with the default execution policy\&.
|
||||
|
||||
The \f3rmid\fR command starts a JVM for an activation group with the information in the group\&'s registered activation group descriptor, an \f3ActivationGroupDesc\fR\&. The group descriptor specifies an optional \f3ActivationGroupDesc\&.CommandEnvironment\fR that includes the command to execute to start the activation group and any command-line options to be added to the command line\&. By default, the \f3rmid\fR command uses the \f3java\fR command found in \f3java\&.home\fR\&. The group descriptor also contains properties overrides that are added to the command line as options defined as: \f3-D<property>=<value>\fR\&.The \f3com\&.sun\&.rmi\&.rmid\&.ExecPermission\fR permission grants the \f3rmid\fR command permission to execute a command that is specified in the group descriptor\&'s \f3CommandEnvironment\fR to start an activation group\&. The \f3com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fR permission enables the \f3rmid\fR command to use command-line options, specified as properties overrides in the group descriptor or as options in the \f3CommandEnvironment\fR when starting the activation group\&.When granting the \f3rmid\fR command permission to execute various commands and options, the permissions \f3ExecPermission\fR and \f3ExecOptionPermission\fR must be granted to all code sources\&.
|
||||
|
||||
\fIExecPermission\fR
|
||||
|
||||
The \f3ExecPermission\fR class represents permission for the \f3rmid\fR command to execute a specific command to start an activation group\&.
|
||||
|
||||
\fISyntax\fR: The name of an \f3ExecPermission\fR is the path name of a command to grant the \f3rmid\fR command permission to execute\&. A path name that ends in a slash (/) and an asterisk (*) indicates that all of the files contained in that directory where slash is the file-separator character, \f3File\&.separatorChar\fR\&. A path name that ends in a slash (/) and a minus sign (-) indicates all files and subdirectories contained in that directory (recursively)\&. A path name that consists of the special token \f3<<ALL FILES>>\fR matches any file\&.
|
||||
|
||||
A path name that consists of an asterisk (*) indicates all the files in the current directory\&. A path name that consists of a minus sign (-) indicates all the files in the current directory and (recursively) all files and subdirectories contained in the current directory\&.
|
||||
|
||||
\fIExecOptionPermission\fR
|
||||
|
||||
The \f3ExecOptionPermission\fR class represents permission for the \f3rmid\fR command to use a specific command-line option when starting an activation group\&. The name of an \f3ExecOptionPermission\fR is the value of a command-line option\&.
|
||||
|
||||
\fISyntax\fR: Options support a limited wild card scheme\&. An asterisk signifies a wild card match, and it can appear as the option name itself (matches any option), or an asterisk (*) can appear at the end of the option name only when the asterisk (*) follows a dot (\&.) or an equals sign (=)\&.
|
||||
|
||||
For example: \f3*\fR or \f3-Dmydir\&.*\fR or \f3-Da\&.b\&.c=*\fR is valid, but \f3*mydir\fR or \f3-Da*b\fR or \f3ab*\fR is not\&.
|
||||
|
||||
\fIPolicy file for rmid\fR
|
||||
|
||||
When you grant the \f3rmid\fR command permission to execute various commands and options, the permissions \f3ExecPermission\fR and \f3ExecOptionPermission\fR must be granted to all code sources (universally)\&. It is safe to grant these permissions universally because only the \f3rmid\fR command checks these permissions\&.
|
||||
|
||||
An example policy file that grants various execute permissions to the \f3rmid\fR command is:
|
||||
.sp
|
||||
.nf
|
||||
\f3grant {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 "/files/apps/java/jdk1\&.7\&.0/solaris/bin/java";\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 permission com\&.sun\&.rmi\&.rmid\&.ExecPermission\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 "/files/apps/rmidcmds/*";\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 "\-Djava\&.security\&.policy=/files/policies/group\&.policy";\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 "\-Djava\&.security\&.debug=*";\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 permission com\&.sun\&.rmi\&.rmid\&.ExecOptionPermission\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 "\-Dsun\&.rmi\&.*";\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3};\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
|
||||
The first permission granted allows the \f3rmid\fR tcommand o execute the 1\&.7\&.0 release of the \f3java\fR command, specified by its explicit path name\&. By default, the version of the \f3java\fR command found in \f3java\&.home\fR is used (the same one that the \f3rmid\fR command uses), and does not need to be specified in the policy file\&. The second permission allows the \f3rmid\fR command to execute any command in the directory \f3/files/apps/rmidcmds\fR\&.
|
||||
|
||||
The third permission granted, an \f3ExecOptionPermission\fR, allows the \f3rmid\fR command to start an activation group that defines the security policy file to be \f3/files/policies/group\&.policy\fR\&. The next permission allows the \f3java\&.security\&.debug property\fR to be used by an activation group\&. The last permission allows any property in the \f3sun\&.rmi property\fR name hierarchy to be used by activation groups\&.
|
||||
|
||||
To start the \f3rmid\fR command with a policy file, the \f3java\&.security\&.policy\fR property needs to be specified on the \f3rmid\fR command line, for example:
|
||||
|
||||
\f3rmid -J-Djava\&.security\&.policy=rmid\&.policy\fR\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
<policyClassName>
|
||||
|
||||
If the default behavior is not flexible enough, then an administrator can provide, when starting the \f3rmid\fR command, the name of a class whose \f3checkExecCommand\fR method is executed to check commands to be executed by the \f3rmid\fR command\&.
|
||||
|
||||
The \f3policyClassName\fR specifies a public class with a public, no-argument constructor and an implementation of the following \f3checkExecCommand\fR method:
|
||||
.sp
|
||||
.nf
|
||||
\f3 public void checkExecCommand(ActivationGroupDesc desc, String[] command)\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 throws SecurityException;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
|
||||
Before starting an activation group, the \f3rmid\fR command calls the policy\&'s \f3checkExecCommand\fR method and passes to it the activation group descriptor and an array that contains the complete command to start the activation group\&. If the \f3checkExecCommand\fR throws a \f3SecurityException\fR, then the \f3rmid\fR command does not start the activation group and an \f3ActivationException\fR is thrown to the caller attempting to activate the object\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
none
|
||||
|
||||
If the \f3sun\&.rmi\&.activation\&.execPolicy\fR property value is \f3none\fR, then the \f3rmid\fR command does not perform any validation of commands to start activation groups\&.
|
||||
.RE
|
||||
|
||||
.TP
|
||||
-log \fIdir\fR
|
||||
.br
|
||||
Specifies the name of the directory the activation system daemon uses to write its database and associated information\&. The log directory defaults to creating a log, in the directory in which the \f3rmid\fR command was executed\&.
|
||||
.TP
|
||||
-port \fIport\fR
|
||||
.br
|
||||
Specifies the port the registry uses\&. The activation system daemon binds the \f3ActivationSystem\fR, with the name \f3java\&.rmi\&.activation\&.ActivationSystem\fR, in this registry\&. The \f3ActivationSystem\fR on the local machine can be obtained using the following \f3Naming\&.lookup\fR method call:
|
||||
.sp
|
||||
.nf
|
||||
\f3import java\&.rmi\&.*; \fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 import java\&.rmi\&.activation\&.*;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ActivationSystem system; system = (ActivationSystem)\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 Naming\&.lookup("//:port/java\&.rmi\&.activation\&.ActivationSystem");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
|
||||
.TP
|
||||
-stop
|
||||
.br
|
||||
Stops the current invocation of the \f3rmid\fR command for a port specified by the \f3-port\fR option\&. If no port is specified, then this option stops the \f3rmid\fR invocation running on port 1098\&.
|
||||
.SH ENVIRONMENT\ VARIABLES
|
||||
.TP
|
||||
CLASSPATH
|
||||
Used to provide the system a path to user-defined classes\&. Directories are separated by colons, for example: \f3\&.:/usr/local/java/classes\fR\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
java(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Setting the Class Path
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,78 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Remote Method Invocation (RMI) Tools
|
||||
.\" Title: rmiregistry.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH rmiregistry 1 "21 November 2013" "JDK 8" "Remote Method Invocation (RMI) Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
rmiregistry \- Starts a remote object registry on the specified port on the current host\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBrmiregistry\fR [ \fIport\fR ]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIport\fR
|
||||
The number of a \f3port\fR on the current host at which to start the remote object registry\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3rmiregistry\fR command creates and starts a remote object registry on the specified port on the current host\&. If the port is omitted, then the registry is started on port 1099\&. The \f3rmiregistry\fR command produces no output and is typically run in the background, for example:
|
||||
.sp
|
||||
.nf
|
||||
\f3rmiregistry &\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
A remote object registry is a bootstrap naming service that is used by RMI servers on the same host to bind remote objects to names\&. Clients on local and remote hosts can then look up remote objects and make remote method invocations\&.
|
||||
.PP
|
||||
The registry is typically used to locate the first remote object on which an application needs to call methods\&. That object then provides application-specific support for finding other objects\&.
|
||||
.PP
|
||||
The methods of the \f3java\&.rmi\&.registry\&.LocateRegistry\fR class are used to get a registry operating on the local host or local host and port\&.
|
||||
.PP
|
||||
The URL-based methods of the \f3java\&.rmi\&.Naming\fR class operate on a registry and can be used to look up a remote object on any host and on the local host\&. Bind a simple name (string) to a remote object, rebind a new name to a remote object (overriding the old binding), unbind a remote object, and list the URL bound in the registry\&.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-J
|
||||
.br
|
||||
Used with any Java option to pass the option following the \f3-J\fR (no spaces between the \f3-J\fR and the option) to the Java interpreter\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
java(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\f3java\&.rmi\&.registry\&.LocateRegistry\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/registry/LocateRegistry\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
\f3java\&.rmi\&.Naming class description\fR at http://docs\&.oracle\&.com/javase/8/docs/api/java/rmi/Naming\&.html
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,117 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java IDL and RMI-IIOP Tools
|
||||
.\" Title: servertool.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH servertool 1 "21 November 2013" "JDK 8" "Java IDL and RMI-IIOP Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
servertool \- Provides an easy-to-use interface for developers to register, unregister, start up, and shut down a persistent server\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIoptions\fR
|
||||
The command-line options\&. See Options\&.
|
||||
.TP
|
||||
commands
|
||||
The command-line commands\&. See Commands\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3servertool\fR command provides the command-line interface for developers to register, unregister, start up, and shut down a persistent server\&. Command-line commands let you obtain various statistical information about the server\&. See Commands\&.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-ORBInitialHost \fInameserverhost\fR
|
||||
.br
|
||||
This options is required\&. It specifies the host machine on which the name server runs and listens for incoming requests\&. The \f3nameserverhost\fR value must specify the port on which the \f3orb\fR is running and listening for requests\&. The value defaults to \f3localhost\fR when this option is not specified\&. If \f3orbd\fR and \f3servertool\fR are running on different machines, then you must specify the name or IP address of the host on which \f3orbd\fR is running\&.
|
||||
|
||||
\fINote:\fR On Oracle Solaris, you must become a root user to start a process on a port below 1024\&. Oracle recommends that you use a port number above or equal to 1024 for the \f3nameserverport\fR value\&.
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes \f3option\fR to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
|
||||
.SH COMMANDS
|
||||
You can start the \f3servertool\fR command with or without a command-line command\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
If you did not specify a command when you started \f3servertool\fR, then the command-line tool displays the \f3servertool\fR prompt where you can enter commands: \f3servertool >\fR\&.
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
If you specify a command when you start \f3servertool\fR, then the Java IDL Server Tool starts, executes the command, and exits\&.
|
||||
.TP
|
||||
.ll 180
|
||||
register -server \fIserver-class-name\fR -classpath \fIclasspath-to-server\fR [ -applicationName \fIapplication-name\fR -args \fIargs-to-server\fR -vmargs \fIflags-for-JVM\fR ]
|
||||
Registers a new persistent server with the Object Request Broker Daemon (ORBD)\&. If the server is not already registered, then it is registered and activated\&. This command causes an installation method to be called in the \f3main\fR class of the server identified by the \f3-server\fR option\&. The installation method must be \f3public static void install(org\&.omg\&.CORBA\&.ORB)\fR\&. The install method is optional and lets developers provide their own server installation behavior, such as creating a database schema\&.
|
||||
.TP
|
||||
.ll 180
|
||||
unregister -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR
|
||||
Unregisters a server from the ORBD with either its server ID or its application name\&. This command causes an uninstallation method to be called in the \f3main\fR class of the server identified by the \f3-server\fR option\&. The \f3uninstall\fR method must be \f3public static void uninstall(org\&.omg\&.CORBA\&.ORB)\fR\&. The \f3uninstall\fR method is optional and lets developers provide their own server uninstallation behavior, such as undoing the behavior of the \f3install\fR method\&.
|
||||
.TP
|
||||
getserverid -applicationName \fIapplication-name\fR
|
||||
Returns the server ID that corresponds to the \f3application-name\fR value\&.
|
||||
.TP
|
||||
list
|
||||
Lists information about all persistent servers registered with the ORBD\&.
|
||||
.TP
|
||||
listappnames
|
||||
Lists the application names for all servers currently registered with the ORBD\&.
|
||||
.TP
|
||||
listactive
|
||||
Lists information about all persistent servers that were started by the ORBD and are currently running\&.
|
||||
.TP
|
||||
.ll 180
|
||||
locate -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR [ -endpointType \fIendpointType\fR ]
|
||||
Locates the endpoints (ports) of a specific type for all ORBs created by a registered server\&. If a server is not already running, then it is activated\&. If an \f3endpointType\fR value is not specified, then the plain/non-protected endpoint associated with each ORB in a server is returned\&.
|
||||
.TP
|
||||
.ll 180
|
||||
locateperorb -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR [ -orbid \fIORB-name\fR ]
|
||||
Locates all the endpoints (ports) registered by a specific Object Request Broker (ORB) of registered server\&. If a server is not already running, then it is activated\&. If an \f3orbid\fR is not specified, then the default value of \f3""\fR is assigned to the \f3orbid\fR\&. If any ORBs are created with an \f3orbid\fR of empty string, then all ports registered by it are returned\&.
|
||||
.TP
|
||||
orblist -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR
|
||||
Lists the \f3ORBId\fR of the ORBs defined on a server\&. An \f3ORBId\fR is the string name for the ORB created by the server\&. If the server is not already running, then it is activated\&.
|
||||
.TP
|
||||
shutdown -serverid \fIserver-id\fR | -applicationName application-name
|
||||
Shut down an active server that is registered with ORBD\&. During execution of this command, the \f3shutdown\fR method defined in the class specified by either the \f3-serverid\fR or \f3-applicationName\fR parameter is also called to shut down the server process\&.
|
||||
.TP
|
||||
startup -serverid \fIserver-id\fR | -applicationName application-name
|
||||
Starts up or activate a server that is registered with ORBD\&. If the server is not running, then this command starts the server\&. If the server is already running, then an error message is displayed\&.
|
||||
.TP
|
||||
help
|
||||
Lists all the commands available to the server through the \f3servertool\fR command\&.
|
||||
.TP
|
||||
quit
|
||||
Exits the \f3servertool\fR command\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
orbd(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,468 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java IDL and RMI-IIOP Tools
|
||||
.\" Title: tnameserv.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH tnameserv 1 "21 November 2013" "JDK 8" "Java IDL and RMI-IIOP Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
tnameserv \- Interface Definition Language (IDL)\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBtnameserve\fR \fB\-ORBInitialPort\fR [ \fInameserverport\fR ]
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
-ORBInitialPort \fInameserverport\fR
|
||||
.br
|
||||
The initial port where the naming service listens for the bootstrap protocol used to implement the ORB \f3resolve_initial_references\fR and \f3list_initial_references\fR methods\&.
|
||||
.SH DESCRIPTION
|
||||
Java IDL includes the Object Request Broker Daemon (ORBD)\&. ORBD is a daemon process that contains a Bootstrap Service, a Transient Naming Service, a Persistent Naming Service, and a Server Manager\&. The Java IDL tutorials all use ORBD, but you can substitute the \f3tnameserv\fR command for the \f3orbd\fR command in any of the examples that use a Transient Naming Service\&.
|
||||
.PP
|
||||
See orbd(1) or Naming Service at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html
|
||||
.PP
|
||||
The CORBA Common Object Services (COS) Naming Service provides a tree-structure directory for object references similar to a file system that provides a directory structure for files\&. The Transient Naming Service provided with Java IDL, \f3tnameserv\fR, is a simple implementation of the COS Naming Service specification\&.
|
||||
.PP
|
||||
Object references are stored in the name space by name and each object reference-name pair is called a name binding\&. Name bindings can be organized under naming contexts\&. Naming contexts are name bindings and serve the same organizational function as a file system subdirectory\&. All bindings are stored under the initial naming context\&. The initial naming context is the only persistent binding in the name space\&. The rest of the name space is lost when the Java IDL naming service process stops and restarts\&.
|
||||
.PP
|
||||
For an applet or application to use COS naming, its ORB must know the port of a host running a naming service or have access to an initial naming context string for that naming service\&. The naming service can either be the Java IDL naming service or another COS-compliant naming service\&.
|
||||
.SS START\ THE\ NAMING\ SERVICE
|
||||
You must start the Java IDL naming service before an application or applet that uses its naming service\&. Installation of the Java IDL product creates a script (Oracle Solaris: \f3tnameserv\fR) or executable file (Windows: \f3tnameserv\&.exe\fR) that starts the Java IDL naming service\&. Start the naming service so it runs in the background\&.
|
||||
.PP
|
||||
If you do not specify otherwise, then the Java IDL naming service listens on port 900 for the bootstrap protocol used to implement the ORB \f3resolve_initial_references\fR and \f3list_initial_references methods\fR, as follows:
|
||||
.sp
|
||||
.nf
|
||||
\f3tnameserv \-ORBInitialPort nameserverport&\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
If you do not specify the name server port, then port 900 is used by default\&. When running Oracle Solaris software, you must become the root user to start a process on a port below 1024\&. For this reason, it is recommended that you use a port number greater than or equal to 1024\&. To specify a different port, for example, 1050, and to run the naming service in the background, from a UNIX command shell, enter:
|
||||
.sp
|
||||
.nf
|
||||
\f3tnameserv \-ORBInitialPort 1050&\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
From an MS-DOS system prompt (Windows), enter:
|
||||
.sp
|
||||
.nf
|
||||
\f3start tnameserv \-ORBInitialPort 1050\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
Clients of the name server must be made aware of the new port number\&. Do this by setting the \f3org\&.omg\&.CORBA\&.ORBInitialPort\fR property to the new port number when you create the ORB object\&.
|
||||
.SS RUN\ THE\ SERVER\ AND\ CLIENT\ ON\ DIFFERENT\ HOSTS
|
||||
In most of the Java IDL and RMI-IIOP tutorials, the naming service, server, and client are all running on the development machine\&. In real-world deployment, the client and server probably run on different host machines from the Naming Service\&.
|
||||
.PP
|
||||
For the client and server to find the Naming Service, they must be made aware of the port number and host on which the naming service is running\&. Do this by setting the \f3org\&.omg\&.CORBA\&.ORBInitialPort\fR and \f3org\&.omg\&.CORBA\&.ORBInitialHost\fR properties in the client and server files to the machine name and port number on which the Naming Service is running\&. An example of this is shown in Getting Started Using RMI-IIOP at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/rmi-iiop/rmiiiopexample\&.html
|
||||
.PP
|
||||
You could also use the command-line options \f3-ORBInitialPort nameserverport#\fR and \f3-ORBInitialHost nameserverhostname\fR to tell the client and server where to find the naming service\&. For one example of doing this using the command-line option, see Java IDL: The Hello World Example on Two Machines at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/tutorial/jidl2machines\&.html
|
||||
.PP
|
||||
For example, suppose the Transient Naming Service, \f3tnameserv\fR is running on port 1050 on host \f3nameserverhost\fR\&. The client is running on host \f3clienthost,\fR and the server is running on host \f3serverhost\fR\&.
|
||||
.PP
|
||||
Start \f3tnameserv\fR on the host \f3nameserverhost\fR:
|
||||
.sp
|
||||
.nf
|
||||
\f3tnameserv \-ORBInitialPort 1050\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
Start the server on the \f3serverhost\fR:
|
||||
.sp
|
||||
.nf
|
||||
\f3java Server \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
Start the client on the \f3clienthost\fR:
|
||||
.sp
|
||||
.nf
|
||||
\f3java Client \-ORBInitialPort 1050 \-ORBInitialHost nameserverhost\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SS STOP\ THE\ NAMING\ SERVICE
|
||||
To stop the Java IDL naming service, use the relevant operating system command, such as \f3kill\fR for a Unix process or \f3Ctrl+C\fR for a Windows process\&. The naming service continues to wait for invocations until it is explicitly shut down\&. Note that names registered with the Java IDL naming service disappear when the service is terminated\&.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes \f3option\fR to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
|
||||
.SH EXAMPLES
|
||||
.SS ADD\ OBJECTS\ TO\ THE\ NAME\ SPACE
|
||||
The following example shows how to add names to the name space\&. It is a self-contained Transient Naming Service client that creates the following simple tree\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3Initial Naming Context\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 plans\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 Personal\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 calendar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 schedule\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
In this example, \f3plans\fR is an object reference and \f3Personal\fR is a naming context that contains two object references: \f3calendar\fR and \f3schedule\fR\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3import java\&.util\&.Properties;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3import org\&.omg\&.CORBA\&.*;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3import org\&.omg\&.CosNaming\&.*;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3public class NameClient {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 public static void main(String args[]) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 try {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
In Start the Naming Service, the \f3nameserver\fR was started on port 1050\&. The following code ensures that the client program is aware of this port number\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 Properties props = new Properties();\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ORB orb = ORB\&.init(args, props);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
This code obtains the initial naming context and assigns it to \f3ctx\fR\&. The second line copies \f3ctx\fR into a dummy object reference \f3objref\fR that is attached to various names and added into the name space\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 NamingContext ctx =\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NamingContextHelper\&.narrow(\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 orb\&.resolve_initial_references("NameService"));\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NamingContext objref = ctx;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
This code creates a name \f3plans\fR of type \f3text\fR and binds it to the dummy object reference\&. \f3plans\fR is then added under the initial naming context using the \f3rebind\fR method\&. The \f3rebind\fR method enables you to run this program over and over again without getting the exceptions from using the \f3bind\fR method\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 NameComponent nc1 = new NameComponent("plans", "text");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NameComponent[] name1 = {nc1};\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ctx\&.rebind(name1, objref);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("plans rebind successful!");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
This code creates a naming context called \f3Personal\fR of type \f3directory\fR\&. The resulting object reference, \f3ctx2\fR, is bound to the \f3name\fR and added under the initial naming context\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 NameComponent nc2 = new NameComponent("Personal", "directory");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NameComponent[] name2 = {nc2};\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NamingContext ctx2 = ctx\&.bind_new_context(name2);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("new naming context added\&.\&.");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
The remainder of the code binds the dummy object reference using the names \f3schedule\fR and \f3calendar\fR under the \f3Personal\fR naming context (\f3ctx2\fR)\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 NameComponent nc3 = new NameComponent("schedule", "text");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NameComponent[] name3 = {nc3};\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ctx2\&.rebind(name3, objref);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("schedule rebind successful!");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NameComponent nc4 = new NameComponent("calender", "text");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NameComponent[] name4 = {nc4};\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ctx2\&.rebind(name4, objref);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("calender rebind successful!");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 } catch (Exception e) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 e\&.printStackTrace(System\&.err);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3}\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SS BROWSING\ THE\ NAME\ SPACE
|
||||
The following sample program shoes how to browse the name space\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3import java\&.util\&.Properties;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3import org\&.omg\&.CORBA\&.*;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3import org\&.omg\&.CosNaming\&.*;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3public class NameClientList {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 public static void main(String args[]) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 try {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
In Start the Naming Service, the \f3nameserver\fR was started on port 1050\&. The following code ensures that the client program is aware of this port number\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 Properties props = new Properties();\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 ORB orb = ORB\&.init(args, props);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
The following code obtains the initial naming context\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 NamingContext nc =\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 NamingContextHelper\&.narrow(\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 orb\&.resolve_initial_references("NameService"));\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
The \f3list\fR method lists the bindings in the naming context\&. In this case, up to 1000 bindings from the initial naming context will be returned in the \f3BindingListHolder\fR; any remaining bindings are returned in the \f3BindingIteratorHolder\fR\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 BindingListHolder bl = new BindingListHolder();\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 BindingIteratorHolder blIt= new BindingIteratorHolder();\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 nc\&.list(1000, bl, blIt);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
This code gets the array of bindings out of the returned \f3BindingListHolder\fR\&. If there are no bindings, then the program ends\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 Binding bindings[] = bl\&.value;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 if (bindings\&.length == 0) return;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
The remainder of the code loops through the bindings and prints outs the names\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3 for (int i=0; i < bindings\&.length; i++) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 // get the object reference for each binding\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 org\&.omg\&.CORBA\&.Object obj = nc\&.resolve(bindings[i]\&.binding_name);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 String objStr = orb\&.object_to_string(obj);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 int lastIx = bindings[i]\&.binding_name\&.length\-1;\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 // check to see if this is a naming context\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 if (bindings[i]\&.binding_type == BindingType\&.ncontext) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("Context: " +\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 bindings[i]\&.binding_name[lastIx]\&.id);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 } else {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 System\&.out\&.println("Object: " +\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 bindings[i]\&.binding_name[lastIx]\&.id);\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 } catch (Exception e) {\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 e\&.printStackTrace(System\&.err)\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3 }\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3}\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
orbd(1)
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
@@ -0,0 +1,117 @@
|
||||
'\" t
|
||||
.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
|
||||
.\" Arch: generic
|
||||
.\" Software: JDK 8
|
||||
.\" Date: 21 November 2013
|
||||
.\" SectDesc: Java Deployment Tools
|
||||
.\" Title: unpack200.1
|
||||
.\"
|
||||
.if n .pl 99999
|
||||
.TH unpack200 1 "21 November 2013" "JDK 8" "Java Deployment Tools"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
|
||||
.SH NAME
|
||||
unpack200 \- Transforms a packed file produced by pack200(1) into a JAR file for web deployment\&.
|
||||
.SH SYNOPSIS
|
||||
.sp
|
||||
.nf
|
||||
|
||||
\fBunpack200\fR [ \fIoptions\fR ] input\-file \fIJAR\-file\fR
|
||||
.fi
|
||||
.sp
|
||||
.TP
|
||||
\fIoptions\fR
|
||||
The command-line options\&. See Options\&.
|
||||
.TP
|
||||
\fIinput-file\fR
|
||||
Name of the input file, which can be a pack200 gzip file or a pack200 file\&. The input can also be JAR file produced by \f3pack200\fR(1) with an effort of \f30\fR, in which case the contents of the input file are copied to the output JAR file with the Pack200 marker\&.
|
||||
.TP
|
||||
\fIJAR-file\fR
|
||||
Name of the output JAR file\&.
|
||||
.SH DESCRIPTION
|
||||
The \f3unpack200\fR command is a native implementation that transforms a packed file produced by \f3pack200\fR\f3(1)\fR into a JAR file\&. A typical usage follows\&. In the following example, the \f3myarchive\&.jar\fR file is produced from \f3myarchive\&.pack\&.gz\fR with the default \f3unpack200\fR command settings\&.
|
||||
.sp
|
||||
.nf
|
||||
\f3unpack200 myarchive\&.pack\&.gz myarchive\&.jar\fP
|
||||
.fi
|
||||
.nf
|
||||
\f3\fP
|
||||
.fi
|
||||
.sp
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
-Hvalue --deflate-hint=\fIvalue\fR
|
||||
.br
|
||||
Sets the deflation to be \f3true\fR, \f3false\fR, or \f3keep\fR on all entries within a JAR file\&. The default mode is \f3keep\fR\&. If the value is \f3true\fR or \f3false\fR, then the \f3--deflate=hint\fR option overrides the default behavior and sets the deflation mode on all entries within the output JAR file\&.
|
||||
.TP
|
||||
-r --remove-pack-file
|
||||
.br
|
||||
Removes the input pack file\&.
|
||||
.TP
|
||||
-v --verbose
|
||||
.br
|
||||
Displays minimal messages\&. Multiple specifications of this option displays more verbose messages\&.
|
||||
.TP
|
||||
-q --quiet
|
||||
.br
|
||||
Specifies quiet operation with no messages\&.
|
||||
.TP
|
||||
-lfilename --log-file=\fIfilename\fR
|
||||
.br
|
||||
Specifies a log file where output messages are logged\&.
|
||||
.TP
|
||||
-? -h --help
|
||||
.br
|
||||
Prints help information about the \f3unpack200\fR command\&.
|
||||
.TP
|
||||
-V --version
|
||||
.br
|
||||
Prints version information about the \f3unpack200\fR command\&.
|
||||
.TP
|
||||
-J\fIoption\fR
|
||||
.br
|
||||
Passes option to the Java Virtual Machine, where \f3option\fR is one of the options described on the reference page for the Java application launcher\&. For example, \f3-J-Xms48m\fR sets the startup memory to 48 MB\&. See java(1)\&.
|
||||
.SH NOTES
|
||||
This command should not be confused with the \f3unpack\fR command\&. They are distinctly separate products\&.
|
||||
.PP
|
||||
The Java SE API Specification provided with the JDK is the superseding authority in case of discrepancies\&.
|
||||
.SH EXIT\ STATUS
|
||||
The following exit values are returned: 0 for successful completion, and a value that is greater than 0 when an error occurred\&.
|
||||
.SH SEE\ ALSO
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
pack200(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
jar(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
jarsigner(1)
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
Pack200 and Compression at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/deployment/deployment-guide/pack200\&.html
|
||||
.TP 0.2i
|
||||
\(bu
|
||||
The Java SE Technical Documentation page at http://docs\&.oracle\&.com/javase/
|
||||
.RE
|
||||
.br
|
||||
'pl 8.5i
|
||||
'bp
|
||||
Reference in New Issue
Block a user