Manpages

−n

postinst, postrm 等 の ス ク リ プ ト に 変 更 を 加 え ま せ ん 。

v5 こ れ は サ ポ ー ト さ れ て い る 最 低 限 の 互 換 性 レ ベ ル で す 。 こ れ 以 前 の 互 換 性 レ ベ ル か ら ア ッ プ グ レ ー ド し よ う と し て い る 場 合 、

v6

v5 か ら の 変 更 点 :

− メ ン テ ナ ン ス 用 ス ク リ プ ト の 一 部 を 生 成 す る コ マ ン ド は 、

prerm と postrm ス ク リ プ ト 用 に こ れ ら を 逆 順 に 並 び 替 え る よ う に な り ま し た 。

−

dh_installwm は x−window−manager.1.gz と い う slave な man ペ ー ジ へ リ ン ク を 作 る よ う に な り ま し た 。 こ れ は パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 内 の usr/share/man/man1 デ ィ レ ク ト リ に man ペ ー ジ が あ る 場 合 に 行 わ れ ま す 。

−

dh_builddeb は 、 CVS: .svn:.git の よ う に 除 外 す る 対 象 を DH_ALWAYS_EXCLUDE に 指 定 し て も 該 当 す る フ ァ イ ル を 削 除 し て い ま せ ん で し た 。 本 互 換 性 レ ベ ル で は 削 除 す る よ う に な っ て い ま す 。

−

dh_installman は 、 パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ に す で に 存 在 す る man ペ ー ジ を 上 書 き し て も 良 く な り ま し た 。 こ れ よ り 以 前 の 互 換 性 レ ベ ル の 元 で は 、 こ の よ う な 動 作 は 何 の 警 告 も な く 拒 絶 さ れ て い ま し た 。

v7

v6 か ら の 変 更 点 :

− も し 、

debian/tmp 以 下 に あ る よ う な フ ァ イ ル が 、 カ レ ン ト デ ィ レ ク ト リ に な い 場 合 (も し く は 、 −−sourcedir で 指 定 し た デ ィ レ ク ト リ に な い 場 合 ) 、 dh_install は debian/tmp を 探 し に い く よ う に な り ま し た 。 こ の 振 る 舞 い の 変 更 に よ り 、 dh_install に 特 に 何 か 引 数 を 指 定 し な く て も 、 debian/tmp に イ ン ス ト ー ル し よ う と す る dh_auto_install と 協 調 し て 動 作 で き る よ う に な り ま し た 。

−

dh_clean は debian/clean を 読 み 、 そ こ に 記 載 さ れ て い る フ ァ イ ル を 消 す よ う に な り ま し た 。

−

dh_clean は ビ ル ド デ ィ レ ク ト リ の 最 上 位 の 階 層 に あ る *−stamp フ ァ イ ル を 消 す よ う に な り ま し た 。

−

dh_installchangelogs は 、 何 も 指 定 し な く て も ど の フ ァ イ ル が upstream の changelog で あ る か を 推 定 す る よ う に な り ま し た 。

v8

v7 か ら の 変 更 点 :

−

dh_makeshlibs は 、 shlibs フ ァ イ ル を 作 成 す る 為 に 、 dpkg-gensymbols を す べ て の 共 有 ラ イ ブ ラ リ に 対 し て 実 行 す る よ う に な り ま し た 。 −X を 指 定 す る と 実 行 を 除 外 す る ラ イ ブ ラ リ を 指 定 で き ま す 。 ま た 、 通 常 で は な い 場 所 に ラ イ ブ ラ リ が あ る 為 dh_makeshlibs へ 渡 す 前 に dpkg-gensymbols が 処 理 で き な い よ う な 場 合 、 パ ッ ケ ー ジ の ビ ル ド が 失 敗 に 終 わ る よ う に な り ま し た 。

−

