ld コマンド

目的

オブジェクト・ファイルをリンクします。

構文

ld [ -DNumber ] [ -eLabel ] [ -G ] [ -HNumber ] [ -K ] [ -m ] [ -M ] [ -oName ] [ -r ] [ -s ] [ -SNumber ] [ -TNumber ] [ -u Name ] ... [ -v ] [ -V ] [ -z ] [ -ZString ] ... [ -bOption ] ... [ -LDirectory ] ... { -fFileID ... -lName ... InputFile ... }

または

ld -bsvr4 [ -d[y | n] ] [ -D Number ] [ -e Label ] [ -G ] [ -HNumber ] [ -K ] [ -m ] [ -M ] [ -oName ] [ -r ] [ -R Path ] [ -s ] [ -SNumber ] [ -TNumber ] [ -u Name ] ... [ -v ] [ -V ] [ -z [defs | nodefs] ] [ -z multidefs ] [ -z [text | nowarntext | warntext] ] ] [ -ZString ] ... [ -bOption ] ... [ -LDirectory ] ... { -fFileID ... -lName ... InputFile ... }

説明

ld コマンドは、リンケージ・エディターまたはバインダーとも呼ばれ、オブジェクト・ファイル、アーカイブ・ファイル、およびインポート・ファイルを 1 つの出力オブジェクト・ファイルに結合して、 外部参照を解決します。 さらに、このコマンドは実行可能オブジェクト・ファイルを作成します。 また、-s フラグを付けずに ld コマンドを指定すると、次回に ld コマンドを呼び出すときに、この出力ファイルを InputFile パラメーターとして使用できます。 デフォルトでは、ld コマンドは出力を作成し、a.out というファイル内に置きます。

ld コマンドを使用すると、すべての入力オブジェクト・ファイルをリストしなくても、プログラムを再リンクできます。 例えば、大きなプログラムの 1 つのオブジェクト・ファイルを変更した場合、コマンド・ラインで新しいオブジェクト・ファイルと以前のプログラムをリストし、プログラムが必要とする共用ライブラリーを指定することにより、プログラムを再リンクできます。 例を参照してください。

ld コマンドは、コマンド・ラインで指定された順序で入力ファイルをリンクします。 同じファイルを複数回指定すると、そのファイルの最初のオカレンスのみが処理されます。 -bI (i の大文字)、-bimport、 -bkeepfile、-f、-l (L の小文字) フラグを使用するか、あるいは InputFile パラメーターとして、少なくとも入力ファイルを 1 つは指定しなければなりません (-bI、-bimport、または -bkeepfile フラグは、-b フラグを I、import、または keepfile オプションと共に使用しています)。

オペレーティング・システム上で実行するプログラムを作成する場合は、cc コマンドを使用してファイルをリンクしてください。 cc コマンドは共通オプションと必要なサポート・ライブラリーを指定して ld コマンドを呼び出すので、コマンド・ラインにそれらのオプションとライブラリーを指定する必要はありません (この情報は、/etc/xlC.cfg または /etc/vac.cfg の構成ファイルから読み取られます)。

リンク・モード

ld コマンドは、64 ビット・オブジェクトとプログラムもリンクします。しかし、32 ビット・オブジェクトと 64 ビット・オブジェクトを共にリンクできません。 リンク・モードを指定するには、OBJECT_MODE 環境変数を使用するか、-b32 オプションまたは -b64 オプションを使用します。

アーカイブ・ファイル

アーカイブ・ファイルは、共用オブジェクトなど、通常はインポート・ファイルとオブジェクト・ファイルが入っている複合オブジェクトです。 アーカイブ・ファイルに別のアーカイブ・ファイルまたはタイプが認識されないメンバーが入っていると、ld コマンドは警告を表示して認識されないメンバーを無視します。 アーカイブ・ファイルに入っているオブジェクト・ファイルの XCOFF ヘッダー内で F_LOADONLY ビットが設定されていると、ld コマンドはそのメンバーを無視します。 一般に、このビットは、既存のアプリケーションでロードして実行できるように、アーカイブ・ファイルに残っている共用オブジェクトの旧バージョンを指定するために使用されます。 新しいアプリケーションは、共用オブジェクトの新バージョン、つまりアーカイブの別のメンバーとリンクします。

共用オブジェクト

