[devel] version scripts

[devel] version scripts

[Igor Zubkov]

Hi!

Вот решил сделать тестовый version script для libasyncns. Для начала
надо получить список всех символов из библиотеки:
[icesik@iceberg .libs]$ nm -D libasyncns.so.0.1.0 |awk 'NF==3{print$2,$3}'
A __bss_start
A _edata
A _end
T _fini
T _init
T asyncns_cancel
T asyncns_fd
T asyncns_free
T asyncns_freeaddrinfo
T asyncns_getaddrinfo
T asyncns_getaddrinfo_done
T asyncns_getnameinfo
T asyncns_getnameinfo_done
T asyncns_getnext
T asyncns_getnqueries
T asyncns_getuserdata
T asyncns_isdone
T asyncns_new
T asyncns_res_done
T asyncns_res_query
T asyncns_res_search
T asyncns_setuserdata
T asyncns_wait
[icesik@iceberg .libs]$

Так вот, я прав:
1) что нужны только символы с пометкой T?
2) что T _fini и T _init не нужно добавлять в version script?

-- 
icesik

Re: [devel] version scripts

[Alexey Shabalin]

29 мая 2008 г. 19:55 пользователь Igor Zubkov написал:
> Hi!
>
> Вот решил сделать тестовый version script для libasyncns. Для начала
> надо получить список всех символов из библиотеки:
>
> Так вот, я прав:
> 1) что нужны только символы с пометкой T?
> 2) что T _fini и T _init не нужно добавлять в version script?

Господа знающие, и мне проведите ликбез пожалуйста.
Тоже делаю версионирование для новой libgnet (она особо и не нужна
никому - делаю для понимания).
сравнивая версионирование, сделаное в libxml2 и в libpango вижу два
разных подхода:
1. в libxml описаны только добавленые символы в версиях, типа
LIBXML2_2.6.16 {
   global:
       xmlMemBlocks;
       xmlRelaxNGInitTypes;
};
2. в libpango сначала идёт полный перечень всех символов + local, а
потом описаны версии с включением предыдущей, типа
PANGO_1.18 {
   global:
   pango_font_face_is_synthesized;
} PANGO_1.14;

1.18 включает 1.14

Вопрос как делать правильно. Первого варианта можно добится используя
только rpmsodiff, второй более трудоёмкий.

-- 
Alexey Shabalin

Re: [devel] version scripts

[Igor Zubkov]

29.05.08, Alexey Shabalin написал(а):
> Господа знающие, и мне проведите ликбез пожалуйста.
>  Тоже делаю версионирование для новой libgnet (она особо и не нужна
>  никому - делаю для понимания).
>  сравнивая версионирование, сделаное в libxml2 и в libpango вижу два
>  разных подхода:
>  1. в libxml описаны только добавленые символы в версиях, типа
>  LIBXML2_2.6.16 {
>    global:
>        xmlMemBlocks;
>        xmlRelaxNGInitTypes;
>  };
>  2. в libpango сначала идёт полный перечень всех символов + local, а
>  потом описаны версии с включением предыдущей, типа
>  PANGO_1.18 {
>    global:
>    pango_font_face_is_synthesized;
>  } PANGO_1.14;
>
>  1.18 включает 1.14

http://abicheck.sourceforge.net/intro.html

-- 
icesik

Re: [devel] version scripts

[Pavlov Konstantin]

[-- Attachment #1: Type: text/plain, Size: 1125 bytes --]

On Thu, May 29, 2008 at 06:55:34PM +0300, Igor Zubkov wrote:
> Hi!
> 
> Вот решил сделать тестовый version script для libasyncns. Для начала
> надо получить список всех символов из библиотеки:
> [icesik@iceberg .libs]$ nm -D libasyncns.so.0.1.0 |awk 'NF==3{print$2,$3}'
> A __bss_start
> A _edata
> A _end
> T _fini
> T _init
> T asyncns_cancel
> T asyncns_fd
> T asyncns_free
> T asyncns_freeaddrinfo
> T asyncns_getaddrinfo
> T asyncns_getaddrinfo_done
> T asyncns_getnameinfo
> T asyncns_getnameinfo_done
> T asyncns_getnext
> T asyncns_getnqueries
> T asyncns_getuserdata
> T asyncns_isdone
> T asyncns_new
> T asyncns_res_done
> T asyncns_res_query
> T asyncns_res_search
> T asyncns_setuserdata
> T asyncns_wait
> [icesik@iceberg .libs]$
> 
> Так вот, я прав:
> 1) что нужны только символы с пометкой T?
> 2) что T _fini и T _init не нужно добавлять в version script?

