path: root/man/pt/dpkg-query.pod

        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

dpkg-query - uma ferramenta para questionar a base de dados do dpkg

=head1 SINOPSE

B<dpkg-query> [I<option>...] I<command>

=head1 DESCRIÇÃO

B<dpkg-query> é uma ferramenta para mostrar informação acerca de pacotes
listados no base de dados do B<dpkg>.

=head1 COMANDOS

=over 

=item B<-l>, B<--list> [I<package-name-pattern>...]

Lista todos os pacotes conhecidos que correspondem a um ou mais padrões,
independentemente do seu estado, o que inclui quaisquer referências a
pacotes reais ou virtuais em qualquer campo de relacionamento de dependência
(tal como B<Breaks>, B<Enhances>, etc.). Se nenhum I<package-name-pattern>
for fornecido, lista todos os pacotes em I<%ADMINDIR%/status>, excluindo
aqueles marcados como não-instalados (isto é, aqueles que foram previamente
purgados). São permitidos caracteres wildcard de shell normal em
I<package-name-pattern>. Por favor note que provavelmente terá que citar
I<package-name-pattern> para impedir a shell de executar expansão do nome de
ficheiro. Por exemplo isto irá listas todos os nomes de pacotes que comecem
com “libc6”:

=over 

 dpkg-query -l 'libc6*'

=back

As primeiras três colunas do resultado mostram a acção desejada, e estado do
pacote, e erros, por essa ordem.

Acção desejada:

=over 

=item u = Unknown

=item i = Install

=item h = Hold

=item r = Remove

=item p = Purge

=back

Estado de pacote:

=over 

=item n = Not-installed

=item c = Config-files

=item H = Half-installed

=item U = Unpacked

=item F = Half-configured

=item W = Triggers-awaiting

=item t = Triggers-pending

=item i = Installed

=back

Flags de erro:

=over 

=item E<lt>emptyE<gt> = (none)

=item R = Reinst-required

=back

Um estado em letra maiúscula ou letra de erro indica que o pacote é provável
de causar severos problemas. Por favor consulte B<dpkg>(1) para informação
sobre os estados e bandeiras em cima.

O formato de saída desta opção não é configurável, mas varia automaticamente
para caber na largura do terminal. Destina-se a ser lido por humanos e não é
facilmente lido por máquinas. Veja B<-W> (B<--show>)  e B<--showformat> para
um modo de configurar o formato do resultado.

=item B<-W>, B<--show> [I<package-name-pattern>...]

Tal como a opção B<--list> isto irá listar todos os pacotes que correspondem
ao padrão fornecido. No entanto, o resultado pode ser personalizado usando a
opção B<--showformat>. O formato de saída predefinido mostra um pacote
correspondente por linha, cada linha a ter o nome (estendido com o
qualificador de arquitectura para pacotes B<Multi-Arch> B<same>) e a versão
instalada do pacote, separada por um tab.

=item B<-s>, B<--status> [I<package-name>...]

Reporta estado de pacote específico. Isto apenas mostra a entrada na base de
dados de estados de pacotes instalados. Se não especificado nenhum
I<package-name> irá mostrar todas as entradas de pacotes na base de dados de
estados (desde dpkg 1.19.1). Quando são listadas várias entradas de
I<package-name>, as entradas de estado requisitadas são separadas por uma
linha vazia, com a mesma ordem que foi especificada na lista de argumentos.

=item B<-L>, B<--listfiles> I<package-name>...

Lista os ficheiros instalados no seu sistema a partir de
I<package-name>. Quando são listados vários I<package-name>, as listas de
ficheiros pedidas são separadas por uma linha vazia, na mesma ordem como
especificada na lista de argumentos. No entanto, note que os ficheiros
criados pelos scripts de instalação específicos do pacote não são listados.

=item <--control-list> I<package-name>

Lista ficheiros de controle instalados no seu sistema a partir de
I<nome-pacote> (desde dpkg 1.16.5). Estes podem ser usados como argumentos
de entrada para B<--control-show>.

=item B<--control-show> I<package-name> I<control-file>

Escreve o I<ficheiro-controle> instalado no seu sistema a partir de
I<nome-pacote> na saída standard (desde dpkg 1.16.5).

=item B<-c>, B<--control-path> I<package-name> [I<control-file>]

Lista caminhos para ficheiros de controle instalados no seu sistema a partir
de I<package-name> (desde dpkg 1.15.4).  Se for especificado I<control-file>
então apenas lista o caminho para esse ficheiro de controle se estiver
presente.

B<Aviso>: este comando está descontinuado pois da acesso direto à base de
dados interna do  dpkg, por favor use B<--control-list> e B<--control-show>
em vez deste para todos os casos onde esses comandos possam dar os mesmos
resultados finais. esult. Apesar disto, enquanto ainda existir pelo menos um
caso onde este comando é necessário (isto é, quando é preciso de remover um
script de maintainer postrm prejudicial), e enquanto não existir boa solução
para isso, este comando não será removido.

