パッケージにパッチを適用

関連記事

• ABS
• SVN から PKGBUILD を取得

このドキュメントでは ABS を使ってパッケージにパッチを作成したり適用する手順を説明します。

パッチの作成

別の場所から入手したパッチを使う場合 (例: Linux カーネルのパッチをダウンロードした場合)、下のセクションに飛んでください。ただしソースコードや Makefile、設定ファイルなどを編集する必要がある場合、パッチを作成できるようにならなければなりません。

ノート: ファイル内の一行か二行程度しか変える必要がないときは (例: Makefile)、sed を利用するほうが簡単だと思われます。

パッケージのパッチを作成するときは、パッケージのコピーを2つ作成して、新しいコピーを編集し、2つのファイルの差分を作成します。Arch Linux パッケージを作成する場合、以下の手順に従うことでパッチが作成できます:

1. ファイルのダウンロード先を PKGBUILD の source 配列に追加してください。もちろん、既存の PKGBUILD を編集する場合、必要ありません。
2. ダミーの (空の、あるいは echo コマンドだけしか存在しない) build() 関数を作成してください。既存の PKGBUILD を修正する場合、build 関数の大部分をコメントアウトしてください。makepkg を複数回実行することになるため、壊れたパッケージをビルドするのに時間を費やすのは無駄です。
3. makepkg -o を実行してください。編集する必要があるソースファイルが src ディレクトリにダウンロードされます。
4. src ディレクトリに移動してください。通常の場合、ダウンロードした圧縮ファイルから解凍されたファイルが含まれたディレクトリが存在します (ファイルしかない場合もありますが、差分は複数のファイルを処理できます)。ディレクトリのコピーを2つ作成してください。片方のコピーには手を入れず makepkg で操作しません。もう片方のコピーからパッチを作成します。2つのコピーには package.pristine と package.new などと名前を付けます。
5. package.new ディレクトリに移動してください。編集する必要があるファイルを全て編集します。必要な変更はパッチで何をするかによります。Makefile のパスを修正する、あるいはソースのエラーを修正する (例えば、gcc 3.4 でコンパイルできるようにする) などです。無論、package.new ディレクトリのサブディレクトリにあるファイルを編集することもできます。package.new ディレクトリに大量のファイルを作成するコマンドを実行しないように気をつけてください。プログラムをコンパイルして変更が問題ないかを確認してはいけません。コンパイルを実行してしまうと、無用なファイルがパッチの中に入ってしまいます。代わりに、手動で patch コマンドを使用するか PKGBUILD (下を参照) でディレクトリの別のコピー (先に作成した pristine ディレクトリではありません) にパッチを適用して、そこから変更を適用してください。
6. src ディレクトリに戻ってください。
7. diff -aur package.pristine package.new を実行してください。unified 形式の diff フォーマットで全ての変更が出力されます。ファイルを開いてパッチが問題ないことを確認することができます。
8. diff -aur package.pristine package.new > package.patch を実行して全ての変更を package.patch という名前のファイルにまとめてください。これが patch で使用するファイルになります。元のディレクトリのコピーに変更を適用して、上手くパッチが機能することを確認できます。また、パッチに無駄な情報が含まれていないことも確認すると良いでしょう。例えば、ファイル内のタブがパッチによってスペースに変換されるのは望ましくありません (テキストエディタが行ったことが原因です)。パッチはテキストエディタを使って編集することができます。あるいは万全を期して (diff ファイルに誤りを入れないように)、元のファイルを編集してから再度パッチを作成してもかまいません。

パッチの適用

このセクションでは自分で作成した、あるいはインターネットからダウンロードしてきたパッチを PKGBUILD の prepare() 関数で適用する方法を説明します。以下の手順に従ってください:

1. PKGBUILD の source 配列にパッチファイルのエントリを追加してください。元のソース url とは空白で区切られます。ファイルがオンライン上に存在する場合、完全な URL を記入すれば src ディレクトリに自動的にダウンロード・配置されます。パッチを自分で作成した場合、あるいはインターネット上からパッチを取得できない場合、PKGBUILD ファイルと同じディレクトリにパッチファイルを置いて、source 配列にファイルの名前を追加してください。ファイルが src ディレクトリにコピーされるようになります。PKGBUILD を再配布する場合、PKGBUILD とパッチを一緒にする必要があります。
2. 次に updpkgsums を使用して md5sums 配列を更新してください。あるいは手動で md5sums 配列にエントリを追加してください。md5sum ツールを使うことでパッチのチェックサムを生成できます。
3. PKGBUILD の中に prepare() 関数を（存在しない場合）作成してください。
4. まずはパッチをあてる必要があるディレクトリに移動します (移動を行うのは prepare() 関数の中で、ターミナルではありません。パッチの適用を自動化します)。cd $srcdir/$pkgname-$pkgver などとすることでディレクトリを移動できます。$pkgname-$pkgver はダウンロードされたソースファイルが展開されたときによく作られるディレクトリの名前ですが、必ずしもこの名前になるとは限りません。
5. ディレクトリの中からパッチを適用してください。prepare() 関数に以下を追加するだけです (pkgname.patch は差分が含まれているファイルの名前に置き換えてください。パッチファイルは PKGBUILD の source 配列に追加したので自動的に src ディレクトリにコピーされています):

   patch -p1 <pkgname.patch

prepare 関数の例:

prepare() {
 cd $pkgname-$pkgver
 patch -Np1 <../eject.patch
}

(ターミナルから) makepkg を実行してください。全てが上手くいっていれば、パッチが自動的に適用されて、新しいパッケージにはパッチに含まれている変更が追加されているはずです。そうならない場合、patch の -p オプションを使って実験を行ってみてください。詳しくは man patch を読んでください。

基本的には次のようになっています。myversion/ のファイルにパッチを適用する diff ファイルが作成された場合、diff ファイルは myversion/file に適用されます。(PKGBUILD で cd した) yourversion/ ディレクトリの中から実行する場合、ファイルにパッチが適用されるときに、myversion/ の部分は省いて file ファイルに適用されるようにしなくてはなりません。-p1 でパスからディレクトリが一つ削除されます。しかしながら、開発者が myfiles/myversion にパッチを適用した場合、ディレクトリを二つ削除する必要があるので、-p2 を使います。

-p オプションを指定しなかった場合、全てのディレクトリ構造が取り除かれます。全てのファイルがベースディレクトリに存在する場合はそれで ok ですが、パッチを作成したのが myversion/ で編集したファイルが myversion/src/file の場合、yourversion の中から -p オプションを付けずにパッチを実行したときに、yourversion/file という名前のファイルにパッチが適用されてしまいます。

ほとんどの開発者はパッチを適用するディレクトリの親ディレクトリからパッチを作成するので、通常は -p1 が正しくなります。

参照

• http://www.kegel.com/academy/opensource.html — Useful information on patching files
• http://patch-tracker.debian.org/
• http://gentoo-portage.com/
• http://packages.gentoo.org/
• http://pkgs.fedoraproject.org/cgit/