ИМЯ

mount - применяется для монтирования файловых систем.

ОБЗОР

#include <sys/mount.h>

int mount(const char *source, const char *target,
const char *filesystemtype, unsigned long mountflags,
const void *data);

ОПИСАНИЕ

Вызов mount() подключает файловую систему, указанную в source (обычно здесь
задаётся название устройства, но также может быть указано имя каталога, или файла,
или фиктивное устройство), к пути заданному в target(каталогу или файлу).

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

Вариант filesystemtype доступные ядру перечислены в /proc/filesystems (например:
"btrfs", "ext4", "jfs", "xfs", "vfat", "fuse", "tmpfs", "cgroup", "proc",
"mqueue", "nfs", "cifs", "iso9660"). Дополнительные типы становятся доступными
после загрузки соответствующих модулей.

Аргумент data рассматривается каждой файловой системой по-своему. Обычно, это
строка параметров, перечисленных через запятую, которые понимает файловая система.
О том, какие параметры доступны для каждого типа файловой системы смотрите
mount(8).

Вызов mount() выполняет один из нескольких типов операций, в зависимости от
значений, указанных в mountflags. Выбор выполняемой операции определяется путем
тестирования значений, установленных в mountflags, с проведением тестов в
следующем порядке:

* Перемонтировать существующие точки монтирования: mountflags включает
MS_REMOUNT.

* Создать привязку (bind mount): mountflags включает MS_BIND.

* Изменить тип существующего монтирования: mountflags включает одно из MS_SHARED,
MS_PRIVATE, MS_SLAVE или MS_UNBINDABLE.

* Переместить существующее монтирование в новое место: mountflags включает
MS_MOVE.

* Создать новое монтирование: mountflags не содержит ни один из указанных выше
флагов.

Каждая из этих операций подробно описана далее на этой странице. Для изменения
поведения mount() могут быть указаны дополнительные флаги в mountflags, как
описано ниже.

Дополнительные флаги для монтирования
Ниже расположенный список дополнительных флагов, которые можно использовать в
mountflags. Обратите внимание на то, что некоторые из них или даже все
игнорируются операциями. Такие случае будут описаны далее по тексту.

MS_DIRSYNC (начиная с Linux 2.5.19)
(a) дескрипторы необходимо обновить для некоторого изменения, не
связанного с временными метками файлов;

(b) приложение использует fsync(2), syncfs(2), or sync(2);

(c) неиспользуемый дескриптор вытесняется из памяти; или

(d) прошло более 24 часов с момента записи дескриптора на диск.

Данный параметр монтирования существенно сокращает количество операций
записи, необходимых для обновления меток времени inode, особенно mtime и
atime. Однако, если произойдёт падение системы, то поля atime и mtime на
диске могут оказаться устаревшими на 24 часа.

В качестве примеров, где данный параметр может принести значительную выгоду это
частые произвольные операции записи в уже выделенные файлы, а также случаи, когда
также включён параметр монтирования MS_STRICTATIME (преимущество объединения
MS_STRICTATIME и MS_LAZYTIME в том, что stat(2) будет возвращать правильное
обновлённое время, но обновления atime будет производиться на диск только в
случаях перечисленных выше).

MS_MANDLOCK
Разрешить обязательную блокировку файлов в этой файловой системе
(обязательная блокировка всё равно сначала должна быть включена для
определённого файла как описано в fcntl(2)). Начиная с Linux 4.5 этот
параметр монтирования требует мандата CAP_SYS_ADMIN.

MS_NOATIME
Не обновлять время доступа для (всех типов) файлов в этой файловой системе.

MS_NODEV
Запретить доступ к устройствам (специальным файлам) в этой файловой
системе.

MS_NODIRATIME
Не обновлять время доступа для каталогов в этой файловой системе. Данный
флаг частично предоставляет свойство MS_NOATIME; то есть при MS_NOATIME
подразумевается MS_NODIRATIME.

