.\" -*- coding: UTF-8 -*-
.\" Copyright 1992, Drew Eckhardt <drew@cs.colorado.edu>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH chdir 2 "8 fevereiro 2026" "Linux man\-pages 6.18" 
.SH NOME
chdir, fchdir \- altera o diretório de trabalho
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <unistd.h>\fP
.P
\fBint chdir(const char *\fP\fIcaminho\fP\fB);\fP
\fBint fchdir(int \fP\fIfd\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBfchdir\fP():
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    _XOPEN_SOURCE >= 500
        || /* Desde o glibc 2.12: */ _POSIX_C_SOURCE >= 200809L
        || /* glibc até e incluindo 2.19: */ _BSD_SOURCE
.fi
.SH DESCRIÇÃO
\fBchdir\fP() altera o diretório atual de trabalho do processo chamador para o
diretório especificado em \fIcaminho\fP.
.P
\fBfchdir\fP() é idêntico a \fBchdir\fP(); a única diferença é que o diretório é
fornecido com um descritor de arquivo aberto.
.SH "VALOR DE RETORNO"
Em caso de sucesso, zero é retornado. Em caso de erro, \-1 é retornado, e
\fIerrno\fP é definido para indicar o erro.
.SH ERROS
Dependendo do sistema de arquivos, outros erros podem ser retornados. Os
erros mais gerais para \fBchdir\fP() são listados abaixo:
.TP 
\fBEACCES\fP
Permissão de pesquisa é negada em um dos componentes de \fIcaminho\fP. (Veja
também \fBpath_resolution\fP(7).)
.TP 
\fBEFAULT\fP
\fIcaminho\fP aponta para fora de seu espaço de endereços acessíveis.
.TP 
\fBEIO\fP
Ocorreu um erro de E/S.
.TP 
\fBELOOP\fP
Muitos links simbólicos foram encontrados na resolução de \fIcaminho\fP.
.TP 
\fBENAMETOOLONG\fP
\fIcaminho\fP é muito longo.
.TP 
\fBENOENT\fP
O diretório especificado em \fIcaminho\fP não existe.
.TP 
\fBENOMEM\fP
A memória do kernel disponível foi insuficiente.
.TP 
\fBENOTDIR\fP
Um componente do \fIcaminho\fP não é um diretório.
.P
Os erros gerais para \fBfchdir\fP() são listados abaixo:
.TP 
\fBEACCES\fP
Permissão de procura foi negada no diretório aberto em \fIfd\fP.
.TP 
\fBEBADF\fP
\fIfd\fP não é um descritor de arquivo válido.
.TP 
\fBENOTDIR\fP
\fIfd\fP não se refere a um diretório.
.SH PADRÕES
POSIX.1\-2024.
.SH HISTÓRICO
.TP 
\fBchdir\fP()
SVr4, POSIX.1\-1988, 4.4BSD.
.TP 
\fBfchdir\fP()
SVr4, 4.4BSD, SUSv1, POSIX.1\-2001 XSI, POSIX.1\-2008.
.SH NOTAS
O diretório de trabalho atual é o ponto de partida para interpretar nomes de
caminho relativos (aqueles que não começam com \[aq]/\[aq]).
.P
Um processo filho criado via \fBfork\fP(2) herda o diretório de trabalho atual
de seu pai. O diretório de trabalho atual permanece inalterado por
\fBexecve\fP(2).
.SH "VEJA TAMBÉM"
\fBchroot\fP(2), \fBgetcwd\fP(3), \fBpath_resolution\fP(7)
.PP
.SH 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>
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .