
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

start-stop-daemon - inicia e pára programas daemon do sistema

=head1 RESUMO

B<start-stop-daemon> [I<option>...] I<command>

=head1 DESCRIÇÃO

B<start-stop-daemon> é usado para a criação e término de processos de nível-de-sistema. Usando uma destas opções de correspondência, o B<start-stop-daemon> pode ser configurado para procurar instâncias existentes de processos a correr.

B<Nota>: A menos que B<--pid> ou B<--pidfile> sejam especificados, B<start-stop-daemon> comporta-se de modo semelhante a L<killall(1)>. B<start-stop-daemon> irá sondar a tabela de processos em busca de qualquer processo que coincida com o nome de processo, pid parente, uid, e/u gid (se especificado). Quaisquer processos correspondentes irá prevenir um B<--start> de iniciar o daemon. A todos os processos correspondentes será enviado o sinal TERM (ou aquele especificado via B<--signal> ou B<--retry>) se for especificado B<--stop>.Para daemons que têm filhos de vida-longa que precisam sobreviver a um B<--stop>, você tem de especificar um pidfile.

=head1 COMANDOS

=over 

=item B<-S>, B<--start> [B<-->] I<arguments>

Verifica a existência de um processo especificado. Se tal processo existir, o B<start-stop-daemon> não faz nada, e termina com um estado de erro 1 (0 se B<--oknodo> for especificado). Se tal processo não existir, inicia uma instância, usando ou o executável especificado por B<--exec> ou, se especificado, por B<--startas>. Quaisquer argumentos dados após B<--> na linha de comandos são passados sem modificação ao programa que está a ser iniciado.

=item B<-K>, B<--stop>

Verifica a existência de um processo especificado. Se tal processo existir, B<start-stop-daemon> envia o sinal especificado por B<--signal>, e termina com estado de erro 0. Se tal processo não existir, B<start-stop-daemon> termina com estado de erro 1 (0 se B<--oknodo> for especificado). Se for especificado B<--retry> então o B<start-stop-daemon> irá verificar se os processo(s) terminaram.

=item B<-T>, B<--status>

Check for the existence of a specified process, and returns an exit status code, according to the LSB Init Script Actions

Supported since version 1.16.1.

=item B<--pidof>

Check for the existence of specified processes, print their PIDs, and returns an exist status just like B<--status>.

Supported since version 1.23.8.

=item B<-H>, B<--help>

Mostra informação de utilização e termina.

=item B<-V>, B<--version>

Mostra a versão do programa e termina.

=back

=head1 OPÇÕES

=head2 Opções de correspondência

=over 

=item B<--pid> I<pid>

Check for a process with the specified I<pid>.  The I<pid> must be a number greater than 0.

Supported since version 1.17.6.

=item B<--ppid> I<ppid>

Check for a process with the specified parent pid I<ppid>.  The I<ppid> must be a number greater than 0.

Supported since version 1.17.7.

=item B<-p>, B<--pidfile> I<pidfile>

Verifica se um processo criou o ficheiro I<pidfile>.

B<Nota>: Usar esta opção de correspondência sozinha pode causar que se actue em processos intencionalmente, se o processo antigo terminou sem ser capaz de remover o seu I<pidfile>.

B<Aviso>: Usar esta opção de correspondência com um pidfile gravável mundialmente ou usa-la sozinha com um daemon que escreve o pidfile como um utilizador sem privilégios (não-root) irá ser recusada com um erro (desde versão 1.19.3) pois isto é um risco de segurança, porque ou o utilizador consegue escrever nele, ou se o daemon ficar comprometido, não se pode confiar no conteúdo do pidfile, e depois um programa privilegiado (tal como um script de init corrido como root) acabaria a actuar em qualquer processo do sistema. Usar I</dev/null> está isento destas verificações.

=item B<-x>, B<--exec> I<executable>

Verifica por processos que são instâncias deste I<executable>. O argumento I<executable> deve ser um nome de caminho absoluto.

B<Nota>: Isto pode não funcionar como pretendido com com scripts de interpretação, pois o executável irá apontar para o interpretador. Tendo em conta que processos que correm dentro de uma chroot também irão corresponder, então poderão ser necessárias outras restrições de correspondência.

=item B<-n>, B<--name> I<process-name>

Verifica por processos com o nome I<process-name>. O I<process-name> é geralmente o nome de ficheiro do processo, mas pode ter sido modificado pelo próprio processo.

B<Nota>: Na maioria dos sistemas esta informação é obtida a partir do nome de comunicação do processo a partir do kernel, o que tem tendência a ter um limite de comprimento relativamente curto (assumir mais de 15 caracteres é não-portável).

=item B<-u>, B<--user> I<username>|I<uid>

