Scroll to navigation

UMOUNT(2) Руководство программиста Linux UMOUNT(2)

ИМЯ

umount, umount2 - размонтирует файловую систему

СИНТАКСИС

#include <sys/mount.h>
int umount(const char *target);
int umount2(const char *target, int flags);

ОПИСАНИЕ

Вызовы umount() и umount2() удаляют подключение (самого верхнего уровня) к файловой системе, примонтированной к target.

Для размонтирования файловых систем требуются права (Linux: мандат CAP_SYS_ADMIN).

В Linux 2.1.116 добавлен системный вызов umount2(), который, подобно umount(), размонтирует заданный объект, но позволяет указать дополнительные флаги flags, контролирующие поведение операции:

Попросить файловую систему прервать ожидающие запросы перед попыткой размонтирования. Это может позволить выполнить размонтирование без ожидания недоступного сервера, но может привести к потере данных. Если после прерывания запросов некоторые процессы продолжат обращаться к файловой системе, размонтирование не будет выполнено. В Linux 4.12 MNT_FORCE поддерживается только в следующих файловых системах: 9p (начиная с Linux 2.6.16), ceph (начиная с Linux 2.6.34), cifs (начиная с Linux 2.6.12), fuse (начиная с Linux 2.6.16), lustre (начиная с Linux 3.11) и NFS (начиная с Linux 2.1.116).
Выполнить отложенное размонтирование: сделать точку монтирования недоступной для новых подключений, немедленно размонтировать файловую систему и все файловые системы, смонтированные ниже по дереву и по таблице монтирования, и выполнить настоящее размонтирование только когда точка доступа станет свободной.
Пометить точку монтирования как недействительную. Если точка монтирования в это время не используется, то первоначальный вызов umount2() с этим флагом завершится с ошибкой EAGAIN, но пометит точку монтирования как недействительную. Точка монтирования остаётся недействительной до тех пор, пока какой-нибудь процесс не запросит к ней доступ. Второй вызов umount2() с флагом MNT_EXPIRE размонтирует недействительную точку монтирования. Этот флаг нельзя указывать вместе с MNT_FORCE или MNT_DETACH.
Не следовать по ссылке, если target является символьной ссылкой. Это флаг помогает избежать проблем с безопасностью в программах принадлежащих root и с установленным битом set-user-ID, которые позволяют непривилегированным пользователям размонтировать файловые системы.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а errno устанавливается в соответствующее значение.

ОШИБКИ

Коды ошибок, описанные ниже, не зависят от типа файловой системы. У каждой файловой системы могут быть свои коды ошибок и своё собственное поведение. Подробности смотрите в исходном коде ядра Linux.

Вызов umount2() с флагом MNT_EXPIRE успешно пометил незанятую файловую систему как недействительную.
Объект target не может быть размонтирован, так как он занят.
Объект target указывает вне адресного пространства, доступного пользователю.
Значение target не является точкой монтирования.
Вызов umount2() был вызван с флагом MNT_EXPIRE и с MNT_DETACH или MNT_FORCE.
Вызов umount2() был сделан с неверным значением флага flags.
Значение пути длиннее чем MAXPATHLEN.
Указан пустой путь или одна из его частей не существует.
Ядро не может выделить свободную страницу для копирования имени файла или данных.
Вызывающий процесс не имеет требуемых привилегий.

ВЕРСИИ

Флаги MNT_DETACH и MNT_EXPIRE доступны в glibc начиная с версии 2.11.

СООТВЕТСТВИЕ СТАНДАРТАМ

Эти функции есть только в Linux, и они не должны использоваться в переносимых программах.

ЗАМЕЧАНИЯ

Вызов umount() и общие точки монтирования

Действия на точку монтирования, являющуюся общей, включая операции umount(), будут переданы каждой общей точке монтирования в этой группе и каждой подчинённой точке монтирования в этой группе. Это означает, что umount() члена из набора общих точек монтирования приведёт к размонтированию всех в его членов, а также всех их подчинённых.

Это распространение действия размонтирования может быть особенно удивительным в системах, где каждая точка монтирования является общей по умолчанию. В таких системах рекурсивно привязываемое монтирование корневого каталога файловой системы в подкаталог, а затем размонтирование этого подкаталога с MNT_DETACH приведёт к тому, что каждая точка монтирования в пространстве имён монтирования будет размонтирована в отложенном режиме.

Чтобы umount() также не делал, перед вызовом umount() точка монтирования может быть перемонтирована с помощью вызова mount(2) с аргументом mount_flags, в который добавлены MS_REC и MS_PRIVATE.

Историческая справка

Изначально функция umount() вызывалась как umount(device) и возвращала ENOTBLK при попытке работы с любым не блочным устройством. В Linux 0.98p4 был добавлен вызов umount(dir) для поддержки анонимных устройств. В Linux 2.3.99-pre7 был убран вызов umount(device), остался только umount(dir) (теперь устройства могут быть подключены более чем к одной точке, поэтому указания только устройства недостаточно).

СМ. ТАКЖЕ

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

ЗАМЕЧАНИЯ

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy Ovchinnikov <dmitriyxt5@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.

9 июня 2020 г. Linux