APT(8) APT APT(8) NOME apt - interface de linha de comandos SINOPSE apt [-h] [-o=config_string] [-c=ficheiro_de_configuracao] [-t=lancamento-alvo] [-a=arquitectura] {list | search | show | update | install pkg [{=numero_de_versao_do_pacote | /lancamento-alvo}]... | remove pkg... | upgrade | full-upgrade | edit-sources | {-v | --version} | {-h | --help}} DESCRICAO O apt disponibiliza uma interface de linha de comandos de alto nivel para o sistema de gestao de pacotes. Destina-se a ser uma interface para utilizador final e dispoe algumas opcoes mais apropriadas para utilizacao interativa por predefinicao em comparacao com ferramentas especializadas do APT como o apt-get(8) e o apt-cache(8). Muito como o proprio 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 opcoes para nao duplicar informacao em multiplos locais e em parte para evitar saturar os leitores com uma cornucopia de opcoes e detalhes. update apt-get update e usado para descarregar informacao de pacotes de todas as fontes configuradas. Outros comandos operam com estes dados para , por ex, executar actualizacoes de pacotes ou procurar e mostrar detalhes acerta de todos os pacotes disponiveis para instalacao. upgrade apt-get upgrade e usado para instalar actualizacoes disponiveis de todos os pacotes actualmente instalados no sistema a partir das fontes configuradas via sources.list(5). Se necessario para satisfazer dependencias serao instalados novos pacotes, mas pacotes existentes nunca serao removidos. Se a actualizacao de um pacote necessitar da remocao de um pacote instalado, a actualizacao deste pacote nao sera executada. Quando um pacote e fornecido como um argumento, o pacote sera instalado antes da accao de actualizacao. full-upgrade apt-get full-upgrade executa a funcao de upgrade mas ira remover pacotes actualmente instalados se tal for necessario para actualizar o sistema como um todo. Quando um pacote e fornecido como um argumento, o pacote sera instalado antes da accao de actualizacao. install, reinstall, remove, purge apt-get Executa a accao requisitada em um ou mais pacotes especificados via regex(7), glob(7) ou por correspondencia exacta. A accao requisitada pode ser sobreposta para pacotes especificos ao acrescentar um mais (+) ao nome do pacote para instalar esse pacote ou um menos (-) para o remover. Pode ser selecionada para instalacao uma versao especifica de um pacote ao adicionar ao nome do pacote o simbolo igual (=) e a versao do pacote a selecionar. Alternativamente a versao de um lancamento especifico pode ser selecionada ao adicionar ao nome do pacote uma barra de divisao (/) e o nome de codigo (trixie, forky, sid ...) ou o nome de suite (stable, testing, unstable). Isto ira tambem selecionar versoes a partir deste lancamento para as dependencias deste pacote se necessario para satisfazer o pedido. Remover um pacote remove todos os dados empacotados, mas deixa ficar ficheiros (modificados) de configuracao do utilizador geralmente pequenos, para o caso da remocao ter sido um acidente. Apenas fazer um pedido de instalacao para o pacote removido acidentalmente ira restaurar a sua funcao como estava anteriormente. Por outro lado voce pode ver-se livre desses restos ao chamar purge mesmo em pacotes ja removidos. Note que isto nao afecta nenhuns dados ou configuracoes armazenados no seu directorio home pessoal. autoremove apt-get autoremove e usado para remover pacotes que foram instalados automaticamente para satisfazer dependencias de outros pacotes e que ja nao sao necessarios porque as dependencias alteraram ou porque os pacotes que precisavam delas foram entretanto removidos. Voce deve verificar que a lista nao inclua aplicacoes de que passou a gostar apesar de terem sido instaladas apenas como uma dependencia de outro pacote. Voce pode marcar tal pacote como instalado manualmente ao usar apt-mark(8). Os pacotes que voce instalou explicitamente via comando install tambem nunca sao propostos para remocao automatica. satisfy apt-get satisfy satisfaz strings de dependencias, como usado em Build-Depends. Tambem 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 sao semelhantes aos comandos do aptitude equivalentes para muitos casos de utilizacao, mas sao diferentes em que escrevem a razao atual que o solucionador apanhou em vez do caminho potencialmente mais forte. O comando why determina porque um pacote instalado esta instalado. Isto fornece um retorno razoavel sobre o porque de um pacote instalado automaticamente foi instalado; para um pacote instalado manualmente nenhuma outra razao e dada. Se o pacote nao estiver instalado, nenhuma razao pode ser determinada. O comando why-not determina porque um pacote for determinado como nao instalavel. Isto pode nem sempre produzir um resultado, mesmo se um pacote nao for mesmo instalavel. Ambos comandos recebem um unico 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 disponiveis e apresentar correspondencias. Isto pode, por exemplo, ser util se procura pacotes com uma caracteristica especifica. Se esta a procura de um pacote que inclua um ficheiro especifico tente o apt-file(1). show (apt-cache(8)) Mostra informacao acerca do(s) pacote(s) indicados incluindo as suas dependencias, tamanho de instalacao e de download, fontes a partir das quais o pacote esta disponivel, a descricao do conteudo dos pacotes e muito mais. Pode, por exemplo, ser util para ver esta informacao antes de permitir ao apt(8) remover um pacote ou enquanto procura por novos pacotes para instalar. list list e de certa maneira semelhante a dpkg-query --list pois pode mostrar uma lista de pacotes que satisfacam certos criterios. Suporta padroes glob(7) para coincidir com nomes de pacotes, apt- patterns(7), assim como opcoes para listar instalados (--installed), atualizaveis (--upgradeable) ou todas as versoes disponiveis (--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 tambem disponibiliza verificacoes basicas aos mesmos. showsrc, depends, rdepends, policy (resumido em apt-cache(8)) source, build-dep, download, changelog, clean, distclean, autoclean (resumido em apt-get(8)) UTILIZACAO DE SCRIPTS E DIFERENCAS 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 versoes. Apesar de tentar nao perder a compatibilidade com versoes anteriores isto nao e garantido se uma alteracao parecer benefica para uso interativo. Todas as funcionalidades do apt(8) estao tambem disponiveis em ferramentas dedicadas ao APT como apt-get(8) e apt-cache(8). O apt(8) apenas varia o valor predefinido de algumas opcoes (veja apt.conf(5) e especialmente o ambito Binario). Portanto voce devera preferir usar estes comandos (potencialmente com algumas opcoes adicionais ativas) nos seus scripts pois eles mantem compatibilidade com versoes anteriores sempre que possivel. OPCOES Todas as opcoes de linha de comandos podem ser definidas usando o ficheiro de configuracao, as descricoes indicam a opcao de configuracao a definir. Para opcoes booleanas voce pode sobre por o ficheiro de configuracao usando algo como -f-,--no-f, -f=no ou varias outras variantes. -h, --help Mostra um sumario curto da utilizacao. -v, --version Mostra a versao do programa. --audit -Mostra mensagens audit (e notificacoes). Isto sobrepoe a opcao quiet, mas apenas para mensagens de notificacao, nao as de progresso. -c, --config-file Ficheiro de Configuracao; Especifica o ficheiro de configuracao a usar. O programa ira ler o ficheiro de configuracao predefinido e depois este ficheiro de configuracao. Se as definicoes de configuracao precisarem de ser definidas antes, os ficheiros de configuracao predefinidos sao analisados especificando um ficheiro com a variavel de ambiente APT_CONFIG. Veja apt.conf(5) para informacao de sintaxe. -o, --option Define uma Opcao de Configuracao; Isto ira definir uma opcao de configuracao arbitraria. A sintaxe e -o Foo::Bar=bar. -o e --option podem ser usadas varias vezes para definir opcoes diferentes. --cli-version Requisita uma versao CLI especifica. Isto e um padrao que recebe uma versao MAJOR.MINOR. Voce pode omitir a versao MINOR, que no caso sera usado o nivel menor suportado mais recente. Os rastreios de versao sao apresentados como se segue: A versao 3.2 tem versoes equivalentes 0.32, 1.22, e 2.12, que implementam novas funcionalidades para as suas versoes maiores especificadas. Um caso especial e o padrao de versao X.9: Uma versao tipo 2.9 e seguida por 3.0, mas 2.10 segue diretamente em 2.8; dado que nos usamos numeros de versao impar como serie de desenvolvimento (2.9 e a serie de desenvolvimento 3.0). Esta funcionalidade foi introduzida no APT 3.1.10, e substitui a configuracao especifica de binario. Voce pode usar o APT::Version para efeito semelhante em binarios mais antigos, por exemplo, -o APT::Version=2 para fazer o apt(8) comportar-se como a serie 2.x. O valor predefinido e a versao APT atual para apt(8)e 0.(10 * major + minor) para os comandos classicos. A serie 0.X e software descontinuado e os outros comandos irao rolar sobre a serie 2.x no futuro. --no-color, --color Liga e desliga cores. As cores estao ligadas por predefinicao nos terminais suportados para apt(8) e tambem podem ser desativadas usando as variaveis de ambiente NO_COLOR ou APT_NO_COLOR, ou tambem configuradas pela opcao de configuracao e escopo APT::Color, veja apt.conf(5) para informacao sobre isso. VEJA TAMBEM 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. DIAGNOSTICO apt devolve zero na operacao normal, 100 decimal em erro. BUGS pagina 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). TRADUCAO A traducao Portuguesa foi feita por Americo Monteiro de 2009 a 2012. A traducao foi revista pela equipa de traducoes portuguesas da Debian . Note que este documento traduzido pode conter partes nao traduzidas. Isto e feito propositadamente, para evitar perdas de conteudo quando a traducao esta atrasada relativamente ao conteudo original. AUTOR Equipa do APT NOTAS 1. pagina de bugs do APT https://bugs.debian.org/src:apt APT 3.3.3 07 Novembro 2025 APT(8)