Ubuntu Manpages

chdir, fchdir

altera o diretório de trabalho

#include <unistd.h>

int chdir(const char *path);
int fchdir(int fd);

chdir altera o diretório atual para o específicado em path.

fchdir é identico a chdir, somente que o diretório é fornecido com um descritor de arquivo aberto.

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

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

path aponta para fora do seu espaço de endereço acessível.
path é muito longo.
O arquivo não existe.
Memória de kernel disponível é insufuciente.
Um componete do path Não é um diretório.
Permissão de busco é negada em um componente do path.
Muitas ligações simbólicas foram encontradas na resolução do path.
Um erro de E/S ocorreu.

Os erros gerais para fchdir são listados abaixo:

fd não é válido como descritor de arquivos.
Permissão de procura foi negada no diretório aberto em fd.

A chamada chdir é compatível com SVr4, SVID, POSIX, X/OPEN, BSD 4.4. SVr4 documenta condições de erro adicionais EINTR, ENOLINK, e EMULTIHOP mas não ENOMEM. POSIX.1 não tem as condições de erro ENOMEM ou ELOOP. X/OPEN não tem as condições de erro EFAULT, ENOMEM ou EIO.

fchdir é compatível com SVr4, BSD 4.4 e X/OPEN. SVr4 documenta condições de erro adicionais EIO, EINTR, ENOLINK. X/OPEN não tem as condições de erro EINTR e EIO.

getcwd(3), chroot(2)

André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)