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
- Les spécificateurs sont développés dans les paramètres des fichiers d'unité, pas par le shell. Utiliser
%%pour un%littéral. - Certains spécificateurs valent une chaîne vide lorsque la valeur source n'est pas définie, par exemple les champs d'image système sur une installation standard.