On Mon, Sep 01, 2003 at 10:58:50AM +0200, Martin Godisch wrote: > + In the case of init script commands other than <tt>status</tt> > (i.e., > + <tt>start</tt>, <tt>stop</tt>, <tt>restart</tt>, <tt>reload</tt>, > and > + <tt>force-reload</tt>), the init script should return an exit status > + of zero if the action described by the argument has been successful > + or the package is removed but not purged. Otherwise, the init script > + should print an error message and return one of the following > non-zero > + exit status codes. > + <taglist> > + <tag>1</tag> > + <item>generic or unspecified error,</item> > + <tag>2</tag> > + <item>invalid or excess argument(s),</item> > + <tag>3</tag> > + <item>unimplemented feature (for example, <tt>reload</tt>),</item> > + <tag>4</tag> > + <item>user had insufficient privilege,</item> > + <tag>5</tag> > + <item>reserved for LSB use,</item> > + <tag>6</tag> > + <item>program is not configured,</item> > + <tag>7</tag> > + <item>program is not running,</item> > + <tag>8-99</tag> > + <item>reserved for future LSB use,</item> > + <tag>100-149</tag> > + <item>reserved for distribution use,</item> > + <tag>150-199</tag> > + <item>reserved for application use,</item> > + <tag>200-254</tag> > + <item>reserved.</item> > + </taglist> > + All error messages should be printed on standard error. All status > + messages should be printed on standard output. (This does not > prevent > + scripts from calling the logging functions such as > + <tt>log_failure_msg</tt>). > + </p>
I think it's premature for the definition of the return values to be under a "should" clause. Something like this would be more appropriate: Otherwise, the init script should print an error message and return a non-zero exit status code. Packages are encouraged to select return codes based on the following list. [When we have most packages in compliance with this, we can upgrade it to a "should" clause again. This will likely be hastened if people supply patches.] -- .''`. ** Debian GNU/Linux ** | Andrew Suffield : :' : http://www.debian.org/ | `. `' | `- -><- |
pgpNj7S0ixqrK.pgp
Description: PGP signature