第 3 章 コンパイラオプション

この章では、f95 コンパイラのコマンド行オプションについて説明します。

• コンパイラオプションフラグに使用する構文の説明: 「3.1 コマンド構文」

• 機能別のオプションのまとめ: 「3.3 オプションのまとめ」

• 各コンパイラオプションフラグに関する詳細リファレンス: 「3.4 オプションリファレンス」

3.1 コマンド構文

コンパイラのコマンド行の構文は次のとおりです。

f95 [options] list_of_files  additional_options

角括弧 ([ ]) の中の項目は省略可能なパラメータを示します。角括弧自体はコマンドの一部ではありません。options には、先頭にハイフン (-) を付けたオプションキーワードを指定します。オプションによっては、リスト中の次の項目を引数として取るものがあります。list_of_files には、ソース、オブジェクトまたはライブラリのファイル名を空白で区切って複数指定することができます。また、オプションによっては、ソースファイルリストよりもあとに続けて指定しなければならないものがあります (たとえば、 -B、-l、および -L)。 これらのオプションには、そのオプション用のファイルリストを指定してもかまいません。

3.2 オプションの構文

コンパイラオプションの一般的な書式を次に示します。

次の表記規則に従って、オプションを説明しています。

括弧、縦棒、省略符号は、オプションを記述するために使用している記号で、オプション自体の一部ではありません。

オプションの一般的な規則を次に示します。

• -lx は libx .a ライブラリにリンクするためのオプションです。-lx は必ずファイル名リストのあとに指定して、ライブラリの検索順序が保たれるようにしてください。

• 通常、コンパイラオプションは左から右の順序で処理されます。このため、マクロのオプション (別のオプションを含むオプションも) を意図的に上書きすることができます。この規則はリンカーのオプションには適用されません。ただし、オプションが同じコマンド行で繰り返される場合は、-I、-L、-R などは以前に指定した値を上書きせずに、順番に処理します。

• -xhasc[ ={yes|no}] などの複数の選択肢リストの最初の選択肢は、コマンド行に値なしでオプションのフラグが指定された場合に適用される値です。たとえば -xhasc は -xhasc=yes と指定するのと同じことです。

• ソースファイル、オブジェクトファイル、およびライブラリは、コマンド行に現れる順にコンパイルとリンクが実行されます。

3.3 オプションのまとめ

この節では、各コンパイラオプションを機能別に分類し、概略を説明します。詳細は、次の詳細欄に示すページを参照してください。

SPARC および x64/x86 プラットフォーム両方ですべてのオプションを使用できるわけではないことに注意してください。使用可能かどうかについては、詳細オプションリファレンスの節で確認してください。

次の表に、f95 のコンパイラオプションを機能別にまとめます。この表には、廃止されたり使用されなくなったりしたオプションフラグは含まれていません。フラグによっては、複数の使用目的があるため、複数の個所に記載されているものがあります。

3.3.1 頻繁に利用するオプション

コンパイラには、オプションのコマンド行パラメータによって選択できる機能が数多くあります。次の表に、頻繁に利用するオプションをまとめてあります。

3.3.2 マクロフラグ

マクロフラグによっては、別のフラグの組み合わせに展開されるマクロもあります。これらのマクロフラグは、ある機能を選択するために、通常一緒に表示されるオプションを簡単に指定できるように提供されるものです。

コマンド行でマクロフラグのあとに別のオプションを設定すると、このマクロの展開内容は上書きまたは追加されます。

3.3.3 下位互換のための旧オプション

コンパイラの初期リリース、および Fortran の一部旧機能との下位互換のためのオプションを示します。

移植性のある Fortran 95 プログラムを作成する際には、これらのオプションフラグは使用しないでください。

3.3.4 旧オプションフラグ

次のオプションは廃止されています。 使用しないでください。将来のコンパイラでは、これらのオプションは削除される予定です。

3.4 オプションリファレンス

この節では、すべての f95 コンパイラコマンド行オプションフラグについて説明します。これには、さまざまなリスク、制約、警告、相互作用、例、およびその他の詳細情報も含まれます。

各オプションは、特に付記していないかぎり、SPARC および x64/x86 プラットフォームの両方で有効です。SPARC プラットフォームでのみ有効なオプションフラグは (SPARC) と付記しています。x64/x86 プラットフォームでのみ有効なオプションフラグは (x86) と付記しています。

(廃止) と付記されているオプションフラグは廃止されているため、使わないでください。多くの場合、代わりに使用すべきほかのオプションまたはフラグに置き換えられています。

3.4.1 -a

(廃止) tcov を使用する。旧式の基本ブロックごとのプロファイリングを行います。

tcov を使用する旧式の基本ブロックごとのプロファイルを行います。新しいプロファイリング方法については、-xprofile=tcov を参照してください。 詳細は、tcov(1) マニュアルページを参照してください。

3.4.2 -aligncommon[ ={1|2|4| 8|16}]

共通ブロックおよび標準の数値連続型のデータの境界整列を指定します。

指定された値は、共通ブロックおよび標準数値連続型内のデータ要素の整列の最大値 (単位はバイト) を示します。

標準の数値連続型 とは、SEQUENCE 文 1 つとデフォルトの要素データ型 (KIND= または * size のどちらも付かない INTEGER、REAL、DOUBLEPRECISION、COMPLEX) からなる構造型です。REAL*8 などのほかのすべての型は非標準の型になります。

たとえば、-aligncommon=4 と指定すると、4 バイト以上の自然整列サイズを保つ全データ要素が、4 バイト境界に整列します。

このオプションは、指定のサイズより小さい自然整列サイズを保つデータに影響しません。

-aligncommon を指定しないと、共通ブロック内のデータおよび数値連続型のデータは、多くても 4 バイト境界に整列されます。

値を指定せずに -aligncommon だけを指定すると、デフォルトの 1 が仮定され、共通ブロックおよび数値連続型の要素は、すべて 1 バイト境界に整列されます。要素間のパディングは行われません。

-aligncommon=16 は、64 ビットが有効ではないプラットフォームにおいて -aligncommon=8 に戻ります。

3.4.3 -ansi

標準外の拡張機能を識別します。

ソースコード中で、標準外の Fortran 95 の拡張機能を使用すると、警告メッセージが出力されます。

3.4.4 -arg=local

ENTRY 文に対する実際の引数を保持します。

このオプションを使って代替エントリポイントを持つ副プログラムをコンパイルする場合、f95 は、copy または restore を使用して、ダミー引数と実際の引数の関連付けを保持します。

このオプションは、従来の FORTRAN 77 プログラムとの互換性のために用意されています。このオプションに依存するコードは、標準外です。

3.4.5 -autopar

ループの自動並列化を使用可能にします。

マルチプロセッサで並列処理の対象に適するループを探し、そのループを並列化します。内部反復データに依存するループを解析し、ループを再構築します。最適化レベルが -O3 以上に設定されていない場合は、自動的に -O3 に設定されます。

-autopar などの並列化オプションを使用している場合は、-stackvar オプションも指定します。-autopar を使用している場合は、-stackvar オプションを使用した方がパフォーマンスが改善される場合があります。これは、オプティマイザが並列化する機会をより多く検出できるようになるためです。メインスレッドおよびスレーブスレッドのスタックサイズを設定する方法については、-stackvar オプションの説明を参照してください。

プログラム中に libthread スレッドライブラリへの明示的な呼び出しがある場合は、-autopar は使用しないでください。「3.4.60 -mt」の注釈を参照してください。

-autopar オプションは、シングルプロセッサのシステムには適していません。シングルプロセッサのシステムでこのオプションを付けてコンパイルを行うと、通常は実行速度が低下します。

並列化されたプログラムをマルチスレッド環境で実行するには、実行前に PARALLEL (または OMP_NUM_THREADS) 環境変数を設定しなければなりません。これは、プログラムが作成できる最大スレッド数を実行時システムに指示しています。デフォルトは 1 です。一般的に、PARALLEL 変数または OMP_NUM_THREADS 変数には、ターゲットプラットフォーム上の利用可能な仮想プロセッサ数を設定します。この数は、Solaris の psrinfo(1) コマンドを使用して調べることができます。

-autopar を使用してコンパイルとリンクを一度に行う場合、マルチスレッド処理ライブラリとスレッド対応の Fortran 実行時ライブラリが自動的にリンクされます。-autopar を使用してコンパイルとリンクを別々に行う場合は、適切なライブラリにリンクするために、-autopar を使用してリンクを行う必要があります。

-reduction オプションは、-autopar オプションと組み合わせて使用することもできます。

並列化についての詳細は、『Fortran プログラミングガイド』を参照してください。明示的にユーザーが制御して並列化を行う場合は、OpenMP 指令および —xopenmp オプションを使用します。

3.4.6 -B{static|dynamic}

動的または静的ライブラリリンクを指定します。

-B と dynamic または static の間に空白文字を入れないでください。-B を省略すると、デフォルトとして -Bdynamic が使用されます。

• -Bdynamic: 動的リンクを優先する (共有ライブラリのリンク)。

• -Bstatic: 静的リンクをする必要がある (共有ライブラリなし)。

次の点にも注意してください。

• static を指定した場合に動的ライブラリしか見つからないと、「library was not found」(ライブラリがありません) という警告メッセージが出力され、ライブラリのリンクは行われません。

• dynamic を指定した場合に静的ライブラリしか見つからないと、その静的ライブラリとリンクされます。 警告メッセージは表示されません。

コマンド行で、-Bstatic と -Bdynamic を切り替えることができます。次のように、-Bstatic と -Bdynamic をコマンド行で切り替えて、何回でもライブラリを静的および動的にリンクすることができます。

f95 prog.f -Bdynamic -lwells -Bstatic -lsurface

これらはローダーおよびリンカーのオプションです。コンパイルコマンドに -Bx オプションを指定してコンパイルとリンクを分けて行う場合は、リンク時にも -Bx オプションを指定する必要があります。

-Bdynamic と -dn の両方をコマンド行に指定することはできません。-dn を指定すると動的ライブラリのリンクが行われなくなるためです。

64 ビットの Solaris 環境では、ほとんどのシステムライブラリが共有動的ライブラリとして単独使用できます。これには、libm.so と libc.so も含まれます (libm.a と libc.a は提供されていない)。つまり、64 ビットの Solaris 環境で -Bstatic と -dn を指定するとリンクエラーが発生する場合があります。このような場合、アプリケーションを動的ライブラリとリンクさせる必要があります。

Fortran 実行時システムの静的ライブラリと動的ライブラリを組み合わせて使用することは推奨しません。リンカーエラーが発生したり、データが警告なしに破壊されたりする可能性があります。必ず、Fortran 実行時システムの最新の共有動的ライブラリとリンクさせてください。

静的ライブラリと動的ライブラリについての詳細は、『Fortran プログラミングガイド』を参照してください。

3.4.7 -C

実行時に、配列の添字の範囲および適合性を検査します。

配列の添字が宣言されている範囲を超えると、セグメント例外などの予期しない結果になる場合があります。-C オプションはコンパイル時と実行時に、配列の添字に違反がないかどうかを検査します。-C は、実行時に、配列の構文が適合しているかも検査します。

-C を指定すると、実行可能ファイルのサイズが大きくなる場合があります。

-C オプションを使用すると、配列の添字違反はエラーとして扱われます。ソースコードのコンパイル中に配列添字の範囲違反が検出されると、コンパイルエラーとして扱われます。

配列添字の違反が実行時だけに検出される場合、コンパイラは実行可能プログラムの中に範囲を検査するコードを生成します。この結果、実行時間が長くなることがあります。したがって、プログラムの開発やデバッグを行なっている間にこのオプションを使用して配列添字の検査を有効にしておき、最後に添字検査なしで最終バージョンの実行可能ファイルを再コンパイルすると効果的です。

3.4.8 -c

コンパイルだけを行い、.o オブジェクトファイルを生成します。 リンクは行いません。

ソースファイルごとに .o ファイルを作成します。1 つのソースファイルだけをコンパイルする場合は、-o オプションを使用して、出力先の .o ファイルの名前を指定することができます。

3.4.9 -cg89

(廃止、SPARC) 一般的な SPARC アーキテクチャー用にコンパイルを行います。

このオプションは -xtarget=ss2 と同義で、-xarch=v7 -xchip=old -xcache=64/32/1 をマクロ化したものです。

3.4.10 -cg92

(廃止、SPARC) SPARC V8 アーキテクチャー用にコンパイルを行います。

このオプションは -xtarget=ss1000 と同義で、-xarch=v8 -xchip=super -xcache=16/32/4:1024/32/1 をマクロ化したものです。

3.4.11 -copyargs

定数の引数への代入を可能にします。

定数である仮引数を副プログラムが変更できるようにします。このオプションは、すでに作成済みのコードのコンパイル時と実行時にエラーが発生しないようにすることだけを目的としています。

• -copyargs を指定しない場合、定数の引数をサブルーチンに渡し、そのサブルーチン内でその定数を変更しようとすると、実行が異常終了します。

• -copyargs を指定した場合、定数の引数をサブルーチンに渡し、そのサブルーチン内でその定数を変更しようとしても、実行が必ずしも異常終了するとは限りません。

-copyargs を指定しないと異常終了してしまうコードは、Fortran 規格に準拠していません。また、このようなコードは予測できない動作をすることがあります。

3.4.12 -Dname[=def]

プリプロセッサのシンボル name を定義します。

このオプションは .F、.F90、.F95、および .F03 ソースファイルだけに適用します。

-Dname=def name が値 def を持つものと定義します。

-Dname シンボル name を 1 と定義します。

このオプションはコマンド行で name を、

#define name[=def]

とソースファイルに記述されている場合のように定義します。=def の指定がないと、シンボル名 name は値 1 として定義されます。 マクロシンボル name はプリプロセッサ fpp (または cpp。-xpp オプションを参照) に渡されて展開されます。

事前定義されたマクロシンボルの前には 2 つの下線を付けます。Fortran 構文には事前定義されたマクロの実際の値は使用できません。事前定義されたマクロは、fpp か cpp のプリプロセッサ指令内だけで使用してください (初めに付く 2 つの下線に注意)。

• 製品バージョンは、_ _SUNPRO_F90、および _ _SUNPRO_F95 に 16 進数で事前定義されています。たとえば、_ _SUNPRO_F95 は、Sun Studio 12 release では 0x830 です。

• 次のマクロは、該当するシステム上でそれぞれ事前定義されています。

  _ _sparc、_ _unix、_ _sun、_ _SVR4、__i386、_ _SunOS_5_6、_ _SunOS_5_7、_ _SunOS_5_8、_ _SunOS_5_9、_ _SunOS_5_10

  たとえば、SPARC システム上では、_ _sparc 値が定義されています。

• sparc、unix、sun は、下線なしで事前定義されていますが、将来のリリースで削除される可能性があります。

• SPARC V9 システムでは、_ _sparcv9 マクロも定義されています。

• 64 ビット x86 システムでは、_ _amd64 および _ _x86_64 マクロが定義されています。

コンパイラが作成した定義を表示するには、冗長メッセージオプション (-v) を付けてコンパイルします。

これらの値は、次のようなプリプロセッサ条件で使用することができます。

#ifdef _ _sparc

f95 は、デフォルトで fpp(1) プリプロセッサを使用します。C プリプロセッサ cpp(1) と同様に、fpp はソースコードマクロを展開して、コードを条件付きでコンパイルすることができます。ただし、cpp とは異なり、fpp は Fortran 構文を理解できるので、Fortran プリプロセッサとしてはこちらを使用することをお勧めします。-xpp=cpp フラグを使用すると、コンパイラは fpp ではなく cpp を使用します。