=item B<-S>, B<--search> I<filename-search-pattern>...

Procura por pacotes que possuem ficheiros que correspondem ao padrão
dado. Podem ser usados caracteres wildcard de shell standard no padrão, onde
o asterisco (B<*>) e ponto interrogação (B<?>) irão corresponder a uma
barra, e a barra invertida (B<\>) será usada como um caractere de escape.

Se o primeiro caractere em I<filename-search-pattern> não for nenhum de
‘B<*[?/>’ então será considerado uma correspondência de sub-string e será
implicitamente cercada por ‘B<*>’ (como em
B<*>I<filename-search-pattern>B<*>).  Se a string subsequente conter
qualquer de ‘B<*[?\>’, então será lidada como um padrão glob, caso contrário
qualquer ‘B</>’ ou ‘B</.>’ no final será removido e será executada uma busca
de caminho literal.

Este comando não irá listar ficheiros extra criados pelos scripts do
maintainer, nem irá listar alternativas.

=item B<-p>, B<--print-avail> [I<package-name>...]

Mostra detalhes sobre pacotes, como encontrado em
I<%ADMINDIR%/available>. Se nenhum I<package-name> for especificado, irá
mostrar todas as entradas de pacotes na base de dados I<disponível> (desde
dpkg 1.19.1). Quando vários I<package-name> são listados, as entradas
I<disponíveis> requeridas são separadas por uma linha vazia, com a mesma
ordem que foi especificada na lista de argumentos.

Utilizadores de frontends baseados no APT devem usar B<apt show>
I<package-name> em vez disto, pois o ficheiro I<disponível> só é mantido
actualizado quando se usa o B<dselect>.

=item B<-?>, B<--help>

Mostra a mensagem de utilização e termina.

=item B<--version>

Mostra a versão e termina.

=back

=head1 OPÇÕES

=over 

=item B<--admindir=>I<dir>

Altera a localização da base de dados do B<dpkg>. A localização predefinida
é I<%ADMINDIR%>.

=item B<--load-avail>

Também carrega o ficheiro disponível quando se usa os comandos B<--show> e
B<--list>, que agora por predefinição apenas consultam o ficheiro de status
(desde dpkg 1.16.2).

=item B<--no-pager>

Desactiva o uso de qualquer paginador quando mostra informação (desde dpkg
1.19.2).

=item B<-f>, B<--showformat=>I<format>

Esta opção é usada para especificar o formato dos resultados que B<--show>
irá produzir (opção curta desde dpkg 1.13.1). O formato é uma string que irá
ser escrita para cada pacote listado.

Na string de formato, “B<\>” introduz escapes:

=over 

=item B<\n> nova linha

=item B<\r> retorno do carrinho

=item B<\t> tab

=back

“B<\>” antes de qualquer outro caractere suprime qualquer significado
especial do caractere seguinte, o que é útil para “B<\>” e “B<$>”.

Informação do pacote pode ser incluída ao inserir referencias variáveis a
campos de pacotes usando a sintaxe “B<${>I<field>[B<;>I<width>]B<}>”. Campos
são escritos alinhados à direita a menos que a largura seja negativa que
nessa caso será usado o alinhamento à esquerda. OS seguintes I<field>s são
reconhecidos mas não estão necessariamente disponíveis no ficheiro de estado
(apenas campos internos ou campos guardados no pacote binário ficam lá):

=over 

=item B<Architecture>

=item B<Bugs>

=item B<Conffiles> (interno)

=item B<Config-Version> (interno)

=item B<Conflicts>

=item B<Breaks>

=item B<Depends>

=item B<Description>

=item B<Enhances>

=item B<Protected>

=item B<Essential>

=item B<Filename> (interno, relacionado com front-end)

=item B<Homepage>

=item B<Installed-Size>

=item B<MD5sum> (interno, relacionado com front-end)

=item B<MSDOS-Filename> (interno, relacionado com front-end)

=item B<Maintainer>

=item B<Origin>

=item B<Package>

=item B<Pre-Depends>

=item B<Priority>

=item B<Provides>

=item B<Recommends>

=item B<Replaces>

=item B<Revision> (obsoleto)

=item B<Section>

=item B<Size> (interno, relacionado com front-end)

=item B<Source>

=item B<Status> (interno)

=item B<Suggests>

=item B<Tag> (geralmente não em .deb mas em ficheiros Packages do repositório)

=item B<Triggers-Awaited> (interno)

=item B<Triggers-Pending> (interno)

=item B<Version>

=back

Os seguintes são campos virtuais,m gerados pelo B<dpkg-query> a partir de
valores de outros campos (note que estes não usam nomes válidos para campos
em ficheiros de controle):

=over 

=item B<binary:Package>

Contém o nome do pacote binário com um possível qualificador de arquitectura
como “libc6:amd64” (desde dpkg 1.16.2). Um qualificador de arquitectura irá
estar presente para tornar o nome do pacote não-ambiguo, por exemplo se o
pacote tem um campo B<Multi-Arch> com um valor de B<same> ou o pacote é de
uma arquitectura alienígena.

=item B<binary:Synopsis>

Contém a descrição curta do pacote (desde dpkg 1.19.1).

=item B<binary:Summary>

Isto é um alias para B<binary:Synopsis> (desde dpkg 1.16.2).

=item B<db:Status-Abbrev>

Contem o estado do pacote abreviado (em três caracteres), tais como “ii ” ou
“iHR” (desde dpkg 1.16.2). Veja a descrição do comando B<--list> para mais
detalhes.

=item B<db:Status-Want>

Contém o estado desejado do pacote, parte do campo Status (desde dpkg
1.17.11).

=item B<db:Status-Status>

Contém a palavra de estado do pacote, parte do campo Status (desde dpkg
1.17.11).

=item B<db:Status-Eflag>

Contém a flag de erro do estado do pacote, parte do campo Status (desde dpkg
1.17.11).

=item B<db-fsys:Files>

Contém a lista de entradas se sistemas de ficheiros do pacote separadas por
novas linhas (desde dpkg 1.19.3).

=item B<db-fsys:Last-Modified>

Contém a marca temporal em segundos da última vez que as entradas de
sistemas de ficheiros do pacote foram modificadas (desde dpkg 1.19.3).

=item B<source:Package>

Contém o nome do pacote fonte para este pacote binário (desde o dpkg
1.16.2).

=item B<source:Version>

Contém a versão de pacote fonte para este pacote binário (desde o dpkg
1.16.2).

=item B<source:Upstream-Version>

Contém a versão do autor do pacote fonte para este pacote binário (desde
dpkg 1.18.16).

=back

A string do formato predefinida é “B<${binary:Package}\t${Version}\n>”. Na
realidade, todos os outros campos encontrados no ficheiro de estado (isto é,
campos definidos pelo utilizador) podem ser também requisitados. Eles irão
ser escritos tal como estão,  too. They will be printed as-is, não obstante,
nenhuma conversão ou verificação de erros é feita neles. Para obter o nome
do maintainer do B<dpkg> e da versão instalada, você pode correr:

=over 

 dpkg-query -f='${binary:Package} ${Version}\t${Maintainer}\n' \
  -W dpkg

=back

=back

=head1 ESTADO À SAÍDA

=over 

=item B<0>

A pesquisa requisitada foi executada com sucesso.

=item B<1>

A pesquisa requisitada falhou seja total ou parcialmente, devido a nenhum
ficheiro ou pacote ter sido encontrado (excepto para B<--control-path>,
B<--control-list> e B<--control-show> onde tais erros são fatais).

=item B<2>

Erro fatal ou irrecuperável devido a utilização de linha de comandos
inválida, ou interações com o sistema, tais como acesso à base de dados,
alocações de memória, etc.

=back

=head1 AMBIENTE

=head2 Ambiente externo

=over 

=item B<SHELL>

Define o programa a executar quando multiplica um comando via shell (desde
dpkg 1.19.2).

=item B<PAGER>

=item B<DPKG_PAGER>

Define o comando paginador a usar (desde dpkg 1.19.1), o qual ir+a ser
executado com «B<$SHELL -c>».  Se B<SHELL> não estiver definido, «B<sh>» irá
ser usado em vez dele. O B<DPKG_PAGER> sobrepõe a variável de ambiente
B<PAGER> (desde dpkg 1.19.2).

=item B<DPKG_ADMINDIR>

Se definido e a opção B<--admindir> não for especificada, será usado como o
directório de dados do B<dpkg>.

=item B<DPKG_COLORS>

Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
são: B<auto> (predefinido), B<always> e B<never>.

=back

=head2 Ambiente interno

=over 

=item B<LESS>

Definido pelo B<dpkg-query> para “B<-FRSXMQ>”, se não já definido, quando
gera um paginador (desde dpkg 1.19.2). Para mudar o comportamento
predefinido, esta variável pode ser pré-ajustada para qualquer outro valor
incluindo uma string vazia, ou as variáveis B<PAGER> ou B<DPKG_PAGER> pode
ser definidas para desactivar opções específicas com «B<-+>», por exemplo
B<DPKG_PAGER="less -+F">.

=back

=head1 VEJA TAMBÉM

B<dpkg>(1).


=head1 TRADUÇÃO

Américo Monteiro

Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro <a_monteiro@gmx.com>.