chdir(2) | System Calls Manual | chdir(2) |
NOME
chdir, fchdir - altera o diretório de trabalho
BIBLIOTECA
Biblioteca C Padrão (libc, -lc)
SINOPSE
#include <unistd.h>
int chdir(const char *caminho); int fchdir(int fd);
fchdir():
_XOPEN_SOURCE >= 500 || /* Since glibc 2.12: */ _POSIX_C_SOURCE >= 200809L || /* glibc up to and including 2.19: */ _BSD_SOURCE
DESCRIÇÃO
chdir() altera o diretório atual de trabalho do processo chamador para o diretório especificado em caminho.
fchdir() é idêntico a chdir(); a única diferença é que o diretório é fornecido com um descritor de arquivo aberto.
VALOR DE RETORNO
Em caso de sucesso, zero é retornado. Em caso de erro, -1 é retornado, e errno é definido para indicar o erro.
ERROS
Dependendo do sistema de arquivos, outros erros podem ser retornados. Os erros mais gerais para chdir() são listados abaixo:
- EACCES
- Permissão de pesquisa é negada em um dos componentes de caminho. (Veja também path_resolution(7).)
- EFAULT
- caminho aponta para fora de seu espaço de endereços acessíveis.
- EIO
- Ocorreu um erro de E/S.
- ELOOP
- Muitos links simbólicos foram encontrados na resolução de caminho.
- ENAMETOOLONG
- caminho é muito longo.
- ENOENT
- O diretório especificado em caminho não existe.
- ENOMEM
- A memória do kernel disponível foi insuficiente.
- ENOTDIR
- Um componente do caminho não é um diretório.
Os erros gerais para fchdir() são listados abaixo:
PADRÕES
POSIX.1-2008.
HISTÓRICO
POSIX.1-2001, SVr4, 4.4BSD.
NOTAS
The current working directory is the starting point for interpreting relative pathnames (those not starting with '/').
Um processo filho criado via fork(2) herda o diretório de trabalho atual de seu pai. O diretório de trabalho atual permanece inalterado por execve(2).
VEJA TAMBÉM
TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>
Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.
Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.
2 maio 2024 | Linux man-pages 6.8 |