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/ |
 `. `'                          |
   `-             -><-          |

Attachment: pgpNj7S0ixqrK.pgp
Description: PGP signature

Reply via email to