Man page - dh_strip(1)

Packages contains this manual

Available languages:

en fr pt ja de

Manual

DH_STRIP

名 前
書 式
説 明
オ プ シ ョ ン
付 記
確 認 す べ き 事
参 照
作 者

名 前

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

書 式

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

説 明

dh_strip is a debhelper program that is responsible for stripping out debug symbols in executables, shared libraries, and static libraries that are not needed during execution.

本 プ ロ グ ラ ム は パ ッ ケ ー ジ ビ ル ド デ ィ レ ク ト リ 以 下 を 探 索 し 、 ど の フ ァ イ ル か ら デ バ ッ グ 情 報 を 取 り 除 く べ き か を 見 つ け 出 し ま す 。 本 プ ロ グ ラ ム は 、 file (1) コ マ ン ド を 利 用 し 、 フ ァ イ ル パ ー ミ ッ シ ョ ン 、 フ ァ イ ル 名 を 利 用 し て 、 ど の フ ァ イ ル が 共 有 ラ イ ブ ラ リ ( *.so )、 実 行 可 能 バ イ ナ リ 、 静 的 ラ イ ブ ラ リ ( lib*.a )、 デ バ ッ グ 用 ラ イ ブ ラ リ ( lib*_g.a , debug/*.so ) で あ る か を 判 断 し 、 該 当 す る 場 合 は 、 デ バ ッ グ シ ン ボ ル を で き る 限 り 取 り 除 き ま す (デ バ ッ グ 用 ラ イ ブ ラ リ に つ い て は 全 く 何 も し ま せ ん )。 多 く の 場 合 で 、 本 プ ロ グ ラ ム は 非 常 に 良 い 推 定 を 行 い 、 正 し く デ バ ッ グ シ ン ボ ル の 除 去 を 行 い ま す 。

自 動 的 に フ ァ イ ル が モ ジ ュ ー ル で あ る か ど う か を 見 分 け る の は 難 し く 、 ま た 、 ど う や っ て モ ジ ュ ー ル か ら デ バ ッ グ 情 報 を 除 外 す れ ば 良 い か を 決 定 す る の も 難 し い 為 、 dh_strip は 、 .o を 拡 張 子 に 持 つ フ ァ イ ル の よ う な バ イ ナ リ モ ジ ュ ー ル か ら デ バ ッ グ 情 報 の 除 去 を 行 う 事 に つ い て 、 未 だ サ ポ ー ト し て い ま せ ん 。

オ プ シ ョ ン

-X item , --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@debian.org>