MAN chroot 2

Материал из Gentoo Linux Wiki

Вернуться в раздел мануалов

[править] Название

chroot - изменить корневой каталог

[править] Обзор

#include <unistd.h>
int chroot(const char * path );

[править] Описание

chroot изменяет корневой каталог на тот, что задан аргументом path . Этот каталог будет использоваться для имен файлов, начинающихся со /. Корневой каталог наследуется всеми потомками текущего процесса.

Только суперпользователь может изменять корневой каталог.

Заметьте, что этот системный вызов не изменяет текущий рабочий каталог, поэтому . может находиться вне дерева каталогов, начинающегося со /. В частности, суперпользователь может выбраться из-под chroot jail с помощью mkdir foo; chroot foo; cd ...

[править] Возвращаемое значение

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

[править] Ошибки

В зависимости от файловой системы могут появляться другие ошибки. Стандартные ошибки таковы:

0.8i EPERM Фактический UID не равен нулю.

EFAULT path указывает за пределы доступного адресного пространства.

ENAMETOOLONG path слишком длинно.

ENOENT Файл не существует.

ENOMEM Ядру не хватило памяти.

ENOTDIR Компонент пути, использованный как каталог в path , в действительности таковым не является.

EACCES В одном из каталогов, находящихся по пути к path , запрещен поиск.

ELOOP path является зацикленной символической ссылкой, то есть при подстановке возникает ссылка на неё саму.

EIO Произошла ошибка ввода-вывода.

[править] Соответствие стандартам

SVr4, SVID, 4.4BSD, X/OPEN. Эта функция не входит в POSIX.1. SVr4 документирует дополнительные коды ошибок EINTR, ENOLINK и EMULTIHOP. X/OPEN не документирует EIO, ENOMEM и EFAULT. Этот интерфейс помечен как "устаревающий" в X/OPEN.

[править] Смотри также

chdir (2)

[править] Перевод

Copyright (C) Alexey Mahotkin <alexm@hsys.msk.ru> 1999

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992

Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one

Since the Linux kernel and libraries are constantly changing, this
manual page may be incorrect or out-of-date. The author(s) assume no
responsibility for errors or omissions, or for damages resulting from
the use of the information contained herein. The author(s) may not
have taken the same level of care in the production of this manual,
which is licensed free of charge, as they might when working
professionally.

Formatted or processed versions of this manual, if unaccompanied by
the source, must acknowledge the copyright and authors of this work.

Modified by Michael Haardt <michael@moria.de>
Modified Wed Jul 21 22:18:17 1993 by Rik Faith <faith@cs.unc.edu>
Modified 21 Aug 1994 by Michael Chastain <mec@shell.portal.com>
Fixed typoes.
Modified 13 Jun 1996 by aeb - Added a warning: . may be outside / tree.
Modified Wed Nov 6 03:50:45 1996 by Eric S. Raymond <esr@thyrsus.com>
Modified by Joseph S. Myers <jsm28@cam.ac.uk>, 970821

Дата последней коррекции перевода 11.12.2003
Оригинальный перевод Алексея Махоткина <alexm@hsys.msk.ru> 1999-2001