CHROOT(2)

NOMBRE
chroot - cambia el directorio raíz.

SINOPSIS
#include <unistd.h>

int chroot(const char *path);

DESCRIPCIÓN
chroot cambia el directorio raíz a aquel especificado en path. Este directorio será usado como el principio de caminos (paths) iniciados en /. El directorio raíz es heredado por todos los descendientes del proceso presente. Solamente el superusuario puede cambiar el directorio raíz.

VALOR REGRESADO
En caso de éxito 0, si hay algún error, -1, y la variable errno es asignada apropiadamente.

ERRORES
Según el sistema de ficheros, se pueden obtener otros valores tras esta función. Los errores más comunes se listan a continuación:

EPERM
    El UID efectivo no coincide con el propietario del fichero, y no es 0; o el owner ó group han sido especificados incorrectamente.

EROFS
    El fichero referido se encuentra en un sistema de ficheros de sólo-lectura.

EFAULT
    path señala fuera de su espacio de direcciones accesibles.

ENAMETOOLONG
    path es demasiado largo.

ENOENT
    El fichero no existe.

ENOMEM
    No hubo suficiente memoria disponible en el kernel.

ENOTDIR
    Un componente del camino no es un directorio.

EACCES
    Permiso de búsqueda denegado en uno de los componentes del prefijo "path".

ELOOP
    path contiene una referencia circular(p.e., via una referencia simbólica).

VÉASE
chdir(2)