Руководства по командной строке

Man » umount Manual online - подробная онлайн-документация для страницы руководства umount

🌍
umount - отмонтировать файловые системы

СИНТАКСИС

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

umount [-dflnrv] {directory|device}

umount -h|-V

ОПИСАНИЕ

Команда umount отключает указанные файловые системы от файловой иерархии. Файловая система указывается путем указания каталога, в котором она смонтирована. Указание специального устройства, на котором находится файловая система, также может работать, но это устарело, главным образом потому, что это не удастся, если это устройство смонтировано более чем в одном каталоге.

Обратите внимание, что файловую систему нельзя отмонтировать, когда она «занята», например, когда есть открытые файлы на ней, или когда какой-либо процесс использует ее в качестве рабочего каталога, или когда файл подкачки на ней используется. Процесс, вызывающий umount, может даже быть проблемным — он открывает libc, а libc, в свою очередь, может открывать, например, файлы локали. Ленивое отмонтирование позволяет избежать этой проблемы, но оно может привести к другим проблемам. См. описание параметра --lazy.

ОПЦИИ

-a, --all

Все файловые системы, описанные в /proc/self/mountinfo (или в устаревшем /etc/mtab), отмонтируются, за исключением файловых систем proc, devfs, devpts, sysfs, rpc_pipefs и nfsd. Этот список файловых систем можно заменить опцией --types umount.

-A, --all-targets

Отмонтировать все точки монтирования в текущем пространстве имен монтирования для указанной файловой системы. Файловая система может быть указана одной из точек монтирования или именем устройства (или UUID и т. д.). При использовании этой опции вместе с --recursive все вложенные точки монтирования в файловой системе будут рекурсивно отмонтированы. Эта опция поддерживается только в системах, где /etc/mtab является символической ссылкой на /proc/mounts.

-c, --no-canonicalize

Не выполнять канонизацию путей. Канонизация путей основана на системных вызовах stat(2) и readlink(2). Эти системные вызовы могут зависать в некоторых случаях (например, в NFS, если сервер недоступен). Опция должна использоваться с каноническим путем к точке монтирования.

Эта опция игнорируется umount для пользователей, не являющихся root.

Для получения дополнительной информации об этой опции см. страницу руководства mount(8). Обратите внимание, что umount не передает эту опцию в вспомогательные программы /sbin/umount.type.

-d, --detach-loop

Если отмонтированное устройство было устройством loop, также освободите это устройство loop. Эта опция не требуется для устройств, инициализированных с помощью mount(8), в этом случае функция «autoclear» включена по умолчанию.

--fake

Принуждает к выполнению всего, кроме фактического системного вызова или выполнения вспомогательной программы umount; это «имитирует» отмонтирование файловой системы. Его можно использовать для удаления записей из устаревшего /etc/mtab, которые были отмонтированы ранее с помощью опции -n.

-f, --force

Принудительно выполнить отмонтирование (в случае недоступной системы NFS).

Обратите внимание, что эта опция не гарантирует, что команда umount не зависнет. Настоятельно рекомендуется использовать абсолютные пути без символических ссылок, чтобы избежать нежелательных системных вызовов readlink(2) и stat(2) в NFS в umount.

-i, --internal-only

Не вызывать вспомогательную программу /sbin/umount.filesystem, даже если она существует. По умолчанию такая вспомогательная программа вызывается, если она существует.

-l, --lazy

Ленивое отмонтирование. Отключите файловую систему от файловой иерархии сейчас и очистите все ссылки на эту файловую систему, как только она перестанет быть занятой.

Перезагрузка системы ожидается в ближайшем будущем, если вы собираетесь использовать эту опцию для сетевой файловой системы или локальной файловой системы с вложенными точками монтирования. Рекомендуемый вариант использования umount -l - предотвратить зависания при завершении работы из-за недоступного сетевого ресурса, когда обычное отмонтирование зависнет из-за неработающего сервера или сетевого разделения. Повторное монтирование ресурса не будет возможным.

-N, --namespace ns

Выполнить отмонтирование в пространстве имен монтирования, указанном в ns. ns — это либо PID процесса, работающего в этом пространстве имен, либо специальный файл, представляющий это пространство имен.

umount переключается в пространство имен, когда он считывает /etc/fstab, записывает /etc/mtab (или записывает в
/run/mount) и вызывает системный вызов umount(2), в противном случае он выполняется в исходном пространстве имен. Это означает, что целевое пространство имен монтирования не должно содержать какие-либо библиотеки или другие
требования, необходимые для выполнения команды umount(2).

См. mount_namespaces(7) для получения дополнительной информации.

-n, --no-mtab

Отмонтировать без записи в /etc/mtab.

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

Отмонтировать только те файловые системы, для которых указана указанная опция в /etc/fstab. Можно указать несколько параметров в списке, разделенных запятыми. Каждая опция может быть префиксирована словом no, чтобы указать, что для этой опции не следует предпринимать никаких действий.

-q, --quiet

Подавлять сообщения об ошибках «не смонтировано».

-R, --recursive

Рекурсивно отмонтировать каждую указанную директорию. Рекурсия для каждой директории прекратится, если какая-либо операция отмонтирования в цепочке не удастся по какой-либо причине. Отношения между точками монтирования определяются записями /proc/self/mountinfo. Файловая система должна быть указана путем к точке монтирования; рекурсивное отмонтирование по имени устройства (или UUID) не поддерживается. Начиная с версии 2.37, она также отмонтирует все перекрывающиеся файловые системы (несколько файловых систем в одной точке монтирования).

