cc - Oracle Solaris Studio 12.4 Man Pages

言語:

cc(1)

名前

cc - C コンパイラ

形式

cc   [-#] [-###] [-Aname[(tokens)]] [-ansi]
     [-B[static|dy- namic]] [-C] [-c] [-D] [-d[y|n]] [-dalign]
     [-E] [-errfmt[=[no%]error]] [-errhdr[=h]]
     [-erroff[=t[,t...]]] [-errshort[=i]] [-errtags=a]
     [-errwarn[=t[,t...]]] [-fast] [-fd] [-features=[a]]
     [-flags] [-flteval[={any|2}]] [-fma[={none|fused}]]
     [-fnonstd] [-fns=[no|yes]] [-fopenmp] [-fprecision=p]
     [-fround=r] [-fsimple[=n]] [-fsingle] [-fstore]
     [-ftrap[=t[,t...]]] [-G] [-g] [-g[n]] [-H] [-hname]
     [-I[-|dir]] [-i] [-include] [-KPIC] [-Kpic] [-keeptmp]
     [-Ldir] [-lname] [-library=sunperf] [-m32|-m64] [-mc]
     [-misalign] [-misalign2] [-mr[,string]] [-mt] [-native]
     [-nofstore] [-O] [-On] [-ofilename] [-P] [-p]
     [-pedantic{=[yes|no]}] [-preserve_argvalues[=int|none]]
     [-Qoption phase [,option...]] [-Q[y|n]] [-qp]
     [-Rdir[:dir...]] [-S] [-s] [-staticlib=[no%]sunperf]
     [-std=value] [-temp=path] [-traceback[=list]] [-Uname]
     [-V] [-v] [-Wc,arg] [-w] [-X[c|a|t|s]] [-Xlinker arg]
     [-xaddr32[={yes|no}]] [-xalias_level[=a]]
     [-xanalyze={code|no}] [-xannotate] [-xarch=a]
     [-xautopar] [-xbinopt={a}] [-xbuiltin[=a]] [-xCC]
     [-xc99[=o]] [-xcache=c] [-xchar[=o]]
     [-xchar_byte_order[=o]] [-xcheck=n] [-xchip=c]
     [-xcode=v] [-xcsi] [-xdebugfor- mat=[stabs|dwarf]]
     [-xdebuginfo=a[,a...]] [-xdepend[={yes|no}]]
     [-xdryrun] [-xdumpmacros[=v[,v...]]] [-xe] [-xF[=v]]
     [-xglobalize[={yes|no}]] [-xhelp=f]
     [-xhwcprof[={enable|disable}]] [-xinline=[v[,v...]]]
     [-xinline_param=a[,a[,a]...]] [-xinline_report[=n]]
     [-xinstrument=[no%]datarace] [-xipo[=n]]
     [-xipo_archive[=a]] [-xipo_build=[yes|no]]
     [-xivdep[=p]] [-xjobs={n|auto}]
     [-xkeep_unref[={[no%]funcs,[no%]vars}]]
     [-xkeepframe[=p]] [-xlang=language] [-xldscope=[v]]
     [-xlibmieee] [-xlibmil] [-xlibmopt] [-xlicinfo]
     [-xlinkopt[=level]] [-xloopinfo] [-xM] [-xM1] [-xMD]
     [-xMF] [-xMMD] [-xMerge] [-xmaxopt[=v]] [-xmemalign=ab]
     [-xmodel=[a]] [-xnolib] [-xnolibmil] [-xnolibmopt]
     [-xnorunpath] [-xOn] [-xopenmp[=i]] [-xP]
     [-xpagesize=n] [-xpagesize_heap=n] [-xpagesize_stack=n]
     [-xpatchpadding[={fix|patch|size}]] [-xpec] [-xpch=v]
     [-xpchstop] [-xpentium] [-xpg] [-xprefetch[=val[,val]]]
     [-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] [-xsfpconst] 
     [-xspace] [-xstrconst] [-xtarget=t] [-xtemp=path]
     [-xthreadvar[=o] [-xthroughput[={yes|no}]] [-xtime]
     [-xtransition] [-xtrigraphs[=[yes|no]]
     [-xunboundsym={yes|no}] [-xunroll=n]
     [-xustr={ascii_utf16_ushort|no}] [-xvector[=a]] [-xvis]
     [-xvpara] [-Yc,dir] [-YA,dir] [-YI,dir] [-YP,dir]
     [-YS,dir] [-Zll]

説明

Oracle Solaris Studio 12.4 C コンパイラバージョン 5.13。

このマニュアルページでは、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 の間でも数値結果が異なることがあります。

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

Oracle Solaris 10 リリース以降では、リンカーは実行時のハードウェアプラットフォームに対するバイナリオブジェクトの互換性を自動的に確認しています。

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

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

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

C コンパイラの概要

cc (1) のマニュアルページでは、現在の Oracle Solaris オペレーティングシステムでの SVID 準拠の ISO C のコンパイラオプションについて説明しています。C コンパイラは、デフォルトでは 2011 ISO/IEC C 規格の構文の一部を認識します。サポートされる機能の詳細は、『C ユーザーガイド』を参照してください。特定のバージョンの ISO/IEC C 標準にコンパイラを制限するには、-std フラグを使用します。

cc は C コンパイルシステムへのインタフェースです。コンパイル処理には、プリプロセッサ、コンパイラ、コードジェネレータ、オプティマイザ、アセンブラ、およびリンクエディタが組み込まれています。cc は、指定されたオプションを処理してから、さまざまなコンポーネントを適切な引数で実行します。cc は複数のタイプのファイルを引数として受け入れます。

接尾辞が .c であるファイルは C ソースファイルと見なされ、プロファイリング、アセンブル、およびリンク編集のために、前処理、コンパイル、最適化、および計測を行うことができます。プリプロセッサはマクロプロセッサとしても使用できますが、その出力が有効な C コンパイラへの入力として使用できる形式となっているため、マクロプロセッサとしての使用はお勧めできません。適切なオプションを指定した場合は、任意の受け渡しが完了したあとに、コンパイル処理を停止できます。

コンパイル処理でアセンブラが実行されると、.c 接尾辞が .o 接尾辞に置き換えられて、オブジェクトファイルが現在の作業ディレクトリに生成されます。ただし、単一の C ファイルをコンパイルしてすぐにリンク編集する場合、通常、.o ファイルは削除されます。

接尾辞が .s であるファイルはアセンブリのソースファイルと見なされ、アセンブルおよびリンク編集できます。

接尾辞が .S であるファイルはアセンブリのソースファイルと見なされ、アセンブルおよびリンク編集できます。そのようなファイルはプリプロセッサ (Oracle Solaris では /usr/ccs/lib/cpp) に渡され、そのあとアセンブラに渡されます。

接尾辞が .i であるファイルは前処理された C ソースファイルと見なされ、プロファイリング、アセンブル、およびリンク編集のために、コンパイル、最適化、および計測を行うことができます。ファイル名が .c、.s、.S、または .i で終わっていないファイルは、リンクエディタに渡され、デフォルトの名前が a.out である動的にリンクされた実行可能ファイルが生成されます。

ライブラリを見つけるために使用されるデフォルトのディレクトリを変更する場合は、オプション -Yc, dir を参照してください。dir はコロン区切りのパスのリストです。

デフォルトのライブラリ検索順序は、-### または -xdryrun オプションを使用し、ld 呼び出しの -Y オプションを検査することで、確認できます。

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

これらのデフォルトコンパイラオプションファイルは、ユーザーがすべてのコンパイルに適用される (ほかの方法で上書きされる場合を除く)、一連のデフォルトオプションを指定することを許可します。たとえば、ファイルによって、すべてのコンパイルのデフォルトを -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.c

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

 
cc -fast -xvpara -c -I/local/hdrs -L/local/libs -lliblocal \
       tst.c -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 と同じであることを意味します。

次のオプションが cc によって解釈されます。

-#

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

-###

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

-Aname[(tokens)]

#assert 前処理指令が実行されたかのように、name を述語として、指定された tokens に関連付けます。

 
Preassertions:system(unix)
          machine(sparc) (SPARC)
          machine(i386) (x86)
          cpu(sparc) (SPARC)
          cpu(i386) (x86)

これは -pedantic モードでは事前定義されません。

-A のあとにハイフン (-) だけが続く場合は、事前定義のマクロ (__ から始まるもの以外) および事前定義の表明はすべて無視されます。

-ansi

-std=c89 と同等です。

-B [static|dynamic]

リンクのためのライブラリのバインドを静的または動的のどちらにするかを指定し、ライブラリが非共有または共有のいずれであるかを示します。-lx オプションを指定すると、-B dynamic の場合、リンクエディタは libx.so という名前のファイル、libx.a という名前のファイルの順に探します。-B static の場合、リンクエディタは libx.a という名前のファイルのみを探します。このオプションは、コマンド行中で何度も指定して、切り替えることができます。

注: Oracle Solaris 64 ビットコンパイル環境では、多くのシステムライブラリ (libc など) は、動的ライブラリとしてのみ使用できます。このため、コマンド行の最後に -Bstatic を使用しないでください。

このオプションとその引数は ld に渡されます。

-C

C プリプロセッサが前処理指令の行以外のコメントを削除しないようにします。

-c

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

-Dname[(arg[,arg])] [=expansion]

マクロが #define 前処理指令によって定義されるのと同様に、オプションの引数を使用してマクロを定義します。=expansion が指定されていない場合は、コンパイラは =1 であると仮定します。

 
Predefinitions:unix
            sparc (SPARC)
            sun

これは -pedantic モードでは事前定義されません。

これらの事前定義は、すべてのモードで有効です。

__BUILTIN_VA_ARG_INCR
__SUNPRO_C=0x5120
__SVR4 (Oracle Solaris)
__SunOS_5_10 (Oracle Solaris)
__SunOS_5_11 (Oracle Solaris)
__amd64 (x86 -m64)
__gnu__linux (linux)
__i386 (x86)
__linux (linux)
__linux__ (linux)
__sparc (SPARC)
__sparcv8 (SPARC)
__sparcv9 (SPARC -m64)
__sun (Oracle Solaris)
__unix
__`uname -s`_`uname -r | tr . _`
__x86_64 (x86 -m64)
linux (x86, linux)

_Restrict キーワードが使用可能であることを示すために -pedantic が指定されていない場合に、いずれかの -std フラグ値を使用して次のものが事前定義されます。

__RESTRICT

コンパイラも、次のオブジェクトのようなマクロを事前定義して、プラグマが認識されることを示します。

 
__PRAGMA_REDEFINE_EXTNAME

-d [y|n]

動的リンクを許可または禁止します。

-dy はリンクエディタに動的リンクを指定します (デフォルト)。-dn はリンクエディタに静的リンクを指定します。

このオプションとその引数は ld に渡されます。

注: このオプションを動的ライブラリと組み合わせて使用すると、致命的なエラーが発生します。ほとんどのシステムライブラリは、動的ライブラリでのみ使用できます。

-dalign

(SPARC) (廃止) このオプションは使用すべきではありません。代わりに -xmemalign=8s を使用してください。廃止されたオプションおよびフラグの完全なリストについては、『C ユーザーガイド』を参照してください。x64/x86 プラットフォームでは無視されます。

-E

ソースファイルに対してプリプロセッサのみを実行し、その出力を stdout に送ります。プリプロセッサはコンパイラ内部に直接組み込まれます。/usr/ccs/lib/cpp が呼び出される -Xs モードの場合は除きます。プリプロセッサの行番号付け情報も含みます。-P オプションも参照してください。

-errfmt[=[no%]error]

このオプションは、エラーメッセージの先頭に文字列「error:」を付けて、警告メッセージと簡単に区別できるようにする場合に使用します。接頭辞は、-errwarn によってエラーに変換された警告にも追加されます。

error: すべてのエラーメッセージに接頭辞「error:」を追加します。
no%error: エラーメッセージに接頭辞「error:」を追加しません。

このオプションを使用しない場合は、-errfmt=no%errorに設定されます。-errfmt を指定したけれども値を指定しない場合、コンパイラはそれを -errfmt=error に指定します。

-errhdr [=h]

このオプションは、ヘッダーファイルからの警告を、次のフラグによって示されるヘッダーファイルのグループに限定するために使用します。

%all: 使用されているすべてのヘッダーファイルを検査します。
%none: ヘッダーファイルを検査しません。
%user: デフォルト。すべてのユーザーヘッダーファイルを検査します。/usr/include およびそのサブディレクトリ内のシステムインクルードファイルを検査しません。コンパイラによって提供されたシステムヘッダーファイルを検査しません。

-erroff[=t[,t...] ]

コンパイラの警告メッセージを抑止しますが、エラーメッセージは抑止しません。このオプションは、-errwarn でゼロ以外の終了ステータスを発生させるように指定されているかどうかにかかわらず、すべての警告メッセージに適用されます。

-erroff の値は、次の 1 つ以上の値で構成されるコンマ区切りのリストのメンバーです。

tag: tag のリストに指定されているメッセージを抑制します。-errtags=yes オプションで、メッセージのタグを表示できます。
no%tag: tag 以外のすべての警告メッセージの抑制を解除します。
%all: すべての警告メッセージを抑制します。
%none: すべてのメッセージの抑制を解除します。これはデフォルト値です。

指定順序によって実行内容が異なります。たとえば、「%all,no%tag」と指定すると、tag 以外のすべての警告メッセージを抑制します。

デフォルトは -erroff=%none で、-erroff を指定すると -erroff=%all と指定した場合と同様の結果が得られます。

-erroff オプションで無効にできるのは、C コンパイラのフロントエンドで -errtags オプションを指定したときにタグを表示する警告メッセージだけです。#pragma error_messages を使用すると、エラーメッセージの抑止を詳細に制御できます。

-errshort[=i]

このオプションは、型の不一致が見つかった際にコンパイラによって生成されるエラーメッセージに含める情報の詳細度を制御するために使用します。大きな集合体が関係する型の不一致がコンパイラで検出される場合にこのオプションを使用すると特に便利です。

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

short: エラーメッセージは、型の展開なしの簡易形式で出力されます。集合体のメンバー、関数の引数、戻り値の型は展開されません。
full: エラーメッセージは、完全な冗長形式で出力されます。不一致の型が完全に展開されます。
tags: エラーメッセージは、タグ名がある型の場合はそのタグ名付きで出力されます。タグ名がない場合は、型は展開された形式で出力されます。

-errshort を使用しない場合は、コンパイラでは -errshort=full が指定されます。-errshort を指定したけれども値を指定しない場合、コンパイラはこのオプションを -errshort=tags に設定します。

このオプションは累積されず、コマンド行で指定された最後の値を受け入れます。

-errtags=a

C コンパイラのフロントエンドで出力される警告メッセージのうち、-erroff オプションで無効にできる、または -errwarn オプションで致命的なエラーに変換できるメッセージのメッセージタグを表示します。C コンパイラのドライバおよび C のコンパイルシステムのほかのコンポーネントから出力されるメッセージにはエラータグが含まれないため、-erroff で無効にしたり、-errwarn で致命的なエラーに変換したりすることはできません。

a には yes または no を指定できます。デフォルトは -errtags=no です。-errtags を指定することは -errtags=yes を指定することと同等です。

-errwarn[=t[,t...] ]

指定した警告メッセージが生成された場合に、致命的ステータスで C コンパイラを終了する場合は、-errwarn オプションを使用します。

t には、次の 1 つまたは複数の項目をコンマで区切って指定します。tag、no%tag、%all、%none。このとき、順序が重要になります。たとえば、%all,no%tag と指定すると、tag 以外のすべての警告メッセージが生成された場合に、致命的ステータスを出力して C コンパイラを終了します。

C コンパイラで生成される警告メッセージは、コンパイラのエラーチェックの改善や機能追加に応じて、リリースごとに変更されます。-errwarn=%all を指定してエラーなしでコンパイルされるコードでも、コンパイラの次期リリースではエラーを出力してコンパイルされる可能性があります。

-errwarn オプションを使用して、障害ステータスで C コンパイラを終了するように指定できるのは、C コンパイラのフロントエンドで -errtags オプションを指定したときにタグを表示する警告メッセージだけです。

デフォルトは -errwarn=%none です。-errwarn のみを指定した場合は、-errwarn=%all と同等です。

-errwarn の値を次の表に示します。

tag: tag で指定されたメッセージが警告メッセージとして発行された場合に、cc を致命的ステータスで終了させます。tag で指定されたメッセージが発行されない場合は無効です。
no%tag: tag で指定されたメッセージが警告メッセージとしてのみ発行された場合に、cc が致命的ステータスを返して終了しないようにします。tag で指定されたメッセージが発行されない場合は無効です。このオプションは、以前にこのオプションと tag または %all で指定した警告メッセージを、警告メッセージとして発行された場合に cc を致命的ステータスで終了させないよう元に戻すために使用します。
%all: どの警告メッセージが発行された場合でも cc を致命的ステータスで終了させます。特定の警告メッセージをこの動作の対象から除外するには、%all のあとに no%tag を指定できます。
%none: どの警告メッセージでも、警告タグが発行された場合に cc が致命的ステータスで終了しないようにします。これはデフォルト値です。

-fast

このオプションはマクロであり、実行可能ファイルが実行時に最適なパフォーマンスになるようにチューニングするための出発点として効果的に使用できます。-fast の展開は、あるリリースのコンパイラと次のリリースで違いがある場合やターゲットプラットフォーム固有のオプションが含められている場合があります。-# オプションまたは -xdryrun を使用して -fast の展開を調べ、-fast の該当するオプションを使用して実行可能ファイルのチューニングを行なってください。

-fast の展開には、コンパイラが最適化された数学ルーチンのライブラリを使用できるようにする -xlibmopt オプションが含まれます。詳細は、このマニュアルページの -xlibmopt の説明を参照してください。

-fast オプションは errno の値に影響します。詳細は、このマニュアルページの最後の「注意事項」のセクションを参照してください。

-fast を指定してコンパイルしたモジュールは、-fast を指定してリンクする必要があります。『C ユーザーガイド』に、コンパイル時とリンク時の両方に指定する必要があるコンパイラオプションの完全な一覧が記載されています。

-fast オプションは、特にコンパイルするマシンとは異なるターゲットで実行するプログラムでは使用できません。そのような場合は、-fast のあとに適切な -xtarget オプションを指定します。例:

% cc -fast -xtarget=generic

SUID によって規定された例外処理に依存する C モジュールに対しては、-fast のあとに -xnolibmil -xbuiltin=%default を指定します。

% cc -fast -xnolibmil -xbuiltin=%default

-fast オプションは、コマンド行でのマクロ展開のように動作します。このため、-fast のあとに対象のオプションを指定することによって、展開されたオプションをオーバーライドできます。

-fast とほかのオプションを組み合わせた場合は、最後に指定したオプションが適用されます。

-fast では、次のオプションがオンになります。

-fma=fused (SPARC, x86)
-fns (SPARC, x86)
-fsimple=2 (SPARC, x86)
-fsingle (SPARC, x86)
-nofstore (x86)
-xalias_level=basic (SPARC, x86)
-xbuiltin=%all (SPARC, x86)
-xdepend (SPARC, x86)
-xlibmil (SPARC, x86)
-xlibmopt (SPARC, x86)
-xmemalign=8s (SPARC)
-xO5 (SPARC, x86)
-xregs=frameptr (x86)
-xtarget=native (SPARC, x86)

コンポーネントオプションフラグのこの選択内容は、各リリースのコンパイラで変更される可能性があります。-fast によって設定されるオプションの詳細は、『C ユーザーガイド』を参照してください。

実行中のシステムで -fast の展開を調べるには、次のコマンドを実行します。

cc -fast -xdryrun |& grep ###

注: 一部の最適化では、プログラムの動作が特定の動作になることを想定しています。プログラムがこれらの想定に適合していない場合は、アプリケーションがクラッシュしたり、誤った結果を生成したりすることがあります。プログラムが -fast 付きのコンパイルに適しているかどうかを判断するには、各オプションの説明を参照してください。

このオプションは、IEEE 規格例外処理に依存するプログラムには使用しないでください。数値結果が異なったり、プログラムが途中で終了したり、予想外のSIGFPEシグナルが発生する可能性があります。

x86 では、-fast オプションに -xregs=frameptr が含まれます。特に C、Fortran、および C++ の混合ソースコードをコンパイルする場合は、その詳細について、-xregs=frameptr の説明を参照してください。

-fd

K&R 形式の関数の宣言や定義について報告します。

-features=[a]

コンパイラの extern インライン関数の扱いは、ISO/IEC 9899:1999 C 標準に指定されている動作にデフォルトで準拠しています。-features=no%extinl 付きで新しいコードをコンパイルすると、extern インライン関数は、C および C++ コンパイラのバージョン 5.5 以降で提供されていたのと同じ扱いを受けます。

古い C および C++ オブジェクト (C/C++ 5.6 より前) は、そのオブジェクトの動作変更なしに、新しい C および C++ オブジェクトとリンクできます。規格に適合した動作を実現するには、最新のコンパイラを使って古いコードをコンパイルする必要があります。

次の表に、a に指定可能な値を示します。接頭辞 no% はサブオプションを無効にします。

[no%]conststrings: 読み取り専用メモリー内で文字列リテラルの配置を有効または無効にします。デフォルトは -features=conststrings であり、非推奨の -xstrconst オプションを置き換えます。デフォルトのコンパイルモードでは、コマンド行に -xstrconst を指定した場合のように、プログラムは文字列リテラルの書き込みに失敗します。
[no%]extensions: サイズがゼロの構造体または共用体の宣言、および有効な値を返す return 文を持つ void 関数を許可または禁止します。
extinl: extern インライン関数をグローバル関数として生成します。これがデフォルトで、1999 C 規格に準拠しています。
[no%]extinl: extern インライン関数を静的関数として生成します。
[no%]typeof: typeof 演算子の認識を有効または無効にします。typeof 演算子はその引数 (式または型のどちらか) の型を返します。構文上は sizeof 演算子と同様に指定されますが、意味上は typedef で定義される型と同様に動作します。したがって、typedefが使用できる箇所であればどこでも使用できます。たとえば、宣言、キャスト、または sizeof や typeof の内側で使用できます。デフォルトは -features=typeof です。
%none: オプション -features=%none は非推奨であり、-features=no% (サブオプションを指定します) に置き換えてください。

例:

typeof(int) i;/* declares variable "i" to be type int*/
typeof(i+10) j;/* declares variable "j" to be type int,
          the type of the expression */

i = sizeof(typeof(j)); /* sizeof returns the size of
          the type associated with variable "j" */

int a[10];
typeof(a) b;/* declares variable "b" to be array of
size 10 */

typeof 演算子は、任意の型の引数を使用できるマクロ定義で特に役立つ可能性があります。例:

#define SWAP(a,b)
         { typeof(a) temp; temp = a; a = b; b = temp; }

-flags

-xhelp=flags と同じです。使用可能なオプションを 1 行に要約した内容を出力します。

-flteval[={any|2}]

(x86) このオプションは、浮動小数点式の評価方法を制御するために使用します。

2: 浮動小数点式は long double として評価されます。
any: 式を構成している変数および定数の型の組み合わせに基づいて浮動小数点式が評価されます。

-flteval が指定されない場合は、-flteval=any に設定されます。-flteval を指定したけれども値を指定しない場合、コンパイラはそれを -flteval=2 に設定します。

-flteval=2 は、-xarch=sse、pentium_pro、ssea、または pentium_proa と一緒にのみ使用できます。

また、-flteval=2 は、-fprecision または -nofstore オプションと組み合わせた場合、互換性がありません。

詳細は、『C ユーザーガイド』の付録 E の「浮動小数点評価における精度」を参照してください。

-fma[={none|fused}]

浮動小数点の積和演算 (FMA) 命令の自動生成を有効にします。-fma=none を指定すると、これらの命令の生成を無効にします。-fma=fused を指定すると、コンパイラは浮動小数点の積和演算 (FMA) 命令を使用して、コードのパフォーマンスを改善する機会を検出しようとします。

デフォルトは -fma=none です。

積和演算命令を生成するための最低限のアーキテクチャーの要件は、SPARC では -xarch=sparcfmaf、x86 では -xarch=avx2 です。積和演算 (FMA) 命令をサポートしていないプラットフォームでプログラムが実行されないようにするため、コンパイラは積和演算 (FMA) 命令を生成する場合、バイナリプログラムにマーク付けをします。最低限のアーキテクチャーが使用されていない場合、-fma=fused は無効になります。

積和演算 (FMA) 命令により、積と和の間で中間の丸め手順が排除されます。その結果、-fma=fused を指定してコンパイルしたプログラムは、精度は減少ではなく増加する傾向にありますが、異なる結果になることがあります。

-fnonstd

-fns および -ftrap=common 用のマクロ。

-fns[=[no|yes]]

SPARC の場合は、SPARC 非標準浮動小数点モードを選択します。

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

デフォルト (-fns=no) は標準の浮動小数点モードです。

オプションの =yes または =no を使用すると、-fast のように、-fns を含むほかのマクロフラグに続く -fns フラグを切り替えることができます。

-fns は -fns=yes と同じです。-fns=yes では非標準の浮動小数点が選択され、-fns=no では標準の浮動小数点が選択されます。

一部の SPARC システムでは、非標準の浮動小数点モードは「段階的アンダーフロー」を無効にします。つまり、小さな結果は、非正規数にはならず、ゼロに切り捨てられます。さらに、このモードでは、非正規のオペランドが報告なしにゼロに置き換えられます。このような SPARC システムでは、ハードウェアの段階的アンダーフローや非正規数がサポートされておらず、このオプションを使用するとプログラムのパフォーマンスを著しく改善できます。

非標準モードを有効にすると、浮動小数点演算は IEEE 754 規格に準拠しない結果を生成する場合があります。詳細は、『数値計算ガイド』を参照してください。

SPARC システムでは、このオプションはメインプログラムのコンパイル時に使用される場合にのみ有効です。

-fopenmp

-xopenmp=parallel と同じです。

-fprecision=p

(x86) 浮動小数点制御ワードの丸め精度モードのビットを p (単精度 (24 ビット)、倍精度 (53 ビット) または拡張精度 (64 ビット) のいずれか) に初期化します。デフォルトの浮動小数点丸め精度モードは拡張モードです。

x86 では、浮動小数点丸め精度モードの設定は精度に対してのみ影響します。指数の有効範囲に対しては影響しません。

このオプションは、x86 システムでメインプログラムのコンパイル時に使用する場合にのみ有効で、64 ビットプラットフォーム (-m64) または SSE2 対応プロセッサ (-xarch=sse2) でコンパイルする場合は無視されます。SPARC プラットフォームでは -fprecision は無視されます。

-fround=r

プログラム初期化中に実行時に確立される IEEE 754 丸めモードを設定します。

r は、nearest、 tozero、negative、positive のいずれかです。

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

ieee_flags サブルーチンと同等です。

r を tozero、negative、positive のいずれかにすると、プログラムが実行を開始するときに、丸め方向モードがそれぞれ、ゼロの方向に丸める、負の無限の方向に丸める、正の無限の方向に丸めるに設定されます。r が nearest のとき、あるいは -fround フラグを使用しないとき、丸め方向モードは初期値から変更されません (デフォルトは nearest)。

このオプションは、メインプログラムをコンパイルするときにだけ有効です。

-xvector または -xlibmopt でのコンパイルには、デフォルトの丸めが必要です。-xvector または -xlibmopt のどちらか、あるいはその両方を使用してコンパイルされたライブラリにリンクするプログラムは、デフォルトの丸めが有効になっていることを確認する必要があります。

-fsimple[=n]

オプティマイザが浮動小数点演算に関する単純化した仮定を行うことを許可します。

デフォルトは -fsimple=0 です。-fsimple は -fsimple=1 と同等です。

n を指定する場合、0、1、2 のいずれかにしなければいけません。

-fsimple=0

前提事項の単純化を行えないようにします。IEEE 754 に厳密に準拠します。

-fsimple=1

保守的な単純化を許可します。生成されるコードは、厳密には IEEE 754 に準拠していません。

-fsimple=1 では、オプティマイザは、次の点を前提にすることができます。

IEEE 754 のデフォルトの丸めとトラップモードが、プロセスの初期化以後も変わらない。
浮動小数点例外以外には、目に見える結果が生じない演算は削除できる。
オペランドとして無限大または非数を持つ計算は、結果に非数を反映する必要はありません。たとえば、x*0 は 0 に置き換えることができます。
演算はゼロの符号を区別しない。

-fsimple=1 の場合、四捨五入や例外を考慮せずに完全な最適化を行うことは許可されていません。特に、浮動小数点演算を、実行時に一定に保たれる丸めモードにおいて異なる結果を生成する浮動小数点演算と置き換えることはできません。

-fsimple=2

-fsimple=1 のすべての機能が含まれ、-xvector=simd が有効な場合に、SIMD 命令を使用して縮約を計算できるようにします。

また、積極的な浮動小数点演算の最適化を許可し、この結果、丸めの変化によって、多くのプログラムが異なる数値結果を生じる可能性があります。たとえば、-fsimple=2 を指定し、あるループ内に x/y の演算があった場合、x/y がループ内で少なくとも 1 回は必ず評価され、z=1/y で、ループの実行中に y と z が一定の値をとることが明らかである場合、オプティマイザは x/y の演算をすべて x*z で置き換えようとします。

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

最適化が精度に与える影響の詳細は、『Techniques for Optimizing Applications: High Performance Computing』(Rajat Garg と Ilya Sharapov 著) をお読みください。OTN Oracle Solaris Studio の Web サイト (oracle.com/technetwork/server-storage/solarisstudio/) のパフォーマンスおよび精度に関する記事も参照してください

-fsingle

(-Xt および -Xs モードのみ) デフォルトでは、-Xs および -Xt は、浮動小数点式の K&R C の規則に従い、double に拡張して倍精度で評価します。-fsingle フラグは、-Xs または -Xt を指定して、コンパイラに浮動小数点式を単精度として評価させる場合に使用します。

-fstore

(x86) 浮動小数点式または関数が変数に代入されるか、式がより短い浮動小数点型にキャストされるときに、コンパイラがその値をレジスタに残さないで、その式または関数の値を代入の左辺の型に変換します。丸めや切り捨てによって、結果がレジスタの値から生成される値と異なることがあります。これは、デフォルトのモードです。このオプションを解除するには、オプション -nofstore を使用してください。

-ftrap[=t[,t...] ]

Sets 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.

接頭辞 no% は、%all または common からサブオプションを削除するために使用します。

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

デフォルトは -ftrap=%none です。

[no%] 形式のオプションは、次の例に示すように、%all や common 値の意味を変更するためにのみ使用され、これらの値のいずれかと一緒に使用される必要があります。[no%] 形式のオプション自体は、特定のトラップを明示的に無効にするものではありません。

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

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

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

x = 1.0 / 3.0;

-G

動的にリンクされた実行可能ファイルではなく共有オブジェクトを生成します。このオプションは、-dn オプションとともに使用することはできず、ld に渡されます。

-G オプションを使用すると、コンパイラはデフォルトの -l オプションを ld に渡しません。共有ライブラリを別の共有ライブラリに依存させる場合は、必要な -l オプションをコマンド行に渡す必要があります。

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

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

-g

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

-g[n]

dbx(1) およびパフォーマンスアナライザ (analyzer(1)) 用の追加のシンボルテーブル情報を生成します。

-xO3 以下の最適化レベルで -g を指定すると、ほとんど完全な最適化と可能なかぎりのシンボル情報を取得できます。末尾呼び出しの最適化とバックエンドのインライン化は無効です。

-xO4 以下の最適化レベルで -g を指定すると、完全な最適化と可能なかぎりのシンボル情報が得られます。

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

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

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

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

値:

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

-H

現在のコンパイル中にインクルードされた各ファイルのパス名を、標準エラーに 1 行に 1 つずつ出力します。

-h name

共有動的ライブラリに異なるバージョンのライブラリを保持できる名前を割り当てます。

通常、-h のあとの name は、-o オプションに指定したファイル名と同じでなければなりません。-h と name の間の空白はオプションです。

リンカーは指定された name をライブラリに割り当て、この名前をライブラリの組み込み名としてライブラリファイルに記録します。-hname; オプションがない場合、組み込み名はライブラリファイルに記録されません。

実行時リンカーはライブラリを実行可能ファイルにロードするとき、組み込み名をライブラリファイルから実行可能ファイルが必要とする共有ライブラリファイルのリストにコピーします。実行可能ファイルはこのリストを持っています。共有ライブラリに組み込み名がないと、リンカーは代わりにその共有ライブラリファイルのパス名を使用します。

-I[-|dir]

-Idir は #include ファイルを検索するディレクトリのリストに dir を追加します。-I の値は左から右に適用されます。

#include <foo.h> という形式の include 文の場合、プリプロセッサはヘッダーファイルを次の順序で検索します。
1. -I オプションで命名されたディレクトリ (ある場合)。
2. コンパイラおよびシステムの標準のディレクトリ (通常は /usr/include)。
#include "foo.h" 形式のインクルード文の場合、次の順序でディレクトリを検索します。
1. 現在のディレクトリ (つまり、include 文自体が含まれているファイルがあるディレクトリ)。
2. -I オプションで命名されたディレクトリ (ある場合)。
3. コンパイラおよびシステムの標準のディレクトリ (通常は /usr/include)。

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

現在のディレクトリが -I 指令で明示的に指定されていないかぎり、コンパイラは現在のディレクトリを検索しません。この影響は #include "foo.h" 形式のインクルード文にも及びます。
#include "foo.h" という形式のインクルードファイルの場合は、ディレクトリを次の順序で検索します。
1. -I オプションで指定されたディレクトリ内 (-I- の前後)。
2. コンパイラおよびシステムの標準のディレクトリ (通常は /usr/include)。
#include <foo.h> 形式のインクルードファイルの場合、次の順序でディレクトリを検索します。
1. -I オプションの -I- のあとに指定されたディレクトリ (つまり、コンパイラは -I- の前にある -I のディレクトリを検索しません)。
2. コンパイラおよびシステムの標準のディレクトリ (通常は /usr/include)。

前述のように、コマンド行の最初の -I- だけが機能します。

-Idir は、usr/include の前に dir で、名前がスラッシュ (/) で始まっていないインクルードファイルを探します。複数の -I オプションが指定された場合は、指定された順序でディレクトリが調べられます。

警告:

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

-i

LD_LIBRARY_PATH および LD_LIBRARY_PATH_64 の設定を無視します。

-include filename

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

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

-KPIC

(SPARC) (廃止) このオプションは使用すべきではありません。代わりに -xcode=pic32 を使用してください。廃止されたオプションおよびフラグの完全なリストについては、『C ユーザーガイド』を参照してください。

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

-Kpic

(SPARC) (廃止) このオプションは使用すべきではありません。代わりに -xcode=pic13 を使用してください。廃止されたオプションおよびフラグの完全なリストについては、『C ユーザーガイド』を参照してください。

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

-keeptmp

コンパイル中に作成された一時ファイルを、自動的に削除する代わりに保持します。

-Ldir

dir に指定したディレクトリを、ld によるライブラリの検索に使用するディレクトリとして追加します。このオプションとその引数は ld に渡されます。

警告:

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

-lname

オブジェクトライブラリ libname.so または libname.a とリンクします (ld(1) に渡すため)。シンボルは左から右へ解決されるため、コマンド行でのライブラリの順序は重要です。このオプションはソースファイルのあとに続ける必要があります。

-library=sunperf

Oracle Solaris Studio 提供のパフォーマンスライブラリにリンクします。

-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 がデフォルト値です。

注

errno

特定の浮動小数点数学ライブラリルーチンは、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 が正しく設定されるようになります。

新しい共有ライブラリ

Solaris release 10 の場合、-xprofile オプションを使用するために、新しい共有ライブラリ libxprof.so.1、libxprof_audit.so.1、および libtdf.so.1 をインストールする必要があります。これらのライブラリは、最新の Oracle Solaris リリースでは事前にインストールされます。

プラグマ

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

#pragma align
#pragma c99
#pragma does_not_read_global_data
#pragma does_not_return
#pragma does_not_write_global_data
#pragma error_messages
#pragma fini
#pragma hdrstop
#pragma ident
#pragma init
#pragma [no_]inline
#pragma [no_]warn_missing_parameter
#pragma int_to_unsigned
#pragma opt
#pragma pack
#pragma rarely_called
#pragma redefine_extname
#pragma returns_new_memory
#pragma struct_align
#pragma unknown_control_flow
#pragma weak

#pragma does_not_read_global_data
#pragma does_not_write_global_data
#pragma no_side_effect

サポートされる OpenMP 2.5 ディレクティブのリストについては、『OpenMP API ユーザーズガイド』を参照してください。

SPARC のみ:

#pragma nomemorydepend
#pragma no_side_effect
#pragma pipeloop
#pragma unroll

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

環境変数

設定可能な環境変数のリスト、およびその機能の簡単な説明を次に示します。

LINT_OPTIONS

lint のオプションのデフォルトセット。LINT_OPTIONS は、次のように lint の呼び出しに使用された名前の直後に、コマンド行にその値が指定されたものとして、lint によって解釈されます。

lint $LINT_OPTIONS ... other-arguments ...

OMP_DYNAMIC

スレッド数の動的調整を有効または無効にします。

OMP_NESTED

入れ子並列化を有効または無効にします。『OpenMP API ユーザーガイド』を参照してください。

OMP_NUM_THREADS

この変数は、プログラムが作成できるスレッドの最大数を実行時システムに示します。デフォルトは 2 です。『OpenMP API ユーザーガイド』を参照してください。

OMP_SCHEDULE

実行時のスケジュール型およびチャンクサイズを設定します。『OpenMP API ユーザーガイド』を参照してください。

PARALLEL

OMP_NUM_THREADS と同じです。

STACKSIZE

プログラムを実行すると、マスタースレッドのメインメモリースタック、および各スレーブスレッドの個別のスタックが維持されます。スタックとは、サブプログラムが呼び出されている間、引数と自動変数を保持するために使用される一時的なメモリーアドレス空間です。メインスタックのデフォルトのサイズは、約 8M バイトです。現在のメインスタックサイズを表示し、それを設定するには、limit(1) コマンドを使用します。

マルチスレッド化されたプログラムの各スレーブスレッドは、それ自体のスレッドスタックを持ちます。このスタックはマスタースレッドのメインスタックに似ていますが、各スレッド固有のものです。スレッドのスタックには、スレッド固有の配列とその (スレッドに対してローカルな) 変数が割り当てられます。

すべてのスレーブスレッドは、同じスタックサイズを持ちます。デフォルトでは、32 ビットアプリケーションの場合は 4M バイト、64 ビットアプリケーションの場合は 8M バイトです。このサイズは、STACKSIZE 環境変数で設定します。

一部の並列化されたコードでは、スレッドのスタックサイズをデフォルトより大きな値に設定する必要がある場合があります。

STACKSIZE 環境変数の構文は、スレーブスレッドのスタックサイズを示すためのキーワード (バイトの B、キロバイトの K、メガバイトの M、ギガバイトの G) を受け入れます。

たとえば、setenv STACKSIZE 8192 はスレーブスレッドのスタックサイズを 8M バイトに、1235B は 1235 バイトに、および 1235G は 1235G バイトに設定します。接尾辞文字なしの整数のデフォルトは K バイトです。

コンパイラが、より大きなスタックサイズが必要であるという警告メッセージを生成することがあります。ただし、それをどのくらいの大きさに設定するかは、試行錯誤で判別するしかない可能性があります。スレッド固有/ローカル配列がかかわる場合は特にそうです。スレッドを実行するにはスタックサイズが小さすぎる場合、プログラムはセグメント例外で中止されます。

TMPDIR

通常、cc は、一時ファイルを tmp ディレクトリ内に作成します。環境変数 TMPDIR を選択したディレクトリに設定することにより、別のディレクトリを指定できます。(TMPDIR が有効なディレクトリではない場合、cc は tmp を使用します)。-xtemp オプションと環境変数 TMPDIR では、-xtemp が優先されます。

SUNPRO_SB_INIT_FILE_NAME

(廃止) ソースブラウザ機能はサポートされなくなりました。

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 は無効になります。

SUNW_MP_THR_IDLE

各ヘルパースレッドのタスク終了ステータスを制御し、spin または sleep ns を設定できます。デフォルトは sleep です。詳細は、『OpenMP API ユーザーズガイド』を参照してください。

SUNW_MP_WARN

OpenMP およびその他の並列化ランタイムシステムからの警告メッセージを出力するには、この環境変数に TRUE を設定します。警告メッセージを処理するために sunw_mp_register_warn() を使用して関数を登録した場合、TRUE に設定しても SUNW_MP_WARN は警告メッセージを出力しません。関数を登録せずに SUNW_MP_WARN に TRUE を設定した場合、SUNW_MP_WARN は警告メッセージを標準エラー出力に出力します。関数を登録せず、SUNW_MP_WARN を設定しない場合、警告メッセージは発行されません。sunw_mp_register_warn() の詳細は、『C ユーザーガイド』を参照してください。

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 です。

ファイル

a.out: 実行可能出力ファイル
bb_link.o: tcov のサポート
file.a: オブジェクトファイルのライブラリ
file.c: C ソースファイル
file.d: tcov(1) テストカバレージの入力ファイル
file.i: 前処理後の C ソースファイル
file.il: inline(1) 展開ファイル
file.ll: lock_lint データベース
file.o: オブジェクトファイル
file.profile: -xprofile によって使用されるデータのディレクトリ
file.s: アセンブラソースファイル
file.so: 動的ライブラリ
file.tcov: tcov(1) からの出力
acomp: コンパイラのフロントエンド
cc: コンパイラのコマンド行ドライバ
cg: コードジェネレータ (SPARC)
crt1.o: 実行時起動コード
crti.o: 実行時起動コード
crtn.o: 実行時起動コード
fbe: アセンブラ
gcrt1.o: gprof(1) を使用したプロファイリングのスタートアップコード
gmon.out: -xpg のデフォルトのプロファイルファイル
ipo: 内部手続きオプティマイザ (SPARC)
iropt: グローバルオプティマイザ
libredblack.so: bids のサポート
mcrt1.o: prof(1) および intro(3) を使用したプロファイリングのスタートアップコード
misalign.o: 整列境界を誤ったデータのサポート (SPARC)
mon.out: -p のデフォルトのプロファイルファイル
postopt: ポストオプティマイザ (SPARC)
ssbd: 静的同期バグ検出 (Oracle Solaris オペレーティング環境)
stack_grow.o: スタックオーバーフローの検査 (SPARC)
SunWS_cache: -xpch オプションを使用した場合に、データを格納するために使用するディレクトリ。
ube: オプティマイザ、コードジェネレータ (x86)
ube_ipa: 内部手続きアナライザ (x86)
values-xa.o: -Xa のサポート
values-xc.o: -Xc のサポート
values-xpg4.o: xpg4 のサポート
values-xpg6.o: SUSv3 のサポート
values-xs.o: -Xs のサポート
values-xt.o: -Xt のサポート
xprof_fini.o: -xprofile=collect を指定してコンパイルされたプログラムの初期化ハンドラおよびファイナライズハンドラ