.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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 "dpkg-deb 1"
.TH dpkg-deb 1 "2022-09-01" "1.20.12" "dpkg suite"
.\" 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"
dpkg-deb \- ferramenta de manipula\(,c\(~ao de arquivos de pacote Debian (.deb)
.SH "SINOPSE"
.IX Header "SINOPSE"
\&\fBdpkg-deb\fR [\fIoption\fR...] \fIcommand\fR
.SH "DESCRI\(,C\(~AO"
.IX Header "DESCRI\(,C\(~AO"
\&\fBdpkg-deb\fR empacota, desempacota e fornece informa\(,c\(~ao acerca de arquivos
Debian.
.PP
Use o \fBdpkg\fR para instalar e remover pacotes do seu sistema.
.PP
Voc\(^e tamb\('em pode invocar o \fBdpkg-deb\fR ao chamar o \fBdpkg\fR com quaisquer
op\(,c\(~oes que deseje passar ao \fBdpkg-deb\fR. O \fBdpkg\fR vai perceber que voc\(^e
quer o \fBdpkg-deb\fR e corre-o por si.
.PP
Para a maioria dos comandos que recebem uma entrada de argumento de arquivo,
o arquivo pode ser lido a partir da entrada standard se o nome de arquivo
for dado por um \('unico caractere de menos (\(Fo\fB\-\fR\(Fc); caso contr\('ario a falta de
suporte ser\('a documentada na sua descri\(,c\(~ao respectiva ao comando.
.SH "COMANDOS"
.IX Header "COMANDOS"
.IP "\fB\-b\fR, \fB\-\-build\fR \fIbinary-directory\fR [\fIarchive\fR|\fIdirectory\fR]" 4
.IX Item "-b, --build binary-directory [archive|directory]"
Cria um arquivo debian para a \('arvore de sistema de ficheiros armazenada em
\&\fIbinary-directory\fR. \fIbinary-directory\fR tem de ter um sub\-direct\('orio
\&\fB\s-1DEBIAN\s0\fR, o qual cont\('em os ficheiros de informa\(,c\(~ao de controlo tais como o
pr\('oprio ficheiro control. Este direct\('orio \fIn\(~ao\fR ir\('a aparecer no arquivo de
sistema de ficheiros do pacote bin\('arios, mas em vez disso os ficheiros nele
ser\(~ao postos na \('area de informa\(,c\(~ao de controlo do pacote bin\('ario.
.Sp
A menos que voc\(^e especifique \fB\-\-nocheck\fR, \fBdpkg-deb\fR ir\('a ler
\&\fBDEBIAN/control\fR e analis\('a\-lo. Ir\('a verificar o ficheiro por erros de
sintaxe e outros problemas, e mostrar o nome do pacote bin\('ario a ser
compilado. \fBdpkg-deb\fR ir\('a tamb\('em verificar as permiss\(~oes dos scripts do
maintainer e outros ficheiros encontrados no direct\('orio de informa\(,c\(~ao de
controlo \fB\s-1DEBIAN\s0\fR.
.Sp
Se n\(~ao for especificado nenhum \fIarchive\fR ent\(~ao o \fBdpkg-deb\fR ir\('a escrever o
pacote no ficheiro \fIbinary-directory\fR\fB.deb\fR.
.Sp
Se o arquivo a ser criado j\('a existir, ele ser\('a sobrescrito.
.Sp
Se o segundo argumento for um direct\('orio ent\(~ao \fBdpkg-deb\fR ir\('a escrever para
o ficheiro \fIdirectory\fR\fB/\fR\fIpackage\fR\fB_\fR\fIversion\fR\fB_\fR\fIarch\fR\fB.deb.\fR
Quando \('e especificado um direct\('orio alvo, em vez de um ficheiro, a op\(,c\(~ao
\&\fB\-\-nocheck\fR pode n\(~ao ser usada (pois \fBdpkg-deb\fR precisa de ler e analisar
o ficheiro de controle do pacote para determinar qual o nome de ficheiro a
suar).
.IP "\fB\-I\fR, \fB\-\-info\fR \fIarchive\fR [\fIcontrol-file-name\fR...]" 4
.IX Item "-I, --info archive [control-file-name...]"
Fornece informa\(,c\(~ao acerca de um arquivo de pacote bin\('ario.
.Sp
Se nenhum \fIcontrol-file-name\fR for especificado ent\(~ao ir\('a escrever um
sum\('ario do conte\('udo do pacote assim como e seu ficheiro de controlo.
.Sp
Se alguns \fIcontrol-file-name\fRs forem especificados ent\(~ao \fBdpkg-deb\fR ir\('a
escrev\(^e\-los pela ordem que forma especificados; se qualquer dos componentes
n\(~ao estiver presente, ir\('a escrever uma mensagem de erro no stderr acerca de
cada um e terminar com estados 2.
.IP "\fB\-W\fR, \fB\-\-show\fR \fIarchive\fR" 4
.IX Item "-W, --show archive"
Fornece informa\(,c\(~ao acerca do arquivo de um pacote bin\('ario no formato
especificado pelo argumento \fB\-\-showformat\fR. O formato predefinido mostra o
nome do pacote e a vers\(~ao em uma linha, separados por um tabulador.
.IP "\fB\-f\fR, \fB\-\-field\fR \fIarchive\fR [\fIcontrol-field-name\fR...]" 4
.IX Item "-f, --field archive [control-field-name...]"
Extrai informa\(,c\(~ao de ficheiro de controle de um arquivo de pacote bin\('ario.
.Sp
Se nenhum \fIcontrol-field-name\fR for especificado ent\(~ao ir\('a escrever o
ficheiro de controle completo.
.Sp
Se algum for especificado ent\(~ao \fBdpkg-deb\fR ir\('a escrever o seu conte\('udo, na
ordem que eles aparecem no ficheiro de controle. Se for especificado mais do
que um \fIcontrol-field-name\fR ent\(~ao \fBdpkg-deb\fR ir\('a preceder cada um com o
seu nome de campo (e dois pontos e espa\(,co).
.Sp
N\(~ao s\(~ao reportados erros para campos requisitados mas n\(~ao encontrados.
.IP "\fB\-c\fR, \fB\-\-contents\fR \fIarchive\fR" 4
.IX Item "-c, --contents archive"
Lista o conte\('udo da por\(,c\(~ao de arquivo da \('arvore do sistema de ficheiros do
arquivo pacote. \('E presentemente produzido no formato gerado pela listagem
detalhada do \fBtar\fR.
.IP "\fB\-x\fR, \fB\-\-extract\fR \fIarchive directory\fR" 4
.IX Item "-x, --extract archive directory"
Extrai a \('arvore do sistema de ficheiros a partir do arquivo de pacote para o
direct\('orio especificado.
.Sp
Note que extrair um pacote para o direct\('orio raiz \fIn\(~ao\fR ir\('a resultar numa
instala\(,c\(~ao correcta! Use o \fBdpkg\fR para instalar pacotes.
.Sp
\&\fIdirectory\fR (mas n\(~ao os seus parentes) ser\('a criada se necess\('ario, e as suas
permiss\(~oes modificadas para corresponder ao conte\('udo do pacote.
.IP "\fB\-X\fR, \fB\-\-vextract\fR \fIarchive directory\fR" 4
.IX Item "-X, --vextract archive directory"
\('E como \fB\-\-extract\fR (\fB\-x\fR)  com \fB\-\-verbose\fR (\fB\-v\fR)  o que escreve uma
listagem dos ficheiros extra\('idos ao avan\(,car.
.IP "\fB\-R\fR, \fB\-\-raw\-extract\fR \fIarchive directory\fR" 4
.IX Item "-R, --raw-extract archive directory"
Extrai a \('arvore do sistema de ficheiros de um arquivo pacote para um
direct\('orio especificado, e os ficheiros de informa\(,c\(~ao de controlo para um
sub\-direct\('orio \fB\s-1DEBIAN\s0\fR do direct\('orio especificado (desde dpkg 1.16.1).
.Sp
O direct\('orio alvo (mas n\(~ao os seus parentes) ser\('a criado se necess\('ario.
.Sp
O arquivo de entrada n\(~ao \('e (actualmente) processado sequencialmente,
portanto l\(^e\-lo a partir da entrada standard (\(Fo\fB\-\fR\(Fc) \fBn\(~ao\fR \('e suportado.
.IP "\fB\-\-ctrl\-tarfile\fR \fIarchive\fR" 4
.IX Item "--ctrl-tarfile archive"
Extrai os dados de controlo de um pacote bin\('ario e envia-os para a sa\('ida
standard em formato \fBtar\fR (desde dpkg 1.17.14). Juntamente com \fBtar\fR(1)
isto pode ser usado para extrair um ficheiro de controlo particular de um
arquivo pacote. O arquivo de entrada ser\('a sempre processado sequencialmente.
.IP "\fB\-\-fsys\-tarfile\fR \fIarchive\fR" 4
.IX Item "--fsys-tarfile archive"
Extrai os dados de \('arvore de sistema de ficheiros de um pacote bin\('ario e
envia-os para a sa\('ida standard em formato \fBtar\fR. Juntamente com \fBtar\fR(1)
isto pode ser usado para extrair um ficheiro particular de um arquivo
pacote. O arquivo de entrada ser\('a sempre processado sequencialmente.
.IP "\fB\-e\fR, \fB\-\-control\fR \fIarchive\fR [\fIdirectory\fR]" 4
.IX Item "-e, --control archive [directory]"
Extrai ficheiros de informa\(,c\(~ao de controlo a partir de uma arquivo de pacote
para o direct\('orio especificado.
.Sp
Se nenhum direct\('orio for especificado, ent\(~ao \('e usado um sub\-direct\('orio
\&\fB\s-1DEBIAN\s0\fR no direct\('orio actual.
.Sp
O direct\('orio alvo (mas n\(~ao os seus parentes) ser\('a criado se necess\('ario.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Mostra a mensagem de utiliza\(,c\(~ao e termina.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Mostra a vers\(~ao e termina.
.SH "OP\(,C\(~OES"
.IX Header "OP\(,C\(~OES"
.IP "\fB\-\-showformat=\fR\fIformat\fR" 4
.IX Item "--showformat=format"
esta op\(,c\(~ao \('e usada para especificar o formato dos resultados que \fB\-\-show\fR
ir\('a produzir. O formato \('e uma string que ser\('a escrita para cada pacote
listado.
.Sp
A string pode referenciar qualquer campo de estado usado o formato
\(lq${\fIfield-name\fR}\(rq, uma lista dos campos v\('alidos pode ser produzida
facilmente usando \fB\-I\fR no mesmo pacote. Uma explica\(,c\(~ao completa das op\(,c\(~oes
de formata\(,c\(~ao (incluindo sequ\(^encias de escape e tabula\(,c\(~ao de campos) pode
ser encontrada na explica\(,c\(~ao da op\(,c\(~ao \fB\-\-showformat\fR em \fBdpkg-query\fR(1).
.Sp
A predefini\(,c\(~ao para este campo \('e \(lq${Package}\et${Version}\en\(rq.
.IP "\fB\-z\fR\fIcompress-level\fR" 4
.IX Item "-zcompress-level"
Especifica que n\('ivel de compress\(~ao usar no backend compressor, quando
compila um pacote (a predefini\(,c\(~ao \('e 9 para gzip, 6 para xz). Os valores
aceites s\(~ao 0\-9 com: 0 a ser mapeado para nenhuma compress\(~ao para
gzip. Antes do dpkg 1.16.2 o n\('ivel 0 era equivalente a nenhuma compress\(~ao
para todos os compressores.
.IP "\fB\-S\fR\fIcompress-strategy\fR" 4
.IX Item "-Scompress-strategy"
Especifica qual a estrat\('egia de compress\(~ao usar no backend compressor,
quando compila um pacote (desde dpkg 1.16.2). Valores permitidos s\(~ao \fBnone\fR
(desde dpkg 1.16.4), \fBfiltered\fR, \fBhuffman\fR, \fBrle\fR e \fBfixed\fR para gzip
(desde dpkg 1.17.0) e \fBextreme\fR para xz.
.IP "\fB\-Z\fR\fIcompress-type\fR" 4
.IX Item "-Zcompress-type"
Especifica qual tipo de compress\(~ao usar quando compila um pacote. Valores
permitidos s\(~ao \fBgzip\fR, \fBxz\fR (desde dpkg 1.15.6), e \fBnone\fR (a predefini\(,c\(~ao
\('e \fBxz\fR).
.IP "\fB\-\-[no\-]uniform\-compression\fR" 4
.IX Item "--[no-]uniform-compression"
Especifica que os mesmos par\(^ametros de compress\(~ao devem ser usados para
todos os membros do arquivo (isto \('e, \fBcontrol.tar\fR e \fBdata.tar\fR; desde
dpkg 1.17.6). Caso contr\('ario apenas o membro \fBdata.tar\fR ir\('a usar estes
par\(^ametros. Os \('unicos tipos de compress\(~ao suportados e permitidos para uso
uniformizado s\(~ao \fBnone\fR, \fBgzip\fR e \fBxz\fR.  A op\(,c\(~ao
\&\fB\-\-no\-uniform\-compression\fR desactiva a compress\(~ao uniforme (desde dpkg
1.19.0). Compress\(~ao uniforme \('e a predefini\(,c\(~ao (desde dpkg 1.19.0).
.IP "\fB\-\-root\-owner\-group\fR" 4
.IX Item "--root-owner-group"
Define os dados de dono e grupo para cada entrada na \('arvore do sistema de
ficheiros para root com id 0 (desde dpkg 1.19.0).
.Sp
\&\fBNota\fR: Esta op\(,c\(~ao pode ser \('util para compila\(,c\(~oes sem-root (veja
\&\fIrootless\-builds.txt\fR), mas \fBn\(~ao\fR deve ser usada quando as entradas t\(^em um
dono ou um grupo que n\(~ao seja o root. O suporte para estes ir\('a ser
adicionado mais tarde no formato de um meta manifesto.
.IP "\fB\-\-deb\-format=\fR\fIformat\fR" 4
.IX Item "--deb-format=format"
Define a vers\(~ao de formato de arquivo usado quando compila (desde dpkg
1.17.0). Valores permitidos s\(~ao \fB2.0\fR para o novo formato, e \fB0.939000\fR
para o antigo (a predefini\(,c\(~ao \('e \fB2.0\fR).
.Sp
O formato de arquivo antigo \('e menos facilmente analisado por ferramentas
n\(~ao\-Debian e est\('a agora obsoleto; o seu \('unico uso \('e quando se compila
pacotes para serem analisados por vers\(~oes do dpkg anteriores a 0.93.76
(Setembro 1995), o qual foi um lan\(,camento apenas para i386.
.IP "\fB\-\-nocheck\fR" 4
.IX Item "--nocheck"
Inibe as verifica\(,c\(~oes usuais de \fBdpkg-deb \-\-build\fR no conte\('udo proposto de
um arquivo. Deste modo, voc\(^e pode compilar qualquer arquivo que queira, n\(~ao
interessa o quanto estragado.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Activa resultados detalhados (desde dpkg 1.16.1). Isto actualmente apenas
afecta \fB\-\-extract\fR fazendo-o comportar-se como \fB\-\-vextract\fR.
.IP "\fB\-D\fR, \fB\-\-debug\fR" 4
.IX Item "-D, --debug"
Activa resultados de depura\(,c\(~ao. Isto n\(~ao \('e muito interessante.
.SH "ESTADO \(`A SA\('IDA"
.IX Header "ESTADO \(`A SA\('IDA"
.IP "\fB0\fR" 4
.IX Item "0"
A ac\(,c\(~ao requisitada foi executada com sucesso.
.IP "\fB2\fR" 4
.IX Item "2"
Erro fatal ou irrecuper\('avel devido a utiliza\(,c\(~ao de linha de comandos
inv\('alida, ou intera\(,c\(~oes com o sistema, tais como acesso \(`a base de dados,
aloca\(,c\(~oes de mem\('oria, etc.
.SH "AMBIENTE"
.IX Header "AMBIENTE"
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
s\(~ao: \fBauto\fR (predefinido), \fBalways\fR e \fBnever\fR.
.IP "\fB\s-1TMPDIR\s0\fR" 4
.IX Item "TMPDIR"
Se definido, \fBdpkg-deb\fR ir\('a us\('a\-lo como o direct\('orio onde criar ficheiros e
direct\('orios tempor\('arios.
.IP "\fB\s-1SOURCE_DATE_EPOCH\s0\fR" 4
.IX Item "SOURCE_DATE_EPOCH"
Se definido, ser\('a usado como marca temporal (em segundos desde a \('epoca) no
contentor \fBdeb\fR(5)'s \fBar\fR(5) e usado para engatar o mtime nas entradas do
ficheiro \fBtar\fR(5).
.SH "NOTAS"
.IX Header "NOTAS"
N\(~ao tente usar o \fBdpkg-deb\fR para instalar software! Voc\(^e deve usar o
\&\fBdpkg\fR apropriado para assegurar que todos os ficheiros s\(~ao colocados
correctamente e os scripts do pacote correm e que os seus estados e
conte\('udos s\(~ao gravados.
.SH "BUGS"
.IX Header "BUGS"
\&\fBdpkg-deb \-I\fR \fIpacote1\fR\fB.deb\fR \fIpacote2\fR\fB.deb\fR faz a coisa errada.
.PP
N\(~ao h\('a autentica\(,c\(~ao nos ficheiros \fB.deb\fR; de facto, nem sequer h\('a um
sum\('ario de verifica\(,c\(~ao sincero. (Ferramentas de alto n\('ivel como o \s-1APT\s0
suportam autentica\(,c\(~ao de pacote \fB.deb\fR obtida a partir de um dado
reposit\('orio, e a maioria dos pacotes hoje em dia fornecem um ficheiro de
controle md5sum gerado por debian/rules. Apesar de isto n\(~ao ser suportado
directamente pelas ferramentas de baixo n\('ivel.)
.SH "VEJA TAMB\('EM"
.IX Header "VEJA TAMB\('EM"
\&\fBdeb\fR(5), \fBdeb-control\fR(5), \fBdpkg\fR(1), \fBdselect\fR(1).
.SH "TRADU\(,C\(~AO"
.IX Header "TRADU\(,C\(~AO"
Am\('erico Monteiro
.PP
Se encontrar algum erro na tradu\(,c\(~ao deste documento, por favor comunique para
Am\('erico Monteiro <a_monteiro@gmx.com>.