ld コマンド

目的

オブジェクトファイルをリンクする。

構文

ld [ -D Number ] [ -e Label ] [ -G ] [ -H Number ] [ -K ] [ -m ] [ -M ] [ -o Name ] [ -r ] [ -s ] [ -S Number ] [ -T Number ] [ -u Name ] ... [ -v ] [ -V ] [ -z ] [ -Z String ] ... [ -b Option ] ... [ -L Directory ] ... { -f FileID ... -l Name ... InputFile ... }

ld -bsvr4 [ -d[y | n] ] [ -D Number ] [ -e Label ] [ -G ] [ -H Number ] [ -K ] [ -m ] [ -M ] [ -o Name ] [ -r ] [ -R Path ] [ -s ] [ -S Number ] [ -T Number ] [ -u Name ] ... [ -v ] [ -V ] [ -z [ defs | nodefs ] ] [ -z multidefs ] [ -z [text | nowarntext | warntext ] ] ] [ -Z String ] ... [ -b Option ] ... [ -L Directory ] ... { -f FileID ... -l Name ... InputFile ... }

説明

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

ld コマンドは、すべての入力オブジェクト・ファイルをリストすることなく、プログラムを再リンクすることができる。 例えば、大規模なプログラムのオブジェクト・ファイルが1つ変更された場合、新しいオブジェクト・ファイルと古いプログラムをコマンド・ラインにリストアップし、プログラムが必要とする共有ライブラリも一緒にリストアップすることで、プログラムを再リンクすることができる。 詳しくは例を参照。

ld コマンドは、コマンド行で指定された順序で入力ファイルをリンクします。 同じファイルを複数回指定すると、そのファイルの最初のオカレンスのみが処理されます。 -bI、 -bimport、 -bkeepfile、 -f、 -l フラグ、またはパラメータとして、少なくとも1つの入力ファイルを指定する。 InputFile パラメータで指定する。 -bI、 -bimport、 -bkeepfile フラグは、 I、 import、 keepfile オプションと一緒に使われる -b フラグである。

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

リンク・モード

ld コマンドは32ビット・オブジェクトとプログラム、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 Nameの形式で -l フラグを使用します。 最後の形式は、 libName.a ファイルを指定します。または、 rtl オプションが使用されている場合は、複数のディレクトリーで検索される libName.so ファイルを指定します。 これらの検索ディレクトリーには、 -L フラグおよび標準ライブラリー・ディレクトリー /usr/lib と /lib が指定するディレクトリーが含まれる。

注意： 共有オブジェクト、または共有オブジェクトを含むアーカイブファイルを、 -l Name フラグの代わりに絶対パス名または相対パス名で指定した場合、パス名は出力ファイルのloaderセクションのインポートファイルID文字列に含まれます。 -bnoipath オプションによってこの動作をオーバーライドできます。

処理中

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

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

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

-r フラグまたは -bnox オプションを指定するか、リンク中にエラーが報告されない限り、 ld コマンドが生成する出力ファイルには実行権限が設定されている。 深刻なエラーが発生した場合、または入力ファイルとして出力ファイルが指定され、何らかのエラーが発生した場合、既存の出力ファイルは上書きされない。

シンボル

ld コマンドは、以下の事前定義シンボルを使用して特殊なアドレス・ロケーションを提供し、C 構文で extern char name[ ]として宣言できます。 以下の表はシンボル名の説明である：

項目	説明
_text	プログラムの最初のロケーションを指定します。
_etext	プログラムの後の最初のロケーションを指定します。
_data	データの最初のロケーションを指定します。
_edata	初期化されたデータの後の最初の位置を指定する。
_end または end	すべてのデータの後の最初のロケーションを指定します。

これらのシンボルを使用するには、そのアドレスを指定しなければなりません。 入力ファイルがこれらのシンボルのいずれかを再定義すると、予期しない結果になる可能性があります。 コンパイラーは、関数ポインターを使用して呼び出しをインプリメントするために、追加の事前定義シンボル _ptrglを使用します。

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

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

