全网最全-Version Script以及__asm__((".symver xxx"))使用总结

首先提醒一点，一切的前提建立在你的名字必须要mangling,不然无论你写的version script还是__asm__都不会起任何效果

Version Script简单用法:

这是一个典型例子，这个例子表示我们first*和second*的符号都会被export并且绑定1.0.6的版本号，同时local *表示除却上面的first*和second*之外，剩下来的符号都是local的。同时，当你""来帮助含有*的名字，这是通配符就不会起作用，而是逐字翻译了

我们再来看另外一个例子，我们首先定义了一个简单的函数，然后写了一个version script

当编译好对应的库之后-Wl,--version-script=xxx.map,我们通过readelf -V查看可以发现有.gnu_version_d的信息。随后当我们用main.cpp去link，最终我们readelf -s查看a.out的时候，我们可以看到如下的版本信息

这里的VERSION_1就是我们之前带的版本信息，此时当我们修改原来的库，比如把VERSION_1改成VERSION_2，再去运行我们之前编译好的app,提示如下信息并且报错不能运行

已经很像glibc的场景了，这个时候如果我们把版本信息直接干掉，直接编译这个动态库即不加任何的version script，提示如下

可以看到虽然他有warning,但是一样是可以运行的

__asm__(.symver)配合名称alias + version script用法

好了，接下来我们来开始难点的，这一次我们使用__asm__(".symver xxx, xxx@xxx")来做配合，注意这里的用法必须要配合linker version script,否则会报错

比如我们有如下的例子

又有一个东西值得先说一下，就是全局如果出现两个相同的符号，那么只能存在一个@@（表示默认，即如果新的程序跟你的库做linking，那么他是默认其效果的那个），另外用了__asm__的语法一般就表示你有多个不同版本的实现指向同一个符号来做alias了。 同时如果新库不存在任何的版本信息，你势必要用@@来表示，不然他会提示找不到符号。

结合我们刚刚代码的__asm__，我们必须有对应的version node,即我们的version script，比如如下：

同样的，这个名字也需要mangling，并且是我们刚刚__asm__后面的alias的名字，表示导出。另外VERSION_3和VERSION_4的顺序其实也很重要，出现在前面的会被默认选择 - 也就是当你之前的库在linking的时候是不带版本信息的app, 那么他在选择的时候默认选择你version script对于导出符号的第一个实现。

以上的情况是当你的API不变，但是实现变化的情况下，你需要用到__asm__ + version script来取别名保证ABI兼容，但是如果本身他把你的API给改变了呢？这种情况下，除了上述需要做的工作都要做一遍之外，你还需要做一个额外的工作，就是把你的header file重新定义成

这样只有当你的程序进行编译的时候使用了-DSIMPLELIB_VERSION_3_0的时候，你的函数签名才会变成带两个参数的，否则就是一个参数的函数原型。以此来支持不同的版本的编译

当你的程序本身在链接的时候没有用版本信息，但是之后因为开始用版本信息的话，你需要把你原来的签名改成

注意最后的@特别有用，他表示不带版本信息， 当然你也可以直接把原来的函数带过来，比如

一样可以成功运行，但是当你把这个@不带版本的和这个普通函数一起开放

你会发现无论你最终怎么改变顺序，运行的始终是那个@的不带版本的函数版本。可以推断整个linker的查找顺序先找@@,再找@，再找无符号

总结:

1. 你可以只使用version script的版本，这种情况下，你就没有使用命令alias的能力，你单单只是在命名版本，为以后做兼容
2. 当你使用__asm__的情况下，你必须配合你的version script来使用，即你在__asm__后面的@跟着的version node必须也要出现在你的version script里
3. 对于同一个符号，当前仅有一个@@,剩下的用@表示。 如果一个符号只有一次出现，那么你应该使用@@,不然linking会提示找不到符号，这个在上面也提到过了
4. Version Node的顺序也很关键，出现在前面的，会在你之前linking不带版本信息的app里优先被使用
5. 有意思的是无论你用disassembly或者gdb来查看binary中的符号，你会发现不带任何的版本信息在里面
6. 用nm并一定能看出version information,你需要使用的是readelf -s这个比较全
7. 你也可以直接让你的version node置为空（unnamed node）这个的用法就很明确了，他只要是为了让你对一些符号做export(global / local)
8. Version Script带来的另外一个非常有用的副效果就是他可以利用global / local来给你做symbol visibility，他非常优雅，因为你因此可以不用修改任何的源代码
9. 这个方法默认就有向前兼容性，假设我们一开始的库不带任何的版本信息，然后编译出来一个app, 随后即使你这个库加了@@或者@,只要你的最终alias是他本身的API，仍然可以找到，并且会找第一个。但是有一个区别就是当我们要linking新的程序时候，必须要保证此时代码里有@@表示默认的情况，否则会提示找不到符号。