.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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 2024-03-10 1.22.6 "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 RESUMO
.IX Header "RESUMO"
\&\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 \fBDEBIAN\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 analisa-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 \fBDEBIAN\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 escreve-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\fR \fIdirectory\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\fR \fIdirectory\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\fR \fIdirectory\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 \fBDEBIAN\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 \fBDEBIAN\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, 3 para zstd). Os valores aceites s\(~ao espec\('ificos do compressor. Para gzip de 0\-9 com 0 a ser mapeado para nenhuma compress\(~ao. Para xz de 0\-9. Para zstd de 0\-22, com os n\('iveis de 20 a 22 a ativarem o seu modo ultra. 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), \fBzstd\fR (desde dpkg 1.21.18) 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, \fBxz\fR e \fBzstd\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\-\-threads\-max=\fR\fIthreads\fR 4
.IX Item "--threads-max=threads"
Define o n\('umero m\('aximo de t\('opicos permitidos para compressores que suportam opera\(,c\(~oes multi\-t\('opico (desde dpkg 1.21.9).
.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 \fBDPKG_DEB_THREADS_MAX\fR 4
.IX Item "DPKG_DEB_THREADS_MAX"
Define o n\('umero m\('aximo de t\('opicos permitidos para compressores que suportam opera\(,c\(~oes multi\-t\('opico (desde dpkg 1.21.9).
.Sp
A op\(,c\(~ao \fB\-\-threads\-max\fR sobrep\(~oe este valor.
.IP \fBDPKG_DEB_COMPRESSOR_TYPE\fR 4
.IX Item "DPKG_DEB_COMPRESSOR_TYPE"
Define o tipo de compress\(~ao a usar (desde dpkg 1.21.10).
.Sp
A op\(,c\(~ao \fB\-Z\fR sobrep\(~oe este valor.
.IP \fBDPKG_DEB_COMPRESSOR_LEVEL\fR 4
.IX Item "DPKG_DEB_COMPRESSOR_LEVEL"
Define o n\('ivel de compress\(~ao a usar (desde dpkg 1.21.10).
.Sp
A op\(,c\(~ao \fB\-z\fR sobrep\(~oe este valor.
.IP \fBDPKG_COLORS\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 \fBTMPDIR\fR 4
.IX Item "TMPDIR"
Se definido, \fBdpkg-deb\fR ir\('a usa-lo como o direct\('orio onde criar ficheiros e direct\('orios tempor\('arios.
.IP \fBSOURCE_DATE_EPOCH\fR 4
.IX Item "SOURCE_DATE_EPOCH"
Se definido, ser\('a usado como marca temporal (em segundos desde a \('epoca) no contentor \fBar\fR\|(5) de \fBdeb\fR\|(5) e usado para engatar o mtime nas entradas do ficheiro \fBtar\fR\|(5).
.Sp
Since dpkg 1.18.8.
.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 SEGURAN\(,CA
.IX Header "SEGURAN\(,CA"
Examinar arquivos de pacotes n\(~ao\-confi\('aveis ou extra\('i\-los para direct\('orios estagi\('arios deve ser considerado um limite \(`a seguran\(,ca, e qualquer viola\(,c\(~ao desse limite derivando dessas opera\(,c\(~oes deve ser considerada uma vulnerabilidade na seguran\(,ca. Mas manusear arquivos de pacotes n\(~ao\-confi\('aveis n\(~ao deve ser feito com facilitismos, pois a \('area de superf\('icie inclui qualquer biblioteca de compress\(~ao suportada, em adi\(,c\(~ao aos formatos de arquivo e aos pr\('oprios ficheiros de controle. Executar essas opera\(,c\(~oes sobre dados n\(~ao\-confi\('aveis como root \('e fortemente desaconselhado.
.PP
A compila\(,c\(~ao de arquivos de pacotes s\('o deve ser executada sobre dados de confian\(,ca.
.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 APT 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"
\&\fI/usr/share/doc/dpkg/spec/rootless\-builds.txt\fR, \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>.