Manpages

名 前

dh_strip - 実 行 フ ァ イ ル 、 共 有 フ ァ イ ル 、 静 的 ラ イ ブ ラ リ の デ バ ッ グ 情 報 を 削 る

書 式

dh_strip [debhelper オ プ シ ョ ン ] [-Xitem] [--dbg-package=パ ッ ケ ー ジ ] [--keep-debug]

説 明

dh_strip は 、 デ バ ッ グ 目 的 で 利 用 す る 必 要 の な い 実 行 フ ァ イ ル 、 共 有 ラ イ ブ ラ リ 、 静 的 ラ イ ブ ラ リ か ら デ バ ッ グ 情 報 を 取 り 除 く 役 目 の debhelper プ ロ グ ラ ム で す 。 本 プ ロ グ ラ ム は パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 以 下 を 探 索 し 、 ど の フ ァ イ ル か ら デ バ ッ グ 情 報 を 取 り 除 く べ き か を 見 つ け 出 し ま す 。 本 プ ロ グ ラ ム は 、 file(1) コ マ ン ド を 利 用 し 、 フ ァ イ ル パ ー ミ ッ シ ョ ン 、 フ ァ イ ル 名 を 利 用 し て 、 ど の フ ァ イ ル が 共 有 ラ イ ブ ラ リ (*.so)、 実 行 可 能 バ イ ナ リ 、 静 的 ラ イ ブ ラ リ (lib*.a)、 デ バ ッ グ 用 ラ イ ブ ラ リ (lib*_g.a, debug/*.so) で あ る か を 判 断 し 、 該 当 す る 場 合 は 、 デ バ ッ グ シ ン ボ ル を で き る 限 り 取 り 除 き ま す (デ バ ッ グ 用 ラ イ ブ ラ リ に つ い て は 全 く 何 も し ま せ ん )。 多 く の 場 合 で 、 本 プ ロ グ ラ ム は 非 常 に 良 い 推 定 を 行 い 、 正 し く デ バ ッ グ シ ン ボ ル の 除 去 を 行 い ま す 。 自 動 的 に フ ァ イ ル が モ ジ ュ ー ル で あ る か ど う か を 見 分 け る の は 難 し く 、 ま た 、 ど う や っ て モ ジ ュ ー ル か ら デ バ ッ グ 情 報 を 除 外 す れ ば 良 い か を 決 定 す る の も 難 し い 為 、 dh_strip は 、 .o を 拡 張 子 に 持 つ フ ァ イ ル の よ う な バ イ ナ リ モ ジ ュ ー ル か ら デ バ ッ グ 情 報 の 除 去 を 行 う 事 に つ い て 、 未 だ サ ポ ー ト し て い ま せ ん 。

オ プ シ ョ ン

-Xitem, --exclude=item

item を 名 前 に 含 む よ う な フ ァ イ ル を 、 デ バ ッ グ 情 報 除 去 の 対 象 か ら 外 し ま す 。 も し 、 複 数 の フ ァ イ ル を 処 理 さ せ な い よ う に 指 定 し た け れ ば 、 本 オ プ シ ョ ン を 複 数 回 指 定 す る こ と に よ っ て 行 え ま す 。

--dbg-package=package こ の オ プ シ ョ ン は 、 現 在 特 別 な 目 的 の た め の オ プ シ ョ ン で あ り 、 通 常 必 要 あ り ま せ ん 。 ほ と ん ど の 場 合 、 新 し い ソ ー ス パ ッ ケ ー ジ で は debhelper が 自 動 的 に デ バ ッ グ パ ッ ケ ー ジ ("dbgsym パ ッ ケ ー ジ ") を 生 成 す る の で 、 こ の オ プ シ ョ ン を 使 う 理 由 は 少 な い は ず で す 。 手 動 で 作 ら れ た --dbg-package を 自 動 生 成 さ れ た デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ で 置 き 換 え た い 場 合 は --dbgsym-migration オ プ シ ョ ン を 参 照 し て 下 さ い 。

dh_strip を 使 っ て パ ッ ケ ー ジ か ら デ バ ッ グ シ ン ボ ル を 取 き 、 指 定 の デ バ ッ グ 用 パ ッ ケ ー ジ の パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 内 に 独 立 し た フ ァ イ ル と し て デ バ ッ グ シ ン ボ ル を 保 存 し ま す 。 例 え ば 、 ビ ル ド 予 定 の パ ッ ケ ー ジ と し て 、 libfoo、 foo が あ り 、 foo-dbg パ ッ ケ ー ジ に は デ バ ッ グ シ ン ボ ル を 含 め て お き た い 場 合 、 dh_strip--dbg-package=foo-dbg を 実 行 し て く だ さ い 。

This option implies --no-automatic-dbgsym and cannot be used with --automatic-dbgsym or --dbgsym-migration.

-k, --keep-debug こ の オ プ シ ョ ン は 、 現 在 特 別 な 目 的 の た め の オ プ シ ョ ン で あ り 、 通 常 必 要 あ り ま せ ん 。 ほ と ん ど の 場 合 、 新 し い ソ ー ス パ ッ ケ ー ジ で は debhelper が 自 動 的 に デ バ ッ グ パ ッ ケ ー ジ ("dbgsym パ ッ ケ ー ジ ") を 生 成 す る の で 、 こ の オ プ シ ョ ン を 使 う 理 由 は 少 な い は ず で す 。 手 動 で 作 ら れ た --dbg-package を 自 動 生 成 さ れ た デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ で 置 き 換 え た い 場 合 は --dbgsym-migration オ プ シ ョ ン を 参 照 し て 下 さ い 。 デ バ ッ グ シ ン ボ ル が 取 り 除 か れ る 一 方 、 パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 以 下 に あ る usr/lib/debug/ デ ィ レ ク ト リ へ 取 り 除 い た デ バ ッ グ シ ン ボ ル を 取 り 置 き ま す 。 --dbg-package オ プ シ ョ ン の 方 が 本 オ プ シ ョ ン よ り も 使 う の は 易 し い の で す が 、 本 オ プ シ ョ ン は --dbg-package オ プ シ ョ ン よ り も 柔 軟 な 指 定 が 可 能 で す 。

This option implies --no-automatic-dbgsym and cannot be used with --automatic-dbgsym.

--dbgsym-migration=package-relation こ の オ プ シ ョ ン は 、 手 動 (--dbg-package) で 作 成 し た "-dbg" パ ッ ケ ー ジ か ら 自 動 生 成 さ れ た デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ へ 移 行 す る の に 利 用 さ れ ま す 。 こ の オ プ シ ョ ン で は 、 (現 在 で は 廃 止 と な っ て い る ) -dbg パ ッ ケ ー ジ と フ ァ イ ル が 衝 突 す る の を 避 け る た め に デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ に 追 加 さ れ る 正 し い Replaces 及 び Breaks の 依 存 関 係 を 記 述 す る 筈 で す 。

This option implies --automatic-dbgsym and cannot be used with --keep-debug, --dbg-package or --no-automatic-dbgsym. 例 :

  dh_strip --dbgsym-migration='libfoo-dbg (<< 2.1-3~)'
  dh_strip --dbgsym-migration='libfoo-tools-dbg (<< 2.1-3~), libfoo2-dbg (<< 2.1-3~)'

--automatic-dbgsym, --no-automatic-dbgsym 可 能 な 際 に dh_strip が デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ を 作 る か ど う か を コ ン ト ロ ー ル し ま す 。 デ フ ォ ル ト は デ バ ッ グ シ ン ボ ル パ ッ ケ ー ジ を 作 成 し ま す 。
--ddebs, --no-ddebs

--automatic-dbgsym と --no-automatic-dbgsym の 歴 史 的 な 名 前 で す 。

--ddeb-migration=package-relation

--dbgsym-migration の 歴 史 的 な 名 前 で す 。

付 記

If the DEB_BUILD_OPTIONS environment variable contains nostrip, nothing will be stripped, in accordance with Debian policy (section 10.1 "Binaries"). This will also inhibit the automatic creation of debug symbol packages.

The automatic creation of debug symbol packages can also be prevented by adding noautodbgsym to the DEB_BUILD_OPTIONS environment variable. However, dh_strip will still add debuglinks to ELF binaries when this flag is set. This is to ensure that the regular deb package will be identical with and without this flag (assuming it is otherwise "bit-for-bit" reproducible).

確 認 す べ き 事

Debian ポ リ シ ー バ ー ジ ョ ン 3.0.1

参 照

debhelper(7) こ の プ ロ グ ラ ム は debhelper の 一 部 で す 。

作 者

Joey Hess <joeyh [AT] debian.org>