.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_STRIP 1"
.TH DH_STRIP 1 "2019-09-14" "12.6" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOME"
.IX Header "NOME"
dh_strip \- despoja executáveis, bibliotecas partilhas, e algumas bibliotecas
estáticas
.SH "RESUMO"
.IX Header "RESUMO"
\&\fBdh_strip\fR [\fIdebhelper opções\fR] [\fB\-X\fR\fIitem\fR]
[\fB\-\-dbg\-package=\fR\fIpacote\fR] [\fB\-\-keep\-debug\fR]
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
\&\fBdh_strip\fR é um programa debhelper que é responsável por despojar
executáveis, bibliotecas partilhadas, e bibliotecas estáticas que não são
usadas para depuração.
.PP
Este programa examina os seus directórios de compilação de pacotes e decide
sozinho o que despojar. Usa o \fBfile\fR\|(1), as permissões de ficheiros e os
nomes dos ficheiros para descobrir quais ficheiros são bibliotecas
partilhadas (\fI*.so\fR), binários executáveis, e bibliotecas estáticas
(\fIlib*.a\fR) e de depuração (\fIlib*_g.a\fR, \fIdebug/*.so\fR), 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.
.PP
Como é muito difícil perceber automaticamente se um ficheiro é um módulo, e
difícil determinar como despojar um módulo, o \fBdh_strip\fR presentemente não
lida com o despojar de módulos binários como os ficheiros \fI.o\fR.
.SH "OPÇÕES"
.IX Header "OPÇÕES"
.IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4
.IX Item "-Xitem, --exclude=item"
Exclui ficheiros que contenham \fIitem\fR 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.
.IP "\fB\-\-dbg\-package=\fR\fIpacote\fR" 4
.IX Item "--dbg-package=pacote"
\&\fBEsta opção é agora uma opção de objectivo especial que normalmente vocẽ
não precisa\fR. 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 \*(L"dbgsym\*(R"). \fBSe você tem um \-\-dbg\-package
manual\fR que deseja substituir por um pacote de símbolos de depuração gerado
automaticamente, por favor veja a opção \fB\-\-dbgsym\-migration\fR.
.Sp
Faz o \fBdh_strip\fR 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.
.Sp
Por exemplo, se os seus pacotes são libfoo e foo e você deseja incluir um
pacote \fIfoo-dbg\fR com símbolos de depuração, use \fBdh_strip
\&\-\-dbg\-package=\fR\fIfoo-dbg\fR.
.Sp
Esta opção implica que \fB\-\-no\-automatic\-dbgsym\fR e \fInão pode\fR ser usado com
\&\fB\-\-automatic\-dbgsym\fR ou \fB\-\-dbgsym\-migration\fR.
.IP "\fB\-k\fR, \fB\-\-keep\-debug\fR" 4
.IX Item "-k, --keep-debug"
\&\fBEsta opção é agora uma opção de objectivo especial que normalmente vocẽ
não precisa\fR. 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 \*(L"dbgsym\*(R"). \fBSe você tem um \-\-dbg\-package
manual\fR que deseja substituir por um pacote de símbolos de depuração gerado
automaticamente, por favor veja a opção \fB\-\-dbgsym\-migration\fR.
.Sp
Os símbolos de depuração serão retidos, e separados para um ficheiro
independente em \fIusr/lib/debug/\fR no directório de compilação do
pacote. \fB\-\-dbg\-package\fR é mais fácil de usar que esta opção, mas esta opção
é mais flexível.
.Sp
Esta opção implica que \fB\-\-no\-automatic\-dbgsym\fR e \fIcannot\fR seja usado com
\&\fB\-\-automatic\-dbgsym\fR.
.IP "\fB\-\-dbgsym\-migration=\fR\fIpackage-relation\fR" 4
.IX Item "--dbgsym-migration=package-relation"
Esta opção é usada para migrar de um pacote \*(L"\-dbg\*(R" manual (criado com
\&\fB\-\-dbg\-package\fR) para um pacote de símbolos de depuração gerado
automaticamente. Esta opção deve descrever uma relação \fBReplaces\fR\- e
\&\fBBreaks\fR 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).
.Sp
Esta opção implica que \fB\-\-automatic\-dbgsym\fR e \fIcannot\fR seja usado com
\&\fB\-\-keep\-debug\fR, \fB\-\-dbg\-package\fR ou \fB\-\-no\-automatic\-dbgsym\fR.
.Sp
Exemplos:
.Sp
.Vb 1
\&  dh_strip \-\-dbgsym\-migration=\*(Aqlibfoo\-dbg (<< 2.1\-3~)\*(Aq
\&
\&  dh_strip \-\-dbgsym\-migration=\*(Aqlibfoo\-tools\-dbg (<< 2.1\-3~), libfoo2\-dbg (<< 2.1\-3~)\*(Aq
.Ve
.IP "\fB\-\-automatic\-dbgsym\fR, \fB\-\-no\-automatic\-dbgsym\fR" 4
.IX Item "--automatic-dbgsym, --no-automatic-dbgsym"
Controla se o \fBdh_strip\fR deve criar pacotes de símbolos de depuração quando
possível.
.Sp
A predefinição é criar pacotes de símbolos de depuração.
.IP "\fB\-\-ddebs\fR, \fB\-\-no\-ddebs\fR" 4
.IX Item "--ddebs, --no-ddebs"
Nome histórico para \fB\-\-automatic\-dbgsym\fR e \fB\-\-no\-automatic\-dbgsym\fR.
.IP "\fB\-\-ddeb\-migration=\fR\fIpackage-relation\fR" 4
.IX Item "--ddeb-migration=package-relation"
Nome histórico para \fB\-\-dbgsym\-migration\fR.
.SH "NOTAS"
.IX Header "NOTAS"
Se a variável de ambiente \fB\s-1DEB_BUILD_OPTIONS\s0\fR conter \fBnostrip\fR,  nada será
despojado, em conformidade com a política Debian (secção 10.1
\&\*(L"Binários\*(R"). Isto irá também inibir a criação automática de pacotes de
símbolos de depuração.
.PP
A criação automática de pacotes de símbolos de depuração também pode ser
prevenida ao adicionar \fBnoautodbgsym\fR à variável de ambiente
\&\fB\s-1DEB_BUILD_OPTIONS\s0\fR. No entanto, \fBdh_strip\fR irá na mesma adicionar
debuglinks aos binários \s-1ELF\s0 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 \*(L"bit por bit\*(R".
.SH "EM CONFORMIDADE COM"
.IX Header "EM CONFORMIDADE COM"
Debian policy, versão 3.0.1
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
\&\fBdebhelper\fR\|(7)
.PP
Este programa é parte do debhelper.
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>
.SH "TRADUÇÃO"
.IX Header "TRADUÇÃO"
Américo Monteiro
.PP
Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro \fIa_monteiro@gmx.com\fR
ou
Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.