共用オブジェクトは、一般に ld コマンドの次の呼び出しによって作成され、XCOFF ヘッダー内で F_SHROBJ ビットが設定されているオブジェクト・ファイルです。 共用オブジェクトは、実行時に解決される外部シンボルを定義します。 -bnso または -bnoautoimp オプションを指定すると、ld コマンドは共用オブジェクトを通常のオブジェクト・ファイルとして処理するので、ファイルが除去されているリンクは失敗します。

一般に、共有オブジェクト内のシンボルが実際に参照される場合、入力として使用する共有オブジェクトは、出力ファイルのローダー・セクション内にのみリストされます。 しかし、実行時リンカーを使用するときに、シンボルの参照がない場合でも共有オブジェクトをリストしたい場合もあります。 -brtl オプションを使用すると、コマンド・ラインにリストされたアーカイブ・メンバーでないすべての共有オブジェクトは、出力ファイルにリストされます。 プログラムを実行すると、システム・ローダーはこれらの共有オブジェクトをすべてロードします。実行時リンカーでは、これらの共有オブジェクトによってエクスポートされるシンボルを使用できます。 アーカイブ内のインポート・ファイルによって自動ロードが使用可能にされていない限り、アーカイブ・メンバーである共有オブジェクトは、自動的にはロードされません。 自動ロードを使用可能にするには、インポートおよびエクスポート・ファイルの形式 (-bI: および -bE: フラグ)を参照してください。

インポート・ファイルとエクスポート・ファイル

インポート・ファイルは、実行時に解決するために外部シンボルを識別する ASCII ファイルです。 インポート・ファイルは、インポートされるシンボルを定義する共用オブジェクトを識別します。 システム・ローダーは、これらのシンボルを実行時に検索して解決します。 インポート・ファイルの 1 行目が #! (番号記号、感嘆符) で始まる場合は、このファイルを通常の InputFile としてコマンド・ラインで指定できます。 それ以外の場合は、-bI または -bimport オプションを使用してインポート・ファイルを指定しなければなりません。

エクスポート・ファイルは、別の実行可能オブジェクト・ファイルをインポートに使用できるようにする外部シンボルを識別する ASCII ファイルです。 エクスポート・ファイルのフォーマットは、インポート・ファイルと同じです。

ライブラリー

ライブラリーは、.a で終わる名前のファイルです。ライブラリーによっては .so で終わる場合もあります。 ライブラリーを指定するには、絶対パス名または相対パス名を指定する方法と、-l (L の小文字) フラグを -lName フォーマットで使用する方法があります。 後者のフォーマットでは、libName.a ファイルを指定します。rtl オプションを使用する場合は、いくつかのディレクトリーから検索する libName.so ファイルを指定します。これらの検索ディレクトリーには、-L フラグで指定したディレクトリーと、標準ライブラリー・ディレクトリーである /usr/lib と /lib が含まれます。

処理

ld コマンドは、すべての入力ファイルを、アーカイブ・ファイルであるかどうかに関係なく同様に処理します。 このコマンドは、すべてのオブジェクトのシンボル・テーブルを組み込み、既存のシンボルと重複するシンボル定義のみを廃棄します。 他のバージョンの ld コマンドとは異なり、参照が定義よりも先になるようにアーカイブ・ファイルを並べ替える必要はありません。 また、同じアーカイブ・ファイルをコマンド・ラインで何度もリストする必要もありません。

ld コマンド・フラグの順序は、入力オブジェクト・ファイル、ライブラリー、およびインポート・ファイルを除けば、コマンドの処理方法には影響を与えません。 このコマンドのフラグには、 -L、-f、-l (L の小文字)、-bkeepfile、-bI (i の大文字) があります。 これらのフラグは、次の順序で処理されます。

