带版本号的符号 versioned symbol

小小疏忽，折腾了我近一天的时间，不过总算弄清了个大概。
碰到几次带版本的符号的连接问题，令人头疼。
终于狠下心来，花了两天时间把info ld Scripts看了一遍，感觉大有长进。
突然有股冲动，想译完ld script部分。

                              带版本号的符号
                           E-mail: [e-mail]


*难免有错误，欢迎指导*

内容简介
---------
0 前提
1 带版本号的符号的定义
2 连接到带版本的符号
3 GNU扩充
4 我的疑问
5 英文搜索关键字
6 我的参考

                              带版本号的符号
                           E-mail: [e-mail]


*难免有错误，欢迎指导*

内容简介
---------
0 前提
1 带版本号的符号的定义
2 连接到带版本的符号
3 GNU扩充
4 我的疑问
5 英文搜索关键字
6 我的参考


0. 前提

-- 只限于ELF文件格式
-- 以下讨论用gcc

1. 带版本号的符号的定义(共享库内)

文件b.c内容如下，
int old_true()
{
        return 1;
}

int new_true()
{
        return 2;
}

写连接器的版本控制脚本，本例中为b.lds，内容如下
VER1.0{
    new_true;
};
VER2.0{
};

$gcc -c b.c
$gcc -shared -Wl,--version-script=b.lds -o libb.so b.o

可以在{}内填入要绑定的符号，本例中new_true符号就与VER1.0绑定了。
那么如果有一个应用程序连接到该库的new_true符号，那么它连接的就是VER1.0版本的new_true符号

如果把b.lds更改为，
VER1.0{
};
VER2.0{
    new_true;
};

然后在生成libb.so文件，在运行那个连接到VER1.0版本的new_true符号的应用程序，可以发现该应用程序不能运行了，
因为库内没有VER1.0版本的new_true，只有VER2.0版本的new_true。


2. 连接到带版本的符号
写一个简单的应用(名为app)连接到libb.so，应用符号new_true
假设libb.so的版本控制文件为，
VER1.0{
};
VER2.0{
    new_true;
};

$ nm app | grep new_true
         U new_true@@VER1.0
$
用nm命令发现app连接到VER1.0版本的new_true

3. GNU的扩充
它允许在程序文件内绑定 *符号* 到 *带版本号的别名符号*

文件b.c内容如下，
int old_true()
{
        return 1;
}

int new_true()
{
        return 2;
}
__asm__( ".symver old_true,true@VER1.0" );
__asm__( ".symver new_true,true@@VER2.0" );


其中，带版本号的别名符号是true，其默认的版本号为VER2.0

供连接器用的版本控制脚本b.lds内容如下，
VER1.0{
};
VER2.0{
};

版本控制文件内必须包含版本VER1.0和版本VER2.0的定义，因为在b.c文件内有对他们的引用

****** 假定libb.so与app.c在同一目录下 ********

以下应用程序app.c连接到该库，
int true();
int main()
{
    printf( "%d ", true );
}

$ gcc app.c libb.so
$ LD_LIBRARY_PATH=. ./app
2
$ nm app | grep true
         U true@@VER2.0
$

很明显，程序app使用的是VER2.0版本的别名符号true，如果在b.c内没有指明别名符号true的默认版本，
那么gcc app.c libb.so将出现连接错误，提示true没有定义。

也可以在程序内指定特定版本的别名符号true，程序如下，
__asm__( ".symver true,true@VER1.0" );
int true();
int main()
{
    printf( "%d ", true );
}

$ gcc app.c libb.so
$ LD_LIBRARY_PATH=. ./app
1
$ nm app | grep true
         U true@VER1.0
$

显然，连接到了版本号为VER1.0的别名符号true。其中只有一个@表示，该版本不是默认的版本




我的疑问：
    版本控制脚本文件中，各版本号节点之间的依赖关系


英文搜索关键字：
    .symver
    versioned symbol
    version a shared library

参考：
    info ld, Scripts node