system函数返回值探究

    对于system这个函数的功能早就有一定了解，读书期间，就学习了UNIX系统编程这本书，后来买了APUE.我这个人总是有好读书不求甚解的毛病。对于system函数只知其一，不知其二。后来被人问起相关的问题，结果丢了脸。书到用时方恨自己不求甚解。今天仔细探查了下system的一些特性。

    APUE这本书，对system这个函数已经将的比较明白了，只是它的相关知识稍显分散。最开始我是去网上找的资料，自己写的测试代码，可是还是有很多迷惑的地方。后来才拿起APUE ，好好读了第八章和第十章的相关章节。

    

#include <stdlib.h>

int system(const char *command);

    system的作用是在shell终端执行command。简单的说就是在C中执行system("ls")这行代码的含义就相当于在shell执行ls一样。这么说还是比较笼统，下面详细描述之：

    system是个综合的操作，分解开来看就是相当于执行了

1 fork  生成一个子进程。

2 在子进程执行 execl（"/bin/sh","sh","-c" command,(char*)0）;

3 waitpid

下面进入正题，返回值：

1 如果fork失败了，或者waitpid返回除了EINTR之外的错误，system返回 -1；

2 execl执行失败，其返回值如同shell执行了"exit(127)" 一样。

3 如果上述三步都执行成功，那么，system返回值是shell的终止状态。

上面这些话是APUE的，很抽象，很不具体，很笼统，我现在结合手册和代码解释一下。

手册中有这么一段话：

The value returned is -1 on error (e.g.  fork(2) failed), and the return status of  the  command  otherwise.   This  latter  return  status  is in the format specified in wait(2).  Thus, the exit code of the command will be WEXITSTATUS(status).  In case /bin/sh could not be executed, the exit status will be that of a command that does
 exit(127).

1 如果/bin/sh拉起shell命令失败，或者是shell命令没有正常执行 （比如命令根本就是非法的命令），那么，将原因填入status的8～15位。

  手册中也说如果命令执行不起来，那么相当于执行exit

libin@libin:~/program/C/Linux/system$ ./tsys "nosuchcmd"
sh: nosuchcmd: not found
status = 32512
normal termination,exit status = 127

我们看到了，nosuchcmd不是shell支持的命令，所以，shell命令返回了127，对于system函数，返回值为127*256 = 32512；因为shell的返回值是 system返回值的8～15位。

2  如果shell顺利执行完毕，那么将shell的返回值填到system返回值的8～15位。

 这里需要强调以下，所谓顺利执行完毕，并不是说，命令command执行成功，而是指  /bin/sh顺利调用，执行期间没有被信号异常终止，这都算是顺利执行完毕。

  

看下面的例子：

libin@libin:~/program/C/Linux/system$ ./tsys "ls /noexisted"
ls: 无法访问/noexisted: 没有那个文件或目录
status = 512
normal termination,exit status = 2

libin@libin:~/program/C/Linux/system$ ls /noexist
ls: 无法访问/noexist: 没有那个文件或目录
libin@libin:~/program/C/Linux/system$ echo $?
2
libin@libin:~/program/C/Linux/system$

    我们看到了，虽然/noexist文件并不存在，ls这条命令执行出了错，但是仍然属于shell顺利执行完毕。ls /noexist的错误吗是2，所以，system函数的返回值为 2*256 = 512.

    各位可能比较感兴趣的是，如果我知道system的返回值，如何知道我的命令的返回值呢？手册中有这么一句话：

Thus, the exit code of the command will be WEXITSTATUS(status)

    看到了WEXITSTATUS（status），就是command的返回值。当然前提条件是shell命令顺利执行完毕。即：

WIFEXITED(status) ! =0

3 前面的讨论都没有考虑信号，如果shell在执行过程中收到了信号。

这个问题我存在有疑惑，因为APUE第十章讲到，system的实现要忽略SIGINT和SIGQUIT，但是我的实验结果并不是这样，如有高手知道，请不吝赐教。

首先看我的终端信号配置：

libin@libin:~/program/C/Linux/system$ stty -a
speed 38400 baud; rows 36; columns 134; line = 0;
intr = ^C; quit = ^\; erase = ^?; kill = ^U; eof = ^D; eol = M-^?; eol2 = M-^?; swtch = M-^?; start = ^Q; stop = ^S; susp = ^Z;
rprnt = ^R; werase = ^W; lnext = ^V; flush = ^O; min = 1; time = 0;
-parenb -parodd cs8 hupcl -cstopb cread -clocal -crtscts
-ignbrk brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl ixon -ixoff -iuclc ixany imaxbel iutf8
opost -olcuc -ocrnl onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0
isig icanon iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt echoctl echoke

    Ctrl+C产生SIGINT，Ctrl+\ 产生 SIGQUIT。

    看下测试结果：

