Manuels pour la ligne de commande

Man » Manuel umount en ligne - documentation en ligne détaillée pour la page de manuel umount

🌍
umount - démonter les systèmes de fichiers

SYNTAXE

umount -a [-dflnrv] [-t fstype] [-O option...]

umount [-dflnrv] {directory|device}

umount -h|-V

DESCRIPTION

La commande umount détache les systèmes de fichiers spécifiés de l’arborescence de fichiers. Un système de fichiers est spécifié en indiquant le répertoire où il a été monté. Indiquer le périphérique spécial sur lequel le système de fichiers réside peut également fonctionner, mais c’est obsolète, principalement parce que cela échouera si ce périphérique a été monté sur plusieurs répertoires.

Notez qu’un système de fichiers ne peut pas être démonté s’il est « actif » : par exemple, s’il y a des fichiers ouverts dessus, ou si un processus a son répertoire de travail, ou si un fichier d’échange dessus est utilisé. Le processus offensant pourrait même être umount lui-même : il ouvre libc, et libc à son tour peut ouvrir, par exemple, des fichiers de locale. Un démontage « paresseux » évite ce problème, mais cela peut introduire d’autres problèmes. Voir la description de l’option --lazy ci-dessous.

OPTIONS

-a, --all

Tous les systèmes de fichiers décrits dans /proc/self/mountinfo (ou dans le /etc/mtab obsolète) sont démontés, à l’exception des systèmes de fichiers proc, devfs, devpts, sysfs, rpc_pipefs et nfsd. Cette liste des systèmes de fichiers peut être remplacée par l’option --types umount.

-A, --all-targets

Démonter tous les points de montage dans l’espace de noms de montage actuel pour le système de fichiers spécifié. Le système de fichiers peut être spécifié par l’un des points de montage ou du nom du périphérique (ou UUID, etc.). Lorsque cette option est utilisée avec --recursive, tous les montages imbriqués dans le système de fichiers sont démontés récursivement. Cette option n’est prise en charge que sur les systèmes où /etc/mtab est un lien symbolique vers /proc/mounts.

-c, --no-canonicalize

Ne pas canoniser les chemins. La canonisation des chemins est basée sur les appels système stat(2) et readlink(2). Ces appels système peuvent se bloquer dans certains cas (par exemple sur NFS si le serveur n’est pas disponible). L’option doit être utilisée avec le chemin canonique du point de montage.

Cette option est ignorée silencieusement par umount pour les utilisateurs non root.

Pour plus de détails sur cette option, voir la page de manuel mount(8). Notez qu’umount ne transmet pas cette option aux assistants /sbin/umount.type.

-d, --detach-loop

Lorsque le périphérique démonté était un périphérique de boucle, libérer également ce périphérique de boucle. Cette option est inutile pour les périphériques initialisés par mount(8), dans ce cas, la fonctionnalité « autoclear » est activée par défaut.

--fake

Cela fait que tout est fait, à l’exception de l’exécution réelle de l’appel système ou de l’assistant umount ; cela « simule » le démontage du système de fichiers. Il peut être utilisé pour supprimer les entrées de l’ancien /etc/mtab qui ont été démontées précédemment avec l’option -n.


-f, --force

Force le démontage (en cas de système NFS inaccessible).

Notez que cette option ne garantit pas que la commande umount ne se bloquera pas. Il est fortement recommandé d’utiliser des chemins absolus sans liens symboliques afin d’éviter les appels de système readlink(2) et stat(2) non désirés sur un NFS inaccessible lors du démontage.

-i, --internal-only

Ne pas appeler le programme d’assistance /sbin/umount.filesystem, même s’il existe. Par défaut, un tel programme d’assistance est appelé s’il existe.

-l, --lazy

Démontage paresseux. Détachez le système de fichiers de la hiérarchie des fichiers maintenant, et nettoyez toutes les références à ce système de fichiers dès qu’il n’est plus utilisé.

