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)