[% title = "Debian Packaging Manual - 共有ライブラリ" %]

<p><a name="ch-sharedlibs"></a></p>
<hr>

<p>
[ <a href="ch-diversions.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch-scope.html">1</a> ]
[ <a href="ch-binarypkg.html">2</a> ]
[ <a href="ch-sourcepkg.html">3</a> ]
[ <a href="ch-controlfields.html">4</a> ]
[ <a href="ch-versions.html">5</a> ]
[ <a href="ch-maintainerscripts.html">6</a> ]
[ <a href="ch-descriptions.html">7</a> ]
[ <a href="ch-relationships.html">8</a> ]
[ <a href="ch-conffiles.html">9</a> ]
[ <a href="ch-alternatives.html">10</a> ]
[ <a href="ch-diversions.html">11</a> ]
[ 12 ]
[ <a href="ch-methif.html">13</a> ]
[ <a href="ch-conversion.html">14</a> ]
[ <a href="ch-methif.html">next</a> ]
</p>

<hr>

<h2>
Debian Packaging Manual
<br>Chapter 12 - 共有ライブラリ
</h2>

<hr>

<p>
共有ライブラリを含むパッケージの場合、その共有ライブラリがつねに
使用可能となるように多少の注意を払って作成しなければなりません。 とりわけ、libc
などのシステム運用に関わる重要な共有ライブラリの ときは特に重要です。
</p>

<p>
初めに、パッケージは、共有ライブラリを正しい名前で
インストールしなくてはなりません。例えば、パッケージ <code>libgdbm1</code>
は、<samp>libgdbm.so.1.7.3</samp> を、 <samp>/usr/lib/libgdbm.so.1.7.3</samp>
としてインストールしなくては なりません。prerm や postrm
スクリプトからこれらのファイルの
名前を変更したり、再リンクしたりしてはいけません; <code>dpkg</code>
は、実行中のプログラムに影響がないように、
注意してファイル名の変更などの作業を実行しますし、これと
競合するような処理は，おそらく問題を起こすでしょう。
</p>

<p>
次に、パッケージは <code>ldconfig</code> の作成する
共有ライブラリ用のシンボリックリンクを含まなければいけません。
例えば、<code>libgdbm1</code> パッケージは、 <samp>/usr/lib/libgdbm.so.1</samp>
から <samp>libgdbm.so.1.7.3</samp> へのシンボリックリンクを含んで
いなければいけません。これが必要なのは、<code>dpkg</code> が
ライブラリをインストールしてから <code>postinst</code> スクリプトで
<code>ldconfig</code> が実行されるまでの間に、 <code>ld.so</code>
がそのライブラリを見つけることができるように
するためです。さらに、古いバージョンのパッケージ管理システムでは、
<samp>.deb</samp> ファイル中のライブラリは、それへの
シンボリックリンクが置かれるより先に置かれていることを
要求していました。これは、<code>dpkg</code> が
(古いバージョンのライブラリを指すシンボリックリンクを上書きする ことによって)
新しいシンボリックリンクをインストールする時点で、
新しい共有ライブラリが既に存在していることを保証するためです。
あいにく、これはいつでも可能なことと言うわけではありませんでした。
なぜなら、それはファイルシステムのふるまいに大きく 依存するからです。ある種の
(reisefs のような) ファイルシステムは
ファイルを作る順番が問題にならないように、ファイルを 並び換えます。リリース
<samp>1.7.0</samp> から、パッケージ作成時に <code>dpkg</code>
が自動的にファイルそれ自身を並び換えるように なります。
</p>

<p>
三番目に、開発版 (development) パッケージは、バージョン番号なしの
共有ライブラリへのシンボリックリンクを含んでいなければいけません。
例えば、<samp>libgdbm1-dev</samp> パッケージは、
<samp>/usr/lib/libgdm.so</samp> から <samp>libgdm.so.1.7.3</samp> への
シンボリックリンクを含んでいなければいけません。
このシンボリックリンクが必要となるのは、パッケージを
コンパイルするときに動的にリンクするか静的にリンクするかによって、
<code>ld</code> は <samp>libgdm.so</samp> か <samp>libgdm.a</samp>
しか探さないからです。
</p>

