Nome
apt-get – utilitário de manipulação de pacotes APT – interface de linha de comando
Synopsis
apt-get command
Descrição
apt-get é a ferramenta de linha de comando para manipulação de pacotes, e pode ser considerado o “back-end” do utilizador para outras ferramentas usando a biblioteca APT. Existem várias interfaces “front-end”, tais como synaptic e aptitude.
Comandos
A menos que a opção -h, ou –help seja dada, um dos comandos abaixo deve estar presente. update Usado para re-sincronizar os ficheiros de índice de pacotes a partir das suas fontes. Os índices dos pacotes disponíveis são obtidos a partir da(s) localização(ões) especificada(s) em/etc/apt/sources.list(5). Uma actualização deve ser sempre realizada antes de uma actualização ou dist-upgrade. upgrade Usado para instalar as versões mais recentes de todos os pacotes actualmente instalados no sistema a partir das fontes enumeradas em /etc/apt/sources.list(5).Pacotes actualmente instalados com novas versões disponíveis são recuperados e actualizados; em nenhuma circunstância são removidos pacotes actualmente instalados, nem são recuperados e instalados pacotes que ainda não estejam instalados. Novas versões de pacotes actualmente instalados que não podem ser actualizados sem alterar o estado de instalação de outro pacote serão deixados na sua versão actual. Uma actualização deve ser executada primeiro para que o apt-get saiba que novas versões de pacotes estão disponíveis. dist-upgrade Além de executar a função de actualização, esta opção também lida inteligentemente com a alteração de dependências com novas versões de pacotes;o apt-get tem um sistema “inteligente” de resolução de conflitos, e tentará actualizar os pacotes mais importantes à custa de pacotes menos importantes, se necessário. O ficheiro /etc/apt/sources.list(5) contém uma lista de locais a partir dos quais se podem obter os ficheiros de pacotes desejados. Ver também apt_preferences(5) para um mecanismo de sobreposição das configurações gerais para pacotes individuais. instalar pkg(s) Esta opção é seguida por um ou mais pacotes desejados para instalação. Cada pacote é um nome de pacote, não um nome de ficheiro totalmente qualificado (por exemplo, no sistema Fedora Core, glibc seria o argumento fornecido, não glibc-2.4.8.i686.rpm). Todos os pacotes requeridos pelo(s) pacote(s) especificado(s) para instalação também serão recuperados e instalados. O ficheiro /etc/apt/sources.list(5) é utilizado para localizar os repositórios para os pacotes desejados. Se um hífen (-) for anexado ao nome do pacote (sem espaço de intervenção), o pacote identificado será removido se estiver actualmente instalado. Da mesma forma, um sinal de mais (+)pode ser utilizado para designar um pacote a instalar. Estas últimas características podem ser utilizadas para anular decisões tomadas pelo sistema de resolução de conflitos do apt-get. Uma versão específica de um pacote pode ser seleccionada para instalação, seguindo o nome do pacote com um igual (=) e a versão do pacote a seleccionar. Isto fará com que essa versão seja localizada e seleccionada para instalação. Alternativamente, uma distribuição específica pode ser seleccionada seguindo o nome do pacote com uma barra (/) e a versão da distribuição ou o nome do Arquivo (isto é, estável, testing, instável). Ambos os mecanismos de selecção de versão podem baixar os pacotes e devem ser usados com cuidado. Finalmente, o mecanismo apt_preferences(5) permite criar uma política de instalação alternativa para pacotes individuais. Se nenhum pacote corresponder à expressão dada e a expressão contiver uma de “.”, “?” ou “*”, então presume-se ser uma expressão regular POSIX, e é aplicada a todos os nomes de pacotes na base de dados. Quaisquer correspondências são então instaladas (ou removidas). Note-se que a correspondência é feita por substrato, pelo que “lo.*” corresponde a “how-lo” e “lowest”. Se isto não for desejado, ancorar a expressão regular com um caracter “^” ou “$”, ou criar uma expressão regular mais específica. remover pkg(s) Idêntico a instalar excepto que os pacotes são removidos em vez de instalados. Se um sinal de mais (+) for anexado ao nome do pacote (sem espaço de intervenção), o pacote identificado será instalado em vez de removido. source source_pkg Causes apt-get to get get source packages. O APT examinará os pacotes disponíveis para decidir qual o pacote-fonte a ir buscar. Encontrará então e descarregará no directório actual a versão mais recente disponível desse pacote-fonte. Os pacotes-fonte são rastreados separadamente dos pacotes binários de linhas do tipo viarpm-src no ficheiro sources.list(5). Isto provavelmente significará que não obterá a mesma fonte que o pacote que instalou, ou que poderá instalar. Se as opções –compile forem especificadas então o pacote será compilado para um binário usando rpmbuild, se –download-onlyis especificado então o pacote fonte não será descompactado. Uma versão fonte específica pode ser recuperada seguindo o nome da fonte com um igual (=) e depois a versão a buscar, semelhante ao mecanismo utilizado para os ficheiros do pacote. Isto permite uma correspondência exacta entre o nome do pacote-fonte e a versão, permitindo implicitamente a opção APT::Get::Only-Source. Note que os pacotes-fonte não são rastreados como os pacotes binários, eles existem apenas no directório actual e são semelhantes às bolas de alcatrão de origem. build-dep source_pkg Faz com que o apt-get instale/remova pacotes numa tentativa de satisfazer as dependências de compilação de um pacote-fonte. check Diagnostic tool; actualiza a cache de pacotes e verifica se existem dependências quebradas. clean Limpa o repositório local dos ficheiros de pacotes recuperados. Remove tudo menos o ficheiro de bloqueio de /var/cache/apt/archives/ and/orvar/cache/apt/archives/partial/. autoclean Como clean, autoclean limpa o repositório local dos ficheiros de pacotes recuperados. A diferença é que apenas remove ficheiros de pacotes que já não podem ser descarregados, e que são em grande parte inúteis. Isto permite que uma cache seja mantida durante um longo período de tempo sem que ela fique fora de controlo. A opção de configuração APT::Clean-Installed impedirá que os pacotes instalados sejam apagados se for activada.
Opções
Todas as opções de linha de comando 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 pode sobrepor-se ao ficheiro de configuração usando algo como -f-, –no-f, -f=no ou várias outras variações.
-d, –download-only Download only; os ficheiros de pacotes são apenas recuperados, não desempacotados ou instalados. Item de configuração: APT::Get::Download-Only. -f, –fix-broken Fix. Tentativa de corrigir um sistema com dependências quebradas no local. Esta opção, quando utilizada com instalar/remover, pode omitir quaisquer pacotes para permitir ao APT todeduce uma solução provável. Qualquer pacote(s) especificado(s) deve(m) corrigir completamente o problema. Esta opção é por vezes necessária ao executar o APT pela primeira vez; o próprio APT não permite a existência de dependências de pacotes quebrados num sistema. É possível que a estrutura de dependência de um sistema possa ser tão corrupta que exija intervenção manual. A utilização desta opção juntamente com -m pode produzir um erro em algumas situações. Item de configuração: APT::Get::Fix-Broken. -m, –ignore-missing, –fix-missing Ignorar pacotes em falta. Se os pacotes não puderem ser recuperados ou falharem a verificação de integridade após a recuperação (ficheiros de pacotes corrompidos), retenha esses pacotes e trate do resultado. A utilização desta opção juntamente com -f pode produzir um erro em algumas situações. Se um pacote for seleccionado para instalação (particularmente se for mencionado na linha de comando) e não puder ser descarregado, então será silenciosamente retido. Item de configuração: APT::Get::Fix-Missing.–no-download Desactiva o download de pacotes. Isto é melhor usado com –ignore-missing para forçar o APT a usar apenas os rpms que já descarregou. Item de configuração: APT::Obter::Descarregar. -q, –quiet Quiet Quiet. Produz resultados adequados para o registo, omitindo indicadores de progresso. Mais q’s produzirão mais silenciosos, até um máximo de dois. Pode também usar-q=# para definir o nível de silêncio, anulando o ficheiro de configuração. Note que o nível silencioso 2 implica -y, nunca se deve usar -qq sem modificador de acção ano, como -d, –print-uris ou -s, pois o APT pode decidir fazer algo que não esperava. Item de configuração: silencioso. -s, –simular, –just-print, –dry-run, –recon, –no-act Sem acção. Efectuar uma simulação de eventos que ocorreriam mas que não alteram realmente o sistema. Item de configuração: APT::Obter::Simular.Simular imprime uma série de linhas, cada uma representando uma operação rpm: Configurar (Conf), Remover (Remv), Desembalar (Inst). Parênteses rectos indicam pacotes quebrados com um conjunto vazio de parênteses rectos, o que significa que quebrar não tem qualquer consequência (raro). -y, –yes, –assume-yes Sim automático para avisos. Assumir “sim” como resposta a todos os avisos e correr não-interactivamente. Se ocorrer uma situação indesejável, tal como mudar um pacote retido ou remover um pacote essencial, então apt-get irá abortar. Item de configuração: APT::Get::Assume-Yes. -u, –show-upgradeed Mostrar pacotes actualizados. Imprimir uma lista de todos os pacotes que devem ser actualizados. Item de Configuração: APT::Obter::Show-Upgradeed. -V, –verbose-versões Mostrar versões completas para pacotes actualizados e instalados. Item de Configuração: APT::Obter::Mostrar-Versões. -b, –compile, –build Compile pacotes fonte depois de os descarregar. Item de Configuração: APT::Obter::Compile.–ignore-hold Ignorar pacotes Detentores de pacotes. Isto faz com que o apt-get ignore uma retenção colocada sobre um pacote. Isto pode ser útil em conjunto com dist-upgrade para anular o número de retenções não desejadas. Item de configuração: APT::Ignore-Hold.–no-upgrade Não actualize pacotes. Quando usado em conjunto com a instalação, a não actualização impedirá que os pacotes listados sejam actualizados se já estiverem instalados. Item de Configuração: APT::Get::Upgrade.–force-yes Force sim. Esta é uma opção perigosa que irá fazer com que o apt-get continue sem ser solicitado se estiver a fazer algo potencialmente prejudicial. Não deve ser usada excepto em situações muito especiais. Usar –force-yes pode potencialmente destruir o seu sistema! Item de configuração: APT::Get::force-yes.–print-uris Em vez de ir buscar os ficheiros para instalar, os seus URIs são impressos. Cada URI terá o caminho, o nome do ficheiro de destino, o tamanho e o md5hash esperado. Note-se que o nome do ficheiro a escrever nem sempre corresponde ao nome do ficheiro no local remoto! Isto também funciona com os comandos de origem e de actualização. Quando utilizado com o comando de actualização, o MD5 e o tamanho não estão incluídos, e cabe ao utilizador descomprimir quaisquer ficheiros comprimidos. Item de configuração: APT::Get::Print-URIs.–reinstall Re-Install pacotes que já estão instalados e na versão mais recente. Item de Configuração: APT::Get::ReInstall.–list-cleanup Esta opção por defeito liga, utiliza –no-list-cleanup para o desligar. Quando ligado, o apt-get irá gerir automaticamente o conteúdo de/var/lib/apt/lists para assegurar que os ficheiros obsoletos são apagados. A única razão para o desligar é se alterar frequentemente a sua lista de fontes. Item de configuração: APT::Get::List-Cleanup. -t, –target-release, –default-release Esta opção controla a entrada padrão para o motor de políticas. Cria um pino predefinido com prioridade 990, utilizando a cadeia de liberação especificada. O ficheiro de preferências pode ainda sobrepor-se a esta definição. Em suma, esta opção permite ter um controlo simples sobre quais os pacotes de distribuição que serão recuperados. Alguns exemplos comuns podem ser -t ‘2.1*’ ou -t instáveis. Item de configuração: APT::Default-Release; ver também a página do manual apt_preferences(5). –somente triviais Realizar apenas operações que sejam “triviais”. Logicamente, isto pode ser considerado relacionado com –assume-yes. Onde –assume-yes responderá sim a qualquer pergunta, –trivial-only responderá não. Item de configuração: fIAPT::Get::Trivial-Only.–no-remove Se algum pacote tiver de ser removido, apt-get abortar imediatamente sem aviso prévio. Item de Configuração: APT::Get::Remove.–only-sonly-source Apenas tem significado para o comando source. Indica que os nomes das fontes dadas não devem ser mapeados através da tabela binária. Isto significa que se esta opção for especificada, o comando source só aceitará os nomes dos pacotes fonte como argumentos, em vez de aceitar nomes de pacotes binários e procurar o pacote fonte correspondente. Item de configuração: APT::Get::Only-Source. -h, –help Mostra um breve resumo de utilização. -v, –version Mostrar a versão do programa. -c, –config-file Configuration File. Especificar um ficheiro de configuração a utilizar. O programa lerá o ficheiro de configuração padrão e depois este ficheiro de configuração. Seeapt.conf(5) para informação sintáctica. -o, –opção Definir uma opção de configuração. Isto irá definir uma opção de configuração arbitrária. A sintaxe é -o Foo::Bar=bar.
Arquivos
/etc/apt/sources.list Locais de onde ir buscar os pacotes. Item de configuração: Dir::Etc::SourceList./etc/apt/apt.conf Ficheiro de configuração do APT. Item de configuração: Dir::Etc::Main./etc/apt/apt.conf.d/ fragmentos de ficheiro de configuração APT. Item de configuração: Dir::Etc::Parts./etc/apt/preferências Ficheiro de preferências de versão. É aqui que se especifica “pinning”, ou seja, uma preferência para obter certos pacotes de uma fonte separada ou de uma versão diferente de uma distribuição. Item de configuração: Dir::Etc::Preferences./var/cache/apt/archives/ Storage area for retrieved package files. Item de Configuração: Dir::Cache::Arquivos./var/cache/apt/archives/partial/ Área de armazenamento para ficheiros de pacotes em trânsito. Item de configuração: Dir::Cache::Archives (implicit partial)./var/lib/apt/lists/ Área de armazenamento para informação de estado para cada recurso de pacote especificado em sources.list(5). Item de configuração: Dir::State::Lists./var/lib/apt/lists/partial/ Área de armazenamento para informação de estado em trânsito. Item de configuração: Dir::Estado::Listas (parcial implícita).
Ver Também
apt-cache(8), apt-cdrom(8), sources.list(5),apt.conf(5),
apt-config(8), apt_preferences(5)
Diagnostics
apt-get retorna zero no funcionamento normal, decimal 100 no erro.
Buggs
Relatar bugs no APT-RPM é melhor feito na mailinglist do APT-RPM emhttp://apt-rpm.org/mailinglist.shtml,
Autor
Informação do mantenedor e contribuinte pode ser encontrada na página de créditoshttp://apt-rpm.org/about.shtml do APT-RPM.