annotate src/bsd/doc/man/ja/javah.1 @ 2640:9282f04c3555

. Make changes to the BSD man pages identical to those made to the Linux man pages.
author Greg Lewis <glewis@eyesbeyond.com>
date Sat, 17 Jul 2010 18:02:36 -0700
parents 8356c7fa1a33
children 24a70eaf47af
rev   line source
glewis@2640 1 ." Copyright (c) 1994, 2010, Oracle and/or its affiliates. All rights reserved.
kurt@1245 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
kurt@1245 3 ."
kurt@1245 4 ." This code is free software; you can redistribute it and/or modify it
kurt@1245 5 ." under the terms of the GNU General Public License version 2 only, as
kurt@1245 6 ." published by the Free Software Foundation.
kurt@1245 7 ."
kurt@1245 8 ." This code is distributed in the hope that it will be useful, but WITHOUT
kurt@1245 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
kurt@1245 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
kurt@1245 11 ." version 2 for more details (a copy is included in the LICENSE file that
kurt@1245 12 ." accompanied this code).
kurt@1245 13 ."
kurt@1245 14 ." You should have received a copy of the GNU General Public License version
kurt@1245 15 ." 2 along with this work; if not, write to the Free Software Foundation,
kurt@1245 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
kurt@1245 17 ."
glewis@2552 18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
glewis@2552 19 ." or visit www.oracle.com if you need additional information or have any
glewis@2552 20 ." questions.
kurt@1245 21 ."
glewis@2640 22 .TH javah 1 "02 Jun 2010"
kurt@1245 23
kurt@1245 24 .LP
kurt@1245 25 .SH "名前"
kurt@1245 26 javah \- C ヘッダーとスタブファイルジェネレータ
kurt@1245 27 .LP
kurt@1245 28 .RS 3
kurt@1245 29
kurt@1245 30 .LP
kurt@1245 31 .LP
kurt@1245 32 \f3javah\fP は、Java クラスから C ヘッダーファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
kurt@1245 33 .LP
kurt@1245 34 .RE
kurt@1245 35 .SH "形式"
glewis@933 36 .LP
glewis@933 37
glewis@933 38 .LP
kurt@1245 39 .nf
kurt@1245 40 \f3
kurt@1245 41 .fl
kurt@1245 42 javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
kurt@1245 43 .fl
kurt@1245 44 javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
kurt@1245 45 .fl
kurt@1245 46 \fP
kurt@1245 47 .fi
kurt@1245 48
glewis@933 49 .LP
kurt@1245 50 .SH "説明"
glewis@933 51 .LP
glewis@933 52
glewis@933 53 .LP
glewis@933 54 .LP
kurt@1245 55 \f3javah\fP は、ネイティブメソッドを実装するために必要な C ヘッダーとソースファイルを生成します。作成されたヘッダーとソースファイルは、ネイティブソースコードからオブジェクトのインスタンス変数を参照するために C プログラムによって使用されます。.h ファイルは、対応するクラスと一致する配置を持つ構造体定義を含みます。構造体のフィールドは、クラスのインスタンス変数に対応します。
kurt@1245 56 .LP
kurt@1245 57 .LP
kurt@1245 58 ヘッダーファイルとその中で宣言される構造体の名前はクラスの名前から派生します。\f3javah\fP に渡されるクラスがパッケージの中にある場合、パッケージ名はヘッダーファイル名と構造体名の両方に付加されます。下線 (_) が名前の区切り文字として使用されます。
kurt@1245 59 .LP
kurt@1245 60 .LP
kurt@1245 61 デフォルトでは \f3javah\fP は、コマンド行にリストされる各クラスのヘッダーファイルを作成し、現在のディレクトリにファイルを置きます。ソースファイルを作成するには、\f2\-stubs\fP オプションを使用してください。1 つのファイルの中に、リストされたすべてのクラスの結果を連結するには、\f2\-o\fP オプションを使用してください。
kurt@1245 62 .LP
kurt@1245 63 .LP
kurt@1245 64 新しいネイティブメソッドインタフェースである Java Native Interface (JNI) は、ヘッダー情報またはスタブファイルを必要としません。 現在では、\f3javah\fP は、JNI 形式のネイティブメソッドに必要なネイティブメソッド機能プロトタイプを生成します。 デフォルトでは、\f3javah\fP は JNI 形式で出力され、その結果は .h ファイルに格納されます。
kurt@1245 65 .LP
kurt@1245 66 .LP
kurt@1245 67 \f3javah_g\fP は、jdb(1) のようなデバッガに適した、\f3javah\fP の最適化されていないバージョンです。
kurt@1245 68 .LP
kurt@1245 69 .SH "オプション"
kurt@1245 70 .LP
kurt@1245 71
kurt@1245 72 .LP
kurt@1245 73 .RS 3
kurt@1245 74 .TP 3
kurt@1245 75 \-o outputfile
kurt@1245 76 コマンド行にリストされたすべてのクラスに対して、結果のヘッダーまたはソースファイルを連結して \f2outputfile\fP に格納します。\f3\-o\fP または \f3\-d\fP のどちらか一方だけが使われます。
kurt@1245 77 .TP 3
kurt@1245 78 \-d directory
kurt@1245 79 \f3javah\fP がヘッダーファイルまたはスタブファイルを保存する、ディレクトリを設定します。\f3\-d\fP または \f3\-o\fP のどちらか一方だけが使われます。
kurt@1245 80 .TP 3
kurt@1245 81 \-stubs
kurt@1245 82 \f3javah\fP が、Java オブジェクトファイルから C 宣言を生成します。
kurt@1245 83 .TP 3
kurt@1245 84 \-verbose
kurt@1245 85 詳細出力を指定し、作成ファイルの状態に関するメッセージを、\f3javah\fP が標準出力に出力します。
kurt@1245 86 .TP 3
kurt@1245 87 \-help
kurt@1245 88 \f3javah\fP の使用法についてのヘルプメッセージを出力します。
kurt@1245 89 .TP 3
kurt@1245 90 \-version
kurt@1245 91 \f3javah\fP のバージョン情報を出力します。
kurt@1245 92 .TP 3
kurt@1245 93 \-jni
kurt@1245 94 JNI 形式のネイティブファイル機能プロトタイプを含む出力ファイルを、\f3javah\fP が作成します。これは標準出力であるため、\f3\-jni\fP の使用はオプションです。
kurt@1245 95 .TP 3
kurt@1245 96 \-classpath path
kurt@1245 97 クラスを探すために \f3javah\fP が使用するパスを指定します。デフォルトまたは CLASSPATH 環境変数設定を上書きします。ディレクトリはコロンで分割します。したがって、\f2path\fP の一般形式は次のようになります。
kurt@1245 98 .nf
kurt@1245 99 \f3
kurt@1245 100 .fl
kurt@1245 101 .:<your_path>
kurt@1245 102 .fl
kurt@1245 103 \fP
kurt@1245 104 .fi
kurt@1245 105 例を示します。
kurt@1245 106 .nf
kurt@1245 107 \f3
kurt@1245 108 .fl
kurt@1245 109 .:/home/avh/classes:/usr/local/java/classes
kurt@1245 110 .fl
kurt@1245 111 \fP
kurt@1245 112 .fi
kurt@1245 113 .LP
kurt@1245 114 便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
kurt@1245 115 .br
kurt@1245 116 .br
kurt@1245 117 たとえば、ディレクトリ \f2foo\fP に \f2a.jar\fP と \f2b.JAR\fP が含まれている場合、クラスパス要素 \f2foo/*\fP は \f2A.jar:b.JAR\fP に展開されます。 ただし、JAR ファイルの順番は指定されません。このリストには、隠しファイルも含め、指定されたディレクトリ内のすべての JAR ファイルが含まれます。\f2*\fP だけから成るクラスパスエントリは、カレントディレクトリ内のすべての JAR ファイルのリストに展開されます。\f2CLASSPATH\fP 環境変数も、定義時には同様に展開されます。クラスパスのワイルドカード展開は必ず、Java 仮想マシンの起動前に実行されます。したがって、\f2System.getenv("CLASSPATH")\fP 呼び出しのように環境に問い合わせを行わない限り、Java プログラムが展開されていないワイルドカードを認識することはありません。
kurt@1245 118 .TP 3
kurt@1245 119 \-bootclasspath path
kurt@1245 120 ブートストラップクラスをロードするパスを指定します。ブートストラップクラスは、デフォルトでは \f2jre/lib/rt.jar\fP および他のいくつかの JAR ファイル にある、コア Java 2 プラットフォームを実装するクラスです。
kurt@1245 121 .TP 3
kurt@1245 122 \-old
kurt@1245 123 古い JDK1.0 形式のヘッダーファイルを生成するように指定します。
kurt@1245 124 .TP 3
kurt@1245 125 \-force
kurt@1245 126 出力ファイルが常に書き込まれるように指定します。
kurt@1245 127 .TP 3
kurt@1245 128 \-Joption
kurt@1245 129 Java 仮想マシンに \f2option\fP を渡します。 \f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。
kurt@1245 130 .RE
kurt@1245 131
kurt@1245 132 .LP
kurt@1245 133 .SH "環境変数"
kurt@1245 134 .LP
kurt@1245 135
kurt@1245 136 .LP
kurt@1245 137 .RS 3
kurt@1245 138 .TP 3
kurt@1245 139 CLASSPATH
kurt@1245 140 ユーザー定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割されています。
kurt@1245 141 .nf
kurt@1245 142 \f3
kurt@1245 143 .fl
kurt@1245 144 .:/home/avh/classes:/usr/local/java/classes
kurt@1245 145 .fl
kurt@1245 146 \fP
kurt@1245 147 .fi
kurt@1245 148 .RE
kurt@1245 149
kurt@1245 150 .LP
kurt@1245 151 .SH "関連項目"
kurt@1245 152 .LP
kurt@1245 153
kurt@1245 154 .LP
kurt@1245 155 .LP
kurt@1245 156 javac(1)、java(1)、jdb(1)、javap(1)、javadoc(1)
glewis@933 157 .LP
glewis@933 158