A desvantagem de usar o soquete privado, no entanto, é a segurança; O init apenas permite que o usuário root se comunique nesse soquete, o que significa que comandos somente leitura, como status e list, não podem ser feitos por outros usuários.

A opção –system instrui o initctl a se comunicar através do barramento do sistema D-Bus, e não pelo soquete privado.

Esta opção só é possível se o daemon de barramento do sistema estiver em execução e se o init estiver conectado a ele. A vantagem é que a configuração de segurança padrão permite que usuários não raiz usem comandos somente leitura .

Normalmente, não há necessidade de usar esta opção, pois o daemon init usa o nome Upstart padrão. No entanto, pode ser útil para depuração .

Normalmente, o initctl espera o comando terminar antes de retornar.

Para os comandos iniciar , parar e reiniciar , concluir significa que o trabalho nomeado está em execução (ou foi finalizado para tarefas) ou foi totalmente parado.

Para o comando emit , concluir significa que todos os trabalhos afetados pelo evento estão em execução (ou foram concluídos para tarefas) ou foram totalmente parados.

Em vez disso, essa opção faz com que esses comandos aguardem apenas a mudança ou o objetivo da meta ser enfileirado.

Consulte status para obter uma descrição do formato de saída.

Os argumentos opcionais KEY = VALUE especificam variáveis ​​de ambiente a serem passadas para o trabalho inicial e colocadas em seu ambiente. Eles também servem para especificar qual instância dos trabalhos de várias instâncias deve ser iniciada.

A maioria dos trabalhos permite apenas uma única instância; aqueles que usam a estrofe da instância em sua configuração definem uma sequênciaexpandido de variáveis ​​de ambiente para nomear a instância. Tantas instâncias exclusivas podem ser iniciadas quanto nomes exclusivos podem ser gerados pela estrofe. Assim, as variáveis ​​de ambiente também servem para selecionar em qual instância do JOB será executada.

Se o trabalho já estiver em execução, o start retornará um erro.

Quando chamado a partir da sub-rotina de pré-parada de uma configuração de tarefa, start pode ser chamado sem argumento para cancelar a parada .

Consulte status para obter uma descrição do formato de saída e inicie uma discussão sobre instâncias.

Quando chamado a partir da sub-rotina de pré-inicialização de uma configuração de tarefa, stop pode ser chamado sem um argumento para cancelar o início .

A instância do job que está sendo reiniciada manterá sua configuração original. Para que a nova instância seja executada com a configuração mais recente do trabalho, pare o trabalho e, em seguida, inicie -o novamente.

Consulte status para obter uma descrição do formato de saída e inicie uma discussão sobre instâncias.

Observe que este comando só pode ser usado quando houver uma instância de JOB ; se não houver, ele retornará um erro em vez de iniciar um novo.

Veja o início para uma discussão sobre instâncias.

Para um trabalho de instância única, é exibida uma linha como a seguinte:

início / execução da tarefa, processo 1234

O nome do trabalho é fornecido primeiro, seguido pelo objetivo e estado atuais da instância selecionada. O objetivo é iniciar ou parar , o status pode ser de espera , partida , pré-partida , gerada , pós-partida , corrida , pré-parada , parada , morte ou pós-parada .

Se o trabalho tiver um processo ativo, a identificação do processo seguirá na mesma linha. Se o estado for pré-início ou pós-parada, esse será o ID do processo equivalente; caso contrário, será o ID do processo principal:

início / pré-início do trabalho, processo 902

Os estados pós-início e pré-parada podem ter vários processos anexados, os processos extras seguirão em linhas consecutivas recuadas por uma guia:

início do trabalho / pós-início, processo 1234
        processo pós-inicialização 1357

Se não houver processo principal, eles podem seguir a mesma linha, mas serão prefixados para indicar que não é o ID do processo principal que está sendo fornecido:

início do trabalho / pós-início, processo (pós-início) 1357

Os trabalhos que permitem várias instâncias têm nomes para cada instância; a saída é idêntica à anterior, exceto que o nome da instância segue o nome da tarefa entre parênteses:

início do trabalho (tty1) / pós-início, processo 1234
        processo pós-inicialização 1357

Observe que esse comando inclui na enumeração os trabalhos ainda a serem executados (em outras palavras, arquivos de configuração para os quais ainda não foram criadas instâncias de trabalho) na saída com o status “parar / aguardar”. Com efeito, essas entradas indicam arquivos de configuração que representam possíveis trabalhos futuros.

Consulte status para obter uma descrição do formato de saída e inicie uma discussão sobre instâncias.

Nenhuma ordem específica é usada para a saída e não há diferença na saída (exceto o nome da instância que aparece entre parênteses) entre os trabalhos de instância única e várias instâncias.

Os argumentos opcionais KEY = VALUE especificam variáveis ​​de ambiente a serem incluídas no evento e, portanto, exportadas para o ambiente de quaisquer trabalhos iniciados e parados pelo evento.

O ambiente também pode servir para especificar qual instância dos trabalhos de várias instâncias deve ser iniciada ou parada. Veja o início para uma discussão sobre instâncias.

Não há limitação nos nomes de eventos que podem ser emitidos com este comando; você é livre para inventar novos eventos e usá-los em suas configurações de trabalho.

