Lister les volumes de stockage procurés par tous les fournisseurs de stockage en cours dans le système (ou, avec l’option --user, dans l’environnement d’exécution de l’utilisateur). L’argument facultatif GLOB est un motif de style interpréteur de commandes (consulter fnmatch(3)) qui filtre le résultat par nom de volume. La sortie est une table contenant le service fournisseur, le nom de volume, son type (« blk », « reg » ou « dir »), une indication de lecture seule, et, s’ils sont connus, sa taille et le nombre d’octets utilisés.

C’est la commande par défaut si aucune n’est spécifiée.

Ajouté dans la version 261.

Lister les patrons de volume gérés par les fournisseurs de stockage en cours. Ces patrons encapsulent une configuration à utiliser lors d’une création à la volée de volumes lorsqu’ils sont acquis. La prise en charge de patron est une fonctionnalité facultative pour les fournisseurs et s’applique uniquement aux fournisseurs autorisant la création de volumes à la volée (consulter la documentation respective du fournisseur pour plus de détails, par exemple, systemd-storage-fs@.service(8)). L’argument facultatif GLOB filtre selon le nom de patron. Les fournisseurs de stockage qui ne mettent pas en œuvre la création de volume selon un patron (tels que les fournisseurs de périphérique en mode bloc) ne sont pas inclus dans cette sortie.

Ajouté dans la version 261.

Lister les fournisseurs de stockage connus du système. Cela est déterminé en analysant le répertoire bien connu de sockets pour des sockets AF_UNIX qui semblent des points de terminaison io.systemd.StorageProvider. Pour chaque fournisseur, il est aussi indiqué si la connexion au socket est actuellement possible.

Ajouté dans la version 261.

Opérer sur les fournisseurs de stockage du système en entier. Les sockets sont recherchés dans /run/systemd/io.systemd.StorageProvider/. C’est le comportement par défaut.

Ajouté dans la version 261.

Opérer sur les fournisseurs de stockage par utilisateur. Les sockets sont recherchés dans $XDG_RUNTIME_DIR/systemd/io.systemd.StorageProvider/.

Ajouté dans la version 261.

Afficher la sortie formatée en JSON. Le mode attendu est « short » (pour la sortie la plus concise possible sans redondance d’espace ou de saut de ligne), « pretty » (pour une plus jolie version de la même chose avec indentation et sauts de ligne) ou « off » (pour désactiver la sortie JSON, comportement par défaut).

Ne pas rediriger (pipe) la sortie vers un afficheur (pager).

Ne pas afficher de légende, c'est-à-dire les en-têtes de colonne et le pied de page contenant des remarques.

Ne pas demander à l'utilisateur de s'authentifier pour les opérations requérant des privilèges.

Afficher un aide-mémoire succinct et quitter.

Afficher une information de version courte et quitter.

Acquérir un volume de répertoires et réaliser un montage bind de son arbre de répertoires sur la cible.

Ajouté dans la version 261.

Acquérir un fichier normal ou un volume de périphérique en mode bloc et les monter sous forme de système de fichiers de type TYPE_SF (par exemple, « storage.ext4 », « storage.btrfs », ...).

Ajouté dans la version 261.

