<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> 
<chapter lang=ko> 
<!-- 작성자 : yundream             --> 
<!-- 작성일 : 2004/04/28           --> 
<!-- 연락처 : yundream@joinc.co.kr --> 
 
<!-- 함수 이름을 입력합니다 --> 
<title>system(3)</title> 
 
<!-- 이건 함수에 대한 대략적인 설명이구요 --> 
<para> 
    shell 명령어 실행기 
</para> 
  
<!-- 여기에 함수의 간단한 사용법이 들어갑니다 --> 
<section> 
    <title>사용법</title> 
    <para> 
        <screen> 
#include <stdlib.h> 
 
int system(const char *string); 
        </screen> 
    </para> 
</section> 
 
<!-- 여기엔 함수의 자세한 설명 이 들어갑니다 --> 
<section> 
    <title>설명</title> 
    <para> 
        system() 함수는 /bin/sh -c <emphasis>string</emphasis>를 호출하여  
        <emphasis>string</emphasis>에 지정된 명령어를 실행하고, 명령어가 끝난후 
        반환한다. 명령어가 실행동안, SIGCHLD는 블럭되며, SIGINT, SIGQUIT는  
        무시된다. system() 함수는 기본적으로 fork()와 execve()의 조합응용이다.  
    </para> 
</section> 
 
<!-- 함수가 되돌려주는 값이구요 --> 
<section> 
    <title>반환값</title> 
    <para> 
        만약 /bin/sh를 실행시키기 위한 execve()의 호출이 실패했다면 127이  
        리턴되며, 다른 에러가 있다면 -1, 그렇지 않다면 명령어의 리턴코드가  
        반환된다. 
    </para> 
    <para> 
        <emphasis>string</emphasis>값이 NULL이고, system()이 shell을 이용할 수  
        있다면 0이 아닌 값을 그렇지 않다면 0을 반환한다.  
    </para> 
    <para> 
        system()은 다른 wait()상태의 다른 자식에게 영향을 주지 않는다.  
    </para> 
</section> 
 
<!-- 마지막으로 에제 입니다                                                 --> 
<!-- 여기에는 완전한 예제가 들어가 있는데, 굳이 완전한 예제를 만들필요 없이 --> 
<!-- 코드 일부분만 작성해서 올려주셔도 됩니다                               -->  
<!-- "<", ">", "&" 등은 변환해 주셔야 하는데, 귀찮으시면 :-) 변환 하지 않   --> 
<!-- 아도 됩니다. 제가 검사 해서 올리겠습니다                               --> 
<!-- 예제에 대한 간단한 설명을 적어주셔도 되구요                            --> 
<section> 
    <title>예제</title> 
    <para> 
        <screen> 
#include <unistd.h> 
#include <stdio.h> 
 
int main(int argc, char **argv) 
{ 
    int i = 0; 
    int retval; 
    retval = system("ls -al"); 
    printf("Exit Status %d\n", retval); 
} 
        </screen> 
    </para> 
</section> 
<section> 
    <title>참고문헌</title> 
    <para> 
        <orderedlist> 
        <listitem> 
            <para> 
                fork() 
            </para> 
        </listitem> 
        <listitem> 
            <para> 
                execl() 
            </para> 
        </listitem> 
        </orderedlist> 
    </para> 
</section> 
</chapter>