Un redémarrage du système est à prévoir dans un avenir proche si vous comptez utiliser cette option pour un système de fichiers réseau ou un système de fichiers local avec des points de montage secondaires. L’utilisation recommandée de umount -l est d’éviter les blocages lors de l’arrêt en raison d’un partage réseau inaccessible, où une commande umount normale se bloquerait en raison d’un serveur hors service ou d’une partition réseau. Les remontages du partage ne seront pas possibles.

-N, --namespace ns

Effectuez le démontage dans l’espace de nom de montage spécifié par ns. ns est soit l’ID de processus d’un processus s’exécutant dans cet espace de nom, soit un fichier spécial représentant cet espace de nom.

umount bascule vers l’espace de nom lorsque la commande lit /etc/fstab, écrit dans /etc/mtab (ou écrit dans /run/mount) et appelle le système d’appel umount(2). Autrement, elle s’exécute dans l’espace de nom d’origine. Cela signifie que l’espace de nom de montage cible n’a pas besoin de contenir des bibliothèques ou d’autres exigences nécessaires à l’exécution de la commande umount(2).

Consultez mount_namespaces(7) pour plus d’informations.

-n, --no-mtab

Démontez sans écrire dans /etc/mtab.

-O, --test-opts option...

Démontez uniquement les systèmes de fichiers qui ont l’option spécifiée définie dans /etc/fstab. Plusieurs options peuvent être spécifiées dans une liste séparée par des virgules. Chaque option peut être préfixée par no pour indiquer qu’aucune action ne doit être effectuée pour cette option.

-q, --quiet

Supprimez les messages d’erreur « non monté ».

-R, --recursive

Démontez de manière récursive chaque répertoire spécifié. La récursion pour chaque répertoire s’arrêtera si une opération de démontage dans la chaîne échoue pour une raison quelconque. La relation entre les points de montage est déterminée par les entrées /proc/self/mountinfo. Le système de fichiers doit être spécifié par le chemin du point de montage ; le démontage récursif par nom de périphérique (ou UUID) n’est pas pris en charge. Depuis la version 2.37, il démonte également tous les systèmes de fichiers superposés (plusieurs systèmes de fichiers sur le même point de montage).

-r, --read-only

Lorsqu’un démontage échoue, essayez de remonter le système de fichiers en lecture seule.

-t, --types type...

Indiquez que les actions ne doivent être effectuées que sur les systèmes de fichiers du type spécifié. Plusieurs types peuvent être spécifiés dans une liste séparée par des virgules. La liste des types de systèmes de fichiers peut être préfixée par no pour indiquer qu’aucune action ne doit être effectuée pour tous les types mentionnés. Notez qu’umount lit les informations sur les systèmes de fichiers montés à partir du noyau (/proc/mounts) et que les noms des systèmes de fichiers peuvent être différents des noms des systèmes de fichiers utilisés dans /etc/fstab (par exemple, « nfs4 » par rapport à « nfs »).


-v, --verbose

Mode verbeux.

-h, --help

Affiche l’aide et quitte.

-V, --version

Affiche la version et quitte.

DÉMONTAGE POUR LES UTILISATEURS QUI NE SONT PAS L’UTILISATEUR ROOT

Normalement, seul l’utilisateur root peut démonter les systèmes de fichiers. Cependant, lorsqu’une ligne dans fstab contient l’option user, n’importe quel utilisateur peut démonter le système de fichiers correspondant. Pour plus de détails, consultez la page de manuel mount(8).

Depuis la version 2.34, la commande umount peut également être utilisée pour effectuer des opérations de démontage pour les systèmes de fichiers FUSE si la table de montage du noyau contient l’ID de l’utilisateur. Dans ce cas, l’option user= dans fstab n’est pas requise.

Depuis la version 2.35, la commande umount ne quitte pas lorsque les permissions de l’utilisateur sont inadéquates en raison des règles de sécurité internes de libmount. Elle supprime les permissions suid et continue en tant qu’utilisateur normal. Cela peut être utilisé pour prendre en charge les cas d’utilisation où les permissions root ne sont pas nécessaires (par exemple, les systèmes de fichiers FUSE, les espaces de noms utilisateur, etc.).

