Provided by: debhelper_13.24.2ubuntu1_all bug

NOME

       dh_testroot - assegura que um pacote é compilado com o nível necessário de permissões de root.

RESUMO

       dh_testroot [debhelper opções]

DESCRIÇÃO

       dh_testroot é usado para determinar se um alvo está a ser corrido com acesso suficiente a funcionalidades
       de (tipo-)root.

       A definição de acesso suficiente depende em se o construtor (a ferramenta que invoca o alvo debian/rules)
       suporta o campo Rules-Requires-Root (R³). Se o construtor suportar R³, então irá regular a variável de
       ambiente DEB_RULES_REQUIRES_ROOT e dh_testroot irá validar que o construtor seguiu os requerimentos
       mínimos para a valor fornecido de DEB_RULES_REQUIRES_ROOT.

       Se o construtor não suportar Rules-Requires-Root, então não irá regular a variável de ambiente
       DEB_RULES_REQUIRES_ROOT. Isto irá fazer com que dh_testroot (e o resto do debhelper) recorra a assumir
       que é implicado (fake)root.

       O seguinte é um sumário de como dh_testroot se comporta baseado na variável de ambiente
       DEB_RULES_REQUIRES_ROOT (os espaços em branco no inicio e no final na variável são ignorados).

       -   Se  não  definido, ou definido para "binary-targets", então dh_testroot deduz que é corrido como root
           ou sob fakeroot(1).

       -   Se definido para "no", então dh_testroot  retorna  com  sucesso  (sem  executar  nenhuma  verificação
           adicional).

       -   Se  definido para qualquer outro valor que o de cima, então dh_testroot declara que ou é corrido como
           root (ou sob fakeroot(1)) ou o construtor disponibilizou a  variável  de  ambiente  DEB_GAIN_ROOT_CMD
           (ex. via dpkg-buildpackage -r).

       Por  favor  note  que  dh_testroot não lê o campo Rules-Requires-Root. O que implica que dh_testroot pode
       produzir resultados incorrectos se o construtor apoiar-se em  DEB_RULES_REQUIRES_ROOT.  Por  outro  lado,
       também activa coisas como testar o que irá acontecer quando DEB_RULES_REQUIRES_ROOT está definida para um
       determinado valor.

VEJA TAMBÉM

       debhelper(7)

       Este programa é parte do debhelper.

AUTOR

       Joey Hess <joeyh@debian.org>

TRADUÇÃO

       Américo Monteiro

       Se  encontrar  algum  erro  na  tradução  deste  documento,  por  favor  comunique  para Américo Monteiro
       a_monteiro@gmx.com ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.

13.24.2ubuntu1                                     2025-05-22                                     DH_TESTROOT(1)