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)