1. -L フラグは、-l (L の小文字) フラグで指定したライブラリーを見つけるために、検索ディレクトリーのリストにディレクトリーを追加します。各ディレクトリーは指定した順序で検索されます。 すべての -L フラグは、-l フラグよりも先に処理されます。
2. ld コマンドは、InputFile パラメーターと、-f フラグで指定したファイルと、-l (L の小文字) フラグで指定したライブラリーを、指定した順序で処理します。
3. ld コマンドは、他のすべてのオブジェクト・ファイルとライブラリーを処理した後で、-bI (i の大文字) フラグで指定したインポート・ファイルを、指定した順序で処理します。 インポート・ファイルを他のオブジェクト・ファイルよりも先に処理する必要があれば、 -bI フラグを付けずにインポート・ファイルを入力ファイルとして指定できます。 この場合、インポート・ファイルの 1 行目は #! (番号記号、感嘆符) で始まらなければなりません。 また、インポート・ファイルは、ステップ 2 で説明したように、他の入力ファイルと共に処理されます。
4. -bkeepfile オプションでは、ld コマンドによってガーベッジ・コレクションが行われない入力ファイルを指定します。 指定した入力ファイルを InputFile パラメーターでも指定しているか、または -f フラグで指定したファイルにもリストしていると、-bkeepfile オプションはファイルの処理順序に影響を与えません。 それ以外の場合、ファイルはステップ 2 で説明したように他の入力ファイルと共に順に処理されます。

-r フラグまたは -bnox オプションを指定するか、あるいはリンク中にエラーが発生しなければ、ld コマンドで作成される出力ファイルには実行許可が設定されます。 重大エラーが発生した場合、あるいは出力ファイルを入力ファイルとして指定し、エラーが発生した場合、既存の出力ファイルは上書きされません。

シンボル

ld コマンドでは、次の事前定義シンボルを使用して特殊なアドレス位置を指定します。また、 C 構文で extern char name[ ] として宣言できます。

これらのシンボルを使用するには、そのアドレスを指定しなければなりません。 入力ファイルで 6 つのうちいずれかのシンボルを再定義すると、予測できない結果が生じることがあります。 追加の事前定義シンボル _ptrgl は、コンパイラーで関数ポインターによる呼び出しを実現するために使用します。

ガーベッジ・コレクション

デフォルトでは、ld コマンドはガーベッジ・コレクションを行い、出力ファイルの生成時に参照されない制御セクション (CSECT) を削除します。

CSECT は、コードまたはデータの非表示ユニットです。 CSECT は、他の CSECT に入っているシンボルを参照する再配置エントリー (RLD) が入っていると、その CSECT を参照します。 参照先の CSECT は、自分が参照するすべての CSECT も参照されるようにします。 エクスポートされるシンボル、-u フラグで指定したシンボル、-e フラグでエントリー・ポイントとして指定したシンボルを含む CSECT も参照されます。

シンボルが参照されず、それでも出力ファイルに必要な場合、シンボルをエクスポートしたり、-u フラグでシンボルを指定したり、ガーベッジ・コレクションを抑制できます。 ガーベッジ・コレクションを抑制するには、-r フラグまたは -bnogc オプションを使用します。 個々のオブジェクト・ファイルのためにガーベッジ・コレクションを抑制するには、 -bkeepfile オプションまたは -bgcbypass オプションを使用します。 ガーベッジ・コレクションを抑制しても、参照されない内部シンボルは削除されます。

無視されてサポートされないフラグ

ld コマンドの他のバージョンとの互換性を保つために、 一部のフラグは認識されますが、無視されます。 これらのフラグを指定すると、そのフラグとオペランドが無視されたことを示すメッセージが表示されます。 フラグが無視されても、ld コマンドがそれ以上処理せずに終了することはありません。 次のフラグが無視されます。

-ANumber         -bnostrcmpct     -n
-bfilelist       -bstrcmpct       -N
-bfl             -BNumber         -Q
-bforceimp       -d               -RNumber
-bi              -i               -VNumber
-binsert         -j[Key:]Number   -x
-bnoforceimp     -kKey:Path       -YNumber

ld コマンドでサポートされないフラグを指定すると、エラー・メッセージが表示されます。 サポートされないフラグがすべて診断された後、ld コマンドはそれ以上処理を行わずに終了します。

フラグ

ld コマンドは XPG Utility Syntax Guidelines に準拠していますが、引数 — はコマンド・ラインの残りのオペランドではなく、次のオペランドのみに適用されます。例えば、次のコマンド・ラインがあるものとします。

ld -- -s -v

-s はファイル名として処理され、-v はフラグとして処理されます。 -v をファイル名として処理させるには、次のように指定します。

ld -- -s -- -v 

バインダー

ld コマンドは、コマンド・ライン引数の妥当性を検査し、バインダー (デフォルトでは /usr/ccs/bin/bind ファイル) を呼び出して、生成されたバインダー・サブコマンドのリストを渡します。 バインダー・プログラムは実際にファイルをリンクします。 一般に、バインダーは ld コマンドによって呼び出されますが、直接呼び出すこともできます。 この場合、バインダーは標準入力からコマンドを読み取ります。