dh は 最 初 の パ ラ メ ー タ と し て 、 一 連 の 処 理 の 名 前 を 指 定 し 、 そ の 次 に オ プ シ ョ ン を 記 載 し な け れ ば な ら な く な り ま し た 。 つ ま り 、 "dh $@ −−foo" が 正 し く 、 "dh −−foo $@" は 間 違 い と な り ま す 。

−

dh_auto_* は Makefile.PL フ ァ イ ル よ り も 、 Perl の Module::Build モ ジ ュ ー ル を 優 先 し て 利 用 す る よ う に な り ま し た 。

v9

v8 か ら の 変 更 点 :

multiarch を サ ポ ー ト し ま す 。 特 に dh_auto_configure は autoconfコ マ ン ド へ −−libdir や −−libexecdir に multiarch 用 途 の デ ィ レ ク ト リ を 渡 す よ う に な っ て い ま す 。

−

dh コ マ ン ド は debian/rules に 記 載 さ れ て い る タ ー ゲ ッ ト 間 の 一 般 的 な 依 存 性 を 考 慮 し ま す 。 そ の た め 、 "dh binary" は rules フ ァ イ ル に 存 在 す る build, build-arch, build-indep, install 等 の タ ー ゲ ッ ト を 実 行 し て い き ま す 。 つ ま り 、 他 の タ ー ゲ ッ ト に 関 す る 依 存 関 係 を い ち い ち 細 か く 明 示 し た binary タ ー ゲ ッ ト を 用 意 す る 必 要 は あ り ま せ ん 。

−

dh_strip は デ バ ッ グ シ ン ボ ル フ ァ イ ル を 圧 縮 し 、 −dbg パ ッ ケ ー ジ の イ ン ス ト ー ル 時 に 必 要 と す る 容 量 を 削 減 し ま す 。

−

dh_auto_configure は 、 autoconf を 使 っ た と き に 、 −−libexecdir に ソ ー ス パ ッ ケ ー ジ 名 を 追 加 し な く な り ま し た 。

−

dh は −−with=python−support オ プ シ ョ ン を 、 デ フ ォ ル ト で は 無 効 に す る よ う に な り ま し た 。

− す べ て の

dh_auto_* debhelper プ ロ グ ラ ム と dh コ マ ン ド

−

dh_auto_configure は 、 dpkg-buildflags に よ っ て 設 定 さ れ る CFLAGS、 CPPFLAGS, LDFLAGS パ ラ メ ー タ を Makefile.PL や Build.PL へ 引 き 渡 し ま す 。

−

dh_strip は build-id に 基 づ く 場 所 に 、 分 離 し た デ バ ッ グ シ ン ボ ル を 配 置 し ま す 。

実 行 可 能 権 限 を 付 与 し た debhelper 用 の 設 定 フ ァ イ ル は 、 実 行 さ れ 出 力 が 設 定 と し て 扱 わ れ ま す 。

v10

v9 か ら の 変 更 点 :

−

  override_dh_foo:
    dh_foo −pmy−pkg
  override_dh_bar:
    dh_bar
    dh_foo −−remainingこ の 場 合 、

dh_foo −−remaining の 呼 び 出 し は 、 dh_foo −pmy−pkg が 分 か れ て い る override タ ー ゲ ッ ト 内 に あ る た め 、 my-pkg も 含 み ま す 。 こ の 問 題 は −−remaining に 限 ら ず −a, −i な ど も 含 み ま す 。

作 推 奨 モ ー ド で す 。

−

Please note that the dh_installsystemd tool has a slightly different behaviour in some cases (e.g. when using the −−name parameter).

The vast majority of all packages will be unaffected by this change.

Known exceptions include building with the nodoc profile, where the above tools will silently permit failed matches where the patterns are used to specify documentation.

Migration note: A bug in debhelper 11 up to 11.1.5 made dh_installinfo incorrectly ignore −−sourcedir.

Note this item will eventually become obsolete as upstream intends to drop support for the PERL_USE_UNSAFE_INC environment variable. When perl drops support for it, then this variable will be removed retroactively from existing compat levels as well.

