NOME

       dh_installdeb - instala ficheiros no directório DEBIAN

RESUMO

       dh_installdeb [debhelper opções]

DESCRIÇÃO

       dh_installdeb é um programa debhelper que é responsável por instalar ficheiros nos directórios DEBIAN nos
       directórios de compilação de pacotes com as permissões correctas.

FICHEIROS

       pacote.postinst
       pacote.preinst
       pacote.postrm
       pacote.prerm
           Estes scripts de maintainer são instalados no directório DEBIAN.

           dh_installdeb  irá  executar  a  substituição  de  tokens conhecidos do padrão #TOKEN#.  Em geral, os
           scripts irão querer incluir o #DEBHELPER# para beneficiar dos scripts de shell gerados pelos comandos
           debhelper  (incluindo  commands  (including  aqueles  de  dh_installdeb  quando  processa   ficheiros
           package.maintscript).

           O  token  #DEBHELPER#  deve  ser colocado na sua linha própria pois é muitas vezes substituído por um
           script de shell de multi-linhas.

       pacote.triggers
       pacote.shlibs
           Estes ficheiros de controle são instalados no directório DEBIAN.

           Note que o pacote.shlibs  é  apenas  instalado  em  nível  de  compatibilidade  9  e  anteriores.  Em
           compatibilidade 10, use dh_makeshlibs(1).

       pacote.conffiles
           este  ficheiro  será  instalado  no  directório  DEBIAN.  O  ficheiro fornecido será enriquecido pelo
           debhelper para incluir todos os conffiles auto-detetados pelo debhelper  (o  responsável  deve  estar
           listado lá pois o debhelper assume que deve lidar com essa parte.)

           Este ficheiro é principalmente útil para usar entradas "especiais" tais como a funcionalidade remove-
           on-upgrade do dpkg.

       pacote.maintscript
           As  linhas  neste  ficheiro  correspondem  a  comandos e parâmetros de dpkg-maintscript-helper(1). No
           entanto, os "maint-script-parameters" não devem ser incluídos pois o debhelper  irá  adicionar  esses
           automaticamente.

           Exemplo:

               # Correct
               rm_conffile /etc/obsolete.conf 0.2~ foo
               # INCORRECT
               rm_conffile /etc/obsolete.conf 0.2~ foo -- "$@"

           No  nível  de  compatibilidade  10 ou posterior, quaisquer meta-caracteres de shell serão "escapados"
           então não se pode inserir aqui código arbitrário de shell. Por exemplo, uma linha  como  "mv_conffile
           /etc/oldconffile /etc/newconffile" irá inserir fragmentos de script de maintainer em todos os scripts
           de maintainer suficientes para mover esse ficheiro de configuração.

           Foi  também  intenção  de  fazer  escape  de  shell  a  meta-caracteres nos níveis de compatibilidade
           anteriores. No entanto, não funcionava correctamente e como tal era possível embeber código de  shell
           arbitrário nos níveis de compatibilidade anteriores.

           A  ferramenta  dh_installdeb  irá  fazer alguma validação básica a alguns dos comandos listados neste
           ficheiro para apanhar enganos comuns. A validação é activada como um aviso desde compatibilidade 10 e
           como um erro a resolver na compatibilidade 12.

           Onde  possível,  o  dh_installdeb  pode  escolher  rescrever  algumas  ou  todas   as   entradas   em
           funcionalidades  equivalentes  suportadas  no dpkg sem se apoiar nos scripts do maintainer scripts  a
           seu exclusivo critério (exemplos incluem rescrever  rm_conffile  em  remove-on-upgrade  do  dpkg).  O
           requerimento mínimo para activar esta funcionalidade é que o debhelper corra em compatibilidade 10 ou
           posterior.

           Suporta variáveis de substituição em compatibilidade 13 e posterior como documentado em debhelper(7).

OPÇÕES

       -DTOKEN=VALUE, --define TOKEN=VALUE
           Define  tokens  a  serem  substituídos dentro dos scripts do maintainer quando são gerados. Por favor
           note as limitações descritas em "Limitações  nos  nomes  dos  tokens"  também  se  aplicam  a  tokens
           definidos na linha de comandos. Nomes de tokens inválidos irão despoletar um erro.

           No  caso  simples,  este  parâmetro  irá  causar com que #TOKEN# seja substituído por VALUE. Se VALUE
           começar com um @-sign literal, então espera-se que VALUE aponte para um ficheiro que contém  o  valor
           real a inserir.

           Um token declarado explicitamente com este parâmetro irá substituir tokens embutidos.

           Exemplos de testes para ajuda na compreensão:

                   cat >> debian/postinst <<EOF
                   #SIMPLE#
                   #FILEBASED#
                   EOF
                   echo -n "Complex value" > some-file
               dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file

           Neste exemplo, #SIMPLE# irá expandir para direct e #FILEBASED# irá expandir para Complex value.

           É  também  possível  definir  valores  específicos-de-pacote  para  um dado token. Isto é útil quando
           dh_installdeb está a actuar em múltiplos pacotes que precisam de  valores  diferentes  para  o  mesmo
           token. Isto é feito ao prefixar o nome do token com pkg.nome-do-pacote..

           Isto pode ser usado como no exemplo seguinte:

                   cat >> debian/foo.postinst <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
                   cat >> debian/bar.postinst <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
                   cat >> debian/baz.postinst <<EOF
                   # Script for #PACKAGE#
                   #TOKEN#
                   EOF
               dh_installdeb -pfoo -pbar -pbaz  --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \
                 --define pkg.baz.TOKEN=unique-baz-value

           Neste  exemplo,  #TOKEN#  irá  expandir para default em debian/foo.postinst, para unique-bar-value em
           debian/bar.postinst e para unique-baz-value em debian/baz.postinst.

           Note que os tokens #pkg.*# irão ser visíveis em todos os scripts que actuem. Ex, você pode referir  a
           #pkg.bar.TOKEN# dentro de debian/foo.postinst e ele será substituído por unique-bar-value.

SUBSTITUIÇÃO EM SCRIPTS DE MAINTAINER

       O  dh_installdeb  irá  substituir automaticamente os seguintes tokens dentro de um script disponibilizado
       pelo maintainer (se não for substituído via -D/--define):

       #DEBHELPER#
           Este token é por predefinição substituído por excertos de shell de comandos debhelper  gerados.  Isto
           inclui os excertos gerados pelo dh_installdeb a partir do ficheiro package.maintscript (se presente).

       #DEB_HOST_NAME#, #DEB_BUILD_NAME#, #DEB_TARGET_NAME#
           Estes  tokens  são  substituídos pela variável respectiva a partir de dpkg-architecture(1).  Em quase
           todos os casos, você vai querer usar a variante #DEB_HOST_NAME num script para assegurar que obtêm  o
           valor correcto quando faz compilação cruzada.

           Na   melhor   das   hipóteses,   tokens   deste  padrão  que  não  correspondam  a  uma  variável  em
           dpkg-architecture(1) serão deixados como estão.

       #ENV.NAME#
           Estes tokens deste formato serão substituídos pelo valor da variável de ambiente correspondente. Se a
           variável de ambiente não estiver definida, o token é substituído pela string vazia.

           Note que existem limites em quais nomes podem ser usados (veja "Limitações nos nomes dos token").

       #PACKAGE#
           Este token é por predefinição substituído pelo nome do pacote, o qual irá conter o script concreto.

   Limitações nos nomes dos token
       Todos os tokens que se destinam a ser substituídos têm de corresponder ao regex: #[A-Za-z0-9_.+]+#

       Tokens que não correspondam a esse regex serão ignorados em silêncio se  encontrados  no  script  modelo.
       Nomes  de token inválidos passados a -D ou --define irão causar que o dh_installdeb rejeite o comando com
       um erro na maioria dos casos.

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.18ubuntu2.1                                     2024-10-18                                   DH_INSTALLDEB(1)