付録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 メカニズムを用いある実行プログラムに複数のプラグインを提供するのに使用されます。

共有ライブラリーは変数や関数やクラスのようなコンパイルされたオブジェクトを表す シンボル をエキスポートし、リンクされた実行プログラムからそれらへのアクセスを可能とします。

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

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

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

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

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

libfoo1-dbg: 共有ライブラリー libfoo1 のデバッグシンボルを含むデバッグシンボルパッケージ。

libfoo-dev: 共有ライブラリー libfoo.so.1 用のヘッダーファイル他を含む開発用パッケージ 。^[91]

Debian パッケージは一般的に *.la Libtool アーカイブファイルを含んではいけません。^[92]

Debian パッケージは一般的に RPATH を使うべきではありません。^[93]

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

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

dh_makeshlibs(1)

dpkg-gensymbols(1)

dpkg-shlibdeps(1)

deb-symbols(5)

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

debuild や pdebuild 等のツールを使ってソースツリーのテストビルドをします。 (もしシンボルの欠如等でビルドがうまく行かない場合には、共有ライブラリーパッケージ名を libfoo1a 等と繰り上げる必要のある何らかの後方非互換な ABI 変更があったので、最初からやり直す必要があります。)

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

もし上記のように dpkg-gensymbols によって diff がプリントされるのを発見した場合には、生成された共有ライブラリーのバイナリーパッケージから適切な symbols ファイルを抽出しましょう。^[97]

$ 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

これは、ノンネイティブ Debian パッケージと同様でソースコード内容の要約です。(Debian リビジョンはありません。)

mypackage_1.0_i386.deb

これは、ノンネイティブ Debian パッケージと同様で完成したバイナリーパッケージです。(Debian リビジョンはありません。)

mypackage_1.0_i386.changes

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