2 つのバインダー・オプションがバインダーの呼び出しに影響を与えます。 binder オプションは呼び出すバインダーを指定し、 nobind オプションは ld コマンドがバインダーを呼び出さないようにします。 その他のバインダー・オプションは、生成されるバインダー・サブコマンドに影響を与えます。

ld コマンドはオプションまたはコマンド・ライン引数内でエラーを検出しなければ、バインダーを呼び出します。 バインダーは、次の形式のコマンド・ラインで呼び出されます。

bind [quiet_opt] [loadmap_opt]

quiet_opt のデフォルト値は quiet で、loadmap_opt のデフォルト値はヌルの文字列なので、デフォルトのコマンド・ラインは次のようになります。

/usr/ccs/bin/bind quiet

オプション (-bOptions)

# autoload 
#! (foo.o) 

-bautoload:<archive_name>(foo.o)

実行時リンク

デフォルトでは、共有オブジェクト内のシンボルへの参照は、リンク時にバインドされます。 つまり出力モジュールは、インポートされたシンボルを特定の共有オブジェクト内の定義に関連付けます。 別の共有オブジェクトが同じシンボルをエクスポートする場合でも、ロード時に指定した共有オブジェクト内の定義を使用します。

いくつかのシンボルをロード時に再バインドできるように、プログラムに実行時リンカーを使用させることができます。 実行時リンカーを使用するプログラムを作成するには、-brtl オプションでプログラムをリンクします。 共有モジュールをリンクする方法は、シンボルの再バインドに影響します。

-G フラグを使用して、実行時リンクを使用可能な共有オブジェクトを作成できます。 既存の共有オブジェクトをストリップする必要がない限り、rtl_enable コマンドでそれらを再リンクして、実行時リンクを完全に使用可能にできるようになります。

シンボル可視性

入力オブジェクト・ファイル内のグローバル・シンボルや弱いシンボルは、可視性でマークを付けることができます。4 つのシンボル可視性が定義されています。

シンボルの可視性は、アセンブラー・ソース・ファイルで指定できます。一部のコンパイラーも可視性をサポートしています。詳細については、コンパイラーの資料を参照してください。

エクスポート・ファイルもシンボルの可視性を指定するために使用できます。通常、エクスポート・ファイルで指定された可視性は、オブジェクト・ファイルで指定された可視性よりも優先されます。このリンカーは、プログラムまたは共用オブジェクト用のエクスポート・リストを作成するときにシンボルの可視性を考慮に入れます。

インポートおよびエクスポート・ファイルの形式 (-bI: および -bE: フラグ)

インポート・ファイルまたはエクスポート・ファイルの各行には、シンボルの名前が含まれ、オプションでその後にアドレスまたはキーワードが続きます。 プライマリー・キーワードは、svc、svc32、svc3264、svc64、syscall、syscall32、syscall3264、syscall64、symbolic、nosymbolic、nosymbolic-、list、cm、bss、internal、hidden、protected、および export です。追加のキーワードは weak および required で、別のキーワードと共に使用することができます。

インポート・ファイルでは、アドレスを指定すると、シンボルを、共用メモリー・セグメント内のアドレスのように固定したアドレスにマップすることができます。キーワード cm、bss、または weak の いずれかを使用して、インポートされるシンボルのストレージ・クラスを指定することもできます。 autoexp オプションを使用すると、インポートされるシンボルのストレージ・クラスが、どのシンボルを自動的にエクスポートするかに影響します。 インポート・ファイルで別のキーワードを指定すると、このキーワードは無視されます。

エクスポート・ファイルでは、機能名の後に svc、svc32、svc3264、svc64, syscall, syscall32、syscall3264、または syscall64 キーワードを使用して、機能がシステム呼び出しであることを示すことができます。これはカーネル・エクステンションをリンクする際に必要です。 出力ファイルがカーネル・エクステンションでない場合、これらのキーワードは symbolic キーワードと等価です。

list キーワードを使用すると、シンボルがエクスポート・シンボルとしてマークされていなくても、出力ファイルのローダー・セクションにシンボルをリストできます。実行時、アプリケーションにいくつかのシンボルを処理させたい場合、このキーワードを使用できます。 システム・ローダーや実行時リンカーは、リストされたシンボルは処理しません。

