source: projects/vine-making-rpm/trunk/help/vine-making-rpm.xml @ 8246

Revision 8246, 135.0 KB checked in by yasumichi, 9 years ago (diff)

%check スクリプトの説明を修正

Line 
1<?xml version="1.0"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4<!ENTITY ex-usemacro SYSTEM "example.spec">
5<!ENTITY ex-pkginfo SYSTEM "ex-pkginfo.spec">
6<!ENTITY ex-script SYSTEM "ex-script.spec">
7<!ENTITY ex-files SYSTEM "ex-files.spec">
8<!ENTITY ex-changelog SYSTEM "ex-changelog.spec">
9]>
10<book id="making-rpm" lang="ja">
11
12<bookinfo>
13  <title>RPMパッケージの作成方法</title>
14  <authorgroup>
15    <author>
16      <firstname>Jun</firstname>
17      <surname>Nishii</surname>
18    </author>
19    <editor>
20      <surname>Akahoshi</surname>
21      <firstname>Yasumichi</firstname>
22    </editor>
23    <editor>
24      <firstname>Kazutaka</firstname>
25      <surname>HARADA</surname>
26    </editor>
27    <editor>
28      <firstname>Takuya</firstname>
29      <surname>Kobayashi</surname>
30    </editor>
31  </authorgroup>
32  <abstract>
33          <para>この文書は、Vine Linux上で動くアプリケーションをRPMパッケージ化する方法を解説しています。</para>
34          <para>初めてRPMパッケージを作成する方を主な対象としておりますが、他のドキュメントでは分かりにくいあるいは触れられていない点に注意して説明していますので経験者にも参考になる点があります。</para>
35        <para>なお、RPMパッケージのインストール方法やシェルスクリプト、基本的なコマンドの使い方は省略しております。</para>
36        <!--para>間違いの指摘・コメント・要望等は、ML(メーリングリスト)や BTS(バグトラッキングシステム)で知らせていただければ、できるだけ反映していくつもりですので、ご協力をお願いします。また、SPECファイルを書く時にこういうことがわからなかったという意見や情報も募集中です。</para-->
37  </abstract>
38  <!--pubdate>2007/10/3</pubdate-->
39</bookinfo>
40
41<glossary id="mr-glossary">
42        <title>用語の解説</title>
43        <glossentry>
44                <glossterm>RPM Package Manager</glossterm>
45                <acronym>RPM</acronym>
46                <glossdef>
47                        <para>アプリケーションの安全なインストール、更新、削除などを目的とした強力なパッケージ管理システムです。</para>
48                </glossdef>
49        </glossentry>
50        <glossentry>
51                <glossterm>バイナリパッケージ</glossterm>
52                <glossdef>
53                        <para>展開すれば、そのまま実行可能な状態でアプリケーションに必要な全てのファイルがアーカイブされています。</para>
54                        <para>バイナリパッケージのファイル名は、<filename>name-version-release.arch.rpm</filename>という形式です。</para>
55                </glossdef>
56        </glossentry>
57        <glossentry>
58                <glossterm>ソースパッケージ</glossterm>
59                <acronym>SRPM</acronym>
60                <glossdef>
61                        <para>バイナリパッケージの作成に必要なソースやパッチ、SPECファイルがアーカイブされています。</para>
62                        <para>ソースパッケージのファイル名は、<filename>name-version-release.src.rpm</filename>という形式です。</para>
63                        <para><command>rpm <option>-ivh</option> <filename>hoge.src.rpm</filename></command> で<xref linkend="mr-directories"/>で解説するディレクトリに展開されます。</para>
64                </glossdef>
65        </glossentry>
66        <glossentry>
67                <glossterm>SPECファイル</glossterm>
68                <acronym>SPEC</acronym>
69                <glossdef>
70                        <para>ソースからパッケージを作成するための手順やパッケージの情報を記述するファイル。</para>
71                        <para>SPECファイルのファイル名は、<filename>name.spec</filename>という形式です。</para>
72                        <para>この文書では主にSPECファイルの書き方を説明します。</para>
73                </glossdef>
74        </glossentry>
75        <glossentry>
76                <glossterm>パッチファイル</glossterm>
77                <acronym>パッチ</acronym>
78                <glossdef>
79                        <para>オリジナルのソースに修正を加えるため、差分情報を記述したファイル。</para>
80                        <para>ファイル名は、<filename>name.patch</filename>という形式です。</para>
81                </glossdef>
82        </glossentry>
83</glossary>
84
85<part id="mr-setup">
86        <title>環境設定</title>
87        <partintro>
88                <para><xref linkend="mr-setup" />では、VinePlus向けパッケージを作成するにあたって設定すべきことを説明します。</para>
89        </partintro>
90        <chapter id="rpmmacros">
91                <title>設定ファイル</title>
92                <para>RPMパッケージ(以下、パッケージ)作成環境の設定ファイルは、ユーザのホームディレクトリ(以下、<filename class="directory">~/</filename>)にある <filename>.rpmmacros</filename> です。</para>
93                <para>Vine Linuxをインストールしたままの状態であれば、下記の様になっています。</para>
94
95<screen>
96%_topdir ${HOME}/rpm
97
98# gpg signing
99# %_signature gpg
100# %_gpg_name Your Name &lt;your mail address&gt;
101</screen>
102
103                <para>既に削除してしまった場合は、<filename>/etc/skel/.rpmmacros</filename>から<filename class="directory">~/</filename>にコピーします。</para>
104                <para>また、内容を変更している場合は、次節以降を参考に必要な設定が漏れていないか確認してください。</para>
105                <important>
106                        <title>パッケージ作成は一般ユーザで行いましょう</title>
107                        <para>パッケージ作成をroot権限で行うとシステムを破壊する場合があります。必ず、一般ユーザ権限で行ってください。</para>
108                        <para>そのため設定ファイルは、あなたが通常使用している一般ユーザのホームディレクトリに用意してください。</para>
109                </important>
110        </chapter>
111
112        <chapter id="mr-directories">
113                <title>パッケージ作成に必要なディレクトリの準備</title>
114                <para>パッケージ作成に必要なディレクトリは、<filename class="directory">~/.rpmmacros</filename><varname>%_topdir</varname>で設定されたディレクトリに以下の名前で配置します。</para>
115                <table id="rpmdirs">
116                        <title>パッケージ作成に必要なディレクトリ名と使用目的</title>
117                        <tgroup cols="2">
118                                <thead>
119                                        <row>
120                                                <entry>ディレクトリ名</entry>
121                                                <entry>使用目的</entry>
122                                        </row>
123                                </thead>
124                                <tbody>
125                                        <row>
126                                                <entry>BUILD</entry>
127                                                <entry>パッケージ作成時にソースの展開や make を実行するための作業用ディレクトリです。</entry>
128                                        </row>
129                                        <row>
130                                                <entry>RPMS/arch</entry>
131                                                <entry>作成されたバイナリパッケージ(<filename>*.rpm</filename>)が格納されます。対象となる architecture によって arch の部分が、i386・ppc などになります。なお、architecture に依存しないパッケージは、RPMS/noarch に格納されます。</entry>
132                                        </row>
133                                        <row>
134                                                <entry>SRPMS</entry>
135                                                <entry>作成されたソースパッケージ(<filename>*.srpm</filename>)が格納されます。</entry>
136                                        </row>
137                                        <row>
138                                                <entry>SPECS</entry>
139                                                <entry>パッケージ作成の指示書であるSPECファイル(<filename>*.spec</filename>)を格納します。</entry>
140                                        </row>
141                                        <row>
142                                                <entry>SOURCES</entry>
143                                                <entry>パッケージ化するアプリケーションのソースやパッチを格納します。</entry>
144                                        </row>
145                                </tbody>
146                        </tgroup>
147                </table>
148
149                <para>Vine Linuxをインストールしたままの状態であれば、<varname>%_topdir</varname><literal>${HOME}/rpm</literal>に設定されており、上記のディレクトリも<filename class="directory">~/rpm</filename>の中に用意されています。</para>
150                <para>以下、<xref linkend="rpmdirs" />で説明したディレクトリを単にBUILDとか、SOURCESと呼びます。</para>
151
152                <important>
153                        <title>必要なディレクトリが存在しない場合</title>
154                        <para>もし必要なディレクトリが無い、または削除してしまった場合は、端末上で<command>mkrpmdir</command>コマンドを実行してください。</para>
155                        <screen>$ <command>mkrpmdir ~</command></screen>
156                        <para>このコマンドにより<filename class="directory">~/rpm</filename>配下に必要なディレクトリを作成できます。</para>
157                        <para>もし、<command>mkrpmdir</command>コマンドが見つからない場合は、vutilsパッケージをインストールしてください。</para>
158                </important>
159        </chapter>
160
161        <chapter id="mr-gpgsign">
162                <title>パッケージ署名の設定</title>
163                <para>VineSeed および VinePlus では、原則として GnuPG による署名を行っていただきます。(GnuPG 鍵の作成方法は web などを参照してください。 )</para>
164                <para><filename>~/.rpmmacros</filename>に以下の記述があるか確認して下さい。</para>
165
166<screen>
167# gpg signing
168# %_signature gpg
169# %_gpg_name Your Name &lt;your mail address&gt;
170</screen>
171
172                <para>行頭の # は、コメントを表しますので以下のように修正します。</para>
173
174<!--screen>
175# gpg signing
176%_signature gpg
177%_gpg_name Your Name &lt;your mail address&gt;
178</screen-->
179<screen>
180# gpg signing
181%_signature gpg <co id="signature" />
182%_gpg_name Your Name &lt;your mail address&gt;  <co id="gpg_name" />
183</screen>
184<calloutlist>
185        <callout arearefs="signature">
186                <para>署名に GnuPG を使用する宣言</para>
187        </callout>
188        <callout arearefs="gpg_name">
189                <para>使用する GnuPG 鍵の宣言</para>
190        </callout>
191</calloutlist>
192
193                <para>使用する GnuPG 鍵に合わせて、Your Nameはあなたの名前(ローマ字表記)、your mail addressはあなたのメールアドレスに変更して下さい。</para>
194                <para>なお、パッケージ作成時には署名のためのオプションを与える必要がありますが、ファイル <filename>~/.popt</filename> に以下の記述を追加しておくとオプションを省略可能になります。</para>
195
196<screen>
197rpmbuild alias --ba             -ba --sign
198rpmbuild alias --bb             -bb --sign
199rpmbuild alias --bs             -bs --sign
200rpmbuild alias --ta             -ta --sign
201rpmbuild alias --rebuild        --rebuild --sign
202</screen>
203
204        </chapter>
205</part>
206
207<part id="mr-basicflow">
208        <title>基本的なパッケージ作成の流れ</title>
209        <partintro>
210                <para><xref linkend="mr-basicflow" />では、共通的に必要となる事項を中心にパッケージ作成の基本的な流れを説明します。</para>
211        </partintro>
212<chapter id="mr-preparation">
213        <title>パッケージ作成毎の準備</title>
214        <para>この章から、実際にパッケージ作成の手順を説明していきます。</para>
215        <sect1 id="mr-correct-info">
216                <title>パッケージ化対象アプリケーションの情報収集</title>
217                <para>次節以降の準備のためにパッケージ化しようとしているアプリケーションの情報を確認します。</para>
218                <para>最初にパッケージ化するアプリケーションが、既にVinePlus(VineSeed)向けに用意されていないか確認します。</para>
219
220                <example>
221                        <title>パッケージの存在を確認する</title>
222
223<screen>
224# apt-get update
225$ apt-cache search name
226</screen>
227
228                </example>
229
230                <note>
231                        <title>パッケージが存在した場合</title>
232                        <para>パッケージが存在していても不具合がある場合やバージョンアップする場合には、パッケージを修正する必要があります。</para>
233                        <para>この様な場合には、<command>apt-get source name</command>などとして既存のSPECファイルを取得し、修正するようにしてください。</para>
234                </note>
235
236                <para>パッケージが存在しないかバージョンアップする場合は、ダウンロードしたソースを<filename class="directory">SOURCES</filename>に保存してください。</para>
237
238                <para>また、以下の情報についても配布元のサイトやソースに含まれる <filename>README</filename> などのファイルを見て確認してください。</para>
239                <itemizedlist>
240                        <listitem><para>ビルド・インストールの方法</para></listitem>
241                        <listitem><para>ビルド・実行に必要なライブラリやアプリケーションとそのバージョン</para></listitem>
242                        <listitem><para>実行時に参照される設定ファイル</para></listitem>
243                </itemizedlist>
244        </sect1>
245        <sect1 id="install-library">
246                <title>アプリケーションのビルド・実行に必要なパッケージのインストール</title>
247                <para>アプリケーションのビルド・実行に必要なライブラリやアプリケーションがあれば、それらのパッケージがインストールされているか確認してください。</para>
248                <para>特にライブラリでは、ビルドにのみ必要なファイルがサブパッケージ(通常はname-devel)として用意されている場合があり、注意が必要です。</para>
249                <para>また、複数のメジャーバージョンを共存させるためにパッケージ名にメジャーバージョンが追加されている場合があります。</para>
250                <para>パッケージによっては、名前の一部が省略されている場合もあります。</para>
251                <example>
252                        <title>gtk+-2.xを必要とする場合</title>
253                        <para>
254                                パッケージのビルドには、gtk2-develパッケージがインストールされている必要があります。
255                                (この例では、gtk+ の + が省略されている上、gtk+-1.xと共存するためにパッケージ名にメジャーバージョンである 2 が追加されています。)
256                        </para>
257                </example>
258                <para>なお、必要なライブラリ等のパッケージが用意されていない場合は、先にパッケージ化してください。</para>
259        </sect1>
260        <sect1 id="prepare-patch">
261                <title>パッチの用意</title>
262                <para>以下の様な場合には、パッチを用意します。</para>
263                <itemizedlist>
264                        <listitem><para>必要なライブラリが全てインストールされているにも関わらずビルドに失敗する</para></listitem>
265                        <listitem><para>実行時の不具合がある</para></listitem>
266                        <listitem><para>アプリケーションのインストール先を変更できる仕組みになっていない</para></listitem>
267                        <listitem><para>設定ファイルをVine Linux向けにカスタマイズしたい</para></listitem>
268                </itemizedlist>
269                <para>ビルドや実行に関する不具合は、既に配布元でも承知して公式のパッチが用意されている場合もあります。</para>
270                <para>その場合は、公式のパッチをダウンロードして<filename class="directory">SOURCES</filename>に保存します。</para>
271                <note>
272                        <title>自分でパッチを作成する場合の手順</title>
273                        <orderedlist>
274                                <listitem><para>アプリケーションのソースを展開</para></listitem>
275                                <listitem>
276                                        <para>展開されたディレクトリをコピー</para>
277                                        <screen>$ cp -R srcdir srcdir.org</screen>
278                                </listitem>
279                                <listitem><para>コピー元のディレクトリ(srcdir)以下のファイルに必要な修正を加える</para></listitem>
280                                <listitem>
281                                        <para>パッチを作成する</para>
282                                        <screen>$ diff -uNr srcdir.org/ srcdir/ &gt; <replaceable>patchname</replaceable>.patch</screen>
283                                </listitem>
284                                <listitem><para>patchname.patchを<filename class="directory">SOURCES</filename>に保存</para></listitem>
285                        </orderedlist>
286                </note>
287        </sect1>
288</chapter>
289
290<chapter id="make-spec">
291        <title>SPECファイルの記述</title>
292        <para>いよいよ、パッケージ作成の肝となるSPECファイルの記述について説明します。</para>
293        <para>SPECファイルの内容は、以下の主要部分に分類できます。</para>
294        <itemizedlist>
295                <listitem><para>パッケージ情報</para></listitem>
296                <listitem><para>パッケージの作成やインストール等の手順(スクリプト部)</para></listitem>
297                <listitem><para>インストールされるファイルの一覧</para></listitem>
298                <listitem><para>パッケージの変更履歴</para></listitem>
299        </itemizedlist>
300        <important>
301                <title>SPECファイルの文字コード</title>
302                <para>SPECファイルの文字コードは<emphasis>UTF-8</emphasis>にしてください。</para>
303        </important>
304        <note>
305                <title>マクロの定義</title>
306                <para>SPECファイルの冒頭にパッケージのバージョンなど頻繁に使用されるものをマクロとして定義しておくと後々の修正が楽になります。</para>
307                <para><screen>%define   macro   literal</screen>ようにするとパッケージ作成時に<varname>%{macro}</varname>と書かれた部分を<literal>literal</literal>に置換して処理します。</para>
308                <para><xref linkend="common-macro" />も参照して下さい。</para>
309        </note>
310        <sect1 id="package-info">
311                <title>パッケージ情報の記述</title>
312                <para><command>rpm</command>コマンドでパッケージに関する問い合わせを実行した場合に表示される情報やパッケージの依存情報などを記述します。</para>
313                <example id="ex-pkginfo">
314                        <title>パッケージ情報の記述例</title>
315                        <para>以下にパッケージ情報の記述例を示します。(#を記述すると#から行末までがコメントとして扱われます。)</para>
316
317                        <screen>&ex-pkginfo;&ex-pkginfo;</screen>
318                       
319                </example>
320
321                <para>基本情報から依存情報の部分は、1行につき1つの情報を記述する構成となっています。</para>
322                <para>各行は「Summary:」のようにタグとそれに続くコロンで始まり、さらにタグに対応する情報が続く形式になっています。</para>
323
324                <sect2>
325                        <title>基本情報</title>
326                        <para><xref linkend="spec-basic-info" />の情報は、<command>rpm -qi</command>などでパッケージに関して問い合わせを行った場合に表示されます。</para>
327                        <table id="spec-basic-info">
328                                <title>基本情報で使用されるタグ</title>
329                                <tgroup cols="2">
330                                        <thead><row><entry>タグ</entry><entry>内容</entry></row></thead>
331                                        <tbody>
332                                                <row>
333                                                        <entry>Summary</entry>
334                                                        <entry>パッケージの簡単な説明を英語で記述します。</entry>
335                                                </row>
336                                                <row>
337                                                        <entry>Summary(ja)</entry>
338                                                        <entry>Summaryを日本語で翻訳します。</entry>
339                                                </row>
340                                                <row>
341                                                        <entry>Name</entry>
342                                                        <entry>パッケージの名前です。定義以降、%{name}というマクロで参照できます。</entry>
343                                                </row>
344                                                <row>
345                                                        <entry>Version</entry>
346                                                        <entry>パッケージのバージョンです。定義以降、%{version}というマクロで参照できます。</entry>
347                                                </row>
348                                                <row>
349                                                        <entry>Release</entry>
350                                                        <entry>冒頭の数字は同じバージョンで何回目のリリースになるかを意味します。%{?_dist_release}は、vl5の様に対象となるVine Linuxのバージョンに置き換えられます。定義以降、%{release}というマクロで参照できます。</entry>
351                                                </row>
352                                                <row>
353                                                        <entry>License</entry>
354                                                        <entry>アプリケーションのライセンス</entry>
355                                                </row>
356                                                <row>
357                                                        <entry>Group</entry>
358                                                        <entry>アプリケーションの種類。<xref linkend="group-list" />を参照して下さい。</entry>
359                                                </row>
360                                                <row>
361                                                        <entry>Packager</entry>
362                                                        <entry>パッケージメンテナ。BTS.VineLinux.Orgへのログインユーザ名を使用してください。複数のメンテナがいる場合、カンマで区切ります。</entry>
363                                                </row>
364                                                <row>
365                                                        <entry>Distribution</entry>
366                                                        <entry>VinePlusやVineSeedのパッケージは、Vine Linuxを指定します。</entry>
367                                                </row>
368                                                <row>
369                                                        <entry>Vendor</entry>
370                                                        <entry>作成したrpmパッケージに関する責任を負うVendor名です。VinePlusやVineSeedのパッケージは、Project Vineを指定します。</entry>
371                                                </row>
372                                                <row>
373                                                        <entry>Url</entry>
374                                                        <entry>アプリケーションの情報を提供しているURL</entry>
375                                                </row>
376                                        </tbody>
377                                </tgroup>
378                        </table>
379                </sect2>
380
381                <sect2>
382                        <title>パッケージ作成時に必要となるタグ</title>
383                        <table>
384                                <title>パッケージ作成時に必要となるタグ</title>
385                                <tgroup cols="2">
386                                        <thead><row><entry>タグ</entry><entry>内容</entry></row></thead>
387                                        <tbody>
388                                                <row>
389                                                        <entry>Source</entry>
390                                                        <entry>パッケージ化するアプリケーションのソースファイル名。ソースの入手先を明示するためにURL形式で記述することも可能。</entry>
391                                                </row>
392                                                <row>
393                                                        <entry>Patch</entry>
394                                                        <entry>
395                                                                <xref linkend="prepare-patch" />で用意したパッチファイルを指定します。
396                                                                書式はSourceと同じです。
397                                                        </entry>
398                                                </row>
399                                                <row>
400                                                        <entry>BuildRoot</entry>
401                                                        <entry>仮想インストールのためのディレクトリ名を書きます。直接ディレクトリ名を書くのではなく、例のようにマクロを利用してください。</entry>
402                                                </row>
403                                        </tbody>
404                                </tgroup>
405                        </table>
406                        <para>複数のソースファイルやパッチがあるときはSource0、Source1、...やPatch0、Patch1、...というふうに番号をふって列挙します。(Source0は、Sourceと省略できます。)</para>
407                        <para>Souce数字 で指定したファイルは %{SOURCE数字} というマクロとして <xref linkend="mr-script" />の %prep や %install などの部分で利用できます。</para>
408                </sect2>
409
410                <sect2>
411                        <title>依存情報</title>
412                        <para>パッケージの依存情報など他のパッケージとの関係を示すには、<xref linkend="dependency-tag" />のようなタグを使用します。</para>
413                        <table id="dependency-tag">
414                                <title>パッケージの依存関係を扱うタグ</title>
415                                <tgroup cols="2">
416                                        <thead><row><entry>タグ</entry><entry>内容</entry></row></thead>
417                                        <tbody>
418                                                <row>
419                                                        <entry>Requires</entry>
420                                                        <entry>作成しているrpmパッケージが動作するのに必要なパッケージ名</entry>
421                                                </row>
422                                                <row>
423                                                        <entry>BuildRequires</entry>
424                                                        <entry>パッケージの作成時に必要となるパッケージ名</entry>
425                                                </row>
426                                                <row>
427                                                        <entry>Conflicts</entry>
428                                                        <entry>共存できないパッケージ名</entry>
429                                                </row>
430                                                <row>
431                                                        <entry>Provides</entry>
432                                                        <entry>作成するパッケージが他のパッケージの代替となる場合、そのパッケージ名を記述</entry>
433                                                </row>
434                                                <row>
435                                                        <entry>Obsoletes</entry>
436                                                        <entry>パッケージをインストールする際にアンインストールしたいパッケージ名</entry>
437                                                </row>
438                                                <row>
439                                                        <entry>BuildConflicts</entry>
440                                                        <entry>パッケージ作成時にはインストールしておけないパッケージ名</entry>
441                                                </row>
442                                        </tbody>
443                                </tgroup>
444                        </table>
445                        <para>&lt;, &gt;, =, &gt;=, &lt;=といった演算子を使うとパッケージのバージョン、リリース番号を限定することもできます。</para>
446                        <example>
447                                <title>ghostscriptのバージョン5.10がパッケージの動作に必要な場合</title>
448                                <screen>Requires: ghostscript = 5.10</screen>
449                        </example>
450                        <example>
451                                <title>gtk2-develのバージョン2.16.0以上がパッケージの作成に必要な場合</title>
452                                <screen>BuildRequires: gtk2-devel &gt;= 2.16.0</screen>
453                        </example>
454                        <important>
455                                <title>演算子の両側には必ずスペースやタブを入れてください。</title>
456                                <para>演算子の両側にスペースやタブを入れない場合、パッケージ名からバージョンまでが一つのパッケージ名として認識されてしまいます</para>
457                                <para>例えば、<screen>BuildRequires: gtk2-devel&gt;=2.16.0</screen>とすると「gtk2-devel&gt;=2.16.0」というパッケージ名だと認識してしまいます。</para>
458                        </important>
459                        <para>複数のパッケージが関係する場合は、カンマ(,)やスペースで区切って列挙したり、複数行に分けて記述できます。複数行に分ける場合は、各行にタグが必要です。</para>
460                        <para>パッケージがいくつかのグループに分類できる場合には、複数行に書いた方がわかりやすくなります。</para>
461                        <example>
462                                <title>一行で記述する例</title>
463                                <screen>Requires: ghostscript &gt;= 5.10, ghostscript-fonts, VFlib = 2.24, tetex, tetex-extra</screen>
464                        </example>
465                        <example>
466                                <title>複数行に分けて記述する例</title>
467
468<screen>
469Requires: ghostscript &gt;= 5.10, ghostscript-fonts, VFlib = 2.24
470Requires: tetex, tetex-extra
471</screen>
472
473                        </example>
474                </sect2>
475
476                <sect2>
477                        <title>詳しい解説</title>
478                        <para>Summaryよりも詳しいパッケージの解説を<screen>%description</screen>の次の行から、<emphasis>英語で</emphasis>記述します。</para>
479                        <para>Summaryタグの場合と違い、複数行にわたる解説を書くことができます。</para>
480                        <para>なお、日本語による翻訳を追加する場合は、<screen>%description -l ja</screen>として、同様に記述できます。</para>
481                </sect2>
482        </sect1>
483
484        <sect1 id="mr-script">
485                <title>スクリプト部</title>
486                <para>スクリプト部では、パッケージの作成やインストール等の手順を記述します。</para>
487                <example id="ex-script">
488                        <title>スクリプト部の記述例</title>
489                        <screen>&ex-script;</screen>
490                </example>
491                <para>スクリプト部は、<xref linkend="section-list" />で示すセクションに分かれます。</para>
492                <para>各セクションは、独立したbashスクリプトとして実行できるように記述します。</para>
493
494        <note>
495                        <title>rpmbuild時の内部の仕組み</title>
496                        <para>各セクション名が現れた時に #!/bin/sh -eが起動され(Vine Linuxでは/bin/shは/bin/bashにsym.linkされてる)、
497                                各環境変数(RPM_SOURCE_DIRやRPM_PACKAGE_NAMEなど)が定義された後、
498                                次のセクション名が出てくるまで、記述されているスクリプトが実行されます。</para>
499                        <para>環境変数の詳細については、<xref linkend="mr-env" />を参照してください。</para>
500                </note>
501
502                <table id="section-list">
503                        <title>スクリプト部のセクション</title>
504                        <tgroup cols="3">
505                                <thead><row><entry>セクション名</entry><entry>概要</entry><entry>詳細説明</entry></row></thead>
506                                <tbody>
507                                        <row>
508                                                <entry>%prep</entry>
509                                                <entry>ソースをビルドする前に実施する準備事項</entry>
510                                                <entry><xref linkend="prep-section" /></entry>
511                                        </row>
512                                        <row>
513                                                <entry>%build</entry>
514                                                <entry>ソースのビルド手順</entry>
515                                                <entry><xref linkend="build-section" /></entry>
516                                        </row>
517                                        <row>
518                                                <entry>%install</entry>
519                                                <entry>ソースからのインストール手順</entry>
520                                                <entry><xref linkend="install-section" /></entry>
521                                        </row>
522                                        <row>
523                                                <entry>%check</entry>
524                                                <entry>ビルドされたバイナリが正常に動作するか検証する手順</entry>
525                                                <entry><xref linkend="check-section" /></entry>
526                                        </row>
527                                        <row>
528                                                <entry>%clean</entry>
529                                                <entry>パッケージ作成後の後始末</entry>
530                                                <entry><xref linkend="clean-section" /></entry>
531                                        </row>
532                                        <row>
533                                                <entry>その他</entry>
534                                                <entry>パッケージのインストール等の前後に実行する手順</entry>
535                                                <entry><xref linkend="other-section" /></entry>
536                                        </row>
537                                </tbody>
538                        </tgroup>
539                </table>
540                <para>以下、各セクションの詳細を解説します。</para>
541
542                <sect2 id="prep-section">
543                        <title>%prepセクション</title>
544                        <para>ソースをビルドする前に実施する準備事項をシェルスクリプトで記述します。</para>
545                        <para>以下で説明する%setup,%patchなどのマクロを用いて、ソースの展開やパッチの適用などを行います。</para>
546                        <para>なお、このセクションの最初で<screen>rm -rf ${RPM_BUILD_ROOT}</screen>として、
547                                ${RPM_BUILD_ROOT}(<xref linkend="package-info" />のBuildRootで指定したディレクトリ)
548                                を掃除することが多いです。ただし、このときには、
549                                BuildRootの設定には十分気をつけて下さい(何故かわかりますね?)
550                        </para>
551                        <variablelist>
552                                <varlistentry>
553                                        <term>%setup</term>
554                                        <listitem><para>
555                                                        <command>tar</command>でアーカイブされ、
556                                                        <command>gzip</command>または<command>bzip2</command>圧縮されたソースを展開します。
557                                                        %setupとオプションなしで書くと、以下が順に行われます。</para>
558                                                <orderedlist>
559                                                        <listitem><para>
560                                                                        <xref linkend="mr-directories" />で指定したディレクトリBUILDにcdする。
561                                                        </para></listitem>
562                                                        <listitem><para>
563                                                                        指定ディレクトリ(-nで指定できる。デフォルトのディレクトリ名は、
564                                                                        ${RPM_PACKAGE_NAME}-${RPM_PACKAGE_VERSION}、後述)
565                                                                        がカレント・ディレクトリ(BUILD)に存在すれば消去する。
566                                                        </para></listitem>
567                                                        <listitem><para>
568                                                                        Sourceで指定したソースのアーカイブを展開する。
569                                                        </para></listitem>
570                                                        <listitem><para>指定ディレクトリ(2の指定ディレクトリ名と同じ)にcdする。
571                                                        </para></listitem>
572                                                </orderedlist>
573                                                <para>%setupの動作を制御する必要がある場合は、<xref linkend="setup-macro" />を参照してください。</para>
574                                        </listitem>
575                                </varlistentry>
576
577                                <varlistentry>
578                                        <term>%patch</term>
579                                        <listitem>
580                                                <para>%setupで展開したソースにパッチをあてるためのマクロとしてはたらきます。</para>
581                                                <para>オプションなしで%patchと書くと、
582                                                        <screen>patch -p0 -s &lt; ${RPM_SOURCE_DIR}/&lt;Patchで指定したファイル&gt;</screen>
583                                                        が起動されます。</para>
584                                                <para><xref linkend="ex-script" />のように書くと、
585                                                        <screen>patch -p1 -s &lt; ${RPM_SOURCE_DIR}/&lt;Patchで指定したファイル&gt;</screen>
586                                                        と同じことをします。</para>
587                                                       
588                                                <para>パッチファイルが複数ある場合、Patch0, Patch1,...に対して、
589<screen>
590%patch0 -p1
591%patch1 -p1
592</screen>
593                                                        と実行することも出来ます。%patchには-b &lt;name&gt;
594                                                        (バックアップ・ファイルの拡張子指定、デフォルトは.orig)などのオプ
595                                                        ションがあります。
596                                        </para></listitem>
597                                </varlistentry>
598                        </variablelist>
599                </sect2>
600
601                <sect2 id="build-section">
602                        <title>%buildセクション</title>
603                        <para>
604                                        ソースをmakeするスクリプトの開始であることを示し、また、
605                                        %setupで指定したディレクトリにcdするマクロとしてはたらきます。
606                                        以下には、makeを行うときの手順をスクリプトとして書きます。
607                        </para>
608                        <para>ここでの処理で必要となるパッケージ等は、BuildRequires(build): で指定します。</para>
609                        <note>
610                                <title>ソースにconfigureスクリプトが用意されている場合</title>
611                                <para>autoconf化されたソースなどmakeの前に
612                                        <screen>$ configure --prefix=/usr</screen>
613                                        などとしてインストールするディレクトリなどを制御できるソースがあります。</para>
614                                <para>configureスクリプトが用意されている場合には、%configureマクロを利用すると便利です。</para>
615                                <para>%configureマクロは、<filename>/usr/lib/rpm/macros</filename>で次のように定義されており、
616                                        Vine Linux推奨のコンパイルフラグやインストールディレクトリを設定できます。</para>
617<screen>
618%configure \
619  CFLAGS="${CFLAGS:-%optflags}" ; export CFLAGS ; \
620  CXXFLAGS="${CXXFLAGS:-%optflags}" ; export CXXFLAGS ; \
621  FFLAGS="${FFLAGS:-%optflags}" ; export FFLAGS ; \
622  ./configure --host=%{_host} --build=%{_build} \\\
623        --target=%{_target_platform} \\\
624        --program-prefix=%{?_program_prefix} \\\
625        --prefix=%{_prefix} \\\
626        --exec-prefix=%{_exec_prefix} \\\
627        --bindir=%{_bindir} \\\
628        --sbindir=%{_sbindir} \\\
629        --sysconfdir=%{_sysconfdir} \\\
630        --datadir=%{_datadir} \\\
631        --includedir=%{_includedir} \\\
632        --libdir=%{_libdir} \\\
633        --libexecdir=%{_libexecdir} \\\
634        --localstatedir=%{_localstatedir} \\\
635        --sharedstatedir=%{_sharedstatedir} \\\
636        --mandir=%{_mandir} \\\
637        --infodir=%{_infodir}
638</screen>
639                                <para>ここで定義されていないオプション、例えば--disable-scrollkeeperというようなオプションが必要な場合には
640                                        <screen>%configure --disable-scroolkeeper</screen>のように追加でオプションを指定できます。</para>
641                        </note>
642                </sect2>
643
644                <sect2 id="install-section">
645                        <title>%installセクション</title>
646                        <para>
647                                ファイルをinstallするスクリプトの開始であることを示し、また、
648                                %setupで指定したディレクトリにcdするマクロとしてはたらきます。
649                                以下には、installを行うときの手順を示します。
650                                データ定義部のBuildRootで設定したディレクトリ(${RPM_BUILD_ROOT})
651                                の下に全てのファイルがインストールされるように、工夫しましょう。
652                                Makefileが短いときには、修正してpatchをつくるかわりに、ここに、
653                                cp, installコマンド等を用いたinstallスクリプトを書くのも一手です。
654                        </para>
655                        <para>
656                                %setup のところと同じように、マクロ %{SOURCE数字} を使って Source: で指定したファイルを直接インストールすることもできます。
657                                <screen>%{__install} -m 644 %{SOURCE2} %{buildroot}/where/there/</screen>
658                        </para>
659                        <para>
660                                なお、rpm-3.0.5以降では、インストールされたバイナリは
661                                rpmパッケージにする段階で自動的にstripされますので、
662                                %installでbinaryのstripを行う必要はありません。
663                        </para>
664                        <para>
665                                ここでの処理で必要となるパッケージ等は、
666                                BuildRequires(install): で指定します。
667                        </para>
668                </sect2>
669
670                <sect2 id="check-section">
671                        <title>%checkセクション</title>
672                        <para>
673                                ビルドされたバイナリが正常に動作することを check するスクリプトの開始であることを示します。
674                                %setupで指定したディレクトリにcdするマクロとしてはたらきます。
675                                以下には、make test や make check などを実行するときの手順を示します。
676                        </para>
677                        <para>
678                                GNOME などが利用する desktopファイルの書式チェックなどを行うこともできます。
679                                <xref linkend="add_to_gnome_menu" />を参照してください。
680                        </para>
681                        <para>
682                                rpm-4.2以降で実装された機能です。
683                        </para>
684                        <para>
685                                        ここでの処理で必要となるパッケージ等は、
686                                        BuildRequires(install): で指定します。
687                        </para>
688                </sect2>
689
690                <sect2 id="clean-section">
691                        <title>%cleanセクション</title>
692                        <para>
693                                        rpmを作ったあとの後始末を記述します。
694                        </para>
695                        <para>
696                                        ここでの処理で必要となるパッケージ等は、
697                                        BuildRequires(clean): で指定します。
698                        </para>
699
700                </sect2>
701        </sect1>
702
703        <sect1 id="making-rpm-5-3">
704                <title>ファイルリスト部</title>
705                <para>%filesはじまる部分で、RPMパッケージに収録するファイル名を列挙します。</para>
706                <example id="ex-filelist">
707                        <title>ファイルリスト部の例</title>
708                        <screen>&ex-files;</screen>
709                </example>
710                <para>このとき以下に注意してください。</para>
711                <itemizedlist>
712                        <listitem><para>
713                                        ここに書くファイル名は重複してはいけません。
714                        </para></listitem>
715                        <listitem><para>
716                                        列挙されたファイルは、%docで指定するものを除いて、
717                                        %installまでのスクリプトの実行によって、
718                                        記述した通りの場所(${RPM_BUILD_ROOT}を''/''とみなす)
719                                        にinstallされるものでないといけません。
720                        </para></listitem>
721                        <listitem><para>
722                                        列挙されたファイルがおかしな userID/groupID を持っていると、
723                                        rpmパッケージが正常にbuildできないことがあります。
724                        </para></listitem>
725                        <listitem><para>
726                                        ファイルを含まないバーチャルパッケージ<footnote><para>Requires で他のパッケージをまとめてインストールしたり、%post, %preun, %postun などで何らかのコマンド処理を行うようなパッケージ。task-gnome や task-tetex などのように task- という名前が使われます。</para></footnote>を作る場合でも、%files という行だけは必要になります。%files という行を省略してしまうと、rpmbuild コマンドで処理しても src.rpm しか作れません。
727                        </para></listitem>
728                </itemizedlist>
729                <para>
730                        <command>rpmbuild</command>コマンドは、SPECファイルに基づいてRPMパッケージを作るときに、
731                        <xref linkend="mr-script" />で設定した一連のスクリプトを実行した後、
732                        ${RPM_BUILD_ROOT}をとみなして%files以下で指定されたファイルを回収し、
733                        それを指定位置にinstallするようなRPMパッケージをつくります。
734                </para>
735                <sect2>
736                        <title>ドキュメント・ファイルの指定</title>
737                        <para>
738                                %docというマクロを用います。<xref linkend="ex-filelist" />のように、%doc READMEとすると、
739                                %setupで指定したホームディレクトリ下のREADMEが、
740                                ${RPM_BUILD_ROOT}/usr/doc/hoge-1.1-2/にcpされたのち、
741                                rpmパッケージに回収されます。つまり%docは、
742                                ドキュメントファイルのインストールとパッケージングのためのファイル指定を同時に行うマクロとしてはたらきます。
743                                以下のように、ディレクトリごと指定もできます。
744                        </para>
745                        <screen>%doc doc/</screen>
746                </sect2>
747                <sect2>
748                        <title>パッケージに収録するファイルの指定</title>
749                        <para>その絶対パスで指定します。</para>
750                        <itemizedlist>
751                                <listitem><para>
752                                                個別ファイルはそのまま指定。(/usr/bin/hoge.bin など)
753                                </para></listitem>
754                                <listitem><para>
755                                                あるディレクトリ以下の全てのファイルをrpmパッケージにいれたいときには、
756                                                そのディレクトリ名を書きます。(タグなし、/usr/hoge/ など)。
757                                                アンインストール時には、そのディレクトリごとなくなります。
758                                </para></listitem>
759                                <listitem><para>
760                                                ワイルドカードも使えます。(/usr/hoge/* など)
761                                </para></listitem>
762                        </itemizedlist>
763                        <warning>
764                                <para>
765                                        rpm-3.0.5以降では、man ファイルや info ファイルは自動的にgzipで圧縮されます。
766                                        %filesにmanやinfoのファイル名を書くときには拡張子.gzをつけるのを忘れないようにしましょう。
767                                </para>
768                        </warning>
769                </sect2>
770                <sect2>
771                        <title>タグを用いたファイル指定</title>
772                        <variablelist>
773                                <varlistentry>
774                                        <term>%dir &lt;dir name&gt;</term>
775                                        <listitem><para>
776                                                        指定したディレクトリだけをパッケージに含める。
777                                                        <screen>``/usr/hoge/'' = ``%dir /usr/hoge/'' + ``/usr/hoge/*''</screen>
778                                                        ってかんじです。
779                                        </para></listitem>
780                                </varlistentry>
781                                <varlistentry>
782                                        <term>%config &lt;file name&gt;</term>
783                                        <listitem><para>
784                                                        configファイルであることを示す。
785                                                        ファイルが書き換えられていた場合、
786                                                        アンインストール時には .rpmsaveをつけた名前で保存されます。
787                                                        アップグレード時には新しいファイルと置き換えられ、
788                                                        元のファイルは .rpmsaveをつけた名前で保存されます。
789                                                </para>
790                                                <para>
791                                                        ファイルが変更されていた場合、
792                                                        アップグレード時に新しいファイルに置き換えずにもとのファイルをそのまま使う場合には、
793                                                        %config(noreplace) を指定します。
794                                                        <screen>%config(noreplace) &lt;file name&gt;</screen>
795                                                        この場合新しいパッケージに入っている設定ファイルは、
796                                                        .rpmnew をつけた名前で保存されます。
797                                                        また、アップグレードではなく、同じバージョンをインストールし直した時には、
798                                                        .rpmorig をつけた名前で保存されます。
799                                                </para>
800                                                <para>
801                                                        存在しなくても問題ないファイルの場合は、
802                                                        %config(missingok) を指定します。
803                                                        <screen>%config(missingok) &lt;file name&gt;</screen>
804                                                        これは、rpmコマンドの -V オプションでチェックした時に、
805                                                        ファイルが無くてもエラーにならないようにするためのものです。
806                                        </para></listitem>
807                                </varlistentry>
808                                <varlistentry>
809                                        <term>%attr(&lt;mode&gt;,&lt;owner&gt;,&lt;group&gt;[, dirmode]) &lt;file name&gt;</term>
810                                        <listitem><para>
811                                                        %filesに列挙するファイルのパーミッションやuser ID、group IDを設定する。
812                                                        例えば、
813                                                        <screen>%attr(755,root,root) /usr/lib/hoge</screen>
814                                                        とする。一部の属性を省略(書き換えない)したいときには - を使って、
815                                                        <screen>%attr(755,-,root) /usr/lib/hoge</screen>
816                                                        とする。
817                                                </para>
818                                                <para>
819                                                        <screen>%attr(755,root,root)</screen>
820                                                        のように( )の中には 3つしか書かないことが多いですが、
821                                                        <screen>%attr(755,root,root,755)</screen>
822                                                        のように 4つ書くこともできます。
823                                                        4つ目の数字(dirmode)は、
824                                                        <emphasis>ディレクトリとサブディレクトリのパーミッション</emphasis>になります。
825                                        </para></listitem>
826                                </varlistentry>
827                                <varlistentry>
828                                        <term>%defattr(&lt;mode&gt;,&lt;owner&gt;,&lt;group&gt;[, dirmode])</term>
829                                        <listitem><para>
830                                                        それ以降の行に書かれた属性のデフォルト値を設定する。
831                                                        %attr が出てきた行を除いて、それ以降に書かれたものに共通になります。
832                                                </para>
833                                                <para>
834                                                        %defattr も %attr も何度でも使えます。
835                                                        次の例だと、/usr/bin/hoge と /usr/lib/hoge は一つ目の %defattr の 755 になり、
836                                                        /usr/share/locale/ja 以降は二つ目の %defattr の 644 になります。
837                                                </para>
838<screen>
839%defattr(755,-,-)
840/usr/bin/hoge
841/usr/lib/hoge
842%defattr(644,-,-)
843/usr/share/locale/ja
844/usr/share/locale/lv</screen>                                           
845                                                <para>
846                                                        %attrと同様、4つ目の数字は、
847                                                        ディレクトリとサブディレクトリのパーミッションになります。
848                                        </para></listitem>
849                                </varlistentry>
850
851                                <varlistentry>
852                                        <term>%verify( ) &lt;file name&gt;</term>
853                                        <listitem><para>
854                                                        %filesに列挙するファイルについて、rpm -V でパッケージを検証する時に、検証する項目を指定する。</para>
855                                                <para>
856                                                        ( ) の中には<xref linkend="verify-options" />にあるものが入ります。
857                                                        複数指定する場合には、, もしくは スペース で区切ります。</para>
858
859
860                                                <table id="verify-options">
861                                                        <title>%verify の ( ) の中で指定できるもの</title>
862                                                        <tgroup cols="2">
863                                                                <thead>
864                                                                        <row><entry>項目</entry><entry>内容</entry></row>
865                                                                </thead>
866                                                                <tbody>
867                                                                        <row><entry>size</entry><entry>サイズ</entry></row>
868                                                                        <row><entry>mode</entry><entry>パーミッションとファイルの種類</entry></row>
869                                                                        <row><entry>md5</entry><entry>md5 値</entry></row>
870                                                                        <row><entry>rdev</entry><entry>デバイスファイルのモードビットなど</entry></row>
871                                                                        <row><entry>link</entry><entry>リンク先</entry></row>
872                                                                        <row><entry>user</entry><entry>ファイルの所有者 user</entry></row>
873                                                                        <row><entry>group</entry><entry>ファイルのグループ group</entry></row>
874                                                                        <row><entry>mtime</entry><entry>ファイルの更新時刻 mtime(modification time)</entry></row>
875                                                                </tbody>
876                                                        </tgroup>
877                                                </table>
878
879                                                <para><emphasis>not</emphasis> とすると<emphasis>検証しない項目</emphasis>だけを指定できます。</para>
880                                                <para>書き換えることが前提となる設定ファイルなので、ファイルサイズ と md5値 と 更新時刻 は検証する必要がないといった場合には、
881                                                        <screen>%verify(not size,md5,mtime) /etc/hoge.conf</screen>
882                                                        のように指定します。
883                                        </para></listitem>
884                                </varlistentry>
885
886                                <varlistentry>
887                                        <term>%defverify( )</term>
888                                        <listitem><para>
889                                                        それ以降の行に書かれたファイルについて検証する項目を設定します。
890                                        </para></listitem>
891                                        <listitem><para>
892                                                        %verify と %defverify は、%attr と %defattr と同じような関係です。
893                                        </para></listitem>
894                                </varlistentry>
895
896                        </variablelist>
897                        <para>
898                                %config %attr %verify などは、次のようにスペースを入れることで一つのファイルに複数指定できます。
899                                <screen>%config %verify(not size,md5,mtime) /etc/hoge.conf</screen>
900                        </para>
901
902                        <para>
903                                この%filesの指定は少々面倒なとこかもしれません。
904                                新しくパッケージをつくる場合などは、%install までのスクリプト部を書いたところで、%files以下は何も書かないまま、一度、そのSPECファイルから rpm をbuildしてみるとよいかもしれません。(rpm -bi hoge.spec これについては次節)。
905
906                                そのあとで、${RPM_BUILD_ROOT}以下にinstallされてるファイルを、find コマンドで見てみて%filesの指定をします。
907                        </para>
908                        <para>
909                                %filesで書かれていないファイルがある場合には、build 時に
910                                <screen>パッケージに未収録のファイルを検査中: /usr/lib/rpm/check-files /var/tmp/hoge-1.1-root
911                                        警告: パッケージに未収録のインストール済みファイルが見つかりました:</screen>
912                                と未収録のファイルの名前などが表示されます。
913                                この部分を利用して %files の部分を作成するのもよいでしょう。
914                        </para>
915
916                        <para>
917                                ソースのバージョンアップなどで、作成されるファイルが増減したり、ディレクトリが変わったりする場合があります。未収録のファイルがあっても、build が途中で終了せず、パッケージを作成できてしまう場合があるので、build 時のメッセージは必ず確認してください。
918                        </para>
919                </sect2>
920        </sect1>
921
922        <sect1 id="package-changelog">
923                <title>パッケージの更新履歴</title>
924                <para>%changelog以下にパッケージの更新履歴を英語で記述します。最新の更新情報が上にくるように書きます。</para>
925                <example>
926                        <title>パッケージの更新履歴の例</title>
927                        <screen>&ex-changelog;</screen>
928                </example>
929                <para>
930                        一行目の最初に * を書き、日付と変更を加えた人の名前を書きます。
931                        二行目以降に - を書き、更新内容を書きます。
932                        今日の日付は <command>date コマンド</command> で
933                        <command>LANG=C date +'%a %b %d %Y'</command> とすると確認できます。
934                        12月1日のように日の部分が一桁の場合は 0 をつけ 01 のようにします。
935                </para>
936                <para>
937                        Vine Linux でのパッケージングルールでは
938                        一行目に日付、パッケージャーの名前、メールアドレス、パッケージのバージョン,、リリース番号を書くことになっています。
939                </para>
940<screen>
941* 曜日 月 日 西暦年 パッケージャーの名前 &lt;メールアドレス&gt; バージョン-リリース番号
942- 更新内容
943</screen>
944                <para>
945                        更新内容の部分でもマクロは展開され %{name} は hoge になります。
946                        マクロを展開せずにそのまま %{name} と書きたい場合は
947                        %%{name} のように % を二つ続けて書いて下さい。
948                </para>
949                <para>
950                        日本語を使うことも可能になっていますが、Summary や description
951                        のように環境変数に応じて日本語や英語のどちらかを表示するという仕組みは無いので、
952                        英語だけで書くほうがよいでしょう。
953                </para>
954        </sect1>
955</chapter>
956
957<chapter id="rpmbuild">
958        <title>SPECファイルをもとにRPMパッケージを作成する</title>
959        <para>RPMパッケージを作成するには、次のコマンドを実行します。</para>
960        <screen>$ <command>rpmbuild -ba --sign hoge.spec</command></screen>
961        <para>特に問題がなければ、バイナリパッケージとソースパッケージの両方が作成されます。</para>
962        <para>どちらか一方のみを作成する場合は、オプション<option>-ba</option>(build all)の代わりに
963                <option>-bb</option>(build binary)あるいは<option>-bs</option>(build source)を使用します。</para>
964        <para>なお、オプション<option>--sign</option>は、パッケージに署名することを意味します。<xref linkend="mr-gpgsign" /><filename>~/.popt</filename>の設定をした場合は、省略可能です。</para>
965        <para>署名オプションが有効になっていれば、次の様なプロンプトが表示されるのでGnuPG鍵のパスフレーズを入力して下さい。</para>
966        <screen>パスフレーズの入力:</screen>
967
968        <important>
969                <title>rpmbuildの推奨</title>
970                <para>Vine Linux 3.0以降で採用されているrpm-4.xではパッケージのビルドは<command>rpmbuild</command>コマンドを利用するようになりました。過去との互換性のためVine Linuxでは、<command>rpm</command>コマンドも利用できるようになっていますが、将来的に廃止の予定であるため今後は<command>rpmbuild</command>コマンドをお使いください。</para>
971        </important>
972
973        <para>パッケージを作成せずに段階的にスクリプト部を検証する場合は、<xref linkend="verify-script" />のオプションを使用します。
974                この際、オプション<option>--short-circuit</option>を併用すると一つ前の段階の動作結果を利用できます。</para>
975        <table id="verify-script">
976                <title>スクリプト部の検証オプション</title>
977                <tgroup cols="2">
978                        <thead><row><entry>オプション</entry><entry>実行内容</entry></row></thead>
979                        <tbody>
980                                <row>
981                                        <entry>-bp</entry>
982                                        <entry>%prepセクションの実行(build prep)</entry>
983                                </row>
984                                <row>
985                                        <entry>-bc</entry>
986                                        <entry>%prep、%buildセクションの実行(build compile)</entry>
987                                </row>
988                                <row>
989                                        <entry>-bi</entry>
990                                        <entry>%prep,%build,%install,%checkセクションの実行(build install)</entry>
991                                </row>
992                        </tbody>
993                </tgroup>
994        </table>
995
996        <note>
997                <title>メッセージの記録</title>
998                <para>
999                        次のように | (パイプ) と tee コマンドを利用して、ビルド中のメッセージをファイルに残しておくと、エラーの確認や、%files の確認、Requires の確認といった作業がやりやすくなります。
1000                </para> 
1001                <screen>$ <command>rpmbuild -ba hoge.spec 2&gt;&amp;1<footnote><para>2&gt;&amp;1 はエラーメッセージ(2:標準エラー出力の内容)を (tee コマンドに渡すために) 標準出力(1) にリダイレクトする(2に流れるメッセージを 1と合流させる)というものです。これで、tee で指定したファイル hoge-build.log に、標準出力のメッセージと一緒にエラーメッセージも書き込まれるようになります。</para></footnote> |tee hoge-build.log</command></screen>
1002        </note>
1003
1004        <note>
1005                <title>tarballからRPMパッケージを作成する</title>
1006                <para>
1007                        他に、 tar.gz 形式のソースの中に含まれている SPEC ファイルを用いて build するときには、
1008                        -b のかわりに -t を用いて、
1009                        <screen>$ <command>rpmbuild -ta hoge.tar.gz</command></screen>
1010                        などとします。
1011                </para>
1012        </note>
1013                <!--para>サンプルのSPECファイルのような指定で、rpmパッケージをつくると、hoge-1.1-2vl5.i386.rpm という名前のrpmができます(architectureがi386の場合)。</para-->
1014</chapter>
1015
1016
1017<chapter id="mr-followup">
1018        <title>パッケージ作成後に確認すること</title>
1019        <orderedlist>
1020
1021          <listitem><para>SPEC ファイルのエンコーディング等を確認する。</para>
1022            <para><screen>$ <command>rpm -qpi hoge.rpm</command></screen>
1023              で文字化けしないかどうか、また、バージョンなど、記述した内容にミスが無いか確認する。</para>
1024            <para><screen>$ <command>LANG=C rpm -qpi hoge.rpm</command></screen>
1025              として英語による出力も確認する。</para>
1026          </listitem>
1027         
1028          <listitem><para>Changelog の記述を確認する。</para>
1029            <para><screen>$ <command>rpm -qp --changelog hoge.rpm | head</command></screen>
1030              などで、追記した部分を確認する。</para>
1031          </listitem>
1032         
1033          <listitem><para>依存関係(Requires)を確認する。</para>
1034            <para><screen>$ <command>rpm -qpR hoge.rpm</command></screen></para>
1035           
1036            <para>パッケージがシェルスクリプトのファイルなどを含んでいる場合、その中で利用されるコマンド(もしくはパッケージ)が Requires: で指定されているかを確かめる必要もあります。これは、実際にシェルスクリプトを実行するなどして確かめる必要があります。</para>
1037            <para>
1038                    RPMパッケージをbuildするときには、
1039                    そのパッケージに含まれるバイナリの実行に必要なライブラリ名も、
1040                    自動的にRequiresに加えられます(正確には必要なライブラリのsonameが加えられます)。
1041                    rpmパッケージをinstallするときに、必要なライブラリがシステム上にないと、
1042                    libhoge.so is neededとかいって、おこられますが、
1043                    libhoge.soがなんというパッケージに入ってるかわからずに困ることがよくあるので、
1044                    必要なパッケージ名をきちんとRequiresに書くように心がけましょう。
1045            </para>
1046            <para>
1047                    筆者はbuildした時に出力されるメッセージの
1048                    <screen>Requires: /bin/sh libICE.so.6 libORBit-2.so.0</screen>
1049                    といった部分を、(bash の for文 を利用して)<command>slocate</command> と <command>rpm -qf</command> で処理してパッケージ名を調べています。
1050<screen>$ for i in libICE.so.6 libORBit-2.so.0 ;
1051do slocate $i |xargs rpm -qf ;
1052done | sort -u</screen>
1053            </para>
1054          </listitem>
1055         
1056          <listitem><para>build 時の依存関係(BuildRequires)を確認する。</para>
1057           
1058            <para>できあがった src.rpm を、BuildRequires で指定していない devel などのパッケージをアンインストールした状態で rebuild してみる。</para>
1059
1060            <para>
1061                    *-devel というパッケージをアンインストールするのに、筆者は(bash で)次のようなコマンド(for文)を利用しています。sed や awk で処理してる部分はもう少し上手なやり方があるかもしれません。</para>
1062            <example id="rm-devel">
1063                    <title>*-develパッケージをアンインストールするシェルスクリプト</title>
1064<screen>
1065for i in `rpm -qa --last | grep devel | sed s/devel-/"devel "/ | awk '{print $1}'` ;
1066do
1067        echo $i ;
1068        rpm -q $i &amp;&amp; rpm -e $i ;
1069        rpm -q $i &amp;&amp; apt-get remove $i ;
1070done</screen>
1071            </example>
1072
1073          </listitem>
1074
1075        </orderedlist>
1076
1077        <para>ローカルに apt のリポジトリを作成しておくと、apt-get install や apt-get build-dep で、依存関係のチェック等が行えて便利です。</para>
1078
1079</chapter>
1080</part>
1081
1082<part id="mr-advanced">
1083        <title>より高度なパッケージ作成のための情報</title>
1084        <partintro>
1085                <para><xref linkend="mr-advanced" />では、<xref linkend="mr-basicflow" />を一通り理解した方向けにより高度なパッケージ作成に必要な情報を提供します。</para>
1086        </partintro>
1087        <chapter id="env-and-macro">
1088                <title>環境変数とマクロの活用</title>
1089                <sect1 id="mr-env">
1090                        <title>環境変数</title>
1091                        <para>
1092                                スクリプト部の各タグからはじまる部分は、先にも述べた通り独立したbash scriptとして働くので、
1093                                その範囲内で、
1094                                <screen>TEXMF="/usr/share/texmf"</screen>
1095                                と変数を定義して用いることができます。
1096                        </para>
1097                        <para>
1098                                定義した変数は ${ } で囲んで
1099                                <screen>${TEXMF}</screen>
1100                                のようにすると利用できます。
1101                                $TEXMF のように { } を省略することもできます。
1102                        </para>
1103                        <para>
1104                                /usr/share というディレクトリは標準で %{_datadir} というマクロが定義されているので
1105                                <screen>TEXMF="%{_datadir}/texmf"</screen>
1106                                とすることができます。
1107                                マクロについては、次節以降で説明します。
1108                        </para>
1109                        <para>
1110                                また、以下の変数は各タグ毎に環境変数として定義されます。
1111                        </para>
1112                        <variablelist>
1113                                <varlistentry>
1114                                        <term>RPM_SOURCE_DIR</term>
1115                                        <listitem><para>
1116                                                        ディレクトリSOURCESを表す。<xref linkend="rpmdirs" />参照。
1117                                                        デフォルトは、
1118                                                        <screen>RPM_SOURCE_DIR="/usr/src/redhat/SOURCES"</screen>
1119                                        </para></listitem>
1120                                </varlistentry>
1121                                <varlistentry>
1122                                        <term>RPM_BUILD_DIR</term>
1123                                        <listitem><para>
1124                                                        ディレクトリBUILDを表す。<xref linkend="rpmdirs" />参照。
1125                                                        デフォルトは、
1126                                                        <screen>RPM_BUILD_DIR="/usr/src/redhat/BUILD"</screen>
1127                                        </para></listitem>
1128                                </varlistentry>
1129                                <varlistentry>
1130                                        <term>RPM_DOC_DIR</term>
1131                                        <listitem><para>
1132                                                        %docで指定されたドキュメントファイルをインストールするためのディレクトリを表す。
1133                                                        rpmrcファイルの、defaultdocdirで指定する。デフォルトは、
1134                                                        <screen>RPM_DOC_DIR="/usr/doc"</screen>
1135                                        </para></listitem>
1136                                </varlistentry>
1137                                <varlistentry>
1138                                        <term>RPM_OPT_FLAGS</term>
1139                                        <listitem><para>
1140                                                        コンパイル時にコンパイラにわたすデフォルトのオプション指定を表す。
1141                                                        rpmrcファイルの、optflagsで指定する。
1142                                                        アーキテクチャ毎に指定ができる。
1143                                                        例えば、%buildにおいて以下のように使う
1144                                                        <screen>make CFLAGS=${RPM_OPT_FLAGS}</screen>
1145                                                        デフォルトはarchitectureがi386のときには、
1146                                                        <screen>RPM_OPT_FLAGS="-O2 -m486 -fno-strength-reduce"</screen>
1147                                        </para></listitem>
1148                                </varlistentry>
1149                                <varlistentry>
1150                                        <term>RPM_ARCH_FLAGS</term>
1151                                        <listitem><para>
1152                                                        buildを行なっているシステムのアーキテクチャを表す変数。
1153                                                        アーキテクチャがi386なら、
1154                                                        <screen>RPM_ARCH_FLAGS="i386"</screen>
1155                                        </para></listitem>
1156                                </varlistentry>
1157                                <varlistentry>
1158                                        <term>RPM_OS</term>
1159                                        <listitem><para>
1160                                                        buildを行なっているシステムのOSをあらわす変数。Linuxなら、
1161                                                        <screen>RPM_OS="Linux"</screen>
1162                                        </para></listitem>
1163                                </varlistentry>
1164                                <varlistentry>
1165                                        <term>RPM_BUILD_ROOT</term>
1166                                        <listitem><para>
1167                                                        BuildRootで設定された仮想インストールのためのディレクトリを表す。
1168                                                        (<xref linkend="package-info" />のBuildRootの項参照)
1169                                        </para></listitem>
1170                                </varlistentry>
1171                                <varlistentry>
1172                                        <term>RPM_PACKAGE_NAME</term>
1173                                        <listitem><para>
1174                                                        Nameで設定されたパッケージ名を表す。
1175                                                        (<xref linkend="package-info" />のNameの項参照)
1176                                        </para></listitem>
1177                                </varlistentry>
1178                                <varlistentry>
1179                                        <term>RPM_PACKAGE_VERSION</term>
1180                                        <listitem><para>
1181                                                        Versionで設定されたバージョン名を表す。
1182                                                        (<xref linkend="package-info" />のVersionの項参照)
1183                                        </para></listitem>
1184                                </varlistentry>
1185                                <varlistentry>
1186                                        <term>RPM_PACKAGE_RELEASE</term>
1187                                        <listitem><para>
1188                                                        Releaseで設定されたリリース番号を表す。
1189                                                        (<xref linkend="package-info" />のReleaseの項参照)
1190                                        </para></listitem>
1191                                </varlistentry>
1192                        </variablelist>
1193                </sect1>
1194                <sect1 id="define-macro">
1195
1196                        <title>SPECファイル中のマクロ定義</title>
1197                        <para>
1198                                マクロは
1199                                <screen>%define マクロの名前 内容</screen>
1200                                のように書くことで定義できます。
1201                        </para>
1202                        <para>
1203                                <screen>%{マクロの名前}</screen>
1204                                のように書くことで利用できます。
1205                                {} を省略して %マクロの名前 と書くこともできますが、
1206                                {} をつけて利用したほうが、
1207                                <xref linkend="mr-script" />に出てきた %prep や %build などといったタグと区別しやすくなります。
1208                        </para>
1209                        <para>
1210                                マクロは、%setupや%installなどのスクリプト部やファイル定義部など、
1211                                SPECファイル全体で使えるので、
1212                                うまく使うとバージョンアップに追随してSPECファイルを書くときに楽ができます。
1213                        </para>
1214                        <para>
1215                                %define で定義せずに使えるマクロとして %{name} , %{version} , %{release} があります。
1216                                <xref linkend="package-info" />にでてきた、Name Version Release の値が、
1217                                それぞれ %{name} , %{version} , %{release} の内容になります。
1218                        </para>
1219                        <note><para>
1220                                        %define name hoge として name を定義し Name: %{name} のように利用しているSPECファイルを見かけることがありますが、
1221                                        Name の値を参照するのが %{name} なので、本来とは逆の使い方になり問題を起こす場合があるかもしれません。
1222                                        このような場合は %define pkg_name hoge , Name: %{pkg_name} のように
1223                                        %{name} とは違う名前のマクロを利用したほうがよいでしょう。
1224                        </para></note>
1225                        <para>
1226                                <xref linkend="make-spec" />のSPECファイルの例のデータ定義部は、
1227                                %{name} と %{version} というマクロを利用して、以下のように書くことができます。
1228                                Name: hoge なので %{name} は hoge に、Version: 1.1 なので %{version} は 1.1 になります。
1229                        </para>
1230<screen>
1231Name: hoge
1232Version: 1.1
1233Release: 1
1234Source: %{name}-%{version}.tar.gz
1235Patch: %{name}.patch
1236</screen>
1237
1238                        <para>
1239                                SPECファイルの中(どこでもいいです)に %dump と書いておくと、
1240                                <command>rpmbuild</command> コマンドでパッケージを作る時に、
1241                                すべてのマクロが標準エラー出力に出力され、確認することができます。
1242                        </para>
1243                        <para>
1244                                マクロの定義を取り消したいけれど、行を削除するのではなくコメントとして残しておきたいという場合には、
1245                                %define に % をつけて、%%define にし、さらに # をつけます。
1246
1247                                <screen>%define hoge hige</screen> を <screen># %%define hoge hige</screen> のようにします。
1248
1249                                <screen># %define hoge hige</screen> ではだめです。
1250                                # 以降はコメントになるという処理よりも、マクロの %define の方が先に処理されるので、
1251                                %define hoge hige が解釈されてしまいます。
1252                        </para>
1253
1254                </sect1>
1255
1256                <sect1 id="common-macro">
1257
1258                        <title>標準で定義されているマクロ</title>
1259
1260                        <para>
1261                                よく利用されるコマンドやディレクトリなどにはあらかじめマクロが定義されています。
1262                                自分で定義した変数と同様にSPECファイル全体で使えます。
1263                        </para>
1264                        <para>
1265                                標準で定義されているマクロは <filename>/usr/lib/rpm/macros</filename> に書かれています。
1266                                ユーザー毎のマクロを記述するファイルは<filename>~/.rpmmacros</filename>です。
1267                        </para>
1268                        <para>
1269                                <filename>~/.rpmmacros</filename> に書く場合には
1270                                <screen>%マクロの名前 内容</screen>
1271                                とします。
1272                                <xref linkend="mr-directories" />で出てきた %_topdir などもマクロです。
1273                        </para>
1274                        <para>
1275                                ユーザー毎のマクロと、標準で定義されているマクロをあわせたものは、
1276                                <command>rpm</command>コマンドの <option>--showrc</option>オプションで確認できます。
1277                                <screen>$ <command>rpm --showrc</command></screen>
1278                        </para>
1279                        <para>
1280                                また、それぞれのマクロがどんなものかは、
1281                                <screen>$ <command>rpm --eval "%{マクロ}"</command></screen>
1282                                のようにすると確認できます。
1283                        </para>
1284                        <para>
1285                                標準で定義されているマクロについてはなるべく利用してください。
1286                                SPECファイルのメンテナンスしやすさの向上につながります。
1287                        </para>
1288                        <para>
1289                                たとえば、%{configure} や %{makeinstall} といったマクロを利用することで、
1290                                %build や %install の部分を簡潔に書くことができる場合があります。
1291<screen>%build
1292%{configure}
1293%{__make}
1294
1295%install
1296%{makeinstall}</screen>
1297                                <screen>$ <command>rpm --eval "%{configure}"</command></screen>
1298                                などとやってそれぞれのマクロがどんなものか確認して下さい。
1299                        </para>
1300
1301                        <para>
1302                                rpm 4.x および Vine Linux 4.1 で定義されているマクロを使うと
1303                                <xref linkend="make-spec" />のSPECファイルは次のようになります。
1304                        </para>
1305                        <screen>&ex-usemacro;</screen>
1306
1307                </sect1>
1308        </chapter>
1309
1310        <chapter id="tag-dependencies-information">
1311                <title>依存情報の記述に関する詳細</title>
1312
1313                <sect1 id="mr-requires">
1314                        <title>Requires</title>
1315                        <para>
1316                                Requires には、従来の Requires: だけではなく Requires(pre): などのように
1317                                ( ) をつけて厳密に指定することもできるようになりました。
1318                        </para>
1319
1320                        <para>
1321                                ( ) の中には<xref linkend="Requires-options" />にあるものが入ります。
1322                                ( ) の中に入る項目は <xref linkend="mr-script" /> のタグ等に対応しています。どの部分で必要になるかを書きます。
1323                        </para>
1324
1325                        <para>
1326                                Requires( ): のように ( ) の中に何も書かなかった場合は、Requires: として扱われます。
1327                        </para>
1328
1329                        <para>
1330                                ( ) の中は、Requires(pre,preun,post,postun): のように , を用いることで複数を同時に指定できます。
1331                        </para>
1332
1333                        <table id="Requires-options">
1334                                <title>Requires の ( ) の中で利用できるもの</title>
1335                                <tgroup cols="2">
1336                                        <thead>
1337                                                <row><entry>項目</entry><entry>対応するタグ等</entry></row>
1338                                        </thead>
1339                                        <tbody>
1340                                                <row><entry>pre</entry><entry>%pre で必要になるもの</entry></row>
1341                                                <row><entry>preun</entry><entry>%preun で必要になるもの</entry></row>
1342                                                <row><entry>post</entry><entry>%post で必要になるもの</entry></row>
1343                                                <row><entry>postun</entry><entry>%postun で必要になるもの</entry></row>
1344                                                <row><entry>prereq</entry><entry>インストール時に必要になるもの</entry></row>
1345
1346                                                <row><entry>verify</entry><entry>%verifyscript で必要になるもの</entry></row>
1347                                                <row><entry>interp</entry><entry>スクリプト部を解釈(interpret)するために必要になるもの</entry></row>
1348                                                <row><entry>rpmlib</entry><entry>rpmのデータベース等を扱うために必要なもの</entry></row>
1349                                        </tbody>
1350                                </tgroup>
1351                        </table>
1352
1353                        <para>
1354                                Requires(pre): などを指定した場合には、<emphasis>インストール、アンインストールされる順番が保証されます。</emphasis>
1355                                指定されたパッケージは<emphasis>先にインストールされ、後にアンインストールされます。</emphasis>
1356                        </para>
1357
1358                        <para>prereq は pre,preun,post,postun などよりも曖昧な書き方ですが、以前 PreReq で書かれていたものを Requires に機械的に置き換える場合には利用できると思います。</para>
1359
1360                        <para>rpmlib については、通常、build 時に自動的に追加されるものなので、特別な機能を利用するのでなければ、記述する必要はありません。</para>
1361
1362                        <para>interp も、自動的に追加されますが、特別な shell などを利用する場合には記述しておいた方がよいでしょう。</para>
1363                </sect1>
1364
1365                <sect1 id="mr-provides">
1366                        <title>Provides</title>
1367                        <para>
1368                                日本語化されたgsであるgs<emphasis>j</emphasis>というパッケージがあるとします。
1369                                このパッケージはもともとのgsと同等の機能を持っています。
1370                                インストールしたいhoge-1.1-2.rpmがgsを必要(Requires)としてるとしましょう。
1371                                しかし、gs<emphasis>j</emphasis>がインストールされているためにgsはインストールされていません。
1372                                このとき、hoge.rpmをインストールしようとするとrpmコマンドは
1373                                gsが無いためにエラー・メッセージを出します。
1374                        </para>
1375                        <para>
1376                                このようなトラブルをさけるためには、gs<emphasis>j</emphasis>を作るときに、
1377                                <screen>Provides: gs</screen>
1378                                と書いておくと、gs<emphasis>j</emphasis>はgsパッケージを提供することができます。
1379                        </para>
1380                        <para>
1381                                また、あるパッケージ A がpdfを読むツールをRequiresするときに、
1382                                xpdf と gs(pdf対応) のように複数の選択肢がある場合、
1383                                xpdf と gs の Providesに
1384                                <screen>Provides: pdf-reader</screen>
1385                                と仮想的なパッケージ名(仮想パッケージ virtual package)を書いておいて、
1386                                A で Requires: pdf-reader としておけば、パッケージ名を限定せずに、
1387                                なんらかのpdf-readerがインストールされてることを要求できます。
1388                                たとえば emacs lisp のパッケージでは emacs や xemacs ではなく
1389                                emacsen という仮想パッケージを要求するものが多いです。
1390                        </para>
1391                </sect1>
1392
1393                <sect1 id="mr-buildreq">
1394                        <title>BuildRequires</title>
1395                        <para>
1396                                コンパイラなどのパッケージや、
1397                                ヘッダーファイルやライブラリなどを含んだ hoge-devel
1398                                などのパッケージで不足するものがないか確認しましょう。
1399                        </para>
1400                        <para>
1401                                また、Source: で指定されたファイルが hoge.zip のように zip 形式の場合は、
1402                                ソースの展開に unzip のパッケージが、
1403                                同様に lzh 形式なら lha のパッケージが必要になります。
1404                        </para>
1405                        <para>
1406                                Vine Linux では <filename>build-essential</filename> という仮想パッケージがあり、
1407                                このパッケージをインストールすることでたくさんのパッケージがインストールされます。
1408                                参照 <ulink url="using-rpm-4.html#using-rpm-4-2">環境設定</ulink>
1409                        </para>
1410                        <para>
1411                                パッケージの作成時には build-essential をインストールすることを前提としているので、
1412                                build-essential に含まれている make,gzip,bzip2,tar,patch,findutils,coreutils,file,libtool,automake,autoconf などは省略してかまいません。
1413                                gcc や gettext などは、ソースが C言語であることや、メッセージが国際化されていることなどを示す意味もあるので、必要であれば書いておいた方がいいかもしれません。
1414                        </para>
1415                        <para>
1416                                <emphasis>%prep</emphasis>,<emphasis>%setup</emphasis>,<emphasis>%build</emphasis>,<emphasis>%install</emphasis> で必要になるコマンドやパッケージを指定します。
1417                        </para>
1418                        <para>
1419                                Requires( ): と同じように、BuildRequires も ( ) をつけて詳細な指定をすることができます。
1420                        </para>
1421                        <para>
1422                                ( ) の中には<xref linkend="BuildRequires-options" />にあるものが入ります。
1423                                ( ) の中に入る項目は <xref linkend="mr-script" /> のタグ等に対応しています。どの部分で必要になるかを書きます。
1424                        </para>
1425                        <table id="BuildRequires-options">
1426                                <title>BuildRequires の ( ) の中で利用できるもの</title>
1427                                <tgroup cols="2">
1428                                        <thead>
1429                                                <row><entry>項目</entry><entry>対応するタグ等</entry></row>
1430                                        </thead>
1431                                        <tbody>
1432                                                <row><entry>prep</entry><entry>%prep,%setup で必要になるもの</entry></row>
1433                                                <row><entry>build</entry><entry>%build で必要になるもの</entry></row>
1434                                                <row><entry>install</entry><entry>%install,%check で必要になるもの</entry></row>
1435                                                <row><entry>clean</entry><entry>%clean で必要になるもの</entry></row>
1436                                        </tbody>
1437                                </tgroup>
1438                        </table>
1439                </sect1>
1440
1441                <sect1 id="mr-buildprereq">
1442                        <title>BuildPrereq</title>
1443                        <para>
1444                                BuildRequiresと同様にパッケージの作成の時に必要になるパッケージを書きます。
1445                                BuildRequiresとの違いは必要とするパッケージを<emphasis>作成する順番を決める</emphasis>ということです。
1446                        </para>
1447                        <para>
1448                                BuildRequiresと同様、BuildPrereq(prep) のように prep,build,install,clean を指定できます。
1449                        </para>
1450                        <!-- 参照 http://www.redhat.com/archives/rpm-list/2004-April/msg00164.html -->
1451                        <para>
1452                                A というパッケージがパッケージ作成時に B と C の二つのパッケージを必要としているとします。
1453                                この場合 B と C をインストールすれば、A というパッケージを作成することができます。
1454                        </para>
1455                        <para>
1456                                このときに B と C のパッケージがなくて、それぞれ作る必要があったとします。
1457                                B と C がそれぞれ独立したものではなく、C のパッケージ作成時に B が必要で、
1458                                できあがった C は B の特定のバージョンを必要とするパッケージになるということがあります。
1459                                このような場合には BuildPrereq に B を BuildRequires に C を指定し、
1460                                B を C よりも先に作成する必要があるということを示しておきます。
1461                        </para>
1462                </sect1>
1463        </chapter>
1464
1465        <chapter id="setup-macro">
1466                <title>%setupマクロの詳細</title>
1467                <para>
1468                        hoge-1.1.tar.gzを展開したときに、hoge-1.1/というディレクトリができるなら、
1469                        オプションをつけなくても以上の作業が行われますが、例えば、
1470                        hoge/というディレクトリができるなら、このディレクトリの下にcdできるように、
1471                        <screen>%setup -n hoge</screen>
1472                        または、
1473                        <screen>%setup -n ${RPM_PACKAGE_NAME}</screen>
1474                        と指定します。
1475                </para>
1476                <para>
1477                        複数のソースがあるときには以下に述べるオプション-aや-bを使います。
1478                        例えばSource、Source1、Source2の3つがあるときには、
1479                        <screen>%setup -a 1 -a 2 -n hoge</screen>
1480                        などとします。(以下のオプションの指定参照。)
1481                </para>
1482                <para>
1483                        この%setupにはさまざまなオプションがありますが、
1484                        代表的なものを以下に示します。
1485                </para>
1486                <variablelist>
1487                        <varlistentry>
1488                                <term>-n &lt;ディレクトリ名&gt;</term>
1489                                <listitem><para>
1490                                                %setupを実行した後(もしくは前)にcdするディレクトリ名(name)を指定する。
1491                                                このオプションを省略したときの、デフォルトのディレクトリ名は、
1492                                                ${RPM_PACKAGE_NAME}-${RPM_PACKAGE_VERSION}。
1493                                </para></listitem>
1494                        </varlistentry>
1495                        <varlistentry>
1496                                <term>-c</term>
1497                                <listitem><para>
1498                                                指定ディレクトリ(上の-nオプションで指定したディレクトリ)
1499                                                を作成し(create)、そこにcdした後にソースの展開をします。
1500                                </para></listitem>
1501                        </varlistentry>
1502                        <varlistentry>
1503                                <term>-a &lt;#&gt;</term>
1504                                <listitem><para>
1505                                                Source0を展開した後、
1506                                                指定ディレクトリ(上と同じ)にcdした(after)、
1507                                                #番目のソース(Source#)の展開をします。
1508                                                %setup -a 2 -a 3 と複数-aオプションが指定された時には、
1509                                                Source0 が展開された後、指定ディレクトリに cd し、
1510                                                Source2、Source3を展開します。
1511                                                (Source0の展開は最初の一回だけです。)
1512                                </para></listitem>
1513                        </varlistentry>
1514                        <varlistentry>
1515                                <term>-b &lt;#&gt;</term>
1516                                <listitem><para>
1517                                                Source0を展開した後、
1518                                                指定ディレクトリ(上と同じ)にcdする前に(before)、
1519                                                #番目に指定されてるソース(Source#)の展開をします。
1520                                </para></listitem>
1521                        </varlistentry>
1522                        <varlistentry>
1523                                <term>-D</term>
1524                                <listitem><para>
1525                                                先に述べたように、%setupは、まず、指定ディレクトリ(上と同じ)が、
1526                                                ディレクトリBUILDの下にあるかどうかをチェックして、もし存在していたら、
1527                                                それを削除してから、ソースの展開などの作業を行います。
1528                                                %setupを複数回呼びたい場合、
1529                                                2回目に%setupを呼んだ時に最初の%setupで展開したディレクトリを削除されては困ります。
1530                                                この-Dオプションは、このような削除を行わないようにします。(あまり使いません)
1531                                </para></listitem>
1532                        </varlistentry>
1533                        <varlistentry>
1534                                <term>-T</term>
1535                                <listitem><para>
1536                                                ソースの展開を行いません。先に述べたように、
1537                                                オプション指定を -a 2 や -b 2 とすると、
1538                                                Source0とSource2で指定したものが展開されます。
1539                                                Source2だけを展開したいときには、このオプションを使って、
1540                                                <screen>%setup -T -a 2</screen>
1541                                                とします。また、
1542                                                <screen>%setup -T -c hoge</screen>
1543                                                とすると、パッケージの展開は行わず、ディレクトリhogeを作って、
1544                                                そこにcdします。
1545                                </para></listitem>
1546                        </varlistentry>
1547                        <varlistentry>
1548                                <term>-q</term>
1549                                <listitem><para>
1550                                                ソースの展開のとき、展開中の情報を表示しません。
1551                                                たとえば tar での展開の時に、-q 無しだと tar xvvf、-q 有りだと tar xf のように変わります。
1552                                </para></listitem>
1553                        </varlistentry>
1554                </variablelist>
1555
1556                <para>
1557                        次のように tar.gz ではないファイルが Source0 となる場合があります。
1558                        <screen>Source0: hoge-%{version}.lzh</screen>
1559                        tar.gz ではないので、%setup では展開できません。
1560                </para>
1561                <para>
1562                        このような場合には、まず %setup の -Tオプション を利用して作業ディレクトリに移動します。
1563                        %setup のあとには、bash script を書いて作業を行うことができるので、
1564                        通常のコマンドで Source0 のファイルを展開します。
1565<screen>%setup -T hoge-%{version}
1566lha x %{SOURCE0}</screen>
1567                </para>
1568                <para>
1569                        次のように tar.gz などでは無いファイルが Source2 としてあるということがあります。
1570<screen>Source0: hoge-%{version}.tar.gz
1571Source1: hoge-additional-%{version}.tar.gz
1572Source2: how-to-use-hoge.txt</screen>
1573                </para>
1574                <para>
1575                        こういった場合には、Source0 と Source1 を %setup で展開したあとで、<command>installコマンド</command>などで、Source2 に対応するマクロ %{SOURCE2} を処理します。
1576                </para>
1577                <para>%setup で展開するのと同じ処理をしたければ、
1578<screen>%setup -q -a 1
1579%{__install} -m 644 %{SOURCE2} .</screen>
1580                        のようにします。
1581                </para>
1582                <para>
1583                        %setup で Source0 を展開してできたディレクトリ BUILD/hoge-%version/  に移動しているので、<command>installコマンド</command> で . (カレントディレクトリ<footnote><para>current directory, 現在のディレクトリ</para></footnote>) を指定すると . は BUILD/hoge-%version/ となっているので、BUILD/hoge-%version/に Source2 が install されます。
1584                </para>
1585                <para>他のファイルと同じように BUILD/hoge-%version/ にあるので %doc として指定するのもそのままできます。</para>
1586<screen>%files
1587%doc how-to-use-hoge.txt</screen>
1588                <para>%{SOURCE2} といったマクロは %doc のところでは使えないので、%doc %{SOURCE2} とすることはできません。</para>
1589
1590                <para>
1591                        lha や unzip など、特別なコマンドが必要になる場合は、
1592                        BuildRequires(prep): で指定します。
1593                </para>
1594        </chapter>
1595
1596        <chapter id="other-section">
1597                <title>スクリプト部で使用できるその他のセクション</title>
1598                <para>スクリプト部に入れることができるセクションは、<xref linkend="mr-script" />で説明したほかにもいろいろあります。</para>
1599                <!--以下のセクションはそれぞれインストール時やアンインストール時に起動するシェルスクリプトを記述するためのものです。-->
1600                <table id="pre-and-post">
1601                        <title>インストール時やアンインストール時に起動するセクション</title>
1602                        <tgroup cols="3">
1603                                <thead><row><entry>セクション名</entry><entry>概要</entry><entry>詳細説明</entry></row></thead>
1604                                <tbody>
1605                                        <row>
1606                                                <entry>%pre</entry>
1607                                                <entry>RPMパッケージをインストールするときパッケージの展開前に行うことを書く</entry>
1608                                                <entry><xref linkend="pre-section" /></entry>
1609                                        </row>
1610                                        <row>
1611                                                <entry>%post</entry>
1612                                                <entry>RPMパッケージをインストールするときパッケージの展開後に行うことを書く</entry>
1613                                                <entry><xref linkend="post-section" /></entry>
1614                                        </row>
1615                                        <row>
1616                                                <entry>%preun</entry>
1617                                                <entry>RPMパッケージをアンインストールするとき展開ファイルの削除前に行うことを書く</entry>
1618                                                <entry><xref linkend="preun-section" /></entry>
1619                                        </row>
1620                                        <row>
1621                                                <entry>%postun</entry>
1622                                                <entry>RPMパッケージをアンインストールするとき各ファイルを削除した後に行うことを書く</entry>
1623                                                <entry><xref linkend="postun-section" /></entry>
1624                                        </row>
1625                                </tbody>
1626                        </tgroup>
1627                </table>
1628                <para>さらに、他のパッケージがインストールされた時に起動するスクリプトも記述できます。</para>
1629                <table id="triggers">
1630                        <title>他のパッケージがインストールされた時に起動するセクション</title>
1631                        <tgroup cols="3">
1632                                <thead><row><entry>セクション名</entry><entry>概要</entry><entry>詳細説明</entry></row></thead>
1633                                <tbody>
1634                                        <row>
1635                                                <entry>%triggerin</entry>
1636                                                <entry>あるパッケージがインストールされていた、もしくは、された時に起動するスクリプト</entry>
1637                                                <entry><xref linkend="triggerin-section" /></entry>
1638                                        </row>
1639                                        <row>
1640                                                <entry>%triggerun</entry>
1641                                                <entry>あるパッケージの削除前に起動するスクリプト</entry>
1642                                                <entry><xref linkend="triggerin-section" />参照</entry>
1643                                        </row>
1644                                        <row>
1645                                                <entry>%triggerpostun</entry>
1646                                                <entry>あるパッケージの削除後に起動するスクリプト</entry>
1647                                                <entry><xref linkend="triggerin-section" />参照</entry>
1648                                        </row>
1649                                </tbody>
1650                        </tgroup>
1651                </table>
1652                <para>パッケージが正しくインストールされているかを検証するには、rpm コマンドで -V オプションを用いますが、-V オプションでできることを増やすためのセクションもあります。</para>
1653                <table id="verifyscript-table">
1654                        <title>パッケージの検証時に起動するセクション</title>
1655                        <tgroup cols="3">
1656                                <thead><row><entry>セクション名</entry><entry>概要</entry><entry>詳細説明</entry></row></thead>
1657                                <tbody>
1658                                        <row>
1659                                                <entry>%verifyscript</entry>
1660                                                <entry>RPMパッケージを検証するとき(rpm -Vを実行した時)に追加して起動するスクリプト</entry>
1661                                                <entry><xref linkend="verifyscript-section" /></entry>
1662                                        </row>
1663                                </tbody>
1664                        </tgroup>
1665                </table>
1666                <para>この章で説明するセクションは、SPECファイルからRPMパッケージを作るときには、実行されることはありません。</para>
1667                <para>
1668                        <emphasis>%pre %post %preun %postun %triggerin %triggerun %triggerpostun といったセクションを使うのは、ちょっと注意が必要です。</emphasis>
1669                        詳しくは、<xref linkend="mr-important" />を参照してください。
1670                </para>
1671                <sect1 id="pre-section">
1672                        <title>%preセクション</title>
1673                        <para>
1674                                RPMパッケージをインストールするとき、パッケージの展開前に行うことを書く。
1675                                -pオプションについては%postの場合(以下)参照。
1676                        </para>
1677                        <para>ここでの処理で必要となるパッケージ等は、Requires(pre): で指定します。</para>
1678                </sect1>
1679
1680                <sect1 id="post-section">
1681                        <title>%postセクション</title>
1682                        <para>RPMパッケージをインストールするとき、パッケージの展開後に行うことを書く。</para>
1683                        <para>ここでの処理で必要となるパッケージ等は、Requires(post): で指定します。</para>
1684                        <example>
1685                                <title>%postセクションを利用してinfoファイルをインストールする例</title>
1686                                <para>
1687<screen>%post
1688if [ "$1" = 0 ] ; then
1689%{_syssbindir}/install-info %{_infodir}/hoge.info.gz %{_infodir}/dir
1690fi</screen>
1691                                        として、info のメニューエントリに infoファイルを追加します。
1692                                        if [ $1 = 0 ]; then と fi の行は、
1693                                        アップグレード時には実行せず、インストール時だけに実行させるための記述です。
1694                                        <xref linkend="mr-symlink" />も参照してください。
1695                                </para>
1696                                <para>
1697                                        %{_syssbindir}/install-info というコマンドが必要になるので、
1698                                        Requires(post): %{_syssbindir}/install-info とします。
1699                                </para>
1700                                <para>
1701                                        info ファイルは、アンインストール時にも処理が必要になります。
1702                                        <xref linkend="preun-section" /> も参照してください。
1703                                </para>
1704                        </example>
1705
1706                        <example>
1707                                <title>ライブラリをインストールする後にldconfigを実行する例</title>
1708                                <para>
1709<screen>
1710%post
1711%{_syssbindir}/ldconfig
1712</screen>
1713                                        とすると、ldconfigが実行される。また、代わりに
1714                                        <screen>%post -p %{_syssbindir}/ldconfig</screen>
1715                                        と、-pオプションを用いて書くと、
1716                                        シェルを起動すること無く直接コマンドが実行される。
1717                                        またこのコマンドはrpmパッケージのインストール時に必要なコマンドとして、
1718                                        Requires(interp): %{_syssbindir}/install-info として登録される。
1719                                </para>
1720
1721                                <para>
1722                                        正確にいうと、タグに <option>-p</option>オプションをつけた場合は、
1723                                        /bin/sh ではなく別のプログラムでスクリプト部分を解釈(interpret)させるということになります。
1724                                        この場合には Requires(interp) として登録されます。(%postなので Requires(post) としても登録されます。)
1725                                </para>
1726                        </example>
1727                        <example>
1728                                <title>%postセクションで-pオプションを使用して問題が起こる例</title>
1729                                <para>
1730<screen>
1731%post -p %{_syssbindir}/ldconfig
1732# update ld.so.cache
1733
1734%files</screen>
1735                                        この場合は %post と %files の間の2行が、スクリプト部分になります。
1736                                        一行目に
1737                                        <screen># update ld.so.cache</screen>
1738                                        と書いてあります。
1739                                        bash であれば、# で始まる行は コメントと解釈され無視されますが、
1740                                        このスクリプト部分を読み、実行するのは /bin/sh ではなく %{_syssbindir}/ldconfig です。
1741                                        ldconfig には # 以降をコメントとして無視するというルールは無いので、
1742                                        そのまま実行しようとしてエラーになります。
1743                                </para>
1744                                <para>
1745                                        エラーを起こさないようにするには
1746<screen>
1747%post -p %{_syssbindir}/ldconfig
1748
1749
1750%files</screen>
1751                                        とするか、
1752<screen>
1753%post
1754%{_syssbindir}/ldconfig
1755# update ld.so.cache
1756
1757%files</screen>
1758                                        とします。
1759                                </para>
1760
1761                                <para>
1762                                        一つ目の例では、%{_syssbindir}/ldconfig がスクリプト部分を実行するために起動し(、起動した時点で ld.so.cache が更新されますが)、スクリプト部分については何も書かれていないので何もせずに終了します。
1763                                </para>
1764                                <para>
1765                                        二つ目の例では、/bin/sh が起動し、スクリプト部分を解釈し %{_syssbindir}/ldconfig を実行、# 以下はコメントなので無視します。
1766                                </para>
1767                        </example>
1768                </sect1>
1769
1770                <sect1 id="preun-section">
1771                        <title>%preunセクション</title>
1772                        <para>RPMパッケージをアンインストールするとき、展開ファイルの削除前に行うことを書く。</para>
1773                        <para>ここでの処理で必要となるパッケージ等は、Requires(preun): で指定します。</para>
1774                        <para>-pオプションについては%postの場合と同様です。Requires(interp): と Requires(preun): に登録されます。</para>
1775                        <example>
1776                                <title>%preunセクションを利用してinfoファイルをアンインストールする例</title>
1777                                <para>
1778<screen>
1779%preun
1780if [ $1 = 0 ]; then
1781%{_syssbindir}/install-info --delete %{_infodir}/hoge.info.gz %{_infodir}/dir
1782fi
1783</screen>
1784                                        として、info のメニューエントリから削除します。
1785                                        if [ $1 = 0 ]; then と fi の行は、
1786                                        アップグレード時には実行せず、アンインストール時だけに実行させるための記述です。
1787                                        <xref linkend="mr-symlink" />も参照してください。
1788                                </para>
1789                        </example>
1790                </sect1>
1791                <sect1 id="postun-section">
1792                        <title>%postunセクション</title>
1793                        <para>RPMパッケージをアンインストールするとき、各ファイルを削除した後に行うことを書く。</para>
1794                        <para>ここでの処理で必要となるパッケージ等は、Requires(postun): で指定します。</para>
1795                        <para>-pオプションについては%postの場合と同様です。Requires(interp): と Requires(postun): に登録されます。</para>
1796                </sect1>
1797
1798                <sect1 id="triggerin-section">
1799                        <title>%triggerinセクション</title>
1800                        <para>あるパッケージがインストールされていた、もしくは、された時に起動するスクリプトを書く。</para>
1801                        <example>
1802                                <title>%triggerinセクションの使用例</title>
1803                                <para>
1804<screen>
1805%triggerin -- hoge
1806echo "hoge is installed"
1807</screen>
1808                                        と書いておくと、パッケージhogeをインストールしたときに、
1809                                        上記メッセージが表示されます。以下のように、バージョン指定もできます。
1810<screen>
1811%triggerin -- hoge &gt; 3.0
1812echo "hoge is installed"
1813</screen>
1814                                </para>
1815                        </example>
1816                        <para>
1817                                同様にして、あるパッケージの削除前に実行される%triggerun、
1818                                あるパッケージの削除後に実行される%triggerpostunがあります。このセクションについては、
1819                                <filename>/usr/share/doc/rpm-&lt;version&gt;/triggers</filename> に詳しい説明があります。
1820                        </para>
1821                </sect1>
1822
1823                <sect1 id="verifyscript-section">
1824                        <title>%verifyscriptセクション</title>
1825                        <para>RPMパッケージを検証するとき(rpm -Vを実行した時)に、追加して実行することを書く。</para>
1826                        <para>ここでの処理で必要となるパッケージ等は、Requires(verify): で指定します。</para>
1827                        <para>-pオプションについては%postの場合と同様です。Requires(interp): と Requires(verify): に登録されます。</para>
1828                        <para>このスクリプトの実行結果は、成功した場合には何も表示されず、エラーが発生したときにエラーメッセージのみが標準出力に出力されます。rpm -Vvv などのようにした場合には、標準出力への出力も確認できます。</para>
1829
1830                        <para>
1831                                たとえば、%pre で %{_sbindir}/useradd hoge などとしてユーザーを登録した場合には、
1832<screen>%verifyscript
1833%{_bindir}/id hoge</screen>
1834                                としておくと、hoge というユーザーが存在しているかどうかを確認することができます。
1835                        </para>
1836                        <para>
1837                                この場合、/usr/bin/id というコマンドは coreutils というパッケージに含まれているので、
1838                                Requires(verify): %{_bindir}/id あるいは、Requires(verify): coreutils とします。
1839                        </para>
1840                </sect1>
1841        </chapter>
1842
1843        <chapter id="mr-subpkg">
1844                <title>サブパッケージの作成方法</title>
1845                <para>インストールされるファイル全体の容量が大きくなる場合、アプリケーションの実行時に必要なファイルのみを本体に収録し、他のファイルをサブパッケージ化することがあります。</para>
1846                <para>たとえば、muleのRPMパッケージをつくるときに、本体のRPMパッケージがelcを含んでいれば、
1847                        そのソースであるelファイルはなくてもmuleの実行には問題ないですから、
1848                        mule.rpm と mule-el.rpm みたいにわけたほうがよいかもしれません。</para>
1849                <para>また、ライブラリや開発用ヘッダファイルもソースに含まれるアプリケーションをパッケージ化する時は、
1850                        アプリ本体の hoge.rpm と、開発者用に hoge.h を入れたhoge-devel.rpmにわけたいこともあるでしょう。
1851                        ドキュメントが大きいと、hoge-docs.rpmも別に作りたいこともあるでしょう。
1852                </para>
1853                <para>
1854                        こういうときには、ちょっとSPECファイルを変更するだけで、
1855                        サブパッケージの作成をすることができます。 具体的には、
1856                        サブパッケージ(ここでは、hogeのサブパッケージhoge-docsとする)のための、
1857                        データ定義部(%package docsではじまり、GroupやSummary、%description docsなどを書く部分)と、
1858                        そのサブパッケージにいれるファイルを列挙した%files docs から始まるファイルリストを付け加えます。
1859                        具体例は、RPM-BUILD-HOWTOにもありますので、興味のある人はそちらを参照してください。
1860                </para>
1861                <para><xref linkend="subpkg-name" />には、よく使われるサブパッケージ名を記載しています。サブパッケージ作成時の参考としてください。</para>
1862                <table id="subpkg-name">
1863                        <title>一般的なサブパッケージ名</title>
1864                        <tgroup cols="2">
1865                                <thead><row><entry>サブパッケージ名</entry><entry>収録内容</entry></row></thead>
1866                                <tbody>
1867                                        <row>
1868                                                <entry>devel</entry>
1869                                                <entry>メインパッケージのライブラリを使うプログラムをコンパイルする際に必要なヘッダファイル (*.h)</entry>
1870                                        </row>
1871                                        <row>
1872                                                <entry>libs</entry>
1873                                                <entry>ランタイムライブラリ *.so.*。本体パッケージのサイズがある程度大きくなった場合などの理由がある場合、本体にはバイナリや設定ファイルを、ライブラリを -libs サブパッケージに分けて収録することがあります。</entry>
1874                                        </row>
1875                                        <row>
1876                                                <entry>static</entry>
1877                                                <entry>static ライブラリ (*.a)。明確な理由により static ライブラリを必要とする場合にサブパッケージ化する。それ以外の場合は、パッケージ対象から除外してください。</entry>
1878                                        </row>
1879                                        <row>
1880                                                <entry>tools, utils</entry>
1881                                                <entry>本体のパッケージが主にライブラリを収録している場合、ツールなどのバイナリやスクリプト群をサブパッケージ化する場合があります</entry>
1882                                        </row>
1883                                        <row>
1884                                                <entry>doc, docs</entry>
1885                                                <entry>付属ドキュメント類などを独立したサブパッケージに分けたもの</entry>
1886                                        </row>
1887                                        <row>
1888                                                <entry>demos, example</entry>
1889                                                <entry>サンプルスクリプトやサンプルコード類をサブパッケージに分けたもの</entry>
1890                                        </row>
1891                                </tbody>
1892                        </tgroup>
1893                </table>
1894                <!-- ここにtracからサブパッケージ化のルールをもってくる -->
1895        </chapter>
1896
1897        <chapter id="mr-specific">
1898                <title>パッケージ固有の作法等について</title>
1899
1900                <sect1 id="add_to_gnome_menu">
1901                        <title>GNOME,KDE,Xfce のメニューに追加するために</title>
1902
1903                        <para>GNOME,KDE,Xfce のメニューに追加するためには、ディレクトリ<filename>/usr/share/applications</filename><filename>アプリケーションの名前.desktop</filename> というファイル(以降 desktopファイルと呼びます)をインストールする必要があります。</para>
1904
1905                        <para>desktopファイルを取り扱う <command>desktop-file-install</command>コマンド、<command>desktop-file-validate</command>コマンド、<command>update-desktop-database</command>コマンドは、<filename>desktop-file-utils</filename>というパッケージに含まれています。</para>
1906
1907                        <para>desktopファイルの扱いは次のような手順になります。</para>
1908                        <itemizedlist>
1909                                <listitem><para>
1910                                                %installタグの部分で次のようにして desktopファイルを<filename>%{buildroot}/%{_datadir}/applications</filename>にインストールしておきます。
1911
1912<screen>
1913%install
1914%{__mkdir_p} %{buildroot}/%{_datadir}/applications
1915%{_bindir}/desktop-file-install --dir=%{buildroot}/%{_datadir}/applications <filename>hoge.desktop</filename>
1916</screen>
1917
1918                                </para></listitem>
1919                                <listitem><para>%checkタグの部分で次のようにして desktopファイルが書式にしたがって正しく書かれているかをチェックします。</para>
1920<screen>
1921%check
1922%{_bindir}/desktop-file-validate %{buildroot}/%{_datadir}/applications/hoge.desktop
1923</screen>
1924
1925                                        <para>ソースから make する、make install するなどの部分ではこのチェックが行われないことも多いので、%checkタグの部分でチェックを行うようにしておきます。</para>
1926                                        <para><command>desktop-file-validate</command>コマンドは複数のファイルをまとめて処理できないので、*.desktop のようにはできません。desktopファイルの数だけ、コマンドを書いてください。もちろん、for文などを使ってもかまいません。
1927                                </para></listitem>
1928                                <listitem><para>
1929                                                %postタグや%postunタグの部分で
1930<screen>
1931%post
1932if [ -x %{_bindir}/update-desktop-database ] ; then
1933%{_bindir}/update-desktop-database %{_datadir}/applications
1934fi
1935
1936%postun
1937if [ -x %{_bindir}/update-desktop-database ] ; then
1938%{_bindir}/update-desktop-database %{_datadir}/applications
1939fi
1940</screen>
1941                                                のように処理します。
1942                                                <command>update-desktop-database</command> コマンドがインストールされていなければ実行しない、という形にすることで、twm や icewm や WindowMaker など、GNOME等のメニューとは直接関係ないウィンドウマネージャを使用しているときに、deskto-file-utils に依存せずにすむようになります。
1943                                </para></listitem>
1944                                <listitem><para>
1945                                                他のファイルと同じように %filesの部分に入れておきます。
1946<screen>%files
1947%{_datadir}/applications/<filename>hoge.desktop</filename></screen>
1948                                </para></listitem>
1949                                <listitem><para>
1950                                                BuildRequires で desktop-file-utils を指定します。
1951                                                <screen>BuildRequires(install,check): <filename>desktop-file-utils</filename></screen>
1952                                </para></listitem>
1953                        </itemizedlist>
1954                </sect1>
1955
1956                <sect1 id="emacs_lisp_package">
1957                        <title>Emacs Lisp のパッケージ</title>
1958
1959                        <para>Emacsen には emacsen-common というパッケージがあり、
1960                                インストールされている Emacsen の FLAVOR の情報や、
1961                                FLAVOR ごとに、その FLAVOR で byte compile された Emacs Lisp パッケージのリストを管理するという仕組みがあります。</para>
1962                        <para>この仕組みを用いることで以下のようなことが可能となっています。</para>
1963                        <itemizedlist>
1964                                <listitem><para>
1965                                                パッケージのインストール時に、すでにインストールされている Emacsen の FLAVOR ごとにそれぞれ byte compile して elc ファイルを作成する。</para></listitem>
1966                                <listitem><para>
1967                                                パッケージのアンインストール時に、すべての FLAVOR からパッケージの elc ファイルを削除する。</para></listitem>
1968                                <listitem><para>
1969                                                Emacsen の FLAVOR のインストール時、アンインストール時に、その FLAVOR で byte compile する、FLAVOR で byte compile した elc を削除する。</para></listitem>
1970                        </itemizedlist>
1971                        <para>この仕組みを利用するために、Emacs Lisp のパッケージでは以下のようなことをしておきます。</para>
1972                        <itemizedlist>
1973                                <listitem><para>
1974                                                %installタグの部分では byte compile していない el ファイルを
1975                                                %{_datadir}/emacs/site-lisp/%{name} 以下にインストールします。</para></listitem>
1976                                <listitem><para>
1977                                                Source2 や Source3 などに byte-compile と install を行うためのスクリプトAと、
1978                                                byte-compile してできた elc ファイルを削除するためのスクリプトBを用意します。
1979                                                インストールに使える Makefile 等がある場合は %installタグの部分で
1980                                                %{_datadir}/emacs/site-lisp/%{name} 以下に Makefile 等をインストールしておき、
1981                                                スクリプトの中から利用できるようにします。</para></listitem>
1982                                <listitem><para>
1983                                                install 用のスクリプトAでは、
1984                                                Emacsen の FLAVOR に応じて %{_datadir}/FLAVOR/site-list/%{name}/ 以下に
1985                                                bytecompile した elc ファイルをインストールするようにします。</para></listitem>
1986                                <listitem><para>
1987                                                uninstall 用のスクリプトBでは、
1988                                                Emacsen の FLAVOR に応じてスクリプトAでインストールした elc ファイルを削除するようにしておきます。</para></listitem>
1989                                <listitem><para>
1990                                                %installタグの部分で次のようにして、スクリプトAとスクリプトBをインストールします。
1991<screen>
1992%_installemacsenscript %{name} %{SOURCE2}
1993
1994%_removeemacsenscript  %{name} %{SOURCE3}
1995
1996</screen>
1997                                                スクリプトA,B はそれぞれ /usr/lib/emacsen-common/packages/install/ , /usr/lib/emacsen-common/packages/remove/ に、
1998                                                %{name} という名前でインストールされます。
1999                                                これによって、スクリプトA,B は、Emacs の FLAVOR がインストール、アンインストールされた時に実行されるようになります。</para>
2000                                        <para>%files の部分でそれぞれのスクリプトを記述しておきます。</para>
2001<screen>%{_libdir}/emacsen-common/packages/install/%{name}
2002%{_libdir}/emacsen-common/packages/remove/%{name}</screen></listitem>
2003                                <listitem><para>
2004                                                %postタグの部分は次のように記述しておきます。
2005                                                if [ "$1" = 数字 ]; then ; fi は、インストール時、アップグレード時、アンインストール時、それぞれで違う動作をさせるためのものです。<xref linkend="mr-important" />を参照してください。
2006<screen>
2007%post
2008#
2009# bytecompile and install
2010#
2011
2012if [ "$1" = 2 ]; then
2013%_emacsenPackageRemove %{name}
2014
2015fi
2016
2017%_addemacsenlist %{name}
2018
2019%_emacsenPackageInstall %{name}
2020
2021%preun
2022
2023if [ "$1" = 0 ]; then
2024%_emacsenPackageRemove %{name}
2025
2026%_removeemacsenlist %{name}
2027
2028fi
2029</screen>
2030                                        </para>
2031                                        <para>%_emacsenPackageInstall と %_emacsenPackageRemove は スクリプトA,B を実行するためのマクロです。</para>
2032                                        <para>%_addemacsenlist と %_removeemacsenlist は、インストール済み Emacs Lisp パッケージのリストにパッケージを登録する、削除するというマクロです。</para>
2033                                        <para>
2034                                                %_installemacsenscript, %_removeemacsenscript, %_emacsenPackageRemove, %_addemacsenlist,
2035                                                %_removeemacsenlist の行の次の行は、空行にしておかないとエラーとなるようです。</para></listitem>
2036                        </itemizedlist>
2037                </sect1>
2038
2039
2040                <sect1 id="add_to_alternatives">
2041                        <title>alternatives を利用するパッケージ</title>
2042
2043                        <para>alternatives については <ulink url="update-alternatives.html">update-alternatives による標準コマンドの切り替え</ulink> にまとめられています。</para>
2044
2045                        <para>
2046                                alternatives に登録する場合には %post と %preun で次のようにします。
2047<screen>%post
2048if [ "$1" = "1" ]; then
2049%{_syssbindir}/update-alternatives --install リンク名 総称名 選択候補 優先度
2050fi
2051
2052%preun
2053if [ "$1" = "0" ]; then
2054%{_syssbindir}/update-alternatives --remove 総称名 選択候補
2055fi</screen>
2056                        </para>
2057                        <para>Provides と Requires を指定します。
2058<screen>Provides: 総称名 リンク名
2059Requires: update-alternatives
2060Requires(post,preun): %{_syssbindir}/update-alternatives</screen>
2061                                とします。
2062                        </para>
2063
2064                        <para>
2065                                Provides の リンク名 については、無くても問題はありませんが、%files には書かれないファイルなので、Provides に書いておいたほうがよいと思います。
2066                        </para>
2067
2068                        <para>
2069                                %post での登録と %preun での削除は、インストール時とアンインストール時だけに必要で、アップグレード時に実行してしまうと問題があるので、"$1" が 1 の場合(インストール時)と 0 の場合(アンインストール時)だけ処理するように if 文 にしておきます。
2070                        </para>
2071
2072                        <para>
2073                                %post での処理を、パッケージのアップグレード時にも行ってしまうと、パッケージのインストール後にユーザが優先度を変更していた場合、それを無視してパッケージ側で優先度を勝手に変更してしまうことになります。
2074                        </para>
2075
2076                        <para>
2077                                新規パッケージではなく、既存のパッケージの %post,%preun に update-alternatives の処理を追加する場合には、次のようにするとよいかもしれません。
2078<screen>%post
2079if [ "$1" = "1" ]; then
2080if [ "`%{_sysbindir/update-alternatives --list '総称名' | grep -c 'リンク名'`" = "0" ]; then
2081%{_syssbindir}/update-alternatives --install リンク名 総称名 選択候補 優先度
2082fi
2083fi
2084
2085%preun
2086if [ "$1" = "0" ]; then
2087%{_syssbindir}/update-alternatives --remove 総称名 選択候補
2088fi</screen>
2089                        </para>
2090
2091                        <para>
2092                                %triggerin と %triggerpreun と %preun を用いることで、他のパッケージが持っているファイルを alternatives で登録するようなパッケージを作ることもできます。
2093
2094<screen>Provides: 総称名 リンク名
2095Requires: update-alternatives
2096Requires(preun,triggerin,triggerpreun): %{_syssbindir}/update-alternatives
2097
2098%preun
2099if [ "$1" = "0" ]; then
2100%{_syssbindir}/update-alternatives --remove-all 総称名
2101fi
2102
2103%triggerin -- 対象となるパッケージ
2104if [ "$1" = "1" ]; then
2105echo triggerin scriptlet by %{name} start
2106%{_syssbindir}/update-alternatives --install リンク名 総称名 選択候補 優先度
2107echo triggerin scriptlet by %{name} end
2108fi
2109
2110%triggerpreun -- 対象となるパッケージ
2111if [ "$1" = "0" ]; then
2112echo triggerpreun scriptlet by %{name} start
2113%{_syssbindir}/update-alternatives --remove 総称名 選択候補
2114echo triggerin scriptlet by %{name} end
2115fi</screen>
2116                        </para>
2117                </sect1>
2118
2119                <sect1 id="use-gconf2">
2120                        <title>GConf2を利用するパッケージ</title>
2121                        <para>GConf2を設定の保存に利用しているアプリケーションの場合、通常、<command>make install</command>の途中でデフォルトの設定値が記述されたファイルをGConf2に登録しようとします。</para>
2122                        <para>しかし、このタイミングでGConf2への登録を行うとRPMパッケージ化の際にエラーを吐きますし、RPMパッケージをインストールしてもGConf2には何も登録されません。</para>
2123                        <para>この様なアプリケーションをパッケージ化する場合は、以下のようにSPECファイルを記述してGConf2への登録のタイミングを制御する必要があります。</para>
2124                        <itemizedlist>
2125                                <listitem>
2126                                        <para>%installセクションのmake installの前後を以下のように記述します。</para>
2127<screen>
2128export GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL=1
2129make install
2130unset GCONF_DISABLE_MAKEFILE_SCHEMA_INSTALL
2131</screen>
2132                                        <para>これでmake install時にGConf2への登録が省略されます。</para>
2133                                </listitem>
2134                                <listitem>
2135                                        <para>%postセクションに以下の記述を追加します。</para>
2136<screen>
2137export GCONF_CONFIG_SOURCE=`gconftool-2 --get-default-source`
2138gconftool-2 --makefile-install-rule %{_sysconfdir}/gconf/schemas/<replaceable>package</replaceable>.schemas > /dev/null
2139</screen>
2140                                        <para><replaceable>package</replaceable>の部分は、適切な名前(ワイルドカード使用可)に置き換えてください。</para>
2141                                </listitem>
2142                                <listitem>
2143                                        <para><emphasis>%preun</emphasis>セクションに以下の記述を追加します。</para>
2144<screen>
2145if [ $1 = 0 ]; then
2146        export GCONF_CONFIG_SOURCE=`gconftool-2 --get-default-source`
2147        gconftool-2 --makefile-uninstall-rule %{_sysconfdir}/gconf/schemas/<replaceable>package</replaceable>.schemas > /dev/null
2148fi
2149</screen>
2150                                        <para>これは、削除される前の .schemas ファイルを利用しますので%postunセクションでは駄目です。</para>
2151                                </listitem>
2152                        </itemizedlist>
2153                </sect1>
2154
2155                <sect1 id="library-package">
2156                        <title>ライブラリのパッケージングポリシー</title>
2157                        <sect2>
2158                                <title>staticライブラリを収録しない</title>
2159                                <para>Vine Linuxでは従来、staticライブラリ(*.a)を-develサブパッケージに収録していました。しかし、以下の理由から今後は原則としてstaticライブラリをパッケージに収録しないこととします。</para>
2160                                <itemizedlist>
2161                                        <listitem><para>あるライブラリにバグ、セキュリティホールなどが発見された場合にそれをリンクしているパッケージを追跡することが難しい</para></listitem>
2162                                        <listitem><para>staticリンクした場合、ライブラリの問題でアプリケーション全体の再ビルドが必要となる</para></listitem>
2163                                </itemizedlist>
2164                                <para>ただし、明確な理由によりstaticライブラリを必要とする場合は、メインパッケージや -devel サブパッケージに収録するのではなく、-static サブパッケージを作成して収録してください。</para>
2165                        </sect2>
2166                        <sect2>
2167                                <title>libtoolライブラリを収録しない</title>
2168                                <para>従来、一部のパッケージで Libtool で使われる .la ファイル (ライブラリアーカイブ、擬似ライブラリ)がパッケージに収録されていました。しかし、以下の理由から今後は原則としてパッケージには収録しないこととします。 </para>
2169                                <itemizedlist>
2170                                        <listitem><para>Linux などの場合では .la ファイルを使わずとも .so に情報が内包されているため、.la ファイルは必要ではない</para></listitem>
2171                                        <listitem><para>間違った情報がはいっていることもあり、それが原因で問題がおこる場合がある</para></listitem>
2172                                        <listitem><para>.la があったりなかったりという状態が混在すると、ライブラリを見つけられない場合が発生する</para></listitem>
2173                                </itemizedlist>
2174                        </sect2>
2175                </sect1>
2176        </chapter>
2177</part>
2178
2179<appendix id="mr-important">
2180        <title>RPMパッケージをつくるときの注意</title>
2181        <sect1 id="mr-symlink">
2182                <title>シンボリック・リンク等を%postとかで張らない</title>
2183                <subtitle>間違えてもそれ(%postではったリンクなど)を%preunや%postunで削除してはいけない</subtitle>
2184                <para>
2185                        シンボリック・リンクを含む全てのファイルを%installまででインストールして、
2186                        %filesに加えるべきである。
2187                </para>
2188                <para>
2189                        これは特に重要です。よく、%post で、シンボリック・リンクをはって、
2190                        %preun でそのリンクを削除するようなSPECファイルがあります。
2191                        これを行うと、アップデート時に問題が生じることがあります。以前、
2192                        libcのパッケージでこういう記述が入ってるものがあって、
2193                        深刻な問題が生じたこともありました。
2194                </para>
2195
2196                <para>
2197                        その理由は、rpm -U &lt;new-rpm&gt; としたときに、
2198<screen>
2199rpm -e &lt;old-rpm&gt;
2200rpm -i &lt;new-rpm&gt;
2201</screen>
2202                ではなく、
2203<screen>
2204rpm -i &lt;new-rpm&gt;
2205rpm -e &lt;old-rpm&gt;
2206</screen>
2207                        とはたらくためです。
2208                </para>
2209                <para>
2210                        つまり、%post で、シンボリック・リンクをはって、
2211                        %preun でそれを削除するような rpm のバージョンアップをしようと、
2212                        rpm -U (アップデート)を実行すると
2213                        <orderedlist>
2214                                <listitem><para>
2215                                                新しいパッケージのインストールが行なわれ、
2216                                                %postでシンボリック・リンクがつくられる。
2217                                </para></listitem>
2218                                <listitem><para>
2219                                                古いパッケージのアンインストールが行なわれる。
2220                                                このとき、%preunでさっき新しいパッケージが作ったシンボリック・
2221                                                リンクが削除される。
2222                                </para></listitem>
2223                        </orderedlist>
2224                        この仕様は、libcとかのアップグレードの途中でlibcとかがなくなってトラブルが生じるのを避けようとしたためのものと思われます。
2225                </para>
2226                <para>
2227                        実はこの問題は解決法があります。
2228                        %pre, %post, %preun, %postunのスクリプト実行時には、スクリプトに対して以下の引数が与えられます。
2229                </para>
2230                <itemizedlist>
2231                        <listitem>
2232                                <para>rpm -iでインストールを行うとき</para>
2233                                <para>%pre, %postに対して$1=1</para>
2234                        </listitem>
2235                        <listitem>
2236                                <para>rpm -Uでアップデートを行うとき</para>
2237                                <itemizedlist>
2238                                        <listitem><para>
2239                                                        新しいrpmのインストール時に、
2240                                                        %pre, %postに対して$1=2
2241                                        </para></listitem>
2242                                        <listitem><para>
2243                                                        古いrpmをアンインストール時に、
2244                                                        %preun, %postunに対して$1=1
2245                                        </para></listitem>
2246                                </itemizedlist>
2247                        </listitem>
2248                        <listitem>
2249                                <para>rpm -eでアンインストールを行うとき</para>
2250                                <para>%preun, %postunに対して$1=0</para>
2251                        </listitem>
2252                </itemizedlist>
2253                <para>
2254                        すなわち、はじめてインストールするときには、引数として1がわたされ、
2255                        rpm -eでアンインストールするときには0がわたされるわけです。
2256                        これを利用すると、
2257<screen>
2258%post
2259if [ $1 = 1]; then
2260        echo ``First installation!''
2261fi
2262%preun
2263if [ $1 = 0]; then
2264        echo ``Good bye!''
2265fi
2266</screen>
2267                        とかできるわけです。
2268                        (それでも%postなどでシンボリック・リンクをはったりすると、
2269                        出どころ不明のファイルが増えることになります。その他トラブルをさけるため、
2270                        できるだけファイルは%filesに加えるようにし、
2271                        %postなどに書くスクリプトはできるだけ少なくしましょう)
2272                </para>
2273        </sect1>
2274        <sect1 id="minimum-epoch">
2275                <title>むやみに Epoch を使わない。</title>
2276                <para>Epoch については説明しませんが、
2277                        パッケージのバージョン管理に混乱を引き起こす場合があるので、
2278                        絶対に必要という場合以外は利用しないでください。
2279                        なお、Serial は rpm 4.4 で obsolete となっています。
2280                </para>
2281        </sect1>
2282        <sect1 id="minimum-subpkgs">
2283                <title>あまり細かくサブパッケージに分けない</title>
2284                <para>
2285                        サブパッケージの作り方を覚えると、やたら沢山のサブパッケージをつくる人がいるが、
2286                        アップグレード時のメンテ(rpm -UやSPECの書き直し)が面倒になるばかりか、
2287                        どれがなんだか分からなくなったりする。分割は必要最小限に。
2288                </para>
2289        </sect1>
2290        <sect1 id="minimum-config">
2291                <title>%configは乱用しない</title>
2292                <para>
2293                        %configを多くすると、%filesが非常にわかりづらくなることがあり、
2294                        version up等の時にこの部分のメンテに労力がかかるようになりよくない。
2295                        デフォルトのままで出来るだけ多くの人が利用できるようなconfigファイルを用意し、
2296                        ユーザの%configの設定は必要最小限ですむように心掛けると、
2297                        多くの人が利用しやすいものができ、多くの場合に%fileの記述もすっきりする。
2298                </para>
2299        </sect1>
2300        <sect1 id="minimum-patch">
2301                <title>patchを使いすぎない</title>
2302                <para>
2303                        configファイルの設定やMakefileなどを変えたりするために頑張ってpatchをいろいろつくるよりも、
2304                        別にファイルを用意してSourceに加えておき、%installあたりで
2305                        <screen>%{__cp} ${RPM_SOURCE_DIR}/hoge.conf .</screen>
2306                        とかしてしまったほうが、すっきりすることが多い。srpmをばらしても、
2307                        そのファイルがすぐ出てきてわかりやすく、
2308                        アップデートのためにSPEC修正するときも楽だったりする。
2309                </para>
2310        </sect1>
2311        <sect1 id="mr-usecomment">
2312                <title>SPECファイルは第三者にもわかりやすくする</title>
2313                <para>
2314                        SPECファイルはソースのアップデートに対応して修正をしたり、
2315                        第三者が見て必要に応じて書き直したりすることがある。
2316                        凝っていろいろな設定をしたりする複雑なものを書くより、
2317                        ポータビリティを重視して簡潔に書いた方が後のメンテのためには吉。また、
2318                        違った環境でbuildができなくなるようなことが無いよう、
2319                        SPECファイル中のスクリプトで、特殊なコマンドを呼ぶようなことは避け、
2320                        一般的なコマンド使用にとどめるべき。
2321                </para>
2322        </sect1>
2323</appendix>
2324
2325
2326<appendix id="group-list">
2327        <title>Vine Linux で使用できるGroup一覧</title>
2328        <table>
2329                <title>Vine Linux で使用できるGroup一覧</title>
2330                <tgroup cols="3">
2331                        <thead><row><entry>Group</entry><entry>説明</entry><entry></entry></row></thead>
2332                        <tbody>
2333                                <row>
2334                                        <entry>Applications/Accessories</entry>
2335                                        <entry>ちょっとした小物や単機能のシンプルなアプリケーション</entry>
2336                                        <entry>電卓、辞書</entry>
2337                                </row>
2338                                <row>
2339                                        <entry>Applications/Administration</entry>
2340                                        <entry>システムやデスクトップの設定、管理の為のアプリケーション(動作に root 権限が必要)</entry>
2341                                        <entry>synaptic、gnome-system-tools</entry>
2342                                </row>
2343                                <row>
2344                                        <entry>Applications/Archiving</entry>
2345                                        <entry>ファイルの圧縮や解凍、書庫(アーカイブ)の作成に使用するアプリケーション</entry>
2346                                        <entry>bzip2, cpio, file-roller</entry>
2347                                </row>
2348                                <row>
2349                                        <entry>Applications/Development</entry>
2350                                        <entry>アプリケーションの開発に使用するアプリケーション</entry>
2351                                        <entry>xxgdb、IDE</entry>
2352                                </row>
2353                                <row>
2354                                        <entry>Applications/Documentation</entry>
2355                                        <entry>ドキュメントのみのパッケージ</entry>
2356                                        <entry>Vine-manual、JF</entry>
2357                                </row>
2358                                <row>
2359                                        <entry>Applications/Editors</entry>
2360                                        <entry>テキストエディタ</entry>
2361                                        <entry>GEdit、Emacs、Vi</entry>
2362                                </row>
2363                                <row>
2364                                        <entry>Applications/Editors/Emacs</entry>
2365                                        <entry>Emacs 及び Emacs 用のアプリケーション</entry>
2366                                        <entry></entry>
2367                                </row>
2368                                <row>
2369                                        <entry>Applications/Edutainment</entry>
2370                                        <entry>教育あるいは科学に関連したアプリケーション</entry>
2371                                        <entry>gnuplot、dia</entry>
2372                                </row>
2373                                <row>
2374                                        <entry>Applications/Games</entry>
2375                                        <entry>ゲーム</entry>
2376                                        <entry></entry>
2377                                </row>
2378                                <row>
2379                                        <entry>Applications/Graphics</entry>
2380                                        <entry>画像を扱うアプリケーション</entry>
2381                                        <entry>GIMP、Inkscape</entry>
2382                                </row>
2383                                <row>
2384                                        <entry>Applications/Internet</entry>
2385                                        <entry>インターネットを利用するアプリケーション</entry>
2386                                        <entry>firefox、Sylpheed、gFTP</entry>
2387                                </row>
2388                                <row>
2389                                        <entry>Applications/Multimedia</entry>
2390                                        <entry>動画や音楽を扱うアプリケーション</entry>
2391                                        <entry>Totem、BMP 、XMMS</entry>
2392                                </row>
2393                                <row>
2394                                        <entry>Applications/Other</entry>
2395                                        <entry>Applications の他のどの Group にも割り当てられないもの</entry>
2396                                        <entry></entry>
2397                                </row>
2398                                <row>
2399                                        <entry>Applications/Productivity</entry>
2400                                        <entry>ワープロや表計算、PIM等のアプリケーション</entry>
2401                                        <entry>abiword、Gnumeric</entry>
2402                                </row>
2403                                <row>
2404                                        <entry>Applications/Publishing</entry>
2405                                        <entry>印刷やフォントに関連したアプリケーション</entry>
2406                                        <entry>ghostscript, tetex</entry>
2407                                </row>
2408                                <row>
2409                                        <entry>Applications/Services</entry>
2410                                        <entry>ウェブサーバーやメールサーバー及び各種デーモン(Daemon)</entry>
2411                                        <entry>Apache、Postfix</entry>
2412                                </row>
2413                                <row>
2414                                        <entry>Applications/System</entry>
2415                                        <entry>システムを設定したり監視したりするアプリケーション(ユーザー権限で動作可能)</entry>
2416                                        <entry>gnome-system-monitor、mtools</entry>
2417                                </row>
2418                                <row>
2419                                        <entry>Applications/Text</entry>
2420                                        <entry>テキストの処理に使用するアプリケーション</entry>
2421                                        <entry>less, nkf, namazu</entry>
2422                                </row>
2423                                <row>
2424                                        <entry>Development/Libraries</entry>
2425                                        <entry>開発に必要なヘッダファイル等を含むパッケージ</entry>
2426                                        <entry>*-devel</entry>
2427                                </row>
2428                                <row>
2429                                        <entry>Development/Languages</entry>
2430                                        <entry>開発に使用する各種言語用のパッケージ</entry>
2431                                        <entry>perl、php、ruby</entry>
2432                                </row>
2433                                <row>
2434                                        <entry>Development/Tools</entry>
2435                                        <entry>開発に必要な各種 Tool を含むパッケージ</entry>
2436                                        <entry>automake、gettext</entry>
2437                                </row>
2438                                <row>
2439                                        <entry>System Environment/Base</entry>
2440                                        <entry>システムの動作に必要な最小構成のパッケージ(インストーラでいうところの最小構成に該当)</entry>
2441                                        <entry></entry>
2442                                </row>
2443                                <row>
2444                                        <entry>System Environment/Daemons</entry>
2445                                        <entry>システムの動作で必要なサービス及びデーモン</entry>
2446                                        <entry>dbus、hal</entry>
2447                                </row>
2448                                <row>
2449                                        <entry>System Enviroment/Kernel</entry>
2450                                        <entry>カーネル</entry>
2451                                        <entry></entry>
2452                                </row>
2453                                <row>
2454                                        <entry>System Environment/Libraries</entry>
2455                                        <entry>システムの動作に必要な各種ライブラリ</entry>
2456                                        <entry>gtk2、libpng</entry>
2457                                </row>
2458                                <row>
2459                                        <entry>System Environment/Shells</entry>
2460                                        <entry>各種シェル</entry>
2461                                        <entry></entry>
2462                                </row>
2463                                <row>
2464                                        <entry>User Interface/Desktops</entry>
2465                                        <entry>デスクトップ環境やウィンドウマネージャのアプリケーション</entry>
2466                                        <entry>KDE、Xfce 、Fluxbox</entry>
2467                                </row>
2468                                <row>
2469                                        <entry>User Interface/X</entry>
2470                                        <entry>XOrgと、それに付属するパッケージApplications/Accessories</entry>
2471                                        <entry></entry>
2472                                </row>
2473                        </tbody>
2474                </tgroup>
2475        </table>
2476        <note>
2477                <title>参考</title>
2478                <para>Vine Linux で使用できるGroup一覧は、<filename>/usr/share/doc/rpm-*/GROUPS_for_vine.txt</filename> に記述されています。</para>
2479                <para>それぞれの Group の簡単な説明は、<filename>/usr/share/doc/rpm-*/GROUPS-DESC_for_vine.txt</filename> に記述されています。</para>
2480        </note>
2481</appendix>
2482
2483<appendix id="custom-dir">
2484        <title>パッケージ作成に必要なディレクトリの変更方法</title>
2485        <para>パッケージ作成に必要なディレクトリを変更したいときには、<filename>~/.rpmmacros</filename>の設定を変更します。</para>
2486        <example>
2487                <title>トップディレクトリの変更例</title>
2488                <para>パッケージ作成に必要なディレクトリを全て/home/user/VinePlus以下に格納する場合は、以下のように変更します。</para>
2489                <screen>%_topdir   /home/user/VinePlus</screen>
2490        </example>
2491        <para>また、以下のマクロを設定することで個別に設定することもできます。</para>
2492        <table>
2493                <title>ディレクトリ制御用マクロ</title>
2494                <tgroup cols="3">
2495                        <thead>
2496                                <row>
2497                                        <entry>マクロ名</entry>
2498                                        <entry>使用目的</entry>
2499                                        <entry>既定値</entry>
2500                                </row>
2501                        </thead>
2502                        <tbody>
2503                                <row>
2504                                        <entry>%_builddir</entry>
2505                                        <entry>ソースの展開・ビルド用</entry>
2506                                        <entry>%_topdir/BUILD</entry>
2507                                </row>
2508                                <row>
2509                                        <entry>%_rpmdir</entry>
2510                                        <entry>バイナリパッケージ格納用</entry>
2511                                        <entry>%_topdir/RPMS</entry>
2512                                </row>
2513                                <row>
2514                                        <entry>%_srcrpmdir</entry>
2515                                        <entry>ソースパッケージ格納用</entry>
2516                                        <entry>%_topdir/SRPMS</entry>
2517                                </row>
2518                                <row>
2519                                        <entry>%_specdir</entry>
2520                                        <entry>SPECファイル格納用</entry>
2521                                        <entry>%_topdir/SPECS</entry>
2522                                </row>
2523                                <row>
2524                                        <entry>%_sourcedir</entry>
2525                                        <entry>アプリケーションのソース・パッチ格納用</entry>
2526                                        <entry>%_topdir/SOURCES</entry>
2527                                </row>
2528                        </tbody>
2529                </tgroup>
2530        </table>
2531        <warning>
2532                <title>ディレクトリの作成を忘れないように</title>
2533                <para>ここで説明したマクロを設定した場合は、設定に合わせて書き込み可能なディレクトリを作成する必要があります。</para>
2534                <para>特に%_rpmdirを設定したとき(%_topdirの変更による位置の変化も含む)には、設定したディレクトリの中に i386・noarch などのarchitecture 毎のディクレトリも忘れずに作成してください。</para>
2535        </warning>
2536</appendix>
2537
2538<appendix id="mr-othertag">
2539        <title>SPECファイルで使用できる便利なタグ</title>
2540        <variablelist>
2541                <varlistentry>
2542                        <term>Prefix</term>
2543                        <listitem><para>
2544                                        このタグを使うと、
2545                                        rpmパッケージをインストールする時にインストールディレクトリをコントロールできます。
2546                                        例えば、
2547                                        <screen>Prefix: /usr</screen>
2548                                        としていて、ファイル定義部で
2549<screen>
2550%files
2551/usr/bin/fuga</screen>
2552                                        と定義してたとしましょう。このパッケージをインストールする時に、
2553                                        --prefix /usr/local とオプション指定すると、
2554                                        fugaは/usr/local/bin/fuga.binにインストールされます。
2555                        </para></listitem>
2556                </varlistentry>
2557                <varlistentry>
2558                        <term>BuildArch</term>
2559                        <listitem><para>
2560                                        書いたSPECファイルを使って生成されるrpmパッケージのアーキテクチャを指定できます。
2561                                        例えば、elファイルとかシェルスクリプトとかばかりを含むrpmパッケージを作るときには、
2562                                        i386やalphaなどのアーキテクチャに依存しないnoarchであることを、
2563                                        <screen>BuildArch: noarch</screen>
2564                                        というふうに明示します。
2565                                        このような指定をしておくとnoarch.rpmという拡張子のつくrpmパッケージが作成できて、
2566                                        いろいろなアーキテクチャ上で共用できます。
2567                        </para></listitem>
2568                </varlistentry>
2569                <varlistentry>
2570                        <term>ExclusiveArch</term>
2571                        <listitem><para>
2572                                        SPECファイルや src.rpmパッケージから、パッケージを生成 できる アーキテクチャーを指定します。
2573                                        たとえば、ExclusiveArch: i386 とすると、i386 以外の ppc,i486,i586,i686,x86_64 といったアーキテクチャーではバイナリパッケージを生成できなくなります。
2574                        </para></listitem>
2575                </varlistentry>
2576                <varlistentry>
2577                        <term>ExcludeArch</term>
2578                        <listitem><para>
2579                                        SPECファイルや src.rpmパッケージから、パッケージを生成 できない アーキテクチャーを指定します。
2580                                        たとえば、ExcludeArch: ppc とすると、ppc ではバイナリパッケージを生成できなくなります。ppc 以外の i386,i486,i586,i686,x86_64 といったアーキテクチャーではバイナリパッケージを生成できます。
2581                        </para></listitem>
2582                </varlistentry>
2583        </variablelist>
2584</appendix>
2585
2586<appendix id="mr-changelog">
2587        <title>更新記録(1999/2/16以降)</title>
2588        <itemizedlist>
2589                <listitem>
2590                        <para>2009/7/4</para>
2591                        <itemizedlist>
2592                                <listitem><para>「環境設定」、「基本的な流れ」、「より高度なパッケージ作成のための情報」の3部構成に変更</para></listitem>
2593                                <listitem><para>「ライブラリのパッケージングポリシー」を追加</para></listitem>
2594                        </itemizedlist>
2595                </listitem>
2596                <listitem>
2597                        <para>2009/6/26</para>
2598                        <itemizedlist>
2599                                <listitem><para>「rpm関連ファイルの説明」を「用語の解説」に修正</para></listitem>
2600                                <listitem><para>「rpmパッケージをつくるための準備」を「パッケージ作成毎の準備」に変更</para></listitem>
2601                        </itemizedlist>
2602                </listitem>
2603                <listitem>
2604                        <para>2009/6/25</para>
2605                        <itemizedlist>
2606                                <listitem><para>「はじめに」を「文書の概要」と「さらに深く知りたい方へ」に分割</para></listitem>
2607                                <listitem><para>「環境設定」を「rpmパッケージをつくるための準備」から分割</para></listitem>
2608                                <listitem><para>「更新記録」を付録に変更</para></listitem>
2609                        </itemizedlist>
2610                </listitem>
2611                <listitem>
2612                        <para>2007/10/3</para>
2613                        <itemizedlist>
2614                                <listitem><para>Appendix B で desktop file に関して修正</para></listitem>
2615                        </itemizedlist>
2616                </listitem>
2617                <listitem>
2618                        <para>2007/9/10</para>
2619                        <itemizedlist>
2620                                <listitem><para>Appendix B で desktop-file-install を使うよう修正</para></listitem>
2621                        </itemizedlist>
2622                </listitem>
2623                <listitem>
2624                        <para>2007/7/21</para>
2625                        <itemizedlist>
2626                                <listitem><para>Appendix B に desktop-file-validate について追記</para></listitem>
2627                        </itemizedlist>
2628                </listitem>
2629                <listitem>
2630                        <para>2007/6/26</para>
2631                        <itemizedlist>
2632                                <listitem><para>Copyright と Serial について追記</para></listitem>
2633                        </itemizedlist>
2634                </listitem>
2635                <listitem>
2636                        <para>2007/6/25</para>
2637                        <itemizedlist>
2638                                <listitem><para>%prep での %{SOURCE数字} の利用例を記載</para></listitem>
2639                                <listitem><para>%post での install-info の例で、install時にのみ処理を行うように if文 を追加</para></listitem>
2640                                <listitem><para>%files と Requires の探し方のヒントを記載</para></listitem>
2641                                <listitem><para>ExclusiveArch と ExcludeArch の説明を記載</para></listitem>
2642                                <listitem><para>Appendix B にalternatives を利用するパッケージについて追加</para></listitem>
2643                        </itemizedlist>
2644                </listitem>
2645                <listitem>
2646                        <para>2007/5/23</para>
2647                        <itemizedlist>
2648                                <listitem><para>Requires( ),BuildRequires( ) の説明を追加</para></listitem>
2649                                <listitem><para>Prereq の代わりに Requires(pre,post) 等の使用を推奨</para></listitem>
2650                                <listitem><para>%verifyscript について記載</para></listitem>
2651                                <listitem><para>%verify について記載</para></listitem>
2652                                <listitem><para>パッケージ作成後に確認することを記載</para></listitem>
2653                                <listitem><para>リンクの修正</para></listitem>
2654                        </itemizedlist>
2655                </listitem>
2656                <listitem>
2657                        <para>2006/12/8</para>
2658                        <itemizedlist>
2659                                <listitem><para>Epoch の使用について記載</para></listitem>
2660                                <listitem><para>install-info --delete の記述を修正</para></listitem>
2661                                <listitem><para>Group 一覧、説明 の typo を修正</para></listitem>
2662                        </itemizedlist>
2663                </listitem>
2664                <listitem>
2665                        <para>2006/11/17</para>
2666                        <itemizedlist>
2667                                <listitem><para>Group 一覧、説明を rpm-4.4.2-0vl16 にあわせて修正</para></listitem>
2668                        </itemizedlist>
2669                </listitem>
2670                <listitem>
2671                        <para>2006/11/8</para>
2672                        <itemizedlist>
2673                                <listitem><para>License の説明を修正</para></listitem>
2674                                <listitem><para>%check の説明を追記</para></listitem>
2675                                <listitem><para>rpmbuild -bi で %check も実行されることを記述</para></listitem>
2676                                <listitem><para>Vine Linux 4.x での Group 一覧、説明を修正</para></listitem>
2677                                <listitem><para>Appendix B にGNOMEのメニューについて追加</para></listitem>
2678                        </itemizedlist>
2679                </listitem>
2680                <listitem>
2681                        <para>2006/11/3</para>
2682                        <itemizedlist>
2683                                <listitem><para>Vine Linux 4.x での Group 一覧、説明を追加</para></listitem>
2684                                <listitem><para>BuildRequires と BuildConflictsの説明を追加</para></listitem>
2685                                <listitem><para>Requires と Prereq、BuildRequires と BuildPrereq の説明を修正、それぞれの違いを追記</para></listitem>
2686                                <listitem><para>%config に noreplace,missingok の説明を追加</para></listitem>
2687                                <listitem><para>マクロの説明を追加</para></listitem>
2688                                <listitem><para>spec の例を修正、マクロを使用した spec の例を追加</para></listitem>
2689                                <listitem><para>%check の説明を追加</para></listitem>
2690                                <listitem><para>%post,%postun に info ファイルの例を追加</para></listitem>
2691                                <listitem><para>タグの -p の説明を追加</para></listitem>
2692                                <listitem><para>Appendix B パッケージ固有の作法等についてを作成</para></listitem>
2693                        </itemizedlist>
2694                </listitem>
2695                <listitem>
2696                        <para>2006/10/26</para>
2697                        <itemizedlist>
2698                                <listitem><para>全体を見直し</para></listitem>
2699                        </itemizedlist>
2700                </listitem>
2701                <listitem>
2702                        <para>2004/9/19</para>
2703                        <itemizedlist>
2704                                <listitem><para>rpmbuildを推奨する様、追加。</para></listitem>
2705                        </itemizedlist>
2706                </listitem>
2707                <listitem>
2708                        <para>2004/6/30</para>
2709                        <itemizedlist>
2710                                <listitem><para>tex形式から、DocBook SGML形式に変更。</para></listitem>
2711                        </itemizedlist>
2712                </listitem>
2713                <listitem>
2714                        <para>2000/10/30</para>
2715                        <itemizedlist>
2716                                <listitem><para>細かい修正をすこし</para></listitem>
2717                                <listitem><para>rpm-3.0.5 以降で binary が strip されることと、man/info がgzされることを記述</para></listitem>
2718                                <listitem><para>Prereq の説明追加</para></listitem>
2719                                <listitem><para>rpm -bp の説明追加</para></listitem>
2720                        </itemizedlist>
2721                </listitem>
2722                <listitem>
2723                        <para>2000/3/7</para>
2724                        <itemizedlist>
2725                                <listitem><para>minor なタイポや記述の修正</para></listitem>
2726                                <listitem><para>%setup の記述修正(-a,-b)および追加(-q)</para></listitem>
2727                                <listitem><para>.rpmmacros の説明に .rpmrc の場合も併記</para></listitem>
2728                        </itemizedlist>
2729                </listitem>
2730                <listitem>
2731                        <para>1999/9/3</para>
2732                        <itemizedlist>
2733                                <listitem><para>.rpmmacros の記述追加(rpm-3.0.x 対応)</para></listitem>
2734                                <listitem><para>BuildPrereq に関する記述を追加</para></listitem>
2735                        </itemizedlist>
2736                </listitem>
2737                <listitem>
2738                        <para>1999/2/16</para>
2739                        <itemizedlist>
2740                                <listitem><para>Summary(ja), %description -l ja, %changelog に関する記述を追加</para></listitem>
2741                                <listitem><para>その他細かい修正</para></listitem>
2742                        </itemizedlist>
2743                </listitem>
2744        </itemizedlist>
2745</appendix>
2746
2747<appendix id="mr-more">
2748        <title>さらに深く知りたい方へ</title>
2749        <para>rpmパッケージの作り方についてさらに知りたい人は、
2750                <ulink url="http://www.linux.or.jp/JF/JFdocs/archive/RPM-BUILD-HOWTO.html">RPM-BUILD-HOWTO</ulink>
2751                (古高さん、石岡さん著、JFにあります)や
2752                <ulink url="http://www.rpm.org/max-rpm/index.html">Maximum-RPM</ulink>(英語です。)を読みましょう。
2753                どちらも、書かれてからだいぶ時間が経っていますが、参考になると思います。</para>
2754
2755        <note>
2756                <para>RPM-BUILD-HOWTO は JF というパッケージがインストールされていれば、
2757                        <ulink url="file:///usr/share/doc/JF/archive/RPM-BUILD-HOWTO.txt.gz">/usr/share/doc/JF/archive/RPM-BUILD-HOWTO.txt.gz</ulink> にあります。</para>
2758        </note>
2759
2760        <para>また、rpm付属のドキュメントが /usr/share/doc/rpm-version/ 以下にあります。(英語です。)</para>
2761        <para>細かなことについて知りたい場合は、apt-get source rpm , rpm -bp rpm.spec などとして、rpm 自体のソースを読むのもよいでしょう。</para>
2762
2763        <para>Vine Linux では <ulink url="http://vinelinux.org/packaging.html">パッケージングに関する指針</ulink> というドキュメントもあります。Vine Seed や Vine Plus のパッケージを作成する場合にはこの指針に従ってください。</para>
2764</appendix>
2765
2766</book>
2767
2768<!--
2769                Local Variables:
2770                encode: utf-8-unix
2771                mode: nxml
2772                End:
2773-->
Note: See TracBrowser for help on using the repository browser.