Version leap to libisoburn-0.4.3

libisoburn/trunk/xorriso/README

@@ -4,12 +4,12 @@
 xorriso. By Thomas Schmitt <scdbackup@gmx.net>
 Integrated sub project of libburnia-project.org but also published via:
 http://scdbackup.sourceforge.net/xorriso_eng.html
-http://scdbackup.sourceforge.net/xorriso-0.4.1.tar.gz
+http://scdbackup.sourceforge.net/xorriso-0.4.3.tar.gz
 Copyright (C) 2006-2009 Thomas Schmitt, provided under GPL version 2.
 ------------------------------------------------------------------------------
 
 
-xorriso is a program which maps file objects from POSIX compliant
+xorriso is a program which copies file objects from POSIX compliant
 filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows
 session-wise manipulation of such filesystems. It can load the management
 information of existing ISO images and it writes the session results to
@@ -46,10 +46,10 @@ Optional at compile time are:
 If they were present at compile time, then the optional libraries have to
 be present at runtime, too.
 
-Obtain xorriso-0.4.1.tar.gz, take it to a directory of your choice and do:
+Obtain xorriso-0.4.3.tar.gz, take it to a directory of your choice and do:
 
-    tar xzf xorriso-0.4.1.tar.gz
-    cd xorriso-0.4.1
+    tar xzf xorriso-0.4.3.tar.gz
+    cd xorriso-0.4.3
 
 Within that directory execute:
 
@@ -108,7 +108,8 @@ If you want xorriso to report a "Build timestamp" with its option -version:
 
                        Drives and Disk File Objects 
 
-The user of xorriso needs rw-permission for the CD burner device.
+The user of libisoburn applications needs rw-permission for the CD/DVD/BD
+drives which shall be used, even if only reading is intended.
 A list of rw-accessible drives can be obtained by
 
     xorriso -devices
@@ -185,8 +186,9 @@ and vice versa:
 
                              File Formats
 
-Currently there is only one file format peculiar to xorriso : sector maps
-which describe the valid and invalid blocks on a media or a disk copy of
+                             Sector Maps
+
+Sector maps describe the valid and invalid blocks on a media or a disk copy of
 a media. xorriso creates and reads these file with its option -check_media.
 
 The file begins with 32 bytes of cleartext of which the last one is a
@@ -202,6 +204,45 @@ bit in the map. Then come the bits in form of 8-bit bytes.
 Data block M is covered by bit B=M/S in the map, bit number B is stored in
 byte B/8 as bit B%8. A valid readable data block has its bit set to 1.
 
+                             Checksum Tags
+
+Checksum tags are data blocks inside an ISO 9660 image which do not belong to
+any file but rather tell the MD5 of a certain range of data blocks.
+
+The superblock checksum tag is written after the ECMA-119 volume descriptors.
+The tree checksum tag is written after the ECMA-119 directory entries.
+The session checksum tag is written after all payload including the checksum
+array. (Then follows eventual padding.)
+
+The tags are single lines of printable text, padded by 0 bytes. They have
+the following format:
+
+ Tag_id pos=# range_start=# range_size=# [session_start|next=#] md5=# self=#\n
+
+Parameters md5= and self= are 32 digit hex, the others are decimal numbers.
+
+Tag_id distinguishes the following tag types
+  "libisofs_rlsb32_checksum_tag_v1"     Relocated 64 kB superblock tag
+  "libisofs_sb_checksum_tag_v1"         Superblock tag
+  "libisofs_tree_checksum_tag_v1"       Directory tree tag
+  "libisofs_checksum_tag_v1"            Session tag
+
+A relocated superblock may appear at LBA 0 of an image which was produced for
+being stored in a disk file or on overwriteable media (e.g. DVD+R, BD-RE).
+xorriso records a first session recorded with its superblock at LBA 32 and
+the may follow at the next block address after the session tag which is
+divisible by 32. Normally no session starts after the address given by
+relocated superblock parameter session_start=.
+Session oriented media like CD-R[W], DVD+R, BD-R will have no relocated
+superblock but rather bear a table-of-content on media level.
+
+A tag is valid if pos= tells its own block address and self= tells its own MD5
+up to the last hex digit of md5=. range_start= tells the first block that is
+covered by md5=, range_size= tells the number of blocks covered by md5=.
+Relocated superblocks tell the block address of their session by session_start=.
+Superblock and tree tag tell the block address of the next tag by next=.
+The newline character at the end is mandatory.
+
 
                              libisoburn
 
@@ -223,8 +264,8 @@ This binary is leaner but depends on properly installed libraries of suitable
 revision.
 
 Dynamic library and compile time header requirements for libisoburn-0.4.0 :
-- libburn.so.4  , version libburn-0.6.4 or higher
-- libisofs.so.6 , version libisofs-0.6.20 or higher
+- libburn.so.4  , version libburn-0.7.0 or higher
+- libisofs.so.6 , version libisofs-0.6.22 or higher
 libisoburn and xorriso will not start with libraries which are older than their
 headers seen at compile time. So compile in the oldest possible installation
 setup unless you have reason to enforce a newer bug fix level.