"Fossies" - the Fresh Open Source Software Archive

Member "xorriso-1.5.4/doc/susp_aaip_isofs_names.txt" (30 Jan 2021, 8200 Bytes) of package /linux/misc/xorriso-1.5.4.pl02.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "susp_aaip_isofs_names.txt": 1.5.1_vs_1.5.2.

    1                  Arbitrary Attribute Interchange Protocol
    2                 Interchange of Persistent File Attributes
    3 
    4                       Directory of Namespace "isofs."
    5 
    6           by Thomas Schmitt    - mailto:scdbackup@gmx.net
    7           Libburnia project    - mailto:bug-xorriso@gnu.org
    8 
    9 
   10 The following names are defined for AAIP namespace "isofs." as mentioned in
   11 specification of AAIP. Unless explicitly stated otherwise, numbers with
   12 names like *_LEN are 8 bit unsigned integers, those with *_BYTES are 32 bit
   13 unsigned integers.
   14 
   15 -------------------------------------------------------------------------------
   16 
   17 Name:
   18       isofs.ca
   19 
   20 Purpose:
   21       Records the range of checksummed image data (START, END), the number
   22       of checksum items (COUNT), the number of bytes in a single checksum item
   23       (SIZE), and the name of the checksum algorithm (CHECKSUM_TYPE).
   24       END is also the block address of the start of the checksum recording
   25       area in the image.
   26       See also isofs.cx .
   27       This attribute shall be attached to the root directory entry
   28       and be global for the whole image.
   29 
   30 Format of Value:
   31       START_LEN | START_BYTES | END_LEN | END_BYTES |
   32       COUNT_LEN | COUNT_BYTES | SIZE_LEN | SIZE_BYTES | CHECKSUM_TYPE
   33       Each number is encoded as _LEN byte and _BYTES value string.
   34       The _LEN fields comply to ISO 9660 Format section 7.1.1.
   35       The byte strings START_BYTES, END_BYTES, COUNT_BYTES, SIZE_BYTES begin
   36       with the most significant byte. Leading zero bytes are allowed.
   37       CHECKSUM_TYPE consists of the bytes after
   38       START_LEN + END_LEN + COUNT_LEN + SIZE_LEN + 4.
   39       It shall be a string of printable characters without terminating 0-byte.
   40       Type names shall be registered here.
   41       For now there is:
   42        "MD5"   128 bit message digest, see RFC 1321, see man md5sum 
   43 
   44 Example:
   45       LBA range 32 to 1000000 , 520 checksums recorded, MD5 
   46       {   1,  32,
   47           3,  15,  66,  64,
   48           2,   2,   8,
   49           1,  16,
   50         'M', 'D', '5' }
   51       or
   52       {   4,   0,   0,   0,  32,
   53           4,   0,  15,  66,  64,
   54           4,   0,   0,   2,   8,
   55           1,  16,
   56          'M', 'D', '5' }
   57 
   58 Registered:
   59       16 Jul 2009 by Thomas Schmitt for libisofs.
   60 
   61 -------------------------------------------------------------------------------
   62 
   63 Name:
   64       isofs.cs
   65 
   66 Purpose:
   67       Records the name of the character set that was used as output character
   68       set when writing the RRIP name tree of the ISO 9660 image. It shall be
   69       suitable as parameter for function iconv_open(3).
   70       This attribute shall be attached to the root directory entry and be
   71       global for the whole image.
   72 
   73 Format of Value:
   74       Shall hold the character set name without terminating 0-byte.
   75 
   76 Example:
   77       { 'I', 'S', 'O', '-', '8', '8', '5', '9' , '-', '1' }
   78 
   79 Registered:
   80       18 Mar 2009 by Thomas Schmitt for libisofs.
   81 
   82 -------------------------------------------------------------------------------
   83 
   84 Name:
   85       isofs.cx
   86 
   87 Purpose:
   88       Records the index of the file's checksum in the checksum area at the
   89       end of the image. The byte address of the checksum is 
   90        checksum_area_lba * 2048 + isofs.cx * checksum_size
   91       Default checksum algorithm is MD5 with a size of 16 byte.
   92       See also isofs.ca .
   93 
   94 Format of Value:
   95       A byte string which begins with the most significant byte.
   96 
   97 Example:
   98       Index 123456
   99       {   1, 226,  64 }
  100 
  101 Registered:
  102       16 Jul 2009 by Thomas Schmitt for libisofs.
  103 
  104 -------------------------------------------------------------------------------
  105 
  106 Name:
  107       isofs.di
  108 
  109 Purpose:
  110       Records .st_dev and .st_ino of struct stat of the file source in the
  111       local filesystem. See man 2 stat.
  112       Both values may be unsigned integers up to 255 bytes.
  113 
  114 Format of Value:
  115       DEV_LEN | DEV_BYTES | INO_LEN | INO_BYTES
  116       The _LEN fields comply to ISO 9660 Format section 7.1.1.
  117       The byte strings begin with the most significant byte.
  118 
  119 Example:
  120       Device number 2001, inode number 176343
  121       {   2,   7, 209,
  122           3,   2, 176, 215 } 
  123 
  124 Registered:
  125       17 Feb 2009 by Thomas Schmitt for xorriso.
  126 
  127 -------------------------------------------------------------------------------
  128 
  129 Name:
  130       isofs.hb
  131 
  132 Purpose:
  133       Records the IsoHfsplusBlessings blessing of a IsoNode as defined
  134       in libisofs.h. At image load time, this info may be converted back
  135       into a relation between IsoImage and IsoNode so that it is available for
  136       the HFS+ writer when a new ISO 9660 / HFS+ image gets produced.
  137 
  138 Format of Value:
  139       BLESSING
  140       This is a single byte out of {'p', 'i', 's', '9', 'x'} for
  141       ISO_HFSPLUS_BLESS_PPC_BOOTDIR, ISO_HFSPLUS_BLESS_INTEL_BOOTFILE,
  142       ISO_HFSPLUS_BLESS_SHOWFOLDER, ISO_HFSPLUS_BLESS_OS9_FOLDER,
  143       ISO_HFSPLUS_BLESS_OSX_FOLDER.
  144 
  145 Example:
  146       { 'p' }
  147 
  148 Registered:
  149       07 Jun 2012 by Thomas Schmitt for xorriso.
  150 
  151 -------------------------------------------------------------------------------
  152 
  153 Name:
  154       isofs.hx
  155 
  156 Purpose:
  157       Records the iso_hfsplus_xinfo_data information as defined in libisofs.h.
  158       At image load time, this info may be converted back into an xinfo
  159       attachment for iso_hfsplus_xinfo_func so that it is available for
  160       the HFS+ writer when a new ISO 9660 / HFS+ image gets produced.
  161 
  162 Format of Value:
  163       VERSION_LEN | VERSION | CREATOR | TYPE
  164       VERSION_LEN complies to ISO 9660 Format section 7.1.1.
  165       The byte string VERSION begins with the most significant byte.
  166       VERSION == 0 is the only one that is currently defined. It assures the
  167       existence of 4 bytes CREATOR and 4 bytes TYPE.
  168       Higher versions will keep these 8 bytes and possibly add new ones. 
  169 
  170 Example:
  171       { 1, 0, 'Y', 'Y', 'D', 'N', 'T', 'E', 'X', 'T' }
  172 
  173 Registered:
  174       07 Jun 2012 by Thomas Schmitt for xorriso.
  175 
  176 -------------------------------------------------------------------------------
  177 
  178 Name:
  179       isofs.nt
  180 
  181 Purpose:
  182       Records the name truncation mode and the truncation length for Rock Ridge
  183       names. See iso_image_set_truncate_mode() in libisofs.h.
  184       This attribute shall be attached to the root directory entry and be
  185       global for the whole image.
  186 
  187 Format of Value:
  188       MODE_LEN | MODE_BYTES | LENGTH_LEN | LENGTH_BYTES
  189 
  190 Example:
  191       { 1, 1, 1, 255 }
  192 
  193 Registered:
  194       24 Sep 2015 by Thomas Schmitt for libisofs.
  195 
  196 -------------------------------------------------------------------------------
  197 
  198 Name:
  199       isofs.st
  200 
  201 Purpose:
  202       Records a time point at least 1 second before any nodes were added to a
  203       freshly loaded or created ISO image. Nodes in the image which have
  204       younger timestamps are suspect to have changed their content during
  205       image production and might bear inconsistent content.
  206       The RRIP timestamps have a blind second during which a change after
  207       node registration would not be recognizable for incremental backups
  208       which are based in "isofs.di" rather than on content comparison.
  209       This attribute shall be attached to the root directory entry
  210       and be global for the whole image.
  211 
  212 Format of Value:
  213       Shall hold UTC seconds since 1970 as decimal number string without
  214       terminating 0-byte.
  215 
  216 Example:
  217       { '1', '2', '3', '8', '7', '4', '2', '2', '9', '6' }
  218 
  219 Registered:
  220       03 Apr 2009 by Thomas Schmitt for xorriso.
  221 
  222 -------------------------------------------------------------------------------
  223 -------------------------------------------------------------------------------
  224 -------------------------------------------------------------------------------
  225 
  226 This text is under
  227 Copyright (c) 2009 - 2015 Thomas Schmitt <scdbackup@gmx.net>
  228 It shall only be modified in sync with libisofs and other software which
  229 makes use of AAIP. Please mail change requests to mailing list
  230 <bug-xorriso@gnu.org> or to the copyright holder in private.
  231 Only if you cannot reach the copyright holder for at least one month it is
  232 permissible to modify this text under the same license as the affected
  233 copy of libisofs. Currently: GNU General Public License version 2 or later.
  234 If you do so, you commit yourself to taking reasonable effort to stay in
  235 sync with the other interested users of this text.
  236