O evento mais “conhecido” usado pela configuração Upstart padrão é o evento runlevel . Esta opção é normalmente emitida pelas ferramentas telinit e shutdown .

Esse comando geralmente não é necessário, pois o init observa seus diretórios de configuração com inotify e é recarregado automaticamente em casos de alterações.

Nenhum trabalho será iniciado por este comando.

A PRIORIDADE pode ser uma de depuração , informação , mensagem , aviso , erro ou fatal .

Quando chamado sem argumento, solicita a prioridade mínima atual da mensagem que o daemon init registrará e produzirá na saída padrão.

Observe que uma configuração de trabalho é o nome de um arquivo de configuração de trabalho, sem a extensão. Observe também que essas informações são estáticas: elas não se referem a nenhum trabalho em execução.

Para cada evento emitido, uma linha separada é exibida começando com dois caracteres de espaço seguidos por “emite evento”, em que “evento” indica um único evento emitido.

As condições de início e parada estão listadas em linhas separadas, começando com dois espaçoscaracteres e seguido por “iniciar” e “parar”, respectivamente, terminando com a condição apropriada.

Se uma configuração de trabalho não emitir , iniciar ou parar em condições, o nome da configuração do trabalho será exibido sem mais detalhes.

Observe que as condições de inicialização e parada serão totalmente entre colchetes, independentemente de elas aparecerem assim no arquivo de configuração da tarefa, o que é útil para ver como o daemon init percebe a condição.

Exemplo de saída:

foo
  emite boing
  emite um pontinho
  iniciar em (começando A e (B ou C var = 2))
  parar (barra HELLO = teste mundial = 123 ou parar a wibble)

OPTION pode ser o seguinte:

foo
  emite boing
  emite um pontinho
  começar a começar (trabalho: A, env :)
  iniciar em B (trabalho :, env :)
  iniciar em C (trabalho :, env: var = 2)
  parar na barra (trabalho :, env: HELLO = teste mundial = 123)
  parar em parar (job: wibble, evento: stop, env :)

Esta opção é útil para determinar o impacto da adição ou remoção de arquivos de configuração do trabalho.

Observe que, para usar este comando, é necessário garantir que todos os arquivos de configuração de tarefas anunciam os eventos que emitem corretamente.

Se forem identificados erros, o nome da configuração do trabalho será exibido. As linhas subseqüentes mostrarão as condições de falha na configuração do trabalho, uma por linha. As linhas de condição começam com dois espaços e são seguidas com “start on:” ou “stop on:”, a palavra “unknown”, o tipo de entidade que não é conhecido e, finalmente, seu nome.

Observe que apenas as configurações do trabalho que estão logicamente com erro (aquelas com condições insatisfatórias) serão exibidas. Observe também que configurações de trabalho sintaticamente inválidas podem acionar um erro se causarem um erro na condição.

Supondo que o arquivo de configuração do trabalho /etc/init/foo.conf contenha o seguinte:

começar a começar uva
pare no pêssego

O comando check-config pode exibir:

foo
  começo: emprego desconhecido uva
  parar: evento desconhecido pêssego

Se algum erro for detectado, o código de saída será 1 (um). Se todas as verificações passarem, o código de saída será 0 (zero).

Observe que, para condições complexas de iniciar e parar , esse comando pode fornecer o que parece ser uma saída enganosa quando uma condição de erro é encontrada, pois todas as expressões na condição de falha que estão com erro geram uma saída de erro. Por exemplo, se a configuração do trabalho /etc/init/bar.conf contiver o seguinte:

iniciar em (A e (iniciado B ou (iniciando C ou D))))

E apenas o evento A pode ser satisfeito, a saída será:

Barra
  começo em: trabalho desconhecido B
  começo em: trabalho desconhecido C
  início: evento desconhecido D

OPTION pode ser o seguinte:

Quando executado a partir de um trabalho, este comando consulta automaticamente a tabela de ambiente específico do trabalho; caso contrário, a tabela de ambiente global aplicada a todos os trabalhos quando eles são iniciados é consultada.

Observe que a tabela do ambiente de tarefa global compreende as variáveis ​​já configuradas no ambiente init daemons na inicialização, o conjunto mínimo de variáveis ​​padrão do sistema adicionadas pelo daemon init e quaisquer variáveis ​​configuradas usando set-env . Veja init para mais detalhes.

OPTION pode ser o seguinte:

Quando executado a partir de um trabalho, este comando consulta automaticamente a tabela de ambiente específico do trabalho; caso contrário, a tabela de ambiente global aplicada a todos os trabalhos quando eles são iniciados é consultada.

OPTION pode ser o seguinte:

Este comando é permitido apenas ao executar no modo de sessão do usuário. Veja init para mais detalhes.

OPÇÕES podem ser as seguintes:

OPÇÕES podem ser as seguintes:

Este comando é permitido apenas quando executado no modo de sessão do usuário. Veja init para mais detalhes.

Observe que o efeito do processo Init Init que gerencia a reinicialização do modo de sessão do usuário é equivalente a esse comando ter sido chamado.

OPÇÕES podem ser as seguintes:

Exemplo de saída para um trabalho que especifica a sub-rotina de uso é mostrado abaixo:

Uso: tty DEV = ttyX - onde X é o ID do console