3.5.2. Estrutura do arquivo da unidade

Os arquivos de unidade normalmente consistem de três seções:

  • A seção [Unit] - contém opções genéricas que não dependem do tipo da unidade. Estas opções fornecem descrição da unidade, especificam o comportamento da unidade e definem dependências para outras unidades. Para uma lista das opções [Unidade] mais freqüentemente utilizadas, veja Tabela 3.9, “Opções de seção [Unidade] importantes”.
  • A seção [Unit type] - se uma unidade tem diretrizes específicas de tipo, estas são agrupadas sob uma seção com o nome do tipo de unidade. Por exemplo, os arquivos da unidade de serviço contêm a seção [Service].
  • A seção [Install] - contém informações sobre a instalação da unidade utilizada pelos comandos systemctl enable e disable. Para uma lista de opções para a seção [Install], veja Tabela 3.11, “Opções de seção [Instalar] importantes”.

3.5.2.1. Opções de seção [Unidade] importantes

As seguintes tabelas listam opções importantes da seção [Unidade].

Tabela 3.9. Opções de seção [Unidade] importantes

Opção[a]Descrição

Description

Uma descrição significativa da unidade. Este texto é exibido, por exemplo, na saída do comando systemctl status.

Documentation

Fornece uma lista de URIs de referência de documentação para a unidade.

After[b]

Define a ordem na qual as unidades são iniciadas. A unidade só começa depois que as unidades especificadas em After estiverem ativas. Ao contrário de Requires, After não ativa explicitamente as unidades especificadas. A opção Before tem a funcionalidade oposta a After.

Requires

Configura as dependências de outras unidades. As unidades listadas em Requires são ativadas em conjunto com a unidade. Se alguma das unidades necessárias falhar em iniciar, a unidade não é ativada.

Wants

Configura dependências mais fracas do que Requires. Se qualquer uma das unidades listadas não começar com sucesso, não terá impacto na ativação da unidade. Esta é a forma recomendada para estabelecer dependências de unidades personalizadas.

Conflicts

Configura dependências negativas, um oposto a Requires.

[a] Para uma lista completa de opções configuráveis na seção [Unidade], consulte a página do manual systemd.unit(5).
[b] Na maioria dos casos, é suficiente definir apenas as dependências do pedido com After e Before opções de arquivo de unidade. Se você também definir uma dependência de pedidos com Wants (recomendado) ou Requires, a dependência de pedidos ainda precisa ser especificada. Isso porque as dependências de pedidos e requisitos funcionam independentemente uma da outra.