jdk/src/linux/doc/man/ja/javah.1
changeset 2692 345bc8d65b19
parent 2 90ce3da70b43
child 5506 202f599c92aa
equal deleted inserted replaced
2691:bad7bbf42755 2692:345bc8d65b19
     1 '\" t
     1 ." Copyright 2002-2006 Sun Microsystems, Inc.  All Rights Reserved.
     2 .\"
     2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3 .\" Copyright 2000-2006 Sun Microsystems, Inc.  All Rights Reserved.
     3 ."
     4 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4 ." This code is free software; you can redistribute it and/or modify it
     5 .\"
     5 ." under the terms of the GNU General Public License version 2 only, as
     6 .\" This code is free software; you can redistribute it and/or modify it
     6 ." published by the Free Software Foundation.
     7 .\" under the terms of the GNU General Public License version 2 only, as
     7 ."
     8 .\" published by the Free Software Foundation.
     8 ." This code is distributed in the hope that it will be useful, but WITHOUT
     9 .\"
     9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    10 .\" This code is distributed in the hope that it will be useful, but WITHOUT
    10 ." FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    11 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    11 ." version 2 for more details (a copy is included in the LICENSE file that
    12 .\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    12 ." accompanied this code).
    13 .\" version 2 for more details (a copy is included in the LICENSE file that
    13 ."
    14 .\" accompanied this code).
    14 ." You should have received a copy of the GNU General Public License version
    15 .\"
    15 ." 2 along with this work; if not, write to the Free Software Foundation,
    16 .\" You should have received a copy of the GNU General Public License version
    16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    17 .\" 2 along with this work; if not, write to the Free Software Foundation,
    17 ."
    18 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    18 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    19 .\"
    19 ." CA 95054 USA or visit www.sun.com if you need additional information or
    20 .\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
    20 ." have any questions.
    21 .\" CA 95054 USA or visit www.sun.com if you need additional information or
    21 ."
    22 .\" have any questions.
    22 .TH javah 1 "04 May 2009"
    23 .\"
    23 ." Generated from HTML by html2man (author: Eric Armstrong)
    24 .\" 
    24 
    25 '\"macro stdmacro
    25 .LP
    26 .TH javah 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
    26 .SH ""
    27 .SH "名前"
    27 javah \- C 若鴻帥<ゃ吾с若
    28 javah \- C 言語のヘッダとスタブファイルのジェネレータ
    28 .LP
    29 .\" 
    29 .RS 3
    30 .\"  This document was created by saving an HTML file as text
    30 
    31 .\"  from the JavaSoft web site:
    31 .LP
    32 .\" 
    32 .LP
    33 .\" http://java.sun.com/products/jdk/1.2/docs/tooldocs/tools.html
    33 \f3javah\fP Java 鴻 C 若<ゃ C 純若鴻<ゃ篏障<ゃJava 違潟域茯ф吾潟若C 篁荐茯ф吾潟若・膓潟若娯篏障
    34 .\" 
    34 .LP
    35 .\"  and adding appropriate troff macros.  Because the JavaSoft web site 
    35 .RE
    36 .\"  man pages can change without notice, it may be helpful to diff
    36 .SH "綵√"
    37 .\"  files to identify changes other than new functionality. 
    37 .LP
    38 .\" 
    38 
       
    39 .LP
       
    40 .nf
       
    41 \f3
       
    42 .fl
       
    43 javah [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
       
    44 .fl
       
    45 javah_g [ \fP\f3options\fP\f3 ] fully\-qualified\-classname. . .
       
    46 .fl
       
    47 \fP
       
    48 .fi
       
    49 
       
    50 .LP
       
    51 .SH "茯"
    39 .LP
    52 .LP
    40 
    53 
    41 .LP
    54 .LP
    42 .LP
    55 .LP
    43 \f3javah\fP は、Java クラスから C ヘッダファイルと C ソースファイルを作成します。これらのファイルは、Java プログラミング言語で書かれたコードと、C などのその他の言語で書かれたコードを接続し、コードが相互に作用するようにします。
    56 \f3javah\fP ゃc<純絎茖綽荀 C 若純若鴻<ゃ障篏若純若鴻<ゃゃc純若鴻潟若吾сゃ潟鴻帥潟劫違с C 違c篏睡障.h <ゃ絲上鴻筝眼臀ゆ篏絎臂帥障罕篏c若鴻ゃ潟鴻帥潟劫違絲上障
    44 .LP
    57 .LP
    45 .SH "形式"
       
    46 .B javah 
       
    47 [
       
    48 .B options
       
    49 ]
       
    50 .I fully-qualified-classname . . .
       
    51 .br
       
    52 .B javah_g 
       
    53 [
       
    54 .B options
       
    55 ]
       
    56 .I fully-qualified-classname . . .
       
    57 .SH "機能説明"
       
    58 .IX "stub file generator" "" "stub file generator \(em \fLjavah\fP"
       
    59 .IX "C header and stub file generator" "" "C header and stub file generator \(em \fLjavah\fP"
       
    60 .IX "javah" "" "\fLjavah\fP \(em C header and stub file generator"
       
    61 .B javah
       
    62 コマンドは、ネイティブメソッドを実装するのに必要な
       
    63 C
       
    64 言語のヘッダおよびソースファイルを生成します。
       
    65 C
       
    66 のプログラムは、
       
    67 生成されたヘッダとソースファイルを使って、
       
    68 ネイティブソースコードからオブジェクトのインスタンス
       
    69 変数を参照できます。
       
    70 .B .h
       
    71 ファイルは、対応するクラスに合ったレイアウトの
       
    72 構造体定義を含んでいます。
       
    73 構造体に含まれるフィールドは、クラス内のインスタンス変数に
       
    74 対応しています。
       
    75 .LP
    58 .LP
    76 ヘッダファイル名およびヘッダファイル中で定義される構造体名は、
    59 若<ゃ筝уh罕篏鴻羇丞障\f3javah\fP 羝<鴻宴若吾筝翫宴若後若<ゃ罕篏筝≧鴻篁障筝膩 (_) 阪絖篏睡障
    77 クラス名から派生します。
       
    78 .B javah
       
    79 に渡されるクラスがパッケージ内部にあれば、
       
    80 そのパッケージ名がファイル名および構造体名の先頭に付加されます。
       
    81 名前の間は下線
       
    82 (_)
       
    83 で区切られます。
       
    84 .LP
    60 .LP
    85 デフォルトでは、
       
    86 .B javah
       
    87 はコマンド行で指定された個々のクラスに対して
       
    88 ヘッダファイルを作成し、現在のディレクトリに出力します。
       
    89 .B \-stubs
       
    90 オプションを指定するとソースファイルが生成されます。
       
    91 .B \-o
       
    92 オプションを指定すると、指定した全クラスに対する出力ファイル
       
    93 を連結して
       
    94 1
       
    95 個のファイルとして生成します。
       
    96 .LP
    61 .LP
    97 新しいネイティブメソッドインタフェースの
    62 с \f3javah\fP 潟潟茵鴻鴻若<ゃ篏憜c<ゃ臀障純若鴻<ゃ篏\f2\-stubs\fP 激с潟篏睡1 ゃ<ゃ筝鴻鴻鴻腟g\f2\-o\fP 激с潟篏睡
    98 Java Native Interface (JNI)
       
    99 は、ヘッダ情報やスタブファイルを必要としません。
       
   100 ただし
       
   101 .B javah
       
   102 コマンドは現在も JNI 形式のネイティブメソッドに必要な
       
   103 ネイティブメソッド関数プロトタイプを生成できます。
       
   104 .B javah 
       
   105 はデフォルトで JNI 形式で出力し、その結果を 
       
   106 .B .h
       
   107 ファイルに格納します。
       
   108 .LP
    63 .LP
   109 .B javah_g
       
   110 は非最適化バージョンの
       
   111 .B javah
       
   112 で、
       
   113 .B jdb
       
   114 などのデバッガ用の使用に適しています。
       
   115 .SH "オプション"
       
   116 .TP 15
       
   117 .BI \-o " outputfile"
       
   118 コマンド行で指定したすべてのクラスに対する結果のヘッダファイルまたは
       
   119 ソースファイルを連結し、
       
   120 .BR outputfile 
       
   121 に格納します。
       
   122 .B \-o
       
   123 オプションまたは 
       
   124 .B \-d
       
   125 オプションだけを使用できます。
       
   126 .TP 15
       
   127 .BI \-d " directory"
       
   128 .B javah
       
   129 がヘッダファイルまたはスタブファイルを書き出す
       
   130 ディレクトリを指定します。
       
   131 .TP 15
       
   132 .B \-stubs
       
   133 Java オブジェクトファイルから C 言語の宣言を生成します。
       
   134 .TP 15
       
   135 .B \-verbose
       
   136 詳細情報の出力を要求します。
       
   137 .B javah
       
   138 は、生成されたファイルの状態に関するメッセージを
       
   139 .B stdout
       
   140 に書き出します。
       
   141 .TP 15
       
   142 .B  \-help
       
   143 .B javah
       
   144 の使用法についてヘルプメッセージを出力します。
       
   145 .TP 15
       
   146 .B \-version
       
   147 javah バージョン情報を出力します。
       
   148 .TP 15
       
   149 .B  \-jni
       
   150 JNI 形式のネイティブなメソッド関数のプロトタイプが入った出力ファイルを
       
   151 作成します。これはデフォルトの出力であるため、
       
   152 -B \-jni
       
   153 は省略可能です。
       
   154 .TP 15
       
   155 .BI \-classpath " path"
       
   156 .B javah
       
   157 がクラスを検索するために用いるパスを
       
   158 .I path
       
   159 で指定します。この指定値は、デフォルトおよび
       
   160 .B CLASSPATH
       
   161 環境変数の設定値をオーバーライドします。
       
   162 複数のディレクトリを指定する場合はコロンで区切ります。
       
   163 したがって
       
   164 .I path
       
   165 の通常の形式は次のようになります。
       
   166 .RS 20
       
   167 .sp 1n
       
   168 .LP
    64 .LP
   169 .BI .:< your_path >
    65 違ゃc<純ゃ潟帥с若鴻с Java Native Interface (JNI) 惹宴障鴻帥<ゃ綽荀障 憜с\f3javah\fP JNI 綵√ゃc<純綽荀ゃc<純罘純帥ゃ障 с\f3javah\fP  JNI 綵√у阪腟 .h <ゃ主障
   170 .sp 1n
       
   171 .RE
       
   172 .RS 15
       
   173 .LP
    66 .LP
   174 パスの指定例:
       
   175 .RE
       
   176 .RS 20
       
   177 .sp 1n
       
   178 .LP
    67 .LP
   179 .B .:/home/avh/classes:/usr/local/java/classes
    68 \f3javah_g\fP jdb(1) \f3javah\fP 若吾с潟с
   180 .sp 1n
       
   181 .RE
       
   182 .LP
    69 .LP
   183 便宜上、\f2*\fP のベース名を含むクラスパス要素は、ディレクトリ内の拡張子 \f2.jar\fP または \f2.JAR\fP を持つすべてのファイルのリストを指定するのと同じとみなされます (Java プログラムはこの 2 つの呼び出しを区別できない)。
    70 .SH "激с"
       
    71 .LP
       
    72 
       
    73 .LP
       
    74 .RS 3
       
    75 .TP 3
       
    76 \-o outputfile 
       
    77 潟潟茵鴻鴻鴻絲障腟若障純若鴻<ゃg \f2outputfile\fP 主障\f3\-o\fP 障 \f3\-d\fP <筝鴻篏帥障 
       
    78 .TP 3
       
    79 \-d directory 
       
    80 \f3javah\fP 若<ゃ障鴻帥<ゃ篆絖c荐絎障\f3\-d\fP 障 \f3\-o\fP <筝鴻篏帥障 
       
    81 .TP 3
       
    82 \-stubs 
       
    83 \f3javah\fP Java 吾с<ゃ C 絎h障 
       
    84 .TP 3
       
    85 \-verbose 
       
    86 荅括完阪絎篏<ゃ倶≪<祉若吾\f3javah\fP 罔羣阪阪障 
       
    87 .TP 3
       
    88 \-help 
       
    89 \f3javah\fP 篏睡羈ゃ<祉若吾阪障 
       
    90 .TP 3
       
    91 \-version 
       
    92 \f3javah\fP 若吾с恰宴阪障 
       
    93 .TP 3
       
    94 \-jni 
       
    95 JNI 綵√ゃc<ゃ罘純帥ゃ阪<ゃ\f3javah\fP 篏障罔羣阪с\f3\-jni\fP 篏睡激с潟с 
       
    96 .TP 3
       
    97 \-classpath path 
       
    98 鴻「 \f3javah\fP 篏睡鴻絎障障 CLASSPATH 医紊域┃絎筝吾障c潟潟у蚊障c\f2path\fP 筝綵√罨<障 
       
    99 .nf
       
   100 \f3
       
   101 .fl
       
   102    .:<your_path>
       
   103 .fl
       
   104 \fP
       
   105 .fi
       
   106 箴腓冴障 
       
   107 .nf
       
   108 \f3
       
   109 .fl
       
   110    .:/home/avh/classes:/usr/local/java/classes
       
   111 .fl
       
   112 \fP
       
   113 .fi
       
   114 .LP
       
   115 箴水筝\f2*\fP 若劫鴻壕膣c≦宍絖 \f2.jar\fP 障 \f2.JAR\fP ゃ鴻<ゃ鴻絎帥障 (Java 違 2 ゃ若喝冴阪ャс)
   184 .br
   116 .br
   185 .br
   117 .br
   186 たとえば、ディレクトリ \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 プログラムは認識しません。   
   118 違c \f2foo\fP  \f2a.jar\fP  \f2b.JAR\fP 障翫鴻壕膣 \f2foo/*\fP  \f2A.jar:b.JAR\fP 絮障 JAR <ゃ絎障鴻<ゃ絎c鴻 JAR <ゃ障障\f2*\fP 鴻鴻潟潟c鴻 JAR <ゃ鴻絮障\f2CLASSPATH\fP 医紊違絎臂罕絮障鴻鴻ゃ若絮綽Java 篁潟激潟莎桁絎茵障c\f2System.getenv("CLASSPATH")\fP 若喝冴医茵Java 違絮ゃ若茯茘障   
   187 .TP 15
   119 .TP 3
   188 .BI \-bootclasspath " path"
   120 \-bootclasspath path 
   189 bootstrap クラスをロードするパスを指定します。デフォルトでは、bootstrap 
   121 若鴻鴻若鴻絎障若鴻鴻с \f2jre/lib/rt.jar\fP 割ゃ JAR <ゃ 潟 Java 2 若絎茖鴻с 
   190 クラスはコアとなる Java 2 プラットフォームを実装するクラスで、
   122 .TP 3
   191 .B jre/lib/rt.jar
   123 \-old 
   192 および他の重要な jar ファイルに含まれています。
   124 ゃ JDK1.0 綵√若<ゃ絎障 
   193 .TP 15
   125 .TP 3
   194 .B \-old
   126 \-force 
   195 古い JDK 1.0 形式のヘッダファイルを生成します。
   127 阪<ゃ絽吾吾莨若障絎障 
   196 .TP 15
   128 .TP 3
   197 .B  \-force
   129 \-Joption 
   198 常に出力ファイルに書き込むことを指定します。
   130 Java 篁潟激潟 \f2option\fP 羝<障 \f2option\fP java(1)<潟鴻若吾荐莠激с潟 1 ゆ絎障違\f3\-J\-Xms48m\fP 絎鴻帥若≪<≪若 48M ゃ荐絎障 
   199 .TP 15
   131 .RE
   200 .BI \-J "option"
   132 
   201 .I option
       
   202 を Java 仮想マシンに渡します。ここで、
       
   203 .I option
       
   204 は、Java アプリケーション起動プログラムの参照ページで
       
   205 説明されているオプションの 1 つです。たとえば、
       
   206 .I \-J-Xms48m
       
   207 は、起動時に使用するメモリを 48M バイトに設定します。
       
   208 .SH "環境変数"
       
   209 .TP 15
       
   210 .B CLASSPATH
       
   211 ユーザ定義クラスへのパスをシステムに通知するために使用します。
       
   212 複数のディレクトリを指定する場合はコロンで区切ります。
       
   213 以下に例を示します。
       
   214 .RS 10
       
   215 .sp 1n
       
   216 .LP
   133 .LP
   217 .B .:/home/avh/classes:/usr/local/java/classes
   134 .SH "医紊"
       
   135 .LP
       
   136 
       
   137 .LP
       
   138 .RS 3
       
   139 .TP 3
       
   140 CLASSPATH 
       
   141 若吟弱臂鴻吾鴻激鴻絎障c潟潟у蚊障 
       
   142 .nf
       
   143 \f3
       
   144 .fl
       
   145 .:/home/avh/classes:/usr/local/java/classes
       
   146 .fl
       
   147 \fP
       
   148 .fi
   218 .RE
   149 .RE
   219 .SH "関連項目"
   150 
       
   151 .LP
       
   152 .SH "∫i"
   220 .LP
   153 .LP
   221 
   154 
   222 .LP
   155 .LP
   223 .LP
   156 .LP
   224 javac、java、jdb、javap、javadoc
   157 javac(1)java(1)jdb(1)javap(1)javadoc(1)
   225 .LP
   158 .LP
   226 
   159 
   227 .LP
   160 .LP
   228  
   161