CC - Oracle Solaris Studio 12.4 Man Pages

言語:

CC(1)

名前

CC - C++ コンパイラ

形式

CC   [-#]  [-###]  [-B{dynamic|static|symbolic}] [-c]
     [-compat[={5|g}]] [+d] [-Dname[=def]] [-d{y|n}]
     [-dalign]  [-dryrun] [-E] [-erroff[=t[,t...]]]
     [-errtags[=a]] [-errwarn[=t[,t...]]] [-fast]
     [-features=a[,a...]] [-filt[=filter[,filter...]]
     [-flags] [-fma[={none|fused}]] [-fnonstd]
     [-fns[={yes|no}]] [-fopenmp] [-fprecision=a]
     [-fround=a] [-fsimple[=n]] [-fstore] [-ftrap=a[,a...]]
     [-G] [-g] [-g[n]] [-H] [-h[ ]lname] [-help]
     [-Ipathname] [-I-] [-i] [-include] [-inline]
     [-instances=i] [-instlib=file] [-KPIC] [-Kpic]
     [-keeptmp] [-Lpath] [-llib] [-libmieee] [-libmil]
     [-library=lib[,lib...]] [-m32|-m64] [-mc] [-misalign]
     [-mr[,string]] [-mt] [-native] [-noex] [-nofstore]
     [-nolib] [-nolibmil] [-noqueue] [-norunpath] [-O[n]]
     [-O[level]] [-o file] [+p] [-P] [-p] [-pentium] [-pg]
     [-PIC] [-pic] [-preserve_argvalues[=int|none]] [-pta]
     [-ptipath] [-pto] [-ptv]
     [{-Qoption|-qoption} phase [,option...]]
     [{-Qproduce|-qproduce}type] [-qp] [-Rpath[:path...]]
     [-S] [-s] [-staticlib=l[,l...]] [-std=v]
     [-sync_stdio=[yes|no]] [-temp=path]
     [-template=a[,a...]] [-time] [-traceback[=list]]
     [-Uname] [-unroll=n] [-V] [-v] [-verbose=a[,a...]]
     [-Wc,arg] [+w] [+w2] [-w] [-Xlinker arg] [-Xm]
     [-xaddr32[={yes|no}]] [-xalias_level[=n]]
     [-xanalyze={code|no}] [-xannotate[={yes|no}]] [-xar]
     [-xarch=isa] [-xautopar] [-xbinopt={a}]
     [-xbuiltin[={a}] [-xcache=c] [-xchar[=o]] [-xcheck[=n]]
     [-xchip=c] [-xcode=v] [-xdebugformat=[stabs|dwarf]]
     [-xdebuginfo=a[,a...]] [-xdepend[={yes|no}]]
     [-xdumpmacros[=value[,value...]] [-xe] [-xF[=v]]
     [-xglobalize[={yes|no}]] [-xhelp=flags]
     [-xhwcprof[={enable|disable}]] [-xia]
     [-xinline[=func_spec[,func_spec...]]
     [-xinline_param=a[,a[,a]...]] [-xinline_report[=n]]
     [-xinstrument=[no%]datarace] [-xipo[={0|1|2}]
     [-xipo_archive[=a]] [-xipo_build=[yes|no]]
     [-xivdep[=p]] [-xjobs=[n|auto]]
     [-xkeep_unref[={[no%]funcs,[no%]vars}]]
     [-xkeepframe[=p]] [-xlang=language[,language]]
     [-xldscope=[v]] [-xlibmieee] [-xlibmil] [-xlibmopt]
     [-xlic_lib=sunperf] [-xlicinfo] [-xlinkopt[=level]]
     [-xloopinfo] [-xM] [-xM1] [-xMD] [-xMF] [-xMMD]
     [-xMerge] [-xmaxopt[=v]]  [-xmemalign=ab] [-xmodel=[a]]
     [-xnolib]  [-xnolibmil] [-xnolibmopt] [-xOn]
     [-xopenmp[=i]] [-xpagesize=n] [-xpagesize_heap=n]
     [-xpagesize_stack=n]
     [-xpatchpadding[={fix|patch|size}]] [-xpch=v]
     [-xpchstop] [-xpec] [-xpg] [-xport64[=v]]
     [-xprefetch[=a[,a]] [-xprefetch_auto_type=[a]
     [-xprefetch_level[=l]] [-xprevise={yes|no}] [-xprofile=p]
     [-xprofile_ircache[=path]]
     [-xprofile_pathmap=collect_prefix:use_prefix]
     [-xreduction] [-xregs=r[,r...]] [-xrestrict[=f]]
     [-xs[={yes|no}]] [-xsafe=mem] [-xsegment_align=n] [-xspace]
     [-xtarget=t] [-xtemp=path] [-xthreadvar[=o]]
     [-xthroughput[={yes|no}]] [-xtime]
     [-xtrigraphs[={yes|no}]] [-xunboundsym={yes|no}]
     [-xunroll=n] [-xustr={ascii_utf16_ushort|no}]
     [-xvector[=a]] [-xvis] [-xvpara] [-xwe] [-Yc,path]
     [-z arg] [file] ...

説明

Oracle Solaris Studio 12.4 C++ コンパイラ。

このマニュアルページでは、Oracle Solaris Studio 12.4 C++ コンパイラのオプションまたはフラグについて詳細に説明します。

このリリースの完全なドキュメントは、Oracle Technical Network (OTN) Solaris Studio の Web サイトで入手できます。

http://oracle.com/technetwork/server-storage/solarisstudio

OTN Web サイトには Oracle Solaris Studio の完全なリソースがあり、ベストプラクティス、さまざまなプログラミングテクノロジの詳細、およびその他のトピックからなる多数の技術的な記事が含まれています。

Oracle Solaris Studio スイートのすべての新機能の完全な説明については、『このリリースの新機能ガイド』を参照してください。

このマニュアルページは、定義上はクイックリファレンスです。C++ コンパイラとそのオプションの詳細は、『C++ ユーザーズガイド』を参照してください。

64 ビットプラットフォーム用のコンパイル

ターゲットコンパイルのメモリーモデル (ILP32 または LP64) を指定するには、それぞれ -m32 および -m64 オプションを使用します。

-xarch オプションには、暗黙的なメモリーモデル定義が含まれなくなったため、ターゲットプロセッサの命令セットを指定するためのみに使用してください。

ILP32 モデルは、C 言語の int、long、およびポインタデータ型がすべて 32 ビット拡張であることを指定します。long およびポインタデータ型を指定する LP64 モデルは、すべて 64 ビット拡張です。Oracle Solaris および Linux OS は、LP64 メモリーモデルの大きなファイルや大きな配列もサポートします。

-m64 を使用してコンパイルを行う場合、結果の実行可能ファイルは、64 ビットカーネルを実行する Oracle Solaris OS または Linux OS の 64 ビット SPARC または x86 プロセッサでのみ動作します。64 ビットオブジェクトのコンパイル、リンク、および実行は、64 ビット実行をサポートする Oracle Solaris または Linux OS でのみ行うことができます。

x86 の特記事項

x86 の Oracle Solaris プラットフォーム用にコンパイルする場合は、注意する必要がある重要な問題がいくつかあります。

-xarch を sse、sse2、sse2a、または sse3 以上に設定してコンパイルされたプログラムは、それらの拡張機能が備わったプラットフォームでのみ実行する必要があります。

このリリースでは、デフォルトの命令セットおよび -xarch=generic の意味が sse2 に変更されました。ターゲットプラットフォームオプションを指定せずにコンパイルすると、古い Pentium III または以前のシステムと互換性がない sse2 バイナリが生成されます。

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

-xarch=pentium_pro または -xarch=sse での数値の結果は、x86 の 80 ビットの浮動小数点レジスタの影響で、SPARC での結果と異なる場合があります。この差を最小にするには、-fstore オプションを使用するか、デフォルトの -xarch=sse2 を指定してコンパイルします。

組み込み数学ライブラリ (sin(x) など) が異なるため、Oracle Solaris と Linux の間でも数値結果が異なることがあります。

バイナリの互換性の妥当性検査

特殊化された -xarch ハードウェアフラグを使用してコンパイルおよび作成されたプログラムバイナリは、適切なプラットフォームで実行されているかどうかが検証されます。特殊化された -xarch オプションでコンパイルしたプログラムを、適切な機能または命令セット拡張に対応していないプラットフォームで実行すると、セグメント例外や明示的な警告メッセージなしの不正な結果が発生することがあります。

ただし、Linux ではそのような検証は行われません。古いハードウェアプラットフォームの Oracle Solaris Studio のコンパイラでコンパイルされたバイナリオブジェクトを実行すると、ランタイムエラーになることがあります。Linux では、それらのバイナリを適切なハードウェアプラットフォームにデプロイすることはユーザーの責任です。

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

C++ コンパイラの概要

CC は、C++ およびアセンブリソースファイルをオブジェクトファイルに変換し、それらのオブジェクトファイルとライブラリを実行可能プログラムにリンクします。

C++ オブジェクトを含むプログラムは、CC でリンクする必要があります。

CC は、C++ ソースプログラムとして .c、.C、.cc、.cxx、.c++、.cpp、または .i で終わる引数を取ります。.s で終わる引数は、アセンブリソースファイルであると見なされます。.o で終わる引数は、オブジェクトファイルであると見なされます。

名前が上の接尾辞で終わらないファイルは、オブジェクトプログラムまたはライブラリとして扱われ、リンクエディタに渡されます。-c、-S、-E、または -P が指定されていないかぎり、これらのプログラムとライブラリは、指定されたすべてのコンパイルまたはアセンブリの結果とともに、指定された順序でリンクされて a.out という名前の出力ファイルを生成します。-o オプションを使用して、実行可能ファイルに別の名前を指定できます。

1 つのファイルが一度にすべてコンパイルおよびリンクされる場合、中間ファイルは削除されます。

CC コマンドを使用する前に、C++ コンパイルシステムのインストール先として選択したディレクトリの名前を検索パスに挿入します。検索パスを設定する手順については、csh(1) または sh(1) のマニュアルページを参照してください。

ユーザー指定のデフォルトコンパイラオプション起動ファイル

これらのデフォルトコンパイラオプションファイルは、ユーザーがすべてのコンパイルに適用される (ほかの方法で上書きされる場合を除く)、一連のデフォルトオプションを指定することを許可します。たとえば、ファイルによって、すべてのコンパイルのデフォルトを -xO2 としたり、またはファイル setup.il を自動的に含めたりするように指定できます。

コンパイラは起動時に、すべてのコンパイルに含めるべきデフォルトオプションがリストされているデフォルトオプションファイルを検索します。環境変数 SPRO_DEFAULTS_PATH は、デフォルトファイルを検索するディレクトリのコロン区切りリストを指定します。

環境変数が設定されていない場合、標準のデフォルトセットが使用されます。環境変数が設定されているが空の場合、デフォルトは使用されません。

デフォルトファイルの名前は compiler.defaults の形式である必要があります。compiler は cc、c89、c99、CC、ftn、または lint のいずれかです。たとえば、C++ コンパイラでのデフォルトは CC.defaults になります。

コンパイラ用のデフォルトファイルが SPRO_DEFAULTS_PATH に一覧表示されているディレクトリ内で見つかった場合、コンパイラはコマンド行のオプションを処理する前に、このファイルを読み込んでオプションを処理します。最初に見つかったデフォルトファイルが使用され、検索は終了します。

システム管理者は、システム全体のデフォルトファイルを Studio-install-path/prod/etc/config に作成できます。環境変数が設定されている場合、インストールされたデフォルトファイルは読み取られません。

デフォルトファイルの形式はコマンド行と同様です。ファイルの各行には、1 つ以上のコンパイラオプションを空白で区切って含めてもかまいません。ワイルドカードや置換などのシェル展開は、デフォルトファイル内のオプションには適用されません。

—#、—###、および —dryrun の各オプションによって生成される詳細出力では、SPRO_DEFAULTS_PATH の値と、完全展開されたコマンド行が表示されます。

ユーザーによってコマンド行で指定されたオプションは、通常、デフォルトファイルから読み取られたオプションをオーバーライドします。たとえば、—xO4 でのコンパイルがデフォルトファイルで指定されており、ユーザーがコマンド行で —xO2 を指定した場合、—xO2 が使用されます。

デフォルトオプションファイルに記載されているオプションの一部は、コマンド行で指定されたオプションのあとに付加されます。これらは、プリプロセッサオプション —I、リンカーオプション —B、—L、—R、 —l、および、ソースファイル、オブジェクトファイル、アーカイブ、共有オブジェクトなどのすべてのファイル引数です。

次に示すのは、ユーザー指定のデフォルトコンパイラオプション起動ファイルがどのように使用される可能性があるかの例です。

 
demo% cat /project/defaults/CC.defaults
-fast -I/project/src/hdrs -L/project/libs -llibproj -xvpara
demo% setenv SPRO_DEFAULTS_PATH /project/defaults
demo% CC -c -I/local/hdrs -L/local/libs -lliblocal tst.cc

コンパイラコマンドは次と同等になります。

 
CC -fast -xvpara -c -I/local/hdrs -L/local/libs -lliblocal \
       tst.cc -I/project/src/hdrs -L/project/libs -llibproj

コンパイラデフォルトファイルはプロジェクト全体のデフォルトを設定するための便利な方法ですが、問題の診断を困難にする原因になる場合もあります。このような問題を回避するには、環境変数SPRO_DEFAULTS_PATHを現在のディレクトリではなく絶対パスに設定します。

デフォルトオプションファイルのインタフェース安定性はコミットされていません。オプション処理の順序は、将来のリリースで変更される可能性があります。

オプション

すべてのプラットフォームに共通のオプションは、すべてのプラットフォームで暗黙的に受け入れられます。この規則の例外は、個別のオプションに記述されています。

SPARC プラットフォームでのみ有効なオプションは (SPARC) とマークされています。x86/x64 プラットフォームでのみ有効なオプションは (x86) とマークされています。

非推奨のオプションは(廃止)とマークされており、今後は使用しないでください。これらは、以前のリリースとの互換性のためにのみ提供されています。代わりに示されているオプションを使用してください。

リンカーのオプションについては、ld(1) を参照してください。

コマンド行オプションの構文では、角括弧 ( [] ) の項目はオプションです。選択するリテラル項目をバーで区切ったリストは、{yes | no | maybe } のように、中括弧で囲まれています。値なしでフラグが表示されている場合は、通常、リストの最初の項目がデフォルト値を示しています。

たとえば、-someoption[={no|yes}] は -someoption が -someoption=no と同じであることを意味します。

一般に、コンパイラオプションは左から右に処理され (ただし、-U オプションがすべての -D オプションのあとに処理される点は例外です)、マクロオプション (ほかのオプションを含むオプション) を選択的にオーバーライドできるようにします。この規則はリンカーのオプションには適用されません。

例を含む C++ コンパイラオプションの詳細な説明については、『C++ ユーザーズガイド』を参照してください。

CC は、次のオプションを受け入れます。

-#

冗長モードをオンにして、コマンドオプションが展開された状態を示します。要素が呼び出されるごとにその要素を表示します。

-###

呼び出される各コンポーネントを表示しますが、それらのコンポーネントは実際には実行しません。また、コマンドオプションの展開内容を表示します。

-Bbinding

ライブラリのリンク形式をシンボリック、動的 (共有)、静的 (共有でない) のいずれかから指定します。

-Bdynamic がデフォルトです。-B オプションは、コマンド行で複数回使用できます。

-Bbinding オプションの詳細は、ld(1) のマニュアルページおよび Oracle Solaris のドキュメントを参照してください。

-Bdynamic は、リンクエディタに liblib.so ファイルを探すよう指示します。ライブラリのリンク方式を共有にしたい場合は、このオプションを指定します。liblib.so ファイルが見つからない場合、リンカーは liblib.a ファイルを探します。

-Bstatic は、リンクエディタに liblib.a ファイルのみを探すよう指示します。 .a 接尾辞は、このファイルが静的 (つまり、非共有) であることを示します。ライブラリのリンク形式を非共有にしたい場合は、このオプションを指定します。

-Bsymbolic は、シンボルがほかですでに定義されている場合でも、可能であればシンボルを共有ライブラリ内で強制的に解決します。-Bsymbolic については、ld(1) のマニュアルページを参照してください。

このオプションとその引数は、リンカー ld に渡されます。コンパイルとリンクを別の手順で行うときに -Bbinding オプションを使用する場合は、そのオプションをリンクの手順に含める必要があります。

警告:

C++ コードが含まれているプログラムでは -Bsymbolic を使用せず、代わりにリンカースコープを使用してください。リンカースコープの詳細は、『C++ ユーザーズガイド』を参照してください。-xldscope オプションも参照してください。

-Bsymbolic を使用すると、異なるモジュール内の参照が、本来 1 つのグローバルオブジェクトの複数の異なる複製に結合されてしまう可能性があります。

例外メカニズムは、アドレスの比較によって機能します。何かのコピーが 2 つある場合は、それらのアドレスが等しくならないため、一意のアドレスであると想定されているものの比較に依存する例外メカニズムが失敗することがあります。

-c

各ソースファイルの .o ファイルをリンクせずにコンパイルおよび生成します。-o オプションを使用すると、1 つのオブジェクトファイルを明示的に指定できます。コンパイラが各入力ファイルに対応するオブジェクトコードを生成する場合は、現在の作業ディレクトリにオブジェクトファイルを作成します。リンクを行わないと、オブジェクトファイルの削除も行われません。

次に例を示します。

CC -c x.cc は、オブジェクトファイル x.o を生成します。
CC -c -o y.o x.cc は、オブジェクトファイル y.o を生成します。

警告:

コンパイラは、入力ファイル (.cc、.c、.i など) のオブジェクトコードを生成する場合、常に .o ファイルを作業ディレクトリ内に生成します。リンク手順を省略すると、この .o ファイルは削除されません。

関連項目:

『数値計算ガイド』、ieee_sun(3M)。

-features=a

さまざまな C++ 言語機能を有効または無効にします。

次の表に、-features サブオプションの各キーワードとその意味を示します。サブオプションに接頭辞 no% を適用すると、そのサブオプションが無効になります。

%all

非推奨。%all を使用しないでください。下記の警告を参照してください。

%none

非推奨。%none を使用しないでください。下記の警告を参照してください。

[no%]altspell

トークンの代替スペル (&& に対する and など) を認識します。デフォルトは altspell です。

[no%]anachronisms

廃止されている構文を許可します。無効になっている (つまり、-feature=no%anachronisms である) 場合、廃止されている構文は許可されません。デフォルトは anachronisms です。

[no%]bool

bool 型とリテラルを許可します。有効になっている場合は、マクロ _BOOL = 1 です。無効になっている場合、マクロは定義されません。デフォルトは bool です。

[no%]conststrings

リテラル文字列を読み取り専用メモリー内に配置します。デフォルトは conststrings です。

cplusplus_redef

通常は事前に定義されているマクロ __cplusplus を、コマンド行で -D オプションによって再定義できるようにします。ソースコードで #define 指令を使用して __cplusplus の再定義を試みることは許可されていません。

例:

CC -features=cplusplus_redef -D__cplusplus=1 ...

g++ コンパイラは通常、__cplusplus マクロを 1 に事前に定義するため、ソースコードがこの非標準の値に依存している可能性があります。(標準の値は、1998 年の C++ 標準または 2003 年の更新を実装しているコンパイラを示す 199711L です。将来の標準では、このマクロにより大きな値が必要になります。)

このオプションは、g++ 用のコードをコンパイルするために __cplusplus を 1 に再定義する必要がないかぎり使用しないでください。

[no%]except

C++ 例外を許可します。C++ 例外が無効になっている (つまり、-features=no%except である) 場合、関数でのスロー指定は受け入れられますが、無視されます。コンパイラは例外コードを生成しません。キーワード try、throw、および catch は常に予約されています。デフォルトは except です。

explicit

キーワード explicit を認識します。no%explicit は許可されません。

[no%]export

キーワード export を認識します。デフォルトは export です。

[no%]extensions

ほかの C++ コンパイラによって一般に受け入れられる非標準のコードを許可します。-features=extensions オプションを使用したときにコンパイラによって受け入れられる無効なコードについては、『C++ ユーザーズガイド』の第 4 章を参照してください。デフォルトは -features=no%extensions です。

[no%]iddollar

初期以外の識別子文字として $ を許可します。デフォルトは no%iddollar です。

[no%]localfor

for 文に対する標準に準拠したローカルスコープの規則を使用します。デフォルトは localfor です。

[no%]mutable

キーワード mutable を認識します。デフォルトは mutable です。

namespace

キーワード namespace を認識します。no%namespace は許可されません。

[no%]nestedaccess

入れ子のクラスから包含するクラスの private メンバーにアクセスできるようにします。デフォルトは -features=nestedacces です。

[no%]rvalueref

非定数参照の右辺値または一時値へのバインドを許可します。デフォルトは -features=no%rvalueref です。C++ コンパイラは従来より、非定数参照を一時値または右辺値にバインドできないという規則の適用に厳格ではありませんでした。C++ コンパイラは、デフォルトでは無効なコードを受け入れます。古いコンパイラの動作に復元するには、オプション -features=rvalueref を使用します。

[no%]rtti

実行時の型識別 (RTTI) を許可します。

[no%]split_init

ローカルではない静的オブジェクトの初期化子を個々の関数に配置します。-features=no%split_init を使用した場合、コンパイラは、すべての初期化子を 1 つの関数内に配置します。-features=no%split_init を使用すると、コンパイル時間が可能なかぎり費やされて、コードサイズが最小限に抑えられます。デフォルトは split_init です。

[no%]strictdestorder

静的ストレージの期間でのオブジェクトの破棄の順序に関連した C++ 標準で指定されている要件に従います。デフォルトは strictdestrorder です。

[no%]tmplife

ANSI/ISO C++ 標準で定義されている、完全な式の最後にある式によって作成された一時オブジェクトをクリーンアップします。(-features=no%tmplife が有効である場合、ほとんどの一時オブジェクトは、そのブロックの最後にクリーンアップされます)。デフォルトは tmplife です。

[no%]tmplrefstatic

関数テンプレートからの依存静的関数または静的関数テンプレートの参照を許可します。デフォルトは、標準準拠の no%tmplrefstatic です。

[no%]transitions

標準 C++ で問題があるため、プログラムが予想とは異なった方法で動作したり、将来のコンパイラによって拒否されたりする原因となる可能性のある ARM 言語構造を許可します。-features=no%transitions を使用すると、コンパイラはエラーメッセージの代わりに、これらの構造に関する警告を発行します。

相互の関連性:

このオプションは、置き換えられる代わりに蓄積されます。

次の値の使用は、標準ライブラリやヘッダーと互換性がありません。

no%bool
no%except
no%mutable

警告:

-features=%all または -features=%none を使用しないでください。これらのサブオプションは非推奨であり、将来のリリースで削除される可能性があります。結果は予測できない場合があります。

-features=tmplife を使用すると、プログラムの動作が変化する可能性があります。-features=tmplife オプションを指定してもしなくてもプログラムが機能するかどうかのテストは、そのプログラムの移植性をテストする 1 つの方法になります。

-filt[=filter[,filter...]]

CC が通常はリンカーのエラーメッセージに適用するフィルタを抑制します。

サブオプションに接頭辞 no% を適用すると、そのサブオプションが無効になります。

filter は、次の値のいずれかである必要があります。

[no%]errors: C++ のリンカーエラーメッセージの説明を表示します。説明の抑止は、リンカーの診断を別のツールに直接提供している場合に便利です。
[no%]names: C++ で符号化されたリンカー名を復号化します。
[no%]returns: 関数の戻り型を復号化します。この復号化を抑制すると、関数名をより迅速に識別するために役立ちますが、共変戻り値の場合は、戻り値の型のみが異なる関数があることに注意してください。
[no%]stdlib: リンカーとコンパイラの両方のエラーメッセージで、標準ライブラリの名前を簡素化します。この結果、標準ライブラリ関数の名前を認識しやすくなります。
%all: -filt=errors,names,returns,stdlib と同等です。これはデフォルトの動作です。
%none: -filt=no%errors,no%names,no%returns,no%stdlib と同等です。

デフォルト:

-filt オプションを指定しない場合、または -filt を値なしで指定した場合、コンパイラでは -filt=errors,names,returns,stdlib が使用されます。

相互の関連性:

[no%]returns は、no%names と組み合わせた場合、影響はありません。つまり、次のオプションは同等です。

-filt=no%names
-filt=no%names,no%returns
-filt=no%names,returns

関連項目:

最適化が精度にどのように影響する場合があるかを詳細に説明するために Rajat Garg と Ilya Sharapov によって執筆された『Techniques for Optimizing Applications: High Performance Computing』。OTN Oracle Solaris Studio の Web サイト (oracle.com/technetwork/server-storage/solarisstudio/) のパフォーマンスおよび精度に関する記事も参照してください

-fstore

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

このオプションを指定すると、コンパイラは、浮動小数点の式または関数の値をレジスタ内に置いたままにするのではなく、その式または関数が変数に割り当てられたときか、またはその式がより短い浮動小数点型にキャストされたときに代入式の左辺の型に変換します。

このオプションを解除するには、オプション -nofstore を使用してください。

警告:

丸めや切り捨てのために、結果がレジスタの値から生成された値とは異なることがあります。

-ftrap=a[,a...]

This option the IEEE 745 trapping mode in effect at startup but does not install a SIGFPE handler. You can use ieee_handler(3M) or fex_set_handling(3M) to simultaneously enable traps and install a SIGFPE handler. If you specify more than one value, the list is processed sequentially from left to right.

a は、次の値のいずれかである必要があります。

[no%]division: ゼロによる除算をトラップします。
[no%]inexact: 正確でない結果をトラップします。
[no%]invalid: 無効な演算をトラップします。
[no%]overflow: オーバーフローをトラップします。
[no%]underflow: アンダーフローをトラップします。
%all: 前述のすべてをトラップします。
%none: 前述のどれもトラップしません。
common: 無効、ゼロ除算、オーバーフローをトラップします。

[no%] 接頭辞は、%all または common の値の意味を変更する目的でのみ使用されるため、例に示すように、これらのいずれかの値とともに使用する必要があることに注意してください。[no%] 接頭辞は、単独で特定のトラップを明示的に無効にするものではありません。

デフォルト:

-ftrap を指定しない場合、コンパイラは -ftrap=%none であると見なします。

例: -ftrap=%all,no%inexact は、inexact を除くすべてのトラップを設定することを示します。

警告:

あるルーチンを -ftrap でコンパイルする場合は、プログラムのすべてのルーチンを同じ -ftrap オプションでコンパイルしてください。そうしないと、予期しない結果になることがあります。

-ftrap=inexact トラップでは、浮動小数点の値が正確に表現できないとトラップが発生するため、使用には注意してください。たとえば、次の文ではこの条件が発生する場合があります。

x = 1.0 / 3.0;

-G

実行可能ファイルの代わりに動的共有ライブラリを構築します。ld(1) のマニュアルページおよび『C++ ユーザーズガイド』を参照してください。コマンド行で指定されたソースファイルはすべて、デフォルトでは -xcode=pic13 でコンパイルされます。

テンプレートが含まれていて、-instances=extern オプションを使用してコンパイルされたファイルから共有ライブラリを構築すると、.o ファイルにより参照されているテンプレートインスタンスがすべてテンプレートキャッシュから自動的に含められます。

コンパイル時とリンク時の両方に指定する必要があるコンパイラオプションと -G オプションを組み合わせて共有ライブラリを作成した場合は、生成された共有オブジェクトとのリンクでも、必ず同じオプションを指定してください。

-xcode の説明に記述されているように、共有オブジェクトを作成するときは、64 ビット SPARC アーキテクチャー用にコンパイルされるすべてのオブジェクトファイルもまた、明示的な -xcode 値を使用してコンパイルする必要があります。

-c が指定されていない場合は、次のオプションが ld に渡されます。-dy、-G、および -R。

共有ライブラリを構築するために ld -G を使用しないでください。CC -G を使用してください。こうすると、CCドライバによって C++ に必要ないくつかのオプションがldに自動的に渡されます。

-G オプションを使用すると、コンパイラはデフォルトの -l オプションを ld に渡しません。共有ライブラリが別の共有ライブラリに対する依存関係を持つようにするには、コマンド行で必要な -l または -library オプションを渡す必要があります。たとえば、共有ライブラリが libCrun に依存するようにするには、コマンド行で -lCrun または -library=Crun を渡す必要があります。

-g

-g[n] を参照してください。

-g[n]

コンパイラとリンカーの両方に、dbx(1) でのデバッグ、または analyzer(1) でのパフォーマンス分析のためのファイルまたはプログラムを準備するよう指示します。タスクには次のものが含まれます。

n に応じて、オブジェクトファイルと実行可能ファイルのシンボルテーブル内により詳細な情報を生成します。
デバッガがその一部の機能を実装するために呼び出すことのできる、いくつかの「ヘルパー関数」を生成します。
最適化レベルが指定されていない場合は、関数のインライン生成を無効にします。つまり、最適化レベルも同時に指定されていない場合は、このオプションを使用すると +d オプションが指定されていることになります。-O または -xO レベルが指定された -g では、インライン化は無効になりません。
特定のレベルの最適化を無効にする。

このオプションを -xO[level] (または、-O などの同等のオプション) とともに使用した場合は、インライン化および限られたデバッグ情報が得られます。詳細は、-xO のエントリを参照してください。

-gO を指定し、かつ最適化レベルが -xO3 以下である場合、コンパイラは、最大限のシンボリック情報をほぼ完全な最適化とともに提供します。末尾呼び出しの最適化は無効になります。

このオプションを使用し、かつ最適化レベルが -xO4 以上である場合、コンパイラは、最大限のシンボリック情報を完全な最適化とともに提供します。

このオプションを指定した場合は、-O または -xO も同時に指定されていないかぎり、+d オプションが自動的に指定されます。

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

-g オプションで生成される解説メッセージは、プログラムのコンパイル時にコンパイラが実行した最適化と変換について説明します。ソースコードでインタリーブされたメッセージを表示するには、er_src(1) コマンドを使用します。

プログラムを個別の手順でコンパイルしてリンクする場合、—g オプションを一方の手順に含め、もう一方の手順から除外してもプログラムの正確さには影響しませんが、プログラムのデバッグ機能に影響します。-g (または -g0) でコンパイルされていないが、-g (または -g0) でリンクされたモジュールはすべて、デバッグのために適切に準備されません。関数 main を含むモジュールの -g オプション (または -g0 オプション) でのコンパイルは通常、デバッグのために必要であることに注意してください。

-g は、ほかのさまざまな、よりプリミティブなオプションに展開されるマクロとして実装されます。展開の詳細については、-xdebuginfo を参照してください。

値:

-g: 標準のデバッグ情報を生成します。
-gnone: デバッグ情報は生成されません。これはデフォルト値です。
-g1: 事後デバッグの際に重要と思われるファイル、行番号、および簡単なパラメータ情報を生成します。
-g2: -g と同じです。
-g3: 追加のデバッグ情報 (現在はマクロの定義情報のみで構成されます) を生成します。この追加情報により、-g のみを使用したコンパイルと比較して、結果の .o および実行可能ファイルのデバッグ情報のサイズが増える可能性があります。
-g0: コンパイラに、デバッグのためのファイルまたはプログラムを準備するが、インライン化を無効にしないよう指示します。このオプションは、+d が無効になり、dbx がインライン化された関数にステップインできない点を除き、-g と同じです。

関連項目:

詳細は、-xs と +d の説明、および ld(1) のマニュアルページを参照してください。

-H

標準エラー出力 (stderr) で、現在のコンパイルに含まれている各 #include ファイルのパス名を 1 行に 1 つずつ出力します。

-h[ ]lname

名前 lname を、生成された共有動的ライブラリに割り当てます。

これは ld に渡されるローダーオプションです。一般に、-h のあとの名前は、-o のあとの名前とまったくと同じにするべきです。-h と lname の間のスペースはオプションです。

コンパイルの時ローダーは、作成対象の共有動的ライブラリに、指定の名前を割り当てます。この名前は、ライブラリのイントリンシック名として、ライブラリファイルに記録されます。-hlname オプションがない場合、組み込み名はライブラリファイル内に記録されません。

どの実行可能ファイルにも、必要な共有ライブラリファイルのリストがあります。実行時のリンカーは、ライブラリを実行可能ファイルにリンクするとき、ライブラリのイントリンシック名をこの共有ライブラリファイルのリストの中にコピーします。共有ライブラリに組み込み名がないと、リンカーは代わりにその共有ライブラリファイルのパス名を使用します。次のコマンド行は 1 つの例です。

% CC -G -o libx.so.1 -h libx.so.1 a.o b.o c.o

相互の関連性:

このオプションは、置き換えられる代わりに蓄積されます。

-help

このオプションは非推奨であり、将来のリリースで削除される予定です。代わりに -xhelp=flags を使用してください。

-Ipathname

相対ファイル名 (スラッシュ以外の文字で始まるファイル名) を持つファイルを検索するためのディレクトリリストに、pathname (パス名) を追加します。

コンパイラは、引用符でインクルードしたファイル (形式は #include "foo.h") を次の順序で検索します。

ソースが存在するディレクトリ
-I オプションで指定されているディレクトリ内 (存在する場合)
コンパイラで提供される C++ ヘッダーファイル、ANSI C ヘッダーファイル、および特殊目的ファイルの include ディレクトリ内
usrinclude 内

コンパイラは、山括弧でインクルードしたファイル (形式は #include <foo.h>) を次の順序で検索します。

-I オプションで指定されているディレクトリ内 (存在する場合)
コンパイラで提供される C++ ヘッダーファイル、ANSI C ヘッダーファイル、および特殊目的ファイルの include ディレクトリ内
usrinclude 内

注: スペルが標準ヘッダーファイルの名前に一致している場合は、C++ のユーザーズガイドの標準ヘッダーの実装に関するセクションも参照してください。

相互の関連性:

このオプションは、置き換えられる代わりに蓄積されます。

-I- オプションを使用すると、デフォルトの検索規則をオーバーライドできます。

-library=no%Cstd が指定されている場合、コンパイラで提供される Cstd ヘッダーファイルは検索されません。

注: -ptipath が使用されていない場合、コンパイラは -Ipathname 内でテンプレートファイルを探します。-ptipath の代わりに -Ipathname を使用することをお勧めします。

警告:

コンパイラがインストールされている位置の /usr/include、/lib、/usr/lib を検索ディレクトリに指定しないでください。

-I-

インクルードファイルの検索規則を次のように変更します。

#include "foo.h" という形式のインクルードファイルの場合は、ディレクトリを次の順序で検索します。
1. -I オプション (-I- の前とあとの両方) で指定されたディレクトリ。
2. コンパイラで提供される C++ ヘッダーファイル、ANSI C ヘッダーファイル、および特殊な目的のファイルのディレクトリ。
3. /usr/include ディレクトリ。
#include <foo.h> 形式のインクルードファイルの場合、次の順序でディレクトリを検索します。
1. -I- のあとにある -I オプションで指定されているディレクトリ。
2. コンパイラで提供される C++ ヘッダーファイル、ANSI C ヘッダーファイル、および特殊な目的のファイルのディレクトリ。
3. /usr/include ディレクトリ。

警告:

コンパイラがインストールされている位置の /usr/include、/lib、/usr/lib を検索ディレクトリに指定しないでください。

コマンド行の最初の -I- だけが、説明した動作を引き起こします。

-i

リンカー ld(1) に、LD_LIBRARY_PATH または LD_LIBRARY_PATH_64 の設定をすべて無視するよう指示します。

-include filename

このオプションを指定すると、コンパイラは filename を、主要なソースファイルの 1 行目に記述されているかのように #include プリプロセッサ指令として処理します。

コンパイラが filename を検索する最初のディレクトリは現在の作業ディレクトリであり、ファイルが明示的にインクルードされている場合のようにメインのソースファイルが存在するディレクトリになるわけではありません。コンパイラが現在の作業ディレクトリで filename を見つけられない場合は、通常のディレクトリパスが検索されます。複数の -include オプションを指定する場合は、コマンド行で表示された順にファイルがインクルードされます。

-inline

このオプションは非推奨であり、将来のリリースで削除される予定です。代わりに -xinline を使用してください。

-instances=a

テンプレートインスタンスの位置とリンケージを制御します。次の表に、a の値の意味を示します。

extern

必要なすべてのインスタンスをテンプレートリポジトリの comdat セクション内に配置し、それらに対してグローバルリンケージを行います。リポジトリのインスタンスが古い場合は、再びインスタンス化されます。

注: コンパイルとリンクを別々に行うとき、コンパイル処理で -instance=extern を指定した場合には、リンク処理でも -instance=extern を指定する必要があります。

explicit

明示的にインスタンス化されたインスタンスを現在のオブジェクトファイルの comdat セクション内に配置し、それらに対してグローバルリンケージを行います。必要なインスタンスがほかにあっても生成しません。

global

必要なすべてのインスタンスを現在のオブジェクトファイルの comdat セクション内に配置し、それらに対してグローバルリンケージを行います。

semiexplicit

明示的にインスタンス化されたインスタンスおよび明示的なインスタンスが必要とするすべてのインスタンスを現在のオブジェクトファイルの comdat セクション内に配置し、それらに対してグローバルリンケージを行います。

static

-instances=static は非推奨です。現在では -instances=global によって static のすべての利点が得られ、欠点はなくなっているため、-instances=static を使用する理由はなくなりました。このオプションは、このバージョンのコンパイラには存在しない、旧リリースのコンパイラにあった問題を克服するために用意されていました。必要なすべてのインスタンスを現在のオブジェクトファイルに置き、それらに対して静的リンケージを行います。

デフォルト:

instances が指定されていない場合は、-instances=global であると見なされます。

警告:

static や semiexplicit の値では、無効な結果が生成されることがあります。詳細は、『C++ ユーザーズガイド』を参照してください。

-instlib=file

このオプションは、ライブラリ (静的または共有) や現在のオブジェクト内で複製されるテンプレートインスタンスの生成を抑制するために使用します。一般に、プログラムがライブラリと多数のインスタンスを共有する場合は、-instlib=file を試してみて、コンパイル時間が改善されるかどうかを確認してください。

値:

現在のコンパイルで生成される可能性のあるテンプレートインスタンスを含むライブラリを指定するには、file 引数を使用します。ファイル名引数にはスラッシュ文字「/」を含める必要があります。現在のディレクトリに相対的なパスの場合は、ドットスラッシュ「./」を使用します。

デフォルト:

-instlib=file オプションにはデフォルト値がなく、指定する場合にのみ使用されます。このオプションは複数回指定でき、指定内容は追加されていきます。

例:

libfoo.a および libbar.so ライブラリによって、ソースファイル a.cc と共有される多数のテンプレートインスタンスがインスタンス化されるとします。-instlib=file を追加し、ライブラリを指定すると、冗長性が回避されるためコンパイル時間の短縮に役立ちます。

example% CC -c -instlib=./libfoo.a -instlib=./libbar.so a.cc

相互の関連性:

-g を使ってコンパイルするとき、-instlib=file で指定したライブラリが -g でコンパイルされていない場合には、テンプレートインスタンスがデバッグ不能となります。この問題の対策としては、-g を指定するときに -instlib=file を使用しないようにします。

file を見つけるために -L パスは検索されません。

警告:

-instlib によってライブラリを指定する場合には、そのライブラリとのリンクを行う必要があります。

関連項目:

-template、-instances、-pti

-KPIC

(SPARC) (廃止) 代わりに -xcode=pic32 を使用してください。

(x86) x86 アーキテクチャー上の -Kpic と同じです。

-Kpic

(SPARC) (廃止) 代わりに -xcode=pic13 を使用してください。

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

-keeptmp

コンパイル中に作成された一時ファイルを保持します。このオプションは、-verbose=diags とともに、デバッグに役立ちます。

-Lpath

ライブラリ検索パスに path を追加します。

このオプションは ld に渡されます。リンカーは、コンパイラで提供されるディレクトリを検索する前に、path で指定されたディレクトリを検索します。

相互の関連性:

このオプションは、置き換えられる代わりに蓄積されます。

警告:

/usr/include、lib、/usr/lib、またはコンパイラのインストール領域を検索ディレクトリとして指定しないでください。

-llib

リンカーの検索ライブラリのリストにライブラリ liblib.a または liblib.so を追加します。

このオプションは ld に渡されます。通常のライブラリには、liblib.a や liblib.so などの名前が付いており、この lib と .a または .so の部分が必要です。このオプションでは、lib の部分を指定できます。1 つのコマンド行に必要な数だけのライブラリを配置します。これらのライブラリは、-Lpath で指定された順序で検索されます。

このオプションはオブジェクトファイル名のあとに使用してください。

相互の関連性:

このオプションは、置き換えられる代わりに蓄積されます。

警告:

マルチスレッドアプリケーションを構築するか、またはマルチスレッド化されたライブラリにアプリケーションをリンクする場合は、そのアプリケーションを直接 -lthread でリンクするのではなく、プログラムを -mt オプションでコンパイルおよびリンクする必要があります (-mt を参照)。

-libmieee

このオプションは非推奨であり、将来のリリースで削除される予定です。代わりに -xlibmieee を使用してください。

-libmil

このオプションは非推奨であり、将来のリリースで削除される予定です。代わりに -xlibmil を使用してください。

-library=lib[,lib...]

指定された CC で提供されるライブラリをコンパイルとリンクに組み込みます。

CC で提供されるライブラリを指定するために -library オプションが使用されている場合は、適切な -I パスがコンパイル中に設定され、適切な -L、-Y、-P、-R の各パスと -l オプションがリンク中に設定されます。

値:

サブオプションに接頭辞 no% を適用すると、そのサブオプションが無効になります。

次の表に、lib の値の意味を示します。

[no%]f77: 非推奨。使用しないでください。-xlang=f77 を使用してください。
[no%]f90: 非推奨。使用しないでください。-xlang=f90 を使用してください。
[no%]f95: 非推奨。使用しないでください。-xlang=f95 を使用してください。
[no%]interval: 非推奨。使用しないでください。-xia を使用してください。
[no%]iostream: 古い iostream ライブラリ libiostream を使用します。
[no%]Cstd: C++ 標準ライブラリ libCstd を使用し、コンパイラで提供される C++ 標準ライブラリヘッダーファイルをインクルードします。
[no%]stlport4: デフォルトの libCstd の代わりに、標準ライブラリの STLport 実装を使用します。-library=stlport4 でコンパイルされたコードは、デフォルトの -library=Cstd またはオプションの -library=stdcxx4 でコンパイルされたコードと同じプログラムでは使用できません。
[no%]stlport4_dbg: STLport のデバッグ可能なライブラリを使用します。
[no%]stdcxx4: デフォルトの libCstd の代わりに、Oracle Solaris の一部としてインストールされた Apache stdcxx バージョン 4 ライブラリを使用します。このオプションにより、-mt オプションも暗黙的に設定されます。stdcxx ライブラリには、マルチスレッドモードが必要です。このオプションは、コンパイルのたびに、およびアプリケーション全体のリンクコマンドで一貫して使用する必要があります。-library=stdcxx4 を使用してコンパイルされたコードは、デフォルトの -library=Cstd または省略可能な -library=stlport4 を使用してコンパイルされたコードと同じプログラムでは使用できません。
[no%]Crun: C++ 実行時ライブラリ libCrun を使用します。
[no%]gc: ガベージコレクション libgc を使用します。
[no%]sunperf: Sun Performance Library を使用します。
%none: libCrun を除き、C++ ライブラリを使用しません。

-library=libC は許可されないことに注意してください。

デフォルト:

libCstd ライブラリは、-library=%none、-library=no%Cstd、-library=stdcxx4、または -library=stlport4 を使用して明確に除外されないかぎり常に含まれます。

また、libm および libc ライブラリは、-library=%none を指定した場合でも常に含まれます。libCrun は常に含まれます。

例:

どの C++ ライブラリ (libCrun を除く) も使用せずにリンクするには、次のコマンドを使用します。

example% CC -library=%none

libCstd と libiostream の両方を含める場合は、同じファイルにアクセスするプログラム内で iostream の古い形式と新しい形式 (cout と std::cout など) を使用しないように注意する必要があります。同じプログラム内に標準 iostream と従来の iostream が混在し、その両方のコードから同じファイルにアクセスすると、問題が発生する可能性があります。

相互の関連性:

-xnolib が指定されている場合、-library は無視されます。

-library でライブラリが指定されている場合は、適切な -I パスがコンパイル中に設定されます。適切な -L、-Y、-P、-R の各パスと -l オプションがリンク中に設定されます。

このオプションは、置き換えられる代わりに蓄積されます。

同じコマンド行では -library=stlport4、-library=stdcxx4、-library=Cstd のうちのいずれか 1 つを指定できます。

-library=sunperf と -xlic_lib=sunperf を同じコマンド行で使用することはできません。

区間演算ライブラリを使用する場合は、libCstd または libiostream のいずれかのライブラリを含める必要があります。

指定したライブラリは、システムサポートライブラリよりも前にリンクされます。

警告:

いわゆる「従来の」iostream は、1998 C++ 標準で置き換えられた iostream の 1986 オリジナルバージョンです。これは、-library=iostream オプションを使用して選択されます。「従来の」iostream のどの 2 つの実装も同じではないため、廃止されている場合を除き、それを使用するコードには移植性がありません。このライブラリは将来の Oracle Solaris Studio リリースで中止される予定であることに注意してください。

STLport または Oracle Solaris Studio C++ ライブラリのどの構成マクロも再定義または変更しないでください。これらのライブラリは、C++ コンパイラと連携するような方法で構成および構築されています。構成マクロを変更すると、プログラムがコンパイルまたはリンクされなかったり、正しく動作しなくなったりします。

コンパイルとリンクを別の手順で行う場合は、コンパイルコマンドで指定される一連の -library オプションをリンクコマンドでも指定する必要があります。

これらのライブラリは安定したものではなく、リリースによって変わることがあります。

関連項目:

-I、-l、-R、-staticlib、-xia、-xlang、-xnolib、『C++ Interval Arithmetic Programming Reference』、『C++ Standard Reference Library』

-m32|-m64

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

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

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

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

大量の静的データを持つアプリケーションを -m64 を使用してコンパイルするときは、-xmodel=medium も必要になることがあります。一部の Linux プラットフォームは、ミディアムモデルをサポートしていません。

-m32|-m64 を指定してコンパイルしたモジュールは、-m32|-m64 を指定してリンクする必要があります。コンパイル時とリンク時の両方で指定する必要のあるコンパイラオプションの完全なリストについては、『C++ ユーザーズガイド』を参照してください。

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

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

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

-mc

オブジェクトファイルの.commentセクションから、重複する文字列を削除します。-mc オプションを使用すると、mcs -c コマンドが呼び出されます。(mcs(1) のマニュアルページを参照)。

-misalign

(SPARC) (廃止) このオプションは使用すべきではありません。代わりに -xmemalign=2i オプションを使ってください。

-mr[,string]

オブジェクトファイルの .comment セクションからすべての文字列を削除し、string が指定されている場合は、そのセクション内に string を配置します。文字列に空白が含まれている場合は、文字列を引用符で囲む必要があります。このオプションを使用すると、mcs -d [- string] コマンドが呼び出されます。

相互の関連性:

このオプションは、-S が指定されている場合は無効です。

-mt[={yes|no}]

このオプションを使用して、Oracle Solaris スレッドまたは POSIX スレッド API を使用しているマルチスレッド化コードをコンパイルおよびリンクします。-mt=yes オプションにより、ライブラリが適切な順序でリンクされることが保証されます。

このオプションは -D_REENTRANT をプリプロセッサに渡します。

Oracle Solaris スレッドを使用するには、thread.h ヘッダーファイルをインクルードし、-mt=yes オプション付きでコンパイルします。Oracle Solaris プラットフォームで POSIX スレッドを使用するには、pthread.h ヘッダーファイルをインクルードし、-mt=yes オプション付きでコンパイルします。

Linux プラットフォーム上では、POSIX スレッドの API のみが使用できます (Linux プラットフォームには libthread はありません)。したがって、Linux プラットフォームで -mt=yes を使用すると、—lthread の代わりに —lpthread が追加されます。Linux プラットフォームで POSIX スレッドを使用するには、—mt を使用してコンパイルします。

-G を使用してコンパイルする場合は、-mt=yes を指定しても、-lthread と -lpthread のどちらも自動的には含められません。共有ライブラリを構築する場合は、これらのライブラリを明示的にリストする必要があります。

(OpenMP 共有メモリー並列化 API を使用するための) —xopenmp オプションには、-mt=yes が自動的に含まれます。

-mt=yes を指定してコンパイルを実行し、リンクを個別の手順でリンクする場合は、コンパイル手順と同様にリンク手順でも -mt=yes オプションを使用する必要があります。-mt=yes を使用して 1 つの変換ユニットをコンパイルおよびリンクする場合は、-mt=yes を指定してプログラムのすべてのユニットをコンパイルおよびリンクする必要があります。

-mt=yes は、コンパイラのデフォルトの動作です。この動作が望ましくない場合は、オプション -mt=no を使用してください。

オプション -mt は、-mt=yes と同じです。

関連項目:

analyzer(1), ld(1)

-xglobalize[={yes|no}]

ファイルの静的変数のグローバル化を制御します (関数は制御しません)。

グローバル化は修正継続機能および内部手続きの最適化で必要となる手法であり、それによってファイルの静的シンボルがグローバルに拡張されます。同じ名前のシンボルを区別するために、名前に接頭辞が追加されます。

デフォルトは -xglobalize=no です。-xglobalize と指定することは -xglobalize=yes と指定することと同等です。

相互の関連性:

-xpatchpadding を参照してください。

-xipo もグローバル化を要求し、-xglobalize をオーバーライドします。

-xhelp=flags

各コンパイラフラグの簡単な説明を表示します。

-xhwcprof[={enable|disable}]

(SPARC) -xhwcprof オプションは、データ領域プロファイリングに対するコンパイラのサポートを有効にするために使用します。

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

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

コンパイルとリンクを別々に行う場合は、-xhwcprof をリンク時にも使用してください。将来 -xhwcprof に拡張する場合は、リンク時に -xhwcprof を使用する必要があります。

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

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

-xhwcprof を使用する場合は最適化を有効にし、デバッグのデータ形式を dwarf (-xdebugformat=dwarf) に設定しておく必要があります。これは、現在の Oracle Solaris Studio コンパイラのデフォルトです。同じコマンド行に -xhwcprof と -xdebugformat=stabs を指定することはできません。

-xhwcprof は -xdebuginfo を使用して必要最低限のデバッグ情報を自動的に有効にするため、-g は必要ありません。

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

-xhwcprof は、次のようにさまざまなよりプリミティブなオプションに展開されるマクロとして実装されます。

 
-xhwcprof
        -xdebuginfo=hwcprof,tagtype,line
-xhwcprof=enable
        -xdebuginfo=hwcprof,tagtype,line
-xhwcprof=disable
        -xdebuginfo=no%hwcprof,no%tagtype,no%line

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

example% CC -c -O -xhwcprof -g example.cc

ハードウェアカウンタによるプロファイリングについての詳細は、『パフォーマンスアナライザ』のマニュアルを参照してください。

-xia

適切な区間演算ライブラリをリンクし、適した浮動小数点環境を設定します。

-xia オプションは、-fsimple=0 -ftrap=%none -fns=no -library=interval に展開されるマクロです。

相互の関連性:

区間演算ライブラリを使用するには、<suninterval.h> をインクルードします。

区間演算ライブラリを使用する場合は、Cstd と iostreams のいずれかのライブラリを含める必要があります。これらのライブラリを含める方法については、-library を参照してください。

警告:

区間を使用し、-fsimple、-ftrap、または -fns に異なる値を指定すると、プログラムが正しく動作しないことがあります。

C++ 区間演算は実験に基づくもので発展性があります。詳細は、リリースごとに変更される可能性があります。

x86 プラットフォームでは、32 ビットのコンパイルのために -xarch=sse2 を指定する必要があります。また、Linux プラットフォーム上では -xia を使用できません。

関連項目: -library、『C++ Interval Arithmetic Programming Reference』

-xinline[=func_spec[,func_spec...]]

オプティマイザが -xO3 以上でユーザー作成のどのルーチンをインライン化できるかを指定します。

値:

サブオプションに接頭辞 no% を適用すると、そのサブオプションが無効になります。

func_spec には、次のいずれかを指定できます。

%auto

最適化レベル -xO4 以上で自動インライン化を有効にします。この引数は、オプティマイザが選択した関数をインライン化できることをオプティマイザに知らせます。%auto を指定しない場合、コマンド行で明示的なインライン化が指定されているなら、通常、自動インライン化は無効になります。

-xinline=[no%]func_name...

func_name

オプティマイザに関数をインライン化するように強く要求します。関数が extern "C" として宣言されていない場合は、func_name の値を符号化する必要があります。実行可能ファイルに対して nm コマンドを使用すると、符号化された関数名を検索できます。extern "C" で宣言された関数の場合は、名前はコンパイラで符号化されません。

no%func_name

リスト上のルーチン名の前に no% を付けると、そのルーチンのインライン化が禁止されます。func_name の符号化された名前に関する規則は、no%func_name にも適用されます。

-xipo[=1|2] を使用していないかぎり、コンパイル中のファイル内のルーチンのみがインライン化の対象と見なされます。オプティマイザでは、どのルーチンがインライン化に適しているかを判断します。

デフォルト:

-xinline オプションが指定されていない場合、コンパイラは -xinline=%auto であると見なします。-xinline= が引数なしで指定されている場合は、最適化レベルには関係なく、どの関数もインライン化されません。

例:

自動インライン化を有効にする一方で、int foo() が宣言されている関数のインライン化を無効にするには、次のコマンドを使用します。

example% CC -xO5 -xinline=%auto,no%__1cDfoo6F_i_ -c a.cc

int foo() として宣言されている関数のインライン化を強くリクエストし、その他のすべての関数をインライン化の候補にするには、次のコマンドを使用します。

example% CC -xO5 -xinline=%auto, __1cDfoo6F_i_ -c a.cc

int foo() として宣言されている関数のインライン化を強くリクエストし、その他のどの関数のインライン化も許可しないようにするには、次のコマンドを使用します。

example% CC -xO5 -xinline=__1cDfoo6F_i_ -c a.cc

相互の関連性:

-xinline オプションは、-xO3 未満の最適化レベルには影響を与えません。-xO4 以上では、オプティマイザは -xinline オプションが指定されていなくても、どの関数をインライン化すべきかを判定します。-xO4 以上ではまた、コンパイラは、どの関数をインライン化すればパフォーマンスが向上するかの判定も試みます。

ルーチンは、次のいずれかの条件が当てはまる場合はインライン化されます。

最適化が -xO3 以上に設定されている
インライン化に効果があって安全
関数がコンパイル中のファイル内にあるか、または関数が -xipo[=1|2] でコンパイルされたファイル内にある。

警告:

-xinline で関数を強制的にインライン化した場合、実際にはパフォーマンスが低下する可能性があります。

プラグマ

次の #pragmas はコンパイルシステムに認識されます。

#pragma align
#pragma does_not_read_global_data
#pragma does_not_return
#pragma does_not_write_global_data
#pragma dumpmacros
#pragma end_dumpmacros
#pragma fini
#pragma hdrstop
#pragma ident
#pragma init
#pragma must_have_frame
#pragma pack
#pragma rarely_called
#pragma returns_new_memory
#pragma unknown_control_flow
#pragma weak

#pragma does_not_read_global_data
#pragma does_not_write_global_data
#pragma no_side_effect

SPARC のみ:

#pragma no_side_effect

これらのプラグマの詳細は、『C++ ユーザーズガイド』を参照してください。

環境変数

SUN_PROFDATA=profdir

設定すると、-xprofile=collect を指定してコンパイルされたプログラムから収集されたプロファイルデータが、プログラムが実行された時点での現在の作業ディレクトリ内の profdir という名前のディレクトリに格納されます。コンパイル時に、オプションの引数 :profdir を -xprofile=collect[:profdir] に指定した場合、SUN_PROFDATA は無効になります。

SUN_PROFDATA_DIR=dirname

設定すると、-xprofile=collect を指定してコンパイルしたプログラムから収集されたプロファイルデータが、UNIX のディレクトリ名が dirname であるディレクトリに格納されます。dirname が絶対パスでない場合は、プログラムが実行された時点での現在の作業用ディレクトリの相対パスであると解釈されます。コンパイル時に、オプションの引数 :profdir を -xprofile=collect[:profdir] に指定した場合、SUN_PROFDATA_DIR は無効になります。

SUN_PROFDATA_REPLACE={objfile,program,all}

SUN_PROFDATA_REPLACE は、オブジェクトファイルの変更されたバージョンが実行時に検出されたときにリセットされるプロファイルデータのスコープを示します。SUN_PROFDATA_REPLACE は、指定されたプログラムの範囲のユニット内にあるプロファイルされたプログラムとプロファイルデータの整合性を保つために使用します。

SUN_PROFDATA_REPLACE の値とその意味を次に示します。

objfile: 変更されたオブジェクトファイルのプロファイルデータをリセットします。
program: 変更されたオブジェクトファイルが含まれているプログラムのすべてのオブジェクトファイルのプロファイルデータをリセットします。
all: オブジェクトファイルが変更された場合、プロファイルディレクトリのすべてのコンテンツをリセットします。

SUN_PROFDATA_REPLACE のデフォルト設定は SUN_PROFDATA_REPLACE=objfile です。

例:

 
% setenv SUN_PROFDATA_REPLACE program (csh)
$ export SUN_PROFDATA_REPLACE=program (ksh)

この設定で、変更されたオブジェクトファイルが含まれているプログラムが実行されると、そのプログラムのすべてのオブジェクトファイルのプロファイルデータがリセットされます。関連するオプションには、-xOn および -xipo=n があります。

SUN_PROFDATA_ASYNC_INTERVAL=async_interval

非同期のプロファイル収集を有効にするには、この環境変数を設定します。非同期のプロファイル収集では、プロファイルデータは実行されているプロセスから一定の間隔 (秒単位で指定) で収集されます。

環境変数 LD_AUDIT、LD_AUDIT_32、または LD_AUDIT_64 のいずれかに /usr/lib/{,64}/libxprof_audit.so.1 が設定されていない場合、SUN_PROFDATA_ASYNC_INTERVAL は無効です。

非同期のプロファイル収集では、MT セーフの mmap ベースのメモリーアロケータ (UMEM_OPTIONS を backend=mmap に設定することによって mmap ベースの割り当てが指定されている libumem (3LIB) など) が必要となります。

例: 64 ビットのプロセスからの 1 分間隔の非同期のプロファイル収集を有効にするには、次の環境変数を指定します。

 
$ env LD_AUDIT_64=/usr/lib/64/libxprof_audit.so.1 \
SUN_PROFDATA_ASYNC_INTERVAL=60 UMEM_OPTIONS=backend=mmap \
64-bit-program [program-args]

SUN_PROFDATA_ASYNC_VERBOSE=verbose

ゼロ以外を設定すると、非同期コレクタから標準エラー出力に詳細なメッセージが出力されます。非同期のプロファイル収集が有効ではない場合、SUN_PROFDATA_ASYNC_VERBOSE は無効です。

SUN_PROFDATA_CLEANUP_AFTER_EXIT=[0|1]

1 を設定すると、プロセスが exit() を呼び出した時間とプロセスの終了が完了した時間の間に、プロファイラがデータ構造体をクリーンアップします。0 を設定すると、アプリケーションが exit() を呼び出す前に終了していなかったアプリケーションスレッドによるプロファイル収集への有害な干渉が防止されます。詳細は、exit(3C) を参照してください。デフォルト設定は SUN_PROFDATA_CLEANUP_AFTER_EXIT=0 です。

ファイル

file.a: 静的ライブラリ
file.C: 入力ファイル
file.cc: 入力ファイル
file.c++: 入力ファイル
file.cpp: 入力ファイル
file.cxx: 入力ファイル
file.o: オブジェクトファイル
file.so: 動的 (共有) ライブラリ
a.out: リンクされた出力
xprof_fini.o: -xprofile=collect を指定してコンパイルされたプログラムの初期化ハンドラおよびファイナライズハンドラ

注

特定の浮動小数点数学ライブラリルーチンは、errno 変数 (errno.h で定義されています) でエラーステータスを返します。コンパイラオプション -fast、-xbuiltin、-xlibmieee、-xlibmil、-xlibmopt を指定すると、コンパイラは浮動小数点関数の呼び出しを、errno 変数を設定しない同等の最適化されたコードに自由に置き換えることができます。さらに、-fast ではマクロ __MATHERR_ERRNO_DONTCARE が定義されるため、コンパイラは数学関数で errno を設定する必要がないと想定できます。結果として、errno の値または浮動小数点関数呼び出しのあとに発生した浮動小数点例外の値に依存するユーザーコードが、一貫性のない結果を生成する可能性があります。

この問題を回避する方法の 1 つとして、このようなコードを -fast などのオプションを使用してコンパイルしないようにします。

ただし、-fast の最適化が必要で、コードが浮動小数点ライブラリ呼び出しのあとに正しく設定される errno の値、または適切な浮動小数点例外が発生することに依存している場合は、次のオプションを使用してコンパイルしてください。

 
-xbuiltin=none -U__MATHERR_ERRNO_DONTCARE \
-xnolibmopt  -xnolibmil

これをコマンド行の -fast のあとに使用することで、コンパイラはそのようなライブラリコールを最適化しなくなり、数学関数への呼び出しで errno が正しく設定されるようになります。