Scroll to navigation

SYSTEMD-MOUNT(1) systemd-mount SYSTEMD-MOUNT(1)

NOM

systemd-mount, systemd-umount – Établir et détruire des montages provisoires ou des points d’auto-montage

SYNOPSIS

systemd-mount [OPTIONS...] QUOI [OÙ]

systemd-mount [OPTIONS...] --tmpfs [NOM] OÙ

systemd-mount [OPTIONS...] --list

systemd-mount [OPTIONS...] --umount QUOI|OÙ...

DESCRIPTION

systemd-mount peut être utilisé pour créer et démarrer une unité .mount transitoire ou .automount du système de fichiers QUOI du point de montage OÙ.

De beaucoup de façons, systemd-mount est similaire à la commande mount(8) de bas niveau. Cependant, au lieu d’exécuter l’opération de montage directement et immédiatement, systemd-mount la planifie dans la file d’attente de tâches du gestionnaire de services de façon à pouvoir y apporter d’autres dépendances (telles que des montages parent ou un vérificateur de système de fichiers à exécuter à priori), et pouvoir utiliser la logique d’auto-montage.

La commande prend un ou deux arguments. Si un seul argument est spécifié, il doit être relatif à un périphérique en mode bloc ou à un fichier normal contenant un système de fichiers (par exemple, /dev/sdb1 ou /chemin/vers/disque.img). Le périphérique en mode bloc ou le fichier d’image est alors sondé pour un étiquette de système de fichiers ou autres métadonnées, et est monté dans un répertoire sous /run/media/system/ dont le nom est généré à partir de l’étiquette du système de fichiers. Dans ce mode, le périphérique en mode bloc ou le fichier d’image doivent exister au moment de l’invocation de la commande de façon à pouvoir être sondés. Si le périphérique s’avère être un périphérique en mode bloc extractible (par exemple, une clé USB), un point d’automontage est créé au lieu d’un point de montage normal (c’est-à-dire l’option --automount= est implicite, voir ci-après). Si l’option --tmpfs est spécifiée, alors l’argument est interprété comme le chemin où le système de fichiers temporaire doit être monté.

Si deux arguments sont spécifiés, le premier indique la source à monter (le QUOI) et le second indique le chemin sur lequel la monter (le OÙ). Dans ce mode, aucun sondage de la source n’est tenté et aucun nœud de périphérique de soutien (backing) n’a besoin d’exister. Cependant, si ce mode est combiné avec l’option --discover, le sondage de nœud de périphérique pour des métadonnées supplémentaires est activé et – à peu près comme dans le cas d’argument unique relaté ci-dessus – le périphérique indiqué doit exister au moment de l’invocation de la commande.

Utilisez la commande avec l’option --list pour afficher une table succincte de tous les périphériques en mode bloc connus avec les systèmes de fichiers montés.

systemd-umount peut être utilisé pour démonter un point de montage ou d’automontage. C’est le pendant de systemd-mount --umount.

OPTIONS

Les options suivantes sont comprises :

--no-block

Ne pas attendre de manière synchrone que l’opération requise se termine. Si cette option n’est pas indiquée, la tâche sera vérifiée, mise en file d’attente et systemd-mount attendra que le lancement d’unité de montage ou d’automontage soit fini. En passant cet argument, la tâche est seulement vérifiée et mise en file d’attente.

Ajouté dans la version 232.

-l, --full

Ne pas réduire la taille de la sortie quand l’option --list est spécifiée.

Ajouté dans la version 245.

--no-pager

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

--no-legend

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

--no-ask-password

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

--json=MODE

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).

--quiet, -q

Supprimer la sortie supplémentaire informative lors de l’exécution.

Ajouté dans la version 232.

--discover

