exit code numbers reassigned, man page updated

diff --git a/doc/zypper.8 b/doc/zypper.8
index 79bd011..c4e059f 100644 (file)
--- a/doc/zypper.8
+++ b/doc/zypper.8
@@ -235,6 +235,41 @@ Turns on rug compatibility. See compatibility notes next to affected commands.
 .B /var/lib/zypp/cache
 Directory for storing metadata contained in installation sources.
 
+.SH "EXIT CODES"
+.LP
+There are several exit codes defined for zypper for use e.g. within scripts. These codes are defined in header file src/zmart.h found in zypper source package. Codes from interval (1-5) denote an error, numbers (100-103) provide a specific information, 0 represents a normal successfull run. Following is a list of these codes with descriptions.
+.TP
+0 - ZYPPER_EXIT_OK
+Successfull run of zypper with no special info.
+.TP
+1 - ZYPPER_EXIT_ERR_BUG
+Unexpected situation occured, probably caused by a bug.
+.TP
+2 - ZYPPER_EXIT_ERR_SYNTAX
+zypper was invoked with an invalid command or option, or a bad syntax.
+.TP
+3 - ZYPPER_EXIT_ERR_INVALID_ARGS
+Some of provided arguments were invalid. E.g. an invalid URI was provided to the service-add command.
+.TP
+4 - ZYPPER_EXIT_ERR_ZYPP
+A problem reported by ZYPP library. E.g. another instance of ZYPP is running.
+.TP
+5 - ZYPPER_EXIT_ERR_PRIVILEGES
+User invoking zypper has insufficient privileges for specified operation.
+.TP
+100 - ZYPPER_EXIT_INF_UPDATE_NEEDED
+Returned by the patch-check command if there are patches available for installation.
+.TP
+101 - ZYPPER_EXIT_INF_SEC_UPDATE_NEEDED
+Returned by the patch-check command if there are security patches available for installation.
+.TP
+102 - ZYPPER_EXIT_INF_REBOOT_NEEDED
+Returned after a successfull installation of a patch which requires reboot of computer.
+.TP
+103 - ZYPPER_EXIT_INF_RESTART_NEEDED
+Returned after a successfull installation of a patch which requires restart of the package manager itself. This means that one of patches to be installed affects the package manager itself and the command used (e.g. zypper update) needs to be executed once again to install any remaining patches.
+
+
 .SH "NOTE"
 .LP
 Currently, zypper can be run only by user with root privileges.

diff --git a/src/zmart.h b/src/zmart.h
index a38114f..e07cc50 100644 (file)
--- a/src/zmart.h
+++ b/src/zmart.h
@@ -32,16 +32,16 @@
 
 #define ZYPPER_EXIT_OK                     0
 // errors
-#define ZYPPER_EXIT_ERR_SYNTAX             1 // syntax error, e.g. zypper instal, zypper in --unknown option
-#define ZYPPER_EXIT_ERR_INVALID_ARGS       2 // invalid arguments given, e.g. zypper source-add httttps://asdf.net 
-#define ZYPPER_EXIT_ERR_ZYPP               3 // error indicated from within libzypp, e.g. God = zypp::getZYpp() threw an exception
-#define ZYPPER_EXIT_ERR_PRIVILEGES         4 // unsufficient privileges for the operation
-#define ZYPPER_EXIT_ERR_BUG                5 // undetermined error
+#define ZYPPER_EXIT_ERR_BUG                1 // undetermined error
+#define ZYPPER_EXIT_ERR_SYNTAX             2 // syntax error, e.g. zypper instal, zypper in --unknown option
+#define ZYPPER_EXIT_ERR_INVALID_ARGS       3 // invalid arguments given, e.g. zypper source-add httttps://asdf.net 
+#define ZYPPER_EXIT_ERR_ZYPP               4 // error indicated from within libzypp, e.g. God = zypp::getZYpp() threw an exception
+#define ZYPPER_EXIT_ERR_PRIVILEGES         5 // unsufficient privileges for the operation
 // info
-#define ZYPPER_EXIT_INF_UPDATE_NEEDED     -1 // update needed
-#define ZYPPER_EXIT_INF_SEC_UPDATE_NEEDED -2 // security update needed
-#define ZYPPER_EXIT_INF_REBOOT_NEEDED     -3 
-#define ZYPPER_EXIT_INF_RESTART_NEEDED    -4
+#define ZYPPER_EXIT_INF_UPDATE_NEEDED      100 // update needed
+#define ZYPPER_EXIT_INF_SEC_UPDATE_NEEDED  101 // security update needed
+#define ZYPPER_EXIT_INF_REBOOT_NEEDED      102 // reboot needed after install/upgrade 
+#define ZYPPER_EXIT_INF_RESTART_NEEDED     103 // restart of package manager itself needed
 
 struct Settings
 {