-r, --read-only

Если отмонтирование не удается, попытайтесь повторно смонтировать файловую систему в режиме только для чтения.

-t, --types type...

Укажите, что действия следует выполнять только для файловых систем указанного типа. Можно указать несколько типов в списке, разделенных запятыми. Список типов файловых систем можно префиксировать словом no, чтобы указать, что для всех указанных типов не следует предпринимать никаких действий. Обратите внимание, что umount считывает информацию о смонтированных файловых системах из ядра (/proc/mounts) и имена файловых систем могут отличаться от имен файловых систем, используемых в /etc/fstab (например, «nfs4» против «nfs»).

-v, --verbose

Подробный режим.

-h, --help

Отобразить текст справки и выйти.

-V, --version

Отобразить версию и выйти.

ОТМОНТИРОВАНИЕ ФАЙЛОВЫХ СИСТЕМ ОРДИНАРНЫМИ ПОЛЬЗОВАТЕЛЯМИ

Обычно отмонтировать файловые системы может только суперпользователь. Однако, если в файле fstab для определенной строки указана опция user, любой пользователь может отмонтировать соответствующую файловую систему. Подробности см. в mount(8) man-странице.

Начиная с версии 2.34, команда umount также может использоваться для выполнения операции отмонтирования для файловых систем FUSE, если таблица монтирования ядра содержит идентификатор пользователя. В этом случае опция монтирования user= в fstab не требуется.

Начиная с версии 2.35, команда umount не завершается с ошибкой, когда разрешения пользователя недостаточны из-за внутренних правил безопасности libmount. Она отключает права suid и продолжает работу как обычный пользователь, не являющийся root. Это можно использовать для поддержки сценариев, в которых права root не требуются (например, файловые системы FUSE, пространства имен пользователей и т. д.).

УСТРОЙСТВО LOOP

Команда umount автоматически отсоединяет устройство loop, которое ранее было инициализировано командой mount(8), независимо от /etc/mtab.

В этом случае устройство инициализируется с флагом «autoclear» (см. вывод команды losetup(8) для получения дополнительной информации), в противном случае необходимо использовать опцию --detach-loop или вызвать losetup -d device. Поддержка функции autoclear реализована, начиная с Linux 2.6.25.

Обратите внимание, что начиная с ядра Linux v3.7 используется «ленивое уничтожение устройства». Система просто помечает устройство loop флагом autoclear и уничтожает его позже. Если вам нужно дождаться полного удаления устройства loop, вызовите udevadm settle после umount.

СТАТУС ВЫХОДА

Команда umount имеет следующие коды выхода (биты можно объединять с помощью побитового ИЛИ):

0   успех

1   неверный синтаксис или отсутствие разрешений

2   системная ошибка (недостаточно памяти, невозможно создать новый процесс, нет доступных устройств loop)

4   внутренняя ошибка монтирования

8   прервано пользователем

16  проблемы с записью или блокировкой `/etc/mtab`

32  ошибка монтирования

64  некоторые операции отмонтирования выполнены успешно

Команда umount -a возвращает 0 (все выполнено успешно), 32 (все операции завершились неудачей) или 64 (некоторые операции выполнены успешно, некоторые — неудачно).

126 не удалось выполнить внешнюю программу-помощник монтирования/отмонтирования `/sbin/umount.<type>` (начиная с util-linux v2.41)

ВНЕШНИЕ ПОМОЩНИКИ

Синтаксис внешних программ-помощников отмонтирования:

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

где `suffix` — тип файловой системы (или значение из маркера `uhelper=` или `helper=` в файле `mtab`). Опция `-t` может использоваться для файловых систем, которые поддерживают подтипы. Например:

umount.fuse -t fuse.sshfs

Маркер `uhelper=something` (непривилегированный помощник) может появиться в файле `/etc/mtab`, когда обычным пользователям необходимо иметь возможность отмонтировать точку монтирования, которая не определена в `/etc/fstab` (например, для устройства, которое было смонтировано udisks(1)).

Маркер `helper=type` в файле `mtab` перенаправит все запросы на отмонтирование в программу-помощник `/sbin/umount.type`, независимо от UID.

Обратите внимание, что /etc/mtab в настоящее время устарел, и helper= и другие опции монтирования, используемые в пользовательском пространстве, поддерживаются libmount.

Код выхода программы-помощника возвращается как код выхода umount(8). Значение 126 используется, если программа-помощник монтирования найдена, но вызов execl() завершился неудачей.

ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ

LIBMOUNT_FSTAB=<path>
переопределяет местоположение файла `fstab` по умолчанию (игнорируется для suid)

LIBMOUNT_DEBUG=all
включает отладочный вывод libmount

ФАЙЛЫ

/etc/mtab
таблица смонтированных файловых систем (устарела и обычно заменена символической ссылкой на /proc/mounts)

/etc/fstab
таблица известных файловых систем

/proc/self/mountinfo
таблица смонтированных файловых систем, генерируемая ядром.

ИСТОРИЯ

Команда umount появилась в Version 6 AT&T UNIX.

ССЫЛКИ

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

СООБЩЕНИЕ ОБ ОШИБКАХ

Для сообщений об ошибках используйте систему отслеживания проблем [https://github.com/util-linux/util-linux/issues].

ДОСТУПНОСТЬ

Команда umount является частью пакета util-linux, который можно загрузить с Linux Kernel Archive [https://www.kernel.org/pub/linux/utils/util-linux/].