Verifica por processos cujo dono é o utilizador especificado por I<username> ou I<uid>.

B<Nota>: usar só esta opção de correspondência irá causar com que seja actuado em todos os processos que correspondem ao utilizador.

=back

=head2 Opções genéricas

=over 

=item B<-g>, B<--group> I<group>|I<gid>

Altera para I<grupo> ou I<gid> quando inicia o processo.

=item B<-s>, B<--signal> I<signal>

Com B<--stop>, especifica o sinal a enviar aos processos a serem parados (predefinição TERM).

=item B<-R>, B<--retry> I<timeout>|I<schedule>

Com B<--stop>, especifica que B<start-stop-daemon> deve verificar se o(s) processo(s) terminam mesmo. Irá verificar repetidamente se qualquer processo correspondente está a correr, até que nenhum esteja. Se os processos não terminarem irá então tomar mais acções como determinado pelo agendamento.

Se for especificado I<timeout> em vez de I<schedule>, então agenda I<signal>B</>I<timeout>B</KILL/>I<timeout> é usada, onde I<signal> é o sinal especificado com B<--signal>.

I<schedule> é uma lista de pelo menos dois itens separados por barras (B</>); cada item pode ser B<->I<signal-number> ou [B<->]I<signal-name>, o que significa enviar esse sinal, ou I<timeout>, o que significa esperar esses tantos segundos para que os processos terminem, ou B<forever>, o que significa repetir o resto da agenda para sempre se necessário.

Se o fim da agenda for atingido e não foi especificado B<forever>, então B<start-stop-daemon> termina com o estado de erro 2. Se for especificada uma agenda então qualquer sinal especificado com B<--signal> é ignorado.

=item B<-a>, B<--startas> I<pathname>

Com B<--start>, inicia o processo especificado por I<nome-de-caminho>. Se não especificado, usa por predefinição o argumento dado a B<--exec>.

=item B<-t>, B<--test>

Escreve as acções que seriam tomadas e define valores de retorno apropriados, mas não toma nenhuma acção.

=item B<-o>, B<--oknodo>

Retorna o estado de saída 0 em vez de 1 se nenhuma acção foi (será) tomada.

=item B<-q>, B<--quiet>

Não escreve mensagens informativas, apenas mostra mensagens de erro.

=item B<-c>, B<--chuid> I<username>|I<uid>[B<:>I<group>|I<gid>]

Muda para este nome-utilizador/uid antes de arrancar o processo. Você também pode especifica um grupo ao anexar B<:>, e depois o grupo ou gid do mesmo modo que faria com o comando L<chown(1)> (I<user>B<:>I<group>).  Se for especificado um utilizador sem um grupo, é usado o GID primários para esse utilizador. Quando usa esta opção você tem de compreender que os grupos primário e suplementar são também definidos, mesmo que a opção B<--group> não seja especificada. A opção B<--group> é apenas para grupos em que o utilizador não é normalmente um membro dele (tal como adicionar sociedade de grupo por-processo para utilizadores genéricos tipo B<nobody>).

=item B<-r>, B<--chroot> I<root>

Change directory and chroot to I<root> before starting the process.  Note that the pidfile is also written after the chroot.

=item B<-d>, B<--chdir> I<path>

Muda directório para I<caminho> antes de iniciar o processo. Isto é feito depois de chroot se a opção B<-r>|B<--chroot> estiver definida. Quando não especificado, o B<start-stop-daemon> irá mudar o directório para o directório raiz antes de iniciar o processo.

=item B<-b>, B<--background>

Tipicamente usado com programas que não se desanexam deles próprios. Esta opção irá forçar o B<start-stop-daemon> a bifurcar antes de iniciar o processo, e a força-lo para os bastidores.

B<Nota>: O estado de saída de uma falha inesperada tardia durante o processo de inicialização não pode ser verificado, a menos que seja usada a opção B<--notify-await>.  Destina-se a ser usada por programas que ou não faz sentido serem deamonizados por si próprios, ou onde não é viável ou desejável adicionar o código de deamonização e notificação para eles fazerem isto por si próprios.

=item B<--notify-await>

Wait for the background process to send a readiness notification before considering the service started This option can only be used with B<--background>.

Isto implementa partes do protocolo de prontidão do systemd, como especificado no manual L<sd_notify(3)>.  As seguintes variáveis são suportadas:

=over 

=item B<READY=1>

O programa está pronto a dar serviço, portanto é seguro sair-mos.

=item B<EXTEND_TIMEOUT_USEC=>I<number>

O programa pede para estender o limite de tempo em by I<number> milissegundos. Isto irá reiniciar o tempo limite actual para o valor especificado.

=item B<ERRNO=>I<number>