The −−doc−main−package option can be used when the auto-detection is insufficient.

This change may cause the tools to process more files than previously.

Changes from v11 are:

If an unversioned dependency in the shlibs file is wanted, this can be obtained by passing −VNone instead. However, please see dh_makeshlibs(1) for the caveat of unversioned dependencies.

付 記

複 数 の バ イ ナ リ パ ッ ケ ー ジ の サ ポ ー ト ソ ー ス パ ッ ケ ー ジ が 複 数 の バ イ ナ リ パ ッ ケ ー ジ を 生 成 す る 場 合 、 デ フ ォ ル ト で は debhelper は 実 行 時 に す べ て の バ イ ナ リ パ ッ ケ ー ジ を 生 成 し ま す 。 こ の 場 合 ソ ー ス パ ッ ケ ー ジ が 、 ア ー キ テ ク チ ャ 依 存 パ ッ ケ ー ジ と ア ー キ テ ク チ ャ 非 依 存 パ ッ ケ ー ジ を 同 時 に 生 成 す る と し た ら 、 こ の 振 る 舞 い は 正 し く あ り ま せ ん 。 と い う の も 、 debian/rules で は 、 ア ー キ テ ク チ ャ 依 存 パ ッ ケ ー ジ を 生 成 す る な ら binary-arch タ ー ゲ ッ ト 内 で 生 成 す る 必 要 が あ り 、 ア ー キ テ ク チ ャ 非 依 存 の パ ッ ケ ー ジ な ら ば 、 binary−indep タ ー ゲ ッ ト で 生 成 す る 必 要 が あ る 為 で す 。 こ れ を 容 易 に す る 為 、 ど の パ ッ ケ ー ジ が debhelper プ ロ グ ラ ム に よ っ て 処 理 さ れ る か を よ り コ ン ト ロ ー ル す る の と 同 様 、 す べ て の debhelper プ ロ グ ラ ム は −a, −i, −p, −s パ ラ メ ー タ を 解 釈 で き ま す 。 こ れ ら の パ ラ メ ー タ は 重 複 可 能 で す 。 何 も 指 定 し な い 場 合 、 debhelper プ ロ グ ラ ム は 、 以 下 の 例 外 を 除 い て control フ ァ イ ル に 列 挙 さ れ た す べ て の パ ッ ケ ー ジ に 対 し て 処 理 を 行 い ま す 。 ま ず 、 debian/control 中 の Architecture フ ィ ー ル ド が DEB_HOST_ARCH ア ー キ テ ク チ ャ に 一 致 し な い 全 て の パ ッ ケ ー ジ が 除 外 さ れ ま す ("Debian ポ リ シ ー 5.6.8 章 ")。 ま た 、 <https://wiki.debian.org/BuildProfileSpec>; に あ る ド ラ フ ト の ポ リ シ ー に よ る と 、 DEB_BUILD_PROFILES 環 境 変 数 と debian/control 中 の バ イ ナ リ パ ッ ケ ー ジ 節 の Build-Profiles フ ィ ー ル ド の 内 容 を 元 に 追 加 で パ ッ ケ ー ジ が 除 外 さ れ ま す 。

Interaction between package selections and Build-Profiles

Build-Profiles affect which packages are included in the package selections mechanisms in debhelper. Generally, the package selections are described from the assumption that all packages are enabled. This section describes how the selections react when a package is disabled due to the active Build-Profiles (or lack of active Build-Profiles).
−a/−−arch, −i/−−indep OR no selection options (a raw "dh_X" call)

The package disabled by Build-Profiles is silently excluded from the selection.

Note you will receive a warning if all packages related to these selections are disabled. In that case, it generally does not make sense to do the build in the first place.

−N package / −−no−package package

The option is accepted and effectively does nothing.

−p package / −−package package

The option is accepted, but debhelper will not act on the package.