3.4.13 -dalign

COMMON ブロックおよび標準の数値連続型の整列を行い、高速なマルチワードのロード/ストアを生成します。

このフラグを使用すると、COMMON ブロック、数値連続型、および EQUIVALENCE クラスのデータレイアウトが変更されるため、コンパイラは、そのデータに対する高速なマルチワードのロード/ストアを生成できるようになります。

データレイアウトは、-f フラグを指定した時と同じようになります。COMMON ブロックと EQUIVALENCE クラスの倍精度および 4 倍精度のデータが、メモリー内で「自然に」境界整列されます。 これは、8 バイトの境界整列になります。 なお、64 ビット環境で -m64 を指定してコンパイルを行うと、4 倍精度のデータは 16 バイトに境界整列されます。COMMON ブロック内のデータのデフォルト整列は、4 バイトの境界整列です。コンパイラも自然整列を前提とするため、高速なマルチワードのロード/ストアを生成してデータを参照できるようになります。

-dalign を -xtypemap=real:64,double:64,integer:64 とともに使用すると、SPARC プロセッサで 64 ビット整数変数がダブルワードで境界整列されます。

-dalign を使用すると、データの境界整列が標準に合わなくなることがあります。これが原因で、EQUIVALENCE や COMMON の変数に問題が生じることがあります。さらに、-dalign が必要な場合、移植性のないプログラムになります。

-dalign は、次と同等なマクロです。

SPARC プラットフォームの場合、-xmemalign=8s -aligncommon=16

32 ビット x86 プラットフォームの場合、-aligncommon=8

64 ビット x86 プラットフォームの場合、-aligncommon=16

ある 1 つの副プログラムに -dalign を付けてコンパイルした場合は、プログラムのすべての副プログラムに -dalign を付けてコンパイルしてください。このオプションは -fast オプションに含まれます。

-dalign は、-aligncommon を呼び出すので、標準の数値連続型も影響を受けます。「3.4.2 -aligncommon[ ={1|2|4| 8|16}]」を参照してください。

3.4.14 -dbl_align_all[ ={yes|no}]

8 バイトの境界上でデータを強制的に整列します。

値には yes または no のいずれかを指定します。値が yes の場合、変数はすべて 8 バイトの境界に整列されます。デフォルトは、-dbl_align_all=no です。

64 ビット環境で -m64 を使用してコンパイルした場合、4 倍精度のデータは 16 バイト境界に整列されます。

このフラグによって、COMMON ブロック内のデータレイアウトやユーザー定義の構造体が変更されることはありません。

-dalign と併用して、マルチワードのロード/ストアで追加した効率を有効にします。

使用した場合、すべてのルーチンをこのフラグでコンパイルする必要があります。

3.4.15 -depend[ ={yes|no}]

データ依存についてループを解析し、ループを再構築します。

依存解析は、-depend または -depend=yes によって使用可能になります。この解析は、-depend=no によって使用不可になります。これがコンパイラのデフォルト値です。

このオプションを指定すると、最適化レベルが指定されていない場合、または O3 未満の場合は、自動的に最適化レベルが O3 に設定されます。-depend は、-fast、-autopar、および -parallel オプションでも行われます。最適化レベル -O3 以上を指定した場合も、-depend が自動的に追加されます。『 Fortran プログラミングガイド』を参照してください。

3.4.16 -dn

動的ライブラリを使用不可能にします。「3.4.18 -d{ y|n}」を参照してください。

3.4.17 -dryrun

f95 のコマンド行ドライバによって実行されるコマンド群を表示しますが、コンパイルは行いません。

デバッグ時に便利です。このオプションにより、コンパイルを実行するために呼び出されるコマンドとサブオプションが表示されます。

3.4.18 -d{ y|n}

実行可能ファイル全体に対して、動的ライブラリを使用可能または使用不可にします。

• -dy: 動的/共有ライブラリを使用できます。

• -dn: 動的/共有ライブラリを使用できません。

このオプションを指定しない場合は、デフォルトとして -dy が使用されます。

-Bx とは異なり、このオプションは実行可能ファイル全体に適用され、コマンド行で 1 回だけ使用します。

-dy|-dn は、ローダーおよびリンカーのオプションです。これらのオプションを付けてコンパイルとリンクを別々に行う場合は、リンクでも同じオプションを指定する必要があります。

64 ビットの Solaris 環境で共有動的ライブラリとしてだけ使用できるシステムライブラリはほとんどありません。これには、libm.so と libc.so (libm.a と libc.a は提供されていない) も含まれます。このため、64 ビット Solaris プラットフォームと 32 ビット Solaris x86 プラットフォーム、Solaris 10 release 以降の 32 ビット Solaris プラットフォームのすべてで、-dn および -Bstatic がリンクエラーを引き起こすことがあります。この場合、アプリケーションを動的ライブラリとリンクさせる必要があります。

3.4.19 -e

拡張された入力ソース行を受け付けます。

ソース行は、132 文字まで拡張できます。コンパイラは 132 桁目まで各行の右側を空白で埋めます。-e オプションを指定してコンパイルする場合に継続行を使用するときは、文字定数が複数行にまたがらないようにしてください。複数行にまたがると、不必要な空白が定数に挿入されてしまいます。

3.4.20 -erroff[ ={%all|%none| taglist}]

タグ名によって一覧表示された警告メッセージを抑制します。

各タグ名をコンマで区切った並び (taglist) で指定した警告メッセージの表示を抑制します。%all を指定した場合は、すべての警告メッセージが抑制されます。これは、-w オプションを指定するのと同じです。%none の場合、警告メッセージは抑制されません。引数なしで —erroff を指定した場合は、—erroff=%all を指定するのと同じです。

例:

f95 -erroff=WDECL_LOCAL_NOTUSED ink.f

-errtags オプションを使用して、警告メッセージに関連付けられているタグ名を表示します。

3.4.21 -errtags[ ={yes|no}]

メッセージタグが各警告メッセージ付きで表示されます。

-errtags=yes を付けると、コンパイラの内部エラータグ名が警告メッセージとともに表示されます。-errtags だけの場合は -errtags=yes と同じです。

デフォルトでは、タグは表示されません (-errtags=no)。

demo% f95 -errtags ink.f
ink.f:
 MAIN:
"ink.f", 11 行目: 警告: 局所変数「i」が使用されていません (WDECL_LOCAL_NOTUSED)  

3.4.22 -errwarn[ ={%all|%none| taglist}]

警告メッセージをエラーとして処理します。

taglist は、エラーとして処理する警告メッセージのコンマ区切りのタグ名リストです。%all を指定した場合は、すべての警告メッセージがエラーとして処理されます。 %none の場合、警告メッセージはエラーとして処理されません。

-errtags も参照してください。

3.4.23 -explicitpar

(廃止、SPARC) Sun または Cray の指令で明示的に示されたループを並列化します。

このオプションを使用すると、従来の Sun または Cray の並列化指令が有効になります。これらの指令および並列化モデルは推奨されず、サポートされません。推奨され、サポートされる並列化モデルは OpenMP API です。Sun/Cray 指令から OpenMP への変換についての詳細は、-xopenmp オプションおよび『OpenMP API ユーザーズガイド』を参照してください。

コンパイラは、並列で実行すると、正確な結果が生成されないようなデータの依存が DO ループ中にある場合でも、並列コードを生成します。明示的な並列化を行う場合は、ループを正しく分析してデータ依存の問題がないことを確認してから、並列化の指令を使用してください。

並列化は、マルチプロセッサシステムのみに適用されます。

このオプションを使用すると、Sun、Cray、またはこの両方の明示的な並列化指令が有効になります。並列化指令の直前にある DO ループには、スレッド化されたコードが生成されます。

OpenMP 明示的並列化指令を有効にするには、-explicitpar を使用しないでください。この代わりに -openmp を使用してください (「3.4.155 -xopenmp[={ parallel|noopt|none}]」を参照)。

-explicitpar は、すでに libthread ライブラリへの呼び出しによって、独自にマルチスレッド処理を行なったプログラムをコンパイルする場合には使用できません。

並列化されたプログラムをマルチスレッド環境で実行するには、実行前に PARALLEL (または OMP_NUM_THREADS) 環境変数を設定しておく必要があります。これは、プログラムが作成できる最大スレッド数を実行時システムに指示しています。デフォルトは 1 です。 一般的に、PARALLEL 変数または OMP_NUM_THREADS 変数には、ターゲットプラットフォーム上の利用可能な仮想プロセッサ数を設定します。psrinfo(1) を参照してください。

-explicitpar を使用してコンパイルとリンクを一度に行う場合、マルチスレッド処理ライブラリとスレッド対応の Fortran 実行時ライブラリが自動的にリンクされます。-explicitpar を使用してコンパイルとリンクを分けて行う場合は、リンクにも -explicitpar を指定する必要があります。

-explicitpar などの並列化オプションを使用する場合にパフォーマンスを改善するには、-stackvar オプションも指定してください。

有効な並列化指令の形式は -mp オプション (「3.4.59 -mp={%none|sun|cray}」を参照) を使用して選択します。-explicitpar のデフォルトは Sun 指令です。Cray 指令を有効にするには、-explicitpar -mp=cray を使用してください。

最適化レベルが -O3 以上に設定されていない場合は、自動的に -O3 に設定されます。

詳細は、『Fortran プログラミングガイド』の「並列化」の章を参照してください。

3.4.24 -ext_names= e

外部名に下線を付けるかどうかを指定します。

e には plain または underscores のいずれかを指定します。デフォルトは underscores です。

-ext_names=plain: 下線を付けません。

-ext_names=underscores: 下線を付けます。

外部名とは、サブルーチン、関数、ブロックデータ副プログラム、名前付き共通ブロックの名前のことです。このオプションは、ルーチンの入口の名前と、その呼び出しに使用する名前の両方に影響を与えます。このフラグを使用すると、Fortran 95 のルーチンから別のプログラム言語のルーチンを呼び出したり、呼び出しを受けたりすることができます。

3.4.25 -F

ソースファイルプリプロセッサを起動します。 ただしコンパイルは行いません。

コマンド行に表示された .F、.F90、.F95、および .F03 ソースファイルに fpp プリプロセッサを適用し、同じファイル名で拡張子を .f (または .f95、.f03) に変えたファイルに結果を書き込みます。ただし、コンパイルは行いません。

例:

f95 -F source.F

このコマンドを実行すると、ソースファイルが source.f に書き込まれます。

fpp は Fortran のデフォルトのプリプロセッサです。C のプリプロセッサ (cpp) は、-xpp=cpp を指定すると選択されます。

3.4.26 -f

COMMON ブロックの倍精度および 4 倍精度のデータを境界整列します。

-f は従来のオプションフラグで、-aligncommon=16 と同義です。-aligncommon を使用してください。

COMMON ブロック内のデータのデフォルト整列は、4 バイトの境界整列です。-f を使用すると、COMMON ブロックと EQUIVALENCE クラスの倍精度および 4 倍精度のデータが、メモリー内で「自然に」境界整列されます。これは、8 バイトの境界整列になります。なお、64 ビット SPARC 環境で -m64 を指定してコンパイルを行うと、4 倍精度のデータは 16 バイトに境界整列されます。

-f を使用すると、データの境界整列が標準に合わなくなることがあります。これが原因で、EQUIVALENCE や COMMON の変数に問題が生じることがあります。さらに、-f が必要な場合、移植性のないプログラムになります。

-f オプションを指定してプログラムのいずれかの部分をコンパイルする場合は、そのプログラムに含まれる副プログラムもすべて -f オプションを指定してコンパイルする必要があります。

このオプションを単独で使用すると、コンパイラで倍精度および 4 倍精度のデータに対して高速のマルチワードのフェッチ/ストア命令を生成することはできません。 -dalign オプションがこれを実行し、-f も呼び出します。-f よりも -dalign を使用することをお勧めします。「3.4.13 -dalign」を参照してください。これは、-dalign が -f と同様に -fast オプションの一部であるからです。

3.4.27 -f77[=list]

FORTRAN 77の互換性モードを選択します。

このオプションフラグによって、f77 コンパイラが使用可能な言語拡張機能を含むソースプログラムを含め、従来の FORTRAN 77 ソースプログラムの f95 (Fortran 95 コンパイラ) への移植が可能になります。

list は、次のキーワードから選択された、コンマで区切られたリストです。

すべてのキーワードは、no% を前に付けて無効にすることができます。

-f77=%all,no%backslash

-f77 が指定されない場合は、デフォルトとして -f77=%none が使用されます。リストなしの -f77 は、-f77=%all と同じ意味を持ちます。

例外トラップと -f77:

-f77 を指定すると、Fortran 95 のトラップモードが変更されず、-ftrap=common になります。Fortran 95 と FORTRAN 77 は、演算例外トラップの動作が異なります。FORTRAN 77 コンパイラは、演算例外が発生したあとでも実行を継続することができます。-f77 によるコンパイルでも、プログラムはプログラム終了時に ieee_retrospective を呼び出して、演算例外が発生した場合はそれらの例外をすべて報告します。コマンド行の -f77 オプションフラグのあとに -ftrap=%none を指定すると、元の FORTRAN 77 の動作を真似することができます。

f77 の互換性および FORTRAN 77 から Fortran 95 への移行の詳細は、「4.12 言語の混在」を参照してください。

間違った結果を生じさせる可能性がある標準外のプログラミングの問題を処理する方法については、-xalias フラグも参照してください。

3.4.28 -fast

実行パフォーマンスを最適化するオプションを選択します。

このオプションは、リリースごと、またはコンパイラごとに変更されることのあるほかのオプションを選択する機能として定義されています。また、-fast で選択される一部のオプションは、すべてのプラットフォームでは利用できません。-fast の展開を確認するには、-dryrun フラグを使用してコンパイルしてください。

-fast は、特定のベンチマークアプリケーションのパフォーマンスを引き上げます。しかし、対象アプリケーションに適していないオプションが選択される場合もあります。-fast は、アプリケーションを最高のパフォーマンスでコンパイルするための第一歩として使用してください。ただし、追加調整が必要な場合もあります。-fast を使用したコンパイル時にプログラムが誤動作する場合、-fast を構成する個々のオプションを細かく調べ、自分のプログラムに適したオプションの中から正しい動作を保つものだけを呼び出してください。

また、-fast でコンパイルされたプログラムは、使用するデータセットにより、高いパフォーマンスと正確な結果を実現できないことがあります。浮動小数点演算の特定プロパティーに依存するプログラムに対し、-fast を使用したコンパイルは避けてください。

-fast で選択されたオプションの一部は暗黙的にリンクするため、コンパイルとリンクを別々に行う場合は、リンク時も必ず -fast を指定してください。

-fast では、次のオプションを選択します。

• -xtarget=native ハードウェアターゲット。コンパイルを行うのとは異なるマシンでプログラムを実行する場合は、-fast のあとにコード生成オプションを付けます。例: f95 -fast -xtarget=ultraT2 ...

• -O5 最適化レベルオプション。

• -depend オプションは、データの依存関係と再構成についてループを解析します。

• システムが提供するインライン展開テンプレート用の -libmil オプション。例外処理を使用する C モジュールでは、-fast のあとに -nolibmil (-fast -nolibmil のように) を付けます。-libmil を使うと errno の設定や、matherr(3m) の呼び出しによって、例外を検出することができなくなります。