Для начального списка я бы посмотрел в include-файлы.

-- 
С помощью chroot jail вы можете обезопасить систему от зачрутенного
сервиса гораздо надежнее, чем без использования чрутизации.
		-- ldv in sisyphus@

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] version scripts

[Igor Zubkov]

29.05.08, Pavlov Konstantin написал(а):
>  > Так вот, я прав:
>  > 1) что нужны только символы с пометкой T?
>  > 2) что T _fini и T _init не нужно добавлять в version script?
>
> Для начального списка я бы посмотрел в include-файлы.

А если проект весит 10 mb? А если ещё больше? Предлагаешь читать все
исходники? Зачем делать работу за nm?

-- 
icesik

Re: [devel] version scripts

[Pavlov Konstantin]

[-- Attachment #1: Type: text/plain, Size: 841 bytes --]

On Thu, May 29, 2008 at 07:50:32PM +0300, Igor Zubkov wrote:
> 29.05.08, Pavlov Konstantin написал(а):
> >  > Так вот, я прав:
> >  > 1) что нужны только символы с пометкой T?
> >  > 2) что T _fini и T _init не нужно добавлять в version script?
> >
> > Для начального списка я бы посмотрел в include-файлы.
> 
> А если проект весит 10 mb? А если ещё больше? Предлагаешь читать все
> исходники? Зачем делать работу за nm?

Не все символы, полученные nm, могут быть во внешнем API.