symbolic、nosymbolic、または nosymbolic- キーワードを使用して、エクスポートされるシンボルに属性を関連付けることができます。 エクスポート・ファイル内のシンボル・アドレスは無視されます。エクスポート・ファイルでは、キーワード cm および bss は nosymbolic キーワードと等価です。シンボルの可視性は、internal、hidden、protected、または export キーワードで指定できます。詳細については、エクスポートされるシンボルの属性 を参照してください。

weak キーワードは、弱いシンボル割り当てを指定することができ、 別の属性と共に使用されます。

required キーワードを使用して、シンボルが定義済みでインポートされていないことを確認してください。これらの基準を満たさないシンボルについてエラーが表示されます。

ld コマンドはインポート・ファイルおよびエクスポート・ファイルを次のように処理します。

• ブランク行は無視されます。
• * (アスタリスク) で始まる行はコメントであるため、無視されます。

• # (番号記号、ブランク・スペース) で始まる行は、オペランドを setopt バインダー・サブコマンド (-bdbg:Option) に提供します。例えば、バインダーは # verbose が含まれている行を、ファイルから各シンボルが読み取られるたびにリストします。 このオプションの設定はファイルを処理している間だけ有効です。 # 32、# 64、# no32、および # no64 の各オプションを使用して、リストされるシンボルを 32 ビット・リンク、64 ビット・リンク、またはその両方のリンクのどれに対して使用するかを指定します。

  32 ビットおよび 64 ビットのインポート・ファイル・オプション

  項目	説明
  32	このオプションをインポート・ファイルまたはエクスポート・ファイルで使用して、以降のシンボルを 32 ビット・モードでリンクするときに処理して、64 ビット・モードでリンクするときに無視するよう指定します。 32 オプションまたは 64 オプションを指定しない場合、すべてのシンボルが 32 ビットと 64 ビットの両方のモードで処理されます。
  64	このオプションをインポート・ファイルまたはエクスポート・ファイルで使用して、以降のシンボルを 64 ビット・モードでリンクするときに処理して、32 ビット・モードでリンクするときに無視するよう指定します。 32 オプションまたは 64 オプションを指定しない場合、すべてのシンボルが 32 ビットと 64 ビットの両方のモードで処理されます。
  no32 または no64	以前の 32 または 64 をオーバーライドします。 以降のシンボルは、32 ビットと 64 ビットの両方のモードで処理されます。

• インポート・ファイルを処理する場合、#! (番号記号、感嘆符) で始まる行は、後続のインポート・シンボルに関連付けられる共用ライブラリー名を提供します。この行は複数回現れ、#! で始まる次の行が読み取られるまで後続のシンボルに適用されます。 このファイル名情報は、XCOFF オブジェクト・ファイルのローダー・セクションに入れられ、実行時にシステム・ローダーによって適切なオブジェクト・ファイルを配置するために使用されます。 インポート・ファイル名が ipath/ifile (imember) である場合、 ローダー・セクションに入れられたファイル名は、インポート・ファイル名と インポート・ファイルの #! 行の内容に基づいて、次のように判別されます。

  項目	説明
  #!	( #! の後に何もない場合) ヌル・パス、ヌル・ファイル、ヌル番号を使います。 これはシステム・ローダーによって遅らされたインポートとして扱われます。
  #! ()	ipath、ifile、imember を使います。 この行は、インポート・ファイルをコマンド・ラインで InputFile パラメーターとして指定している場合に使用できます。 この場合、ファイルは #! で始まらなければなりません。 また、この行は、他の #! 行によって変更されている場合に、デフォルトの名前を復元するために使用することもできます。
  #! path/file (member)	指定されたパス、指定されたファイル、指定されたメンバーを使います。
  #! path/file	指定されたパス、指定されたファイル、およびヌル・メンバーを使います。
  #! file	ヌル・パス、指定されたファイル、およびヌル・メンバーを使います。 実行時にはディレクトリーのリストを検索して共用オブジェクトを見つけます。
  #! (member)	ipath、ifile、および指定されたメンバーを使います。 実行時にはディレクトリーのリストを検索して共用オブジェクトを見つけます。
  #! file (member)	ヌル・パス、指定されたファイル、指定されたメンバーを使います。 実行時にはディレクトリーのリストを検索して共用オブジェクトを見つけます。
  #! .	(1 つのドット) この名前は、メインの実行可能ファイルの名前です。 別の名前を持つ複数のメインプログラムからシンボルをインポートする共有オブジェクトを作成する場合、このファイル名を使用します。 メインプログラムは、他のモジュールがインポートするシンボルをエクスポートする必要があります。 エクスポートしないとロードに失敗します。 実行時リンカーで、あるいは実行時リンカーなしで、このインポート・ファイル名を使用できます。
  #! ..	(2 つのドット) この名前を使用して、実行時リンカーが解決するシンボルをリストします。 このファイル名を使用して、実行時リンカーを利用するプログラムが使用する共有オブジェクトを作成します。 rtllib オプションでリンクされなかったプログラム内の .. からシンボルをインポートするモジュールを使用すると、シンボルは解決されず、このようなシンボルへの参照は未定義の動作をします。