• 積極的に浮動小数点を最適化しようとする -fsimple=2 オプション。厳密に IEEE 754 標準に準拠する必要がある場合は -fsimple=2 は適していません。「3.4.39 -fsimple[ ={1|2|0}]」を参照してください。

• 共通ブロックの倍および 4 倍データ用に倍長ロードとストアを生成する -dalign オプション。このオプションを使用すると、標準外の形式で共通ブロックの Fortran データの境界整列が行われる可能性があります。

• -xlibmopt オプションは、最適化された数学ライブラリルーチンを選択します。

• -pad=local は、キャッシュの利用率を改善するために、適宜共通ブロック内の変数の間にパディングを挿入します。(SPARC)

• -xvector=lib は、DO ループ内のある特定の数学ライブラリ呼び出しを、同等のベクトル化されたライブラリルーチンの単一呼び出しに変換します。(SPARC)

• -fns は、標準外の SPARC 浮動小数点演算の例外ハンドリングおよび段階的アンダーフローを選択します。「3.4.33 -fns[ ={yes| no}]」を参照してください。

• —xvector および —xlibmopt で必要なため、-fround=nearest が選択されます。(Solaris)

• 共通の浮動小数点例外のトラッピング -ftrap=common は、Fortran 95 で有効です。

• -nofstore は、式の精度を強制的に結果の精度にする設定を取り消します。(x86)

• -xregs=frameptr は、コンパイラがフレームポインタレジスタを未割り当ての呼び出し先保存レジスタとして使用することを許可します。-fast のあとに -xregs=no%frameptr を指定すると、フレームポインタレジスタは通常の用途でのレジスタとして使用されません。(x86)

次に示すように、-fast オプションのあとに別のオプションを付けて、このリストに追加したり削除したりできます。

f95 -fast -fsimple=1 -xnolibmopt ...

この例では、-fast で選択された -fsimple=2 の指定を変更し、-xlibmopt を無効にしています。

-fast は -dalign、-fns、-fsimple=2 を呼び出すため、-fast でコンパイルされたプログラムは、標準外の浮動小数点演算、標準外のデータ整列、および標準外の式評価の配列を招くことがあります。これらの選択オプションは、ほとんどのプログラムに適していない可能性があります。

-fast フラグで選択する一連のオプションは、コンパイラのリリースによって変更されることがあります。-dryrun を指定してコンパイラを呼び出すと、-fast の展開値が表示されます。

<sparc>%f95 -dryrun -fast |& grep ###
          ###     コマンド行ファイルおよびオプション (展開済み):
          ### -dryrun -xO5 -xarch=sparcvis2 -xcache=64/32/4:1024/64/4
              -xchip=ultra3i -xdepend=yes -xpad=local -xvector=lib
              -dalign -fsimple=2 -fns=yes -ftrap=common -xlibmil
              -xlibmopt -fround=nearest

3.4.29 -fixed

固定書式の Fortran 95 ソース入力ファイルを指定します。

コマンド行に指定するソースファイルはすべて、ファイル名の拡張子に関係なく固定書式として解釈されます。通常、f95 は .f のファイルだけを固定書式として解釈し、.f95 ファイルを自由書式として解釈します。

3.4.30 -flags

-help と同義です。

3.4.31 -fma={none| fused}

(SPARC) 浮動小数点演算、融合演算、積和演算命令の自動生成を有効にします。-fma=none は、これらの命令の生成を無効にします。-fma=fused は、コンパイラが浮動小数点演算、融合演算、積和演算命令を使用して、コードのパフォーマンスを改善する機会を見つけようとすることを許可します。デフォルトは -fma=none です。

融合した積和演算命令を生成するには、コンパイラに対して -xarch=sparcfmaf および最適化レベルが -xO2 以上に設定されていることが最低限必要です。融合した積和演算命令が生成された場合は、これらの命令をサポートしていないプラットフォームでプログラムが実行されないように、コンパイラはバイナリプログラムにマークを付けます。

3.4.32 -fnonstd

浮動小数点算術ハードウェアの非標準の初期化を行います。

このオプションは、次のオプションフラグを組み合わせたマクロです。

-fns -ftrap=common

-fnonstd を指定することは、Fortran 主プログラムの先頭で次の 2 つの呼び出しを行うのとほぼ同じです。

i=ieee_handler("set", "common", SIGFPE_ABORT)
call nonstandard_arithmetic()

nonstandard_arithmetic() ルーチンは、旧式の abrupt_underflow() ルーチンの代わりです。

このオプションを有効にするには、主プログラム全体にこのオプションを付けてコンパイルする必要があります。

このオプションを使用すると、浮動小数点ハードウェアが初期化されて次の処理が実行されます。

• 浮動小数点例外で異常終了 (トラップ) します。

• 速度が改善する場合には、アンダーフローのフラッシュ時に、IEEE 規格の要求しているような非正規数ではなく、ゼロを生成します。

段階的アンダーフローおよび非正規数についての詳細は、-fns を参照してください。

-fnonstd オプションは、浮動小数点オーバーフロー、ゼロによる除算、無効な演算などの例外処理のためのハードウェアトラップを可能にします。これらのハードウェアトラップは SIGFPE シグナルに変換され、プログラムに SIGFPE ハンドラがなければメモリーダンプして終了します。

詳細は、ieee_handler(3m) と ieee_functions(3m) のマニュアルページ、『数値計算ガイド』、および『Fortran プログラミングガイド』を参照してください。

3.4.33 -fns[ ={yes| no}]

非標準の浮動小数点モードを選択します。

デフォルトは標準の浮動小数点モード (-fns=no) です。『Fortran プログラミングガイド』の「浮動小数点演算」の章を参照してください。

-fast などの -fns フラグが含まれるマクロフラグのあとに =yes または =no オプションを使用して、-fns フラグを切り替えることができます。値を指定しない場合 -fns は、-fns=yes と同じです。

このオプションフラグは、プログラムの実行開始時に、非標準の浮動小数点モードを有効にします。SPARC プラットフォームで非標準の浮動小数点モードを指定すると、「段階的アンダーフロー」が無効になります。 つまり、小さな結果は、非正規数にはならず、ゼロに切り捨てられます。また、非正規オペランドがゼロに置き換えられます。段階的アンダーフローと非正規数をハードウェアでサポートしていない SPARC システムで、このオプションを使用すると、プログラムによってはパフォーマンスが飛躍的に上がることがあります。

x が完全なアンダーフローの原因にならないとき、非正規数 x とは次の範囲にある数です。

非正規数に関する詳細は、『数値計算ガイド』を参照してください。また、このオプションおよび関連するオプションについては『Fortran プログラミングガイド』の「浮動小数点演算」の章を参照してください。演算によっては、「非正規数」を表すのに「指数が最小の非正規化数」という用語を使用している場合があります。

デフォルトでは、浮動小数点は標準の設定に初期化されます。

• IEEE 754 浮動小数点演算は、例外時に異常終了しません。

• アンダーフローは段階的です。

x86 プラットフォームの場合、このオプションは Pentium III および Pentium 4 プロセッサ (sse または sse2 命令セット) でのみ有効です。

x86 では、-fns は SSE flush-to-zero モードを選択します。利用可能な場合には、denormals-are-zero モードが選択されます。このフラグは、非正規数の結果をゼロに切り捨てます。また、利用可能な場合には、非正規数オペランドもゼロとして扱われます。このフラグは、SSE または SSE2 命令セットを利用しない従来の x87 浮動小数点演算には影響しません。

-fns オプションを有効にするには、主プログラム全体にこのオプションを付けてコンパイルします。

3.4.34 -fpover[ ={yes|no}]

書式付きの入力で浮動小数点オーバーフローを検出します。

-fpover=yes を指定すると、入出力ライブラリは書式付きの入力で実行時浮動小数点オーバーフローを検出し、エラー条件 (1031) を返します。デフォルトでは、このようなオーバーフローの検出は行いません (-fpover=no)。値を指定しない場合、-fpover は -fpover=yes と同等です。—ftrap とともに使用すると、完全な診断情報が表示されます。

3.4.35 -fpp

fpp を使用して、入力の前処理を強制的に行います。

ファイルの拡張子に関係なく、f95 コマンド行にリストされた全入力ソースファイルを fpp プリプロセッサに渡します。通常、fpp によって自動的に先行処理されるファイルは、拡張子が .F、.F90、または .F95 のファイルのみです。「3.4.162 -xpp={ fpp|cpp}」も参照してください。

3.4.36 -fprecision={single|double|extended}

(x86) 非標準の浮動小数点丸め精度モードを初期設定します。

x86 で、浮動小数点精度モードを single、 double、extended のいずれかに設定します。

single か double の場合、丸め精度モードは、プログラムの実行が始まるときに、それぞれ単精度、倍精度に設定されます。extended か、-fprecision が指定されなかった場合のデフォルトでは、丸め精度モードは拡張精度に初期設定されます。

このオプションは、x86 システム上でのみ、かつ、主プログラムをコンパイルするときに使用する場合にのみ有効です。

3.4.37 -free

自由書式のソース入力ファイルを指定します。

コマンド行で指定したソースファイルはすべて、ファイル名の拡張子を問わず、f95 自由書式と解釈されます。通常、f95 は .f のファイルだけを固定書式として解釈し、.f95 ファイルを自由書式として解釈します。

3.4.38 -fround={ nearest|tozero|negative| positive}

起動時に IEEE の丸めモードを有効にします。

デフォルトは -fround=nearest です。

このオプションを有効にするには、主プログラム全体にこのオプションを付けてコンパイルする必要があります。

このオプションは、IEEE 754 の丸めモードを次のように設定します。

• 定数式の評価時にコンパイラによって使用されます。

• 実行時のプログラム初期化中に設定されます。

値が tozero、negative、または positive の場合、プログラムの実行開始時に、オプションは丸め方向を round-to-zero、round-to-negative-infinity、または round-to-positive-infinity にそれぞれ設定します。-fround を指定しない場合は、デフォルトで -fround=nearest が使用され、丸め方向は round-to-nearest になります。このオプションの意味は ieee_flags 関数の場合と同じです。『Fortran プログラミングガイ ド』の「浮動小数点演算」の章を参照してください。

3.4.39 -fsimple[ ={1|2|0}]

浮動小数点最適化の設定を選択します。

オプティマイザが浮動小数点演算に関する前提を単純化できるようにします。『Fortran プログラミングガイド』の「浮動小数点演算」の章を参照してください。

一貫した結果を得るには、プログラム中のすべての副プログラムを同じ -fsimple オプションを付けてコンパイルする必要があります。

デフォルトは次のとおりです。

• -fsimple フラグが指定されていない場合、コンパイラは -fsimple=0 とみなします。

• 値なしで -fsimple が指定されている場合、コンパイラは -fsimple=1 を使用します。

別の浮動小数点単純化レベルは次のとおりです。

-fsimple=0

前提を単純化しません。IEEE 754 に厳密に準拠します。

-fsimple=1

若干の単純化を認めます。生成されるコードは IEEE 754 に厳密には準拠していませんが、大半のプログラムの数値結果は変わりありません。

-fsimple=1 を指定すると、オプティマイザは次のことを前提とします。

• IEEE 754 のデフォルトの丸め/トラップモードは、プロセス初期化後も変化しない。

• 浮動小数点例外を除いて、外に現れない結果 (中間結果) を生成する演算は削除してもよい。

• 演算対象として無限または非数を伴う演算において、非数を結果に反映させる必要はない。たとえば、x*0 は 0 で置き換えてよい。

• 演算がゼロの符号に応じて変化することはない。

-fsimple=1 を指定すると、オプティマイザは必ず丸めまたは例外に応じた、完全な最適化を行います。特に、浮動小数点演算を、実行時に一定に保たれる丸めモードにおいて異なる結果を生成する浮動小数点演算と置き換えることはできません。

-fsimple=2

—fsimple=1 に加えて、積極的な浮動小数点の最適化を許可します。このため、一部のプログラムは、数式の評価方法の変更が原因で、異なる数値結果を出すことがあります。特に、Fortran の標準規則は、部分式の明示的な括弧を重視して式の評価の配列を制御するため、-fsimple=2 によって違反が生じることがあります。その結果、Fortran の規則に依存するプログラムにおいて、数値の丸めに差異が生じる可能性があります。

たとえば、-fsimple=2 を使用すると、コンパイラは C-(A-B) を (C-A)+B として評価するため、最終的なコードがより良好に最適化されている場合、明示的な括弧について標準規則の違反が生じます。また、コンパイラは、x/y の反復演算を x*z で置き換えることがあります。 この場合、z=1/y が 1 回だけ計算されて一時的に保存されるため、コストのかかる割り算が除去されます。

浮動小数点演算の特定プロパティーに依存するプログラムは、-fsimple=2 でコンパイルしないでください。

ただし、-fsimple=2 を指定していても、-fsimple=2 を指定しなければ発生しない浮動小数点例外をプログラムに発生させるような最適化はできません。

-fast は -fsimple=2 を選択します。

3.4.40 -fstore

(x86) 浮動小数点式の精度を強制的に設定します。

代入文の場合、このオプションはあらゆる浮動小数点式を強制的に代入先の変数の精度にします。これはデフォルト値です。ただし、-fast オプションには、このオプションを無効にする -nofstore が含まれています。再びこのオプションを有効にするには、-fast のあとに -fstore を続けてください。

3.4.41 -ftrap= t

起動時に有効になる浮動小数点のトラップモードを設定します。

t には、次の 1 つまたは複数の項目をコンマで区切って指定します。

%all, %none, common, [no%]invalid, [no%]overflow, [no%]underflow, [no%]division, [no%]inexact.

-ftrap=common は、-ftrap=invalid,overflow,underflow,division のマクロです。

f95 のデフォルトは -ftrap=common です。これは、C および C++ コンパイラのデフォルト (-ftrap=none) と異なります。

起動時に IEEE 745 のトラップモードを有効にします。ただし、SIGFPE ハンドラは組み込まれません。トラップの設定と SIGFPE ハンドラの組み込みを同時に行うには、ieee_handler(3M) か fex_set_handling(3M) を使用します。複数の値を指定した場合、それらの値は左から右に処理されます。共通の例外とは、演算不可能、ゼロによる除算、およびオーバーフローと定義されています。

例: -ftrap=%all,no%inexact は、inexact を除くすべての例外に対して、トラップを設定するという意味です。

次の点を除いて、-ftrap=t の意味は ieee_flags() と同じです。

• %all は、全トラップモードをオンにし、予期している例外にも予期していない例外にもトラップを発生させます。この代わりに common を使用してください。

• %none は、すべてのトラップモードをオフにします。

• 先頭に付いている no% はそのトラップモードをオフにします。

このオプションを有効にするには、主プログラム全体にこのオプションを付けてコンパイルする必要があります。

詳細は、『Fortran プログラミングガイド』の「浮動小数点演算」の章を参照してください。

3.4.42 -G

実行可能ファイルの代わりに、動的共有ライブラリを構築します。

このオプションは、動的共有ライブラリを構築するようリンカーに指示します。-G を指定しないと、リンカーは実行可能ファイルを構築します。-G を指定すると、動的ライブラリを構築します。出力ファイル名を指定するには、-G オプションとともに -o オプションを使用します。詳細は、『 Fortran プログラミングガイド 』の「ライブラリ」の章を参照してください。

3.4.43 -g

デバッグとパフォーマンス分析のためにコンパイルします。

