LLI Wiki — My Digital Knowledge Base

Spécificateurs des fichiers d'unité systemd

Référence courte des spécificateurs % utilisables dans les fichiers d'unité systemd : noms, instances, hôte, utilisateur et répertoires.

Les fichiers d'unité systemd acceptent des spécificateurs : des marqueurs écrits sous la forme % suivi d'une lettre. systemd les remplace au chargement de l'unité, ce qui permet d'utiliser un même fichier d'unité sur plusieurs machines ou pour plusieurs instances. Voici une référence courte ; la liste complète se trouve dans le manuel systemd.unit(5).

# Exemple illustratif : %S est la racine du répertoire d'état
ExecStart=/usr/bin/myservice --state-dir %S/myservice

Noms d'unité et instances

Spécificateur Signification
%n Nom complet de l'unité, suffixe compris (par exemple myservice@web.service)
%N Nom de l'unité sans le suffixe
%p Nom du préfixe (myservice pour myservice@web.service)
%i Nom de l'instance : le texte entre le premier @ et le suffixe (web)
%I Nom de l'instance sans l'échappement
%j Dernière partie du préfixe, après le dernier -
%f Nom de fichier sans échappement, précédé d'un /

Hôte et système

Spécificateur Signification
%H Nom d'hôte
%l Nom d'hôte court (jusqu'au premier point)
%q Nom d'hôte « pretty » de /etc/machine-info, ou le nom court s'il n'est pas défini
%m Identifiant machine
%b Identifiant de démarrage (boot ID), qui change à chaque démarrage
%v Version du noyau, comme l'affiche uname -r
%a Architecture, par exemple x86-64 ou arm64
%o, %w, %W Identifiant, version et variante du système, tirés de /etc/os-release
%A, %B, %M Version de l'image, identifiant de build et identifiant d'image, tirés de /etc/os-release (vide si non défini)

Utilisateur et répertoires

La valeur de ces spécificateurs dépend du fait que l'unité s'exécute sous le gestionnaire système ou sous un gestionnaire utilisateur. Sous le gestionnaire système, l'utilisateur et le groupe valent root et 0.

Spécificateur Signification
%u, %U Nom et UID numérique de l'utilisateur du gestionnaire de services
%g, %G Nom et GID numérique du groupe de cet utilisateur
%h Répertoire personnel de cet utilisateur
%s Shell de connexion de cet utilisateur
%t Racine du répertoire d'exécution (/run, ou $XDG_RUNTIME_DIR pour les gestionnaires utilisateur)
%S Racine du répertoire d'état (/var/lib, ou l'équivalent utilisateur)
%C Racine du répertoire de cache (/var/cache, ou l'équivalent utilisateur)
%L Racine du répertoire de journaux (/var/log, ou l'équivalent utilisateur)
%E Racine du répertoire de configuration (/etc, ou l'équivalent utilisateur)
%T Répertoire temporaire (/tmp)
%V Répertoire temporaire plus volumineux et persistant (/var/tmp)
%d Répertoire des identifiants (credentials, issu de $CREDENTIALS_DIRECTORY)

Autres

Spécificateur Signification
%y Chemin du fichier d'unité qui définit l'unité
%Y Répertoire de ce fichier d'unité
%% Un signe pourcentage littéral

Remarques

Mastodon LLIMastodon SocialFosstodon