Linux system函数返回值

一、简介

1、语法

cpp 复制代码
#include <stdlib.h>

int system(const char *command);

2、函数说明

system()会调用fork()产生子进程,由子进程来调用/bin/sh -c command来执行参数command字符串所代表的命令,此命令执行完后随即返回原调用的进程。

command命令执行完成后,system函数才会返回。--意味着system是阻塞的

在调用system()期间SIGCHLD 信号会被暂时搁置,SIGINT和SIGQUIT 信号则会被忽略。

3、返回值

1、先统一两个说法:

(1)system 返回值:指调用 system 函数后的返回值,比如上例中 status 为 system 返回值

(2)shell 返回值:指 system 所调用的 shell 命令的返回值,比如上例中,test.sh 中返回的值为 shell 返回值。

2、如何正确判断 test.sh 是否正确执行?

仅判断 status 是否 ==0?或者仅判断 status 是否!=-1?

都错!

看得很晕吧?

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().

ref:

https://www.cnblogs.com/Rainingday/p/15070262.html

从Linux system()函数谈起 -- 又见杜梨树

system(3) - Linux manual page

https://linux.die.net/man/3/system

宏伟精讲·linux system()函数完全解密 - 知乎

system函数的原理和调用方法_c++system函数原理-CSDN博客

linux system 函数源代码分析-ShadowSrX-ChinaUnix博客

system.c - sysdeps/posix/system.c - Glibc source code (glibc-2.38) - Bootlin

相关推荐
发疯的技术鼠1 小时前
03-优先级与调度
linux
无足鸟ICT3 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
GeW3 小时前
世界目光聚焦中国:底层技术、Linux、数据库的破局逻辑
linux·数据库
IT大白鼠3 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
Decay__4 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
A-刘晨阳4 小时前
K8S 二进制集群搭建(一主两从)v1.37.2 版本
运维·云原生·容器·kubernetes·calico·nerdctl
tonydf4 小时前
没完了,Nginx又报新漏洞!
运维·nginx
星恒随风4 小时前
MySQL 从零入门(十):MVCC、Undo Log 与 Read View 详解——InnoDB 如何实现事务隔离?
linux·数据库·笔记·sql·mysql
瑞雪兆丰年兮6 小时前
Linux零基础快速入门-第二章 Linux基础命令
linux·运维·服务器
lambo mercy6 小时前
01初识docker
运维·docker·容器