dbx(1) デバッグユーティリティーによるデバッグ、およびパフォーマンスアナライザによるパフォーマンス分析のために、シンボルテーブル情報を生成します。

-g の指定がなくてもある程度のデバッグはできますが、dbx とデバッガ のすべての機能を使用するには、-g を付けてコンパイルする必要があります。

-g とともに指定した、ほかのオプションの機能の一部が制限される場合があります。詳細は、dbx のマニュアルを参照してください。

パフォーマンスアナライザの機能を最大限に利用するには、-g オプションを指定してコンパイルします。一部のパフォーマンス分析機能は -g を必要としませんが、注釈付きのソースコード、一部の関数レベルの情報、およびコンパイラの注釈メッセージを確認するには、-g でコンパイルする必要があります。詳細は、analyzer(1) マニュアルページおよびマニュアル『Sun Studio プログラムのパフォーマンス解析』を参照してください。

-g で生成される注釈メッセージは、プログラムのコンパイル時にコンパイラの実行した最適化と変換について説明します。これらのメッセージは、ソースコードに挿入されているため、er_src(1) コマンドで表示できます。

注釈メッセージは、コンパイラが実際に最適化を実行した場合に限り表示されます。-xO4、-fast などを使用して高度な最適化レベルを要求すると、注釈メッセージの表示される可能性が高くなります。

3.4.44 -hname

生成する動的共有ライブラリの名前を指定します。

このオプションはリンカーに渡されます。詳細は、Solaris の『リンカーとライブラリ』および『Fortran プログラミングガイド』の「ライブラリ」の章を参照してください。

-hname オプションにより、作成される共有動的ライブラリに、ライブラリの内部名として name という名前が記録されます。-h と name の間には空白文字があってもなくてもかまいません (ライブラリ名が elp の場合を除く。この場合、空白が必要となる)。通常、name には -o のあとに指定する名前と同じものを指定してください。-G を指定せずにこのオプションを使用しても意味がありません。

-hname オプションを省略すると、ライブラリファイルに内部名は記録されません。

ライブラリに内部名がある場合、このライブラリを引用する実行可能プログラムを実行するときは、実行時リンカーはあらゆるパスを検索して、同じ内部名を持つライブラリを探します。内部名を指定しておくと、実行時リンクの際に行うライブラリの検索が、より柔軟になります。このオプションは、共有ライブラリのバージョンを指定する場合にも使用できます。

共有ライブラリの内部名がない場合、リンカーは代わりに共有ライブラリファイルの特定のパスを使用します。

3.4.45 -help

コンパイルオプションの一覧を表示します。

「3.4.131 -xhelp={ readme|flags}」を参照してください。

3.4.46 -Ipath

INCLUDE ファイルの検索パスに path を追加します。

INCLUDE ファイルの検索パスの先頭に、ディレクトリパス path を挿入します。 -I と path の間には、空白文字を入れないでください。無効なディレクトリを指定した場合には、警告メッセージが表示されずに無視されます。

「インクルードファイルの検索パス」とは、INCLUDE ファイルを探すために使用するディレクトリのリストです。インクルードファイルとは、プリプロセッサ指令 #include、または Fortran の INCLUDE 文に指定するファイルです。

例: /usr/app/include で INCLUDE ファイルを検索するには、次のようにします。

demo% f95 -I/usr/app/include growth.F

コマンド行で複数回 -IIpath オプションを指定することができます。各オプションを指定するごとに、検索パスリストの先頭に最初に検索するパスとして追加されます。

INCLUDE 文または #include 指令の相対パス名は次の順序で検索されます。

1. ソースファイルがあるディレクトリ

2. -I オプションで指定したディレクトリ

3. コンパイラのデフォルトの内部リストにあるディレクトリ

4. /usr/include/

プリプロセッサを呼び出すには、.F、.F90、.F95、または .F03 の拡張子付きのソースファイルをコンパイルする必要があります。

3.4.47 -i8

i8 オプションはありません。

このコンパイラで 8 バイト INTEGER を指定するには、—xtypemap=integer:64 を使用します。

3.4.48 -inline=[ %auto][[,][no%] f1,…[no%]fn]

指定のルーチンのインライン化を有効または無効にします。

関数およびサブルーチン名のコンマ区切りのリストに指定されたユーザー作成のルーチンをインライン化するようオプティマイザに要求します。ルーチン名に no% という接頭辞を付けると、そのルーチンのインライン化が無効になります。

インライン化とは最適化の手法の 1 つで、CALL や関数呼び出しなどの副プログラムの引用を、実際の副プログラムコードに効果的に置き換えます。インライン機能を有効にすると、オプティマイザが効率的なコードを生成できる機会が増えます。

%auto を指定すると、最適化レベル -O4 または -O5 での自動インライン化が有効になります。-inline で明示的なインライン化が指定されている場合、通常、これらの最適化レベルでの自動インライン化は無効になります。

例: ルーチン xbar、zbar、vpoint をインライン化します。

demo% f95 -O3 -inline=xbar,zbar,vpoint *.f

このオプションを使用するための条件は次のとおりです。 ただし、条件が満たされていなくても、警告メッセージは出力されません。

• 最適化レベルが -O3 以上に設定されている。

• ルーチンのソースがコンパイルされているファイル中にある。ただし、-xipo または -xcrossfile が指定されている場合を除く。

• コンパイラは、実際にインライン化した結果が安全で効果があるかどうかを判断する。

-inline を -O4 とともに指定すると、コンパイラが通常実行する自動インライン化機能が使用できなくなります (%auto も指定した場合は除く)。なお、-O4 を指定すると、コンパイラは通常、ユーザー作成の適切なサブルーチンや関数をすべてインライン化しようとします。-O4 に -inline を追加すると、オプティマイザはリスト中にあるルーチンに限ってインライン化を行うため、実際にはパフォーマンスが低下します。この場合、%auto サブオプションを使用して、-O4 および -O5 で自動インライン化を有効にします。

demo% f95 -O4 -inline=%auto,no%zpoint *.f

前述の例では、-O4 の自動インライン化を有効にしながら、コンパイラが試みる zpoint() ルーチンのインライン化を無効にしています。

3.4.49 -iorounding[ ={compatible|processor-defined}]

書式付き入出力の浮動小数点の丸めモードを設定します。

すべての書式付き入出力操作の ROUND= 指示子を広域的に設定します。

-iorounding=compatible と指定する場合は、データ変換によって得られる値は、2 つのもっとも近い表示値のうち、より近い方の表示値になります。値が表示値のちょうど中間である場合は、0 から離れている方の表示値になります。

-iorounding=processor-defined を指定する場合は、丸めモードは、プロセッサのデフォルトのモードです。-iorounding が指定されない場合は、これがデフォルトになります。

3.4.50 -Kpic

(廃止) -pic と同義です。

3.4.51 -KPIC

(廃止) -PIC と同義です。

3.4.52 -Lpath

ライブラリ検索ディレクトリパスのリストに path を追加します。

オブジェクトライブラリの検索ディレクトリのリストの先頭にディレクトリ path を追加します。-L と path の間の空白文字はあってもなくてもかまいません。このオプションはリンカーに渡されます。「3.4.53 -lx」も参照してください。

ld(1) は、実行可能ファイルを生成しながら、path でアーカイブライブラリ (.a ファイル) と共有ライブラリ (.so ファイル) を探します。ld はまず path を検索してから、デフォルトのディレクトリを探します。ライブラリの検索順序に関する詳細は、『Fortran プログラミングガイド』の「ライブラリ」の章を参照してください。LD_LIBRARY_PATH および -Lpath の相対的な順序については、ld(1) を参照してください。

-L path を使用して /usr/lib または /usr/ccs/lib を指定すると、バンドルされていない libm はリンクされなくなります。これらのディレクトリはデフォルトで検索されます。

例: -Lpath を使用して、ライブラリを検索するディレクトリを指定します。

demo% f95 -L./dir1 -L./dir2 any.f

3.4.53 -lx

リンカー検索ライブラリのリストに、ライブラリ libx.a を追加します。

-lx をリンカーに渡して、ld が未解決の参照を検索するためのライブラリを追加指定します。ld は、オブジェクトライブラリ libx をリンクします。共有ライブラリ libx.so が使用できる場合 (-Bstatic または -dn が指定されていない場合)、ld はこれを使用します。そうでなければ、ld は静的ライブラリ libx.a を使用します。共有ライブラリを使用する場合は、名前は a.out に組み込まれます。-l と x の間には、空白文字を入れないでください。

例: ライブラリ libVZY をリンクします。

demo% f95 any.f -lVZY

複数のライブラリとリンクするには、-lx を再度使用してください。

例: ライブラリ liby と libz をリンクします。

demo% f95 any.f -ly -lz

ライブラリの検索パス、および検索順序については、『Fortran プログラミングガイド』の「ライブラリ」の章を参照してください。

3.4.54 -libmil

最適化として libm ライブラリルーチンをインライン化します。

一部の libm ライブラリルーチンには、インラインテンプレートがあります。このオプションを指定すると、これらのテンプレートが選択され、現在選択されている浮動小数点オプションとプラットフォームに対してもっとも高速な実行可能コードが生成されます。

詳細は、libm_single(3F) および libm_double(3F) のマニュアルページを参照してください。

3.4.55 -loopinfo

ループの並列化結果を表示します。

-autopar オプションで並列化されたループとそうでないループを示します。

-loopinfo により、標準エラーに次のメッセージリストが出力されます。

demo% f95 -c -fast -autopar -loopinfo shalow.f
...
"shalow.f", 172 行目: 並列化されます、逐次版が生成されました
"shalow.f", 173 行目: 並列化されません、利得なし
"shalow.f", 181 行目: 並列化されます、融合
"shalow.f", 182 行目: 並列化されません、利得なし
...
...etc

3.4.56 -Mpath

MODULE ディレクトリ、アーカイブ、またはファイルを指定します。

現在のコンパイルで参照されている Fortran 95 モジュールの検索で、指定されたパスが調べられます。現在のディレクトリのほかに、このパスが調べられます。

path には、ディレクトリ、.a アーカイブファイル (プリコンパイル済みモジュールファイルの場合)、または .mod プリコンパイル済みモジュールファイルを指定できます。コンパイラは、ファイルの内容を検査してファイルの種類を判定します。

.a アーカイブファイルは、 -M オプションフラグで、モジュールが検索されることが明示的に指定される必要があります。デフォルトでは、コンパイラはアーカイブファイルを検索しません。

USE 文にある MODULE 名と同じ名前の .mod ファイルのみが検索されます。たとえば USE ME 文があると、コンパイラは me.mod モジュールファイルのみ検索します。

検索時には、モジュールファイルの書き込み先のディレクトリが優先されます。これは、-moddir コンパイラオプションか MODDIR 環境変数で制御します。どちらも指定されていない場合は、現在のディレクトリがデフォルトの書き込み先ディレクトリになります。両方とも指定されている場合、-moddir フラグで指定されているパスが書き込み先ディレクトリになります。

これは、-M フラグのみが指定されている場合は、-M フラグに指定されているすべてのオブジェクトの前に現在のディレクトリでモジュール検索が行われることを意味します。以前のリリースの動作をエミュレートするには、次を使用します。

-moddir=empty-dir -Mdir -M

ここで empty-dir は空のディレクトリへのパスです。

-M とパスの間に空白文字を入れてもかまいません。たとえば、-M /home/siri/PK15/Modules のようにします。

Solaris で、アーカイブやモジュールファイル以外の通常ファイルをパスに指定した場合は、コンパイラは ld オプションをリンカーに渡し、リンカーマップファイルとしてファイルを処理します。これは C および C++ コンパイラと同様の便利な機能です。

Fortran 95 モジュールについての詳細は、「4.9 モジュールファイル」を参照してください。

3.4.57 -m32 | -m64

コンパイルされたバイナリオブジェクトのメモリーモデルを指定します。

32 ビット実行可能ファイルおよび共有ライブラリを作成するには、-m32 を使用します。64 ビット実行可能ファイルおよび共有ライブラリを作成するには、-m64 を使用します。

ILP32 メモリーモデル (32 ビット int、long、ポインタデータ型) は、64 ビットに対応していないすべての Solaris プラットフォームおよび Linux プラットフォームのデフォルト値です。LP64 メモリーモデル (64 ビット long、ポインタデータ型) は、64 ビット対応の Linux プラットフォームのデフォルト値です。-m64 は、LP64 モデルが使用可能なプラットフォームでのみ許可されます。

-m32 でコンパイルされたオブジェクトファイルまたはライブラリは、-m64 でコンパイルされたオブジェクトファイルまたはライブラリとリンクできません。

-m64 を使用して大容量の静的データを持つアプリケーションをコンパイルする場合は、-xmodel=medium も必要な場合があります。

一部の Linux プラットフォームは、ミディアムモデルをサポートしていません。

旧バージョンのコンパイラでは、-xarch で命令セットを選択することで、メモリーモデルの ILP32 または LP64 が暗黙に指定されていました。Sun Studio 12 コンパイラでは、このようなことはありません。ほとんどのプラットフォームでは、64 ビットオブジェクトを作成するのに、コマンド行に -m64 を追加するだけです。

Solaris では、-m32 がデフォルト値です。64 ビットプログラムをサポートしている Linux システムでは、-m64 -xarch=sse2 がデフォルト値です。

3.4.58 -moddir= path

コンパイルされた .mod MODULE ファイルの書き込み先を指定します。

コンパイラは、コンパイルした .mod MODULE 情報ファイルを path で指定されたディレクトリに書き込みます。ディレクトリパスは、MODDIR 環境変数で指定することもできます。両方が指定されている場合は、このオプションフラグが優先されます。

デフォルトでは、コンパイラは .mod ファイルの書き込み先として現在のディレクトリを使用します。

Fortran 95 モジュールの詳細は、「4.9 モジュールファイル」を参照してください。

3.4.59 -mp={%none|sun|cray}

Sun または Cray の並列化指令を選択します。

Sun および Cray の並列化指令は非推奨になりました。代わりに、OpenMP 並列化 API を使用します。アプリケーションを OpenMP に移行する方法については、『OpenMP API ユーザーズガイド』を参照してください。

-explicitpar を指定した場合のデフォルトは -mp=%none になります。

-explicitpar を指定した場合のデフォルトは -mp=sun になります。

並列化を有効にするには、-explicitpar (または -parallel) を指定する必要があります。正確さを期すには、-stackvar も指定します。

-explicitpar -stackvar -mp=cray

OpenMP の並列化用にコンパイルするには、-xopenmp フラグを使用します。「3.4.155 -xopenmp[={ parallel|noopt|none}]」を参照してください。

しかし、Sun 指令と Cray 指令は、同じコンパイル単位内で同時に使用することはできません。

Sun および Cray 並列化指令の概要は、表 C–1 を参照してください。詳細は、『Fortran プログラミングガイド』を参照してください。

3.4.60 -mt

スレッド環境で使用しても安全なライブラリへのリンクを要求します。

ユーザーが独自に低レベルのスレッド管理を行う場合 (たとえば、libthread ライブラリを呼び出す場合) は、-mt を使用してコンパイルすると、衝突を防ぐことができます。

libthread ライブラリを呼び出すマルチスレッド C コードと Fortran を併用する場合は、-mt を使用します。Solaris の『マルチスレッドのプログラミング』も参照してください。

-autopar、-explicitpar、または -parallel のオプションを使用すると、自動的に -mt の機能が有効になります。

次の点に注意してください。

