.\" Copyright (c) 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. .\" .\" @(#) exec. 3 8.3 (Berkeley) 1/24/94 .\" %FreeBSD: src/lib/libc/gen/exec. 3, v 1.7. 2.7 2001/12/14 18:33:51 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/exec. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .Dd January 24, 1994 .Dt EXEC 3 .Os .Sh 명칭 .Nm execl , .Nm execlp , .Nm execle , .Nm exect , .Nm execv , .Nm execvp .Nd 파일을 실행한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Vt extern char **environ ; .Ft int .Fn execl "const char *path" "const char *arg" ... .Ft int .Fn execlp "const char *file" "const char *arg" ... .Ft int .Fn execle "const char *path" "const char *arg" ... .Ft int .Fn exect "const char *path" "char *const argv[]" "char *const envp[]" .Ft int .Fn execv "const char *path" "char *const argv[]" .Ft int .Fn execvp "const char *file" "char *const argv[]" .Sh 해설 .Fn exec 패밀리의 함수는 현재의 프로세스 이미지를 새로운 프로세스 이미지로 두어 바꿉니다. 이 메뉴얼 페이지로 설명하는 함수는, 함수 .Xr execve 2 의 프론트엔드입니다 (현재의 프로세스의 치환의 상세한 것에 대하여는, .Xr execve 2 의 메뉴얼 페이지를 참조해 주세요). .Pp 이러한 함수의 초기 인수는, 실행되는 파일의 패스명입니다. .Pp .Fn execl , .Fn execlp , 및 .Fn execle 의 각 함수의 .Fa "const char *arg" 및 후속의 생략 기호는 .Em arg0 , .Em arg1 , \&..., .Em argn (이)라고 생각할 수가 있습니다. 이것들은 실행되었다 프로그램에 이용할 수 있는 인수 리스트를 나타내는 널 캐릭터로 끝나는 string를 가리킨다 1 개(살) 또는 복수의 포인터의 리스트를 기술합니다. 관행으로, 최초의 인수는, 실행중의 파일에 대응하는 파일명을 가리킬 필요가 있습니다. 인수의 리스트는 .Dv NULL 포인터로 종료시킨다 .Em 필요가 있어 . .Pp .Fn exect , .Fn execv , 및 .Fn execvp 의 각 함수는, 새로운 프로그램에 이용할 수 있는 인수 리스트를 나타낸다 널 캐릭터로 끝나는 string를 가리키는 포인터의 배열을 제공합니다. 관행으로, 최초의 인수는, 실행중의 파일에 대응하는 파일명을 가리킬 필요가 있습니다. 포인터의 배열은 .Dv NULL 포인터로 종료한다 .Sy 필요가 있어 . .Pp .Fn execle (와)과 .Fn exect 의 각 함수도, 실행된 프로세스의 환경을 지정합니다. 그러기 위해서는, 파라미터 리스트내에 있는 인수 리스트를 종료시킨다 .Dv NULL 포인터, 또는 추가 파라미터와 함께 argv 배열을 가리키는 포인터에 따릅니다. 이 추가의 파라미터는, 널 캐릭터로 끝나는 string를 가리키는 포인터의 배열이며, .Dv NULL 포인터로 종료된다 .Em 필요가 있어 . 다른 함수는, 현재의 프로세스내의 외부 변수 .Va environ (으)로부터 새로운 프로세스 이미지용의 환경을 다룹니다. .Pp 이러한 함수에는 특별한 의미론이 있는 것도 있습니다. .Pp .Fn execlp (와)과 .Fn execvp 의 각 함수는, 지정된 파일명에 slash .Dq Li / 하지만 포함되지 않은 경우, 실행 가능 파일을 검색해 쉘의 처치를 복제합니다. 검색 패스는 .Dq Ev PATH 변수에 의해 환경내에서 지정된 패스입니다. 이 값이 지정되지 않는 경우, .Aq paths.h 의 .Dv _PATH_DEFPATH 정의에 따라, 디폴트의 패스가 설정됩니다. 이것은, .Dq Ev /bin:/usr/bin: (으)로 설정되어 있습니다. 게다가 특정의 에러가 특별히 취급됩니다. .Pp 에러가 애매한 경우(간단하게 하기 위해서, 여기에서는 .Er ENOEXEC 이외의 모든 에러를 애매라고 생각합니다. 다만, 치명적인 에러 .Er EACCES 만이 실로 애매합니다), 이러한 함수는, 파일을 개시해, 파일이 존재하는지, 그리고 적절한 실행 퍼미션이 있는지를 판정하는것 같이 동작합니다. 그런 경우, 이러한 함수는 .Fn execve 에 의해 설정된 값에 복원된 글로벌 변수 .Va errno 그리고 즉시 돌아옵니다. 그렇지 않은 경우, 검색이 계속합니다. 검색이 .Fn execve 의 실행에 성공하지 않고, 또는 에러를 위해서(때문에) 종료하지 않고 완료하면(자), 이러한 함수는, 적절한 실행 퍼미션이 있는 적어도 1 개의 파일이 발견되었는지 어떠했는지에 따라, 글로벌 변수 .Va errno (을)를 .Er EACCES 또는 .Er ENOENT (으)로 설정해 돌아옵니다. .Pp 파일의 헤더가 인식되지 않는다(시도했다 .Fn execve 하지만 .Er ENOEXEC (을)를 돌려줄) 경우, 이러한 함수는, 최초의 인수로서 파일의 패스가 있는 쉘을 실행합니다 (이 시도가 실패했을 경우, 그 이상의 검색은 행해지지 않습니다). .Pp .Fn exect 함수는, 프로그램 트레이스 기능을 유효하게 해 파일을 실행합니다 ( .Xr ptrace 2 (을)를 참조). .Pp .Sh 반환값 .Fn exec 함수가 돌아왔을 경우, 에러가 발생하고 있을 것입니다. 반환값은 \-1 이어, 글로벌 변수 .Va errno 하지만 설정되어 에러를 나타냅니다. .Sh 파일 .Bl -tag -width /bin/sh -compact /bin/sh 쉘 .El .Sh 에러 .Fn execl , .Fn execle , .Fn execlp 및 .Fn execvp (은)는 처리 실패해, 프로그램 라이브러리 함수 .Xr execve 2 및 .Xr malloc 3 에 붙어 지정된 에러를 지정한다 .Va errno (을)를 설정할 가능성이 있습니다. .Pp .Fn exect (와)과 .Fn execv (은)는, 프로그램 라이브러리 함수 .Xr execve 2 에 붙어 지정된 에러에 관계해 .Va errno (을)를 설정할 가능성이 있습니다. .Pp .Sh 관련 항목 .Xr sh 1 , .Xr execve 2 , .Xr fork 2 , .Xr ktrace 2 , .Xr ptrace 2 , .Xr environ 7 .Sh 호환성 역사적으로는 .Fn execlp 함수와 .Fn execvp 함수의 디폴트의 패스는 .Dq Pa :/bin:/usr/bin 입니다. 이것이, system security를 향상시키기 위해서(때문에) 현재의 디렉토리를 마지막으로 배치하도록(듯이) 변경되었습니다. .Pp 파일을 실행하려고 하고 있는 동안에 에러가 발생했을 때의 .Fn execlp (와)과 .Fn execvp 의 동작은, 그다지 역사적인 관행이 아니고, 종래부터 문서화 되지 않고, .Tn POSIX 표준으로 지정되어 있지 않습니다. .Pp 종래, .Fn execlp 함수와 .Fn execvp 함수는, 상기의 것, 및 .Er ETXTBSY , .Er ENOMEM (와)과 .Er E2BIG (을)를 제외해 모든 에러를 무시했습니다. .Er ETXTBSY 그리고 이러한 함수는 몇초간, sleeve 한 다음에 재시행해, .Er ENOMEM (와)과 .Er E2BIG 그리고 이러한 함수는 돌아갑니다. 이것들은 현재 .Er ETXTBSY 에 붙어 돌아와, 존재와 실행 가능성을 좀 더 주의 깊게 판정합니다. 특히, 패스 접두어내의 액세스 할 수 없는 디렉토리를 나타낸다 .Er EACCES 하지만, 부적절한 실행 퍼미션이 있는 파일에 대한 .Er EACCES (와)과 혼란되지 않게 되어 있습니다. .Bx 4.4 그리고, 이러한 함수는, .Er EACCES , .Er ENOENT , .Er ENOEXEC 및 .Er ETXTBSY 이외의 모든 에러로 돌아왔습니다. 이것은 종래의 에러 처리보다 뒤떨어진 것이었습니다. 패스 접두어에 대한 에러의 무시를 찢어, 비정상으로 애매한 에러 .Er EFAULT (와)과 비정상인 에러 .Er EIO 의 처리를 개량할 뿐(만큼)이기 때문입니다. 동작은 .Xr sh 1 의 동작과 일치하도록(듯이) 변경되었습니다. .Pp .Sh 표준 .Fn execl , .Fn execv , .Fn execle , .Fn execlp 및 .Fn execvp 하 .St -p1003.1-88 에 준거하고 있습니다.