APT(8)

NOME
apt - interface de linha de comandos

SINOPSE

apt [-h] [-o=config_string] [-c=ficheiro_de_configuração] [-t=lançamento-alvo] [-a=arquitectura] {list | search | show | update | install pkg [{=número_de_versão_do_pacote | /lançamento-alvo}]... | remove pkg... | upgrade | full-upgrade | edit-sources | {-v | --version} | {-h | --help}}

DESCRIÇÃO

O apt disponibiliza uma interface de linha de comandos de alto nível para o sistema de gestão de pacotes. Destina-se a ser uma interface para utilizador final e dispõe algumas opções mais apropriadas para utilização interactiva por predefinição em comparação com ferramentas especializadas do APT como o apt-get(8) e o apt-cache(8).

Muito como o próprio apt, o seu manual destina-se a ser uma interface de utilizador final e como tal apenas menciona os comandos mais usados e parte das opções para não duplicar informação em múltiplos locais e em parte para evitar saturar os leitores com uma cornucópia de opções e detalhes.

update apt-get
    update é usado para descarregar informação de pacotes de todas as fontes configuradas. Outros comandos operam com estes dados para , por ex, executar actualizações de pacotes ou procurar e mostrar detalhes acerta de todos os pacotes disponíveis para instalação.

upgrade apt-get
    upgrade é usado para instalar actualizações disponíveis de todos os pacotes actualmente instalados no sistema a partir das fontes configuradas via sources.list(5). Se necessário para satisfazer dependências serão instalados novos pacotes, mas pacotes existentes nunca serão removidos. Se a actualização de um pacote necessitar da remoção de um pacote instalado, a actualização deste pacote não será executada.

    Quando um pacote é fornecido como um argumento, o pacote será instalado antes da acção de actualização.

full-upgrade apt-get
    full-upgrade executa a função de upgrade mas irá remover pacotes actualmente instalados se tal for necessário para actualizar o sistema como um todo.

    Quando um pacote é fornecido como um argumento, o pacote será instalado antes da acção de actualização.

install, reinstall, remove, purge apt-get
    Executa a acção requisitada em um ou mais pacotes especificados via regex(7), glob(7) ou por correspondência exacta. A acção requisitada pode ser sobreposta para pacotes específicos ao acrescentar um mais (+) ao nome do pacote para instalar esse pacote ou um menos (-) para o remover.

    Pode ser selecionada para instalação uma versão específica de um pacote ao adicionar ao nome do pacote o símbolo igual (=) e a versão do pacote a selecionar. Alternativamente a versão de um lançamento específico pode ser selecionada ao adicionar ao nome do pacote uma barra de divisão (/) e o nome de código (trixie, forky, sid ...) ou o nome de suite (stable, testing, unstable). Isto irá também selecionar versões a partir deste lançamento para as dependências deste pacote se necessário para satisfazer o pedido.

    Remover um pacote remove todos os dados empacotados, mas deixa ficar ficheiros (modificados) de configuração do utilizador geralmente pequenos, para o caso da remoção ter sido um acidente. Apenas fazer um pedido de instalação para o pacote removido acidentalmente irá restaurar a sua função como estava anteriormente. Por outro lado você pode ver-se livre desses restos ao chamar purge mesmo em pacotes já removidos. Note que isto não afecta nenhuns dados ou configurações armazenados no seu directório home pessoal.

autoremove apt-get
    autoremove é usado para remover pacotes que foram instalados automaticamente para satisfazer dependências de outros pacotes e que já não são necessários porque as dependências alteraram ou porque os pacotes que precisavam delas foram entretanto removidos.

    Você deve verificar que a lista não inclua aplicações de que passou a gostar apesar de terem sido instaladas apenas como uma dependência de outro pacote. Você pode marcar tal pacote como instalado manualmente ao usar apt-mark(8). Os pacotes que você instalou explicitamente via comando install também nunca são propostos para remoção automática.

satisfy apt-get
    satisfy satisfaz strings de dependências, como usado em Build-Depends. Também lida com conflitos, ao prefixar um argumento com "Conflicts: ".

    Exemplo: apt satisfy "foo, bar (>= 1.0)" "Conflicts: baz, fuzz"

why, why-not
    Estes comandos escrevem o caminho raciocinado pelo solucionador. Eles são semelhantes aos comandos do aptitude equivalentes para muitos casos de utilização, mas são diferentes em que escrevem a razão atual que o solucionador apanhou em vez do caminho potencialmente mais forte.

    O comando why determina porque um pacote instalado está instalado. Isto fornece um retorno razoável sobre o porquê de um pacote instalado automaticamente foi instalado; para um pacote instalado manualmente nenhuma outra razão é dada. Se o pacote não estiver instalado, nenhuma razão pode ser determinada.

    O comando why-not determina porquê um pacote for determinado como não instalável. Isto pode nem sempre produzir um resultado, mesmo se um pacote não for mesmo instalável.

    Ambos comandos recebem um único argumento, o nome de um pacote.

search (apt-cache(8))
    search pode ser usado para procurar por termo(s) regex(7) fornecidos na lista de pacotes disponíveis e apresentar correspondências. Isto pode, por exemplo, ser útil se procura pacotes com uma característica específica. Se está à procura de um pacote que inclua um ficheiro específico tente o apt-file(1).

