dh_strip - despoja executáveis, bibliotecas partilhas, e algumas
bibliotecas estáticas
dh_strip [
debhelper opções]
[
-Xitem] [
--dbg-package=pacote]
[
--keep-debug]
dh_strip é um programa debhelper que é responsável
por retirar símbolos de depuração em executáveis,
bibliotecas partilhadas, e bibliotecas estáticas que não
são necessárias durante a execução.
Este programa examina os seus directórios de compilação de
pacotes e decide sozinho o que despojar. Usa o
file(1), as
permissões de ficheiros e os nomes dos ficheiros para descobrir quais
ficheiros são bibliotecas partilhadas (
*.so), binários
executáveis, e bibliotecas estáticas (
lib*.a) e de
depuração (
lib*_g.a,
debug/*.so), e despoja cada
um o máximo possível. (O que não é de todo para
bibliotecas de depuração.) Em geral parece acertar muito bem nos
ficheiros, e fará o trabalha certo em quase todos os casos.
Como é muito difícil perceber automaticamente se um ficheiro
é um módulo, e difícil determinar como despojar um
módulo, o
dh_strip presentemente não lida com o despojar
de módulos binários como os ficheiros
.o.
-
-Xitem, --exclude=item
- Exclui ficheiros que contenham item em qualquer
ponto do seu nome de serem despojados. Você pode usar esta
opção várias vezes para construir uma lista de coisas
a excluir.
-
--dbg-package=pacote
-
Esta opção é agora uma
opção de objectivo especial que normalmente você
não precisa. Na maioria dos casos, deverá haver poucas
razões para usar esta opção para novos pacotes fonte
pois o debhelper gera automaticamente pacotes de depuração
(pacotes "dbgsym"). Se você tem um --dbg-package
manual que deseja substituir por um pacote de símbolos de
depuração gerado automaticamente, por favor veja a
opção --dbgsym-migration.
Faz o dh_strip salvar os símbolos de depuração
despojados dos pacotes em que actua como ficheiros independentes no
directório de compilação do pacote do pacote de
depuração especificado.
Por exemplo, se os seus pacotes são libfoo e foo e você deseja
incluir um pacote foo-dbg com símbolos de
depuração, use dh_strip --dbg-package=foo-dbg.
Esta opção implica que --no-automatic-dbgsym e
não pode ser usado com --automatic-dbgsym ou
--dbgsym-migration.
-
-k, --keep-debug
-
Esta opção é agora uma
opção de objectivo especial que normalmente você
não precisa. Na maioria dos casos, deverá haver poucas
razões para usar esta opção para novos pacotes fonte
pois o debhelper gera automaticamente pacotes de depuração
(pacotes "dbgsym"). Se você tem um --dbg-package
manual que deseja substituir por um pacote de símbolos de
depuração gerado automaticamente, por favor veja a
opção --dbgsym-migration.
Os símbolos de depuração serão retidos, e
separados para um ficheiro independente em usr/lib/debug/ no
directório de compilação do pacote.
--dbg-package é mais fácil de usar que esta
opção, mas esta opção é mais
flexível.
Esta opção implica que --no-automatic-dbgsym e
cannot seja usado com --automatic-dbgsym.
-
--dbgsym-migration=package-relation
- Esta opção é usada para migrar de um
pacote "-dbg" manual (criado com --dbg-package) para um
pacote de símbolos de depuração gerado
automaticamente. Esta opção deve descrever uma
relação Replaces- e Breaks válida, a
qual será adicionada ao pacote de símbolos de
depuração para evitar conflitos de ficheiros com o pacote
-dbg (agora obsoleto).
Esta opção implica que --automatic-dbgsym e
cannot seja usado com --keep-debug, --dbg-package ou
--no-automatic-dbgsym.
Exemplos:
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
- Controla se o dh_strip deve criar pacotes de
símbolos de depuração quando possível.
A predefinição é criar pacotes de símbolos de
depuração.
-
--ddebs, --no-ddebs
- Nome histórico para --automatic-dbgsym e
--no-automatic-dbgsym.
-
--ddeb-migration=package-relation
- Nome histórico para --dbgsym-migration.
Se a variável de ambiente
DEB_BUILD_OPTIONS conter
nostrip,
nada será despojado, em conformidade com a política Debian
(secção 10.1 "Binários"). Isto irá
também inibir a criação automática de pacotes de
símbolos de depuração.
A criação automática de pacotes de símbolos de
depuração também pode ser prevenida ao adicionar
noautodbgsym à variável de ambiente
DEB_BUILD_OPTIONS. No entanto,
dh_strip irá na mesma
adicionar debuglinks aos binários ELF quando a bandeira estiver
definida. Isto não garante que o pacote deb regular irá ser
idêntico com e sem esta bandeira (assumindo que é caso
contrário reproduzível "bit por bit".
Debian policy, versão 3.0.1
debhelper(7)
Este programa é parte do debhelper.
Joey Hess <
[email protected]>
Américo Monteiro
Se encontrar algum erro na tradução deste documento, por favor
comunique para Américo Monteiro
[email protected] ou Equipa
Debian de Tradução Portuguesa
[email protected].