.\" Copyright (c) 1983, 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. .\" .\" @(#) chroot. 2 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/sys/chroot. 2, v 1.7. 2.7 2002/01/09 14:24:23 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/chroot. 2, v 1.7 2002/01/11 04:52:59 horikawa Exp $ .Dd June 4, 1993 .Dt CHROOT 2 .Os .Sh 명칭 .Nm chroot .Nd 루트 디렉토리를 변경한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Ft int .Fn chroot "const char *dirname" .Sh 해설 .Fa dirname (은)는, ASCII 의 눌 캐릭터로 종료하는 디렉토리의 패스명의 주소입니다. .Fn chroot (은)는, .Fa dirname (을)를 루트 디렉토리, 즉, .Ql / 그리고 개시하는 패스명의 패스 검색의 개시점으로 합니다. .Pp 디렉토리가 루트 디렉토리가 되기 위해서(때문에)는, 프로세스에 그 디렉토리에의 실행 (검색) 허가가 없으면 안됩니다. .Pp .Fn chroot (은)는 프로세스의 현재의 디렉토리에 영향을 주지 않는 것에 주의할 필요가 있습니다. .Pp 이 함수를 호출할 수 있는 것은 슈퍼 유저만입니다. .Pp 디렉토리를 참조하는 오픈 파일 기술자가 존재하는 경우, .Fn chroot 호출은 sysctl 변수 .Ql kern.chroot_allow_open_directories 의 설정에 따라, 다음과 같이 실패합니다: .Pp .Ql kern.chroot_allow_open_directories 하지만 0 으로 설정되어 있는 경우, 디렉토리가 오픈되고 있으면 .Fn chroot (은)는 항상 .Er EPERM 그리고 실패합니다. .Pp .Ql kern.chroot_allow_open_directories 하지만 1 에 세트 되고 있는 경우 (디폴트), 디렉토리가 오픈되고 있어, 그 프로세스가 .Fn chroot 호출의 영향을 받는 경우, .Er EPERM 그리고 실패합니다. .Pp .Ql kern.chroot_allow_open_directories 하지만 다른 값의 경우, 오픈 디렉토리의 체크는 되지 않습니다. .Pp 정상적으로 완료하면(자), 값 0 이 돌려주어집니다. 그렇지 않은 경우는, 값 -1 이 돌려주어 에러를 나타내기 위해서(때문에) .Va errno 하지만 설정됩니다. .Sh 에러 .Fn chroot (은)는, 다음의 경우, 처리에 실패해, 루트 디렉토리는 변경되지 않습니다. .Bl -tag -width Er .It Bq Er ENOTDIR 패스의 원가요소중에 디렉토리 이외의 것이 포함되어 있습니다. .It Bq Er EPERM 실효 유저 ID 가 슈퍼 유저가 아닙니다. 또는 디렉토리가 1 개(살) 이상의 파일 기술자에 의해 오픈되고 있습니다. .It Bq Er ENAMETOOLONG 패스명의 원가요소가 255 캐릭터를 넘고 있는지, 또는 패스명 전체가 1023 캐릭터를 넘고 있습니다. .It Bq Er ENOENT 지정의 디렉토리가 존재하지 않습니다. .It Bq Er EACCES 지정된 패스에는, 검색이 허가되어 있지 않은 디렉토리가 포함되어 있습니다. .It Bq Er ELOOP 패스명을 변환할 경우에 검출된 기호 연결이 너무 많습니다. .It Bq Er EFAULT .Fa path (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Sh 관련 항목 .Xr chdir 2 , .Xr jail 2 .Sh 역사 .Fn chroot 함수는 .Bx 4.2 그리고 등장했습니다.