付録A 上級パッケージング

Debian Policy Manual, 8 "Shared libraries"

Debian Policy Manual, 9.1.1 "File System Structure"

Debian Policy Manual, 10.2 "Libraries"

共有ライブラリーとはコンパイルされたコードを含む ELF オブジェクトファイルです。

共有ライブラリーは *.so ファイルとして頒布されます。(*.a ファイルでも *.la ファイルでもありません)

主に、共有ライブラリーは ld メカニズムを用い複数の実行プログラム間でコードを共有するのに使用されます。

時々、共有ライブラリーは dlopen メカニズムを用いある実行プログラムに複数のプラグインを提供するのに使用されます。

Shared libraries export symbols, which represent compiled objects such as variables, functions, and classes; and enable access to them from the linked executables.

共有ライブラリー libfoo.so.1 の SONAME: objdump -p libfoo.so.1 | grep SONAME ^[88]

共有ライブラリーの SONAME は通常ライブラリーのファイル名と一致します(例外もあります)。

/usr/bin/foo にリンクされた共有ライブラリーの SONAME: objdump -p /usr/bin/foo | grep NEEDED ^[89]

libfoo1: 共有ライブラリー libfoo.so.1 で SONAME ABI バージョンが 1 のライブラリーパッケージ。^[90]

ライブラリーパッケージのパッケージメンテナースクリプトは SONAME に必要なシンボリックリンクを作成するために特定の環境下で ldconfig を呼ばなければいけません。^[91]

libfoo1-dbg: the debugging symbols package that contains the debugging symbols for the shared library package libfoo1.

libfoo-dev: the development package that contains the header files etc. for the shared library libfoo.so.1.^[92]

Debian packages should not contain *.la Libtool archive files in general.^[93]

Debian packages should not use RPATH in general.^[94]

少々内容が古くなった二次的なレファレンスですが、Debian Library Packaging Guide はまだ有用かもしれません。

Debian Policy Manual, 8.6.3 "The symbols system"^[96]

dh_makeshlibs(1)

dpkg-gensymbols(1)

dpkg-shlibdeps(1)

deb-symbols(5)

アップストリームの libfoo-1.3.tar.gz ファイルを用いてDebian 化したソースツリーの骨子を準備します。

Make trial builds of the source tree with tools such as debuild and pdebuild. (If this fails due to missing symbols etc., there were some backward-incompatible ABI changes that require you to bump the shared library package name to something like libfoo1a and you should start over again.)

$ cd libfoo-1.3
$ debuild
...
dpkg-gensymbols: warning: some new symbols appeared in the symbols file: ...
 see diff output below
--- debian/libfoo1.symbols (libfoo1_1.3-1_amd64)
+++ dpkg-gensymbolsFE5gzx        2012-11-11 02:24:53.609667389 +0900
@@ -127,6 +127,7 @@
  foo_get_name@Base 1.1
  foo_get_longname@Base 1.2
  foo_get_type@Base 1.1
+ foo_get_longtype@Base 1.3-1
  foo_get_symbol@Base 1.1
  foo_get_rank@Base 1.1
  foo_new@Base 1.1
...

If you see the diff printed by the dpkg-gensymbols as above, extract the proper updated symbols file from the generated binary package of the shared library. ^[98]

$ cd ..
$ dpkg-deb -R  libfoo1_1.3_amd64.deb libfoo1-tmp
$ sed -e 's/1\.3-1/1\.3/' libfoo1-tmp/DEBIAN/symbols \
        >libfoo-1.3/debian/libfoo1.symbols

debuild や pdebuild のようなツールでリリースパッケージをビルドします。

$ cd libfoo-1.3
$ debuild -- clean
$ debuild
...

Ubuntu wiki MultiarchSpec (アップストリーム)

Debian wiki Multiarch/Implementation (Debian の状況)

全てのファイルが含まれる単一の圧縮された tar ファイルを用いる 3.0 (native) フォーマットでネイティブの Debian ソースパッケージを作成します。

ネイティブ Debian ソースパッケージから、Debian バイナリーパッケージをビルドします。

mypackage_1.0.tar.gz

これは、dpkg-source コマンドにより mypackage-1.0 ディレクトリーから作られたソースコードのターボールです。(そのサフィックスは orig.tar.gz ではありません。)

mypackage_1.0.dsc

This is a summary of the contents of the source code, as in the non-native Debian package. (There is no Debian revision.)

mypackage_1.0_i386.deb

This is your completed binary package, as in the non-native Debian package. (There is no Debian revision.)

mypackage_1.0_i386.changes

これは、ノンネイティブ Debian パッケージと同様で現パッケージバージョンでの全変更を記述します。(Debian リビジョンはありません。)