二进制兼容性

将以下类型的对象文件称为 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 中的一个。
• 从这些 ABI 导出的符号是不连接的。
• 在 libc + + ABI 与 libC ABI 之间没有交叉引用。

Libc + + ABI 和 libC ABI 中的混合 C++ 符号不相关。 为了防止符号名称在 C/C++ 共享对象的 ABI 之间重叠，建议重命名诸如全局变量和 C 函数之类的符号以对符号名称中的 ABI 进行编码。 例如，您可以通过更改标识或使用 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

示例
以下示例显示如何从单个源构建双 ABI 库以同时支持 libc + + ABI 和 libC 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 程序可以从 dual-ABI 库调用 func 和 bar 函数。 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++ 运行时，因此基于 Clang 的 IBM XL C/C++ for AIX 16.1.0 前端生成的应用程序需要在系统上提供相应版本的 IBM Open XL C/C++ for AIX 运行时。 同样， ibmclang.shr.o 也可以使用基于 Clang 的前端 IBM XL C/C++ for AIX 16.1.0 进行构建，并由 IBM Open XL C/C++ for AIX 和基于 Clang 的前端 IBM XL C/C++ for AIX 16.1.0使用。

您可以使用 AIX 命令 ldd来确认可执行文件的装入依赖关系。 以下是在以上示例中使用 ldd on xlc.a.out 和 ibmclang.a.out 的输出:

$ 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)
     ...
$