• -mt を使用するときは、入出力を伴う関数の副プログラム自体を入出力文の一部として参照することはできません。このような入出力は、再帰入出力と呼ばれ、デッドロックの原因になることがあります。

• 一般的な注意として、ユーザー独自でマルチスレッド化したコードを -autopar、-explicitpar、または -parallel オプションを付けてコンパイルしないでください。コンパイラが生成するスレッドライブラリへの呼び出しとプログラム自体の呼び出しが衝突して、予測できない結果になることがあります。

• シングルプロセッサシステムの場合、-mt オプションを付けるとパフォーマンスが低下することがあります。

3.4.61 -native

(廃止) ホストシステムに対してパフォーマンスを最適化します。

このオプションは、-xtarget=native と同義です。-xtarget=native の使用を推奨します。-fast オプションでは -xtarget=native と設定します。

3.4.62 -noautopar

コマンド行で先に指定された -autopar で起動されている自動並列化を無効にします。

3.4.63 -nodepend

(SPARC) コマンド行で先に指定された -depend を取り消します。

3.4.64 -noexplicitpar

コマンド行で先に指定された -explicitpar で起動されている明示的な並列化を無効にします。

3.4.65 -nofstore

(x86) コマンド行の -fstore を取り消します。

コンパイラのデフォルトは -fstore です。-fast には、-nofstore が含まれています。

3.4.66 -nolib

システムライブラリとリンクしません。

システムライブラリや言語ライブラリと自動的にリンクを行いません。つまりデフォルトの -lx オプションを ld に渡さないということです。通常は、ユーザーがコマンド行で指定しなくても、システムライブラリは実行可能ファイルに自動的にリンクされます。

-nolib オプションを使用すると、必要なライブラリの中の 1 つを静的にリンクするといった作業が容易になります。最終的な実行には、システムおよび言語ライブラリが必要です。手動でライブラリとのリンクを行なってください。このオプションを使用すると、すべてを管理できます。

f95 では、libm を静的にリンクし、libc を動的にリンクします。

demo% f95 -nolib any.f95 -Bstatic -lm -Bdynamic -lc

-lx オプションの指定の順番には意味があります。例に示す順序で指定してください。

3.4.67 -nolibmil

コマンド行の -libmil を取り消します。

このオプションは、次の例のように、-fast オプションのあとに使用して、libm 数学ルーチンのインライン化を無効にします。

demo% f95 -fast -nolibmil …

3.4.68 -noreduction

コマンド行の -reduction を無効にします。

このオプションにより、-reduction オプションが無効になります。

3.4.69 -norunpath

実行可能ファイル中に、実行時共有ライブラリのパスを設定しません。

コンパイラは通常、実行時リンカーが共有ライブラリを検索する位置を示すパスを実行可能ファイル中に設定します。このパスはインストールの形式によって異なります。-norunpath オプションは、実行可能ファイルにパスが組み込まれないようにします。

ライブラリを標準でない場所にインストールし、別のサイトで実行可能ファイルを実行したときに、ローダーがそのパスを検索しないようにする場合に、このオプションを使用します。-Rpaths と比較してみてください。

詳細は、『 Fortran プログラミングガイド 』の「ライブラリ」の章を参照してください。

3.4.70 -O[n]

最適化レベルを指定します。

n には 1、2、3、4、5 のいずれかを指定します。-O と n の間には空白文字を入れないでください。

-O[n] の指定がない場合は、基本的な最適化のレベルは、局所的な共通部分式の除去、および不要コードの分析だけに限られます。プログラムのパフォーマンスは、最適化なしの場合よりも、特定の最適化レベルを指定してコンパイルした方が、大幅に改善されることがあります。通常のプログラムには、-O (レベル -O3) または -fast (レベル -O5) を使用することをお勧めします。

-On の各レベルには、それよりも低いレベルでの最適化が含まれています。一般に、プログラムのコンパイル時の最適化レベルが高いと、実行時のパフォーマンスも向上します。ただし、最適化レベルを高くすると、コンパイル時間が長くなり、実行可能ファイルのサイズが大きくなります。

-g を使用するデバッグは -On を抑制しませんが、 -On は -g のいくつかの機能を制限します。dbx に関するマニュアルを参照してください。

-O3 と -O4 のオプションでは、dbx から変数を表示できないという点で、デバッグ機能が制限されますが、dbx where コマンドを使用してシンボルを追跡することができます。

オプティマイザがメモリーを使い切ると、レベルを下げて最適化をやり直します。以降のルーチンでは元のレベルに戻ってコンパイルを行います。

最適化についての詳細は、『Fortran プログラミングガイド』の「パフォーマンスプロファイリング」と「パフォーマンスと最適化」の章を参照してください。

3.4.71 -O

-O3 と同義です。

3.4.72 -O1

文レベルの最小限の最適化を行います。

高いレベルの最適化では、コンパイル時間が長すぎる場合、またはスワップ領域が不足する場合に、-O1 を使用します。

3.4.73 -O2

基本ブロックレベルの最適化を行います。

通常、生成されるコードのサイズがもっとも小さくなります (-xspace も参照)。

-O3 を使用すると、コンパイル時間が長すぎる場合、スワップ領域が不足する場合、または生成される実行可能ファイルのサイズが大きすぎる場合には -O2 を使用します。これ以外の場合は、-O3 を使用してください。

3.4.74 -O3

関数レベルで、ループを展開し大域的に最適化を行います。 -depend を自動的に追加します。

通常、-O2、-O1 を使用した場合よりも生成される実行可能ファイルのサイズが大きくなります。

3.4.75 -O4

同一ファイル内にあるルーチンを自動的にインライン化します。

インライン化が行われるため、-O4 では、生成される実行可能ファイルのサイズが通常大きくなります。

-g オプションを指定すると、前に説明した -O4 による自動的なインライン化は行われません。-xcrossfile を使用すると、-O4 によるインライン化の範囲が拡張されます。

3.4.76 -O5

最高レベルの最適化を行います。

プログラム中で、全体の計算時間のうちの最大部分を消費する部分に限って適用してください。-O5 の最適化アルゴリズムは、ソースプログラム中でこのレベルを適用する部分が大きすぎると、コンパイルに時間がかかり、パフォーマンスが低下します。

プロファイルのフィードバックと併せて使用すると、最適化がパフォーマンスの向上につながる可能性が高まります。-xprofile=p を参照してください。

3.4.77 -o name

書き込み先の実行可能ファイルの名前を指定します。

-o と name の間には空白文字を 1 つ入れてください。 このオプションを省略すると、デフォルトとして実行可能ファイルが a.out に書き込まれます。また -c とともに使用すると、-o はターゲットの .o オブジェクトファイルの名前を指定します。また -G とともに使用すると、ターゲットの .so ライブラリファイルの名前を指定します。

3.4.78 -onetrip

DO ループを 1 回だけ実行します。

DO ループが少なくとも 1 回は実行されるようにコンパイルします。標準 Fortran の DO ループは、一部の古典的な Fortran の実装とは異なり、上限が下限より小さい場合には、1 回も実行されません。

3.4.79 -openmp

-xopenmp と同義です。

3.4.80 -p

(廃止) prof プロファイラを使用するプロファイル用にコンパイルします。

プロファイル用のオブジェクトファイルを作成します。prof(1) を参照してください。コンパイルとリンクを分けて行う場合、-p オプションを付けてコンパイルしたときはリンクでも必ず -p オプションを付けてください。-p と prof は主に旧式のシステムとの互換性を保つため使用します。gprof を使用した -pg プロファイリングの方をお勧めします。詳細は、『Fortran プログラミングガイド』のパフォーマンスプロファイルに関する説明を参照してください。

3.4.81 -pad[=p]

キャッシュを効率よく利用するためにパディングを挿入します。

配列や文字変数が、静的な局所変数で初期化されていない場合、または共通ブロックにある場合、間にパディングを挿入します。パディングは、キャッシュを効率的に利用できる位置にデータが配置されるように挿入されます。いずれの場合も、配列または文字変数を等値化することはできません。

p を指定する場合は、%none か、local または common のいずれかまたは両方を指定する必要があります。

local と common の両方を指定する場合、順序はどちらが先でもかまいません。

-pad のデフォルトは、次のとおりです。

• デフォルトではコンパイラはパディングを挿入しません。

• 値なしの -pad は -pad=local,common と指定するのと同じです。

-pad[=p] オプションは、次の条件を満たす項目に適用されます。

• 配列または文字変数になっている項目

• 静的で局所的または共通ブロックにある項目

局所変数または静的変数については、「3.4.96 -stackvar」を参照してください。

プログラムは次の制限事項に従っている必要があります。

• 配列と文字列のどちらに対しても EQUIVALENCE 文を適用 (等値化) できません。

• ある共通ブロックを引用するファイルのコンパイルで -pad=common を指定するときは、その共通ブロックを引用するすべてのファイルのコンパイルで -pad=common を指定する必要があります。このオプションは、共通ブロック内の変数の配置を変更します。あるプログラム単位をこのオプション付きでコンパイルし、別のプログラム単位をこのオプションなしでコンパイルすると、共通ブロック内の同じ位置への引用が、別の位置を引用してしまう可能性が生じます。

• -pad=common を指定する場合、別のプログラム単位にある共通ブロックの変数宣言を、名前を除いて同じにする必要があります。共通ブロックの変数の間に挿入されるパディングの量は、このような変数の宣言内容に応じて異なります。別のプログラム単位にある変数のサイズやランクが異なる場合は、同じファイル内でも変数の位置が異なることがあります。

• -pad=common が指定されている場合、共通ブロック変数を伴う EQUIVALENCE を宣言すると、警告メッセージが表示されてエラーになります。ブロックはパディングされません。

• -pad=common が指定されている場合、共通ブロック内の配列のオーバーインデックスを避けてください。パディングされた共通ブロックで隣接データの位置を変更すると、予想外の形でオーバーインデックスが失敗します。

-pad が使用されたときに、共通ブロックのコンパイルの一貫性が維持されるようにする必要があります。異なるプログラムユニットの共通ブロックを -pad=common を付けてコンパイルしたとき、その一貫性が維持されない場合は、エラーになります。-Xlist を付けたコンパイルでは、同じ名前の共通ブロックの長さがプログラムユニットの間で異なる場合に、そのことが報告されます。

3.4.82 -parallel

(廃止、SPARC)-autopar、-explicitpar、-depend で並列化します。

このオプションには、従来の Sun および Cray の並列化指令を有効にする -explicitpar が含まれます。これらの指令は推奨されず、サポートされません。Sun Studio コンパイラで推奨され、サポートされる並列化モデルは OpenMP API です。従来の Sun/Cray 指令を OpenMP に移行する方法の詳細は、『Sun Studio OpenMP API ユーザーズガイド』を参照してください。

並列化するループの選択は、コンパイラによって自動的に、またユーザーの明示的な指令によって行われます。最適化レベルが -O3 よりも低い場合は、自動的に -O3 に設定されます。「3.4.23 -explicitpar」も参照してください。

パフォーマンスを改善するため、-autopar などの並列化オプションを使用する場合、-stackvar オプションも指定してください。

デフォルトでは、Sun 形式の並列化指令が有効です。Cray 形式の並列化指令を選択する場合は、-mp=cray を使用します (注: OpenMP 並列化の場合は、-parallel ではなく、-xopenmp を使用する)。

独自のスレッド管理を行なっている場合には、-parallel を使用しないでください。「3.4.60 -mt」を参照してください。

-parallel のような並列化オプションは、マルチプロセッサシステムで実行するための実行可能プログラムを生成することを前提としています。シングルプロセッサシステムで並列化を行うと、通常はパフォーマンスが低下します。

並列化されたプログラムをマルチスレッド環境で実行するには、実行前に PARALLEL (または OMP_NUM_THREADS) 環境変数を設定しておく必要があります。これは、プログラムが作成できる最大スレッド数を実行時システムに指示しています。デフォルトは 1 です。 一般的に、PARALLEL 変数または OMP_NUM_THREADS 変数には、ターゲットプラットフォーム上の利用可能な仮想プロセッサ数を設定します (psrinfo(1) を参照)。

-parallel を使用してコンパイルとリンクを一度に行う場合、マルチスレッド処理ライブラリとスレッド対応の Fortran 実行時ライブラリが自動的にリンクされます。-parallel を使用してコンパイルとリンクを分けて行う場合は、リンクにも-parallel を指定する必要があります。

詳細は、『Fortran プログラミングガイド』の「並列化」の章を参照してください。

3.4.83 -pg

gprof プロファイラを使用するプロファイル用にコンパイルします。

-p オプションを使用した場合と同様の形式でプロファイル用にコードをコンパイルします。ただし、詳細な統計情報を記録する実行時記録メカニズムも起動され、プログラムが正常に終了すると、gmon.out ファイルが生成されます。gprof を実行すると、実行プロファイルが生成されます。詳細は、gprof(1) のマニュアルページおよび『Fortran プログラミングガイド』を参照してください。

ライブラリオプションは、ソースファイルと .o ファイルのあとに指定してください (-pg ライブラリは静的)。

-pg を指定した場合、-xprofile でコンパイルする利点はありません。これら 2 つの機能は、他方で使用できるデータを生成せず、他方で生成されたデータを使用できません。

64 ビット Solaris プラットフォームで prof(1) または gprof(1)、32 ビット Solaris プラットフォームで gprof を使用して生成されたプロファイルには、おおよそのユーザー CPU 時間が含まれます。これらの時間は、メインの実行可能ファイルのルーチンと、実行可能ファイルをリンクするときにリンカー引数として指定した共有ライブラリのルーチンの PC サンプルデータ (pcsample(2) を参照) から導出されます。そのほかの共有ライブラリ (dlopen(3DL) を使用してプロセスの起動後に開かれたライブラリ) のプロファイルは作成されません。

32 ビット Solaris システムの場合、prof(1) を使用して生成されたプロファイルには、実行可能ファイルのルーチンだけが含まれます。32 ビット共有ライブラリのプロファイルは、-pg で実行可能ファイルをリンクし、gprof(1) を使用することで作成できます。

Solaris 10 ソフトウェアには、-p でコンパイルされたシステムライブラリが含まれません。その結果、Solaris 10 プラットフォームで収集されたプロファイルには、システムライブラリルーチンの呼び出し回数が含まれません。

コンパイラオプション -p、-pg、-xpg の実行時サポートは、スレッドに対して安全ではありません。そのため、マルチスレッドプログラムのコンパイルには使用しないでください。マルチスレッドを使用するプログラムをこれらのオプションを付けてコンパイルすると、実行時に、不正な結果やセグメント例外が発生する可能性があります。

コンパイルとリンクを分けて行う場合、-pg を付けてコンパイルしたときはリンクでも必ず -pg を付けてください。

3.4.84 -pic

共有ライブラリ用に位置独立コードをコンパイルします。

SPARC では、-pic は -xcode=pic13 と同等です。位置独立コードの詳細は、「3.4.122 -xcode=keyword」を参照してください。

x86 では、位置独立コードを生成します。このオプションは、共有ライブラリを構築するためにソースファイルをコンパイルするときに使用します。大域データへの各参照は、大域オフセットテーブルにおけるポインタの間接参照として生成されます。各関数呼び出しは、手続きリンケージテーブルを通して PC 相対アドレス指定モードで生成されます。

3.4.85 -PIC

32 ビットアドレスで位置独立コードをコンパイルします。

SPARC では、-PIC は -xcode=pic32 と同等です。位置独立コードの詳細は、「3.4.122 -xcode=keyword」を参照してください。

