NOME

       chroot - altera o diretório raiz

SINOPSE

       #include <unistd.h>

       int chroot(const char *path);

DESCRIÇÃO

       chroot  altera  o diretório raiz para aquele específicado no path.  Este diretório será usado pelos nomes
       de caminhos começando com /.  O diretório raiz é herdado por todos filhos do processo corrente.

       Somente o super-usuário pode alterar o diretório raiz.

       Note que esta chamada não altera o diretório atual de trabalho, de forma  que  `.'  pode  estar  fora  da
       árvore raiz em `/'.

VALORES RETORNADOS

       Em  caso  de  sucesso,  zero  é  retornado.  Caso  contrário,  -1  é  retornado,  e  errno  é selecionado
       adequadamente.

ERROS

       Dependendo do sistema de arquivos, outros erros podem ser retornados. Os erros mais gerais  são  listados
       abaixo:

       EPERM  A UID efetiva não é zero.

       EFAULT path aponta para fora do seu espaço de endereços acessível.

       ENAMETOOLONG
              Caminho é muito longo.

       ENOENT Os arquivos não existem.

       ENOMEM Memória do kernel insuficiente.

       ENOTDIR
              Um componente do caminho não é um diretório.

       EACCES

              Permissão de procura é negada em um componente do prefixo do caminho.

       ELOOP  Muitas ligações simbólicas foram encontrada na resolução do caminho.

       EIO    Um erro de E/S ocorreu.

DE ACORDO COM

       SVr4,  SVID,  4.4BSD,  X/OPEN.  Esta  função não é parte da POSIX.1.  SVr4 documenta as condições de erro
       adicionais EINTR, ENOLINK e EMULTIHOP.  X/OPEN não documenta as condições de erro EIO, ENOMEM ou  EFAULT.
       Esta interface é marcada como válida pela X/OPEN.

VEJA TAMBÉM

       chdir(2)

TRADUZIDO POR LDP-BR em 21/08/2000

       André  L.  Fassone  Canova <lonelywolf@blv.com.br> (tradução) Fábio Henrique F. Silva <fabiohfs@mail.com>
       (revisão)

Linux 2.0.30                                       21/08/1997                                          CHROOT(2)