PÉRIPHÉRIQUE LOOP

La commande umount détachera automatiquement le périphérique loop précédemment initialisé par la commande mount(8), indépendamment de /etc/mtab.

Dans ce cas, le périphérique est initialisé avec le drapeau « autoclear » (voir la sortie de losetup(8) pour plus de détails). Sinon, il est nécessaire d’utiliser l’option --detach-loop ou d’appeler losetup -d device. La fonctionnalité autoclear est prise en charge depuis Linux 2.6.25.

Notez que depuis Linux v3.7, le noyau utilise la « destruction paresseuse du périphérique ». Le système marque simplement le périphérique loop avec le drapeau autoclear et le détruit plus tard. Si vous devez attendre la suppression complète du périphérique loop, appelez udevadm settle après umount.

CODE DE SORTIE

umount a les codes de sortie suivants (les bits peuvent être combinés avec l’opérateur OR) :

0   succès

1   invocation ou permissions incorrectes

2   erreur système (manque de mémoire, impossible de créer un nouveau processus, plus de périphériques loop disponibles)

4   erreur interne de montage

8   interruption de l’utilisateur

16  problèmes d’écriture ou de verrouillage de /etc/mtab

32  échec du montage

64  certains démontages ont réussi

La commande umount -a renvoie 0 (tous réussis), 32 (tous échoués) ou 64 (certains ont échoué, certains ont réussi).

126 échec de l’exécution du programme d’aide externe /sbin/umount.<type> (depuis util-linux v2.41)

PROGRAMMES D’AIDE EXTERNES

La syntaxe des programmes d’aide de démontage externes est :

umount.suffix {directory|device} [-flnrv] [-N namespace] [-t type.subtype]

où suffix est le type de système de fichiers (ou la valeur d’un marqueur uhelper= ou helper= dans le fichier mtab). L’option -t peut être utilisée pour les systèmes de fichiers qui prennent en charge les sous-types. Par exemple :

umount.fuse -t fuse.sshfs

Un marqueur uhelper=something peut apparaître dans le fichier /etc/mtab lorsque les utilisateurs ordinaires doivent être en mesure de démonter un point de montage qui n’est pas défini dans /etc/fstab (par exemple, pour un périphérique qui a été monté par udisks(1)).

Un marqueur helper=type dans le fichier mtab redirigera toutes les requêtes de démontage vers le programme d’aide /sbin/umount.type, indépendamment de l’UID.

Notez que /etc/mtab est actuellement obsolète et que les options d’espace de noms utilisateur et autres sont maintenues par libmount.

La valeur du code de retour du programme auxiliaire est renvoyée comme code de retour de umount(8). La valeur 126 est utilisée si le programme auxiliaire est trouvé, mais que l’appel à execl() échoue.

ENVIRONNEMENT

LIBMOUNT_FSTAB=<chemin>
remplace l’emplacement par défaut du fichier fstab (ignoré pour suid)

LIBMOUNT_DEBUG=all
active la sortie de débogage de libmount

FICHIERS

/etc/mtab
table des systèmes de fichiers montés (déprécié et généralement remplacé par un lien symbolique vers /proc/mounts)

/etc/fstab
table des systèmes de fichiers connus

/proc/self/mountinfo
table des systèmes de fichiers montés générée par le noyau.

HISTORIQUE

Une commande umount est apparue dans la version 6 d’AT&T UNIX.

VOIR AUSSI

umount(2), losetup(8), mount_namespaces(7), mount(8)

SIGNALEMENT DE BUGS

Pour les signalements de bugs, utilisez le système de suivi des problèmes [https://github.com/util-linux/util-linux/issues].

DISPONIBILITÉ

La commande umount fait partie du paquet util-linux qui peut être téléchargé sur l’archive Linux Kernel [https://www.kernel.org/pub/linux/utils/util-linux/].