详解bash中的退出状态机制

程序的退出状态

当一个程序结束时会向父进程报告自己的退出状态( exit status ). 通过传递 int 类型的变量给库函数 exit 或系统调用 _exit 可以设置当前程序的退出状态, 在 Linux 中, 通过 WEXITSTATUS 返回的退出状态的值域为 [0, 255] 之间的整数 . 如果传递的值不在这个范围内, 内核会自动帮你强转为 u_int8_t . 通过 waitpid 库函数可以得到子进程的退出状态, 其值存储在参数 wstatus 的低 8 位中.

// 定义在 wait.h 中
# define WEXITSTATUS(status)  __WEXITSTATUS (status)

// 定义在 waitstatus.h 中
/* If WIFEXITED(STATUS), the low-order 8 bits of the status. */
#define  __WEXITSTATUS(status)  (((status) & 0xff00) >> 8)

下面这个例子展示了如何使用 waitpid 及相关宏函数获取子进程的退出状态:

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

#define PARENT_EXIT 10086
#define CHILD_EXIT -10

int main()
{
  pid_t pid = fork();

  if (pid > 0)
  {
    int wstatus;
    // 父进程等待子进程执行完毕, 用 WUNTRACED 选项追踪已结束的子进程
    pid_t child_pid = waitpid(pid, &wstatus, WUNTRACED);

    if (WIFEXITED(wstatus))
      printf("Child exit status: %dn", WEXITSTATUS(wstatus));
    else
      perror("Bad wait statusn");

    // 父进程退出
    exit(PARENT_EXIT);
  }
  else if (pid == 0)
  {
    // 子进程立即退出, 因此需要父进程设置 WUNTRACED
    exit(CHILD_EXIT);
  }
  else
  {
    // 处理 fork 时出现的错误
    perror("forkn");
    exit(EXIT_FAILURE);
  }
}

编译并运行上例可以得到被强转后的状态码, 我们使用 WIFEXITED 判断等待的子进程是否执行成功, 然后对执行成功子进程使用 WEXITSTATUS 获取其退出状态. 对程序来说, 最终的退出状态就是主进程的退出状态.

> gcc ecitcode.c;./a.out;echo "Parent exit status: $?"
Child exit status: 246 # -10 强转为 uint8
Parent exit status: 102 # 10086 强转为 uint8

在 POSIX 标准中规定退出状态 0 代表该程序正常退出, 1 代表发生错误, 其他数字由程序自行规定, 因此在 glibc 的 stdlib.h 中仅定义了如下宏:

#define EXIT_FAILURE  1    /* Failing exit status. */
#define EXIT_SUCCESS  0    /* Successful exit status. */

程序本身一般会在文档中事先约定每种退出状态代表的退出原因( termination ), 例如在 ls 的帮助文档中:

> ls --help
...其他内容...
Exit status: # 退出状态
 0 if OK, # 正常执行
 1 if minor problems # 次要问题, 例如: 无法访问子目录
 2 if serious trouble # 严重错误, 例如: 无法访问命令行参数
...其他内容...

命令的退出状态

在 bash 中会记录所执行命令的退出状态, 可以通过 $? 获取最近执行的命令的退出状态. bash 自身的退出状态为执行的最后一条命令的退出状态, 也就等价于显式指定 exit $? . 如果没有执行任何命令就退出, 则 bash 的退出状态为 0 , 要注意在 bash 中用 0 表示 true , 用非零表示 false .