Activer le sondage de la source à monter. Ce commutateur est implicite quand un seul argument est spécifié sur la ligne de commande. Si cette option est passée, des métadonnées supplémentaires sont lues dans le périphérique pour améliorer l’unité à créer. Par exemple, une chaine descriptive pour les unités transitoires est générée à partir de l’étiquette du système de fichiers et du modèle de périphérique. De plus, si un périphérique en mode bloc amovible (par exemple, une clé USB) est détecté, une unité d’automontage est créée au lieu d’une unité de montage normal, avec un délai d’inactivité court, dans le but de s’assurer que le système de fichiers soit placé dans un état propre rapidement après chaque accès.

Ajouté dans la version 232.

--type=, -t

Spécifier le type de système de fichiers à monter (par exemple, « vfat » ou « ext4 »). Si cette option est omise ou définie à « auto », le type de système de fichiers est déterminé automatiquement.

Ajouté dans la version 232.

--options=, -o

Options de montage supplémentaires pour le point de montage.

Ajouté dans la version 232.

--owner=UTILISATEUR

Permettre à l’UTILISATEUR spécifié d’être propriétaire du système de fichiers monté. Cela est réalisé en ajoutant les options uid= et gid= à la liste des options de montage. Cette option n’est prise en charge que par certains systèmes de fichiers.

Ajouté dans la version 237.

--fsck=

Cette option prend un argument booléen, par défaut « on ». Elle détermine si une exécution de vérification du système de fichiers doit être faite immédiatement avant l’opération de montage. Dans le cas de l’auto-montage (voir l’option --automount= ci-après), la vérification est faite au moment du premier accès au périphérique, ce qui peut retarder légèrement cet accès.

Ajouté dans la version 232.

--description=

Cette option fournit une description des unités de montage ou auto-montage. Voir Description= dans systemd.unit(5).

Ajouté dans la version 232.

--property=, -p

Cette option définit une propriété d’unité pour l’unité de montage créée. Elle reçoit une affectation du même format que prend la commande set-property de systemctl(1).

Ajouté dans la version 232.

--automount=

Cette option prend un argument booléen. Elle détermine si un point d’auto-montage ou un point de montage normal doit être créé. Si « true », un point d’auto-montage est créé qui est pris en charge par le système de fichiers existant au moment du premier accès. Si « false » un point de montage normal est créé qui est pris en charge immédiatement par le système de fichiers existant. Les points d’auto-montage ont l’avantage que le système de fichiers demeure non monté, et donc dans un état propre, jusqu’au premier accès. Dans le mode auto-montage, le commutateur --timeout-idle-sec= (voir ci-après) peut être utilisé pour s’assurer que le point de montage soit démonté automatiquement après le dernier accès et une certaine période d’inactivité.

Si ce commutateur n’est pas spécifié, sa valeur par défaut est « false ». S’il n’est pas spécifié et que l’option --discover est utilisée (ou un seul argument est passé, ce qui implique --discover, voir ci-avant), et que le périphérique en mode bloc est détecté comme amovible, il est défini à « true » dans le but d’augmenter la possibilité que le système de fichiers soit complètement dans un état propre si le périphérique est extrait de manière brusque.

Ajouté dans la version 232.

-A

Équivalent à --automount=yes.

Ajouté dans la version 232.

--timeout-idle-sec=

Cette option définit une valeur temporelle contrôlant le délai d’inactivité dans le mode auto-montage. Si définie à « infinity » (valeur par défaut), aucun démontage automatique n’est réalisé. Sinon, le système de fichiers de soutien du point d’auto-montage est détaché après le dernier accès et le délai d’inactivité dépassé. Consultez systemd.time(7) pour les détails de la syntaxe temporelle gérée. Cette option n’a aucun effet dans le cas d’un montage normal et si l’auto-montage n’est pas utilisé.

Remarquez que si l’option --discover est utilisée (ou un seul argument est passé, ce qui implique --discover, voir ci-avant) et que le périphérique en mode bloc du système de fichiers est détecté amovible, l’option --timeout-idle-sec=1s est implicite.