-brtl オプションを使用する場合にアーカイブ・メンバーを自動的にロードするため、次のようにしてインポート・ファイルを作成できます。 shr.so がアーカイブ内の共有オブジェクトである場合、次のようにしてインポート・ファイルを作成します。

# autoload
#! (shr.so)

適用できる場合、追加行に追加のメンバー名をリストできます。 インポート・ファイルにシンボル名をリストする必要はありません。shr.so からインポートされるシンボルは、shr.so 自体から読み取られるからです。

共用ライブラリーの作成についての詳細は、 プログラミングの一般概念: プログラムの作成およびデバッグ のの『共用ライブラリーの作成方法』を参照してください。 ロードとバインドについての詳細は、 Technical Reference: Base Operating System and Extensions, Volume 1 の『load subroutine』を参照してください。

エクスポートされるシンボルの属性

実行時リンクを使用すると、正しい属性でシンボルがエクスポートされる場合に限って、同じモジュール内のシンボルへの参照を再バインドできます。 symbolic 属性のシンボルへの参照は再バインドできません。 nosymbolic 属性のシンボルへの参照は、再バインドできます。 シンボルが変数である場合、nosymbolic- 属性のシンボルへの参照は再バインドできます。 関数シンボルの場合、関数ポインターを使用する呼び出しは再バインドできます。その一方で、直接の関数呼び出しは再バインドできません。 nosymbolic- 属性がデフォルトです。この属性は、オペレーティング・システムのこれまでのバージョンとの互換性のために提供されますが、お勧めできません。

実行時リンカーを使用しない場合、nosymbolic 属性を使用しないでください。 モジュール内の関数呼び出しは、グローバルなリンケージ・コードを使用する関数ディスクリプターを 通じて間接的に実行されるからです。 それ以外の場合、エクスポートされるシンボルの属性は、実行時リンカーを使用しないプログラムで使用するモジュールには影響しません。

エクスポート・ファイルにリストされるシンボルに、明示的なエクスポート属性を指定できます。 明示的な属性のない多くのシンボルは、symbolic オプション、nosymbolic オプション、または nosymbolic- オプションで指定したデフォルトのエクスポート属性でエクスポートされます。

シンボルがエクスポート・ファイルでキーワードなしでリストされ、シンボルの可視性が入力ファイルで指定されている場合、シンボルの可視性が保持されます。入力シンボルの可視性は、internal、hidden、protected、または export キーワードを使用してオーバーライドできます。

weak エクスポート属性は、Loader Section で、関連したシンボルの マッピング・タイプに L_WEAK とマークします。

インポートされるシンボルは、 weak エクスポート属性のみを保有することができます。別のモジュールからシンボルをインポートすると、シンボルへのすべての参照を再バインドできます。 しかし、シンボルが固定アドレスでインポートされた場合、すべての参照はこの固定アドレスにバインドされ、実行時リンカーでは再バインドできません。 システム・ローダーは、延期されたインポートを解決しなければなりません。 実行時リンカーが、延期されたインポートへの参照を解決したり、再バインドしたりすることはありません。

非インポートのシンボルをエクスポートする場合、次の規則を使用します。

