dpkg-source - クラウドでオンライン

プログラム：

NAME

dpkg-source - Debian ソース パッケージ (.dsc) 操作ツール

SYNOPSIS

dpkg-ソース [オプション...] command

DESCRIPTION

dpkg-ソース Debian ソース アーカイブをパックおよび解凍します。

これらのコマンドでは、複数のオプションを 1 つに結合することはできません。
オプションの値を別の引数で指定できるようにします。

コマンド

-x, - エキス ファイル名.dsc [出力ディレクトリ]
ソースパッケージを抽出します(- エキス dpkg 1.17.14 以降)。 XNUMX つの非オプション引数
Debian ソース管理ファイルの名前 (.dsc）。オプションの
2 番目の非オプション引数は、ファイルを抽出するディレクトリを指定するために指定できます。
ソース パッケージへの移行、これは存在してはなりません。出力ディレクトリが指定されていない場合、
ソースパッケージは、という名前のディレクトリに抽出されます。 source-バージョン 現在の下で
作業ディレクトリ。

dpkg-ソース ソースパッケージを構成する他のファイルの名前を読み取ります
制御ファイルから。これらは、 .dsc.

抽出されたパッケージ内のファイルには、アクセス許可と所有権が設定されます。
ファイルとディレクトリが単に存在した場合に予期されるものに
作成されました - ディレクトリと実行可能ファイルは 0777 になり、プレーン ファイルは
0666 になります。どちらもエクストラクターの umask によって変更されます。親ディレクトリが setgid の場合
そうすれば、抽出されたディレクトリも同様になり、すべてのファイルとディレクトリも削除されます。
そのグループの所有権を継承します。

ソース パッケージが非標準形式を使用している場合 (現在、これはすべての形式を意味します)
「1.0」を除く）、その名前は次の場所に保存されます。 debian/ソース/フォーマット そのため
ソース パッケージの次のビルドでは、デフォルトで同じ形式が使用されます。

-b, - 建てる ディレクトリにジョブを開始します。 [フォーマット固有のパラメータ]
ソースパッケージをビルドします(- 建てる dpkg 1.17.14 以降)。最初の非オプション引数
は、debian 化されたソース ツリーを含むディレクトリの名前として解釈されます (つまり、
debian サブディレクトリがあり、元のファイルが変更される可能性があります)。に応じて
パッケージのビルドに使用されるソース パッケージ形式、追加パラメータは次のとおりです。
受け入れた。

dpkg-ソース このファイルで見つかった最初の形式でソース パッケージをビルドします。
順序付きリスト: で示される形式 - フォーマット コマンドラインオプション、
で示される形式 debian/ソース/フォーマット、「1.0」。 「1.0」へのフォールバックは次のとおりです。
非推奨であり、将来のある時点で削除される予定です。常に
必要なソース形式を文書化します debian/ソース/フォーマット。 セクションを参照 SOURCE
PACKAGE 書式 さまざまなソース パッケージ形式の詳細な説明を参照してください。

--印刷形式 ディレクトリにジョブを開始します。
次の場合、ソース パッケージのビルドに使用されるソース形式を出力します。
dpkg-ソース - 建てる ディレクトリにジョブを開始します。 （同じ条件で同じように呼び出されました）
パラメーター; dpkg 1.15.5 以降)。

