Linux Shell ERROR/RETURN code

理解Shell退出码

最新推荐文章于 2025-04-26 15:33:09 发布

俄罗斯方块高手

最新推荐文章于 2025-04-26 15:33:09 发布

阅读量6.3k

点赞数

CC 4.0 BY-SA版权

分类专栏： Shell 文章标签： shell linux command 脚本 integer documentation

本文链接：https://blog.youkuaiyun.com/dssxk/article/details/8090551

Shell 专栏收录该内容

4 篇文章

订阅专栏

本文详细解释了Shell脚本中各种退出码的意义，包括通用错误、命令执行失败等常见情况，并提出了标准化退出码的建议。

Exit Code Number Meaning Example Comments

1 Catchall for general errors let “var1 = 1/0″ Miscellaneous errors, such as ”divide by zero” and other impermissible operations

2 Misuse of shell builtins (according to Bash documentation) empty_function() {} Seldom seen, usually defaults to exit code 1
126 Command invoked cannot execute Permission problem or command is not an executable
127 “command not found” illegal_command Possible problem with $PATH or a typo
128 Invalid argument to exit exit 3.14159 exit takes only integer args in the range 0 – 255 (see first footnote)
128+n Fatal error signal ”n” kill -9 $PPID of script $? returns 137 (128 + 9)
130 Script terminated by Control-C Control-C is fatal error signal 2, (130 = 128 + 2, see above)

255* Exit status out of range exit -1 exit takes only integer args in the range 0 – 255

退出码的值
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的整数作为参数
通过上面的表, 我们了解到, 退出码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.

只有在Bash或sh提示符下, 当shell脚本退出后, 在命令行上使用$?才会得到与上表相一致的结果. 在某些情况下, 运行C-shell或者tcsh可能会给出不同的值.
注意事项
[1]
超出范围的退出值可能会产生意想不到的退出码. 如果退出值比255大, 那么退出码将会取256的模. 举个例子, exit 3809的退出码将是225(3809 % 256 = 225).

退出码的值

　1 　　　通用错误 let "var1 = 1/0" 各种各样的错误都可能使用这个退出码, 比如"除0错误"

　2　　　shell内建命令使用错误(Bash文档上有说明) 很少看到, 通常情况下退出码都为1。所有内建命令返回 2 来指示不正确的用法。

　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的整数作为参数。如果退出值比255大, 那么退出码将会取256的模. 举个例子, exit 3809的退出码将是225(3809 % 256 = 225).

返回值分析

   1：程序中，用 exit 来设置进程的退出值时，虽然该参数的类型为 int，但在父进程中，只能取得其值的低 8 位，所以用 exit 返回时，高于 255 是没有意义的。
   2：对应 system 返回值，其值由两部分组成：低 8 位表示所执行的脚步在执行过程中所接收到的信号值，其余的位表示 exit 的返回值。
   3：由　2　可知，对于 system 返回值（ret）来讲，ret>>8 即为 exit 返回值，也对应为获取的 shell 命令的执行状态（$?）。
   4：return ：　Perl 与　Shell(Bash)是不同的

　　　　　　Bash只能返回０－２５５的值，但可以通过echo返回字符串和整数

　　　　　　Perl 可以通过return返回字符串，数字（整数和小数）