show (apt-cache(8))
    Mostra informação acerca do(s) pacote(s) indicados incluindo as suas dependências, tamanho de instalação e de download, fontes a partir das quais o pacote está disponível, a descrição do conteúdo dos pacotes e muito mais. Pode, por exemplo, ser útil para ver esta informação antes de permitir ao apt(8) remover um pacote ou enquanto procura por novos pacotes para instalar.

list
    list é de certa maneira semelhante a dpkg-query --list pois pode mostrar uma lista de pacotes que satisfaçam certos critérios. Suporta padrões glob(7) para coincidir com nomes de pacotes, apt-patterns(7), assim como opções para listar instalados (--installed), actualizáveis (--upgradeable) ou todas as versões disponíveis (--all-versions).

edit-sources (work-in-progress)
    edit-sources permite-lhe editar os seus ficheiros sources.list(5) no seu editor de texto preferido enquanto também disponibiliza verificações básicas aos mesmos.

showsrc, depends, rdepends, policy (resumido em apt-cache(8))

source, build-dep, download, changelog, clean, distclean, autoclean (resumido em apt-get(8))

UTILIZAÇÃO DE SCRIPTS E DIFERENÇAS COM OUTRAS FERRAMENTAS DO APT

A linha de comandos do apt(8) foi desenhada como ferramenta de utilizador final e pode variar o comportamento entre versões. Apesar de tentar não perder a compatibilidade com versões anteriores isto não é garantido se uma alteração parecer benéfica para uso interactivo.

Todas as funcionalidades do apt(8) estão também disponíveis em ferramentas dedicadas ao APT como apt-get(8) e apt-cache(8). O apt(8) apenas varia o valor predefinido de algumas opções (veja apt.conf(5) e especialmente o âmbito Binário). Portanto você deverá preferir usar estes comandos (potencialmente com algumas opções adicionais activas) nos seus scripts pois eles mantêm compatibilidade com versões anteriores sempre que possível.

OPÇÕES

Todas as opções de linha de comandos podem ser definidas usando o ficheiro de configuração, as descrições indicam a opção de configuração a definir. Para opções booleanas você pode sobre por o ficheiro de configuração usando algo como -f-,--no-f, -f=no ou várias outras variantes.

-h, --help
    Mostra um sumário curto da utilização.

-v, --version
    Mostra a versão do programa.

--audit
    -Mostra mensagens audit (e notificações). Isto sobrepõe a opção quiet, mas apenas para mensagens de notificação, não as de progresso.

-c, --config-file
    Ficheiro de Configuração; Especifica o ficheiro de configuração a usar. O programa irá ler o ficheiro de configuração predefinido e depois este ficheiro de configuração. Se as definições de configuração precisarem de ser definidas antes, os ficheiros de configuração predefinidos são analisados especificando um ficheiro com a variável de ambiente APT_CONFIG. Veja apt.conf(5) para informação de sintaxe.

-o, --option
    Define uma Opção de Configuração; Isto irá definir uma opção de configuração arbitrária. A sintaxe é -o Foo::Bar=bar. -o e --option podem ser usadas várias vezes para definir opções diferentes.

--cli-version
    Requests a specific CLI version. This is a pattern that takes a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest supported minor level will be used.

    Version tracks are presented as follows: The version 3.2 has equivalent versions 0.32, 1.22, and 2.12, implementing new features for their specified major versions.

    A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0, but 2.10 follows directly on 2.8; given that we use odd version numbers as development series (2.9 is the 3.0 development series).

    This feature has been introduced in APT 3.1.10, and replaces the binary-specific configuration. You may use the APT::Version to similar effect on older binaries, for example, use -o APT::Version=2 to make apt(8) behave like the 2.x series.

    The default value is the current APT version for apt(8) and 0.(10 * major + minor) for the classic commands. The 0.X series is soft-deprecated and the other commands will roll over to the 2.x series in the future.

--no-color, --color
    Liga e desliga cores. As cores estão ligadas por predefinição nos terminais suportados para apt(8) e também podem ser desactivadas usando as variáveis de ambiente NO_COLOR ou APT_NO_COLOR, ou também configuradas pela opção de configuração e escopo APT::Color, veja apt.conf(5) para informação sobre isso.

VEJA TAMBÉM

apt-get(8), apt-cache(8), sources.list(5), apt.conf(5), apt-config(8), apt-patterns(7), O guia de utilizadores do The APT em /usr/share/doc/apt-doc/, apt_preferences(5), o Howto do APT.

DIAGNÓSTICO

apt devolve zero na operação normal, 100 decimal em erro.

BUGS

página de bugs do APT[1]. Se deseja reportar um bug no APT, por favor veja /usr/share/doc/debian/bug-reporting.txt ou o comando reportbug(1).

TRADUÇÃO

A tradução Portuguesa foi feita por Américo Monteiro <a_monteiro@netcabo.pt> de 2009 a 2012. A tradução foi revista pela equipa de traduções portuguesas da Debian <traduz@debianpt.org>.

Note que este documento traduzido pode conter partes não traduzidas. Isto é feito propositadamente, para evitar perdas de conteúdo quando a tradução está atrasada relativamente ao conteúdo original.

AUTOR

Equipa do APT

NOTAS

1.  página de bugs do APT
    https://bugs.debian.org/src:apt