dpatch - クラウドでオンライン

プログラム：

NAME

dpatch - Debian 用のパッチ保守システム

SYNOPSIS

パッチ [オプション] command [コマンド引数]

DESCRIPTION

パッチ Debian パッケージ用の使いやすいパッチ システムで、dbs に似ています。
パッケージですが、使い方ははるかに簡単です。

パッチやその他の単純なカスタマイズ テンプレートを保存できます。 debian /パッチ &
それ以外の場合は、ソース ツリーを大幅に再編成する必要はありません。 パッチを入手するには
ビルド時に適用される場合は、makefile スニペットをインクルードし、依存するだけで済みます。
パッチ/アンパッチ のターゲット ビルド or の段階 debian / rules。 柔軟性をさらに高めるために、
あなたは呼び出すことができます /usr/bin/dpatch 直接も。

警告

パッチ は非推奨です。「3.0 (quilt)」Debian ソース パッケージ形式に切り替えてください。
代わりは。 見る http://wiki.debian.org/Projects/DebSrc3.0＃よくある質問 その方法についての短いガイドについては、
ボーマンは

GLOBAL OPTIONS

dpatch の全体的な動作を変更し、影響を与えるオプションがいくつかあります。
XNUMX つだけではなく、使用可能なほとんどのコマンドが対象になります。

これらのグローバル オプションは次のとおりです。

--workdir (-d) DIRECTORY
デフォルトでは、dpatch は実行元のソース ツリーにパッチを適用します。 これとともに
オプションを使用すると、これを変更して、dpatch が別のツリーで動作するように指示できますが、
現在の dpatch から dpatch を取得します。

これは dpatch スクリプトレットに XNUMX 番目の引数を渡すだけであり、
指定したディレクトリに移動します。 これを行うには、 --chdir オプションの説明
を参照してください。

--chdir (-c)
現在の作業ディレクトリとは異なる作業ディレクトリを使用する場合は、その前に作業ディレクトリを変更してください。
パッチを適用しようとしています。

これは、 --workdir オプションを選択します。