O programa está a terminar com um erro. Faça o mesmo e escreva a string amiga-do-utilizador para o valor B<errno>.

=back

Supported since version 1.19.3.

=item B<--notify-timeout> I<timeout>

Set a timeout for the B<--notify-await> option.  When the timeout is reached, B<start-stop-daemon> will exit with an error code, and no readiness notification will be awaited.  The default is B<60> seconds.

Supported since version 1.19.3.

=item B<-C>, B<--no-close>

Do not close any file descriptor when forcing the daemon into the background.  Used for debugging purposes to see the process output, or to redirect file descriptors to log the process output.  Only relevant when using B<--background>.

Supported since version 1.16.5.

=item B<-O>, B<--output> I<pathname>

Redirect B<stdout> and B<stderr> to I<pathname> when forcing the daemon into the background.  Only relevant when using B<--background>.

Supported since version 1.20.6.

=item B<-N>, B<--nicelevel> I<int>

Isto altera a prioridade do processo antes de o iniciar.

=item B<-P>, B<--procsched> I<policy>B<:>I<priority>

This alters the process scheduler policy and priority of the process before starting it.  The priority can be optionally specified by appending a B<:> followed by the value.  The default I<priority> is 0.  The currently supported policy values are B<other>, B<fifo> and B<rr>.

Esta opção pode não fazer anda em alguns sistemas, onde o agendamento de processos POSIX não é suportado.

Supported since version 1.15.0.

=item B<-I>, B<--iosched> I<class>B<:>I<priority>

This alters the IO scheduler class and priority of the process before starting it.  The priority can be optionally specified by appending a B<:> followed by the value.  The default I<priority> is 4, unless I<class> is B<idle>, then I<priority> will always be 7.  The currently supported values for I<class> are B<idle>, B<best-effort> and B<real-time>.

Esta opção pode não fazer anda em alguns sistemas, onde o agendamento de processos Linux IO não é suportado.

Supported since version 1.15.0.

=item B<-k>, B<--umask> I<mask>

This sets the umask of the process before starting it.

Supported since version 1.13.22.

=item B<-m>, B<--make-pidfile>

Usado quando se inicia um programa que não cria o seu próprio ficheiro pid. Esta opção irá fazer o B<start-stop-daemon> criar o ficheiro referenciado com B<--pidfile> e colocar o pid nele mesmo antes de executar o processo. Nota, o ficheiro só será removido quando se pára o programa se for usado B<--remove-pidfile>.

B<Nota>: Esta funcionalidade pode não funcionar em todos os casos. Mais notavelmente quando o programa a ser executar bifurca do seu processo principal. Devido a isto, é geralmente apenas útil quando combinado com a opção B<--background>.

=item B<--remove-pidfile>

Used when stopping a program that does not remove its own pid file.  This option will make B<start-stop-daemon> remove the file referenced with B<--pidfile> after terminating the process.

Supported since version 1.17.19.

=item B<-v>, B<--verbose>

Escreve mensagens de informação detalhadas.

=back

=head1 ESTADO À SAÍDA

=over 

=item B<0>

A acção requerida foi executada. Se B<--oknodo> foi especificado, é também possível que nada tenha de ser feito. Isto pode acontecer quando B<--start> foi especificado e um processo correspondente já estava a correr, ou quando B<--stop> foi especificado e não há nenhum processo correspondente.

=item B<1>

Se B<--oknodo> não foi especificado e nada foi feito.

=item B<2>

Se B<--stop> e B<--retry> foram especificados, mas foi alcançado o fim do agendamento e os processos ainda estavam a correr.

=item B<3>

Qualquer outro erro.

=back

When using the B<--status> or B<--pidof> commands, the following status codes are returned:

=over 

=item B<0>

Programa está em execução.

=item B<1>

Programa não está em execução e o ficheiro pid existe.

=item B<3>

Programa não está em execução.

=item B<4>

Incapaz de determinar o estado do programa.

=back

=head1 EXEMPLO

Inicia o daemon B<food>, a menos que um já esteja a correr (um processo chamado food, a correr como utilizador food, com pid em food.pid):

=over 

 start-stop-daemon --start --oknodo --user food --name food \
   --pidfile %RUNSTATEDIR%/food.pid --startas /usr/sbin/food \
   --chuid food -- --daemon

=back

Envia B<SIGTERM> para B<food> e espera até 5 segundos para que pare:

=over 

 start-stop-daemon --stop --oknodo --user food --name food \
   --pidfile %RUNSTATEDIR%/food.pid --retry 5

=back

Demonstração dum agendamento personalizado para parar o B<food>:

=over 

 start-stop-daemon --stop --oknodo --user food --name food \
   --pidfile %RUNSTATEDIR%/food.pid --retry=TERM/30/KILL/5

=back


=head1 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>.
