Re-instated range "vreixo" with old and new codes, adjusted severity definitions

libburn/trunk/cdrskin/cdrskin_timestamp.h

@@ -1 +1 @@
-#define Cdrskin_timestamP "2008.02.04.175209"
+#define Cdrskin_timestamP "2008.02.06.174009"

libburn/trunk/libburn/libdax_msgs.h

@@ -141,12 +141,17 @@ struct libdax_msgs_item;
 #define LIBDAX_MSGS_SEV_WARNING                                      0x50000000
 
 
-/** Non-fatal error messages indicating that important parts of an action
+/** Non-fatal error messages indicating that parts of an action failed but
-    failed but processing may go on if one accepts deviations from the
+    processing may go on if one accepts deviations from the desired result.
-    desired result.
 
-    E.g.: One of several libisofs input files cannot be found.
+    SORRY shall also be the severity for incidents which are severe enough
+    for FAILURE but happen within already started irrevocable actions,
+    like ISO image generation. A precondition for such a severity ease is
+    that the action can be continued after the incident.
+
+    E.g.: A pattern yields no result.
           A speed setting cannot be made.
+          A libisofs input file is inaccessible during image generation.
 
     After SORRY a function should try to go on if that makes any sense
     and if no threshold prescribes abort on SORRY. The function should
@@ -156,15 +161,17 @@ struct libdax_msgs_item;
 #define LIBDAX_MSGS_SEV_SORRY                                        0x60000000
 
 
-/** Non-fatal error indicating that a complete action failed and that
+/** Non-fatal error indicating that an important part of an action failed and
-    only a thorough new setup of preconditions will give hope for success.
+    that only a new setup of preconditions will give hope for sufficient
+    success.
 
     E.g.: No media is inserted in the output drive.
           No write mode can be found for inserted media.
-          All libisofs input files are inaccessible.
+          A libisofs input file is inaccessible during grafting.
 
-    After FAILURE a function should end very soon with a return value
+    After FAILURE a function should end with a return value indicating failure.
-    indicating failure.
+    It is at the discretion of the function whether it ends immediately in any
+    case or whether it tries to go on if the eventual threshold allows.
 */
 #define LIBDAX_MSGS_SEV_FAILURE                                      0x68000000
 
@@ -499,8 +506,80 @@ Range "scdbackup"          :  0x00020000 to 0x0002ffff
 ------------------------------------------------------------------------------
 Range "vreixo"              :  0x00030000 to 0x0003ffff
 
