shell脚本返回值及其使用场景

应用场景

在一些应用中（比如Jenkins），嵌入了shell脚本，系统通过shell脚本的返回值来判断执行结果，如果返回值非0，则发生了执行错误，需要中止执行，这在使用单个命令时没有问题。然而，在shell （A）脚本又调用了shell脚本文件（B ）时，当被调用的shell脚本B执行过程中发生了错误时，系统不会认为B有问题，而是继续往下执行。这样就会掩盖了问题。

解决

在被调用的shell脚本B中返回错误代码，当被调用的shell脚本B中发生错误时，捕捉该错误代码，然后返回该错误代码，这样系统就能捕获被调用的脚本B的错误代码，而及时中止执行。

1、实现步骤：

（1）获取执行结果代码。使用“$?”获取。

（2）加入执行执行结果代码检测函数，若发现结果代码非0，则返回脚本的执行代码。使用“exit [代码]”表示。

2、示例：

Shell A：

#do something ...
/home/test/B.sh
#do something ...

Shell B(/home/test/B.sh)：

check_result()
{
  echo input params:$1

  if [ $1 != 0 ]; then
     echo wahaha
     exit $1
  fi
}

ls /
echo 1.result:$?
check_result $?

cat /xxxyyy
v1=$?
echo 2.result:{v1}
check_result $v1

check_result()为定义的检测函数，当命令的返回码非0时，shell脚本停止执行，返回代码。

v1=$? 保存命令执行返回码，其为临时变量。需要保存留作后用。

附录：

1、shell 返回码

参考：Linux Shell Bash 带有特殊含义的退出码

表格 D-1. "保留的"退出码

退出码的值	含义	例子	注释
1	通用错误	let "var1 = 1/0"	各种各样的错误都可能使用这个退出码, 比如"除0错误"
2	shell内建命令使用错误(Bash文档上有说明)		很少看到, 通常情况下退出码都为1
126	命令调用不能执行		程序或命令的权限是不可执行的
127	"command not found"		估计是$PATH不对, 或者是拼写错误
128	exit的参数错误	exit 3.14159	exit只能以整数作为参数, 范围是0 - 255(见脚注)
128+n	信号"n"的致命错误	kill -9 脚本的$PPID	$? 返回137(128 + 9)
130	用Control-C来结束脚本		Control-C是信号2的致命错误, (130 = 128 + 2, 见上边)
255*	超出范围的退出状态	exit -1	exit命令只能够接受范围是0 - 255的整数作为参数

2、shell返回码与函数返回码、命令返回码的区别

shell返回码，标识整个脚本的执行结果状态，用“exit 返回码”表示。

函数返回码，标识一个函数的执行结果状态，用“return 返回码”表示。

命令返回码，标识一个命令的执行结果状态，在命令执行后，紧跟着获取返回码，用"$?"获取。