--ビルド前 ディレクトリにジョブを開始します。
ソース パッケージ形式の対応するフックを実行します (dpkg 1.15.8 以降)。これ
フックはパッケージのビルド前に呼び出されます (dpkg-ビルドパッケージ それをとても呼びます
その前でも早い段階で debian / rules ）。このコマンドはべき等であり、呼び出すことができます。
複数回。すべてのソース形式がこのフックに何かを実装しているわけではありません。
通常は、たとえば次のことを保証することによって、ビルド用のソース ツリーを準備します。
Debian パッチが適用されます。

--ビルド後 ディレクトリにジョブを開始します。
ソース パッケージ形式の対応するフックを実行します (dpkg 1.15.8 以降)。これ
フックはパッケージのビルド後に呼び出されます (dpkg-ビルドパッケージ それを最後と呼びます)。
このコマンドはべき等であり、複数回呼び出すことができます。すべてのソース形式ではありません
このフックで何かを実装し、通常、それを使用して内容を元に戻します。
--ビルド前 完了しました。

- 専念 [ディレクトリにジョブを開始します。]..。
解凍されたソースツリーの変更を記録します。 ディレクトリにジョブを開始します。 (dpkg 1.16.1 以降)。 これ
コマンドは、ソース形式に応じて補足パラメータを取ることができます。それは
この操作が何の意味もない形式の場合はエラーが発生します。

-?, - 助けて
使用法メッセージを表示して終了します。

- バージョン
バージョンを表示して終了します。

OPTIONS

ジェネリック ビルド オプション
-c制御ファイル
情報を読み取るメインのソース管理ファイルを指定します。 デフォルトは
デビアン/コントロール。相対パス名で指定された場合、これは次から始まると解釈されます。
ソースツリーの最上位ディレクトリ。

-l変更ログファイル
情報を読み取る変更ログ ファイルを指定します。 デフォルトは
debian / changelog。相対パス名で指定された場合、これは次から始まると解釈されます。
ソースツリーの最上位ディレクトリ。

-F変更ログ形式
変更ログの形式を指定します。 見る dpkg-parsechangelog(1) 情報として
代替フォーマットについて。

--format =値
ソース パッケージをビルドするには、指定された形式を使用します (dpkg 1.14.17 以降)。します
で指定された形式をオーバーライドします debian/ソース/フォーマット.

-V名=値
出力置換変数を設定します。 見る deb-substvars（5）の議論のため
出力の置換。

-Tsubstvars ファイル
置換変数を読み取る substvars ファイル;デフォルトでは、ファイルは読み取られません。
このオプションを複数回使用して、複数の変数から置換変数を読み取ることができます。
ファイル (dpkg 1.15.6 以降)。

-Dフィールド=値
出力制御ファイルフィールドをオーバーライドまたは追加します。

-Uフィールド
出力制御ファイルのフィールドを削除します。

-Z , - 圧縮=
作成された tarball および diff ファイルに使用する圧縮を指定します (- 圧縮
dpkg 1.15.5 以降)。このオプションによって既存の tarball が無効になるわけではないことに注意してください。
再圧縮すると、新しいファイルにのみ影響します。サポートされている値は次のとおりです。 gzip, bzip2, lzma
& xz。 デフォルトは xz 形式 2.0 以降の場合、および gzip フォーマット1.0の場合。 xz
dpkg 1.15.5 以降でのみサポートされます。

-zレベル, --圧縮レベル=レベル
使用する圧縮レベル (--圧縮レベル dpkg 1.15.5 以降)。同様に -Z it
新しく作成されたファイルのみに影響します。サポートされている値は次のとおりです。 1 〜へ 9, 最良, 速いです.
デフォルトは 9 gzip と bzip2 の場合、 6 xz と lzma 用。

-i[正規表現], --diff-ignore[=正規表現]
フィルターで除外したいファイルに一致する Perl 正規表現を指定できます。
diff のファイルのリスト (--diff-ignore dpkg 1.15.6 以降)。 (このリストは
find コマンドによって生成されます。) (ソース パッケージがバージョン 3 としてビルドされている場合
VCS を使用するソース パッケージ。これは、コミットされていない変更を無視するために使用できます。
特定のファイル。 -i.* を使用すると、それらはすべて無視されます。)

　 -i このオプション自体は、デフォルトの正規表現 (任意の正規表現を保持) を使用してこの設定を有効にします。
以前に使用したデフォルトの正規表現への変更 --extend-diff-ignore)
最も一般的なリビジョンの制御ファイルとディレクトリを除外します。
制御システム、バックアップおよびスワップ ファイル、および Libtool ビルド出力ディレクトリ。そこには
複数のアクティブな正規表現のうち 1 つだけを指定できます -i 最後のオプションのみが選択可能
効果。

これは、差分に含まれる無関係なファイルを削除するのに非常に役立ちます。
例えばリビジョン管理システムでソースを管理していて、
追加のファイルを含めずにソース パッケージをビルドするにはチェックアウトし、
通常含まれるディレクトリ (CVS/、.cvsignore、.svn/ など)。の
デフォルトの正規表現はすでに完全に網羅されていますが、置き換える必要がある場合は、
デフォルトではパスの任意の部分と一致することに注意してください。
ファイル名の先頭または完全なファイル名のみを指定するには、必要な情報を指定する必要があります。
アンカー (例: 「(^|/)」、「($|/)」)。

--extend-diff-ignore=正規表現
指定された Perl 正規表現は、によって使用されるデフォルト値を拡張します。
--diff-ignore およびその現在の値 (設定されている場合) (dpkg 1.15.6 以降)。これを行うのは、
連結する”|正規表現”を既存の値に置き換えます。このオプションは次のような場合に便利です。
debian/ソース/オプション 一部の自動生成ファイルを自動パッチから除外するには
世代。

