.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLINIT 1"
.TH DH_INSTALLINIT 1 "2020-03-27" "12.10ubuntu1" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOME"
.IX Header "NOME"
dh_installinit \- instala ficheiros de iniciação de serviços em directórios
de compilação de pacotes
.SH "RESUMO"
.IX Header "RESUMO"
\&\fBdh_installinit\fR [\fIdebhelper opções\fR] [\fB\-\-name=\fR\fInome\fR] [\fB\-n\fR]
[\fB\-R\fR] [\fB\-r\fR] [\fB\-d\fR] [\fB\-\-\fR \fIparams\fR]
.SH "DESCRIÇÃO"
.IX Header "DESCRIÇÃO"
\&\fBdh_installinit\fR é um programa debhelper que é responsável por instalar
scripts init com os ficheiros de predefinições associados. Em níveis de
compatibilidade até, e incluindo, 10, \fBdh_installinit\fR ira também instalar
alguns ficheiros relacionados com o systemd fornecidos pelo empacotamento
debian (veja a secção \*(L"\s-1FICHEIROS\*(R"\s0 em baixo). Em níveis de compatibilidade
até, e incluindo, 11, \fBdh_installinit\fR irá também lidar com trabalhos de
arranque fornecidos pelo empacotamento debian (veja \*(L"\s-1FICHEIROS\*(R"\s0 para mais
informação sobre isto também).
.PP
Também gera automaticamente os comandos \fIpostinst\fR e \fIpostrm\fR e \fIprerm\fR
necessários para definir os links simbólicos em \fI/etc/rc*.d/\fR para iniciar
e parar os scripts init.
.PP
Em compatibilidade 10 ou anterior: Se um pacote apenas embarcar um ficheiro
de serviço do systemd e não for disponibilizado nenhum script de sysvinit,
você pode querer excluir a chamada ao dh_installinit para esse pacote
(ex. via \fB\-N\fR). Caso contrário, você pode obter avisos do lintian acerca de
scripts init.d a não serem incluídos no pacote.
.SH "FICHEIROS"
.IX Header "FICHEIROS"
.IP "debian/\fIpacote\fR.init" 4
.IX Item "debian/pacote.init"
Se isto existir, é instalado em etc/init.d/\fIpacote\fR no directório de
compilação do pacote.
.IP "debian/\fIpacote\fR.default" 4
.IX Item "debian/pacote.default"
Se isto existir, é instalado em etc/default/\fIpacote\fR no directório de
compilação do pacote.
.IP "debian/\fIpacote\fR.upstart" 4
.IX Item "debian/pacote.upstart"
Em nível de compatibilidade 11, este ficheiro irá disparar um erro com uma
lembrança para assegurar a remoção apropriada do ficheiro upstart na versão
anterior do pacote. Por favor consider usar a funcionalidade \*(L"rm_conffile\*(R"
do \fBdh_installdeb\fR\|(1) para assegurar a remoção apropriada de ficheiros
upstart anteriores.
.Sp
No nível de compatibilidade 10, se este ficheiro existir, é instalado em
etc/init/\fIpacote\fR.conf no directório de compilação do pacote.
.IP "debian/\fIpacote\fR.service" 4
.IX Item "debian/pacote.service"
Se isto existir, é instalado em lib/systemd/system/\fIpacote\fR.service no
directório de compilação do pacote. Apenas usado nos níveis de
compatibilidade 10 e inferiores.
.IP "debian/\fIpacote\fR.tmpfile" 4
.IX Item "debian/pacote.tmpfile"
Se isto existir, é instalado em usr/lib/tmpfiles.d/\fIpacote\fR.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.
.SH "OPÇÕES"
.IX Header "OPÇÕES"
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Não modifique os scripts \fIpostinst\fR/\fIpostrm\fR/\fIprerm\fR.
.IP "\fB\-o\fR, \fB\-\-only\-scripts\fR" 4
.IX Item "-o, --only-scripts"
Apenas modifica os scripts \fIpostinst\fR/\fIpostrm\fR/\fIprerm\fR, 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 \fBdh_installinit\fR encontrá\-lo.
.Sp
\&\fBCaveat\fR: Isto irá passar ao lado de todas as verificações regulares e
modificar \fIincondicionalmente\fR os scripts. Quase de certeza que você irá
querer usar isto com \fB\-p\fR para limitar quais pacotes serão afectados pela
chamada. Exemplo:
.Sp
.Vb 3
\& override_dh_installinit:
\&        dh_installinit \-pfoo \-\-only\-scripts
\&        dh_installinit \-\-remaining
.Ve
.IP "\fB\-R\fR, \fB\-\-restart\-after\-upgrade\fR" 4
.IX Item "-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.
.Sp
Nos níveis de compatibilidade anteriores, a predefinição era parar o script
em \fIprerm\fR, e depois arrancá\-lo de novo no \fIpostinst\fR.
.Sp
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.
.IP "\fB\-\-no\-restart\-after\-upgrade\fR" 4
.IX Item "--no-restart-after-upgrade"
Desfaz um \fB\-\-restart\-after\-upgrade\fR 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 \fIprerm\fR e arrancado de novo no script
\&\fIpostinst\fR.
.IP "\fB\-r\fR, \fB\-\-no\-stop\-on\-upgrade\fR, \fB\-\-no\-restart\-on\-upgrade\fR" 4
.IX Item "-r, --no-stop-on-upgrade, --no-restart-on-upgrade"
Não pára o script init na actualização. Isto tem o efeito secundário de não
reiniciar o serviço como parte da actualização.
.Sp
Se desejar reiniciar o serviço com o tempo mínimo de desligado, por favor
use \fB\-\-restart\-after\-upgrade\fR (predefinido em compatibilidade 10 ou
posterior). Se desejar que o serviço seja reiniciado mas que fique parado
durante a actualização, então por favor use \fB\-\-no\-restart\-after\-upgrade\fR
(repare no \*(L"after-upgrade\*(R").
.Sp
Note que o alias \fB\-\-no\-restart\-on\-upgrade\fR está descontinuado e será também
removido em compatibilidade 12. Isto serve para evitar confusão com a opção
\&\fB\-\-no\-restart\-after\-upgrade\fR. A variante \fB\-\-no\-stop\-on\-upgrade\fR foi
introduzida no debhelper 10.2 (incluído em Debian stretch).
.IP "\fB\-\-no\-start\fR" 4
.IX Item "--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 \fBupdate\-rc.d\fR. Útil para scripts rcS.
.IP "\fB\-\-no\-enable\fR" 4
.IX Item "--no-enable"
Desactiva o script de init na purga, mas não o activa na instalação. Isto
implica uma dependência baseada na versão em \fBinit-system-helpers (>=
1.51)\fR pois é a primeira versão funcional que suporta \fBupdate\-rc.d
<script> defaults-disabled\fR.
.Sp
\&\fBNote\fR que esta opção não afecta se os serviços são arrancados. Por favor
lembre-se de também usar \fB\-\-no\-start\fR se o serviço não deverá ser
arrancado.
.Sp
Não pode ser combinado com \fB\-u\fR\fIparams\fR, \fB\-\-update\-rcd\-params=\fR\fIparams\fR,
ou \fB\-\-\fR \fIparams\fR.
.IP "\fB\-d\fR, \fB\-\-remove\-d\fR" 4
.IX Item "-d, --remove-d"
Remove o \fBd\fR final do nome do pacote, e usa o resultado para o nome do
ficheiro de trabalho upstart que é instalado em \fIetc/init/\fR , e para o nome
do ficheiro de script de iniciação que é instalado em etc/init.d e o
ficheiro predefinido é instalado em \fIetc/default/\fR. Isto pode ser útil para
daemons com nomes que terminam em \fBd\fR. (Note: isto toma precedência sobre o
parâmetro \fB\-\-init\-script\fR descrito em baixo).
.IP "\fB\-u\fR\fIparams\fR \fB\-\-update\-rcd\-params=\fR\fIparams\fR" 4
.IX Item "-uparams --update-rcd-params=params"
.PD 0
.IP "\fB\-\-\fR \fIparams\fR" 4
.IX Item "-- params"
.PD
Passa \fIparâmetros\fR para \fBupdate\-rc.d\fR\|(8). Se não especificado, \fBdefaults\fR
(ou \fBdefaults-disabled\fR com \fB\-\-no\-enable\fR) será passado para
\&\fBupdate\-rc.d\fR\|(8).
.Sp
Não pode ser combinado com  \fB\-\-no\-enable\fR.
.IP "\fB\-\-name=\fR\fInome\fR" 4
.IX Item "--name=nome"
Instala o script de iniciação (e ficheiro predefinido) assim como o ficheiro
de trabalho upstart usando no nome de ficheiro \fInome\fR em vez do nome
predefinido, o qual é o nome do pacote. Quando este parâmetro é usado, o
\&\fBdh_installinit\fR procura e instala ficheiros chamados
\&\fIdebian/package.name.init\fR, \fIdebian/package.name.default\fR e
\&\fIdebian/package.name.upstart\fR em vez dos usuais \fIdebian/package.init\fR,
\&\fIdebian/package.default\fR e \fIdebian/package.upstart\fR.
.IP "\fB\-\-init\-script=\fR\fInome-do-script\fR" 4
.IX Item "--init-script=nome-do-script"
Usa \fIscriptname\fR para o nome do script de iniciação que é instalado em
\&\fIetc/init.d/\fR (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
\&\fBdh_installinit\fR irá ver se existe um ficheiro no directório \fIdebian/\fR que
seja parecido com \fIpackage.scriptname\fR e se existir instala-o como script
de iniciação em preferência dos ficheiros que normalmente instala.
.Sp
Este parâmetro está descontinuado, use o parâmetro \fB\-\-name\fR em vez
deste. Este parâmetro é incompatível com o uso de tarefas upstart.
.IP "\fB\-\-error\-handler=\fR\fIfunção\fR" 4
.IX Item "--error-handler=função"
Chama a \fIfunção\fR de shell chamada se a execução do script de iniciação
falhar. A função deve ser disponibilizada nos scripts \fIprerm\fR e
\&\fIpostinst\fR, antes do símbolo \fB#DEBHELPER#\fR.
.SH "NOTAS"
.IX Header "NOTAS"
Note que este comando não é idempotente. O \fBdh_prep\fR\|(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.
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
\&\fBdebhelper\fR\|(7), \fBdh_installsystemd\fR\|(1)
.PP
Este programa é parte do debhelper.
.SH "AUTORES"
.IX Header "AUTORES"
Joey Hess <joeyh@debian.org>
.PP
Steve Langasek <steve.langasek@canonical.com>
.PP
Michael Stapelberg <stapelberg@debian.org>
.SH "TRADUÇÃO"
.IX Header "TRADUÇÃO"
Américo Monteiro
.PP
Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro \fIa_monteiro@gmx.com\fR
ou
Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.
