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