Note that it does not matter whether a package is enabled or disabled by default. メ ン テ ナ ス ク リ プ ト の 自 動 生 成
debhelper コ マ ン ド に は 、 Debian メ ン テ ナ ス ク リ プ ト の 一 部 を 自 動 的 に 生 成 す る も の が あ り ま す 。 も し 、 既 存 の Debian メ ン テ ナ ス ク リ プ ト に 自 動 生 成 さ れ た 部 分 を 含 む よ う に し た け れ ば 、 コ ー ド を 追 加 し た い 場 所 に #DEBHELPER# と 追 記 し て く だ さ い 。 #DEBHELPER# は dh_installdeb が 実 行 さ れ る 際 に 、 自 動 生 成 さ れ た コ ー ド へ 置 換 さ れ ま す 。 ス ク リ プ ト が ま っ た く 存 在 し な い が debhelper が 何 か を ス ク リ プ ト に 追 加 す る 必 要 が あ る 場 合 、 debhelper は ス ク リ プ ト を 一 式 生 成 し ま す 。

−n パ ラ メ ー タ ー を 指 定 す る と 、 こ の よ う な debhelper プ ロ グ ラ ム に よ る ス ク リ プ ト の 自 動 生 成 を 行 わ な い よ う に で き ま す (上 記 参 照 )。 挿 入 さ れ る コ ー ド は シ ェ ル ス ク リ プ ト な の で 、 Perl ス ク リ プ ト に は 直 接 埋 め 込 め な い 事 に 注 意 し て く だ さ い 。 も し 何 か を Perl ス ク リ プ ト に 埋 め 込 み た い 場 合 、 以 下 に 一 例 を 挙 げ ま す ($1, $2 等 は set コ マ ン ド に よ り 設 定 さ れ る 事 に 注 意 ):

  my $temp="set −e\nset −− @ARGV\n" . << 'EOF';
  #DEBHELPER#
  EOF
  if (system($temp)) {
     my $exit_code = ($? >> 8) & 0xff;
     my $signal = $? & 0x7f;
     if ($exit_code) {
         die("debhelper ス ク リ プ ト は 失 敗 し ま し た 。 エ ラ ー コ ー ド : ${exit_code}");}
       else {
         die("debhelper ス ク リ プ ト は 以 下 の シ グ ナ ル で 終 了 さ れ ま し た : ${signal}");}}様

