PACMAN.CONF(5) Manual do pacman PACMAN.CONF(5) NOME pacman.conf - arquivo de configuracao do gerenciador de pacotes pacman SINOPSE /etc/pacman.conf DESCRICAO O pacman, usando libalpm(3), tentara ler pacman.conf cada vez que for chamado. Este arquivo de configuracao e dividido em secoes ou repositorios. Cada secao define um repositorio de pacotes que o pacman pode usar ao procurar pacotes no modo --sync. A excecao e a secao de opcoes, que define opcoes globais. Os comentarios sao suportados apenas comecando uma linha com cerquilha (#). Os comentarios nao podem comecar no meio de uma linha. EXEMPLO # # pacman.conf # [options] NoUpgrade = etc/passwd etc/group etc/shadow NoUpgrade = etc/fstab [core] Include = /etc/pacman.d/core [custom] Server = file:///home/pkgs Nota Cada diretiva deve estar em CamelCase, ou seja, as palavras sao unidas sem espacos e cada uma e iniciada com letra maiuscula. Se as letras maiusculas nao forem respeitadas, a diretiva nao sera reconhecida. Por exemplo, noupgrade ou NOUPGRADE nao vao funcionar. OPCOES RootDir = /caminho/para/diretorio/raiz Define o diretorio raiz padrao de instalacao para o pacman. Esta opcao e usada se voce deseja instalar um pacote em uma particao montada temporariamente "pertencente" a outro sistema ou para uma instalacao em chroot. NOTA: Se o caminho da base de dados ou o arquivo de log nao forem especificados na linha de comando ou no pacman.conf(5), seu local padrao estara dentro deste caminho raiz. DBPath = /caminho/para/diretorio/bd Substitui o local padrao do diretorio de topo de nivel da base de dados. O padrao e /var/lib/pacman/. A maioria dos usuarios nao precisara definir esta opcao. NOTA: se especificado, este e um caminho absoluto e o caminho raiz nao e prefixado automaticamente. CacheDir = /caminho/para/diretorio/cache Substitui o local padrao do diretorio de cache do pacote. O padrao e /var/cache/pacman/pkg/. Varios diretorios de cache podem ser especificados e sao tentados na ordem em que estao listados no arquivo de configuracao. Se um arquivo nao for encontrado em nenhum diretorio de cache, ele sera baixado no primeiro diretorio de cache com acesso de escrita. NOTA: este e um caminho absoluto, o caminho raiz nao e prefixado automaticamente. HootDir = /caminho/para/diretorio/hook Adiciona diretorios para procurar hooks do alpm, alem do diretorio de hooks do sistema (/usr/share/libalpm/hooks/). O padrao e /etc/pacman.d/hooks. Varios diretorios podem ser especificados com hooks em diretorios posteriores, tendo precedencia sobre hooks em diretorios anteriores. NOTA: este e um caminho absoluto, o caminho raiz nao e prefixado automaticamente. Para obter mais informacoes sobre os hooks do alpm, consulte alpm-hooks(5). GPGDir = /caminho/para/diretorio/gpg Substitui o local padrao do diretorio que contem os arquivos de configuracao do GnuPG. O padrao e /etc/pacman.d/gnupg/. Este diretorio deve conter dois arquivos: pubring.gpg e trustdb.gpg. pubring.gpg contem as chaves publicas de todos os empacotadores. trustdb.gpg contem uma base de dados chamada trust, que especifica que as chaves sao autenticas e confiaveis. NOTA: este e um caminho absoluto, o caminho raiz nao e anexado automaticamente. LogFile = /caminho/para/arquivo/log Substitui o local padrao do arquivo de log pacman. O padrao e /var/log/pacman.log. Este e um caminho absoluto e o diretorio raiz nao e prefixado. HoldPkg = pacote ... Se um usuario tentar remover um pacote que esta listado no HoldPkg, o pacman solicitara confirmacao antes de continuar. Padroes de glob no estilo shell sao permitidos. IgnorePkg = pacote ... Instrui o pacman a ignorar quaisquer atualizacoes para este pacote ao executar um --sysupgrade. Padroes de glob no estilo shell sao permitidos. IgnoreGroup = grupo ... Instrui o pacman a ignorar quaisquer atualizacoes para todos pacotes neste grupo ao executar um --sysupgrade. Padroes de glob no estilo shell sao permitidos. Include = /caminho/para/arquivo/configuracao Inclui outro arquivo de configuracao. Este arquivo pode incluir repositorios ou opcoes gerais de configuracao. Os curingas nos caminhos especificados serao expandidos com base nas regras de glob(7). Architecture = auto &| i686 &| x86_64 | ... Se definido, o pacman permitira apenas a instalacao de pacotes das arquiteturas especificadas (p.ex., i686, x86_64 etc.). O valor especial auto usara a arquitetura do sistema, fornecida por "uname -m". Se nao estiver definida, nenhuma verificacao de arquitetura sera feita. NOTA: Pacotes com a arquitetura especial any sempre podem ser instalados, pois eles devem ser independentes da arquitetura. XferCommand = /caminho/para/comando %u Se definido, um programa externo sera usado para baixar todos os arquivos remotos. Todas as instancias de %u serao substituidas pelo URL de download. Se presente, as instancias de %o serao substituidas pelo nome do arquivo local, alem de uma extensao ".parte", que permite que programas como o wget facam o resumo do arquivo corretamente. Essa opcao e util para usuarios que enfrentam problemas com o suporte HTTP/FTP interno ou precisam do suporte a proxy mais avancado que vem com utilitarios como wget. NoUpgrade = arquivo ... Todos os arquivos listados com uma diretiva NoUpgrade nunca serao tocados durante a instalacao/atualizacao de um pacote, e os novos arquivos serao instalados com a extensao .pacnew. Esses arquivos se referem aos arquivos no arquivo compactado, portanto, nao inclua a barra inicial (o RootDir) ao especifica-los. Padroes de glob no estilo shell sao permitidos. E possivel inverter as correspondencias acrescentando um arquivo com um ponto de exclamacao. Os arquivos invertidos resultarao na inclusao de novos arquivos na lista negra na lista de permissoes. As correspondencias subsequentes substituirao as anteriores. Um ponto de exclamacao ou barra invertida literal inicial precisa ser escapado. NoExtract = arquivo ... Todos os arquivos listados com uma diretiva NoExtract nunca serao extraidos de um pacote para o sistema de arquivos. Isso pode ser util quando voce nao deseja que parte de um pacote seja instalada. Por exemplo, se a raiz do seu httpd usa um index.php, voce pode nao querer que o arquivo index.html seja extraido do pacote apache. Esses arquivos se referem aos arquivos no arquivo compactado, portanto, nao inclua a barra inicial (o RootDir) ao especifica-los. Padroes de glob no estilo shell sao permitidos. E possivel inverter as correspondencias acrescentando um arquivo com um ponto de exclamacao. Os arquivos invertidos resultarao na inclusao de novos arquivos na lista negra na lista de permissoes. As correspondencias subsequentes substituirao as anteriores. Um ponto de exclamacao ou barra invertida literal inicial precisa ser escapado. CleanMethod = KeepInstalled &| KeepCurrent Se definida como KeepInstalled (o padrao), a operacao -Sc limpara os pacotes que nao estao mais instalados (nao presentes na base de dados local). Se definida como KeepCurrent, -Sc limpa pacotes desatualizados (nao presentes em nenhuma base de dados de sincronizacao). O segundo comportamento e util quando o cache do pacote e compartilhado entre varias maquinas, onde as bases de dados locais geralmente sao diferentes, mas as bases de dados de sincronizacao em uso podem ser as mesmas. Se os dois valores forem especificados, os pacotes serao limpos apenas se nao estiverem instalados localmente e nao estiverem presentes em nenhuma base de dados de sincronizacao conhecida. SigLevel = ... Define o nivel de verificacao de assinatura padrao. Para mais informacoes, consulte Verificacao de Assinatura de Pacotes e Bases de Dados abaixo. LocalFileSigLevel = ... Define o nivel de verificacao de assinatura para instalar pacotes usando a operacao "-U" em um arquivo local. Usa o valor de SigLevel como o padrao. RemoteFileSigLevel = ... Define o nivel de verificacao de assinatura para instalar pacotes usando a operacao "-U" em um arquivo remoto URL. Usa o valor de SigLevel como o padrao. UseSyslog Registra mensagens de acao atraves de syslog(). Isto ira inserir entradas de log em /var/log/messages ou equivalente. Color Habilita cores automaticamente somente quando a saida do pacman estiver em um tty. NoProgressBar Desabilita barras de progresso. Isso e util para terminais que nao tem suporte a caracteres de escape. CheckSpace Executa uma verificacao aproximada do espaco em disco disponivel adequado antes de instalar os pacotes. VerbosePkgLists Exibe o nome, a versao e o tamanho dos pacotes alvos formatados como uma tabela para operacoes de atualizacao, sincronizacao e remocao. DisableDownloadTimeout Desativa padroes para limite de baixa velocidade e tempo limite em downloads. Use isso se voce tiver problemas para baixar arquivos com proxy e/ou gateway de seguranca. ParallelDownloads = ... Especifica o numero de fluxos de download simultaneos. O valor precisa ser um numero inteiro positivo. Se esta opcao de configuracao nao for definida, apenas um fluxo de download e usado (p.ex., downloads acontecem sequencialmente). SECOES DE REPOSITORIOS Cada secao do repositorio define um nome de secao e pelo menos um local onde os pacotes podem ser encontrados. O nome da secao e definido pela string entre colchetes (os dois acima sao core e custom). Os nomes do repositorio devem ser exclusivos e o nome local e reservado para a base de dados dos pacotes instalados. Os locais sao definidos com a diretiva Server e seguem uma estrutura de nomenclatura de URL. Se voce quiser usar um diretorio local, podera especificar o caminho completo com um prefixo "file://", como mostrado acima. Uma maneira comum de definir locais de base de dados usa a diretiva Include. Para cada repositorio definido no arquivo de configuracao, uma unica diretiva Include pode conter um arquivo que lista os servidores para esse repositorio. [core] # usa este servidor primeiro Server = ftp://ftp.archlinux.org/$repo/os/$arch # em seguida, usa servidores definidos no mirrorlist abaixo Include = {sysconfdir}/pacman.d/mirrorlist A ordem dos repositorios nos arquivos de configuracao e importante; os repositorios listados primeiro terao precedencia sobre os listados posteriormente no arquivo quando os pacotes em dois repositorios tiverem nomes identicos, independentemente do numero da versao. Include = caminho Inclui outro arquivo de configuracao. Este arquivo pode incluir repositorios ou opcoes gerais de configuracao. Os curingas nos caminhos especificados serao expandidos com base nas regras de glob(7). Server = url Uma URL completa para um local onde a base de dados, os pacotes e as assinaturas (se disponiveis) para este repositorio podem ser encontrados. Durante a analise, o pacman definira a variavel $repo com o nome da secao atual. Isso geralmente e utilizado em arquivos especificados usando a diretiva Include, para que todos os repositorios possam usar o mesmo arquivo de espelho. O pacman tambem define a variavel $arch como o primeiro valor da opcao Architecture, para que o mesmo arquivo de espelho possa ser usado para diferentes arquiteturas. SigLevel = ... Define o nivel de verificacao de assinatura para este repositorio. Para mais informacoes, consulte Verificacao de Assinatura de Pacotes e Bases de Dados abaixo. Usage = ... Define o nivel de uso para este repositorio. Esta opcao leva uma lista de tokens que devem ser pelo menos um dos seguintes: Sync Habilita atualizacoes para este repositorio. Search Habilita pesquisa para este repositorio. Install Habilita a instalacao de pacotes deste repositorio durante uma operacao --sync. Upgrade Permite que este repositorio seja uma fonte valida de pacotes ao executar um --sysupgrade. All Habilita todos os recursos acima para o repositorio. Esse e o padrao se nao for especificado. Observe que um repositorio ativado pode ser operado explicitamente, independentemente do nivel de uso definido. VERIFICACAO DE ASSINATURA DE PACOTES E BASES DE DADOS A diretiva SigLevel e valida nas secoes [options] e de repositorio. Se usado em [options], ela define um valor padrao para qualquer repositorio que nao forneca a configuracao. o Se definida com Never, nenhuma verificacao de assinatura e feita. o Se definida com Opcional, as assinaturas serao verificadas quando presentes, mas bases de dados e pacotes nao assinados tambem serao aceitos. o Se definida com Required, assinaturas serao exigidas em todos os pacotes e bases de dados. Como alternativa, voce pode obter um controle mais refinado, combinando algumas das opcoes e prefixos descritos abaixo. Todas as opcoes em um arquivo de configuracao sao processadas da maneira de cima para baixo, da esquerda para a direita, onde as opcoes posteriores substituem e/ou complementam as anteriores. Se SigLevel for especificado em uma secao do repositorio, o valor inicial sera o da secao [options] ou o padrao interno do sistema, como mostrado abaixo, se nao for especificado. As opcoes sao divididas em dois grupos principais, descritos abaixo. Termos usados como "marginalmente confiavel" sao termos usados pelo GnuPG, para obter mais informacoes, consulte gpg(1). Quando verificar Estas opcoes controlam se e quando verificacoes de assinaturas sao feitas. Never Toda verificacao de assinatura e suprimida, mesmo se assinaturas estiverem presentes. Optional (padrao) Assinaturas sao verificadas se presentes; a ausencia de assinatura nao e um erro. Uma assinatura invalida e um erro fatal, assim como a assinatura de uma chave que nao esta no chaveiro. Required Assinaturas sao exigidas; ausencia de assinatura ou uma assinatura invalida e um erro fatal, assim como a assinatura de uma chave que nao esta no chaveiro. O que e permitido Essas opcoes controlam quais assinaturas sao vistas como permitidas. Observe que nenhuma dessas opcoes permite a aceitacao de assinaturas invalidas ou expiradas ou de chaves revogadas. TrustedOnly (padrao) Se uma assinatura for verificada, ela devera estar no chaveiro e ser totalmente confiavel; a confianca marginal nao atende a esse criterio. TrustAll Se uma assinatura for verificada, ela deve estar no chaveiro, mas nao e necessario que seja atribuido um nivel de confianca (p.ex., confianca desconhecida ou marginal). Alem disso, as opcoes nos dois grupos podem ser prefixadas com Package ou Database, o que fara com que ela tenha efeito apenas no tipo de objeto especificado. Por exemplo, PackageTrustAll permitiria assinaturas marginais e desconhecidas de nivel de confianca para pacotes. O padrao embutido e o seguinte: SigLevel = Optional TrustedOnly USANDO SEU PROPRIO REPOSITORIO Se voce possui varios pacotes personalizados, geralmente e mais facil gerar seu proprio repositorio local personalizado do que instala-los todos com a opcao --upgrade. Tudo o que voce precisa fazer e gerar uma base de dados de pacotes compactados no diretorio com esses pacotes para que o pacman possa encontra-lo quando executado com --refresh. repo-add /home/pkgs/custom.db.tar.gz /home/pkgs/*.pkg.tar.gz O comando acima vai gerar uma base de dados compactada chamada /home/pkgs/custom.db.tar.gz. Observe que a base de dados deve estar no formato definido no arquivo de configuracao e {ext} e um tipo de compactacao valida conforme documentado em repo-add(8). E isso! Agora configure sua secao personalizada no arquivo de configuracao, como mostrado no exemplo de configuracao acima. O pacman agora usara o repositorio de pacotes. Se voce adicionar novos pacotes ao repositorio, lembre-se de gerar novamente a base de dados e use a opcao --refresh do pacman. Para informacoes sobre o comando repo-add, veja "repo-add --help" ou repo-add(8). VEJA TAMBEM pacman(8), libalpm(3) Consulte o site do pacman em https://archlinux.org/pacman/ para obter informacoes atuais sobre o pacman e suas ferramentas relacionadas. BUGS Bugs? Voce deve estar brincando; nao ha erros neste software. Mas se por acaso estivermos errados, envie um relatorio de erro com o maximo de detalhes possivel no rastreador de erros do Arch Linux na secao Pacman. AUTORES Atuais mantenedores: o Allan McRae o Andrew Gregory o Eli Schwartz o Morgan Adamiec Principais colaboradores anteriores: o Judd Vinet o Aurelien Foret o Aaron Griffin o Dan McGee o Xavier Chantry o Nagy Gabor o Dave Reisner Para outros contribuidores, use git shortlog -s no repositorio pacman.git. TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Rafael Fontenelle Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . Pacman 6.0.2 6 fevereiro 2024 PACMAN.CONF(5)