Como o systemd interpreta os códigos de retorno dos scripts que ele inicia em ExecStartPre e ExecStartPost?

Question

O Systemd, ao processar um arquivo .service, é capaz de executar scripts nas cláusulas ExecStartPre e ExecStartPost. Esses scripts podem retornar valores para o systemd.

Na documentação do systemd, indica que um valor de retorno de qualquer coisa, menos de 0, é considerado uma falha e, a menos que essa cláusula tenha o prefixo '-', indica que essa tentativa de iniciar o serviço será abortada.

Uma tentativa de lançamento abortada não é grande coisa, porque o systemd irá simplesmente tentar iniciar o serviço, a menos que o serviço esteja marcado como simples (eu acho).

Em um script que eu herdei, o autor indica que um valor de retorno de 111 informa ao systemd que não apenas o lançamento deve ser abortado, mas que nenhum outro lançamento deve ser tentado. Em outros lugares, o script condicionalmente retorna 10, ou 11, além do típico 0. Essas condições de retorno parecem ser parte integrante do funcionamento do script.

Não consegui encontrar nada que descreva a interpretação desses códigos de retorno pelo systemd.

    

Answer 1

Você tem opções para o comando principal ExecStart . Eu não sei, mas suspeito que os -Post e -Pre não os usam.

Aceitando 10 e 11 como válidos: SuccessExitStatus =

Visualizando 111 como um separador total de ofertas: RestartPreventExitStatus =

Caso contrário, você sempre pode escrever um script shell rápido para empacotar a falta de suporte no systemd.

Eu faria algo assim:

#!/bin/sh

if [ -f /run/my-script-is-dead ]
then
    # to avoid very fast loop, sleep for a bit
    sleep 10
    exit 1
fi

# Run the script itself
/path/and/usual-command

# check result
RESULT=$?

if [ $RESULT -eq 10 ] || [ RESULT -eq 11 ]
then
    exit 0
fi

if [ $RESULT -eq 111 ]
then
    touch /run/my-script-is-dead
    exit 1
fi

exit $RESULT

Mas, colocando um arquivo em /run , ele irá automaticamente desaparecer em cada reinicialização. Se você quer algo mais permanente, então você terá que criar um arquivo em outro lugar (por exemplo, /var/cache/... )