-This has been abandoned and may not be re-used for other purposes than
+ 0x0003ffff (FAILURE,HIGH) = Operation canceled
-re-instating the old numbers and further extending them.
+ 0x0003fffe (FATAL,HIGH)   = Unknown or unexpected fatal error
+ 0x0003fffd (FAILURE,HIGH) = Unknown or unexpected error
+ 0x0003fffc (FATAL,HIGH)   = Internal programming error
+ 0x0003fffb (FAILURE,HIGH) = NULL pointer where NULL not allowed
+ 0x0003fffa (FATAL,HIGH)   = Memory allocation error
+ 0x0003fff9 (FATAL,HIGH)   = Interrupted by a signal
+ 0x0003fff8 (FAILURE,HIGH) = Invalid parameter value
+ 0x0003fff7 (FATAL,HIGH)   = Cannot create a needed thread
+ 0x0003fff6 (FAILURE,HIGH) = Write error
+ 0x0003fff5 (FAILURE,HIGH) = Buffer read error
+ 0x0003ffc0 (FAILURE,HIGH) = Trying to add a node already added to another dir
+ 0x0003ffbf (FAILURE,HIGH) = Node with same name already exist
+ 0x0003ffbe (FAILURE,HIGH) = Trying to remove a node that was not added to dir
+ 0x0003ffbd (FAILURE,HIGH) = A requested node does not exist
+ 0x0003ffbc (FAILURE,HIGH) = Image already bootable
+ 0x0003ffbb (FAILURE,HIGH) = Trying to use an invalid file as boot image
+ 0x0003ff80 (FAILURE,HIGH) = Error on file operation
+ 0x0003ff7f (FAILURE,HIGH) = Trying to open an already openned file
+ 0x0003ff7e (FAILURE,HIGH) = Access to file is not allowed
+ 0x0003ff7d (FAILURE,HIGH) = Incorrect path to file
+ 0x0003ff7c (FAILURE,HIGH) = The file does not exist in the filesystem
+ 0x0003ff7b (FAILURE,HIGH) = Trying to read or close a file not openned
+ 0x0003ff7a (FAILURE,HIGH) = Directory used where no dir is expected
+ 0x0003ff79 (FAILURE,HIGH) = File read error
+ 0x0003ff78 (FAILURE,HIGH) = Not dir used where a dir is expected
+ 0x0003ff77 (FAILURE,HIGH) = Not symlink used where a symlink is expected
+ 0x0003ff76 (FAILURE,HIGH) = Cannot seek to specified location
+ 0x0003ff75 (HINT,MEDIUM)  = File not supported in ECMA-119 tree and ignored
+ 0x0003ff74 (HINT,MEDIUM)  = File bigger than supported by used standard
+ 0x0003ff73 (SORRY,HIGH)   = File read error during image creation
+ 0x0003ff72 (HINT,MEDIUM)  = Cannot convert filename to requested charset
+ 0x0003ff71 (SORRY,HIGH)   = File cannot be added to the tree
+ 0x0003ff70 (HINT,MEDIUM)  = File path breaks specification constraints
+ 0x0003ff00 (FAILURE,HIGH) = Charset conversion error
+ 0x0003feff (FAILURE,HIGH) = Too much files to mangle
+ 0x0003fec0 (FAILURE,HIGH) = Wrong or damaged Primary Volume Descriptor
+ 0x0003febf (SORRY,HIGH)   = Wrong or damaged RR entry
+ 0x0003febe (SORRY,HIGH)   = Unsupported RR feature
+ 0x0003febd (FAILURE,HIGH) = Wrong or damaged ECMA-119
+ 0x0003febc (FAILURE,HIGH) = Unsupported ECMA-119 feature
+ 0x0003febb (SORRY,HIGH)   = Wrong or damaged El-Torito catalog
+ 0x0003feba (SORRY,HIGH)   = Unsupported El-Torito feature
+ 0x0003feb9 (SORRY,HIGH)   = Cannot patch isolinux boot image
+ 0x0003feb8 (SORRY,HIGH)   = Unsupported SUSP feature
+ 0x0003feb7 (WARNING,HIGH) = Error on a RR entry that can be ignored
+ 0x0003feb6 (HINT,MEDIUM)  = Error on a RR entry that can be ignored
+ 0x0003feb5 (WARNING,HIGH) = Multiple ER SUSP entries found
+ 0x0003feb4 (HINT,MEDIUM)  = Unsupported volume descriptor found
+ 0x0003feb3 (WARNING,HIGH) = El-Torito related warning
+ 0x0003feb2 (SORRY,HIGH)   = Image write cancelled
+
+Outdated codes which may not be re-used for other purposes than
+re-instating them, if ever:
+
+X 0x00031001 (SORRY,HIGH)    = Cannot read file (ignored)
+X 0x00031002 (FATAL,HIGH)    = Cannot read file (operation canceled)
+X 0x00031000 (FATAL,HIGH)    = Unsupported ISO-9660 image
+X 0x00031001 (HINT,MEDIUM)   = Unsupported Vol Desc that will be ignored
+X 0x00031002 (FATAL,HIGH)    = Damaged ISO-9660 image
+X 0x00031003 (SORRY,HIGH)    = Cannot read previous image file
+X 0x00030101 (HINT,MEDIUM)   = Unsupported SUSP entry that will be ignored
+X 0x00030102 (SORRY,HIGH)    = Wrong/damaged SUSP entry
+X 0x00030103 (WARNING,MEDIUM)= Multiple SUSP ER entries where found
+X 0x00030111 (SORRY,HIGH)    = Unsupported RR feature
+X 0x00030112 (SORRY,HIGH)    = Error in a Rock Ridge entry
+X 0x00030201 (HINT,MEDIUM)   = Unsupported Boot Vol Desc that will be ignored
+X 0x00030202 (SORRY,HIGH)    = Wrong El-Torito catalog
+X 0x00030203 (HINT,MEDIUM)   = Unsupported El-Torito feature
+X 0x00030204 (SORRY,HIGH)    = Invalid file to be an El-Torito image
+X 0x00030205 (WARNING,MEDIUM)= Cannot properly patch isolinux image
+X 0x00030206 (WARNING,MEDIUM)= Copying El-Torito from a previous image without
+X                              enought info about it
+X 0x00030301 (NOTE,MEDIUM)   = Unsupported file type for Joliet tree
 
 
 ------------------------------------------------------------------------------
@@ -519,15 +598,18 @@ Range "application"         :  0x00040000 to 0x0004ffff
 ------------------------------------------------------------------------------
 Range "libisofs-xorriso"    :  0x00050000 to 0x0005ffff
 
-This is the representation of libisofs.so.6 error codes in xorriso.
+This is an alternative representation of libisofs.so.6 error codes in xorriso.
-Other applications are invited to map the output of ISO_ERR_CODE(e)
+If values returned by iso_error_get_code() do not fit into 0x30000 to 0x3ffff
-into the same range of numbers.
+then they get truncated to 16 bit and mapped into this range.
+(This should never need to happen, of course.)
 
 ------------------------------------------------------------------------------
 Range "libisoburn"          :  0x00060000 to 0x00006ffff
 
  0x00060000 (*,*)           : Message which shall be attributed to libisoburn
 
+ >>> the messages of libisoburn need to be registered individually
+
 
 ------------------------------------------------------------------------------