x86 では、—PIC は —pic と同等です。

3.4.86 -Qoption pr ls

サブオプションリスト ls をコンパイル段階 pr に渡します。

Qoption、pr、および ls の間には必ず空白文字を入れます。Q は大文字でも小文字でもかまいません。リスト には、コンパイル段階に適したサブオプションをコンマで区切って指定します。リストには空白文字を入れないでください。また、サブオプションの先頭にマイナス記号を付けることができます。

このオプションは主に、サポートスタッフによる内部デバッグ用に使われます。LD_OPTIONS 環境変数を使用してリンカーにオプションを渡します。『Fortran プログラミングガイド』のリンクとライブラリに関する章を参照してください。

3.4.87 -qp

-p と同義です。

3.4.88 -R ls

動的ライブラリの検索パスを実行可能ファイルに設定します。

このオプションを指定すると、ld(1) リンカーは動的ライブラリ検索パスのリストを実行可能ファイルに格納します。

ls には、ライブラリ検索パスのディレクトリをコロンで区切って指定します。-R と ls の間には空白文字があってもなくてもかまいません。

このオプションを複数指定した場合は、それぞれのディレクトリリストがコロンで区切られて連結されます。

このリストは実行時に実行時リンカー ld.so が使用します。実行時に、このリストにあるパスで動的なライブラリを検索し、未解決の参照を解決しようとします。

このオプションは、動的ライブラリへのパスを指定するオプションを意識せずに出荷用の実行可能ファイルを実行できるようにしたいときに使用します。

-Rpaths を使用して実行可能ファイルを構築すると、ディレクトリパスはデフォルトのパスに追加されます。デフォルトのパス /opt/SUNWspro/lib は、常に最後に検索されます。

詳細は、『Fortran プログラミングガイド』の「ライブラリ」の章および Solaris の『リンカーとライブラリ』を参照してください。

3.4.89 -r8const

単精度の定数を REAL*8 の定数に変換します。

単精度の REAL 定数はすべて REAL*8 に変換されます。倍精度 (REAL*8) 定数は変更されません。このオプションは、定数にだけ適用されます。定数と変数の両方を変換す る場合は、「3.4.179 -xtypemap= spec」を参照してください。

このオプションフラグを使用する際には注意が必要です。REAL*4 引数を期待するサブルーチンまたは関数が REAL*4 定数で呼び出される場合に、REAL*8 の指令を受け取ることになるため、インタフェースの問題が生じる可能性があります。また、入出力リストに REAL*4 定数がある書式なし write によって書き込まれた、書式なしデータファイルの読み取りプログラムで問題を生じる可能性もあります。

3.4.90 -reduction

ループ中にある縮約演算を識別します。

自動並列化中にループを解析し、縮約演算を調べます。ループの縮約には、潜在的に丸めのエラーがあります。

「縮約演算」によって、配列内の要素が単一のスカラー値に変換されます。縮約演算の典型的な例として、あるベクトルの各要素をまとめる処理があります。このような演算は並列化の対象ではありませんが、-reduction を指定すると、コンパイラは縮約演算を認識し、特別な例として並列化します。コンパイラが認識する縮約演算については、『Fortran プログラミングガイド』の「並列化」の章を参照してください。

このオプションは、自動並列化オプション -autopar または -parallel とともに使用する場合にのみ使用できます。それ以外の場合は無視されます。明示的に並列化されたループは縮約演算の解析の対象にはなりません。

例: -reduction オプションを付けた自動並列化処理

demo% f95 -parallel -reduction any.f

3.4.91 -S

コンパイルし、アセンブリのソースコードだけを生成します。

指定したプログラムをコンパイルし、アセンブリ言語の出力結果を、接尾辞 .s の付いた名前のファイルに出力します。.o ファイルは作成しません。

3.4.92 -s

実行可能ファイルからシンボルテーブルを取り除きます。

実行可能ファイルを縮小しますが、リバースエンジニアを困難にします。また、このオプションを使用すると、dbx その他のツールによるデバッグができなくなり、-g オプショは無視されます。

3.4.93 -sb

(廃止) ソースコードブラウザ用のテーブル情報を生成します。

-sb は、コンパイラが fpp または cpp プリプロセッサを経由して自動的に渡すソースファイル (すなわち、拡張子が .F、.F90、.F95、または .F03 のファイル) 上で使用することはできません。また、-F オプションとともに使用することもできません。

3.4.94 -sbfast

(廃止) ソースコードブラウザ用のテーブル情報のみを生成します。

ソースコードブラウザ用のテーブル情報のみを生成します。アセンブルやリンクは行わず、オブジェクトファイルも作成しません。

-sbfast は、コンパイラが fpp または cpp プリプロセッサを経由して自動的に渡すソースファイル (すなわち、拡張子が .F、.F90、.F95、または .F03 のファイル) 上で使用することはできません。また、-F オプションとともに使用することもできません。

3.4.95 -silent

(廃止) コンパイラメッセージの出力を抑制します。

通常、f95 コンパイラは、コンパイル中に、エラー診断以外のメッセージを発行しません。このオプションフラグは、従来の f77 コンパイラとの互換性を保つために準備されています。-f77 互換性フラグとともに使用しない場合は、このオプションフラグは必要ありません。

3.4.96 -stackvar

可能な場合はいつでも局所変数をメモリースタックに割り当てます。

このオプションは、再帰的で再入力可能なコードの記述を簡単にし、ループを並列化する際の最適化により自由度を与えることができます。

並列化オプションを使用する場合は、-stackvar を使用するようにしてください。

局所変数は、仮引数ではない変数、 COMMON 変数、外部スコープから継承された変数、または USE 文によってアクセス可能になったモジュール変数です。

-stackvar を有効にすると、局所変数は、属性 SAVE または STATIC を持たないかぎり、スタックに割り当てられます。明示的に初期化された変数は、SAVE 属性を使用して暗黙的に宣言されます。明示的に初期化されず、いくつかのコンポーネントが初期化されている構造変数は、デフォルトでは、SAVE を使用して暗黙的に宣言されません。また、SAVE または STATIC 属性を持つ変数と同等な変数は、暗黙的に SAVE または STATIC です。

静的に割り当てられた変数は、プログラムによって明示的に値を指定されないかぎり、暗黙的に 0 に初期化されます。スタックに割り当てられた変数は、構造変数のコンポーネントがデフォルトで初期化できる場合を除き、暗黙的に初期化されません。

-stackvar を使用してサイズが大きい配列をスタック上に割り当てると、スタックからオーバーフローし、セグメント例外が発生する場合があります。このような場合はスタックサイズを大きくする必要があります。

プログラムを実行する初期スレッドには、メインスタックがあり、マルチスレッド化されたプログラムの各ヘルパースレッドには、それぞれスレッドスタックがあります。

メインスタックのデフォルトのサイズは、約 8M バイトです。デフォルトのスレッドスタックサイズは、32 ビットシステムで 4M バイト、64 ビットシステムで 8M バイトです。引数なしで limit コマンドを実行すると、現在のメインスタックのサイズが表示されます。-stackvar を使用したときにセグメント例外が発生する場合は、メインスタックとスレッドスタックのサイズを大きくしてみてください。

例: 現在のメインスタックのサイズを表示します。

demo% limit
cputime         制限なし
filesize        制限なし
datasize        523256K バイト
stacksize       8192K バイト      <---
coredumpsize    制限なし
descriptors     64
memorysize      制限なし
demo%

例: メインスタックのサイズを 64M バイトに設定します。

demo% limit stacksize 65536

例: 各スレッドスタックのサイズを 8M バイトに設定します。

demo% setenv STACKSIZE 8192

各スレーブスレッドで使用されるスタックサイズは、 STACKSIZE 環境変数に値 (キロバイト単位) を指定することで設定できます。

% setenv STACKSIZE 8192

この例は、各スレーブスレッドのスタックサイズを 8M バイトに設定します。

STACKSIZE 環境変数は、接尾辞 B、K、M、または G の付いた数値も受け付けます。これらの接尾辞はそれぞれ、バイト、キロバイト、メガバイト、ギガバイトを表します。デフォルトはキロバイトです。

並列化と -stackvar を併用する方法の詳細は、『Fortran プログラミングガイド』の「並列化」の章を参照してください。limit コマンドについての詳細は、csh(1) を参照してください。

-xcheck=stkovf フラグを指定してコンパイルすると、スタックオーバーフロー状態に対する実行時の検査が有効になります。「3.4.120 -xcheck=keyword」を参照してください。

3.4.97 -stop_status[ ={yes|no}]

STOP 文により整数のステータス値を返します。

デフォルトは -stop_status=no です。

-stop_status=yes を付けると、STOP 文に整数の定数を入れることができます。その値は、プログラムの終了時に環境に渡されます。

STOP 123

STOP 文には、0 から 255 の範囲にある値を指定してください。これよりも大きい値は切り捨てられ、実行時メッセージが出力されます。ただし、

STOP ”stop string’

は受け付けられます。この場合は環境にステータス値 0 が返されます。ただし、コンパイラの警告メッセージは出力されます。

このステータス環境変数は、C シェル (csh) では $status、また Bourne (sh) シェルと Korn (ksh) シェルでは $? です。

3.4.98 -temp= dir

一時ファイルのディレクトリを設定します。

コンパイラによって使用される一時ファイル用のディレクトリを dir に設定します。このオプションでは空白文字を入れないでください。このオプションを指定しない場合、一時ファイルは /tmp ディレクトリに置かれます。

3.4.99 -time

各コンパイル段階の経過時間を表示します。

各コンパイル段階で費やされた時間とリソースが表示されます。

3.4.100 -U

ソースファイル中の大文字と小文字を区別します。

大文字を小文字と同等には取り扱いません。デフォルトでは、文字列定数中を除き、大文字をすべて小文字として解釈します。このオプションを指定すると、Delta、DELTA、および delta はすべて別の記号として解釈されます。組み込み関数の呼び出しは、このオプションによる影響を受けません。

Fortran を別の言語に移植したり、混用したりする場合は、-U オプションを指定する必要があることがあります。『 Fortran プログラミングガイド 』の Fortran95 への移植に関する章を参照してください。

3.4.101 -Uname

プリプロセッサのマクロ name の定義を取り消します。

このオプションは、fpp または cpp プリプロセッサを呼び出すソースファイルにのみ適用されます。このオプションは、同じコマンド行の -Dname で作成されたプリプロセッサのマクロ name の初期定義を削除します。この場合、オプションの順序に関係なく、コマンド行ドライバによって暗黙に配置された -Dname も対象となります。ソースファイルのマクロ定義には影響しません。コマンド行に複数の -Uname フラグを配置できます。-U とマクロ name の間に空白文字を入れることはできません。

3.4.102 -u

未宣言の変数に対してメッセージを出力します。

すべての変数に対するデフォルトの型を、Fortran の暗黙の型宣言を使用せずに「未宣言」にします。これは、各コンパイル単位で IMPLICIT NONE が指定されていることと同じです。宣言していない変数に対して警告メッセージが出力されます。ただし、このオプションは、IMPLICIT 文や明示的に type を指定する文より優先されることはありません。

3.4.103 -unroll= n

DO ループの展開が可能な個所で、使用可能にします。

n は正の整数です。次の選択が可能です。

• n が 1 の場合、ループの展開をすべて禁止します。

• n が 2 以上の場合、オプティマイザはループを n 回展開します。

一般に、ループを展開するとパフォーマンスが改善されますが、実行可能ファイルのサイズが大きくなります。ループの展開と各種のコンパイラの最適化については、『Fortran プログラミングガイド』の「パフォーマンスと最適化」の章を参照してください。「2.3.1.3 UNROLL 指令」も参照してください。

3.4.104 -use= list

暗黙的な USE モジュールを指定します。

list は、モジュール名またはモジュールファイル名のコンマ区切りのリストです。

-use=module_name を使用してコンパイルすると、USE module_name 文をコンパイルされる各副プログラムまたはモジュールに追加することになります。-use=module_file_name を使用してコンパイルすると、指定されたファイルに含まれる各モジュールの USE module_name を追加することになります。

Fortran 95 モジュールについての詳細は、「4.9 モジュールファイル」を参照してください。

3.4.105 -V

各コンパイラパスの名前とバージョンを表示します。

コンパイラの実行時に、各パスの名前とバージョンを表示します。

前述の情報は、問題が発生した場合にご購入先に問い合わせるときに役立ちます。

3.4.106 -v

各コンパイラパスの詳細情報を表示します。

-V と同様に、コンパイラの実行時にそれぞれのパス名を表示し、ドライバが使用したオプション、マクロフラグ展開、および環境変数を詳細に表示します。

3.4.107 -vax=keywords

VAX VMS Fortran 拡張機能を有効にすることを指定します。

keywords 指定子は、次のサブオプションのいずれか、またはこれらのサブオプションをいくつか組み合わせて、コンマで区切ったリストとして指定します。

サブオプションは個々に選択することもオフにすることもできます。個々にオフにするには、サブオプションの前に no% を付けます。

例:

-vax=debug,rsize,no%blank_zero

3.4.108 -vpara

並列化に関する 詳細な警告メッセージを表示します。

コンパイラが、並列化指令で明示的に指定されたループを分析するごとに、検出されるデータの依存関係に関する警告メッセージを出力します。ただし、ループの並列化は続けられます。

例: 詳細な並列化に関する警告

demo% f95 -explicitpar -vpara any.f
any.f:
 MAIN any:
"any.f", 11 行目: 警告: ループには参照を無効にする並列化が含まれている
可能性があります

-xopenmp と OpenMP API 指令、または -explicitpar と従来の C$MIC DOALL 並列化指令とともに使用します。

警告は、コンパイラが次の状態を検出したときに表示されます。

• OpenMP 並列領域でのアクセスによってデータの競合が起きる可能性がある共有変数の宣言、並列領域に値があって並列領域のあとで使用されるスレッド固有変数の宣言など、OpenMP のデータ共有属性節の問題のある使用

• 異なるループ繰り返し間でデータに依存関係がある C$MIC DOALL 並列化ループ

すべての並列化指令が問題なく処理される場合、警告は表示されません。

Sun Studio のコンパイラは OpenMP API の並列化モデルをサポートします。そのため、C$MIC 並列化指令は推奨されません。OpenMP API への移行については、『OpenMP API ユーザーズガイド』を参照してください。

3.4.109 -w[n]

警告メッセージを表示または抑制します。

ほとんどの警告メッセージを表示または出力しないようにします。ただし、前に指定したオプションのすべて、あるいは一部が無効になるようなオプションを指定している場合には、警告メッセージが表示されます。

n は、0、1、2、3、または 4 です。

-w0 は、エラーメッセージのみを表示します。これは -w と同義です。-w1 はエラー と警告を表示します。これは、-w を省略したときのデフォルトです。-w2 は、エラー、警告、および注意を表示します。-w3 は、エラー、警告、注意、および注を表示します。-w4 は、エラー、警告、注意、注、およびコメントを表示します。

例: -w オプションを使用しても警告メッセージが出力される場合

demo% f95 -w -parallel any.f
f95: 警告: 並列化コードをサポートするために、最適化レベルが 0 から 3 に
変更されました
demo%

3.4.110 -Xlist[ x]

リストを生成し、大域的なプログラム検査 (GPC) を実行します。