Ajouté dans la version 232.

--automount-property=

Cette option est similaire à --property=, mais applique des propriétés supplémentaires à l’unité d’auto-montage créée au lieu de l’unité de montage.

Ajouté dans la version 232.

--bind-device

Cette option détermine si l’unité de montage ou d’auto-montage créée doit être liée à la durée de vie du périphérique de soutien. Ce réglage est particulièrement utile dans le mode auto-montage. Si elle est activée, les unités seront stoppées automatiquement lors de la disparition du périphérique de soutien. Par défaut, l’unité d’auto-montage ne quitte pas et les prochains accès bloqueront jusqu’à ce que le périphérique de soutien soit rebranché. Cette option n’a aucun effet dans le cas de montage ne concernant pas un périphérique, tel qu’un montage réseau ou de système de fichiers virtuel.

Si l’option --discover est utilisée (ou un seul argument est passé, ce qui implique --discover, voir ci-avant) et que le périphérique en mode bloc du système de fichiers est amovible, cette option est implicite.

Remarquez que les unités de montage obtiennent par défaut une dépendance Requires= sur le périphérique de soutien. Ce comportement peut être contrôlé avec l’option de montage x-systemd.device-bound= (voir systemd.mount(5) pour plus de renseignements). En particulier, x-systemd.device-bound=no a la priorité sur cette option et supprime les dépendances de périphérique à la fois dans les unités de montage générées et dans ce qui est impliqué par le gestionnaire de service.

Ajouté dans la version 232.

--list

Au lieu d’établir un point de montage ou d’auto-montage, cette option affiche une liste succincte des périphériques en mode bloc contenant des systèmes de fichiers pouvant être montés avec systemd-mount, et des métadonnées utiles telles que les étiquettes, etc.

Ajouté dans la version 232.

-u, --umount

Cette option arrête les unités de montage et d’auto-montage correspondant aux points de montage OÙ ou aux périphériques QUOI. systemd-mount avec cette option ou systemd-umount peuvent prendre plusieurs arguments qui peuvent être des points de montage, des périphériques, des noms de nœud de style /etc/fstab ou des fichiers de soutien correspondant aux périphériques boucle, tels que systemd-mount --umount /chemin/vers/umount /dev/sda1 UUID=xxxxxx-xxxx ÉTIQUETTE=xxxxx /chemin/vers/disque.img. Remarquez que lorsque l’option -H ou -M est spécifiée, seuls les chemins absolus de point de montage sont gérés.

Ajouté dans la version 233.

-G, --collect

Cette option décharge l’unité transitoire après qu’elle a terminé, même si elle échoue. Normalement, sans cette option, toutes les unités de montage qui sont montées et échouent sont conservées en mémoire jusqu’à ce que l’utilisateur réinitialise leur état d’échec avec l’option systemctl reset-failed ou une commande équivalente. D’un autre côté, les unités arrêtées avec succès sont déchargées immédiatement. Si cette option est activée, le « ramasse-miettes » (garbage collection) pour les unités est plus agressif, et décharge les unités sans tenir compte du fait qu’elles se soient terminées avec succès ou non. Cette option est un raccourci pour l’option --property=CollectMode=inactive-or-failed (consulter les explications concernant CollectMode= dans systemd.unit(5) pour davantage d’informations).

Ajouté dans la version 236.

-T, --tmpfs

Cette option crée et monte un nouveau système de fichiers tmpfs dans OÙ, avec un NOM facultatif dont la valeur par défaut est tmpfs.

Le système de fichiers est monté avec le mode du répertoire de premier niveau déterminé par le réglage d’umask(2) de l’appelant, c’est-à-dire rwxrwxrwx avec le masque umask de l’appelant. Cela correspond à ce que mkdir(1) réalise, mais c’est différent du réglage par défaut du noyau de « rwxrwxrwxt », c’est-à-dire un répertoire éditable par tout le monde avec le « sticky bit » positionné.