libin@libin:~/program/C/Linux/system$ ./tsys "sleep 7"
^Cstatus = 2
abnormal termination,signal number =2
libin@libin:~/program/C/Linux/system$ sleep 7
^C
libin@libin:~/program/C/Linux/system$ echo $?
130

    我们可以看到，直接在终端执行sleep 7，然后用Ctrl+C发送SIGINT信号，异常退出，shell返回值为130，130的原因，APUE上解释了，因为SIGINT 等于2，终止状态是128+信号编号，所以为130.

    按照APUE上，我们的system调用应该将SIGINT忽略掉，然后正常返回，同时返回值为130，但是实际上LINUX下并不是这样的。实际上system的返回值为2，并且异常退出了。

    SIGQUIT信号也是一样的，看我在我的Ubuntu 上做的测试：

libin@libin:~/program/C/Linux/system$ ./tsys "sleep 7"
^\status = 3
abnormal termination,signal number =3
libin@libin:~/program/C/Linux/system$ sleep 7
^\退出
libin@libin:~/program/C/Linux/system$ echo $?
131

    2012年1月1日，我做了下面的实验测试，下面是实验的过程。

root@libin:~/program/C/Linux/system# ./tsys  "sleep 50" &
[1] 2518
root@libin:~/program/C/Linux/system# ps -ef


root      2359  2343  0 12:42 pts/0    00:00:00 /bin/bash
root      2518  2359  0 12:55 pts/0    00:00:00 ./tsys sleep 50
root      2519  2518  0 12:55 pts/0    00:00:00 sh -c sleep 50
root      2520  2519  0 12:55 pts/0    00:00:00 sleep 50
root      2521  2359  0 12:56 pts/0    00:00:00 ps -ef
root@libin:~/program/C/Linux/system# kill -3 2520
Quit
status = 33536
normal termination,exit status = 131


root@libin:~/program/C/Linux/system# ./tsys  "sleep 50" &
[1] 2568
root@libin:~/program/C/Linux/system# ps -ef

root      2568  2359  0 13:01 pts/0    00:00:00 ./tsys sleep 50
root      2569  2568  0 13:01 pts/0    00:00:00 sh -c sleep 50
root      2570  2569  0 13:01 pts/0    00:00:00 sleep 50
root      2571  2359  0 13:01 pts/0    00:00:00 ps -ef
root@libin:~/program/C/Linux/system# kill -3 2569
status = 3
abnormal termination,signal number =3

 

    从测试结果上看，基本上进程关系如下，system的返回值，其实是shell的终止状态，

而不是sleep的返回值。所谓屏蔽INTR信号和QUIT信号，指的是tsys这个进程，忽略了INT信号的QUIT信号，但是sh进程，和sleep进程，都没有忽略这两个信号。

    如果给sleep进程发送SIGQUIT信号，杀死sleep进程，那么sleep会返回131，告诉shell进程我被SIGQUIT杀死了。而sh进程，则是安然退出，所以，依然打印出正常退出的打印，通过调用WEXITSTATUS，看以看出，sleep进程的遗言是131，表明收到QUIT信号。

    下面是测试程序，基本是照抄的APUE。

#define _XOPEN_SOURCE

#include<stdio.h>
#include<stdlib.h>
#include<unistd.h>

#include<signal.h>
#include<sys/wait.h>

void pr_exit(int status)
{
        printf("status = %d\n",status);
    if(WIFEXITED(status))
        {
            printf("normal termination,exit status = %d\n",WEXITSTATUS(status));
        }

        else if(WIFSIGNALED(status))
        {
            printf("abnormal termination,signal number =%d%s\n",
                                WTERMSIG(status),
#ifdef WCOREDUMP
                                WCOREDUMP(status)?"core file generated" : "");
#else
                "");
#endif
        }
}


int main(int argc,char* argv[])
{
        int status;

        if(argc<2)
        {
             fprintf(stderr,"usage:tsys cmd\n");
                 return -1;
        }

        if((status = system(argv[1]) )<0)
        {
            fprintf(stderr,"system error\n");
                return -2;
        }

        pr_exit(status);
    return 0;
}

十分感谢Heartwork的回复，本应该及早致谢，但是由于本周加班太多，机会每天都是10点以后到家，所以没有时间细细揣摩Heartwork的恢复。

参考文献：

1 APUE