-I[ファイルパターン], --tar-ignore[=ファイルパターン]
このオプションを指定すると、パターンが渡されます。 tar（1）の -除外する
.orig.tar または .tar ファイルを生成するために呼び出されるときのオプション (--tar-ignore から
dpkg 1.15.6)。例えば、 -ICVS は、tar が CVS ディレクトリをスキップするようにします。
.tar.gz ファイルを生成します。このオプションはリストするために複数回繰り返すことができます
除外するパターンは複数あります。

-I 単独でデフォルトを追加します -除外する 制御ファイルをフィルタリングして除外するオプション
最も一般的なリビジョン管理システムのディレクトリ、バックアップ ファイルとスワップ ファイル、
Libtool は出力ディレクトリを構築します。

注： 目的は似ていますが、 -i & -I 構文が大きく異なり、
セマンティクス。 -i 指定できるのは 1 回のみで、Perl 互換の正規表現を使用します。
これは、各ファイルの絶対相対パスと照合されます。 -I 複数指定できる
倍になり、シェルのワイルドカードを使用したファイル名パターンを受け取ります。パターンが適用されるのは、
完全な相対パスだけでなく、パスの各部分も個別に指定できます。の正確なセマンティクス
タールの -除外する オプションはやや複雑です。を参照してください。
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

両方のオプションのデフォルトの正規表現とパターンは、 - 助けて


ジェネリック エキス オプション
--コピー禁止
抽出されたソース パッケージの近くに元の tarball をコピーしないでください (dpkg 以降)
1.14.17）。

-いいえ-チェック
解凍する前に署名とチェックサムをチェックしないでください (dpkg 1.14.17 以降)。

--有効な署名が必要
ソース パッケージに OpenPGP 署名が含まれていない場合、そのパッケージの解凍を拒否します。
(dpkg 1.15.0 以降) ユーザーの 信頼できるキー.gpg キーホルダー、
ベンダー固有のキーリングの 1 つ、または公式の Debian キーリングの 1 つ
(/usr/share/keyrings/debian-keyring.gpg &
/usr/share/keyrings/debian-maintainers.gpg).

--無視-悪いバージョン
不正なソース パッケージのバージョン チェックを致命的ではない警告に変換します (dpkg 以降)
1.17.7）。このオプションは、古代のソースを抽出する場合にのみ必要です。
下位互換性のためだけに、壊れたバージョンのパッケージ。

SOURCE PACKAGE 書式

どのソース形式を使用すればよいかわからない場合は、おそらく「3.0 (キルト)」のいずれかを選択する必要があります。
または「3.0（ネイティブ）」。詳細については、https://wiki.debian.org/Projects/DebSrc3.0 を参照してください。
これらの形式を Debian 内に展開します。

フォーマット： 1.0
この形式のソース パッケージは、次のいずれかで構成されます。 .orig.tar.gz に関連する .diff.gz
または単一の .tar.gz (その場合、パッケージは ネイティブ).

抽出

ネイティブ パッケージの抽出は、ターゲット内の 1 つの tarball を単純に抽出することです。
ディレクトリ。非ネイティブ パッケージの抽出は、最初に .orig.tar.gz &
次に、に含まれるパッチを適用します。 .diff.gz ファイル。パッチ適用されたすべてのファイルのタイムスタンプ
ソース パッケージの抽出時間にリセットされます (これにより、タイムスタンプのずれが回避されます)
自動生成ファイルにパッチを適用すると問題が発生します)。 diff は新しいファイルを作成できます (
debian ディレクトリ全体がそのように作成されます) が、ファイルを削除することはできません (空のファイルは削除されます)
残ったもの）。

建物

ネイティブ パッケージの構築は、ソース ディレクトリを含む 1 つの tarball を作成するだけです。
非ネイティブ パッケージを構築するには、元の tarball を別のファイルに抽出する必要があります。
「.orig」ディレクトリと再生成 .diff.gz ソースパッケージを比較することで ディレクトリにジョブを開始します。
.orig ディレクトリを使用します。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 オプション （with - 建てる）：

オプション以外の 2 番目の引数を指定する場合は、元のソースの名前にする必要があります。
ディレクトリ、tarfile、またはパッケージが Debian 固有のものである場合は空の文字列など
Debian化の差分はありません。 2 番目の引数が指定されていない場合は、 dpkg-ソース 見えるでしょう
元のソース tarfile の場合 パッケージ_上流バージョン.orig.tar.gz または元
ソースディレクトリ ディレクトリにジョブを開始します。.orig に応じて -sX 引数