Ajouté dans la version 255.

--canonicalize=

Cette option contrôle si le chemin spécifié doit être mis sous forme canonique du côté client avant la requête de l’opération. Cette option prend un paramètre booléen (par défaut « true »). Remarquez que pour des opérations non locales (c’est-à-dire quand les options --machine= ou --host= sont utilisées), cette mise en forme est implicitement désactivée.

La mise sous forme canonique de chemin implique la résolution des liens symboliques et l’expansion d’éléments de chemin « .. » et de nœud de périphérique de style ÉTIQUETTE=/UUID=. Si cette mise sous forme est désactivée et que le chemin contient un élément de lien symbolique, « .. » ou un développement ÉTIQUETTE=/UUID=/..., l’opération échoue.

Ajouté dans la version 258.

--user

Échanger avec le gestionnaire de service de l'utilisateur appelant plutôt qu'avec le gestionnaire de service du système.

--system

Échanger avec le gestionnaire de service du système. C'est la valeur implicite par défaut.

-H, --host=

Effectuer l'opération à distance. Indiquer un nom d'hôte, ou un nom d'utilisateur et un nom d'hôte séparés par un « @ », auquel se connecter. Le nom d'hôte peut, de façon optionnelle, être suffixé par un port sur lequel ssh écoute, séparé par un « : », puis le nom d'un conteneur, séparé par un « / », ce qui connecte alors directement à un conteneur donné sur l'hôte spécifié. SSH sera utilisé pour dialoguer avec l’instance du gestionnaire de la machine distante. Les noms de conteneur peuvent être énumérés avec machinectl -H HÔTE. Mettre les adresses IPv6 entre crochets.

-M, --machine=

Effectuer l'opération dans un conteneur local. Préciser le nom d'un conteneur auquel se connecter, optionnellement préfixé par le nom d'utilisateur sous lequel se connecter et un caractère de séparation « @ ». Si la chaîne spéciale « .host » est utilisée à la place du nom du conteneur, une connexion au système local est effectuée (ce qui est utile pour se connecter au bus utilisateur d'un utilisateur particulier : « --user --machine=lennart@.host »). Si la syntaxe « @ » n'est pas utilisée, la connexion est réalisée en tant que superutilisateur. Si la syntaxe « @ » est utilisée, le côté gauche ou le côté droit peuvent être omis (mais pas les deux à la fois), auquel cas le nom de l'utilisateur local et « .host » sont implicites.

-h, --help

Afficher un aide-mémoire succinct et quitter.

--version

Afficher une information de version courte et quitter.

CODE DE RETOUR

En cas de succès, 0 est renvoyé, autrement, un code d'échec différent de zéro est renvoyé.

BASE DE DONNÉES UDEV

Si l’option --discover est utilisée, systemd-mount gère quelques propriétés udev(7) supplémentaires de périphériques en mode bloc :

SYSTEMD_MOUNT_OPTIONS=

Options de montage à utiliser si l’option --options= n’est pas utilisée.

Ajouté dans la version 232.

SYSTEMD_MOUNT_WHERE=

Chemin du système de fichiers où placer le point de montage au lieu d’un chemin automatiquement généré.

Ajouté dans la version 232.

EXEMPLE

Utiliser une règle udev telle que la suivante pour automatiquement monter tous les périphériques de stockage USB insérés :

ACTION=="add", SUBSYSTEMS=="usb", SUBSYSTEM=="block", ENV{ID_FS_USAGE}=="filesystem", \


        RUN{program}+="/usr/bin/systemd-mount --no-block --automount=yes --collect $devnode"

VOIR AUSSI

systemd(1), mount(8), systemctl(1), systemd.unit(5), systemd.mount(5), systemd.automount(5), systemd-run(1)

TRADUCTION

La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.

systemd 262.1