xorrisofs: Insert

 
 3 Inserting files into the ISO image
 ************************************
 
 'xorrisofs' deals with two kinds of file addresses:
 *disk_path* is a path to an object in the local filesystem tree.
 *iso_rr_path* is the Rock Ridge address of a file object in the ISO
 image.  If no Rock Ridge information shall be stored in an emerging ISO,
 then the names will get mapped to ISO 9660 names of limited length and
 character set.
 
    A program argument is handled as a *pathspec*, if it is not
 recognized as original mkisofs option or additional 'xorrisofs' option.
 A pathspec depicts an input file object by a disk_path.  If option
 -graft-points is not present, then the behavior depends on the file type
 of disk_path.  Directories get merged with the /-directory of the ISO
 image.  Files of other types get copied into the /-directory.
 If -graft-points is present then each pathspec gets split at the first
 occurrence of the =-character.  The part before the = is taken as
 *target*, i.e.  the iso_rr_path for the file object in the ISO image.
 The part after the first = is taken as *source*, i.e.  the disk_path of
 the input object.
 It is possible to make =-characters part of the iso_rr_path by preceding
 them with a \-character.  The same must be done for \-characters which
 shall be part of the iso_rr_path.
 
    If the source part of the pathspec leads to a directory, then all
 files underneath this directory get inserted into the image, too.  It is
 possible to exclude particular files from being inserted by help of
 option -m.
 In case that target already exists, the following rules apply:
 Directories and other files may overwrite existing non-directories.
 Directories get merged with existing directories.  Non-directories may
 not overwrite existing directories.