- 厳しい (-S)
厳密モードを有効にします。これは、警告が発生しても dpatch が早期に救済されることを意味します。
(すでに適用されているパッチを適用しようとするときなど、通常は適用されます。
単にスキップしてください）。

- 力 (-F)
dpatch が通常であればパッチの適用または非適用を強制する
操作はすでに以前に実行されているため、これらの操作はスキップしてください。

--with-cpp
cpp の使用を強制します。 の使用をオーバーライドします DPATCH_OPTION_CPP=1 内のオプション
debian/パッチ/00オプション ファイルにソフトウェアを指定する必要があります。

コマンド

パッチ 取り扱い コマンド
すべてのパッチ処理コマンドには一般的な構文があります。つまり、
それ自体は、処理する dpatch 名のリストを取得し、すべての dpatch に対して意図された処理を実行します。
それらのうち、コマンドラインで指定されたのとまったく同じ順序で。

次に、各パッチ処理コマンドのバージョンがあり、 -すべて サフィックス、これは
引数を取らず、利用可能なすべてのアクションに対して必要なアクションを実行します。
dパッチ。

最後のバリエーションは、 -それまで or -まで 接尾辞は XNUMX つだけ必要です
引数: dpatch の名前。 すべての dpatch に対して適切なアクションが実行されます。
この指定されたものまで。

適用する [オプション]
patch [オプション]
XNUMX つ以上の dpatch を作業ツリー (そうでない場合は現在のディレクトリ) に適用します。
そうでないと言われました）。 デフォルトでは、指定されたパッチはまったく同じように適用されます。
指定された順序で。

オプション
--stampdir=ディレクトリにジョブを開始します。, -s=ディレクトリにジョブを開始します。
スタンプファイルを入れる ディレクトリにジョブを開始します。 デフォルトの代わりに debian/パッチ適用済み.
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドが何も出力しないように強制します。
-詳細 (-v)
スクリプトレット出力の非表示を無効にします。

適用する [オプション]
パッチを解除する [オプション]
XNUMX つ以上の dpatch を作業ツリー (そうでない場合は現在のディレクトリ) に適用します。
そうでないと言われました）。 デフォルトでは、指定されたパッチは逆に適用されます。
通常は逆の順序で適用解除する必要があるため、指定された順序で
(つまり、適用順序と比較して)。

オプション
--stampdir=ディレクトリにジョブを開始します。, -s=ディレクトリにジョブを開始します。
スタンプ ファイルを使用する ディレクトリにジョブを開始します。 デフォルトの代わりに debian/パッチ適用済み.
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドが何も出力しないように強制します。
-詳細 (-v)
スクリプトレット出力の非表示を無効にします。

cat [オプション]
dpatch の名前、作成者、説明などのメタ情報を出力します。
(適切なオプションを使用していずれも無効にできます)。

オプション
--メタなし、 --desc-only (-nm、 -NS）
パッチの説明のみを出力します。
--著者のみ （-に）
パッチの作成者のみを出力します。
-- 説明なし、 (-nd)
パッチの説明を印刷しないでください。
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドが何も出力しないように強制します。

リスト [オプション]
指定されたパッチの名前をリストします。 このコマンドは、次の点を除いてあまり役に立ちません。
リスト-すべて バリアント。利用可能なパッチをすべてリストします。

オプション
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。

status [オプション]
指定されたパッチのステータス (作業中のパッチに適用されているかどうか) を出力します。
木かどうか。

オプション
--stampdir=ディレクトリにジョブを開始します。, -s=ディレクトリにジョブを開始します。
スタンプ ファイルを使用する ディレクトリにジョブを開始します。 デフォルトの代わりに debian/パッチ適用済み.
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドが何も出力しないように強制します。

ログ [オプション]
指定されたパッチ適用試行のログを表示します。

オプション
--stampdir=ディレクトリにジョブを開始します。, -s=ディレクトリにジョブを開始します。
スタンプ ファイルを使用する ディレクトリにジョブを開始します。 デフォルトの代わりに debian/パッチ適用済み.
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドに何も出力させず、余分なものを含まないログを出力します。
上には砂糖。

コール [オプション]
ユーザー指定の引数を使用して dpatch を呼び出します。 すべての引数に パッケージ- プレフィックスは
dpatch 自体では使用されないことが保証されており、このパッチで使用するために予約されています。


このコマンドは、dpatch からカスタム メタ情報を抽出する場合に最も役立ちます。
スクリプトレット。

オプション
--引数=argは (-a=引数)
パッチを呼び出す argは 引数として。
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。
- 静かな (-q)
コマンドが何も出力しないように強制します。

その他 コマンド
パッチテンプレート [オプション] [パッチ名] [説明]
に与えられた情報に基づいて、準標準の dpatch スクリプト テンプレートを印刷します。
コマンドライン。 もし 説明 とすると、約 72 文字で折りたたまれます。
複数行を適切に記述します。

テンプレートを STDIN の前に追加すると、標準入力の内容は次のようになります。
テンプレートの直後に印刷されます。

オプション
-追加 (-p)
テンプレートを STDIN の先頭に追加します。
- 助けて （-NS）
コマンドに関する短いヘルプ メッセージを出力します。

助けます （ - ヘルプ、 -h) [ command]
dpatch 自体、または特定のパッチについて、もう少し詳細なヘルプを提供しようとします。
dpatchコマンド。

バージョン
dpatch のバージョン番号を出力して終了します。

パッチ IN デビアン PACKAGES

dpatch を使用するには XNUMX つの異なる方法があります。 debian / rules: 直接呼び出すか、
配合工業用化学製品の dpatch.make（7）。 ここでは前者の方法のみを説明します。後者には、
独自のマニュアルページ。

注意: 次の例では、 .NOTPARALLEL ～の頭に旗を立てる
debian / rules 依存関係リストは実行順序に依存するためです。 それなし
.NOTPARALLEL、複数の make スレッド ( -j
オプション）。

ほとんどの状況では、ビルド プロセス中すぐに dpatch を実行する必要があります。
可能。 それをどのように達成できるかは、既存のシステムに大きく依存します。 debian / rules.
ただし、一般的に、ほとんどのパッケージには ビルド （または ビルドスタンプ), 設定ステータスまたは
configure （または 設定スタンプ） 目標。 最初に dpatching を行う最も簡単な方法
つまり、dpatch を呼び出すルールを作成し、それをリストに追加するだけで済みます。
適切なターゲットの前提条件 (上記を参照)。

dpatch の適用解除は簡単な場合もあれば、少し難しい場合もあります。 何も入っていない場合は、 ルールタッチ
dpatch によって変更されたファイル (互換性のない変更が作成される) を安全に追加できます パッチを解除する 〜へ
のリスト ルールの依存関係。

パッチがビルド システムに影響を与える可能性がある場合は、ソースを適用した後でパッチを適用解除する必要があります。
木が掃除されました。 これを行うには、 たとえば、 きれいにパッチされた、を書きます
dpatch を呼び出して dpatch を適用解除し、新しいパッチを作成するルール あるルール
きれいにパッチされた & パッチを解除する その前提条件として。

例を見てみましょう! まずは原文の該当部分を見てみましょう
debian / rules 私たちの想像上のパッケージ:

config.status: 設定する
./configure --prefix=/ usr --マンディル=は、/ usr / share
ビルド: config.status
${メイク}
クリーン：
$(テストディレクトリ)
$(テストルート)
${MAKE} ディクリーン
rm -rf debian/imaginary-package debian/files debian/substvars

dpatchify 後は次のようになります。

config.status: パッチ構成
./configure --prefix=/ usr --マンディル=は、/ usr / share
ビルド: config.status
${メイク}
クリーン: クリーンパッチ、パッチ解除
クリーンパッチ済み:
$(テストディレクトリ)
$(テストルート)
${MAKE} ディクリーン
rm -rf debian/imaginary-package debian/files debian/substvars

パッチ: パッチスタンプ
パッチスタンプ:
dpatch 適用-すべて
dpatch cat-all >パッチスタンプ

パッチを解除:
dpatch deapply-all
rm -rf パッチスタンプ debian/パッチ適用済み

追加 パッチ スクリプトレット 〜へ a パッケージ
dpatch を使用するときは、どの dpatch を適用するか、どの dpatch を適用するかをシステムに伝えたいと思うはずです。
捨てるもの。 最も一般的な状況では、名前を列挙するだけで十分です。
dpatches (からの相対ファイル名) debian /パッチ）in debian/パッチ/00リスト。 彼ら
通常は拡張子が付いています .dpatch 拡張子は省略できるため、ファイル
debian/パッチ/01_one_patch.dpatch として書かれています 01_ワンパッチ 内部 debian/パッチ/00リスト

ただし、申請など、より柔軟な対応が必要な状況もあるかもしれません。
たとえば、XNUMX つのアーキテクチャのみに同じパッチを適用する場合、 m68k & powerpc。 これを次のように解決します
少なくとも XNUMX つのまったく異なる方法: XNUMX つは、両方のパッチに同じパッチをリストすることです。
debian/パッチ/00list.m68k & debian/パッチ/00list.powerpc、もうXNUMXつは使用することです
DPATCH_OPTION_CPP=1 in debian/パッチ/00オプション。 00list ファイルが渡されます cpp
コマンドで DEB_BUILD_ARCH アーキテクチャに設定された変数、および
DEB_BUILD_ARCH_建築 1 に設定されています。cpp を使用したサンプル debian/パッチ/00リスト
このように見えるかもしれません：

01_manpage_typo
#定義されている場合(DEB_BUILD_ARCH_m68k) || 定義済み(DEB_BUILD_ARCH_powerpc)
/* このパッチは、Macintosh ボックスでのランダムなビルド時の破損を修正します。 */
02_macintosh_foo
#endif

作成 パッチ スクリプトレット
dpatch スクリプトレットを作成するにはさまざまな方法があります。 これらは単純な実行可能ファイルです。
標準化された呼び出し規約に従います (次の文書に記載されています)。 パッチ（7））。

$EDITOR を起動するか、次のコマンドを使用します。 dpatch-編集パッチ, これで準備は完了です。

ほとんどの場合、dpatch ファイルは単純なパッチを適用するだけなので、偶数のパッチがあります。
より簡単な方法:

dpatch patch-template -p "01_some_patch" "ランダムなパッチ" \
debian/パッチ/01_some_patch.dpatch

onworks.net サービスを使用してオンラインで dpatch を使用する