CSECT は、コードまたはデータの非表示ユニットです。 CSECT は、他の CSECT に入っているシンボルを参照する再配置エントリー (RLD) が入っていると、その CSECT を参照します。 参照先の 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 コマンドラインに -bsvr4 オプションがある場合、 -R と -z オプションは再定義される。

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

フラグ

ld コマンドは、XPG ユーティリティー構文ガイドラインに準拠しています。ただし、引数 — は次のオペランドにのみ適用され、コマンド行の残りのオペランドには適用されません。 例えば、コマンド・ラインに 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のデフォルト値はNULL文字列なので、デフォルトのコマンドラインは以下のようになる：

/usr/ccs/bin/bind quiet

オプション (-b オプション)

# 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 キーワードを使用すると、エクスポートされたシンボルとしてマークされていなくても、出力ファイルのローダー・セクションにシンボルがリストされるようにすることができます。 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ビットのインポートファイルオプション

  表 6.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 ）である場合、ローダーセクションに配置されるファイル名は、インポートファイル名とインポートファイルの #! 行の内容に基づいて、以下のように決定される：

  表7. インポートファイルの「#!行の内容

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

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

# autoload
#! (shr.so)

必要に応じて、追加のメンバー名をさらに多くの行にリストすることができます。 shr.so からインポートされたシンボルは shr.so 自体から読み取られるため、インポート・ファイル内のシンボル名をリストする必要はありません。

共有ライブラリーの作成について詳しくは、 create_shared_lib サブルーチンを参照してください。 ロードおよびバインドの詳細については、 load サブルーチンを参照してください。

order_file format

order_fileフォーマットファイルで指定されたシンボルは、「-border_fileフラグが使 用されている場合、同じストレージマッピング・クラスの他のシンボルよりも 前にマッピングされる。

<symbol-name> <white-space> <optional-smc-or-index> <white-space> <optional-object-module>

以下は、 order_file 形式のファイルを作成するためのガイドラインです：

• オプションの'<optional-smc-or-index>と'<optional-object-module>フィールドが'order_fileフォーマットファイルに記述されていない場合、'<symbol-name>フィールドに指定された値がグローバル名として使用される。
• 行頭のハッシュタグ（#）またはアスタリスク（*）、あるいは行の任意の位置で空白を含む'#または'*文字は、コメントを示す。 その行がコメントとして認識されている場合、残りの行は無視される。
• <symbol-name>フィールドの値には、タブ、空白、改行以外のあらゆる文字を含めることができる。 ただし、「<symbol-name>フィールドの値は、「#または「*文字で始まってはならない。
• <optional-smc-or-index>フィールドは以下のいずれかの値を取ることができる：
  • [<smc>]: '[<smc>]オプションは、ストレージ・マッピング・クラスを指定する。 ストレージ・マッピング・クラスは'/usr/include/syms.hファイルで定義されている。 TC0という名前の目次（TOC）アンカーは、ストレージ・マッピング・クラスとしては使えない。
  • %<number>: '%<number>オプションはシンボルテーブルのインデックスを指定する。
• <optional-object-module>フィールドは以下のいずれかの値を取ることができる：
  • <<pathname>>: <pathname> オプションは、 object_file ファイルのパスを指定する。 パス名は'<>ブラケットで囲まなければならない。
  • <<pathname>(<member>)>>: '(<member>)オプションはアーカイブメンバーを指定する。 アーカイブ・メンバー名は'()括弧で囲む必要がある。 <pathname> ( <member> ) の値全体を角括弧 (<>) で囲む必要があります。

  オブジェクト・モジュール名には、開き角括弧、閉じ角括弧、開き括弧、閉じ括弧を含んではならない。 <パス名>の値が'/で始まる場合、パス名は絶対一致でなければならない。 <パス名>の値は、一意に一致するものが見つかれば、先頭のディレクトリ名をいくつでも削除して短くすることができる。