MS_NOEXEC
Запретить исполнение программ в этой файловой системе.

MS_NOSUID
Не учитывать биты set-UID и set-GID или файловые мандаты при исполнении
программ в этой файловой системе.

MS_RDONLY
Подключить файловую систему в режиме только для чтения.

MS_REC (начиная с Linux 2.4.11)
Используется вместе с MS_BIND для создания рекурсивной точки монтирования и
вместе с флагами типа распространения для рекурсивного изменения типа
распространения всех точек монтирования в поддереве. Подробности смотрите
далее.

MS_RELATIME (начиная с Linux 2.6.20)
При доступе к файлу на этой файловой системе значение времени последнего

MS_SILENT (начиная с Linux 2.6.17)
Не выводить определённые (printk()) предупреждающие сообщения в журнал
ядра. Этот флаг заменяет неправильно названный и устаревший флаг MS_VERBOSE
(доступный начиная с Linux 2.4.12), который выполняет такую же функцию.

MS_STRICTATIME (начиная с Linux 2.6.30)
Всегда обновлять время последнего доступа (atime) при доступе к файлам на
этой файловой системе (это выполнялось по умолчанию до Linux 2.6.30).
Задание этого флага отменяет поведение флагов MS_NOATIME и MS_RELATIME.

MS_SYNCHRONOUS
Осуществлять запись на эту файловую систему синхронно (как если бы флаг
O_SYNC для open(2) был указан для всех файлов, открытых на этой файловой
системе).

Начиная с Linux 2.4 флаги MS_NODEV, MS_NOEXEC и MS_NOSUID можно устанавливать на
точки монтирования. Начиная с ядра l 2.6.16 флаги MS_NOATIME и MS_NODIRATIME также
можно устанавливать на точки монтирования. Флаг MS_RELATIME также можно
устанавливать на точки монтирования. Начиная с Linux 2.6.16 флаг MS_RDONLY может
устанавливаться и сбрасываться на точках монтирования, а также на нижележащей
файловой системе. Смонтированная файловая система будет доступна на запись только,
если сама или её точка монтирования не были помечены как только для чтения.

Перемонтированние существующих точек монтирования.
Существующие монтирования можно перемонтировать, указав MS_REMOUNT в mountflags.
Это позволяет изменить mountflags и data существующих монтирований без
необходимости размонтировать и заново монтировать файловую систему. target должен
соответствовать указанному при начальном вызове mount().

Аргументы source и filesystemtype игнорируются.

Аргументы mountflags и data должны совпадать со значениями, используемыми в
первоначальном вызове mount(), за исключением параметров, которые были
преднамеренно изменены. Ещё одним исключением является то, что флаг MS_BIND имеет
другой смысл для перемонтирования и должен включаться только, если это
действительно нужно.

Следующие mountflags могут быть изменены: MS_LAZYTIME, MS_MANDLOCK, MS_NOATIME,
MS_NODEV, MS_NODIRATIME, MS_NOEXEC, MS_NOSUID, MS_RELATIME, MS_RDONLY, и
MS_SYNCHRONOUS. Попытки изменить значения флага MS_DIRSYNC во время
перемонтирования тихо игнорируются.

Начиная с Linux 3.17, если не одно из значений MS_NOATIME, MS_NODIRATIME,
MS_RELATIME, или MS_STRICTATIME не указано в mountflags , то при перемонтировании
сохраняются текущие значения этих флагов (а не изменяются на значение по умолчанию
MS_RELATIME).

Начиная с Linux 2.6.26, данный флаг можно использовать вместе с MS_BIND для
изменения только флагов, касающихся точки монтирования. В частности, это полезно
для установки или сброса флага «только для чтения» на точке монтирования без
изменения нижележащей файловой системы. При значении mountflags:

MS_REMOUNT | MS_BIND | MS_RDONLY