このオプションを使用すると、潜在的なプログラムのバグを発見できます。このオプションは、予備のコンパイラパスを呼び出し、大域プログラムを通して、副プログラムの引数、共通ブロック、およびパラメータの一貫性をチェックします。また、このオプションは、相互参照表などの行番号付きのソースコードリストも生成します。-Xlist オプションが発行するエラーメッセージは助言レベルの警告であり、プログラムのコンパイルやリンクを中断するものではありません。

ソースコードのすべての構文エラーを訂正してから、-Xlist でコンパイルを実行してください。構文エラーのあるソースコードでコンパイルを実行すると、予想外の結果が報告されることがあります。

例: ルーチン間の一貫性をチェックします。

 demo% f95 -Xlist  fil.f

前述の例により、出力ファイル fil.lst に次の項目が書き込まれます。

• 行番号付きのソースリスト (デフォルト)

• ルーチン間の矛盾についてのエラーメッセージ (リストに組み込まれている)

• 識別子の相互参照表 (デフォルト)

デフォルトにより、ファイル name.lst にリスト内容が書き込まれます。ここで、name はコマンド行に最初に配置されているソースファイルの名前です。

多数のサブオプションにより、さまざまな動作を柔軟に選択できます。これらのサブオプションは、-Xlist オプションの接尾辞によって指定されます。次の表を参照してください。

詳細は、『Fortran プログラミングガイド』の「プログラムの解析とデバッグ」の章を参照してください。

3.4.111 -xa

-a と同義です。

3.4.112 -xalias[= keywords]

コンパイラが仮定する別名付けの程度を指定します。

標準規格以外のプログラム手法によっては、コンパイラの最適化方法に干渉する状況になります。オーバーインデックスおよびポインタの使用、および大域変数または一意ではない変数を副プログラムの引数として渡すことは、不明確な状況を引き起こし、予定どおりにコードが実行されない場合があります。

-xalias フラグを使用すると、別名付けが Fortran の標準規則からどのくらい離れているかをコンパイラに知らせることができます。

フラグには、キーワードのリストがある場合も、ない場合もあります。キーワードのリストはコンマで区切られ、各キーワードはプログラムにおける別名付けの状況を表しています。

キーワードに接頭辞 no% が付いている場合は、その別名付けが存在しないことを表します。

別名付けのキーワードは、次のとおりです。

リストなしで -xalias を指定すると、Fortran の別名付け規則に違反しないほとんどのプログラムで最高のパフォーマンスを得ることができます。これは、次に対応します。

no%dummy,no%craypointer,no%actual,no%overindex,no%ftnpointer

有効にするには、-xalias は、最適化レベル -xO3 以上でコンパイルするときに使用する必要があります。

-xalias フラグが指定されていない場合は、コンパイラのデフォルトでは、次の Cray ポインタを除き、Fortran 95 の標準に準拠しているとみなされます。

no%dummy,craypointer,no%actual,no%overindex,no%ftnpointer

別名付けの状況の例、および -xalias を使用した指定方法については、『Fortran プログラミングガイド』の移植に関する章を参照してください。

3.4.113 -xarch=isa

命令セットアーキテクチャー (ISA) を指定します。

表 3–11 に、-xarch キーワード isa で受け付けられるアーキテクチャーを示します。

-xarch は単独で使用できますが、-xtarget オプションの展開の一部です。 特定の -xtarget オプションで設定されている -xarch の値を上書きするために使用することもできます。次に例を示します。

% f95 -xtarget=ultra2 -xarch=sparcfmaf ...

-xtarget=ultra2 で設定した -xarch が無効になります。

このオプションは、指定の命令セットだけを許すことによって、コンパイラが指定の命令セットアーキテクチャーの命令に対応するコードしか生成できないようにします。なお、ターゲット固有の命令が使用されるとは限りません。

このオプションを最適化で使用する場合は、適切なアーキテクチャーを選択すると、そのアーキテクチャー上での実行パフォーマンスを向上させることができます。不適切な選択を行うと、意図したターゲットプラットフォームでは実行できないバイナリプログラムが生成されます。

次の点に注意してください。

• 従来の 32 ビット SPARC 命令セットアーキテクチャーの V7 および V8 では、暗黙に —m32 を設定します。—m64 とともに使用することはできません。

• sparc および sparcvis を指定してコンパイルしたオブジェクトバイナリファイル (.o) は、 リンクし、まとめて実行できますが、実行は sparcvis 互換プラットフォーム上だけに限られます。

• sparc、sparcvis、および sparcvis2 を指定してコンパイルしたオブジェクトバイナリファイル (.o) は、リンクし、まとめて実行できますが、実行は sparcvis2 互換プラットフォーム上だけに限られます。

オプションの選択によっては、生成された実行可能プログラムのパフォーマンスが、初期のアーキテクチャーよりかなり劣ることがあります。また、4 倍精度 (REAL*16 および long double) の浮動小数点命令は、これらの命令セットアーキテクチャーの多くで使用できますが、コンパイラは、それらの命令を生成したコードでは、それらの命令を使用しません。

SPARC プラットフォームで -xarch が指定されなかった場合のデフォルトは、SPARC プラットフォームでは sparc、x86 プラットフォームでは 386 です。

表 3–12 に、SPARC プラットフォーム上で使用する各 -xarch キーワードについて詳細に説明します。

表 3–13 に、x86 プラットフォーム上で使用する各 -xarch キーワードについて詳細に説明します。x86 で -xarch が指定されなかった場合のデフォルトは、generic です。

3.4.113.1 x86/x64 プラットフォームでの特別な注意

x86 Solaris プラットフォームでコンパイルを行う場合は、次の点が重要です。

• -xarch を sse、sse2、sse2a、または sse3 に設定してコンパイルしたプログラムは、これらの機能および拡張機能をサポートするプラットフォームで実行する必要があります。

• Pentium 4 互換プラットフォームの場合、Solaris 9 4/04 以降のリリースは SSE/SSE2 に対応しています。これより前のバージョンの Solaris は SSE/SSE2 に対応していません。

• コンパイルとリンクを別々に行う場合は、必ずコンパイラを使ってリンクし、同じ -xarch 設定で正しい起動ルーチンがリンクされるようにしてください。

• x86 の 80 バイト浮動小数点レジスタが原因で、x86 での演算結果が SPARC の結果と異なる場合があります。こうした違いが出ないようにするために、-fstore オプションを使用してください。あるいは、ハードウェアが SSE2 をサポートしている場合は、-xarch=sse2 を付けてコンパイルしてください。

• Sun Studio 11 と Solaris 10 OS から、これらの特殊化された -xarch ハードウェアフラグを使用してコンパイルし、構築されたプログラムバイナリは、適切なプラットフォームで実行されることが確認されます。

• Solaris 10 以前のシステムでは確認が行われないため、これらのフラグを使用して構築したオブジェクトが適切なハードウェアに配備されることをユーザーが確認する必要があります。

• これらの -xarch オプションでコンパイルしたプログラムを、適切な機能または命令セット拡張に対応していないプラットフォームで実行すると、セグメント例外や明示的な警告メッセージなしの不正な結果が発生することがあります。

• このことは、.il インラインアセンブリ言語関数を使用しているプログラムや、SSE、SSE2、SSE2a、SSE3 の命令、および拡張機能を利用している __asm() アセンブラコードにも当てはまります。

3.4.114 -xassume_control[ =keywords]

ASSUME プラグマを制御するパラメータを設定します。

このフラグを使用して、コンパイラがソースコード内の ASSUME プラグマを処理する方法を制御します。

プログラマは ASSUME プラグマを使用することによって、コンパイラがより良い最適化を得るために使用できる特殊な情報を表明することができます。これらの表明は、確率を指定することができます。確率が 0 または 1 の場合は確実 (certain) とされ、それ以外の場合は不確実 (non-certain) とみなされます。

また、可能性または確実性を指定して、次に DO ループのトリップカウント、または分岐が起こることを表明することもできます。

f95 コンパイラが認識する ASSUME プラグマの説明については、「2.3.1.9 ASSUME 指令」を参照してください。

-xassume_control オプションの keywords には、1 つのサブオプションキーワードまたはコンマで区切られたキーワードのリストを指定できます。認識されるキーワードサブオプションは、次のとおりです。

コンパイラのデフォルトは次のとおりです。

-xassume_control=optimize

これは、コンパイラが ASSUME プラグマを認識し、最適化に影響を与えますが、検査は行わないという意味です。

パラメータを指定しない場合、-xassume_control は次と同義です。

-xassume_control=check,fatal

この場合、コンパイラは certain とマークされたすべての ASSUME プラグマを受け付け、検査しますが、最適化には影響を与えません。表明が無効の場合、プログラムは終了します。

3.4.115 -xautopar

-autopar と同義です。

3.4.116 -xbinopt={ prepare | off}

(SPARC) コンパイル後の最適化用にバイナリを準備します。

コンパイル済みのバイナリファイルは、あとで binopt(1) を使用して、最適化、変換、分析できます。このオプションは、実行可能ファイルまたは共有オブジェクトを構築するときに使用できます。また、有効にするには、最適化レベルを -O1 以上にする必要があります。

このオプションを使用して構築すると、バイナリファイルのサイズが約 5% 増加します。

コンパイルとリンクを個別に実行する場合、コンパイルとリンクの両方で -xbinopt を指定する必要があります。

アプリケーションのすべてのソースコードを -xbinopt でコンパイルしなかった場合でも、次のように、プログラムバイナリを構築する最後のリンク手順で -xbinopt フラグを使用します。

example% f95 -0 program -xbinopt=prepare a.o b.o c.f95

-xbinopt を使用してコンパイルしたコードだけが、binopt(1) で最適化できます。

デフォルトは -xbinopt=off です。

3.4.117 -xcache= c

オプティマイザ用のキャッシュ特性を定義します。

c には次のいずれかを指定します。

• generic

• native

• s1/l1/a1[/t1]

• s1/l1/a1[/t1]:s2/l2/a2[/t2]

• s1/l1/a1[/t1]:s2/l2/a2[/t2]:s3/l3/a3[/t3]

si/li/ai/ti の定義は次のとおりです。

si レベル i のデータキャッシュのサイズ (キロバイト単位) li レベル i のデータキャッシュの行サイズ (バイト単位) ai レベル i のデータキャッシュの結合性 ti レベル i でキャッシュを共有するハードウェアスレッドの数 (省略可能)

このオプションは、オプティマイザが使用できるキャッシュ特性を指定します。特別なキャッシュ特性が必ず使用されるわけではありません。

このオプションは、-xtarget オプションを展開した機能の一部です。-xtarget オプションで暗黙に指定された -xcache 値の指定を変更する場合に、このオプションを単独で使用します。

例: -xcache=16/32/4:1024/32/1 では、次の内容を指定します。

レベル 1 のキャッシュ: 16K バイト、32 バイト行サイズ、4 面結合

レベル 2 のキャッシュ: 1024K バイト、32 バイト行サイズ、ダイレクトマップ結合

3.4.118 -xcg89

(SPARC/廃止) -cg89 と同義です。

3.4.119 -xcg92

(SPARC/廃止) -cg92 と同義です。

3.4.120 -xcheck=keyword

実行時の特別な検査を生成します。

キーワードには次のいずれかを指定します。

スタックオーバーフローは、特に、スタックに大きな配列が割り当てられるマルチスレッドアプリケーションで、近傍のスレッドスタックのデータを警告なしに破壊する可能性があります。スタックオーバーフローの可能性がある場合は、-xcheck=stkovf を使用してすべてのルーチンをコンパイルします。ただし、このフラグを使用してコンパイルしても、このフラグを使用せずにコンパイルしたルーチンでスタックオーバーフローが起こる可能性があるので、すべてのスタックオーバーフローの状況が検出されるわけではありません。

3.4.121 -xchip=c

オプティマイザ用のターゲットプロセッサを指定します。

このオプションは、処理対象となるプロセッサを指定することによって、タイミング特性を指定します。

このオプションは単独で使用できますが、-xtarget オプションを展開した機能の一部です。-xtarget オプションで暗黙に指定された -xchip 値の指定を変更する場合に、このオプションを使用します。

-xchip=c は次のものに影響を与えます。

• 命令の順序 (スケジューリング)

• 分岐をコンパイルする方法

• 同義の代替命令の選択

次の表に、-xchip の有効なプロセッサ名の値をまとめてあります。

x86 プラットフォーム:-xchip 値は、 pentium、pentium_pro、pentium3、pentium4、generic、opteron、および native のいずれかです。

3.4.122 -xcode=keyword

(SPARC) SPARC プラットフォームのコードアドレス空間を指定します。

keyword の値は次のとおりです。

-xcode=keyword を明示的に指定しなかった場合のデフォルトは、次のとおりです。

32 ビットのプラットフォームの場合は、-xcode=abs32 です。64 ビット のプラットフォームの場合は、-xcode=abs44 です。

3.4.122.1 位置独立コード

実行時のパフォーマンスを向上するために動的共有ライブラリを作成するときには、-xcode=pic13 または -xcode=pic32 を使用します。

動的実行可能ファイルのコードは、通常、メモリーの固定アドレスに結び付けられ、位置独立コードは、プロセスのどのようなアドレス空間でもロードすることができます。

位置独立コードを使用する場合は、大域オフセットテーブルを使用した直接的なリファレンスとして、再配置可能なリファレンスが作成されます。頻繁にアクセスされる共有オブジェクトの項目は、-xcode=pic13 または -xcode=pic32 を使用してコンパイルすると、位置独立コード以外のコードによって行われる多数の再配置が必要なくなるという利点があります。

大域オフセットテーブルのサイズは、8K バイトに制限されます。

-xcode={pic13|pic32} には、次のようなパフォーマンス上の影響があります。

• -xcode=pic13 または -xcode=pic32 のいずれかでコンパイルされたルーチンは、エントリで命令をいくつか実行することによって、共有ライブラリの大域変数や静的変数へのアクセスに使用する大域的なオフセットテーブルを指すようにレジスタを設定します。

• 大域変数または静的変数にアクセスするごとに、大域オフセットテーブルを介して余分な間接メモリー参照を行います。pic32 でコンパイルを実行すると、大域的または静的なメモリー参照を行うごとに、命令が 2 つ追加されます。

こうした影響があるとしても、-xcode=pic13 または -xcode=pic32 を使用すると、ライブラリコードを共有できるため、必要となるシステムメモリーを大幅に減らすことができます。-xcode=pic13 または -xcode=pic32 でコンパイルした共有ライブラリ中のコードの各ページは、そのライブラリを使用する各プロセスで共有することができます。共有ライブラリ中にあるコードのページに 1 つでも -pic でコンパイルされていないメモリー参照 (直接メモリー参照) があると、このページは共有できなくなるため、ライブラリを使用したプログラムを実行するたびに、そのページのコピーが作成されます。

.o ファイルが -xcode=pic13 または -xcode=pic32 でコンパイルされているかどうかを調べるには、nm コマンドを使用する方法がもっとも簡単です。

nm file.o | grep _GLOBAL_OFFSET_TABLE_

位置独立コードを含む .o ファイルには、_GLOBAL_OFFSET_TABLE_ への未解決の外部参照があります。未解決の参照は U の文字で示されます。

-xcode=pic13 または -xcode=pic32 のどちらを使用すべきか決定するときは、elfdump -c (詳細は elfdump(1) のマニュアルページを参照) を使用することによって、セクションヘッダー (sh_name: .got) を探して、大域オフセットテーブル (GOT) のサイズを調べてください。sh_size 値が GOT のサイズです。 GOT のサイズが 8,192 バイトに満たない場合は -xcode=pic13、そうでない場合は -xcode=pic32 を指定します。