-さ, -sp, -sk, -彼の & -sr 既存の tar ファイルやディレクトリは上書きされません。これなら
それで望ましい -sA, -sP, -SK, -彼の & -氏 代わりに使用する必要があります。

-sk デフォルトで、元のソースを tarfile として期待するように指定します パッケージ_アップストリーム-
バージョン.tar. 。この元のソースはそのまま残ります。
tarfile を作成するか、現在のディレクトリに存在しない場合はコピーします。タールボール
に解凍されます ディレクトリにジョブを開始します。.orig 差分の生成用。

-sp いいね -sk ただし、後でディレクトリを再度削除します。

-彼の デフォルトで、元のソースがディレクトリであると想定されることを指定します パッケージ-
上流バージョン.orig & dpkg-ソース 新しいオリジナルのソースアーカイブを作成します
それから。

-sr いいね -彼の ただし、そのディレクトリは使用後に削除されます。

-NS 元のソースがディレクトリとしても、ファイルとしても利用可能であることを指定します。
tarファイル。 dpkg-ソース diff の作成にはディレクトリが使用されますが、tarfile は
作成する .dsc。このオプションは注意して使用する必要があります - ディレクトリと tarfile が
一致しない場合は、不正なソース アーカイブが生成されます。

-sn オリジナルのソースを検索せず、差分も生成しないように指定します。の
2 番目の引数を指定する場合は、空の文字列にする必要があります。これは Debian で使用されます。
特定のパッケージには個別の上流ソースがないため、
Debian化の差分はありません。

