Appendix D. 带有特殊含义的退出码


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

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

通过上面的表, 我们了解到, 退出码1 - 2, 126 - 165, 和255 [1] 都具有特殊的含义, 因此应该避免使用用户指定的退出参数. 如果脚本使用exit 127作为退出语句, 那么可能就会在故障诊断的时候产生混淆(如何判断这是由"command not found"引起的, 还是由用户定义引起的?). 然而, 许多脚本使用exit 1作为通用的返回错误值. 因为退出码1能够表示的错误太多了, 不过这么做, 对于调试来说, 也起不到任何帮助的作用.

其实早就有人对退出状态值进行了系统的分类(请参考/usr/include/sysexits.h), 不过这个文件是为C/C++程序员准备的. 其实shell脚本也需要这样一个类似的标准. 所以本文作者呼吁限制使用用户定义的退出码, 尤其是范围64 - 113(还有0, 表示成功), 这么做, 就可以和C/C++标准保持一致. 这样我们就有了50个可用的退出码, 而且非常便于故障诊断.

本书中所有例子中的用户定义退出码都符合这个标准, 除了那些超出标准范围的例子, 比如例子 9-2.

Note

只有在Bash或sh提示符下, 当shell脚本退出后, 在命令行上使用$?才会得到与上表相一致的结果. 在某些情况下, 运行C-shell或者tcsh可能会给出不同的值.

注意事项

[1]

超出范围的退出值可能会产生意想不到的退出码. 如果退出值比255大, 那么退出码将会取256. 举个例子, exit 3809的退出码将是225(3809 % 256 = 225).