-- 
 * raorn орёт: "cyrus - наше ффсио!!!" и размахивает британским флагом
 * vorphalack рвёт британский флаг raorn`а на британский флаг с криком цытрусь -
   саксь, курьер-имап рулиз!!! )))
 * raorn рвёт на vorphalack
<MaxA>  блин... рванья накидали, пройти негде... :)
<AMike> опять обкурились
<lioka> теперь можно смеяццо и жечь тряпки

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] version scripts

[Igor Zubkov]

29.05.08, Pavlov Konstantin написал(а):
>  > >  > Так вот, я прав:
>  > >  > 1) что нужны только символы с пометкой T?
>  > >  > 2) что T _fini и T _init не нужно добавлять в version script?
>  > > Для начального списка я бы посмотрел в include-файлы.
>  > А если проект весит 10 mb? А если ещё больше? Предлагаешь читать все
>  > исходники? Зачем делать работу за nm?
> Не все символы, полученные nm, могут быть во внешнем API.

Вот я лю этом и спрашиваю. Только "T" или ещё какие-то?

-- 
icesik

Re: [devel] version scripts

[Mikhail Gusarov]

[-- Attachment #1: Type: text/plain, Size: 433 bytes --]

Twas brillig at 20:04:49 29.05.2008 UTC+03 when Igor Zubkov did gyre and gimble:

 >> Не все символы, полученные nm, могут быть во внешнем API.
 IZ> Вот я лю этом и спрашиваю. Только "T" или ещё какие-то?
"T" тоже могут не принадлежать внешнему API

-- 
JID: dottedmag@altlinux.org / dottedmag@jabber.dottedmag.net

[-- Attachment #2: Type: application/pgp-signature, Size: 196 bytes --]

Re: [devel] version scripts

[Alexander Bokovoy]

Игорь,

29 мая 2008 г. 21:04 пользователь Igor Zubkov <igor.zubkov@gmail.com> написал:
> 29.05.08, Pavlov Konstantin написал(а):
>>  > >  > Так вот, я прав:
>>  > >  > 1) что нужны только символы с пометкой T?
>>  > >  > 2) что T _fini и T _init не нужно добавлять в version script?
>>  > > Для начального списка я бы посмотрел в include-файлы.
>>  > А если проект весит 10 mb? А если ещё больше? Предлагаешь читать все
>>  > исходники? Зачем делать работу за nm?
>> Не все символы, полученные nm, могут быть во внешнем API.
>
> Вот я лю этом и спрашиваю. Только "T" или ещё какие-то?
поэтому и говорят: "Смотрите в include-файлы". API определяется именно
там и различия в коде между двумя версиями могут приводить к разнице в
API даже если символы в ELF не поменялись. В частности, могут
поменяться структуры данных, которые в ELF не отражены.

К тому же, не все публичные символы в ELF публичны с точки зрения API.
В некоторых особых случаях правила использования символов, отраженных
в ABI, определены лицензией. Например, распространено использование
LGPL+ограничения по плагинам (они могут использовать только символы
официального API, в противном случае лицензия GNU GPL).

Поэтому в любом случае нужно смотреть и анализировать реальное API для
того, чтобы делать выводы по версионированию ABI.
-- 
/ Alexander Bokovoy

Re: [devel] version scripts

[Igor Zubkov]

[-- Attachment #1: Type: text/plain, Size: 2544 bytes --]

29.05.08, Alexander Bokovoy<ab@altlinux.org> написал(а):
>  >>  > >  > Так вот, я прав:
>  >>  > >  > 1) что нужны только символы с пометкой T?
>  >>  > >  > 2) что T _fini и T _init не нужно добавлять в version script?
>  >>  > > Для начального списка я бы посмотрел в include-файлы.
>  >>  > А если проект весит 10 mb? А если ещё больше? Предлагаешь читать все
>  >>  > исходники? Зачем делать работу за nm?
>  >> Не все символы, полученные nm, могут быть во внешнем API.
>  >
>  > Вот я лю этом и спрашиваю. Только "T" или ещё какие-то?
>
> поэтому и говорят: "Смотрите в include-файлы". API определяется именно
>  там и различия в коде между двумя версиями могут приводить к разнице в
>  API даже если символы в ELF не поменялись. В частности, могут
>  поменяться структуры данных, которые в ELF не отражены.

Понятно.

>  К тому же, не все публичные символы в ELF публичны с точки зрения API.

Ага. Есть различная внутреняя кухня которую лучше не выставалять наружу.

>  В некоторых особых случаях правила использования символов, отраженных
>  в ABI, определены лицензией. Например, распространено использование
>  LGPL+ограничения по плагинам (они могут использовать только символы
>  официального API, в противном случае лицензия GNU GPL).
>
>  Поэтому в любом случае нужно смотреть и анализировать реальное API для
>  того, чтобы делать выводы по версионированию ABI.

Спасибо за советы, когда буду писать страницу на вики, надо будет это
всё туда добавить.

Итак, я сделал тестовый version script для libasyncns-0.3-alt2.
[icesik@iceberg SOURCES]$ cat libasyncns-0.3-vers.sym
LIBASYNCNS_0_3
{
	global:
		asyncns_cancel;
		asyncns_fd;
		asyncns_free;
		asyncns_freeaddrinfo;
		asyncns_getaddrinfo;
		asyncns_getaddrinfo_done;
		asyncns_getnameinfo;
		asyncns_getnameinfo_done;
		asyncns_getnext;
		asyncns_getnqueries;
		asyncns_getuserdata;
		asyncns_isdone;
		asyncns_new;
		asyncns_res_done;
		asyncns_res_query;
		asyncns_res_search;
		asyncns_setuserdata;
		asyncns_wait;
	local:
		*;
};
[icesik@iceberg SOURCES]$

Из этого списка убраны A символы и служебные (T _fini и T _init).
После сборки у libasyncns появляется новый интерфейс LIBASYNCNS_0_3
(это ведь так называется?) и новый Provides
libasyncns.so.0(LIBASYNCNS_0_3). Единственное приложение которое
линкуется с libasyncns pulseaudio после пересборки получает новую
бинарную зависимость на libasyncns.so.0(LIBASYNCNS_0_3). Ну и вопрос,
я всё правильно сделал? Если да, то я занесу это всё в вику для
потомков.

P.S.: нужные файлы для воспроизведение приложены.

-- 
icesik

[-- Attachment #2: libasyncns.spec.bz2 --]
[-- Type: application/x-bzip2, Size: 1106 bytes --]

[-- Attachment #3: libasyncns-0.3-alt-vers.patch.bz2 --]
[-- Type: application/x-bzip2, Size: 336 bytes --]

[-- Attachment #4: libasyncns-0.3-vers.sym.bz2 --]
[-- Type: application/x-bzip2, Size: 199 bytes --]

Re: [devel] version scripts

[Sergey Bolshakov]

>>>>> "Igor" == Igor Zubkov <igor.zubkov-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:
[skipped]

 > Итак, я сделал тестовый version script для libasyncns-0.3-alt2.
 > [icesik@iceberg SOURCES]$ cat libasyncns-0.3-vers.sym
 > LIBASYNCNS_0_3
 > {
 > 	global:
 > 		asyncns_cancel;
 > 		asyncns_fd;
 > 		asyncns_free;
 > 		asyncns_freeaddrinfo;
 > 		asyncns_getaddrinfo;
 > 		asyncns_getaddrinfo_done;
 > 		asyncns_getnameinfo;
 > 		asyncns_getnameinfo_done;
 > 		asyncns_getnext;
 > 		asyncns_getnqueries;
 > 		asyncns_getuserdata;
 > 		asyncns_isdone;
 > 		asyncns_new;
 > 		asyncns_res_done;
 > 		asyncns_res_query;
 > 		asyncns_res_search;
 > 		asyncns_setuserdata;
 > 		asyncns_wait;
 > 	local:
 > 		*;
 > };
 > [icesik@iceberg SOURCES]$

А ты уверен, что version script вообще нужен ?
Бишь, есть или будет изменение ABI без смены soname ?
Посмотрев (невнимательно) на svn проекта, я чего-то подобного
не усмотрел.

-- 

Re: [devel] version scripts

[Igor Zubkov]

[-- Attachment #1: Type: text/plain, Size: 1007 bytes --]

30.05.08, Sergey Bolshakov написал(а):
> А ты уверен, что version script вообще нужен ?
>  Бишь, есть или будет изменение ABI без смены soname ?
>  Посмотрев (невнимательно) на svn проекта, я чего-то подобного
>  не усмотрел.

Если брать именно libasyncns, то для него оно вроде и не нужно. Это
просто пакет для примера разбирательства с version scripts. Я могу и
другой выбрать.

Ок. Другой. gnome-keyring-2.22.1 или 2.22.2 (у них вроде ничего между
версиями не поехало):
[icesik@iceberg i586]$ rpmsodiff libgnome-keyring-2.22.1-alt1.i586.rpm
libgnome-keyring-2.22.2-alt1.i586.rpm
	common sonames:
libgnome-keyring.so.0	/usr/lib/libgnome-keyring.so.0.1.1	/usr/lib/libgnome-keyring.so.0.1.1

libgnome-keyring.so.0 definitions unchanged

vim:ft=diff
[icesik@iceberg i586]$

[icesik@iceberg .libs]$ nm -D libgnome-keyring.so.0.1.1 |awk
'NF==3{print$2,$3}' | wc -l
115
[icesik@iceberg .libs]$

Сделал аналогично, оставил только T символы в version script. Всё
остально не так интересно и в аттаче.

-- 
icesik

[-- Attachment #2: gnome-keyring.spec.bz2 --]
[-- Type: application/x-bzip2, Size: 2396 bytes --]

[-- Attachment #3: gnome-keyring-2.22.2-alt-vers.patch.bz2 --]
[-- Type: application/x-bzip2, Size: 363 bytes --]

[-- Attachment #4: libgnome-keyring-2.22.2-vers.sym.bz2 --]
[-- Type: application/x-bzip2, Size: 700 bytes --]

Re: [devel] version scripts

[Sergey Bolshakov]

>>>>> "Igor" == Igor Zubkov <igor.zubkov-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

 > 30.05.08, Sergey Bolshakov написал(а):
 >> А ты уверен, что version script вообще нужен ?
 >> Бишь, есть или будет изменение ABI без смены soname ?
 >> Посмотрев (невнимательно) на svn проекта, я чего-то подобного
 >> не усмотрел.

 > Если брать именно libasyncns, то для него оно вроде и не нужно. Это
 > просто пакет для примера разбирательства с version scripts. Я могу и
 > другой выбрать.

Сделай милость, выбери другой.

-- 

Re: [devel] version scripts

[Igor Zubkov]

30.05.08, Sergey Bolshakov написал(а):
>>> А ты уверен, что version script вообще нужен ?
>>> Бишь, есть или будет изменение ABI без смены soname ?
>>> Посмотрев (невнимательно) на svn проекта, я чего-то подобного
>>> не усмотрел.
>> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
>> просто пакет для примера разбирательства с version scripts. Я могу и
>> другой выбрать.
> Сделай милость, выбери другой.

Предложи свой вариант. Я уже два предложил.

-- 
icesik

Re: [devel] version scripts

[Pavlov Konstantin]

[-- Attachment #1: Type: text/plain, Size: 776 bytes --]

On Sat, May 31, 2008 at 12:03:24AM +0300, Igor Zubkov wrote:
> 30.05.08, Sergey Bolshakov написал(а):
> >>> А ты уверен, что version script вообще нужен ?
> >>> Бишь, есть или будет изменение ABI без смены soname ?
> >>> Посмотрев (невнимательно) на svn проекта, я чего-то подобного
> >>> не усмотрел.
> >> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
> >> просто пакет для примера разбирательства с version scripts. Я могу и
> >> другой выбрать.
> > Сделай милость, выбери другой.
> 
> Предложи свой вариант. Я уже два предложил.

Так если ничего не изменилось, то зачем?

-- 
Кстати,  а вынос  separator (0.2.1-alt1) в группу "Игры/Спорт" ---
трагическая случайность или экзистенциальная концептуальтность? :)
		-- avp in sisyphus@

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]

Re: [devel] version scripts

[Igor Zubkov]

31.05.08, Pavlov Konstantin написал(а):
>> Предложи свой вариант. Я уже два предложил.
> Так если ничего не изменилось, то зачем?

Затем что бы понять, сделал ли я их правильно (относительно того что я
понимаю в текущий момент) или не правильно. Вместо того что бы
упражнятся в остороумии, лучше бы посмотрел на то что я сделал и
сказал, правильно или нет.

-- 
icesik

Re: [devel] version scripts

[Alexey Shabalin]

31.05.08, Pavlov Konstantin написал(а):
> On Sat, May 31, 2008 at 12:03:24AM +0300, Igor Zubkov wrote:
>  > >> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
>  > >> просто пакет для примера разбирательства с version scripts. Я могу и
>  > >> другой выбрать.
>  > > Сделай милость, выбери другой.
>  >
>  > Предложи свой вариант. Я уже два предложил.
>
давай на примере gnet(libgnet) - он сейчас никому не нужен, а 2.0.7 и
2.0.8 разные по api версии
>
> Так если ничего не изменилось, то зачем?


-- 
Alexey Shabalin

Re: [devel] version scripts

[Igor Zubkov]

[-- Attachment #1: Type: text/plain, Size: 511 bytes --]

31.05.08, Alexey Shabalin написал(а):
> >  > >> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
>  >  > >> просто пакет для примера разбирательства с version scripts. Я могу и
>  >  > >> другой выбрать.
>  >  > > Сделай милость, выбери другой.
>  >  >
>  >  > Предложи свой вариант. Я уже два предложил.
>  >
>
> давай на примере gnet(libgnet) - он сейчас никому не нужен, а 2.0.7 и
>  2.0.8 разные по api версии

Если я правильно ошибаюсь, то version mapfile должен быть такой.

-- 
icesik

[-- Attachment #2: libgnet-2.0.7-vers.sym --]
[-- Type: application/octet-stream, Size: 5877 bytes --]

Re: [devel] version scripts

[Alexey Shabalin]

[-- Attachment #1: Type: text/plain, Size: 745 bytes --]

2008/5/31 Igor Zubkov :
> 31.05.08, Alexey Shabalin написал(а):
>> >  > >> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
>>  >  > >> просто пакет для примера разбирательства с version scripts. Я могу и
>>  >  > >> другой выбрать.
>>  >  > > Сделай милость, выбери другой.
>>  >  >
>>  >  > Предложи свой вариант. Я уже два предложил.
>>  >
>>
>> давай на примере gnet(libgnet) - он сейчас никому не нужен, а 2.0.7 и
>>  2.0.8 разные по api версии
>
> Если я правильно ошибаюсь, то version mapfile должен быть такой.
то есть этого в предыдущих версиях не было? раз вешаешь только на
LIBGNET_2_0_7 интерфейс?
цепляю свой вариант, основанный только на rpmsodiff, символы _* надо
наверно вынести в local:


-- 
Alexey Shabalin

[-- Attachment #2: libgnet-2.0.map --]
[-- Type: application/octet-stream, Size: 1204 bytes --]

Re: [devel] version scripts

[Alexey Shabalin]

[-- Attachment #1: Type: text/plain, Size: 621 bytes --]

2008/5/30 Igor Zubkov :
> 30.05.08, Sergey Bolshakov написал(а):
>> А ты уверен, что version script вообще нужен ?
>>  Бишь, есть или будет изменение ABI без смены soname ?
>>  Посмотрев (невнимательно) на svn проекта, я чего-то подобного
>>  не усмотрел.
>
> Если брать именно libasyncns, то для него оно вроде и не нужно. Это
> просто пакет для примера разбирательства с version scripts. Я могу и
> другой выбрать.
>
> Ок. Другой. gnome-keyring-2.22.1 или 2.22.2 (у них вроде ничего между
> версиями не поехало):

Пожалуйста, проверьте мой version script.
Если возражений нет, такой уедет в сизиф.

-- 
Alexey Shabalin

[-- Attachment #2: gnome-keyring-2.22.2-symver.map.bz2 --]
[-- Type: application/x-bzip2, Size: 769 bytes --]