バイナリー互換性

以下のタイプのオブジェクト・ファイルを libc + + ABI として参照してください。これは、オブジェクト・ファイルのベースとなる C++ 標準ライブラリー実装を示します。

• IBM Open XL C/C++ for AIXで作成された C++ オブジェクト・ファイル。 これらのオブジェクト・ファイルは、C++ ランタイム・ライブラリー libc++.a、 libc++abi.a、および libunwind.aによって提供されるインターフェースを使用します。これらはそれぞれ、 libc++.rte、 libc++abi.rte、および libunwind.rte ファイルセットからのものです。
• IBM XL C/C++ for AIX 16.1.0の Clang ベース・フロントエンドで作成された C++ オブジェクト・ファイル。 これらのオブジェクト・ファイルは、 libc++.rte ファイルセットからの C++ ランタイム libc++.aによって提供されるインターフェースを使用します。

同様に、以下のタイプのオブジェクト・ファイルを libC ABI として参照してください。

• IBM XL C/C++ for AIX 16.1.0 以前のリリースの XL ベース・フロントエンドで作成された C++ オブジェクト・ファイル。 オブジェクト・ファイルは、 xlC.rte ファイルセットからの C++ ランタイム libC.aによって提供されるインターフェースを使用します。

libc + + ABI と libC ABI は互換性がありませんが、以下の条件がすべて満たされている場合は、ライブラリーを libc + + ABI または libC ABI のいずれかでビルドされたアプリケーションに使用できるように、共有オブジェクトを単一のライブラリーにパッケージすることができます。

• ライブラリー内の libc + + ABI または libC ABI 共用オブジェクトは、相互に排他的です。
• C++ API 表面を表すライブラリー内の各共有オブジェクトは、libc + + ABI および libC ABI のいずれか 1 つのみをサポートします。
• これらの ABI からエクスポートされたシンボルは非結合です。
• libc + + ABI と libC ABI の間に相互参照はありません。

libc + + ABI および libC ABI 内のマングルされた C++ シンボルは結合されていません。 C/C++ 共有オブジェクトの ABI 間でシンボル名が重複しないようにするために、グローバル変数や C 関数などのシンボル名を変更して、シンボル名の ABI をエンコードすることをお勧めします。 例えば、ID を変更するか、GNU asm ラベルを使用することによって、関数名を別の名前にマップすることができます。 次の例では、名前 externCFunctionV2 が libc + + ABI の externCFunction 関数に使用され、その元の名前 externCFunction が libC ABI で使用されます。

#if defined(_AIX) && defined(__clang__)
  extern "C" void externCFunction(void) asm("externCFunctionV2");
#else
  extern "C" void externCFunction(void);
#endif

例
以下の例は、libc + + ABI と libC ABI の両方をサポートするために、単一ソースからデュアル ABI ライブラリーをビルドする方法を示しています。

$ cat build_example.sh
#!/usr/bin/ksh
rm -f xlc.shr.o ibmclang.shr.o libfunc.a xlc.a.out ibmclang.a.out
xlC -qmkshrobj func.cpp -o xlc.shr.o -bE:xlc.exp
ibm-clang++_r -shared func.cpp -o ibmclang.shr.o -bE:ibmclang.exp
ar -v -q libfunc.a xlc.shr.o ibmclang.shr.o
xlC main.cpp -o xlc.a.out libfunc.a -blibpath:.:/usr/lib
ibm-clang++_r main.cpp -o ibmclang.a.out libfunc.a -blibpath:.:/usr/lib

$ cat func.hpp
#include <iostream>

#if defined(_AIX) && defined(__clang__)
extern "C" void bar(void) asm("bar2");
#else
extern "C" void bar(void);
#endif

void func(void);

$ cat func.cpp
#include "func.hpp"

#if defined(_AIX) && defined(__clang__)
#define BUILD_COMPILER "build compiler is ibm-clang++_r"
#else
#define BUILD_COMPILER "build compiler is xlC"
#endif

void func(void)
{
  std::cout << "func(): " << BUILD_COMPILER << std::endl;
}

extern "C" void bar(void)
{
  std::cout << "bar(): " << BUILD_COMPILER << std::endl;
}
$ cat main.cpp
#include "func.hpp"

int main() {
  func();
  bar();
  return 0;
}
$ cat xlc.exp
#!
func__Fv
bar
$ cat ibmclang.exp
#!
_Z4funcv
bar2
$ build_example.sh
$ xlc.a.out
func(): build compiler is xlC
bar(): build compiler is xlC
$ ibmclang.a.out
func(): build compiler is ibm-clang++_r
bar(): build compiler is ibm-clang++_r
$

この例では、 xlC または ibm-clang++_r コマンドを使用して作成された main プログラムは、 func 関数と bar 関数の両方をデュアル ABI ライブラリーから呼び出すことができます。 libfunc.a の共有オブジェクト ibmclang.shr.o は、 IBM Open XL C/C++ コンパイラーを使用して作成されます。 共有オブジェクトは、 IBM Open XL C/C++ for AIX と、 IBM XL C/C++ for AIX 16.1.0の Clang ベース・フロントエンドの両方で使用できます。 ibmclang.shr.o は IBM Open XL C/C++ コンパイラーの C++ ランタイムに依存しているため、 IBM XL C/C++ for AIX 16.1.0 の Clang ベース・フロントエンドによって生成されたアプリケーションは、適切なバージョンの IBM Open XL C/C++ for AIX ランタイムをシステム上で使用可能にする必要があります。 同様に、 ibmclang.shr.o は、 IBM XL C/C++ for AIX 16.1.0 の Clang ベース・フロントエンドを使用して作成することもでき、 IBM Open XL C/C++ for AIX と IBM XL C/C++ for AIX 16.1.0の Clang ベース・フロントエンドの両方で使用できます。

AIX コマンド lddを使用して、実行可能ファイルのロード依存関係を確認できます。 上記の例では、 xlc.a.out および ibmclang.a.out で ldd を使用した場合の出力を以下に示します。

$ ldd xlc.a.out
xlc.a.out needs:
     ...
     /usr/lib/libC.a(shr.o)
     ...
     /usr/lib/libC.a(shrcore.o)
     /usr/lib/libC.a(ansi_32.o)
     /usr/lib/libC.a(ansicore_32.o)
$ ldd ibmclang.a.out
ibmclang.a.out needs:
     ...
     /usr/lib/libc++.a(shr2.o)
     /usr/lib/libc++abi.a(libc++abi.so.1)
     /usr/lib/libunwind.a(libunwind.so.1)
     /usr/lib/libc++.a(libc++.so.1)
     ...
$