.\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) chdir. 2 8.2 (Berkeley) 12/11/93 .\" %FreeBSD: src/lib/libc/sys/chdir. 2, v 1.7. 2.5 2001/12/14 18:34:00 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/chdir. 2, v 1.8 2001/12/23 00:03:41 horikawa Exp $ .Dd December 11, 1993 .Dt CHDIR 2 .Os .Sh 명칭 .Nm chdir , .Nm fchdir .Nd 현재의 작업 디렉토리를 변경한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Ft int .Fn chdir "const char *path" .Ft int .Fn fchdir "int fd" .Sh 해설 .Fa path 인수는, 디렉토리의 패스명을 가리킵니다. .Fn chdir 함수에 의해, 지정된 디렉토리가 현재의 작업 디렉토리, 즉 slash .Ql / 그리고 개시하지 않는 패스명의 패스 검색의 개시점이 됩니다. .Pp .Fn fchdir 함수에 의해, .Fa fd 하지만 참조하는 디렉토리가 현재의 작업 디렉토리 (slash .Ql / 그리고 개시하지 않는 패스명의 패스 검색의 개시점)이 됩니다. .Pp 디렉토리가 현재의 작업 디렉토리가 되기 위해서(때문에)는, 프로세스가 그 디렉토리에의 실행 (검색) 액세스 허가를 가지고 있을 필요가 있습니다. .Sh 반환값 .Rv -std .Sh 에러 다음의 1 개 또는 복수가 진정한 경우, .Fn chdir 의 처리는 실패해, 현재의 작업 디렉토리는 변경되지 않습니다. .Bl -tag -width Er .It Bq Er ENOTDIR 패스의 원가요소중에 디렉토리 이외의 것이 포함되어 있습니다. .It Bq Er ENAMETOOLONG 패스명의 원가요소가 255 캐릭터를 넘고 있는지, 또는 패스명 전체가 1023 캐릭터를 넘고 있습니다. .It Bq Er ENOENT 지정된 디렉토리가 존재하지 않습니다. .It Bq Er ELOOP 패스명을 변환할 경우에 검출된 기호 연결이 너무 많습니다. .It Bq Er EACCES 패스명의 원가요소의 어느쪽이든으로, 검색이 허가되고 있지 않습니다. .It Bq Er EFAULT .Fa path (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Pp 다음의 1 개 또는 복수가 진정한 경우, .Fn fchdir 의 처리는 실패해, 현재의 작업 디렉토리는 변경되지 않습니다. .Bl -tag -width Er .It Bq Er EACCES 파일 기술자가 참조하는 디렉토리에서 검색이 허가되고 있지 않습니다. .It Bq Er ENOTDIR 파일 기술자가 디렉토리를 참조하고 있지 않습니다. .It Bq Er EBADF 인수 .Fa fd 하지만 유효한 파일 기술자가 아닙니다. .El .Sh 관련 항목 .Xr chroot 2 .Sh 표준 .Fn chdir 함수는 .St -p1003.1-90 에 준거하고 있습니다. .Sh 역사 .Fn chdir 함수는 .At v7 그리고 등장했습니다. .Fn fchdir 함수는 .Bx 4.2 그리고 등장했습니다.