umount, umount2 - Démonter un système de fichiers
Bibliothèque C standard (
libc,
-lc)
#include <sys/mount.h>
int umount(const char *target);
int umount2(const char *target, int flags);
umount() et
umount2() suppriment l'attachement du système
de fichiers (de plus haut niveau) monté sur le répertoire
target.
Les privilèges appropriés (sous Linux : la capacité
CAP_SYS_ADMIN) sont requis pour démonter des systèmes de
fichiers.
Depuis Linux 2.1.116 l'appel système
umount2() fonctionne
comme
umount(), mais dispose d'options supplémentaires
(
flags) configurant le comportement de l'opération :
-
MNT_FORCE (depuis Linux 2.1.116)
- Demander au système de fichiers d'abandonner les
requêtes en attente avant de tenter le démontage. Cela peut
permettre au démontage de terminer sans attendre un serveur
inaccessible, mais pourrait provoquer la perte de données. Si
après l'abandon des requêtes, certains processus ont encore
des références en cours au système de fichiers, le
démontage va encore échouer. Au moment de la
version 4.12, MNT_FORCE n'est prise en charge que sur les
systèmes de fichiers suivants : 9p (depuis
Linux 2.6.16), ceph (depuis Linux 2.6.34), cifs (depuis
Linux 2.6.12), fuse (depuis Linux 2.6.16), lustre (depuis
Linux 3.11) et NFS (depuis Linux 2.1.116).
-
MNT_DETACH (depuis Linux 2.4.11)
- Faire un détachement paresseux : rendre le
montage non disponible pour les nouveaux accès, déconnecter
immédiatement le système de fichiers et tous les
systèmes de fichiers montés en dessous de lui les uns des
autres et de la table de montage, puis réaliser effectivement le
démontage lorsque le montage ne sera plus occupé.
-
MNT_EXPIRE (depuis Linux 2.6.8)
- Marquer le montage comme ayant expiré. Si un montage
n'est pas utilisé, un premier appel à umount2() avec
ce paramètre échoue avec l'erreur EAGAIN, mais marque
le montage comme expiré. Il reste dans cet état tant
qu'aucun processus n'y accède. Un second appel à
umount2() avec MNT_EXPIRE détache le montage
expiré. Ce paramètre ne peut être combiné avec
MNT_FORCE ou MNT_DETACH.
-
UMOUNT_NOFOLLOW (depuis Linux 2.6.34)
- Ne pas déréférencer target s'il
s'agit d'un lien symbolique. Ce paramètre permet d'éviter
des problèmes de sécurité dans des programmes
set-UID- root qui permettent aux utilisateurs ordinaires de
démonter des systèmes de fichiers.
En cas de succès, zéro est renvoyé. En cas d'erreur,
-1 est renvoyé et
errno est définie pour
préciser l'erreur.
Les erreurs détaillées ici sont indépendantes du type de
système de fichiers. Chaque type de système peut avoir des codes
d'erreurs spécifiques, et un comportement particulier. Consultez les
sources du noyau Linux pour plus de détails.
- EAGAIN
- Un appel à umount2() avec l'attribut
MNT_EXPIRE a marqué correctement un système de
fichiers non utilisé comme expiré.
- EBUSY
-
target ne peut pas être démonté
car il est occupé.
- EFAULT
-
target pointe en dehors de l'espace d'adressage de
l'utilisateur.
- EINVAL
-
target n'est pas un point de montage.
- EINVAL
-
target est verrouillé ; consultez
mount_namespaces(7).
- EINVAL
-
umount2() a été appelé avec
l'option MNT_EXPIRE, en même temps que MNT_DETACH ou
MNT_FORCE.
-
EINVAL (depuis Linux 2.6.34)
-
umount2() a été appelé avec une
valeur non autorisé dans flags.
- ENAMETOOLONG
- Un des arguments est plus long que MAXPATHLEN.
- ENOENT
- Un des chemins est vide ou a un composant inexistant.
- ENOMEM
- Le noyau n'a pas pu allouer suffisamment de
mémoire.
- EPERM
- L'appelant n'a pas les privilèges
appropriés.
MNT_DETACH et
MNT_EXPIRE sont disponibles depuis la
glibc 2.11.
Ces fonctions sont spécifiques à Linux et ne doivent pas
être employées dans des programmes destinés à
être portables.
Les montages partagés font que toutes les activités de montage sur
un montage, y compris les opérations
umount(), seront transmises
sur chaque montage partagé dans le groupe de pairs et tous les montages
esclaves de ce groupe de pairs. Cela signifie qu'une opération
umount() sur n'importe quel pair d'un ensemble de montages
partagés fera que tous ses pairs seront démontés et que
tous leurs esclaves seront aussi démontés.
La propagation de cette activité de démontage peut être
particulièrement surprenante sur les systèmes où chaque
montage est partagé par défaut. Sur ce type de système,
le montage lié de façon récursive du répertoire
racine du système de fichiers sur un sous-répertoire et ensuite
le démontage de ce sous-répertoire avec l'option
MNT_DETACH feront que chaque montage dans l'espace de montage sera
détaché paresseusement.
Pour s'assurer qu'
umount() ne se propage pas de cette manière, le
montage peut être remonté par un appel
mount(2) avec un
argument
mount_flags qui comprend à la fois
MS_REC et
MS_PRIVATE avant que
umount() ne soit appelé.
La fonction
umount d'origine était invoquée avec
umount(périphérique) et renvoyait
ENOTBLK si
l'argument était autre chose qu'un périphérique bloc.
Dans Linux 0.98p4, un appel
umount(répertoire) a
été ajouté afin de gérer des
périphériques anonymes. Dans Linux 2.3.99-pre7, l'appel
umount(périphérique) a été supprimé,
en ne gardant que
umount(répertoire) (car maintenant les
périphériques peuvent être montés en plusieurs
endroits et l'indication du périphérique ne suffit plus).
mount(2),
mount_namespaces(7),
path_resolution(7),
mount(8),
umount(8)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Jean-Pierre Giraud <
[email protected]>
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 à
[email protected]