FCHDIR(3)                  POSIX Programmer's Manual                 FCHDIR(3)



PPRROOLLOOGG
       This manual page is part of the POSIX Programmer's Manual.  The OS
       implementation of this interface may differ (consult the corresponding
       OS manual page for details of OS behavior), or the interface may not be
       implemented on OS.

NNAAMMEE
       fchdir -- change working directory

SSYYNNOOPPSSIISS
       #include <unistd.h>

       int fchdir(int _f_i_l_d_e_s);

DDEESSCCRRIIPPTTIIOONN
       The _f_c_h_d_i_r() function shall be equivalent to _c_h_d_i_r() except that the
       directory that is to be the new current working directory is specified
       by the file descriptor _f_i_l_d_e_s.

       A conforming application can obtain a file descriptor for a file of
       type directory using _o_p_e_n(), provided that the file status flags and
       access modes do not contain O_WRONLY or O_RDWR.

RREETTUURRNN VVAALLUUEE
       Upon successful completion, _f_c_h_d_i_r() shall return 0. Otherwise, it
       shall return -1 and set _e_r_r_n_o to indicate the error. On failure the
       current working directory shall remain unchanged.

EERRRROORRSS
       The _f_c_h_d_i_r() function shall fail if:

       EEAACCCCEESS Search permission is denied for the directory referenced by
              _f_i_l_d_e_s.

       EEBBAADDFF  The _f_i_l_d_e_s argument is not an open file descriptor.

       EENNOOTTDDIIRR
              The open file descriptor _f_i_l_d_e_s does not refer to a directory.

       The _f_c_h_d_i_r() may fail if:

       EEIINNTTRR  A signal was caught during the execution of _f_c_h_d_i_r().

       EEIIOO    An I/O error occurred while reading from or writing to the file
              system.

       _T_h_e _f_o_l_l_o_w_i_n_g _s_e_c_t_i_o_n_s _a_r_e _i_n_f_o_r_m_a_t_i_v_e_.

EEXXAAMMPPLLEESS
       None.

AAPPPPLLIICCAATTIIOONN UUSSAAGGEE
       None.

RRAATTIIOONNAALLEE
       None.

FFUUTTUURREE DDIIRREECCTTIIOONNSS
       None.

SSEEEE AALLSSOO
       _c_h_d_i_r(), _d_i_r_f_d()

       The Base Definitions volume of POSIX.1-2017, <<uunniissttdd..hh>>

CCOOPPYYRRIIGGHHTT
       Portions of this text are reprinted and reproduced in electronic form
       from IEEE Std 1003.1-2017, Standard for Information Technology --
       Portable Operating System Interface (POSIX), The Open Group Base
       Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the
       Institute of Electrical and Electronics Engineers, Inc and The Open
       Group.  In the event of any discrepancy between this version and the
       original IEEE and The Open Group Standard, the original IEEE and The
       Open Group Standard is the referee document. The original Standard can
       be obtained online at http://www.opengroup.org/unix/online.html .

       Any typographical or formatting errors that appear in this page are
       most likely to have been introduced during the conversion of the source
       files to man page format. To report such errors, see
       https://www.kernel.org/doc/man-pages/reporting_bugs.html .



IEEE/The Open Group                  2017                            FCHDIR(3)