Cette option accepte l'une des valeurs suivantes ; « any » (ouvrir si le volume existe, sinon le créer — c'est la valeur par défaut), « open » (échec si le volume n'existe pas encore) ou « new » (échec si le volume existe déjà).

Ajouté dans la version 261.

Le patron à utiliser lors de la création d’un nouveau volume s’il est manquant et que le fournisseur accepte la création à la volée de volumes.

Ajouté dans la version 261.

Lors de la création d’un nouveau volume à la volée, taille en octets à allouer. Cette option accepte les suffixes habituels « K », « M », « G » et « T » (base 1024). Cette indication est nécessaire lors de la création d’un volume de fichiers normal.

Ajouté dans la version 261.

$ storagectl providers
$ storagectl volumes
$ storagectl volumes '*toto*'
$ storagectl templates

# mount -t storage fs:mon_vol /mnt/mon_vol

# mount -t storage.ext4 fs:scratch /mnt/scratch -o loop

# mount -t storage.ext4 -o ro block:/dev/disk/by-id/usb-toto /mnt/toto

Le niveau maximal de journalisation de messages émis (messages avec un niveau de journalisation supérieur, c'est-à-dire les moins importants seront supprimés). Cette variable prend une liste de valeurs séparées par des virgules. Une valeur peut être (par ordre d'importance décroissante) emerg, alert, crit, err, warning, notice, info, debug ou un entier dans l’intervalle 0...7. Consultez syslog(3) pour davantage d'informations. Chaque valeur peut être optionnellement préfixée avec console, syslog, kmsg ou journal suivi d'un deux-points (:) pour définir le niveau de journalisation maximal pour la cible spécifique de journal (par exemple SYSTEMD_LOG_LEVEL=debug,console:info indique de journaliser au niveau debug excepté pour la journalisation vers la console qui doit s'effectuer au niveau info). Notez que le niveau maximal de journalisation globale est prioritaire sur tout niveau maximal de journalisation par cible.

Un booléen. Si la valeur est vrai, les messages écrits sur le terminal seront colorés selon la priorité.

Ce réglage n’est utile que lorsque les messages sont écrits directement dans un terminal ou un fichier,car journalctl(1) et d'autres outils qui affichent des journaux coloreront par eux-mêmes les messages selon le niveau de journalisation.

Un booléen. Si la valeur est vrai, les messages du journal de la console seront préfixés d'un horodatage.

Ce réglage n’est utile que lorsque les messages sont écrits directement dans un terminal ou un fichier,car journalctl(1) et d'autres outils qui affichent des journaux attacheront par eux-mêmes un horodatage selon les métadonnées de l'entrée.

Un booléen. Si la valeur est vrai, les messages seront préfixés par un nom de fichier et du numéro de ligne du code source d'où vient le message.

Notez que de toute façon, l'emplacement du journal est souvent attaché comme métadonnée aux entrées du journal. L'inclure directement dans le texte du message peut néanmoins être opportun lors du débogage de programmes.

Un booléen. Si la valeur est vrai, les messages seront préfixés par l'identifiant numérique du thread actuel (TID).

Notez que de toute façon, l'emplacement du journal est souvent attaché comme métadonnée aux entrées du journal. L'inclure directement dans le texte du message peut néanmoins être opportun lors du débogage de programmes.

Destination de la journalisation des messages. Une des destinations parmi console (journaliser dans le terminal attaché), console-prefixed (journaliser dans le terminal attaché, mais avec des préfixes qui codent le niveau et le « service » de journalisation, consultez syslog(3)), kmsg (journaliser dans le tampon de journalisation circulaire du noyau), journal (journaliser dans le journal), journal-or-kmsg (journaliser dans le journal s'il est disponible et sinon dans kmsg), auto (déterminer automatiquement la cible appropriée de journalisation, c'est la destination par défaut), null (désactive la sortie de journalisation).

Limiter le taux de messages vers kmsg ou pas. Prend un booléen. Par défaut « true ». Si désactivé, systemd ne limitera pas le taux des messages écrits à kmsg.

Afficheur à utiliser lorsque --no-pager n'est pas précisé. $SYSTEMD_PAGER est utilisé s'il est défini ; autrement, $PAGERest utilisé. Si ni $SYSTEMD_PAGER, ni $PAGER ne sont définis, un ensemble d’afficheurs bien connus sont essayés à tour de rôle, incluant less(1) et more(1), jusqu'à ce qu'il en soit trouvé un. Si aucun afficheur n'est trouvé, aucun afficheur n'est appelé. Définir ces variables d'environnement à une chaîne vide ou à « cat » est équivalent à l'utilisation de --no-pager.

Remarque : si $SYSTEMD_PAGERSECURE n'est pas défini, $SYSTEMD_PAGER et $PAGER ne peuvent être utilisés que pour désactiver l'afficheur (avec « cat » ou « "" ») et autrement seront ignorés.

Outrepasser les options passées à less (par défaut « FRSXMK »).

Les utilisateurs voudront peut-être changer deux options en particulier :

K

X

Notez que le réglage de la variable d'environnement $LESS normale n'a aucun effet sur les invocations de less par les outils de systemd.

Voir less(1) pour plus de détails.

Outrepasser le jeu de caractères passé à less (par défaut « utf-8 », si le terminal invoqué est compatible avec l'UTF-8).

Notez que le réglage de la variable d'environnement $LESSCHARSET normale n'a aucun effet sur les invocations de less par les outils de systemd.

Les commandes d'afficheur courantes comme less(1), en plus de « l'affichage », c'est-à-dire le défilement de la sortie, prennent en charge l'ouverture et l'écriture d'autres fichiers et l'exécution de commandes d'interpréteur arbitraires. Quand les commandes sont invoquées avec des privilèges élevés, par exemple sous sudo(8) ou pkexec(1), l'afficheur devient une limite de sécurité. Il convient de veiller à ce que seuls des programmes avec des fonctionnalités strictement limitées soient utilisés comme afficheurs et que les fonctionnalités comme l'ouverture ou la création de nouveaux fichiers ou le démarrage de sous-processus ne soient pas autorisées. Un « mode sécurisé » pour l'afficheur peut être activé comme décrit ci-dessous, si l'afficheur le prend en charge (la plupart des afficheurs ne sont pas écrits de façon à prendre cela en considération). Il est recommandé soit d'activer explicitement le « mode sécurisé », soit de désactiver complètement l'afficheur en utilisant --no-pager ou PAGER=cat lorsque des utilisateurs non fiables sont autorisés à exécuter des commandes avec des privilèges élevés.

Cette option prend un argument booléen. Lorsqu'elle est définie à vrai, le « mode sécurisé » de l'afficheur est activé. En « mode sécurisé », LESSSECURE=1 est défini lors de l'invocation de l'afficheur, ce qui lui indique de désactiver les commandes qui ouvrent ou créent des fichiers, ou qui démarrent un nouveau sous-processus. Actuellement, seul less(5) est connu pour comprendre cette variable et implémenter le « mode sécurisé ».

Quand l'option est définie à faux, aucune limitation n'est imposée à l'afficheur. Définir SYSTEMD_PAGERSECURE=0 ou ne pas le supprimer de l'environnement hérité peut permettre à l'utilisateur d'invoquer des commandes arbitraires.

Quand $SYSTEMD_PAGERSECURE n'est pas défini, les outils de systemd tentent de déterminer automatiquement si le « mode sécurisé » doit être activé et si l'afficheur le prend en charge. Le « mode sécurisé » est activé si l'UID effectif est différent de celui du propriétaire de la session de connexion (voir geteuid(2) et sd_pid_get_owner_uid(3)) ou lors de l'exécution sous sudo(8) ou des outils similaires ($SUDO_UID est défini [2]). Dans ces cas, SYSTEMD_PAGERSECURE=1 sera défini et les afficheurs qui ne sont pas connus pour implémenter le « mode sécurisé » ne seront pas du tout utilisés. Notez que cette détection automatique ne couvre que les mécanismes les plus courants d'élévation des privilèges et qu'elle est conçue pour faciliter la tâche. Il est recommandé de définir explicitement $SYSTEMD_PAGERSECURE ou de désactiver l'afficheur.

Notez que si les variables $SYSTEMD_PAGER ou $PAGER doivent être respectées, sauf pour désactiver l'afficheur, $SYSTEMD_PAGERSECURE doit aussi être défini.

Cette variable prend un argument booléen ou une valeur spéciale. Par défaut (si elle n’est pas définie), systemd et les utilitaires connexes utilisent si possible des couleurs dans leur sortie. Si $COLORTERM est défini à « truecolor » ou « 24bit », des couleurs 24 bits (couleurs vraies) sont utilisées, autrement 256 couleurs sont utilisées, à moins que $NO_COLOR ou $TERM indiquent que les couleurs sont désactivées.

true

false

« 16 », « 256 », « 24bit »

« auto-16 », « auto-256 », « auto-24bit »

La valeur doit être un booléen. Contrôle si les liens cliquables doivent être générés dans la sortie pour des émulateurs de terminaux le prenant en charge. Cela peut être indiqué pour passer outre la décision faite par systemd basée sur $TERM et d'autres conditions.