pivot_root - изменяет корневую файловую систему
pivot_root(2)
изменяет корневую файловую систему
ОБЗОР
int pivot_root(const char *new_root, const char *put_old);
Замечание:В glibc нет обёрточной функции для данного системного вызова;
смотрите
ЗАМЕЧАНИЯ.
ОПИСАНИЕ
Вызов
pivot_root() перемещает корневую систему вызывающего процесса в
каталог
put_old и делает каталог
new_root новой корневой файловой
системой у вызывающего процесса.
Обычно, pivot_root() используется при загрузке, когда система монтирует
временную корневую файловую систему (например, initrd), а затем монтирует
настоящую корневую файловую систему, делая, тем самым, её корневой для всех
последующих процессов или нитей.
Вызов pivot_root() может изменить (или не изменить) текущий корневой и
текущий рабочий каталоги во всех процессах или нитях, использующих старый
корневой каталог. Вызывающий pivot_root() должен быть уверен в том, что
процессы у которых корневой или текущий рабочий каталог равен старому
корневому каталогу, работают нормально в каждом случае. Самый простой способ
достичь этого — сменить их корневой и текущий рабочий каталог на new_root
до вызова pivot_root().
Содержимое предыдущего абзаца, на самом деле, является не совсем
определённым, потому что реализация pivot_root() может измениться в
будущем. На момент написания этого документа pivot_root() изменяет
корневой и текущий рабочий каталоги каждого процесса или нити на
new_root, если они указывают на старый корневой каталог. Это необходимо
для того, чтобы нити ядра не занимали старый корневой и текущий рабочий
каталог, даже если они вообще не обращались к файловой системе. В будущем,
возможно, будет создан механизм, заставляющий нити ядра отказаться от
доступа к файловой системе, что позволит удалить этот довольно навязчивый
механизм из pivot_root().
Заметим, что всё это относится и к вызывающему процессу: pivot_root()
может изменить (а может и не изменить) его текущий рабочий каталог. По этой
причине рекомендуется вызывать chdir("/") сразу после вызова
pivot_root().
На значения new_root и put_old накладываются следующие ограничения:
-
Они должны быть каталогами.
-
Аргументы
new_root и
put_old не могут быть в одной файловой системе с
текущим корневым каталогом.
-
Аргумент
put_old должен быть в дереве каталогов
new_root, т.е., путём
добавления ненулевого количества
/.. в строке, на которую указывает
put_old, можно получить каталог, равный
new_root.
-
К
put_old не должны быть подмонтированы файловые системы.
См. также страницу pivot_root(8), в которой приведены примеры возможного
использования.
Если текущий корневой каталог не является точкой монтирования (например,
после chroot(2) или pivot_root(), см. ниже), то к put_old
подключается не старый корневой каталог, а точка монтирования этой файловой
системы.
Аргумент new_root может и не быть точкой монтирования. В этом случае в
/proc/mounts будет указана точка монтирования файловой системы,
содержащей новый new_root как корневой каталог (/).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении возвращается 0. В случае ошибки возвращается -1, а
errno устанавливается в соответствующее значение.
ОШИБКИ
Вызов
pivot_root() может возвращать (в
errno) любые ошибки, которые
возвращаются
stat(2). Также он может вернуть:
EBUSY
Аргумент new_root или put_old находится в текущей корневой файловой
системе, или какая-то файловая система уже смонтирована в put_old.
EINVAL
Аргумент put_old не находится в дереве каталогов new_root.
ENOTDIR
Аргумент new_root или put_old не является каталогом.
EPERM
Вызывающий процесс не имеет мандата CAP_SYS_ADMIN.
ВЕРСИИ
Вызов
pivot_root() появился в Linux 2.3.41.
СООТВЕТСТВИЕ СТАНДАРТАМ
Вызов
pivot_root() есть только в Linux и поэтому его использование не
переносимо.
ЗАМЕЧАНИЯ
В glibc нет обёртки для данного системного вызова; запускайте его с помощью
syscall(2).
ДЕФЕКТЫ
Вызов
pivot_root() не должен изменять корневой и рабочий каталоги других
процессов в системе.
Некорректное использование pivot_root() может привести к непредсказуемым
последствиям.