будет обеспечен доступ к этой точке монтирования в режиме только для чтения, без
изменения других точек монтирования.
Остальные биты в аргументе mountflags также игнорируются, за исключением MS_REC
(привязка монтирования имеет те же параметры монтирования что и задействованная
точка монтирования). Однако посмотрите обсуждение перемонтирования, представленное
выше, о том, как сделать существующую привязку монтирования доступной только для
чтения.

По умолчанию, когда каталогу назначена привязка монтирования, монтируется только
этот каталог; если существуют другие подмонтирования в дереве каталогов, то им не
назначается привязка монтирования. Если также указан флаг MS_REC, то выполняется
операция рекурсивной привязки монтирования: всем подмонтированиям в поддереве
source (отличным от непривязываемых монтирований) также назначается привязка
монтирования в соответствующее расположение к поддереве target.

Изменение типа распространения существующего монтирования
Если mountflags содержит один из флагов MS_SHARED, MS_PRIVATE, MS_SLAVE, или
MS_UNBINDABLE (все доступны начиная с Linux 2.6.15), то тип распространения
существующего монтирования изменяется. Если указано сразу несколько из этих
флагов, то возвращается ошибка.

Только флаги MS_REC т MS_SILENT можно использовать для изменения типа
монтирования.

Аргументы source, filesystemtype и data игнорируются.

Назначение флагов типа распространения следующее:

MS_SHARED
Делает эту точку монтирования общей. События монтирования и размонтирования
этой точки сразу же распространяются на другие точки монтирования,
являющиеся членами её равноправной группы. Распространение здесь означает,
что монтирование или размонтирование автоматически происходит и у всех
остальных точек монтирования в равноправной группе. И наоборот, события
монтирования и размонтирования, возникшие у точек монтирования равноправной
группы, будут распространены и на эту точку монтирования.

MS_PRIVATE
События монтирования и размонтирования не распространяются в эту точку и от
этой точки.

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

Если точка монтирования подчинённая, то события монтирования и размонтирования
распространяются на эту точку монтирования из (главной) общей равноправной группы,
в которую она раньше входила. События монтирования и размонтирования этой точки не
распространяются на членов группы.

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

MS_UNBINDABLE
Делает эту точку монтирования непривязываемой. Она подобна индивидуальной
точке монтирования плюс недоступна привязка монтирования. При рекурсивной

распространения по умолчанию, назначаемый новым точкам монтирования) смотрите в
mount_namespaces(7).

Перемещение точки монтирования
Если в mountflags содержится флаг MS_MOVE (доступен, начиная с Linux 2.4.18), то
перемещается поддерево: в source задаётся существующая точка монтирования, а
target указывается новое расположение, в которое будет перемещена точка
монтирования. Перемещение атомарно: поддерево всегда смонтировано.

Оставшиеся биты в аргументе mountflags игнорируются, как и аргументы
filesystemtype и data.

Создание новой точки монтирования
В том случае, если ни одно из значений MS_REMOUNT, MS_BIND, MS_MOVE, MS_SHARED,
MS_PRIVATE, MS_SLAVE, или MS_UNBINDABLE не указано в mountflags, вызов mount()
выполняет действие по умолчанию: создаёт новую точку монтирования. В source
задаётся источник новой точки монтирования, а значение target указывает каталог,
в котором будет создана точка монтирования.

Используются аргументы filesystemtype и data, дополнительные параметры для
изменения поведения могут быть указаны в mountflags.

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

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

ОШИБКИ

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

EACCES Поиск запрещён из-за одной части пути, которая не доступна для просмотра и
поиск (см. подробнее в path_resolution(7)).

EACCES Было предпринята попытка монтирования файловой системы доступной только на
чтение, но без флага ms_rdonly.

EACCES Блочное устройство source найдено на файловой системе смонтированное с
опцией MS_NODEV

EBUSY источник уже смонтирован.

EBUSY source не может быть перемонтирован с доступом только на чтение, потому что
он все ещё содержит файлы, открытые для записи.