一般に、-xcode の使用方法の決定に際しては、次のガイドラインに従ってください。

• 実行可能ファイルを構築する場合は、-xcode=pic13 と -xcode=pic32 のどちらも使わない。

• 実行可能ファイルへのリンク専用のアーカイブライブラリを構築する場合は、-xcode=pic13 と -xcode=pic32 のどちらも使わない。

• 共有ライブラリを構築する場合は、-xcode=pic13 から開始し、GOT のサイズが 8,192 バイトを超えたら、-xcode=pic32 を使用する。

• 共有ライブラリへのリンク用のアーカイブライブラリを構築する場合は、-xcode=pic32 のみ使用する。

動的ライブラリを構築する場合は、-xcode=pic13 または pic32 (または -pic または -PIC) オプションを使用してコンパイルしてください。Solaris の『リンカーとライブラリ』を参照してください。

3.4.123 -xcommonchk[ ={yes|no}]

共通ブロック不一致の実行時検査を行います。

このオプションは、TASK COMMON や並列化を使用しているプログラムで共通ブロックに不一致がないかデバッグ検査を行います。『Fortran プログラミングガイド』の「並列化」の章で TASK COMMON 指令に関する説明を参照してください。

デフォルトは -xcommonchk=no です。 共通ブロック不一致の実行時検査を行うとパフォーマンスが低下するので、デフォルトではこのオプションは無効になっています。-xcommonchk=yes はプログラム開発とデバッグのときだけ使用し、製品版のプログラムには使用しないでください。

-xcommonchk=yes でコンパイルすると実行時検査が行われます。1 つのソースプログラム単位で正規の共通ブロックとして宣言されている共通ブロックが TASK COMMON 指令の中で指定されていると、プログラムは停止し、不一致を示すエラーメッセージが出力されます。値を指定しない場合、-xcommonchk は -xcommonchk=yes と同等です。

例: tc.f における TASKCOMMON 指令の欠如

demo% cat tc.f
                common /x/y(1000)
                do 1 i=1,1000
 1              y(i) = 1.
                call z(57.)
                end
demo% cat tz.f
                subroutine z(c)
                common /x/h(1000)
C$PAR TASKCOMMON X
C$PAR DOALL
                do 1 i=1,1000
1                       h(i) = c* h(i)
                return
                end
demo% f95 -c -O4 -parallel -xcommonchk tc.f
demo% f95 -c -O4 -parallel -xcommonchk tz.f
demo% f95 -o tc -O4 -parallel -xcommonchk tc.o tz.o
demo% tc
エラー (libmtsk): threadprivate/taskcommon の宣言の不一致
   x_: tc.f の 1 行目では threadprivate/taskcommon として宣言しません。
demo%

3.4.124 -xcrossfile[ ={1|0}]

最適化とソースファイル間のインライン化を有効にします。

通常、コンパイラが分析する範囲はコマンド行で指定した個別のファイルに限られます。たとえば、-O4 の自動インライン化は、単一のソースファイル中で定義され、引用される副プログラムに対してのみ行われます。

-xcrossfile を付けると、コンパイラは、コマンド行で指定されたすべてのファイルを、単一のソースファイルに連結されているかのように分析します。

-xcrossfile は、-O4 または -O5 と併用したときだけ有効です。

ファイル間のインライン化を行うと、ソースファイルの相互依存関係が生成されます。これは、通常は存在しません。-xcrossfile を指定してコンパイルしたファイルセット中のいずれかのファイルを変更した場合は、新しいコードが正しくインライン化されるように、全ファイルを再コンパイルする必要があります。「3.4.48 -inline=[ %auto][[,][no%] f1,…[no%]fn]」を参照してください。

デフォルトでは、コマンド行に -xcrossfile を指定しないので、-xcrossfile=0 となり、ファイル間の最適化は行われません。ファイル間の最適化を有効にするには、-xcrossfile (-xcrossfile=1 と同義) と指定します。

また、.s のアセンブラソースファイルは、ファイル間解析には関係しません。また、-S を指定したコンパイルでは、-xcrossfile フラグは無視されます。

3.4.125 -xdebugformat={ dwarf|stabs}

Sun Studio コンパイラのデバッガ情報の形式は、「stabs」形式から「dwarf」形式に移行しつつあります。このリリースのデフォルト設定は、-xdebugformat=dwarf です。

デバッグ情報を読み取るソフトウェアを保守している場合は、今回からそのようなツールを stab 形式から dwarf 形式へ移行するためのオプションが加わりました。

このオプションは、ツールを移植する場合に新しい形式を使用する方法として使用してください。デバッガ情報を読み取るソフトウェアを保守していないか、ツールでこれらの内のいずれかの形式のデバッガ情報が必要でなければ、このオプションを使用する必要はありません。

-xdebugformat=stabs は、stab 標準形式を使用してデバッグ情報を生成します。

-xdebugformat=dwarf は、dwarf 標準形式を使用してデバッグ情報を生成します。

-xdebugformat を指定しない場合は、コンパイラでは -xdebugformat=dwarf が指定されます。引数なしでこのオプションを指定するとエラーになります。

このオプションは、-g オプションによって記録されるデータの形式に影響します。また、この情報の一部の形式はこのオプションで制御されます。したがって、-g を使用しなくても、-xdebugformat は有効です。

dbx とパフォーマンスアナライザソフトウェアは、stab 形式と dwarf 形式を両方とも認識するので、このオプションを使用しても、ツールの機能にはまったく影響を与えません。

これは過渡的なインタフェースなので、今後のリリースでは、マイナーリリースであっても互換性なく変更されることがあります。stab と dwarf のどちらであっても、特定のフィールドまたは値の詳細は、今後とも変更される可能性があります。

コンパイルされたオブジェクトまたは実行可能ファイルのデバッグ情報の形式を判断するには、dwarfdump(1) コマンドを使用します。

3.4.126 -xdepend

-depend と同義です。

3.4.127 -xexplicitpar

-explicitpar と同義です。

3.4.128 -xF

パフォーマンスアナライザにより、関数レベルの並べ替えを行います。

コンパイラ、パフォーマンスアナライザ、およびリンカーを使用して、コアイメージで関数 (副プログラム) の並べ替えを再度実行できます。-xF オプションでコンパイルすると、アナライザが実行されます。これにより、マップファイルを作成して、関数がどのように使用されるかに応じて、メモリー中の関数の順序を並べ替えることができます。そのあと、実行可能ファイルを構築するリンクにおいて、-Mmapfile リンカーオプションを使って、そのマップを使用するように指定することができます。これによって、実行可能ファイルの関数が別々のセクションに配置されます 。f95 —Mpath オプションも、リンカーに通常ファイルを渡します。 f95 —Mpath オプションの説明を参照してください。

メモリー中の副プログラムの並べ替えは、アプリケーションのテキストページフォルト時間がアプリケーションの実行時間に占める割合が大きい場合にのみ役に立ちます。その他の場合の並べ替えでは、アプリケーションの全体的なパフォーマンスは改善されない場合があります。アナライザについての詳細は、『プログラムのパフォーマンス解析』を参照しください。

3.4.129 -xfilebyteorder= options

リトルエンディアン式プラットフォームとビッグエンディアン式プラットフォーム間のファイルの共有をサポートします。

このフラグは、書式なし入出力ファイル内のデータのバイト順序とバイト列を特定します。options には、次のフラグを任意に組み合わせたものを指定しますが、少なくとも 1 つのフラグを指定する必要があります。

littlemax_align:spec

bigmax_align:spec

native:spec

max_align は、ターゲットプラットフォームの最大バイト列を宣言します。指定できる値は 1、2、4、8、16 です。境界整列は、C 言語の構造体との互換性を維持するため、プラットフォーム依存のバイト列を使用する Fortran VAX 構造体と Fortran 95 派生型に適用されます。

最大バイト列が max_align のプラットフォームでは、little は「リトルエンディアン」ファイルを表します。たとえば little4 は 32 ビット x86 ファイルを表すのに対し、little16 は 64 ビット x86 ファイルを表します。

big は、最大バイト列が max_align の「ビッグエンディアン」ファイルを指定します。たとえば big8 が 32 ビット SPARC ファイルを表すのに対し、big16 は 64 ビット SPARC ファイルを表します。

native は、コンパイルしているプロセッサプラットフォームが使用しているのと同じバイト順序、バイト列の「ネイティブ」ファイルを表します。次は、「ネイティブ」とみなされます。

spec には、コンマ区切りのリストで次を指定します。

%all

unit

filename

%all は、SCRATCH として開かれるか、-xfilebyteorder フラグで明示的に指定する以外のすべてのファイルと、その他の論理ユニットを表します。%all は、1 回だけ指定できます。

unit は、プログラムによって開かれた特定の Fortran ユニット番号を表します。

filename は、プログラムによって開かれた特定の Fortran ファイル名を表します。

3.4.129.1 例:

-xfilebyteorder=little4:1,2,afile.in,big8:9,bfile.out,12
-xfilebyteorder=little8:%all,big16:20

3.4.129.2 備考:

このオプションは、STATUS="SCRATCH" を指定して開かれたファイルには適用されません。それらのファイルに対する入出力操作は、常にネイティブプロセッサのバイト順序とバイト列が使用されます。

コンパイラコマンド行に -xfilebyteorder が指定されていない場合の最初のデフォルトは、-xfilebyteorder=native:%all です。

このオプションには、ファイル名およびユニット番号をそれぞれ 1 回だけ宣言できます。

コマンド行に -xfilebyteorder を含める場合は、little、big、または native の少なくとも 1 つの指定と組み合わせる必要があります。

このフラグで明示的に宣言されていないファイルは、ネイティブファイルとみなされます。たとえば、-xfilebyteorder=little4:zork.out を付けて zork.out をコンパイルした場合、このファイルは、4 バイトの最大データ整列規則を持つリトルエンディアンの 32 ビット x86 ファイルと宣言され、ほかのすべてのファイルはネイティブファイルになります。

ファイルに指定されたバイト順序はネイティブプロセッサと同じであるが、バイト列が異なる場合は、バイトスワップが行われないにしても、適切なパディングが使用されます。たとえば m64 を付けた、64 ビット x86 プラットフォーム向けのコンパイルで、-xfilebyteorder=little4:filename が指定された場合などがそうです。

ビッグエンディアンとリトルエンディアン式プラットフォーム間で共有されるデータレコード内で宣言する型は、同じサイズである必要があります。たとえば、-xtypemap=integer:64,real:64,double:128 を付けてコンパイルした SPARC 実行可能ファイルの生成するファイルを、-xtypemap=integer:64,real:64,double:64 を付けてコンパイルした x86 実行可能ファイルが読み取ることはできません。これは、両者のデフォルトの倍精度データ型のサイズが異なるためです。

REAL*16 データを含む書式なしのファイルは、REAL*16 をサポートしていない x86 プラットフォームでは使用できません。

ネイティブ以外のファイルとして指定されたファイルに対して、UNION/MAP データオブジェクト全体を使った入出力操作を行うと、実行時入出力エラーになります。ネイティブ以外のファイルに対しては、MAP の個別メンバーを使った入出力操作のみ行うことができます。UNION/MAP を含む VAX レコード全体を使った入出力操作は行えません。

3.4.130 -xhasc[ ={yes|no}]

ホレリス定数を実際の引数リストの文字列として扱います。

-xhasc=yes を指定すると、コンパイラは、サブルーチンまたは関数でホレリス定数が実際の引数として指定された場合にそれらの定数を文字列として扱います。これはデフォルトであり、Fortran の標準に準拠しています。コンパイラが生成する実際のコールリストには、各文字列の非表示の長さが示されます。

-xhasc=no を指定すると、ホレリス定数は副プログラムの型なしの値として扱われ、それらの値のアドレスだけが実際の引数リストに配置されます。副プログラムに渡される実際のコールリストには、文字列の長さは示されません。

ホレリス定数で副プログラムが呼び出され、呼び出された副プログラムが引数を INTEGER (または CHARACTER 以外) と予測する場合、ルーチンを -xhasc=no でコンパイルします。

例:

demo% cat hasc.f
                call z(4habcd, ’abcdefg’)
                end
                subroutine z(i, s)
                integer i
                character *(*) s
                print *, "string length = ", len(s)
                return
                end
demo% f95 -o has0 hasc.f
demo% has0
 string length =   4    <-- 7 であるべきです
demo% f95 -o has1 -xhasc=no hasc.f
demo% has1
 string length =   7  <--  s の長さを修正します

z への 4habcd の受け渡しは、-xhasc=no でコンパイルすることにより、正しく行われます。

このフラグは、従来の FORTRAN 77 プログラムの移植を支援するために提供されています。

3.4.131 -xhelp={ readme|flags}

要約したヘルプ情報を表示します。

-xhelp=readme

このコンパイラのリリースのオンライン README ファイルを表示します。

-xhelp=flags

コンパイラのオプションフラグを一覧表示します。-help と同義です。

3.4.132 -xhwcprof[={enable | disable}]

(SPARC) コンパイラのデータ空間プロファイリングのサポートを有効にします。

-xhwcprof を有効にすると、コンパイラは、プロファイル対象のロード命令およびストア命令と、それらが参照するデータ型および構造体メンバーをツールが関連付けるのに役立つ情報を、-g で生成されたシンボル情報と組み合わせて生成します。このオプションでは、プロファイルデータを命令空間ではなくターゲットのデータ空間と関連付け、命令プロファイリングだけでは簡単に得ることができない動作情報を確認できます。

指定した一連のオブジェクトファイルは、-xhwcprof を使用してコンパイルできます。ただし、このオプションがもっとも役立つのは、アプリケーション内のすべてのオブジェクトファイルに適用したときです。このオプションによって、アプリケーションのオブジェクトファイルに分散しているすべてのメモリー参照を識別したり、関連付けたりするカバレージが提供されます。

コンパイルとリンクを別々に行う場合は、-xhwcprof をリンク時にも使用してください。

-xhwcprof=enable または -xhwcprof=disable のインスタンスは、同じコマンド行にある以前の -xhwcprof のインスタンスをすべて無効にします。

-xhwcprof はデフォルトでは無効です。引数を指定せずに -xhwcprof と指定することは、-xhwcprof=enable と指定することと同じです。

-xhwcprof を使用する場合は最適化を有効にし、デバッグのデータ形式を dwarf (-xdebugformat=dwarf) に設定しておく必要があります。これは、この Sun Studio のリリースのデフォルトです。

-xhwcprof と -g を組み合わせて使用すると、コンパイラに必要な一時ファイル記憶領域は、-xhwcprof と -g を単独で指定することによって増える量の合計を超えて大きくなります。

次のコマンドは example.f をコンパイルし、ハードウェアカウンタによるプロファイリングのサポートを指定し、DWARF シンボルを使用してデータ型と構造体メンバーのシンボリック解析を指定します。

f95 -c -O -xhwcprof -g  example.f            

ハードウェアカウンタによるプロファイリングの詳細は、『Sun Studio Performance Analyzer』を参照してください。

3.4.133 -xia[={widestneed|strict}]

(SPARC) 区間演算処理を有効化し、適切な浮動小数点環境を設定します。

指定しない場合のデフォルトは、-xia=widestneed です。

Fortran 95 で拡張された区間演算の詳細は、『Fortran 95 区画演算プログラミングリファレンス 』に記載されています。「3.4.136 -xinterval[ ={widestneed|strict| no}]」も参照してください。

-xia フラグは、次のように展開されるマクロです。