• シンボルに list 属性がある場合、ローダー・セクションのシンボル・テーブルにリストされます。しかし、シンボル・テーブル・エントリーに L_EXPORT フラグは設定されません。実行時リンカーは、このようなシンボルを無視します。
• 明示的な属性で、または明示的な可視性でシンボルがエクスポートされた場合、明示的な属性または可視性が使用されます。
• シンボルが BSS シンボルである場合、nosymbolic 属性でエクスポートされます。
• それ以外のシンボルの場合、symbolic オプション、nosymbolic オプション、または nosymbolic- オプションで指定したグローバル属性でシンボルがエクスポートされます。デフォルトのグローバル属性は nosymbolic- です。

アドレス・マップ

ld コマンドはアドレス・マップを生成して、出力オブジェクト・ファイル内のシンボルのレイアウトをリストします。 map (または R) オプションを使用すると、未解決のシンボルとインポートされたシンボルが最初にリストされ、次に各セクションのシンボルがアドレス順にリストされます。 calls (または C) オプションを使用すると、各シンボルの後に、そのシンボルから他のシンボルへの参照がリストされます。 xref (または X) オプションを使用すると、各シンボルの後に、他のシンボルからそのシンボルへの参照がリストされます。 smap、scalls、または sxref オプションを使用すると、シンボルがアルファベット順にリストされることを除き、アドレス・マップには、順に map、calls、xref オプションによってリストされるものと同じ情報が格納されます。

内部シンボルは、ストレージ・クラス HIDEXT と共に、シンボル名の前後に文字 < および > (不等号括弧) が付いた形式で出力されます。ストレージ・クラス C_EXT の外部シンボル名はシンボル名の前後に不等号括弧が付いていない形式で、 ストレージ・クラス C_WEAKEXT の外部シンボル名はシンボル名の前後に 文字 { および } が付いた形式で出力されます。

各シンボルについて、次の情報がリストされます。

• シンボルがインポートされたか、エクスポートされたか、またはエントリー・ポイントかを示す情報。* (アスタリスク) はエントリー・ポイントを、I はインポートされたシンボルを、E はエクスポートされたシンボルを示します。
• そのアドレス (インポートされたシンボルを除く)
• 長さと位置合わせ (CSECT シンボル、BSS シンボルの場合)
• ストレージ・マッピング・クラス
• シンボル・タイプ
• シンボル番号 (同じ名前のシンボルを区別するために使用)
• シンボル名
• 入力ファイル情報

ストレージ・マッピング・クラスとシンボル・タイプは、/usr/include/syms.h ファイル内で定義されます。 アドレス・マップには、最後の 2 桁のみ表示されますが、ストレージ・マッピング・クラス XMC_TC0 は T0 として表示されます。

入力ファイル情報は、入力ファイルのタイプに応じて異なります。 オブジェクト・ファイルの場合は、C_FILE シンボル・テーブル・エントリーから取り出されたソース・ファイル名がリストされます。 オブジェクトがアーカイブ・ファイルから取り出されると、そのオブジェクト・ファイル名は次のフォーマットでリストされます。

ArchiveFileName[ObjectName]

共用オブジェクト名は、{} (中括弧) で囲まれてリストされます。 共用オブジェクトがインポート・ファイルで定義されている場合は、共用オブジェクト名の前にインポート・ファイル名がリストされます。

インポート・シンボルのシンボル・タイプは ER ですが、関連するファイル入力情報があります。 未定義のシンボルも、シンボル・タイプ ER と共にリストされますが、シンボル番号を除く他のすべての欄は空白になっています。

-T フラグおよび -D フラグ (つまり pT オプションまたは pD オプション) は、これらのアドレス・マップで出力されるアドレスに影響を与えます。 マシン・レベルでデバッグする場合は、シンボルが実行時と同じアドレスでリストされるようにアドレスを選択すると便利です。 プライベート・モードでロードされた共有オブジェクトを使用しない 32 ビット・プログラムの場合、-bpT:0x10000000 オプションおよび -bpD:0x20000000 オプションで指定して正しいアドレスを選択できます。 この 2 つのオプションは、デフォルトでは /etc/xlC.cfg ファイルまたは /etc/vac.cfg ファイル内に定義されます。

環境変数

以下の環境変数が、ld コマンドの実行に影響を与えます。

例

1. 数個のオブジェクト・ファイルをリンクして a.out ファイルを作成し、オペレーティング・システムの下で実行するには、次のように入力します。

   ld /usr/lib/crt0.o pgm.o subs1.o subs2.o -lc

   -lc (L の小文字) は、libc.a ライブラリーをリンクします。 これより簡単なリンク方法は、次のように cc コマンド (コンパイラー) を使用してファイルをリンクすることです。

   cc  pgm.o  subs1.o  subs2.o