<p>
共有ライブラリを、<samp>/etc/ld.so.conf</samp> に書かれてある
ディレクトリか、<code>ld.so</code> によるデフォルトの 検索ディレクトリ
(現在のところ、<samp>/usr/lib</samp> と <samp>/lib</samp> です)
のいずれかにインストールするパッケージは、 最初の引数が 'configure'
であったとき，かつそのときのみ <code>postinst</code> スクリプトの中で
<code>ldconfig</code> を呼ばなければなりません。しかし、パッケージを
アップグレードしようとしたときに、postrm と preinstの中で <code>ldconfig</code>
を呼ばないようにすることも重要です。
(インストール時、アップグレード時のパッケージ展開作業の 詳細については <a
href="ch-maintainerscripts.html#s-unpackphase">インストールやアップグレードでの
ファイルの展開段階の詳細, Section 6.3</a> を参照ください) それは、その場合には
<code>dpkg</code> がインストールしている 間に使う一時的なファイルを
<code>ldconfig</code> が見てしまい、
共有ライブラリリンクがその一時的なファイルを指すようにして
しまうからです。そして、<code>dpkg</code> はインストールを
継続する直前に、そのリンク先を消してしまいます！
</p>

<hr>

<h3><a name="s-shlibs"></a>12.1 <samp>shlibs</samp> ファイルの書式</h3>

<p>
このファイルは、<code>dpkg-shlibdeps</code> によって使用され、
共有ライブラリを含むパッケージを提供する場合は必須です。
</p>

<p>
それぞれの行はつぎのものから構成されます。
</p>

<pre>
      <var>library-name</var> <var>version-or-soname</var> <var>dependencies ...</var>
</pre>

<p>
<var>library-name</var> は、共有ライブラリの名前です。
例えば、<samp>libc5</samp> です。
</p>

<p>
<var>version-or-soname</var> は、ライブラリの .so ファイル名です。つまり、
<code>ld.so</code> によって
認識されるライブラリ名と厳密に一致した名前を与えなければ
いけません。ふつうは、ライブラリのメジャーバージョン番号です。
</p>

<p>
<var>dependencies</var> は、バイナリパッケージ制御ファイル中の dependency
フィールドと同じ書式です。そのパッケージに含まれる
ライブラリで構築したバイナリが動作するために必要なパッケージの
詳細が記述されていなければなりません。<a
href="ch-relationships.html#s-depsyntax">関係性フィールドの書式, Section
8.1</a> をご覧になってください。
</p>

<p>
例えば、パッケージ <samp>foo</samp> が、<samp>libfoo.so.1.2.3</samp>
を含むとします。この時、ライブラリの .so ファイル名は、
<samp>libfoo.so.1</samp> となります。そして、
マイナーバージョンが、<samp>2.3</samp> であるような最初の
パッケージのバージョンは、<var>1.2.3-1</var> となります。
そこで、このパッケージの、<var>shlibs</var> には以下のように 書かれます。
</p>

<pre>
       libfoo 1	foo (&gt;= 1.2.3-1)
</pre>

<p>
特定のバージョン番号への依存関係は、古いバージョンの
共有ライブラリで新しいバイナリを実行しようとした際に、 <code>ld.so</code>
が出力するウォーニングを回避するのに 役立ちます。
</p>

<hr>

<h3><a name="s12.2"></a>12.2 <samp>shlibs</samp> に関する技術情報の詳細</h3>

<hr>

<h4><a name="s12.2.1"></a>12.2.1 <samp>shlibs</samp> ファイルとは<em>何か</em> ?</h4>

<p>
<samp>debian/shlibs</samp> ファイルは、パッケージ化された
バイナリがどの共有ライブラリに依存しているか調べる方法を
提供します。このファイルを使用する目的は、
パッケージメンテナが自分の作業を楽にすることにあります。
</p>

