namcap(1) Comandos de usuário namcap(1)

namcap - utilitário de análise de pacotes

namcap [opções] <pacote|PKGBUILD> [pacote|PKGBUILD] ...

namcap é um utilitário de análise de pacotes que procura problemas em pacotes Arch Linux ou seus arquivos PKGBUILD. Ele pode aplicar regras à lista de arquivos, aos próprios arquivos ou a arquivos PKGBUILD individuais.

As regras retornam listas de mensagens. Cada mensagem pode ser de três tipos: erro, aviso ou informação (pense nelas como notas ou comentários). Erros (designados por 'E:') são coisas que o namcap tem certeza que estão erradas e precisam ser corrigidas. Avisos (designados por 'W:') são coisas que o namcap acha que deveriam ser alteradas, mas se você sabe o que está fazendo, pode deixá-los. As informações (designadas como 'I:') só são mostradas quando você usa o argumento info. As mensagens informativas fornecem informações que podem ser úteis, mas não precisam ser alteradas.

Não executa as regras LISTA_REGRAS no pacote
exibe mensagens informativas
retorna uma lista de regras válidas e suas descrições
exibe tags do namcap facilmente analisáveis em vez da descrição normal legível por humanos; por exemplo, usando non-fhs-man-page em vez de "Non-FHS man page (%s) found. Use /usr/share/man instead". Uma lista completa de tags namcap junto com suas descrições legíveis pode ser encontrada em /usr/share/namcap/tags.
só aplica as regras LISTA_REGRAS ao pacote
LISTA_REGRAS é uma lista de nomes de regras, separadas por vírgula
exibe a versão e sai

Verifica se as variáveis de array são na verdade arrays e não strings
Verifica se as entradas de backup não começam com /
Procura referências a i686 e i586 e diz para você usar $CARCH
Verifica um PKGBUILD para verificar se o nome do pacote não possui caracteres maiúsculos
Verifica um pacote para verificar se o nome do pacote não possui caracteres maiúsculos
Garante que um PKGBUILD inclua somas de verificação válidas
Este módulo executa ldd em todos os executáveis, obtém as dependências no nível do link, encontra o menor subconjunto de dependências que cobrem as dependências no nível do link e compara essa lista com as dependências do pacote. Ele retorna mensagens em três casos: dependência detectada e não incluída, dependência incluída mas já satisfeita e dependência incluída e não necessária. Essas sugestões são apenas diretrizes e todos os criadores de pacotes devem levar isso em consideração (ou seja, você é mais inteligente que o namcap)

Alguns casos em que o namcap falha são dlopen() e links obscuros. As bibliotecas dlopen() não aparecem porque são carregadas em tempo de execução: no caso de um programa que carrega plug-ins. Links obscuros são os casos em que apenas uma pequena parte do pacote precisa de algo para ser executado; normalmente, a pequena parte não será acessada a menos que essa coisa esteja instalada (ou seja, um plugin java para mozilla incluído no pacote java).

Verifica os nomes dos diretórios na lista de arquivos do pacote para diretórios padrão (ou seja, /etc, /usr/bin, /usr/lib). Todos os arquivos em diretórios que não são padrão são retornados
Ocorre um erro se encontrar arquivos ELF (binários) fora dos caminhos padrão (/bin, /usr/bin, etc.)
Procura diretórios em um pacote que não contém nenhum arquivo
Verifica se variáveis extras começam com um sublinhado
Verifica a instalação correta das páginas info
Verifica a instalação correta das páginas man
Verifica se todos os arquivos pertencem a root:root e não a algum outro usuário ou grupo
Verifica os arquivos mime do GNOME gerados
Verifica se o cache do ícones hicolor é atualizado quando um pacote instala arquivos em /usr/share/icons/hicolor
Verifica se um pacote não contém o arquivo do diretório info (/usr/share/info/dir)
Quaisquer PKGBUILDs que se referem a arquivos em $startdir estão incorretos
Avisa se arquivos libtool (*.la) estão presentes
Verifica se a variável de licenças foi preenchida em um PKGBUILD.
Verifica se a variável de licenças foi preenchida em um pacote. Para pacotes com licença personalizada, ele verifica se o arquivo de licença foi instalado em /usr/share/licenses/$pkgname/
Pesquisa por perllocal.pod. perllocal.pod é um arquivo desagradável incluído durante a maioria das instalações de módulos Perl
Verifica as permissões básicas de arquivos e diretórios. Ele retorna avisos sobre bits legíveis mundialmente não sendo definidos, bits graváveis mundiais sendo definidos e bits executáveis mundiais não sendo definidos para diretórios
Retorna um erro se um binário tiver RPATH definido para algo diferente de /usr/lib
Retorna um erro se um binário tiver RUNPATH definido como algo diferente de /usr/lib, /usr/lib32
Verifica se não há diretórios scrollkeeper
Avisa se um PKGBUILD está baixando de um espelho específico do sourceforge em vez do genérico downloads.sourceforge.net
Descobre links simbólicos e físicos que não apontam para um caminho válido no pacote
Para mantenedores de pacotes, este módulo verifica se nos lembramos de adicionar um comentário de Maintainer e Contributor.
Verifica se temos a variável url definida no PKGBUILD
Verifica se temos a variável url definida no arquivo do pacote

aplica todas as regras a foo.pkg.tar.gz
aplica as regras de dependência e link simbólico a foo.pkg.tar.gz
aplica todas as regras baseadas em PKGBUILD ao arquivo PKGBUILD
lista todas as regras disponíveis

Copyright © 2003-2023 Colaboradores do Namcap, veja AUTHORS para detalhes.

Este é um software livre; consulte o código-fonte para condições de cópia. Há NENHUMA garantia; nem mesmo para COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM OBJETIVO ESPECÍFICO.

A tradução para português brasileiro desta página man foi criada por Rafael Fontenelle <rafaelff@gnome.org>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

January 14, 2024 namcap 3.5.2