2. 出力ファイルの名前を指定するには、次のように入力します。

   cc  -o pgm  pgm.o  subs1.o  subs2.o

   これによりファイル pgm 内に出力が作成されます。
3. オブジェクト・ファイル subs1.o だけが変更されている場合に pgm を再リンクするには、次のように入力します。

   cc -o pgm subs1.o pgm

   オブジェクト・ファイル pgm.o と subs2.o から取り出された CSECT は、ファイル pgm から読み取られます。 この手法は、プログラムが多くの入力ファイルから構成されており、一度に変更するファイルが少ない場合に、リンク処理を迅速に行うことができます。
4. ライブラリー・サブルーチンとリンクするには、次のように入力します。

   cc  pgm.o  subs1.o  subs2.o  mylib.a  -ltools

   これにより、オブジェクト・モジュール pgm.o、subs1.o、subs2.o と mylib.a アーカイブからのサブルーチン、および -l (L の小文字) フラグで指定されたライブラリー (これは /usr/lib/libtools.a ファイルを意味します) からのサブルーチンがリンクします。
5. 共用オブジェクト・ファイルを生成するには、次のように入力します。

   ld -o shrsub.o subs1.o subs2.o -bE:shrsub.exp -bM:SRE -lc

   これは、オブジェクト・ファイル subs1.o、subs2.o と、-lc フラグで指定したライブラリー libc.a からのサブルーチンをリンクします。 これは、ファイル shrsub.exp で指定されたシンボルをエクスポートし、リンクされた共用オブジェクトをファイル shrsub.o. に保管します。-bM:SRE は、リンクされているオブジェクト・ファイルに共用オブジェクト・フラグをセットします。
6. 上記で生成された共用オブジェクト・ファイル shrsub.o とリンクするには、次のように入力します。

   cc -o pgm pgm.o shrsub.o -L '.'

   これは、オブジェクト・ファイル pgm.o を、shrsub.o のエクスポートされたシンボルとリンクします。リンクされた出力は、オブジェクト・ファイル pgm に保管されます。 -L '.' は、システム・ローダーが共用オブジェクト shrsub.o を見つけるために使用するライブラリー検索パスに、現行ディレクトリーを追加します。 実行時には、ディレクトリーに shrsub.o ファイルのインスタンスがあるか、/usr/lib 標準ライブラリー・ディレクトリーに shrsub.o ファイルがある場合にのみ、このプログラムがロードされます。 このプログラムをどこからでも実行できるようにするには、オプション -L`pwd` を使用します。

   システム・ローダーによって検索されるディレクトリーのリストは、dump コマンドを使用して表示できます。

7. 非共用ライブラリーとして libc.a ライブラリーを使用するプログラムをリンクするには、次のように入力します。

   cc -o pgm pgm.o -bnso -bI:/lib/syscalls.exp

   これは、pgm.o を必要なサポート・ライブラリーにリンクして、その結果生成される出力ファイルを pgm と命名します。 cc コマンドの場合、libc.a ライブラリーが必要なサポート・ライブラリーです。通常このライブラリーが、ユーザーのプログラムに共有ライブラリーとしてリンク・エディットされます。 この例では、-bnso オプションで ld コマンドに非共用ライブラリーとして libc.a ライブラリーをリンクするよう指示しています。また -bI:/lib/syscalls.exp は、ld コマンドにカーネルまたは /usr/lib/boot/unix ファイルに実際に含まれるシステム・コール関数をインポートするよう指示します。 -bnso オプションでリンクする場合、この例で -bI:/lib/syscalls.exp オプションによって行われたように、共有オブジェクト内でインポートとエクスポートの両方 (つまりパススルー) が行われたすべてのシンボルを、常に明示的にインポートしなければなりません。
   注: /usr/lib/libc.a が非共用リンクされる場合は、 フラグ -bI:/lib/syscalls.exp を使用しなければなりません。 オペレーティング・システムの更新リリースがインストールされると、常にアプリケーションを再リンクする必要があります。 静的にリンクされたアプリケーションは、修正レベルまたはリリース・レベルから他の修正または リリース・レベルにバイナリーで移植されません。

ファイル