<p>
Debian システム上にある他の <samp>shlibs</samp> ファイルを以下に 列挙します。
</p>
<ul>
<li>
<p>
<samp>/etc/dpkg/shlibs.default</samp>
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>/etc/dpkg/shlibs.override</samp>
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>/var/lib/dpkg/info/*.shlibs</samp>
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>debian/shlibs.local</samp>
</p>
</li>
</ul>

<p>
バイナリパッケージの構築時、<code>dpkg-shlibdeps</code> が
これらのファイルを使います。
</p>

<hr>

<h4><a name="s12.2.2"></a>12.2.2 <code>dpkg-shlibdeps</code> は、 <em>どのようにして</em>働くのか ?</h4>

<p>
<code>dpkg-shlibdeps</code> は、 コマンドラインから入力された
コンパイル済のバイナリ (近くリリースされる <code>dpkg-shlibdeps</code>
ではライブラリも) が直接 [<a href="footnotes.html#f22" name="fr22">22</a>]
使っている共有ライブラリを調べます。
</p>

<p>
各共有ライブラリに対して、<code>dpkg-shlibdeps</code> は
以下の情報を把握する必要があり、
</p>
<ul>
<li>
<p>
ライブラリを含んでいるパッケージ、および
</p>
</li>
<li>
<p>
ライブラリのバージョン番号、
</p>
</li>
</ul>

<p>
そのために以下のファイルを記述順に走査します。
</p>
<!-- ol type="1" start="1"  -->
<li>
<p>
<samp>debian/shlibs.local</samp>
</p>
</li>
<li>
<p>
<samp>/etc/dpkg/shlibs.override</samp>
</p>
</li>
<li>
<p>
<samp>/var/lib/dpkg/info/*.shlibs</samp>
</p>
</li>
<li>
<p>
<samp>/etc/dpkg/shlibs.default</samp>
</p>
</li>
</ol>

<hr>

<h4><a name="s12.2.3"></a>12.2.3 多くの <samp>shlibs</samp> ファイルを<em>誰が</em> 管理しているのか ?</h4>

<ul>
<li>
<p>
<samp>/etc/dpkg/shlibs.default</samp> - dpkg のメンテナ
</p>
</li>
<li>
<p>
<samp>/var/lib/dpkg/info/<var>package</var>.shlibs</samp> -
それぞれのパッケージメンテナ
</p>
</li>
<li>
<p>
<samp>/etc/dpkg/shlibs.override</samp> - ローカルの システム管理者
</p>
</li>
<li>
<p>
<samp>debian/shlibs.local</samp> - パッケージ開発者
</p>
</li>
</ul>

<p>
<samp>shlibs.default</samp> は、<code>dpkg</code> によって
管理されています。<code>dpkg</code> によって提供される
<samp>shlibs.default</samp> の各エントリは、
共有ライブラリパッケージすべてが、それぞれの <samp>shlibs</samp>
ファイルを持つようになるまで、デフォルトの決定のために 置かれています。
</p>

<hr>

<h4><a name="s12.2.4"></a>12.2.4 <code>dpkg-shlibdeps</code> と <samp>shlibs</samp> ファイルを<em>どのようにして</em>使うか ?</h4>

<hr>

<h5><a name="s12.2.4.1"></a>12.2.4.1 あなたのパッケージが共有ライブラリを含んで いないとき</h5>

<p>
<samp>debian/rules</samp> ファイル中に <code>dpkg-shlibs</code>
の呼出しルーチンを置いてください。バイナリだけを含んだ パッケージ
(つまり、スクリプトを含まない) の場合、以下を 使用してください。
</p>

<pre>
       dpkg-shlibdeps debian/tmp/usr/bin/* debian/tmp/usr/sbin/*
</pre>

<p>
<code>dpkg-shlibdeps</code> が何も文句を言って
こなかったなら、成功です。もし、エラーやウォーニングなどが
出力されたのであれば、たぶん、それ用の <samp>debian/shlibs.local</samp>
を作成する必要が あるでしょう。
</p>

<hr>

<h5><a name="s12.2.4.2"></a>12.2.4.2 あなたのパッケージが共有ライブラリを 含んでいるとき</h5>

<p>
<samp>debian/shlibs</samp> ファイルを作成して、 <samp>debian/rules</samp>
によってそれを制御領域に インストールしてください。
</p>

<pre>
       install -m644 debian/shlibs debian/tmp/DEBIAN
</pre>

<p>
もし、あなたのパッケージが他のバイナリを含んでいるので
あれば、上の記述を参照してください。
</p>

<hr>

<h4><a name="s12.2.5"></a>12.2.5 <samp>debian/shlibs.local</samp> を <em>どのように</em>書くのか</h4>

<p>
あなたの作ったパッケージが、自身の <samp>/var/lib/dpkg/info/*.shlibs</samp>
をまだ提供していない ライブラリに依存しているとき、この問題の
<em>一時的</em>解決のためにこのファイルはあります。
</p>

<p>
バイナリ <samp>foo</samp> をパッケージ構築中だとします。
構築中のメッセージが、例えば以下のようになっていて、
</p>

<pre>
       $ ldd foo
       libbar.so.1 =&gt; /usr/X11R6/lib/libbar.so.1.0
       libc.so.5 =&gt; /lib/libc.so.5.2.18
       libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6.0
</pre>

<p>
そして、 <code>dpkg-shlibdeps</code> を実行すると、 以下のようになります。
</p>

<pre>
       $ dpkg-shlibdeps -o foo
       dpkg-shlibdeps: warning: unable to find dependency information
       for shared library libbar
       (soname 1, path /usr/X11R6/lib/libbar.so.1.0, dependency field Depends)
       shlibs:Depends=elf-x11r6lib, libc5 (&gt;= 5.2.18)
</pre>

<p>
<code>foo</code> バイナリは、<code>libbar</code>
共有ライブラリに依存していますが、 <samp>var/lib/dpkg/info/</samp> にある
<samp>*.shlibs</samp> ファイルには、このライブラリを提供したパッケージの名前は
ありません。というわけで、責任をとるパッケージを 決定しましょう。
</p>

<pre>
       $ dpkg -S /usr/X11R6/lib/libbar.so.1.0
       bar1: /usr/X11R6/lib/libbar.so.1.0
       $ dpkg -s bar1 | grep Version
       Version: 1.0-1
</pre>

<p>
どうやら、<code>bar1</code> のバージョン 1.0-1 が
現在我々の使用しているものということのようです。
ここで、この問題を一時的に解決するために、自分専用の
<samp>debian/shlibs.local</samp> を作ります。以下の行を、
<samp>debian/shlibs.local</samp> 中に含めてください。
</p>

<pre>
       libbar 1 bar1 (&gt;= 1.0-1)
</pre>

<p>
さあ、これであなたのパッケージ構築作業はうまくいくはずです。
<code>libbar1</code> のパッケージメンテナが、それ用の <samp>shlibs</samp>
ファイルを提供したときには、あなたの <samp>debian/shlibs.local</samp>
ファイルは削除してもよいです。
</p>

<hr>

<p>
[ <a href="ch-diversions.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch-scope.html">1</a> ]
[ <a href="ch-binarypkg.html">2</a> ]
[ <a href="ch-sourcepkg.html">3</a> ]
[ <a href="ch-controlfields.html">4</a> ]
[ <a href="ch-versions.html">5</a> ]
[ <a href="ch-maintainerscripts.html">6</a> ]
[ <a href="ch-descriptions.html">7</a> ]
[ <a href="ch-relationships.html">8</a> ]
[ <a href="ch-conffiles.html">9</a> ]
[ <a href="ch-alternatives.html">10</a> ]
[ <a href="ch-diversions.html">11</a> ]
[ 12 ]
[ <a href="ch-methif.html">13</a> ]
[ <a href="ch-conversion.html">14</a> ]
[ <a href="ch-methif.html">next</a> ]
</p>

<hr>

<p>
Debian Packaging Manual
</p>

<address>
version revision 1.13, 2000-08-22<br>
<br>
Ian Jackson <code><a href="mailto:ijackson&#64;gnu.ai.mit.edu">ijackson&#64;gnu.ai.mit.edu</a></code><br>
校正: David A. Morris <code><a href="mailto:bweaver&#64;debian.org">bweaver&#64;debian.org</a></code><br>
メンテナー: Christian Schwarz <code><a href="mailto:schwarz&#64;debian.org">schwarz&#64;debian.org</a></code><br>
メンテナー: Manoj Srivastava <code><a href="mailto:srivasta&#64;debian.org">srivasta&#64;debian.org</a></code><br>
メンテナー: Julian Gilbey <code><a href="mailto:J.D.Gilbey&#64;qmw.ac.uk">J.D.Gilbey&#64;qmw.ac.uk</a></code><br>
メンテナー: The Debian Policy group <code><a href="mailto:debian-policy&#64;lists.debian.org">debian-policy&#64;lists.debian.org</a></code><br>
日本語版メンテナー: 早瀬 茂規 <code><a href="mailto:shayase&#64;tky3.3web.ne.jp">shayase&#64;tky3.3web.ne.jp</a></code><br>
日本語版校正: Japanese Debian Documentation Project <code><a href="mailto:debian-doc&#64;debian.or.jp">debian-doc&#64;debian.or.jp</a></code><br>
<br>
</address>
<hr>