Scroll to navigation

DH_INSTALLINIT(1) Debhelper DH_INSTALLINIT(1)

NOME

dh_installinit - instala ficheiros de iniciação de serviços em directórios de compilação de pacotes

RESUMO

dh_installinit [debhelper opções] [--name=nome] [-n] [-R] [-r] [-d] [-- params]

DESCRIÇÃO

dh_installinit é um programa debhelper que é responsável por instalar scripts init com os ficheiros de predefinições associados, assim como ficheiros de trabalhos upstart, e ficheiros de serviço do systemd em directórios de compilação de pacotes.

Também gera automaticamente os comandos postinst e postrm e prerm necessários para definir os links simbólicos em /etc/rc*.d/ para iniciar e parar os scripts init.

FICHEIROS

debian/pacote.init
Se isto existir, é instalado em etc/init.d/pacote no directório de compilação do pacote.
debian/pacote.default
Se isto existir, é instalado em etc/default/pacote no directório de compilação do pacote.
debian/pacote.upstart
Se isto existir, é instalado em etc/init/pacote.conf no directório de compilação do pacote.
debian/pacote.service
Se isto existir, é instalado em lib/systemd/system/pacote.service no directório de compilação do pacote. Apenas usado nos níveis de compatibilidade 10 e inferiores.
debian/pacote.tmpfile
Se isto existir, é instalado em usr/lib/tmpfiles.d/pacote.conf no directório de compilação do pacote. (Actualmente o mecanismo tmpfiles.d é usado apenas pelo systemd.) Apenas usado nos níveis de compatibilidade 10 e inferiores.

OPÇÕES

-n, --no-scripts
Não modifique os scripts postinst/postrm/prerm.
-o, --only-scripts
Apenas modifica os scripts postinst/postrm/prerm, não instala na realidade nenhum script de init, ficheiros predefinidos, ficheiros de trabalho upstart ou serviço do systemd. Pode ser útil se o ficheiro é embarcado e/ou instalado pelo autor original num modo que não deixa ser fácil deixar o dh_installinit encontrá-lo.

Caveat: Isto irá passar ao lado de todas as verificações regulares e modificar incondicionalmente os scripts. Quase de certeza que você irá querer usar isto com -p para limitar quais pacotes serão afectados pela chamada. Exemplo:

 override_dh_installinit:
        dh_installinit -pfoo --only-scripts
        dh_installinit --remaining
    
-R, --restart-after-upgrade
Não pára o script de iniciação até que a actualização do pacote estejam completa. Este é o comportamento predefinido no nível compatibilidade 10.

Nos níveis de compatibilidade anteriores, a predefinição era parar o script em prerm, e depois arrancá-lo de novo no postinst.

Isto pode ser útil para daemons que não devem ter a possibilidade de ficar em baixo durante muito tempo durante a actualização. Mas você deve certificar-se que o daemon não vai ficar confuso por o pacote estar a ser actualizado enquanto ele está a correr antes de usar esta opção.

--no-restart-after-upgrade
Desfaz um --restart-after-upgrade prévio (ou a predefinição do nível de compatibilidade 10). Se não forem dadas mais opções, isto irá causar com que o serviço seja parado no script prerm e arrancado de novo no script postinst.
-r, --no-stop-on-upgrade, --no-restart-on-upgrade
Não pára o script de iniciação durante uma actualização.
--no-start
Não inicia o script de init durante a instalação ou actualização, ou não o pára durante a remoção. Apenas chama update-rc.d. Útil para scripts rcS.
-d, --remove-d
Remove o d final do nome do pacote, e usa o resultado para o nome do ficheiro de trabalho upstar que é instalado em etc/init/ , e para o nome do ficheiro de script de iniciação que é instalado em etc/init.d e o ficheiro predefinido é instalado em etc/default/. Isto pode ser útil para daemons com nomes que terminam em d. (Note: isto toma precedência sobre o parâmetro --init-script descrito em baixo).
-uparams --update-rcd-params=params
-- params
Passa params para update-rc.d(8). Se não for especificado, as predefinições serão passadas para update-rc.d(8).
--name=nome
Instala o script de iniciação (e ficheiro predefinido) assim como o ficheiro de trabalho upstart usando no nome de ficheiro nome em vez do nome predefinido, o qual é o nome do pacote. Quando este parâmetro é usado, o dh_installinit procura e instala ficheiros chamados debian/package.name.init, debian/package.name.default e debian/package.name.upstart em vez dos usuais debian/package.init, debian/package.default e debian/package.upstart.
--init-script=nome-do-script
Usa scriptname para o nome do script de iniciação que é instalado em etc/init.d/ (e também o usa como nome de ficheiro para o ficheiro de predefinições, se for instalado). Se você usar este parâmetro, o dh_installinit irá ver se existe um ficheiro no directório debian/ que seja parecido com package.scriptname e se existir instala-o como script de iniciação em preferência dos ficheiros que normalmente instala.

Este parâmetro está descontinuado, use o parâmetro --name em vez deste. Este parâmetro é incompatível com o uso de tarefas upstart.

--error-handler=função
Chama a função de shell chamada se a execução do script de iniciação falhar. A função deve ser disponibilizada nos scripts prerm e postinst, antes do símbolo #DEBHELPER#.

NOTAS

Note que este comando não é idempotente. O dh_prep(1) deve ser chamado entre invocações deste comando. Caso contrário, pode causar múltiplas instâncias do mesmo texto a ser adicionado aos scripts do mantenedor.

VEJA TAMBÉM

debhelper(7)

Este programa é parte do debhelper.

AUTORES

Joey Hess <joeyh@debian.org>

Steve Langasek <steve.langasek@canonical.com>

Michael Stapelberg <stapelberg@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.

2017-01-25 10.2.5