-さ or -sA
元のソース アーカイブを tarfile またはディレクトリとして検索するように指定します。
2 番目の引数があれば、それは空の文字列のいずれかになります (これは同等です)
使用します -sn）。 tarfile が見つかった場合は、それを解凍して diff を作成します。
後でそれを削除します（これは -sp);ディレクトリが見つかった場合は、
それをパックして元のソースを作成し、後で削除します (これは同等です)
〜へ -sr);どちらも見つからない場合は、パッケージに非ビアン化がないと想定されます。
diff、単純なソース アーカイブのみ (これは -sn）。両方の場合
そのとき見つかる dpkg-ソース 次の場合、ディレクトリは無視され、上書きされます。 -sA ました
指定された (これは、 -sP)、または次の場合はエラーを発生させます -さ 指定されました。 -sA
デフォルトです。

--上流変更時に中止
生成された差分に外部のファイルへの変更が含まれている場合、プロセスは失敗します。
debian サブディレクトリ (dpkg 1.15.8 以降)。このオプションは次の場合には使用できません
debian/ソース/オプション しかし、で使用できます debian/source/local-options.

エキス オプション （with - 抽出する）：

いずれの場合も、既存の元のソース ツリーは削除されます。

-sp 抽出時に使用すると、元のソース (存在する場合) が tarfile として残されます。
現在のディレクトリにまだ存在していない場合、または既存のディレクトリに存在する場合
別のファイルがある場合はそこにコピーされます。 (この is 　 デフォルト).

-彼の 元のソースツリーを解凍します。

-sn 元のソースが現在のディレクトリにコピーされたり、
開梱された。現在のディレクトリにあった元のソース ツリーはそのまま残ります。
除去された。

すべて -sX オプションは相互に排他的です。複数指定した場合は最後のもののみ
使用されます。

--skip-debian化
上流のソースに加えて debian diff の適用をスキップします (dpkg 以降)
1.15.1）。

フォーマット： 2.0
抽出は dpkg 1.13.9 以降でサポートされ、ビルドは dpkg 1.14.8 以降でサポートされています。でも知られている
ウィッグ＆ペンとして。この形式は広く使用することはお勧めできません。形式「3.0 (キルト)」
それを置き換えます。 Wig&penは新世代ソースパッケージの最初の仕様でした
形式でダウンロードすることができます。

この形式の動作は、「3.0 (quilt)」形式と同じです。
パッチの明示的なリストは使用しません。内のすべてのファイル debian/パッチ/ Perlと一致する
正規表現 [\w-]+ 有効なパッチである必要があります。パッチは抽出時に適用されます。

新しいソース パッケージをビルドするとき、アップストリーム ソースへの変更はすべてパッチに保存されます。
命名 zz_debian-diff-auto.

フォーマット： 3.0 （ネイティブ）
dpkg 1.14.17 以降でサポートされています。この形式は、ネイティブ パッケージ形式を拡張したものです。
1.0形式で定義されています。すべての圧縮方法をサポートしており、デフォルトでは無視されます。
VCS 固有のファイルとディレクトリ、および多くの一時ファイル (デフォルト値を参照)
に関連付けられている -I 内のオプション - 助けて 出力）。

フォーマット： 3.0 （キルト）
dpkg 1.14.17 以降でサポートされています。この形式のソース パッケージには少なくとも
オリジナルの tarball (.tar.EXT コラボレー EXT することができます gz, bz2, lzma & xz) と debian
タールボール (.debian.tar。EXT）。追加のオリジナルの tarball を含めることもできます
(.orig-コンポーネント。タール。EXT). コンポーネント 英数字とハイフンのみを含めることができます
(「-」)。

抽出

メインのオリジナル tarball が最初に抽出され、その後、追加のオリジナル tarball がすべて抽出されます。
にちなんで名付けられたサブディレクトリに抽出されます。 コンポーネント ファイル名の一部 (以前の任意の
既存のディレクトリは置き換えられます)。 debian tarball はソースの上に抽出されます
既存のディレクトリを事前に削除した後のディレクトリ Debianの ディレクトリ。 debian に注意してください
tarball には、 Debianの サブディレクトリですが、外部のバイナリ ファイルも含めることができます
そのディレクトリの (参照 --include-バイナリ オプション）。

にリストされているすべてのパッチ debian/パッチ/debian.series or debian/パッチ/シリーズ 次に
適用済み。前者のファイルが使用され、後者のファイルが存在しない (またはシンボリックリンクである) 場合、
その後、後者は前者へのシンボリックリンクに置き換えられます。これは使用法を簡素化することを目的としています
of キルト パッチのセットを管理します。ただし、次のことに注意してください。 dpkg-ソース 解析します
パッチ適用に使用される明示的なオプションを含むファイルを正しくシリーズ化する (各ファイルに保存される)
パッチ ファイル名の後の行と 1 つ以上のスペース)、それらのオプションは無視され、
で適用できるパッチを常に期待してください。 -p1 のオプション patch。したがって、それは放出します
このようなオプションに遭遇すると警告が表示され、ビルドが失敗する可能性があります。

パッチ適用されたすべてのファイルのタイムスタンプは、ソース パッケージの抽出時間にリセットされます。
(これにより、自動生成されたファイルにパッチを適用するときに問題を引き起こすタイムスタンプの歪みが回避されます)。

に反して キルトのデフォルトの動作では、パッチはファズなしで適用されることが期待されます。
そうでない場合は、そのようなパッチを次のように更新する必要があります。 キルトまたは dpkg-ソース 意志
適用しようとするとエラーが発生します。

同様に キルトのデフォルトの動作では、パッチによってファイルも削除される可能性があります。

ファイル .pc/applied-patches いくつかのパッチが適用されている場合に作成されます。
抽出。

建物

現在のディレクトリにあるすべての元の tarball は一時ファイルに抽出されます。
ディレクトリを展開する場合と同じロジックに従って、debian ディレクトリがコピーされます
一時ディレクトリに保存され、自動パッチを除くすべてのパッチ
(debian-変更点-バージョン or debian の変更、 応じて --single-debian-patch）は
適用済み。一時ディレクトリはソース パッケージ ディレクトリと比較されます。とき
diff が空ではない場合、ビルドは失敗します。 --single-debian-patch or --自動コミット されています
この場合、差分は自動パッチに保存されます。自動パッチが適用されている場合
作成/削除されると、シリーズ ファイルとファイルから追加/削除されます。 キルト メタデータ

バイナリ ファイルに対する変更は diff で表現できないため、エラーが発生します。
メンテナが意図的にその変更されたバイナリ ファイルを
debian tarball (以下にリストすることにより) debian/source/include-binaries）。ビルドも失敗します
ホワイトリストに登録されていない限り、debian サブディレクトリでバイナリ ファイルが見つかった場合
　 debian/source/include-binaries.

更新された debian ディレクトリと変更されたバイナリのリストは、生成するために使用されます。
Debian tarball。

自動生成された差分には、VCS 固有のファイルの変更は含まれません。
多数の一時ファイル (関連するデフォルト値を参照) -i 内のオプション - 助けて 出力）。で
特に、 .pc が使用するディレクトリ キルト 自動生成中は無視されます。
パッチ。

注： dpkg-ソース --ビルド前 （と - 建てる) にリストされているすべてのパッチが確実に適用されます。
シリーズ ファイルが適用されるため、パッケージ ビルドには常にすべてのパッチが適用されます。します
これは、適用されていないパッチを見つけることによって行われます (パッチは シリーズ ファイルには入っていない
.pc/applied-patches)、そのセットの最初のパッチをエラーなしで適用できる場合、
それらをすべて適用します。オプション --準備なし この動作を無効にするために使用できます。

レコーディング 変更

- 専念 [ディレクトリにジョブを開始します。] [パッチ名] [パッチファイル]
によって管理されないローカルの変更に対応するパッチを生成します。
キルト patch system という名前でパッチシステムに統合します。 パッチ名.
名前が欠落している場合は、対話形式で尋ねられます。もし パッチファイル 与えられる、それは
統合するローカルの変更に対応するパッチとして使用されます。一度
統合すると、エディタが起動して、メタ情報を編集できるようになります。
パッチヘッダー。

通過 パッチファイル これは主に、これを事前に生成したビルド失敗の後に役立ちます。
このため、指定されたファイルは統合後に削除されます。こちらにも注意してください
パッチ ファイルに含まれる変更がすでにツリーに適用されている必要があること
パッチによって変更されたファイルには補足的な未記録があってはなりません
変更。

パッチ生成時に変更されたバイナリ ファイルが検出された場合、それらは自動的に修正されます。
に追加 debian/source/include-binaries 最終的には Debian tarball に保存されます
(まさにそのような dpkg-ソース --include-バイナリ - 建てる します)。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 オプション

--allow-version-of-quilt-db=バージョン
次を許可します。 dpkg-ソース のバージョンの場合にソース パッケージをビルドするには、 キルト
たとえ指定されたものであっても、 dpkg-ソース それについては知りません（dpkg以来）
1.15.5.4）。これは事実上、指定されたバージョンの キルト メタデータは
バージョン 2 と互換性があります。 dpkg-ソース 現在サポートしています。のバージョン
　 キルト メタデータは次の場所に保存されます .pc/.バージョン.

--include-remove
削除されたファイルは無視せず、自動生成されたパッチに含めてください。

--タイムスタンプを含める
自動生成されたパッチにタイムスタンプを含めます。

--include-バイナリ
変更されたすべてのバイナリを debian tarball に追加します。にも追加してください
debian/source/include-binaries: 以降のビルドではデフォルトで追加されます
したがって、このオプションは不要になります。

--準備なし
明らかに次のようなパッチを適用してビルド ツリーを準備しようとしないでください。
適用されません (dpkg 1.14.18 以降)。

--single-debian-patch
　 debian/パッチ/debian-変更 debian/パッチ/debian-変更-バージョン
ビルド中に生成される自動パッチの名前 (dpkg 1.15.5.4 以降)。
このオプションは、パッケージが VCS および
パッチ セットを確実に生成できません。代わりに、上流との現在の差分
単一のパッチに保存する必要があります。オプションが入れられます
debian/source/local-options そして、
debian/source/local-patch-header Debian の変更がどのように最適になるかを説明するファイル
たとえば、使用されている VCS で確認されます。

--create-empty-orig
メインのオリジナルの tarball が存在しない場合、および次の場合は空として自動的に作成します。
補足的なオリジナルの tarball があります (dpkg 1.15.6 以降)。このオプションは
ソースパッケージが複数のアップストリームのバンドルにすぎない場合に使用することを目的としています。
「メイン」ソフトウェアが存在しない場合。

-- パッチを適用しないことはありません。 --unapply-パッチ
デフォルトでは、 dpkg-ソース 内のパッチの適用が自動的に解除されます。 --ビルド後
適用中にフックした場合 --ビルド前 (--unapply-パッチ dpkg以来
1.15.8、 --no-unapply-patches dpkg 1.16.5 以降)。これらのオプションにより、
パッチの適用解除プロセスを強制的に無効または有効にします。それらのオプションは
でのみ許可されます debian/source/local-options 生成されたすべてのソースパッケージが
デフォルトでは同じ動作になります。

--上流変更時に中止
自動パッチが生成されている場合、プロセスは失敗します (dpkg 1.15.8 以降)。
このオプションを使用すると、すべての変更が適切に記録されたことを確認できます。
別 キルト ソース パッケージをビルドする前にパッチを適用します。このオプションはそうではありません
で許可 debian/ソース/オプション しかし、で使用できます debian/source/local-options.

--自動コミット
自動パッチが生成されている場合、プロセスは失敗しません。
すぐに記録されます キルト シリーズ。

エキス オプション

--skip-debian化
上流のソース上での debian tarball の抽出をスキップします (dpkg 以降)
1.15.1）。

--スキップパッチ
抽出の最後にパッチを適用しないでください (dpkg 1.14.18 以降)。

フォーマット： 3.0 （カスタム）
dpkg 1.14.17 以降でサポートされています。この形式は特殊です。実際の情報源を表すものではありません
パッケージ形式ですが、任意のファイルを含むソース パッケージを作成するために使用できます。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 オプション

オプション以外の引数はすべて、生成されたソース パッケージに統合するファイルとして取得されます。
これらは存在する必要があり、現在のディレクトリに存在することが望ましいです。少なくとも 1 つのファイルが必要です
与えられた。

--ターゲットフォーマット=値
必須。生成されるソース パッケージの実際の形式を定義します。生成された
.dsc ファイルには、この値が含まれます。 フォーマット 「3.0 (カスタム)」ではなくフィールドに入力してください。

フォーマット： 3.0 （ギット）
dpkg 1.14.17 以降でサポートされています。この形式は実験的なものです。

この形式のソース パッケージは、git リポジトリの単一のバンドルで構成されます。 .git 〜へ
パッケージのソースを保持します。もあるかもしれません .gitshallow リビジョンをリストしたファイル
浅い git クローン。

抽出

バンドルは git リポジトリとしてターゲット ディレクトリに複製されます。ある場合
gitshallow ファイルとしてインストールされます .git/浅い クローンされた git リポジトリ内。

デフォルトでは、新しいリポジトリには、チェックアウトされたブランチと同じブランチが含まれることに注意してください。
元のソースでチェックアウトされました。 (通常は「マスター」ですが、何でもかまいません。)
他のブランチは以下で利用可能になります リモコン/原点/.

建物

先に進む前に、いくつかのチェックが行われ、不完全なものがないことを確認します。
コミットされていない変更は無視されました。

git バンドル(1)はgitリポジトリのバンドルを生成するために使用されます。デフォルトでは、すべて
リポジトリ内のブランチとタグはバンドルに含まれます。

完成に向けてあなたの背中を押してくれる、執筆のための持続可能で本物のモーメンタムを作り出す。 オプション

--git-ref=参照
git バンドルに含める git ref を指定できるようにします。使用するとデフォルトが無効になります
すべてのブランチとタグを含める動作。複数回指定することも可能です。の
参照 含めるブランチまたはタグの名前を指定できます。任意のパラメータでも構いません
に渡すことができるのは git-rev-リスト(1)。たとえば、マスターのみを含めるには、
ブランチ、使用 --git-ref=マスター。を除くすべてのタグとブランチを含めるには、
プライベートブランチ、使用 --git-ref=- すべて --git-ref=^プライベート

--git- Depth=数
指定された数に切り詰められた履歴を持つ浅いクローンを作成します。
改訂。

フォーマット： 3.0 (bzr)
dpkg 1.14.17 以降でサポートされています。この形式は実験的なものです。単一の tarball を生成します
bzr リポジトリが含まれています。

抽出

tarball が解凍され、bzr を使用して現在のブランチがチェックアウトされます。

建物

先に進む前に、いくつかのチェックが行われ、不完全なものがないことを確認します。
コミットされていない変更は無視されました。

次に、ソース ディレクトリの VCS 固有の部分が一時ディレクトリにコピーされます。
ディレクトリ。この一時ディレクトリが tarball に圧縮される前に、さまざまなクリーンアップが行われます。
スペースを節約するために行われます。

診断

いいえ source 形式でアーカイブしたプロジェクトを保存します． 指定の in debian/ソース/フォーマット
ファイル debian/ソース/フォーマット は常に存在し、必要なソース形式を示す必要があります。
下位互換性のため、ファイルが存在しない場合は形式「1.0」が想定されますが、
これに依存すべきではありません: 将来のある時点で dpkg-ソース 失敗するように変更されます
そのファイルが存在しない場合。

その根拠は、フォーマット「1.0」は推奨フォーマットではなくなったため、通常はフォーマット「XNUMX」を使用する必要があるということです。
新しい形式 (「3.0 (キルト)」、「3.0 (ネイティブ)」) のいずれかを選択しますが、 dpkg-ソース しません
これは自動的に行われます。古い形式を引き続き使用したい場合は、次のようにする必要があります。
それを明示的に「1.0」と入力します debian/ソース/フォーマット.

　 差分 修正 　 フォロー中 アップストリーム ファイル
ソース形式「1.0」を使用する場合、アップストリーム ファイルを直接変更することは通常悪い考えです。
変更は最終的に隠蔽され、.diff.gz ファイルにはほとんど文書化されないためです。代わりにあなたは
変更をパッチとして debian ディレクトリに保存し、ビルド時に適用する必要があります。
この複雑さを避けるために、これを提供する形式「3.0 (キルト)」を使用することもできます。
ネイティブ。

表す 変化する 〜へ file
アップストリーム ソースへの変更は通常、パッチ ファイルとともに保存されますが、すべての変更が保存できるわけではありません。
パッチは、プレーン テキスト ファイルの内容のみを変更できます。もし、あんたが
ファイルを別のタイプのものに置き換えてみてください (たとえば、プレーンなファイルを置き換えます)
シンボリックリンクまたはディレクトリを含むファイル) を実行すると、このエラー メッセージが表示されます。

新しく 作成した 空の file file 意志 be で表さ in 差分
パッチ ファイルでは空のファイルを作成できません。したがって、この変更は
ソース パッケージを削除すると、それについて警告が表示されます。

実行ファイル モード パーマ of file 意志 be で表さ in 差分
パッチ ファイルにはファイルのアクセス許可が記録されないため、実行可能アクセス許可は記録されません。
ソースパッケージに保存されます。この警告はその事実を思い出させます。

特別 モード パーマ of file 意志 be で表さ in 差分
パッチ ファイルにはファイルのアクセス許可が記録されないため、変更されたアクセス許可は記録されません。
ソースパッケージに保存されます。この警告はその事実を思い出させます。

FILE 書式

debian/ソース/フォーマット
このファイルには、ソースのビルドに使用する形式が 1 行で含まれています。
パッケージ (可能な形式は上で説明されています)。先頭または末尾のスペースは許可されません。

debian/source/include-binaries
このファイルには、バイナリ ファイルのリスト (1 行に 1 つ) が含まれています。
debian tarball。先頭と末尾のスペースは削除されます。 ‘で始まる行#' それは
コメントはスキップされます。空行は無視されます。

debian/ソース/オプション
このファイルには、自動的に先頭に追加される長いオプションのリストが含まれています。
コマンドラインオプションのセット dpkg-ソース - 建てる or dpkg-ソース --印刷形式 コール。
のようなオプション - 圧縮 & --圧縮レベル はこのファイルに適しています。

各オプションは別の行に入力する必要があります。空行および‘で始まる行#' それは
無視されました。先頭の「--' は削除する必要があり、短いオプションは許可されません。オプション
‘の前後にスペースを入れることができます=' 記号とオプションの引用符を値の前後に使用できます。
そのようなファイルの例を次に示します。

# dpkg-source で最大限の圧縮率で debian.tar.bz2 を作成させます
圧縮 = "bzip2"
圧縮レベル = 9
# debian/patches/debian-changes を自動パッチとして使用します
単一の debian パッチ
# config.{sub,guess} の変更を無視します。
extend-diff-ignore = "(^|/)(config.sub|config.guess)$"

注： 形式でアーカイブしたプロジェクトを保存します． このファイルではオプションは受け入れられません。使用する必要があります。 debian/ソース/フォーマット
を代わりにお使いください。

debian/source/local-options
まさにそのように debian/ソース/オプション ただし、ファイルは生成されたファイルに含まれていません。
ソースパッケージ。メンテナまたは管理者に関連付けられた設定を保存すると便利な場合があります。
ソース パッケージが保持される VCS リポジトリ。

debian/source/local-patch-header & debian/ソース/パッチヘッダー
形式「2.0」で生成された自動パッチの上に置かれる自由形式のテキスト、または
「3.0（キルト）」。 ローカルパッチヘッダー 生成されたソースパッケージには含まれていませんが、
パッチヘッダー です。

debian/パッチ/シリーズ
このファイルには、適用する必要があるすべてのパッチが (指定された順序で) リストされています。
上流のソースパッケージ。先頭と末尾のスペースは削除されます。で始まる行
'#’ はコメントなのでスキップされます。空行は無視されます。残りの行は a で始まります
パッチ ファイル名 ( debian/パッチ/ ディレクトリ）最初の空白文字まで
または行末。オプション キルト オプションは行末または最初まで追跡できます
'#' の前に 1 つ以上のスペースが続きます (コメントの開始からコメントの終了までをマークします)
ライン）。

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