• ハイフン（-）を1つ指定すると、名前のない記号を指定できる。 <symbol- name >フィールドに名前のないシンボルを指定する場合は、 <optional-smc-or-index> フィールドを使用してシンボルテーブルのインデックスを指定し、 <optional-object-module> フィールドを使用して object_file ファイルパス名を指定してください。
• <optional-smc-or-index>フィールドが指定されず、'<optional-object-module>フィールドが指定された場合、TOC記号（TCまたはTE）は無視される。
• <optional-smc-or-index>フィールドが指定され、'<optional-object-module>フィールドが指定されない場合、'<optional-smc-or-index>フィールドに指定できるのは'[<smc>]オプションのみである。 この場合、'<symbol-name>フィールドで指定され、指定されたストレージマッピング・クラスを持つシンボルが選択される。
• シンボル名、シンボルテーブルのインデックス、および「<optional-object-module>フィールドを指定し、シンボルテーブルのインデックスが指定したシンボル名のシンボルを指している場合、このシンボル値が選択される。
• ストレージマッピング・クラスと'<optional-object-module>フィールドに値を指定すると、指定されたストレージマッピング・クラスを持つシンボルが選択される。
  注：TOCアンカーは決して選択できない。
• 選択されたシンボルが出力ファイルに保存されない場合、そのシンボルはガベージコレクションとみなされる。 システムは、'order_fileフォーマットファイル中の、出力ファイルに保存されていないシンボルの行を無視する。

.foo                        # Denotes a global symbol, probably a function.
.foo1 <obj1.o>              # Denotes a symbol in obj1.o, but not a TOC symbol.
.foo2 <libxxx.a(maxi64.o)>  # Denotes a  symbol in an archive member, but not a TOC symbol.
var [TC]                    # Denotes the unique TOC symbol referring to a global variable.
foo1 [TC] <obj1.o>          # Denotes the TOC symbol in obj1.o.
var2 %99 <obj2.o>           # Denotes the symbol ‘var2’ with symbol table index 99 in obj2.o.
-  %17 <obj3.o>             # Denotes the unnamed symbol with symbol table index 17 in obj3.o.

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

ランタイム・リンクを使用する場合、同じモジュール内のシンボルへの参照は、シンボルが適切な属性でエクスポートされた場合にのみリバウンドできます。 symbolic 属性を持つシンボルへの参照をリバウンドすることはできません。 nosymbolic 属性を持つシンボルへの参照は、リバウンドできます。 nosymbolic- 属性を持つシンボルへの参照は、シンボルが変数の場合はリバウンドできます。 関数シンボルの場合、関数ポインターを使用した呼び出しはリバウンドできますが、直接関数呼び出しはリバウンドできません。 nosymbolic- 属性がデフォルトです。この属性は、オペレーティング・システムのこれまでのバージョンとの互換性のために提供されますが、お勧めできません。

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

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

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

weak エクスポート属性は、関連するシンボルのマッピング・タイプを、ローダー・セクションの 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 はエクスポートされたシンボルを示します。
• そのアドレス (インポートされたシンボルを除く)
• 長さおよびアライメント（ CSECTs および 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 コマンドは libc.a ライブラリをリンクする。 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 にあった CSECTs は、ファイル pgm から読み込まれる。 この手法は、プログラムが多くの入力ファイルから構成されており、一度に変更するファイルが少ない場合に、リンク処理を迅速に行うことができます。
4. ライブラリー・サブルーチンとリンクするには、次のコマンドを入力します。

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

   これは、オブジェクト・モジュール pgm.o、 subs1.o、 subs2.o、 mylib.a アーカイブのサブルーチン、 -l フラグで指定されたライブラリーのサブルーチンをリンクする。 つまり、 /usr/lib/libtools.a 。
5. 共有オブジェクトを生成するには、次のコマンドを入力します。

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

   これにより、 -lc フラグで指定されたライブラリー libc.a から、オブジェクト・ファイル subs1.o、 subs2.o、およびサブルーチンがリンクされます。 これは、ファイル 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 ファイルのインスタンスを含むディレクトリーから実行される場合、または shrsub.o ファイルが /usr/lib 標準ライブラリー・ディレクトリーで検出される場合にのみ、このプログラムがロードされます。 プログラムをどこからでも実行できるようにするには、オプション -L `pwd`を使用します。

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

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

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

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

ファイル