.\" 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. .\" .\" @(#) execve. 2 8.5 (Berkeley) 6/1/94 .\" %FreeBSD: src/lib/libc/sys/execve. 2, v 1.16. 2.10 2001/12/22 01:21:30 jwd Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/execve. 2, v 1.7 2001/12/23 00:03:42 horikawa Exp $ .Dd June 1, 1994 .Dt EXECVE 2 .Os .Sh 명칭 .Nm execve .Nd 파일을 실행한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .Fd #include .Ft int .Fn execve "const char *path" "char *const argv[]" "char *const envp[]" .Sh 해설 .Fn execve (은)는 호출 프로세스를 새로운 프로세스로 변환합니다. 새로운 프로세스는 .Em new process file (으)로 불리는 통상의 파일에 따라 구성됩니다. 이 파일의 이름은 .Fa path 에 의해 지정됩니다. 이 파일은 실행 가능 오브젝트 파일, 또는 인터프리터용의 데이터의 파일입니다. 실행 가능 오브젝트 파일은, 식별 헤더에 데이터의 페이지가 계속된 것으로 구성됩니다. 이 데이터는 초기 프로그램 (텍스트)과 초기치 있어 데이터의 페이지를 나타냅니다. 추가의 페이지는 헤더의 지정에 의해 0 데이터로 초기화되는 경우가 있습니다. .Xr elf 5 및 .Xr a.out 5 (을)를 참조해 주세요. .Pp 인터프리터 파일은 다음의 형식의 행으로 개시합니다. .Pp .Bd -ragged -offset indent -compact .Sy \&#! .Em 인터프리터 .Bq Em arg .Ed .Pp 인터프리터 파일이 .Sy execve 될 때, 시스템은 실제로는 지정의 .Em 인터프리터 (을)를 .Sy execve 합니다. 옵션의 .Em arg 하지만 지정되어 있는 경우, 그것은 .Em 인터프리터 의 1번째의 인수에 되어, 원래의 .Sy execve 그리고 지정된 파일의 이름은 2 번째의 인수가 됩니다. 그 이외에서는 .Sy execve 그리고 지정된 파일의 이름이 1번째의 인수가 됩니다. 원래의 인수는 쉬프트 되어 후속의 인수에 됩니다. 0 번째의 인수는 지정되었다 .Em 인터프리터 (으)로 설정됩니다. .Pp 인수 .Fa argv (은)는, 눌로 종료하는 캐릭터 포인터의 배열을 가리키는 포인터입니다. 각 캐릭터 포인터는 눌 캐릭터로 종료하는 캐릭터 라인을 가리킵니다. 이러한 캐릭터 라인은, 새로운 프로세스로부터 참조할 수 있는 인수 리스트를 구성합니다. 적어도 1 개의 인수가 배열내에 존재하고 있을 필요가 있습니다. 관습에서는, 최초의 요소가 실행된 프로그램의 이름이 될 것입니다 (예를 들어, .Fa path 의 마지막 원가요소). .Pp 인수 .Fa envp 도, 눌로 종료하는 캐릭터 포인터의 배열을 가리키는 포인터입니다. 각 캐릭터 포인터는 눌 캐릭터로 종료하는 캐릭터 라인을 가리킵니다. 이 배열을 가리키는 포인터는, 통상, 글로벌 변수 .Va environ 에 보존됩니다. 이러한 캐릭터 라인은, 인수로서 명령에 직접 건네받지 않는 정보를 새로운 프로세스에 건네줍니다 .Pf ( Xr environ 7 (을)를 참조). .Pp 호출 프로세스 이미지내에서 오픈되고 있는 파일 기술자는, 새로운 프로세스 이미지 중(안)에서도 오픈된대로 입니다. 그러나, close-on-exec 플래그가 설정되어 있는 것은 예외입니다. .Pf ( Xr close 2 (와)과 .Xr fcntl 2 (을)를 참조). 오픈된 채로의 기술자는 .Fn execve 의 영향을 받지 않습니다. .Pp 호출 프로세스로 무시하도록(듯이) 설정된 시그널은, 새로운 프로세스내에서도 무시되도록(듯이) 설정됩니다. 호출 프로세스 이미지내에서 포착되도록(듯이) 설정된 시그널은, 새로운 프로세스 이미지내에서 디폴트의 액션에 설정됩니다. 블록 된 시그널은, 시그널 액션의 변화 (와)는 관계없는 것으로 블록 된 채로 있습니다. 시그널 스택은 미정도리에 리셋트 됩니다 (상세한 것에 대하여는 .Xr sigaction 2 (을)를 참조해 주세요). .Pp 새로운 프로세스 이미지 파일에 set-user-ID 모드 비트 하지만 설정되어 있는 경우 .Pf ( Xr chmod 2 (을)를 참조), 새로운 프로세스 이미지의 실효 유저 ID 는, 새로운 프로세스 이미지 파일의 소유자 ID 로 설정됩니다. 새로운 프로세스 이미지 파일에 set-group-ID 모드 비트가 설정되어 있는 경우, 새로운 프로세스 이미지의 실효 그룹 ID 는 새롭다 프로세스 이미지 파일의 그룹 ID 로 설정됩니다 (실효 그룹 ID 는 그룹 리스트의 최초의 요소입니다). 새로운 프로세스의 열매 유저 ID, 열매 그룹 ID, 및 그 외의 그룹 ID 는, 호출 프로세스 이미지와 같게 됩니다. set-user-ID 및 set-group-ID 처리의 뒤, 실효 유저 ID 는 saved set-user-ID 로서 기록되어 실효 그룹 ID 는 saved set-group-ID 로서 기록됩니다. 이러한 값은, 다음에 실효 ID 를 변경하는데 사용할 수 있습니다 .Pf ( Xr setuid 2 (을)를 참조). .Pp 해당하는 파일 시스템으로 .Ar nosuid 옵션이 유효한 경우, 또는 새로운 프로세스 파일이 인터프리터 파일의 경우, set-ID 비트는 의미를 가지지 않습니다. 실효 ID 가 변경되었을 경우, 시스템 콜의 트레이스는 무효가 됩니다. .Pp 또, 새로운 프로세스는 호출해 프로세스로부터 다음의 속성을 계승합니다. .Pp .Bl -column 파일 모드 마스크 -offset indent -compact .It 프로세스 ID Ta Xr getpid 2 \ 를 참조 .It parent process ID Ta Xr getppid 2 \ 를 참조 .It 프로세스 그룹 ID Ta Xr getpgrp 2 \ 를 참조 .It 액세스 그룹 Ta Xr getgroups 2 \ 를 참조 .It 작업 디렉토리 Ta Xr chdir 2 \ 를 참조 .It 루트 디렉토리 Ta Xr chroot 2 \ 를 참조 .It 제어 단말 Ta Xr termios 4 \ 를 참조 .It 리소스의 사용 상황 Ta Xr getrusage 2 \ 를 참조 .It 인터벌 타이머 Ta Xr getitimer 2 \ 를 참조 .It 리소스의 사용 제한 Ta Xr getrlimit 2 \ 를 참조 .It 파일 모드 마스크 Ta Xr umask 2 \ 를 참조 .It 시그널 마스크 Ta Xr sigvec 2 , .Xr sigsetmask 2 \ 를 참조 .El .Pp .Fn execve 호출의 결과로서 실행될 때, 프로그램은 다음과 같이 불려 갑니다. .Bd -literal -offset indent main(argc, argv, envp) int argc; char **argv, **envp; .Ed .Pp 여기서, .Fa argc 하 .Fa argv 의 요소수 (``arg count'')이며, .Fa argv (은)는, 인수 자신을 가리키는 캐릭터 포인터의 배열을 가리킵니다. .Sh 반환값 .Fn execve (은)는 현재의 프로세스 이미지를 새로운 프로세스 이미지로 덧쓰기하므로, 처리가 성공한 호출에는 돌아오는 프로세스가 없습니다. .Fn execve 하지만 호출 프로세스에 되돌아 오는 경우는 에러가 일어나고 있습니다. 반환값은 -1 으로, 에러를 나타내기 위해서(때문에) 글로벌 변수 .Va errno 하지만 설정됩니다 .Sh 에러 다음의 경우, .Fn execve (은)는 처리에 실패해, 호출 프로세스로 돌아옵니다. .Bl -tag -width Er .It Bq Er ENOTDIR 패스의 원가요소중에 디렉토리 이외의 것이 포함되어 있습니다. .It Bq Er ENAMETOOLONG 패스명의 원가요소가 255 캐릭터를 넘고 있는지, 또는 패스명 전체가 1023 캐릭터를 넘고 있습니다. .It Bq Er ENAMETOOLONG 인타프리트 되는 스크립트를 기동할 경우에, 인터프리터의 이름이 .Dv MAXSHELLCMDLEN 캐릭터를 넘고 있습니다. .It Bq Er ENOENT 새로운 프로세스 파일이 존재하지 않습니다. .It Bq Er ELOOP 패스명을 변환할 경우에 검출된 기호 연결이 너무 많습니다. .It Bq Er EACCES 지정된 패스에는, 검색이 허가되어 있지 않은 디렉토리가 포함되어 있습니다 .It Bq Er EACCES 새로운 프로세스 파일이 통상의 파일이 아닙니다. .It Bq Er EACCES 새로운 프로세스 파일은, 실행이 허가되고 있지 않습니다. .It Bq Er ENOEXEC 새로운 프로세스 파일에 적절한 액세스 허가가 있습니다만, 헤더의 매직 번호가 무효입니다. .It Bq Er ETXTBSY 새로운 프로세스 파일은 순수한 수속 (공유 텍스트) 파일로, 현시점에서 다른 프로세스에 의해 기록 또는 읽기용으로 오픈되고 있습니다. .It Bq Er ENOMEM 새로운 프로세스는, 용서되었다 .Pq Xr getrlimit 2 로 부과된 최대치 이상의 가상 메모리를 필요로 합니다. .It Bq Er E2BIG 새로운 프로세스의 인수 리스트의 바이트수가 시스템의 부과한 상한을 넘고 있습니다. 이 상한은, .Xr sysctl 3 의 MIB 변수 .Dv KERN_ARGMAX 에 의해 지정됩니다. .It Bq Er EFAULT 새로운 프로세스 파일은, 헤더내의 사이즈치로 나타나는 만큼 길게 없습니다. .It Bq Er EFAULT .Fa path , .Fa argv , 또는 .Fa envp 하지만 올바르지 않은 주소를 가리키고 있습니다. .It Bq Er EIO 파일 시스템으로부터 독해간에 입출력 에러가 발생했습니다. .El .Sh 경고 슈퍼 유저가 아닌 것에 대해서 .Em setuid 된 프로그램이, 열매 .Em uid 하지만 ``root''의 때에 실행되었을 경우, 프로그램은 부분적으로 슈퍼 유저의 권한을 가집니다. .Sh 관련 항목 .Xr ktrace 1 , .Xr fork 2 , .Xr _exit 2 , .Xr execl 3 , .Xr exit 3 , .Xr sysctl 3 , .Xr a.out 5 , .Xr elf 5 , .Xr environ 7 , .Xr mount 8 .Sh 역사 .Fn execve 함수는 .Bx 4.2 그리고 등장했습니다.