EBUSY source не может быть смонтирована в target, так как target сейчас занята
(является рабочим каталогом какой-то нити, точкой монтирования другого
устройства, содержит открытые файлы и т.д.).

EFAULT Один из аргументов-указателей указывает на каталог за пределами
пользовательского адресного пространства.

EINVAL источник имеет недоступный суперблок.

EINVAL Была предпринята попытка перемонтирования (MS_REMOUNT), но source еще не
был смонтирован в target.

EINVAL Была попытка выполнить связанное монтирование, как несвязанное
монтирование.

ELOOP Во время разбора имён найдено слишком много ссылок.

ELOOP Сделана попытка перемещения, но цель оказалась подкаталогом источника.

EMFILE (В случае, если не требуются блочные устройства): таблица фиктивных
устройств переполнена.

ENAMETOOLONG
Значение пути длиннее чем MAXPATHLEN.

ENODEV Тип из filesystemtype в ядре не настроен.

ENOENT Указан пустой путь или одна из его частей не существует.

ENOMEM Ядро не может выделить свободную страницу для копирования имени файла или
данных.

ENOTBLK
Значение source не является блочным устройством (а устройство было
запрошено).

ENOTDIR
Значение target или префикс source не является каталогом.

ENXIO Старший номер блочного устройства source вне допустимого диапазона.

EPERM Вызывающий процесс не имеет требуемых привилегий.

ВЕРСИИ

Определения MS_DIRSYNC, MS_MOVE, MS_PRIVATE, MS_REC, MS_RELATIME, MS_SHARED,
MS_SLAVE, MS_STRICTATIME и MS_UNBINDABLE были добавлены в заголовочные файлы
glibc начиная с версии 2.12.

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

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

ЗАМЕЧАНИЯ

Начиная с Linux 2.4 одна файловая система может быть смонтирована в множество
точек монтирования, также множественное монтирование может осуществляться в одну
точку.

В верхних 16 битах аргумента mountflags может содержаться магическое число 0xC0ED
(MS_MGC_VAL) (все остальные флаги из ОПИСАНИЯ находятся в младших 16 битах
mountflags). Указание MS_MGC_VAL было требованием ядра до версии 2.4, но начиная с
Linux 2.4 этого больше не нужно, и число игнорируется, если указано.

Изначальный флаг MS_SYNC был переименован в MS_SYNCHRONOUS в 1.1.69, когда в
<mman.h> был добавлен другой флаг MS_SYNC.

До Linux 2.4 попытка выполнения программ set-UID или set-GID на файловой системе,
подключённой с параметром MS_NOSUID, вызывает ошибку EPERM. Начиная с Linux 2.4
биты set-UID и set-GID в этом случае негласно игнорируются.


Процесс-потомок, создаваемый fork(2), использует родительское пространство имён
монтирования совместно с родителем; пространство имён монтирования сохраняется при
вызове execve(2).

Процесс может получить собственное пространство имён монтирования если: он был
создан с помощью clone(2) с флагом CLONE_NEWNS; в этом случае его новое
пространство имён инициализируется копией пространства имён процесса, который
вызвал clone(2); или он вызовет unshare(2) с флагом CLONE_NEWNS; в этом случае
пространство имён вызвавшего получит свою копию пространства имён, которое он
раньше совместно использовал с другими процессами, и дальнейшие монтирования и
размонтирования вызвавшим будут невидимы другим процессам (за исключением
потомков, которые вызывающий создаст позже) и наоборот.

Файл /proc/[pid]/mounts, который есть только в Linux, содержит список точек
монтирования в пространстве имён монтирования процесса с заданным ID; подробней
см. в proc(5).

СМОТРИТЕ ТАКЖЕ

mountpoint(1), umount(2), mount_namespaces(7), path_resolution(7), findmnt(8),
lsblk(8), mount(8), umount(8)