々 な 依 存 関 係 の 自 動 生 成
debhelper は 他 の パ ッ ケ ー ジ に 依 存 す る よ う な パ ッ ケ ー ジ を 作 成 す る こ と が あ り ま す 。 例 え ば 、 dh_installdebconf(1) を 使 う と 、 ビ ル ド し た パ ッ ケ ー ジ は debconf パ ッ ケ ー ジ に も 依 存 す る よ う に な り ま す 。 あ る い は dh_installxfonts(1) を 使 う と 、 特 定 の バ ー ジ ョ ン の xutils に 依 存 す る こ と に な り ま す 。 こ れ ら の 様 々 な 依 存 関 係 を 追 い か け る の は 、 debhelper が ど の よ う な 処 理 を 行 う か に よ る た め に 面 倒 な こ と に な り が ち で す 。 そ の た め 、 debhelper は 自 動 的 に 依 存 関 係 を 解 決 す る 機 能 を 提 供 し ま す 。 他 の パ ッ ケ ー ジ に 依 存 す る よ う な パ ッ ケ ー ジ を 生 成 す る debhelper コ マ ン ド は 、 何 に 依 存 す る か に つ い て man ペ ー ジ に 記 載 し て あ る 他 に 、 ${misc:Depends} と 呼 ば れ る 変 数 を 、 自 動 的 に 生 成 し た 依 存 情 報 と 置 き 換 え ま す 。 も し debian/control に こ の 変 数 を 指 定 す れ ば 、 debhelper は 必 要 と す る 依 存 関 係 を 自 動 的 に 展 開 す る よ う に な り ま す 。 こ の 変 数 は 、 dh_makeshlibs(1) に よ り 生 成 さ れ た 標 準 の ${shlibs:Depends} 変 数 と は ま っ た く 関 連 を 持 ち ま せ ん 。 ま た 、 dh_perl(1) に よ り 生 成 さ れ た ${perl:Depends} 変 数 も 同 様 で す 。 debhelper コ マ ン ド の 推 測 が 実 状 に 合 わ な い 場 合 は 、 こ れ ら を 使 わ な い よ う に す る こ と も 可 能 で す 。 パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ デ フ ォ ル ト で は 、 す べ て の debhelper プ ロ グ ラ ム は パ ッ ケ ー ジ に 含 め る フ ァ イ ル 群 を ま と め る 一 時 デ ィ レ ク ト リ と し て debian/package デ ィ レ ク ト リ を 使 用 し ま す 。 時 折 、 別 の 一 時 デ ィ レ ク ト リ を 利 用 し た く な る 場 合 が あ る で し ょ う 。 こ の 場 合 は 、 −P フ ラ グ を 利 用 し て く だ さ い 。 例 え ば 、 "dh_installdocs　 −Pdebian/tmp" で は debian/tmp を 一 時 デ ィ レ ク ト リ と し て 利 用 で き ま す 。 た だ し 、 −P を 使 う と 、 debhelper プ ロ グ ラ ム は 一 度 に 1 つ の パ ッ ケ ー ジ の 処 理 し か で き ま せ ん 。 そ の 為 、 複 数 の バ イ ナ リ パ ッ ケ ー ジ を 生 成 す る よ う な 場 合 、 ど の バ イ ナ リ パ ッ ケ ー ジ に 対 し て debhelper が 作 用 す る か を 指 定 す る た め に −p フ ラ グ を 併 用 す る 必 要 が あ り ま す 。

udeb パ ッ ケ ー ジ に つ い て
debhelper は udeb も サ ポ ー ト し て い ま す 。 debhelper で udeb パ ッ ケ ー ジ を 作 成 す る に は 、 "Package-Type: udeb" を debian/control の パ ッ ケ ー ジ 定 義 に 加 え て く だ さ い 。 debhelper は udeb フ ァ イ ル を debian-installer ポ リ シ ー に あ わ せ て ビ ル ド し ま す 。 こ れ は 、 パ ッ ケ ー ジ の 拡 張 子 が .udeb と な る フ ァ イ ル で 、 い か な る ド キ ュ メ ン ト や 、 preinst, postrm, prerm, config ス ク リ プ ト 等 も 省 い た も の で す 。

環 境 変 数

以 下 の 環 境 変 数 は debhelper の 振 る 舞 い に 影 響 を 与 え る こ と が で き ま す 。 正 し く 動 作 す る た め に は 、 (単 な る Makefile 変 数 で は な く ) 実 際 の 環 境 変 数 で あ る 必 要 が あ る こ と に 注 意 す る の が 重 要 で す 。 こ れ ら を 正 し く debian/rules で 指 定 す る に は 、 必 ず "export" し て く だ さ い 。 例 え ば "export DH_VERBOSE " な ど と し ま す 。

DH_VERBOSE

1 を 指 定 す る と 冗 長 出 力 モ ー ド に な り ま す 。 debhelper は 動 作 す る 全 て の コ マ ン ド に つ い て 出 力 を 行 う よ う に な り ま す 。 ま た 、 autoconf の よ う な ビ ル ド シ ス テ ム に つ い て も 冗 長 出 力 さ れ た ビ ル ド ロ グ を 有 効 に し ま す 。

DH_QUIET

