Linux system函數返回值

例：

status = system("./test.sh");

一、先統一兩個說法：

（1）system返回值：指調用system函數後的返回值，好比上例中status爲system返回值

（2）shell返回值：指system所調用的shell命令的返回值，好比上例中，test.sh中返回的值爲shell返回值。

 

二、如何正確判斷test.sh是否正確執行？

僅判斷status是否==0？或者僅判斷status是否!=-1? 

 

都錯！

 

三、man中對於system的說明

 

RETURN VALUE
       The value returned is -1 on error (e.g.  fork() 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).

看得很暈吧？

 

system函數對返回值的處理，涉及3個階段：

階段1：建立子進程等準備工做。若是失敗，返回-1。

階段2：調用/bin/sh拉起shell腳本，若是拉起失敗或者shell未正常執行結束（參見備註1），緣由值被寫入到status的低8~15比特位中。system的man中只說明瞭會寫了127這個值，但實測發現還會寫126等值。

階段3：若是shell腳本正常執行結束，將shell返回值填到status的低8~15比特位中。

備註1：

只要可以調用到/bin/sh，而且執行shell過程當中沒有被其餘信號異常中斷，都算正常結束。

好比：無論shell腳本中返回什麼緣由值，是0仍是非0，都算正常執行結束。即便shell腳本不存在或沒有執行權限，也都算正常執行結束。

若是shell腳本執行過程當中被強制kill掉等狀況則算異常結束。

 

如何判斷階段2中，shell腳本是否正常執行結束呢？系統提供了宏：WIFEXITED(status)。若是WIFEXITED(status)爲真，則說明正常結束。

如何取得階段3中的shell返回值？你能夠直接經過右移8bit來實現，但安全的作法是使用系統提供的宏：WEXITSTATUS(status)。

 

 

因爲咱們通常在shell腳本中會經過返回值判斷本腳本是否正常執行，若是成功返回0，失敗返回正數。

因此綜上，判斷一個system函數調用shell腳本是否正常結束的方法應該是以下3個條件同時成立：

（1）-1 != status

（2）WIFEXITED(status)爲真

（3）0 == WEXITSTATUS(status)

 

注意：

根據以上分析，當shell腳本不存在、沒有執行權限等場景下時，以上前2個條件仍會成立，此時WEXITSTATUS(status)爲127，126等數值。

因此，咱們在shell腳本中不能將127，126等數值定義爲返回值，不然沒法區分中是shell的返回值，仍是調用shell腳本異常的緣由值。shell腳本中的返回值最好多1開始遞增。

 

判斷shell腳本正常執行結束的健全代碼以下：

 

#include <stdio.h>
#include <stdlib.h>
#include <sys/wait.h>
#include <sys/types.h>

int main()
{
    pid_t status;


    status = system("./test.sh");

    if (-1 == status)
    {
        printf("system error!");
    }
    else
    {
        printf("exit status value = [0x%x]\n", status);

        if (WIFEXITED(status))
        {
            if (0 == WEXITSTATUS(status))
            {
                printf("run shell script successfully.\n");
            }
            else
            {
                printf("run shell script fail, script exit code: %d\n", WEXITSTATUS(status));
            }
        }
        else
        {
            printf("exit status = [%d]\n", WEXITSTATUS(status));
        }
    }

    return 0;
}

WIFEXITED(stat_val) Evaluates to a non-zero value if status was returned for a child process that terminated normally. WEXITSTATUS(stat_val) If the value of WIFEXITED(stat_val) is non-zero, this macro evaluates to the low-order 8 bits of the status argument that the child process passed to _exit() or exit(), or the value the child process returned from main().