[pca] PCA return codes

[Jeff A. Earickson]

On Wed, 22 Oct 2008, Martin Paul wrote:

> Date: Wed, 22 Oct 2008 15:04:07 +0200
> From: Martin Paul <martin at par.univie.ac.at>
> Reply-To: "PCA (Patch Check Advanced) Discussion" <pca at lists.univie.ac.at>
> To: "PCA (Patch Check Advanced) Discussion" <pca at lists.univie.ac.at>
> Subject: Re: [pca] PCA return codes
> 
> Fred Chagnon wrote:
>> In my wrapper script for pca, I would like to be able to determine if pca
>> finished patching completely, or if it finished prematurely, perhaps due to
>> a patch that required an immediate reconfigure reboot. Does pca have
>> different return codes for these situations? Where can I see a list of
>> possible exit situations?
>
> I've taken the simple approach now, and at last implemented that in the 
> current development release. From "pca --man":
>
>  EXIT STATUS
>    The following exit values are returned:
>
>       0  No error
>       1  Unknown error
>       2  Usage error
>       3  Reboot required to continue patch installation
>       4  Reboot required
>       5  Reboot recommended

This may be nitpicky, but I would reorder it as:

         0  No error
         1  Unknown error
         2  Usage error
         3  Reboot recommended
         4  Reboot required to continue patch installation
         5  Reboot required

That way (errcode > 2) means "you should reboot" and (errcode > 3) means
"you must reboot".

Jeff Earickson
Colby College