quiet モ ー ド を 有 効 に す る に は 1 を 指 定 し て 下 さ い 。 debhelperは upstream の ビ ル ド シ ス テ ム の 呼 び 出 し コ マ ン ド や 、 dh が ど の サ ブ コ マ ン ド が 呼 び 出 さ れ た の か も 出 力 し な く な り 、 upstream の ビ ル ド シ ス テ ム に よ っ て は さ ら に 静 か に な り ま す 。 こ れ は 重 要 な メ ッ セ ー ジ に 注 目 す る の が 簡 単 に な り ま す が 、 buildd の ロ グ と し て は 出 力 は 極 め て 使 い 物 に な ら な く な り ま す 。 DH_VERBOSE が 同 時 に セ ッ ト さ れ て い る と 無 視 さ れ ま す 。

DH_COMPAT こ の 環 境 変 数 は 、 debhelper を ど の 互 換 性 レ ベ ル で 実 行 す る か を 一 時 的 に 指 定 す る も の で す 。 こ ち ら を 指 定 す る と debian/compat の 値 を 上 書 き し ま す 。
DH_NO_ACT

1 に 設 定 す る と 、 何 も し な い (no-act) モ ー ド に な り ま す 。

DH_OPTIONS こ の 環 境 変 数 に 指 定 し た も の は 、 す べ て の debhelper コ マ ン ド の 末 尾 に 指 定 さ れ る よ う に な り ま す 。

dh(1) を 使 え ば 、 続 い て 呼 び 出 さ れ る debhelper コ マ ン ド に 指 定 し た オ プ シ ョ ン を 渡 す こ と が で き ま す 。 大 抵 の 場 合 、 こ ち ら の 方 が DH_OPTIONS を 使 う よ り も 良 い 方 法 で す 。

DH_ALWAYS_EXCLUDE こ ち ら が 設 定 さ れ て い る と 、 −X オ プ シ ョ ン を サ ポ ー ト す る す べ て の コ マ ン ド に 対 し 、 −X オ プ シ ョ ン の 値 と し て 環 境 変 数 の 値 を 指 定 し ま す 。 さ ら に 、 dh_builddeb コ マ ン ド は ビ ル ド ツ リ ー の 元 で 環 境 変 数 の 値 に 基 づ く パ タ ー ン に マ ッ チ す る も の 全 部 を rm −rf す る よ う に な り ま す 。 こ れ は CVS ソ ー ス ツ リ ー か ら パ ッ ケ ー ジ ビ ル ド を す る 場 合 に 便 利 な 場 合 が あ り ま す 。 例 え ば 、 DH_ALWAYS_EXCLUDE=CVS を 指 定 す れ ば 、 CVS デ ィ レ ク ト リ が ビ ル ド の 際 に 検 索 さ れ る の を 防 ぐ こ と が で き ま す 。 あ る い は 、 ソ ー ス の tarball に す で に CVS デ ィ レ ク ト リ が (愚 か に も ) 含 ま れ て い る 場 合 、 debian/rules で DH_ALWAYS_EXCLUDE=CVS 環 境 変 数 を export す れ ば 、 ど こ で パ ッ ケ ー ジ を ビ ル ド し よ う と も 効 果 を 発 揮 す る よ う に な り ま す 。 除 外 し た い も の を 複 数 指 定 し た い 場 合 は 、 DH_ALWAYS_EXCLUDE=CVS:.svn の よ う に コ ロ ン で 区 切 っ て く だ さ い 。
DH_EXTRA_ADDONS

If set, this adds the specified dh addons to be run in the appropriate places in the sequence of commands. This is equivalent to specifying the addon to run with the −−with flag in the debian/rules file. Any −−without calls specifying an addon in this environment variable will not be run.

This is intended to be used by downstreams or specific local configurations that require a debhelper addon to be run during multiple builds without having to patch a large number of rules file. If at all possible, this should be avoided in favor of a −−with flag in the rules file.

参 照

/usr/share/doc/debhelper/examples/

debhelper を 使 う と き の debian/rules フ ァ イ ル の 例 が 格 納 さ れ て い ま す 。

<http://joeyh.name/code/debhelper/>;

Debhelper の Web サ イ ト で す 。

作 者

Joey Hess <joeyh [AT] debian.org>