exitcodes.html

来自「BASH Shell 编程 经典教程 《高级SHELL脚本编程》中文版」· HTML 代码 · 共 468 行

HTML
468 行
字号 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><HTML><HEAD><TITLE>带有特殊含义的退出码</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINKREL="HOME"TITLE="高级Bash脚本编程指南"HREF="index.html"><LINKREL="PREVIOUS"TITLE="Awk"HREF="awk.html"><LINKREL="NEXT"TITLE="I/O和I/O重定向的详细介绍"HREF="ioredirintro.html"></HEAD><BODYCLASS="APPENDIX"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">高级Bash脚本编程指南: 一本深入学习shell脚本艺术的书籍</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="awk.html"ACCESSKEY="P">前一页</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="ioredirintro.html"ACCESSKEY="N">下一页</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><DIVCLASS="APPENDIX"><H1><ANAME="EXITCODES"></A>Appendix D. 带有特殊含义的退出码</H1><P><ANAME="EXITCODESREF"></A></P><DIVCLASS="TABLE"><HR><ANAME="AEN18110"></A><P><B>表格 D-1. <SPANCLASS="QUOTE">"保留的"</SPAN>退出码</B></P><TABLEBORDER="1"CLASS="CALSTABLE"><COL><COL><COL><COL><THEAD><TR><TH>退出码的值</TH><TH>含义</TH><TH>例子</TH><TH>注释</TH></TR></THEAD><TBODY><TR><TD><CODECLASS="OPTION">1</CODE></TD><TD>通用错误</TD><TD>let "var1 = 1/0"</TD><TD>各种各样的错误都可能使用这个退出码, 比如<SPANCLASS="QUOTE">"除0错误"</SPAN></TD></TR><TR><TD><CODECLASS="OPTION">2</CODE></TD><TD>shell内建命令使用错误(Bash文档上有说明)</TD><TD>&nbsp;</TD><TD>很少看到, 通常情况下退出码都为<SPANCLASS="ERRORCODE">1</SPAN></TD></TR><TR><TD><CODECLASS="OPTION">126</CODE></TD><TD>命令调用不能执行</TD><TD>&nbsp;</TD><TD>程序或命令的权限是不可执行的</TD></TR><TR><TD><CODECLASS="OPTION">127</CODE></TD><TD><SPANCLASS="QUOTE">"command not found"</SPAN></TD><TD>&nbsp;</TD><TD>估计是<CODECLASS="VARNAME">$PATH</CODE>不对, 或者是拼写错误</TD></TR><TR><TD><CODECLASS="OPTION">128</CODE></TD><TD><AHREF="exit-status.html#EXITCOMMANDREF">exit</A>的参数错误</TD><TD>exit 3.14159</TD><TD><BCLASS="COMMAND">exit</B>只能以整数作为参数, 			  范围是<SPANCLASS="RETURNVALUE">0 - 255</SPAN>(见脚注)</TD></TR><TR><TD><CODECLASS="OPTION">128+n</CODE></TD><TD>信号<SPANCLASS="QUOTE">"n"</SPAN>的致命错误</TD><TD><BCLASS="COMMAND">kill -9</B> 脚本的<CODECLASS="VARNAME">$PPID</CODE></TD><TD><KBDCLASS="USERINPUT">$?</KBD> 返回<SPANCLASS="ERRORCODE">137</SPAN>(128 + 9)</TD></TR><TR><TD><CODECLASS="OPTION">130</CODE></TD><TD>用Control-C来结束脚本</TD><TD>&nbsp;</TD><TD>Control-C是信号<SPANCLASS="ERRORCODE">2</SPAN>的致命错误, 			  (130 = 128 + 2, 见上边)</TD></TR><TR><TD><CODECLASS="OPTION">255*</CODE></TD><TD>超出范围的退出状态</TD><TD>exit <SPANCLASS="RETURNVALUE">-1</SPAN></TD><TD><BCLASS="COMMAND">exit</B>命令只能够接受范围是<SPANCLASS="ERRORCODE">0 - 255</SPAN>的整数作为参数</TD></TR></TBODY></TABLE><HR></DIV><P>通过上面的表, 我们了解到, 退出码<SPANCLASS="ERRORCODE">1 - 2,        126 - 165, 和255</SPAN>	<ANAME="AEN18187"HREF="#FTN.AEN18187"><SPANCLASS="footnote">[1]</SPAN></A>	都具有特殊的含义, 因此应该避免使用用户指定的退出参数. 	如果脚本使用<BCLASS="COMMAND">exit 127</B>作为退出语句, 	那么可能就会在故障诊断的时候产生混淆(如何判断这是由<SPANCLASS="QUOTE">"command not found"</SPAN>引起的, 还是由用户定义引起的?). 	然而, 许多脚本使用<BCLASS="COMMAND">exit 1</B>作为通用的返回错误值. 	因为退出码<SPANCLASS="ERRORCODE">1</SPAN>能够表示的错误太多了, 	不过这么做, 对于调试来说, 也起不到任何帮助的作用. 	</P><P>其实早就有人对退出状态值进行了系统的分类(请参考<TTCLASS="FILENAME">/usr/include/sysexits.h</TT>), 	不过这个文件是为C/C++程序员准备的. 	其实shell脚本也需要这样一个类似的标准. 	所以本文作者呼吁限制使用用户定义的退出码, 	尤其是范围<SPANCLASS="RETURNVALUE">64 - 113</SPAN>(还有<SPANCLASS="RETURNVALUE">0</SPAN>, 表示成功), 	这么做, 就可以和C/C++标准保持一致. 	这样我们就有了50个可用的退出码, 	而且非常便于故障诊断. </P><P>本书中所有例子中的用户定义退出码都符合这个标准, 	除了那些超出标准范围的例子, 比如<AHREF="internalvariables.html#TMDIN">例子 9-2</A>. </P><DIVCLASS="NOTE"><P></P><TABLECLASS="NOTE"WIDTH="100%"BORDER="0"><TR><TDWIDTH="25"ALIGN="CENTER"VALIGN="TOP"><IMGSRC="./images/note.gif"HSPACE="5"ALT="Note"></TD><TDALIGN="LEFT"VALIGN="TOP"><P>只有在Bash或<EM>sh</EM>提示符下, 当shell脚本退出后, 			在命令行上使用<AHREF="internalvariables.html#XSTATVARREF">$?</A>才会得到与上表相一致的结果. 	在某些情况下, 	运行C-shell或者<EM>tcsh</EM>可能会给出不同的值. </P></TD></TR></TABLE></DIV></DIV><H3CLASS="FOOTNOTES">注意事项</H3><TABLEBORDER="0"CLASS="FOOTNOTES"WIDTH="100%"><TR><TDALIGN="LEFT"VALIGN="TOP"WIDTH="5%"><ANAME="FTN.AEN18187"HREF="exitcodes.html#AEN18187"><SPANCLASS="footnote">[1]</SPAN></A></TD><TDALIGN="LEFT"VALIGN="TOP"WIDTH="95%"><P>超出范围的退出值可能会产生意想不到的退出码. 			如果退出值比<SPANCLASS="ERRORCODE">255</SPAN>大, 			那么退出码将会取<SPANCLASS="ERRORCODE">256</SPAN>的<AHREF="ops.html#MODULOREF">模</A>. 	  举个例子, <BCLASS="COMMAND">exit 3809</B>的退出码将是<SPANCLASS="ERRORCODE">225</SPAN>(3809 % 256 = 225). </P></TD></TR></TABLE><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="awk.html"ACCESSKEY="P">前一页</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="index.html"ACCESSKEY="H">首页</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="ioredirintro.html"ACCESSKEY="N">下一页</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">Awk</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top">&nbsp;</TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">I/O和I/O重定向的详细介绍</TD></TR></TABLE></DIV></BODY></HTML>

exitcodes.html - 源码说明

本页面展示了「BASH Shell 编程 经典教程 《高级SHELL脚本编程》中文版」中的 exitcodes.html 源码文件，采用 HTML 编程语言编写，共 468 行代码。您可以在线阅读完整代码内容，也可以返回资源详情页下载完整源码包进行本地学习和开发。

虫虫下载站收录了大量与Shell相关的技术资源，包括源代码、技术文档、电路图等，是电子工程师和嵌入式开发者的专业学习平台。

⌨️ 快捷键说明

复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?